@asm-agent/tui 0.8.2

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport { setKittyProtocolActive } from \"./keys.js\";\nimport { StdinBuffer } from \"./stdin-buffer.js\";\nimport {\n\tparseOscColorResponse,\n\tQUERY_DEFAULT_BACKGROUND,\n\tQUERY_DEFAULT_FOREGROUND,\n\ttype Rgb,\n\tsetDefaultTerminalColors,\n} from \"./terminal-colors.js\";\n\nconst cjsRequire = createRequire(import.meta.url);\n\nconst TERMINAL_PROGRESS_KEEPALIVE_MS = 1000;\nconst TERMINAL_PROGRESS_ACTIVE_SEQUENCE = \"\\x1b]9;4;3\\x07\";\nconst TERMINAL_PROGRESS_CLEAR_SEQUENCE = \"\\x1b]9;4;0;\\x07\";\n\n// A preserved alternate screen is adopted by the next ProcessTerminal during in-process handoff.\nlet pendingAltScreenHandoff: symbol | undefined;\n\ninterface PendingInputHandoff {\n\ttoken: symbol;\n\twasRaw: boolean;\n\tdiscardHandler: (data: string) => void;\n}\n\n// Keep stdin raw and drain input while a preserved fullscreen frame waits for\n// the next in-process TUI. Worker-backed session attach can make this handoff\n// noticeably longer; restoring cooked mode during the gap makes arrow escape\n// sequences echo into the preserved frame.\nlet pendingInputHandoff: PendingInputHandoff | undefined;\n\nfunction consumeAltScreenHandoff(): boolean {\n\tif (!pendingAltScreenHandoff) {\n\t\treturn false;\n\t}\n\tpendingAltScreenHandoff = undefined;\n\treturn true;\n}\n\nfunction beginInputHandoff(token: symbol, wasRaw: boolean): void {\n\tconst inheritedWasRaw = pendingInputHandoff?.wasRaw ?? wasRaw;\n\tif (pendingInputHandoff) {\n\t\tprocess.stdin.removeListener(\"data\", pendingInputHandoff.discardHandler);\n\t}\n\tconst discardHandler = (_data: string) => {};\n\tpendingInputHandoff = { token, wasRaw: inheritedWasRaw, discardHandler };\n\tprocess.stdin.on(\"data\", discardHandler);\n\tprocess.stdin.resume();\n}\n\nfunction consumeInputHandoff(): boolean | undefined {\n\tconst handoff = pendingInputHandoff;\n\tif (!handoff) {\n\t\treturn undefined;\n\t}\n\tprocess.stdin.removeListener(\"data\", handoff.discardHandler);\n\tpendingInputHandoff = undefined;\n\treturn handoff.wasRaw;\n}\n\nfunction cancelInputHandoff(token: symbol): void {\n\tconst handoff = pendingInputHandoff;\n\tif (!handoff || handoff.token !== token) {\n\t\treturn;\n\t}\n\tprocess.stdin.removeListener(\"data\", handoff.discardHandler);\n\tpendingInputHandoff = undefined;\n\tprocess.stdin.pause();\n\tif (process.stdin.setRawMode) {\n\t\tprocess.stdin.setRawMode(handoff.wasRaw);\n\t}\n}\n\n/**\n * Minimal terminal interface for TUI\n */\nexport interface Terminal {\n\t// Start the terminal with input and resize handlers\n\tstart(onInput: (data: string) => void, onResize: () => void): void;\n\n\t// Stop the terminal and restore state\n\tstop(options?: TerminalStopOptions): void;\n\n\t/**\n\t * Drain stdin before exiting to prevent Kitty key release events from\n\t * leaking to the parent shell over slow SSH connections.\n\t * @param maxMs - Maximum time to drain (default: 1000ms)\n\t * @param idleMs - Exit early if no input arrives within this time (default: 50ms)\n\t */\n\tdrainInput(maxMs?: number, idleMs?: number): Promise<void>;\n\n\t// Write output to terminal\n\twrite(data: string): void;\n\n\t// Get terminal dimensions\n\tget columns(): number;\n\tget rows(): number;\n\n\t// Whether Kitty keyboard protocol is active\n\tget kittyProtocolActive(): boolean;\n\n\t// Cursor positioning (relative to current position)\n\tmoveBy(lines: number): void; // Move cursor up (negative) or down (positive) by N lines\n\n\t// Cursor visibility\n\thideCursor(): void; // Hide the cursor\n\tshowCursor(): void; // Show the cursor\n\n\t// Clear operations\n\tclearLine(): void; // Clear current line\n\tclearFromCursor(): void; // Clear from cursor to end of screen\n\tclearScreen(): void; // Clear entire screen and move cursor to (0,0)\n\n\t// Alternate screen buffer. The primary screen (and its scrollback) is left\n\t// untouched while the alt screen is active, so a full-screen view can be\n\t// shown and dismissed without disturbing the transcript history.\n\tenterAltScreen(): void;\n\tleaveAltScreen(): void;\n\tget altScreenActive(): boolean;\n\n\t// SGR mouse tracking (?1000 + ?1006); motion tracking is deliberately never\n\t// enabled so native drag-selection keeps working.\n\tsetMouseTracking(enabled: boolean): void;\n\tget mouseTrackingActive(): boolean;\n\n\t// Title operations\n\tsetTitle(title: string): void; // Set terminal window title\n\n\t// Progress indicator (OSC 9;4)\n\tsetProgress(active: boolean): void;\n}\n\nexport interface TerminalStopOptions {\n\tpreserveAltScreen?: boolean;\n}\n\n/**\n * Real terminal using process.stdin/stdout\n */\nexport class ProcessTerminal implements Terminal {\n\tprivate wasRaw = false;\n\tprivate started = false;\n\tprivate inputHandler?: (data: string) => void;\n\tprivate resizeHandler?: () => void;\n\tprivate _kittyProtocolActive = false;\n\tprivate _modifyOtherKeysActive = false;\n\tprivate readonly altScreenHandoffToken = Symbol(\"altScreenHandoff\");\n\tprivate _altScreenActive = consumeAltScreenHandoff();\n\tprivate _mouseTrackingActive = false;\n\tprivate stdinBuffer?: StdinBuffer;\n\tprivate stdinDataHandler?: (data: string) => void;\n\tprivate keyboardProtocolFallbackTimer?: ReturnType<typeof setTimeout>;\n\tprivate progressInterval?: ReturnType<typeof setInterval>;\n\tprivate defaultColorProbe?: {\n\t\tforeground?: Rgb;\n\t\tbackground?: Rgb;\n\t\ttimeout: ReturnType<typeof setTimeout>;\n\t};\n\tprivate writeLogPath = (() => {\n\t\tconst env = process.env.PI_TUI_WRITE_LOG || \"\";\n\t\tif (!env) return \"\";\n\t\ttry {\n\t\t\tif (fs.statSync(env).isDirectory()) {\n\t\t\t\tconst now = new Date();\n\t\t\t\tconst 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\t\t\t\treturn path.join(env, `tui-${ts}-${process.pid}.log`);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Not an existing directory - use as-is (file path)\n\t\t}\n\t\treturn env;\n\t})();\n\n\tget kittyProtocolActive(): boolean {\n\t\treturn this._kittyProtocolActive;\n\t}\n\n\tstart(onInput: (data: string) => void, onResize: () => void): void {\n\t\tthis.started = true;\n\t\tthis.inputHandler = onInput;\n\t\tthis.resizeHandler = onResize;\n\n\t\t// Save previous state and enable raw mode\n\t\tthis.wasRaw = consumeInputHandoff() ?? process.stdin.isRaw ?? false;\n\t\tif (process.stdin.setRawMode) {\n\t\t\tprocess.stdin.setRawMode(true);\n\t\t}\n\t\tprocess.stdin.setEncoding(\"utf8\");\n\t\tprocess.stdin.resume();\n\n\t\t// Enable bracketed paste mode - terminal will wrap pastes in \\x1b[200~ ... \\x1b[201~\n\t\tprocess.stdout.write(\"\\x1b[?2004h\");\n\n\t\t// Set up resize handler immediately\n\t\tprocess.stdout.on(\"resize\", this.resizeHandler);\n\n\t\t// Refresh terminal dimensions - they may be stale after suspend/resume\n\t\t// (SIGWINCH is lost while process is stopped). Unix only.\n\t\tif (process.platform !== \"win32\") {\n\t\t\tprocess.kill(process.pid, \"SIGWINCH\");\n\t\t}\n\n\t\t// On Windows, enable ENABLE_VIRTUAL_TERMINAL_INPUT so the console sends\n\t\t// VT escape sequences (e.g. \\x1b[Z for Shift+Tab) instead of raw console\n\t\t// events that lose modifier information. Must run AFTER setRawMode(true)\n\t\t// since that resets console mode flags.\n\t\tthis.enableWindowsVTInput();\n\n\t\t// Query and enable Kitty keyboard protocol\n\t\t// The query handler intercepts input temporarily, then installs the user's handler\n\t\t// See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/\n\t\tthis.queryAndEnableKittyProtocol();\n\t}\n\n\t/**\n\t * Set up StdinBuffer to split batched input into individual sequences.\n\t * This ensures components receive single events, making matchesKey/isKeyRelease work correctly.\n\t *\n\t * Also watches for Kitty protocol response and enables it when detected.\n\t * This is done here (after stdinBuffer parsing) rather than on raw stdin\n\t * to handle the case where the response arrives split across multiple events.\n\t */\n\tprivate setupStdinBuffer(): void {\n\t\tthis.stdinBuffer = new StdinBuffer({ timeout: 10 });\n\n\t\t// Kitty protocol response pattern: \\x1b[?<flags>u\n\t\tconst kittyResponsePattern = /^\\x1b\\[\\?(\\d+)u$/;\n\n\t\t// Forward individual sequences to the input handler\n\t\tthis.stdinBuffer.on(\"data\", (sequence) => {\n\t\t\tif (this.handleDefaultColorProbeResponse(sequence)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Check for Kitty protocol response (only if not already enabled)\n\t\t\tif (!this._kittyProtocolActive) {\n\t\t\t\tconst match = sequence.match(kittyResponsePattern);\n\t\t\t\tif (match) {\n\t\t\t\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\t\t\t\tthis._kittyProtocolActive = true;\n\t\t\t\t\tsetKittyProtocolActive(true);\n\n\t\t\t\t\t// Enable Kitty keyboard protocol (push flags)\n\t\t\t\t\t// Flag 1 = disambiguate escape codes\n\t\t\t\t\t// Flag 2 = report event types (press/repeat/release)\n\t\t\t\t\t// Flag 4 = report alternate keys (shifted key, base layout key)\n\t\t\t\t\t// Base layout key enables shortcuts to work with non-Latin keyboard layouts\n\t\t\t\t\tprocess.stdout.write(\"\\x1b[>7u\");\n\t\t\t\t\treturn; // Don't forward protocol response to TUI\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (this.inputHandler) {\n\t\t\t\tthis.inputHandler(sequence);\n\t\t\t}\n\t\t});\n\n\t\t// Re-wrap paste content with bracketed paste markers for existing editor handling\n\t\tthis.stdinBuffer.on(\"paste\", (content) => {\n\t\t\tif (this.inputHandler) {\n\t\t\t\tthis.inputHandler(`\\x1b[200~${content}\\x1b[201~`);\n\t\t\t}\n\t\t});\n\n\t\t// Handler that pipes stdin data through the buffer\n\t\tthis.stdinDataHandler = (data: string) => {\n\t\t\tthis.stdinBuffer!.process(data);\n\t\t};\n\t}\n\n\t/**\n\t * Query terminal for Kitty keyboard protocol support and enable if available.\n\t *\n\t * Sends CSI ? u to query current flags. If terminal responds with CSI ? <flags> u,\n\t * it supports the protocol and we enable it with CSI > 1 u.\n\t *\n\t * If no Kitty response arrives shortly after startup, fall back to enabling\n\t * xterm modifyOtherKeys mode 2. This is needed for tmux, which can forward\n\t * modified enter keys as CSI-u when extended-keys is enabled, but may not\n\t * answer the Kitty protocol query.\n\t *\n\t * The response is detected in setupStdinBuffer's data handler, which properly\n\t * handles the case where the response arrives split across multiple stdin events.\n\t */\n\tprivate queryAndEnableKittyProtocol(): void {\n\t\tthis.setupStdinBuffer();\n\t\tprocess.stdin.on(\"data\", this.stdinDataHandler!);\n\t\tthis.queryDefaultTerminalColors();\n\t\tprocess.stdout.write(\"\\x1b[?u\");\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\tthis.keyboardProtocolFallbackTimer = setTimeout(() => {\n\t\t\tthis.keyboardProtocolFallbackTimer = undefined;\n\t\t\tif (!this._kittyProtocolActive && !this._modifyOtherKeysActive) {\n\t\t\t\tprocess.stdout.write(\"\\x1b[>4;2m\");\n\t\t\t\tthis._modifyOtherKeysActive = true;\n\t\t\t}\n\t\t}, 150);\n\t}\n\n\tprivate clearKeyboardProtocolFallbackTimer(): void {\n\t\tif (!this.keyboardProtocolFallbackTimer) {\n\t\t\treturn;\n\t\t}\n\t\tclearTimeout(this.keyboardProtocolFallbackTimer);\n\t\tthis.keyboardProtocolFallbackTimer = undefined;\n\t}\n\n\tprivate queryDefaultTerminalColors(): void {\n\t\tif (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {\n\t\t\treturn;\n\t\t}\n\t\tthis.finishDefaultColorProbe();\n\t\tthis.defaultColorProbe = {\n\t\t\ttimeout: setTimeout(() => this.finishDefaultColorProbe(), 100),\n\t\t};\n\t\tprocess.stdout.write(QUERY_DEFAULT_FOREGROUND);\n\t\tprocess.stdout.write(QUERY_DEFAULT_BACKGROUND);\n\t}\n\n\tprivate handleDefaultColorProbeResponse(sequence: string): boolean {\n\t\tconst response = parseOscColorResponse(sequence);\n\t\tif (!response) {\n\t\t\treturn false;\n\t\t}\n\t\tif (!this.defaultColorProbe) {\n\t\t\treturn true;\n\t\t}\n\n\t\tthis.defaultColorProbe[response.kind] = response.rgb;\n\t\tif (this.defaultColorProbe.foreground && this.defaultColorProbe.background) {\n\t\t\tthis.finishDefaultColorProbe();\n\t\t}\n\t\treturn true;\n\t}\n\n\tprivate finishDefaultColorProbe(): void {\n\t\tif (!this.defaultColorProbe) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst { foreground, background, timeout } = this.defaultColorProbe;\n\t\tclearTimeout(timeout);\n\t\tthis.defaultColorProbe = undefined;\n\t\tif (foreground && background) {\n\t\t\tsetDefaultTerminalColors({ foreground, background });\n\t\t\tthis.resizeHandler?.();\n\t\t}\n\t}\n\n\t/**\n\t * On Windows, add ENABLE_VIRTUAL_TERMINAL_INPUT (0x0200) to the stdin\n\t * console handle so the terminal sends VT sequences for modified keys\n\t * (e.g. \\x1b[Z for Shift+Tab). Without this, libuv's ReadConsoleInputW\n\t * discards modifier state and Shift+Tab arrives as plain \\t.\n\t */\n\tprivate enableWindowsVTInput(): void {\n\t\tif (process.platform !== \"win32\") return;\n\t\ttry {\n\t\t\t// Dynamic require to avoid bundling koffi's 74MB of cross-platform\n\t\t\t// native binaries into every compiled binary. Koffi is only needed\n\t\t\t// on Windows for VT input support.\n\t\t\tconst koffi = cjsRequire(\"koffi\");\n\t\t\tconst k32 = koffi.load(\"kernel32.dll\");\n\t\t\tconst GetStdHandle = k32.func(\"void* __stdcall GetStdHandle(int)\");\n\t\t\tconst GetConsoleMode = k32.func(\"bool __stdcall GetConsoleMode(void*, _Out_ uint32_t*)\");\n\t\t\tconst SetConsoleMode = k32.func(\"bool __stdcall SetConsoleMode(void*, uint32_t)\");\n\n\t\t\tconst STD_INPUT_HANDLE = -10;\n\t\t\tconst ENABLE_VIRTUAL_TERMINAL_INPUT = 0x0200;\n\t\t\tconst handle = GetStdHandle(STD_INPUT_HANDLE);\n\t\t\tconst mode = new Uint32Array(1);\n\t\t\tGetConsoleMode(handle, mode);\n\t\t\tSetConsoleMode(handle, mode[0]! | ENABLE_VIRTUAL_TERMINAL_INPUT);\n\t\t} catch {\n\t\t\t// koffi not available — Shift+Tab won't be distinguishable from Tab\n\t\t}\n\t}\n\n\tasync drainInput(maxMs = 1000, idleMs = 50): Promise<void> {\n\t\tif (this._kittyProtocolActive) {\n\t\t\t// Disable Kitty keyboard protocol first so any late key releases\n\t\t\t// do not generate new Kitty escape sequences.\n\t\t\tprocess.stdout.write(\"\\x1b[<u\");\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[>4;0m\");\n\t\t\tthis._modifyOtherKeysActive = false;\n\t\t}\n\n\t\tconst previousHandler = this.inputHandler;\n\t\tthis.inputHandler = undefined;\n\n\t\tlet lastDataTime = Date.now();\n\t\tconst onData = () => {\n\t\t\tlastDataTime = Date.now();\n\t\t};\n\n\t\tprocess.stdin.on(\"data\", onData);\n\t\tconst endTime = Date.now() + maxMs;\n\n\t\ttry {\n\t\t\twhile (true) {\n\t\t\t\tconst now = Date.now();\n\t\t\t\tconst timeLeft = endTime - now;\n\t\t\t\tif (timeLeft <= 0) break;\n\t\t\t\tif (now - lastDataTime >= idleMs) break;\n\t\t\t\tawait new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));\n\t\t\t}\n\t\t} finally {\n\t\t\tprocess.stdin.removeListener(\"data\", onData);\n\t\t\tthis.inputHandler = previousHandler;\n\t\t}\n\t}\n\n\tstop(options: TerminalStopOptions = {}): void {\n\t\tconst wasStarted = this.started;\n\t\tthis.started = false;\n\t\tthis.finishDefaultColorProbe();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\n\t\tif (this.clearProgressInterval()) {\n\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n\t\t}\n\n\t\tif (this._mouseTrackingActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[?1006l\\x1b[?1002l\");\n\t\t\tthis._mouseTrackingActive = false;\n\t\t}\n\t\tif (this._altScreenActive) {\n\t\t\tif (options.preserveAltScreen) {\n\t\t\t\tpendingAltScreenHandoff = this.altScreenHandoffToken;\n\t\t\t\tthis._altScreenActive = false;\n\t\t\t} else {\n\t\t\t\tthis.releaseAltScreen();\n\t\t\t}\n\t\t} else if (!options.preserveAltScreen) {\n\t\t\tthis.releaseAltScreen();\n\t\t}\n\n\t\t// Disable bracketed paste mode\n\t\tprocess.stdout.write(\"\\x1b[?2004l\");\n\n\t\t// Disable Kitty keyboard protocol if not already done by drainInput()\n\t\tif (this._kittyProtocolActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[<u\");\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[>4;0m\");\n\t\t\tthis._modifyOtherKeysActive = false;\n\t\t}\n\n\t\t// Clean up StdinBuffer\n\t\tif (this.stdinBuffer) {\n\t\t\tthis.stdinBuffer.destroy();\n\t\t\tthis.stdinBuffer = undefined;\n\t\t}\n\n\t\t// Remove event handlers\n\t\tif (this.stdinDataHandler) {\n\t\t\tprocess.stdin.removeListener(\"data\", this.stdinDataHandler);\n\t\t\tthis.stdinDataHandler = undefined;\n\t\t}\n\t\tthis.inputHandler = undefined;\n\t\tif (this.resizeHandler) {\n\t\t\tprocess.stdout.removeListener(\"resize\", this.resizeHandler);\n\t\t\tthis.resizeHandler = undefined;\n\t\t}\n\n\t\tif (options.preserveAltScreen && wasStarted) {\n\t\t\tbeginInputHandoff(this.altScreenHandoffToken, this.wasRaw);\n\t\t} else {\n\t\t\t// Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being\n\t\t\t// re-interpreted after raw mode is disabled. This fixes a race condition\n\t\t\t// where Ctrl+D could close the parent shell over SSH.\n\t\t\tprocess.stdin.pause();\n\n\t\t\t// Restore raw mode state\n\t\t\tif (process.stdin.setRawMode) {\n\t\t\t\tprocess.stdin.setRawMode(this.wasRaw);\n\t\t\t}\n\t\t}\n\t}\n\n\twrite(data: string): void {\n\t\tprocess.stdout.write(data);\n\t\tif (this.writeLogPath) {\n\t\t\ttry {\n\t\t\t\tfs.appendFileSync(this.writeLogPath, data, { encoding: \"utf8\" });\n\t\t\t} catch {\n\t\t\t\t// Ignore logging errors\n\t\t\t}\n\t\t}\n\t}\n\n\tget columns(): number {\n\t\treturn process.stdout.columns || Number(process.env.COLUMNS) || 80;\n\t}\n\n\tget rows(): number {\n\t\treturn process.stdout.rows || Number(process.env.LINES) || 24;\n\t}\n\n\tmoveBy(lines: number): void {\n\t\tif (lines > 0) {\n\t\t\t// Move down\n\t\t\tprocess.stdout.write(`\\x1b[${lines}B`);\n\t\t} else if (lines < 0) {\n\t\t\t// Move up\n\t\t\tprocess.stdout.write(`\\x1b[${-lines}A`);\n\t\t}\n\t\t// lines === 0: no movement\n\t}\n\n\thideCursor(): void {\n\t\tprocess.stdout.write(\"\\x1b[?25l\");\n\t}\n\n\tshowCursor(): void {\n\t\tprocess.stdout.write(\"\\x1b[?25h\");\n\t}\n\n\tclearLine(): void {\n\t\tprocess.stdout.write(\"\\x1b[K\");\n\t}\n\n\tclearFromCursor(): void {\n\t\tprocess.stdout.write(\"\\x1b[J\");\n\t}\n\n\tclearScreen(): void {\n\t\tprocess.stdout.write(\"\\x1b[2J\\x1b[H\"); // Clear screen and move to home (1,1)\n\t}\n\n\tenterAltScreen(): void {\n\t\tif (this._altScreenActive) return;\n\t\tif (this.ownsPendingAltScreenHandoff()) {\n\t\t\tpendingAltScreenHandoff = undefined;\n\t\t\tthis._altScreenActive = true;\n\t\t\treturn;\n\t\t}\n\t\tthis._altScreenActive = true;\n\t\tthis.write(\"\\x1b[?1049h\");\n\t}\n\n\tleaveAltScreen(): void {\n\t\tthis.releaseAltScreen();\n\t}\n\n\tprivate releaseAltScreen(): void {\n\t\tconst ownsPendingHandoff = this.ownsPendingAltScreenHandoff();\n\t\tif (!this._altScreenActive && !ownsPendingHandoff) return;\n\t\tthis._altScreenActive = false;\n\t\tif (ownsPendingHandoff) {\n\t\t\tpendingAltScreenHandoff = undefined;\n\t\t\tcancelInputHandoff(this.altScreenHandoffToken);\n\t\t}\n\t\tthis.write(\"\\x1b[?1049l\");\n\t}\n\n\tget altScreenActive(): boolean {\n\t\treturn this._altScreenActive;\n\t}\n\n\tprivate ownsPendingAltScreenHandoff(): boolean {\n\t\treturn pendingAltScreenHandoff === this.altScreenHandoffToken;\n\t}\n\n\tsetMouseTracking(enabled: boolean): void {\n\t\tif (enabled === this._mouseTrackingActive) return;\n\t\tthis._mouseTrackingActive = enabled;\n\t\t// ?1002 (button-event tracking) reports drag motion for in-app selection\n\t\t// but not hover, keeping passive mouse movement unreported.\n\t\tthis.write(enabled ? \"\\x1b[?1002h\\x1b[?1006h\" : \"\\x1b[?1006l\\x1b[?1002l\");\n\t}\n\n\tget mouseTrackingActive(): boolean {\n\t\treturn this._mouseTrackingActive;\n\t}\n\n\tsetTitle(title: string): void {\n\t\t// OSC 0;title BEL - set terminal window title\n\t\tprocess.stdout.write(`\\x1b]0;${title}\\x07`);\n\t}\n\n\tsetProgress(active: boolean): void {\n\t\tif (active) {\n\t\t\t// OSC 9;4;3 - indeterminate progress\n\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);\n\t\t\tif (!this.progressInterval) {\n\t\t\t\tthis.progressInterval = setInterval(() => {\n\t\t\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);\n\t\t\t\t}, TERMINAL_PROGRESS_KEEPALIVE_MS);\n\t\t\t}\n\t\t} else {\n\t\t\tthis.clearProgressInterval();\n\t\t\t// OSC 9;4;0 - clear progress\n\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n\t\t}\n\t}\n\n\tprivate clearProgressInterval(): boolean {\n\t\tif (!this.progressInterval) return false;\n\t\tclearInterval(this.progressInterval);\n\t\tthis.progressInterval = undefined;\n\t\treturn true;\n\t}\n}\n"]}

package/dist/terminal.js

@@ -0,0 +1,486 @@
+import * as fs from "node:fs";
+import { createRequire } from "node:module";
+import * as path from "node:path";
+import { setKittyProtocolActive } from "./keys.js";
+import { StdinBuffer } from "./stdin-buffer.js";
+import { parseOscColorResponse, QUERY_DEFAULT_BACKGROUND, QUERY_DEFAULT_FOREGROUND, setDefaultTerminalColors, } from "./terminal-colors.js";
+const cjsRequire = createRequire(import.meta.url);
+const TERMINAL_PROGRESS_KEEPALIVE_MS = 1000;
+const TERMINAL_PROGRESS_ACTIVE_SEQUENCE = "\x1b]9;4;3\x07";
+const TERMINAL_PROGRESS_CLEAR_SEQUENCE = "\x1b]9;4;0;\x07";
+// A preserved alternate screen is adopted by the next ProcessTerminal during in-process handoff.
+let pendingAltScreenHandoff;
+// Keep stdin raw and drain input while a preserved fullscreen frame waits for
+// the next in-process TUI. Worker-backed session attach can make this handoff
+// noticeably longer; restoring cooked mode during the gap makes arrow escape
+// sequences echo into the preserved frame.
+let pendingInputHandoff;
+function consumeAltScreenHandoff() {
+    if (!pendingAltScreenHandoff) {
+        return false;
+    }
+    pendingAltScreenHandoff = undefined;
+    return true;
+}
+function beginInputHandoff(token, wasRaw) {
+    const inheritedWasRaw = pendingInputHandoff?.wasRaw ?? wasRaw;
+    if (pendingInputHandoff) {
+        process.stdin.removeListener("data", pendingInputHandoff.discardHandler);
+    }
+    const discardHandler = (_data) => { };
+    pendingInputHandoff = { token, wasRaw: inheritedWasRaw, discardHandler };
+    process.stdin.on("data", discardHandler);
+    process.stdin.resume();
+}
+function consumeInputHandoff() {
+    const handoff = pendingInputHandoff;
+    if (!handoff) {
+        return undefined;
+    }
+    process.stdin.removeListener("data", handoff.discardHandler);
+    pendingInputHandoff = undefined;
+    return handoff.wasRaw;
+}
+function cancelInputHandoff(token) {
+    const handoff = pendingInputHandoff;
+    if (!handoff || handoff.token !== token) {
+        return;
+    }
+    process.stdin.removeListener("data", handoff.discardHandler);
+    pendingInputHandoff = undefined;
+    process.stdin.pause();
+    if (process.stdin.setRawMode) {
+        process.stdin.setRawMode(handoff.wasRaw);
+    }
+}
+/**
+ * Real terminal using process.stdin/stdout
+ */
+export class ProcessTerminal {
+    wasRaw = false;
+    started = false;
+    inputHandler;
+    resizeHandler;
+    _kittyProtocolActive = false;
+    _modifyOtherKeysActive = false;
+    altScreenHandoffToken = Symbol("altScreenHandoff");
+    _altScreenActive = consumeAltScreenHandoff();
+    _mouseTrackingActive = false;
+    stdinBuffer;
+    stdinDataHandler;
+    keyboardProtocolFallbackTimer;
+    progressInterval;
+    defaultColorProbe;
+    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;
+    }
+    start(onInput, onResize) {
+        this.started = true;
+        this.inputHandler = onInput;
+        this.resizeHandler = onResize;
+        // Save previous state and enable raw mode
+        this.wasRaw = consumeInputHandoff() ?? 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", this.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.
+        this.enableWindowsVTInput();
+        // Query and enable Kitty keyboard protocol
+        // The query handler intercepts input temporarily, then installs the user's handler
+        // See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+        this.queryAndEnableKittyProtocol();
+    }
+    /**
+     * 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.
+     */
+    setupStdinBuffer() {
+        this.stdinBuffer = new StdinBuffer({ timeout: 10 });
+        // Kitty protocol response pattern: \x1b[?<flags>u
+        const kittyResponsePattern = /^\x1b\[\?(\d+)u$/;
+        // Forward individual sequences to the input handler
+        this.stdinBuffer.on("data", (sequence) => {
+            if (this.handleDefaultColorProbeResponse(sequence)) {
+                return;
+            }
+            // Check for Kitty protocol response (only if not already enabled)
+            if (!this._kittyProtocolActive) {
+                const match = sequence.match(kittyResponsePattern);
+                if (match) {
+                    this.clearKeyboardProtocolFallbackTimer();
+                    this._kittyProtocolActive = true;
+                    setKittyProtocolActive(true);
+                    // Enable Kitty keyboard protocol (push flags)
+                    // Flag 1 = disambiguate escape codes
+                    // Flag 2 = report event types (press/repeat/release)
+                    // Flag 4 = report alternate keys (shifted key, base layout key)
+                    // Base layout key enables shortcuts to work with non-Latin keyboard layouts
+                    process.stdout.write("\x1b[>7u");
+                    return; // Don't forward protocol response to TUI
+                }
+            }
+            if (this.inputHandler) {
+                this.inputHandler(sequence);
+            }
+        });
+        // Re-wrap paste content with bracketed paste markers for existing editor handling
+        this.stdinBuffer.on("paste", (content) => {
+            if (this.inputHandler) {
+                this.inputHandler(`\x1b[200~${content}\x1b[201~`);
+            }
+        });
+        // Handler that pipes stdin data through the buffer
+        this.stdinDataHandler = (data) => {
+            this.stdinBuffer.process(data);
+        };
+    }
+    /**
+     * 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.
+     *
+     * If no Kitty response arrives shortly after startup, fall back to enabling
+     * xterm modifyOtherKeys mode 2. This is needed for tmux, which can forward
+     * modified enter keys as CSI-u when extended-keys is enabled, but may not
+     * answer the Kitty protocol query.
+     *
+     * The response is detected in setupStdinBuffer's data handler, which properly
+     * handles the case where the response arrives split across multiple stdin events.
+     */
+    queryAndEnableKittyProtocol() {
+        this.setupStdinBuffer();
+        process.stdin.on("data", this.stdinDataHandler);
+        this.queryDefaultTerminalColors();
+        process.stdout.write("\x1b[?u");
+        this.clearKeyboardProtocolFallbackTimer();
+        this.keyboardProtocolFallbackTimer = setTimeout(() => {
+            this.keyboardProtocolFallbackTimer = undefined;
+            if (!this._kittyProtocolActive && !this._modifyOtherKeysActive) {
+                process.stdout.write("\x1b[>4;2m");
+                this._modifyOtherKeysActive = true;
+            }
+        }, 150);
+    }
+    clearKeyboardProtocolFallbackTimer() {
+        if (!this.keyboardProtocolFallbackTimer) {
+            return;
+        }
+        clearTimeout(this.keyboardProtocolFallbackTimer);
+        this.keyboardProtocolFallbackTimer = undefined;
+    }
+    queryDefaultTerminalColors() {
+        if (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {
+            return;
+        }
+        this.finishDefaultColorProbe();
+        this.defaultColorProbe = {
+            timeout: setTimeout(() => this.finishDefaultColorProbe(), 100),
+        };
+        process.stdout.write(QUERY_DEFAULT_FOREGROUND);
+        process.stdout.write(QUERY_DEFAULT_BACKGROUND);
+    }
+    handleDefaultColorProbeResponse(sequence) {
+        const response = parseOscColorResponse(sequence);
+        if (!response) {
+            return false;
+        }
+        if (!this.defaultColorProbe) {
+            return true;
+        }
+        this.defaultColorProbe[response.kind] = response.rgb;
+        if (this.defaultColorProbe.foreground && this.defaultColorProbe.background) {
+            this.finishDefaultColorProbe();
+        }
+        return true;
+    }
+    finishDefaultColorProbe() {
+        if (!this.defaultColorProbe) {
+            return;
+        }
+        const { foreground, background, timeout } = this.defaultColorProbe;
+        clearTimeout(timeout);
+        this.defaultColorProbe = undefined;
+        if (foreground && background) {
+            setDefaultTerminalColors({ foreground, background });
+            this.resizeHandler?.();
+        }
+    }
+    /**
+     * 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.
+     */
+    enableWindowsVTInput() {
+        if (process.platform !== "win32")
+            return;
+        try {
+            // Dynamic require to avoid bundling koffi's 74MB of cross-platform
+            // native binaries into every compiled binary. Koffi is only needed
+            // on Windows for VT input support.
+            const koffi = cjsRequire("koffi");
+            const k32 = koffi.load("kernel32.dll");
+            const GetStdHandle = k32.func("void* __stdcall GetStdHandle(int)");
+            const GetConsoleMode = k32.func("bool __stdcall GetConsoleMode(void*, _Out_ uint32_t*)");
+            const SetConsoleMode = k32.func("bool __stdcall SetConsoleMode(void*, uint32_t)");
+            const STD_INPUT_HANDLE = -10;
+            const ENABLE_VIRTUAL_TERMINAL_INPUT = 0x0200;
+            const handle = GetStdHandle(STD_INPUT_HANDLE);
+            const mode = new Uint32Array(1);
+            GetConsoleMode(handle, mode);
+            SetConsoleMode(handle, mode[0] | ENABLE_VIRTUAL_TERMINAL_INPUT);
+        }
+        catch {
+            // koffi not available — Shift+Tab won't be distinguishable from Tab
+        }
+    }
+    async drainInput(maxMs = 1000, idleMs = 50) {
+        if (this._kittyProtocolActive) {
+            // Disable Kitty keyboard protocol first so any late key releases
+            // do not generate new Kitty escape sequences.
+            process.stdout.write("\x1b[<u");
+            this._kittyProtocolActive = false;
+            setKittyProtocolActive(false);
+        }
+        if (this._modifyOtherKeysActive) {
+            process.stdout.write("\x1b[>4;0m");
+            this._modifyOtherKeysActive = false;
+        }
+        const previousHandler = this.inputHandler;
+        this.inputHandler = undefined;
+        let lastDataTime = Date.now();
+        const onData = () => {
+            lastDataTime = Date.now();
+        };
+        process.stdin.on("data", onData);
+        const endTime = Date.now() + maxMs;
+        try {
+            while (true) {
+                const now = Date.now();
+                const timeLeft = endTime - now;
+                if (timeLeft <= 0)
+                    break;
+                if (now - lastDataTime >= idleMs)
+                    break;
+                await new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));
+            }
+        }
+        finally {
+            process.stdin.removeListener("data", onData);
+            this.inputHandler = previousHandler;
+        }
+    }
+    stop(options = {}) {
+        const wasStarted = this.started;
+        this.started = false;
+        this.finishDefaultColorProbe();
+        this.clearKeyboardProtocolFallbackTimer();
+        if (this.clearProgressInterval()) {
+            process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);
+        }
+        if (this._mouseTrackingActive) {
+            process.stdout.write("\x1b[?1006l\x1b[?1002l");
+            this._mouseTrackingActive = false;
+        }
+        if (this._altScreenActive) {
+            if (options.preserveAltScreen) {
+                pendingAltScreenHandoff = this.altScreenHandoffToken;
+                this._altScreenActive = false;
+            }
+            else {
+                this.releaseAltScreen();
+            }
+        }
+        else if (!options.preserveAltScreen) {
+            this.releaseAltScreen();
+        }
+        // Disable bracketed paste mode
+        process.stdout.write("\x1b[?2004l");
+        // Disable Kitty keyboard protocol if not already done by drainInput()
+        if (this._kittyProtocolActive) {
+            process.stdout.write("\x1b[<u");
+            this._kittyProtocolActive = false;
+            setKittyProtocolActive(false);
+        }
+        if (this._modifyOtherKeysActive) {
+            process.stdout.write("\x1b[>4;0m");
+            this._modifyOtherKeysActive = false;
+        }
+        // Clean up StdinBuffer
+        if (this.stdinBuffer) {
+            this.stdinBuffer.destroy();
+            this.stdinBuffer = undefined;
+        }
+        // Remove event handlers
+        if (this.stdinDataHandler) {
+            process.stdin.removeListener("data", this.stdinDataHandler);
+            this.stdinDataHandler = undefined;
+        }
+        this.inputHandler = undefined;
+        if (this.resizeHandler) {
+            process.stdout.removeListener("resize", this.resizeHandler);
+            this.resizeHandler = undefined;
+        }
+        if (options.preserveAltScreen && wasStarted) {
+            beginInputHandoff(this.altScreenHandoffToken, this.wasRaw);
+        }
+        else {
+            // 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(this.wasRaw);
+            }
+        }
+    }
+    write(data) {
+        process.stdout.write(data);
+        if (this.writeLogPath) {
+            try {
+                fs.appendFileSync(this.writeLogPath, data, { encoding: "utf8" });
+            }
+            catch {
+                // Ignore logging errors
+            }
+        }
+    }
+    get columns() {
+        return process.stdout.columns || Number(process.env.COLUMNS) || 80;
+    }
+    get rows() {
+        return process.stdout.rows || Number(process.env.LINES) || 24;
+    }
+    moveBy(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
+    }
+    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"); // Clear screen and move to home (1,1)
+    }
+    enterAltScreen() {
+        if (this._altScreenActive)
+            return;
+        if (this.ownsPendingAltScreenHandoff()) {
+            pendingAltScreenHandoff = undefined;
+            this._altScreenActive = true;
+            return;
+        }
+        this._altScreenActive = true;
+        this.write("\x1b[?1049h");
+    }
+    leaveAltScreen() {
+        this.releaseAltScreen();
+    }
+    releaseAltScreen() {
+        const ownsPendingHandoff = this.ownsPendingAltScreenHandoff();
+        if (!this._altScreenActive && !ownsPendingHandoff)
+            return;
+        this._altScreenActive = false;
+        if (ownsPendingHandoff) {
+            pendingAltScreenHandoff = undefined;
+            cancelInputHandoff(this.altScreenHandoffToken);
+        }
+        this.write("\x1b[?1049l");
+    }
+    get altScreenActive() {
+        return this._altScreenActive;
+    }
+    ownsPendingAltScreenHandoff() {
+        return pendingAltScreenHandoff === this.altScreenHandoffToken;
+    }
+    setMouseTracking(enabled) {
+        if (enabled === this._mouseTrackingActive)
+            return;
+        this._mouseTrackingActive = enabled;
+        // ?1002 (button-event tracking) reports drag motion for in-app selection
+        // but not hover, keeping passive mouse movement unreported.
+        this.write(enabled ? "\x1b[?1002h\x1b[?1006h" : "\x1b[?1006l\x1b[?1002l");
+    }
+    get mouseTrackingActive() {
+        return this._mouseTrackingActive;
+    }
+    setTitle(title) {
+        // OSC 0;title BEL - set terminal window title
+        process.stdout.write(`\x1b]0;${title}\x07`);
+    }
+    setProgress(active) {
+        if (active) {
+            // OSC 9;4;3 - indeterminate progress
+            process.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);
+            if (!this.progressInterval) {
+                this.progressInterval = setInterval(() => {
+                    process.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);
+                }, TERMINAL_PROGRESS_KEEPALIVE_MS);
+            }
+        }
+        else {
+            this.clearProgressInterval();
+            // OSC 9;4;0 - clear progress
+            process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);
+        }
+    }
+    clearProgressInterval() {
+        if (!this.progressInterval)
+            return false;
+        clearInterval(this.progressInterval);
+        this.progressInterval = undefined;
+        return true;
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport { setKittyProtocolActive } from \"./keys.js\";\nimport { StdinBuffer } from \"./stdin-buffer.js\";\nimport {\n\tparseOscColorResponse,\n\tQUERY_DEFAULT_BACKGROUND,\n\tQUERY_DEFAULT_FOREGROUND,\n\ttype Rgb,\n\tsetDefaultTerminalColors,\n} from \"./terminal-colors.js\";\n\nconst cjsRequire = createRequire(import.meta.url);\n\nconst TERMINAL_PROGRESS_KEEPALIVE_MS = 1000;\nconst TERMINAL_PROGRESS_ACTIVE_SEQUENCE = \"\\x1b]9;4;3\\x07\";\nconst TERMINAL_PROGRESS_CLEAR_SEQUENCE = \"\\x1b]9;4;0;\\x07\";\n\n// A preserved alternate screen is adopted by the next ProcessTerminal during in-process handoff.\nlet pendingAltScreenHandoff: symbol | undefined;\n\ninterface PendingInputHandoff {\n\ttoken: symbol;\n\twasRaw: boolean;\n\tdiscardHandler: (data: string) => void;\n}\n\n// Keep stdin raw and drain input while a preserved fullscreen frame waits for\n// the next in-process TUI. Worker-backed session attach can make this handoff\n// noticeably longer; restoring cooked mode during the gap makes arrow escape\n// sequences echo into the preserved frame.\nlet pendingInputHandoff: PendingInputHandoff | undefined;\n\nfunction consumeAltScreenHandoff(): boolean {\n\tif (!pendingAltScreenHandoff) {\n\t\treturn false;\n\t}\n\tpendingAltScreenHandoff = undefined;\n\treturn true;\n}\n\nfunction beginInputHandoff(token: symbol, wasRaw: boolean): void {\n\tconst inheritedWasRaw = pendingInputHandoff?.wasRaw ?? wasRaw;\n\tif (pendingInputHandoff) {\n\t\tprocess.stdin.removeListener(\"data\", pendingInputHandoff.discardHandler);\n\t}\n\tconst discardHandler = (_data: string) => {};\n\tpendingInputHandoff = { token, wasRaw: inheritedWasRaw, discardHandler };\n\tprocess.stdin.on(\"data\", discardHandler);\n\tprocess.stdin.resume();\n}\n\nfunction consumeInputHandoff(): boolean | undefined {\n\tconst handoff = pendingInputHandoff;\n\tif (!handoff) {\n\t\treturn undefined;\n\t}\n\tprocess.stdin.removeListener(\"data\", handoff.discardHandler);\n\tpendingInputHandoff = undefined;\n\treturn handoff.wasRaw;\n}\n\nfunction cancelInputHandoff(token: symbol): void {\n\tconst handoff = pendingInputHandoff;\n\tif (!handoff || handoff.token !== token) {\n\t\treturn;\n\t}\n\tprocess.stdin.removeListener(\"data\", handoff.discardHandler);\n\tpendingInputHandoff = undefined;\n\tprocess.stdin.pause();\n\tif (process.stdin.setRawMode) {\n\t\tprocess.stdin.setRawMode(handoff.wasRaw);\n\t}\n}\n\n/**\n * Minimal terminal interface for TUI\n */\nexport interface Terminal {\n\t// Start the terminal with input and resize handlers\n\tstart(onInput: (data: string) => void, onResize: () => void): void;\n\n\t// Stop the terminal and restore state\n\tstop(options?: TerminalStopOptions): void;\n\n\t/**\n\t * Drain stdin before exiting to prevent Kitty key release events from\n\t * leaking to the parent shell over slow SSH connections.\n\t * @param maxMs - Maximum time to drain (default: 1000ms)\n\t * @param idleMs - Exit early if no input arrives within this time (default: 50ms)\n\t */\n\tdrainInput(maxMs?: number, idleMs?: number): Promise<void>;\n\n\t// Write output to terminal\n\twrite(data: string): void;\n\n\t// Get terminal dimensions\n\tget columns(): number;\n\tget rows(): number;\n\n\t// Whether Kitty keyboard protocol is active\n\tget kittyProtocolActive(): boolean;\n\n\t// Cursor positioning (relative to current position)\n\tmoveBy(lines: number): void; // Move cursor up (negative) or down (positive) by N lines\n\n\t// Cursor visibility\n\thideCursor(): void; // Hide the cursor\n\tshowCursor(): void; // Show the cursor\n\n\t// Clear operations\n\tclearLine(): void; // Clear current line\n\tclearFromCursor(): void; // Clear from cursor to end of screen\n\tclearScreen(): void; // Clear entire screen and move cursor to (0,0)\n\n\t// Alternate screen buffer. The primary screen (and its scrollback) is left\n\t// untouched while the alt screen is active, so a full-screen view can be\n\t// shown and dismissed without disturbing the transcript history.\n\tenterAltScreen(): void;\n\tleaveAltScreen(): void;\n\tget altScreenActive(): boolean;\n\n\t// SGR mouse tracking (?1000 + ?1006); motion tracking is deliberately never\n\t// enabled so native drag-selection keeps working.\n\tsetMouseTracking(enabled: boolean): void;\n\tget mouseTrackingActive(): boolean;\n\n\t// Title operations\n\tsetTitle(title: string): void; // Set terminal window title\n\n\t// Progress indicator (OSC 9;4)\n\tsetProgress(active: boolean): void;\n}\n\nexport interface TerminalStopOptions {\n\tpreserveAltScreen?: boolean;\n}\n\n/**\n * Real terminal using process.stdin/stdout\n */\nexport class ProcessTerminal implements Terminal {\n\tprivate wasRaw = false;\n\tprivate started = false;\n\tprivate inputHandler?: (data: string) => void;\n\tprivate resizeHandler?: () => void;\n\tprivate _kittyProtocolActive = false;\n\tprivate _modifyOtherKeysActive = false;\n\tprivate readonly altScreenHandoffToken = Symbol(\"altScreenHandoff\");\n\tprivate _altScreenActive = consumeAltScreenHandoff();\n\tprivate _mouseTrackingActive = false;\n\tprivate stdinBuffer?: StdinBuffer;\n\tprivate stdinDataHandler?: (data: string) => void;\n\tprivate keyboardProtocolFallbackTimer?: ReturnType<typeof setTimeout>;\n\tprivate progressInterval?: ReturnType<typeof setInterval>;\n\tprivate defaultColorProbe?: {\n\t\tforeground?: Rgb;\n\t\tbackground?: Rgb;\n\t\ttimeout: ReturnType<typeof setTimeout>;\n\t};\n\tprivate writeLogPath = (() => {\n\t\tconst env = process.env.PI_TUI_WRITE_LOG || \"\";\n\t\tif (!env) return \"\";\n\t\ttry {\n\t\t\tif (fs.statSync(env).isDirectory()) {\n\t\t\t\tconst now = new Date();\n\t\t\t\tconst 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\t\t\t\treturn path.join(env, `tui-${ts}-${process.pid}.log`);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Not an existing directory - use as-is (file path)\n\t\t}\n\t\treturn env;\n\t})();\n\n\tget kittyProtocolActive(): boolean {\n\t\treturn this._kittyProtocolActive;\n\t}\n\n\tstart(onInput: (data: string) => void, onResize: () => void): void {\n\t\tthis.started = true;\n\t\tthis.inputHandler = onInput;\n\t\tthis.resizeHandler = onResize;\n\n\t\t// Save previous state and enable raw mode\n\t\tthis.wasRaw = consumeInputHandoff() ?? process.stdin.isRaw ?? false;\n\t\tif (process.stdin.setRawMode) {\n\t\t\tprocess.stdin.setRawMode(true);\n\t\t}\n\t\tprocess.stdin.setEncoding(\"utf8\");\n\t\tprocess.stdin.resume();\n\n\t\t// Enable bracketed paste mode - terminal will wrap pastes in \\x1b[200~ ... \\x1b[201~\n\t\tprocess.stdout.write(\"\\x1b[?2004h\");\n\n\t\t// Set up resize handler immediately\n\t\tprocess.stdout.on(\"resize\", this.resizeHandler);\n\n\t\t// Refresh terminal dimensions - they may be stale after suspend/resume\n\t\t// (SIGWINCH is lost while process is stopped). Unix only.\n\t\tif (process.platform !== \"win32\") {\n\t\t\tprocess.kill(process.pid, \"SIGWINCH\");\n\t\t}\n\n\t\t// On Windows, enable ENABLE_VIRTUAL_TERMINAL_INPUT so the console sends\n\t\t// VT escape sequences (e.g. \\x1b[Z for Shift+Tab) instead of raw console\n\t\t// events that lose modifier information. Must run AFTER setRawMode(true)\n\t\t// since that resets console mode flags.\n\t\tthis.enableWindowsVTInput();\n\n\t\t// Query and enable Kitty keyboard protocol\n\t\t// The query handler intercepts input temporarily, then installs the user's handler\n\t\t// See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/\n\t\tthis.queryAndEnableKittyProtocol();\n\t}\n\n\t/**\n\t * Set up StdinBuffer to split batched input into individual sequences.\n\t * This ensures components receive single events, making matchesKey/isKeyRelease work correctly.\n\t *\n\t * Also watches for Kitty protocol response and enables it when detected.\n\t * This is done here (after stdinBuffer parsing) rather than on raw stdin\n\t * to handle the case where the response arrives split across multiple events.\n\t */\n\tprivate setupStdinBuffer(): void {\n\t\tthis.stdinBuffer = new StdinBuffer({ timeout: 10 });\n\n\t\t// Kitty protocol response pattern: \\x1b[?<flags>u\n\t\tconst kittyResponsePattern = /^\\x1b\\[\\?(\\d+)u$/;\n\n\t\t// Forward individual sequences to the input handler\n\t\tthis.stdinBuffer.on(\"data\", (sequence) => {\n\t\t\tif (this.handleDefaultColorProbeResponse(sequence)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Check for Kitty protocol response (only if not already enabled)\n\t\t\tif (!this._kittyProtocolActive) {\n\t\t\t\tconst match = sequence.match(kittyResponsePattern);\n\t\t\t\tif (match) {\n\t\t\t\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\t\t\t\tthis._kittyProtocolActive = true;\n\t\t\t\t\tsetKittyProtocolActive(true);\n\n\t\t\t\t\t// Enable Kitty keyboard protocol (push flags)\n\t\t\t\t\t// Flag 1 = disambiguate escape codes\n\t\t\t\t\t// Flag 2 = report event types (press/repeat/release)\n\t\t\t\t\t// Flag 4 = report alternate keys (shifted key, base layout key)\n\t\t\t\t\t// Base layout key enables shortcuts to work with non-Latin keyboard layouts\n\t\t\t\t\tprocess.stdout.write(\"\\x1b[>7u\");\n\t\t\t\t\treturn; // Don't forward protocol response to TUI\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (this.inputHandler) {\n\t\t\t\tthis.inputHandler(sequence);\n\t\t\t}\n\t\t});\n\n\t\t// Re-wrap paste content with bracketed paste markers for existing editor handling\n\t\tthis.stdinBuffer.on(\"paste\", (content) => {\n\t\t\tif (this.inputHandler) {\n\t\t\t\tthis.inputHandler(`\\x1b[200~${content}\\x1b[201~`);\n\t\t\t}\n\t\t});\n\n\t\t// Handler that pipes stdin data through the buffer\n\t\tthis.stdinDataHandler = (data: string) => {\n\t\t\tthis.stdinBuffer!.process(data);\n\t\t};\n\t}\n\n\t/**\n\t * Query terminal for Kitty keyboard protocol support and enable if available.\n\t *\n\t * Sends CSI ? u to query current flags. If terminal responds with CSI ? <flags> u,\n\t * it supports the protocol and we enable it with CSI > 1 u.\n\t *\n\t * If no Kitty response arrives shortly after startup, fall back to enabling\n\t * xterm modifyOtherKeys mode 2. This is needed for tmux, which can forward\n\t * modified enter keys as CSI-u when extended-keys is enabled, but may not\n\t * answer the Kitty protocol query.\n\t *\n\t * The response is detected in setupStdinBuffer's data handler, which properly\n\t * handles the case where the response arrives split across multiple stdin events.\n\t */\n\tprivate queryAndEnableKittyProtocol(): void {\n\t\tthis.setupStdinBuffer();\n\t\tprocess.stdin.on(\"data\", this.stdinDataHandler!);\n\t\tthis.queryDefaultTerminalColors();\n\t\tprocess.stdout.write(\"\\x1b[?u\");\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\tthis.keyboardProtocolFallbackTimer = setTimeout(() => {\n\t\t\tthis.keyboardProtocolFallbackTimer = undefined;\n\t\t\tif (!this._kittyProtocolActive && !this._modifyOtherKeysActive) {\n\t\t\t\tprocess.stdout.write(\"\\x1b[>4;2m\");\n\t\t\t\tthis._modifyOtherKeysActive = true;\n\t\t\t}\n\t\t}, 150);\n\t}\n\n\tprivate clearKeyboardProtocolFallbackTimer(): void {\n\t\tif (!this.keyboardProtocolFallbackTimer) {\n\t\t\treturn;\n\t\t}\n\t\tclearTimeout(this.keyboardProtocolFallbackTimer);\n\t\tthis.keyboardProtocolFallbackTimer = undefined;\n\t}\n\n\tprivate queryDefaultTerminalColors(): void {\n\t\tif (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {\n\t\t\treturn;\n\t\t}\n\t\tthis.finishDefaultColorProbe();\n\t\tthis.defaultColorProbe = {\n\t\t\ttimeout: setTimeout(() => this.finishDefaultColorProbe(), 100),\n\t\t};\n\t\tprocess.stdout.write(QUERY_DEFAULT_FOREGROUND);\n\t\tprocess.stdout.write(QUERY_DEFAULT_BACKGROUND);\n\t}\n\n\tprivate handleDefaultColorProbeResponse(sequence: string): boolean {\n\t\tconst response = parseOscColorResponse(sequence);\n\t\tif (!response) {\n\t\t\treturn false;\n\t\t}\n\t\tif (!this.defaultColorProbe) {\n\t\t\treturn true;\n\t\t}\n\n\t\tthis.defaultColorProbe[response.kind] = response.rgb;\n\t\tif (this.defaultColorProbe.foreground && this.defaultColorProbe.background) {\n\t\t\tthis.finishDefaultColorProbe();\n\t\t}\n\t\treturn true;\n\t}\n\n\tprivate finishDefaultColorProbe(): void {\n\t\tif (!this.defaultColorProbe) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst { foreground, background, timeout } = this.defaultColorProbe;\n\t\tclearTimeout(timeout);\n\t\tthis.defaultColorProbe = undefined;\n\t\tif (foreground && background) {\n\t\t\tsetDefaultTerminalColors({ foreground, background });\n\t\t\tthis.resizeHandler?.();\n\t\t}\n\t}\n\n\t/**\n\t * On Windows, add ENABLE_VIRTUAL_TERMINAL_INPUT (0x0200) to the stdin\n\t * console handle so the terminal sends VT sequences for modified keys\n\t * (e.g. \\x1b[Z for Shift+Tab). Without this, libuv's ReadConsoleInputW\n\t * discards modifier state and Shift+Tab arrives as plain \\t.\n\t */\n\tprivate enableWindowsVTInput(): void {\n\t\tif (process.platform !== \"win32\") return;\n\t\ttry {\n\t\t\t// Dynamic require to avoid bundling koffi's 74MB of cross-platform\n\t\t\t// native binaries into every compiled binary. Koffi is only needed\n\t\t\t// on Windows for VT input support.\n\t\t\tconst koffi = cjsRequire(\"koffi\");\n\t\t\tconst k32 = koffi.load(\"kernel32.dll\");\n\t\t\tconst GetStdHandle = k32.func(\"void* __stdcall GetStdHandle(int)\");\n\t\t\tconst GetConsoleMode = k32.func(\"bool __stdcall GetConsoleMode(void*, _Out_ uint32_t*)\");\n\t\t\tconst SetConsoleMode = k32.func(\"bool __stdcall SetConsoleMode(void*, uint32_t)\");\n\n\t\t\tconst STD_INPUT_HANDLE = -10;\n\t\t\tconst ENABLE_VIRTUAL_TERMINAL_INPUT = 0x0200;\n\t\t\tconst handle = GetStdHandle(STD_INPUT_HANDLE);\n\t\t\tconst mode = new Uint32Array(1);\n\t\t\tGetConsoleMode(handle, mode);\n\t\t\tSetConsoleMode(handle, mode[0]! | ENABLE_VIRTUAL_TERMINAL_INPUT);\n\t\t} catch {\n\t\t\t// koffi not available — Shift+Tab won't be distinguishable from Tab\n\t\t}\n\t}\n\n\tasync drainInput(maxMs = 1000, idleMs = 50): Promise<void> {\n\t\tif (this._kittyProtocolActive) {\n\t\t\t// Disable Kitty keyboard protocol first so any late key releases\n\t\t\t// do not generate new Kitty escape sequences.\n\t\t\tprocess.stdout.write(\"\\x1b[<u\");\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[>4;0m\");\n\t\t\tthis._modifyOtherKeysActive = false;\n\t\t}\n\n\t\tconst previousHandler = this.inputHandler;\n\t\tthis.inputHandler = undefined;\n\n\t\tlet lastDataTime = Date.now();\n\t\tconst onData = () => {\n\t\t\tlastDataTime = Date.now();\n\t\t};\n\n\t\tprocess.stdin.on(\"data\", onData);\n\t\tconst endTime = Date.now() + maxMs;\n\n\t\ttry {\n\t\t\twhile (true) {\n\t\t\t\tconst now = Date.now();\n\t\t\t\tconst timeLeft = endTime - now;\n\t\t\t\tif (timeLeft <= 0) break;\n\t\t\t\tif (now - lastDataTime >= idleMs) break;\n\t\t\t\tawait new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));\n\t\t\t}\n\t\t} finally {\n\t\t\tprocess.stdin.removeListener(\"data\", onData);\n\t\t\tthis.inputHandler = previousHandler;\n\t\t}\n\t}\n\n\tstop(options: TerminalStopOptions = {}): void {\n\t\tconst wasStarted = this.started;\n\t\tthis.started = false;\n\t\tthis.finishDefaultColorProbe();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\n\t\tif (this.clearProgressInterval()) {\n\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n\t\t}\n\n\t\tif (this._mouseTrackingActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[?1006l\\x1b[?1002l\");\n\t\t\tthis._mouseTrackingActive = false;\n\t\t}\n\t\tif (this._altScreenActive) {\n\t\t\tif (options.preserveAltScreen) {\n\t\t\t\tpendingAltScreenHandoff = this.altScreenHandoffToken;\n\t\t\t\tthis._altScreenActive = false;\n\t\t\t} else {\n\t\t\t\tthis.releaseAltScreen();\n\t\t\t}\n\t\t} else if (!options.preserveAltScreen) {\n\t\t\tthis.releaseAltScreen();\n\t\t}\n\n\t\t// Disable bracketed paste mode\n\t\tprocess.stdout.write(\"\\x1b[?2004l\");\n\n\t\t// Disable Kitty keyboard protocol if not already done by drainInput()\n\t\tif (this._kittyProtocolActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[<u\");\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tprocess.stdout.write(\"\\x1b[>4;0m\");\n\t\t\tthis._modifyOtherKeysActive = false;\n\t\t}\n\n\t\t// Clean up StdinBuffer\n\t\tif (this.stdinBuffer) {\n\t\t\tthis.stdinBuffer.destroy();\n\t\t\tthis.stdinBuffer = undefined;\n\t\t}\n\n\t\t// Remove event handlers\n\t\tif (this.stdinDataHandler) {\n\t\t\tprocess.stdin.removeListener(\"data\", this.stdinDataHandler);\n\t\t\tthis.stdinDataHandler = undefined;\n\t\t}\n\t\tthis.inputHandler = undefined;\n\t\tif (this.resizeHandler) {\n\t\t\tprocess.stdout.removeListener(\"resize\", this.resizeHandler);\n\t\t\tthis.resizeHandler = undefined;\n\t\t}\n\n\t\tif (options.preserveAltScreen && wasStarted) {\n\t\t\tbeginInputHandoff(this.altScreenHandoffToken, this.wasRaw);\n\t\t} else {\n\t\t\t// Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being\n\t\t\t// re-interpreted after raw mode is disabled. This fixes a race condition\n\t\t\t// where Ctrl+D could close the parent shell over SSH.\n\t\t\tprocess.stdin.pause();\n\n\t\t\t// Restore raw mode state\n\t\t\tif (process.stdin.setRawMode) {\n\t\t\t\tprocess.stdin.setRawMode(this.wasRaw);\n\t\t\t}\n\t\t}\n\t}\n\n\twrite(data: string): void {\n\t\tprocess.stdout.write(data);\n\t\tif (this.writeLogPath) {\n\t\t\ttry {\n\t\t\t\tfs.appendFileSync(this.writeLogPath, data, { encoding: \"utf8\" });\n\t\t\t} catch {\n\t\t\t\t// Ignore logging errors\n\t\t\t}\n\t\t}\n\t}\n\n\tget columns(): number {\n\t\treturn process.stdout.columns || Number(process.env.COLUMNS) || 80;\n\t}\n\n\tget rows(): number {\n\t\treturn process.stdout.rows || Number(process.env.LINES) || 24;\n\t}\n\n\tmoveBy(lines: number): void {\n\t\tif (lines > 0) {\n\t\t\t// Move down\n\t\t\tprocess.stdout.write(`\\x1b[${lines}B`);\n\t\t} else if (lines < 0) {\n\t\t\t// Move up\n\t\t\tprocess.stdout.write(`\\x1b[${-lines}A`);\n\t\t}\n\t\t// lines === 0: no movement\n\t}\n\n\thideCursor(): void {\n\t\tprocess.stdout.write(\"\\x1b[?25l\");\n\t}\n\n\tshowCursor(): void {\n\t\tprocess.stdout.write(\"\\x1b[?25h\");\n\t}\n\n\tclearLine(): void {\n\t\tprocess.stdout.write(\"\\x1b[K\");\n\t}\n\n\tclearFromCursor(): void {\n\t\tprocess.stdout.write(\"\\x1b[J\");\n\t}\n\n\tclearScreen(): void {\n\t\tprocess.stdout.write(\"\\x1b[2J\\x1b[H\"); // Clear screen and move to home (1,1)\n\t}\n\n\tenterAltScreen(): void {\n\t\tif (this._altScreenActive) return;\n\t\tif (this.ownsPendingAltScreenHandoff()) {\n\t\t\tpendingAltScreenHandoff = undefined;\n\t\t\tthis._altScreenActive = true;\n\t\t\treturn;\n\t\t}\n\t\tthis._altScreenActive = true;\n\t\tthis.write(\"\\x1b[?1049h\");\n\t}\n\n\tleaveAltScreen(): void {\n\t\tthis.releaseAltScreen();\n\t}\n\n\tprivate releaseAltScreen(): void {\n\t\tconst ownsPendingHandoff = this.ownsPendingAltScreenHandoff();\n\t\tif (!this._altScreenActive && !ownsPendingHandoff) return;\n\t\tthis._altScreenActive = false;\n\t\tif (ownsPendingHandoff) {\n\t\t\tpendingAltScreenHandoff = undefined;\n\t\t\tcancelInputHandoff(this.altScreenHandoffToken);\n\t\t}\n\t\tthis.write(\"\\x1b[?1049l\");\n\t}\n\n\tget altScreenActive(): boolean {\n\t\treturn this._altScreenActive;\n\t}\n\n\tprivate ownsPendingAltScreenHandoff(): boolean {\n\t\treturn pendingAltScreenHandoff === this.altScreenHandoffToken;\n\t}\n\n\tsetMouseTracking(enabled: boolean): void {\n\t\tif (enabled === this._mouseTrackingActive) return;\n\t\tthis._mouseTrackingActive = enabled;\n\t\t// ?1002 (button-event tracking) reports drag motion for in-app selection\n\t\t// but not hover, keeping passive mouse movement unreported.\n\t\tthis.write(enabled ? \"\\x1b[?1002h\\x1b[?1006h\" : \"\\x1b[?1006l\\x1b[?1002l\");\n\t}\n\n\tget mouseTrackingActive(): boolean {\n\t\treturn this._mouseTrackingActive;\n\t}\n\n\tsetTitle(title: string): void {\n\t\t// OSC 0;title BEL - set terminal window title\n\t\tprocess.stdout.write(`\\x1b]0;${title}\\x07`);\n\t}\n\n\tsetProgress(active: boolean): void {\n\t\tif (active) {\n\t\t\t// OSC 9;4;3 - indeterminate progress\n\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);\n\t\t\tif (!this.progressInterval) {\n\t\t\t\tthis.progressInterval = setInterval(() => {\n\t\t\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);\n\t\t\t\t}, TERMINAL_PROGRESS_KEEPALIVE_MS);\n\t\t\t}\n\t\t} else {\n\t\t\tthis.clearProgressInterval();\n\t\t\t// OSC 9;4;0 - clear progress\n\t\t\tprocess.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n\t\t}\n\t}\n\n\tprivate clearProgressInterval(): boolean {\n\t\tif (!this.progressInterval) return false;\n\t\tclearInterval(this.progressInterval);\n\t\tthis.progressInterval = undefined;\n\t\treturn true;\n\t}\n}\n"]}