@agent-infra/browser 0.1.6 → 0.2.0-alpha.4

package/dist/actions/key-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions/key-map.js","sources":["webpack://@agent-infra/browser/webpack/runtime/define_property_getters","webpack://@agent-infra/browser/webpack/runtime/has_own_property","webpack://@agent-infra/browser/webpack/runtime/make_namespace_object","webpack://@agent-infra/browser/./src/actions/key-map.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * The following code is modified based on\n * https://github.com/puppeteer/puppeteer/blob/main/packages/puppeteer-core/src/common/USKeyboardLayout.ts\n *\n * Copyright 2017 Google Inc.\n * SPDX-License-Identifier: Apache-2.0\n * https://github.com/puppeteer/puppeteer/blob/main/LICENSE\n */\nimport type { KeyInput } from 'puppeteer-core';\n\n/**\n * Only adapt for common macOS system hotkeys\n *\n * See issues:\n * - https://github.com/bytedance/UI-TARS-desktop/pull/560\n *\n * References:\n * - Mac shortcuts list: https://support.apple.com/zh-cn/102650\n * - Chrome: https://support.google.com/chrome/answer/157179\n * - CDP: https://chromedevtools.github.io/devtools-protocol/tot/Input/#method-dispatchKeyEvent\n * - Commands: https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/editing/commands/editor_command_names.h\n */\nexport const MAC_SYSTEM_HOTKEY_MAP = new Map<\n  string,\n  { key: KeyInput; commands: string }\n>([\n  ['CorM+A', { key: 'KeyA', commands: 'SelectAll' }],\n  ['CorM+KeyA', { key: 'KeyA', commands: 'SelectAll' }],\n\n  ['CorM+X', { key: 'KeyX', commands: 'Cut' }],\n  ['CorM+KeyX', { key: 'KeyX', commands: 'Cut' }],\n\n  ['CorM+C', { key: 'KeyC', commands: 'Copy' }],\n  ['CorM+KeyC', { key: 'KeyC', commands: 'Copy' }],\n\n  ['CorM+V', { key: 'KeyV', commands: 'Paste' }],\n  ['CorM+KeyV', { key: 'KeyV', commands: 'Paste' }],\n\n  ['CorM+Z', { key: 'KeyZ', commands: 'Undo' }],\n  ['CorM+KeyZ', { key: 'KeyZ', commands: 'Undo' }],\n\n  ['CorM+Y', { key: 'KeyY', commands: 'Redo' }],\n  ['CorM+KeyY', { key: 'KeyY', commands: 'Redo' }],\n  ['CorM+Shift+Z', { key: 'KeyZ', commands: 'Redo' }],\n  ['CorM+Shift+KeyZ', { key: 'KeyZ', commands: 'Redo' }],\n  ['Shift+CorM+Z', { key: 'KeyZ', commands: 'Redo' }],\n  ['Shift+CorM+KeyZ', { key: 'KeyZ', commands: 'Redo' }],\n]);\n\nexport const KEY_ABBR_TO_STANDARD_MAP: Readonly<Record<string, KeyInput>> = {\n  // modifier keys\n  ctrl: 'Control',\n  cmd: 'Meta', // macOS only\n  command: 'Meta', // macOS only\n  opt: 'Alt', // macOS only\n  option: 'Alt', // macOS only\n  // arraw keys\n  up: 'ArrowUp',\n  down: 'ArrowDown',\n  left: 'ArrowLeft',\n  right: 'ArrowRight',\n  // others\n  esc: 'Escape',\n  del: 'Delete',\n  ins: 'Insert',\n  pgup: 'PageUp',\n  pgdown: 'PageDown',\n  return: 'Enter',\n};\n\n// Auto-generated form puppeteer-core/src/common/USKeyboardLayout.ts _keyDefinitions\nexport const KEY_LOW_TO_STANDARD_MAP: Readonly<Record<string, KeyInput>> = {\n  '0': '0',\n  '1': '1',\n  '2': '2',\n  '3': '3',\n  '4': '4',\n  '5': '5',\n  '6': '6',\n  '7': '7',\n  '8': '8',\n  '9': '9',\n  power: 'Power',\n  eject: 'Eject',\n  abort: 'Abort',\n  help: 'Help',\n  backspace: 'Backspace',\n  tab: 'Tab',\n  numpad5: 'Numpad5',\n  numpadenter: 'NumpadEnter',\n  enter: 'Enter',\n  '\\r': '\\r',\n  '\\n': '\\n',\n  shiftleft: 'ShiftLeft',\n  shiftright: 'ShiftRight',\n  controlleft: 'ControlLeft',\n  controlright: 'ControlRight',\n  altleft: 'AltLeft',\n  altright: 'AltRight',\n  pause: 'Pause',\n  capslock: 'CapsLock',\n  escape: 'Escape',\n  convert: 'Convert',\n  nonconvert: 'NonConvert',\n  space: 'Space',\n  numpad9: 'Numpad9',\n  pageup: 'PageUp',\n  numpad3: 'Numpad3',\n  pagedown: 'PageDown',\n  end: 'End',\n  numpad1: 'Numpad1',\n  home: 'Home',\n  numpad7: 'Numpad7',\n  arrowleft: 'ArrowLeft',\n  numpad4: 'Numpad4',\n  numpad8: 'Numpad8',\n  arrowup: 'ArrowUp',\n  arrowright: 'ArrowRight',\n  numpad6: 'Numpad6',\n  numpad2: 'Numpad2',\n  arrowdown: 'ArrowDown',\n  select: 'Select',\n  open: 'Open',\n  printscreen: 'PrintScreen',\n  insert: 'Insert',\n  numpad0: 'Numpad0',\n  delete: 'Delete',\n  numpaddecimal: 'NumpadDecimal',\n  digit0: 'Digit0',\n  digit1: 'Digit1',\n  digit2: 'Digit2',\n  digit3: 'Digit3',\n  digit4: 'Digit4',\n  digit5: 'Digit5',\n  digit6: 'Digit6',\n  digit7: 'Digit7',\n  digit8: 'Digit8',\n  digit9: 'Digit9',\n  keya: 'KeyA',\n  keyb: 'KeyB',\n  keyc: 'KeyC',\n  keyd: 'KeyD',\n  keye: 'KeyE',\n  keyf: 'KeyF',\n  keyg: 'KeyG',\n  keyh: 'KeyH',\n  keyi: 'KeyI',\n  keyj: 'KeyJ',\n  keyk: 'KeyK',\n  keyl: 'KeyL',\n  keym: 'KeyM',\n  keyn: 'KeyN',\n  keyo: 'KeyO',\n  keyp: 'KeyP',\n  keyq: 'KeyQ',\n  keyr: 'KeyR',\n  keys: 'KeyS',\n  keyt: 'KeyT',\n  keyu: 'KeyU',\n  keyv: 'KeyV',\n  keyw: 'KeyW',\n  keyx: 'KeyX',\n  keyy: 'KeyY',\n  keyz: 'KeyZ',\n  metaleft: 'MetaLeft',\n  metaright: 'MetaRight',\n  contextmenu: 'ContextMenu',\n  numpadmultiply: 'NumpadMultiply',\n  numpadadd: 'NumpadAdd',\n  numpadsubtract: 'NumpadSubtract',\n  numpaddivide: 'NumpadDivide',\n  f1: 'F1',\n  f2: 'F2',\n  f3: 'F3',\n  f4: 'F4',\n  f5: 'F5',\n  f6: 'F6',\n  f7: 'F7',\n  f8: 'F8',\n  f9: 'F9',\n  f10: 'F10',\n  f11: 'F11',\n  f12: 'F12',\n  f13: 'F13',\n  f14: 'F14',\n  f15: 'F15',\n  f16: 'F16',\n  f17: 'F17',\n  f18: 'F18',\n  f19: 'F19',\n  f20: 'F20',\n  f21: 'F21',\n  f22: 'F22',\n  f23: 'F23',\n  f24: 'F24',\n  numlock: 'NumLock',\n  scrolllock: 'ScrollLock',\n  audiovolumemute: 'AudioVolumeMute',\n  audiovolumedown: 'AudioVolumeDown',\n  audiovolumeup: 'AudioVolumeUp',\n  mediatracknext: 'MediaTrackNext',\n  mediatrackprevious: 'MediaTrackPrevious',\n  mediastop: 'MediaStop',\n  mediaplaypause: 'MediaPlayPause',\n  semicolon: 'Semicolon',\n  equal: 'Equal',\n  numpadequal: 'NumpadEqual',\n  comma: 'Comma',\n  minus: 'Minus',\n  period: 'Period',\n  slash: 'Slash',\n  backquote: 'Backquote',\n  bracketleft: 'BracketLeft',\n  backslash: 'Backslash',\n  bracketright: 'BracketRight',\n  quote: 'Quote',\n  altgraph: 'AltGraph',\n  props: 'Props',\n  cancel: 'Cancel',\n  clear: 'Clear',\n  shift: 'Shift',\n  control: 'Control',\n  alt: 'Alt',\n  accept: 'Accept',\n  modechange: 'ModeChange',\n  ' ': ' ',\n  print: 'Print',\n  execute: 'Execute',\n  '\\u0000': '\\u0000',\n  a: 'A',\n  b: 'B',\n  c: 'C',\n  d: 'D',\n  e: 'E',\n  f: 'F',\n  g: 'G',\n  h: 'H',\n  i: 'I',\n  j: 'J',\n  k: 'K',\n  l: 'L',\n  m: 'M',\n  n: 'N',\n  o: 'O',\n  p: 'P',\n  q: 'Q',\n  r: 'R',\n  s: 'S',\n  t: 'T',\n  u: 'U',\n  v: 'V',\n  w: 'W',\n  x: 'X',\n  y: 'Y',\n  z: 'Z',\n  meta: 'Meta',\n  '*': '*',\n  '+': '+',\n  '-': '-',\n  '/': '/',\n  ';': ';',\n  '=': '=',\n  ',': ',',\n  '.': '.',\n  '`': '`',\n  '[': '[',\n  '\\\\': '\\\\',\n  ']': ']',\n  \"'\": \"'\",\n  attn: 'Attn',\n  crsel: 'CrSel',\n  exsel: 'ExSel',\n  eraseeof: 'EraseEof',\n  play: 'Play',\n  zoomout: 'ZoomOut',\n  ')': ')',\n  '!': '!',\n  '@': '@',\n  '#': '#',\n  $: '$',\n  '%': '%',\n  '^': '^',\n  '&': '&',\n  '(': '(',\n  ':': ':',\n  '<': '<',\n  _: '_',\n  '>': '>',\n  '?': '?',\n  '~': '~',\n  '{': '{',\n  '|': '|',\n  '}': '}',\n  '\"': '\"',\n  softleft: 'SoftLeft',\n  softright: 'SoftRight',\n  camera: 'Camera',\n  call: 'Call',\n  endcall: 'EndCall',\n  volumedown: 'VolumeDown',\n  volumeup: 'VolumeUp',\n};\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","MAC_SYSTEM_HOTKEY_MAP","Map","KEY_ABBR_TO_STANDARD_MAP","KEY_LOW_TO_STANDARD_MAP"],"mappings":"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"}

package/dist/actions/key-map.mjs

@@ -0,0 +1,369 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+const MAC_SYSTEM_HOTKEY_MAP = new Map([
+    [
+        'CorM+A',
+        {
+            key: 'KeyA',
+            commands: 'SelectAll'
+        }
+    ],
+    [
+        'CorM+KeyA',
+        {
+            key: 'KeyA',
+            commands: 'SelectAll'
+        }
+    ],
+    [
+        'CorM+X',
+        {
+            key: 'KeyX',
+            commands: 'Cut'
+        }
+    ],
+    [
+        'CorM+KeyX',
+        {
+            key: 'KeyX',
+            commands: 'Cut'
+        }
+    ],
+    [
+        'CorM+C',
+        {
+            key: 'KeyC',
+            commands: 'Copy'
+        }
+    ],
+    [
+        'CorM+KeyC',
+        {
+            key: 'KeyC',
+            commands: 'Copy'
+        }
+    ],
+    [
+        'CorM+V',
+        {
+            key: 'KeyV',
+            commands: 'Paste'
+        }
+    ],
+    [
+        'CorM+KeyV',
+        {
+            key: 'KeyV',
+            commands: 'Paste'
+        }
+    ],
+    [
+        'CorM+Z',
+        {
+            key: 'KeyZ',
+            commands: 'Undo'
+        }
+    ],
+    [
+        'CorM+KeyZ',
+        {
+            key: 'KeyZ',
+            commands: 'Undo'
+        }
+    ],
+    [
+        'CorM+Y',
+        {
+            key: 'KeyY',
+            commands: 'Redo'
+        }
+    ],
+    [
+        'CorM+KeyY',
+        {
+            key: 'KeyY',
+            commands: 'Redo'
+        }
+    ],
+    [
+        'CorM+Shift+Z',
+        {
+            key: 'KeyZ',
+            commands: 'Redo'
+        }
+    ],
+    [
+        'CorM+Shift+KeyZ',
+        {
+            key: 'KeyZ',
+            commands: 'Redo'
+        }
+    ],
+    [
+        'Shift+CorM+Z',
+        {
+            key: 'KeyZ',
+            commands: 'Redo'
+        }
+    ],
+    [
+        'Shift+CorM+KeyZ',
+        {
+            key: 'KeyZ',
+            commands: 'Redo'
+        }
+    ]
+]);
+const KEY_ABBR_TO_STANDARD_MAP = {
+    ctrl: 'Control',
+    cmd: 'Meta',
+    command: 'Meta',
+    opt: 'Alt',
+    option: 'Alt',
+    up: 'ArrowUp',
+    down: 'ArrowDown',
+    left: 'ArrowLeft',
+    right: 'ArrowRight',
+    esc: 'Escape',
+    del: 'Delete',
+    ins: 'Insert',
+    pgup: 'PageUp',
+    pgdown: 'PageDown',
+    return: 'Enter'
+};
+const KEY_LOW_TO_STANDARD_MAP = {
+    0: '0',
+    1: '1',
+    2: '2',
+    3: '3',
+    4: '4',
+    5: '5',
+    6: '6',
+    7: '7',
+    8: '8',
+    9: '9',
+    power: 'Power',
+    eject: 'Eject',
+    abort: 'Abort',
+    help: 'Help',
+    backspace: 'Backspace',
+    tab: 'Tab',
+    numpad5: 'Numpad5',
+    numpadenter: 'NumpadEnter',
+    enter: 'Enter',
+    '\r': '\r',
+    '\n': '\n',
+    shiftleft: 'ShiftLeft',
+    shiftright: 'ShiftRight',
+    controlleft: 'ControlLeft',
+    controlright: 'ControlRight',
+    altleft: 'AltLeft',
+    altright: 'AltRight',
+    pause: 'Pause',
+    capslock: 'CapsLock',
+    escape: 'Escape',
+    convert: 'Convert',
+    nonconvert: 'NonConvert',
+    space: 'Space',
+    numpad9: 'Numpad9',
+    pageup: 'PageUp',
+    numpad3: 'Numpad3',
+    pagedown: 'PageDown',
+    end: 'End',
+    numpad1: 'Numpad1',
+    home: 'Home',
+    numpad7: 'Numpad7',
+    arrowleft: 'ArrowLeft',
+    numpad4: 'Numpad4',
+    numpad8: 'Numpad8',
+    arrowup: 'ArrowUp',
+    arrowright: 'ArrowRight',
+    numpad6: 'Numpad6',
+    numpad2: 'Numpad2',
+    arrowdown: 'ArrowDown',
+    select: 'Select',
+    open: 'Open',
+    printscreen: 'PrintScreen',
+    insert: 'Insert',
+    numpad0: 'Numpad0',
+    delete: 'Delete',
+    numpaddecimal: 'NumpadDecimal',
+    digit0: 'Digit0',
+    digit1: 'Digit1',
+    digit2: 'Digit2',
+    digit3: 'Digit3',
+    digit4: 'Digit4',
+    digit5: 'Digit5',
+    digit6: 'Digit6',
+    digit7: 'Digit7',
+    digit8: 'Digit8',
+    digit9: 'Digit9',
+    keya: 'KeyA',
+    keyb: 'KeyB',
+    keyc: 'KeyC',
+    keyd: 'KeyD',
+    keye: 'KeyE',
+    keyf: 'KeyF',
+    keyg: 'KeyG',
+    keyh: 'KeyH',
+    keyi: 'KeyI',
+    keyj: 'KeyJ',
+    keyk: 'KeyK',
+    keyl: 'KeyL',
+    keym: 'KeyM',
+    keyn: 'KeyN',
+    keyo: 'KeyO',
+    keyp: 'KeyP',
+    keyq: 'KeyQ',
+    keyr: 'KeyR',
+    keys: 'KeyS',
+    keyt: 'KeyT',
+    keyu: 'KeyU',
+    keyv: 'KeyV',
+    keyw: 'KeyW',
+    keyx: 'KeyX',
+    keyy: 'KeyY',
+    keyz: 'KeyZ',
+    metaleft: 'MetaLeft',
+    metaright: 'MetaRight',
+    contextmenu: 'ContextMenu',
+    numpadmultiply: 'NumpadMultiply',
+    numpadadd: 'NumpadAdd',
+    numpadsubtract: 'NumpadSubtract',
+    numpaddivide: 'NumpadDivide',
+    f1: 'F1',
+    f2: 'F2',
+    f3: 'F3',
+    f4: 'F4',
+    f5: 'F5',
+    f6: 'F6',
+    f7: 'F7',
+    f8: 'F8',
+    f9: 'F9',
+    f10: 'F10',
+    f11: 'F11',
+    f12: 'F12',
+    f13: 'F13',
+    f14: 'F14',
+    f15: 'F15',
+    f16: 'F16',
+    f17: 'F17',
+    f18: 'F18',
+    f19: 'F19',
+    f20: 'F20',
+    f21: 'F21',
+    f22: 'F22',
+    f23: 'F23',
+    f24: 'F24',
+    numlock: 'NumLock',
+    scrolllock: 'ScrollLock',
+    audiovolumemute: 'AudioVolumeMute',
+    audiovolumedown: 'AudioVolumeDown',
+    audiovolumeup: 'AudioVolumeUp',
+    mediatracknext: 'MediaTrackNext',
+    mediatrackprevious: 'MediaTrackPrevious',
+    mediastop: 'MediaStop',
+    mediaplaypause: 'MediaPlayPause',
+    semicolon: 'Semicolon',
+    equal: 'Equal',
+    numpadequal: 'NumpadEqual',
+    comma: 'Comma',
+    minus: 'Minus',
+    period: 'Period',
+    slash: 'Slash',
+    backquote: 'Backquote',
+    bracketleft: 'BracketLeft',
+    backslash: 'Backslash',
+    bracketright: 'BracketRight',
+    quote: 'Quote',
+    altgraph: 'AltGraph',
+    props: 'Props',
+    cancel: 'Cancel',
+    clear: 'Clear',
+    shift: 'Shift',
+    control: 'Control',
+    alt: 'Alt',
+    accept: 'Accept',
+    modechange: 'ModeChange',
+    ' ': ' ',
+    print: 'Print',
+    execute: 'Execute',
+    '\u0000': '\u0000',
+    a: 'A',
+    b: 'B',
+    c: 'C',
+    d: 'D',
+    e: 'E',
+    f: 'F',
+    g: 'G',
+    h: 'H',
+    i: 'I',
+    j: 'J',
+    k: 'K',
+    l: 'L',
+    m: 'M',
+    n: 'N',
+    o: 'O',
+    p: 'P',
+    q: 'Q',
+    r: 'R',
+    s: 'S',
+    t: 'T',
+    u: 'U',
+    v: 'V',
+    w: 'W',
+    x: 'X',
+    y: 'Y',
+    z: 'Z',
+    meta: 'Meta',
+    '*': '*',
+    '+': '+',
+    '-': '-',
+    '/': '/',
+    ';': ';',
+    '=': '=',
+    ',': ',',
+    '.': '.',
+    '`': '`',
+    '[': '[',
+    '\\': '\\',
+    ']': ']',
+    "'": "'",
+    attn: 'Attn',
+    crsel: 'CrSel',
+    exsel: 'ExSel',
+    eraseeof: 'EraseEof',
+    play: 'Play',
+    zoomout: 'ZoomOut',
+    ')': ')',
+    '!': '!',
+    '@': '@',
+    '#': '#',
+    $: '$',
+    '%': '%',
+    '^': '^',
+    '&': '&',
+    '(': '(',
+    ':': ':',
+    '<': '<',
+    _: '_',
+    '>': '>',
+    '?': '?',
+    '~': '~',
+    '{': '{',
+    '|': '|',
+    '}': '}',
+    '"': '"',
+    softleft: 'SoftLeft',
+    softright: 'SoftRight',
+    camera: 'Camera',
+    call: 'Call',
+    endcall: 'EndCall',
+    volumedown: 'VolumeDown',
+    volumeup: 'VolumeUp'
+};
+export { KEY_ABBR_TO_STANDARD_MAP, KEY_LOW_TO_STANDARD_MAP, MAC_SYSTEM_HOTKEY_MAP };
+
+//# sourceMappingURL=key-map.mjs.map

package/dist/actions/key-map.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions/key-map.mjs","sources":["webpack://@agent-infra/browser/./src/actions/key-map.ts"],"sourcesContent":["/**\n * The following code is modified based on\n * https://github.com/puppeteer/puppeteer/blob/main/packages/puppeteer-core/src/common/USKeyboardLayout.ts\n *\n * Copyright 2017 Google Inc.\n * SPDX-License-Identifier: Apache-2.0\n * https://github.com/puppeteer/puppeteer/blob/main/LICENSE\n */\nimport type { KeyInput } from 'puppeteer-core';\n\n/**\n * Only adapt for common macOS system hotkeys\n *\n * See issues:\n * - https://github.com/bytedance/UI-TARS-desktop/pull/560\n *\n * References:\n * - Mac shortcuts list: https://support.apple.com/zh-cn/102650\n * - Chrome: https://support.google.com/chrome/answer/157179\n * - CDP: https://chromedevtools.github.io/devtools-protocol/tot/Input/#method-dispatchKeyEvent\n * - Commands: https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/editing/commands/editor_command_names.h\n */\nexport const MAC_SYSTEM_HOTKEY_MAP = new Map<\n  string,\n  { key: KeyInput; commands: string }\n>([\n  ['CorM+A', { key: 'KeyA', commands: 'SelectAll' }],\n  ['CorM+KeyA', { key: 'KeyA', commands: 'SelectAll' }],\n\n  ['CorM+X', { key: 'KeyX', commands: 'Cut' }],\n  ['CorM+KeyX', { key: 'KeyX', commands: 'Cut' }],\n\n  ['CorM+C', { key: 'KeyC', commands: 'Copy' }],\n  ['CorM+KeyC', { key: 'KeyC', commands: 'Copy' }],\n\n  ['CorM+V', { key: 'KeyV', commands: 'Paste' }],\n  ['CorM+KeyV', { key: 'KeyV', commands: 'Paste' }],\n\n  ['CorM+Z', { key: 'KeyZ', commands: 'Undo' }],\n  ['CorM+KeyZ', { key: 'KeyZ', commands: 'Undo' }],\n\n  ['CorM+Y', { key: 'KeyY', commands: 'Redo' }],\n  ['CorM+KeyY', { key: 'KeyY', commands: 'Redo' }],\n  ['CorM+Shift+Z', { key: 'KeyZ', commands: 'Redo' }],\n  ['CorM+Shift+KeyZ', { key: 'KeyZ', commands: 'Redo' }],\n  ['Shift+CorM+Z', { key: 'KeyZ', commands: 'Redo' }],\n  ['Shift+CorM+KeyZ', { key: 'KeyZ', commands: 'Redo' }],\n]);\n\nexport const KEY_ABBR_TO_STANDARD_MAP: Readonly<Record<string, KeyInput>> = {\n  // modifier keys\n  ctrl: 'Control',\n  cmd: 'Meta', // macOS only\n  command: 'Meta', // macOS only\n  opt: 'Alt', // macOS only\n  option: 'Alt', // macOS only\n  // arraw keys\n  up: 'ArrowUp',\n  down: 'ArrowDown',\n  left: 'ArrowLeft',\n  right: 'ArrowRight',\n  // others\n  esc: 'Escape',\n  del: 'Delete',\n  ins: 'Insert',\n  pgup: 'PageUp',\n  pgdown: 'PageDown',\n  return: 'Enter',\n};\n\n// Auto-generated form puppeteer-core/src/common/USKeyboardLayout.ts _keyDefinitions\nexport const KEY_LOW_TO_STANDARD_MAP: Readonly<Record<string, KeyInput>> = {\n  '0': '0',\n  '1': '1',\n  '2': '2',\n  '3': '3',\n  '4': '4',\n  '5': '5',\n  '6': '6',\n  '7': '7',\n  '8': '8',\n  '9': '9',\n  power: 'Power',\n  eject: 'Eject',\n  abort: 'Abort',\n  help: 'Help',\n  backspace: 'Backspace',\n  tab: 'Tab',\n  numpad5: 'Numpad5',\n  numpadenter: 'NumpadEnter',\n  enter: 'Enter',\n  '\\r': '\\r',\n  '\\n': '\\n',\n  shiftleft: 'ShiftLeft',\n  shiftright: 'ShiftRight',\n  controlleft: 'ControlLeft',\n  controlright: 'ControlRight',\n  altleft: 'AltLeft',\n  altright: 'AltRight',\n  pause: 'Pause',\n  capslock: 'CapsLock',\n  escape: 'Escape',\n  convert: 'Convert',\n  nonconvert: 'NonConvert',\n  space: 'Space',\n  numpad9: 'Numpad9',\n  pageup: 'PageUp',\n  numpad3: 'Numpad3',\n  pagedown: 'PageDown',\n  end: 'End',\n  numpad1: 'Numpad1',\n  home: 'Home',\n  numpad7: 'Numpad7',\n  arrowleft: 'ArrowLeft',\n  numpad4: 'Numpad4',\n  numpad8: 'Numpad8',\n  arrowup: 'ArrowUp',\n  arrowright: 'ArrowRight',\n  numpad6: 'Numpad6',\n  numpad2: 'Numpad2',\n  arrowdown: 'ArrowDown',\n  select: 'Select',\n  open: 'Open',\n  printscreen: 'PrintScreen',\n  insert: 'Insert',\n  numpad0: 'Numpad0',\n  delete: 'Delete',\n  numpaddecimal: 'NumpadDecimal',\n  digit0: 'Digit0',\n  digit1: 'Digit1',\n  digit2: 'Digit2',\n  digit3: 'Digit3',\n  digit4: 'Digit4',\n  digit5: 'Digit5',\n  digit6: 'Digit6',\n  digit7: 'Digit7',\n  digit8: 'Digit8',\n  digit9: 'Digit9',\n  keya: 'KeyA',\n  keyb: 'KeyB',\n  keyc: 'KeyC',\n  keyd: 'KeyD',\n  keye: 'KeyE',\n  keyf: 'KeyF',\n  keyg: 'KeyG',\n  keyh: 'KeyH',\n  keyi: 'KeyI',\n  keyj: 'KeyJ',\n  keyk: 'KeyK',\n  keyl: 'KeyL',\n  keym: 'KeyM',\n  keyn: 'KeyN',\n  keyo: 'KeyO',\n  keyp: 'KeyP',\n  keyq: 'KeyQ',\n  keyr: 'KeyR',\n  keys: 'KeyS',\n  keyt: 'KeyT',\n  keyu: 'KeyU',\n  keyv: 'KeyV',\n  keyw: 'KeyW',\n  keyx: 'KeyX',\n  keyy: 'KeyY',\n  keyz: 'KeyZ',\n  metaleft: 'MetaLeft',\n  metaright: 'MetaRight',\n  contextmenu: 'ContextMenu',\n  numpadmultiply: 'NumpadMultiply',\n  numpadadd: 'NumpadAdd',\n  numpadsubtract: 'NumpadSubtract',\n  numpaddivide: 'NumpadDivide',\n  f1: 'F1',\n  f2: 'F2',\n  f3: 'F3',\n  f4: 'F4',\n  f5: 'F5',\n  f6: 'F6',\n  f7: 'F7',\n  f8: 'F8',\n  f9: 'F9',\n  f10: 'F10',\n  f11: 'F11',\n  f12: 'F12',\n  f13: 'F13',\n  f14: 'F14',\n  f15: 'F15',\n  f16: 'F16',\n  f17: 'F17',\n  f18: 'F18',\n  f19: 'F19',\n  f20: 'F20',\n  f21: 'F21',\n  f22: 'F22',\n  f23: 'F23',\n  f24: 'F24',\n  numlock: 'NumLock',\n  scrolllock: 'ScrollLock',\n  audiovolumemute: 'AudioVolumeMute',\n  audiovolumedown: 'AudioVolumeDown',\n  audiovolumeup: 'AudioVolumeUp',\n  mediatracknext: 'MediaTrackNext',\n  mediatrackprevious: 'MediaTrackPrevious',\n  mediastop: 'MediaStop',\n  mediaplaypause: 'MediaPlayPause',\n  semicolon: 'Semicolon',\n  equal: 'Equal',\n  numpadequal: 'NumpadEqual',\n  comma: 'Comma',\n  minus: 'Minus',\n  period: 'Period',\n  slash: 'Slash',\n  backquote: 'Backquote',\n  bracketleft: 'BracketLeft',\n  backslash: 'Backslash',\n  bracketright: 'BracketRight',\n  quote: 'Quote',\n  altgraph: 'AltGraph',\n  props: 'Props',\n  cancel: 'Cancel',\n  clear: 'Clear',\n  shift: 'Shift',\n  control: 'Control',\n  alt: 'Alt',\n  accept: 'Accept',\n  modechange: 'ModeChange',\n  ' ': ' ',\n  print: 'Print',\n  execute: 'Execute',\n  '\\u0000': '\\u0000',\n  a: 'A',\n  b: 'B',\n  c: 'C',\n  d: 'D',\n  e: 'E',\n  f: 'F',\n  g: 'G',\n  h: 'H',\n  i: 'I',\n  j: 'J',\n  k: 'K',\n  l: 'L',\n  m: 'M',\n  n: 'N',\n  o: 'O',\n  p: 'P',\n  q: 'Q',\n  r: 'R',\n  s: 'S',\n  t: 'T',\n  u: 'U',\n  v: 'V',\n  w: 'W',\n  x: 'X',\n  y: 'Y',\n  z: 'Z',\n  meta: 'Meta',\n  '*': '*',\n  '+': '+',\n  '-': '-',\n  '/': '/',\n  ';': ';',\n  '=': '=',\n  ',': ',',\n  '.': '.',\n  '`': '`',\n  '[': '[',\n  '\\\\': '\\\\',\n  ']': ']',\n  \"'\": \"'\",\n  attn: 'Attn',\n  crsel: 'CrSel',\n  exsel: 'ExSel',\n  eraseeof: 'EraseEof',\n  play: 'Play',\n  zoomout: 'ZoomOut',\n  ')': ')',\n  '!': '!',\n  '@': '@',\n  '#': '#',\n  $: '$',\n  '%': '%',\n  '^': '^',\n  '&': '&',\n  '(': '(',\n  ':': ':',\n  '<': '<',\n  _: '_',\n  '>': '>',\n  '?': '?',\n  '~': '~',\n  '{': '{',\n  '|': '|',\n  '}': '}',\n  '\"': '\"',\n  softleft: 'SoftLeft',\n  softright: 'SoftRight',\n  camera: 'Camera',\n  call: 'Call',\n  endcall: 'EndCall',\n  volumedown: 'VolumeDown',\n  volumeup: 'VolumeUp',\n};\n"],"names":["MAC_SYSTEM_HOTKEY_MAP","Map","KEY_ABBR_TO_STANDARD_MAP","KEY_LOW_TO_STANDARD_MAP"],"mappings":"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AAa;IACb,WAAW;IACX,cAAc;IACd,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,OAAO;IACP,OAAO;IACP,SAAS;IACT,KAAK;IACL,QAAQ;IACR,YAAY;IACZ,KAAK;IACL,OAAO;IACP,SAAS;IACT,UAAU;IACV,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,OAAO;IACP,UAAU;IACV,MAAM;IACN,SAAS;IACT,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,GAAG;IACH,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,GAAG;IACH,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,UAAU;IACV,WAAW;IACX,QAAQ;IACR,MAAM;IACN,SAAS;IACT,YAAY;IACZ,UAAU;AACZ"}

package/dist/actions/keyboard.d.ts

@@ -0,0 +1,21 @@
+import type { Page } from 'puppeteer-core';
+import type { EnvInfo, KeyboardOptions, KeyOrHotKeyInput, ActionResult } from '../types';
+import type { TabDialog } from '../tabs/dialog';
+export declare class Keyboard {
+    #private;
+    constructor(page: Page, dialog: TabDialog, env: EnvInfo);
+    /**
+     * Enhance puppeteer's [keyboard.press()](https://pptr.dev/api/puppeteer.keyboard.press) to support combination hotkeys.
+     */
+    press(key: KeyOrHotKeyInput, options?: KeyboardOptions): Promise<ActionResult>;
+    /**
+     * Enhance puppeteer's [keyboard.down()](https://pptr.dev/api/puppeteer.keyboard.down) to support combination hotkeys.
+     */
+    down(key: KeyOrHotKeyInput, options?: KeyboardOptions): Promise<ActionResult>;
+    /**
+     * Enhance puppeteer's [keyboard.up()](https://pptr.dev/api/puppeteer.keyboard.up) to support combination hotkeys.
+     */
+    up(key: KeyOrHotKeyInput): Promise<ActionResult>;
+    type(text: string, options?: KeyboardOptions): Promise<ActionResult>;
+}
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/actions/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/actions/keyboard.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAY,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EACV,OAAO,EAEP,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,qBAAa,QAAQ;;gBAKP,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO;IAMvD;;OAEG;IACG,KAAK,CACT,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC;IA0BxB;;OAEG;IACG,IAAI,CACR,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC;IAqBxB;;OAEG;IACG,EAAE,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAchD,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC;CAoFzB"}

package/dist/actions/keyboard.js

@@ -0,0 +1,196 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    Keyboard: ()=>Keyboard
+});
+const external_delay_namespaceObject = require("delay");
+var external_delay_default = /*#__PURE__*/ __webpack_require__.n(external_delay_namespaceObject);
+const external_key_map_js_namespaceObject = require("./key-map.js");
+function _check_private_redeclaration(obj, privateCollection) {
+    if (privateCollection.has(obj)) throw new TypeError("Cannot initialize the same private elements twice on an object");
+}
+function _class_apply_descriptor_get(receiver, descriptor) {
+    if (descriptor.get) return descriptor.get.call(receiver);
+    return descriptor.value;
+}
+function _class_apply_descriptor_set(receiver, descriptor, value) {
+    if (descriptor.set) descriptor.set.call(receiver, value);
+    else {
+        if (!descriptor.writable) throw new TypeError("attempted to set read only private field");
+        descriptor.value = value;
+    }
+}
+function _class_extract_field_descriptor(receiver, privateMap, action) {
+    if (!privateMap.has(receiver)) throw new TypeError("attempted to " + action + " private field on non-instance");
+    return privateMap.get(receiver);
+}
+function _class_private_field_get(receiver, privateMap) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
+    return _class_apply_descriptor_get(receiver, descriptor);
+}
+function _class_private_field_init(obj, privateMap, value) {
+    _check_private_redeclaration(obj, privateMap);
+    privateMap.set(obj, value);
+}
+function _class_private_field_set(receiver, privateMap, value) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
+    _class_apply_descriptor_set(receiver, descriptor, value);
+    return value;
+}
+function _class_private_method_get(receiver, privateSet, fn) {
+    if (!privateSet.has(receiver)) throw new TypeError("attempted to get private field on non-instance");
+    return fn;
+}
+function _class_private_method_init(obj, privateSet) {
+    _check_private_redeclaration(obj, privateSet);
+    privateSet.add(obj);
+}
+var _page = /*#__PURE__*/ new WeakMap(), _env = /*#__PURE__*/ new WeakMap(), _dialog = /*#__PURE__*/ new WeakMap(), _formatHotkey = /*#__PURE__*/ new WeakSet(), _macOSCDPHotKey = /*#__PURE__*/ new WeakSet(), _buildDialogResponse = /*#__PURE__*/ new WeakSet();
+class Keyboard {
+    async press(key, options = {}) {
+        if (_class_private_field_get(this, _dialog).isOpen) return _class_private_method_get(this, _buildDialogResponse, buildDialogResponse).call(this, 'press');
+        const formattedHotkey = _class_private_method_get(this, _formatHotkey, formatHotkey).call(this, key);
+        if ('macOS' === _class_private_field_get(this, _env).osName && 'Chrome' === _class_private_field_get(this, _env).browserName) {
+            const success = await _class_private_method_get(this, _macOSCDPHotKey, macOSCDPHotKey).call(this, formattedHotkey, options);
+            if (success) return {
+                success: true
+            };
+        }
+        for (const key of formattedHotkey)await _class_private_field_get(this, _page).keyboard.down(key);
+        await external_delay_default()(options.delay ?? 0);
+        for (const key of formattedHotkey.reverse())await _class_private_field_get(this, _page).keyboard.up(key);
+        return {
+            success: true
+        };
+    }
+    async down(key, options = {}) {
+        if (_class_private_field_get(this, _dialog).isOpen) return _class_private_method_get(this, _buildDialogResponse, buildDialogResponse).call(this, 'down');
+        const formattedHotkey = _class_private_method_get(this, _formatHotkey, formatHotkey).call(this, key);
+        if ('macOS' === _class_private_field_get(this, _env).osName && 'Chrome' === _class_private_field_get(this, _env).browserName) {
+            const success = await _class_private_method_get(this, _macOSCDPHotKey, macOSCDPHotKey).call(this, formattedHotkey, options);
+            if (success) return {
+                success: true
+            };
+        }
+        for (const key of formattedHotkey)await _class_private_field_get(this, _page).keyboard.down(key);
+        return {
+            success: true
+        };
+    }
+    async up(key) {
+        if (_class_private_field_get(this, _dialog).isOpen) return _class_private_method_get(this, _buildDialogResponse, buildDialogResponse).call(this, 'up');
+        const formattedHotkey = _class_private_method_get(this, _formatHotkey, formatHotkey).call(this, key);
+        for (const key of formattedHotkey.reverse())await _class_private_field_get(this, _page).keyboard.up(key);
+        return {
+            success: true
+        };
+    }
+    async type(text, options = {}) {
+        if (_class_private_field_get(this, _dialog).isOpen) return _class_private_method_get(this, _buildDialogResponse, buildDialogResponse).call(this, 'type');
+        if (text.length < 15 && options.delay) await _class_private_field_get(this, _page).keyboard.type(text, options);
+        else await _class_private_field_get(this, _page).keyboard.sendCharacter(text);
+        return {
+            success: true
+        };
+    }
+    constructor(page, dialog, env){
+        _class_private_method_init(this, _formatHotkey);
+        _class_private_method_init(this, _macOSCDPHotKey);
+        _class_private_method_init(this, _buildDialogResponse);
+        _class_private_field_init(this, _page, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _env, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _dialog, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_set(this, _page, page);
+        _class_private_field_set(this, _dialog, dialog);
+        _class_private_field_set(this, _env, env);
+    }
+}
+function formatHotkey(hotkey) {
+    const lowerCaseHotkey = hotkey.toLowerCase();
+    const keys = lowerCaseHotkey.split(/[\s+]+/);
+    const formattedKeys = keys.map((key)=>{
+        if (external_key_map_js_namespaceObject.KEY_ABBR_TO_STANDARD_MAP[key]) return external_key_map_js_namespaceObject.KEY_ABBR_TO_STANDARD_MAP[key];
+        if (external_key_map_js_namespaceObject.KEY_LOW_TO_STANDARD_MAP[key]) return external_key_map_js_namespaceObject.KEY_LOW_TO_STANDARD_MAP[key];
+        throw new Error('Unsupported key: ' + key);
+    });
+    return formattedKeys;
+}
+async function macOSCDPHotKey(keys, options) {
+    const hotkey = keys.map((key)=>{
+        if ('Control' === key || 'Meta' === key) return 'CorM';
+        return key;
+    }).join('+');
+    const command = external_key_map_js_namespaceObject.MAC_SYSTEM_HOTKEY_MAP.get(hotkey);
+    if (command) {
+        await _class_private_field_get(this, _page).keyboard.down(command.key, {
+            commands: [
+                command.commands
+            ]
+        });
+        await external_delay_default()(options.delay ?? 0);
+        await _class_private_field_get(this, _page).keyboard.up(command.key);
+        return true;
+    }
+    return false;
+}
+function buildDialogResponse(type) {
+    return {
+        success: false,
+        message: `Cannot perform keyboard.${type}() operation because there is a dialog on the current page.`,
+        detail: _class_private_field_get(this, _dialog).meta
+    };
+}
+exports.Keyboard = __webpack_exports__.Keyboard;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "Keyboard"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=keyboard.js.map