omk-tui 1.3.1 → 1.4.0

package/dist/line-reset-memo.js

@@ -0,0 +1,101 @@
+import { isImageLine } from "./terminal-image.js";
+import { normalizeTerminalOutput } from "./utils.js";
+/** Reset SGR and close any open OSC 8 hyperlink at segment boundaries. */
+export const SEGMENT_RESET = "\x1b[0m\x1b]8;;\x07";
+const KITTY_SEQUENCE_PREFIX = "\x1b_G";
+const NO_IDS = [];
+export function extractKittyImageIds(line) {
+    const sequenceStart = line.indexOf(KITTY_SEQUENCE_PREFIX);
+    if (sequenceStart === -1)
+        return NO_IDS;
+    const paramsStart = sequenceStart + KITTY_SEQUENCE_PREFIX.length;
+    const paramsEnd = line.indexOf(";", paramsStart);
+    if (paramsEnd === -1)
+        return NO_IDS;
+    const params = line.slice(paramsStart, paramsEnd);
+    for (const param of params.split(",")) {
+        const [key, value] = param.split("=", 2);
+        if (key !== "i" || value === undefined)
+            continue;
+        const id = Number(value);
+        if (Number.isInteger(id) && id > 0 && id <= 0xffffffff) {
+            return [id];
+        }
+    }
+    return NO_IDS;
+}
+/**
+ * Per-row memo for line resets (normalization + SEGMENT_RESET) and Kitty image IDs.
+ *
+ * A row reuses the previous frame's output when its raw text equals the previous
+ * raw row at the same index, or at the same distance from the end. The second
+ * candidate covers a block of rows inserted or removed above (an off-screen
+ * message growing by a line shifts every row below it), so one early change no
+ * longer re-normalizes the whole transcript. Output depends only on the raw
+ * text, so reuse on equal text is always exact. Unchanged component caches
+ * usually compare by reference, keeping the renderer's diff on the cheap path.
+ */
+export class LineResetMemo {
+    raw = [];
+    out = [];
+    /** Per-row Kitty IDs, or null when no row of the frame carries any (the common case). */
+    ids = null;
+    /** Raw buffer from two frames ago, refilled instead of reallocated. */
+    spareRaw = [];
+    /** Kitty image IDs present in the most recent `apply` result. */
+    kittyImageIds = new Set();
+    /** Normalizes `lines` in place (image lines untouched) and returns it. */
+    apply(lines) {
+        const count = lines.length;
+        const raw = this.spareRaw;
+        raw.length = count;
+        const previousRaw = this.raw;
+        const previousOut = this.out;
+        const previousIds = this.ids;
+        const previousLength = previousRaw.length;
+        const shift = previousLength - count;
+        let ids = null;
+        for (let i = 0; i < count; i++) {
+            const line = lines[i];
+            raw[i] = line;
+            let from = -1;
+            if (i < previousLength && previousRaw[i] === line) {
+                from = i;
+            }
+            else if (shift !== 0) {
+                const aligned = i + shift;
+                if (aligned >= 0 && aligned < previousLength && previousRaw[aligned] === line)
+                    from = aligned;
+            }
+            let rowIds;
+            if (from !== -1) {
+                lines[i] = previousOut[from];
+                if (previousIds === null)
+                    continue;
+                rowIds = previousIds[from];
+            }
+            else {
+                const output = isImageLine(line) ? line : normalizeTerminalOutput(line) + SEGMENT_RESET;
+                lines[i] = output;
+                rowIds = extractKittyImageIds(output);
+            }
+            if (rowIds.length > 0) {
+                ids ??= new Array(count).fill(NO_IDS);
+                ids[i] = rowIds;
+            }
+        }
+        const kittyImageIds = new Set();
+        if (ids !== null) {
+            for (const rowIds of ids)
+                for (const id of rowIds)
+                    kittyImageIds.add(id);
+        }
+        this.spareRaw = previousRaw;
+        this.raw = raw;
+        this.out = lines;
+        this.ids = ids;
+        this.kittyImageIds = kittyImageIds;
+        return lines;
+    }
+}
+//# sourceMappingURL=line-reset-memo.js.map

package/dist/line-reset-memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-reset-memo.js","sourceRoot":"","sources":["../src/line-reset-memo.ts"],"names":[],"mappings":"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","sourcesContent":["import { isImageLine } from \"./terminal-image.ts\";\nimport { normalizeTerminalOutput } from \"./utils.ts\";\n\n/** Reset SGR and close any open OSC 8 hyperlink at segment boundaries. */\nexport const SEGMENT_RESET = \"\\x1b[0m\\x1b]8;;\\x07\";\n\nconst KITTY_SEQUENCE_PREFIX = \"\\x1b_G\";\nconst NO_IDS: readonly number[] = [];\n\nexport function extractKittyImageIds(line: string): readonly number[] {\n\tconst sequenceStart = line.indexOf(KITTY_SEQUENCE_PREFIX);\n\tif (sequenceStart === -1) return NO_IDS;\n\n\tconst paramsStart = sequenceStart + KITTY_SEQUENCE_PREFIX.length;\n\tconst paramsEnd = line.indexOf(\";\", paramsStart);\n\tif (paramsEnd === -1) return NO_IDS;\n\n\tconst params = line.slice(paramsStart, paramsEnd);\n\tfor (const param of params.split(\",\")) {\n\t\tconst [key, value] = param.split(\"=\", 2);\n\t\tif (key !== \"i\" || value === undefined) continue;\n\t\tconst id = Number(value);\n\t\tif (Number.isInteger(id) && id > 0 && id <= 0xffffffff) {\n\t\t\treturn [id];\n\t\t}\n\t}\n\treturn NO_IDS;\n}\n\n/**\n * Per-row memo for line resets (normalization + SEGMENT_RESET) and Kitty image IDs.\n *\n * A row reuses the previous frame's output when its raw text equals the previous\n * raw row at the same index, or at the same distance from the end. The second\n * candidate covers a block of rows inserted or removed above (an off-screen\n * message growing by a line shifts every row below it), so one early change no\n * longer re-normalizes the whole transcript. Output depends only on the raw\n * text, so reuse on equal text is always exact. Unchanged component caches\n * usually compare by reference, keeping the renderer's diff on the cheap path.\n */\nexport class LineResetMemo {\n\tprivate raw: string[] = [];\n\tprivate out: string[] = [];\n\t/** Per-row Kitty IDs, or null when no row of the frame carries any (the common case). */\n\tprivate ids: (readonly number[])[] | null = null;\n\t/** Raw buffer from two frames ago, refilled instead of reallocated. */\n\tprivate spareRaw: string[] = [];\n\t/** Kitty image IDs present in the most recent `apply` result. */\n\tkittyImageIds = new Set<number>();\n\n\t/** Normalizes `lines` in place (image lines untouched) and returns it. */\n\tapply(lines: string[]): string[] {\n\t\tconst count = lines.length;\n\t\tconst raw = this.spareRaw;\n\t\traw.length = count;\n\t\tconst previousRaw = this.raw;\n\t\tconst previousOut = this.out;\n\t\tconst previousIds = this.ids;\n\t\tconst previousLength = previousRaw.length;\n\t\tconst shift = previousLength - count;\n\t\tlet ids: (readonly number[])[] | null = null;\n\t\tfor (let i = 0; i < count; i++) {\n\t\t\tconst line = lines[i];\n\t\t\traw[i] = line;\n\t\t\tlet from = -1;\n\t\t\tif (i < previousLength && previousRaw[i] === line) {\n\t\t\t\tfrom = i;\n\t\t\t} else if (shift !== 0) {\n\t\t\t\tconst aligned = i + shift;\n\t\t\t\tif (aligned >= 0 && aligned < previousLength && previousRaw[aligned] === line) from = aligned;\n\t\t\t}\n\t\t\tlet rowIds: readonly number[];\n\t\t\tif (from !== -1) {\n\t\t\t\tlines[i] = previousOut[from];\n\t\t\t\tif (previousIds === null) continue;\n\t\t\t\trowIds = previousIds[from];\n\t\t\t} else {\n\t\t\t\tconst output = isImageLine(line) ? line : normalizeTerminalOutput(line) + SEGMENT_RESET;\n\t\t\t\tlines[i] = output;\n\t\t\t\trowIds = extractKittyImageIds(output);\n\t\t\t}\n\t\t\tif (rowIds.length > 0) {\n\t\t\t\tids ??= new Array<readonly number[]>(count).fill(NO_IDS);\n\t\t\t\tids[i] = rowIds;\n\t\t\t}\n\t\t}\n\t\tconst kittyImageIds = new Set<number>();\n\t\tif (ids !== null) {\n\t\t\tfor (const rowIds of ids) for (const id of rowIds) kittyImageIds.add(id);\n\t\t}\n\t\tthis.spareRaw = previousRaw;\n\t\tthis.raw = raw;\n\t\tthis.out = lines;\n\t\tthis.ids = ids;\n\t\tthis.kittyImageIds = kittyImageIds;\n\t\treturn lines;\n\t}\n}\n"]}

package/dist/render-generation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Structural stand-in for tui.ts `Component` (importing it, even as a type,
+ * would put this module in an import cycle with tui.ts).
+ */
+interface Component {
+    render(width: number): string[];
+}
+export declare function nextRenderGeneration(): number;
+/** Missing hook ⇒ settled (plain components keep freeze-eligible behavior). */
+export declare function isRenderSettled(component: Component): boolean;
+/** Missing hook ⇒ 0 (component is treated as immutable once rendered). */
+export declare function renderGeneration(component: Component): number;
+/** Max generation over `own` and every child (children without hooks count as 0). */
+export declare function maxChildGeneration(own: number, children: readonly Component[]): number;
+/**
+ * Drop render caches of a frozen (off-screen) component without changing its
+ * render generation. Opt-in only: a component releases exactly what its own
+ * `releaseRenderCache()` drops (Container and Box forward to their children).
+ * Components without the hook are left untouched; fields are never cleared by
+ * name, because a third-party field called `cache` may not be a render cache.
+ */
+export declare function releaseRenderCache(component: Component): void;
+export {};
+//# sourceMappingURL=render-generation.d.ts.map

package/dist/render-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-generation.d.ts","sourceRoot":"","sources":["../src/render-generation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,UAAU,SAAS;IAClB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAChC;AAcD,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAOD,iFAA+E;AAC/E,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAG7D;AAED,4EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAG7D;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAOtF;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAG7D","sourcesContent":["/**\n * Structural stand-in for tui.ts `Component` (importing it, even as a type,\n * would put this module in an import cycle with tui.ts).\n */\ninterface Component {\n\trender(width: number): string[];\n}\n\n/**\n * Process-wide render generation counter.\n *\n * Mutable TUI primitives stamp `nextRenderGeneration()` on every visible\n * change, and containers report the max stamp of themselves and their\n * children. Because stamps only ever increase, any change anywhere in a\n * subtree strictly raises that subtree's generation — removing a child, then\n * adding another, can never land back on a previously observed value. Off-\n * screen windowing compares these numbers instead of object identity.\n */\nlet renderGenerationCounter = 0;\n\nexport function nextRenderGeneration(): number {\n\trenderGenerationCounter += 1;\n\treturn renderGenerationCounter;\n}\n\ntype LifecycleNode = Component & {\n\tisRenderSettled?: () => boolean;\n\tgetRenderGeneration?: () => number;\n};\n\n/** Missing hook ⇒ settled (plain components keep freeze-eligible behavior). */\nexport function isRenderSettled(component: Component): boolean {\n\tconst node = component as LifecycleNode;\n\treturn typeof node.isRenderSettled === \"function\" ? node.isRenderSettled() : true;\n}\n\n/** Missing hook ⇒ 0 (component is treated as immutable once rendered). */\nexport function renderGeneration(component: Component): number {\n\tconst node = component as LifecycleNode;\n\treturn typeof node.getRenderGeneration === \"function\" ? node.getRenderGeneration() : 0;\n}\n\n/** Max generation over `own` and every child (children without hooks count as 0). */\nexport function maxChildGeneration(own: number, children: readonly Component[]): number {\n\tlet max = own;\n\tfor (const child of children) {\n\t\tconst generation = renderGeneration(child);\n\t\tif (generation > max) max = generation;\n\t}\n\treturn max;\n}\n\ntype CacheNode = Component & { releaseRenderCache?: () => void };\n\n/**\n * Drop render caches of a frozen (off-screen) component without changing its\n * render generation. Opt-in only: a component releases exactly what its own\n * `releaseRenderCache()` drops (Container and Box forward to their children).\n * Components without the hook are left untouched; fields are never cleared by\n * name, because a third-party field called `cache` may not be a render cache.\n */\nexport function releaseRenderCache(component: Component): void {\n\tconst node = component as CacheNode;\n\tif (typeof node.releaseRenderCache === \"function\") node.releaseRenderCache();\n}\n"]}

package/dist/render-generation.js

@@ -0,0 +1,48 @@
+/**
+ * Process-wide render generation counter.
+ *
+ * Mutable TUI primitives stamp `nextRenderGeneration()` on every visible
+ * change, and containers report the max stamp of themselves and their
+ * children. Because stamps only ever increase, any change anywhere in a
+ * subtree strictly raises that subtree's generation — removing a child, then
+ * adding another, can never land back on a previously observed value. Off-
+ * screen windowing compares these numbers instead of object identity.
+ */
+let renderGenerationCounter = 0;
+export function nextRenderGeneration() {
+    renderGenerationCounter += 1;
+    return renderGenerationCounter;
+}
+/** Missing hook ⇒ settled (plain components keep freeze-eligible behavior). */
+export function isRenderSettled(component) {
+    const node = component;
+    return typeof node.isRenderSettled === "function" ? node.isRenderSettled() : true;
+}
+/** Missing hook ⇒ 0 (component is treated as immutable once rendered). */
+export function renderGeneration(component) {
+    const node = component;
+    return typeof node.getRenderGeneration === "function" ? node.getRenderGeneration() : 0;
+}
+/** Max generation over `own` and every child (children without hooks count as 0). */
+export function maxChildGeneration(own, children) {
+    let max = own;
+    for (const child of children) {
+        const generation = renderGeneration(child);
+        if (generation > max)
+            max = generation;
+    }
+    return max;
+}
+/**
+ * Drop render caches of a frozen (off-screen) component without changing its
+ * render generation. Opt-in only: a component releases exactly what its own
+ * `releaseRenderCache()` drops (Container and Box forward to their children).
+ * Components without the hook are left untouched; fields are never cleared by
+ * name, because a third-party field called `cache` may not be a render cache.
+ */
+export function releaseRenderCache(component) {
+    const node = component;
+    if (typeof node.releaseRenderCache === "function")
+        node.releaseRenderCache();
+}
+//# sourceMappingURL=render-generation.js.map

package/dist/render-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-generation.js","sourceRoot":"","sources":["../src/render-generation.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,IAAI,uBAAuB,GAAG,CAAC,CAAC;AAEhC,MAAM,UAAU,oBAAoB,GAAW;IAC9C,uBAAuB,IAAI,CAAC,CAAC;IAC7B,OAAO,uBAAuB,CAAC;AAAA,CAC/B;AAOD,iFAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,SAAoB,EAAW;IAC9D,MAAM,IAAI,GAAG,SAA0B,CAAC;IACxC,OAAO,OAAO,IAAI,CAAC,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAAA,CAClF;AAED,4EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,SAAoB,EAAU;IAC9D,MAAM,IAAI,GAAG,SAA0B,CAAC;IACxC,OAAO,OAAO,IAAI,CAAC,mBAAmB,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAAA,CACvF;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,QAA8B,EAAU;IACvF,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,UAAU,GAAG,GAAG;YAAE,GAAG,GAAG,UAAU,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AAAA,CACX;AAID;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoB,EAAQ;IAC9D,MAAM,IAAI,GAAG,SAAsB,CAAC;IACpC,IAAI,OAAO,IAAI,CAAC,kBAAkB,KAAK,UAAU;QAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;AAAA,CAC7E","sourcesContent":["/**\n * Structural stand-in for tui.ts `Component` (importing it, even as a type,\n * would put this module in an import cycle with tui.ts).\n */\ninterface Component {\n\trender(width: number): string[];\n}\n\n/**\n * Process-wide render generation counter.\n *\n * Mutable TUI primitives stamp `nextRenderGeneration()` on every visible\n * change, and containers report the max stamp of themselves and their\n * children. Because stamps only ever increase, any change anywhere in a\n * subtree strictly raises that subtree's generation — removing a child, then\n * adding another, can never land back on a previously observed value. Off-\n * screen windowing compares these numbers instead of object identity.\n */\nlet renderGenerationCounter = 0;\n\nexport function nextRenderGeneration(): number {\n\trenderGenerationCounter += 1;\n\treturn renderGenerationCounter;\n}\n\ntype LifecycleNode = Component & {\n\tisRenderSettled?: () => boolean;\n\tgetRenderGeneration?: () => number;\n};\n\n/** Missing hook ⇒ settled (plain components keep freeze-eligible behavior). */\nexport function isRenderSettled(component: Component): boolean {\n\tconst node = component as LifecycleNode;\n\treturn typeof node.isRenderSettled === \"function\" ? node.isRenderSettled() : true;\n}\n\n/** Missing hook ⇒ 0 (component is treated as immutable once rendered). */\nexport function renderGeneration(component: Component): number {\n\tconst node = component as LifecycleNode;\n\treturn typeof node.getRenderGeneration === \"function\" ? node.getRenderGeneration() : 0;\n}\n\n/** Max generation over `own` and every child (children without hooks count as 0). */\nexport function maxChildGeneration(own: number, children: readonly Component[]): number {\n\tlet max = own;\n\tfor (const child of children) {\n\t\tconst generation = renderGeneration(child);\n\t\tif (generation > max) max = generation;\n\t}\n\treturn max;\n}\n\ntype CacheNode = Component & { releaseRenderCache?: () => void };\n\n/**\n * Drop render caches of a frozen (off-screen) component without changing its\n * render generation. Opt-in only: a component releases exactly what its own\n * `releaseRenderCache()` drops (Container and Box forward to their children).\n * Components without the hook are left untouched; fields are never cleared by\n * name, because a third-party field called `cache` may not be a render cache.\n */\nexport function releaseRenderCache(component: Component): void {\n\tconst node = component as CacheNode;\n\tif (typeof node.releaseRenderCache === \"function\") node.releaseRenderCache();\n}\n"]}

package/dist/terminal-output.d.ts

@@ -10,6 +10,13 @@ export interface TerminalOutputStats {
     readonly writableLength: number;
     readonly backpressured: boolean;
 }
+/**
+ * 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 declare function writeTerminalRaw(data: string): void;
 /** Metadata-only observation. No paint queue, retries, or interception of error handling. */
 export declare class TerminalOutput {
     private readonly stream;
@@ -18,7 +25,19 @@ export declare class TerminalOutput {
     private readonly counters;
     private readonly onDrain;
     private readonly onError;
-    constructor(stream: Writable, log?: string);
+    private readonly resizeLog;
+    constructor(stream: Writable, log?: string, resizeLog?: string);
+    private readonly finalLine;
+    private owesFinal;
+    /**
+     * 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: () => void, size: () => {
+        cols: number;
+        rows: number;
+    }): () => void;
     write(data: string, log?: boolean): void;
     snapshot(): TerminalOutputStats;
     stop(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"terminal-output.d.ts","sourceRoot":"","sources":["../src/terminal-output.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CAChC;AAgBD,6FAA6F;AAC7F,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAOvB;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,YAAY,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAK,EAGrC;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,IAAI,CAuBrC;IAED,QAAQ,IAAI,mBAAmB,CAM9B;IAED,IAAI,IAAI,IAAI,CAIX;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.d.ts","sourceRoot":"","sources":["../src/terminal-output.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CAChC;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGnD;AAUD,6FAA6F;AAC7F,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAOvB;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAE1D,YAAY,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAK,EAAE,SAAS,SAAuC,EAKvF;IAED,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6D;IAEvF,OAAO,CAAC,SAAS;IASjB;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,IAAI,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,IAAI,CAU1F;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,IAAI,CAyBrC;IAED,QAAQ,IAAI,mBAAmB,CAM9B;IAED,IAAI,IAAI,IAAI,CAOX;CACD","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-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":"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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\";\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":"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,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAc7D,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,sFAAsF;AACtF,IAAI,YAAwC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAQ;IACpD,IAAI,YAAY;QAAE,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAAA,CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAc,CAAC;AAC1C,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,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;IAEe,SAAS,CAAgC;IAE1D,YAAY,MAAgB,EAAE,GAAG,GAAG,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,EAAE;QACzF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAAA,CACrC;IAEgB,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAE/E,SAAS,GAAS;QACzB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;YAC1B,KAAK,MAAM,SAAS,IAAI,WAAW;gBAAE,SAAS,EAAE,CAAC;QAAA,CACjD,CAAC,CAAC;IAAA,CACH;IAED;;;;OAIG;IACH,aAAa,CAAC,QAAoB,EAAE,IAA0C,EAAc;QAC3F,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,OAAO,QAAQ,CAAC;QAC1B,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAClB,OAAO,GAAG,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACrF,IAAI,GAAG,IAAI,CAAC;YACZ,QAAQ,EAAE,CAAC;QAAA,CACX,CAAC;IAAA,CACF;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;YACtB,YAAY,GAAG,IAAI,CAAC;YACpB,IAAI,IAAI,CAAC,SAAS;gBAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,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,SAAS,EAAE,CAAC;QACjB,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,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;QACvB,IAAI,YAAY,KAAK,IAAI;YAAE,YAAY,GAAG,SAAS,CAAC;IAAA,CACpD;CACD","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"]}