@code-yeongyu/senpi-pty 2026.8.30 → 2026.9.2

package/dist/screen-operations.d.ts

@@ -0,0 +1,42 @@
+export interface OperationSettler {
+    readonly resolve: () => void;
+    readonly reject: (error: Error) => void;
+}
+export interface WriteOperation {
+    readonly kind: "write";
+    readonly payload: string;
+    settled: Promise<void> | null;
+    readonly settlers: OperationSettler[];
+}
+export interface ReplayOperation {
+    readonly kind: "replay";
+    payload: string;
+    settled: Promise<void> | null;
+    readonly settlers: OperationSettler[];
+}
+export interface ResizeOperation {
+    readonly kind: "resize";
+    cols: number;
+    rows: number;
+    replay: string;
+    settled: Promise<void> | null;
+    readonly settlers: OperationSettler[];
+}
+export type ScreenOperation = WriteOperation | ReplayOperation | ResizeOperation;
+/**
+ * Ceiling for characters queued but not yet parsed by xterm. Beyond it the
+ * queued writes collapse into one bounded history replay, so a flooding PTY
+ * can neither overrun xterm's 50M-char pending-write watermark (which rejects
+ * with "write data discarded, use flow control to avoid losing data") nor
+ * grow the queue's memory without limit.
+ */
+export declare const MAX_PENDING_WRITE_CHARS = 1048576;
+export declare function settleOperation(settlers: OperationSettler[], error: Error | null): void;
+export declare function trackSettler(settlers: OperationSettler[]): Promise<void>;
+/**
+ * Every caller attached to the same queued operation shares ONE promise and
+ * ONE settler, so a flood, resize storm, or flush storm cannot grow an
+ * operation's settler memory with the number of callers.
+ */
+export declare function sharedSettler(operation: ScreenOperation): Promise<void>;
+//# sourceMappingURL=screen-operations.d.ts.map

package/dist/screen-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-operations.d.ts","sourceRoot":"","sources":["../src/screen-operations.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,UAAY,CAAC;AAEjD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAMvF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvE"}

package/dist/screen-operations.js

@@ -0,0 +1,34 @@
+/**
+ * Ceiling for characters queued but not yet parsed by xterm. Beyond it the
+ * queued writes collapse into one bounded history replay, so a flooding PTY
+ * can neither overrun xterm's 50M-char pending-write watermark (which rejects
+ * with "write data discarded, use flow control to avoid losing data") nor
+ * grow the queue's memory without limit.
+ */
+export const MAX_PENDING_WRITE_CHARS = 1_048_576;
+export function settleOperation(settlers, error) {
+    const owners = settlers.splice(0, settlers.length);
+    for (const settler of owners) {
+        if (error === null)
+            settler.resolve();
+        else
+            settler.reject(error);
+    }
+}
+export function trackSettler(settlers) {
+    return new Promise((resolve, reject) => {
+        settlers.push({ resolve, reject });
+    });
+}
+/**
+ * Every caller attached to the same queued operation shares ONE promise and
+ * ONE settler, so a flood, resize storm, or flush storm cannot grow an
+ * operation's settler memory with the number of callers.
+ */
+export function sharedSettler(operation) {
+    if (operation.settled === null) {
+        operation.settled = trackSettler(operation.settlers);
+    }
+    return operation.settled;
+}
+//# sourceMappingURL=screen-operations.js.map

package/dist/screen-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-operations.js","sourceRoot":"","sources":["../src/screen-operations.ts"],"names":[],"mappings":"AA8BA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAEjD,MAAM,UAAU,eAAe,CAAC,QAA4B,EAAE,KAAmB;IAChF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,OAAO,EAAE,CAAC;;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAA4B;IACxD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAA0B;IACvD,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAChC,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC;AAC1B,CAAC","sourcesContent":["export interface OperationSettler {\n\treadonly resolve: () => void;\n\treadonly reject: (error: Error) => void;\n}\n\nexport interface WriteOperation {\n\treadonly kind: \"write\";\n\treadonly payload: string;\n\tsettled: Promise<void> | null;\n\treadonly settlers: OperationSettler[];\n}\n\nexport interface ReplayOperation {\n\treadonly kind: \"replay\";\n\tpayload: string;\n\tsettled: Promise<void> | null;\n\treadonly settlers: OperationSettler[];\n}\n\nexport interface ResizeOperation {\n\treadonly kind: \"resize\";\n\tcols: number;\n\trows: number;\n\treplay: string;\n\tsettled: Promise<void> | null;\n\treadonly settlers: OperationSettler[];\n}\n\nexport type ScreenOperation = WriteOperation | ReplayOperation | ResizeOperation;\n\n/**\n * Ceiling for characters queued but not yet parsed by xterm. Beyond it the\n * queued writes collapse into one bounded history replay, so a flooding PTY\n * can neither overrun xterm's 50M-char pending-write watermark (which rejects\n * with \"write data discarded, use flow control to avoid losing data\") nor\n * grow the queue's memory without limit.\n */\nexport const MAX_PENDING_WRITE_CHARS = 1_048_576;\n\nexport function settleOperation(settlers: OperationSettler[], error: Error | null): void {\n\tconst owners = settlers.splice(0, settlers.length);\n\tfor (const settler of owners) {\n\t\tif (error === null) settler.resolve();\n\t\telse settler.reject(error);\n\t}\n}\n\nexport function trackSettler(settlers: OperationSettler[]): Promise<void> {\n\treturn new Promise<void>((resolve, reject) => {\n\t\tsettlers.push({ resolve, reject });\n\t});\n}\n\n/**\n * Every caller attached to the same queued operation shares ONE promise and\n * ONE settler, so a flood, resize storm, or flush storm cannot grow an\n * operation's settler memory with the number of callers.\n */\nexport function sharedSettler(operation: ScreenOperation): Promise<void> {\n\tif (operation.settled === null) {\n\t\toperation.settled = trackSettler(operation.settlers);\n\t}\n\treturn operation.settled;\n}\n"]}

package/dist/screen-text.d.ts

@@ -0,0 +1,8 @@
+import type { Terminal as XtermTerminalType } from "@xterm/headless";
+export declare function readLine(buffer: XtermTerminalType["buffer"]["active"], lineIndex: number): string;
+export declare function normalizeDimension(value: number | undefined, fallback: number): number;
+export declare function normalizeScrollback(value: number | undefined): number;
+export declare function normalizeReplayHistoryLength(cols: number, rows: number, scrollback: number): number;
+export declare function decodeInput(value: string | Uint8Array): string;
+export declare function sanitizeString(value: string): string;
+//# sourceMappingURL=screen-text.d.ts.map

package/dist/screen-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-text.d.ts","sourceRoot":"","sources":["../src/screen-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAQrE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGrE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGnG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAG9D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBpD"}

package/dist/screen-text.js

@@ -0,0 +1,51 @@
+const DEFAULT_SCROLLBACK = 1000;
+const MIN_SIZE = 1;
+const MAX_SIZE = 10000;
+const MIN_REPLAY_HISTORY_LENGTH = 4096;
+const MAX_REPLAY_HISTORY_LENGTH = 1_000_000;
+export function readLine(buffer, lineIndex) {
+    return buffer.getLine(lineIndex)?.translateToString(true) ?? "";
+}
+export function normalizeDimension(value, fallback) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.min(MAX_SIZE, Math.max(MIN_SIZE, Math.trunc(value)));
+}
+export function normalizeScrollback(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return DEFAULT_SCROLLBACK;
+    return Math.max(0, Math.trunc(value));
+}
+export function normalizeReplayHistoryLength(cols, rows, scrollback) {
+    const visibleCells = Math.max(MIN_SIZE, cols) * Math.max(MIN_SIZE, rows + scrollback + 1);
+    return Math.min(MAX_REPLAY_HISTORY_LENGTH, Math.max(MIN_REPLAY_HISTORY_LENGTH, visibleCells * 4));
+}
+export function decodeInput(value) {
+    if (typeof value === "string")
+        return value;
+    return new TextDecoder("utf-8", { fatal: false }).decode(value);
+}
+export function sanitizeString(value) {
+    let output = "";
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                output += value[index] + value[index + 1];
+                index += 1;
+            }
+            else {
+                output += "\uFFFD";
+            }
+        }
+        else if (code >= 0xdc00 && code <= 0xdfff) {
+            output += "\uFFFD";
+        }
+        else {
+            output += value[index];
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=screen-text.js.map

package/dist/screen-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-text.js","sourceRoot":"","sources":["../src/screen-text.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Terminal as XtermTerminalType } from \"@xterm/headless\";\n\nconst DEFAULT_SCROLLBACK = 1000;\nconst MIN_SIZE = 1;\nconst MAX_SIZE = 10000;\nconst MIN_REPLAY_HISTORY_LENGTH = 4096;\nconst MAX_REPLAY_HISTORY_LENGTH = 1_000_000;\n\nexport function readLine(buffer: XtermTerminalType[\"buffer\"][\"active\"], lineIndex: number): string {\n\treturn buffer.getLine(lineIndex)?.translateToString(true) ?? \"\";\n}\n\nexport function normalizeDimension(value: number | undefined, fallback: number): number {\n\tif (value === undefined || !Number.isFinite(value)) return fallback;\n\treturn Math.min(MAX_SIZE, Math.max(MIN_SIZE, Math.trunc(value)));\n}\n\nexport function normalizeScrollback(value: number | undefined): number {\n\tif (value === undefined || !Number.isFinite(value)) return DEFAULT_SCROLLBACK;\n\treturn Math.max(0, Math.trunc(value));\n}\n\nexport function normalizeReplayHistoryLength(cols: number, rows: number, scrollback: number): number {\n\tconst visibleCells = Math.max(MIN_SIZE, cols) * Math.max(MIN_SIZE, rows + scrollback + 1);\n\treturn Math.min(MAX_REPLAY_HISTORY_LENGTH, Math.max(MIN_REPLAY_HISTORY_LENGTH, visibleCells * 4));\n}\n\nexport function decodeInput(value: string | Uint8Array): string {\n\tif (typeof value === \"string\") return value;\n\treturn new TextDecoder(\"utf-8\", { fatal: false }).decode(value);\n}\n\nexport function sanitizeString(value: string): string {\n\tlet output = \"\";\n\tfor (let index = 0; index < value.length; index += 1) {\n\t\tconst code = value.charCodeAt(index);\n\t\tif (code >= 0xd800 && code <= 0xdbff) {\n\t\t\tconst next = value.charCodeAt(index + 1);\n\t\t\tif (next >= 0xdc00 && next <= 0xdfff) {\n\t\t\t\toutput += value[index] + value[index + 1];\n\t\t\t\tindex += 1;\n\t\t\t} else {\n\t\t\t\toutput += \"\\uFFFD\";\n\t\t\t}\n\t\t} else if (code >= 0xdc00 && code <= 0xdfff) {\n\t\t\toutput += \"\\uFFFD\";\n\t\t} else {\n\t\t\toutput += value[index];\n\t\t}\n\t}\n\treturn output;\n}\n"]}

package/dist/screen.d.ts

@@ -13,19 +13,64 @@ export interface TerminalScreenSnapshot {
         readonly y: number;
     };
 }
+/**
+ * Headless xterm screen model with serialized, flow-controlled writes.
+ *
+ * Every terminal mutation (feed, resize, backlog replay) runs through one
+ * FIFO queue that awaits xterm's parse callback before issuing the next
+ * write, so xterm's pending-write watermark can never be exceeded. When the
+ * queued backlog outgrows {@link MAX_PENDING_WRITE_CHARS}, the queued writes
+ * collapse into a single bounded history replay that reconstructs the same
+ * screen state. After {@link TerminalScreen.dispose}, queued and future
+ * operations settle as resolved no-ops; a terminal is never created after
+ * disposal.
+ */
 export declare class TerminalScreen {
     private terminal;
     private readonly history;
     private historyLength;
+    private readonly operations;
+    private pendingChars;
+    private draining;
+    private disposed;
+    private notifyDisposed;
+    private readonly whenDisposed;
     private readonly maxReplayHistoryLength;
     private readonly scrollback;
     constructor(options?: TerminalScreenOptions);
     feed(data: string | Uint8Array): Promise<void>;
     resize(cols: number, rows: number): Promise<void>;
+    /**
+     * Resolves once everything fed before this call has been parsed. Attaches
+     * to the queue tail instead of enqueueing a marker so a flush can never
+     * split a tail replay (which would let over-cap feeds mint unbounded new
+     * replay operations); only an empty queue enqueues a zero-length write.
+     */
     flush(): Promise<void>;
     snapshot(): TerminalScreenSnapshot;
     dispose(): void;
     private createTerminal;
+    private enqueue;
+    /**
+     * Route an over-cap feed to the queue's tail replay instead of enqueueing
+     * another write. Replay payloads are owned snapshot strings (immune to
+     * history trimming) bounded to the replay budget, and every coalesced feed
+     * shares the tail's memoized promise, so a flood cannot grow the queue,
+     * its payload memory, or its settler memory past the configured bounds.
+     */
+    private coalesceFeedIntoReplay;
+    /**
+     * A resize whose snapshot would push the queued payload past the cap
+     * collapses the whole queue into one resize at the latest dimensions:
+     * every dropped operation's payload is already covered by the bounded
+     * history snapshot, and their settlers settle with this operation.
+     */
+    private coalesceQueueIntoResize;
+    private boundReplayPayload;
+    private drain;
+    private run;
+    /** A disposed terminal may never invoke its parse callback; do not hang. */
+    private raceDisposal;
     private write;
     private appendHistory;
     private trimHistory;

package/dist/screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACF;AAWD,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,GAAE,qBAA0B;IAQ/C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,sBAAsB;IA0BlC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;CAcnB"}
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACF;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,GAAE,qBAA0B;IAW/C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BjD;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,QAAQ,IAAI,sBAAsB;IA0BlC,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,OAAO;IAMf;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,kBAAkB;YAKZ,KAAK;YAoBL,GAAG;IAkBjB,4EAA4E;IAC5E,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;CAcnB"}

package/dist/screen.js

@@ -1,38 +1,95 @@
 import xterm from "@xterm/headless";
+import { MAX_PENDING_WRITE_CHARS, settleOperation, sharedSettler, } from "./screen-operations.js";
+import { decodeInput, normalizeDimension, normalizeReplayHistoryLength, normalizeScrollback, readLine, sanitizeString, } from "./screen-text.js";
 const XtermTerminal = xterm.Terminal;
 const DEFAULT_COLS = 80;
 const DEFAULT_ROWS = 24;
-const DEFAULT_SCROLLBACK = 1000;
-const MIN_SIZE = 1;
-const MAX_SIZE = 10000;
-const MIN_REPLAY_HISTORY_LENGTH = 4096;
-const MAX_REPLAY_HISTORY_LENGTH = 1_000_000;
+/**
+ * Headless xterm screen model with serialized, flow-controlled writes.
+ *
+ * Every terminal mutation (feed, resize, backlog replay) runs through one
+ * FIFO queue that awaits xterm's parse callback before issuing the next
+ * write, so xterm's pending-write watermark can never be exceeded. When the
+ * queued backlog outgrows {@link MAX_PENDING_WRITE_CHARS}, the queued writes
+ * collapse into a single bounded history replay that reconstructs the same
+ * screen state. After {@link TerminalScreen.dispose}, queued and future
+ * operations settle as resolved no-ops; a terminal is never created after
+ * disposal.
+ */
 export class TerminalScreen {
     constructor(options = {}) {
         this.history = [];
         this.historyLength = 0;
+        this.operations = [];
+        this.pendingChars = 0;
+        this.draining = false;
+        this.disposed = false;
+        this.notifyDisposed = () => undefined;
         const cols = normalizeDimension(options.cols, DEFAULT_COLS);
         const rows = normalizeDimension(options.rows, DEFAULT_ROWS);
         this.scrollback = normalizeScrollback(options.scrollback);
         this.maxReplayHistoryLength = normalizeReplayHistoryLength(cols, rows, this.scrollback);
+        this.whenDisposed = new Promise((resolve) => {
+            this.notifyDisposed = resolve;
+        });
         this.terminal = this.createTerminal(cols, rows);
     }
     feed(data) {
+        if (this.disposed)
+            return Promise.resolve();
         const payload = decodeInput(data);
         const sanitizedPayload = sanitizeString(payload);
         if (sanitizedPayload.length > 0)
             this.appendHistory(sanitizedPayload);
-        return this.write(payload);
+        if (this.pendingChars + payload.length > MAX_PENDING_WRITE_CHARS) {
+            return this.coalesceFeedIntoReplay(payload);
+        }
+        this.pendingChars += payload.length;
+        const operation = { kind: "write", payload, settled: null, settlers: [] };
+        return this.enqueue(operation, sharedSettler(operation));
     }
     resize(cols, rows) {
+        if (this.disposed)
+            return Promise.resolve();
         const nextCols = normalizeDimension(cols, this.terminal.cols);
         const nextRows = normalizeDimension(rows, this.terminal.rows);
-        this.terminal.dispose();
-        this.terminal = this.createTerminal(nextCols, nextRows);
-        return this.write(this.history.join(""));
+        const snapshot = this.history.join("");
+        const tail = this.operations[this.operations.length - 1];
+        if (tail !== undefined && tail.kind === "resize") {
+            tail.cols = nextCols;
+            tail.rows = nextRows;
+            this.pendingChars += snapshot.length - tail.replay.length;
+            tail.replay = snapshot;
+            return sharedSettler(tail);
+        }
+        if (this.pendingChars + snapshot.length > MAX_PENDING_WRITE_CHARS) {
+            return this.coalesceQueueIntoResize(nextCols, nextRows, snapshot);
+        }
+        const operation = {
+            kind: "resize",
+            cols: nextCols,
+            rows: nextRows,
+            replay: snapshot,
+            settled: null,
+            settlers: [],
+        };
+        this.pendingChars += snapshot.length;
+        return this.enqueue(operation, sharedSettler(operation));
     }
+    /**
+     * Resolves once everything fed before this call has been parsed. Attaches
+     * to the queue tail instead of enqueueing a marker so a flush can never
+     * split a tail replay (which would let over-cap feeds mint unbounded new
+     * replay operations); only an empty queue enqueues a zero-length write.
+     */
     flush() {
-        return this.write("");
+        if (this.disposed)
+            return Promise.resolve();
+        const tail = this.operations[this.operations.length - 1];
+        if (tail !== undefined)
+            return sharedSettler(tail);
+        const operation = { kind: "write", payload: "", settled: null, settlers: [] };
+        return this.enqueue(operation, sharedSettler(operation));
     }
     snapshot() {
         const buffer = this.terminal.buffer.active;
@@ -58,6 +115,15 @@ export class TerminalScreen {
         };
     }
     dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.notifyDisposed();
+        const pending = this.operations.splice(0, this.operations.length);
+        this.pendingChars = 0;
+        for (const operation of pending) {
+            settleOperation(operation.settlers, null);
+        }
         this.terminal.dispose();
     }
     createTerminal(cols, rows) {
@@ -70,6 +136,108 @@ export class TerminalScreen {
             logLevel: "off",
         });
     }
+    enqueue(operation, settled) {
+        this.operations.push(operation);
+        void this.drain();
+        return settled;
+    }
+    /**
+     * Route an over-cap feed to the queue's tail replay instead of enqueueing
+     * another write. Replay payloads are owned snapshot strings (immune to
+     * history trimming) bounded to the replay budget, and every coalesced feed
+     * shares the tail's memoized promise, so a flood cannot grow the queue,
+     * its payload memory, or its settler memory past the configured bounds.
+     */
+    coalesceFeedIntoReplay(payload) {
+        const tail = this.operations[this.operations.length - 1];
+        if (tail !== undefined && tail.kind === "replay") {
+            const previousLength = tail.payload.length;
+            tail.payload = this.boundReplayPayload(tail.payload + payload);
+            this.pendingChars += tail.payload.length - previousLength;
+            return sharedSettler(tail);
+        }
+        const operation = {
+            kind: "replay",
+            payload: this.history.join(""),
+            settled: null,
+            settlers: [],
+        };
+        this.pendingChars += operation.payload.length;
+        return this.enqueue(operation, sharedSettler(operation));
+    }
+    /**
+     * A resize whose snapshot would push the queued payload past the cap
+     * collapses the whole queue into one resize at the latest dimensions:
+     * every dropped operation's payload is already covered by the bounded
+     * history snapshot, and their settlers settle with this operation.
+     */
+    coalesceQueueIntoResize(cols, rows, snapshot) {
+        const operation = {
+            kind: "resize",
+            cols,
+            rows,
+            replay: snapshot,
+            settled: null,
+            settlers: [],
+        };
+        for (const queued of this.operations.splice(0, this.operations.length)) {
+            for (const settler of queued.settlers)
+                operation.settlers.push(settler);
+            queued.settlers.length = 0;
+        }
+        this.pendingChars = snapshot.length;
+        return this.enqueue(operation, sharedSettler(operation));
+    }
+    boundReplayPayload(payload) {
+        if (payload.length <= this.maxReplayHistoryLength)
+            return payload;
+        return sanitizeString(payload.slice(-this.maxReplayHistoryLength));
+    }
+    async drain() {
+        if (this.draining)
+            return;
+        this.draining = true;
+        try {
+            while (!this.disposed) {
+                const operation = this.operations.shift();
+                if (operation === undefined)
+                    return;
+                this.pendingChars -= operation.kind === "resize" ? operation.replay.length : operation.payload.length;
+                try {
+                    await this.run(operation);
+                    settleOperation(operation.settlers, null);
+                }
+                catch (error) {
+                    settleOperation(operation.settlers, error instanceof Error ? error : new Error(String(error)));
+                }
+            }
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+    async run(operation) {
+        if (this.disposed)
+            return;
+        switch (operation.kind) {
+            case "write":
+                await this.raceDisposal(this.write(operation.payload));
+                return;
+            case "replay":
+                this.terminal.reset();
+                await this.raceDisposal(this.write(operation.payload));
+                return;
+            case "resize":
+                this.terminal.dispose();
+                this.terminal = this.createTerminal(operation.cols, operation.rows);
+                await this.raceDisposal(this.write(operation.replay));
+                return;
+        }
+    }
+    /** A disposed terminal may never invoke its parse callback; do not hang. */
+    raceDisposal(written) {
+        return Promise.race([written, this.whenDisposed]);
+    }
     write(payload) {
         return new Promise((resolve, reject) => {
             try {
@@ -107,49 +275,4 @@ export class TerminalScreen {
         this.historyLength = trimmed.length;
     }
 }
-function readLine(buffer, lineIndex) {
-    return buffer.getLine(lineIndex)?.translateToString(true) ?? "";
-}
-function normalizeDimension(value, fallback) {
-    if (value === undefined || !Number.isFinite(value))
-        return fallback;
-    return Math.min(MAX_SIZE, Math.max(MIN_SIZE, Math.trunc(value)));
-}
-function normalizeScrollback(value) {
-    if (value === undefined || !Number.isFinite(value))
-        return DEFAULT_SCROLLBACK;
-    return Math.max(0, Math.trunc(value));
-}
-function normalizeReplayHistoryLength(cols, rows, scrollback) {
-    const visibleCells = Math.max(MIN_SIZE, cols) * Math.max(MIN_SIZE, rows + scrollback + 1);
-    return Math.min(MAX_REPLAY_HISTORY_LENGTH, Math.max(MIN_REPLAY_HISTORY_LENGTH, visibleCells * 4));
-}
-function decodeInput(value) {
-    if (typeof value === "string")
-        return value;
-    return new TextDecoder("utf-8", { fatal: false }).decode(value);
-}
-function sanitizeString(value) {
-    let output = "";
-    for (let index = 0; index < value.length; index += 1) {
-        const code = value.charCodeAt(index);
-        if (code >= 0xd800 && code <= 0xdbff) {
-            const next = value.charCodeAt(index + 1);
-            if (next >= 0xdc00 && next <= 0xdfff) {
-                output += value[index] + value[index + 1];
-                index += 1;
-            }
-            else {
-                output += "\uFFFD";
-            }
-        }
-        else if (code >= 0xdc00 && code <= 0xdfff) {
-            output += "\uFFFD";
-        }
-        else {
-            output += value[index];
-        }
-    }
-    return output;
-}
 //# sourceMappingURL=screen.js.map

package/dist/screen.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Terminal as XtermTerminalType } from \"@xterm/headless\";\nimport xterm from \"@xterm/headless\";\n\nexport interface TerminalScreenOptions {\n\treadonly cols?: number;\n\treadonly rows?: number;\n\treadonly scrollback?: number;\n}\n\nexport interface TerminalScreenSnapshot {\n\treadonly cols: number;\n\treadonly rows: number;\n\treadonly visibleGrid: readonly string[];\n\treadonly scrollback: readonly string[];\n\treadonly cursor: {\n\t\treadonly x: number;\n\t\treadonly y: number;\n\t};\n}\n\nconst XtermTerminal = xterm.Terminal;\nconst DEFAULT_COLS = 80;\nconst DEFAULT_ROWS = 24;\nconst DEFAULT_SCROLLBACK = 1000;\nconst MIN_SIZE = 1;\nconst MAX_SIZE = 10000;\nconst MIN_REPLAY_HISTORY_LENGTH = 4096;\nconst MAX_REPLAY_HISTORY_LENGTH = 1_000_000;\n\nexport class TerminalScreen {\n\tprivate terminal: XtermTerminalType;\n\tprivate readonly history: string[] = [];\n\tprivate historyLength = 0;\n\tprivate readonly maxReplayHistoryLength: number;\n\tprivate readonly scrollback: number;\n\n\tconstructor(options: TerminalScreenOptions = {}) {\n\t\tconst cols = normalizeDimension(options.cols, DEFAULT_COLS);\n\t\tconst rows = normalizeDimension(options.rows, DEFAULT_ROWS);\n\t\tthis.scrollback = normalizeScrollback(options.scrollback);\n\t\tthis.maxReplayHistoryLength = normalizeReplayHistoryLength(cols, rows, this.scrollback);\n\t\tthis.terminal = this.createTerminal(cols, rows);\n\t}\n\n\tfeed(data: string | Uint8Array): Promise<void> {\n\t\tconst payload = decodeInput(data);\n\t\tconst sanitizedPayload = sanitizeString(payload);\n\t\tif (sanitizedPayload.length > 0) this.appendHistory(sanitizedPayload);\n\t\treturn this.write(payload);\n\t}\n\n\tresize(cols: number, rows: number): Promise<void> {\n\t\tconst nextCols = normalizeDimension(cols, this.terminal.cols);\n\t\tconst nextRows = normalizeDimension(rows, this.terminal.rows);\n\t\tthis.terminal.dispose();\n\t\tthis.terminal = this.createTerminal(nextCols, nextRows);\n\t\treturn this.write(this.history.join(\"\"));\n\t}\n\n\tflush(): Promise<void> {\n\t\treturn this.write(\"\");\n\t}\n\n\tsnapshot(): TerminalScreenSnapshot {\n\t\tconst buffer = this.terminal.buffer.active;\n\t\tconst viewportStart = buffer.viewportY;\n\t\tconst visibleGrid: string[] = [];\n\t\tconst scrollback: string[] = [];\n\t\tconst scrollbackStart = Math.max(0, viewportStart - this.scrollback);\n\n\t\tfor (let lineIndex = scrollbackStart; lineIndex < viewportStart; lineIndex += 1) {\n\t\t\tscrollback.push(readLine(buffer, lineIndex));\n\t\t}\n\t\tfor (let row = 0; row < this.terminal.rows; row += 1) {\n\t\t\tvisibleGrid.push(readLine(buffer, viewportStart + row));\n\t\t}\n\n\t\treturn {\n\t\t\tcols: this.terminal.cols,\n\t\t\trows: this.terminal.rows,\n\t\t\tvisibleGrid,\n\t\t\tscrollback,\n\t\t\tcursor: {\n\t\t\t\tx: buffer.cursorX,\n\t\t\t\ty: buffer.cursorY,\n\t\t\t},\n\t\t};\n\t}\n\n\tdispose(): void {\n\t\tthis.terminal.dispose();\n\t}\n\n\tprivate createTerminal(cols: number, rows: number): XtermTerminalType {\n\t\treturn new XtermTerminal({\n\t\t\tcols,\n\t\t\trows,\n\t\t\tscrollback: this.scrollback,\n\t\t\tdisableStdin: true,\n\t\t\tallowProposedApi: true,\n\t\t\tlogLevel: \"off\",\n\t\t});\n\t}\n\n\tprivate write(payload: string): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\ttry {\n\t\t\t\tthis.terminal.write(payload, resolve);\n\t\t\t} catch (error) {\n\t\t\t\tconst sanitizedPayload = sanitizeString(payload);\n\t\t\t\tif (sanitizedPayload === payload) {\n\t\t\t\t\treject(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.terminal.write(sanitizedPayload, resolve);\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate appendHistory(payload: string): void {\n\t\tthis.history.push(payload);\n\t\tthis.historyLength += payload.length;\n\t\tthis.trimHistory();\n\t}\n\n\tprivate trimHistory(): void {\n\t\twhile (this.historyLength > this.maxReplayHistoryLength && this.history.length > 1) {\n\t\t\tconst removed = this.history.shift();\n\t\t\tif (removed === undefined) return;\n\t\t\tthis.historyLength -= removed.length;\n\t\t}\n\n\t\tif (this.historyLength <= this.maxReplayHistoryLength) return;\n\t\tconst [onlyChunk] = this.history;\n\t\tif (onlyChunk === undefined) return;\n\t\tconst trimmed = sanitizeString(onlyChunk.slice(-this.maxReplayHistoryLength));\n\t\tthis.history[0] = trimmed;\n\t\tthis.historyLength = trimmed.length;\n\t}\n}\n\nfunction readLine(buffer: XtermTerminalType[\"buffer\"][\"active\"], lineIndex: number): string {\n\treturn buffer.getLine(lineIndex)?.translateToString(true) ?? \"\";\n}\n\nfunction normalizeDimension(value: number | undefined, fallback: number): number {\n\tif (value === undefined || !Number.isFinite(value)) return fallback;\n\treturn Math.min(MAX_SIZE, Math.max(MIN_SIZE, Math.trunc(value)));\n}\n\nfunction normalizeScrollback(value: number | undefined): number {\n\tif (value === undefined || !Number.isFinite(value)) return DEFAULT_SCROLLBACK;\n\treturn Math.max(0, Math.trunc(value));\n}\n\nfunction normalizeReplayHistoryLength(cols: number, rows: number, scrollback: number): number {\n\tconst visibleCells = Math.max(MIN_SIZE, cols) * Math.max(MIN_SIZE, rows + scrollback + 1);\n\treturn Math.min(MAX_REPLAY_HISTORY_LENGTH, Math.max(MIN_REPLAY_HISTORY_LENGTH, visibleCells * 4));\n}\n\nfunction decodeInput(value: string | Uint8Array): string {\n\tif (typeof value === \"string\") return value;\n\treturn new TextDecoder(\"utf-8\", { fatal: false }).decode(value);\n}\n\nfunction sanitizeString(value: string): string {\n\tlet output = \"\";\n\tfor (let index = 0; index < value.length; index += 1) {\n\t\tconst code = value.charCodeAt(index);\n\t\tif (code >= 0xd800 && code <= 0xdbff) {\n\t\t\tconst next = value.charCodeAt(index + 1);\n\t\t\tif (next >= 0xdc00 && next <= 0xdfff) {\n\t\t\t\toutput += value[index] + value[index + 1];\n\t\t\t\tindex += 1;\n\t\t\t} else {\n\t\t\t\toutput += \"\\uFFFD\";\n\t\t\t}\n\t\t} else if (code >= 0xdc00 && code <= 0xdfff) {\n\t\t\toutput += \"\\uFFFD\";\n\t\t} else {\n\t\t\toutput += value[index];\n\t\t}\n\t}\n\treturn output;\n}\n"]}
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Terminal as XtermTerminalType } from \"@xterm/headless\";\nimport xterm from \"@xterm/headless\";\nimport {\n\tMAX_PENDING_WRITE_CHARS,\n\ttype ReplayOperation,\n\ttype ResizeOperation,\n\ttype ScreenOperation,\n\tsettleOperation,\n\tsharedSettler,\n} from \"./screen-operations.ts\";\n\nimport {\n\tdecodeInput,\n\tnormalizeDimension,\n\tnormalizeReplayHistoryLength,\n\tnormalizeScrollback,\n\treadLine,\n\tsanitizeString,\n} from \"./screen-text.ts\";\n\nexport interface TerminalScreenOptions {\n\treadonly cols?: number;\n\treadonly rows?: number;\n\treadonly scrollback?: number;\n}\n\nexport interface TerminalScreenSnapshot {\n\treadonly cols: number;\n\treadonly rows: number;\n\treadonly visibleGrid: readonly string[];\n\treadonly scrollback: readonly string[];\n\treadonly cursor: {\n\t\treadonly x: number;\n\t\treadonly y: number;\n\t};\n}\n\nconst XtermTerminal = xterm.Terminal;\nconst DEFAULT_COLS = 80;\nconst DEFAULT_ROWS = 24;\n\n/**\n * Headless xterm screen model with serialized, flow-controlled writes.\n *\n * Every terminal mutation (feed, resize, backlog replay) runs through one\n * FIFO queue that awaits xterm's parse callback before issuing the next\n * write, so xterm's pending-write watermark can never be exceeded. When the\n * queued backlog outgrows {@link MAX_PENDING_WRITE_CHARS}, the queued writes\n * collapse into a single bounded history replay that reconstructs the same\n * screen state. After {@link TerminalScreen.dispose}, queued and future\n * operations settle as resolved no-ops; a terminal is never created after\n * disposal.\n */\nexport class TerminalScreen {\n\tprivate terminal: XtermTerminalType;\n\tprivate readonly history: string[] = [];\n\tprivate historyLength = 0;\n\tprivate readonly operations: ScreenOperation[] = [];\n\tprivate pendingChars = 0;\n\tprivate draining = false;\n\tprivate disposed = false;\n\tprivate notifyDisposed: () => void = () => undefined;\n\tprivate readonly whenDisposed: Promise<void>;\n\tprivate readonly maxReplayHistoryLength: number;\n\tprivate readonly scrollback: number;\n\n\tconstructor(options: TerminalScreenOptions = {}) {\n\t\tconst cols = normalizeDimension(options.cols, DEFAULT_COLS);\n\t\tconst rows = normalizeDimension(options.rows, DEFAULT_ROWS);\n\t\tthis.scrollback = normalizeScrollback(options.scrollback);\n\t\tthis.maxReplayHistoryLength = normalizeReplayHistoryLength(cols, rows, this.scrollback);\n\t\tthis.whenDisposed = new Promise((resolve) => {\n\t\t\tthis.notifyDisposed = resolve;\n\t\t});\n\t\tthis.terminal = this.createTerminal(cols, rows);\n\t}\n\n\tfeed(data: string | Uint8Array): Promise<void> {\n\t\tif (this.disposed) return Promise.resolve();\n\t\tconst payload = decodeInput(data);\n\t\tconst sanitizedPayload = sanitizeString(payload);\n\t\tif (sanitizedPayload.length > 0) this.appendHistory(sanitizedPayload);\n\t\tif (this.pendingChars + payload.length > MAX_PENDING_WRITE_CHARS) {\n\t\t\treturn this.coalesceFeedIntoReplay(payload);\n\t\t}\n\t\tthis.pendingChars += payload.length;\n\t\tconst operation: ScreenOperation = { kind: \"write\", payload, settled: null, settlers: [] };\n\t\treturn this.enqueue(operation, sharedSettler(operation));\n\t}\n\n\tresize(cols: number, rows: number): Promise<void> {\n\t\tif (this.disposed) return Promise.resolve();\n\t\tconst nextCols = normalizeDimension(cols, this.terminal.cols);\n\t\tconst nextRows = normalizeDimension(rows, this.terminal.rows);\n\t\tconst snapshot = this.history.join(\"\");\n\t\tconst tail = this.operations[this.operations.length - 1];\n\t\tif (tail !== undefined && tail.kind === \"resize\") {\n\t\t\ttail.cols = nextCols;\n\t\t\ttail.rows = nextRows;\n\t\t\tthis.pendingChars += snapshot.length - tail.replay.length;\n\t\t\ttail.replay = snapshot;\n\t\t\treturn sharedSettler(tail);\n\t\t}\n\t\tif (this.pendingChars + snapshot.length > MAX_PENDING_WRITE_CHARS) {\n\t\t\treturn this.coalesceQueueIntoResize(nextCols, nextRows, snapshot);\n\t\t}\n\t\tconst operation: ResizeOperation = {\n\t\t\tkind: \"resize\",\n\t\t\tcols: nextCols,\n\t\t\trows: nextRows,\n\t\t\treplay: snapshot,\n\t\t\tsettled: null,\n\t\t\tsettlers: [],\n\t\t};\n\t\tthis.pendingChars += snapshot.length;\n\t\treturn this.enqueue(operation, sharedSettler(operation));\n\t}\n\n\t/**\n\t * Resolves once everything fed before this call has been parsed. Attaches\n\t * to the queue tail instead of enqueueing a marker so a flush can never\n\t * split a tail replay (which would let over-cap feeds mint unbounded new\n\t * replay operations); only an empty queue enqueues a zero-length write.\n\t */\n\tflush(): Promise<void> {\n\t\tif (this.disposed) return Promise.resolve();\n\t\tconst tail = this.operations[this.operations.length - 1];\n\t\tif (tail !== undefined) return sharedSettler(tail);\n\t\tconst operation: ScreenOperation = { kind: \"write\", payload: \"\", settled: null, settlers: [] };\n\t\treturn this.enqueue(operation, sharedSettler(operation));\n\t}\n\n\tsnapshot(): TerminalScreenSnapshot {\n\t\tconst buffer = this.terminal.buffer.active;\n\t\tconst viewportStart = buffer.viewportY;\n\t\tconst visibleGrid: string[] = [];\n\t\tconst scrollback: string[] = [];\n\t\tconst scrollbackStart = Math.max(0, viewportStart - this.scrollback);\n\n\t\tfor (let lineIndex = scrollbackStart; lineIndex < viewportStart; lineIndex += 1) {\n\t\t\tscrollback.push(readLine(buffer, lineIndex));\n\t\t}\n\t\tfor (let row = 0; row < this.terminal.rows; row += 1) {\n\t\t\tvisibleGrid.push(readLine(buffer, viewportStart + row));\n\t\t}\n\n\t\treturn {\n\t\t\tcols: this.terminal.cols,\n\t\t\trows: this.terminal.rows,\n\t\t\tvisibleGrid,\n\t\t\tscrollback,\n\t\t\tcursor: {\n\t\t\t\tx: buffer.cursorX,\n\t\t\t\ty: buffer.cursorY,\n\t\t\t},\n\t\t};\n\t}\n\n\tdispose(): void {\n\t\tif (this.disposed) return;\n\t\tthis.disposed = true;\n\t\tthis.notifyDisposed();\n\t\tconst pending = this.operations.splice(0, this.operations.length);\n\t\tthis.pendingChars = 0;\n\t\tfor (const operation of pending) {\n\t\t\tsettleOperation(operation.settlers, null);\n\t\t}\n\t\tthis.terminal.dispose();\n\t}\n\n\tprivate createTerminal(cols: number, rows: number): XtermTerminalType {\n\t\treturn new XtermTerminal({\n\t\t\tcols,\n\t\t\trows,\n\t\t\tscrollback: this.scrollback,\n\t\t\tdisableStdin: true,\n\t\t\tallowProposedApi: true,\n\t\t\tlogLevel: \"off\",\n\t\t});\n\t}\n\n\tprivate enqueue(operation: ScreenOperation, settled: Promise<void>): Promise<void> {\n\t\tthis.operations.push(operation);\n\t\tvoid this.drain();\n\t\treturn settled;\n\t}\n\n\t/**\n\t * Route an over-cap feed to the queue's tail replay instead of enqueueing\n\t * another write. Replay payloads are owned snapshot strings (immune to\n\t * history trimming) bounded to the replay budget, and every coalesced feed\n\t * shares the tail's memoized promise, so a flood cannot grow the queue,\n\t * its payload memory, or its settler memory past the configured bounds.\n\t */\n\tprivate coalesceFeedIntoReplay(payload: string): Promise<void> {\n\t\tconst tail = this.operations[this.operations.length - 1];\n\t\tif (tail !== undefined && tail.kind === \"replay\") {\n\t\t\tconst previousLength = tail.payload.length;\n\t\t\ttail.payload = this.boundReplayPayload(tail.payload + payload);\n\t\t\tthis.pendingChars += tail.payload.length - previousLength;\n\t\t\treturn sharedSettler(tail);\n\t\t}\n\t\tconst operation: ReplayOperation = {\n\t\t\tkind: \"replay\",\n\t\t\tpayload: this.history.join(\"\"),\n\t\t\tsettled: null,\n\t\t\tsettlers: [],\n\t\t};\n\t\tthis.pendingChars += operation.payload.length;\n\t\treturn this.enqueue(operation, sharedSettler(operation));\n\t}\n\n\t/**\n\t * A resize whose snapshot would push the queued payload past the cap\n\t * collapses the whole queue into one resize at the latest dimensions:\n\t * every dropped operation's payload is already covered by the bounded\n\t * history snapshot, and their settlers settle with this operation.\n\t */\n\tprivate coalesceQueueIntoResize(cols: number, rows: number, snapshot: string): Promise<void> {\n\t\tconst operation: ResizeOperation = {\n\t\t\tkind: \"resize\",\n\t\t\tcols,\n\t\t\trows,\n\t\t\treplay: snapshot,\n\t\t\tsettled: null,\n\t\t\tsettlers: [],\n\t\t};\n\t\tfor (const queued of this.operations.splice(0, this.operations.length)) {\n\t\t\tfor (const settler of queued.settlers) operation.settlers.push(settler);\n\t\t\tqueued.settlers.length = 0;\n\t\t}\n\t\tthis.pendingChars = snapshot.length;\n\t\treturn this.enqueue(operation, sharedSettler(operation));\n\t}\n\n\tprivate boundReplayPayload(payload: string): string {\n\t\tif (payload.length <= this.maxReplayHistoryLength) return payload;\n\t\treturn sanitizeString(payload.slice(-this.maxReplayHistoryLength));\n\t}\n\n\tprivate async drain(): Promise<void> {\n\t\tif (this.draining) return;\n\t\tthis.draining = true;\n\t\ttry {\n\t\t\twhile (!this.disposed) {\n\t\t\t\tconst operation = this.operations.shift();\n\t\t\t\tif (operation === undefined) return;\n\t\t\t\tthis.pendingChars -= operation.kind === \"resize\" ? operation.replay.length : operation.payload.length;\n\t\t\t\ttry {\n\t\t\t\t\tawait this.run(operation);\n\t\t\t\t\tsettleOperation(operation.settlers, null);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tsettleOperation(operation.settlers, error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t}\n\t\t\t}\n\t\t} finally {\n\t\t\tthis.draining = false;\n\t\t}\n\t}\n\n\tprivate async run(operation: ScreenOperation): Promise<void> {\n\t\tif (this.disposed) return;\n\t\tswitch (operation.kind) {\n\t\t\tcase \"write\":\n\t\t\t\tawait this.raceDisposal(this.write(operation.payload));\n\t\t\t\treturn;\n\t\t\tcase \"replay\":\n\t\t\t\tthis.terminal.reset();\n\t\t\t\tawait this.raceDisposal(this.write(operation.payload));\n\t\t\t\treturn;\n\t\t\tcase \"resize\":\n\t\t\t\tthis.terminal.dispose();\n\t\t\t\tthis.terminal = this.createTerminal(operation.cols, operation.rows);\n\t\t\t\tawait this.raceDisposal(this.write(operation.replay));\n\t\t\t\treturn;\n\t\t}\n\t}\n\n\t/** A disposed terminal may never invoke its parse callback; do not hang. */\n\tprivate raceDisposal(written: Promise<void>): Promise<void> {\n\t\treturn Promise.race([written, this.whenDisposed]);\n\t}\n\n\tprivate write(payload: string): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\ttry {\n\t\t\t\tthis.terminal.write(payload, resolve);\n\t\t\t} catch (error) {\n\t\t\t\tconst sanitizedPayload = sanitizeString(payload);\n\t\t\t\tif (sanitizedPayload === payload) {\n\t\t\t\t\treject(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.terminal.write(sanitizedPayload, resolve);\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate appendHistory(payload: string): void {\n\t\tthis.history.push(payload);\n\t\tthis.historyLength += payload.length;\n\t\tthis.trimHistory();\n\t}\n\n\tprivate trimHistory(): void {\n\t\twhile (this.historyLength > this.maxReplayHistoryLength && this.history.length > 1) {\n\t\t\tconst removed = this.history.shift();\n\t\t\tif (removed === undefined) return;\n\t\t\tthis.historyLength -= removed.length;\n\t\t}\n\n\t\tif (this.historyLength <= this.maxReplayHistoryLength) return;\n\t\tconst [onlyChunk] = this.history;\n\t\tif (onlyChunk === undefined) return;\n\t\tconst trimmed = sanitizeString(onlyChunk.slice(-this.maxReplayHistoryLength));\n\t\tthis.history[0] = trimmed;\n\t\tthis.historyLength = trimmed.length;\n\t}\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-pty",
-	"version": "2026.8.30",
+	"version": "2026.9.2",
 	"description": "Typed PTY session loader for Senpi persistent terminals",
 	"type": "module",
 	"main": "./dist/index.js",