catui-agent 1.0.0-beta.0

package/dist/core/lib/tui/src/keys.d.ts

@@ -0,0 +1,149 @@
+/**
+ * [WHO]: Keyboard input handling - setKittyProtocolActive, isKittyProtocolActive, Key, matchesKey, parseKey
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/lib/tui/src/index.ts, TUI components
+ * [HERE]: core/lib/tui/src/keys.ts - keyboard input handling for terminal applications
+ *
+ * Supports both legacy terminal sequences and Kitty keyboard protocol.
+ * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+ */
+/**
+ * Set the global Kitty keyboard protocol state.
+ * Called by ProcessTerminal after detecting protocol support.
+ */
+export declare function setKittyProtocolActive(active: boolean): void;
+/**
+ * Query whether Kitty keyboard protocol is currently active.
+ */
+export declare function isKittyProtocolActive(): boolean;
+type Letter = "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";
+type SymbolKey = "`" | "-" | "=" | "[" | "]" | "\\" | ";" | "'" | "," | "." | "/" | "!" | "@" | "#" | "$" | "%" | "^" | "&" | "*" | "(" | ")" | "_" | "+" | "|" | "~" | "{" | "}" | ":" | "<" | ">" | "?";
+type SpecialKey = "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";
+type BaseKey = Letter | SymbolKey | SpecialKey;
+/**
+ * Union type of all valid key identifiers.
+ * Provides autocomplete and catches typos at compile time.
+ */
+export type KeyId = BaseKey | `ctrl+${BaseKey}` | `shift+${BaseKey}` | `alt+${BaseKey}` | `ctrl+shift+${BaseKey}` | `shift+ctrl+${BaseKey}` | `ctrl+alt+${BaseKey}` | `alt+ctrl+${BaseKey}` | `shift+alt+${BaseKey}` | `alt+shift+${BaseKey}` | `ctrl+shift+alt+${BaseKey}` | `ctrl+alt+shift+${BaseKey}` | `shift+ctrl+alt+${BaseKey}` | `shift+alt+ctrl+${BaseKey}` | `alt+ctrl+shift+${BaseKey}` | `alt+shift+ctrl+${BaseKey}`;
+/**
+ * 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 declare const Key: {
+    readonly escape: "escape";
+    readonly esc: "esc";
+    readonly enter: "enter";
+    readonly return: "return";
+    readonly tab: "tab";
+    readonly space: "space";
+    readonly backspace: "backspace";
+    readonly delete: "delete";
+    readonly insert: "insert";
+    readonly clear: "clear";
+    readonly home: "home";
+    readonly end: "end";
+    readonly pageUp: "pageUp";
+    readonly pageDown: "pageDown";
+    readonly up: "up";
+    readonly down: "down";
+    readonly left: "left";
+    readonly right: "right";
+    readonly f1: "f1";
+    readonly f2: "f2";
+    readonly f3: "f3";
+    readonly f4: "f4";
+    readonly f5: "f5";
+    readonly f6: "f6";
+    readonly f7: "f7";
+    readonly f8: "f8";
+    readonly f9: "f9";
+    readonly f10: "f10";
+    readonly f11: "f11";
+    readonly f12: "f12";
+    readonly backtick: "`";
+    readonly hyphen: "-";
+    readonly equals: "=";
+    readonly leftbracket: "[";
+    readonly rightbracket: "]";
+    readonly backslash: "\\";
+    readonly semicolon: ";";
+    readonly quote: "'";
+    readonly comma: ",";
+    readonly period: ".";
+    readonly slash: "/";
+    readonly exclamation: "!";
+    readonly at: "@";
+    readonly hash: "#";
+    readonly dollar: "$";
+    readonly percent: "%";
+    readonly caret: "^";
+    readonly ampersand: "&";
+    readonly asterisk: "*";
+    readonly leftparen: "(";
+    readonly rightparen: ")";
+    readonly underscore: "_";
+    readonly plus: "+";
+    readonly pipe: "|";
+    readonly tilde: "~";
+    readonly leftbrace: "{";
+    readonly rightbrace: "}";
+    readonly colon: ":";
+    readonly lessthan: "<";
+    readonly greaterthan: ">";
+    readonly question: "?";
+    readonly ctrl: <K extends BaseKey>(key: K) => `ctrl+${K}`;
+    readonly shift: <K extends BaseKey>(key: K) => `shift+${K}`;
+    readonly alt: <K extends BaseKey>(key: K) => `alt+${K}`;
+    readonly ctrlShift: <K extends BaseKey>(key: K) => `ctrl+shift+${K}`;
+    readonly shiftCtrl: <K extends BaseKey>(key: K) => `shift+ctrl+${K}`;
+    readonly ctrlAlt: <K extends BaseKey>(key: K) => `ctrl+alt+${K}`;
+    readonly altCtrl: <K extends BaseKey>(key: K) => `alt+ctrl+${K}`;
+    readonly shiftAlt: <K extends BaseKey>(key: K) => `shift+alt+${K}`;
+    readonly altShift: <K extends BaseKey>(key: K) => `alt+shift+${K}`;
+    readonly ctrlShiftAlt: <K extends BaseKey>(key: K) => `ctrl+shift+alt+${K}`;
+};
+/**
+ * Event types from Kitty keyboard protocol (flag 2)
+ * 1 = key press, 2 = key repeat, 3 = key release
+ */
+export type KeyEventType = "press" | "repeat" | "release";
+/**
+ * Check if the last parsed key event was a key release.
+ * Only meaningful when Kitty keyboard protocol with flag 2 is active.
+ */
+export declare function isKeyRelease(data: string): boolean;
+/**
+ * Check if the last parsed key event was a key repeat.
+ * Only meaningful when Kitty keyboard protocol with flag 2 is active.
+ */
+export declare function isKeyRepeat(data: string): boolean;
+/**
+ * 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 declare function matchesKey(data: string, keyId: KeyId): boolean;
+/**
+ * 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 declare function parseKey(data: string): string | undefined;
+export {};

package/dist/core/lib/tui/src/keys.js

@@ -0,0 +1,5 @@
+var U=Object.defineProperty;var o=(e,f)=>U(e,"name",{value:f,configurable:!0});let m=!1;function T(e){m=e}o(T,"setKittyProtocolActive");function v(){return m}o(v,"isKittyProtocolActive");const N={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",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:"?",ctrl:o(e=>`ctrl+${e}`,"ctrl"),shift:o(e=>`shift+${e}`,"shift"),alt:o(e=>`alt+${e}`,"alt"),ctrlShift:o(e=>`ctrl+shift+${e}`,"ctrlShift"),shiftCtrl:o(e=>`shift+ctrl+${e}`,"shiftCtrl"),ctrlAlt:o(e=>`ctrl+alt+${e}`,"ctrlAlt"),altCtrl:o(e=>`alt+ctrl+${e}`,"altCtrl"),shiftAlt:o(e=>`shift+alt+${e}`,"shiftAlt"),altShift:o(e=>`alt+shift+${e}`,"altShift"),ctrlShiftAlt:o(e=>`ctrl+shift+alt+${e}`,"ctrlShiftAlt")},S=new Set(["`","-","=","[","]","\\",";","'",",",".","/","!","@","#","$","%","^","&","*","(",")","_","+","|","~","{","}",":","<",">","?"]),u={shift:1,alt:2,ctrl:4},k=192,b={escape:27,tab:9,enter:13,space:32,backspace:127,kpEnter:57414},g={up:-1,down:-2,right:-3,left:-4},l={delete:-10,insert:-11,pageUp:-12,pageDown:-13,home:-14,end:-15},E={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~"]},I={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$"]},L={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^"]},_={"\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"},C=o((e,f)=>f.includes(e),"matchesLegacySequence"),w=o((e,f,x)=>x===u.shift?C(e,I[f]):x===u.ctrl?C(e,L[f]):!1,"matchesLegacyModifierSequence");let $="press";function H(e){return e.includes("\x1B[200~")?!1:!!(e.includes(":3u")||e.includes(":3~")||e.includes(":3A")||e.includes(":3B")||e.includes(":3C")||e.includes(":3D")||e.includes(":3H")||e.includes(":3F"))}o(H,"isKeyRelease");function q(e){return e.includes("\x1B[200~")?!1:!!(e.includes(":2u")||e.includes(":2~")||e.includes(":2A")||e.includes(":2B")||e.includes(":2C")||e.includes(":2D")||e.includes(":2H")||e.includes(":2F"))}o(q,"isKeyRepeat");function D(e){if(!e)return"press";const f=parseInt(e,10);return f===2?"repeat":f===3?"release":"press"}o(D,"parseEventType");function A(e){const f=e.match(/^\x1b\[(\d+)(?::(\d*))?(?::(\d+))?(?:;(\d+))?(?::(\d+))?u$/);if(f){const s=parseInt(f[1],10),i=f[2]&&f[2].length>0?parseInt(f[2],10):void 0,r=f[3]?parseInt(f[3],10):void 0,O=f[4]?parseInt(f[4],10):1,y=D(f[5]);return $=y,{codepoint:s,shiftedKey:i,baseLayoutKey:r,modifier:O-1,eventType:y}}const x=e.match(/^\x1b\[1;(\d+)(?::(\d+))?([ABCD])$/);if(x){const s=parseInt(x[1],10),i=D(x[2]),r={A:-1,B:-2,C:-3,D:-4};return $=i,{codepoint:r[x[3]],modifier:s-1,eventType:i}}const t=e.match(/^\x1b\[(\d+)(?:;(\d+))?(?::(\d+))?~$/);if(t){const s=parseInt(t[1],10),i=t[2]?parseInt(t[2],10):1,r=D(t[3]),y={2:l.insert,3:l.delete,5:l.pageUp,6:l.pageDown,7:l.home,8:l.end}[s];if(y!==void 0)return $=r,{codepoint:y,modifier:i-1,eventType:r}}const c=e.match(/^\x1b\[1;(\d+)(?::(\d+))?([HF])$/);if(c){const s=parseInt(c[1],10),i=D(c[2]),r=c[3]==="H"?l.home:l.end;return $=i,{codepoint:r,modifier:s-1,eventType:i}}return null}o(A,"parseKittySequence");function n(e,f,x){const t=A(e);if(!t)return!1;const c=t.modifier&~k,s=x&~k;if(c!==s)return!1;if(t.codepoint===f)return!0;if(t.baseLayoutKey!==void 0&&t.baseLayoutKey===f){const i=t.codepoint,r=i>=97&&i<=122,O=S.has(String.fromCharCode(i));if(!r&&!O)return!0}return!1}o(n,"matchesKittySequence");function K(e,f,x){const t=e.match(/^\x1b\[27;(\d+);(\d+)~$/);if(!t)return!1;const c=parseInt(t[1],10),s=parseInt(t[2],10),i=c-1;return s===f&&i===x}o(K,"matchesModifyOtherKeys");function M(e){const f=e.toLowerCase(),x=f.charCodeAt(0);return x>=97&&x<=122||f==="["||f==="\\"||f==="]"||f==="_"?String.fromCharCode(x&31):f==="-"?"":null}o(M,"rawCtrlChar");function B(e){const f=e.toLowerCase().split("+"),x=f[f.length-1];return x?{key:x,ctrl:f.includes("ctrl"),shift:f.includes("shift"),alt:f.includes("alt")}:null}o(B,"parseKeyId");function P(e,f){const x=B(f);if(!x)return!1;const{key:t,ctrl:c,shift:s,alt:i}=x;let r=0;switch(s&&(r|=u.shift),i&&(r|=u.alt),c&&(r|=u.ctrl),t){case"escape":case"esc":return r!==0?!1:e==="\x1B"||n(e,b.escape,0);case"space":return!m&&(c&&!i&&!s&&e==="\0"||i&&!c&&!s&&e==="\x1B ")?!0:r===0?e===" "||n(e,b.space,0):n(e,b.space,r);case"tab":return s&&!c&&!i?e==="\x1B[Z"||n(e,b.tab,u.shift):r===0?e==="	"||n(e,b.tab,0):n(e,b.tab,r);case"enter":case"return":return s&&!c&&!i?n(e,b.enter,u.shift)||n(e,b.kpEnter,u.shift)||K(e,b.enter,u.shift)?!0:m?e==="\x1B\r"||e===`
+`:!1:i&&!c&&!s?n(e,b.enter,u.alt)||n(e,b.kpEnter,u.alt)||K(e,b.enter,u.alt)?!0:m?!1:e==="\x1B\r":r===0?e==="\r"||!m&&e===`
+`||e==="\x1BOM"||n(e,b.enter,0)||n(e,b.kpEnter,0):n(e,b.enter,r)||n(e,b.kpEnter,r);case"backspace":return i&&!c&&!s?e==="\x1B\x7F"||e==="\x1B\b"?!0:n(e,b.backspace,u.alt):r===0?e==="\x7F"||e==="\b"||n(e,b.backspace,0):n(e,b.backspace,r);case"insert":return r===0?C(e,E.insert)||n(e,l.insert,0):w(e,"insert",r)?!0:n(e,l.insert,r);case"delete":return r===0?C(e,E.delete)||n(e,l.delete,0):w(e,"delete",r)?!0:n(e,l.delete,r);case"clear":return r===0?C(e,E.clear):w(e,"clear",r);case"home":return r===0?C(e,E.home)||n(e,l.home,0):w(e,"home",r)?!0:n(e,l.home,r);case"end":return r===0?C(e,E.end)||n(e,l.end,0):w(e,"end",r)?!0:n(e,l.end,r);case"pageup":return r===0?C(e,E.pageUp)||n(e,l.pageUp,0):w(e,"pageUp",r)?!0:n(e,l.pageUp,r);case"pagedown":return r===0?C(e,E.pageDown)||n(e,l.pageDown,0):w(e,"pageDown",r)?!0:n(e,l.pageDown,r);case"up":return i&&!c&&!s?e==="\x1Bp"||n(e,g.up,u.alt):r===0?C(e,E.up)||n(e,g.up,0):w(e,"up",r)?!0:n(e,g.up,r);case"down":return i&&!c&&!s?e==="\x1Bn"||n(e,g.down,u.alt):r===0?C(e,E.down)||n(e,g.down,0):w(e,"down",r)?!0:n(e,g.down,r);case"left":return i&&!c&&!s?e==="\x1B[1;3D"||!m&&e==="\x1BB"||e==="\x1Bb"||n(e,g.left,u.alt):c&&!i&&!s?e==="\x1B[1;5D"||w(e,"left",u.ctrl)||n(e,g.left,u.ctrl):r===0?C(e,E.left)||n(e,g.left,0):w(e,"left",r)?!0:n(e,g.left,r);case"right":return i&&!c&&!s?e==="\x1B[1;3C"||!m&&e==="\x1BF"||e==="\x1Bf"||n(e,g.right,u.alt):c&&!i&&!s?e==="\x1B[1;5C"||w(e,"right",u.ctrl)||n(e,g.right,u.ctrl):r===0?C(e,E.right)||n(e,g.right,0):w(e,"right",r)?!0:n(e,g.right,r);case"f1":case"f2":case"f3":case"f4":case"f5":case"f6":case"f7":case"f8":case"f9":case"f10":case"f11":case"f12":return r!==0?!1:C(e,E[t])}if(t.length===1&&(t>="a"&&t<="z"||S.has(t))){const O=t.charCodeAt(0),y=M(t);return c&&i&&!s&&!m&&y?e===`\x1B${y}`:i&&!c&&!s&&!m&&t>="a"&&t<="z"&&e===`\x1B${t}`?!0:c&&!s&&!i?y&&e===y?!0:n(e,O,u.ctrl):c&&s&&!i?n(e,O,u.shift+u.ctrl):s&&!c&&!i?e===t.toUpperCase()?!0:n(e,O,u.shift):r!==0?n(e,O,r):e===t||n(e,O,0)}return!1}o(P,"matchesKey");function R(e){const f=A(e);if(f){const{codepoint:t,baseLayoutKey:c,modifier:s}=f,i=[],r=s&~k;r&u.shift&&i.push("shift"),r&u.ctrl&&i.push("ctrl"),r&u.alt&&i.push("alt");const O=t>=97&&t<=122,y=S.has(String.fromCharCode(t)),p=O||y?t:c??t;let h;if(p===b.escape?h="escape":p===b.tab?h="tab":p===b.enter||p===b.kpEnter?h="enter":p===b.space?h="space":p===b.backspace?h="backspace":p===l.delete?h="delete":p===l.insert?h="insert":p===l.home?h="home":p===l.end?h="end":p===l.pageUp?h="pageUp":p===l.pageDown?h="pageDown":p===g.up?h="up":p===g.down?h="down":p===g.left?h="left":p===g.right?h="right":(p>=97&&p<=122||S.has(String.fromCharCode(p)))&&(h=String.fromCharCode(p)),h)return i.length>0?`${i.join("+")}+${h}`:h}if(m&&(e==="\x1B\r"||e===`
+`))return"shift+enter";const x=_[e];if(x)return x;if(e==="\x1B")return"escape";if(e==="")return"ctrl+\\";if(e==="")return"ctrl+]";if(e==="")return"ctrl+-";if(e==="\x1B\x1B")return"ctrl+alt+[";if(e==="\x1B")return"ctrl+alt+\\";if(e==="\x1B")return"ctrl+alt+]";if(e==="\x1B")return"ctrl+alt+-";if(e==="	")return"tab";if(e==="\r"||!m&&e===`
+`||e==="\x1BOM")return"enter";if(e==="\0")return"ctrl+space";if(e===" ")return"space";if(e==="\x7F"||e==="\b")return"backspace";if(e==="\x1B[Z")return"shift+tab";if(!m&&e==="\x1B\r")return"alt+enter";if(!m&&e==="\x1B ")return"alt+space";if(e==="\x1B\x7F"||e==="\x1B\b")return"alt+backspace";if(!m&&e==="\x1BB")return"alt+left";if(!m&&e==="\x1BF")return"alt+right";if(!m&&e.length===2&&e[0]==="\x1B"){const t=e.charCodeAt(1);if(t>=1&&t<=26)return`ctrl+alt+${String.fromCharCode(t+96)}`;if(t>=97&&t<=122)return`alt+${String.fromCharCode(t)}`}if(e==="\x1B[A")return"up";if(e==="\x1B[B")return"down";if(e==="\x1B[C")return"right";if(e==="\x1B[D")return"left";if(e==="\x1B[H"||e==="\x1BOH")return"home";if(e==="\x1B[F"||e==="\x1BOF")return"end";if(e==="\x1B[3~")return"delete";if(e==="\x1B[5~")return"pageUp";if(e==="\x1B[6~")return"pageDown";if(e.length===1){const t=e.charCodeAt(0);if(t>=1&&t<=26)return`ctrl+${String.fromCharCode(t+96)}`;if(t>=32&&t<=126)return e}}o(R,"parseKey");export{N as Key,H as isKeyRelease,q as isKeyRepeat,v as isKittyProtocolActive,P as matchesKey,R as parseKey,T as setKittyProtocolActive};

package/dist/core/lib/tui/src/kill-ring.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Ring buffer for Emacs-style kill/yank operations.
+ *
+ * Tracks killed (deleted) text entries. Consecutive kills can accumulate
+ * into a single entry. Supports yank (paste most recent) and yank-pop
+ * (cycle through older entries).
+ */
+/**
+ * [WHO]: KillRing
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/lib/tui/src/index.ts
+ * [HERE]: core/lib/tui/src/kill-ring.ts -
+ */
+export declare class KillRing {
+    private ring;
+    /**
+     * Add text to the kill ring.
+     *
+     * @param text - The killed text to add
+     * @param opts - Push options
+     * @param opts.prepend - If accumulating, prepend (backward deletion) or append (forward deletion)
+     * @param opts.accumulate - Merge with the most recent entry instead of creating a new one
+     */
+    push(text: string, opts: {
+        prepend: boolean;
+        accumulate?: boolean;
+    }): void;
+    /** Get most recent entry without modifying the ring. */
+    peek(): string | undefined;
+    /** Move last entry to front (for yank-pop cycling). */
+    rotate(): void;
+    get length(): number;
+}

package/dist/core/lib/tui/src/kill-ring.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var r=(n,i)=>s(n,"name",{value:i,configurable:!0});class e{static{r(this,"KillRing")}ring=[];push(i,t){if(i)if(t.accumulate&&this.ring.length>0){const h=this.ring.pop();this.ring.push(t.prepend?i+h:h+i)}else this.ring.push(i)}peek(){return this.ring.length>0?this.ring[this.ring.length-1]:void 0}rotate(){if(this.ring.length>1){const i=this.ring.pop();this.ring.unshift(i)}}get length(){return this.ring.length}}export{e as KillRing};

package/dist/core/lib/tui/src/stdin-buffer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * [WHO]: StdinBuffer class - buffers input and emits complete sequences
+ * [FROM]: Depends on node:events
+ * [TO]: Consumed by core/lib/tui/src/index.ts, TUI input handling
+ * [HERE]: core/lib/tui/src/stdin-buffer.ts - input buffering for terminal sequences
+ *
+ * Buffers stdin data events that arrive in partial chunks, especially for
+ * escape sequences like mouse events. Based on OpenTUI.
+ */
+import { EventEmitter } from "events";
+export type StdinBufferOptions = {
+    /**
+     * Maximum time to wait for sequence completion (default: 10ms)
+     * After this time, the buffer is flushed even if incomplete
+     */
+    timeout?: number;
+};
+export type StdinBufferEventMap = {
+    data: [string];
+    paste: [string];
+};
+/**
+ * Buffers stdin input and emits complete sequences via the 'data' event.
+ * Handles partial escape sequences that arrive across multiple chunks.
+ */
+export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
+    private buffer;
+    private timeout;
+    private readonly timeoutMs;
+    private pasteMode;
+    private pasteBuffer;
+    constructor(options?: StdinBufferOptions);
+    process(data: string | Buffer): void;
+    flush(): string[];
+    clear(): void;
+    getBuffer(): string;
+    destroy(): void;
+}

package/dist/core/lib/tui/src/stdin-buffer.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(t,e)=>a(t,"name",{value:e,configurable:!0});import{EventEmitter as b}from"events";const u="\x1B",l="\x1B[200~",c="\x1B[201~";function g(t){if(!t.startsWith(u))return"not-escape";if(t.length===1)return"incomplete";const e=t.slice(1);return e.startsWith("[")?e.startsWith("[M")?t.length>=6?"complete":"incomplete":d(t):e.startsWith("]")?B(t):e.startsWith("P")?C(t):e.startsWith("_")?W(t):e.startsWith("O")?e.length>=2?"complete":"incomplete":(e.length===1,"complete")}o(g,"isCompleteSequence");function d(t){if(!t.startsWith(`${u}[`))return"complete";if(t.length<3)return"incomplete";const e=t.slice(2),i=e[e.length-1],r=i.charCodeAt(0);if(r>=64&&r<=126){if(e.startsWith("<")){if(/^<\d+;\d+;\d+[Mm]$/.test(e))return"complete";if(i==="M"||i==="m"){const s=e.slice(1,-1).split(";");if(s.length===3&&s.every(n=>/^\d+$/.test(n)))return"complete"}return"incomplete"}return"complete"}return"incomplete"}o(d,"isCompleteCsiSequence");function B(t){return!t.startsWith(`${u}]`)||t.endsWith(`${u}\\`)||t.endsWith("\x07")?"complete":"incomplete"}o(B,"isCompleteOscSequence");function C(t){return!t.startsWith(`${u}P`)||t.endsWith(`${u}\\`)?"complete":"incomplete"}o(C,"isCompleteDcsSequence");function W(t){return!t.startsWith(`${u}_`)||t.endsWith(`${u}\\`)?"complete":"incomplete"}o(W,"isCompleteApcSequence");function m(t){const e=[];let i=0;for(;i<t.length;){const r=t.slice(i);if(r.startsWith(u)){let f=1;for(;f<=r.length;){const s=r.slice(0,f),n=g(s);if(n==="complete"){e.push(s),i+=f;break}else if(n==="incomplete")f++;else{e.push(s),i+=f;break}}if(f>r.length)return{sequences:e,remainder:r}}else e.push(r[0]),i++}return{sequences:e,remainder:""}}o(m,"extractCompleteSequences");class M extends b{static{o(this,"StdinBuffer")}buffer="";timeout=null;timeoutMs;pasteMode=!1;pasteBuffer="";constructor(e={}){super(),this.timeoutMs=e.timeout??10}process(e){this.timeout&&(clearTimeout(this.timeout),this.timeout=null);let i;if(Buffer.isBuffer(e))if(e.length===1&&e[0]>127){const s=e[0]-128;i=`\x1B${String.fromCharCode(s)}`}else i=e.toString();else i=e;if(i.length===0&&this.buffer.length===0){this.emit("data","");return}if(this.buffer+=i,this.pasteMode){this.pasteBuffer+=this.buffer,this.buffer="";const s=this.pasteBuffer.indexOf(c);if(s!==-1){const n=this.pasteBuffer.slice(0,s),h=this.pasteBuffer.slice(s+c.length);this.pasteMode=!1,this.pasteBuffer="",this.emit("paste",n),h.length>0&&this.process(h)}return}const r=this.buffer.indexOf(l);if(r!==-1){if(r>0){const n=this.buffer.slice(0,r),h=m(n);for(const p of h.sequences)this.emit("data",p)}this.buffer=this.buffer.slice(r+l.length),this.pasteMode=!0,this.pasteBuffer=this.buffer,this.buffer="";const s=this.pasteBuffer.indexOf(c);if(s!==-1){const n=this.pasteBuffer.slice(0,s),h=this.pasteBuffer.slice(s+c.length);this.pasteMode=!1,this.pasteBuffer="",this.emit("paste",n),h.length>0&&this.process(h)}return}const f=m(this.buffer);this.buffer=f.remainder;for(const s of f.sequences)this.emit("data",s);this.buffer.length>0&&(this.timeout=setTimeout(()=>{const s=this.flush();for(const n of s)this.emit("data",n)},this.timeoutMs))}flush(){if(this.timeout&&(clearTimeout(this.timeout),this.timeout=null),this.buffer.length===0)return[];const e=[this.buffer];return this.buffer="",e}clear(){this.timeout&&(clearTimeout(this.timeout),this.timeout=null),this.buffer="",this.pasteMode=!1,this.pasteBuffer=""}getBuffer(){return this.buffer}destroy(){this.clear()}}export{M as StdinBuffer};

package/dist/core/lib/tui/src/terminal-image.d.ts

@@ -0,0 +1,73 @@
+/**
+ * [WHO]: ImageProtocol, TerminalCapabilities, CellDimensions, ImageDimensions, ImageLayout
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/lib/tui/src/index.ts
+ * [HERE]: core/lib/tui/src/terminal-image.ts - terminal image protocol support
+ */
+export type ImageProtocol = "kitty" | "iterm2" | null;
+export interface TerminalCapabilities {
+    images: ImageProtocol;
+    trueColor: boolean;
+    hyperlinks: boolean;
+}
+export interface CellDimensions {
+    widthPx: number;
+    heightPx: number;
+}
+export interface ImageDimensions {
+    widthPx: number;
+    heightPx: number;
+}
+export interface ImageRenderOptions {
+    maxWidthCells?: number;
+    maxHeightCells?: number;
+    preserveAspectRatio?: boolean;
+    /** Kitty image ID. If provided, reuses/replaces existing image with this ID. */
+    imageId?: number;
+}
+export declare function getCellDimensions(): CellDimensions;
+export declare function setCellDimensions(dims: CellDimensions): void;
+export declare function detectCapabilities(): TerminalCapabilities;
+export declare function getCapabilities(): TerminalCapabilities;
+export declare function resetCapabilitiesCache(): void;
+export declare function isImageLine(line: string): boolean;
+/**
+ * Generate a random image ID for Kitty graphics protocol.
+ * Uses random IDs to avoid collisions between different module instances
+ * (e.g., main app vs extensions).
+ */
+export declare function allocateImageId(): number;
+export declare function encodeKitty(base64Data: string, options?: {
+    columns?: number;
+    rows?: number;
+    imageId?: number;
+}): string;
+/**
+ * Delete a Kitty graphics image by ID.
+ * Uses uppercase 'I' to also free the image data.
+ */
+export declare function deleteKittyImage(imageId: number): string;
+/**
+ * Delete all visible Kitty graphics images.
+ * Uses uppercase 'A' to also free the image data.
+ */
+export declare function deleteAllKittyImages(): string;
+export declare function encodeITerm2(base64Data: string, options?: {
+    width?: number | string;
+    height?: number | string;
+    name?: string;
+    preserveAspectRatio?: boolean;
+    inline?: boolean;
+}): string;
+export declare function calculateImageRows(imageDimensions: ImageDimensions, targetWidthCells: number, cellDimensions?: CellDimensions): number;
+export declare function getPngDimensions(base64Data: string): ImageDimensions | null;
+export declare function getJpegDimensions(base64Data: string): ImageDimensions | null;
+export declare function getGifDimensions(base64Data: string): ImageDimensions | null;
+export declare function getWebpDimensions(base64Data: string): ImageDimensions | null;
+export declare function getImageDimensions(base64Data: string, mimeType: string): ImageDimensions | null;
+export declare function renderImage(base64Data: string, imageDimensions: ImageDimensions, options?: ImageRenderOptions): {
+    sequence: string;
+    rows: number;
+    imageId?: number;
+} | null;
+export declare function imageFallback(mimeType: string, dimensions?: ImageDimensions, filename?: string): string;

package/dist/core/lib/tui/src/terminal-image.js

@@ -0,0 +1 @@
+var x=Object.defineProperty;var u=(t,e)=>x(t,"name",{value:e,configurable:!0});let c=null,f={widthPx:9,heightPx:18};function d(){return f}u(d,"getCellDimensions");function $(t){f=t}u($,"setCellDimensions");function m(){const t=process.env.TERM_PROGRAM?.toLowerCase()||"",e=process.env.TERM?.toLowerCase()||"",r=process.env.COLORTERM?.toLowerCase()||"";return process.env.KITTY_WINDOW_ID||t==="kitty"?{images:"kitty",trueColor:!0,hyperlinks:!0}:t==="ghostty"||e.includes("ghostty")||process.env.GHOSTTY_RESOURCES_DIR?{images:"kitty",trueColor:!0,hyperlinks:!0}:process.env.WEZTERM_PANE||t==="wezterm"?{images:"kitty",trueColor:!0,hyperlinks:!0}:process.env.ITERM_SESSION_ID||t==="iterm.app"?{images:"iterm2",trueColor:!0,hyperlinks:!0}:t==="vscode"?{images:null,trueColor:!0,hyperlinks:!0}:t==="alacritty"?{images:null,trueColor:!0,hyperlinks:!0}:{images:null,trueColor:r==="truecolor"||r==="24bit",hyperlinks:!0}}u(m,"detectCapabilities");function p(){return c||(c=m()),c}u(p,"getCapabilities");function y(){c=null}u(y,"resetCapabilitiesCache");const h="\x1B_G",a="\x1B]1337;File=";function k(t){return t.startsWith(h)||t.startsWith(a)?!0:t.includes(h)||t.includes(a)}u(k,"isImageLine");function S(){return Math.floor(Math.random()*4294967294)+1}u(S,"allocateImageId");function I(t,e={}){const n=["a=T","f=100","q=2"];if(e.columns&&n.push(`c=${e.columns}`),e.rows&&n.push(`r=${e.rows}`),e.imageId&&n.push(`i=${e.imageId}`),t.length<=4096)return`\x1B_G${n.join(",")};${t}\x1B\\`;const s=[];let i=0,l=!0;for(;i<t.length;){const o=t.slice(i,i+4096),g=i+4096>=t.length;l?(s.push(`\x1B_G${n.join(",")},m=1;${o}\x1B\\`),l=!1):g?s.push(`\x1B_Gm=0;${o}\x1B\\`):s.push(`\x1B_Gm=1;${o}\x1B\\`),i+=4096}return s.join("")}u(I,"encodeKitty");function U(t){return`\x1B_Ga=d,d=I,i=${t}\x1B\\`}u(U,"deleteKittyImage");function v(){return"\x1B_Ga=d,d=A\x1B\\"}u(v,"deleteAllKittyImages");function w(t,e={}){const r=[`inline=${e.inline!==!1?1:0}`];if(e.width!==void 0&&r.push(`width=${e.width}`),e.height!==void 0&&r.push(`height=${e.height}`),e.name){const n=Buffer.from(e.name).toString("base64");r.push(`name=${n}`)}return e.preserveAspectRatio===!1&&r.push("preserveAspectRatio=0"),`\x1B]1337;File=${r.join(";")}:${t}\x07`}u(w,"encodeITerm2");function P(t,e,r={widthPx:9,heightPx:18}){const s=e*r.widthPx/t.widthPx,i=t.heightPx*s,l=Math.ceil(i/r.heightPx);return Math.max(1,l)}u(P,"calculateImageRows");function E(t){try{const e=Buffer.from(t,"base64");if(e.length<24||e[0]!==137||e[1]!==80||e[2]!==78||e[3]!==71)return null;const r=e.readUInt32BE(16),n=e.readUInt32BE(20);return{widthPx:r,heightPx:n}}catch{return null}}u(E,"getPngDimensions");function b(t){try{const e=Buffer.from(t,"base64");if(e.length<2||e[0]!==255||e[1]!==216)return null;let r=2;for(;r<e.length-9;){if(e[r]!==255){r++;continue}const n=e[r+1];if(n>=192&&n<=194){const i=e.readUInt16BE(r+5);return{widthPx:e.readUInt16BE(r+7),heightPx:i}}if(r+3>=e.length)return null;const s=e.readUInt16BE(r+2);if(s<2)return null;r+=2+s}return null}catch{return null}}u(b,"getJpegDimensions");function C(t){try{const e=Buffer.from(t,"base64");if(e.length<10)return null;const r=e.slice(0,6).toString("ascii");if(r!=="GIF87a"&&r!=="GIF89a")return null;const n=e.readUInt16LE(6),s=e.readUInt16LE(8);return{widthPx:n,heightPx:s}}catch{return null}}u(C,"getGifDimensions");function _(t){try{const e=Buffer.from(t,"base64");if(e.length<30)return null;const r=e.slice(0,4).toString("ascii"),n=e.slice(8,12).toString("ascii");if(r!=="RIFF"||n!=="WEBP")return null;const s=e.slice(12,16).toString("ascii");if(s==="VP8 "){if(e.length<30)return null;const i=e.readUInt16LE(26)&16383,l=e.readUInt16LE(28)&16383;return{widthPx:i,heightPx:l}}else if(s==="VP8L"){if(e.length<25)return null;const i=e.readUInt32LE(21),l=(i&16383)+1,o=(i>>14&16383)+1;return{widthPx:l,heightPx:o}}else if(s==="VP8X"){if(e.length<30)return null;const i=(e[24]|e[25]<<8|e[26]<<16)+1,l=(e[27]|e[28]<<8|e[29]<<16)+1;return{widthPx:i,heightPx:l}}return null}catch{return null}}u(_,"getWebpDimensions");function B(t,e){return e==="image/png"?E(t):e==="image/jpeg"?b(t):e==="image/gif"?C(t):e==="image/webp"?_(t):null}u(B,"getImageDimensions");function G(t,e,r={}){const n=p();if(!n.images)return null;const s=r.maxWidthCells??80,i=P(e,s,d());return n.images==="kitty"?{sequence:I(t,{columns:s,rows:i,imageId:r.imageId}),rows:i,imageId:r.imageId}:n.images==="iterm2"?{sequence:w(t,{width:s,height:"auto",preserveAspectRatio:r.preserveAspectRatio??!0}),rows:i}:null}u(G,"renderImage");function L(t,e,r){const n=[];return r&&n.push(r),n.push(`[${t}]`),e&&n.push(`${e.widthPx}x${e.heightPx}`),`[Image: ${n.join(" ")}]`}u(L,"imageFallback");export{S as allocateImageId,P as calculateImageRows,v as deleteAllKittyImages,U as deleteKittyImage,m as detectCapabilities,w as encodeITerm2,I as encodeKitty,p as getCapabilities,d as getCellDimensions,C as getGifDimensions,B as getImageDimensions,b as getJpegDimensions,E as getPngDimensions,_ as getWebpDimensions,L as imageFallback,k as isImageLine,G as renderImage,y as resetCapabilitiesCache,$ as setCellDimensions};

package/dist/core/lib/tui/src/terminal.d.ts

@@ -0,0 +1,86 @@
+/**
+ * [WHO]: Terminal, ProcessTerminal
+ * [FROM]: Depends on node:fs, node:module, ./keys.js, ./stdin-buffer.js
+ * [TO]: Consumed by core/lib/tui/src/index.ts
+ * [HERE]: core/lib/tui/src/terminal.ts -
+ */
+/**
+ * Minimal terminal interface for TUI
+ */
+export interface Terminal {
+    start(onInput: (data: string) => void, onResize: () => void): void;
+    stop(): void;
+    /**
+     * Drain stdin before exiting to prevent Kitty key release events from
+     * leaking to the parent shell over slow SSH connections.
+     * @param maxMs - Maximum time to drain (default: 1000ms)
+     * @param idleMs - Exit early if no input arrives within this time (default: 50ms)
+     */
+    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
+    write(data: string): void;
+    get columns(): number;
+    get rows(): number;
+    get kittyProtocolActive(): boolean;
+    moveBy(lines: number): void;
+    hideCursor(): void;
+    showCursor(): void;
+    clearLine(): void;
+    clearFromCursor(): void;
+    clearScreen(): void;
+    setTitle(title: string): void;
+}
+/**
+ * Real terminal using process.stdin/stdout
+ */
+export declare class ProcessTerminal implements Terminal {
+    private wasRaw;
+    private inputHandler?;
+    private resizeHandler?;
+    private _kittyProtocolActive;
+    private stdinBuffer?;
+    private stdinDataHandler?;
+    private writeLogPath;
+    get kittyProtocolActive(): boolean;
+    start(onInput: (data: string) => void, onResize: () => void): void;
+    /**
+     * Set up StdinBuffer to split batched input into individual sequences.
+     * This ensures components receive single events, making matchesKey/isKeyRelease work correctly.
+     *
+     * Also watches for Kitty protocol response and enables it when detected.
+     * This is done here (after stdinBuffer parsing) rather than on raw stdin
+     * to handle the case where the response arrives split across multiple events.
+     */
+    private setupStdinBuffer;
+    /**
+     * Query terminal for Kitty keyboard protocol support and enable if available.
+     *
+     * Sends CSI ? u to query current flags. If terminal responds with CSI ? <flags> u,
+     * it supports the protocol and we enable it with CSI > 1 u.
+     *
+     * The response is detected in setupStdinBuffer's data handler, which properly
+     * handles the case where the response arrives split across multiple stdin events.
+     *
+     * GPU-renderer terminals (Warp, Wave) may have issues with Kitty protocol queries.
+     * Skip the query on these terminals to prevent crashes or hangs.
+     */
+    private queryAndEnableKittyProtocol;
+    /**
+     * On Windows, add ENABLE_VIRTUAL_TERMINAL_INPUT (0x0200) to the stdin
+     * console handle so the terminal sends VT sequences for modified keys
+     * (e.g. \x1b[Z for Shift+Tab). Without this, libuv's ReadConsoleInputW
+     * discards modifier state and Shift+Tab arrives as plain \t.
+     */
+    private enableWindowsVTInput;
+    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
+    stop(): void;
+    write(data: string): void;
+    get columns(): number;
+    get rows(): number;
+    moveBy(lines: number): void;
+    hideCursor(): void;
+    showCursor(): void;
+    clearLine(): void;
+    clearFromCursor(): void;
+    clearScreen(): void;
+    setTitle(title: string): void;
+}

package/dist/core/lib/tui/src/terminal.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var c=(u,t)=>f(u,"name",{value:t,configurable:!0});import*as p from"node:fs";import{createRequire as h}from"node:module";import{setKittyProtocolActive as l}from"./keys.js";import{StdinBuffer as w}from"./stdin-buffer.js";const m=h(import.meta.url);class P{static{c(this,"ProcessTerminal")}wasRaw=!1;inputHandler;resizeHandler;_kittyProtocolActive=!1;stdinBuffer;stdinDataHandler;writeLogPath=process.env.CATUI_TUI_WRITE_LOG??process.env.NANOPENCIL_TUI_WRITE_LOG??"";get kittyProtocolActive(){return this._kittyProtocolActive}start(t,e){this.inputHandler=t,this.resizeHandler=e,this.wasRaw=process.stdin.isRaw||!1,process.stdin.setRawMode&&process.stdin.setRawMode(!0),process.stdin.setEncoding("utf8"),process.stdin.resume(),process.stdout.write("\x1B[?2004h"),process.stdout.on("resize",this.resizeHandler),process.platform!=="win32"&&process.kill(process.pid,"SIGWINCH"),this.enableWindowsVTInput(),this.queryAndEnableKittyProtocol()}setupStdinBuffer(){this.stdinBuffer=new w({timeout:10});const t=/^\x1b\[\?(\d+)u$/;this.stdinBuffer.on("data",e=>{if(!this._kittyProtocolActive&&e.match(t)){this._kittyProtocolActive=!0,l(!0),process.stdout.write("\x1B[>7u");return}this.inputHandler&&this.inputHandler(e)}),this.stdinBuffer.on("paste",e=>{this.inputHandler&&this.inputHandler(`\x1B[200~${e}\x1B[201~`)}),this.stdinDataHandler=e=>{this.stdinBuffer.process(e)}}queryAndEnableKittyProtocol(){this.setupStdinBuffer(),process.stdin.on("data",this.stdinDataHandler);const t=process.env.TERM_PROGRAM?.toLowerCase()||"";new Set(["warpterminal","waveterm"]).has(t)||process.stdout.write("\x1B[?u")}enableWindowsVTInput(){if(process.platform==="win32")try{const e=m("koffi").load("kernel32.dll"),o=e.func("void* __stdcall GetStdHandle(int)"),i=e.func("bool __stdcall GetConsoleMode(void*, _Out_ uint32_t*)"),r=e.func("bool __stdcall SetConsoleMode(void*, uint32_t)"),d=-10,n=512,s=o(d),a=new Uint32Array(1);i(s,a),r(s,a[0]|n)}catch{}}async drainInput(t=1e3,e=50){this._kittyProtocolActive&&(process.stdout.write("\x1B[<u"),this._kittyProtocolActive=!1,l(!1));const o=this.inputHandler;this.inputHandler=void 0;let i=Date.now();const r=c(()=>{i=Date.now()},"onData");process.stdin.on("data",r);const d=Date.now()+t;try{for(;;){const n=Date.now(),s=d-n;if(s<=0||n-i>=e)break;await new Promise(a=>setTimeout(a,Math.min(e,s)))}}finally{process.stdin.removeListener("data",r),this.inputHandler=o}}stop(){process.stdout.write("\x1B[?2004l"),this._kittyProtocolActive&&(process.stdout.write("\x1B[<u"),this._kittyProtocolActive=!1,l(!1)),this.stdinBuffer&&(this.stdinBuffer.destroy(),this.stdinBuffer=void 0),this.stdinDataHandler&&(process.stdin.removeListener("data",this.stdinDataHandler),this.stdinDataHandler=void 0),this.inputHandler=void 0,this.resizeHandler&&(process.stdout.removeListener("resize",this.resizeHandler),this.resizeHandler=void 0),process.stdin.pause(),process.stdin.setRawMode&&process.stdin.setRawMode(this.wasRaw)}write(t){if(process.stdout.write(t),this.writeLogPath)try{p.appendFileSync(this.writeLogPath,t,{encoding:"utf8"})}catch{}}get columns(){return process.stdout.columns||80}get rows(){return process.stdout.rows||24}moveBy(t){t>0?process.stdout.write(`\x1B[${t}B`):t<0&&process.stdout.write(`\x1B[${-t}A`)}hideCursor(){process.stdout.write("\x1B[?25l")}showCursor(){process.stdout.write("\x1B[?25h")}clearLine(){process.stdout.write("\x1B[K")}clearFromCursor(){process.stdout.write("\x1B[J")}clearScreen(){process.stdout.write("\x1B[2J\x1B[H")}setTitle(t){process.stdout.write(`\x1B]0;${t}\x07`)}}export{P as ProcessTerminal};