@mariozechner/pi-tui 0.24.0 → 0.24.1

package/dist/keys.js

@@ -4,13 +4,21 @@
  * The Kitty keyboard protocol sends enhanced escape sequences in the format:
  *   \x1b[<codepoint>;<modifier>u
  *
- * Modifier values (added to 1):
+ * Modifier bits (before adding 1 for transmission):
  *   - Shift: 1 (value 2)
  *   - Alt: 2 (value 3)
  *   - Ctrl: 4 (value 5)
  *   - Super: 8 (value 9)
+ *   - Hyper: 16
+ *   - Meta: 32
+ *   - Caps_Lock: 64
+ *   - Num_Lock: 128
  *
  * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+ *
+ * NOTE: Some terminals (e.g., Ghostty on Linux) include lock key states
+ * (Caps Lock, Num Lock) in the modifier field. We mask these out when
+ * checking for key combinations since they shouldn't affect behavior.
  */
 // Common codepoints
 const CODEPOINTS = {
@@ -31,6 +39,8 @@ const CODEPOINTS = {
     enter: 13,
     backspace: 127,
 };
+// Lock key bits to ignore when matching (Caps Lock + Num Lock)
+const LOCK_MASK = 64 + 128; // 192
 // Modifier bits (before adding 1)
 const MODIFIERS = {
     shift: 1,
@@ -44,6 +54,47 @@ const MODIFIERS = {
 function kittySequence(codepoint, modifier) {
     return `\x1b[${codepoint};${modifier + 1}u`;
 }
+/**
+ * Parse a Kitty keyboard protocol sequence.
+ * Handles formats:
+ *   - \x1b[<codepoint>u (no modifier)
+ *   - \x1b[<codepoint>;<modifier>u (with modifier)
+ *   - \x1b[1;<modifier>A/B/C/D (arrow keys with modifier)
+ *
+ * Returns null if not a valid Kitty sequence.
+ */
+function parseKittySequence(data) {
+    // Match CSI u format: \x1b[<num>u or \x1b[<num>;<mod>u
+    const csiUMatch = data.match(/^\x1b\[(\d+)(?:;(\d+))?u$/);
+    if (csiUMatch) {
+        const codepoint = parseInt(csiUMatch[1], 10);
+        const modValue = csiUMatch[2] ? parseInt(csiUMatch[2], 10) : 1;
+        return { codepoint, modifier: modValue - 1 };
+    }
+    // Match arrow keys with modifier: \x1b[1;<mod>A/B/C/D
+    const arrowMatch = data.match(/^\x1b\[1;(\d+)([ABCD])$/);
+    if (arrowMatch) {
+        const modValue = parseInt(arrowMatch[1], 10);
+        // Map arrow letters to virtual codepoints for easier matching
+        const arrowCodes = { A: -1, B: -2, C: -3, D: -4 };
+        const codepoint = arrowCodes[arrowMatch[2]];
+        return { codepoint, modifier: modValue - 1 };
+    }
+    return null;
+}
+/**
+ * Check if a Kitty sequence matches the expected codepoint and modifier,
+ * ignoring lock key bits (Caps Lock, Num Lock).
+ */
+function matchesKittySequence(data, expectedCodepoint, expectedModifier) {
+    const parsed = parseKittySequence(data);
+    if (!parsed)
+        return false;
+    // Mask out lock bits from both sides for comparison
+    const actualMod = parsed.modifier & ~LOCK_MASK;
+    const expectedMod = expectedModifier & ~LOCK_MASK;
+    return parsed.codepoint === expectedCodepoint && actualMod === expectedMod;
+}
 // Pre-built sequences for common key combinations
 export const Keys = {
     // Ctrl+<letter> combinations
@@ -68,6 +119,7 @@ export const Keys = {
 };
 /**
  * Check if input matches a Kitty protocol Ctrl+<key> sequence.
+ * Ignores lock key bits (Caps Lock, Num Lock).
  * @param data - The input data to check
  * @param key - Single lowercase letter (e.g., 'c' for Ctrl+C)
  */
@@ -75,16 +127,25 @@ export function isKittyCtrl(data, key) {
     if (key.length !== 1)
         return false;
     const codepoint = key.charCodeAt(0);
-    return data === kittySequence(codepoint, MODIFIERS.ctrl);
+    // Check exact match first (fast path)
+    if (data === kittySequence(codepoint, MODIFIERS.ctrl))
+        return true;
+    // Check with lock bits masked out
+    return matchesKittySequence(data, codepoint, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches a Kitty protocol key sequence with specific modifier.
+ * Ignores lock key bits (Caps Lock, Num Lock).
  * @param data - The input data to check
  * @param codepoint - ASCII codepoint of the key
  * @param modifier - Modifier value (use MODIFIERS constants)
  */
 export function isKittyKey(data, codepoint, modifier) {
-    return data === kittySequence(codepoint, modifier);
+    // Check exact match first (fast path)
+    if (data === kittySequence(codepoint, modifier))
+        return true;
+    // Check with lock bits masked out
+    return matchesKittySequence(data, codepoint, modifier);
 }
 // Raw control character codes
 const RAW = {
@@ -103,82 +164,195 @@ const RAW = {
 };
 /**
  * Check if input matches Ctrl+A (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlA(data) {
-    return data === RAW.CTRL_A || data === Keys.CTRL_A;
+    return data === RAW.CTRL_A || data === Keys.CTRL_A || matchesKittySequence(data, CODEPOINTS.a, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+C (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlC(data) {
-    return data === RAW.CTRL_C || data === Keys.CTRL_C;
+    return data === RAW.CTRL_C || data === Keys.CTRL_C || matchesKittySequence(data, CODEPOINTS.c, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+D (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlD(data) {
-    return data === RAW.CTRL_D || data === Keys.CTRL_D;
+    return data === RAW.CTRL_D || data === Keys.CTRL_D || matchesKittySequence(data, CODEPOINTS.d, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+E (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlE(data) {
-    return data === RAW.CTRL_E || data === Keys.CTRL_E;
+    return data === RAW.CTRL_E || data === Keys.CTRL_E || matchesKittySequence(data, CODEPOINTS.e, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+K (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlK(data) {
-    return data === RAW.CTRL_K || data === Keys.CTRL_K;
+    return data === RAW.CTRL_K || data === Keys.CTRL_K || matchesKittySequence(data, CODEPOINTS.k, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+O (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlO(data) {
-    return data === RAW.CTRL_O || data === Keys.CTRL_O;
+    return data === RAW.CTRL_O || data === Keys.CTRL_O || matchesKittySequence(data, CODEPOINTS.o, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+P (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlP(data) {
-    return data === RAW.CTRL_P || data === Keys.CTRL_P;
+    return data === RAW.CTRL_P || data === Keys.CTRL_P || matchesKittySequence(data, CODEPOINTS.p, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+T (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlT(data) {
-    return data === RAW.CTRL_T || data === Keys.CTRL_T;
+    return data === RAW.CTRL_T || data === Keys.CTRL_T || matchesKittySequence(data, CODEPOINTS.t, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+U (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlU(data) {
-    return data === RAW.CTRL_U || data === Keys.CTRL_U;
+    return data === RAW.CTRL_U || data === Keys.CTRL_U || matchesKittySequence(data, CODEPOINTS.u, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Ctrl+W (raw byte or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isCtrlW(data) {
-    return data === RAW.CTRL_W || data === Keys.CTRL_W;
+    return data === RAW.CTRL_W || data === Keys.CTRL_W || matchesKittySequence(data, CODEPOINTS.w, MODIFIERS.ctrl);
 }
 /**
  * Check if input matches Alt+Backspace (legacy or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isAltBackspace(data) {
-    return data === RAW.ALT_BACKSPACE || data === Keys.ALT_BACKSPACE;
+    return (data === RAW.ALT_BACKSPACE ||
+        data === Keys.ALT_BACKSPACE ||
+        matchesKittySequence(data, CODEPOINTS.backspace, MODIFIERS.alt));
 }
 /**
  * Check if input matches Shift+Tab (legacy or Kitty protocol).
+ * Ignores lock key bits.
  */
 export function isShiftTab(data) {
-    return data === RAW.SHIFT_TAB || data === Keys.SHIFT_TAB;
+    return (data === RAW.SHIFT_TAB || data === Keys.SHIFT_TAB || matchesKittySequence(data, CODEPOINTS.tab, MODIFIERS.shift));
 }
 /**
  * Check if input matches the Escape key (raw byte or Kitty protocol).
  * Raw: \x1b (single byte)
  * Kitty: \x1b[27u (codepoint 27 = escape)
+ * Ignores lock key bits.
  */
 export function isEscape(data) {
-    return data === "\x1b" || data === `\x1b[${CODEPOINTS.escape}u`;
+    return data === "\x1b" || data === `\x1b[${CODEPOINTS.escape}u` || matchesKittySequence(data, CODEPOINTS.escape, 0);
+}
+// Arrow key virtual codepoints (negative to avoid conflicts with real codepoints)
+const ARROW_CODEPOINTS = {
+    up: -1,
+    down: -2,
+    right: -3,
+    left: -4,
+};
+/**
+ * Check if input matches Arrow Up key.
+ * Handles both legacy (\x1b[A) and Kitty protocol with modifiers.
+ */
+export function isArrowUp(data) {
+    return data === "\x1b[A" || matchesKittySequence(data, ARROW_CODEPOINTS.up, 0);
+}
+/**
+ * Check if input matches Arrow Down key.
+ * Handles both legacy (\x1b[B) and Kitty protocol with modifiers.
+ */
+export function isArrowDown(data) {
+    return data === "\x1b[B" || matchesKittySequence(data, ARROW_CODEPOINTS.down, 0);
+}
+/**
+ * Check if input matches Arrow Right key.
+ * Handles both legacy (\x1b[C) and Kitty protocol with modifiers.
+ */
+export function isArrowRight(data) {
+    return data === "\x1b[C" || matchesKittySequence(data, ARROW_CODEPOINTS.right, 0);
+}
+/**
+ * Check if input matches Arrow Left key.
+ * Handles both legacy (\x1b[D) and Kitty protocol with modifiers.
+ */
+export function isArrowLeft(data) {
+    return data === "\x1b[D" || matchesKittySequence(data, ARROW_CODEPOINTS.left, 0);
+}
+/**
+ * Check if input matches plain Tab key (no modifiers).
+ * Handles both legacy (\t) and Kitty protocol.
+ */
+export function isTab(data) {
+    return data === "\t" || matchesKittySequence(data, CODEPOINTS.tab, 0);
+}
+/**
+ * Check if input matches plain Enter/Return key (no modifiers).
+ * Handles both legacy (\r) and Kitty protocol.
+ */
+export function isEnter(data) {
+    return data === "\r" || matchesKittySequence(data, CODEPOINTS.enter, 0);
+}
+/**
+ * Check if input matches plain Backspace key (no modifiers).
+ * Handles both legacy (\x7f, \x08) and Kitty protocol.
+ */
+export function isBackspace(data) {
+    return data === "\x7f" || data === "\x08" || matchesKittySequence(data, CODEPOINTS.backspace, 0);
+}
+/**
+ * Check if input matches Shift+Enter.
+ * Ignores lock key bits.
+ */
+export function isShiftEnter(data) {
+    return data === Keys.SHIFT_ENTER || matchesKittySequence(data, CODEPOINTS.enter, MODIFIERS.shift);
+}
+/**
+ * Check if input matches Alt+Enter.
+ * Ignores lock key bits.
+ */
+export function isAltEnter(data) {
+    return data === Keys.ALT_ENTER || data === "\x1b\r" || matchesKittySequence(data, CODEPOINTS.enter, MODIFIERS.alt);
+}
+/**
+ * Check if input matches Option/Alt+Left (word navigation).
+ * Handles multiple formats including Kitty protocol.
+ */
+export function isAltLeft(data) {
+    return data === "\x1b[1;3D" || data === "\x1bb" || matchesKittySequence(data, ARROW_CODEPOINTS.left, MODIFIERS.alt);
+}
+/**
+ * Check if input matches Option/Alt+Right (word navigation).
+ * Handles multiple formats including Kitty protocol.
+ */
+export function isAltRight(data) {
+    return data === "\x1b[1;3C" || data === "\x1bf" || matchesKittySequence(data, ARROW_CODEPOINTS.right, MODIFIERS.alt);
+}
+/**
+ * Check if input matches Ctrl+Left (word navigation).
+ * Handles multiple formats including Kitty protocol.
+ */
+export function isCtrlLeft(data) {
+    return data === "\x1b[1;5D" || matchesKittySequence(data, ARROW_CODEPOINTS.left, MODIFIERS.ctrl);
+}
+/**
+ * Check if input matches Ctrl+Right (word navigation).
+ * Handles multiple formats including Kitty protocol.
+ */
+export function isCtrlRight(data) {
+    return data === "\x1b[1;5C" || matchesKittySequence(data, ARROW_CODEPOINTS.right, MODIFIERS.ctrl);
 }
 //# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Kitty keyboard protocol key sequence helpers.\n *\n * The Kitty keyboard protocol sends enhanced escape sequences in the format:\n *   \\x1b[<codepoint>;<modifier>u\n *\n * Modifier values (added to 1):\n *   - Shift: 1 (value 2)\n *   - Alt: 2 (value 3)\n *   - Ctrl: 4 (value 5)\n *   - Super: 8 (value 9)\n *\n * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/\n */\n\n// Common codepoints\nconst CODEPOINTS = {\n\t// Letters (lowercase ASCII)\n\ta: 97,\n\tc: 99,\n\td: 100,\n\te: 101,\n\tk: 107,\n\to: 111,\n\tp: 112,\n\tt: 116,\n\tu: 117,\n\tw: 119,\n\n\t// Special keys\n\tescape: 27,\n\ttab: 9,\n\tenter: 13,\n\tbackspace: 127,\n} as const;\n\n// Modifier bits (before adding 1)\nconst MODIFIERS = {\n\tshift: 1,\n\talt: 2,\n\tctrl: 4,\n\tsuper: 8,\n} as const;\n\n/**\n * Build a Kitty keyboard protocol sequence for a key with modifier.\n */\nfunction kittySequence(codepoint: number, modifier: number): string {\n\treturn `\\x1b[${codepoint};${modifier + 1}u`;\n}\n\n// Pre-built sequences for common key combinations\nexport const Keys = {\n\t// Ctrl+<letter> combinations\n\tCTRL_A: kittySequence(CODEPOINTS.a, MODIFIERS.ctrl),\n\tCTRL_C: kittySequence(CODEPOINTS.c, MODIFIERS.ctrl),\n\tCTRL_D: kittySequence(CODEPOINTS.d, MODIFIERS.ctrl),\n\tCTRL_E: kittySequence(CODEPOINTS.e, MODIFIERS.ctrl),\n\tCTRL_K: kittySequence(CODEPOINTS.k, MODIFIERS.ctrl),\n\tCTRL_O: kittySequence(CODEPOINTS.o, MODIFIERS.ctrl),\n\tCTRL_P: kittySequence(CODEPOINTS.p, MODIFIERS.ctrl),\n\tCTRL_T: kittySequence(CODEPOINTS.t, MODIFIERS.ctrl),\n\tCTRL_U: kittySequence(CODEPOINTS.u, MODIFIERS.ctrl),\n\tCTRL_W: kittySequence(CODEPOINTS.w, MODIFIERS.ctrl),\n\n\t// Enter combinations\n\tSHIFT_ENTER: kittySequence(CODEPOINTS.enter, MODIFIERS.shift),\n\tALT_ENTER: kittySequence(CODEPOINTS.enter, MODIFIERS.alt),\n\tCTRL_ENTER: kittySequence(CODEPOINTS.enter, MODIFIERS.ctrl),\n\n\t// Tab combinations\n\tSHIFT_TAB: kittySequence(CODEPOINTS.tab, MODIFIERS.shift),\n\n\t// Backspace combinations\n\tALT_BACKSPACE: kittySequence(CODEPOINTS.backspace, MODIFIERS.alt),\n} as const;\n\n/**\n * Check if input matches a Kitty protocol Ctrl+<key> sequence.\n * @param data - The input data to check\n * @param key - Single lowercase letter (e.g., 'c' for Ctrl+C)\n */\nexport function isKittyCtrl(data: string, key: string): boolean {\n\tif (key.length !== 1) return false;\n\tconst codepoint = key.charCodeAt(0);\n\treturn data === kittySequence(codepoint, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches a Kitty protocol key sequence with specific modifier.\n * @param data - The input data to check\n * @param codepoint - ASCII codepoint of the key\n * @param modifier - Modifier value (use MODIFIERS constants)\n */\nexport function isKittyKey(data: string, codepoint: number, modifier: number): boolean {\n\treturn data === kittySequence(codepoint, modifier);\n}\n\n// Raw control character codes\nconst RAW = {\n\tCTRL_A: \"\\x01\",\n\tCTRL_C: \"\\x03\",\n\tCTRL_D: \"\\x04\",\n\tCTRL_E: \"\\x05\",\n\tCTRL_K: \"\\x0b\",\n\tCTRL_O: \"\\x0f\",\n\tCTRL_P: \"\\x10\",\n\tCTRL_T: \"\\x14\",\n\tCTRL_U: \"\\x15\",\n\tCTRL_W: \"\\x17\",\n\tALT_BACKSPACE: \"\\x1b\\x7f\",\n\tSHIFT_TAB: \"\\x1b[Z\",\n} as const;\n\n/**\n * Check if input matches Ctrl+A (raw byte or Kitty protocol).\n */\nexport function isCtrlA(data: string): boolean {\n\treturn data === RAW.CTRL_A || data === Keys.CTRL_A;\n}\n\n/**\n * Check if input matches Ctrl+C (raw byte or Kitty protocol).\n */\nexport function isCtrlC(data: string): boolean {\n\treturn data === RAW.CTRL_C || data === Keys.CTRL_C;\n}\n\n/**\n * Check if input matches Ctrl+D (raw byte or Kitty protocol).\n */\nexport function isCtrlD(data: string): boolean {\n\treturn data === RAW.CTRL_D || data === Keys.CTRL_D;\n}\n\n/**\n * Check if input matches Ctrl+E (raw byte or Kitty protocol).\n */\nexport function isCtrlE(data: string): boolean {\n\treturn data === RAW.CTRL_E || data === Keys.CTRL_E;\n}\n\n/**\n * Check if input matches Ctrl+K (raw byte or Kitty protocol).\n */\nexport function isCtrlK(data: string): boolean {\n\treturn data === RAW.CTRL_K || data === Keys.CTRL_K;\n}\n\n/**\n * Check if input matches Ctrl+O (raw byte or Kitty protocol).\n */\nexport function isCtrlO(data: string): boolean {\n\treturn data === RAW.CTRL_O || data === Keys.CTRL_O;\n}\n\n/**\n * Check if input matches Ctrl+P (raw byte or Kitty protocol).\n */\nexport function isCtrlP(data: string): boolean {\n\treturn data === RAW.CTRL_P || data === Keys.CTRL_P;\n}\n\n/**\n * Check if input matches Ctrl+T (raw byte or Kitty protocol).\n */\nexport function isCtrlT(data: string): boolean {\n\treturn data === RAW.CTRL_T || data === Keys.CTRL_T;\n}\n\n/**\n * Check if input matches Ctrl+U (raw byte or Kitty protocol).\n */\nexport function isCtrlU(data: string): boolean {\n\treturn data === RAW.CTRL_U || data === Keys.CTRL_U;\n}\n\n/**\n * Check if input matches Ctrl+W (raw byte or Kitty protocol).\n */\nexport function isCtrlW(data: string): boolean {\n\treturn data === RAW.CTRL_W || data === Keys.CTRL_W;\n}\n\n/**\n * Check if input matches Alt+Backspace (legacy or Kitty protocol).\n */\nexport function isAltBackspace(data: string): boolean {\n\treturn data === RAW.ALT_BACKSPACE || data === Keys.ALT_BACKSPACE;\n}\n\n/**\n * Check if input matches Shift+Tab (legacy or Kitty protocol).\n */\nexport function isShiftTab(data: string): boolean {\n\treturn data === RAW.SHIFT_TAB || data === Keys.SHIFT_TAB;\n}\n\n/**\n * Check if input matches the Escape key (raw byte or Kitty protocol).\n * Raw: \\x1b (single byte)\n * Kitty: \\x1b[27u (codepoint 27 = escape)\n */\nexport function isEscape(data: string): boolean {\n\treturn data === \"\\x1b\" || data === `\\x1b[${CODEPOINTS.escape}u`;\n}\n"]}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,oBAAoB;AACpB,MAAM,UAAU,GAAG;IAClB,4BAA4B;IAC5B,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IAEN,eAAe;IACf,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,EAAE;IACT,SAAS,EAAE,GAAG;CACL,CAAC;AAEX,+DAA+D;AAC/D,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,MAAM;AAElC,kCAAkC;AAClC,MAAM,SAAS,GAAG;IACjB,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACC,CAAC;AAEX;;GAEG;AACH,SAAS,aAAa,CAAC,SAAiB,EAAE,QAAgB,EAAU;IACnE,OAAO,QAAQ,SAAS,IAAI,QAAQ,GAAG,CAAC,GAAG,CAAC;AAAA,CAC5C;AAUD;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,IAAY,EAA8B;IACrE,uDAAuD;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC1D,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,sDAAsD;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACzD,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QAC9C,8DAA8D;QAC9D,MAAM,UAAU,GAA2B,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAE,CAAE,CAAC;QAC9C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAY,EAAE,iBAAyB,EAAE,gBAAwB,EAAW;IACzG,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,oDAAoD;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC;IAC/C,MAAM,WAAW,GAAG,gBAAgB,GAAG,CAAC,SAAS,CAAC;IAElD,OAAO,MAAM,CAAC,SAAS,KAAK,iBAAiB,IAAI,SAAS,KAAK,WAAW,CAAC;AAAA,CAC3E;AAED,kDAAkD;AAClD,MAAM,CAAC,MAAM,IAAI,GAAG;IACnB,6BAA6B;IAC7B,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IAEnD,qBAAqB;IACrB,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;IAC7D,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC;IACzD,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;IAE3D,mBAAmB;IACnB,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC;IAEzD,yBAAyB;IACzB,aAAa,EAAE,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC;CACxD,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAW,EAAW;IAC/D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACpC,sCAAsC;IACtC,IAAI,IAAI,KAAK,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnE,kCAAkC;IAClC,OAAO,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC7D;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,SAAiB,EAAE,QAAgB,EAAW;IACtF,sCAAsC;IACtC,IAAI,IAAI,KAAK,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,kCAAkC;IAClC,OAAO,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAAA,CACvD;AAED,8BAA8B;AAC9B,MAAM,GAAG,GAAG;IACX,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,aAAa,EAAE,UAAU;IACzB,SAAS,EAAE,QAAQ;CACV,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAC/G;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAW;IACrD,OAAO,CACN,IAAI,KAAK,GAAG,CAAC,aAAa;QAC1B,IAAI,KAAK,IAAI,CAAC,aAAa;QAC3B,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAC/D,CAAC;AAAA,CACF;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAW;IACjD,OAAO,CACN,IAAI,KAAK,GAAG,CAAC,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,SAAS,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAChH,CAAC;AAAA,CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAW;IAC/C,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,UAAU,CAAC,MAAM,GAAG,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAAA,CACpH;AAED,kFAAkF;AAClF,MAAM,gBAAgB,GAAG;IACxB,EAAE,EAAE,CAAC,CAAC;IACN,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;CACC,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAW;IAChD,OAAO,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAAA,CAC/E;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAW;IAClD,OAAO,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAAA,CACjF;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAW;IACnD,OAAO,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAAA,CAClF;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAW;IAClD,OAAO,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAAA,CACjF;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAW;IAC5C,OAAO,IAAI,KAAK,IAAI,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAAA,CACtE;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAW;IAC9C,OAAO,IAAI,KAAK,IAAI,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAAA,CACxE;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAW;IAClD,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;AAAA,CACjG;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAW;IACnD,OAAO,IAAI,KAAK,IAAI,CAAC,WAAW,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;AAAA,CAClG;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAW;IACjD,OAAO,IAAI,KAAK,IAAI,CAAC,SAAS,IAAI,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;AAAA,CACnH;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAW;IAChD,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;AAAA,CACpH;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAW;IACjD,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;AAAA,CACrH;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAW;IACjD,OAAO,IAAI,KAAK,WAAW,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CACjG;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAW;IAClD,OAAO,IAAI,KAAK,WAAW,IAAI,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;AAAA,CAClG","sourcesContent":["/**\n * Kitty keyboard protocol key sequence helpers.\n *\n * The Kitty keyboard protocol sends enhanced escape sequences in the format:\n *   \\x1b[<codepoint>;<modifier>u\n *\n * Modifier bits (before adding 1 for transmission):\n *   - Shift: 1 (value 2)\n *   - Alt: 2 (value 3)\n *   - Ctrl: 4 (value 5)\n *   - Super: 8 (value 9)\n *   - Hyper: 16\n *   - Meta: 32\n *   - Caps_Lock: 64\n *   - Num_Lock: 128\n *\n * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/\n *\n * NOTE: Some terminals (e.g., Ghostty on Linux) include lock key states\n * (Caps Lock, Num Lock) in the modifier field. We mask these out when\n * checking for key combinations since they shouldn't affect behavior.\n */\n\n// Common codepoints\nconst CODEPOINTS = {\n\t// Letters (lowercase ASCII)\n\ta: 97,\n\tc: 99,\n\td: 100,\n\te: 101,\n\tk: 107,\n\to: 111,\n\tp: 112,\n\tt: 116,\n\tu: 117,\n\tw: 119,\n\n\t// Special keys\n\tescape: 27,\n\ttab: 9,\n\tenter: 13,\n\tbackspace: 127,\n} as const;\n\n// Lock key bits to ignore when matching (Caps Lock + Num Lock)\nconst LOCK_MASK = 64 + 128; // 192\n\n// Modifier bits (before adding 1)\nconst MODIFIERS = {\n\tshift: 1,\n\talt: 2,\n\tctrl: 4,\n\tsuper: 8,\n} as const;\n\n/**\n * Build a Kitty keyboard protocol sequence for a key with modifier.\n */\nfunction kittySequence(codepoint: number, modifier: number): string {\n\treturn `\\x1b[${codepoint};${modifier + 1}u`;\n}\n\n/**\n * Parsed Kitty keyboard protocol sequence.\n */\ninterface ParsedKittySequence {\n\tcodepoint: number;\n\tmodifier: number; // Actual modifier bits (after subtracting 1)\n}\n\n/**\n * Parse a Kitty keyboard protocol sequence.\n * Handles formats:\n *   - \\x1b[<codepoint>u (no modifier)\n *   - \\x1b[<codepoint>;<modifier>u (with modifier)\n *   - \\x1b[1;<modifier>A/B/C/D (arrow keys with modifier)\n *\n * Returns null if not a valid Kitty sequence.\n */\nfunction parseKittySequence(data: string): ParsedKittySequence | null {\n\t// Match CSI u format: \\x1b[<num>u or \\x1b[<num>;<mod>u\n\tconst csiUMatch = data.match(/^\\x1b\\[(\\d+)(?:;(\\d+))?u$/);\n\tif (csiUMatch) {\n\t\tconst codepoint = parseInt(csiUMatch[1]!, 10);\n\t\tconst modValue = csiUMatch[2] ? parseInt(csiUMatch[2], 10) : 1;\n\t\treturn { codepoint, modifier: modValue - 1 };\n\t}\n\n\t// Match arrow keys with modifier: \\x1b[1;<mod>A/B/C/D\n\tconst arrowMatch = data.match(/^\\x1b\\[1;(\\d+)([ABCD])$/);\n\tif (arrowMatch) {\n\t\tconst modValue = parseInt(arrowMatch[1]!, 10);\n\t\t// Map arrow letters to virtual codepoints for easier matching\n\t\tconst arrowCodes: Record<string, number> = { A: -1, B: -2, C: -3, D: -4 };\n\t\tconst codepoint = arrowCodes[arrowMatch[2]!]!;\n\t\treturn { codepoint, modifier: modValue - 1 };\n\t}\n\n\treturn null;\n}\n\n/**\n * Check if a Kitty sequence matches the expected codepoint and modifier,\n * ignoring lock key bits (Caps Lock, Num Lock).\n */\nfunction matchesKittySequence(data: string, expectedCodepoint: number, expectedModifier: number): boolean {\n\tconst parsed = parseKittySequence(data);\n\tif (!parsed) return false;\n\n\t// Mask out lock bits from both sides for comparison\n\tconst actualMod = parsed.modifier & ~LOCK_MASK;\n\tconst expectedMod = expectedModifier & ~LOCK_MASK;\n\n\treturn parsed.codepoint === expectedCodepoint && actualMod === expectedMod;\n}\n\n// Pre-built sequences for common key combinations\nexport const Keys = {\n\t// Ctrl+<letter> combinations\n\tCTRL_A: kittySequence(CODEPOINTS.a, MODIFIERS.ctrl),\n\tCTRL_C: kittySequence(CODEPOINTS.c, MODIFIERS.ctrl),\n\tCTRL_D: kittySequence(CODEPOINTS.d, MODIFIERS.ctrl),\n\tCTRL_E: kittySequence(CODEPOINTS.e, MODIFIERS.ctrl),\n\tCTRL_K: kittySequence(CODEPOINTS.k, MODIFIERS.ctrl),\n\tCTRL_O: kittySequence(CODEPOINTS.o, MODIFIERS.ctrl),\n\tCTRL_P: kittySequence(CODEPOINTS.p, MODIFIERS.ctrl),\n\tCTRL_T: kittySequence(CODEPOINTS.t, MODIFIERS.ctrl),\n\tCTRL_U: kittySequence(CODEPOINTS.u, MODIFIERS.ctrl),\n\tCTRL_W: kittySequence(CODEPOINTS.w, MODIFIERS.ctrl),\n\n\t// Enter combinations\n\tSHIFT_ENTER: kittySequence(CODEPOINTS.enter, MODIFIERS.shift),\n\tALT_ENTER: kittySequence(CODEPOINTS.enter, MODIFIERS.alt),\n\tCTRL_ENTER: kittySequence(CODEPOINTS.enter, MODIFIERS.ctrl),\n\n\t// Tab combinations\n\tSHIFT_TAB: kittySequence(CODEPOINTS.tab, MODIFIERS.shift),\n\n\t// Backspace combinations\n\tALT_BACKSPACE: kittySequence(CODEPOINTS.backspace, MODIFIERS.alt),\n} as const;\n\n/**\n * Check if input matches a Kitty protocol Ctrl+<key> sequence.\n * Ignores lock key bits (Caps Lock, Num Lock).\n * @param data - The input data to check\n * @param key - Single lowercase letter (e.g., 'c' for Ctrl+C)\n */\nexport function isKittyCtrl(data: string, key: string): boolean {\n\tif (key.length !== 1) return false;\n\tconst codepoint = key.charCodeAt(0);\n\t// Check exact match first (fast path)\n\tif (data === kittySequence(codepoint, MODIFIERS.ctrl)) return true;\n\t// Check with lock bits masked out\n\treturn matchesKittySequence(data, codepoint, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches a Kitty protocol key sequence with specific modifier.\n * Ignores lock key bits (Caps Lock, Num Lock).\n * @param data - The input data to check\n * @param codepoint - ASCII codepoint of the key\n * @param modifier - Modifier value (use MODIFIERS constants)\n */\nexport function isKittyKey(data: string, codepoint: number, modifier: number): boolean {\n\t// Check exact match first (fast path)\n\tif (data === kittySequence(codepoint, modifier)) return true;\n\t// Check with lock bits masked out\n\treturn matchesKittySequence(data, codepoint, modifier);\n}\n\n// Raw control character codes\nconst RAW = {\n\tCTRL_A: \"\\x01\",\n\tCTRL_C: \"\\x03\",\n\tCTRL_D: \"\\x04\",\n\tCTRL_E: \"\\x05\",\n\tCTRL_K: \"\\x0b\",\n\tCTRL_O: \"\\x0f\",\n\tCTRL_P: \"\\x10\",\n\tCTRL_T: \"\\x14\",\n\tCTRL_U: \"\\x15\",\n\tCTRL_W: \"\\x17\",\n\tALT_BACKSPACE: \"\\x1b\\x7f\",\n\tSHIFT_TAB: \"\\x1b[Z\",\n} as const;\n\n/**\n * Check if input matches Ctrl+A (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlA(data: string): boolean {\n\treturn data === RAW.CTRL_A || data === Keys.CTRL_A || matchesKittySequence(data, CODEPOINTS.a, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+C (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlC(data: string): boolean {\n\treturn data === RAW.CTRL_C || data === Keys.CTRL_C || matchesKittySequence(data, CODEPOINTS.c, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+D (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlD(data: string): boolean {\n\treturn data === RAW.CTRL_D || data === Keys.CTRL_D || matchesKittySequence(data, CODEPOINTS.d, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+E (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlE(data: string): boolean {\n\treturn data === RAW.CTRL_E || data === Keys.CTRL_E || matchesKittySequence(data, CODEPOINTS.e, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+K (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlK(data: string): boolean {\n\treturn data === RAW.CTRL_K || data === Keys.CTRL_K || matchesKittySequence(data, CODEPOINTS.k, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+O (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlO(data: string): boolean {\n\treturn data === RAW.CTRL_O || data === Keys.CTRL_O || matchesKittySequence(data, CODEPOINTS.o, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+P (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlP(data: string): boolean {\n\treturn data === RAW.CTRL_P || data === Keys.CTRL_P || matchesKittySequence(data, CODEPOINTS.p, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+T (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlT(data: string): boolean {\n\treturn data === RAW.CTRL_T || data === Keys.CTRL_T || matchesKittySequence(data, CODEPOINTS.t, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+U (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlU(data: string): boolean {\n\treturn data === RAW.CTRL_U || data === Keys.CTRL_U || matchesKittySequence(data, CODEPOINTS.u, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+W (raw byte or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isCtrlW(data: string): boolean {\n\treturn data === RAW.CTRL_W || data === Keys.CTRL_W || matchesKittySequence(data, CODEPOINTS.w, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Alt+Backspace (legacy or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isAltBackspace(data: string): boolean {\n\treturn (\n\t\tdata === RAW.ALT_BACKSPACE ||\n\t\tdata === Keys.ALT_BACKSPACE ||\n\t\tmatchesKittySequence(data, CODEPOINTS.backspace, MODIFIERS.alt)\n\t);\n}\n\n/**\n * Check if input matches Shift+Tab (legacy or Kitty protocol).\n * Ignores lock key bits.\n */\nexport function isShiftTab(data: string): boolean {\n\treturn (\n\t\tdata === RAW.SHIFT_TAB || data === Keys.SHIFT_TAB || matchesKittySequence(data, CODEPOINTS.tab, MODIFIERS.shift)\n\t);\n}\n\n/**\n * Check if input matches the Escape key (raw byte or Kitty protocol).\n * Raw: \\x1b (single byte)\n * Kitty: \\x1b[27u (codepoint 27 = escape)\n * Ignores lock key bits.\n */\nexport function isEscape(data: string): boolean {\n\treturn data === \"\\x1b\" || data === `\\x1b[${CODEPOINTS.escape}u` || matchesKittySequence(data, CODEPOINTS.escape, 0);\n}\n\n// Arrow key virtual codepoints (negative to avoid conflicts with real codepoints)\nconst ARROW_CODEPOINTS = {\n\tup: -1,\n\tdown: -2,\n\tright: -3,\n\tleft: -4,\n} as const;\n\n/**\n * Check if input matches Arrow Up key.\n * Handles both legacy (\\x1b[A) and Kitty protocol with modifiers.\n */\nexport function isArrowUp(data: string): boolean {\n\treturn data === \"\\x1b[A\" || matchesKittySequence(data, ARROW_CODEPOINTS.up, 0);\n}\n\n/**\n * Check if input matches Arrow Down key.\n * Handles both legacy (\\x1b[B) and Kitty protocol with modifiers.\n */\nexport function isArrowDown(data: string): boolean {\n\treturn data === \"\\x1b[B\" || matchesKittySequence(data, ARROW_CODEPOINTS.down, 0);\n}\n\n/**\n * Check if input matches Arrow Right key.\n * Handles both legacy (\\x1b[C) and Kitty protocol with modifiers.\n */\nexport function isArrowRight(data: string): boolean {\n\treturn data === \"\\x1b[C\" || matchesKittySequence(data, ARROW_CODEPOINTS.right, 0);\n}\n\n/**\n * Check if input matches Arrow Left key.\n * Handles both legacy (\\x1b[D) and Kitty protocol with modifiers.\n */\nexport function isArrowLeft(data: string): boolean {\n\treturn data === \"\\x1b[D\" || matchesKittySequence(data, ARROW_CODEPOINTS.left, 0);\n}\n\n/**\n * Check if input matches plain Tab key (no modifiers).\n * Handles both legacy (\\t) and Kitty protocol.\n */\nexport function isTab(data: string): boolean {\n\treturn data === \"\\t\" || matchesKittySequence(data, CODEPOINTS.tab, 0);\n}\n\n/**\n * Check if input matches plain Enter/Return key (no modifiers).\n * Handles both legacy (\\r) and Kitty protocol.\n */\nexport function isEnter(data: string): boolean {\n\treturn data === \"\\r\" || matchesKittySequence(data, CODEPOINTS.enter, 0);\n}\n\n/**\n * Check if input matches plain Backspace key (no modifiers).\n * Handles both legacy (\\x7f, \\x08) and Kitty protocol.\n */\nexport function isBackspace(data: string): boolean {\n\treturn data === \"\\x7f\" || data === \"\\x08\" || matchesKittySequence(data, CODEPOINTS.backspace, 0);\n}\n\n/**\n * Check if input matches Shift+Enter.\n * Ignores lock key bits.\n */\nexport function isShiftEnter(data: string): boolean {\n\treturn data === Keys.SHIFT_ENTER || matchesKittySequence(data, CODEPOINTS.enter, MODIFIERS.shift);\n}\n\n/**\n * Check if input matches Alt+Enter.\n * Ignores lock key bits.\n */\nexport function isAltEnter(data: string): boolean {\n\treturn data === Keys.ALT_ENTER || data === \"\\x1b\\r\" || matchesKittySequence(data, CODEPOINTS.enter, MODIFIERS.alt);\n}\n\n/**\n * Check if input matches Option/Alt+Left (word navigation).\n * Handles multiple formats including Kitty protocol.\n */\nexport function isAltLeft(data: string): boolean {\n\treturn data === \"\\x1b[1;3D\" || data === \"\\x1bb\" || matchesKittySequence(data, ARROW_CODEPOINTS.left, MODIFIERS.alt);\n}\n\n/**\n * Check if input matches Option/Alt+Right (word navigation).\n * Handles multiple formats including Kitty protocol.\n */\nexport function isAltRight(data: string): boolean {\n\treturn data === \"\\x1b[1;3C\" || data === \"\\x1bf\" || matchesKittySequence(data, ARROW_CODEPOINTS.right, MODIFIERS.alt);\n}\n\n/**\n * Check if input matches Ctrl+Left (word navigation).\n * Handles multiple formats including Kitty protocol.\n */\nexport function isCtrlLeft(data: string): boolean {\n\treturn data === \"\\x1b[1;5D\" || matchesKittySequence(data, ARROW_CODEPOINTS.left, MODIFIERS.ctrl);\n}\n\n/**\n * Check if input matches Ctrl+Right (word navigation).\n * Handles multiple formats including Kitty protocol.\n */\nexport function isCtrlRight(data: string): boolean {\n\treturn data === \"\\x1b[1;5C\" || matchesKittySequence(data, ARROW_CODEPOINTS.right, MODIFIERS.ctrl);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mariozechner/pi-tui",
-	"version": "0.24.0",
+	"version": "0.24.1",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
 	"main": "dist/index.js",