@chengchenccc/tui 0.2.0-rc.2 → 0.2.0-rc.3

package/dist/components/ansi-console.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ansi-console.d.ts","sourceRoot":"","sources":["../../src/components/ansi-console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK3C;;;;;;;;;;sCAUsC;AACtC,qBAAa,WAAY,YAAW,SAAS;IAQzC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAVlC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqC;IACxD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAM;gBAGvB,OAAO,EAAE,MAAM,EACE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC/B,SAAS,EAAE,MAAM,IAAI,EACrB,eAAe,GAAE,MAAM,IAAe;IAUzD,iEAAiE;IACjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB;0EACsE;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAc/B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU/B,UAAU,IAAI,IAAI;CAInB"}
+{"version":3,"file":"ansi-console.d.ts","sourceRoot":"","sources":["../../src/components/ansi-console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAS3C;;;;;;;;;;sCAUsC;AACtC,qBAAa,WAAY,YAAW,SAAS;IAQzC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAVlC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqC;IACxD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAM;gBAGvB,OAAO,EAAE,MAAM,EACE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC/B,SAAS,EAAE,MAAM,IAAI,EACrB,eAAe,GAAE,MAAM,IAAe;IAUzD,iEAAiE;IACjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB;0EACsE;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAc/B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU/B,UAAU,IAAI,IAAI;CAInB"}

package/dist/components/ansi-console.js

@@ -1,5 +1,9 @@
 import xterm from "@xterm/headless";
+import { sliceByColumn } from "../utils.js";
 import { lineToAnsi } from "../virtual-terminal.js";
+/** sliceByColumn's strict flag: hard-cut at the column boundary rather
+ *  than leave a wide char straddling it. */
+const TRUNCATE_STRICT = true;
 const XtermTerminal = xterm.Terminal;
 /** Live ANSI console pane backed by a headless xterm VT.
  *
@@ -57,7 +61,7 @@ export class AnsiConsole {
             this.cachedWidth = width;
             this.dirty = false;
         }
-        return this.cached.map((line) => line.slice(0, width));
+        return this.cached.map((line) => sliceByColumn(line, 0, width, TRUNCATE_STRICT));
     }
     handleInput(data) {
         // A lone Esc terminates the console (pi semantics); escape sequences

package/dist/components/loader.d.ts

@@ -9,17 +9,17 @@ export interface LoaderIndicatorOptions {
 /**
  * Loader component that updates with an optional spinning animation.
  */
-/** The one light-sweep palette. The loader's message band and every
- *  consumer's shimmer (oma's chrome rows, tool bodies) read from here, so the
- *  "working" animations cannot drift into different colors: cyan is the
- *  spinner accent, so band and spinner read as one animation. */
+/** The one light-sweep palette, fed from the theme (sweepLow/Mid/High). The
+ *  loader's message band and every consumer's shimmer (oma's chrome rows,
+ *  tool bodies) read from here, so the "working" animations cannot drift
+ *  into different colors: band and spinner read as one animation. */
 export declare const SHIMMER_TIER_OPEN: {
     /** Base tier: dim, the resting color of an unsettled line. */
-    readonly low: "\u001B[2m";
-    /** Mid band: the spinner's own cyan. */
-    readonly mid: "\u001B[36m";
-    /** Crest: bold cyan. */
-    readonly high: "\u001B[1m\u001B[36m";
+    readonly low: string;
+    /** Mid band: the spinner's own accent. */
+    readonly mid: string;
+    /** Crest: bold accent. */
+    readonly high: `\u001B[1m${string}`;
 };
 export type ShimmerTier = keyof typeof SHIMMER_TIER_OPEN;
 export declare class Loader extends Text {

package/dist/components/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/components/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;GAEG;AACH;;;iEAGiE;AACjE,eAAO,MAAM,iBAAiB;IAC5B,8DAA8D;;IAE9D,wCAAwC;;IAExC,wBAAwB;;CAEhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAEzD,qBAAa,MAAO,SAAQ,IAAI;IAC9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAK;IACzB;;mEAE+D;IAC/D,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,OAAO,CAAwB;gBAGrC,EAAE,EAAE,GAAG,EACP,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EACvC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EACvC,OAAO,GAAE,MAAqB,EAC9B,SAAS,CAAC,EAAE,sBAAsB;IAU3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAOxC,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAOZ,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,YAAY,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAYtD,OAAO,CAAC,gBAAgB;IAYxB;;;qDAGiD;IACjD,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,aAAa;CAStB"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/components/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;GAEG;AACH;;;qEAGqE;AACrE,eAAO,MAAM,iBAAiB;IAC5B,8DAA8D;;IAE9D,0CAA0C;;IAE1C,0BAA0B;;CAElB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAEzD,qBAAa,MAAO,SAAQ,IAAI;IAC9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAK;IACzB;;mEAE+D;IAC/D,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,OAAO,CAAwB;gBAGrC,EAAE,EAAE,GAAG,EACP,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EACvC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EACvC,OAAO,GAAE,MAAqB,EAC9B,SAAS,CAAC,EAAE,sBAAsB;IAU3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAOxC,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAOZ,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,YAAY,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAYtD,OAAO,CAAC,gBAAgB;IAYxB;;;qDAGiD;IACjD,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,aAAa;CAStB"}

package/dist/components/loader.js

@@ -1,20 +1,21 @@
+import { tuiTheme } from "../theme.js";
 import { Text } from "./text.js";
 const DEFAULT_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 const DEFAULT_INTERVAL_MS = 80;
 /**
  * Loader component that updates with an optional spinning animation.
  */
-/** The one light-sweep palette. The loader's message band and every
- *  consumer's shimmer (oma's chrome rows, tool bodies) read from here, so the
- *  "working" animations cannot drift into different colors: cyan is the
- *  spinner accent, so band and spinner read as one animation. */
+/** The one light-sweep palette, fed from the theme (sweepLow/Mid/High). The
+ *  loader's message band and every consumer's shimmer (oma's chrome rows,
+ *  tool bodies) read from here, so the "working" animations cannot drift
+ *  into different colors: band and spinner read as one animation. */
 export const SHIMMER_TIER_OPEN = {
     /** Base tier: dim, the resting color of an unsettled line. */
-    low: "\u001b[2m",
-    /** Mid band: the spinner's own cyan. */
-    mid: "\u001b[36m",
-    /** Crest: bold cyan. */
-    high: "\u001b[1m\u001b[36m",
+    low: tuiTheme.dim,
+    /** Mid band: the spinner's own accent. */
+    mid: tuiTheme.accent,
+    /** Crest: bold accent. */
+    high: `\u001b[1m${tuiTheme.accent}`,
 };
 export class Loader extends Text {
     frames = [...DEFAULT_FRAMES];

package/dist/components/output-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-block.d.ts","sourceRoot":"","sources":["../../src/components/output-block.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAeD,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,kBAAkB,CAAC,EAAE,MAAM,EAC3B,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,CAIR;AAwCD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CA+CvE;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,WAAW,CAAgC;IAEnD,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,MAAM,EAAE;IAStD,UAAU,IAAI,IAAI;IAKlB,OAAO,CAAC,QAAQ;CAmBjB"}
+{"version":3,"file":"output-block.d.ts","sourceRoot":"","sources":["../../src/components/output-block.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAkBD,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,kBAAkB,CAAC,EAAE,MAAM,EAC3B,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,CAIR;AAwCD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CA+CvE;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,WAAW,CAAgC;IAEnD,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,MAAM,EAAE;IAStD,UAAU,IAAI,IAAI;IAKlB,OAAO,CAAC,QAAQ;CAmBjB"}

package/dist/components/output-block.js

@@ -5,14 +5,18 @@
  * rich result blocks. It replaces the ad-hoc Card + Text children hacks that
  * made each tool renderer re-implement its own border/background rules.
  */
+import { tuiTheme } from "../theme.js";
 import { applyBackgroundToLine, visibleWidth, wrapTextWithAnsi } from "../utils.js";
-/** Default border colors, keyed by state (omp-ish semantics). */
+/** Border color per state — the SAME verdict tokens the header icon/title
+ *  use (running gold, error crimson, success jade), so the frame echoes the
+ *  verdict instead of a second, off-palette color system. Routed through
+ *  tuiTheme like every other SGR decision in the TUI. */
 const STATE_BORDER = {
-    pending: "\x1b[38;5;33m",
-    running: "\x1b[38;5;33m",
-    success: "\x1b[38;5;8m",
-    error: "\x1b[38;5;31m",
-    warning: "\x1b[38;5;11m",
+    pending: tuiTheme.info,
+    running: tuiTheme.warning,
+    success: tuiTheme.success,
+    error: tuiTheme.error,
+    warning: tuiTheme.warning,
 };
 function normalizePadding(value) {
     return value === undefined ? 1 : Math.max(0, Math.trunc(value));

package/dist/components/output-block.test.d.ts

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

package/dist/components/output-block.test.d.ts.map

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

package/dist/components/output-block.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, test } from "bun:test";
+import { tuiTheme } from "../theme.js";
+import { renderOutputBlock } from "./output-block.js";
+/** The border is the state's verdict channel: it must carry the SAME theme
+ *  token the header icon/title use (running gold, error crimson, success
+ *  jade), so the frame color answers "live / failed / done" at a glance —
+ *  and a future theme swap recolors borders with everything else. */
+describe("output block state border", () => {
+    const top = (state) => renderOutputBlock({ state, sections: [], width: 12 })[0] ?? "";
+    test("border color mirrors the verdict token per state", () => {
+        expect(top("running")).toContain(tuiTheme.warning);
+        expect(top("error")).toContain(tuiTheme.error);
+        expect(top("success")).toContain(tuiTheme.success);
+        expect(top("pending")).toContain(tuiTheme.info);
+        expect(top("warning")).toContain(tuiTheme.warning);
+    });
+    /** The mapping this file replaced had running=blue and error=teal-blue —
+     *  visually the same border for opposite verdicts, which is why the border
+     *  carried no status signal at all. */
+    test("running and error borders are distinguishable", () => {
+        expect(top("running")).not.toBe(top("error"));
+    });
+    test("an explicit borderColor override still wins over the state default", () => {
+        const lines = renderOutputBlock({
+            state: "running",
+            borderColor: tuiTheme.dim,
+            sections: [],
+            width: 12,
+        });
+        expect(lines[0]).toContain(tuiTheme.dim);
+    });
+});

package/dist/components/statusline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../../src/components/statusline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;uEACuE;AACvE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAatE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAaT"}
+{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../../src/components/statusline.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;uEACuE;AACvE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAatE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAaT"}

package/dist/components/statusline.js

@@ -1,8 +1,4 @@
-/**
- * Minimal omp-style status bar renderer (powerline chip + semantic colors).
- * Pure ANSI functions, no component state. Keeping this in packages/tui lets
- * both the bottom status line and (optionally) the header reuse it.
- */
+import { tuiTheme } from "../theme.js";
 /** One powerline chip: ◀bg label bg▶ using the same color for arrows/fill,
  *  but white bold text inside so the label is readable on the tint. */
 export function chip(text, bgAnsi) {
@@ -17,7 +13,7 @@ export function renderStatusBar(segs) {
         if (!s.text)
             continue;
         if (i > 0)
-            out.push(`\x1b[38;5;8m ┆ \x1b[0m`);
+            out.push(`${tuiTheme.dim} ┆ \x1b[0m`);
         if (s.chip && s.bg) {
             out.push(chip(s.text, s.bg));
         }
@@ -39,7 +35,7 @@ export function renderToolHeader(opts) {
     if (meta.length > 0)
         parts.push(meta.join(" · "));
     if (parts.length > 0) {
-        const dim = opts.dimColor ?? "\u001b[2m";
+        const dim = opts.dimColor ?? tuiTheme.dim;
         return `${title} ${dim}${parts.join(" · ")}\u001b[0m`;
     }
     return title;

package/dist/index.d.ts

@@ -15,12 +15,12 @@ export { TruncatedText } from "./components/truncated-text.ts";
 export type { EditorComponent } from "./editor-component.ts";
 export { getKeybindings, type Keybinding, type KeybindingConflict, type KeybindingDefinition, type KeybindingDefinitions, type Keybindings, type KeybindingsConfig, KeybindingsManager, setKeybindings, TUI_KEYBINDINGS, } from "./keybindings.ts";
 export { decodeKittyPrintable, isKeyRelease, isKeyRepeat, isKittyProtocolActive, Key, type KeyEventType, type KeyId, matchesKey, parseKey, setKittyProtocolActive, } from "./keys.ts";
-export { parseSgrMouse, routeSgrMouseInput, type SgrMouseEvent, type SgrMouseHandler, } from "./mouse.ts";
 export { StdinBuffer, type StdinBufferEventMap, type StdinBufferOptions, } from "./stdin-buffer.ts";
 export { KITTY_KEYBOARD_SET_FLAGS, ProcessTerminal, type Terminal, } from "./terminal.ts";
 export { parseOsc11BackgroundColor, parseTerminalColorSchemeReport, type RgbColor, type TerminalColorScheme, } from "./terminal-colors.ts";
 export { deleteKittyImage, getCapabilities, isImageLine, setCellDimensions, } from "./terminal-image.ts";
 export { setTextSizingEnabled, textSizingEnabled, textSizingSupported, } from "./text-sizing.ts";
+export { obsidianDarkTheme, type TuiTheme, tuiTheme } from "./theme.ts";
 export { type Component, Container, CURSOR_MARKER, type Focusable, type FramePlan, getNativeScrollbackLiveRegionStart, getRenderStablePrefixRows, type HistoryBatch, isFocusable, type NativeScrollbackCommittedRows, type NativeScrollbackLiveRegion, type NativeScrollbackReplay, type OverlayAnchor, type OverlayHandle, type OverlayMargin, type OverlayOptions, type OverlayUnfocusOptions, prepareNativeScrollbackReplay, type RenderStablePrefix, type SizeValue, setNativeScrollbackCommittedRows, type TerminalFrameProvider, TUI, type ViewportTailProvider, } from "./tui.ts";
 export { applyBackgroundToLine, sliceByColumn, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "./utils.ts";
 export { VirtualTerminal } from "./virtual-terminal.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -21,8 +21,6 @@ export { TruncatedText } from "./components/truncated-text.js";
 export { getKeybindings, KeybindingsManager, setKeybindings, TUI_KEYBINDINGS, } from "./keybindings.js";
 // Keyboard input handling
 export { decodeKittyPrintable, isKeyRelease, isKeyRepeat, isKittyProtocolActive, Key, matchesKey, parseKey, setKittyProtocolActive, } from "./keys.js";
-// SGR mouse reports (wheel scroll routing)
-export { parseSgrMouse, routeSgrMouseInput, } from "./mouse.js";
 // Input buffering for batch splitting
 export { StdinBuffer, } from "./stdin-buffer.js";
 // Terminal interface and implementations
@@ -32,6 +30,8 @@ export { parseOsc11BackgroundColor, parseTerminalColorSchemeReport, } from "./te
 // Terminal image helpers (used internally by tui.ts)
 export { deleteKittyImage, getCapabilities, isImageLine, setCellDimensions, } from "./terminal-image.js";
 export { setTextSizingEnabled, textSizingEnabled, textSizingSupported, } from "./text-sizing.js";
+// Theme tokens (default: omp obsidian dark)
+export { obsidianDarkTheme, tuiTheme } from "./theme.js";
 export { Container, CURSOR_MARKER, getNativeScrollbackLiveRegionStart, getRenderStablePrefixRows, isFocusable, prepareNativeScrollbackReplay, setNativeScrollbackCommittedRows, TUI, } from "./tui.js";
 // Utilities
 export { applyBackgroundToLine, sliceByColumn, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "./utils.js";

package/dist/loader-sweep.test.js

@@ -1,9 +1,9 @@
 import { describe, expect, test, vi } from "bun:test";
-import { Loader } from "./components/loader.js";
+import { Loader, SHIMMER_TIER_OPEN } from "./components/loader.js";
 const ESC = String.fromCharCode(27);
 /** Cell index of the bright (bold) sweep tier on the rendered line, or -1. */
 function bandCell(line) {
-    return visibleIndex(line, `${ESC}[1m${ESC}[36m`);
+    return visibleIndex(line, SHIMMER_TIER_OPEN.high);
 }
 /** The message row: Loader.render pads with a blank row above and below. */
 function messageRow(loader) {

package/dist/mermaid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../src/mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,iCAAiC,CAAC;AAE9F,YAAY,EAAE,kBAAkB,IAAI,yBAAyB,EAAE,CAAC;AA+BhE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,GAAG,IAAI,CAMf;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,GAAG,IAAI,CA4Bf;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../src/mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,iCAAiC,CAAC;AAE9F,YAAY,EAAE,kBAAkB,IAAI,yBAAyB,EAAE,CAAC;AA0ChE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,GAAG,IAAI,CAMf;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,GAAG,IAAI,CA4Bf;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/mermaid.js

@@ -7,7 +7,13 @@
  * forced direction when the base layout overflows the requested maxWidth.
  */
 import { renderMermaidASCII } from "./vendor/mermaid-ascii/index.js";
-/** Memoized renders (and failures), keyed on source + options + direction. */
+/** Memoized renders (and failures), keyed on source + options + direction.
+ *  Bounded: an assistant can emit unbounded distinct diagrams across a
+ *  long session, and the cache holds rendered ASCII (plus failed renders)
+ *  by strong reference — without a cap it grows until process exit.
+ *  Insertion order gives a cheap FIFO eviction; re-hits do not reorder
+ *  (ponytail: a true LRU matters only if diagrams repeat non-uniformly). */
+const CACHE_CAP = 64;
 const cache = new Map();
 /** Widest rendered row in display columns (Bun wcwidth-style). */
 function asciiDisplayWidth(ascii) {
@@ -27,6 +33,12 @@ function renderVariant(source, baseOptions, baseKey, direction) {
     const options = direction ? { ...baseOptions, direction } : baseOptions;
     const ascii = renderMermaidAsciiSafe(source, options);
     cache.set(key, ascii);
+    while (cache.size > CACHE_CAP) {
+        const oldest = cache.keys().next().value;
+        if (oldest === undefined)
+            break;
+        cache.delete(oldest);
+    }
     return ascii;
 }
 export function renderMermaidAsciiSafe(source, options) {

package/dist/stdin-buffer.d.ts

@@ -40,6 +40,9 @@ export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
     private pasteBuffer;
     private pendingKittyPrintableCodepoint;
     private extendedEscFlush;
+    /** Survives across process() calls so a UTF-8 char split between two
+     *  Buffer chunks decodes once, not as two replacement characters. */
+    private decoder;
     constructor(options?: StdinBufferOptions);
     process(data: string | Buffer): void;
     private emitDataSequence;

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

@@ -1 +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;AAgPtC,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IACf,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IAChE,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;IACjC,OAAO,CAAC,8BAA8B,CAAqB;IAC3D,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAKrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwH3C,OAAO,CAAC,gBAAgB;IAWxB,KAAK,IAAI,MAAM,EAAE;IAgBjB,KAAK,IAAI,IAAI;IAWb,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"stdin-buffer.d.ts","sourceRoot":"","sources":["../src/stdin-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAgPtC,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IACf,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IAChE,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;IACjC,OAAO,CAAC,8BAA8B,CAAqB;IAC3D,OAAO,CAAC,gBAAgB,CAAS;IACjC;yEACqE;IACrE,OAAO,CAAC,OAAO,CAA8B;gBAEjC,OAAO,GAAE,kBAAuB;IAKrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA6H3C,OAAO,CAAC,gBAAgB;IAWxB,KAAK,IAAI,MAAM,EAAE;IAgBjB,KAAK,IAAI,IAAI;IAWb,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/stdin-buffer.js

@@ -16,6 +16,7 @@
  * Based on code from OpenTUI (https://github.com/anomalyco/opentui)
  * MIT License - Copyright (c) 2025 opentui
  */
+import { StringDecoder } from "node:string_decoder";
 import { EventEmitter } from "events";
 const ESC = "\x1b";
 const BRACKETED_PASTE_START = "\x1b[200~";
@@ -231,6 +232,9 @@ export class StdinBuffer extends EventEmitter {
     pasteBuffer = "";
     pendingKittyPrintableCodepoint;
     extendedEscFlush = false;
+    /** Survives across process() calls so a UTF-8 char split between two
+     *  Buffer chunks decodes once, not as two replacement characters. */
+    decoder = null;
     constructor(options = {}) {
         super();
         this.timeoutMs = options.timeout ?? 10;
@@ -241,16 +245,22 @@ export class StdinBuffer extends EventEmitter {
             clearTimeout(this.timeout);
             this.timeout = null;
         }
-        // Handle high-byte conversion (for compatibility with parseKeypress)
-        // If buffer has single byte > 127, convert to ESC + (byte - 128)
+        // Handle high-byte conversion (for compatibility with parseKeypress).
+        // If buffer has single byte > 127, convert to ESC + (byte - 128).
+        // Everything else goes through a PERSISTENT StringDecoder: a UTF-8
+        // character split across two Buffer chunks must not decode as two
+        // replacement characters (emoji/CJK paste or fast typing).
         let str;
         if (Buffer.isBuffer(data)) {
             if (data.length === 1 && data[0] > 127) {
                 const byte = data[0] - 128;
                 str = `\x1b${String.fromCharCode(byte)}`;
+                this.decoder = null; // resync: the hack consumed a raw byte
             }
             else {
-                str = data.toString();
+                if (!this.decoder)
+                    this.decoder = new StringDecoder("utf8");
+                str = this.decoder.write(data);
             }
         }
         else {

package/dist/stdin-buffer.test.js

@@ -36,3 +36,18 @@ describe("StdinBuffer bare-ESC flush extension", () => {
         expect(emitted).toEqual(["\x1b[99;1:3u"]);
     });
 });
+describe("StdinBuffer cross-chunk UTF-8 (Buffer input)", () => {
+    test("a character split across two Buffer chunks decodes once", async () => {
+        const buf = new StdinBuffer({ timeout: 10 });
+        const emitted = [];
+        buf.on("data", (s) => emitted.push(s));
+        const bytes = Buffer.from("😀", "utf8"); // 4 code units
+        buf.process(bytes.subarray(0, 2));
+        buf.process(bytes.subarray(2));
+        await wait(30);
+        const joined = emitted.join("");
+        // Per-chunk toString() used to yield TWO replacement characters here.
+        expect(joined).toContain("😀");
+        expect(joined).not.toContain("\uFFFD");
+    });
+});

package/dist/terminal.d.ts

@@ -51,6 +51,8 @@ export interface Terminal {
  */
 export declare class ProcessTerminal implements Terminal {
     private wasRaw;
+    private wasEncoding;
+    private wasFlowing;
     private inputHandler?;
     private resizeHandler?;
     private _kittyProtocolActive;

package/dist/terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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"}

package/dist/terminal.js

@@ -43,6 +43,8 @@ export function normalizeAppleTerminalInput(data, isAppleTerminal, isShiftPresse
  */
 export class ProcessTerminal {
     wasRaw = false;
+    wasEncoding = null;
+    wasFlowing = null;
     inputHandler;
     resizeHandler;
     _kittyProtocolActive = false;
@@ -78,8 +80,13 @@ export class ProcessTerminal {
     start(onInput, onResize) {
         this.inputHandler = onInput;
         this.resizeHandler = onResize;
-        // Save previous state and enable raw mode
+        // Save previous state and enable raw mode. Encoding and flow state are
+        // saved too: as a LIBRARY, stop() must leave stdin the way it found it —
+        // an embedder's next readline/prompt would otherwise sit on a paused,
+        // forced-UTF8 stream (audit P2).
         this.wasRaw = process.stdin.isRaw || false;
+        this.wasEncoding = process.stdin.readableEncoding;
+        this.wasFlowing = process.stdin.readableFlowing;
         if (process.stdin.setRawMode) {
             process.stdin.setRawMode(true);
         }
@@ -362,6 +369,14 @@ export class ProcessTerminal {
         if (process.stdin.setRawMode) {
             process.stdin.setRawMode(this.wasRaw);
         }
+        // Restore the encoding/flow we borrowed. Flow: resume only if the
+        // stream was flowing before us. Encoding: a null (Buffer-mode) restore
+        // is not expressible in the typed surface (setEncoding lacks null);
+        // utf8-mode stdin is compatible with readline/prompt, so leaving it is
+        // the documented ceiling rather than a cast around the type.
+        process.stdin.setEncoding(this.wasEncoding ?? undefined);
+        if (this.wasFlowing)
+            process.stdin.resume();
     }
     write(data) {
         process.stdout.write(data);

package/dist/theme.d.ts

@@ -0,0 +1,46 @@
+/** TUI color tokens. Every SGR color decision in the TUI routes through
+ *  `tuiTheme`, so a future theme feature swaps this one object instead of
+ *  hunting escape codes across renderers.
+ *
+ *  The default theme ports omp's "obsidian dark" palette (oh-my-pi
+ *  theme/defaults/obsidian.json): warm-black neutrals, a violet accent, jade
+ *  success, crimson error. Values are 24-bit-color SGR strings; terminals
+ *  without truecolor degrade per their own palette. Attributes (bold,
+ *  italic, underline, strike) are NOT themed — a theme recolors, it does not
+ *  restyle structure.
+ *
+ *  Ten color tokens, each a ROLE a renderer can name without knowing the
+ *  palette: one brand accent, three verdict colors, one informational, two
+ *  text tiers, three surfaces. Anything finer (a second orange, a separate
+ *  heading tint) was tried and collapsed — tokens nobody can name from the
+ *  sitting surface are taxonomy, not theme. */
+export interface TuiTheme {
+    /** Brand accent: block titles, spinner + sweep band, selected markers,
+     *  inline code, the banner. obsidian violet. */
+    readonly accent: string;
+    /** Paths, links, notice lines, informational chrome. obsidian cyan. */
+    readonly info: string;
+    /** Success marks, diff added, clean git. obsidian jade. */
+    readonly success: string;
+    /** Errors, failures, diff removed. obsidian crimson. */
+    readonly error: string;
+    /** Warnings and pressure (dirty git, hot context). obsidian gold. */
+    readonly warning: string;
+    /** Secondary text: timestamps, meta, settled rows, hints, quotes. */
+    readonly dim: string;
+    /** Faintest marks: markdown markers, hr, quote bars — structure that
+     *  should sit below the dim tier. */
+    readonly faint: string;
+    /** Selected-row / chip / meter surface. obsidian glass. Inside an overlay
+     *  this is ALSO the selection contrast against bgOverlay. */
+    readonly bgPanel: string;
+    /** Full-overlay surface. obsidian smoke. */
+    readonly bgOverlay: string;
+    /** "Running jobs" chip surface — jade sunk toward the panel tone. */
+    readonly bgChipOk: string;
+}
+export declare const obsidianDarkTheme: TuiTheme;
+/** The active theme. Single swap point for the future theme feature
+ *  (settings key → assign another TuiTheme here, re-render). */
+export declare const tuiTheme: TuiTheme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;+CAe+C;AAE/C,MAAM,WAAW,QAAQ;IACvB;oDACgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;yCACqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;iEAC6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA0BD,eAAO,MAAM,iBAAiB,EAAE,QAW/B,CAAC;AAEF;gEACgE;AAChE,eAAO,MAAM,QAAQ,EAAE,QAA4B,CAAC"}

package/dist/theme.js

@@ -0,0 +1,52 @@
+/** TUI color tokens. Every SGR color decision in the TUI routes through
+ *  `tuiTheme`, so a future theme feature swaps this one object instead of
+ *  hunting escape codes across renderers.
+ *
+ *  The default theme ports omp's "obsidian dark" palette (oh-my-pi
+ *  theme/defaults/obsidian.json): warm-black neutrals, a violet accent, jade
+ *  success, crimson error. Values are 24-bit-color SGR strings; terminals
+ *  without truecolor degrade per their own palette. Attributes (bold,
+ *  italic, underline, strike) are NOT themed — a theme recolors, it does not
+ *  restyle structure.
+ *
+ *  Ten color tokens, each a ROLE a renderer can name without knowing the
+ *  palette: one brand accent, three verdict colors, one informational, two
+ *  text tiers, three surfaces. Anything finer (a second orange, a separate
+ *  heading tint) was tried and collapsed — tokens nobody can name from the
+ *  sitting surface are taxonomy, not theme. */
+/** "#rrggbb" → 24-bit foreground SGR. Module-private: themes are declared as
+ *  hex constants and materialized once; call sites never build SGR strings. */
+function fg(hex) {
+    return `\u001b[38;2;${parseInt(hex.slice(1, 3), 16)};${parseInt(hex.slice(3, 5), 16)};${parseInt(hex.slice(5, 7), 16)}m`;
+}
+/** "#rrggbb" → 24-bit background SGR. */
+function bg(hex) {
+    return `\u001b[48;2;${parseInt(hex.slice(1, 3), 16)};${parseInt(hex.slice(3, 5), 16)};${parseInt(hex.slice(5, 7), 16)}m`;
+}
+/** omp obsidian dark, as hex — kept visible for diffing against upstream. */
+const OBSIDIAN = {
+    glass: "#1a1816",
+    smoke: "#2b2825",
+    violet: "#9d7aff",
+    jade: "#52e8a0",
+    crimson: "#ff5570",
+    cyan: "#5cd9ff",
+    gold: "#ffc942",
+    muted: "#8a857f",
+    dim: "#4a4642",
+};
+export const obsidianDarkTheme = {
+    accent: fg(OBSIDIAN.violet),
+    info: fg(OBSIDIAN.cyan),
+    success: fg(OBSIDIAN.jade),
+    error: fg(OBSIDIAN.crimson),
+    warning: fg(OBSIDIAN.gold),
+    dim: fg(OBSIDIAN.muted),
+    faint: fg(OBSIDIAN.dim),
+    bgPanel: bg(OBSIDIAN.glass),
+    bgOverlay: bg(OBSIDIAN.smoke),
+    bgChipOk: bg("#20362b"),
+};
+/** The active theme. Single swap point for the future theme feature
+ *  (settings key → assign another TuiTheme here, re-render). */
+export const tuiTheme = obsidianDarkTheme;

package/dist/tui-scrollback.test.js

@@ -48,6 +48,98 @@ describe("TUI provider native scrollback", () => {
         expect(scroll.filter((l) => l.startsWith("H"))).toEqual(["H0", "H1", "H2"]);
         expect(vt.getViewport().slice(-5)).toEqual(["V0", "V1", "V2", "V3", "V4"]);
     });
+    test("requestRender(true) repaints the screen but never purges scrollback", async () => {
+        const vt = new VirtualTerminal(20, 5);
+        const tui = new TUI(vt);
+        let frame = 0;
+        tui.setFrameProvider({
+            renderFrame() {
+                frame++;
+                const viewport = frame <= 2 ? ["V0", "V1", "V2", "V3", "V4"] : ["W0", "W1", "W2", "W3", "W4"];
+                if (frame === 1)
+                    return { viewport, history: { id: 1, rows: ["H0", "H1"] } };
+                return { viewport };
+            },
+            acknowledgeHistory() { },
+        });
+        tui.start();
+        // frame 1 carries history, its ack recurses into frame 2; the frame
+        // counter is the deterministic drain signal.
+        while (frame < 2)
+            await vt.waitForRender();
+        expect(vt.getScrollBuffer().some((l) => l.startsWith("H0"))).toBe(true);
+        // The production triggers: transcript reconcile reset (/new, resume)
+        // and PTY overlay exit. Faking a width change here used to emit CSI 3 J
+        // and wipe the committed history.
+        tui.requestRender(true);
+        while (frame < 3)
+            await vt.waitForRender();
+        expect(vt.getScrollBuffer().some((l) => l.startsWith("H0"))).toBe(true);
+        expect(vt.getViewport().some((l) => l.startsWith("W0"))).toBe(true);
+    });
+    test("a real width change replays the committed history at the new width", async () => {
+        const vt = new VirtualTerminal(20, 5);
+        const tui = new TUI(vt);
+        let replayed = 0;
+        let frame = 0;
+        let frontier = 0;
+        let nextId = 1;
+        let historyRows = ["H0-0123456789abcdef", "H1-0123456789abcdef"];
+        tui.setFrameProvider({
+            beginHistoryReplay() {
+                replayed++;
+                frontier = 0;
+                nextId = 100;
+                // Re-laid-out at the new width, like a re-wrapping transcript.
+                historyRows = ["H0-0123", "H1-0123"];
+            },
+            renderFrame() {
+                frame++;
+                if (frontier < historyRows.length) {
+                    const rows = historyRows.slice(frontier);
+                    frontier += rows.length;
+                    return { viewport: ["V*"], history: { id: nextId++, rows } };
+                }
+                return { viewport: ["V*"] };
+            },
+            acknowledgeHistory() { },
+        });
+        tui.start();
+        while (frame < 2)
+            await vt.waitForRender();
+        expect(vt.getScrollBuffer().some((l) => l.includes("H0-0123456789abcdef"))).toBe(true);
+        vt.resize(10, 5);
+        // Replay frame re-offers the whole prefix (frame 3) and its ack recurses
+        // once more (frame 4) before the stream settles.
+        while (frame < 4)
+            await vt.waitForRender();
+        // The purge happened (old-width rows gone) but the provider replayed
+        // its committed prefix, so the history survives re-wrapped.
+        expect(replayed).toBe(1);
+        const scroll = vt.getScrollBuffer().join("\n");
+        expect(scroll).not.toContain("H0-0123456789abcdef");
+        expect(scroll).toContain("H0-0123");
+    });
+    test("stop() flushes the frame provider (not only root children)", async () => {
+        const vt = new VirtualTerminal(20, 5);
+        const tui = new TUI(vt);
+        let flushed = 0;
+        tui.setFrameProvider({
+            renderFrame() {
+                return { viewport: ["V0", "V1", "V2", "V3", "V4"] };
+            },
+            acknowledgeHistory() { },
+            beginHistoryFlush() {
+                flushed++;
+            },
+        });
+        tui.start();
+        await vt.waitForRender();
+        tui.stop();
+        // The provider is not a root child; without the explicit call its
+        // pending history batch never drained on exit.
+        expect(flushed).toBe(1);
+    });
 });
 describe("adaptive render backpressure (omp #4145 port)", () => {
     test("a slow frame pushes the next ordinary paint out proportionally", async () => {

package/dist/tui.d.ts

@@ -220,6 +220,9 @@ export declare class TUI extends Container {
     private providerForceRepaint;
     private fullRedrawCount;
     private stopped;
+    /** True once stop() ran: late async teardown (a pty overlay's deferred
+     *  cleanup) must not write terminal modes into the user's restored shell. */
+    get isStopped(): boolean;
     private pendingOsc11BackgroundReplies;
     private pendingOsc11BackgroundQueries;
     private terminalColorSchemeListeners;

package/dist/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"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"}

package/dist/tui.js

@@ -155,6 +155,11 @@ export class TUI extends Container {
     providerForceRepaint = false;
     fullRedrawCount = 0;
     stopped = false;
+    /** True once stop() ran: late async teardown (a pty overlay's deferred
+     *  cleanup) must not write terminal modes into the user's restored shell. */
+    get isStopped() {
+        return this.stopped;
+    }
     pendingOsc11BackgroundReplies = 0;
     pendingOsc11BackgroundQueries = [];
     terminalColorSchemeListeners = new Set();
@@ -518,6 +523,9 @@ export class TUI extends Container {
         for (const child of this.children) {
             child.beginHistoryFlush?.();
         }
+        // The frame provider is NOT a root child — flush it explicitly, or the
+        // provider's pending history batch never reaches the scrollback on exit.
+        this.frameProvider?.beginHistoryFlush?.();
         if (this.renderTimer) {
             clearTimeout(this.renderTimer);
             this.renderTimer = undefined;
@@ -537,18 +545,31 @@ export class TUI extends Container {
             }
             this.terminal.write("\r\n");
         }
+        else if (this.frameProvider && this.providerWindow.length > 0) {
+            // Provider mode never fills previousLines; the last frame placed the
+            // viewport at providerViewportTop. Park below it so shell output after
+            // exit does not land on the last frame's row.
+            const lastRow = this.providerViewportTop + this.providerWindow.length;
+            this.terminal.write(`\x1b[${lastRow + 1};1H`);
+            this.terminal.write("\r\n");
+        }
         this.terminal.showCursor();
         this.terminal.stop();
     }
     requestRender(force = false) {
         if (force) {
+            // Forced repaint clears the SCREEN, never the user's native
+            // scrollback. Faking a resize here (previousWidth=-1) used to make
+            // the renderer treat it as a width change and purge scrollback with
+            // CSI 3 J — after a transcript reset or a PTY overlay exit the
+            // committed history vanished. providerForceRepaint drives the clear
+            // in both render paths; only a REAL width change may purge.
             this.previousLines = [];
-            this.previousWidth = -1; // -1 triggers widthChanged, forcing a full clear
-            this.previousHeight = -1; // -1 triggers heightChanged, forcing a full clear
             this.cursorRow = 0;
             this.hardwareCursorRow = 0;
             this.maxLinesRendered = 0;
             this.previousViewportTop = 0;
+            this.providerForceRepaint = true;
             if (this.renderTimer) {
                 clearTimeout(this.renderTimer);
                 this.renderTimer = undefined;
@@ -1054,6 +1075,13 @@ export class TUI extends Container {
         const provider = this.frameProvider;
         if (!provider || width <= 0 || height <= 0)
             return;
+        // A REAL width change rewraps everything; the purge below (CSI 3 J)
+        // drops the old-width scrollback rows, so the provider must replay its
+        // committed prefix at the new width first or that history is lost
+        // forever (the provider's frontier still says "already delivered").
+        if (this.previousWidth !== 0 && this.previousWidth !== width) {
+            provider.beginHistoryReplay?.();
+        }
         const plan = provider.renderFrame({ columns: width, rows: height });
         let viewport = [...plan.viewport];
         if (viewport.length > height)
@@ -1083,8 +1111,14 @@ export class TUI extends Container {
             : Math.min(this.providerViewportTop, Math.max(0, height - 1));
         const newTop = Math.max(0, Math.min(startTop + historyRows.length, height - rows));
         let buffer = "\x1b[?2026h";
-        if (destructiveReset)
-            buffer += "\x1b[H\x1b[3J\x1b[2J";
+        if (destructiveReset) {
+            buffer += "\x1b[H\x1b[2J";
+            // Purge scrollback only when a rewrap actually misaligns the rows
+            // above (width change). A plain repaint reset (didReset from the
+            // reconciler) must keep the user's committed history.
+            if (widthChanged)
+                buffer += "\x1b[3J";
+        }
         // Frame advance = history rows appended this frame. After those appends
         // the screen content that sits under new viewport slot i is the OLD
         // window's row (i + advance) — both when the appends scrolled the
@@ -1272,6 +1306,15 @@ export class TUI extends Container {
             const msg = `[${new Date().toISOString()}] fullRender: ${reason} (prev=${this.previousLines.length}, new=${newLines.length}, height=${height})\n`;
             fs.appendFileSync(logPath, msg);
         };
+        // Forced repaint (requestRender(true)): full clear of the SCREEN, but
+        // the user's native scrollback survives — only a real width change
+        // takes the clearScrollback route below.
+        if (this.providerForceRepaint) {
+            logRedraw("forced repaint");
+            fullRender(true);
+            this.providerForceRepaint = false;
+            return;
+        }
         // First render - just output everything without clearing (assumes clean screen)
         if (this.previousLines.length === 0 && !widthChanged && !heightChanged) {
             logRedraw("first render");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chengchenccc/tui",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.0-rc.3",
   "description": "Terminal UI library with differential rendering (vendored from @earendil-works/pi-tui, MIT)",
   "type": "module",
   "exports": {

package/dist/mouse.d.ts

@@ -1,40 +0,0 @@
-/** SGR mouse report parsing (`\x1b[<button;col;rowM` / `…m`).
- *
- * Mouse tracking (modes 1000 + 1006) is enabled by the APPLICATION (oma
- * enables it for the whole session so the wheel can scroll the transcript —
- * our TUI keeps no native-scrollback copy of history). Consumers get 0-based
- * col/row for direct indexing into rendered lines.
- *
- * ponytail: wheel-only consumer for now; click/hover routing (pi's
- * SelectListMouseTarget helpers) can be ported when an overlay needs it.
- *
- * Ported from pi's packages/tui/src/mouse.ts. */
-/** A decoded SGR mouse report. */
-export interface SgrMouseEvent {
-    /** Raw button code (bit 32 = motion, bit 64 = wheel, low bits = button). */
-    button: number;
-    /** 0-based column of the event. */
-    col: number;
-    /** 0-based row of the event. */
-    row: number;
-    /** True for a release report (`m` suffix). */
-    release: boolean;
-    /** Wheel direction: -1 up, 1 down, null when not a wheel event. */
-    wheel: -1 | 1 | null;
-    /** True when the pointer moved (hover or drag) rather than clicked. */
-    motion: boolean;
-    /** True for a left-button press (not motion, not release, not wheel). */
-    leftClick: boolean;
-}
-/** Decode an SGR mouse report, or return null when `data` is not one.
- *  Callers on hot keypress paths should pre-check `data.startsWith("\x1b[<")`
- *  before paying for the regex. */
-export declare function parseSgrMouse(data: string): SgrMouseEvent | null;
-/** Handler invoked with a decoded SGR event; returning `false` reports unhandled. */
-export type SgrMouseHandler = (event: SgrMouseEvent) => boolean | undefined;
-/** Decode an SGR mouse report and forward it to `handler`. Returns `false`
- *  when `data` is not an SGR mouse report (or fails to parse), so callers can
- *  fall through to other input handling. Centralizes the repeated
- *  `data.startsWith("\x1b[<")` + `parseSgrMouse()` pattern. */
-export declare function routeSgrMouseInput(data: string, handler: SgrMouseHandler): boolean;
-//# sourceMappingURL=mouse.d.ts.map

package/dist/mouse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../src/mouse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;iDAUiD;AAEjD,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACrB,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;mCAEmC;AACnC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAWhE;AAED,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,GAAG,SAAS,CAAC;AAE5E;;;+DAG+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAKlF"}

package/dist/mouse.js

@@ -1,39 +0,0 @@
-/** SGR mouse report parsing (`\x1b[<button;col;rowM` / `…m`).
- *
- * Mouse tracking (modes 1000 + 1006) is enabled by the APPLICATION (oma
- * enables it for the whole session so the wheel can scroll the transcript —
- * our TUI keeps no native-scrollback copy of history). Consumers get 0-based
- * col/row for direct indexing into rendered lines.
- *
- * ponytail: wheel-only consumer for now; click/hover routing (pi's
- * SelectListMouseTarget helpers) can be ported when an overlay needs it.
- *
- * Ported from pi's packages/tui/src/mouse.ts. */
-/** Decode an SGR mouse report, or return null when `data` is not one.
- *  Callers on hot keypress paths should pre-check `data.startsWith("\x1b[<")`
- *  before paying for the regex. */
-export function parseSgrMouse(data) {
-    const match = /^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/.exec(data);
-    if (!match)
-        return null;
-    const button = Number(match[1]);
-    const col = Number(match[2]) - 1;
-    const row = Number(match[3]) - 1;
-    const release = match[4] === "m";
-    const wheel = button & 64 ? (button & 1 ? 1 : -1) : null;
-    const motion = (button & 32) !== 0 && wheel === null;
-    const leftClick = !release && wheel === null && !motion && (button & 3) === 0;
-    return { button, col, row, release, wheel, motion, leftClick };
-}
-/** Decode an SGR mouse report and forward it to `handler`. Returns `false`
- *  when `data` is not an SGR mouse report (or fails to parse), so callers can
- *  fall through to other input handling. Centralizes the repeated
- *  `data.startsWith("\x1b[<")` + `parseSgrMouse()` pattern. */
-export function routeSgrMouseInput(data, handler) {
-    if (!data.startsWith("\x1b[<"))
-        return false;
-    const event = parseSgrMouse(data);
-    if (!event)
-        return false;
-    return handler(event) !== false;
-}

package/dist/mouse.test.d.ts

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

package/dist/mouse.test.d.ts.map

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

package/dist/mouse.test.js

@@ -1,36 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { parseSgrMouse, routeSgrMouseInput } from "./mouse.js";
-describe("parseSgrMouse", () => {
-    test("wheel up (button 64) and wheel down (button 65)", () => {
-        const up = parseSgrMouse("\x1b[<64;10;5M");
-        expect(up).toMatchObject({ button: 64, col: 9, row: 4, wheel: -1, release: false });
-        const down = parseSgrMouse("\x1b[<65;1;1M");
-        expect(down).toMatchObject({ button: 65, wheel: 1, col: 0, row: 0 });
-    });
-    test("left click press vs release vs motion", () => {
-        expect(parseSgrMouse("\x1b[<0;3;3M")).toMatchObject({ leftClick: true, motion: false });
-        expect(parseSgrMouse("\x1b[<0;3;3m")).toMatchObject({ release: true, leftClick: false });
-        expect(parseSgrMouse("\x1b[<32;3;3M")).toMatchObject({ motion: true, leftClick: false });
-    });
-    test("non-mouse input returns null", () => {
-        expect(parseSgrMouse("\x1b[A")).toBeNull();
-        expect(parseSgrMouse("\x1b[5~")).toBeNull();
-        expect(parseSgrMouse("x")).toBeNull();
-    });
-});
-describe("routeSgrMouseInput", () => {
-    test("routes wheel and reports consumed; falls through on other input", () => {
-        const wheels = [];
-        const consumed = routeSgrMouseInput("\x1b[<64;1;1M", (event) => {
-            if (event.wheel)
-                wheels.push(event.wheel);
-            return true;
-        });
-        expect(consumed).toBe(true);
-        // Not an SGR report: handler must not run.
-        expect(routeSgrMouseInput("\x1b[5~", () => {
-            wheels.push(99);
-        })).toBe(false);
-        expect(wheels).toEqual([-1]);
-    });
-});