@qduc/term2 0.7.3 → 0.8.0

package/dist/utils/output/output-trim.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-trim.test.js","sourceRoot":"","sources":["../../../source/utils/output/output-trim.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/synchronized-output.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Synchronized Output wrapper for terminal rendering.
+ *
+ * Wraps stdout.write() calls with DEC Mode 2026 escape sequences
+ * (\x1b[?2026h to begin, \x1b[?2026l to end) so that terminal
+ * emulators which support it (iTerm2, WezTerm, foot, etc.) will
+ * buffer the entire update and render it as a single atomic frame.
+ *
+ * This eliminates the flickering that occurs in iTerm2 because Ink's
+ * incremental renderer issues multiple ANSI cursor-movement + erase
+ * sequences per render cycle; without synchronized output the terminal
+ * may render intermediate states (partially erased content) between
+ * individual write() calls.
+ *
+ * Terminals that do NOT support mode 2026 will silently ignore the
+ * escape sequences, so this is safe to enable unconditionally.
+ *
+ * Reference: https://gist.github.com/christianparpart/d8a62cc1ab659194571cd32e76cfd588
+ */
+/**
+ * Check if the terminal likely supports synchronized output.
+ * iTerm2, WezTerm, foot, and many modern terminals support it.
+ * We enable it broadly since unsupported terminals just ignore the sequences.
+ */
+export declare function isSynchronizedOutputSupported(): boolean;
+/**
+ * Wraps a stdout write so the content is emitted inside a synchronized
+ * output block (DEC Mode 2026). The wrapper preserves the original
+ * `write()` signature and injects begin/end markers around each call.
+ *
+ * Usage:
+ *   patchStdoutForSynchronizedOutput(process.stdout);
+ */
+export declare function patchStdoutForSynchronizedOutput(stream: NodeJS.WriteStream): void;
+//# sourceMappingURL=synchronized-output.d.ts.map

package/dist/utils/output/synchronized-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronized-output.d.ts","sourceRoot":"","sources":["../../../source/utils/output/synchronized-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAgCjF"}

package/dist/utils/output/synchronized-output.js

@@ -0,0 +1,66 @@
+/**
+ * Synchronized Output wrapper for terminal rendering.
+ *
+ * Wraps stdout.write() calls with DEC Mode 2026 escape sequences
+ * (\x1b[?2026h to begin, \x1b[?2026l to end) so that terminal
+ * emulators which support it (iTerm2, WezTerm, foot, etc.) will
+ * buffer the entire update and render it as a single atomic frame.
+ *
+ * This eliminates the flickering that occurs in iTerm2 because Ink's
+ * incremental renderer issues multiple ANSI cursor-movement + erase
+ * sequences per render cycle; without synchronized output the terminal
+ * may render intermediate states (partially erased content) between
+ * individual write() calls.
+ *
+ * Terminals that do NOT support mode 2026 will silently ignore the
+ * escape sequences, so this is safe to enable unconditionally.
+ *
+ * Reference: https://gist.github.com/christianparpart/d8a62cc1ab659194571cd32e76cfd588
+ */
+const SYNC_START = '\x1b[?2026h';
+const SYNC_END = '\x1b[?2026l';
+/**
+ * Check if the terminal likely supports synchronized output.
+ * iTerm2, WezTerm, foot, and many modern terminals support it.
+ * We enable it broadly since unsupported terminals just ignore the sequences.
+ */
+export function isSynchronizedOutputSupported() {
+    // Always return true — unsupported terminals silently ignore mode 2026.
+    // This keeps the logic simple and avoids false negatives.
+    return true;
+}
+/**
+ * Wraps a stdout write so the content is emitted inside a synchronized
+ * output block (DEC Mode 2026). The wrapper preserves the original
+ * `write()` signature and injects begin/end markers around each call.
+ *
+ * Usage:
+ *   patchStdoutForSynchronizedOutput(process.stdout);
+ */
+export function patchStdoutForSynchronizedOutput(stream) {
+    if (!isSynchronizedOutputSupported()) {
+        return;
+    }
+    const originalWrite = stream.write.bind(stream);
+    // Track nesting to avoid double-wrapping when Ink's own clear/write
+    // sequences trigger multiple write calls synchronously.
+    let syncing = false;
+    stream.write = function (chunk, encodingOrCallback, callback) {
+        // Avoid double-wrapping and only wrap string data (ANSI sequences).
+        // Binary data or nested calls pass through unchanged.
+        if (syncing || typeof chunk !== 'string') {
+            return originalWrite(chunk, encodingOrCallback, callback);
+        }
+        syncing = true;
+        try {
+            // Prefix the payload with the sync-start marker and suffix with
+            // sync-end, all in a single write to minimise I/O calls.
+            const wrapped = SYNC_START + chunk + SYNC_END;
+            return originalWrite(wrapped, encodingOrCallback, callback);
+        }
+        finally {
+            syncing = false;
+        }
+    };
+}
+//# sourceMappingURL=synchronized-output.js.map

package/dist/utils/output/synchronized-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronized-output.js","sourceRoot":"","sources":["../../../source/utils/output/synchronized-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,UAAU,GAAG,aAAa,CAAC;AACjC,MAAM,QAAQ,GAAG,aAAa,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,wEAAwE;IACxE,0DAA0D;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAA0B;IACzE,IAAI,CAAC,6BAA6B,EAAE,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAwB,CAAC;IAEvE,oEAAoE;IACpE,wDAAwD;IACxD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,CAAC,KAAK,GAAG,UACb,KAAU,EACV,kBAAsE,EACtE,QAAyC;QAEzC,oEAAoE;QACpE,sDAAsD;QACtD,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,aAAa,CAAC,KAAK,EAAE,kBAAyB,EAAE,QAAQ,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC;YACH,gEAAgE;YAChE,yDAAyD;YACzD,MAAM,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;YAC9C,OAAO,aAAa,CAAC,OAAO,EAAE,kBAAyB,EAAE,QAAQ,CAAC,CAAC;QACrE,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAwB,CAAC;AAC3B,CAAC"}

package/dist/utils/output/synchronized-output.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=synchronized-output.test.d.ts.map

package/dist/utils/output/synchronized-output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronized-output.test.d.ts","sourceRoot":"","sources":["../../../source/utils/output/synchronized-output.test.ts"],"names":[],"mappings":""}

package/dist/utils/output/synchronized-output.test.js

@@ -0,0 +1,70 @@
+import { it, expect } from 'vitest';
+import { patchStdoutForSynchronizedOutput, isSynchronizedOutputSupported } from './synchronized-output.js';
+import { Writable } from 'stream';
+it('isSynchronizedOutputSupported returns true', () => {
+    expect(isSynchronizedOutputSupported()).toBe(true);
+});
+it('patchStdoutForSynchronizedOutput wraps string writes with sync markers', () => {
+    const chunks = [];
+    const fakeStream = new Writable({
+        write(chunk, _encoding, callback) {
+            chunks.push(chunk.toString());
+            callback();
+        },
+    });
+    // Add columns property to mimic a WriteStream
+    fakeStream.columns = 80;
+    patchStdoutForSynchronizedOutput(fakeStream);
+    fakeStream.write('hello');
+    expect(chunks.length).toBe(1);
+    expect(chunks[0]).toBe('\x1b[?2026hhello\x1b[?2026l');
+});
+it('patchStdoutForSynchronizedOutput passes through non-string writes', () => {
+    const chunks = [];
+    const fakeStream = new Writable({
+        write(chunk, _encoding, callback) {
+            chunks.push(Buffer.from(chunk));
+            callback();
+        },
+    });
+    fakeStream.columns = 80;
+    patchStdoutForSynchronizedOutput(fakeStream);
+    const buf = Buffer.from([0x01, 0x02, 0x03]);
+    fakeStream.write(buf);
+    expect(chunks.length).toBe(1);
+    // Buffer writes should NOT be wrapped with sync markers
+    expect(chunks[0]).toEqual(buf);
+});
+it('patchStdoutForSynchronizedOutput handles nested writes without double-wrapping', () => {
+    const chunks = [];
+    let writeImpl;
+    const fakeStream = {
+        columns: 80,
+        write(chunk, encoding, callback) {
+            return writeImpl(chunk, encoding, callback);
+        },
+    };
+    writeImpl = (chunk, _encoding, _callback) => {
+        chunks.push(typeof chunk === 'string' ? chunk : chunk.toString());
+        return true;
+    };
+    patchStdoutForSynchronizedOutput(fakeStream);
+    // Save the patched write
+    const patchedWrite = fakeStream.write;
+    // Simulate a nested write (e.g., Ink calling clear then write in sequence)
+    writeImpl = (chunk, _encoding, _callback) => {
+        chunks.push(typeof chunk === 'string' ? chunk : chunk.toString());
+        // Simulate a nested write during the original write
+        if (chunks.length === 1) {
+            patchedWrite.call(fakeStream, 'nested');
+        }
+        return true;
+    };
+    fakeStream.write('outer');
+    // The outer write should be wrapped, and the nested write should also be
+    // handled (not double-wrapped since syncing flag is set)
+    expect(chunks.some((c) => c.includes('\x1b[?2026h'))).toBe(true);
+    // Nested call should NOT contain sync markers (double-wrapping prevented)
+    expect(chunks[1]).toBe('nested');
+});
+//# sourceMappingURL=synchronized-output.test.js.map

package/dist/utils/output/synchronized-output.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronized-output.test.js","sourceRoot":"","sources":["../../../source/utils/output/synchronized-output.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/trim-tool-output.d.ts

@@ -0,0 +1,2 @@
+export declare const trimToolOutput: (output: unknown, maxLines?: number, maxCharacters?: number) => string;
+//# sourceMappingURL=trim-tool-output.d.ts.map

package/dist/utils/output/trim-tool-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-tool-output.d.ts","sourceRoot":"","sources":["../../../source/utils/output/trim-tool-output.ts"],"names":[],"mappings":"AAyCA,eAAO,MAAM,cAAc,GAAI,QAAQ,OAAO,EAAE,WAAW,MAAM,EAAE,gBAAgB,MAAM,KAAG,MAgB3F,CAAC"}

package/dist/utils/output/trim-tool-output.js

@@ -0,0 +1,52 @@
+import { trimOutput } from './output-trim.js';
+const tryParseJson = (value) => {
+    if (!value.trim()) {
+        return null;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+};
+const trimStringValue = (value, maxLines, maxCharacters) => {
+    if (!value) {
+        return value;
+    }
+    return trimOutput(value, maxLines, maxCharacters);
+};
+const trimJsonStrings = (value, maxLines, maxCharacters) => {
+    if (typeof value === 'string') {
+        return trimStringValue(value, maxLines, maxCharacters);
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => trimJsonStrings(entry, maxLines, maxCharacters));
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        const next = {};
+        for (const [key, entry] of Object.entries(record)) {
+            next[key] = trimJsonStrings(entry, maxLines, maxCharacters);
+        }
+        return next;
+    }
+    return value;
+};
+export const trimToolOutput = (output, maxLines, maxCharacters) => {
+    if (typeof output !== 'string') {
+        return String(output ?? '');
+    }
+    const parsed = tryParseJson(output);
+    if (parsed !== null) {
+        const trimmed = trimJsonStrings(parsed, maxLines, maxCharacters);
+        try {
+            return JSON.stringify(trimmed);
+        }
+        catch {
+            return trimStringValue(output, maxLines, maxCharacters);
+        }
+    }
+    return trimStringValue(output, maxLines, maxCharacters);
+};
+//# sourceMappingURL=trim-tool-output.js.map

package/dist/utils/output/trim-tool-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-tool-output.js","sourceRoot":"","sources":["../../../source/utils/output/trim-tool-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,YAAY,GAAG,CAAC,KAAa,EAAkB,EAAE;IACrD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,QAAiB,EAAE,aAAsB,EAAU,EAAE;IAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,QAAiB,EAAE,aAAsB,EAAW,EAAE;IAC7F,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAe,EAAE,QAAiB,EAAE,aAAsB,EAAU,EAAE;IACnG,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/utils/output/trim-tool-output.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trim-tool-output.test.d.ts.map

package/dist/utils/output/trim-tool-output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-tool-output.test.d.ts","sourceRoot":"","sources":["../../../source/utils/output/trim-tool-output.test.ts"],"names":[],"mappings":""}

package/dist/utils/output/trim-tool-output.test.js

@@ -0,0 +1,32 @@
+import { it, expect } from 'vitest';
+import { trimToolOutput } from './trim-tool-output.js';
+it('trimToolOutput trims plain string output by characters', () => {
+    const output = 'a'.repeat(200);
+    const result = trimToolOutput(output, undefined, 50);
+    expect(result.includes('characters trimmed')).toBe(true);
+    expect(result.length < output.length).toBe(true);
+});
+it('trimToolOutput trims string fields inside JSON output', () => {
+    const payload = JSON.stringify({
+        output: 'b'.repeat(200),
+        other: 'ok',
+    });
+    const result = trimToolOutput(payload, undefined, 50);
+    const parsed = JSON.parse(result);
+    expect(parsed.output.includes('characters trimmed')).toBe(true);
+    expect(parsed.other).toBe('ok');
+});
+it('trimToolOutput trims nested JSON output arrays', () => {
+    const payload = JSON.stringify({
+        output: [
+            {
+                success: true,
+                message: 'c'.repeat(200),
+            },
+        ],
+    });
+    const result = trimToolOutput(payload, undefined, 50);
+    const parsed = JSON.parse(result);
+    expect(parsed.output[0].message.includes('characters trimmed')).toBe(true);
+});
+//# sourceMappingURL=trim-tool-output.test.js.map

package/dist/utils/output/trim-tool-output.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-tool-output.test.js","sourceRoot":"","sources":["../../../source/utils/output/trim-tool-output.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAErD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QACvB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,MAAM,EAAE;YACN;gBACE,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;aACzB;SACF;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC,CAAC,CAAC"}

package/dist/utils/output/tty-osc.d.ts

@@ -0,0 +1,27 @@
+export type TtyWriter = (data: string) => void;
+/**
+ * Returns a function that writes a string to the terminal TTY.
+ * Prefers process.stdout when it is a TTY; falls back to opening /dev/tty
+ * directly so the sequence reaches the terminal even when stdout is redirected
+ * (e.g. through the synchronized-output patch or pipe).
+ */
+export declare function getTtyWriter(): TtyWriter | null;
+/**
+ * Wraps a raw OSC inner sequence for delivery through a terminal multiplexer
+ * (tmux or GNU screen). In a bare terminal the sequence is returned unchanged.
+ *
+ * - tmux: DCS passthrough — double every ESC in the inner sequence.
+ * - screen: DCS passthrough — chunk at 768 chars to stay within screen's
+ *   internal buffer limit.
+ */
+export declare function wrapForMultiplexer(inner: string, env: NodeJS.ProcessEnv): string;
+export interface WriteOscOptions {
+    env?: NodeJS.ProcessEnv;
+    getTtyWriter?: () => TtyWriter | null;
+}
+/**
+ * Wraps an OSC inner sequence for the current multiplexer (if any) and writes
+ * it to the TTY. Silently does nothing if no TTY is available.
+ */
+export declare function writeOscSequence(inner: string, opts?: WriteOscOptions): void;
+//# sourceMappingURL=tty-osc.d.ts.map

package/dist/utils/output/tty-osc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty-osc.d.ts","sourceRoot":"","sources":["../../../source/utils/output/tty-osc.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAoB/C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAkBhF;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,IAAI,CAMhF"}

package/dist/utils/output/tty-osc.js

@@ -0,0 +1,66 @@
+import fs from 'fs';
+/**
+ * Returns a function that writes a string to the terminal TTY.
+ * Prefers process.stdout when it is a TTY; falls back to opening /dev/tty
+ * directly so the sequence reaches the terminal even when stdout is redirected
+ * (e.g. through the synchronized-output patch or pipe).
+ */
+export function getTtyWriter() {
+    if (process.stdout.isTTY) {
+        return (data) => void process.stdout.write(data);
+    }
+    try {
+        const fd = fs.openSync('/dev/tty', 'w');
+        fs.closeSync(fd);
+        return (data) => {
+            const writeFd = fs.openSync('/dev/tty', 'w');
+            try {
+                fs.writeSync(writeFd, data);
+            }
+            finally {
+                fs.closeSync(writeFd);
+            }
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Wraps a raw OSC inner sequence for delivery through a terminal multiplexer
+ * (tmux or GNU screen). In a bare terminal the sequence is returned unchanged.
+ *
+ * - tmux: DCS passthrough — double every ESC in the inner sequence.
+ * - screen: DCS passthrough — chunk at 768 chars to stay within screen's
+ *   internal buffer limit.
+ */
+export function wrapForMultiplexer(inner, env) {
+    if (env.TMUX) {
+        // tmux DCS passthrough: double each ESC in the inner sequence
+        const escaped = inner.replace(/\x1b/g, '\x1b\x1b');
+        return `\x1bPtmux;\x1b${escaped}\x1b\\`;
+    }
+    if (env.TERM?.startsWith('screen')) {
+        // screen DCS passthrough: chunk at 768 chars to stay within screen's buffer limit
+        const CHUNK_SIZE = 768;
+        let result = '';
+        for (let i = 0; i < inner.length; i += CHUNK_SIZE) {
+            result += `\x1bP${inner.slice(i, i + CHUNK_SIZE)}\x1b\\`;
+        }
+        return result;
+    }
+    return inner;
+}
+/**
+ * Wraps an OSC inner sequence for the current multiplexer (if any) and writes
+ * it to the TTY. Silently does nothing if no TTY is available.
+ */
+export function writeOscSequence(inner, opts = {}) {
+    const env = opts.env ?? process.env;
+    const getWriter = opts.getTtyWriter ?? getTtyWriter;
+    const writer = getWriter();
+    if (!writer)
+        return;
+    writer(wrapForMultiplexer(inner, env));
+}
+//# sourceMappingURL=tty-osc.js.map

package/dist/utils/output/tty-osc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty-osc.js","sourceRoot":"","sources":["../../../source/utils/output/tty-osc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAIpB;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAEjB,OAAO,CAAC,IAAI,EAAE,EAAE;YACd,MAAM,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC7C,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9B,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,GAAsB;IACtE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,8DAA8D;QAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACnD,OAAO,iBAAiB,OAAO,QAAQ,CAAC;IAC1C,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,kFAAkF;QAClF,MAAM,UAAU,GAAG,GAAG,CAAC;QACvB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;YAClD,MAAM,IAAI,QAAQ,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC3D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAwB,EAAE;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC;IACpD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/output/tty-osc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tty-osc.test.d.ts.map

package/dist/utils/output/tty-osc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty-osc.test.d.ts","sourceRoot":"","sources":["../../../source/utils/output/tty-osc.test.ts"],"names":[],"mappings":""}

package/dist/utils/output/tty-osc.test.js

@@ -0,0 +1,130 @@
+import { it, expect } from 'vitest';
+import fs from 'fs';
+import { wrapForMultiplexer, writeOscSequence, getTtyWriter } from './tty-osc.js';
+// ── wrapForMultiplexer ──────────────────────────────────────────────────────
+it('wrapForMultiplexer returns inner unchanged in a bare terminal', () => {
+    const inner = '\x1b]9;hello\x07';
+    expect(wrapForMultiplexer(inner, {})).toBe(inner);
+});
+it('wrapForMultiplexer wraps in tmux DCS passthrough when TMUX is set', () => {
+    const inner = '\x1b]9;hello\x07';
+    const escaped = inner.replace(/\x1b/g, '\x1b\x1b');
+    const expected = `\x1bPtmux;\x1b${escaped}\x1b\\`;
+    expect(wrapForMultiplexer(inner, { TMUX: '/tmp/tmux' })).toBe(expected);
+});
+it('wrapForMultiplexer wraps in screen DCS passthrough when TERM starts with screen', () => {
+    const inner = '\x1b]9;hi\x07';
+    const expected = `\x1bP${inner}\x1b\\`;
+    expect(wrapForMultiplexer(inner, { TERM: 'screen-256color' })).toBe(expected);
+});
+it('wrapForMultiplexer chunks screen DCS passthrough at 768 characters', () => {
+    // Create an inner sequence longer than 768 chars
+    const longMsg = 'x'.repeat(800);
+    const inner = `\x1b]9;${longMsg}\x07`;
+    expect(inner.length > 768).toBe(true);
+    const result = wrapForMultiplexer(inner, { TERM: 'screen' });
+    const chunk1 = inner.slice(0, 768);
+    const chunk2 = inner.slice(768);
+    expect(result).toBe(`\x1bP${chunk1}\x1b\\` + `\x1bP${chunk2}\x1b\\`);
+});
+// ── writeOscSequence ────────────────────────────────────────────────────────
+it('writeOscSequence calls the injected writer with the bare sequence in a plain env', () => {
+    let written = '';
+    const inner = '\x1b]9;hello\x07';
+    writeOscSequence(inner, {
+        env: {},
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    expect(written).toBe(inner);
+});
+it('writeOscSequence does nothing when getTtyWriter returns null', () => {
+    expect(() => {
+        writeOscSequence('\x1b]9;test\x07', {
+            env: {},
+            getTtyWriter: () => null,
+        });
+    });
+});
+it('writeOscSequence applies tmux wrapping before writing', () => {
+    let written = '';
+    const inner = '\x1b]9;msg\x07';
+    const escaped = inner.replace(/\x1b/g, '\x1b\x1b');
+    const expected = `\x1bPtmux;\x1b${escaped}\x1b\\`;
+    writeOscSequence(inner, {
+        env: { TMUX: '/tmp/tmux' },
+        getTtyWriter: () => (data) => {
+            written = data;
+        },
+    });
+    expect(written).toBe(expected);
+});
+it.sequential('getTtyWriter returned writer opens and closes /dev/tty on each write', () => {
+    const isTty = process.stdout.isTTY;
+    Object.defineProperty(process.stdout, 'isTTY', {
+        value: false,
+        configurable: true,
+    });
+    const openedFds = [];
+    const closedFds = [];
+    const writtenData = [];
+    let nextFd = 100;
+    const originalOpen = fs.openSync;
+    const originalClose = fs.closeSync;
+    const originalWrite = fs.writeSync;
+    fs.openSync = ((path, flags) => {
+        if (path === '/dev/tty') {
+            const fd = nextFd++;
+            openedFds.push(fd);
+            return fd;
+        }
+        return originalOpen(path, flags);
+    });
+    fs.closeSync = ((fd) => {
+        if (fd >= 100) {
+            closedFds.push(fd);
+            return;
+        }
+        return originalClose(fd);
+    });
+    fs.writeSync = ((fd, data) => {
+        if (fd >= 100) {
+            writtenData.push({ fd, data: String(data) });
+            return data.length;
+        }
+        return originalWrite(fd, data);
+    });
+    try {
+        const writer = getTtyWriter();
+        expect(writer).toBeTruthy();
+        // First verification open/close on getTtyWriter call:
+        expect(openedFds.length).toBe(1);
+        expect(closedFds.length).toBe(1);
+        expect(openedFds[0]).toBe(closedFds[0]);
+        // Perform two writes:
+        writer('hello');
+        writer('world');
+        // Should have opened and closed two more times
+        expect(openedFds.length).toBe(3);
+        expect(closedFds.length).toBe(3);
+        expect(writtenData.length).toBe(2);
+        expect(writtenData[0].data).toBe('hello');
+        expect(writtenData[1].data).toBe('world');
+        // Verify each write had its own fd opened and closed
+        expect(writtenData[0].fd).toBe(openedFds[1]);
+        expect(closedFds[1]).toBe(openedFds[1]);
+        expect(writtenData[1].fd).toBe(openedFds[2]);
+        expect(closedFds[2]).toBe(openedFds[2]);
+    }
+    finally {
+        fs.openSync = originalOpen;
+        fs.closeSync = originalClose;
+        fs.writeSync = originalWrite;
+        Object.defineProperty(process.stdout, 'isTTY', {
+            value: isTty,
+            configurable: true,
+        });
+    }
+});
+//# sourceMappingURL=tty-osc.test.js.map

package/dist/utils/output/tty-osc.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty-osc.test.js","sourceRoot":"","sources":["../../../source/utils/output/tty-osc.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAElF,+EAA+E;AAE/E,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;IACvE,MAAM,KAAK,GAAG,kBAAkB,CAAC;IACjC,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC3E,MAAM,KAAK,GAAG,kBAAkB,CAAC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,iBAAiB,OAAO,QAAQ,CAAC;IAClD,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;IACzF,MAAM,KAAK,GAAG,eAAe,CAAC;IAC9B,MAAM,QAAQ,GAAG,QAAQ,KAAK,QAAQ,CAAC;IACvC,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChF,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;IAC5E,iDAAiD;IACjD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,UAAU,OAAO,MAAM,CAAC;IACtC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,MAAM,QAAQ,GAAG,QAAQ,MAAM,QAAQ,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;IAC1F,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,kBAAkB,CAAC;IACjC,gBAAgB,CAAC,KAAK,EAAE;QACtB,GAAG,EAAE,EAAE;QACP,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE;YAC3B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;IACtE,MAAM,CAAC,GAAG,EAAE;QACV,gBAAgB,CAAC,iBAAiB,EAAE;YAClC,GAAG,EAAE,EAAE;YACP,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;IAC/D,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,gBAAgB,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,iBAAiB,OAAO,QAAQ,CAAC;IAElD,gBAAgB,CAAC,KAAK,EAAE;QACtB,GAAG,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;QAC1B,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE;YAC3B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,UAAU,CAAC,sEAAsE,EAAE,GAAG,EAAE;IACzF,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE;QAC7C,KAAK,EAAE,KAAK;QACZ,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAmC,EAAE,CAAC;IACvD,IAAI,MAAM,GAAG,GAAG,CAAC;IAEjB,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,CAAC;IACjC,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC;IACnC,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC;IAEnC,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAS,EAAE,KAAU,EAAE,EAAE;QACvC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC,CAAQ,CAAC;IAEV,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,EAAO,EAAE,EAAE;QAC1B,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;YACd,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAQ,CAAC;IAEV,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,EAAO,EAAE,IAAS,EAAE,EAAE;QACrC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QACD,OAAO,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAQ,CAAC;IAEV,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QAE5B,sDAAsD;QACtD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAExC,sBAAsB;QACtB,MAAO,CAAC,OAAO,CAAC,CAAC;QACjB,MAAO,CAAC,OAAO,CAAC,CAAC;QAEjB,+CAA+C;QAC/C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEjC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,qDAAqD;QACrD,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,QAAQ,GAAG,YAAY,CAAC;QAC3B,EAAE,CAAC,SAAS,GAAG,aAAa,CAAC;QAC7B,EAAE,CAAC,SAAS,GAAG,aAAa,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE;YAC7C,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/utils/output/viewport.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Calculates the starting index for a viewport window, centering on the
+ * selected index while ensuring the visible range stays within bounds.
+ */
+export declare function calculateViewportStart(totalItems: number, selectedIndex: number, maxVisible: number): number;
+//# sourceMappingURL=viewport.d.ts.map

package/dist/utils/output/viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../../source/utils/output/viewport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAc5G"}

package/dist/utils/output/viewport.js

@@ -0,0 +1,20 @@
+/**
+ * Calculates the starting index for a viewport window, centering on the
+ * selected index while ensuring the visible range stays within bounds.
+ */
+export function calculateViewportStart(totalItems, selectedIndex, maxVisible) {
+    if (totalItems <= maxVisible) {
+        return 0;
+    }
+    const half = Math.floor(maxVisible / 2);
+    if (selectedIndex <= half) {
+        return 0;
+    }
+    else if (selectedIndex >= totalItems - half) {
+        return totalItems - maxVisible;
+    }
+    else {
+        return selectedIndex - half;
+    }
+}
+//# sourceMappingURL=viewport.js.map

package/dist/utils/output/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../../../source/utils/output/viewport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,aAAqB,EAAE,UAAkB;IAClG,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAExC,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;SAAM,IAAI,aAAa,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC;QAC9C,OAAO,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,OAAO,aAAa,GAAG,IAAI,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/utils/output/viewport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=viewport.test.d.ts.map

package/dist/utils/output/viewport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.test.d.ts","sourceRoot":"","sources":["../../../source/utils/output/viewport.test.ts"],"names":[],"mappings":""}