@dst0/p-tui 0.4.41 → 5.0.2

package/dist/terminal/processterminal-methods/keyboard-protocol.js

@@ -0,0 +1,147 @@
+import { setKittyProtocolActive } from "../../keys.js";
+import { isNativeModifierPressed } from "../../native-modifiers.js";
+import { StdinBuffer } from "../../stdin-buffer.js";
+import { KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS, KITTY_KEYBOARD_PROTOCOL_QUERY } from "../constants.js";
+import { isAppleTerminalSession, isKeyboardProtocolNegotiationSequencePrefix, normalizeAppleTerminalInput, parseKeyboardProtocolNegotiationSequence, } from "../helpers.js";
+export function do_start(self, onInput, onResize) {
+    self.inputHandler = onInput;
+    self.resizeHandler = onResize;
+    // Save previous state and enable raw mode
+    self.wasRaw = process.stdin.isRaw || false;
+    if (process.stdin.setRawMode) {
+        process.stdin.setRawMode(true);
+    }
+    process.stdin.setEncoding("utf8");
+    process.stdin.resume();
+    // Enable bracketed paste mode - terminal will wrap pastes in \x1b[200~ ... \x1b[201~
+    process.stdout.write("\x1b[?2004h");
+    // Set up resize handler immediately
+    process.stdout.on("resize", self.resizeHandler);
+    // Refresh terminal dimensions - they may be stale after suspend/resume
+    // (SIGWINCH is lost while process is stopped). Unix only.
+    if (process.platform !== "win32") {
+        process.kill(process.pid, "SIGWINCH");
+    }
+    // On Windows, enable ENABLE_VIRTUAL_TERMINAL_INPUT so the console sends
+    // VT escape sequences (e.g. \x1b[Z for Shift+Tab) instead of raw console
+    // events that lose modifier information. Must run AFTER setRawMode(true)
+    // since that resets console mode flags.
+    self.enableWindowsVTInput();
+    // Query Kitty keyboard protocol and fall back to modifyOtherKeys when DA confirms no Kitty response.
+    // See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+    self.queryAndEnableKittyProtocol();
+}
+export function do_setupStdinBuffer(self) {
+    self.stdinBuffer = new StdinBuffer({ timeout: 10 });
+    // Forward individual sequences to the input handler
+    self.stdinBuffer.on("data", (sequence) => {
+        const negotiationSequence = self.readKeyboardProtocolNegotiationSequence(sequence);
+        if (negotiationSequence === "pending") {
+            self.scheduleKeyboardProtocolNegotiationBufferFlush();
+            return; // Wait briefly for the rest of a split Kitty response.
+        }
+        if (self.handleKeyboardProtocolNegotiationSequence(negotiationSequence)) {
+            return;
+        }
+        self.forwardInputSequence(sequence);
+    });
+    // Re-wrap paste content with bracketed paste markers for existing editor handling
+    self.stdinBuffer.on("paste", (content) => {
+        if (self.inputHandler) {
+            self.inputHandler(`\x1b[200~${content}\x1b[201~`);
+        }
+    });
+    // Handler that pipes stdin data through the buffer
+    self.stdinDataHandler = (data) => {
+        self.stdinBuffer.process(data);
+    };
+}
+export function do_queryAndEnableKittyProtocol(self) {
+    self.setupStdinBuffer();
+    process.stdin.on("data", self.stdinDataHandler);
+    self.keyboardProtocolPushed = true;
+    self.clearKeyboardProtocolNegotiationBuffer();
+    process.stdout.write(KITTY_KEYBOARD_PROTOCOL_QUERY);
+}
+export function do_handleKeyboardProtocolNegotiationSequence(self, negotiationSequence) {
+    if (!negotiationSequence)
+        return false;
+    self.clearKeyboardProtocolNegotiationBuffer();
+    if (negotiationSequence.type === "kitty-flags") {
+        if (negotiationSequence.flags !== 0) {
+            self.disableModifyOtherKeys();
+            if (!self._kittyProtocolActive) {
+                self._kittyProtocolActive = true;
+                setKittyProtocolActive(true);
+            }
+        }
+        else {
+            self.enableModifyOtherKeys();
+        }
+        return true;
+    }
+    if (!self._kittyProtocolActive) {
+        self.enableModifyOtherKeys();
+    }
+    return true;
+}
+export function do_readKeyboardProtocolNegotiationSequence(self, sequence) {
+    if (self.keyboardProtocolNegotiationBuffer) {
+        const bufferedSequence = self.keyboardProtocolNegotiationBuffer + sequence;
+        const negotiationSequence = parseKeyboardProtocolNegotiationSequence(bufferedSequence);
+        if (negotiationSequence) {
+            self.clearKeyboardProtocolNegotiationBuffer();
+            return negotiationSequence;
+        }
+        if (isKeyboardProtocolNegotiationSequencePrefix(bufferedSequence)) {
+            self.setKeyboardProtocolNegotiationBuffer(bufferedSequence);
+            return "pending";
+        }
+        self.flushKeyboardProtocolNegotiationBufferAsInput();
+    }
+    const negotiationSequence = parseKeyboardProtocolNegotiationSequence(sequence);
+    if (negotiationSequence)
+        return negotiationSequence;
+    if (isKeyboardProtocolNegotiationSequencePrefix(sequence)) {
+        self.setKeyboardProtocolNegotiationBuffer(sequence);
+        return "pending";
+    }
+    return undefined;
+}
+export function do_setKeyboardProtocolNegotiationBuffer(self, sequence) {
+    self.clearKeyboardProtocolNegotiationBufferFlushTimer();
+    self.keyboardProtocolNegotiationBuffer = sequence;
+}
+export function do_clearKeyboardProtocolNegotiationBuffer(self) {
+    self.clearKeyboardProtocolNegotiationBufferFlushTimer();
+    self.keyboardProtocolNegotiationBuffer = "";
+}
+export function do_flushKeyboardProtocolNegotiationBufferAsInput(self) {
+    if (!self.keyboardProtocolNegotiationBuffer)
+        return;
+    const sequence = self.keyboardProtocolNegotiationBuffer;
+    self.clearKeyboardProtocolNegotiationBuffer();
+    self.forwardInputSequence(sequence);
+}
+export function do_scheduleKeyboardProtocolNegotiationBufferFlush(self) {
+    if (!self.keyboardProtocolNegotiationBuffer || self.keyboardProtocolBufferFlushTimer)
+        return;
+    self.keyboardProtocolBufferFlushTimer = setTimeout(() => {
+        self.keyboardProtocolBufferFlushTimer = undefined;
+        self.flushKeyboardProtocolNegotiationBufferAsInput();
+    }, KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS);
+}
+export function do_clearKeyboardProtocolNegotiationBufferFlushTimer(self) {
+    if (!self.keyboardProtocolBufferFlushTimer)
+        return;
+    clearTimeout(self.keyboardProtocolBufferFlushTimer);
+    self.keyboardProtocolBufferFlushTimer = undefined;
+}
+export function do_forwardInputSequence(self, sequence) {
+    if (!self.inputHandler)
+        return;
+    const isAppleTerminal = sequence === "\r" && isAppleTerminalSession();
+    const input = normalizeAppleTerminalInput(sequence, isAppleTerminal, isAppleTerminal && isNativeModifierPressed("shift"));
+    self.inputHandler(input);
+}
+//# sourceMappingURL=keyboard-protocol.js.map

package/dist/terminal/processterminal-methods/keyboard-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-protocol.js","sourceRoot":"","sources":["../../../src/terminal/processterminal-methods/keyboard-protocol.ts"],"names":[],"mappings":"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","sourcesContent":["import { setKittyProtocolActive } from \"../../keys.ts\";\nimport { isNativeModifierPressed } from \"../../native-modifiers.ts\";\nimport { StdinBuffer } from \"../../stdin-buffer.ts\";\nimport { KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS, KITTY_KEYBOARD_PROTOCOL_QUERY } from \"../constants.ts\";\nimport {\n  isAppleTerminalSession,\n  isKeyboardProtocolNegotiationSequencePrefix,\n  normalizeAppleTerminalInput,\n  parseKeyboardProtocolNegotiationSequence,\n} from \"../helpers.ts\";\nimport type { ProcessTerminal } from \"../processterminal.ts\";\nimport type { KeyboardProtocolNegotiationSequence } from \"../types.ts\";\n\nexport function do_start(self: ProcessTerminal, onInput: (data: string) => void, onResize: () => void): void {\n  self.inputHandler = onInput;\n  self.resizeHandler = onResize;\n\n  // Save previous state and enable raw mode\n  self.wasRaw = process.stdin.isRaw || false;\n  if (process.stdin.setRawMode) {\n    process.stdin.setRawMode(true);\n  }\n  process.stdin.setEncoding(\"utf8\");\n  process.stdin.resume();\n\n  // Enable bracketed paste mode - terminal will wrap pastes in \\x1b[200~ ... \\x1b[201~\n  process.stdout.write(\"\\x1b[?2004h\");\n\n  // Set up resize handler immediately\n  process.stdout.on(\"resize\", self.resizeHandler);\n\n  // Refresh terminal dimensions - they may be stale after suspend/resume\n  // (SIGWINCH is lost while process is stopped). Unix only.\n  if (process.platform !== \"win32\") {\n    process.kill(process.pid, \"SIGWINCH\");\n  }\n\n  // On Windows, enable ENABLE_VIRTUAL_TERMINAL_INPUT so the console sends\n  // VT escape sequences (e.g. \\x1b[Z for Shift+Tab) instead of raw console\n  // events that lose modifier information. Must run AFTER setRawMode(true)\n  // since that resets console mode flags.\n  self.enableWindowsVTInput();\n\n  // Query Kitty keyboard protocol and fall back to modifyOtherKeys when DA confirms no Kitty response.\n  // See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/\n  self.queryAndEnableKittyProtocol();\n}\n\nexport function do_setupStdinBuffer(self: ProcessTerminal): void {\n  self.stdinBuffer = new StdinBuffer({ timeout: 10 });\n\n  // Forward individual sequences to the input handler\n  self.stdinBuffer.on(\"data\", (sequence) => {\n    const negotiationSequence = self.readKeyboardProtocolNegotiationSequence(sequence);\n    if (negotiationSequence === \"pending\") {\n      self.scheduleKeyboardProtocolNegotiationBufferFlush();\n      return; // Wait briefly for the rest of a split Kitty response.\n    }\n    if (self.handleKeyboardProtocolNegotiationSequence(negotiationSequence)) {\n      return;\n    }\n\n    self.forwardInputSequence(sequence);\n  });\n\n  // Re-wrap paste content with bracketed paste markers for existing editor handling\n  self.stdinBuffer.on(\"paste\", (content) => {\n    if (self.inputHandler) {\n      self.inputHandler(`\\x1b[200~${content}\\x1b[201~`);\n    }\n  });\n\n  // Handler that pipes stdin data through the buffer\n  self.stdinDataHandler = (data: string) => {\n    self.stdinBuffer!.process(data);\n  };\n}\n\nexport function do_queryAndEnableKittyProtocol(self: ProcessTerminal): void {\n  self.setupStdinBuffer();\n  process.stdin.on(\"data\", self.stdinDataHandler!);\n  self.keyboardProtocolPushed = true;\n  self.clearKeyboardProtocolNegotiationBuffer();\n  process.stdout.write(KITTY_KEYBOARD_PROTOCOL_QUERY);\n}\n\nexport function do_handleKeyboardProtocolNegotiationSequence(\n  self: ProcessTerminal,\n  negotiationSequence: KeyboardProtocolNegotiationSequence | undefined,\n): boolean {\n  if (!negotiationSequence) return false;\n  self.clearKeyboardProtocolNegotiationBuffer();\n  if (negotiationSequence.type === \"kitty-flags\") {\n    if (negotiationSequence.flags !== 0) {\n      self.disableModifyOtherKeys();\n      if (!self._kittyProtocolActive) {\n        self._kittyProtocolActive = true;\n        setKittyProtocolActive(true);\n      }\n    } else {\n      self.enableModifyOtherKeys();\n    }\n    return true;\n  }\n\n  if (!self._kittyProtocolActive) {\n    self.enableModifyOtherKeys();\n  }\n  return true;\n}\n\nexport function do_readKeyboardProtocolNegotiationSequence(\n  self: ProcessTerminal,\n  sequence: string,\n): KeyboardProtocolNegotiationSequence | \"pending\" | undefined {\n  if (self.keyboardProtocolNegotiationBuffer) {\n    const bufferedSequence = self.keyboardProtocolNegotiationBuffer + sequence;\n    const negotiationSequence = parseKeyboardProtocolNegotiationSequence(bufferedSequence);\n    if (negotiationSequence) {\n      self.clearKeyboardProtocolNegotiationBuffer();\n      return negotiationSequence;\n    }\n    if (isKeyboardProtocolNegotiationSequencePrefix(bufferedSequence)) {\n      self.setKeyboardProtocolNegotiationBuffer(bufferedSequence);\n      return \"pending\";\n    }\n    self.flushKeyboardProtocolNegotiationBufferAsInput();\n  }\n\n  const negotiationSequence = parseKeyboardProtocolNegotiationSequence(sequence);\n  if (negotiationSequence) return negotiationSequence;\n  if (isKeyboardProtocolNegotiationSequencePrefix(sequence)) {\n    self.setKeyboardProtocolNegotiationBuffer(sequence);\n    return \"pending\";\n  }\n  return undefined;\n}\n\nexport function do_setKeyboardProtocolNegotiationBuffer(self: ProcessTerminal, sequence: string): void {\n  self.clearKeyboardProtocolNegotiationBufferFlushTimer();\n  self.keyboardProtocolNegotiationBuffer = sequence;\n}\n\nexport function do_clearKeyboardProtocolNegotiationBuffer(self: ProcessTerminal): void {\n  self.clearKeyboardProtocolNegotiationBufferFlushTimer();\n  self.keyboardProtocolNegotiationBuffer = \"\";\n}\n\nexport function do_flushKeyboardProtocolNegotiationBufferAsInput(self: ProcessTerminal): void {\n  if (!self.keyboardProtocolNegotiationBuffer) return;\n  const sequence = self.keyboardProtocolNegotiationBuffer;\n  self.clearKeyboardProtocolNegotiationBuffer();\n  self.forwardInputSequence(sequence);\n}\n\nexport function do_scheduleKeyboardProtocolNegotiationBufferFlush(self: ProcessTerminal): void {\n  if (!self.keyboardProtocolNegotiationBuffer || self.keyboardProtocolBufferFlushTimer) return;\n  self.keyboardProtocolBufferFlushTimer = setTimeout(() => {\n    self.keyboardProtocolBufferFlushTimer = undefined;\n    self.flushKeyboardProtocolNegotiationBufferAsInput();\n  }, KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS);\n}\n\nexport function do_clearKeyboardProtocolNegotiationBufferFlushTimer(self: ProcessTerminal): void {\n  if (!self.keyboardProtocolBufferFlushTimer) return;\n  clearTimeout(self.keyboardProtocolBufferFlushTimer);\n  self.keyboardProtocolBufferFlushTimer = undefined;\n}\n\nexport function do_forwardInputSequence(self: ProcessTerminal, sequence: string): void {\n  if (!self.inputHandler) return;\n  const isAppleTerminal = sequence === \"\\r\" && isAppleTerminalSession();\n  const input = normalizeAppleTerminalInput(\n    sequence,\n    isAppleTerminal,\n    isAppleTerminal && isNativeModifierPressed(\"shift\"),\n  );\n  self.inputHandler(input);\n}\n"]}

package/dist/terminal/processterminal-methods/terminal-io.d.ts

@@ -0,0 +1,9 @@
+import type { ProcessTerminal } from "../processterminal.ts";
+export declare function do_enableModifyOtherKeys(self: ProcessTerminal): void;
+export declare function do_disableModifyOtherKeys(self: ProcessTerminal): void;
+export declare function do_enableWindowsVTInput(_self: ProcessTerminal): void;
+export declare function do_drainInput(self: ProcessTerminal, maxMs?: number, idleMs?: number): Promise<void>;
+export declare function do_stop(self: ProcessTerminal): void;
+export declare function do_write(self: ProcessTerminal, data: string): void;
+export declare function do_moveBy(_self: ProcessTerminal, lines: number): void;
+//# sourceMappingURL=terminal-io.d.ts.map

package/dist/terminal/processterminal-methods/terminal-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-io.d.ts","sourceRoot":"","sources":["../../../src/terminal/processterminal-methods/terminal-io.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAIpE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAIrE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CA4BpE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,SAAO,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCnG;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAiDnD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CASlE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASrE","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { setKittyProtocolActive } from \"../../keys.ts\";\nimport { cjsRequire, TERMINAL_PROGRESS_CLEAR_SEQUENCE } from \"../constants.ts\";\nimport type { ProcessTerminal } from \"../processterminal.ts\";\n\nexport function do_enableModifyOtherKeys(self: ProcessTerminal): void {\n  if (self._kittyProtocolActive || self._modifyOtherKeysActive) return;\n  process.stdout.write(\"\\x1b[>4;2m\");\n  self._modifyOtherKeysActive = true;\n}\n\nexport function do_disableModifyOtherKeys(self: ProcessTerminal): void {\n  if (!self._modifyOtherKeysActive) return;\n  process.stdout.write(\"\\x1b[>4;0m\");\n  self._modifyOtherKeysActive = false;\n}\n\nexport function do_enableWindowsVTInput(_self: ProcessTerminal): void {\n  if (process.platform !== \"win32\") return;\n  try {\n    const arch = process.arch;\n    if (arch !== \"x64\" && arch !== \"arm64\") return;\n\n    // Dynamic require so non-Windows and bundled/browser paths never load the\n    // native helper. In the npm package native/ is next to dist/; in compiled\n    // binary archives native/ is copied next to the executable.\n    const moduleDir = path.dirname(fileURLToPath(import.meta.url));\n    const nativePath = path.join(\"native\", \"win32\", \"prebuilds\", `win32-${arch}`, \"win32-console-mode.node\");\n    const candidates = [\n      path.join(moduleDir, \"..\", nativePath),\n      path.join(moduleDir, nativePath),\n      path.join(path.dirname(process.execPath), nativePath),\n    ];\n    for (const modulePath of candidates) {\n      try {\n        const helper = cjsRequire(modulePath) as { enableVirtualTerminalInput?: () => boolean };\n        helper.enableVirtualTerminalInput?.();\n        return;\n      } catch {\n        // Try the next possible packaging location.\n      }\n    }\n  } catch {\n    // Native helper not available — Shift+Tab won't be distinguishable from Tab.\n  }\n}\n\nexport async function do_drainInput(self: ProcessTerminal, maxMs = 1000, idleMs = 50): Promise<void> {\n  self.setMouseTracking(false);\n  const shouldDisableKittyProtocol = self.keyboardProtocolPushed || self._kittyProtocolActive;\n  self.clearKeyboardProtocolNegotiationBuffer();\n  if (shouldDisableKittyProtocol) {\n    // Disable Kitty keyboard protocol first so any late key releases\n    // do not generate new Kitty escape sequences.\n    process.stdout.write(\"\\x1b[<u\");\n    self.keyboardProtocolPushed = false;\n    self._kittyProtocolActive = false;\n    setKittyProtocolActive(false);\n  }\n  self.disableModifyOtherKeys();\n\n  const previousHandler = self.inputHandler;\n  self.inputHandler = undefined;\n\n  let lastDataTime = Date.now();\n  const onData = () => {\n    lastDataTime = Date.now();\n  };\n\n  process.stdin.on(\"data\", onData);\n  const endTime = Date.now() + maxMs;\n\n  const check = async (): Promise<void> => {\n    const now = Date.now();\n    const timeLeft = endTime - now;\n    if (timeLeft <= 0) return;\n    if (now - lastDataTime >= idleMs) return;\n    await new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));\n    return check();\n  };\n\n  try {\n    await check();\n  } finally {\n    process.stdin.removeListener(\"data\", onData);\n    self.inputHandler = previousHandler;\n  }\n}\n\nexport function do_stop(self: ProcessTerminal): void {\n  if (self.clearProgressInterval()) {\n    process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n  }\n\n  self.setMouseTracking(false);\n\n  // Disable bracketed paste mode\n  process.stdout.write(\"\\x1b[?2004l\");\n\n  const shouldDisableKittyProtocol = self.keyboardProtocolPushed || self._kittyProtocolActive;\n  self.clearKeyboardProtocolNegotiationBuffer();\n\n  /* c8 ignore stop */\n  // Disable Kitty keyboard protocol if not already done by drainInput()\n  if (shouldDisableKittyProtocol) {\n    process.stdout.write(\"\\x1b[<u\");\n    self.keyboardProtocolPushed = false;\n    self._kittyProtocolActive = false;\n    setKittyProtocolActive(false);\n  }\n  self.disableModifyOtherKeys();\n\n  // Clean up StdinBuffer\n  if (self.stdinBuffer) {\n    self.stdinBuffer.destroy();\n    self.stdinBuffer = undefined;\n  }\n\n  // Remove event handlers\n  if (self.stdinDataHandler) {\n    process.stdin.removeListener(\"data\", self.stdinDataHandler);\n    self.stdinDataHandler = undefined;\n  }\n  self.inputHandler = undefined;\n  if (self.resizeHandler) {\n    process.stdout.removeListener(\"resize\", self.resizeHandler);\n    self.resizeHandler = undefined;\n  }\n\n  // Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being\n  // re-interpreted after raw mode is disabled. This fixes a race condition\n  // where Ctrl+D could close the parent shell over SSH.\n  process.stdin.pause();\n\n  // Restore raw mode state\n  if (process.stdin.setRawMode) {\n    process.stdin.setRawMode(self.wasRaw);\n  }\n}\n\nexport function do_write(self: ProcessTerminal, data: string): void {\n  process.stdout.write(data);\n  if (self.writeLogPath) {\n    try {\n      fs.appendFileSync(self.writeLogPath, data, { encoding: \"utf8\" });\n    } catch {\n      // Ignore logging errors\n    }\n  }\n}\n\nexport function do_moveBy(_self: ProcessTerminal, lines: number): void {\n  if (lines > 0) {\n    // Move down\n    process.stdout.write(`\\x1b[${lines}B`);\n  } else if (lines < 0) {\n    // Move up\n    process.stdout.write(`\\x1b[${-lines}A`);\n  }\n  // lines === 0: no movement\n}\n"]}

package/dist/terminal/processterminal-methods/terminal-io.js

@@ -0,0 +1,153 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { setKittyProtocolActive } from "../../keys.js";
+import { cjsRequire, TERMINAL_PROGRESS_CLEAR_SEQUENCE } from "../constants.js";
+export function do_enableModifyOtherKeys(self) {
+    if (self._kittyProtocolActive || self._modifyOtherKeysActive)
+        return;
+    process.stdout.write("\x1b[>4;2m");
+    self._modifyOtherKeysActive = true;
+}
+export function do_disableModifyOtherKeys(self) {
+    if (!self._modifyOtherKeysActive)
+        return;
+    process.stdout.write("\x1b[>4;0m");
+    self._modifyOtherKeysActive = false;
+}
+export function do_enableWindowsVTInput(_self) {
+    if (process.platform !== "win32")
+        return;
+    try {
+        const arch = process.arch;
+        if (arch !== "x64" && arch !== "arm64")
+            return;
+        // Dynamic require so non-Windows and bundled/browser paths never load the
+        // native helper. In the npm package native/ is next to dist/; in compiled
+        // binary archives native/ is copied next to the executable.
+        const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+        const nativePath = path.join("native", "win32", "prebuilds", `win32-${arch}`, "win32-console-mode.node");
+        const candidates = [
+            path.join(moduleDir, "..", nativePath),
+            path.join(moduleDir, nativePath),
+            path.join(path.dirname(process.execPath), nativePath),
+        ];
+        for (const modulePath of candidates) {
+            try {
+                const helper = cjsRequire(modulePath);
+                helper.enableVirtualTerminalInput?.();
+                return;
+            }
+            catch {
+                // Try the next possible packaging location.
+            }
+        }
+    }
+    catch {
+        // Native helper not available — Shift+Tab won't be distinguishable from Tab.
+    }
+}
+export async function do_drainInput(self, maxMs = 1000, idleMs = 50) {
+    self.setMouseTracking(false);
+    const shouldDisableKittyProtocol = self.keyboardProtocolPushed || self._kittyProtocolActive;
+    self.clearKeyboardProtocolNegotiationBuffer();
+    if (shouldDisableKittyProtocol) {
+        // Disable Kitty keyboard protocol first so any late key releases
+        // do not generate new Kitty escape sequences.
+        process.stdout.write("\x1b[<u");
+        self.keyboardProtocolPushed = false;
+        self._kittyProtocolActive = false;
+        setKittyProtocolActive(false);
+    }
+    self.disableModifyOtherKeys();
+    const previousHandler = self.inputHandler;
+    self.inputHandler = undefined;
+    let lastDataTime = Date.now();
+    const onData = () => {
+        lastDataTime = Date.now();
+    };
+    process.stdin.on("data", onData);
+    const endTime = Date.now() + maxMs;
+    const check = async () => {
+        const now = Date.now();
+        const timeLeft = endTime - now;
+        if (timeLeft <= 0)
+            return;
+        if (now - lastDataTime >= idleMs)
+            return;
+        await new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));
+        return check();
+    };
+    try {
+        await check();
+    }
+    finally {
+        process.stdin.removeListener("data", onData);
+        self.inputHandler = previousHandler;
+    }
+}
+export function do_stop(self) {
+    if (self.clearProgressInterval()) {
+        process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);
+    }
+    self.setMouseTracking(false);
+    // Disable bracketed paste mode
+    process.stdout.write("\x1b[?2004l");
+    const shouldDisableKittyProtocol = self.keyboardProtocolPushed || self._kittyProtocolActive;
+    self.clearKeyboardProtocolNegotiationBuffer();
+    /* c8 ignore stop */
+    // Disable Kitty keyboard protocol if not already done by drainInput()
+    if (shouldDisableKittyProtocol) {
+        process.stdout.write("\x1b[<u");
+        self.keyboardProtocolPushed = false;
+        self._kittyProtocolActive = false;
+        setKittyProtocolActive(false);
+    }
+    self.disableModifyOtherKeys();
+    // Clean up StdinBuffer
+    if (self.stdinBuffer) {
+        self.stdinBuffer.destroy();
+        self.stdinBuffer = undefined;
+    }
+    // Remove event handlers
+    if (self.stdinDataHandler) {
+        process.stdin.removeListener("data", self.stdinDataHandler);
+        self.stdinDataHandler = undefined;
+    }
+    self.inputHandler = undefined;
+    if (self.resizeHandler) {
+        process.stdout.removeListener("resize", self.resizeHandler);
+        self.resizeHandler = undefined;
+    }
+    // Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being
+    // re-interpreted after raw mode is disabled. This fixes a race condition
+    // where Ctrl+D could close the parent shell over SSH.
+    process.stdin.pause();
+    // Restore raw mode state
+    if (process.stdin.setRawMode) {
+        process.stdin.setRawMode(self.wasRaw);
+    }
+}
+export function do_write(self, data) {
+    process.stdout.write(data);
+    if (self.writeLogPath) {
+        try {
+            fs.appendFileSync(self.writeLogPath, data, { encoding: "utf8" });
+        }
+        catch {
+            // Ignore logging errors
+        }
+    }
+}
+export function do_moveBy(_self, lines) {
+    if (lines > 0) {
+        // Move down
+        process.stdout.write(`\x1b[${lines}B`);
+    }
+    else if (lines < 0) {
+        // Move up
+        process.stdout.write(`\x1b[${-lines}A`);
+    }
+    // lines === 0: no movement
+}
+//# sourceMappingURL=terminal-io.js.map

package/dist/terminal/processterminal-methods/terminal-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-io.js","sourceRoot":"","sources":["../../../src/terminal/processterminal-methods/terminal-io.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { setKittyProtocolActive } from \"../../keys.ts\";\nimport { cjsRequire, TERMINAL_PROGRESS_CLEAR_SEQUENCE } from \"../constants.ts\";\nimport type { ProcessTerminal } from \"../processterminal.ts\";\n\nexport function do_enableModifyOtherKeys(self: ProcessTerminal): void {\n  if (self._kittyProtocolActive || self._modifyOtherKeysActive) return;\n  process.stdout.write(\"\\x1b[>4;2m\");\n  self._modifyOtherKeysActive = true;\n}\n\nexport function do_disableModifyOtherKeys(self: ProcessTerminal): void {\n  if (!self._modifyOtherKeysActive) return;\n  process.stdout.write(\"\\x1b[>4;0m\");\n  self._modifyOtherKeysActive = false;\n}\n\nexport function do_enableWindowsVTInput(_self: ProcessTerminal): void {\n  if (process.platform !== \"win32\") return;\n  try {\n    const arch = process.arch;\n    if (arch !== \"x64\" && arch !== \"arm64\") return;\n\n    // Dynamic require so non-Windows and bundled/browser paths never load the\n    // native helper. In the npm package native/ is next to dist/; in compiled\n    // binary archives native/ is copied next to the executable.\n    const moduleDir = path.dirname(fileURLToPath(import.meta.url));\n    const nativePath = path.join(\"native\", \"win32\", \"prebuilds\", `win32-${arch}`, \"win32-console-mode.node\");\n    const candidates = [\n      path.join(moduleDir, \"..\", nativePath),\n      path.join(moduleDir, nativePath),\n      path.join(path.dirname(process.execPath), nativePath),\n    ];\n    for (const modulePath of candidates) {\n      try {\n        const helper = cjsRequire(modulePath) as { enableVirtualTerminalInput?: () => boolean };\n        helper.enableVirtualTerminalInput?.();\n        return;\n      } catch {\n        // Try the next possible packaging location.\n      }\n    }\n  } catch {\n    // Native helper not available — Shift+Tab won't be distinguishable from Tab.\n  }\n}\n\nexport async function do_drainInput(self: ProcessTerminal, maxMs = 1000, idleMs = 50): Promise<void> {\n  self.setMouseTracking(false);\n  const shouldDisableKittyProtocol = self.keyboardProtocolPushed || self._kittyProtocolActive;\n  self.clearKeyboardProtocolNegotiationBuffer();\n  if (shouldDisableKittyProtocol) {\n    // Disable Kitty keyboard protocol first so any late key releases\n    // do not generate new Kitty escape sequences.\n    process.stdout.write(\"\\x1b[<u\");\n    self.keyboardProtocolPushed = false;\n    self._kittyProtocolActive = false;\n    setKittyProtocolActive(false);\n  }\n  self.disableModifyOtherKeys();\n\n  const previousHandler = self.inputHandler;\n  self.inputHandler = undefined;\n\n  let lastDataTime = Date.now();\n  const onData = () => {\n    lastDataTime = Date.now();\n  };\n\n  process.stdin.on(\"data\", onData);\n  const endTime = Date.now() + maxMs;\n\n  const check = async (): Promise<void> => {\n    const now = Date.now();\n    const timeLeft = endTime - now;\n    if (timeLeft <= 0) return;\n    if (now - lastDataTime >= idleMs) return;\n    await new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));\n    return check();\n  };\n\n  try {\n    await check();\n  } finally {\n    process.stdin.removeListener(\"data\", onData);\n    self.inputHandler = previousHandler;\n  }\n}\n\nexport function do_stop(self: ProcessTerminal): void {\n  if (self.clearProgressInterval()) {\n    process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n  }\n\n  self.setMouseTracking(false);\n\n  // Disable bracketed paste mode\n  process.stdout.write(\"\\x1b[?2004l\");\n\n  const shouldDisableKittyProtocol = self.keyboardProtocolPushed || self._kittyProtocolActive;\n  self.clearKeyboardProtocolNegotiationBuffer();\n\n  /* c8 ignore stop */\n  // Disable Kitty keyboard protocol if not already done by drainInput()\n  if (shouldDisableKittyProtocol) {\n    process.stdout.write(\"\\x1b[<u\");\n    self.keyboardProtocolPushed = false;\n    self._kittyProtocolActive = false;\n    setKittyProtocolActive(false);\n  }\n  self.disableModifyOtherKeys();\n\n  // Clean up StdinBuffer\n  if (self.stdinBuffer) {\n    self.stdinBuffer.destroy();\n    self.stdinBuffer = undefined;\n  }\n\n  // Remove event handlers\n  if (self.stdinDataHandler) {\n    process.stdin.removeListener(\"data\", self.stdinDataHandler);\n    self.stdinDataHandler = undefined;\n  }\n  self.inputHandler = undefined;\n  if (self.resizeHandler) {\n    process.stdout.removeListener(\"resize\", self.resizeHandler);\n    self.resizeHandler = undefined;\n  }\n\n  // Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being\n  // re-interpreted after raw mode is disabled. This fixes a race condition\n  // where Ctrl+D could close the parent shell over SSH.\n  process.stdin.pause();\n\n  // Restore raw mode state\n  if (process.stdin.setRawMode) {\n    process.stdin.setRawMode(self.wasRaw);\n  }\n}\n\nexport function do_write(self: ProcessTerminal, data: string): void {\n  process.stdout.write(data);\n  if (self.writeLogPath) {\n    try {\n      fs.appendFileSync(self.writeLogPath, data, { encoding: \"utf8\" });\n    } catch {\n      // Ignore logging errors\n    }\n  }\n}\n\nexport function do_moveBy(_self: ProcessTerminal, lines: number): void {\n  if (lines > 0) {\n    // Move down\n    process.stdout.write(`\\x1b[${lines}B`);\n  } else if (lines < 0) {\n    // Move up\n    process.stdout.write(`\\x1b[${-lines}A`);\n  }\n  // lines === 0: no movement\n}\n"]}

package/dist/terminal/processterminal.d.ts

@@ -0,0 +1,49 @@
+import type { StdinBuffer } from "../stdin-buffer.ts";
+import type { KeyboardProtocolNegotiationSequence, Terminal } from "./types.ts";
+export declare class ProcessTerminal implements Terminal {
+    wasRaw: boolean;
+    inputHandler?: (data: string) => void;
+    resizeHandler?: () => void;
+    _kittyProtocolActive: boolean;
+    _modifyOtherKeysActive: boolean;
+    keyboardProtocolPushed: boolean;
+    keyboardProtocolNegotiationBuffer: string;
+    keyboardProtocolBufferFlushTimer?: ReturnType<typeof setTimeout>;
+    stdinBuffer?: StdinBuffer;
+    stdinDataHandler?: (data: string) => void;
+    progressInterval?: ReturnType<typeof setInterval>;
+    mouseTrackingActive: boolean;
+    writeLogPath: string;
+    get kittyProtocolActive(): boolean;
+    get modifyOtherKeysActive(): boolean;
+    get columns(): number;
+    get rows(): number;
+    start(onInput: (data: string) => void, onResize: () => void): void;
+    setupStdinBuffer(): void;
+    queryAndEnableKittyProtocol(): void;
+    handleKeyboardProtocolNegotiationSequence(negotiationSequence: KeyboardProtocolNegotiationSequence | undefined): boolean;
+    readKeyboardProtocolNegotiationSequence(sequence: string): KeyboardProtocolNegotiationSequence | "pending" | undefined;
+    setKeyboardProtocolNegotiationBuffer(sequence: string): void;
+    clearKeyboardProtocolNegotiationBuffer(): void;
+    flushKeyboardProtocolNegotiationBufferAsInput(): void;
+    scheduleKeyboardProtocolNegotiationBufferFlush(): void;
+    clearKeyboardProtocolNegotiationBufferFlushTimer(): void;
+    forwardInputSequence(sequence: string): void;
+    enableModifyOtherKeys(): void;
+    disableModifyOtherKeys(): void;
+    enableWindowsVTInput(): void;
+    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
+    stop(): void;
+    write(data: string): void;
+    moveBy(lines: number): void;
+    hideCursor(): void;
+    showCursor(): void;
+    clearLine(): void;
+    clearFromCursor(): void;
+    clearScreen(): void;
+    setTitle(title: string): void;
+    setProgress(active: boolean): void;
+    setMouseTracking(active: boolean): void;
+    clearProgressInterval(): boolean;
+}
+//# sourceMappingURL=processterminal.d.ts.map

package/dist/terminal/processterminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processterminal.d.ts","sourceRoot":"","sources":["../../src/terminal/processterminal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkCtD,OAAO,KAAK,EAAE,mCAAmC,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhF,qBAAa,eAAgB,YAAW,QAAQ;IACvC,MAAM,UAAS;IAEf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAE3B,oBAAoB,UAAS;IAE7B,sBAAsB,UAAS;IAE/B,sBAAsB,UAAS;IAE/B,iCAAiC,SAAM;IAEvC,gCAAgC,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAEjE,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,gBAAgB,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAElD,mBAAmB,UAAS;IAE5B,YAAY,SAad;IAEL,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED,IAAI,qBAAqB,IAAI,OAAO,CAEnC;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAEjE;IAED,gBAAgB,IAAI,IAAI,CAEvB;IAED,2BAA2B,IAAI,IAAI,CAElC;IAED,yCAAyC,CACvC,mBAAmB,EAAE,mCAAmC,GAAG,SAAS,GACnE,OAAO,CAET;IAED,uCAAuC,CACrC,QAAQ,EAAE,MAAM,GACf,mCAAmC,GAAG,SAAS,GAAG,SAAS,CAE7D;IAED,oCAAoC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3D;IAED,sCAAsC,IAAI,IAAI,CAE7C;IAED,6CAA6C,IAAI,IAAI,CAEpD;IAED,8CAA8C,IAAI,IAAI,CAErD;IAED,gDAAgD,IAAI,IAAI,CAEvD;IAED,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3C;IAED,qBAAqB,IAAI,IAAI,CAE5B;IAED,sBAAsB,IAAI,IAAI,CAE7B;IAED,oBAAoB,IAAI,IAAI,CAE3B;IAEK,UAAU,CAAC,KAAK,SAAO,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;IAED,IAAI,IAAI,IAAI,CAEX;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE1B;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,SAAS,IAAI,IAAI,CAEhB;IAED,eAAe,IAAI,IAAI,CAEtB;IAED,WAAW,IAAI,IAAI,CAElB;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5B;IAED,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAEjC;IAED,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAEtC;IAED,qBAAqB,IAAI,OAAO,CAE/B;CACF","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { StdinBuffer } from \"../stdin-buffer.ts\";\nimport {\n  do_clearFromCursor,\n  do_clearLine,\n  do_clearProgressInterval,\n  do_clearScreen,\n  do_hideCursor,\n  do_setMouseTracking,\n  do_setProgress,\n  do_setTitle,\n  do_showCursor,\n} from \"./processterminal-methods/cursor-screen.ts\";\nimport {\n  do_clearKeyboardProtocolNegotiationBuffer,\n  do_clearKeyboardProtocolNegotiationBufferFlushTimer,\n  do_flushKeyboardProtocolNegotiationBufferAsInput,\n  do_forwardInputSequence,\n  do_handleKeyboardProtocolNegotiationSequence,\n  do_queryAndEnableKittyProtocol,\n  do_readKeyboardProtocolNegotiationSequence,\n  do_scheduleKeyboardProtocolNegotiationBufferFlush,\n  do_setKeyboardProtocolNegotiationBuffer,\n  do_setupStdinBuffer,\n  do_start,\n} from \"./processterminal-methods/keyboard-protocol.ts\";\nimport {\n  do_disableModifyOtherKeys,\n  do_drainInput,\n  do_enableModifyOtherKeys,\n  do_enableWindowsVTInput,\n  do_moveBy,\n  do_stop,\n  do_write,\n} from \"./processterminal-methods/terminal-io.ts\";\nimport type { KeyboardProtocolNegotiationSequence, Terminal } from \"./types.ts\";\n\nexport class ProcessTerminal implements Terminal {\n  public wasRaw = false;\n\n  public inputHandler?: (data: string) => void;\n\n  public resizeHandler?: () => void;\n\n  public _kittyProtocolActive = false;\n\n  public _modifyOtherKeysActive = false;\n\n  public keyboardProtocolPushed = false;\n\n  public keyboardProtocolNegotiationBuffer = \"\";\n\n  public keyboardProtocolBufferFlushTimer?: ReturnType<typeof setTimeout>;\n\n  public stdinBuffer?: StdinBuffer;\n\n  public stdinDataHandler?: (data: string) => void;\n\n  public progressInterval?: ReturnType<typeof setInterval>;\n\n  public mouseTrackingActive = false;\n\n  public writeLogPath = (() => {\n    const env = process.env.PI_TUI_WRITE_LOG || \"\";\n    if (!env) return \"\";\n    try {\n      if (fs.statSync(env).isDirectory()) {\n        const now = new Date();\n        const ts = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, \"0\")}-${String(now.getDate()).padStart(2, \"0\")}_${String(now.getHours()).padStart(2, \"0\")}-${String(now.getMinutes()).padStart(2, \"0\")}-${String(now.getSeconds()).padStart(2, \"0\")}`;\n        return path.join(env, `tui-${ts}-${process.pid}.log`);\n      }\n    } catch {\n      // Not an existing directory - use as-is (file path)\n    }\n    return env;\n  })();\n\n  get kittyProtocolActive(): boolean {\n    return this._kittyProtocolActive;\n  }\n\n  get modifyOtherKeysActive(): boolean {\n    return this._modifyOtherKeysActive;\n  }\n\n  get columns(): number {\n    return process.stdout.columns || Number(process.env.COLUMNS) || 80;\n  }\n\n  get rows(): number {\n    return process.stdout.rows || Number(process.env.LINES) || 24;\n  }\n\n  start(onInput: (data: string) => void, onResize: () => void): void {\n    do_start(this, onInput, onResize);\n  }\n\n  setupStdinBuffer(): void {\n    do_setupStdinBuffer(this);\n  }\n\n  queryAndEnableKittyProtocol(): void {\n    do_queryAndEnableKittyProtocol(this);\n  }\n\n  handleKeyboardProtocolNegotiationSequence(\n    negotiationSequence: KeyboardProtocolNegotiationSequence | undefined,\n  ): boolean {\n    return do_handleKeyboardProtocolNegotiationSequence(this, negotiationSequence);\n  }\n\n  readKeyboardProtocolNegotiationSequence(\n    sequence: string,\n  ): KeyboardProtocolNegotiationSequence | \"pending\" | undefined {\n    return do_readKeyboardProtocolNegotiationSequence(this, sequence);\n  }\n\n  setKeyboardProtocolNegotiationBuffer(sequence: string): void {\n    do_setKeyboardProtocolNegotiationBuffer(this, sequence);\n  }\n\n  clearKeyboardProtocolNegotiationBuffer(): void {\n    do_clearKeyboardProtocolNegotiationBuffer(this);\n  }\n\n  flushKeyboardProtocolNegotiationBufferAsInput(): void {\n    do_flushKeyboardProtocolNegotiationBufferAsInput(this);\n  }\n\n  scheduleKeyboardProtocolNegotiationBufferFlush(): void {\n    do_scheduleKeyboardProtocolNegotiationBufferFlush(this);\n  }\n\n  clearKeyboardProtocolNegotiationBufferFlushTimer(): void {\n    do_clearKeyboardProtocolNegotiationBufferFlushTimer(this);\n  }\n\n  forwardInputSequence(sequence: string): void {\n    do_forwardInputSequence(this, sequence);\n  }\n\n  enableModifyOtherKeys(): void {\n    do_enableModifyOtherKeys(this);\n  }\n\n  disableModifyOtherKeys(): void {\n    do_disableModifyOtherKeys(this);\n  }\n\n  enableWindowsVTInput(): void {\n    do_enableWindowsVTInput(this);\n  }\n\n  async drainInput(maxMs = 1000, idleMs = 50): Promise<void> {\n    return do_drainInput(this, maxMs, idleMs);\n  }\n\n  stop(): void {\n    do_stop(this);\n  }\n\n  write(data: string): void {\n    do_write(this, data);\n  }\n\n  moveBy(lines: number): void {\n    do_moveBy(this, lines);\n  }\n\n  hideCursor(): void {\n    do_hideCursor(this);\n  }\n\n  showCursor(): void {\n    do_showCursor(this);\n  }\n\n  clearLine(): void {\n    do_clearLine(this);\n  }\n\n  clearFromCursor(): void {\n    do_clearFromCursor(this);\n  }\n\n  clearScreen(): void {\n    do_clearScreen(this);\n  }\n\n  setTitle(title: string): void {\n    do_setTitle(this, title);\n  }\n\n  setProgress(active: boolean): void {\n    do_setProgress(this, active);\n  }\n\n  setMouseTracking(active: boolean): void {\n    do_setMouseTracking(this, active);\n  }\n\n  clearProgressInterval(): boolean {\n    return do_clearProgressInterval(this);\n  }\n}\n"]}

package/dist/terminal/processterminal.js

@@ -0,0 +1,129 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { do_clearFromCursor, do_clearLine, do_clearProgressInterval, do_clearScreen, do_hideCursor, do_setMouseTracking, do_setProgress, do_setTitle, do_showCursor, } from "./processterminal-methods/cursor-screen.js";
+import { do_clearKeyboardProtocolNegotiationBuffer, do_clearKeyboardProtocolNegotiationBufferFlushTimer, do_flushKeyboardProtocolNegotiationBufferAsInput, do_forwardInputSequence, do_handleKeyboardProtocolNegotiationSequence, do_queryAndEnableKittyProtocol, do_readKeyboardProtocolNegotiationSequence, do_scheduleKeyboardProtocolNegotiationBufferFlush, do_setKeyboardProtocolNegotiationBuffer, do_setupStdinBuffer, do_start, } from "./processterminal-methods/keyboard-protocol.js";
+import { do_disableModifyOtherKeys, do_drainInput, do_enableModifyOtherKeys, do_enableWindowsVTInput, do_moveBy, do_stop, do_write, } from "./processterminal-methods/terminal-io.js";
+export class ProcessTerminal {
+    wasRaw = false;
+    inputHandler;
+    resizeHandler;
+    _kittyProtocolActive = false;
+    _modifyOtherKeysActive = false;
+    keyboardProtocolPushed = false;
+    keyboardProtocolNegotiationBuffer = "";
+    keyboardProtocolBufferFlushTimer;
+    stdinBuffer;
+    stdinDataHandler;
+    progressInterval;
+    mouseTrackingActive = false;
+    writeLogPath = (() => {
+        const env = process.env.PI_TUI_WRITE_LOG || "";
+        if (!env)
+            return "";
+        try {
+            if (fs.statSync(env).isDirectory()) {
+                const now = new Date();
+                const ts = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}_${String(now.getHours()).padStart(2, "0")}-${String(now.getMinutes()).padStart(2, "0")}-${String(now.getSeconds()).padStart(2, "0")}`;
+                return path.join(env, `tui-${ts}-${process.pid}.log`);
+            }
+        }
+        catch {
+            // Not an existing directory - use as-is (file path)
+        }
+        return env;
+    })();
+    get kittyProtocolActive() {
+        return this._kittyProtocolActive;
+    }
+    get modifyOtherKeysActive() {
+        return this._modifyOtherKeysActive;
+    }
+    get columns() {
+        return process.stdout.columns || Number(process.env.COLUMNS) || 80;
+    }
+    get rows() {
+        return process.stdout.rows || Number(process.env.LINES) || 24;
+    }
+    start(onInput, onResize) {
+        do_start(this, onInput, onResize);
+    }
+    setupStdinBuffer() {
+        do_setupStdinBuffer(this);
+    }
+    queryAndEnableKittyProtocol() {
+        do_queryAndEnableKittyProtocol(this);
+    }
+    handleKeyboardProtocolNegotiationSequence(negotiationSequence) {
+        return do_handleKeyboardProtocolNegotiationSequence(this, negotiationSequence);
+    }
+    readKeyboardProtocolNegotiationSequence(sequence) {
+        return do_readKeyboardProtocolNegotiationSequence(this, sequence);
+    }
+    setKeyboardProtocolNegotiationBuffer(sequence) {
+        do_setKeyboardProtocolNegotiationBuffer(this, sequence);
+    }
+    clearKeyboardProtocolNegotiationBuffer() {
+        do_clearKeyboardProtocolNegotiationBuffer(this);
+    }
+    flushKeyboardProtocolNegotiationBufferAsInput() {
+        do_flushKeyboardProtocolNegotiationBufferAsInput(this);
+    }
+    scheduleKeyboardProtocolNegotiationBufferFlush() {
+        do_scheduleKeyboardProtocolNegotiationBufferFlush(this);
+    }
+    clearKeyboardProtocolNegotiationBufferFlushTimer() {
+        do_clearKeyboardProtocolNegotiationBufferFlushTimer(this);
+    }
+    forwardInputSequence(sequence) {
+        do_forwardInputSequence(this, sequence);
+    }
+    enableModifyOtherKeys() {
+        do_enableModifyOtherKeys(this);
+    }
+    disableModifyOtherKeys() {
+        do_disableModifyOtherKeys(this);
+    }
+    enableWindowsVTInput() {
+        do_enableWindowsVTInput(this);
+    }
+    async drainInput(maxMs = 1000, idleMs = 50) {
+        return do_drainInput(this, maxMs, idleMs);
+    }
+    stop() {
+        do_stop(this);
+    }
+    write(data) {
+        do_write(this, data);
+    }
+    moveBy(lines) {
+        do_moveBy(this, lines);
+    }
+    hideCursor() {
+        do_hideCursor(this);
+    }
+    showCursor() {
+        do_showCursor(this);
+    }
+    clearLine() {
+        do_clearLine(this);
+    }
+    clearFromCursor() {
+        do_clearFromCursor(this);
+    }
+    clearScreen() {
+        do_clearScreen(this);
+    }
+    setTitle(title) {
+        do_setTitle(this, title);
+    }
+    setProgress(active) {
+        do_setProgress(this, active);
+    }
+    setMouseTracking(active) {
+        do_setMouseTracking(this, active);
+    }
+    clearProgressInterval() {
+        return do_clearProgressInterval(this);
+    }
+}
+//# sourceMappingURL=processterminal.js.map

package/dist/terminal/processterminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processterminal.js","sourceRoot":"","sources":["../../src/terminal/processterminal.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { StdinBuffer } from \"../stdin-buffer.ts\";\nimport {\n  do_clearFromCursor,\n  do_clearLine,\n  do_clearProgressInterval,\n  do_clearScreen,\n  do_hideCursor,\n  do_setMouseTracking,\n  do_setProgress,\n  do_setTitle,\n  do_showCursor,\n} from \"./processterminal-methods/cursor-screen.ts\";\nimport {\n  do_clearKeyboardProtocolNegotiationBuffer,\n  do_clearKeyboardProtocolNegotiationBufferFlushTimer,\n  do_flushKeyboardProtocolNegotiationBufferAsInput,\n  do_forwardInputSequence,\n  do_handleKeyboardProtocolNegotiationSequence,\n  do_queryAndEnableKittyProtocol,\n  do_readKeyboardProtocolNegotiationSequence,\n  do_scheduleKeyboardProtocolNegotiationBufferFlush,\n  do_setKeyboardProtocolNegotiationBuffer,\n  do_setupStdinBuffer,\n  do_start,\n} from \"./processterminal-methods/keyboard-protocol.ts\";\nimport {\n  do_disableModifyOtherKeys,\n  do_drainInput,\n  do_enableModifyOtherKeys,\n  do_enableWindowsVTInput,\n  do_moveBy,\n  do_stop,\n  do_write,\n} from \"./processterminal-methods/terminal-io.ts\";\nimport type { KeyboardProtocolNegotiationSequence, Terminal } from \"./types.ts\";\n\nexport class ProcessTerminal implements Terminal {\n  public wasRaw = false;\n\n  public inputHandler?: (data: string) => void;\n\n  public resizeHandler?: () => void;\n\n  public _kittyProtocolActive = false;\n\n  public _modifyOtherKeysActive = false;\n\n  public keyboardProtocolPushed = false;\n\n  public keyboardProtocolNegotiationBuffer = \"\";\n\n  public keyboardProtocolBufferFlushTimer?: ReturnType<typeof setTimeout>;\n\n  public stdinBuffer?: StdinBuffer;\n\n  public stdinDataHandler?: (data: string) => void;\n\n  public progressInterval?: ReturnType<typeof setInterval>;\n\n  public mouseTrackingActive = false;\n\n  public writeLogPath = (() => {\n    const env = process.env.PI_TUI_WRITE_LOG || \"\";\n    if (!env) return \"\";\n    try {\n      if (fs.statSync(env).isDirectory()) {\n        const now = new Date();\n        const ts = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, \"0\")}-${String(now.getDate()).padStart(2, \"0\")}_${String(now.getHours()).padStart(2, \"0\")}-${String(now.getMinutes()).padStart(2, \"0\")}-${String(now.getSeconds()).padStart(2, \"0\")}`;\n        return path.join(env, `tui-${ts}-${process.pid}.log`);\n      }\n    } catch {\n      // Not an existing directory - use as-is (file path)\n    }\n    return env;\n  })();\n\n  get kittyProtocolActive(): boolean {\n    return this._kittyProtocolActive;\n  }\n\n  get modifyOtherKeysActive(): boolean {\n    return this._modifyOtherKeysActive;\n  }\n\n  get columns(): number {\n    return process.stdout.columns || Number(process.env.COLUMNS) || 80;\n  }\n\n  get rows(): number {\n    return process.stdout.rows || Number(process.env.LINES) || 24;\n  }\n\n  start(onInput: (data: string) => void, onResize: () => void): void {\n    do_start(this, onInput, onResize);\n  }\n\n  setupStdinBuffer(): void {\n    do_setupStdinBuffer(this);\n  }\n\n  queryAndEnableKittyProtocol(): void {\n    do_queryAndEnableKittyProtocol(this);\n  }\n\n  handleKeyboardProtocolNegotiationSequence(\n    negotiationSequence: KeyboardProtocolNegotiationSequence | undefined,\n  ): boolean {\n    return do_handleKeyboardProtocolNegotiationSequence(this, negotiationSequence);\n  }\n\n  readKeyboardProtocolNegotiationSequence(\n    sequence: string,\n  ): KeyboardProtocolNegotiationSequence | \"pending\" | undefined {\n    return do_readKeyboardProtocolNegotiationSequence(this, sequence);\n  }\n\n  setKeyboardProtocolNegotiationBuffer(sequence: string): void {\n    do_setKeyboardProtocolNegotiationBuffer(this, sequence);\n  }\n\n  clearKeyboardProtocolNegotiationBuffer(): void {\n    do_clearKeyboardProtocolNegotiationBuffer(this);\n  }\n\n  flushKeyboardProtocolNegotiationBufferAsInput(): void {\n    do_flushKeyboardProtocolNegotiationBufferAsInput(this);\n  }\n\n  scheduleKeyboardProtocolNegotiationBufferFlush(): void {\n    do_scheduleKeyboardProtocolNegotiationBufferFlush(this);\n  }\n\n  clearKeyboardProtocolNegotiationBufferFlushTimer(): void {\n    do_clearKeyboardProtocolNegotiationBufferFlushTimer(this);\n  }\n\n  forwardInputSequence(sequence: string): void {\n    do_forwardInputSequence(this, sequence);\n  }\n\n  enableModifyOtherKeys(): void {\n    do_enableModifyOtherKeys(this);\n  }\n\n  disableModifyOtherKeys(): void {\n    do_disableModifyOtherKeys(this);\n  }\n\n  enableWindowsVTInput(): void {\n    do_enableWindowsVTInput(this);\n  }\n\n  async drainInput(maxMs = 1000, idleMs = 50): Promise<void> {\n    return do_drainInput(this, maxMs, idleMs);\n  }\n\n  stop(): void {\n    do_stop(this);\n  }\n\n  write(data: string): void {\n    do_write(this, data);\n  }\n\n  moveBy(lines: number): void {\n    do_moveBy(this, lines);\n  }\n\n  hideCursor(): void {\n    do_hideCursor(this);\n  }\n\n  showCursor(): void {\n    do_showCursor(this);\n  }\n\n  clearLine(): void {\n    do_clearLine(this);\n  }\n\n  clearFromCursor(): void {\n    do_clearFromCursor(this);\n  }\n\n  clearScreen(): void {\n    do_clearScreen(this);\n  }\n\n  setTitle(title: string): void {\n    do_setTitle(this, title);\n  }\n\n  setProgress(active: boolean): void {\n    do_setProgress(this, active);\n  }\n\n  setMouseTracking(active: boolean): void {\n    do_setMouseTracking(this, active);\n  }\n\n  clearProgressInterval(): boolean {\n    return do_clearProgressInterval(this);\n  }\n}\n"]}

package/dist/terminal/types.d.ts

@@ -0,0 +1,31 @@
+export type KeyboardProtocolNegotiationSequence = {
+    type: "kitty-flags";
+    flags: number;
+} | {
+    type: "device-attributes";
+};
+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;
+    setProgress(active: boolean): void;
+    setMouseTracking?(active: boolean): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/terminal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/terminal/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mCAAmC,GAC3C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAElC,MAAM,WAAW,QAAQ;IAEvB,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAGnE,IAAI,IAAI,IAAI,CAAC;IAEb;;;;;OAKG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG3D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1B,IAAI,OAAO,IAAI,MAAM,CAAC;IACtB,IAAI,IAAI,IAAI,MAAM,CAAC;IAGnB,IAAI,mBAAmB,IAAI,OAAO,CAAC;IAGnC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B,UAAU,IAAI,IAAI,CAAC;IACnB,UAAU,IAAI,IAAI,CAAC;IAGnB,SAAS,IAAI,IAAI,CAAC;IAClB,eAAe,IAAI,IAAI,CAAC;IACxB,WAAW,IAAI,IAAI,CAAC;IAGpB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAGnC,gBAAgB,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C","sourcesContent":["export type KeyboardProtocolNegotiationSequence =\n  | { type: \"kitty-flags\"; flags: number }\n  | { type: \"device-attributes\" };\n\nexport interface Terminal {\n  // Start the terminal with input and resize handlers\n  start(onInput: (data: string) => void, onResize: () => void): void;\n\n  // Stop the terminal and restore state\n  stop(): void;\n\n  /**\n   * Drain stdin before exiting to prevent Kitty key release events from\n   * leaking to the parent shell over slow SSH connections.\n   * @param maxMs - Maximum time to drain (default: 1000ms)\n   * @param idleMs - Exit early if no input arrives within this time (default: 50ms)\n   */\n  drainInput(maxMs?: number, idleMs?: number): Promise<void>;\n\n  // Write output to terminal\n  write(data: string): void;\n\n  // Get terminal dimensions\n  get columns(): number;\n  get rows(): number;\n\n  // Whether Kitty keyboard protocol is active\n  get kittyProtocolActive(): boolean;\n\n  // Cursor positioning (relative to current position)\n  moveBy(lines: number): void; // Move cursor up (negative) or down (positive) by N lines\n\n  // Cursor visibility\n  hideCursor(): void; // Hide the cursor\n  showCursor(): void; // Show the cursor\n\n  // Clear operations\n  clearLine(): void; // Clear current line\n  clearFromCursor(): void; // Clear from cursor to end of screen\n  clearScreen(): void; // Clear entire screen and move cursor to (0,0)\n\n  // Title operations\n  setTitle(title: string): void; // Set terminal window title\n\n  // Progress indicator (OSC 9;4)\n  setProgress(active: boolean): void;\n\n  // Mouse button-motion and SGR coordinate reporting\n  setMouseTracking?(active: boolean): void;\n}\n"]}

package/dist/terminal/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map