@@ -20,6 +20,7 @@ export interface PreviewAutomationKeyEvent {
2020 readonly isKeypad : boolean ;
2121 readonly text ?: string ;
2222 readonly unmodifiedText ?: string ;
23+ readonly commands ?: ReadonlyArray < string > ;
2324}
2425
2526export interface PreviewAutomationKeySequence {
@@ -79,6 +80,42 @@ const PRINTABLE_KEYS: ReadonlyArray<KeyDefinition> = [
7980 { code : "Slash" , key : "/" , shiftedKey : "?" , keyCode : 191 } ,
8081] ;
8182
83+ /**
84+ * Chromium does not infer macOS editing commands from synthetic Meta chords.
85+ * Keep the common browser editing/navigation shortcuts explicit so dispatched
86+ * key events behave like their physical-key equivalents.
87+ */
88+ const MAC_EDITING_COMMANDS : Readonly < Record < string , string > > = {
89+ "Meta+Backspace" : "deleteToBeginningOfLine" ,
90+ "Meta+ArrowUp" : "moveToBeginningOfDocument" ,
91+ "Meta+ArrowDown" : "moveToEndOfDocument" ,
92+ "Meta+ArrowLeft" : "moveToLeftEndOfLine" ,
93+ "Meta+ArrowRight" : "moveToRightEndOfLine" ,
94+ "Shift+Meta+ArrowUp" : "moveToBeginningOfDocumentAndModifySelection" ,
95+ "Shift+Meta+ArrowDown" : "moveToEndOfDocumentAndModifySelection" ,
96+ "Shift+Meta+ArrowLeft" : "moveToLeftEndOfLineAndModifySelection" ,
97+ "Shift+Meta+ArrowRight" : "moveToRightEndOfLineAndModifySelection" ,
98+ "Meta+KeyA" : "selectAll" ,
99+ "Meta+KeyC" : "copy" ,
100+ "Meta+KeyX" : "cut" ,
101+ "Meta+KeyV" : "paste" ,
102+ "Meta+KeyZ" : "undo" ,
103+ "Shift+Meta+KeyZ" : "redo" ,
104+ } ;
105+ const SHORTCUT_MODIFIER_ORDER = [ "Shift" , "Control" , "Alt" , "Meta" ] as const ;
106+
107+ const macEditingCommands = (
108+ code : string ,
109+ modifiers : PreviewAutomationPressInput [ "modifiers" ] ,
110+ ) : ReadonlyArray < string > => {
111+ const shortcut = [
112+ ...SHORTCUT_MODIFIER_ORDER . filter ( ( modifier ) => modifiers ?. includes ( modifier ) ) ,
113+ code ,
114+ ] . join ( "+" ) ;
115+ const command = MAC_EDITING_COMMANDS [ shortcut ] ;
116+ return command ? [ command ] : [ ] ;
117+ } ;
118+
82119const modifierMask = ( modifiers : PreviewAutomationPressInput [ "modifiers" ] ) : number =>
83120 ( modifiers ?? [ ] ) . reduce ( ( value , modifier ) => {
84121 switch ( modifier ) {
@@ -136,12 +173,14 @@ function resolveKeyDefinition(input: PreviewAutomationPressInput): KeyDefinition
136173 */
137174export function makePreviewAutomationKeySequence (
138175 input : PreviewAutomationPressInput ,
176+ options ?: { readonly isMac ?: boolean } ,
139177) : PreviewAutomationKeySequence {
140178 const definition = resolveKeyDefinition ( input ) ;
141179 const modifiers = modifierMask ( input . modifiers ) ;
142180 const suppressText = input . modifiers ?. some ( ( modifier ) => modifier !== "Shift" ) ?? false ;
143181 const text = suppressText ? "" : ( definition . text ?? "" ) ;
144182 const location = definition . location ?? 0 ;
183+ const commands = options ?. isMac ? macEditingCommands ( definition . code , input . modifiers ) : [ ] ;
145184 const shared = {
146185 key : definition . key ,
147186 code : definition . code ,
@@ -156,6 +195,7 @@ export function makePreviewAutomationKeySequence(
156195 type : text ? "keyDown" : "rawKeyDown" ,
157196 ...shared ,
158197 ...( text ? { text, unmodifiedText : text } : { } ) ,
198+ ...( commands . length > 0 ? { commands } : { } ) ,
159199 } ,
160200 keyUp : { type : "keyUp" , ...shared } ,
161201 signal : { kind : "key" , key : definition . key , code : definition . code } ,
0 commit comments