@juliusbrussee/caveman-tui 0.65.2

package/dist/scroll-buffer.js

@@ -0,0 +1,222 @@
+/**
+ * In-app scroll buffer.
+ *
+ * Covers cavekit-fullscreen-viewport R5 (buffer semantics), R6 (scroll controls).
+ * The buffer owns the session transcript; the TUI renders whatever slice the
+ * buffer exposes for the current viewport.
+ */
+import { visibleWidth, wrapTextWithAnsi } from "./utils.js";
+/**
+ * Session transcript with viewport and follow-tail semantics.
+ *
+ * The buffer stores raw "logical" lines as appended. For rendering, lines are
+ * soft-wrapped to the current viewport width producing "display" lines. The
+ * viewport is defined in display lines, so the scroll math operates on the
+ * post-wrap stream and stays consistent after resize.
+ */
+export class ScrollBuffer {
+    logical = [];
+    wrapEnabled;
+    maxLines;
+    // Cache of wrapped lines — invalidated on width change or append.
+    wrappedCache = null;
+    cachedWidth = 0;
+    viewportWidth = 80;
+    viewportHeight = 24;
+    /** Offset from the top of the wrapped stream (display-line index of viewport top). */
+    topOffset = 0;
+    _mode = "tail";
+    _unseen = 0;
+    constructor(opts = {}) {
+        this.maxLines = opts.maxLines ?? Number.POSITIVE_INFINITY;
+        this.wrapEnabled = opts.wrap !== false;
+    }
+    append(lines) {
+        if (lines.length === 0)
+            return;
+        this.logical.push(...lines);
+        this.trimToMax();
+        this.invalidateCache();
+        if (this._mode === "tail") {
+            this.snapToTail();
+        }
+        else {
+            this._unseen += this.countDisplayLines(lines);
+        }
+    }
+    /**
+     * Replace the last `count` logical lines with `lines`. Used for streaming
+     * updates to a single message that grows in-place. Tail/paused behavior
+     * mirrors append().
+     */
+    replaceTail(count, lines) {
+        if (count > 0) {
+            const removeCount = Math.min(count, this.logical.length);
+            this.logical.splice(this.logical.length - removeCount, removeCount);
+        }
+        this.logical.push(...lines);
+        this.trimToMax();
+        this.invalidateCache();
+        if (this._mode === "tail") {
+            this.snapToTail();
+        }
+    }
+    clear() {
+        this.logical = [];
+        this.invalidateCache();
+        this.topOffset = 0;
+        this._mode = "tail";
+        this._unseen = 0;
+    }
+    setViewportHeight(rows) {
+        if (rows === this.viewportHeight)
+            return;
+        this.viewportHeight = Math.max(1, rows);
+        if (this._mode === "tail")
+            this.snapToTail();
+        else
+            this.clampTopOffset();
+    }
+    setViewportWidth(cols) {
+        if (cols === this.viewportWidth)
+            return;
+        this.viewportWidth = Math.max(1, cols);
+        this.invalidateCache();
+        if (this._mode === "tail")
+            this.snapToTail();
+        else
+            this.clampTopOffset();
+    }
+    get totalLines() {
+        return this.getWrapped().length;
+    }
+    get viewHeight() {
+        return this.viewportHeight;
+    }
+    get viewWidth() {
+        return this.viewportWidth;
+    }
+    scrollBy(delta) {
+        if (delta === 0)
+            return;
+        const next = this.topOffset + delta;
+        const maxTop = Math.max(0, this.getWrapped().length - this.viewportHeight);
+        const clamped = Math.max(0, Math.min(maxTop, next));
+        if (clamped === this.topOffset)
+            return;
+        this.topOffset = clamped;
+        if (this.topOffset >= maxTop) {
+            this.setMode("tail");
+        }
+        else {
+            this.setMode("paused");
+        }
+    }
+    pageUp() {
+        this.scrollBy(-Math.max(1, this.viewportHeight - 1));
+    }
+    pageDown() {
+        this.scrollBy(Math.max(1, this.viewportHeight - 1));
+    }
+    halfPageUp() {
+        this.scrollBy(-Math.max(1, Math.floor(this.viewportHeight / 2)));
+    }
+    halfPageDown() {
+        this.scrollBy(Math.max(1, Math.floor(this.viewportHeight / 2)));
+    }
+    jumpToTop() {
+        if (this.topOffset === 0)
+            return;
+        this.topOffset = 0;
+        this.setMode(this.getWrapped().length <= this.viewportHeight ? "tail" : "paused");
+    }
+    jumpToTail() {
+        this.setMode("tail");
+        this.snapToTail();
+    }
+    get isAtTail() {
+        const maxTop = Math.max(0, this.getWrapped().length - this.viewportHeight);
+        return this.topOffset >= maxTop;
+    }
+    get mode() {
+        return this._mode;
+    }
+    unseenCount() {
+        return this._unseen;
+    }
+    /** Returns exactly viewportHeight display lines (pads with "" when short). */
+    render() {
+        const wrapped = this.getWrapped();
+        const start = Math.max(0, Math.min(wrapped.length, this.topOffset));
+        const slice = wrapped.slice(start, start + this.viewportHeight);
+        while (slice.length < this.viewportHeight)
+            slice.push("");
+        return slice;
+    }
+    // ------------------- internals -------------------
+    setMode(next) {
+        if (this._mode === next)
+            return;
+        this._mode = next;
+        if (next === "tail") {
+            this._unseen = 0;
+        }
+    }
+    snapToTail() {
+        const total = this.getWrapped().length;
+        this.topOffset = Math.max(0, total - this.viewportHeight);
+        this._unseen = 0;
+    }
+    clampTopOffset() {
+        const maxTop = Math.max(0, this.getWrapped().length - this.viewportHeight);
+        if (this.topOffset > maxTop)
+            this.topOffset = maxTop;
+        if (this.topOffset < 0)
+            this.topOffset = 0;
+    }
+    trimToMax() {
+        if (!Number.isFinite(this.maxLines))
+            return;
+        const over = this.logical.length - this.maxLines;
+        if (over > 0)
+            this.logical.splice(0, over);
+    }
+    invalidateCache() {
+        this.wrappedCache = null;
+    }
+    getWrapped() {
+        if (this.wrappedCache && this.cachedWidth === this.viewportWidth) {
+            return this.wrappedCache;
+        }
+        if (!this.wrapEnabled) {
+            this.wrappedCache = [...this.logical];
+        }
+        else {
+            const out = [];
+            for (const line of this.logical) {
+                if (visibleWidth(line) <= this.viewportWidth) {
+                    out.push(line);
+                }
+                else {
+                    out.push(...wrapTextWithAnsi(line, this.viewportWidth));
+                }
+            }
+            this.wrappedCache = out;
+        }
+        this.cachedWidth = this.viewportWidth;
+        return this.wrappedCache;
+    }
+    countDisplayLines(lines) {
+        if (!this.wrapEnabled)
+            return lines.length;
+        let n = 0;
+        for (const line of lines) {
+            if (visibleWidth(line) <= this.viewportWidth)
+                n += 1;
+            else
+                n += wrapTextWithAnsi(line, this.viewportWidth).length;
+        }
+        return n;
+    }
+}
+//# sourceMappingURL=scroll-buffer.js.map

package/dist/scroll-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-buffer.js","sourceRoot":"","sources":["../src/scroll-buffer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * In-app scroll buffer.\n *\n * Covers cavekit-fullscreen-viewport R5 (buffer semantics), R6 (scroll controls).\n * The buffer owns the session transcript; the TUI renders whatever slice the\n * buffer exposes for the current viewport.\n */\n\nimport { visibleWidth, wrapTextWithAnsi } from \"./utils.js\";\n\nexport type ScrollMode = \"tail\" | \"paused\";\n\nexport interface ScrollBufferOptions {\n\tmaxLines?: number;\n\twrap?: boolean;\n}\n\n/**\n * Session transcript with viewport and follow-tail semantics.\n *\n * The buffer stores raw \"logical\" lines as appended. For rendering, lines are\n * soft-wrapped to the current viewport width producing \"display\" lines. The\n * viewport is defined in display lines, so the scroll math operates on the\n * post-wrap stream and stays consistent after resize.\n */\nexport class ScrollBuffer {\n\tprivate logical: string[] = [];\n\tprivate wrapEnabled: boolean;\n\tprivate readonly maxLines: number;\n\n\t// Cache of wrapped lines — invalidated on width change or append.\n\tprivate wrappedCache: string[] | null = null;\n\tprivate cachedWidth = 0;\n\n\tprivate viewportWidth = 80;\n\tprivate viewportHeight = 24;\n\n\t/** Offset from the top of the wrapped stream (display-line index of viewport top). */\n\tprivate topOffset = 0;\n\n\tprivate _mode: ScrollMode = \"tail\";\n\tprivate _unseen = 0;\n\n\tconstructor(opts: ScrollBufferOptions = {}) {\n\t\tthis.maxLines = opts.maxLines ?? Number.POSITIVE_INFINITY;\n\t\tthis.wrapEnabled = opts.wrap !== false;\n\t}\n\n\tappend(lines: string[]): void {\n\t\tif (lines.length === 0) return;\n\t\tthis.logical.push(...lines);\n\t\tthis.trimToMax();\n\t\tthis.invalidateCache();\n\n\t\tif (this._mode === \"tail\") {\n\t\t\tthis.snapToTail();\n\t\t} else {\n\t\t\tthis._unseen += this.countDisplayLines(lines);\n\t\t}\n\t}\n\n\t/**\n\t * Replace the last `count` logical lines with `lines`. Used for streaming\n\t * updates to a single message that grows in-place. Tail/paused behavior\n\t * mirrors append().\n\t */\n\treplaceTail(count: number, lines: string[]): void {\n\t\tif (count > 0) {\n\t\t\tconst removeCount = Math.min(count, this.logical.length);\n\t\t\tthis.logical.splice(this.logical.length - removeCount, removeCount);\n\t\t}\n\t\tthis.logical.push(...lines);\n\t\tthis.trimToMax();\n\t\tthis.invalidateCache();\n\n\t\tif (this._mode === \"tail\") {\n\t\t\tthis.snapToTail();\n\t\t}\n\t}\n\n\tclear(): void {\n\t\tthis.logical = [];\n\t\tthis.invalidateCache();\n\t\tthis.topOffset = 0;\n\t\tthis._mode = \"tail\";\n\t\tthis._unseen = 0;\n\t}\n\n\tsetViewportHeight(rows: number): void {\n\t\tif (rows === this.viewportHeight) return;\n\t\tthis.viewportHeight = Math.max(1, rows);\n\t\tif (this._mode === \"tail\") this.snapToTail();\n\t\telse this.clampTopOffset();\n\t}\n\n\tsetViewportWidth(cols: number): void {\n\t\tif (cols === this.viewportWidth) return;\n\t\tthis.viewportWidth = Math.max(1, cols);\n\t\tthis.invalidateCache();\n\t\tif (this._mode === \"tail\") this.snapToTail();\n\t\telse this.clampTopOffset();\n\t}\n\n\tget totalLines(): number {\n\t\treturn this.getWrapped().length;\n\t}\n\n\tget viewHeight(): number {\n\t\treturn this.viewportHeight;\n\t}\n\n\tget viewWidth(): number {\n\t\treturn this.viewportWidth;\n\t}\n\n\tscrollBy(delta: number): void {\n\t\tif (delta === 0) return;\n\t\tconst next = this.topOffset + delta;\n\t\tconst maxTop = Math.max(0, this.getWrapped().length - this.viewportHeight);\n\t\tconst clamped = Math.max(0, Math.min(maxTop, next));\n\t\tif (clamped === this.topOffset) return;\n\t\tthis.topOffset = clamped;\n\t\tif (this.topOffset >= maxTop) {\n\t\t\tthis.setMode(\"tail\");\n\t\t} else {\n\t\t\tthis.setMode(\"paused\");\n\t\t}\n\t}\n\n\tpageUp(): void {\n\t\tthis.scrollBy(-Math.max(1, this.viewportHeight - 1));\n\t}\n\n\tpageDown(): void {\n\t\tthis.scrollBy(Math.max(1, this.viewportHeight - 1));\n\t}\n\n\thalfPageUp(): void {\n\t\tthis.scrollBy(-Math.max(1, Math.floor(this.viewportHeight / 2)));\n\t}\n\n\thalfPageDown(): void {\n\t\tthis.scrollBy(Math.max(1, Math.floor(this.viewportHeight / 2)));\n\t}\n\n\tjumpToTop(): void {\n\t\tif (this.topOffset === 0) return;\n\t\tthis.topOffset = 0;\n\t\tthis.setMode(this.getWrapped().length <= this.viewportHeight ? \"tail\" : \"paused\");\n\t}\n\n\tjumpToTail(): void {\n\t\tthis.setMode(\"tail\");\n\t\tthis.snapToTail();\n\t}\n\n\tget isAtTail(): boolean {\n\t\tconst maxTop = Math.max(0, this.getWrapped().length - this.viewportHeight);\n\t\treturn this.topOffset >= maxTop;\n\t}\n\n\tget mode(): ScrollMode {\n\t\treturn this._mode;\n\t}\n\n\tunseenCount(): number {\n\t\treturn this._unseen;\n\t}\n\n\t/** Returns exactly viewportHeight display lines (pads with \"\" when short). */\n\trender(): string[] {\n\t\tconst wrapped = this.getWrapped();\n\t\tconst start = Math.max(0, Math.min(wrapped.length, this.topOffset));\n\t\tconst slice = wrapped.slice(start, start + this.viewportHeight);\n\t\twhile (slice.length < this.viewportHeight) slice.push(\"\");\n\t\treturn slice;\n\t}\n\n\t// ------------------- internals -------------------\n\n\tprivate setMode(next: ScrollMode): void {\n\t\tif (this._mode === next) return;\n\t\tthis._mode = next;\n\t\tif (next === \"tail\") {\n\t\t\tthis._unseen = 0;\n\t\t}\n\t}\n\n\tprivate snapToTail(): void {\n\t\tconst total = this.getWrapped().length;\n\t\tthis.topOffset = Math.max(0, total - this.viewportHeight);\n\t\tthis._unseen = 0;\n\t}\n\n\tprivate clampTopOffset(): void {\n\t\tconst maxTop = Math.max(0, this.getWrapped().length - this.viewportHeight);\n\t\tif (this.topOffset > maxTop) this.topOffset = maxTop;\n\t\tif (this.topOffset < 0) this.topOffset = 0;\n\t}\n\n\tprivate trimToMax(): void {\n\t\tif (!Number.isFinite(this.maxLines)) return;\n\t\tconst over = this.logical.length - this.maxLines;\n\t\tif (over > 0) this.logical.splice(0, over);\n\t}\n\n\tprivate invalidateCache(): void {\n\t\tthis.wrappedCache = null;\n\t}\n\n\tprivate getWrapped(): string[] {\n\t\tif (this.wrappedCache && this.cachedWidth === this.viewportWidth) {\n\t\t\treturn this.wrappedCache;\n\t\t}\n\t\tif (!this.wrapEnabled) {\n\t\t\tthis.wrappedCache = [...this.logical];\n\t\t} else {\n\t\t\tconst out: string[] = [];\n\t\t\tfor (const line of this.logical) {\n\t\t\t\tif (visibleWidth(line) <= this.viewportWidth) {\n\t\t\t\t\tout.push(line);\n\t\t\t\t} else {\n\t\t\t\t\tout.push(...wrapTextWithAnsi(line, this.viewportWidth));\n\t\t\t\t}\n\t\t\t}\n\t\t\tthis.wrappedCache = out;\n\t\t}\n\t\tthis.cachedWidth = this.viewportWidth;\n\t\treturn this.wrappedCache;\n\t}\n\n\tprivate countDisplayLines(lines: string[]): number {\n\t\tif (!this.wrapEnabled) return lines.length;\n\t\tlet n = 0;\n\t\tfor (const line of lines) {\n\t\t\tif (visibleWidth(line) <= this.viewportWidth) n += 1;\n\t\t\telse n += wrapTextWithAnsi(line, this.viewportWidth).length;\n\t\t}\n\t\treturn n;\n\t}\n}\n"]}

package/dist/spinners.d.ts

@@ -0,0 +1,26 @@
+export interface SpinnerVariant {
+    readonly frames: readonly string[];
+    readonly interval: number;
+}
+export declare const SPINNERS: {
+    readonly dots: SpinnerVariant;
+    readonly helix: SpinnerVariant;
+    readonly breathe: SpinnerVariant;
+    readonly orbit: SpinnerVariant;
+    readonly dna: SpinnerVariant;
+    readonly waverows: SpinnerVariant;
+    readonly snake: SpinnerVariant;
+    readonly pulse: SpinnerVariant;
+    readonly cascade: SpinnerVariant;
+    readonly scan: SpinnerVariant;
+    readonly diagswipe: SpinnerVariant;
+    readonly fillsweep: SpinnerVariant;
+    readonly rain: SpinnerVariant;
+    readonly columns: SpinnerVariant;
+    readonly sparkle: SpinnerVariant;
+};
+export type SpinnerName = keyof typeof SPINNERS;
+export declare const THINKING_SPINNERS: readonly SpinnerName[];
+export declare const TOOL_SPINNERS: readonly SpinnerName[];
+export declare function getSpinner(name: string | undefined, fallback: SpinnerName): SpinnerVariant;
+//# sourceMappingURL=spinners.d.ts.map

package/dist/spinners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinners.d.ts","sourceRoot":"","sources":["../src/spinners.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AA+GD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;CAgBX,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,QAAQ,CAAC;AAEhD,eAAO,MAAM,iBAAiB,EAAE,SAAS,WAAW,EAQnD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAQ/C,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,WAAW,GAAG,cAAc,CAK1F","sourcesContent":["export interface SpinnerVariant {\n\treadonly frames: readonly string[];\n\treadonly interval: number;\n}\n\nconst dots: SpinnerVariant = {\n\tframes: [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"],\n\tinterval: 80,\n};\n\nconst helix: SpinnerVariant = {\n\tframes: [\"⠁\", \"⠂\", \"⠄\", \"⡀\", \"⢀\", \"⠠\", \"⠐\", \"⠈\"],\n\tinterval: 90,\n};\n\nconst breathe: SpinnerVariant = {\n\tframes: [\"·\", \"•\", \"●\", \"•\"],\n\tinterval: 220,\n};\n\nconst orbit: SpinnerVariant = {\n\tframes: [\"◜\", \"◠\", \"◝\", \"◞\", \"◡\", \"◟\"],\n\tinterval: 110,\n};\n\nconst dna: SpinnerVariant = {\n\tframes: [\"⡀⠀\", \"⠄⠀\", \"⠂⠀\", \"⠁⠀\", \"⠈⠀\", \"⠐⠀\", \"⠠⠀\", \"⢀⠀\"],\n\tinterval: 100,\n};\n\nconst waverows: SpinnerVariant = {\n\tframes: [\"▁\", \"▂\", \"▃\", \"▄\", \"▅\", \"▆\", \"▇\", \"█\", \"▇\", \"▆\", \"▅\", \"▄\", \"▃\", \"▂\"],\n\tinterval: 90,\n};\n\nconst snake: SpinnerVariant = {\n\tframes: [\n\t\t\"▰▱▱▱▱▱▱\",\n\t\t\"▰▰▱▱▱▱▱\",\n\t\t\"▰▰▰▱▱▱▱\",\n\t\t\"▰▰▰▰▱▱▱\",\n\t\t\"▰▰▰▰▰▱▱\",\n\t\t\"▰▰▰▰▰▰▱\",\n\t\t\"▰▰▰▰▰▰▰\",\n\t\t\"▱▰▰▰▰▰▰\",\n\t\t\"▱▱▰▰▰▰▰\",\n\t\t\"▱▱▱▰▰▰▰\",\n\t\t\"▱▱▱▱▰▰▰\",\n\t\t\"▱▱▱▱▱▰▰\",\n\t\t\"▱▱▱▱▱▱▰\",\n\t\t\"▱▱▱▱▱▱▱\",\n\t],\n\tinterval: 100,\n};\n\nconst pulse: SpinnerVariant = {\n\tframes: [\"○\", \"◔\", \"◑\", \"◕\", \"●\", \"◕\", \"◑\", \"◔\"],\n\tinterval: 130,\n};\n\nconst cascade: SpinnerVariant = {\n\tframes: [\"▏\", \"▎\", \"▍\", \"▌\", \"▋\", \"▊\", \"▉\", \"█\", \"▉\", \"▊\", \"▋\", \"▌\", \"▍\", \"▎\"],\n\tinterval: 90,\n};\n\nconst scan: SpinnerVariant = {\n\tframes: [\n\t\t\"[●         ]\",\n\t\t\"[ ●        ]\",\n\t\t\"[  ●       ]\",\n\t\t\"[   ●      ]\",\n\t\t\"[    ●     ]\",\n\t\t\"[     ●    ]\",\n\t\t\"[      ●   ]\",\n\t\t\"[       ●  ]\",\n\t\t\"[        ● ]\",\n\t\t\"[         ●]\",\n\t\t\"[        ● ]\",\n\t\t\"[       ●  ]\",\n\t\t\"[      ●   ]\",\n\t\t\"[     ●    ]\",\n\t\t\"[    ●     ]\",\n\t\t\"[   ●      ]\",\n\t\t\"[  ●       ]\",\n\t\t\"[ ●        ]\",\n\t],\n\tinterval: 90,\n};\n\nconst diagswipe: SpinnerVariant = {\n\tframes: [\"⠁⠀⠀\", \"⠂⠁⠀\", \"⠄⠂⠁\", \"⡀⠄⠂\", \"⠀⡀⠄\", \"⠀⠀⡀\", \"⠀⠀⠀\"],\n\tinterval: 110,\n};\n\nconst fillsweep: SpinnerVariant = {\n\tframes: [\"▱▱▱▱▱\", \"▰▱▱▱▱\", \"▰▰▱▱▱\", \"▰▰▰▱▱\", \"▰▰▰▰▱\", \"▰▰▰▰▰\", \"▱▰▰▰▰\", \"▱▱▰▰▰\", \"▱▱▱▰▰\", \"▱▱▱▱▰\"],\n\tinterval: 110,\n};\n\nconst rain: SpinnerVariant = {\n\tframes: [\"⡀\", \"⡄\", \"⡆\", \"⡇\", \"⠇\", \"⠃\", \"⠁\", \" \"],\n\tinterval: 90,\n};\n\nconst columns: SpinnerVariant = {\n\tframes: [\"▁ ▁ ▁\", \"▃ ▁ ▁\", \"▅ ▃ ▁\", \"▇ ▅ ▃\", \"█ ▇ ▅\", \"▇ █ ▇\", \"▅ ▇ █\", \"▃ ▅ ▇\", \"▁ ▃ ▅\", \"▁ ▁ ▃\"],\n\tinterval: 110,\n};\n\nconst sparkle: SpinnerVariant = {\n\tframes: [\"·\", \"✦\", \"✧\", \"✦\", \"·\", \" \"],\n\tinterval: 160,\n};\n\nexport const SPINNERS = {\n\tdots,\n\thelix,\n\tbreathe,\n\torbit,\n\tdna,\n\twaverows,\n\tsnake,\n\tpulse,\n\tcascade,\n\tscan,\n\tdiagswipe,\n\tfillsweep,\n\train,\n\tcolumns,\n\tsparkle,\n} as const;\n\nexport type SpinnerName = keyof typeof SPINNERS;\n\nexport const THINKING_SPINNERS: readonly SpinnerName[] = [\n\t\"helix\",\n\t\"breathe\",\n\t\"orbit\",\n\t\"dna\",\n\t\"waverows\",\n\t\"snake\",\n\t\"pulse\",\n];\n\nexport const TOOL_SPINNERS: readonly SpinnerName[] = [\n\t\"cascade\",\n\t\"scan\",\n\t\"diagswipe\",\n\t\"fillsweep\",\n\t\"rain\",\n\t\"columns\",\n\t\"sparkle\",\n];\n\nexport function getSpinner(name: string | undefined, fallback: SpinnerName): SpinnerVariant {\n\tif (name && name in SPINNERS) {\n\t\treturn SPINNERS[name as SpinnerName];\n\t}\n\treturn SPINNERS[fallback];\n}\n"]}

package/dist/spinners.js

@@ -0,0 +1,136 @@
+const dots = {
+    frames: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
+    interval: 80,
+};
+const helix = {
+    frames: ["⠁", "⠂", "⠄", "⡀", "⢀", "⠠", "⠐", "⠈"],
+    interval: 90,
+};
+const breathe = {
+    frames: ["·", "•", "●", "•"],
+    interval: 220,
+};
+const orbit = {
+    frames: ["◜", "◠", "◝", "◞", "◡", "◟"],
+    interval: 110,
+};
+const dna = {
+    frames: ["⡀⠀", "⠄⠀", "⠂⠀", "⠁⠀", "⠈⠀", "⠐⠀", "⠠⠀", "⢀⠀"],
+    interval: 100,
+};
+const waverows = {
+    frames: ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█", "▇", "▆", "▅", "▄", "▃", "▂"],
+    interval: 90,
+};
+const snake = {
+    frames: [
+        "▰▱▱▱▱▱▱",
+        "▰▰▱▱▱▱▱",
+        "▰▰▰▱▱▱▱",
+        "▰▰▰▰▱▱▱",
+        "▰▰▰▰▰▱▱",
+        "▰▰▰▰▰▰▱",
+        "▰▰▰▰▰▰▰",
+        "▱▰▰▰▰▰▰",
+        "▱▱▰▰▰▰▰",
+        "▱▱▱▰▰▰▰",
+        "▱▱▱▱▰▰▰",
+        "▱▱▱▱▱▰▰",
+        "▱▱▱▱▱▱▰",
+        "▱▱▱▱▱▱▱",
+    ],
+    interval: 100,
+};
+const pulse = {
+    frames: ["○", "◔", "◑", "◕", "●", "◕", "◑", "◔"],
+    interval: 130,
+};
+const cascade = {
+    frames: ["▏", "▎", "▍", "▌", "▋", "▊", "▉", "█", "▉", "▊", "▋", "▌", "▍", "▎"],
+    interval: 90,
+};
+const scan = {
+    frames: [
+        "[●         ]",
+        "[ ●        ]",
+        "[  ●       ]",
+        "[   ●      ]",
+        "[    ●     ]",
+        "[     ●    ]",
+        "[      ●   ]",
+        "[       ●  ]",
+        "[        ● ]",
+        "[         ●]",
+        "[        ● ]",
+        "[       ●  ]",
+        "[      ●   ]",
+        "[     ●    ]",
+        "[    ●     ]",
+        "[   ●      ]",
+        "[  ●       ]",
+        "[ ●        ]",
+    ],
+    interval: 90,
+};
+const diagswipe = {
+    frames: ["⠁⠀⠀", "⠂⠁⠀", "⠄⠂⠁", "⡀⠄⠂", "⠀⡀⠄", "⠀⠀⡀", "⠀⠀⠀"],
+    interval: 110,
+};
+const fillsweep = {
+    frames: ["▱▱▱▱▱", "▰▱▱▱▱", "▰▰▱▱▱", "▰▰▰▱▱", "▰▰▰▰▱", "▰▰▰▰▰", "▱▰▰▰▰", "▱▱▰▰▰", "▱▱▱▰▰", "▱▱▱▱▰"],
+    interval: 110,
+};
+const rain = {
+    frames: ["⡀", "⡄", "⡆", "⡇", "⠇", "⠃", "⠁", " "],
+    interval: 90,
+};
+const columns = {
+    frames: ["▁ ▁ ▁", "▃ ▁ ▁", "▅ ▃ ▁", "▇ ▅ ▃", "█ ▇ ▅", "▇ █ ▇", "▅ ▇ █", "▃ ▅ ▇", "▁ ▃ ▅", "▁ ▁ ▃"],
+    interval: 110,
+};
+const sparkle = {
+    frames: ["·", "✦", "✧", "✦", "·", " "],
+    interval: 160,
+};
+export const SPINNERS = {
+    dots,
+    helix,
+    breathe,
+    orbit,
+    dna,
+    waverows,
+    snake,
+    pulse,
+    cascade,
+    scan,
+    diagswipe,
+    fillsweep,
+    rain,
+    columns,
+    sparkle,
+};
+export const THINKING_SPINNERS = [
+    "helix",
+    "breathe",
+    "orbit",
+    "dna",
+    "waverows",
+    "snake",
+    "pulse",
+];
+export const TOOL_SPINNERS = [
+    "cascade",
+    "scan",
+    "diagswipe",
+    "fillsweep",
+    "rain",
+    "columns",
+    "sparkle",
+];
+export function getSpinner(name, fallback) {
+    if (name && name in SPINNERS) {
+        return SPINNERS[name];
+    }
+    return SPINNERS[fallback];
+}
+//# sourceMappingURL=spinners.js.map

package/dist/spinners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinners.js","sourceRoot":"","sources":["../src/spinners.ts"],"names":[],"mappings":"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","sourcesContent":["export interface SpinnerVariant {\n\treadonly frames: readonly string[];\n\treadonly interval: number;\n}\n\nconst dots: SpinnerVariant = {\n\tframes: [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"],\n\tinterval: 80,\n};\n\nconst helix: SpinnerVariant = {\n\tframes: [\"⠁\", \"⠂\", \"⠄\", \"⡀\", \"⢀\", \"⠠\", \"⠐\", \"⠈\"],\n\tinterval: 90,\n};\n\nconst breathe: SpinnerVariant = {\n\tframes: [\"·\", \"•\", \"●\", \"•\"],\n\tinterval: 220,\n};\n\nconst orbit: SpinnerVariant = {\n\tframes: [\"◜\", \"◠\", \"◝\", \"◞\", \"◡\", \"◟\"],\n\tinterval: 110,\n};\n\nconst dna: SpinnerVariant = {\n\tframes: [\"⡀⠀\", \"⠄⠀\", \"⠂⠀\", \"⠁⠀\", \"⠈⠀\", \"⠐⠀\", \"⠠⠀\", \"⢀⠀\"],\n\tinterval: 100,\n};\n\nconst waverows: SpinnerVariant = {\n\tframes: [\"▁\", \"▂\", \"▃\", \"▄\", \"▅\", \"▆\", \"▇\", \"█\", \"▇\", \"▆\", \"▅\", \"▄\", \"▃\", \"▂\"],\n\tinterval: 90,\n};\n\nconst snake: SpinnerVariant = {\n\tframes: [\n\t\t\"▰▱▱▱▱▱▱\",\n\t\t\"▰▰▱▱▱▱▱\",\n\t\t\"▰▰▰▱▱▱▱\",\n\t\t\"▰▰▰▰▱▱▱\",\n\t\t\"▰▰▰▰▰▱▱\",\n\t\t\"▰▰▰▰▰▰▱\",\n\t\t\"▰▰▰▰▰▰▰\",\n\t\t\"▱▰▰▰▰▰▰\",\n\t\t\"▱▱▰▰▰▰▰\",\n\t\t\"▱▱▱▰▰▰▰\",\n\t\t\"▱▱▱▱▰▰▰\",\n\t\t\"▱▱▱▱▱▰▰\",\n\t\t\"▱▱▱▱▱▱▰\",\n\t\t\"▱▱▱▱▱▱▱\",\n\t],\n\tinterval: 100,\n};\n\nconst pulse: SpinnerVariant = {\n\tframes: [\"○\", \"◔\", \"◑\", \"◕\", \"●\", \"◕\", \"◑\", \"◔\"],\n\tinterval: 130,\n};\n\nconst cascade: SpinnerVariant = {\n\tframes: [\"▏\", \"▎\", \"▍\", \"▌\", \"▋\", \"▊\", \"▉\", \"█\", \"▉\", \"▊\", \"▋\", \"▌\", \"▍\", \"▎\"],\n\tinterval: 90,\n};\n\nconst scan: SpinnerVariant = {\n\tframes: [\n\t\t\"[●         ]\",\n\t\t\"[ ●        ]\",\n\t\t\"[  ●       ]\",\n\t\t\"[   ●      ]\",\n\t\t\"[    ●     ]\",\n\t\t\"[     ●    ]\",\n\t\t\"[      ●   ]\",\n\t\t\"[       ●  ]\",\n\t\t\"[        ● ]\",\n\t\t\"[         ●]\",\n\t\t\"[        ● ]\",\n\t\t\"[       ●  ]\",\n\t\t\"[      ●   ]\",\n\t\t\"[     ●    ]\",\n\t\t\"[    ●     ]\",\n\t\t\"[   ●      ]\",\n\t\t\"[  ●       ]\",\n\t\t\"[ ●        ]\",\n\t],\n\tinterval: 90,\n};\n\nconst diagswipe: SpinnerVariant = {\n\tframes: [\"⠁⠀⠀\", \"⠂⠁⠀\", \"⠄⠂⠁\", \"⡀⠄⠂\", \"⠀⡀⠄\", \"⠀⠀⡀\", \"⠀⠀⠀\"],\n\tinterval: 110,\n};\n\nconst fillsweep: SpinnerVariant = {\n\tframes: [\"▱▱▱▱▱\", \"▰▱▱▱▱\", \"▰▰▱▱▱\", \"▰▰▰▱▱\", \"▰▰▰▰▱\", \"▰▰▰▰▰\", \"▱▰▰▰▰\", \"▱▱▰▰▰\", \"▱▱▱▰▰\", \"▱▱▱▱▰\"],\n\tinterval: 110,\n};\n\nconst rain: SpinnerVariant = {\n\tframes: [\"⡀\", \"⡄\", \"⡆\", \"⡇\", \"⠇\", \"⠃\", \"⠁\", \" \"],\n\tinterval: 90,\n};\n\nconst columns: SpinnerVariant = {\n\tframes: [\"▁ ▁ ▁\", \"▃ ▁ ▁\", \"▅ ▃ ▁\", \"▇ ▅ ▃\", \"█ ▇ ▅\", \"▇ █ ▇\", \"▅ ▇ █\", \"▃ ▅ ▇\", \"▁ ▃ ▅\", \"▁ ▁ ▃\"],\n\tinterval: 110,\n};\n\nconst sparkle: SpinnerVariant = {\n\tframes: [\"·\", \"✦\", \"✧\", \"✦\", \"·\", \" \"],\n\tinterval: 160,\n};\n\nexport const SPINNERS = {\n\tdots,\n\thelix,\n\tbreathe,\n\torbit,\n\tdna,\n\twaverows,\n\tsnake,\n\tpulse,\n\tcascade,\n\tscan,\n\tdiagswipe,\n\tfillsweep,\n\train,\n\tcolumns,\n\tsparkle,\n} as const;\n\nexport type SpinnerName = keyof typeof SPINNERS;\n\nexport const THINKING_SPINNERS: readonly SpinnerName[] = [\n\t\"helix\",\n\t\"breathe\",\n\t\"orbit\",\n\t\"dna\",\n\t\"waverows\",\n\t\"snake\",\n\t\"pulse\",\n];\n\nexport const TOOL_SPINNERS: readonly SpinnerName[] = [\n\t\"cascade\",\n\t\"scan\",\n\t\"diagswipe\",\n\t\"fillsweep\",\n\t\"rain\",\n\t\"columns\",\n\t\"sparkle\",\n];\n\nexport function getSpinner(name: string | undefined, fallback: SpinnerName): SpinnerVariant {\n\tif (name && name in SPINNERS) {\n\t\treturn SPINNERS[name as SpinnerName];\n\t}\n\treturn SPINNERS[fallback];\n}\n"]}

package/dist/stdin-buffer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * StdinBuffer buffers input and emits complete sequences.
+ *
+ * This is necessary because stdin data events can arrive in partial chunks,
+ * especially for escape sequences like mouse events. Without buffering,
+ * partial sequences can be misinterpreted as regular keypresses.
+ *
+ * For example, the mouse SGR sequence `\x1b[<35;20;5m` might arrive as:
+ * - Event 1: `\x1b`
+ * - Event 2: `[<35`
+ * - Event 3: `;20;5m`
+ *
+ * The buffer accumulates these until a complete sequence is detected.
+ * Call the `process()` method to feed input data.
+ *
+ * Based on code from OpenTUI (https://github.com/anomalyco/opentui)
+ * MIT License - Copyright (c) 2025 opentui
+ */
+import { EventEmitter } from "events";
+export type StdinBufferOptions = {
+    /**
+     * Maximum time to wait for sequence completion (default: 10ms)
+     * After this time, the buffer is flushed even if incomplete
+     */
+    timeout?: number;
+};
+export type StdinBufferEventMap = {
+    data: [string];
+    paste: [string];
+};
+/**
+ * Buffers stdin input and emits complete sequences via the 'data' event.
+ * Handles partial escape sequences that arrive across multiple chunks.
+ */
+export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
+    private buffer;
+    private timeout;
+    private readonly timeoutMs;
+    private pasteMode;
+    private pasteBuffer;
+    constructor(options?: StdinBufferOptions);
+    process(data: string | Buffer): void;
+    flush(): string[];
+    clear(): void;
+    getBuffer(): string;
+    destroy(): void;
+}
+//# sourceMappingURL=stdin-buffer.d.ts.map

package/dist/stdin-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin-buffer.d.ts","sourceRoot":"","sources":["../src/stdin-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AA8MtC,MAAM,MAAM,kBAAkB,GAAG;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IACf,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IACjE,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAc;IAEjC,YAAY,OAAO,GAAE,kBAAuB,EAG3C;IAEM,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiG1C;IAED,KAAK,IAAI,MAAM,EAAE,CAahB;IAED,KAAK,IAAI,IAAI,CAQZ;IAED,SAAS,IAAI,MAAM,CAElB;IAED,OAAO,IAAI,IAAI,CAEd;CACD","sourcesContent":["/**\n * StdinBuffer buffers input and emits complete sequences.\n *\n * This is necessary because stdin data events can arrive in partial chunks,\n * especially for escape sequences like mouse events. Without buffering,\n * partial sequences can be misinterpreted as regular keypresses.\n *\n * For example, the mouse SGR sequence `\\x1b[<35;20;5m` might arrive as:\n * - Event 1: `\\x1b`\n * - Event 2: `[<35`\n * - Event 3: `;20;5m`\n *\n * The buffer accumulates these until a complete sequence is detected.\n * Call the `process()` method to feed input data.\n *\n * Based on code from OpenTUI (https://github.com/anomalyco/opentui)\n * MIT License - Copyright (c) 2025 opentui\n */\n\nimport { EventEmitter } from \"events\";\n\nconst ESC = \"\\x1b\";\nconst BRACKETED_PASTE_START = \"\\x1b[200~\";\nconst BRACKETED_PASTE_END = \"\\x1b[201~\";\n\n/**\n * Check if a string is a complete escape sequence or needs more data\n */\nfunction isCompleteSequence(data: string): \"complete\" | \"incomplete\" | \"not-escape\" {\n\tif (!data.startsWith(ESC)) {\n\t\treturn \"not-escape\";\n\t}\n\n\tif (data.length === 1) {\n\t\treturn \"incomplete\";\n\t}\n\n\tconst afterEsc = data.slice(1);\n\n\t// CSI sequences: ESC [\n\tif (afterEsc.startsWith(\"[\")) {\n\t\t// Check for old-style mouse sequence: ESC[M + 3 bytes\n\t\tif (afterEsc.startsWith(\"[M\")) {\n\t\t\t// Old-style mouse needs ESC[M + 3 bytes = 6 total\n\t\t\treturn data.length >= 6 ? \"complete\" : \"incomplete\";\n\t\t}\n\t\treturn isCompleteCsiSequence(data);\n\t}\n\n\t// OSC sequences: ESC ]\n\tif (afterEsc.startsWith(\"]\")) {\n\t\treturn isCompleteOscSequence(data);\n\t}\n\n\t// DCS sequences: ESC P ... ESC \\ (includes XTVersion responses)\n\tif (afterEsc.startsWith(\"P\")) {\n\t\treturn isCompleteDcsSequence(data);\n\t}\n\n\t// APC sequences: ESC _ ... ESC \\ (includes Kitty graphics responses)\n\tif (afterEsc.startsWith(\"_\")) {\n\t\treturn isCompleteApcSequence(data);\n\t}\n\n\t// SS3 sequences: ESC O\n\tif (afterEsc.startsWith(\"O\")) {\n\t\t// ESC O followed by a single character\n\t\treturn afterEsc.length >= 2 ? \"complete\" : \"incomplete\";\n\t}\n\n\t// Meta key sequences: ESC followed by a single character\n\tif (afterEsc.length === 1) {\n\t\treturn \"complete\";\n\t}\n\n\t// Unknown escape sequence - treat as complete\n\treturn \"complete\";\n}\n\n/**\n * Check if CSI sequence is complete\n * CSI sequences: ESC [ ... followed by a final byte (0x40-0x7E)\n */\nfunction isCompleteCsiSequence(data: string): \"complete\" | \"incomplete\" {\n\tif (!data.startsWith(`${ESC}[`)) {\n\t\treturn \"complete\";\n\t}\n\n\t// Need at least ESC [ and one more character\n\tif (data.length < 3) {\n\t\treturn \"incomplete\";\n\t}\n\n\tconst payload = data.slice(2);\n\n\t// CSI sequences end with a byte in the range 0x40-0x7E (@-~)\n\t// This includes all letters and several special characters\n\tconst lastChar = payload[payload.length - 1];\n\tconst lastCharCode = lastChar.charCodeAt(0);\n\n\tif (lastCharCode >= 0x40 && lastCharCode <= 0x7e) {\n\t\t// Special handling for SGR mouse sequences\n\t\t// Format: ESC[<B;X;Ym or ESC[<B;X;YM\n\t\tif (payload.startsWith(\"<\")) {\n\t\t\t// Must have format: <digits;digits;digits[Mm]\n\t\t\tconst mouseMatch = /^<\\d+;\\d+;\\d+[Mm]$/.test(payload);\n\t\t\tif (mouseMatch) {\n\t\t\t\treturn \"complete\";\n\t\t\t}\n\t\t\t// If it ends with M or m but doesn't match the pattern, still incomplete\n\t\t\tif (lastChar === \"M\" || lastChar === \"m\") {\n\t\t\t\t// Check if we have the right structure\n\t\t\t\tconst parts = payload.slice(1, -1).split(\";\");\n\t\t\t\tif (parts.length === 3 && parts.every((p) => /^\\d+$/.test(p))) {\n\t\t\t\t\treturn \"complete\";\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn \"incomplete\";\n\t\t}\n\n\t\treturn \"complete\";\n\t}\n\n\treturn \"incomplete\";\n}\n\n/**\n * Check if OSC sequence is complete\n * OSC sequences: ESC ] ... ST (where ST is ESC \\ or BEL)\n */\nfunction isCompleteOscSequence(data: string): \"complete\" | \"incomplete\" {\n\tif (!data.startsWith(`${ESC}]`)) {\n\t\treturn \"complete\";\n\t}\n\n\t// OSC sequences end with ST (ESC \\) or BEL (\\x07)\n\tif (data.endsWith(`${ESC}\\\\`) || data.endsWith(\"\\x07\")) {\n\t\treturn \"complete\";\n\t}\n\n\treturn \"incomplete\";\n}\n\n/**\n * Check if DCS (Device Control String) sequence is complete\n * DCS sequences: ESC P ... ST (where ST is ESC \\)\n * Used for XTVersion responses like ESC P >| ... ESC \\\n */\nfunction isCompleteDcsSequence(data: string): \"complete\" | \"incomplete\" {\n\tif (!data.startsWith(`${ESC}P`)) {\n\t\treturn \"complete\";\n\t}\n\n\t// DCS sequences end with ST (ESC \\)\n\tif (data.endsWith(`${ESC}\\\\`)) {\n\t\treturn \"complete\";\n\t}\n\n\treturn \"incomplete\";\n}\n\n/**\n * Check if APC (Application Program Command) sequence is complete\n * APC sequences: ESC _ ... ST (where ST is ESC \\)\n * Used for Kitty graphics responses like ESC _ G ... ESC \\\n */\nfunction isCompleteApcSequence(data: string): \"complete\" | \"incomplete\" {\n\tif (!data.startsWith(`${ESC}_`)) {\n\t\treturn \"complete\";\n\t}\n\n\t// APC sequences end with ST (ESC \\)\n\tif (data.endsWith(`${ESC}\\\\`)) {\n\t\treturn \"complete\";\n\t}\n\n\treturn \"incomplete\";\n}\n\n/**\n * Split accumulated buffer into complete sequences\n */\nfunction extractCompleteSequences(buffer: string): { sequences: string[]; remainder: string } {\n\tconst sequences: string[] = [];\n\tlet pos = 0;\n\n\twhile (pos < buffer.length) {\n\t\tconst remaining = buffer.slice(pos);\n\n\t\t// Try to extract a sequence starting at this position\n\t\tif (remaining.startsWith(ESC)) {\n\t\t\t// Find the end of this escape sequence\n\t\t\tlet seqEnd = 1;\n\t\t\twhile (seqEnd <= remaining.length) {\n\t\t\t\tconst candidate = remaining.slice(0, seqEnd);\n\t\t\t\tconst status = isCompleteSequence(candidate);\n\n\t\t\t\tif (status === \"complete\") {\n\t\t\t\t\tsequences.push(candidate);\n\t\t\t\t\tpos += seqEnd;\n\t\t\t\t\tbreak;\n\t\t\t\t} else if (status === \"incomplete\") {\n\t\t\t\t\tseqEnd++;\n\t\t\t\t} else {\n\t\t\t\t\t// Should not happen when starting with ESC\n\t\t\t\t\tsequences.push(candidate);\n\t\t\t\t\tpos += seqEnd;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (seqEnd > remaining.length) {\n\t\t\t\treturn { sequences, remainder: remaining };\n\t\t\t}\n\t\t} else {\n\t\t\t// Not an escape sequence - take a single character\n\t\t\tsequences.push(remaining[0]!);\n\t\t\tpos++;\n\t\t}\n\t}\n\n\treturn { sequences, remainder: \"\" };\n}\n\nexport type StdinBufferOptions = {\n\t/**\n\t * Maximum time to wait for sequence completion (default: 10ms)\n\t * After this time, the buffer is flushed even if incomplete\n\t */\n\ttimeout?: number;\n};\n\nexport type StdinBufferEventMap = {\n\tdata: [string];\n\tpaste: [string];\n};\n\n/**\n * Buffers stdin input and emits complete sequences via the 'data' event.\n * Handles partial escape sequences that arrive across multiple chunks.\n */\nexport class StdinBuffer extends EventEmitter<StdinBufferEventMap> {\n\tprivate buffer: string = \"\";\n\tprivate timeout: ReturnType<typeof setTimeout> | null = null;\n\tprivate readonly timeoutMs: number;\n\tprivate pasteMode: boolean = false;\n\tprivate pasteBuffer: string = \"\";\n\n\tconstructor(options: StdinBufferOptions = {}) {\n\t\tsuper();\n\t\tthis.timeoutMs = options.timeout ?? 10;\n\t}\n\n\tpublic process(data: string | Buffer): void {\n\t\t// Clear any pending timeout\n\t\tif (this.timeout) {\n\t\t\tclearTimeout(this.timeout);\n\t\t\tthis.timeout = null;\n\t\t}\n\n\t\t// Handle high-byte conversion (for compatibility with parseKeypress)\n\t\t// If buffer has single byte > 127, convert to ESC + (byte - 128)\n\t\tlet str: string;\n\t\tif (Buffer.isBuffer(data)) {\n\t\t\tif (data.length === 1 && data[0]! > 127) {\n\t\t\t\tconst byte = data[0]! - 128;\n\t\t\t\tstr = `\\x1b${String.fromCharCode(byte)}`;\n\t\t\t} else {\n\t\t\t\tstr = data.toString();\n\t\t\t}\n\t\t} else {\n\t\t\tstr = data;\n\t\t}\n\n\t\tif (str.length === 0 && this.buffer.length === 0) {\n\t\t\tthis.emit(\"data\", \"\");\n\t\t\treturn;\n\t\t}\n\n\t\tthis.buffer += str;\n\n\t\tif (this.pasteMode) {\n\t\t\tthis.pasteBuffer += this.buffer;\n\t\t\tthis.buffer = \"\";\n\n\t\t\tconst endIndex = this.pasteBuffer.indexOf(BRACKETED_PASTE_END);\n\t\t\tif (endIndex !== -1) {\n\t\t\t\tconst pastedContent = this.pasteBuffer.slice(0, endIndex);\n\t\t\t\tconst remaining = this.pasteBuffer.slice(endIndex + BRACKETED_PASTE_END.length);\n\n\t\t\t\tthis.pasteMode = false;\n\t\t\t\tthis.pasteBuffer = \"\";\n\n\t\t\t\tthis.emit(\"paste\", pastedContent);\n\n\t\t\t\tif (remaining.length > 0) {\n\t\t\t\t\tthis.process(remaining);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tconst startIndex = this.buffer.indexOf(BRACKETED_PASTE_START);\n\t\tif (startIndex !== -1) {\n\t\t\tif (startIndex > 0) {\n\t\t\t\tconst beforePaste = this.buffer.slice(0, startIndex);\n\t\t\t\tconst result = extractCompleteSequences(beforePaste);\n\t\t\t\tfor (const sequence of result.sequences) {\n\t\t\t\t\tthis.emit(\"data\", sequence);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthis.buffer = this.buffer.slice(startIndex + BRACKETED_PASTE_START.length);\n\t\t\tthis.pasteMode = true;\n\t\t\tthis.pasteBuffer = this.buffer;\n\t\t\tthis.buffer = \"\";\n\n\t\t\tconst endIndex = this.pasteBuffer.indexOf(BRACKETED_PASTE_END);\n\t\t\tif (endIndex !== -1) {\n\t\t\t\tconst pastedContent = this.pasteBuffer.slice(0, endIndex);\n\t\t\t\tconst remaining = this.pasteBuffer.slice(endIndex + BRACKETED_PASTE_END.length);\n\n\t\t\t\tthis.pasteMode = false;\n\t\t\t\tthis.pasteBuffer = \"\";\n\n\t\t\t\tthis.emit(\"paste\", pastedContent);\n\n\t\t\t\tif (remaining.length > 0) {\n\t\t\t\t\tthis.process(remaining);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tconst result = extractCompleteSequences(this.buffer);\n\t\tthis.buffer = result.remainder;\n\n\t\tfor (const sequence of result.sequences) {\n\t\t\tthis.emit(\"data\", sequence);\n\t\t}\n\n\t\tif (this.buffer.length > 0) {\n\t\t\tthis.timeout = setTimeout(() => {\n\t\t\t\tconst flushed = this.flush();\n\n\t\t\t\tfor (const sequence of flushed) {\n\t\t\t\t\tthis.emit(\"data\", sequence);\n\t\t\t\t}\n\t\t\t}, this.timeoutMs);\n\t\t}\n\t}\n\n\tflush(): string[] {\n\t\tif (this.timeout) {\n\t\t\tclearTimeout(this.timeout);\n\t\t\tthis.timeout = null;\n\t\t}\n\n\t\tif (this.buffer.length === 0) {\n\t\t\treturn [];\n\t\t}\n\n\t\tconst sequences = [this.buffer];\n\t\tthis.buffer = \"\";\n\t\treturn sequences;\n\t}\n\n\tclear(): void {\n\t\tif (this.timeout) {\n\t\t\tclearTimeout(this.timeout);\n\t\t\tthis.timeout = null;\n\t\t}\n\t\tthis.buffer = \"\";\n\t\tthis.pasteMode = false;\n\t\tthis.pasteBuffer = \"\";\n\t}\n\n\tgetBuffer(): string {\n\t\treturn this.buffer;\n\t}\n\n\tdestroy(): void {\n\t\tthis.clear();\n\t}\n}\n"]}