indusagi 0.12.32 → 0.12.33

package/local-dist-new/ui/keys.js

@@ -1,1093 +0,0 @@
-/**
- * Keyboard input handling for terminal applications.
- *
- * Supports both legacy terminal sequences and Kitty keyboard protocol.
- * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
- * Reference: https://github.com/sst/opentui/blob/7da92b4088aebfe27b9f691c04163a48821e49fd/packages/core/src/lib/parse.keypress.ts
- *
- * Symbol keys are also supported, however some ctrl+symbol combos
- * overlap with ASCII codes, e.g. ctrl+[ = ESC.
- * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/#legacy-ctrl-mapping-of-ascii-keys
- * Those can still be * used for ctrl+shift combos
- *
- * API:
- * - matchesKey(data, keyId) - Check if input matches a key identifier
- * - parseKey(data) - Parse input and return the key identifier
- * - Key - Helper object for creating typed key identifiers
- * - setKittyProtocolActive(active) - Set global Kitty protocol state
- * - isKittyProtocolActive() - Query global Kitty protocol state
- */
-// =============================================================================
-// Global Kitty Protocol State
-// =============================================================================
-let _kittyProtocolActive = false;
-/**
- * Set the global Kitty keyboard protocol state.
- * Called by ProcessTerminal after detecting protocol support.
- */
-export function setKittyProtocolActive(active) {
-    _kittyProtocolActive = active;
-}
-/**
- * Query whether Kitty keyboard protocol is currently active.
- */
-export function isKittyProtocolActive() {
-    return _kittyProtocolActive;
-}
-// =============================================================================
-// Type-Safe Key Identifiers
-// =============================================================================
-const LETTER_VALUES = [
-    "a",
-    "b",
-    "c",
-    "d",
-    "e",
-    "f",
-    "g",
-    "h",
-    "i",
-    "j",
-    "k",
-    "l",
-    "m",
-    "n",
-    "o",
-    "p",
-    "q",
-    "r",
-    "s",
-    "t",
-    "u",
-    "v",
-    "w",
-    "x",
-    "y",
-    "z",
-];
-const SYMBOL_VALUES = [
-    "`",
-    "-",
-    "=",
-    "[",
-    "]",
-    "\\",
-    ";",
-    "'",
-    ",",
-    ".",
-    "/",
-    "!",
-    "@",
-    "#",
-    "$",
-    "%",
-    "^",
-    "&",
-    "*",
-    "(",
-    ")",
-    "_",
-    "+",
-    "|",
-    "~",
-    "{",
-    "}",
-    ":",
-    "<",
-    ">",
-    "?",
-];
-const SPECIAL_KEY_VALUES = [
-    "escape",
-    "esc",
-    "enter",
-    "return",
-    "tab",
-    "space",
-    "backspace",
-    "delete",
-    "insert",
-    "clear",
-    "home",
-    "end",
-    "pageUp",
-    "pageDown",
-    "up",
-    "down",
-    "left",
-    "right",
-    "f1",
-    "f2",
-    "f3",
-    "f4",
-    "f5",
-    "f6",
-    "f7",
-    "f8",
-    "f9",
-    "f10",
-    "f11",
-    "f12",
-];
-const SPECIAL_KEY_LITERAL_MAP = {
-    escape: "escape",
-    esc: "esc",
-    enter: "enter",
-    return: "return",
-    tab: "tab",
-    space: "space",
-    backspace: "backspace",
-    delete: "delete",
-    insert: "insert",
-    clear: "clear",
-    home: "home",
-    end: "end",
-    pageUp: "pageUp",
-    pageDown: "pageDown",
-    up: "up",
-    down: "down",
-    left: "left",
-    right: "right",
-    f1: "f1",
-    f2: "f2",
-    f3: "f3",
-    f4: "f4",
-    f5: "f5",
-    f6: "f6",
-    f7: "f7",
-    f8: "f8",
-    f9: "f9",
-    f10: "f10",
-    f11: "f11",
-    f12: "f12",
-};
-const SYMBOL_KEY_LITERAL_MAP = {
-    backtick: "`",
-    hyphen: "-",
-    equals: "=",
-    leftbracket: "[",
-    rightbracket: "]",
-    backslash: "\\",
-    semicolon: ";",
-    quote: "'",
-    comma: ",",
-    period: ".",
-    slash: "/",
-    exclamation: "!",
-    at: "@",
-    hash: "#",
-    dollar: "$",
-    percent: "%",
-    caret: "^",
-    ampersand: "&",
-    asterisk: "*",
-    leftparen: "(",
-    rightparen: ")",
-    underscore: "_",
-    plus: "+",
-    pipe: "|",
-    tilde: "~",
-    leftbrace: "{",
-    rightbrace: "}",
-    colon: ":",
-    lessthan: "<",
-    greaterthan: ">",
-    question: "?",
-};
-/**
- * Helper object for creating typed key identifiers with autocomplete.
- *
- * Usage:
- * - Key.escape, Key.enter, Key.tab, etc. for special keys
- * - Key.backtick, Key.comma, Key.period, etc. for symbol keys
- * - Key.ctrl("c"), Key.alt("x") for single modifier
- * - Key.ctrlShift("p"), Key.ctrlAlt("x") for combined modifiers
- */
-export const Key = {
-    ...SPECIAL_KEY_LITERAL_MAP,
-    ...SYMBOL_KEY_LITERAL_MAP,
-    ctrl: (key) => `ctrl+${key}`,
-    shift: (key) => `shift+${key}`,
-    alt: (key) => `alt+${key}`,
-    ctrlShift: (key) => `ctrl+shift+${key}`,
-    shiftCtrl: (key) => `shift+ctrl+${key}`,
-    ctrlAlt: (key) => `ctrl+alt+${key}`,
-    altCtrl: (key) => `alt+ctrl+${key}`,
-    shiftAlt: (key) => `shift+alt+${key}`,
-    altShift: (key) => `alt+shift+${key}`,
-    ctrlShiftAlt: (key) => `ctrl+shift+alt+${key}`,
-};
-// =============================================================================
-// Constants
-// =============================================================================
-const SYMBOL_KEYS = new Set([
-    "`",
-    "-",
-    "=",
-    "[",
-    "]",
-    "\\",
-    ";",
-    "'",
-    ",",
-    ".",
-    "/",
-    "!",
-    "@",
-    "#",
-    "$",
-    "%",
-    "^",
-    "&",
-    "*",
-    "(",
-    ")",
-    "_",
-    "+",
-    "|",
-    "~",
-    "{",
-    "}",
-    ":",
-    "<",
-    ">",
-    "?",
-]);
-const MODIFIERS = {
-    shift: 1,
-    alt: 2,
-    ctrl: 4,
-};
-const LOCK_MASK = 64 + 128; // Caps Lock + Num Lock
-const CODEPOINTS = {
-    escape: 27,
-    tab: 9,
-    enter: 13,
-    space: 32,
-    backspace: 127,
-    kpEnter: 57414, // Numpad Enter (Kitty protocol)
-};
-const ARROW_CODEPOINTS = {
-    up: -1,
-    down: -2,
-    right: -3,
-    left: -4,
-};
-const FUNCTIONAL_CODEPOINTS = {
-    delete: -10,
-    insert: -11,
-    pageUp: -12,
-    pageDown: -13,
-    home: -14,
-    end: -15,
-};
-const LEGACY_KEY_SEQUENCES = {
-    up: ["\x1b[A", "\x1bOA"],
-    down: ["\x1b[B", "\x1bOB"],
-    right: ["\x1b[C", "\x1bOC"],
-    left: ["\x1b[D", "\x1bOD"],
-    home: ["\x1b[H", "\x1bOH", "\x1b[1~", "\x1b[7~"],
-    end: ["\x1b[F", "\x1bOF", "\x1b[4~", "\x1b[8~"],
-    insert: ["\x1b[2~"],
-    delete: ["\x1b[3~"],
-    pageUp: ["\x1b[5~", "\x1b[[5~"],
-    pageDown: ["\x1b[6~", "\x1b[[6~"],
-    clear: ["\x1b[E", "\x1bOE"],
-    f1: ["\x1bOP", "\x1b[11~", "\x1b[[A"],
-    f2: ["\x1bOQ", "\x1b[12~", "\x1b[[B"],
-    f3: ["\x1bOR", "\x1b[13~", "\x1b[[C"],
-    f4: ["\x1bOS", "\x1b[14~", "\x1b[[D"],
-    f5: ["\x1b[15~", "\x1b[[E"],
-    f6: ["\x1b[17~"],
-    f7: ["\x1b[18~"],
-    f8: ["\x1b[19~"],
-    f9: ["\x1b[20~"],
-    f10: ["\x1b[21~"],
-    f11: ["\x1b[23~"],
-    f12: ["\x1b[24~"],
-};
-const LEGACY_SHIFT_SEQUENCES = {
-    up: ["\x1b[a"],
-    down: ["\x1b[b"],
-    right: ["\x1b[c"],
-    left: ["\x1b[d"],
-    clear: ["\x1b[e"],
-    insert: ["\x1b[2$"],
-    delete: ["\x1b[3$"],
-    pageUp: ["\x1b[5$"],
-    pageDown: ["\x1b[6$"],
-    home: ["\x1b[7$"],
-    end: ["\x1b[8$"],
-};
-const LEGACY_CTRL_SEQUENCES = {
-    up: ["\x1bOa"],
-    down: ["\x1bOb"],
-    right: ["\x1bOc"],
-    left: ["\x1bOd"],
-    clear: ["\x1bOe"],
-    insert: ["\x1b[2^"],
-    delete: ["\x1b[3^"],
-    pageUp: ["\x1b[5^"],
-    pageDown: ["\x1b[6^"],
-    home: ["\x1b[7^"],
-    end: ["\x1b[8^"],
-};
-const LEGACY_SEQUENCE_KEY_IDS = {
-    "\x1bOA": "up",
-    "\x1bOB": "down",
-    "\x1bOC": "right",
-    "\x1bOD": "left",
-    "\x1bOH": "home",
-    "\x1bOF": "end",
-    "\x1b[E": "clear",
-    "\x1bOE": "clear",
-    "\x1bOe": "ctrl+clear",
-    "\x1b[e": "shift+clear",
-    "\x1b[2~": "insert",
-    "\x1b[2$": "shift+insert",
-    "\x1b[2^": "ctrl+insert",
-    "\x1b[3$": "shift+delete",
-    "\x1b[3^": "ctrl+delete",
-    "\x1b[[5~": "pageUp",
-    "\x1b[[6~": "pageDown",
-    "\x1b[a": "shift+up",
-    "\x1b[b": "shift+down",
-    "\x1b[c": "shift+right",
-    "\x1b[d": "shift+left",
-    "\x1bOa": "ctrl+up",
-    "\x1bOb": "ctrl+down",
-    "\x1bOc": "ctrl+right",
-    "\x1bOd": "ctrl+left",
-    "\x1b[5$": "shift+pageUp",
-    "\x1b[6$": "shift+pageDown",
-    "\x1b[7$": "shift+home",
-    "\x1b[8$": "shift+end",
-    "\x1b[5^": "ctrl+pageUp",
-    "\x1b[6^": "ctrl+pageDown",
-    "\x1b[7^": "ctrl+home",
-    "\x1b[8^": "ctrl+end",
-    "\x1bOP": "f1",
-    "\x1bOQ": "f2",
-    "\x1bOR": "f3",
-    "\x1bOS": "f4",
-    "\x1b[11~": "f1",
-    "\x1b[12~": "f2",
-    "\x1b[13~": "f3",
-    "\x1b[14~": "f4",
-    "\x1b[[A": "f1",
-    "\x1b[[B": "f2",
-    "\x1b[[C": "f3",
-    "\x1b[[D": "f4",
-    "\x1b[[E": "f5",
-    "\x1b[15~": "f5",
-    "\x1b[17~": "f6",
-    "\x1b[18~": "f7",
-    "\x1b[19~": "f8",
-    "\x1b[20~": "f9",
-    "\x1b[21~": "f10",
-    "\x1b[23~": "f11",
-    "\x1b[24~": "f12",
-    "\x1bb": "alt+left",
-    "\x1bf": "alt+right",
-    "\x1bp": "alt+up",
-    "\x1bn": "alt+down",
-};
-const matchesLegacySequence = (data, sequences) => sequences.includes(data);
-const matchesLegacyModifierSequence = (data, key, modifier) => {
-    if (modifier === MODIFIERS.shift) {
-        return matchesLegacySequence(data, LEGACY_SHIFT_SEQUENCES[key]);
-    }
-    if (modifier === MODIFIERS.ctrl) {
-        return matchesLegacySequence(data, LEGACY_CTRL_SEQUENCES[key]);
-    }
-    return false;
-};
-// Store the last parsed event type for isKeyRelease() to query
-let _lastEventType = "press";
-/**
- * Check if the last parsed key event was a key release.
- * Only meaningful when Kitty keyboard protocol with flag 2 is active.
- */
-export function isKeyRelease(data) {
-    // Don't treat bracketed paste content as key release, even if it contains
-    // patterns like ":3F" (e.g., bluetooth MAC addresses like "90:62:3F:A5").
-    // Terminal.ts re-wraps paste content with bracketed paste markers before
-    // passing to TUI, so pasted data will always contain \x1b[200~.
-    if (data.includes("\x1b[200~")) {
-        return false;
-    }
-    // Quick check: release events with flag 2 contain ":3"
-    // Format: \x1b[<codepoint>;<modifier>:3u
-    if (data.includes(":3u") ||
-        data.includes(":3~") ||
-        data.includes(":3A") ||
-        data.includes(":3B") ||
-        data.includes(":3C") ||
-        data.includes(":3D") ||
-        data.includes(":3H") ||
-        data.includes(":3F")) {
-        return true;
-    }
-    return false;
-}
-/**
- * Check if the last parsed key event was a key repeat.
- * Only meaningful when Kitty keyboard protocol with flag 2 is active.
- */
-export function isKeyRepeat(data) {
-    // Don't treat bracketed paste content as key repeat, even if it contains
-    // patterns like ":2F". See isKeyRelease() for details.
-    if (data.includes("\x1b[200~")) {
-        return false;
-    }
-    if (data.includes(":2u") ||
-        data.includes(":2~") ||
-        data.includes(":2A") ||
-        data.includes(":2B") ||
-        data.includes(":2C") ||
-        data.includes(":2D") ||
-        data.includes(":2H") ||
-        data.includes(":2F")) {
-        return true;
-    }
-    return false;
-}
-function parseEventType(eventTypeStr) {
-    if (!eventTypeStr)
-        return "press";
-    const eventType = parseInt(eventTypeStr, 10);
-    if (eventType === 2)
-        return "repeat";
-    if (eventType === 3)
-        return "release";
-    return "press";
-}
-function parseKittySequence(data) {
-    // CSI u format with alternate keys (flag 4):
-    // \x1b[<codepoint>u
-    // \x1b[<codepoint>;<mod>u
-    // \x1b[<codepoint>;<mod>:<event>u
-    // \x1b[<codepoint>:<shifted>;<mod>u
-    // \x1b[<codepoint>:<shifted>:<base>;<mod>u
-    // \x1b[<codepoint>::<base>;<mod>u (no shifted key, only base)
-    //
-    // With flag 2, event type is appended after modifier colon: 1=press, 2=repeat, 3=release
-    // With flag 4, alternate keys are appended after codepoint with colons
-    const csiUMatch = data.match(/^\x1b\[(\d+)(?::(\d*))?(?::(\d+))?(?:;(\d+))?(?::(\d+))?u$/);
-    if (csiUMatch) {
-        const codepoint = parseInt(csiUMatch[1], 10);
-        const shiftedKey = csiUMatch[2] && csiUMatch[2].length > 0 ? parseInt(csiUMatch[2], 10) : undefined;
-        const baseLayoutKey = csiUMatch[3] ? parseInt(csiUMatch[3], 10) : undefined;
-        const modValue = csiUMatch[4] ? parseInt(csiUMatch[4], 10) : 1;
-        const eventType = parseEventType(csiUMatch[5]);
-        _lastEventType = eventType;
-        return { codepoint, shiftedKey, baseLayoutKey, modifier: modValue - 1, eventType };
-    }
-    // Arrow keys with modifier: \x1b[1;<mod>A/B/C/D or \x1b[1;<mod>:<event>A/B/C/D
-    const arrowMatch = data.match(/^\x1b\[1;(\d+)(?::(\d+))?([ABCD])$/);
-    if (arrowMatch) {
-        const modValue = parseInt(arrowMatch[1], 10);
-        const eventType = parseEventType(arrowMatch[2]);
-        const arrowCodes = { A: -1, B: -2, C: -3, D: -4 };
-        _lastEventType = eventType;
-        return { codepoint: arrowCodes[arrowMatch[3]], modifier: modValue - 1, eventType };
-    }
-    // Functional keys: \x1b[<num>~ or \x1b[<num>;<mod>~ or \x1b[<num>;<mod>:<event>~
-    const funcMatch = data.match(/^\x1b\[(\d+)(?:;(\d+))?(?::(\d+))?~$/);
-    if (funcMatch) {
-        const keyNum = parseInt(funcMatch[1], 10);
-        const modValue = funcMatch[2] ? parseInt(funcMatch[2], 10) : 1;
-        const eventType = parseEventType(funcMatch[3]);
-        const funcCodes = {
-            2: FUNCTIONAL_CODEPOINTS.insert,
-            3: FUNCTIONAL_CODEPOINTS.delete,
-            5: FUNCTIONAL_CODEPOINTS.pageUp,
-            6: FUNCTIONAL_CODEPOINTS.pageDown,
-            7: FUNCTIONAL_CODEPOINTS.home,
-            8: FUNCTIONAL_CODEPOINTS.end,
-        };
-        const codepoint = funcCodes[keyNum];
-        if (codepoint !== undefined) {
-            _lastEventType = eventType;
-            return { codepoint, modifier: modValue - 1, eventType };
-        }
-    }
-    // Home/End with modifier: \x1b[1;<mod>H/F or \x1b[1;<mod>:<event>H/F
-    const homeEndMatch = data.match(/^\x1b\[1;(\d+)(?::(\d+))?([HF])$/);
-    if (homeEndMatch) {
-        const modValue = parseInt(homeEndMatch[1], 10);
-        const eventType = parseEventType(homeEndMatch[2]);
-        const codepoint = homeEndMatch[3] === "H" ? FUNCTIONAL_CODEPOINTS.home : FUNCTIONAL_CODEPOINTS.end;
-        _lastEventType = eventType;
-        return { codepoint, modifier: modValue - 1, eventType };
-    }
-    return null;
-}
-function matchesKittySequence(data, expectedCodepoint, expectedModifier) {
-    const parsed = parseKittySequence(data);
-    if (!parsed)
-        return false;
-    const actualMod = parsed.modifier & ~LOCK_MASK;
-    const expectedMod = expectedModifier & ~LOCK_MASK;
-    // Check if modifiers match
-    if (actualMod !== expectedMod)
-        return false;
-    // Primary match: codepoint matches directly
-    if (parsed.codepoint === expectedCodepoint)
-        return true;
-    // Alternate match: use base layout key for non-Latin keyboard layouts
-    // This allows Ctrl+С (Cyrillic) to match Ctrl+c (Latin) when terminal reports
-    // the base layout key (the key in standard PC-101 layout)
-    if (parsed.baseLayoutKey !== undefined && parsed.baseLayoutKey === expectedCodepoint)
-        return true;
-    return false;
-}
-/**
- * Match xterm modifyOtherKeys format: CSI 27 ; modifiers ; keycode ~
- * This is used by terminals when Kitty protocol is not enabled.
- * Modifier values are 1-indexed: 2=shift, 3=alt, 5=ctrl, etc.
- */
-function matchesModifyOtherKeys(data, expectedKeycode, expectedModifier) {
-    const match = data.match(/^\x1b\[27;(\d+);(\d+)~$/);
-    if (!match)
-        return false;
-    const modValue = parseInt(match[1], 10);
-    const keycode = parseInt(match[2], 10);
-    // Convert from 1-indexed xterm format to our 0-indexed format
-    const actualMod = modValue - 1;
-    return keycode === expectedKeycode && actualMod === expectedModifier;
-}
-// =============================================================================
-// Generic Key Matching
-// =============================================================================
-/**
- * Get the control character for a key.
- * Uses the universal formula: code & 0x1f (mask to lower 5 bits)
- *
- * Works for:
- * - Letters a-z → 1-26
- * - Symbols [\]_ → 27, 28, 29, 31
- * - Also maps - to same as _ (same physical key on US keyboards)
- */
-function rawCtrlChar(key) {
-    const char = key.toLowerCase();
-    const code = char.charCodeAt(0);
-    if ((code >= 97 && code <= 122) || char === "[" || char === "\\" || char === "]" || char === "_") {
-        return String.fromCharCode(code & 0x1f);
-    }
-    // Handle - as _ (same physical key on US keyboards)
-    if (char === "-") {
-        return String.fromCharCode(31); // Same as Ctrl+_
-    }
-    return null;
-}
-const SPECIAL_KEY_ALIASES = {
-    esc: "escape",
-    return: "enter",
-    pageup: "pageUp",
-    pagedown: "pageDown",
-};
-const SPECIAL_KEY_SET = new Set([
-    "escape",
-    "enter",
-    "tab",
-    "space",
-    "backspace",
-    "delete",
-    "insert",
-    "clear",
-    "home",
-    "end",
-    "pageUp",
-    "pageDown",
-    "up",
-    "down",
-    "left",
-    "right",
-    "f1",
-    "f2",
-    "f3",
-    "f4",
-    "f5",
-    "f6",
-    "f7",
-    "f8",
-    "f9",
-    "f10",
-    "f11",
-    "f12",
-]);
-export function normalizeKeyId(keyId) {
-    const parts = keyId.split("+").map((p) => p.trim()).filter(Boolean);
-    if (parts.length === 0)
-        return "";
-    const key = parts[parts.length - 1].toLowerCase();
-    const normalizedKey = SPECIAL_KEY_ALIASES[key] ?? key;
-    const modifierSet = new Set(parts.slice(0, -1).map((p) => p.toLowerCase()));
-    const modifiers = [];
-    if (modifierSet.has("ctrl"))
-        modifiers.push("ctrl");
-    if (modifierSet.has("shift"))
-        modifiers.push("shift");
-    if (modifierSet.has("alt"))
-        modifiers.push("alt");
-    return modifiers.length > 0 ? `${modifiers.join("+")}+${normalizedKey}` : normalizedKey;
-}
-export class KeyValidator {
-    normalize(keyId) {
-        return normalizeKeyId(keyId);
-    }
-    isValid(keyId) {
-        const normalized = normalizeKeyId(keyId);
-        if (!normalized)
-            return false;
-        const parts = normalized.split("+");
-        const key = parts[parts.length - 1];
-        if (key.length === 1)
-            return (key >= "a" && key <= "z") || SYMBOL_KEYS.has(key);
-        return SPECIAL_KEY_SET.has(key);
-    }
-}
-const keyValidator = new KeyValidator();
-function parseKeyId(keyId) {
-    const normalized = normalizeKeyId(keyId);
-    if (!normalized || !keyValidator.isValid(normalized))
-        return null;
-    const parts = normalized.split("+");
-    const key = parts[parts.length - 1];
-    if (!key)
-        return null;
-    return {
-        key,
-        ctrl: parts.includes("ctrl"),
-        shift: parts.includes("shift"),
-        alt: parts.includes("alt"),
-    };
-}
-class KeyMatchEngine {
-    specialKeyResolverRegistry;
-    constructor() {
-        this.specialKeyResolverRegistry = {
-            escape: (data, _decodedKeyId, modifierBits) => {
-                if (modifierBits !== 0)
-                    return false;
-                return data === "\x1b" || matchesKittySequence(data, CODEPOINTS.escape, 0);
-            },
-            esc: (data, _decodedKeyId, modifierBits) => {
-                if (modifierBits !== 0)
-                    return false;
-                return data === "\x1b" || matchesKittySequence(data, CODEPOINTS.escape, 0);
-            },
-            space: (data, decodedKeyId, modifierBits) => {
-                const { ctrl, shift, alt } = decodedKeyId;
-                if (!_kittyProtocolActive) {
-                    if (ctrl && !alt && !shift && data === "\x00")
-                        return true;
-                    if (alt && !ctrl && !shift && data === "\x1b ")
-                        return true;
-                }
-                if (modifierBits === 0)
-                    return data === " " || matchesKittySequence(data, CODEPOINTS.space, 0);
-                return matchesKittySequence(data, CODEPOINTS.space, modifierBits);
-            },
-            tab: (data, decodedKeyId, modifierBits) => {
-                const { ctrl, shift, alt } = decodedKeyId;
-                if (shift && !ctrl && !alt) {
-                    return data === "\x1b[Z" || matchesKittySequence(data, CODEPOINTS.tab, MODIFIERS.shift);
-                }
-                if (modifierBits === 0)
-                    return data === "\t" || matchesKittySequence(data, CODEPOINTS.tab, 0);
-                return matchesKittySequence(data, CODEPOINTS.tab, modifierBits);
-            },
-            enter: (data, decodedKeyId, modifierBits) => this.matchEnterLikeKey(data, decodedKeyId, modifierBits),
-            return: (data, decodedKeyId, modifierBits) => this.matchEnterLikeKey(data, decodedKeyId, modifierBits),
-            backspace: (data, decodedKeyId, modifierBits) => {
-                const { ctrl, shift, alt } = decodedKeyId;
-                if (alt && !ctrl && !shift) {
-                    if (data === "\x1b\x7f" || data === "\x1b\b")
-                        return true;
-                    return matchesKittySequence(data, CODEPOINTS.backspace, MODIFIERS.alt);
-                }
-                if (modifierBits === 0) {
-                    return data === "\x7f" || data === "\x08" || matchesKittySequence(data, CODEPOINTS.backspace, 0);
-                }
-                return matchesKittySequence(data, CODEPOINTS.backspace, modifierBits);
-            },
-            insert: (data, _decodedKeyId, modifierBits) => this.matchFunctionalKey(data, "insert", FUNCTIONAL_CODEPOINTS.insert, modifierBits),
-            delete: (data, _decodedKeyId, modifierBits) => this.matchFunctionalKey(data, "delete", FUNCTIONAL_CODEPOINTS.delete, modifierBits),
-            clear: (data, _decodedKeyId, modifierBits) => {
-                if (modifierBits === 0)
-                    return matchesLegacySequence(data, LEGACY_KEY_SEQUENCES.clear);
-                return matchesLegacyModifierSequence(data, "clear", modifierBits);
-            },
-            home: (data, _decodedKeyId, modifierBits) => this.matchFunctionalKey(data, "home", FUNCTIONAL_CODEPOINTS.home, modifierBits),
-            end: (data, _decodedKeyId, modifierBits) => this.matchFunctionalKey(data, "end", FUNCTIONAL_CODEPOINTS.end, modifierBits),
-            pageup: (data, _decodedKeyId, modifierBits) => this.matchFunctionalKey(data, "pageUp", FUNCTIONAL_CODEPOINTS.pageUp, modifierBits),
-            pagedown: (data, _decodedKeyId, modifierBits) => this.matchFunctionalKey(data, "pageDown", FUNCTIONAL_CODEPOINTS.pageDown, modifierBits),
-            up: (data, decodedKeyId, modifierBits) => this.matchArrowKey(data, "up", ARROW_CODEPOINTS.up, decodedKeyId, modifierBits),
-            down: (data, decodedKeyId, modifierBits) => this.matchArrowKey(data, "down", ARROW_CODEPOINTS.down, decodedKeyId, modifierBits),
-            left: (data, decodedKeyId, modifierBits) => this.matchLeftArrow(data, decodedKeyId, modifierBits),
-            right: (data, decodedKeyId, modifierBits) => this.matchRightArrow(data, decodedKeyId, modifierBits),
-            f1: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f1", modifierBits),
-            f2: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f2", modifierBits),
-            f3: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f3", modifierBits),
-            f4: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f4", modifierBits),
-            f5: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f5", modifierBits),
-            f6: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f6", modifierBits),
-            f7: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f7", modifierBits),
-            f8: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f8", modifierBits),
-            f9: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f9", modifierBits),
-            f10: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f10", modifierBits),
-            f11: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f11", modifierBits),
-            f12: (data, _decodedKeyId, modifierBits) => this.matchFunctionKey(data, "f12", modifierBits),
-        };
-    }
-    matches(data, keyId) {
-        const decodedKeyId = parseKeyId(keyId);
-        if (!decodedKeyId)
-            return false;
-        const modifierBits = this.computeModifierMask(decodedKeyId);
-        const specialKeyResolver = this.specialKeyResolverRegistry[decodedKeyId.key];
-        if (specialKeyResolver) {
-            return specialKeyResolver(data, decodedKeyId, modifierBits);
-        }
-        return this.matchPrintableKey(data, decodedKeyId, modifierBits);
-    }
-    computeModifierMask(decodedKeyId) {
-        let modifierBits = 0;
-        if (decodedKeyId.shift)
-            modifierBits |= MODIFIERS.shift;
-        if (decodedKeyId.alt)
-            modifierBits |= MODIFIERS.alt;
-        if (decodedKeyId.ctrl)
-            modifierBits |= MODIFIERS.ctrl;
-        return modifierBits;
-    }
-    matchFunctionKey(data, functionKey, modifierBits) {
-        if (modifierBits !== 0)
-            return false;
-        return matchesLegacySequence(data, LEGACY_KEY_SEQUENCES[functionKey]);
-    }
-    matchEnterLikeKey(data, decodedKeyId, modifierBits) {
-        const { ctrl, shift, alt } = decodedKeyId;
-        if (shift && !ctrl && !alt) {
-            if (matchesKittySequence(data, CODEPOINTS.enter, MODIFIERS.shift) ||
-                matchesKittySequence(data, CODEPOINTS.kpEnter, MODIFIERS.shift)) {
-                return true;
-            }
-            if (matchesModifyOtherKeys(data, CODEPOINTS.enter, MODIFIERS.shift)) {
-                return true;
-            }
-            if (_kittyProtocolActive) {
-                return data === "\x1b\r" || data === "\n";
-            }
-            return false;
-        }
-        if (alt && !ctrl && !shift) {
-            if (matchesKittySequence(data, CODEPOINTS.enter, MODIFIERS.alt) ||
-                matchesKittySequence(data, CODEPOINTS.kpEnter, MODIFIERS.alt)) {
-                return true;
-            }
-            if (matchesModifyOtherKeys(data, CODEPOINTS.enter, MODIFIERS.alt)) {
-                return true;
-            }
-            if (!_kittyProtocolActive) {
-                return data === "\x1b\r";
-            }
-            return false;
-        }
-        if (modifierBits === 0) {
-            return (data === "\r" ||
-                (!_kittyProtocolActive && data === "\n") ||
-                data === "\x1bOM" ||
-                matchesKittySequence(data, CODEPOINTS.enter, 0) ||
-                matchesKittySequence(data, CODEPOINTS.kpEnter, 0));
-        }
-        return (matchesKittySequence(data, CODEPOINTS.enter, modifierBits) ||
-            matchesKittySequence(data, CODEPOINTS.kpEnter, modifierBits));
-    }
-    matchFunctionalKey(data, legacyName, codepoint, modifierBits) {
-        if (modifierBits === 0) {
-            return matchesLegacySequence(data, LEGACY_KEY_SEQUENCES[legacyName]) || matchesKittySequence(data, codepoint, 0);
-        }
-        if (matchesLegacyModifierSequence(data, legacyName, modifierBits)) {
-            return true;
-        }
-        return matchesKittySequence(data, codepoint, modifierBits);
-    }
-    matchArrowKey(data, arrowName, codepoint, decodedKeyId, modifierBits) {
-        const { ctrl, shift, alt } = decodedKeyId;
-        if (alt && !ctrl && !shift) {
-            const altLegacy = arrowName === "up" ? "\x1bp" : "\x1bn";
-            return data === altLegacy || matchesKittySequence(data, codepoint, MODIFIERS.alt);
-        }
-        if (modifierBits === 0) {
-            return matchesLegacySequence(data, LEGACY_KEY_SEQUENCES[arrowName]) || matchesKittySequence(data, codepoint, 0);
-        }
-        if (matchesLegacyModifierSequence(data, arrowName, modifierBits)) {
-            return true;
-        }
-        return matchesKittySequence(data, codepoint, modifierBits);
-    }
-    matchLeftArrow(data, decodedKeyId, modifierBits) {
-        const { ctrl, shift, alt } = decodedKeyId;
-        if (alt && !ctrl && !shift) {
-            return (data === "\x1b[1;3D" ||
-                (!_kittyProtocolActive && data === "\x1bB") ||
-                data === "\x1bb" ||
-                matchesKittySequence(data, ARROW_CODEPOINTS.left, MODIFIERS.alt));
-        }
-        if (ctrl && !alt && !shift) {
-            return (data === "\x1b[1;5D" ||
-                matchesLegacyModifierSequence(data, "left", MODIFIERS.ctrl) ||
-                matchesKittySequence(data, ARROW_CODEPOINTS.left, MODIFIERS.ctrl));
-        }
-        if (modifierBits === 0) {
-            return (matchesLegacySequence(data, LEGACY_KEY_SEQUENCES.left) ||
-                matchesKittySequence(data, ARROW_CODEPOINTS.left, 0));
-        }
-        if (matchesLegacyModifierSequence(data, "left", modifierBits)) {
-            return true;
-        }
-        return matchesKittySequence(data, ARROW_CODEPOINTS.left, modifierBits);
-    }
-    matchRightArrow(data, decodedKeyId, modifierBits) {
-        const { ctrl, shift, alt } = decodedKeyId;
-        if (alt && !ctrl && !shift) {
-            return (data === "\x1b[1;3C" ||
-                (!_kittyProtocolActive && data === "\x1bF") ||
-                data === "\x1bf" ||
-                matchesKittySequence(data, ARROW_CODEPOINTS.right, MODIFIERS.alt));
-        }
-        if (ctrl && !alt && !shift) {
-            return (data === "\x1b[1;5C" ||
-                matchesLegacyModifierSequence(data, "right", MODIFIERS.ctrl) ||
-                matchesKittySequence(data, ARROW_CODEPOINTS.right, MODIFIERS.ctrl));
-        }
-        if (modifierBits === 0) {
-            return (matchesLegacySequence(data, LEGACY_KEY_SEQUENCES.right) ||
-                matchesKittySequence(data, ARROW_CODEPOINTS.right, 0));
-        }
-        if (matchesLegacyModifierSequence(data, "right", modifierBits)) {
-            return true;
-        }
-        return matchesKittySequence(data, ARROW_CODEPOINTS.right, modifierBits);
-    }
-    matchPrintableKey(data, decodedKeyId, modifierBits) {
-        const { key, ctrl, shift, alt } = decodedKeyId;
-        if (!(key.length === 1 && ((key >= "a" && key <= "z") || SYMBOL_KEYS.has(key)))) {
-            return false;
-        }
-        const codepoint = key.charCodeAt(0);
-        const controlCharacter = rawCtrlChar(key);
-        if (ctrl && alt && !shift && !_kittyProtocolActive && controlCharacter) {
-            return data === `\x1b${controlCharacter}`;
-        }
-        if (alt && !ctrl && !shift && !_kittyProtocolActive && key >= "a" && key <= "z") {
-            if (data === `\x1b${key}`) {
-                return true;
-            }
-        }
-        if (ctrl && !shift && !alt) {
-            if (controlCharacter && data === controlCharacter) {
-                return true;
-            }
-            return matchesKittySequence(data, codepoint, MODIFIERS.ctrl);
-        }
-        if (ctrl && shift && !alt) {
-            return matchesKittySequence(data, codepoint, MODIFIERS.shift + MODIFIERS.ctrl);
-        }
-        if (shift && !ctrl && !alt) {
-            if (data === key.toUpperCase()) {
-                return true;
-            }
-            return matchesKittySequence(data, codepoint, MODIFIERS.shift);
-        }
-        if (modifierBits !== 0) {
-            return matchesKittySequence(data, codepoint, modifierBits);
-        }
-        return data === key || matchesKittySequence(data, codepoint, 0);
-    }
-}
-class KeyParseEngine {
-    legacyLiteralParseTable = {
-        "\x1b": "escape",
-        "\x1c": "ctrl+\\",
-        "\x1d": "ctrl+]",
-        "\x1f": "ctrl+-",
-        "\x1b\x1b": "ctrl+alt+[",
-        "\x1b\x1c": "ctrl+alt+\\",
-        "\x1b\x1d": "ctrl+alt+]",
-        "\x1b\x1f": "ctrl+alt+-",
-        "\t": "tab",
-        "\x00": "ctrl+space",
-        " ": "space",
-        "\x1b[Z": "shift+tab",
-        "\x1b[A": "up",
-        "\x1b[B": "down",
-        "\x1b[C": "right",
-        "\x1b[D": "left",
-        "\x1b[3~": "delete",
-        "\x1b[5~": "pageUp",
-        "\x1b[6~": "pageDown",
-    };
-    parse(data) {
-        const kittyDerivedKeyId = this.parseFromKitty(data);
-        if (kittyDerivedKeyId) {
-            return kittyDerivedKeyId;
-        }
-        return this.parseFromLegacy(data);
-    }
-    parseFromKitty(data) {
-        const parsedKitty = parseKittySequence(data);
-        if (!parsedKitty) {
-            return undefined;
-        }
-        const orderedModifiers = this.formatModifierNames(parsedKitty.modifier & ~LOCK_MASK);
-        const lookupCodepoint = parsedKitty.baseLayoutKey ?? parsedKitty.codepoint;
-        const keyName = this.resolveKeyName(lookupCodepoint);
-        if (!keyName)
-            return undefined;
-        return orderedModifiers.length > 0 ? `${orderedModifiers.join("+")}+${keyName}` : keyName;
-    }
-    parseFromLegacy(data) {
-        if (_kittyProtocolActive && (data === "\x1b\r" || data === "\n")) {
-            return "shift+enter";
-        }
-        const mappedLegacyIdentifier = LEGACY_SEQUENCE_KEY_IDS[data];
-        if (mappedLegacyIdentifier) {
-            return mappedLegacyIdentifier;
-        }
-        if (data === "\r" || (!_kittyProtocolActive && data === "\n") || data === "\x1bOM") {
-            return "enter";
-        }
-        if (data === "\x7f" || data === "\x08") {
-            return "backspace";
-        }
-        if (!_kittyProtocolActive && data === "\x1b\r") {
-            return "alt+enter";
-        }
-        if (!_kittyProtocolActive && data === "\x1b ") {
-            return "alt+space";
-        }
-        if (data === "\x1b\x7f" || data === "\x1b\b") {
-            return "alt+backspace";
-        }
-        if (!_kittyProtocolActive && data === "\x1bB") {
-            return "alt+left";
-        }
-        if (!_kittyProtocolActive && data === "\x1bF") {
-            return "alt+right";
-        }
-        if (data === "\x1b[H" || data === "\x1bOH") {
-            return "home";
-        }
-        if (data === "\x1b[F" || data === "\x1bOF") {
-            return "end";
-        }
-        const exactMatch = this.legacyLiteralParseTable[data];
-        if (exactMatch) {
-            return exactMatch;
-        }
-        if (!_kittyProtocolActive && data.length === 2 && data[0] === "\x1b") {
-            const legacyCode = data.charCodeAt(1);
-            if (legacyCode >= 1 && legacyCode <= 26) {
-                return `ctrl+alt+${String.fromCharCode(legacyCode + 96)}`;
-            }
-            if (legacyCode >= 97 && legacyCode <= 122) {
-                return `alt+${String.fromCharCode(legacyCode)}`;
-            }
-        }
-        if (data.length === 1) {
-            const rawCode = data.charCodeAt(0);
-            if (rawCode >= 1 && rawCode <= 26) {
-                return `ctrl+${String.fromCharCode(rawCode + 96)}`;
-            }
-            if (rawCode >= 32 && rawCode <= 126) {
-                return data;
-            }
-        }
-        return undefined;
-    }
-    resolveKeyName(codepoint) {
-        if (codepoint === CODEPOINTS.escape)
-            return "escape";
-        if (codepoint === CODEPOINTS.tab)
-            return "tab";
-        if (codepoint === CODEPOINTS.enter || codepoint === CODEPOINTS.kpEnter)
-            return "enter";
-        if (codepoint === CODEPOINTS.space)
-            return "space";
-        if (codepoint === CODEPOINTS.backspace)
-            return "backspace";
-        if (codepoint === FUNCTIONAL_CODEPOINTS.delete)
-            return "delete";
-        if (codepoint === FUNCTIONAL_CODEPOINTS.insert)
-            return "insert";
-        if (codepoint === FUNCTIONAL_CODEPOINTS.home)
-            return "home";
-        if (codepoint === FUNCTIONAL_CODEPOINTS.end)
-            return "end";
-        if (codepoint === FUNCTIONAL_CODEPOINTS.pageUp)
-            return "pageUp";
-        if (codepoint === FUNCTIONAL_CODEPOINTS.pageDown)
-            return "pageDown";
-        if (codepoint === ARROW_CODEPOINTS.up)
-            return "up";
-        if (codepoint === ARROW_CODEPOINTS.down)
-            return "down";
-        if (codepoint === ARROW_CODEPOINTS.left)
-            return "left";
-        if (codepoint === ARROW_CODEPOINTS.right)
-            return "right";
-        if (codepoint >= 97 && codepoint <= 122)
-            return String.fromCharCode(codepoint);
-        const char = String.fromCharCode(codepoint);
-        if (SYMBOL_KEYS.has(char)) {
-            return char;
-        }
-        return undefined;
-    }
-    formatModifierNames(modifierBits) {
-        const orderedModifiers = [];
-        if (modifierBits & MODIFIERS.shift)
-            orderedModifiers.push("shift");
-        if (modifierBits & MODIFIERS.ctrl)
-            orderedModifiers.push("ctrl");
-        if (modifierBits & MODIFIERS.alt)
-            orderedModifiers.push("alt");
-        return orderedModifiers;
-    }
-}
-const keyMatcherEngine = new KeyMatchEngine();
-const keyParserEngine = new KeyParseEngine();
-/**
- * Match input data against a key identifier string.
- *
- * Supported key identifiers:
- * - Single keys: "escape", "tab", "enter", "backspace", "delete", "home", "end", "space"
- * - Arrow keys: "up", "down", "left", "right"
- * - Ctrl combinations: "ctrl+c", "ctrl+z", etc.
- * - Shift combinations: "shift+tab", "shift+enter"
- * - Alt combinations: "alt+enter", "alt+backspace"
- * - Combined modifiers: "shift+ctrl+p", "ctrl+alt+x"
- *
- * Use the Key helper for autocomplete: Key.ctrl("c"), Key.escape, Key.ctrlShift("p")
- *
- * @param data - Raw input data from terminal
- * @param keyId - Key identifier (e.g., "ctrl+c", "escape", Key.ctrl("c"))
- */
-export function matchesKey(data, keyId) {
-    return keyMatcherEngine.matches(data, keyId);
-}
-/**
- * Parse input data and return the key identifier if recognized.
- *
- * @param data - Raw input data from terminal
- * @returns Key identifier string (e.g., "ctrl+c") or undefined
- */
-export function parseKey(data) {
-    return keyParserEngine.parse(data);
-}
-//# sourceMappingURL=keys.js.map