@vincemakes/kiso-tui-cells 0.17.0 → 0.19.0

package/dist/components.d.ts

@@ -355,11 +355,41 @@ export interface StretchTerms {
     readonly targets: readonly string[];
     /** the trouble the stretch met: [kind, count, what it was]. */
     readonly trouble: readonly (readonly ["failed" | "denied" | "interrupted", number, string])[];
+    /** R4 — the tool names that still have a call IN FLIGHT. The tense is
+     *  PER TERM, not per line: a stretch whose shell has finished while a
+     *  read runs says `ran 1 shell command · reading 1 file`. The whole
+     *  line used to go progressive, which the standing act slot made a
+     *  visible contradiction — the gap frame put `running npm run check`
+     *  directly above a row reading `(exit 0, 12.4s)`. Absent ⇒ every
+     *  term takes the line's own tense, which is what the settled line
+     *  wants. */
+    readonly liveNames?: readonly string[];
     /** A9 — the human's words, on a QUIET turn's fold only. */
     readonly words?: string;
     /** the live mark; the caller passes the spinner's current frame. */
     readonly mark?: string;
 }
+/**
+ * R4 (C1) — the fold NAMES ITS OWN TARGET.
+ *
+ * `ctrl+r` 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";
 }, W: number): string[];
@@ -370,6 +400,55 @@ export declare function turnFold(t: {
     edits: number;
     others: [string, number][];
 }, W: number): string[];
+/**
+ * R4 — the standing act slot.
+ *
+ * The stretch's ONE line sits above it; this is the region under it,
+ * and it STANDS: allocated when the stretch opens, released at the
+ * fold.
+ *
+ * R3i built the same window INTERMITTENTLY — a running call got its
+ * fixed 1+3 block (W8), a finished one got nothing — so the live
+ * region's height was a function of how many calls happened to be in
+ * flight this frame. Over one real stretch that is 2 rows, then 7,
+ * then 2, then 17 for a three-call batch, then 2 again, and every
+ * transition scrolls everything above it. The owner's report was that
+ * the screen "keeps jumping", and it was an accurate description of
+ * the design, not a defect in its execution.
+ *
+ * The cure is not a smaller window, it is a STANDING one: between two
+ * calls the slot keeps the call that just finished rather than
+ * collapsing, and before any call it keeps the thinking that is
+ * producing them — which is R3i ruling 5 ("thinking belongs on the
+ * stretch line, IN THE ACT WINDOW, and in full in expansions") finally
+ * wired, since R3i stated it while building no window for the thinking
+ * phase to live in.
+ *
+ * Four rows, deliberately the same 1+3 shape W8 gave a running call, so
+ * the commonest frame — exactly one call in flight — renders byte-for-
+ * byte what 0.17.0 shipped.
+ */
+export declare const ACT_SLOT_ROWS = 4;
+/**
+ * R4 — the slot's body rows: the tail of `text`, newest at the BOTTOM,
+ * bottom-padded to exactly `rows`.
+ *
+ * The same dim │ gutter a running call's window uses (W2's table), and
+ * the same two VD-4 rules: leading blank gutters are skipped, and the
+ * short-output pad goes at the BOTTOM so output starts under its own
+ * header and grows downward. The slot's CONTENTS change; its shape
+ * does not.
+ */
+export declare function slotTail(text: string, W: number, rows: number): string[];
+/** R4 — clamp or pad assembled slot rows to EXACTLY `rows`. The padding
+ *  is what makes the slot stand; the clamp is what keeps the slot from
+ *  ever being the thing that trips the force-commit cap (a slot that
+ *  could overflow would commit real cells to relieve blank rows). */
+export declare function slotPad(content: readonly string[], rows: number): string[];
+/** R4 — the slot's overflow row: the calls in flight beyond the head
+ *  budget. It lives INSIDE the slot (it is one of the four rows), which
+ *  is what keeps a parallel burst from growing the region. */
+export declare function moreRunningRow(n: number, W: number): string;
 /** The approval mini-diff (W7): capped at 12 folded rows — the head +
  *  the named middle (the renderer cut — what was cut, how to expand) +
  *  the tail. The rows are folded at the current width BEFORE the cap —

package/dist/components.js

@@ -1189,11 +1189,21 @@ const STRETCH_COMPACT = [
  *  per-segment folds over; the "absorbs at least two rows" rule alone
  *  does not answer it. */
 function stretchTerms(t, live) {
+    // R4 — the tense is per TERM. A name with nothing in flight is in the
+    // past whatever the line's own phase is; with liveNames absent (the
+    // settled line) every term follows the line.
+    const tense = (name) => (live && (t.liveNames === undefined || t.liveNames.includes(name)) ? 1 : 0);
     const total = t.calls.reduce((n, [, c]) => n + c, 0);
-    if (total === 1 && t.targets.length === 1) {
+    // R4 — the one-call TARGET form is the SETTLED line's. Live, the act
+    // slot directly below already names the target on its head row, so
+    // the line was printing the same words twice, one above the other
+    // (`running npm run check` over `shell npm run check`). Settled there
+    // is no slot, and naming the target is strictly more than counting to
+    // one — which is the R3i rule this keeps, where it applies.
+    if (total === 1 && t.targets.length === 1 && !live) {
         const [name] = t.calls[0];
         const e = TERM[name];
-        return [`${e === undefined ? name : e[live ? 1 : 0]} ${t.targets[0]}`];
+        return [`${e === undefined ? name : e[0]} ${t.targets[0]}`];
     }
     return t.calls
         .filter(([, n]) => n > 0)
@@ -1201,7 +1211,7 @@ function stretchTerms(t, live) {
         const e = TERM[name];
         if (e === undefined)
             return `${n} × ${displayVerb(name)}`;
-        return `${e[live ? 1 : 0]} ${n} ${n === 1 ? e[2] : e[3]}`;
+        return `${e[tense(name)]} ${n} ${n === 1 ? e[2] : e[3]}`;
     });
 }
 /** R3i — the trouble clause: which call, and what happened, in WORDS.
@@ -1214,11 +1224,45 @@ function troubleClause(t) {
         .map(([kind, n, what]) => (what === "" || kind === "interrupted" ? `${n} ${kind}` : `${n} ${kind}: ${what}`))
         .join(" · ");
 }
+/**
+ * R4 (C1) — the fold NAMES ITS OWN TARGET.
+ *
+ * `ctrl+r` 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 function stretchLine(t, W) {
     const p = palette();
     const live = t.phase !== "settled";
     const mark = t.phase === "settled" ? `${p.bold}✦${p.reset}` : `${p.dim}${t.mark ?? "✧"}${p.reset}`;
-    const key = t.phase === "settled" ? " · ctrl+r" : "";
+    // R4a (owner ruling, 2026-08-30) — the fold row prints NO key.
+    //
+    // R4 printed `· ctrl+r 3` so the row could name its own target. The
+    // owner's objection is the right one: a number you cannot type is not
+    // a selector, it is decoration that costs a column — and the
+    // reference implementation, checked rather than assumed, prints
+    // nothing on the row either. Its expansion lives in a MODE you enter,
+    // where the pointer can reach every fold including the ones that have
+    // scrolled away; the row itself stays clean.
+    //
+    // So the affordance is retired here and owed to that mode. Until it
+    // exists, `ctrl+r` still opens the most recent fold — it is simply no
+    // longer advertised on a row that cannot say which one it means.
+    const key = "";
     const lead = t.phase === "thinking" ? [`thinking ${t.thoughtSeconds}s`] : t.phase === "settled" && t.thoughtSeconds > 0 ? [`thought ${t.thoughtSeconds}s`] : [];
     const clauseText = troubleClause(t);
     let meta = [...lead, ...(t.phase === "thinking" ? [] : stretchTerms(t, live))].join(" · ");
@@ -1552,6 +1596,77 @@ function shellLiveTail(text, W) {
         kept.push(`${p.dim}${BODY_ROW}${p.reset}`);
     return [...kept, cutLine(`${p.dim}${CUT_ROW}live tail · esc stop · alt+⏎ redirect${p.reset}`, W)];
 }
+/**
+ * R4 — the standing act slot.
+ *
+ * The stretch's ONE line sits above it; this is the region under it,
+ * and it STANDS: allocated when the stretch opens, released at the
+ * fold.
+ *
+ * R3i built the same window INTERMITTENTLY — a running call got its
+ * fixed 1+3 block (W8), a finished one got nothing — so the live
+ * region's height was a function of how many calls happened to be in
+ * flight this frame. Over one real stretch that is 2 rows, then 7,
+ * then 2, then 17 for a three-call batch, then 2 again, and every
+ * transition scrolls everything above it. The owner's report was that
+ * the screen "keeps jumping", and it was an accurate description of
+ * the design, not a defect in its execution.
+ *
+ * The cure is not a smaller window, it is a STANDING one: between two
+ * calls the slot keeps the call that just finished rather than
+ * collapsing, and before any call it keeps the thinking that is
+ * producing them — which is R3i ruling 5 ("thinking belongs on the
+ * stretch line, IN THE ACT WINDOW, and in full in expansions") finally
+ * wired, since R3i stated it while building no window for the thinking
+ * phase to live in.
+ *
+ * Four rows, deliberately the same 1+3 shape W8 gave a running call, so
+ * the commonest frame — exactly one call in flight — renders byte-for-
+ * byte what 0.17.0 shipped.
+ */
+export const ACT_SLOT_ROWS = 4;
+/**
+ * R4 — the slot's body rows: the tail of `text`, newest at the BOTTOM,
+ * bottom-padded to exactly `rows`.
+ *
+ * The same dim │ gutter a running call's window uses (W2's table), and
+ * the same two VD-4 rules: leading blank gutters are skipped, and the
+ * short-output pad goes at the BOTTOM so output starts under its own
+ * header and grows downward. The slot's CONTENTS change; its shape
+ * does not.
+ */
+export function slotTail(text, W, rows) {
+    if (rows <= 0)
+        return [];
+    const p = palette();
+    const all = blockRows(text, W);
+    const from = all.findIndex((r) => visibleWidth(r) > visibleWidth(BODY_ROW));
+    const body = from < 0 ? [] : all.slice(from);
+    const kept = body.slice(Math.max(0, body.length - rows));
+    while (kept.length < rows)
+        kept.push(`${p.dim}${BODY_ROW}${p.reset}`);
+    return kept;
+}
+/** R4 — clamp or pad assembled slot rows to EXACTLY `rows`. The padding
+ *  is what makes the slot stand; the clamp is what keeps the slot from
+ *  ever being the thing that trips the force-commit cap (a slot that
+ *  could overflow would commit real cells to relieve blank rows). */
+export function slotPad(content, rows) {
+    if (rows <= 0)
+        return [];
+    const p = palette();
+    const out = content.slice(0, rows);
+    while (out.length < rows)
+        out.push(`${p.dim}${BODY_ROW}${p.reset}`);
+    return out;
+}
+/** R4 — the slot's overflow row: the calls in flight beyond the head
+ *  budget. It lives INSIDE the slot (it is one of the four rows), which
+ *  is what keeps a parallel burst from growing the region. */
+export function moreRunningRow(n, W) {
+    const p = palette();
+    return cutLine(`  ${p.dim}${CUT_ROW}+${n} more running${p.reset}`, W);
+}
 /** W12: the delegate's child sessions collapse to the tool row plus ONE
  *  line — the height NEVER changes (running → settled replaces the row
  *  in place). The running row derives from the INPUT: the parent has no

package/dist/strings.js

@@ -189,6 +189,11 @@ export const KEY_BINDINGS = [
     { keys: "/", what: "commands" },
     { keys: "↑↓", what: "history / queue pop" },
     { keys: "ctrl+r", what: "expand cells" },
+    // R5 — the transcript viewer. It has to be HERE or it does not exist:
+    // R4a retired the printed key from the fold row on the ground that a
+    // row cannot say which fold a key opens, and the sheet is where the
+    // discoverability moved. A surface nobody can find is not a feature.
+    { keys: "ctrl+o", what: "transcript" },
     { keys: "tab", what: "complete (menu / @)" },
     { keys: "?", what: "this sheet" },
     { keys: "ctrl+z / ctrl+y", what: "undo / redo" },
@@ -254,15 +259,22 @@ const SHEET_GRID = [
     [0, 1, 2],
     [3, 4, 5],
     [6, 7],
+    // R5: ctrl+o joins at index 8, so the tail shifts by one. The grid is
+    // a SECOND table that must agree with KEY_BINDINGS and nothing makes
+    // it — adding a binding without touching this silently drops the LAST
+    // one off the sheet, which is exactly what happened on the first
+    // attempt and exactly what the "ONE SOURCE" gate exists to catch.
     [8, 9],
-    [10], // UD-1: its own single-column row — no hand-tuned stop touched
+    // UD-1's undo row shares this one now — the table has an even count
+    // again, so no binding needs a row to itself.
+    [10, 11],
 ];
 const SHEET_STOPS = [
     [16, 43],
     [16, 43],
     [36],
     [36],
-    [],
+    [36],
 ];
 /**
  * TUI2-R1 (D) — the sheet, one screen, static.
@@ -381,6 +393,9 @@ export function helpRows() {
         ["/help", "print this list of commands"],
         ["/think", "show the last full thinking block"],
         ["/last", "show the most recent tool call's input and output"],
+        // R4 (C4d): a committed row is the terminal's, and cannot be
+        // re-wrapped in place (ADR-0046) — this appends it re-folded.
+        ["/rewrap", "re-print the recent prose at the current width"],
         ["/status", "show session id, event count, and context estimate"],
         ["/mode", "show the approval tier; /mode <name> switches (manual/default/accept-edits/plan/bypass)"],
         ["/model", "list model profiles; /model <name|provider/model> switches"],

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui-cells",
-	"version": "0.17.0",
+	"version": "0.19.0",
 	"description": "kiso tui-cells — the components cell renderer (components, diff, width, the render slice). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",