@vincemakes/kiso-tui-cells 0.23.0 → 0.24.1

package/dist/components.d.ts

@@ -8,7 +8,15 @@
  * lives HERE: every line a component returns must fit the terminal
  * width — the compositor's crash-on-violation invariant backs it up
  * (a component that forgets to fold CRASHES with a diagnostic, never
- * silently truncates — the crash is the contract, not a symptom).
+ * silently truncates — the crash is the contract UNDER TEST; in the
+ * field the row is cut and the fact is said, once, through the notice
+ * channel. DECLARED REVERSAL of "the crash is the contract, not a
+ * symptom" (owner-lane, 2026-09-04): two instances of this class in two
+ * days, one caught by a gate (DC-45) and one by the owner on the first
+ * frame of an ordinary command (DC-48). In a gate the crash is right; in
+ * a human's hands it costs them the composer and the session to save
+ * them a row one column too wide. `KISO_INVARIANTS=throw` is what every
+ * suite here runs under).
  *
  * The fold is SGR-AWARE: a line whose bold/dim span would straddle a
  * fold boundary closes the span at the break and reopens it on the
@@ -44,6 +52,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 +137,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 +276,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 +365,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.
  *