omk-tui 1.3.2 → 1.4.1

package/dist/terminal-output.js

@@ -1,6 +1,7 @@
 import { errorMonitor } from "node:events";
 import { appendFileSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { TerminalResizeLog } from "./terminal-resize-log.js";
 function writeLogPath(value) {
     if (!value)
         return "";
@@ -16,6 +17,27 @@ function writeLogPath(value) {
     }
     return value;
 }
+/** The TerminalOutput of the running TUI: set on its first write, cleared by stop. */
+let activeOutput;
+/**
+ * Raw terminal bytes written from outside the render path (completion BEL,
+ * OSC 52 clipboard). While a TUI is writing they go through its
+ * TerminalOutput, so output stats and the OMK_TUI_RESIZE_LOG byte offsets
+ * count them; otherwise straight to stdout. May throw like stream.write.
+ */
+export function writeTerminalRaw(data) {
+    if (activeOutput)
+        activeOutput.write(data);
+    else
+        process.stdout.write(data);
+}
+/**
+ * Final resize-log lines still owed at process exit, for exits that skip stop
+ * (a dead tty's EIO goes straight to process.exit). One exit listener serves
+ * every TerminalOutput; stop removes its own entry, the next write re-adds it.
+ */
+const finalOnExit = new Set();
+let exitHooked = false;
 /** Metadata-only observation. No paint queue, retries, or interception of error handling. */
 export class TerminalOutput {
     stream;
@@ -35,15 +57,50 @@ export class TerminalOutput {
     onError = () => {
         this.counters.errorCount++;
     };
-    constructor(stream, log = "") {
+    resizeLog;
+    constructor(stream, log = "", resizeLog = process.env.OMK_TUI_RESIZE_LOG || "") {
         this.stream = stream;
         this.logPath = writeLogPath(log);
+        this.resizeLog = resizeLog ? new TerminalResizeLog(resizeLog) : undefined;
+        if (this.resizeLog)
+            this.owesFinal();
+    }
+    finalLine = () => this.resizeLog?.final(this.counters.submittedBytes);
+    owesFinal() {
+        finalOnExit.add(this.finalLine);
+        if (exitHooked)
+            return;
+        exitHooked = true;
+        process.once("exit", () => {
+            for (const finalLine of finalOnExit)
+                finalLine();
+        });
+    }
+    /**
+     * Wraps a resize handler so each resize first logs the bytes written so far
+     * (OMK_TUI_RESIZE_LOG, see terminal-resize-log.ts). Returns the handler
+     * itself when the log is off, so an unset variable costs nothing per event.
+     */
+    withResizeLog(onResize, size) {
+        const log = this.resizeLog;
+        if (!log)
+            return onResize;
+        let prev = size();
+        return () => {
+            const next = size();
+            log.resize(this.counters.submittedBytes, next.cols, next.rows, prev.cols, prev.rows);
+            prev = next;
+            onResize();
+        };
     }
     write(data, log = false) {
         if (!this.observing) {
             this.stream.on("drain", this.onDrain);
             this.stream.on(errorMonitor, this.onError);
             this.observing = true;
+            activeOutput = this;
+            if (this.resizeLog)
+                this.owesFinal();
         }
         this.counters.writeCalls++;
         this.counters.submittedBytes += Buffer.byteLength(data, "utf8");
@@ -74,9 +131,13 @@ export class TerminalOutput {
         };
     }
     stop() {
+        this.finalLine();
+        finalOnExit.delete(this.finalLine);
         this.stream.off("drain", this.onDrain);
         this.stream.off(errorMonitor, this.onError);
         this.observing = false;
+        if (activeOutput === this)
+            activeOutput = undefined;
     }
 }
 //# sourceMappingURL=terminal-output.js.map

package/dist/terminal-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-output.js","sourceRoot":"","sources":["../src/terminal-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAejC,SAAS,YAAY,CAAC,KAAa,EAAU;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC;QACJ,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAChQ,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;QACpD,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,+EAA+E;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,6FAA6F;AAC7F,MAAM,OAAO,cAAc;IACT,MAAM,CAAW;IACjB,OAAO,CAAS;IACzB,SAAS,GAAG,KAAK,CAAC;IACT,QAAQ,GAAG;QAC3B,UAAU,EAAE,CAAC;QACb,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;QAClB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,kBAAkB,EAAE,CAAC;KACrB,CAAC;IACe,OAAO,GAAG,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAAA,CAC3B,CAAC;IACe,OAAO,GAAG,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAAA,CAC3B,CAAC;IAEF,YAAY,MAAgB,EAAE,GAAG,GAAG,EAAE,EAAE;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAAA,CACjC;IAED,KAAK,CAAC,IAAY,EAAE,GAAG,GAAG,KAAK,EAAQ;QACtC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,IAAI,CAAC;YACJ,kDAAkD;YAClD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC;QACb,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC1G,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC;gBACJ,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACR,qDAAqD;YACtD,CAAC;QACF,CAAC;IAAA,CACD;IAED,QAAQ,GAAwB;QAC/B,OAAO;YACN,GAAG,IAAI,CAAC,QAAQ;YAChB,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;SAC5C,CAAC;IAAA,CACF;IAED,IAAI,GAAS;QACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IAAA,CACvB;CACD","sourcesContent":["import { errorMonitor } from \"node:events\";\nimport { appendFileSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Writable } from \"node:stream\";\n\nexport interface TerminalOutputStats {\n\treadonly writeCalls: number;\n\t/** Bytes offered to write, not a claim that the terminal displayed them. */\n\treadonly submittedBytes: number;\n\treadonly writeFalseCount: number;\n\treadonly drainCount: number;\n\treadonly errorCount: number;\n\treadonly peakWritableLength: number;\n\treadonly writableLength: number;\n\treadonly backpressured: boolean;\n}\n\nfunction writeLogPath(value: string): string {\n\tif (!value) return \"\";\n\ttry {\n\t\tif (statSync(value).isDirectory()) {\n\t\t\tconst now = new Date();\n\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\treturn join(value, `tui-${ts}-${process.pid}.log`);\n\t\t}\n\t} catch {\n\t\t// A non-existing path is a filename, matching the existing debug-log contract.\n\t}\n\treturn value;\n}\n\n/** Metadata-only observation. No paint queue, retries, or interception of error handling. */\nexport class TerminalOutput {\n\tprivate readonly stream: Writable;\n\tprivate readonly logPath: string;\n\tprivate observing = false;\n\tprivate readonly counters = {\n\t\twriteCalls: 0,\n\t\tsubmittedBytes: 0,\n\t\twriteFalseCount: 0,\n\t\tdrainCount: 0,\n\t\terrorCount: 0,\n\t\tpeakWritableLength: 0,\n\t};\n\tprivate readonly onDrain = () => {\n\t\tthis.counters.drainCount++;\n\t};\n\tprivate readonly onError = () => {\n\t\tthis.counters.errorCount++;\n\t};\n\n\tconstructor(stream: Writable, log = \"\") {\n\t\tthis.stream = stream;\n\t\tthis.logPath = writeLogPath(log);\n\t}\n\n\twrite(data: string, log = false): void {\n\t\tif (!this.observing) {\n\t\t\tthis.stream.on(\"drain\", this.onDrain);\n\t\t\tthis.stream.on(errorMonitor, this.onError);\n\t\t\tthis.observing = true;\n\t\t}\n\t\tthis.counters.writeCalls++;\n\t\tthis.counters.submittedBytes += Buffer.byteLength(data, \"utf8\");\n\t\ttry {\n\t\t\t// false still accepts the write. Never resend it.\n\t\t\tif (!this.stream.write(data)) this.counters.writeFalseCount++;\n\t\t} catch (error) {\n\t\t\tthis.counters.errorCount++;\n\t\t\tthrow error;\n\t\t}\n\t\tthis.counters.peakWritableLength = Math.max(this.counters.peakWritableLength, this.stream.writableLength);\n\t\tif (log && this.logPath) {\n\t\t\ttry {\n\t\t\t\tappendFileSync(this.logPath, data, { encoding: \"utf8\" });\n\t\t\t} catch {\n\t\t\t\t/* Explicit raw debug logging remains best-effort. */\n\t\t\t}\n\t\t}\n\t}\n\n\tsnapshot(): TerminalOutputStats {\n\t\treturn {\n\t\t\t...this.counters,\n\t\t\twritableLength: this.stream.writableLength,\n\t\t\tbackpressured: this.stream.writableNeedDrain,\n\t\t};\n\t}\n\n\tstop(): void {\n\t\tthis.stream.off(\"drain\", this.onDrain);\n\t\tthis.stream.off(errorMonitor, this.onError);\n\t\tthis.observing = false;\n\t}\n}\n"]}
+{"version":3,"file":"terminal-output.js","sourceRoot":"","sources":["../src/terminal-output.ts"],"names":[],"mappings":"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","sourcesContent":["import { errorMonitor } from \"node:events\";\nimport { appendFileSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Writable } from \"node:stream\";\nimport { TerminalResizeLog } from \"./terminal-resize-log.ts\";\n\nexport interface TerminalOutputStats {\n\treadonly writeCalls: number;\n\t/** Bytes offered to write, not a claim that the terminal displayed them. */\n\treadonly submittedBytes: number;\n\treadonly writeFalseCount: number;\n\treadonly drainCount: number;\n\treadonly errorCount: number;\n\treadonly peakWritableLength: number;\n\treadonly writableLength: number;\n\treadonly backpressured: boolean;\n}\n\nfunction writeLogPath(value: string): string {\n\tif (!value) return \"\";\n\ttry {\n\t\tif (statSync(value).isDirectory()) {\n\t\t\tconst now = new Date();\n\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\treturn join(value, `tui-${ts}-${process.pid}.log`);\n\t\t}\n\t} catch {\n\t\t// A non-existing path is a filename, matching the existing debug-log contract.\n\t}\n\treturn value;\n}\n\n/** The TerminalOutput of the running TUI: set on its first write, cleared by stop. */\nlet activeOutput: TerminalOutput | undefined;\n\n/**\n * Raw terminal bytes written from outside the render path (completion BEL,\n * OSC 52 clipboard). While a TUI is writing they go through its\n * TerminalOutput, so output stats and the OMK_TUI_RESIZE_LOG byte offsets\n * count them; otherwise straight to stdout. May throw like stream.write.\n */\nexport function writeTerminalRaw(data: string): void {\n\tif (activeOutput) activeOutput.write(data);\n\telse process.stdout.write(data);\n}\n\n/**\n * Final resize-log lines still owed at process exit, for exits that skip stop\n * (a dead tty's EIO goes straight to process.exit). One exit listener serves\n * every TerminalOutput; stop removes its own entry, the next write re-adds it.\n */\nconst finalOnExit = new Set<() => void>();\nlet exitHooked = false;\n\n/** Metadata-only observation. No paint queue, retries, or interception of error handling. */\nexport class TerminalOutput {\n\tprivate readonly stream: Writable;\n\tprivate readonly logPath: string;\n\tprivate observing = false;\n\tprivate readonly counters = {\n\t\twriteCalls: 0,\n\t\tsubmittedBytes: 0,\n\t\twriteFalseCount: 0,\n\t\tdrainCount: 0,\n\t\terrorCount: 0,\n\t\tpeakWritableLength: 0,\n\t};\n\tprivate readonly onDrain = () => {\n\t\tthis.counters.drainCount++;\n\t};\n\tprivate readonly onError = () => {\n\t\tthis.counters.errorCount++;\n\t};\n\n\tprivate readonly resizeLog: TerminalResizeLog | undefined;\n\n\tconstructor(stream: Writable, log = \"\", resizeLog = process.env.OMK_TUI_RESIZE_LOG || \"\") {\n\t\tthis.stream = stream;\n\t\tthis.logPath = writeLogPath(log);\n\t\tthis.resizeLog = resizeLog ? new TerminalResizeLog(resizeLog) : undefined;\n\t\tif (this.resizeLog) this.owesFinal();\n\t}\n\n\tprivate readonly finalLine = () => this.resizeLog?.final(this.counters.submittedBytes);\n\n\tprivate owesFinal(): void {\n\t\tfinalOnExit.add(this.finalLine);\n\t\tif (exitHooked) return;\n\t\texitHooked = true;\n\t\tprocess.once(\"exit\", () => {\n\t\t\tfor (const finalLine of finalOnExit) finalLine();\n\t\t});\n\t}\n\n\t/**\n\t * Wraps a resize handler so each resize first logs the bytes written so far\n\t * (OMK_TUI_RESIZE_LOG, see terminal-resize-log.ts). Returns the handler\n\t * itself when the log is off, so an unset variable costs nothing per event.\n\t */\n\twithResizeLog(onResize: () => void, size: () => { cols: number; rows: number }): () => void {\n\t\tconst log = this.resizeLog;\n\t\tif (!log) return onResize;\n\t\tlet prev = size();\n\t\treturn () => {\n\t\t\tconst next = size();\n\t\t\tlog.resize(this.counters.submittedBytes, next.cols, next.rows, prev.cols, prev.rows);\n\t\t\tprev = next;\n\t\t\tonResize();\n\t\t};\n\t}\n\n\twrite(data: string, log = false): void {\n\t\tif (!this.observing) {\n\t\t\tthis.stream.on(\"drain\", this.onDrain);\n\t\t\tthis.stream.on(errorMonitor, this.onError);\n\t\t\tthis.observing = true;\n\t\t\tactiveOutput = this;\n\t\t\tif (this.resizeLog) this.owesFinal();\n\t\t}\n\t\tthis.counters.writeCalls++;\n\t\tthis.counters.submittedBytes += Buffer.byteLength(data, \"utf8\");\n\t\ttry {\n\t\t\t// false still accepts the write. Never resend it.\n\t\t\tif (!this.stream.write(data)) this.counters.writeFalseCount++;\n\t\t} catch (error) {\n\t\t\tthis.counters.errorCount++;\n\t\t\tthrow error;\n\t\t}\n\t\tthis.counters.peakWritableLength = Math.max(this.counters.peakWritableLength, this.stream.writableLength);\n\t\tif (log && this.logPath) {\n\t\t\ttry {\n\t\t\t\tappendFileSync(this.logPath, data, { encoding: \"utf8\" });\n\t\t\t} catch {\n\t\t\t\t/* Explicit raw debug logging remains best-effort. */\n\t\t\t}\n\t\t}\n\t}\n\n\tsnapshot(): TerminalOutputStats {\n\t\treturn {\n\t\t\t...this.counters,\n\t\t\twritableLength: this.stream.writableLength,\n\t\t\tbackpressured: this.stream.writableNeedDrain,\n\t\t};\n\t}\n\n\tstop(): void {\n\t\tthis.finalLine();\n\t\tfinalOnExit.delete(this.finalLine);\n\t\tthis.stream.off(\"drain\", this.onDrain);\n\t\tthis.stream.off(errorMonitor, this.onError);\n\t\tthis.observing = false;\n\t\tif (activeOutput === this) activeOutput = undefined;\n\t}\n}\n"]}

package/dist/terminal-resize-log.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `OMK_TUI_RESIZE_LOG=<path>`: one JSON line per terminal resize, so a capture
+ * of omk's terminal output can be replayed with resizes at exact byte offsets
+ * (tmux `pipe-pane` file sizes lag by several KB).
+ *
+ * Resize line, written when omk handles the resize event, before it renders:
+ *   {"bytes":N,"cols":C,"rows":R,"t":T,"prevCols":PC,"prevRows":PR}
+ * Final line, written on terminal stop (TUI stop, including SIGINT/SIGTERM
+ * paths that stop the TUI), and on process exit if no final line with the same
+ * byte count was written yet (exits that skip stop, e.g. a dead tty's EIO):
+ *   {"final":true,"bytes":N}
+ *
+ * `bytes` is the cumulative UTF-8 length of everything omk handed to stdout
+ * through its terminal writer so far, counted at the write() call: omk-side
+ * bytes, not pty bytes (no ONLCR `\n` → `\r\n` correction). It is an upper
+ * bound on where the resize hit the byte stream (written bytes the terminal had
+ * not read yet may be processed at the new size); the external pipe-pane
+ * offset is the lower bound. `t` is `performance.now()` in ms.
+ *
+ * Lines are appended synchronously so they land before exit. Write errors are
+ * ignored (debug output, best-effort). Unset: no log object exists and the
+ * resize handler is not wrapped (TerminalOutput.withResizeLog).
+ *
+ * Node emits `resize` only when the tty size actually changed, so the SIGWINCH
+ * omk sends itself on start (stale size after suspend) logs a line only if the
+ * size changed while omk was stopped; there are no same-size lines. A
+ * suspend/resume cycle (external editor) writes a final line per stop, so
+ * readers take the last final line.
+ */
+export declare class TerminalResizeLog {
+    private readonly path;
+    constructor(path: string);
+    resize(bytes: number, cols: number, rows: number, prevCols: number, prevRows: number): void;
+    private finalBytes;
+    /** Skipped when the previous final line already has these bytes (stop, then exit). */
+    final(bytes: number): void;
+    private append;
+}
+//# sourceMappingURL=terminal-resize-log.d.ts.map

package/dist/terminal-resize-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-resize-log.d.ts","sourceRoot":"","sources":["../src/terminal-resize-log.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,YAAY,IAAI,EAAE,MAAM,EAEvB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1F;IAED,OAAO,CAAC,UAAU,CAAM;IAExB,sFAAsF;IACtF,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzB;IAED,OAAO,CAAC,MAAM;CAOd","sourcesContent":["import { appendFileSync } from \"node:fs\";\nimport { performance } from \"node:perf_hooks\";\n\n/**\n * `OMK_TUI_RESIZE_LOG=<path>`: one JSON line per terminal resize, so a capture\n * of omk's terminal output can be replayed with resizes at exact byte offsets\n * (tmux `pipe-pane` file sizes lag by several KB).\n *\n * Resize line, written when omk handles the resize event, before it renders:\n *   {\"bytes\":N,\"cols\":C,\"rows\":R,\"t\":T,\"prevCols\":PC,\"prevRows\":PR}\n * Final line, written on terminal stop (TUI stop, including SIGINT/SIGTERM\n * paths that stop the TUI), and on process exit if no final line with the same\n * byte count was written yet (exits that skip stop, e.g. a dead tty's EIO):\n *   {\"final\":true,\"bytes\":N}\n *\n * `bytes` is the cumulative UTF-8 length of everything omk handed to stdout\n * through its terminal writer so far, counted at the write() call: omk-side\n * bytes, not pty bytes (no ONLCR `\\n` → `\\r\\n` correction). It is an upper\n * bound on where the resize hit the byte stream (written bytes the terminal had\n * not read yet may be processed at the new size); the external pipe-pane\n * offset is the lower bound. `t` is `performance.now()` in ms.\n *\n * Lines are appended synchronously so they land before exit. Write errors are\n * ignored (debug output, best-effort). Unset: no log object exists and the\n * resize handler is not wrapped (TerminalOutput.withResizeLog).\n *\n * Node emits `resize` only when the tty size actually changed, so the SIGWINCH\n * omk sends itself on start (stale size after suspend) logs a line only if the\n * size changed while omk was stopped; there are no same-size lines. A\n * suspend/resume cycle (external editor) writes a final line per stop, so\n * readers take the last final line.\n */\nexport class TerminalResizeLog {\n\tprivate readonly path: string;\n\n\tconstructor(path: string) {\n\t\tthis.path = path;\n\t}\n\n\tresize(bytes: number, cols: number, rows: number, prevCols: number, prevRows: number): void {\n\t\tthis.append({ bytes, cols, rows, t: performance.now(), prevCols, prevRows });\n\t}\n\n\tprivate finalBytes = -1;\n\n\t/** Skipped when the previous final line already has these bytes (stop, then exit). */\n\tfinal(bytes: number): void {\n\t\tif (bytes === this.finalBytes) return;\n\t\tthis.finalBytes = bytes;\n\t\tthis.append({ final: true, bytes });\n\t}\n\n\tprivate append(record: Record<string, unknown>): void {\n\t\ttry {\n\t\t\tappendFileSync(this.path, `${JSON.stringify(record)}\\n`, { encoding: \"utf8\" });\n\t\t} catch {\n\t\t\t/* Best-effort debug log. */\n\t\t}\n\t}\n}\n"]}

package/dist/terminal-resize-log.js

@@ -0,0 +1,57 @@
+import { appendFileSync } from "node:fs";
+import { performance } from "node:perf_hooks";
+/**
+ * `OMK_TUI_RESIZE_LOG=<path>`: one JSON line per terminal resize, so a capture
+ * of omk's terminal output can be replayed with resizes at exact byte offsets
+ * (tmux `pipe-pane` file sizes lag by several KB).
+ *
+ * Resize line, written when omk handles the resize event, before it renders:
+ *   {"bytes":N,"cols":C,"rows":R,"t":T,"prevCols":PC,"prevRows":PR}
+ * Final line, written on terminal stop (TUI stop, including SIGINT/SIGTERM
+ * paths that stop the TUI), and on process exit if no final line with the same
+ * byte count was written yet (exits that skip stop, e.g. a dead tty's EIO):
+ *   {"final":true,"bytes":N}
+ *
+ * `bytes` is the cumulative UTF-8 length of everything omk handed to stdout
+ * through its terminal writer so far, counted at the write() call: omk-side
+ * bytes, not pty bytes (no ONLCR `\n` → `\r\n` correction). It is an upper
+ * bound on where the resize hit the byte stream (written bytes the terminal had
+ * not read yet may be processed at the new size); the external pipe-pane
+ * offset is the lower bound. `t` is `performance.now()` in ms.
+ *
+ * Lines are appended synchronously so they land before exit. Write errors are
+ * ignored (debug output, best-effort). Unset: no log object exists and the
+ * resize handler is not wrapped (TerminalOutput.withResizeLog).
+ *
+ * Node emits `resize` only when the tty size actually changed, so the SIGWINCH
+ * omk sends itself on start (stale size after suspend) logs a line only if the
+ * size changed while omk was stopped; there are no same-size lines. A
+ * suspend/resume cycle (external editor) writes a final line per stop, so
+ * readers take the last final line.
+ */
+export class TerminalResizeLog {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    resize(bytes, cols, rows, prevCols, prevRows) {
+        this.append({ bytes, cols, rows, t: performance.now(), prevCols, prevRows });
+    }
+    finalBytes = -1;
+    /** Skipped when the previous final line already has these bytes (stop, then exit). */
+    final(bytes) {
+        if (bytes === this.finalBytes)
+            return;
+        this.finalBytes = bytes;
+        this.append({ final: true, bytes });
+    }
+    append(record) {
+        try {
+            appendFileSync(this.path, `${JSON.stringify(record)}\n`, { encoding: "utf8" });
+        }
+        catch {
+            /* Best-effort debug log. */
+        }
+    }
+}
+//# sourceMappingURL=terminal-resize-log.js.map

package/dist/terminal-resize-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-resize-log.js","sourceRoot":"","sources":["../src/terminal-resize-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,iBAAiB;IACZ,IAAI,CAAS;IAE9B,YAAY,IAAY,EAAE;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAAA,CACjB;IAED,MAAM,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY,EAAE,QAAgB,EAAE,QAAgB,EAAQ;QAC3F,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAAA,CAC7E;IAEO,UAAU,GAAG,CAAC,CAAC,CAAC;IAExB,sFAAsF;IACtF,KAAK,CAAC,KAAa,EAAQ;QAC1B,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU;YAAE,OAAO;QACtC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAAA,CACpC;IAEO,MAAM,CAAC,MAA+B,EAAQ;QACrD,IAAI,CAAC;YACJ,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACR,4BAA4B;QAC7B,CAAC;IAAA,CACD;CACD","sourcesContent":["import { appendFileSync } from \"node:fs\";\nimport { performance } from \"node:perf_hooks\";\n\n/**\n * `OMK_TUI_RESIZE_LOG=<path>`: one JSON line per terminal resize, so a capture\n * of omk's terminal output can be replayed with resizes at exact byte offsets\n * (tmux `pipe-pane` file sizes lag by several KB).\n *\n * Resize line, written when omk handles the resize event, before it renders:\n *   {\"bytes\":N,\"cols\":C,\"rows\":R,\"t\":T,\"prevCols\":PC,\"prevRows\":PR}\n * Final line, written on terminal stop (TUI stop, including SIGINT/SIGTERM\n * paths that stop the TUI), and on process exit if no final line with the same\n * byte count was written yet (exits that skip stop, e.g. a dead tty's EIO):\n *   {\"final\":true,\"bytes\":N}\n *\n * `bytes` is the cumulative UTF-8 length of everything omk handed to stdout\n * through its terminal writer so far, counted at the write() call: omk-side\n * bytes, not pty bytes (no ONLCR `\\n` → `\\r\\n` correction). It is an upper\n * bound on where the resize hit the byte stream (written bytes the terminal had\n * not read yet may be processed at the new size); the external pipe-pane\n * offset is the lower bound. `t` is `performance.now()` in ms.\n *\n * Lines are appended synchronously so they land before exit. Write errors are\n * ignored (debug output, best-effort). Unset: no log object exists and the\n * resize handler is not wrapped (TerminalOutput.withResizeLog).\n *\n * Node emits `resize` only when the tty size actually changed, so the SIGWINCH\n * omk sends itself on start (stale size after suspend) logs a line only if the\n * size changed while omk was stopped; there are no same-size lines. A\n * suspend/resume cycle (external editor) writes a final line per stop, so\n * readers take the last final line.\n */\nexport class TerminalResizeLog {\n\tprivate readonly path: string;\n\n\tconstructor(path: string) {\n\t\tthis.path = path;\n\t}\n\n\tresize(bytes: number, cols: number, rows: number, prevCols: number, prevRows: number): void {\n\t\tthis.append({ bytes, cols, rows, t: performance.now(), prevCols, prevRows });\n\t}\n\n\tprivate finalBytes = -1;\n\n\t/** Skipped when the previous final line already has these bytes (stop, then exit). */\n\tfinal(bytes: number): void {\n\t\tif (bytes === this.finalBytes) return;\n\t\tthis.finalBytes = bytes;\n\t\tthis.append({ final: true, bytes });\n\t}\n\n\tprivate append(record: Record<string, unknown>): void {\n\t\ttry {\n\t\t\tappendFileSync(this.path, `${JSON.stringify(record)}\\n`, { encoding: \"utf8\" });\n\t\t} catch {\n\t\t\t/* Best-effort debug log. */\n\t\t}\n\t}\n}\n"]}

package/dist/terminal-resync.d.ts

@@ -0,0 +1,74 @@
+/**
+ * How far back a clearing repair repaint may reach, in viewport screens.
+ * Bounds the scrollback churn of fixing rows that already scrolled off
+ * (see the repaint budget note in TUI.doRender's fullRender helper). Shared
+ * by the above-viewport repair and the height-resize resync below.
+ */
+export declare const REPAINT_BUDGET_SCREENS = 4;
+/**
+ * Rows to write, relative to the cursor, before a height-change repaint.
+ *
+ * The height-change repaint homes the cursor and rewrites only the last
+ * `height` rows, which assumes the screen top is row `newLines.length - height`.
+ * A resize does not guarantee that: xterm.js drops the rows below the cursor
+ * (the editor footer) when the screen shrinks, and rows the stream appended
+ * since the last frame shift the tail down. Either way the screen top sits
+ * above the tail, and the repaint overwrote rows that never reached scrollback
+ * (scrollback-20 main-r4 lost `value1_3`..`value1_6`).
+ *
+ * What a resize does keep is the cursor's row and the rows above it (the
+ * terminal scrolls or pulls rows around the cursor, it does not move the
+ * cursor off its row). So walk up from the cursor's row to the first row that
+ * differs from the last frame and rewrite from there to the end with line
+ * feeds: rows that no longer fit scroll into scrollback in order, and the tail
+ * repaint that follows lands on a screen that already holds the same rows.
+ * If the walk up is clamped at the screen top (the first changed row already
+ * scrolled away), the changed rows print below their stale copies: duplicated,
+ * not lost. Already-printed rows more than REPAINT_BUDGET_SCREENS screens
+ * above the end are not re-sent; the start never moves below the cursor row.
+ *
+ * Rows are compared without overlays (`previousBase`/`currentBase`, the
+ * rows the components rendered): a full-height overlay such as the pinned
+ * status rail shifts relative to the content when the screen scrolls, so the
+ * composited rows above the cursor would all look changed and be re-sent on
+ * every resize step. What is written is the composited frame (`newLines`).
+ *
+ * A frame that fits the new screen needs no resync: the tail repaint writes
+ * all of it from the top. Resyncing it anyway is harmful when the frame was
+ * padded to the screen height (an overlay taller than short content): its
+ * rows are screen rows, not scrollback-anchored rows, so after a grow pulled
+ * rows back from scrollback the cursor's row no longer maps to the same
+ * content row and the line feeds push the pulled-back rows into scrollback a
+ * second time.
+ *
+ * @param previousBase pre-overlay rows of the last frame
+ * @param newLines composited rows of the frame about to be painted
+ * @param cursorRow content row the hardware cursor was left on by the last frame
+ * @param height terminal rows after the resize
+ * @param currentBase pre-overlay rows of the frame about to be painted (default: `newLines`)
+ */
+export declare function resyncAfterResize(previousBase: readonly string[], newLines: readonly string[], cursorRow: number, height: number, currentBase?: readonly string[]): string;
+/**
+ * First row the resync rewrites, the first changed row at or above the cursor
+ * row, and whether the repaint budget moved the start down from it. Requires
+ * `length > 0`.
+ */
+export declare function resyncStart(previousBase: readonly string[], currentBase: readonly string[], length: number, cursorRow: number, height: number): {
+    first: number;
+    changed: number;
+    capped: boolean;
+};
+/** Per-TUI state for resyncAfterResize: the pre-overlay rows of the last two frames. */
+export declare class ResizeResync {
+    private previousBase;
+    private currentBase;
+    /** Records a frame's rows before overlays are composited; returns them unchanged. Call once per render. */
+    track<T extends readonly string[]>(base: T): T;
+    /** How the last after() call chose its start, for OMK_DEBUG_REDRAW. */
+    detail: string;
+    /** resyncAfterResize for the frame last passed to track(), painted as `newLines`. */
+    after(newLines: readonly string[], cursorRow: number, height: number): string;
+}
+/** Termux changes height when the software keyboard shows or hides; those resizes skip the clearing repaint. */
+export declare function isTermuxSession(): boolean;
+//# sourceMappingURL=terminal-resync.d.ts.map

package/dist/terminal-resync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-resync.d.ts","sourceRoot":"","sources":["../src/terminal-resync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,SAAS,MAAM,EAAa,GACvC,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAerD;AAED,wFAAwF;AACxF,qBAAa,YAAY;IACxB,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,WAAW,CAAyB;IAE5C,2GAA2G;IAC3G,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAI7C;IAED,uEAAuE;IACvE,MAAM,SAAM;IAEZ,qFAAqF;IACrF,KAAK,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe5E;CACD;AAED,gHAAgH;AAChH,wBAAgB,eAAe,IAAI,OAAO,CAEzC","sourcesContent":["/**\n * How far back a clearing repair repaint may reach, in viewport screens.\n * Bounds the scrollback churn of fixing rows that already scrolled off\n * (see the repaint budget note in TUI.doRender's fullRender helper). Shared\n * by the above-viewport repair and the height-resize resync below.\n */\nexport const REPAINT_BUDGET_SCREENS = 4;\n\n/**\n * Rows to write, relative to the cursor, before a height-change repaint.\n *\n * The height-change repaint homes the cursor and rewrites only the last\n * `height` rows, which assumes the screen top is row `newLines.length - height`.\n * A resize does not guarantee that: xterm.js drops the rows below the cursor\n * (the editor footer) when the screen shrinks, and rows the stream appended\n * since the last frame shift the tail down. Either way the screen top sits\n * above the tail, and the repaint overwrote rows that never reached scrollback\n * (scrollback-20 main-r4 lost `value1_3`..`value1_6`).\n *\n * What a resize does keep is the cursor's row and the rows above it (the\n * terminal scrolls or pulls rows around the cursor, it does not move the\n * cursor off its row). So walk up from the cursor's row to the first row that\n * differs from the last frame and rewrite from there to the end with line\n * feeds: rows that no longer fit scroll into scrollback in order, and the tail\n * repaint that follows lands on a screen that already holds the same rows.\n * If the walk up is clamped at the screen top (the first changed row already\n * scrolled away), the changed rows print below their stale copies: duplicated,\n * not lost. Already-printed rows more than REPAINT_BUDGET_SCREENS screens\n * above the end are not re-sent; the start never moves below the cursor row.\n *\n * Rows are compared without overlays (`previousBase`/`currentBase`, the\n * rows the components rendered): a full-height overlay such as the pinned\n * status rail shifts relative to the content when the screen scrolls, so the\n * composited rows above the cursor would all look changed and be re-sent on\n * every resize step. What is written is the composited frame (`newLines`).\n *\n * A frame that fits the new screen needs no resync: the tail repaint writes\n * all of it from the top. Resyncing it anyway is harmful when the frame was\n * padded to the screen height (an overlay taller than short content): its\n * rows are screen rows, not scrollback-anchored rows, so after a grow pulled\n * rows back from scrollback the cursor's row no longer maps to the same\n * content row and the line feeds push the pulled-back rows into scrollback a\n * second time.\n *\n * @param previousBase pre-overlay rows of the last frame\n * @param newLines composited rows of the frame about to be painted\n * @param cursorRow content row the hardware cursor was left on by the last frame\n * @param height terminal rows after the resize\n * @param currentBase pre-overlay rows of the frame about to be painted (default: `newLines`)\n */\nexport function resyncAfterResize(\n\tpreviousBase: readonly string[],\n\tnewLines: readonly string[],\n\tcursorRow: number,\n\theight: number,\n\tcurrentBase: readonly string[] = newLines,\n): string {\n\tif (newLines.length === 0 || newLines.length <= height) return \"\";\n\tconst { first } = resyncStart(previousBase, currentBase, newLines.length, cursorRow, height);\n\tconst up = cursorRow - first;\n\tlet buffer = up > 0 ? `\\x1b[${up}A\\r` : \"\\r\";\n\tfor (let i = first; i < newLines.length; i++) {\n\t\tif (i > first) buffer += \"\\r\\n\";\n\t\tbuffer += `\\x1b[2K${newLines[i]}`;\n\t}\n\treturn buffer;\n}\n\n/**\n * First row the resync rewrites, the first changed row at or above the cursor\n * row, and whether the repaint budget moved the start down from it. Requires\n * `length > 0`.\n */\nexport function resyncStart(\n\tpreviousBase: readonly string[],\n\tcurrentBase: readonly string[],\n\tlength: number,\n\tcursorRow: number,\n\theight: number,\n): { first: number; changed: number; capped: boolean } {\n\tconst top = Math.min(cursorRow, length - 1);\n\tlet changed = top;\n\tfor (let i = 0; i < top; i++) {\n\t\tif (previousBase[i] !== currentBase[i]) {\n\t\t\tchanged = i;\n\t\t\tbreak;\n\t\t}\n\t}\n\t// The budget only limits how far UP already-printed rows are re-sent. It\n\t// must never push the start below the cursor: cursor-down stops at the\n\t// screen bottom, so the rows in between would never be written (a resize\n\t// frame that appended more than the budget lost them).\n\tconst first = Math.min(Math.max(changed, length - height * REPAINT_BUDGET_SCREENS, 0), top);\n\treturn { first, changed, capped: first > changed };\n}\n\n/** Per-TUI state for resyncAfterResize: the pre-overlay rows of the last two frames. */\nexport class ResizeResync {\n\tprivate previousBase: readonly string[] = [];\n\tprivate currentBase: readonly string[] = [];\n\n\t/** Records a frame's rows before overlays are composited; returns them unchanged. Call once per render. */\n\ttrack<T extends readonly string[]>(base: T): T {\n\t\tthis.previousBase = this.currentBase;\n\t\tthis.currentBase = base;\n\t\treturn base;\n\t}\n\n\t/** How the last after() call chose its start, for OMK_DEBUG_REDRAW. */\n\tdetail = \"\";\n\n\t/** resyncAfterResize for the frame last passed to track(), painted as `newLines`. */\n\tafter(newLines: readonly string[], cursorRow: number, height: number): string {\n\t\tconst output = resyncAfterResize(this.previousBase, newLines, cursorRow, height, this.currentBase);\n\t\tif (!output) {\n\t\t\tthis.detail = `resync none (frame fits: new=${newLines.length} <= height=${height})`;\n\t\t\treturn output;\n\t\t}\n\t\tconst { first, changed, capped } = resyncStart(\n\t\t\tthis.previousBase,\n\t\t\tthis.currentBase,\n\t\t\tnewLines.length,\n\t\t\tcursorRow,\n\t\t\theight,\n\t\t);\n\t\tthis.detail = `resync first=${first} changed=${changed} cursorRow=${cursorRow} capped=${capped}`;\n\t\treturn output;\n\t}\n}\n\n/** Termux changes height when the software keyboard shows or hides; those resizes skip the clearing repaint. */\nexport function isTermuxSession(): boolean {\n\treturn Boolean(process.env.TERMUX_VERSION);\n}\n"]}

package/dist/terminal-resync.js

@@ -0,0 +1,112 @@
+/**
+ * How far back a clearing repair repaint may reach, in viewport screens.
+ * Bounds the scrollback churn of fixing rows that already scrolled off
+ * (see the repaint budget note in TUI.doRender's fullRender helper). Shared
+ * by the above-viewport repair and the height-resize resync below.
+ */
+export const REPAINT_BUDGET_SCREENS = 4;
+/**
+ * Rows to write, relative to the cursor, before a height-change repaint.
+ *
+ * The height-change repaint homes the cursor and rewrites only the last
+ * `height` rows, which assumes the screen top is row `newLines.length - height`.
+ * A resize does not guarantee that: xterm.js drops the rows below the cursor
+ * (the editor footer) when the screen shrinks, and rows the stream appended
+ * since the last frame shift the tail down. Either way the screen top sits
+ * above the tail, and the repaint overwrote rows that never reached scrollback
+ * (scrollback-20 main-r4 lost `value1_3`..`value1_6`).
+ *
+ * What a resize does keep is the cursor's row and the rows above it (the
+ * terminal scrolls or pulls rows around the cursor, it does not move the
+ * cursor off its row). So walk up from the cursor's row to the first row that
+ * differs from the last frame and rewrite from there to the end with line
+ * feeds: rows that no longer fit scroll into scrollback in order, and the tail
+ * repaint that follows lands on a screen that already holds the same rows.
+ * If the walk up is clamped at the screen top (the first changed row already
+ * scrolled away), the changed rows print below their stale copies: duplicated,
+ * not lost. Already-printed rows more than REPAINT_BUDGET_SCREENS screens
+ * above the end are not re-sent; the start never moves below the cursor row.
+ *
+ * Rows are compared without overlays (`previousBase`/`currentBase`, the
+ * rows the components rendered): a full-height overlay such as the pinned
+ * status rail shifts relative to the content when the screen scrolls, so the
+ * composited rows above the cursor would all look changed and be re-sent on
+ * every resize step. What is written is the composited frame (`newLines`).
+ *
+ * A frame that fits the new screen needs no resync: the tail repaint writes
+ * all of it from the top. Resyncing it anyway is harmful when the frame was
+ * padded to the screen height (an overlay taller than short content): its
+ * rows are screen rows, not scrollback-anchored rows, so after a grow pulled
+ * rows back from scrollback the cursor's row no longer maps to the same
+ * content row and the line feeds push the pulled-back rows into scrollback a
+ * second time.
+ *
+ * @param previousBase pre-overlay rows of the last frame
+ * @param newLines composited rows of the frame about to be painted
+ * @param cursorRow content row the hardware cursor was left on by the last frame
+ * @param height terminal rows after the resize
+ * @param currentBase pre-overlay rows of the frame about to be painted (default: `newLines`)
+ */
+export function resyncAfterResize(previousBase, newLines, cursorRow, height, currentBase = newLines) {
+    if (newLines.length === 0 || newLines.length <= height)
+        return "";
+    const { first } = resyncStart(previousBase, currentBase, newLines.length, cursorRow, height);
+    const up = cursorRow - first;
+    let buffer = up > 0 ? `\x1b[${up}A\r` : "\r";
+    for (let i = first; i < newLines.length; i++) {
+        if (i > first)
+            buffer += "\r\n";
+        buffer += `\x1b[2K${newLines[i]}`;
+    }
+    return buffer;
+}
+/**
+ * First row the resync rewrites, the first changed row at or above the cursor
+ * row, and whether the repaint budget moved the start down from it. Requires
+ * `length > 0`.
+ */
+export function resyncStart(previousBase, currentBase, length, cursorRow, height) {
+    const top = Math.min(cursorRow, length - 1);
+    let changed = top;
+    for (let i = 0; i < top; i++) {
+        if (previousBase[i] !== currentBase[i]) {
+            changed = i;
+            break;
+        }
+    }
+    // The budget only limits how far UP already-printed rows are re-sent. It
+    // must never push the start below the cursor: cursor-down stops at the
+    // screen bottom, so the rows in between would never be written (a resize
+    // frame that appended more than the budget lost them).
+    const first = Math.min(Math.max(changed, length - height * REPAINT_BUDGET_SCREENS, 0), top);
+    return { first, changed, capped: first > changed };
+}
+/** Per-TUI state for resyncAfterResize: the pre-overlay rows of the last two frames. */
+export class ResizeResync {
+    previousBase = [];
+    currentBase = [];
+    /** Records a frame's rows before overlays are composited; returns them unchanged. Call once per render. */
+    track(base) {
+        this.previousBase = this.currentBase;
+        this.currentBase = base;
+        return base;
+    }
+    /** How the last after() call chose its start, for OMK_DEBUG_REDRAW. */
+    detail = "";
+    /** resyncAfterResize for the frame last passed to track(), painted as `newLines`. */
+    after(newLines, cursorRow, height) {
+        const output = resyncAfterResize(this.previousBase, newLines, cursorRow, height, this.currentBase);
+        if (!output) {
+            this.detail = `resync none (frame fits: new=${newLines.length} <= height=${height})`;
+            return output;
+        }
+        const { first, changed, capped } = resyncStart(this.previousBase, this.currentBase, newLines.length, cursorRow, height);
+        this.detail = `resync first=${first} changed=${changed} cursorRow=${cursorRow} capped=${capped}`;
+        return output;
+    }
+}
+/** Termux changes height when the software keyboard shows or hides; those resizes skip the clearing repaint. */
+export function isTermuxSession() {
+    return Boolean(process.env.TERMUX_VERSION);
+}
+//# sourceMappingURL=terminal-resync.js.map

package/dist/terminal-resync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-resync.js","sourceRoot":"","sources":["../src/terminal-resync.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * How far back a clearing repair repaint may reach, in viewport screens.\n * Bounds the scrollback churn of fixing rows that already scrolled off\n * (see the repaint budget note in TUI.doRender's fullRender helper). Shared\n * by the above-viewport repair and the height-resize resync below.\n */\nexport const REPAINT_BUDGET_SCREENS = 4;\n\n/**\n * Rows to write, relative to the cursor, before a height-change repaint.\n *\n * The height-change repaint homes the cursor and rewrites only the last\n * `height` rows, which assumes the screen top is row `newLines.length - height`.\n * A resize does not guarantee that: xterm.js drops the rows below the cursor\n * (the editor footer) when the screen shrinks, and rows the stream appended\n * since the last frame shift the tail down. Either way the screen top sits\n * above the tail, and the repaint overwrote rows that never reached scrollback\n * (scrollback-20 main-r4 lost `value1_3`..`value1_6`).\n *\n * What a resize does keep is the cursor's row and the rows above it (the\n * terminal scrolls or pulls rows around the cursor, it does not move the\n * cursor off its row). So walk up from the cursor's row to the first row that\n * differs from the last frame and rewrite from there to the end with line\n * feeds: rows that no longer fit scroll into scrollback in order, and the tail\n * repaint that follows lands on a screen that already holds the same rows.\n * If the walk up is clamped at the screen top (the first changed row already\n * scrolled away), the changed rows print below their stale copies: duplicated,\n * not lost. Already-printed rows more than REPAINT_BUDGET_SCREENS screens\n * above the end are not re-sent; the start never moves below the cursor row.\n *\n * Rows are compared without overlays (`previousBase`/`currentBase`, the\n * rows the components rendered): a full-height overlay such as the pinned\n * status rail shifts relative to the content when the screen scrolls, so the\n * composited rows above the cursor would all look changed and be re-sent on\n * every resize step. What is written is the composited frame (`newLines`).\n *\n * A frame that fits the new screen needs no resync: the tail repaint writes\n * all of it from the top. Resyncing it anyway is harmful when the frame was\n * padded to the screen height (an overlay taller than short content): its\n * rows are screen rows, not scrollback-anchored rows, so after a grow pulled\n * rows back from scrollback the cursor's row no longer maps to the same\n * content row and the line feeds push the pulled-back rows into scrollback a\n * second time.\n *\n * @param previousBase pre-overlay rows of the last frame\n * @param newLines composited rows of the frame about to be painted\n * @param cursorRow content row the hardware cursor was left on by the last frame\n * @param height terminal rows after the resize\n * @param currentBase pre-overlay rows of the frame about to be painted (default: `newLines`)\n */\nexport function resyncAfterResize(\n\tpreviousBase: readonly string[],\n\tnewLines: readonly string[],\n\tcursorRow: number,\n\theight: number,\n\tcurrentBase: readonly string[] = newLines,\n): string {\n\tif (newLines.length === 0 || newLines.length <= height) return \"\";\n\tconst { first } = resyncStart(previousBase, currentBase, newLines.length, cursorRow, height);\n\tconst up = cursorRow - first;\n\tlet buffer = up > 0 ? `\\x1b[${up}A\\r` : \"\\r\";\n\tfor (let i = first; i < newLines.length; i++) {\n\t\tif (i > first) buffer += \"\\r\\n\";\n\t\tbuffer += `\\x1b[2K${newLines[i]}`;\n\t}\n\treturn buffer;\n}\n\n/**\n * First row the resync rewrites, the first changed row at or above the cursor\n * row, and whether the repaint budget moved the start down from it. Requires\n * `length > 0`.\n */\nexport function resyncStart(\n\tpreviousBase: readonly string[],\n\tcurrentBase: readonly string[],\n\tlength: number,\n\tcursorRow: number,\n\theight: number,\n): { first: number; changed: number; capped: boolean } {\n\tconst top = Math.min(cursorRow, length - 1);\n\tlet changed = top;\n\tfor (let i = 0; i < top; i++) {\n\t\tif (previousBase[i] !== currentBase[i]) {\n\t\t\tchanged = i;\n\t\t\tbreak;\n\t\t}\n\t}\n\t// The budget only limits how far UP already-printed rows are re-sent. It\n\t// must never push the start below the cursor: cursor-down stops at the\n\t// screen bottom, so the rows in between would never be written (a resize\n\t// frame that appended more than the budget lost them).\n\tconst first = Math.min(Math.max(changed, length - height * REPAINT_BUDGET_SCREENS, 0), top);\n\treturn { first, changed, capped: first > changed };\n}\n\n/** Per-TUI state for resyncAfterResize: the pre-overlay rows of the last two frames. */\nexport class ResizeResync {\n\tprivate previousBase: readonly string[] = [];\n\tprivate currentBase: readonly string[] = [];\n\n\t/** Records a frame's rows before overlays are composited; returns them unchanged. Call once per render. */\n\ttrack<T extends readonly string[]>(base: T): T {\n\t\tthis.previousBase = this.currentBase;\n\t\tthis.currentBase = base;\n\t\treturn base;\n\t}\n\n\t/** How the last after() call chose its start, for OMK_DEBUG_REDRAW. */\n\tdetail = \"\";\n\n\t/** resyncAfterResize for the frame last passed to track(), painted as `newLines`. */\n\tafter(newLines: readonly string[], cursorRow: number, height: number): string {\n\t\tconst output = resyncAfterResize(this.previousBase, newLines, cursorRow, height, this.currentBase);\n\t\tif (!output) {\n\t\t\tthis.detail = `resync none (frame fits: new=${newLines.length} <= height=${height})`;\n\t\t\treturn output;\n\t\t}\n\t\tconst { first, changed, capped } = resyncStart(\n\t\t\tthis.previousBase,\n\t\t\tthis.currentBase,\n\t\t\tnewLines.length,\n\t\t\tcursorRow,\n\t\t\theight,\n\t\t);\n\t\tthis.detail = `resync first=${first} changed=${changed} cursorRow=${cursorRow} capped=${capped}`;\n\t\treturn output;\n\t}\n}\n\n/** Termux changes height when the software keyboard shows or hides; those resizes skip the clearing repaint. */\nexport function isTermuxSession(): boolean {\n\treturn Boolean(process.env.TERMUX_VERSION);\n}\n"]}

package/dist/terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport type { Writable } from \"node:stream\";\nimport { fileURLToPath } from \"node:url\";\nimport { setKittyProtocolActive } from \"./keys.ts\";\nimport { isNativeModifierPressed } from \"./native-modifiers.ts\";\nimport { StdinBuffer } from \"./stdin-buffer.ts\";\nimport { TerminalOutput, type TerminalOutputStats } from \"./terminal-output.ts\";\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\";\nconst APPLE_TERMINAL_SHIFT_ENTER_SEQUENCE = \"\\x1b[13;2u\";\nconst DESIRED_KITTY_KEYBOARD_PROTOCOL_FLAGS = 7;\nconst KITTY_KEYBOARD_PROTOCOL_FALLBACK_TIMEOUT_MS = 150;\nconst KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS = 150;\nconst KITTY_KEYBOARD_PROTOCOL_QUERY = `\\x1b[>${DESIRED_KITTY_KEYBOARD_PROTOCOL_FLAGS}u\\x1b[?u\\x1b[c`;\n\nexport type KeyboardProtocolNegotiationSequence =\n\t| { type: \"kitty-flags\"; flags: number }\n\t| { type: \"device-attributes\" };\n\nexport function parseKeyboardProtocolNegotiationSequence(\n\tsequence: string,\n): KeyboardProtocolNegotiationSequence | undefined {\n\tconst kittyFlags = sequence.match(/^\\x1b\\[\\?(\\d+)u$/);\n\tif (kittyFlags) {\n\t\treturn { type: \"kitty-flags\", flags: Number.parseInt(kittyFlags[1]!, 10) };\n\t}\n\tif (/^\\x1b\\[\\?[\\d;]*c$/.test(sequence)) {\n\t\treturn { type: \"device-attributes\" };\n\t}\n\treturn undefined;\n}\n\nfunction isKeyboardProtocolNegotiationSequencePrefix(sequence: string, allowBareEscapePrefix: boolean): boolean {\n\treturn (allowBareEscapePrefix && sequence === \"\\x1b\") || sequence === \"\\x1b[\" || /^\\x1b\\[\\?[\\d;]*$/.test(sequence);\n}\n\nexport function isAppleTerminalSession(): boolean {\n\treturn process.platform === \"darwin\" && process.env.TERM_PROGRAM === \"Apple_Terminal\";\n}\n\nexport function normalizeAppleTerminalInput(data: string, isAppleTerminal: boolean, isShiftPressed: boolean): string {\n\tif (isAppleTerminal && data === \"\\r\" && isShiftPressed) return APPLE_TERMINAL_SHIFT_ENTER_SEQUENCE;\n\treturn data;\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(): 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\t/** Optional metadata-only output observations; unsupported terminals omit this. */\n\tgetOutputStats?(): TerminalOutputStats;\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// 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\n/**\n * Real terminal using process.stdin/stdout\n */\nexport class ProcessTerminal implements Terminal {\n\tprivate wasRaw = false;\n\tprivate inputHandler?: (data: string) => void;\n\tprivate resizeHandler?: () => void;\n\tprivate _kittyProtocolActive = false;\n\tprivate _modifyOtherKeysActive = false;\n\tprivate keyboardProtocolPushed = false;\n\tprivate keyboardProtocolNegotiationPending = false;\n\tprivate keyboardProtocolLateResponsePending = false;\n\tprivate keyboardProtocolNegotiationBuffer = \"\";\n\tprivate keyboardProtocolFallbackTimer?: ReturnType<typeof setTimeout>;\n\tprivate keyboardProtocolBufferFlushTimer?: ReturnType<typeof setTimeout>;\n\tprivate stdinBuffer?: StdinBuffer;\n\tprivate stdinDataHandler?: (data: string) => void;\n\tprivate progressInterval?: ReturnType<typeof setInterval>;\n\tprivate readonly output: TerminalOutput;\n\n\tconstructor(output: Writable = process.stdout) {\n\t\tthis.output = new TerminalOutput(output, process.env.OMK_TUI_WRITE_LOG || \"\");\n\t}\n\n\tgetOutputStats(): TerminalOutputStats {\n\t\treturn this.output.snapshot();\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.inputHandler = onInput;\n\t\tthis.resizeHandler = onResize;\n\n\t\t// Save previous state and enable raw mode\n\t\tthis.wasRaw = 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\tthis.output.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// Forward individual sequences to the input handler\n\t\tthis.stdinBuffer.on(\"data\", (sequence) => {\n\t\t\tif (this.keyboardProtocolNegotiationPending) {\n\t\t\t\tconst negotiationSequence = this.readKeyboardProtocolNegotiationSequence(sequence, true);\n\t\t\t\tif (negotiationSequence === \"pending\") {\n\t\t\t\t\treturn; // Wait for the rest of a split negotiation response.\n\t\t\t\t}\n\t\t\t\tif (this.handleKeyboardProtocolNegotiationSequence(negotiationSequence)) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (this.keyboardProtocolLateResponsePending) {\n\t\t\t\tconst negotiationSequence = this.readKeyboardProtocolNegotiationSequence(sequence, false);\n\t\t\t\tif (negotiationSequence === \"pending\") {\n\t\t\t\t\tthis.scheduleKeyboardProtocolNegotiationBufferFlush();\n\t\t\t\t\treturn; // Wait for the rest of a split late negotiation response.\n\t\t\t\t}\n\t\t\t\tif (this.handleKeyboardProtocolNegotiationSequence(negotiationSequence)) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthis.forwardInputSequence(sequence);\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 it if available.\n\t *\n\t * Kitty's progressive enhancement detection requires requesting the desired\n\t * flags before querying them. The trailing DA query is a sentinel supported by\n\t * terminals that do not know Kitty keyboard protocol. A short timeout remains\n\t * as a backup for terminals, PTYs, and SSH sessions that delay, split, or drop\n\t * the DA response.\n\t *\n\t * The requested flags are:\n\t * - 1 = disambiguate escape codes\n\t * - 2 = report event types (press/repeat/release)\n\t * - 4 = report alternate keys (shifted key, base layout key)\n\t */\n\tprivate queryAndEnableKittyProtocol(): void {\n\t\tthis.setupStdinBuffer();\n\t\tprocess.stdin.on(\"data\", this.stdinDataHandler!);\n\t\tthis.keyboardProtocolPushed = true;\n\t\tthis.keyboardProtocolNegotiationPending = true;\n\t\tthis.keyboardProtocolLateResponsePending = false;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.output.write(KITTY_KEYBOARD_PROTOCOL_QUERY);\n\t\tthis.keyboardProtocolFallbackTimer = setTimeout(() => {\n\t\t\tthis.keyboardProtocolFallbackTimer = undefined;\n\t\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\t\tthis.keyboardProtocolLateResponsePending = true;\n\t\t\tif (this.keyboardProtocolNegotiationBuffer === \"\\x1b\") {\n\t\t\t\tthis.flushKeyboardProtocolNegotiationBufferAsInput();\n\t\t\t} else {\n\t\t\t\tthis.scheduleKeyboardProtocolNegotiationBufferFlush();\n\t\t\t}\n\t\t\tthis.enableModifyOtherKeys();\n\t\t}, KITTY_KEYBOARD_PROTOCOL_FALLBACK_TIMEOUT_MS);\n\t}\n\n\tprivate handleKeyboardProtocolNegotiationSequence(\n\t\tnegotiationSequence: KeyboardProtocolNegotiationSequence | undefined,\n\t): boolean {\n\t\tif (!negotiationSequence) return false;\n\t\tif (negotiationSequence.type === \"kitty-flags\") {\n\t\t\tif (negotiationSequence.flags !== 0 && !this._kittyProtocolActive) {\n\t\t\t\tthis._kittyProtocolActive = true;\n\t\t\t\tsetKittyProtocolActive(true);\n\t\t\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\t\t\tthis.keyboardProtocolLateResponsePending = true;\n\t\t\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\t\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\n\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\tthis.keyboardProtocolLateResponsePending = true;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\tthis.enableModifyOtherKeys();\n\t\treturn true;\n\t}\n\n\tprivate readKeyboardProtocolNegotiationSequence(\n\t\tsequence: string,\n\t\tallowBareEscapePrefix: boolean,\n\t): KeyboardProtocolNegotiationSequence | \"pending\" | undefined {\n\t\tif (this.keyboardProtocolNegotiationBuffer) {\n\t\t\tconst bufferedSequence = this.keyboardProtocolNegotiationBuffer + sequence;\n\t\t\tconst negotiationSequence = parseKeyboardProtocolNegotiationSequence(bufferedSequence);\n\t\t\tif (negotiationSequence) {\n\t\t\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\t\t\treturn negotiationSequence;\n\t\t\t}\n\t\t\tif (isKeyboardProtocolNegotiationSequencePrefix(bufferedSequence, allowBareEscapePrefix)) {\n\t\t\t\tthis.setKeyboardProtocolNegotiationBuffer(bufferedSequence);\n\t\t\t\treturn \"pending\";\n\t\t\t}\n\t\t\tthis.flushKeyboardProtocolNegotiationBufferAsInput();\n\t\t}\n\n\t\tconst negotiationSequence = parseKeyboardProtocolNegotiationSequence(sequence);\n\t\tif (negotiationSequence) return negotiationSequence;\n\t\tif (isKeyboardProtocolNegotiationSequencePrefix(sequence, allowBareEscapePrefix)) {\n\t\t\tthis.setKeyboardProtocolNegotiationBuffer(sequence);\n\t\t\treturn \"pending\";\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate setKeyboardProtocolNegotiationBuffer(sequence: string): void {\n\t\tthis.clearKeyboardProtocolNegotiationBufferFlushTimer();\n\t\tthis.keyboardProtocolNegotiationBuffer = sequence;\n\t}\n\n\tprivate clearKeyboardProtocolNegotiationBuffer(): void {\n\t\tthis.clearKeyboardProtocolNegotiationBufferFlushTimer();\n\t\tthis.keyboardProtocolNegotiationBuffer = \"\";\n\t}\n\n\tprivate flushKeyboardProtocolNegotiationBufferAsInput(): void {\n\t\tif (!this.keyboardProtocolNegotiationBuffer) return;\n\t\tconst sequence = this.keyboardProtocolNegotiationBuffer;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.forwardInputSequence(sequence);\n\t}\n\n\tprivate scheduleKeyboardProtocolNegotiationBufferFlush(): void {\n\t\tif (!this.keyboardProtocolNegotiationBuffer || this.keyboardProtocolBufferFlushTimer) return;\n\t\tthis.keyboardProtocolBufferFlushTimer = setTimeout(() => {\n\t\t\tthis.keyboardProtocolBufferFlushTimer = undefined;\n\t\t\tthis.flushKeyboardProtocolNegotiationBufferAsInput();\n\t\t}, KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS);\n\t}\n\n\tprivate clearKeyboardProtocolNegotiationBufferFlushTimer(): void {\n\t\tif (!this.keyboardProtocolBufferFlushTimer) return;\n\t\tclearTimeout(this.keyboardProtocolBufferFlushTimer);\n\t\tthis.keyboardProtocolBufferFlushTimer = undefined;\n\t}\n\n\tprivate forwardInputSequence(sequence: string): void {\n\t\tif (!this.inputHandler) return;\n\t\tconst isAppleTerminal = sequence === \"\\r\" && isAppleTerminalSession();\n\t\tconst input = normalizeAppleTerminalInput(\n\t\t\tsequence,\n\t\t\tisAppleTerminal,\n\t\t\tisAppleTerminal && isNativeModifierPressed(\"shift\"),\n\t\t);\n\t\tthis.inputHandler(input);\n\t}\n\n\tprivate enableModifyOtherKeys(): void {\n\t\tif (this._kittyProtocolActive || this._modifyOtherKeysActive) return;\n\t\tthis.output.write(\"\\x1b[>4;2m\");\n\t\tthis._modifyOtherKeysActive = true;\n\t}\n\n\tprivate clearKeyboardProtocolFallbackTimer(): void {\n\t\tif (!this.keyboardProtocolFallbackTimer) return;\n\t\tclearTimeout(this.keyboardProtocolFallbackTimer);\n\t\tthis.keyboardProtocolFallbackTimer = undefined;\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\tconst arch = process.arch;\n\t\t\tif (arch !== \"x64\" && arch !== \"arm64\") return;\n\n\t\t\t// Dynamic require so non-Windows and bundled/browser paths never load the\n\t\t\t// native helper. In the npm package native/ is next to dist/; in compiled\n\t\t\t// binary archives native/ is copied next to the executable.\n\t\t\tconst moduleDir = path.dirname(fileURLToPath(import.meta.url));\n\t\t\tconst nativePath = path.join(\"native\", \"win32\", \"prebuilds\", `win32-${arch}`, \"win32-console-mode.node\");\n\t\t\tconst candidates = [\n\t\t\t\tpath.join(moduleDir, \"..\", nativePath),\n\t\t\t\tpath.join(moduleDir, nativePath),\n\t\t\t\tpath.join(path.dirname(process.execPath), nativePath),\n\t\t\t];\n\t\t\tfor (const modulePath of candidates) {\n\t\t\t\ttry {\n\t\t\t\t\tconst helper = cjsRequire(modulePath) as { enableVirtualTerminalInput?: () => boolean };\n\t\t\t\t\thelper.enableVirtualTerminalInput?.();\n\t\t\t\t\treturn;\n\t\t\t\t} catch {\n\t\t\t\t\t// Try the next possible packaging location.\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {\n\t\t\t// Native helper 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\tconst shouldDisableKittyProtocol =\n\t\t\tthis.keyboardProtocolPushed || this._kittyProtocolActive || this.keyboardProtocolNegotiationPending;\n\t\tthis.keyboardProtocolLateResponsePending = false;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\tif (shouldDisableKittyProtocol) {\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\tthis.output.write(\"\\x1b[<u\");\n\t\t\tthis.keyboardProtocolPushed = false;\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tthis.output.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(): void {\n\t\tif (this.clearProgressInterval()) {\n\t\t\tthis.output.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n\t\t}\n\n\t\t// Disable bracketed paste mode\n\t\tthis.output.write(\"\\x1b[?2004l\");\n\n\t\tconst shouldDisableKittyProtocol =\n\t\t\tthis.keyboardProtocolPushed || this._kittyProtocolActive || this.keyboardProtocolNegotiationPending;\n\t\tthis.keyboardProtocolLateResponsePending = false;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\n\t\t// Disable Kitty keyboard protocol if not already done by drainInput()\n\t\tif (shouldDisableKittyProtocol) {\n\t\t\tthis.output.write(\"\\x1b[<u\");\n\t\t\tthis.keyboardProtocolPushed = false;\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tthis.output.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\t// Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being\n\t\t// re-interpreted after raw mode is disabled. This fixes a race condition\n\t\t// where Ctrl+D could close the parent shell over SSH.\n\t\tprocess.stdin.pause();\n\n\t\t// Restore raw mode state\n\t\tif (process.stdin.setRawMode) {\n\t\t\tprocess.stdin.setRawMode(this.wasRaw);\n\t\t}\n\t\tthis.output.stop();\n\t}\n\n\twrite(data: string): void {\n\t\tthis.output.write(data, true);\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\tthis.output.write(`\\x1b[${lines}B`);\n\t\t} else if (lines < 0) {\n\t\t\tthis.output.write(`\\x1b[${-lines}A`);\n\t\t}\n\t}\n\n\thideCursor(): void {\n\t\tthis.output.write(\"\\x1b[?25l\");\n\t}\n\n\tshowCursor(): void {\n\t\tthis.output.write(\"\\x1b[?25h\");\n\t}\n\n\tclearLine(): void {\n\t\tthis.output.write(\"\\x1b[K\");\n\t}\n\n\tclearFromCursor(): void {\n\t\tthis.output.write(\"\\x1b[J\");\n\t}\n\n\tclearScreen(): void {\n\t\tthis.output.write(\"\\x1b[2J\\x1b[H\"); // Clear screen and move to home (1,1)\n\t}\n\n\tsetTitle(title: string): void {\n\t\tthis.output.write(`\\x1b]0;${title}\\x07`);\n\t}\n\n\tsetProgress(active: boolean): void {\n\t\tif (active) {\n\t\t\tthis.output.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);\n\t\t\tif (!this.progressInterval) {\n\t\t\t\tthis.progressInterval = setInterval(() => {\n\t\t\t\t\tthis.output.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\tthis.output.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"]}
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport type { Writable } from \"node:stream\";\nimport { fileURLToPath } from \"node:url\";\nimport { setKittyProtocolActive } from \"./keys.ts\";\nimport { isNativeModifierPressed } from \"./native-modifiers.ts\";\nimport { StdinBuffer } from \"./stdin-buffer.ts\";\nimport { TerminalOutput, type TerminalOutputStats } from \"./terminal-output.ts\";\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\";\nconst APPLE_TERMINAL_SHIFT_ENTER_SEQUENCE = \"\\x1b[13;2u\";\nconst DESIRED_KITTY_KEYBOARD_PROTOCOL_FLAGS = 7;\nconst KITTY_KEYBOARD_PROTOCOL_FALLBACK_TIMEOUT_MS = 150;\nconst KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS = 150;\nconst KITTY_KEYBOARD_PROTOCOL_QUERY = `\\x1b[>${DESIRED_KITTY_KEYBOARD_PROTOCOL_FLAGS}u\\x1b[?u\\x1b[c`;\n\nexport type KeyboardProtocolNegotiationSequence =\n\t| { type: \"kitty-flags\"; flags: number }\n\t| { type: \"device-attributes\" };\n\nexport function parseKeyboardProtocolNegotiationSequence(\n\tsequence: string,\n): KeyboardProtocolNegotiationSequence | undefined {\n\tconst kittyFlags = sequence.match(/^\\x1b\\[\\?(\\d+)u$/);\n\tif (kittyFlags) {\n\t\treturn { type: \"kitty-flags\", flags: Number.parseInt(kittyFlags[1]!, 10) };\n\t}\n\tif (/^\\x1b\\[\\?[\\d;]*c$/.test(sequence)) {\n\t\treturn { type: \"device-attributes\" };\n\t}\n\treturn undefined;\n}\n\nfunction isKeyboardProtocolNegotiationSequencePrefix(sequence: string, allowBareEscapePrefix: boolean): boolean {\n\treturn (allowBareEscapePrefix && sequence === \"\\x1b\") || sequence === \"\\x1b[\" || /^\\x1b\\[\\?[\\d;]*$/.test(sequence);\n}\n\nexport function isAppleTerminalSession(): boolean {\n\treturn process.platform === \"darwin\" && process.env.TERM_PROGRAM === \"Apple_Terminal\";\n}\n\nexport function normalizeAppleTerminalInput(data: string, isAppleTerminal: boolean, isShiftPressed: boolean): string {\n\tif (isAppleTerminal && data === \"\\r\" && isShiftPressed) return APPLE_TERMINAL_SHIFT_ENTER_SEQUENCE;\n\treturn data;\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(): 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\t/** Optional metadata-only output observations; unsupported terminals omit this. */\n\tgetOutputStats?(): TerminalOutputStats;\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// 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\n/**\n * Real terminal using process.stdin/stdout\n */\nexport class ProcessTerminal implements Terminal {\n\tprivate wasRaw = false;\n\tprivate inputHandler?: (data: string) => void;\n\tprivate resizeHandler?: () => void;\n\tprivate _kittyProtocolActive = false;\n\tprivate _modifyOtherKeysActive = false;\n\tprivate keyboardProtocolPushed = false;\n\tprivate keyboardProtocolNegotiationPending = false;\n\tprivate keyboardProtocolLateResponsePending = false;\n\tprivate keyboardProtocolNegotiationBuffer = \"\";\n\tprivate keyboardProtocolFallbackTimer?: ReturnType<typeof setTimeout>;\n\tprivate keyboardProtocolBufferFlushTimer?: ReturnType<typeof setTimeout>;\n\tprivate stdinBuffer?: StdinBuffer;\n\tprivate stdinDataHandler?: (data: string) => void;\n\tprivate progressInterval?: ReturnType<typeof setInterval>;\n\tprivate readonly output: TerminalOutput;\n\n\tconstructor(output: Writable = process.stdout) {\n\t\tthis.output = new TerminalOutput(output, process.env.OMK_TUI_WRITE_LOG || \"\");\n\t}\n\n\tgetOutputStats(): TerminalOutputStats {\n\t\treturn this.output.snapshot();\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.inputHandler = onInput;\n\t\tthis.resizeHandler = this.output.withResizeLog(onResize, () => ({ cols: this.columns, rows: this.rows }));\n\n\t\t// Save previous state and enable raw mode\n\t\tthis.wasRaw = 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\tthis.output.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// Forward individual sequences to the input handler\n\t\tthis.stdinBuffer.on(\"data\", (sequence) => {\n\t\t\tif (this.keyboardProtocolNegotiationPending) {\n\t\t\t\tconst negotiationSequence = this.readKeyboardProtocolNegotiationSequence(sequence, true);\n\t\t\t\tif (negotiationSequence === \"pending\") {\n\t\t\t\t\treturn; // Wait for the rest of a split negotiation response.\n\t\t\t\t}\n\t\t\t\tif (this.handleKeyboardProtocolNegotiationSequence(negotiationSequence)) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (this.keyboardProtocolLateResponsePending) {\n\t\t\t\tconst negotiationSequence = this.readKeyboardProtocolNegotiationSequence(sequence, false);\n\t\t\t\tif (negotiationSequence === \"pending\") {\n\t\t\t\t\tthis.scheduleKeyboardProtocolNegotiationBufferFlush();\n\t\t\t\t\treturn; // Wait for the rest of a split late negotiation response.\n\t\t\t\t}\n\t\t\t\tif (this.handleKeyboardProtocolNegotiationSequence(negotiationSequence)) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthis.forwardInputSequence(sequence);\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 it if available.\n\t *\n\t * Kitty's progressive enhancement detection requires requesting the desired\n\t * flags before querying them. The trailing DA query is a sentinel supported by\n\t * terminals that do not know Kitty keyboard protocol. A short timeout remains\n\t * as a backup for terminals, PTYs, and SSH sessions that delay, split, or drop\n\t * the DA response.\n\t *\n\t * The requested flags are:\n\t * - 1 = disambiguate escape codes\n\t * - 2 = report event types (press/repeat/release)\n\t * - 4 = report alternate keys (shifted key, base layout key)\n\t */\n\tprivate queryAndEnableKittyProtocol(): void {\n\t\tthis.setupStdinBuffer();\n\t\tprocess.stdin.on(\"data\", this.stdinDataHandler!);\n\t\tthis.keyboardProtocolPushed = true;\n\t\tthis.keyboardProtocolNegotiationPending = true;\n\t\tthis.keyboardProtocolLateResponsePending = false;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.output.write(KITTY_KEYBOARD_PROTOCOL_QUERY);\n\t\tthis.keyboardProtocolFallbackTimer = setTimeout(() => {\n\t\t\tthis.keyboardProtocolFallbackTimer = undefined;\n\t\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\t\tthis.keyboardProtocolLateResponsePending = true;\n\t\t\tif (this.keyboardProtocolNegotiationBuffer === \"\\x1b\") {\n\t\t\t\tthis.flushKeyboardProtocolNegotiationBufferAsInput();\n\t\t\t} else {\n\t\t\t\tthis.scheduleKeyboardProtocolNegotiationBufferFlush();\n\t\t\t}\n\t\t\tthis.enableModifyOtherKeys();\n\t\t}, KITTY_KEYBOARD_PROTOCOL_FALLBACK_TIMEOUT_MS);\n\t}\n\n\tprivate handleKeyboardProtocolNegotiationSequence(\n\t\tnegotiationSequence: KeyboardProtocolNegotiationSequence | undefined,\n\t): boolean {\n\t\tif (!negotiationSequence) return false;\n\t\tif (negotiationSequence.type === \"kitty-flags\") {\n\t\t\tif (negotiationSequence.flags !== 0 && !this._kittyProtocolActive) {\n\t\t\t\tthis._kittyProtocolActive = true;\n\t\t\t\tsetKittyProtocolActive(true);\n\t\t\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\t\t\tthis.keyboardProtocolLateResponsePending = true;\n\t\t\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\t\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\n\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\tthis.keyboardProtocolLateResponsePending = true;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\tthis.enableModifyOtherKeys();\n\t\treturn true;\n\t}\n\n\tprivate readKeyboardProtocolNegotiationSequence(\n\t\tsequence: string,\n\t\tallowBareEscapePrefix: boolean,\n\t): KeyboardProtocolNegotiationSequence | \"pending\" | undefined {\n\t\tif (this.keyboardProtocolNegotiationBuffer) {\n\t\t\tconst bufferedSequence = this.keyboardProtocolNegotiationBuffer + sequence;\n\t\t\tconst negotiationSequence = parseKeyboardProtocolNegotiationSequence(bufferedSequence);\n\t\t\tif (negotiationSequence) {\n\t\t\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\t\t\treturn negotiationSequence;\n\t\t\t}\n\t\t\tif (isKeyboardProtocolNegotiationSequencePrefix(bufferedSequence, allowBareEscapePrefix)) {\n\t\t\t\tthis.setKeyboardProtocolNegotiationBuffer(bufferedSequence);\n\t\t\t\treturn \"pending\";\n\t\t\t}\n\t\t\tthis.flushKeyboardProtocolNegotiationBufferAsInput();\n\t\t}\n\n\t\tconst negotiationSequence = parseKeyboardProtocolNegotiationSequence(sequence);\n\t\tif (negotiationSequence) return negotiationSequence;\n\t\tif (isKeyboardProtocolNegotiationSequencePrefix(sequence, allowBareEscapePrefix)) {\n\t\t\tthis.setKeyboardProtocolNegotiationBuffer(sequence);\n\t\t\treturn \"pending\";\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate setKeyboardProtocolNegotiationBuffer(sequence: string): void {\n\t\tthis.clearKeyboardProtocolNegotiationBufferFlushTimer();\n\t\tthis.keyboardProtocolNegotiationBuffer = sequence;\n\t}\n\n\tprivate clearKeyboardProtocolNegotiationBuffer(): void {\n\t\tthis.clearKeyboardProtocolNegotiationBufferFlushTimer();\n\t\tthis.keyboardProtocolNegotiationBuffer = \"\";\n\t}\n\n\tprivate flushKeyboardProtocolNegotiationBufferAsInput(): void {\n\t\tif (!this.keyboardProtocolNegotiationBuffer) return;\n\t\tconst sequence = this.keyboardProtocolNegotiationBuffer;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.forwardInputSequence(sequence);\n\t}\n\n\tprivate scheduleKeyboardProtocolNegotiationBufferFlush(): void {\n\t\tif (!this.keyboardProtocolNegotiationBuffer || this.keyboardProtocolBufferFlushTimer) return;\n\t\tthis.keyboardProtocolBufferFlushTimer = setTimeout(() => {\n\t\t\tthis.keyboardProtocolBufferFlushTimer = undefined;\n\t\t\tthis.flushKeyboardProtocolNegotiationBufferAsInput();\n\t\t}, KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS);\n\t}\n\n\tprivate clearKeyboardProtocolNegotiationBufferFlushTimer(): void {\n\t\tif (!this.keyboardProtocolBufferFlushTimer) return;\n\t\tclearTimeout(this.keyboardProtocolBufferFlushTimer);\n\t\tthis.keyboardProtocolBufferFlushTimer = undefined;\n\t}\n\n\tprivate forwardInputSequence(sequence: string): void {\n\t\tif (!this.inputHandler) return;\n\t\tconst isAppleTerminal = sequence === \"\\r\" && isAppleTerminalSession();\n\t\tconst input = normalizeAppleTerminalInput(\n\t\t\tsequence,\n\t\t\tisAppleTerminal,\n\t\t\tisAppleTerminal && isNativeModifierPressed(\"shift\"),\n\t\t);\n\t\tthis.inputHandler(input);\n\t}\n\n\tprivate enableModifyOtherKeys(): void {\n\t\tif (this._kittyProtocolActive || this._modifyOtherKeysActive) return;\n\t\tthis.output.write(\"\\x1b[>4;2m\");\n\t\tthis._modifyOtherKeysActive = true;\n\t}\n\n\tprivate clearKeyboardProtocolFallbackTimer(): void {\n\t\tif (!this.keyboardProtocolFallbackTimer) return;\n\t\tclearTimeout(this.keyboardProtocolFallbackTimer);\n\t\tthis.keyboardProtocolFallbackTimer = undefined;\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\tconst arch = process.arch;\n\t\t\tif (arch !== \"x64\" && arch !== \"arm64\") return;\n\n\t\t\t// Dynamic require so non-Windows and bundled/browser paths never load the\n\t\t\t// native helper. In the npm package native/ is next to dist/; in compiled\n\t\t\t// binary archives native/ is copied next to the executable.\n\t\t\tconst moduleDir = path.dirname(fileURLToPath(import.meta.url));\n\t\t\tconst nativePath = path.join(\"native\", \"win32\", \"prebuilds\", `win32-${arch}`, \"win32-console-mode.node\");\n\t\t\tconst candidates = [\n\t\t\t\tpath.join(moduleDir, \"..\", nativePath),\n\t\t\t\tpath.join(moduleDir, nativePath),\n\t\t\t\tpath.join(path.dirname(process.execPath), nativePath),\n\t\t\t];\n\t\t\tfor (const modulePath of candidates) {\n\t\t\t\ttry {\n\t\t\t\t\tconst helper = cjsRequire(modulePath) as { enableVirtualTerminalInput?: () => boolean };\n\t\t\t\t\thelper.enableVirtualTerminalInput?.();\n\t\t\t\t\treturn;\n\t\t\t\t} catch {\n\t\t\t\t\t// Try the next possible packaging location.\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {\n\t\t\t// Native helper 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\tconst shouldDisableKittyProtocol =\n\t\t\tthis.keyboardProtocolPushed || this._kittyProtocolActive || this.keyboardProtocolNegotiationPending;\n\t\tthis.keyboardProtocolLateResponsePending = false;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\t\tif (shouldDisableKittyProtocol) {\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\tthis.output.write(\"\\x1b[<u\");\n\t\t\tthis.keyboardProtocolPushed = false;\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tthis.output.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(): void {\n\t\tif (this.clearProgressInterval()) {\n\t\t\tthis.output.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);\n\t\t}\n\n\t\t// Disable bracketed paste mode\n\t\tthis.output.write(\"\\x1b[?2004l\");\n\n\t\tconst shouldDisableKittyProtocol =\n\t\t\tthis.keyboardProtocolPushed || this._kittyProtocolActive || this.keyboardProtocolNegotiationPending;\n\t\tthis.keyboardProtocolLateResponsePending = false;\n\t\tthis.clearKeyboardProtocolNegotiationBuffer();\n\t\tthis.clearKeyboardProtocolFallbackTimer();\n\n\t\t// Disable Kitty keyboard protocol if not already done by drainInput()\n\t\tif (shouldDisableKittyProtocol) {\n\t\t\tthis.output.write(\"\\x1b[<u\");\n\t\t\tthis.keyboardProtocolPushed = false;\n\t\t\tthis._kittyProtocolActive = false;\n\t\t\tsetKittyProtocolActive(false);\n\t\t}\n\t\tthis.keyboardProtocolNegotiationPending = false;\n\t\tif (this._modifyOtherKeysActive) {\n\t\t\tthis.output.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\t// Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being\n\t\t// re-interpreted after raw mode is disabled. This fixes a race condition\n\t\t// where Ctrl+D could close the parent shell over SSH.\n\t\tprocess.stdin.pause();\n\n\t\t// Restore raw mode state\n\t\tif (process.stdin.setRawMode) {\n\t\t\tprocess.stdin.setRawMode(this.wasRaw);\n\t\t}\n\t\tthis.output.stop();\n\t}\n\n\twrite(data: string): void {\n\t\tthis.output.write(data, true);\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\tthis.output.write(`\\x1b[${lines}B`);\n\t\t} else if (lines < 0) {\n\t\t\tthis.output.write(`\\x1b[${-lines}A`);\n\t\t}\n\t}\n\n\thideCursor(): void {\n\t\tthis.output.write(\"\\x1b[?25l\");\n\t}\n\n\tshowCursor(): void {\n\t\tthis.output.write(\"\\x1b[?25h\");\n\t}\n\n\tclearLine(): void {\n\t\tthis.output.write(\"\\x1b[K\");\n\t}\n\n\tclearFromCursor(): void {\n\t\tthis.output.write(\"\\x1b[J\");\n\t}\n\n\tclearScreen(): void {\n\t\tthis.output.write(\"\\x1b[2J\\x1b[H\"); // Clear screen and move to home (1,1)\n\t}\n\n\tsetTitle(title: string): void {\n\t\tthis.output.write(`\\x1b]0;${title}\\x07`);\n\t}\n\n\tsetProgress(active: boolean): void {\n\t\tif (active) {\n\t\t\tthis.output.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);\n\t\t\tif (!this.progressInterval) {\n\t\t\t\tthis.progressInterval = setInterval(() => {\n\t\t\t\t\tthis.output.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\tthis.output.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

@@ -65,7 +65,7 @@ export class ProcessTerminal {
     }
     start(onInput, onResize) {
         this.inputHandler = onInput;
-        this.resizeHandler = onResize;
+        this.resizeHandler = this.output.withResizeLog(onResize, () => ({ cols: this.columns, rows: this.rows }));
         // Save previous state and enable raw mode
         this.wasRaw = process.stdin.isRaw || false;
         if (process.stdin.setRawMode) {