@opengsd/gsd-pi 1.0.0

package/packages/pi-tui/dist/components/__tests__/box.test.js

@@ -0,0 +1,20 @@
+// GSD-2 + packages/pi-tui/src/components/__tests__/box.test.ts - Box width-discipline regression coverage.
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { visibleWidth } from "../../utils.js";
+import { Box } from "../box.js";
+describe("Box", () => {
+    it("keeps rendered lines within width even when a child overflows its content budget", () => {
+        const box = new Box(1, 0);
+        const child = {
+            render: () => ["abcdefghij"],
+            invalidate() { },
+        };
+        box.addChild(child);
+        const rendered = box.render(6);
+        assert.equal(rendered.length, 1);
+        assert.equal(visibleWidth(rendered[0]), 6);
+        assert.ok(visibleWidth(rendered[0]) <= 6);
+    });
+});
+//# sourceMappingURL=box.test.js.map

package/packages/pi-tui/dist/components/__tests__/box.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.test.js","sourceRoot":"","sources":["../../../src/components/__tests__/box.test.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAE3G,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACpB,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC3F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAc;YACxB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC;YAC5B,UAAU,KAAI,CAAC;SACf,CAAC;QACF,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEpB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAE/B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["// GSD-2 + packages/pi-tui/src/components/__tests__/box.test.ts - Box width-discipline regression coverage.\n\nimport assert from \"node:assert/strict\";\nimport { describe, it } from \"node:test\";\n\nimport type { Component } from \"../../tui.js\";\nimport { visibleWidth } from \"../../utils.js\";\nimport { Box } from \"../box.js\";\n\ndescribe(\"Box\", () => {\n\tit(\"keeps rendered lines within width even when a child overflows its content budget\", () => {\n\t\tconst box = new Box(1, 0);\n\t\tconst child: Component = {\n\t\t\trender: () => [\"abcdefghij\"],\n\t\t\tinvalidate() {},\n\t\t};\n\t\tbox.addChild(child);\n\n\t\tconst rendered = box.render(6);\n\n\t\tassert.equal(rendered.length, 1);\n\t\tassert.equal(visibleWidth(rendered[0]), 6);\n\t\tassert.ok(visibleWidth(rendered[0]) <= 6);\n\t});\n});\n"]}

package/packages/pi-tui/dist/components/__tests__/cancellable-loader.test.d.ts

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

package/packages/pi-tui/dist/components/__tests__/cancellable-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellable-loader.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/cancellable-loader.test.ts"],"names":[],"mappings":""}

package/packages/pi-tui/dist/components/__tests__/cancellable-loader.test.js

@@ -0,0 +1,38 @@
+// pi-tui CancellableLoader component regression tests
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { describe, it, mock, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { CancellableLoader } from "../cancellable-loader.js";
+function makeMockTUI() {
+    return { requestRender: mock.fn() };
+}
+describe("CancellableLoader", () => {
+    let loader;
+    let tui;
+    beforeEach(() => {
+        tui = makeMockTUI();
+    });
+    afterEach(() => {
+        loader?.dispose();
+    });
+    it("dispose() aborts the AbortController signal", () => {
+        loader = new CancellableLoader(tui, (s) => s, (s) => s, "test");
+        assert.equal(loader.aborted, false);
+        loader.dispose();
+        assert.equal(loader.aborted, true);
+    });
+    it("dispose() clears the onAbort callback", () => {
+        loader = new CancellableLoader(tui, (s) => s, (s) => s, "test");
+        loader.onAbort = () => { };
+        loader.dispose();
+        assert.equal(loader.onAbort, undefined);
+    });
+    it("signal is aborted after dispose()", () => {
+        loader = new CancellableLoader(tui, (s) => s, (s) => s, "test");
+        const signal = loader.signal;
+        assert.equal(signal.aborted, false);
+        loader.dispose();
+        assert.equal(signal.aborted, true);
+    });
+});
+//# sourceMappingURL=cancellable-loader.test.js.map

package/packages/pi-tui/dist/components/__tests__/cancellable-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellable-loader.test.js","sourceRoot":"","sources":["../../../src/components/__tests__/cancellable-loader.test.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,4DAA4D;AAE5D,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,SAAS,WAAW;IACnB,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE,EAAS,CAAC;AAC5C,CAAC;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAClC,IAAI,MAAyB,CAAC;IAC9B,IAAI,GAAmC,CAAC;IAExC,UAAU,CAAC,GAAG,EAAE;QACf,GAAG,GAAG,WAAW,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,EAAE,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,IAAI,iBAAiB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,IAAI,iBAAiB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,IAAI,iBAAiB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["// pi-tui CancellableLoader component regression tests\n// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>\n\nimport { describe, it, mock, beforeEach, afterEach } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { CancellableLoader } from \"../cancellable-loader.js\";\n\nfunction makeMockTUI() {\n\treturn { requestRender: mock.fn() } as any;\n}\n\ndescribe(\"CancellableLoader\", () => {\n\tlet loader: CancellableLoader;\n\tlet tui: ReturnType<typeof makeMockTUI>;\n\n\tbeforeEach(() => {\n\t\ttui = makeMockTUI();\n\t});\n\n\tafterEach(() => {\n\t\tloader?.dispose();\n\t});\n\n\tit(\"dispose() aborts the AbortController signal\", () => {\n\t\tloader = new CancellableLoader(tui, (s) => s, (s) => s, \"test\");\n\t\tassert.equal(loader.aborted, false);\n\t\tloader.dispose();\n\t\tassert.equal(loader.aborted, true);\n\t});\n\n\tit(\"dispose() clears the onAbort callback\", () => {\n\t\tloader = new CancellableLoader(tui, (s) => s, (s) => s, \"test\");\n\t\tloader.onAbort = () => {};\n\t\tloader.dispose();\n\t\tassert.equal(loader.onAbort, undefined);\n\t});\n\n\tit(\"signal is aborted after dispose()\", () => {\n\t\tloader = new CancellableLoader(tui, (s) => s, (s) => s, \"test\");\n\t\tconst signal = loader.signal;\n\t\tassert.equal(signal.aborted, false);\n\t\tloader.dispose();\n\t\tassert.equal(signal.aborted, true);\n\t});\n});\n"]}

package/packages/pi-tui/dist/components/__tests__/editor.test.d.ts

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

package/packages/pi-tui/dist/components/__tests__/editor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/editor.test.ts"],"names":[],"mappings":""}

package/packages/pi-tui/dist/components/__tests__/editor.test.js

@@ -0,0 +1,89 @@
+// GSD-2 + packages/pi-tui/src/components/__tests__/editor.test.ts - Editor component regression tests.
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { Editor } from "../editor.js";
+import { CURSOR_MARKER, TUI } from "../../tui.js";
+function makeTerminal() {
+    return {
+        isTTY: true,
+        columns: 80,
+        rows: 24,
+        kittyProtocolActive: false,
+        start() { },
+        stop() { },
+        drainInput: async () => { },
+        write() { },
+        moveBy() { },
+        hideCursor() { },
+        showCursor() { },
+        clearLine() { },
+        clearFromCursor() { },
+        clearScreen() { },
+        setTitle() { },
+    };
+}
+const theme = {
+    borderColor: (text) => text,
+    selectList: {
+        selectedPrefix: (text) => text,
+        selectedText: (text) => text,
+        description: (text) => text,
+        scrollInfo: (text) => text,
+        noMatch: (text) => text,
+    },
+};
+describe("Editor", () => {
+    it("clears bracketed paste state when focus is lost", () => {
+        const editor = new Editor(new TUI(makeTerminal()), theme);
+        editor.focused = true;
+        editor.handleInput("\x1b[200~partial");
+        editor.focused = false;
+        editor.focused = true;
+        editor.handleInput("hello");
+        assert.equal(editor.getText(), "hello");
+    });
+    it("keeps the hardware cursor marker visible while autocomplete is open", () => {
+        const editor = new Editor(new TUI(makeTerminal()), theme);
+        editor.focused = true;
+        editor.setText("/se");
+        editor.autocompleteState = "regular";
+        editor.autocompleteList = { render: () => [] };
+        const rendered = editor.render(40).join("\n");
+        assert.ok(rendered.includes(CURSOR_MARKER));
+    });
+    it("keeps autocomplete height stable while suggestions shrink", () => {
+        const editor = new Editor(new TUI(makeTerminal()), theme);
+        editor.focused = true;
+        editor.setText("/");
+        let autocompleteRows = [
+            "/gsd",
+            "/git",
+            "/grep",
+            "/go",
+            "/group",
+            "(1/6)",
+        ];
+        editor.autocompleteState = "regular";
+        editor.autocompleteList = { render: () => autocompleteRows };
+        const openLength = editor.render(40).length;
+        autocompleteRows = ["/gsd"];
+        const filteredLength = editor.render(40).length;
+        assert.equal(filteredLength, openLength, "autocomplete should reserve rows during a completion session so filtering does not resize the TUI");
+        editor.cancelAutocomplete();
+        const closedLength = editor.render(40).length;
+        assert.ok(closedLength < openLength, "autocomplete row reservation should clear when the completion session closes");
+    });
+    it("maps kitty keypad digits to plain editor text", () => {
+        const editor = new Editor(new TUI(makeTerminal()), theme);
+        editor.focused = true;
+        editor.handleInput("\x1b[57404;129u");
+        assert.equal(editor.getText(), "5");
+    });
+    it("does not insert kitty keypad navigation private-use glyphs into the editor", () => {
+        const editor = new Editor(new TUI(makeTerminal()), theme);
+        editor.focused = true;
+        editor.handleInput("\x1b[57419u");
+        assert.equal(editor.getText(), "");
+    });
+});
+//# sourceMappingURL=editor.test.js.map

package/packages/pi-tui/dist/components/__tests__/editor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.test.js","sourceRoot":"","sources":["../../../src/components/__tests__/editor.test.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD-2 + packages/pi-tui/src/components/__tests__/editor.test.ts - Editor component regression tests.\n\nimport assert from \"node:assert/strict\";\nimport { describe, it } from \"node:test\";\n\nimport { Editor, type EditorTheme } from \"../editor.js\";\nimport { CURSOR_MARKER, TUI } from \"../../tui.js\";\nimport type { Terminal } from \"../../terminal.js\";\n\nfunction makeTerminal(): Terminal {\n\treturn {\n\t\tisTTY: true,\n\t\tcolumns: 80,\n\t\trows: 24,\n\t\tkittyProtocolActive: false,\n\t\tstart() {},\n\t\tstop() {},\n\t\tdrainInput: async () => {},\n\t\twrite() {},\n\t\tmoveBy() {},\n\t\thideCursor() {},\n\t\tshowCursor() {},\n\t\tclearLine() {},\n\t\tclearFromCursor() {},\n\t\tclearScreen() {},\n\t\tsetTitle() {},\n\t};\n}\n\nconst theme: EditorTheme = {\n\tborderColor: (text) => text,\n\tselectList: {\n\t\tselectedPrefix: (text) => text,\n\t\tselectedText: (text) => text,\n\t\tdescription: (text) => text,\n\t\tscrollInfo: (text) => text,\n\t\tnoMatch: (text) => text,\n\t},\n};\n\ndescribe(\"Editor\", () => {\n\tit(\"clears bracketed paste state when focus is lost\", () => {\n\t\tconst editor = new Editor(new TUI(makeTerminal()), theme);\n\t\teditor.focused = true;\n\n\t\teditor.handleInput(\"\\x1b[200~partial\");\n\t\teditor.focused = false;\n\t\teditor.focused = true;\n\t\teditor.handleInput(\"hello\");\n\n\t\tassert.equal(editor.getText(), \"hello\");\n\t});\n\n\tit(\"keeps the hardware cursor marker visible while autocomplete is open\", () => {\n\t\tconst editor = new Editor(new TUI(makeTerminal()), theme);\n\t\teditor.focused = true;\n\t\teditor.setText(\"/se\");\n\n\t\t(editor as any).autocompleteState = \"regular\";\n\t\t(editor as any).autocompleteList = { render: () => [] };\n\n\t\tconst rendered = editor.render(40).join(\"\\n\");\n\n\t\tassert.ok(rendered.includes(CURSOR_MARKER));\n\t});\n\n\tit(\"keeps autocomplete height stable while suggestions shrink\", () => {\n\t\tconst editor = new Editor(new TUI(makeTerminal()), theme);\n\t\teditor.focused = true;\n\t\teditor.setText(\"/\");\n\n\t\tlet autocompleteRows = [\n\t\t\t\"/gsd\",\n\t\t\t\"/git\",\n\t\t\t\"/grep\",\n\t\t\t\"/go\",\n\t\t\t\"/group\",\n\t\t\t\"(1/6)\",\n\t\t];\n\t\t(editor as any).autocompleteState = \"regular\";\n\t\t(editor as any).autocompleteList = { render: () => autocompleteRows };\n\n\t\tconst openLength = editor.render(40).length;\n\n\t\tautocompleteRows = [\"/gsd\"];\n\t\tconst filteredLength = editor.render(40).length;\n\n\t\tassert.equal(\n\t\t\tfilteredLength,\n\t\t\topenLength,\n\t\t\t\"autocomplete should reserve rows during a completion session so filtering does not resize the TUI\",\n\t\t);\n\n\t\t(editor as any).cancelAutocomplete();\n\t\tconst closedLength = editor.render(40).length;\n\t\tassert.ok(\n\t\t\tclosedLength < openLength,\n\t\t\t\"autocomplete row reservation should clear when the completion session closes\",\n\t\t);\n\t});\n\n\tit(\"maps kitty keypad digits to plain editor text\", () => {\n\t\tconst editor = new Editor(new TUI(makeTerminal()), theme);\n\t\teditor.focused = true;\n\n\t\teditor.handleInput(\"\\x1b[57404;129u\");\n\n\t\tassert.equal(editor.getText(), \"5\");\n\t});\n\n\tit(\"does not insert kitty keypad navigation private-use glyphs into the editor\", () => {\n\t\tconst editor = new Editor(new TUI(makeTerminal()), theme);\n\t\teditor.focused = true;\n\n\t\teditor.handleInput(\"\\x1b[57419u\");\n\n\t\tassert.equal(editor.getText(), \"\");\n\t});\n});\n"]}

package/packages/pi-tui/dist/components/__tests__/input.test.d.ts

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

package/packages/pi-tui/dist/components/__tests__/input.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/input.test.ts"],"names":[],"mappings":""}

package/packages/pi-tui/dist/components/__tests__/input.test.js

@@ -0,0 +1,81 @@
+// pi-tui Input component regression tests
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { stripVTControlCharacters } from "node:util";
+import { Input } from "../input.js";
+describe("Input", () => {
+    it("paste buffer is cleared when focus is lost", () => {
+        const input = new Input();
+        input.focused = true;
+        // Simulate starting a paste (bracket paste start marker)
+        input.handleInput("\x1b[200~partial");
+        // Now lose focus mid-paste
+        input.focused = false;
+        // Regain focus — should not have stale paste state
+        input.focused = true;
+        // Typing normal text should work without paste buffer corruption
+        input.handleInput("hello");
+        assert.equal(input.getValue(), "hello");
+    });
+    it("focused getter/setter works correctly", () => {
+        const input = new Input();
+        assert.equal(input.focused, false);
+        input.focused = true;
+        assert.equal(input.focused, true);
+        input.focused = false;
+        assert.equal(input.focused, false);
+    });
+    it("secure mode obscures typed characters in render output", () => {
+        const input = new Input();
+        input.secure = true;
+        input.focused = true;
+        const hiddenText = "sample-hidden-value";
+        input.handleInput(hiddenText);
+        const line = input.render(40)[0] ?? "";
+        // Previous assertion was `line.includes("*********")` — a literal
+        // 9-star string that silently goes stale if the fixture is renamed to
+        // a different length (#4796). Match any run of asterisks and
+        // assert its length covers the hidden text.
+        assert.ok(!line.includes(hiddenText), "rendered line must not expose raw secret text");
+        const maskMatch = line.match(/\*+/);
+        assert.ok(maskMatch, `rendered line must include masked characters, got: ${JSON.stringify(line)}`);
+        assert.ok(maskMatch[0].length >= hiddenText.length, `mask must cover at least the hidden text length (${hiddenText.length}), got ${maskMatch[0].length} asterisks`);
+    });
+    it("maps kitty keypad digits to text instead of inserting private-use glyphs", () => {
+        const input = new Input();
+        input.focused = true;
+        input.handleInput("\x1b[57400;129u");
+        assert.equal(input.getValue(), "1");
+    });
+    it("ignores kitty keypad navigation keys in text input", () => {
+        const input = new Input();
+        input.focused = true;
+        input.handleInput("\x1b[57417u");
+        assert.equal(input.getValue(), "");
+    });
+    it("keeps yank-pop cursor at or above zero after external value shrink", () => {
+        const input = new Input();
+        input.handleInput("first");
+        input.handleInput("\x15"); // Ctrl+U: kill to line start
+        input.handleInput("second");
+        input.handleInput("\x15"); // Ctrl+U: kill another entry
+        input.handleInput("\x19"); // Ctrl+Y: yank "second"
+        input.setValue("");
+        input.handleInput("\x1by"); // Alt+Y: yank-pop to "first"
+        assert.equal(input.getValue(), "first");
+        const rendered = stripVTControlCharacters(input.render(20)[0] ?? "");
+        assert.doesNotMatch(rendered, /firstfirst/, "negative cursor must not duplicate rendered text");
+        assert.match(rendered, /^> first /, "cursor should land after the replacement text");
+    });
+    it("caps oversized bracketed paste before inserting into the input value", () => {
+        const input = new Input();
+        const pasteLimit = 100_000;
+        input.focused = true;
+        input.handleInput(`\x1b[200~${"a".repeat(pasteLimit + 10)}\x1b[201~`);
+        assert.equal(input.getValue().length, pasteLimit);
+        input.handleInput("\x1f"); // Ctrl+-: undo
+        assert.equal(input.getValue(), "", "capped paste should still undo as a single edit");
+    });
+});
+//# sourceMappingURL=input.test.js.map

package/packages/pi-tui/dist/components/__tests__/input.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.test.js","sourceRoot":"","sources":["../../../src/components/__tests__/input.test.ts"],"names":[],"mappings":"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","sourcesContent":["// pi-tui Input component regression tests\n// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>\n\nimport { describe, it } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { stripVTControlCharacters } from \"node:util\";\nimport { Input } from \"../input.js\";\n\ndescribe(\"Input\", () => {\n\tit(\"paste buffer is cleared when focus is lost\", () => {\n\t\tconst input = new Input();\n\t\tinput.focused = true;\n\n\t\t// Simulate starting a paste (bracket paste start marker)\n\t\tinput.handleInput(\"\\x1b[200~partial\");\n\n\t\t// Now lose focus mid-paste\n\t\tinput.focused = false;\n\n\t\t// Regain focus — should not have stale paste state\n\t\tinput.focused = true;\n\n\t\t// Typing normal text should work without paste buffer corruption\n\t\tinput.handleInput(\"hello\");\n\t\tassert.equal(input.getValue(), \"hello\");\n\t});\n\n\tit(\"focused getter/setter works correctly\", () => {\n\t\tconst input = new Input();\n\t\tassert.equal(input.focused, false);\n\t\tinput.focused = true;\n\t\tassert.equal(input.focused, true);\n\t\tinput.focused = false;\n\t\tassert.equal(input.focused, false);\n\t});\n\n\tit(\"secure mode obscures typed characters in render output\", () => {\n\t\tconst input = new Input();\n\t\tinput.secure = true;\n\t\tinput.focused = true;\n\t\tconst hiddenText = \"sample-hidden-value\";\n\t\tinput.handleInput(hiddenText);\n\n\t\tconst line = input.render(40)[0] ?? \"\";\n\t\t// Previous assertion was `line.includes(\"*********\")` — a literal\n\t\t// 9-star string that silently goes stale if the fixture is renamed to\n\t\t// a different length (#4796). Match any run of asterisks and\n\t\t// assert its length covers the hidden text.\n\t\tassert.ok(\n\t\t\t!line.includes(hiddenText),\n\t\t\t\"rendered line must not expose raw secret text\",\n\t\t);\n\t\tconst maskMatch = line.match(/\\*+/);\n\t\tassert.ok(\n\t\t\tmaskMatch,\n\t\t\t`rendered line must include masked characters, got: ${JSON.stringify(line)}`,\n\t\t);\n\t\tassert.ok(\n\t\t\tmaskMatch[0].length >= hiddenText.length,\n\t\t\t`mask must cover at least the hidden text length (${hiddenText.length}), got ${maskMatch[0].length} asterisks`,\n\t\t);\n\t});\n\n\tit(\"maps kitty keypad digits to text instead of inserting private-use glyphs\", () => {\n\t\tconst input = new Input();\n\t\tinput.focused = true;\n\n\t\tinput.handleInput(\"\\x1b[57400;129u\");\n\n\t\tassert.equal(input.getValue(), \"1\");\n\t});\n\n\tit(\"ignores kitty keypad navigation keys in text input\", () => {\n\t\tconst input = new Input();\n\t\tinput.focused = true;\n\n\t\tinput.handleInput(\"\\x1b[57417u\");\n\n\t\tassert.equal(input.getValue(), \"\");\n\t});\n\n\tit(\"keeps yank-pop cursor at or above zero after external value shrink\", () => {\n\t\tconst input = new Input();\n\n\t\tinput.handleInput(\"first\");\n\t\tinput.handleInput(\"\\x15\"); // Ctrl+U: kill to line start\n\t\tinput.handleInput(\"second\");\n\t\tinput.handleInput(\"\\x15\"); // Ctrl+U: kill another entry\n\t\tinput.handleInput(\"\\x19\"); // Ctrl+Y: yank \"second\"\n\n\t\tinput.setValue(\"\");\n\t\tinput.handleInput(\"\\x1by\"); // Alt+Y: yank-pop to \"first\"\n\n\t\tassert.equal(input.getValue(), \"first\");\n\t\tconst rendered = stripVTControlCharacters(input.render(20)[0] ?? \"\");\n\t\tassert.doesNotMatch(rendered, /firstfirst/, \"negative cursor must not duplicate rendered text\");\n\t\tassert.match(rendered, /^> first /, \"cursor should land after the replacement text\");\n\t});\n\n\tit(\"caps oversized bracketed paste before inserting into the input value\", () => {\n\t\tconst input = new Input();\n\t\tconst pasteLimit = 100_000;\n\t\tinput.focused = true;\n\n\t\tinput.handleInput(`\\x1b[200~${\"a\".repeat(pasteLimit + 10)}\\x1b[201~`);\n\n\t\tassert.equal(input.getValue().length, pasteLimit);\n\t\tinput.handleInput(\"\\x1f\"); // Ctrl+-: undo\n\t\tassert.equal(input.getValue(), \"\", \"capped paste should still undo as a single edit\");\n\t});\n});\n"]}

package/packages/pi-tui/dist/components/__tests__/leak-fixes-runtime.test.d.ts

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

package/packages/pi-tui/dist/components/__tests__/leak-fixes-runtime.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leak-fixes-runtime.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/leak-fixes-runtime.test.ts"],"names":[],"mappings":""}

package/packages/pi-tui/dist/components/__tests__/leak-fixes-runtime.test.js

@@ -0,0 +1,161 @@
+// Runtime regression tests for the long-running-session leak fixes.
+//
+// Replaces the source-grep file `src/tests/session-memory-leaks.test.ts`
+// (deleted in #4875, tracked as #4873). The previous tests asserted on
+// identifier presence (`_prevRender`, `_lastMessage`, `MAX_CHAT_COMPONENTS`)
+// in source — a regression that set `MAX_CHAT_COMPONENTS = Number.MAX_SAFE_INTEGER`
+// or replaced `setText` with an inline mutation would still pass.
+//
+// Each test below drives the actual component through a long-running scenario
+// and asserts on observable behaviour.
+import { describe, it, mock, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { Container } from "../../tui.js";
+import { Loader } from "../loader.js";
+import { Text } from "../text.js";
+function makeMockTUI() {
+    return { requestRender: mock.fn() };
+}
+// ─── Container render-skip ──────────────────────────────────────────────
+describe("Container.render skips work when output is unchanged", () => {
+    it("returns the SAME array reference across two renders with no changes", () => {
+        // The container caches `_prevRender` so doRender() can short-circuit
+        // the post-processing (image-line scan, applyLineResets, line diffs).
+        // The contract for the optimization is reference equality of the
+        // returned array — that's what the consumer in tui.ts checks.
+        const c = new Container();
+        c.addChild(new Text("hello", 0, 0));
+        const first = c.render(20);
+        const second = c.render(20);
+        assert.strictEqual(second, first, "Container must return the same array reference when content is unchanged " +
+            "(reference equality is the consumer-visible contract for the skip)");
+    });
+    it("returns a DIFFERENT array reference after addChild invalidates the cache", () => {
+        // If a regression caused `_prevRender` to never reset, downstream
+        // rendering would skip post-processing for new components — visible
+        // as missing/stale UI. Behaviourally we observe that adding a child
+        // breaks the reference-equality contract on the next render.
+        const c = new Container();
+        c.addChild(new Text("a", 0, 0));
+        const first = c.render(20);
+        c.addChild(new Text("b", 0, 0));
+        const second = c.render(20);
+        assert.notStrictEqual(second, first, "adding a child must invalidate the cached render reference");
+    });
+    it("returns a different reference after content changes", () => {
+        const t = new Text("hello", 0, 0);
+        const c = new Container();
+        c.addChild(t);
+        const first = c.render(20);
+        t.setText("world");
+        const second = c.render(20);
+        assert.notStrictEqual(second, first, "changing a child's text must produce a fresh array (not the cached one)");
+    });
+});
+// ─── Loader frame isolation ─────────────────────────────────────────────
+describe("Loader does not mutate Text cache on every spinner tick", () => {
+    let tui;
+    let loader;
+    beforeEach(() => {
+        tui = makeMockTUI();
+        mock.timers.enable({ apis: ["setInterval"] });
+    });
+    afterEach(() => {
+        try {
+            loader?.stop();
+        }
+        catch {
+            /* best-effort */
+        }
+        mock.timers.reset();
+    });
+    it("does not invalidate Text's render cache across N spinner ticks", () => {
+        // Loader extends Text. Text caches its rendered lines keyed by
+        // (text, width). The leak was: the old Loader called setText()
+        // on every 80ms tick, which always cleared the cache, forcing a
+        // re-wrap of the message text.
+        // Behavioural test: render the loader, capture the cached array
+        // reference returned by Text.render, advance many ticks, and
+        // assert the underlying Text cache was NOT invalidated (we observe
+        // this via reference equality of the cached lines slice in the
+        // returned array — the second `result[*]` segment from super.render
+        // stays identity-stable when the cache survives).
+        loader = new Loader(tui, (s) => s, (s) => s, "the-message");
+        const before = loader.render(40);
+        // Run 50 frame intervals — the spinner should rotate, but the
+        // underlying message text wrapping must not change.
+        mock.timers.tick(80 * 50);
+        const after = loader.render(40);
+        // The message portion (everything after the first `""` padding line
+        // and after the spinner glyph + space prefix on the first content
+        // line) must be byte-identical across renders.
+        assert.equal(before.length, after.length, "render shape stable across ticks");
+        // Trailing message lines (index 2 onwards) come straight from Text's
+        // cache without any spinner mutation. They must be reference-equal
+        // substrings — same string contents byte-for-byte.
+        for (let i = 2; i < before.length; i++) {
+            assert.equal(after[i], before[i], `message line ${i} must remain byte-identical across spinner ticks ` +
+                `(cache must not be invalidated by frame rotation)`);
+        }
+    });
+    it("setMessage invalidates Text cache and a new message is reflected", () => {
+        // Quiescence is conditional on the message being unchanged — we
+        // must still see updates when it actually changes. This is the
+        // counter-test that prevents a false-positive "cache always stable"
+        // fix that would freeze the loader text.
+        loader = new Loader(tui, (s) => s, (s) => s, "first");
+        const beforeFirstRender = loader.render(40).join("\n");
+        loader.setMessage("second");
+        const afterChange = loader.render(40).join("\n");
+        assert.ok(afterChange.includes("second"), "new message must render");
+        assert.ok(!afterChange.includes("first") || beforeFirstRender !== afterChange, "render output must change when message changes");
+    });
+});
+// ─── Text.setText early-return guard ────────────────────────────────────
+describe("Text.setText returns early when value is unchanged", () => {
+    it("does not invalidate the cached render when setText receives the same value", () => {
+        // The setText early-return is the runtime guard that keeps the
+        // Loader-and-Text cache stable. We observe it via reference equality
+        // of the rendered output across a setText(SAME) call.
+        const t = new Text("identical", 0, 0);
+        const first = t.render(30);
+        t.setText("identical"); // same value — must NOT clear the cache
+        const second = t.render(30);
+        assert.strictEqual(second, first, "setText with an unchanged value must leave the render cache intact");
+    });
+    it("invalidates cache when the value actually changes", () => {
+        const t = new Text("one", 0, 0);
+        const first = t.render(30);
+        t.setText("two");
+        const second = t.render(30);
+        assert.notStrictEqual(second, first, "setText with a new value must produce a fresh render result");
+    });
+});
+// ─── Heap growth bound (gated on --expose-gc) ───────────────────────────
+describe("Long-running render loop does not leak heap (forced-GC bound)", () => {
+    const hasGc = typeof globalThis.gc === "function";
+    it("renders a Container 5000 times with stable heapUsed (within 2x baseline)", { skip: !hasGc ? "requires --expose-gc to drive deterministic GC between snapshots" : false }, () => {
+        // This is the on-the-wire memory-soak test. The naive version
+        // (no forced GC) is flaky because Node's GC is opportunistic;
+        // any background allocation can shift heapUsed past an absolute
+        // bound. We instead force GC between snapshots and assert a
+        // RELATIVE bound: post-iteration heap must be within 2x of the
+        // post-warmup baseline.
+        const gc = globalThis.gc;
+        const c = new Container();
+        const t = new Text("steady-state", 0, 0);
+        c.addChild(t);
+        // Warm up so the JIT and any lazy initial allocations settle.
+        for (let i = 0; i < 200; i++)
+            c.render(40);
+        gc();
+        const baseline = process.memoryUsage().heapUsed;
+        for (let i = 0; i < 5000; i++)
+            c.render(40);
+        gc();
+        const after = process.memoryUsage().heapUsed;
+        assert.ok(after < baseline * 2, `heapUsed must stay within 2x baseline after 5000 renders ` +
+            `(baseline=${baseline}B, after=${after}B, ratio=${(after / baseline).toFixed(2)})`);
+    });
+});
+//# sourceMappingURL=leak-fixes-runtime.test.js.map

package/packages/pi-tui/dist/components/__tests__/leak-fixes-runtime.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leak-fixes-runtime.test.js","sourceRoot":"","sources":["../../../src/components/__tests__/leak-fixes-runtime.test.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,6EAA6E;AAC7E,oFAAoF;AACpF,kEAAkE;AAClE,EAAE;AACF,8EAA8E;AAC9E,uCAAuC;AAEvC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMlC,SAAS,WAAW;IACnB,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAED,2EAA2E;AAE3E,QAAQ,CAAC,sDAAsD,EAAE,GAAG,EAAE;IACrE,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC9E,qEAAqE;QACrE,sEAAsE;QACtE,iEAAiE;QACjE,8DAA8D;QAC9D,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;QAC1B,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAEpC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,WAAW,CACjB,MAAM,EACN,KAAK,EACL,2EAA2E;YAC1E,oEAAoE,CACrE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QACnF,kEAAkE;QAClE,oEAAoE;QACpE,oEAAoE;QACpE,6DAA6D;QAC7D,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;QAC1B,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,cAAc,CACpB,MAAM,EACN,KAAK,EACL,4DAA4D,CAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;QAC1B,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEd,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,cAAc,CACpB,MAAM,EACN,KAAK,EACL,yEAAyE,CACzE,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,2EAA2E;AAE3E,QAAQ,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACxE,IAAI,GAAY,CAAC;IACjB,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE;QACf,GAAG,GAAG,WAAW,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC;YACJ,MAAM,EAAE,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACR,iBAAiB;QAClB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACzE,+DAA+D;QAC/D,+DAA+D;QAC/D,gEAAgE;QAChE,+BAA+B;QAC/B,gEAAgE;QAChE,6DAA6D;QAC7D,mEAAmE;QACnE,+DAA+D;QAC/D,oEAAoE;QACpE,kDAAkD;QAClD,MAAM,GAAG,IAAI,MAAM,CAAC,GAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAErE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjC,8DAA8D;QAC9D,oDAAoD;QACpD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEhC,oEAAoE;QACpE,kEAAkE;QAClE,+CAA+C;QAC/C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC;QAC9E,qEAAqE;QACrE,mEAAmE;QACnE,mDAAmD;QACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CACX,KAAK,CAAC,CAAC,CAAC,EACR,MAAM,CAAC,CAAC,CAAC,EACT,gBAAgB,CAAC,mDAAmD;gBACnE,mDAAmD,CACpD,CAAC;QACH,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC3E,gEAAgE;QAChE,+DAA+D;QAC/D,oEAAoE;QACpE,yCAAyC;QACzC,MAAM,GAAG,IAAI,MAAM,CAAC,GAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAC,CAAC;QACrE,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,iBAAiB,KAAK,WAAW,EAC5E,gDAAgD,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,2EAA2E;AAE3E,QAAQ,CAAC,oDAAoD,EAAE,GAAG,EAAE;IACnE,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACrF,+DAA+D;QAC/D,qEAAqE;QACrE,sDAAsD;QACtD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,wCAAwC;QAChE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,WAAW,CACjB,MAAM,EACN,KAAK,EACL,oEAAoE,CACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,cAAc,CACpB,MAAM,EACN,KAAK,EACL,6DAA6D,CAC7D,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,2EAA2E;AAE3E,QAAQ,CAAC,+DAA+D,EAAE,GAAG,EAAE;IAC9E,MAAM,KAAK,GAAG,OAAQ,UAAkB,CAAC,EAAE,KAAK,UAAU,CAAC;IAE3D,EAAE,CACD,0EAA0E,EAC1E,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC,CAAC,KAAK,EAAE,EAC7F,GAAG,EAAE;QACJ,8DAA8D;QAC9D,8DAA8D;QAC9D,gEAAgE;QAChE,4DAA4D;QAC5D,+DAA+D;QAC/D,wBAAwB;QACxB,MAAM,EAAE,GAAI,UAAkB,CAAC,EAAgB,CAAC;QAEhD,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEd,8DAA8D;QAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3C,EAAE,EAAE,CAAC;QACL,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC;QAEhD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5C,EAAE,EAAE,CAAC;QACL,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC;QAE7C,MAAM,CAAC,EAAE,CACR,KAAK,GAAG,QAAQ,GAAG,CAAC,EACpB,2DAA2D;YAC1D,aAAa,QAAQ,YAAY,KAAK,YAAY,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACnF,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC,CAAC,CAAC","sourcesContent":["// Runtime regression tests for the long-running-session leak fixes.\n//\n// Replaces the source-grep file `src/tests/session-memory-leaks.test.ts`\n// (deleted in #4875, tracked as #4873). The previous tests asserted on\n// identifier presence (`_prevRender`, `_lastMessage`, `MAX_CHAT_COMPONENTS`)\n// in source — a regression that set `MAX_CHAT_COMPONENTS = Number.MAX_SAFE_INTEGER`\n// or replaced `setText` with an inline mutation would still pass.\n//\n// Each test below drives the actual component through a long-running scenario\n// and asserts on observable behaviour.\n\nimport { describe, it, mock, beforeEach, afterEach } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { Container } from \"../../tui.js\";\nimport { Loader } from \"../loader.js\";\nimport { Text } from \"../text.js\";\n\ninterface MockTui {\n\trequestRender: ReturnType<typeof mock.fn>;\n}\n\nfunction makeMockTUI(): MockTui {\n\treturn { requestRender: mock.fn() };\n}\n\n// ─── Container render-skip ──────────────────────────────────────────────\n\ndescribe(\"Container.render skips work when output is unchanged\", () => {\n\tit(\"returns the SAME array reference across two renders with no changes\", () => {\n\t\t// The container caches `_prevRender` so doRender() can short-circuit\n\t\t// the post-processing (image-line scan, applyLineResets, line diffs).\n\t\t// The contract for the optimization is reference equality of the\n\t\t// returned array — that's what the consumer in tui.ts checks.\n\t\tconst c = new Container();\n\t\tc.addChild(new Text(\"hello\", 0, 0));\n\n\t\tconst first = c.render(20);\n\t\tconst second = c.render(20);\n\t\tassert.strictEqual(\n\t\t\tsecond,\n\t\t\tfirst,\n\t\t\t\"Container must return the same array reference when content is unchanged \" +\n\t\t\t\t\"(reference equality is the consumer-visible contract for the skip)\",\n\t\t);\n\t});\n\n\tit(\"returns a DIFFERENT array reference after addChild invalidates the cache\", () => {\n\t\t// If a regression caused `_prevRender` to never reset, downstream\n\t\t// rendering would skip post-processing for new components — visible\n\t\t// as missing/stale UI. Behaviourally we observe that adding a child\n\t\t// breaks the reference-equality contract on the next render.\n\t\tconst c = new Container();\n\t\tc.addChild(new Text(\"a\", 0, 0));\n\t\tconst first = c.render(20);\n\t\tc.addChild(new Text(\"b\", 0, 0));\n\t\tconst second = c.render(20);\n\t\tassert.notStrictEqual(\n\t\t\tsecond,\n\t\t\tfirst,\n\t\t\t\"adding a child must invalidate the cached render reference\",\n\t\t);\n\t});\n\n\tit(\"returns a different reference after content changes\", () => {\n\t\tconst t = new Text(\"hello\", 0, 0);\n\t\tconst c = new Container();\n\t\tc.addChild(t);\n\n\t\tconst first = c.render(20);\n\t\tt.setText(\"world\");\n\t\tconst second = c.render(20);\n\t\tassert.notStrictEqual(\n\t\t\tsecond,\n\t\t\tfirst,\n\t\t\t\"changing a child's text must produce a fresh array (not the cached one)\",\n\t\t);\n\t});\n});\n\n// ─── Loader frame isolation ─────────────────────────────────────────────\n\ndescribe(\"Loader does not mutate Text cache on every spinner tick\", () => {\n\tlet tui: MockTui;\n\tlet loader: Loader;\n\n\tbeforeEach(() => {\n\t\ttui = makeMockTUI();\n\t\tmock.timers.enable({ apis: [\"setInterval\"] });\n\t});\n\n\tafterEach(() => {\n\t\ttry {\n\t\t\tloader?.stop();\n\t\t} catch {\n\t\t\t/* best-effort */\n\t\t}\n\t\tmock.timers.reset();\n\t});\n\n\tit(\"does not invalidate Text's render cache across N spinner ticks\", () => {\n\t\t// Loader extends Text. Text caches its rendered lines keyed by\n\t\t// (text, width). The leak was: the old Loader called setText()\n\t\t// on every 80ms tick, which always cleared the cache, forcing a\n\t\t// re-wrap of the message text.\n\t\t// Behavioural test: render the loader, capture the cached array\n\t\t// reference returned by Text.render, advance many ticks, and\n\t\t// assert the underlying Text cache was NOT invalidated (we observe\n\t\t// this via reference equality of the cached lines slice in the\n\t\t// returned array — the second `result[*]` segment from super.render\n\t\t// stays identity-stable when the cache survives).\n\t\tloader = new Loader(tui as never, (s) => s, (s) => s, \"the-message\");\n\n\t\tconst before = loader.render(40);\n\t\t// Run 50 frame intervals — the spinner should rotate, but the\n\t\t// underlying message text wrapping must not change.\n\t\tmock.timers.tick(80 * 50);\n\t\tconst after = loader.render(40);\n\n\t\t// The message portion (everything after the first `\"\"` padding line\n\t\t// and after the spinner glyph + space prefix on the first content\n\t\t// line) must be byte-identical across renders.\n\t\tassert.equal(before.length, after.length, \"render shape stable across ticks\");\n\t\t// Trailing message lines (index 2 onwards) come straight from Text's\n\t\t// cache without any spinner mutation. They must be reference-equal\n\t\t// substrings — same string contents byte-for-byte.\n\t\tfor (let i = 2; i < before.length; i++) {\n\t\t\tassert.equal(\n\t\t\t\tafter[i],\n\t\t\t\tbefore[i],\n\t\t\t\t`message line ${i} must remain byte-identical across spinner ticks ` +\n\t\t\t\t\t`(cache must not be invalidated by frame rotation)`,\n\t\t\t);\n\t\t}\n\t});\n\n\tit(\"setMessage invalidates Text cache and a new message is reflected\", () => {\n\t\t// Quiescence is conditional on the message being unchanged — we\n\t\t// must still see updates when it actually changes. This is the\n\t\t// counter-test that prevents a false-positive \"cache always stable\"\n\t\t// fix that would freeze the loader text.\n\t\tloader = new Loader(tui as never, (s) => s, (s) => s, \"first\");\n\t\tconst beforeFirstRender = loader.render(40).join(\"\\n\");\n\t\tloader.setMessage(\"second\");\n\t\tconst afterChange = loader.render(40).join(\"\\n\");\n\t\tassert.ok(afterChange.includes(\"second\"), \"new message must render\");\n\t\tassert.ok(!afterChange.includes(\"first\") || beforeFirstRender !== afterChange,\n\t\t\t\"render output must change when message changes\");\n\t});\n});\n\n// ─── Text.setText early-return guard ────────────────────────────────────\n\ndescribe(\"Text.setText returns early when value is unchanged\", () => {\n\tit(\"does not invalidate the cached render when setText receives the same value\", () => {\n\t\t// The setText early-return is the runtime guard that keeps the\n\t\t// Loader-and-Text cache stable. We observe it via reference equality\n\t\t// of the rendered output across a setText(SAME) call.\n\t\tconst t = new Text(\"identical\", 0, 0);\n\t\tconst first = t.render(30);\n\t\tt.setText(\"identical\"); // same value — must NOT clear the cache\n\t\tconst second = t.render(30);\n\t\tassert.strictEqual(\n\t\t\tsecond,\n\t\t\tfirst,\n\t\t\t\"setText with an unchanged value must leave the render cache intact\",\n\t\t);\n\t});\n\n\tit(\"invalidates cache when the value actually changes\", () => {\n\t\tconst t = new Text(\"one\", 0, 0);\n\t\tconst first = t.render(30);\n\t\tt.setText(\"two\");\n\t\tconst second = t.render(30);\n\t\tassert.notStrictEqual(\n\t\t\tsecond,\n\t\t\tfirst,\n\t\t\t\"setText with a new value must produce a fresh render result\",\n\t\t);\n\t});\n});\n\n// ─── Heap growth bound (gated on --expose-gc) ───────────────────────────\n\ndescribe(\"Long-running render loop does not leak heap (forced-GC bound)\", () => {\n\tconst hasGc = typeof (globalThis as any).gc === \"function\";\n\n\tit(\n\t\t\"renders a Container 5000 times with stable heapUsed (within 2x baseline)\",\n\t\t{ skip: !hasGc ? \"requires --expose-gc to drive deterministic GC between snapshots\" : false },\n\t\t() => {\n\t\t\t// This is the on-the-wire memory-soak test. The naive version\n\t\t\t// (no forced GC) is flaky because Node's GC is opportunistic;\n\t\t\t// any background allocation can shift heapUsed past an absolute\n\t\t\t// bound. We instead force GC between snapshots and assert a\n\t\t\t// RELATIVE bound: post-iteration heap must be within 2x of the\n\t\t\t// post-warmup baseline.\n\t\t\tconst gc = (globalThis as any).gc as () => void;\n\n\t\t\tconst c = new Container();\n\t\t\tconst t = new Text(\"steady-state\", 0, 0);\n\t\t\tc.addChild(t);\n\n\t\t\t// Warm up so the JIT and any lazy initial allocations settle.\n\t\t\tfor (let i = 0; i < 200; i++) c.render(40);\n\t\t\tgc();\n\t\t\tconst baseline = process.memoryUsage().heapUsed;\n\n\t\t\tfor (let i = 0; i < 5000; i++) c.render(40);\n\t\t\tgc();\n\t\t\tconst after = process.memoryUsage().heapUsed;\n\n\t\t\tassert.ok(\n\t\t\t\tafter < baseline * 2,\n\t\t\t\t`heapUsed must stay within 2x baseline after 5000 renders ` +\n\t\t\t\t\t`(baseline=${baseline}B, after=${after}B, ratio=${(after / baseline).toFixed(2)})`,\n\t\t\t);\n\t\t},\n\t);\n});\n"]}

package/packages/pi-tui/dist/components/__tests__/loader.test.d.ts

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

package/packages/pi-tui/dist/components/__tests__/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/loader.test.ts"],"names":[],"mappings":""}

package/packages/pi-tui/dist/components/__tests__/loader.test.js

@@ -0,0 +1,81 @@
+// pi-tui Loader component regression tests
+//
+// The previous version of this file contained 3 tests that called
+// `start()`/`stop()`/`dispose()` with no assertions at all — the claimed
+// regression ("interval leak") would not have failed any of them. See
+// #4794 / #4784.
+//
+// This rewrite uses Node's `mock.timers` to observe the interval that
+// `Loader` registers internally, and `mock.fn()` on the mock TUI to
+// count render requests. Each test asserts on observable behaviour:
+// how many `requestRender` calls happen per tick, whether the interval
+// is cleared on stop/dispose, and whether post-dispose stop() is safe.
+import { describe, it, mock, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { Loader } from "../loader.js";
+function makeMockTUI() {
+    return { requestRender: mock.fn() };
+}
+describe("Loader", () => {
+    let loader;
+    let tui;
+    beforeEach(() => {
+        tui = makeMockTUI();
+        mock.timers.enable({ apis: ["setInterval"] });
+    });
+    afterEach(() => {
+        try {
+            loader?.stop();
+        }
+        catch {
+            /* best-effort */
+        }
+        mock.timers.reset();
+    });
+    it("constructor starts a spinner that ticks every 80ms and requests renders", () => {
+        loader = new Loader(tui, (s) => s, (s) => s, "test");
+        // Initial render request from start().
+        const initial = tui.requestRender.mock.callCount();
+        assert.ok(initial >= 1, `constructor should trigger at least one render (got ${initial})`);
+        // Advance 80ms — one interval tick should call requestRender once more.
+        mock.timers.tick(80);
+        assert.equal(tui.requestRender.mock.callCount(), initial + 1, "80ms tick should advance the spinner and call requestRender");
+        // Advance another 240ms — three more ticks.
+        mock.timers.tick(240);
+        assert.equal(tui.requestRender.mock.callCount(), initial + 4, "four total ticks after the initial render");
+    });
+    it("start() is idempotent — calling twice does not leak intervals", () => {
+        loader = new Loader(tui, (s) => s, (s) => s, "test");
+        // Constructor already started one interval. Call start() again.
+        loader.start();
+        const before = tui.requestRender.mock.callCount();
+        mock.timers.tick(80);
+        const after = tui.requestRender.mock.callCount();
+        // Exactly ONE tick's worth of work should happen — if the second
+        // start() leaked an interval, we'd see two increments per tick.
+        assert.equal(after - before, 1, "double-start must not double-tick (interval leak would show 2 increments)");
+    });
+    it("stop() clears the interval — no more ticks advance requestRender", () => {
+        loader = new Loader(tui, (s) => s, (s) => s, "test");
+        loader.stop();
+        const beforeTick = tui.requestRender.mock.callCount();
+        mock.timers.tick(400); // 5 tick intervals
+        assert.equal(tui.requestRender.mock.callCount(), beforeTick, "stopped loader must not advance renders");
+    });
+    it("dispose() stops the interval and nulls the TUI reference", () => {
+        loader = new Loader(tui, (s) => s, (s) => s, "test");
+        loader.dispose();
+        const beforeTick = tui.requestRender.mock.callCount();
+        mock.timers.tick(400);
+        assert.equal(tui.requestRender.mock.callCount(), beforeTick, "disposed loader must not advance renders");
+        // Calling stop() after dispose() must not throw.
+        assert.doesNotThrow(() => loader.stop());
+    });
+    it("stop() is safe to call multiple times without throwing", () => {
+        loader = new Loader(tui, (s) => s, (s) => s, "test");
+        loader.stop();
+        assert.doesNotThrow(() => loader.stop());
+        assert.doesNotThrow(() => loader.stop());
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/packages/pi-tui/dist/components/__tests__/loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.js","sourceRoot":"","sources":["../../../src/components/__tests__/loader.test.ts"],"names":[],"mappings":"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","sourcesContent":["// pi-tui Loader component regression tests\n//\n// The previous version of this file contained 3 tests that called\n// `start()`/`stop()`/`dispose()` with no assertions at all — the claimed\n// regression (\"interval leak\") would not have failed any of them. See\n// #4794 / #4784.\n//\n// This rewrite uses Node's `mock.timers` to observe the interval that\n// `Loader` registers internally, and `mock.fn()` on the mock TUI to\n// count render requests. Each test asserts on observable behaviour:\n// how many `requestRender` calls happen per tick, whether the interval\n// is cleared on stop/dispose, and whether post-dispose stop() is safe.\n\nimport { describe, it, mock, beforeEach, afterEach } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { Loader } from \"../loader.js\";\n\ninterface MockTui {\n  requestRender: ReturnType<typeof mock.fn>;\n}\n\nfunction makeMockTUI(): MockTui {\n  return { requestRender: mock.fn() };\n}\n\ndescribe(\"Loader\", () => {\n  let loader: Loader;\n  let tui: MockTui;\n\n  beforeEach(() => {\n    tui = makeMockTUI();\n    mock.timers.enable({ apis: [\"setInterval\"] });\n  });\n\n  afterEach(() => {\n    try {\n      loader?.stop();\n    } catch {\n      /* best-effort */\n    }\n    mock.timers.reset();\n  });\n\n  it(\"constructor starts a spinner that ticks every 80ms and requests renders\", () => {\n    loader = new Loader(tui as never, (s) => s, (s) => s, \"test\");\n    // Initial render request from start().\n    const initial = tui.requestRender.mock.callCount();\n    assert.ok(\n      initial >= 1,\n      `constructor should trigger at least one render (got ${initial})`,\n    );\n\n    // Advance 80ms — one interval tick should call requestRender once more.\n    mock.timers.tick(80);\n    assert.equal(\n      tui.requestRender.mock.callCount(),\n      initial + 1,\n      \"80ms tick should advance the spinner and call requestRender\",\n    );\n\n    // Advance another 240ms — three more ticks.\n    mock.timers.tick(240);\n    assert.equal(\n      tui.requestRender.mock.callCount(),\n      initial + 4,\n      \"four total ticks after the initial render\",\n    );\n  });\n\n  it(\"start() is idempotent — calling twice does not leak intervals\", () => {\n    loader = new Loader(tui as never, (s) => s, (s) => s, \"test\");\n    // Constructor already started one interval. Call start() again.\n    loader.start();\n\n    const before = tui.requestRender.mock.callCount();\n    mock.timers.tick(80);\n    const after = tui.requestRender.mock.callCount();\n    // Exactly ONE tick's worth of work should happen — if the second\n    // start() leaked an interval, we'd see two increments per tick.\n    assert.equal(\n      after - before,\n      1,\n      \"double-start must not double-tick (interval leak would show 2 increments)\",\n    );\n  });\n\n  it(\"stop() clears the interval — no more ticks advance requestRender\", () => {\n    loader = new Loader(tui as never, (s) => s, (s) => s, \"test\");\n    loader.stop();\n\n    const beforeTick = tui.requestRender.mock.callCount();\n    mock.timers.tick(400); // 5 tick intervals\n    assert.equal(\n      tui.requestRender.mock.callCount(),\n      beforeTick,\n      \"stopped loader must not advance renders\",\n    );\n  });\n\n  it(\"dispose() stops the interval and nulls the TUI reference\", () => {\n    loader = new Loader(tui as never, (s) => s, (s) => s, \"test\");\n    loader.dispose();\n\n    const beforeTick = tui.requestRender.mock.callCount();\n    mock.timers.tick(400);\n    assert.equal(\n      tui.requestRender.mock.callCount(),\n      beforeTick,\n      \"disposed loader must not advance renders\",\n    );\n\n    // Calling stop() after dispose() must not throw.\n    assert.doesNotThrow(() => loader.stop());\n  });\n\n  it(\"stop() is safe to call multiple times without throwing\", () => {\n    loader = new Loader(tui as never, (s) => s, (s) => s, \"test\");\n    loader.stop();\n    assert.doesNotThrow(() => loader.stop());\n    assert.doesNotThrow(() => loader.stop());\n  });\n});\n"]}

package/packages/pi-tui/dist/components/__tests__/markdown-list.test.d.ts

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