@vincemakes/kiso-tui-cells 0.22.0 → 0.24.0

package/dist/components.d.ts

@@ -44,6 +44,13 @@ export interface FrameCtx {
      *  for the whole stretch, which is the fact it is there to carry:
      *  work is in flight. Owner-ruled 2026-08-31. */
     readonly grouped?: boolean;
+    /** R13 E2 / DC-43 — how many PREVIEW rows a running card may take this
+     *  frame. Undefined is the full window (`CAP_PREVIEW`); the compositor
+     *  lowers it when the live region is tight, and 0 degrades the card to
+     *  its head row alone. It is a frame input, not a property of the
+     *  cell: the same call renders taller or shorter as the room changes,
+     *  and never as its own content changes. */
+    readonly liveWindow?: number;
 }
 /** ONE screen line a component emits (raw, SGR included). */
 export type RenderLine = string;
@@ -122,24 +129,6 @@ export type BodyCell = {
      *  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 [].
-     *  TUI2-R1 (B): `parts` is set when the run spans MORE THAN ONE
-     *  read-only tool — the same mechanism, the exploration row.
-     *  Absent (a single-name run) keeps W13's row byte for byte. */
-    rolled: null | {
-        count: number;
-        lines: number;
-        elapsed: string;
-        targets: string[];
-        parts?: readonly {
-            name: string;
-            subjects: readonly 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,
@@ -279,20 +268,6 @@ export declare const ROLLUP_NOUN: Readonly<Record<string, string>>;
  *  side effects is a list of things that HAPPENED, and every row of it
  *  carries meaning). */
 export declare function isExploreTool(name: string): boolean;
-/** "8 files · 14 searches" — the per-tool counts in first-call order. */
-export declare function exploreCounts(parts: readonly {
-    name: string;
-    subjects: readonly string[];
-}[]): string;
-/** TUI2-R1 (B) — the expanded list: ONE row per tool, the verb column
- *  then the distinct subjects in first-call order, a repeated subject
- *  carrying its ×count, the first three shown and the rest counted.
- *  A search's subject is its PATTERN (quoted — the thing that was
- *  looked for); a read's or a list's is its path. */
-export declare function exploreRows(parts: readonly {
-    name: string;
-    subjects: readonly string[];
-}[], W: number): string[];
 /** Does this tool's fold term count distinct targets rather than calls? */
 export declare function foldCountsObjects(name: string): boolean;
 export declare function foldTerms(reads: number, edits: number, others: readonly [string, number][]): string[];
@@ -382,41 +357,17 @@ export interface StretchTerms {
     /** the live mark; the caller passes the spinner's current frame. */
     readonly mark?: string;
 }
-/**
- * R4 (C1) — the fold NAMES ITS OWN TARGET.
- *
- * `ctrl+o` used to be printed identically on every fold on the screen,
- * and the key walked a ring whose order nothing on screen expressed —
- * so the owner's report was exact: "there is no way to know which
- * stretch it opens". The tint that marks the next target can only be
- * drawn on a LIVE row, and every fold worth reopening is, by
- * construction, in the scrollback where nothing can be tinted.
- *
- * A pointer cannot fix this either, and the bound is worth stating
- * once: SGR mouse reports address the VIEWPORT, so a fold that has
- * scrolled into the terminal's own scrollback is unreachable by any
- * pointer, permanently, on the primary screen. The ordinal is not a
- * cheaper substitute for clicking — it is the form of the affordance
- * that reaches every fold, and it survives a pipe as characters.
- *
- * The number rides the KEY, inside the width ladder, so it is paid for
- * by the same give-way order as every other span (law: the key never
- * gives way — it just got two characters longer).
- */
-export declare function stretchLine(t: StretchTerms & {
-    readonly phase: "thinking" | "acting" | "settled";
-    readonly mark?: string;
-}, W: number): string[];
-/** R6/D3: the quiet turn's fold wears no mark either — the SECOND
- *  emission site, and the one the D3 brief did not name. Same ruling,
- *  same two-space indent; see stretchLine above for the argument. */
-export declare function turnFold(t: {
-    words: string;
-    thoughtSeconds: number;
-    reads: number;
-    edits: number;
-    others: [string, number][];
-}, W: number): string[];
+/** The caps — screen rows counted AFTER the fold, at the current width
+ *  (the W7 table). The renderer-cut row is inside the cap. */
+/** R13 — ONE preview cap, every tool. It was the shell's alone while
+ *  the shell was the only settled call with rows on screen. */
+export declare const CAP_PREVIEW = 5;
+/** DC-46 — the running window's ceiling is the SETTLED preview's, and a
+ *  running card reaches it by growing rather than by being handed it.
+ *  `LIVE_WINDOW` (CAP_PREVIEW + 1) retires with the allocation it sized. */
+/** The rows a card costs besides its window: two pads, the head, two
+ *  blanks and the status row. Below this there is no card (DC-43). */
+export declare const CARD_CHROME = 6;
 /**
  * R4 — the standing act slot.
  *