@vincemakes/kiso-tui 0.1.29 → 0.1.32

package/dist/dock.js

@@ -141,14 +141,20 @@ export class Dock {
         if (!this.#active)
             return;
         const p = palette();
-        const H = this.#height;
-        const W = this.#width;
+        // #17 (P1): read the LIVE size, not the cache — the body's resize
+        // render calls onDock (this redraw) BEFORE this dock's own resize
+        // handler runs, so the cached geometry would draw the chrome at
+        // stale rows (clamped into the body — the separator residue wall).
+        // The live read makes the handler order irrelevant; the cache keeps
+        // serving exit().
+        const H = process.stdout.rows ?? this.#height;
+        const W = process.stdout.columns ?? this.#width;
         const sep = `${p.dim}${"╌".repeat(W)}${p.reset}`;
         const status = `${this.#status}${this.#tail === "" ? "" : ` · ${this.#tail}`}`;
         const statusLine = this.#question ?? this.#statusRow(status, p, W);
         const inp = this.#inputState();
         const out = [];
-        // P3 (审查): the DEC private-mode SET/RESET needs the "?" prefix —
+        // P3 (review): the DEC private-mode SET/RESET needs the "?" prefix —
         // \x1b[?2026h/l, the pi source's exact form. Without it terminals
         // silently ignore the mode and the anti-flicker never engages.
         out.push("\x1b[?2026h"); // synchronized output ON (DEC 2026)

package/dist/editor.js

@@ -102,7 +102,7 @@ export class Editor {
     #onRender;
     #menuOpen = false; // v3 §04: the slash-command menu
     #menuSel = 0;
-    // A2 (手感): the session-scoped input history — every submitted TURN
+    // A2 (the feel): the session-scoped input history — every submitted TURN
     // line (never a question answer), capped at 100, never persisted. ↑↓
     // navigate it ONLY from an empty input or while already browsing.
     #history = [];
@@ -337,7 +337,7 @@ export class Editor {
         }
         else if (final === "A" || final === "B") {
             // v3 §04: the menu owns ↑↓ while open (the selection, never the
-            // cursor). A2 (手感): otherwise ↑↓ navigate the session history
+            // cursor). A2 (the feel): otherwise ↑↓ navigate the session history
             // — ONLY from an empty input or while already browsing; mid-edit
             // the cursor semantics are unchanged (↑↓ do nothing).
             if (this.#menuOpen) {
@@ -427,7 +427,7 @@ export class Editor {
     #submit() {
         let line = String.fromCodePoint(...this.#chars);
         if (this.#menuOpen) {
-            // A1 (手感): Enter submits the EXACT selection directly; a
+            // A1 (the feel): Enter submits the EXACT selection directly; a
             // PARTIAL selection COMPLETES the buffer (the Tab semantics)
             // without submitting — the user reviews and presses Enter
             // again. The old behavior executed the completed command on

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 /**
  * kiso-tui — the PURE terminal layer, extracted from the CLI (the
  * ADR-0041 escape hatch). Zero runtime dependencies: input is data,
- * output is bytes. The cell renderer (body), the bottom-anchored dock,
- * the raw-mode editor, the diff renderer, and the palette.
+ * output is bytes. TUI v6 (ADR-0046): the ONE compositor (the single
+ * writer — body.ts + dock.ts retired), the component tree, the raw-mode
+ * editor, the diff renderer, and the palette.
  */
-export { Body, type BodyOptions } from "./body.js";
-export { Dock } from "./dock.js";
+export { Body, Dock, CURSOR_MARKER, type BodyOptions } from "./compositor.js";
+export { Container, foldLine, visibleWidth, SPINNER, type Component, type FrameCtx } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, type MenuItem, } from "./editor.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderSessionLine, renderStatusLine, renderTerminalGap, renderToolSummary, TAGLINE, truncateRow, type Palette, type PathResolver, type RecapStats, type RenderInput, type RenderResult, type RunUsage, } from "./render.js";
 export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResult } from "./diff.js";

package/dist/index.js

@@ -1,11 +1,12 @@
 /**
  * kiso-tui — the PURE terminal layer, extracted from the CLI (the
  * ADR-0041 escape hatch). Zero runtime dependencies: input is data,
- * output is bytes. The cell renderer (body), the bottom-anchored dock,
- * the raw-mode editor, the diff renderer, and the palette.
+ * output is bytes. TUI v6 (ADR-0046): the ONE compositor (the single
+ * writer — body.ts + dock.ts retired), the component tree, the raw-mode
+ * editor, the diff renderer, and the palette.
  */
-export { Body } from "./body.js";
-export { Dock } from "./dock.js";
+export { Body, Dock, CURSOR_MARKER } from "./compositor.js";
+export { Container, foldLine, visibleWidth, SPINNER } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, } from "./editor.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderSessionLine, renderStatusLine, renderTerminalGap, renderToolSummary, TAGLINE, truncateRow, } from "./render.js";
 export { editFileDiff, truncateDiff, writeFileDiff } from "./diff.js";

package/dist/render.d.ts

@@ -3,7 +3,7 @@
  * input, produce the lines a human sees. Colors are raw ANSI — no
  * dependencies.
  *
- * 手感批 C5: the input is the tui's OWN data shape (RenderInput), never
+ * the ergonomics batch C5: the input is the tui's OWN data shape (RenderInput), never
  * kiso-core's Event — the CLI translates Event → RenderInput. The tui
  * package has ZERO kiso-core imports: input is data, output is bytes.
  */
@@ -31,7 +31,7 @@ export declare const COLOR_ON: Palette;
 export declare const COLOR_OFF: Palette;
 export declare function palette(): Palette;
 /**
- * E 组/八: strip terminal-injection vectors from MODEL/TOOL text before it
+ * E group/round 8: strip terminal-injection vectors from MODEL/TOOL text before it
  * reaches the terminal — ESC, C0 (except \t \n), C1, CR, backspace, and
  * bidi overrides. The kiso colors are applied by render, not by the data.
  * EVERY externally-sourced string must pass through this before any output.
@@ -56,7 +56,7 @@ export interface RenderResult {
     readonly prompt: boolean;
 }
 /**
- * 手感批 C5 — the render input, the tui's OWN data shape: the subset of
+ * the ergonomics batch C5 — the render input, the tui's OWN data shape: the subset of
  * an event stream the renderer reads, keyed by type. The CLI translates
  * its Event stream into this (Event → RenderInput) before rendering —
  * the tui package never imports kiso-core. Field names mirror the
@@ -149,7 +149,7 @@ export type RenderInput = {
  * Render one event. `text` may be a continuation (text_delta appends to the
  * current line); `newline` says whether the line is complete.
  *
- * 自举 P1: `prevThinking` marks a thinking delta that continues the SAME
+ * bootstrap P1: `prevThinking` marks a thinking delta that continues the SAME
  * block — it renders appended to the segment, without the … prefix. The
  * consumer closes the segment with a newline at the next non-thinking
  * event.
@@ -166,7 +166,7 @@ export declare function foldThinking(block: string): string;
 export declare function foldResult(content: string): string;
 export declare function renderEvent(ev: RenderInput, prevThinking?: boolean, resolvePath?: PathResolver): RenderResult;
 /**
- * B 区: one-line summary of a completed tool call, e.g.
+ * B area: one-line summary of a completed tool call, e.g.
  *   ✓ edit src/foo.ts (+12 -3)    ✓ read src/bar.ts (140 lines)
  *   ✗ shell npm test (exit 1)
  * edit/write show +/- line counts, read shows lines, shell shows the exit
@@ -178,7 +178,7 @@ export declare function renderToolSummary(name: string, input: Record<string, un
 }): string;
 /** k-units for the status line: 12345 → 12.3k, 800 → 800, null → ?. */
 export declare function kUnit(value: number | null): string;
-/** B 区: usage data gathered from the run's usage events. */
+/** B area: usage data gathered from the run's usage events. */
 export interface RunUsage {
     readonly in: number | null;
     readonly out: number | null;
@@ -186,9 +186,9 @@ export interface RunUsage {
     readonly known: boolean;
 }
 /**
- * B 区/v2a: the one-line status bar after a terminal, e.g.
+ * B area/v2a: the one-line status bar after a terminal, e.g.
  *   [turn 3 · in 12.4k out 1.8k · cache 9.2k · ctx ~14%]
- * 降噪: unknown fields are OMITTED ENTIRELY (有什么显什么); a fully unknown
+ * Denoising: unknown fields are OMITTED ENTIRELY (show what there is); a fully unknown
  * usage → null (the caller prints nothing); faux mode → [turn N · faux].
  * All data comes from usage events; ctx is the approximate estimate
  * passed in (chars/4 vs the window), marked with ~.
@@ -196,7 +196,7 @@ export interface RunUsage {
 export declare function renderStatusLine(turn: number, usage: RunUsage, ctxRatio: number, faux?: boolean): string | null;
 /**
  * v2a rhythm — the exact bytes after a terminal event: the status line
- * hugs the terminal (有什么显什么 — omitted when there is nothing to show),
+ * hugs the terminal (show what there is — omitted when there is nothing to show),
  * then EXACTLY one blank line before the next prompt. The consumer prints
  * this verbatim; the render tests pin the sequence.
  */

package/dist/render.js

@@ -3,7 +3,7 @@
  * input, produce the lines a human sees. Colors are raw ANSI — no
  * dependencies.
  *
- * 手感批 C5: the input is the tui's OWN data shape (RenderInput), never
+ * the ergonomics batch C5: the input is the tui's OWN data shape (RenderInput), never
  * kiso-core's Event — the CLI translates Event → RenderInput. The tui
  * package has ZERO kiso-core imports: input is data, output is bytes.
  */
@@ -13,7 +13,7 @@ export function palette() {
     return process.env.NO_COLOR === undefined && process.stdout.isTTY ? COLOR_ON : COLOR_OFF;
 }
 /**
- * E 组/八: strip terminal-injection vectors from MODEL/TOOL text before it
+ * E group/round 8: strip terminal-injection vectors from MODEL/TOOL text before it
  * reaches the terminal — ESC, C0 (except \t \n), C1, CR, backspace, and
  * bidi overrides. The kiso colors are applied by render, not by the data.
  * EVERY externally-sourced string must pass through this before any output.
@@ -44,7 +44,7 @@ export function colorInlineCode(line) {
  * Render one event. `text` may be a continuation (text_delta appends to the
  * current line); `newline` says whether the line is complete.
  *
- * 自举 P1: `prevThinking` marks a thinking delta that continues the SAME
+ * bootstrap P1: `prevThinking` marks a thinking delta that continues the SAME
  * block — it renders appended to the segment, without the … prefix. The
  * consumer closes the segment with a newline at the next non-thinking
  * event.
@@ -80,7 +80,7 @@ export function renderEvent(ev, prevThinking = false, resolvePath = (p) => p) {
         case "text_end":
             return { text: "\n", newline: true, prompt: false };
         case "thinking":
-            // 自举 P1/v2b: the CONSUMER buffers each thinking block and folds
+            // bootstrap P1/v2b: the CONSUMER buffers each thinking block and folds
             // it to ONE dim line (foldThinking); this render is the generic
             // path for tests. The full block goes to /think.
             return {
@@ -112,7 +112,7 @@ export function renderEvent(ev, prevThinking = false, resolvePath = (p) => p) {
             };
         }
         case "permission_requested":
-            // 八: the tool NAME is model text — escaped like everything else.
+            // round 8: the tool NAME is model text — escaped like everything else.
             return {
                 text: `⏸ ${escapeTerminal(ev.name)} needs approval ${p.dim}${approvalDetail(ev.name, ev.input, resolvePath)}${p.reset} `,
                 newline: false,
@@ -162,7 +162,7 @@ export function renderEvent(ev, prevThinking = false, resolvePath = (p) => p) {
     }
 }
 /**
- * The approval prompt detail (Area 5/八): the human must be able to see
+ * The approval prompt detail (Area 5/round 8): the human must be able to see
  * EVERYTHING they are approving. The shell command is shown in full; the
  * path is the CANONICAL one the tool will touch; write/edit show the FULL
  * content (never a truncated tail that hides a dangerous payload). The
@@ -182,7 +182,7 @@ function approvalDetail(name, input, resolvePath) {
     return `\n  ${escapeTerminal(JSON.stringify(input))}`;
 }
 /**
- * B 区: one-line summary of a completed tool call, e.g.
+ * B area: one-line summary of a completed tool call, e.g.
  *   ✓ edit src/foo.ts (+12 -3)    ✓ read src/bar.ts (140 lines)
  *   ✗ shell npm test (exit 1)
  * edit/write show +/- line counts, read shows lines, shell shows the exit
@@ -248,9 +248,9 @@ export function kUnit(value) {
     return String(value);
 }
 /**
- * B 区/v2a: the one-line status bar after a terminal, e.g.
+ * B area/v2a: the one-line status bar after a terminal, e.g.
  *   [turn 3 · in 12.4k out 1.8k · cache 9.2k · ctx ~14%]
- * 降噪: unknown fields are OMITTED ENTIRELY (有什么显什么); a fully unknown
+ * Denoising: unknown fields are OMITTED ENTIRELY (show what there is); a fully unknown
  * usage → null (the caller prints nothing); faux mode → [turn N · faux].
  * All data comes from usage events; ctx is the approximate estimate
  * passed in (chars/4 vs the window), marked with ~.
@@ -275,7 +275,7 @@ export function renderStatusLine(turn, usage, ctxRatio, faux = false) {
 }
 /**
  * v2a rhythm — the exact bytes after a terminal event: the status line
- * hugs the terminal (有什么显什么 — omitted when there is nothing to show),
+ * hugs the terminal (show what there is — omitted when there is nothing to show),
  * then EXACTLY one blank line before the next prompt. The consumer prints
  * this verbatim; the render tests pin the sequence.
  */
@@ -345,6 +345,6 @@ export function renderRecap(s) {
 /** One-line summary of a session, for `kiso sessions`. */
 export function renderSessionLine(meta) {
     const when = meta.updatedAt ? new Date(meta.updatedAt).toISOString().slice(0, 16) : "—";
-    // 八: the title is the user's first prompt — model/user text, escaped.
+    // round 8: the title is the user's first prompt — model/user text, escaped.
     return `${meta.id.padEnd(24)} ${meta.runs} runs ${String(meta.events).padStart(5)} events  ${when}  ${escapeTerminal(meta.title)}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-tui",
-  "version": "0.1.29",
+  "version": "0.1.32",
   "description": "kiso tui — the pure terminal layer (cell renderer, dock, raw editor, diff, palette). Zero runtime dependencies: input is data, output is bytes.",
   "type": "module",
   "license": "MIT",