@vincemakes/kiso-tui 0.1.36 → 0.1.38

package/dist/components.d.ts

@@ -15,7 +15,7 @@
  * (untouched); render.ts supplies the original text (palette, escape,
  * tint, fold wording).
  */
-import { foldThinking, foldResult, renderToolSummary } from "./render.js";
+import { foldThinking, foldResult, renderToolSummary, type ResumeMeta } from "./render.js";
 /** The spinner glyphs, cycled by the compositor's on-demand tick. */
 export declare const SPINNER: string[];
 /** The frame context the compositor passes down — the pieces of time
@@ -24,6 +24,10 @@ export declare const SPINNER: string[];
 export interface FrameCtx {
     readonly spinnerI: number;
     readonly now: number;
+    /** The terminal height (rows) — the banner cell's tier input (W1:
+     *  the tier table reads H, so a resize RE-TIERS instead of
+     *  re-folding frozen rows). */
+    readonly height: number;
 }
 /** ONE screen line a component emits (raw, SGR included). */
 export type RenderLine = string;
@@ -43,7 +47,19 @@ export declare function visibleWidth(line: string): number;
 export interface Component {
     render(width: number, ctx: FrameCtx): string[];
 }
-/** The container — vertical concatenation of its children. */
+/** The W11 spacing formula — "a row gets one blank line above it when
+ *  the row is itself a block, or when the previous sibling was taller
+ *  than one row". One-row siblings pack tight; anything multi-row
+ *  breathes on both sides. The FIRST cell never gets the blank (it sits
+ *  at the body's top — the banner would otherwise start one row down).
+ *  `prev` is the previous sibling's OWN rows (raw — a cell's own blank
+ *  must never count toward its height). The blank is a JOIN artifact:
+ *  the cell's own render stays blank-free, so per-cell accounting
+ *  (heights, the fold cache) never sees a fake row. */
+export declare function bodySpacing(prev: readonly string[] | null, rows: readonly string[]): string[];
+/** The container — vertical concatenation with the W11 formula. No
+ *  component decides its own spacing: every blank in the body is the
+ *  container's. */
 export declare class Container implements Component {
     private readonly children;
     constructor(children: Component[]);
@@ -53,14 +69,21 @@ export type BodyCell = {
     kind: "user";
     text: string;
     done: true;
+    turn: number;
 } | {
     kind: "thinking";
     text: string;
     done: boolean;
+    turn: number;
 } | {
     kind: "tool";
     name: string;
     input: string;
+    /** W15: the FULL input JSON (pretty-printed) — the display
+     *  summary above is sliced at 60 chars; the expanded block's
+     *  "--- input ---" section mirrors /last and needs it all. */
+    inputFull: string;
+    childRoles: string[];
     state: "pending" | "approval" | "running" | "done";
     isError: boolean;
     resultText: string;
@@ -70,6 +93,32 @@ export type BodyCell = {
     startedAt: number | null;
     doneAt: number | null;
     done: boolean;
+    /** W15: the live-region expand toggle — while the cell is live
+     *  the FULL body renders in place (the compositor owns those
+     *  rows and redraws them); a committed cell can never toggle
+     *  (history is never rewritten — ADR-0046). */
+    expanded: boolean;
+    /** W14: the turn boundary — the index of the turn record that
+     *  created this cell (the fold-hold's owner; −1 when no turn
+     *  exists yet — the pre-turn cells never hold). */
+    turn: number;
+    /** W13: the rolled-up group summary — set at COMMIT time when
+     *  the head of an N > 2 same-tool run renders the group (the
+     *  work order's claimed shape: "✓ read  5 files (2.4k lines,
+     *  1.1s)" + the target children). The members carry null — the
+     *  compositor's rolled-heads bookkeeping renders them []. */
+    rolled: null | {
+        count: number;
+        lines: number;
+        elapsed: string;
+        targets: string[];
+    };
+    /** W19: a DENIED call's reason (the CLI extracted it from the
+     *  result's "[Permission denied] " prefix, keyed on the "denied"
+     *  tag). Non-null renders the pinned row — the full call name,
+     *  the target, the reason in the W4 parentheses idiom, NO timing
+     *  metadata (the call never ran). */
+    reason: string | null;
 } | {
     kind: "text";
     text: string;
@@ -78,6 +127,12 @@ export type BodyCell = {
     kind: "notice";
     text: string;
     done: true;
+} | {
+    kind: "banner";
+    version: string;
+    extensionsText: string;
+    resume: ResumeMeta[];
+    done: true;
 } | {
     kind: "raw";
     lines: string[];
@@ -89,26 +144,77 @@ export type BodyCell = {
     done: true;
 } | {
     kind: "checklist";
+    /** the model-authored header tail (parseChecklist's count line —
+     *  chat.ts). The compositor's fixed "todo" prefix rides BEFORE it
+     *  (W20 naming ruling: never model-controlled). */
     header: string;
     items: {
         text: string;
         status: "pending" | "active" | "done";
     }[];
-    done: true;
+    /** W20: false while LIVE — the current turn's ONE in-place block
+     *  (the commit loop only takes done cells, so it stays in the
+     *  live region); true once SETTLED — endTurn committed it as the
+     *  turn's one recap block. */
+    done: boolean;
+    /** W20: the LIVE block's ctrl+r toggle (W15) — the capped form
+     *  flips to the full list in place. The settled render ignores
+     *  it (already full). */
+    expanded: boolean;
+    /** W20: the wall clock of the block's FIRST call — the settled
+     *  header's duration is clocked from here, compositor-side (the
+     *  CLI stays unchanged). */
+    startedAt: number;
+    /** W20: the run's duration at the settle — the `2h 14m` form. */
+    durationSeconds: number;
+    turn: number;
 };
 declare const TOOL_SUMMARY_MAX = 60;
 /** The component for one cell — the mapping table lives here so the
  *  compositor stays a pure writer. */
 export declare function cellComponent(cell: BodyCell): Component;
+/** W13 — the rollup opt-in table: which tools collapse, and the count
+ *  NOUN (read_file calls → "5 files", list_dir → "5 dirs", search_text
+ *  → "5 matches"). Only these tools opt in — a shell burst is never
+ *  rolled up (its rows carry meaning). The folded-turn line (W14) reuses
+ *  the plurals for its other-tool terms ("2 dirs", "1 match"). */
+export declare const ROLLUP_NOUN: Readonly<Record<string, string>>;
+/** W14 — the folded-turn line: a whole QUIET turn (no text), once it is
+ *  scrollback, becomes ONE line — the work order's claimed shape
+ *  (`▞ thought 19s · 5 reads · no edits`), the counts accumulated at
+ *  toolStart: read_file → "reads", edit_file → "edits", the other tools
+ *  as first-call-order terms (the ROLLUP_NOUN plurals when the tool opts
+ *  in, the verb + "s" otherwise). */
+export declare function turnFold(t: {
+    thoughtSeconds: number;
+    reads: number;
+    edits: number;
+    others: [string, number][];
+}): string[];
+/** W20 — the todo block's fixed-window height: the whole live block
+ *  (header + rows) in POST-FOLD screen rows at EVERY width: the header,
+ *  the active row, up to 2 pending, the overflow-pending fold, the
+ *  done-collapse. Every live row CUTS at W (never folds) — the block's
+ *  height is its row count. */
+export declare const CAP_TODO_LIVE = 6;
+/** W20 — the settled block's duration, the `2h 14m` form (the todo
+ *  narrative's long-horizon idiom): minutes+seconds under an hour,
+ *  hours+minutes past it. */
+export declare function formatDuration(totalSeconds: number): string;
 /** The status container's row: the status text (+ the tail) with the
  *  right-aligned "/ commands · ↑ history" hint in the idle state —
  *  the hint CUT FIRST when the width is short (the #16g rule); when
  *  the STATUS ITSELF cannot fit, it cuts with a "…" — the last resort,
  *  enforced by invariant ① (the old code let the status soft-wrap). */
-export declare function statusLine(status: string, tail: string, question: boolean, W: number): string;
-/** The footer — the ONE dotted row (the old two-row chrome is gone;
- *  the wall cannot return by construction). */
-export declare function footerLine(W: number): string;
+export declare function statusLine(status: string, tail: string, question: boolean, W: number, hint?: string): string;
+/** W6 — the box: the chrome's top rail. The two ╌ dotted rows become
+ *  a rounded box (the box already says "input lives here"); the rails
+ *  stay dim, the width is still the full W (the box is a rail with
+ *  corners — the menu/gap rows above and the status below are
+ *  untouched). */
+export declare function boxTop(W: number): string;
+/** W6 — the box: the chrome's bottom rail. */
+export declare function boxBottom(W: number): string;
 /** The terminal label + rhythm gap (the pipe path's v2c bytes — the
  *  exact render the passthrough needs). */
 export declare function terminalPipe(label: string, statusLineText: string): string;