@vincemakes/kiso-tui-cells 0.20.3 → 0.21.0

package/dist/approval-panel.d.ts

@@ -266,7 +266,7 @@ export interface PanelView {
     /** The fix hint per speaker (the v8 design §3.5 table). */
     readonly hint?: string;
     /** The options-phase status-left text — the CLI knows the context
-     *  ("⏸ run paused", the trust gate's line). */
+     *  ("❯ run paused", the trust gate's line). */
     readonly statusText: string;
     /** The ALWAYS-verbose args — the full command/content/diff. */
     readonly args: PanelArgs;
@@ -395,7 +395,7 @@ export declare function panelLeadPlain(view: PanelView, phase: PanelPhase, curso
 export declare function panelLeadWidth(view: PanelView, phase: PanelPhase, cursor: number): number;
 /** The status row's left text while the panel is up — the phase, not
  *  the CLI's painting status (the compositor derives it from the panel
- *  state; the "⏸ run paused" etc. ride the options phase). */
+ *  state; the "❯ run paused" etc. ride the options phase). */
 export declare function panelStatus(view: PanelView, phase: PanelPhase, cursor: number): string;
 /**
  * The status row's right-aligned hint — the v4 frame's line, verbatim.

package/dist/approval-panel.js

@@ -432,8 +432,8 @@ export function panelLeadWidth(view, phase, cursor) {
 }
 /** The status row's left text while the panel is up — the phase, not
  *  the CLI's painting status (the compositor derives it from the panel
- *  state; the "⏸ run paused" etc. ride the options phase). */
-// R2 (design §4, the ⏸ ruling): a panel that is WAITING ON A HUMAN says
+ *  state; the "❯ run paused" etc. ride the options phase). */
+// R2 (design §4, the ❯ ruling): a panel that is WAITING ON A HUMAN says
 // so with the one mark that means it. `▸` is the checklist's "the
 // current one" — a mark meaning two things is worse than two marks
 // (law 4.2), and the thing this row has to convey is not "here" but
@@ -450,7 +450,7 @@ export function panelStatus(view, phase, cursor) {
     // typing needs to know the model will read this and answer with a new
     // call — which is what the v4 frame says, in those words.
     if (phase === "amend")
-        return "⏸ your note goes to the model — it will propose a new call";
+        return "❯ your note goes to the model — it will propose a new call";
     return view.statusText;
 }
 /**

package/dist/components.d.ts

@@ -151,7 +151,7 @@ export type BodyCell = {
      *  settled head row aggregates name + status + decidedBy in ONE
      *  row: a denied call's pinned row gains `· by <decidedBy>`; an
      *  extension-approved call's settled row gains `· approved by
-     *  <decidedBy>` (the human approval needs no marker — the ⏸ →
+     *  <decidedBy>` (the human approval needs no marker — the ❯ →
      *  spinner → ✓ sequence told the story). Null until a decision
      *  lands (the auto-allowed calls never have one). */
     verdict: {
@@ -207,7 +207,7 @@ export type BodyCell = {
      *  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
+    /** W20: the LIVE block's ctrl+o toggle (W15) — the capped form
      *  flips to the full list in place. The settled render ignores
      *  it (already full). */
     expanded: boolean;
@@ -224,8 +224,9 @@ declare const TOOL_SUMMARY_MAX = 60;
  *  compositor stays a pure writer. */
 export declare function cellComponent(cell: BodyCell): Component;
 /** W22: the pending-queue chips — queued user lines pre-render above
- *  the input row as the SAME UserMessage chip (undimmed: reverse video
- *  inverts the CURRENT colours), the dim `□` gutter marking the queued
+ *  the input row as the SAME UserMessage chip (undimmed: §2.1 forbids
+ *  dim ON the wash, and on rung 4 reverse video would invert it into a
+ *  dimmed block), the dim `□` gutter marking the queued
  *  state (the gutter rides EVERY row — the gutterFold precedent: the
  *  left edge alone distinguishes the states). Each chip folds at W−3
  *  (the gutter's 2 cells), so a long line hard-folds INSIDE the chip
@@ -245,7 +246,7 @@ export declare function expandSuffix(lines: number | null, room: number): string
 /**
  * TUI2-R2 ⑤ (D, candidate 1) — the FOCUS tint.
  *
- * The cell the next ctrl+r will act on brightens its own `ctrl+r` token
+ * The cell the next ctrl+o will act on brightens its own `ctrl+o` token
  * to the code tint; the rest of the suffix — the separator, the count —
  * stays dim, because what is being marked is the KEY's target, not the
  * row. Zero new rows, zero new columns: the affordance the cell already
@@ -253,7 +254,7 @@ export declare function expandSuffix(lines: number | null, room: number): string
  *
  * Applied to a row rather than composed into it on purpose. The token is
  * emitted from several places (the settled suffix, the renderer's own
- * `└ +N … · ctrl+r` cut rows) and threading a flag through all of them
+ * `└ +N … · ctrl+o` cut rows) and threading a flag through all of them
  * would put the invariant "exactly one bright token" in as many hands as
  * there are emitters. Here it has exactly one.
  *
@@ -307,7 +308,7 @@ export declare function foldTerms(reads: number, edits: number, others: readonly
  *
  *   thinking   ✧ thinking 4s
  *   acting     ✶ reading 6 files · running 4 shell commands
- *   settled    ✦ thought 9s · read 6 files · ran 4 shell commands · ctrl+r
+ *   settled    ✦ thought 9s · read 6 files · ran 4 shell commands · ctrl+o
  *
  * THE GIVE-WAY LADDER, in order, because at some width everything
  * cannot fit:
@@ -384,7 +385,7 @@ export interface StretchTerms {
 /**
  * R4 (C1) — the fold NAMES ITS OWN TARGET.
  *
- * `ctrl+r` used to be printed identically on every fold on the screen,
+ * `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
@@ -508,7 +509,7 @@ export declare function formatDuration(totalSeconds: number): string;
  *  W21: the question param is gone — the old question slot retires; a
  *  pending approval's status IS the panel's (the compositor derives
  *  it from the bound panel state). */
-/** R8b — THE IDLE HINT GIVES WAY IN ORDER, and `ctrl+o` is on it.
+/** R8b — THE IDLE HINT GIVES WAY IN ORDER, and `ctrl+r` is on it.
  *
  *  The transcript viewer shipped in 0.19.0 and was reachable only from
  *  the `?` sheet: not on the banner's key line, not here. A feature
@@ -519,9 +520,9 @@ export declare function formatDuration(totalSeconds: number): string;
  *  when it does not fit — a longer string would take `/ commands` down
  *  with it on a narrow terminal. So the forms are a ladder, and the
  *  order says which affordance is least replaceable: `/ commands`
- *  survives longest because it is the door to everything; `ctrl+o`
+ *  survives longest because it is the door to everything; `ctrl+r`
  *  outranks `↑ history` because pressing up is how a person finds the
- *  history by accident, and nothing finds ctrl+o by accident. */
+ *  history by accident, and nothing finds ctrl+r by accident. */
 export declare function idleHint(room: number): string;
 export declare function statusLine(status: string, tail: string, W: number, hint?: string): string;
 /** The display-width prefix of a plain (SGR-free) text. W21: exported

package/dist/components.js

@@ -185,10 +185,20 @@ export function cellComponent(cell) {
  *
  * The padding is by cells (charWidth is the width authority), so a CJK
  * row pads by width, never by chars, and the chip never overruns.
- * SGR 7 closed with SGR 27 — never SGR 0, the chip composes with a
- * surrounding span — and NEVER dim: reverse video inverts the CURRENT
- * colours, so dimmed text would invert into a dimmed block with no
- * contrast.
+ *
+ * R9 P1 — the surface is the WASH (§1.6, §7.9), closed with 49 rather
+ * than SGR 0 so the chip composes with a surrounding span. It drew with
+ * SGR 7 on every ground until now, which §7.9 never asked for: on a
+ * light terminal that is a full-width black band, on a dark one a white
+ * one, and every turn has exactly one. §11 settles which side was
+ * stale — the design said washed, the code predated DC-3's ground-
+ * resolved wash and was never moved onto it. The ladder makes the move
+ * safe: with no ground `wash` IS reverse video (§3 rung 4), so the
+ * unknown-ground chip is byte-identical to what shipped.
+ *
+ * NEVER dim inside it, on either surface: §2.1 on a resolved wash, and
+ * on rung 4 because reverse video inverts the CURRENT colours, so
+ * dimmed text inverts into a dimmed block with no contrast.
  */
 /**
  * REL-0152-D13 — how much of a turn the chip shows.
@@ -226,7 +236,13 @@ class UserMessage {
                 truncated = true;
                 break;
             }
-            for (const row of foldLine(escapeTerminal(para), chipW)) {
+            // R9 Q3: by WORD. The char fold was defended as lossless, and
+            // that argument does not survive CJK — a run with no spaces has
+            // nothing to lose — while every other prose surface in the
+            // product already folds by word (ErrorLine, VD-10). foldWords
+            // falls through to foldLine's hard break for a word wider than
+            // the row, so invariant ① still outranks the word.
+            for (const row of foldWords(escapeTerminal(para), chipW)) {
                 if (content.length >= USER_CHIP_ROWS) {
                     truncated = true;
                     break;
@@ -245,7 +261,7 @@ class UserMessage {
         // row is two cells per character and pads by cells.
         const inner = chipW;
         for (const row of content) {
-            rows.push(`${p.rv} ${row}${" ".repeat(Math.max(0, inner - displayWidth(row)))} ${p.rvEnd}`);
+            rows.push(`${p.wash} ${row}${" ".repeat(Math.max(0, inner - displayWidth(row)))} ${p.washEnd}`);
         }
         if (!truncated)
             return rows;
@@ -262,8 +278,9 @@ class UserMessage {
     }
 }
 /** W22: the pending-queue chips — queued user lines pre-render above
- *  the input row as the SAME UserMessage chip (undimmed: reverse video
- *  inverts the CURRENT colours), the dim `□` gutter marking the queued
+ *  the input row as the SAME UserMessage chip (undimmed: §2.1 forbids
+ *  dim ON the wash, and on rung 4 reverse video would invert it into a
+ *  dimmed block), the dim `□` gutter marking the queued
  *  state (the gutter rides EVERY row — the gutterFold precedent: the
  *  left edge alone distinguishes the states). Each chip folds at W−3
  *  (the gutter's 2 cells), so a long line hard-folds INSIDE the chip
@@ -353,7 +370,7 @@ class ThinkingFold {
         // opens with a numbered plan ("1. …\n2. …") produces exactly it.
         // Invariant ①b now catches the class at the emit; this stops
         // producing it. Whitespace collapses because the row is a
-        // SUMMARY — the full text is one ctrl+r away, unchanged.
+        // SUMMARY — the full text is one ctrl+o away, unchanged.
         const trimmed = escapeTerminal(block.trim()).replace(/\s+/g, " ");
         // R2 (owner, 2026-08-27) — three changes, each independent.
         //
@@ -587,7 +604,7 @@ function toolTargetOf(c) {
  *  own render; the lines fold (the summary gives way first). W7 (the
  *  flow contract): the block's BODY (the rows below the header) is
  *  capped in SCREEN rows AFTER the fold, at the current width — the
- *  renderer-cut row (`└ +N … · ctrl+r`) sits INSIDE the cap (a
+ *  renderer-cut row (`└ +N … · ctrl+o`) sits INSIDE the cap (a
  *  truncated block is cap−1 output rows + the cut row); the TOOL-cut
  *  row (`└ capped by …` — the tool's OWN truncation note, W10) is a
  *  DIFFERENT fact, never counted in the output cap. W3: the verb is
@@ -626,7 +643,7 @@ class ToolExecution {
             const head = `  explored ${p.bold}${counts}${p.reset}`; // R2: no tick
             const tail = ` (${r.elapsed}s)`;
             const room = W - visibleWidth(head) - tail.length;
-            const affordance = " · ctrl+r lists them";
+            const affordance = " · ctrl+o lists them";
             return [cutLine(`${head}${p.dim}${tail}${affordance.length <= room ? affordance : ""}${p.reset}`, W)];
         }
         if (c.rolled !== null) {
@@ -634,7 +651,7 @@ class ToolExecution {
             // the work order's claimed shape, verbatim — the verbCol's
             // 5-char pad reproduces the "read  5 files" double space, the
             // children are the first 3 basename targets, the overflow row
-            // carries the ctrl+r affordance (its "└ … ctrl+r" joins the
+            // carries the ctrl+o affordance (its "└ … ctrl+o" joins the
             // W15 expand history — the head's commit captures it).
             const r = c.rolled;
             const noun = ROLLUP_NOUN[c.name] ?? "calls";
@@ -643,7 +660,7 @@ class ToolExecution {
             if (shown.length > 0)
                 out.push(`  ${p.dim}${CUT_ROW}${escapeTerminal(shown.join(" · "))}${p.reset}`);
             if (r.targets.length > 3)
-                out.push(`  ${p.dim}${CUT_ROW}+${r.targets.length - 3} more — ctrl+r expands${p.reset}`);
+                out.push(`  ${p.dim}${CUT_ROW}+${r.targets.length - 3} more — ctrl+o expands${p.reset}`);
             return out;
         }
         if (c.state === "done") {
@@ -674,7 +691,7 @@ class ToolExecution {
             }
             const elapsed = c.startedAt !== null && c.doneAt !== null ? ((c.doneAt - c.startedAt) / 1000).toFixed(1) : "?";
             // TUI2-R1.5 ⑤ (VD-6): the line count is stated EXACTLY ONCE. Every
-            // read card carried it twice — `(2 lines, 0.0s) · 2 lines · ctrl+r
+            // read card carried it twice — `(2 lines, 0.0s) · 2 lines · ctrl+o
             // expands` — because the parens and the suffix were written by
             // different rounds, each unaware the other was counting. The
             // SUFFIX keeps it (it is the one that also names the key), so a
@@ -718,8 +735,8 @@ class ToolExecution {
             return out;
         }
         if (c.state === "approval") {
-            // W2: the ⏸ is the GUTTER (the left edge), never the line's tail
-            const out = gutterCut(`${p.bold}⏸${p.reset} `, `${verbCol} ${liveTarget(c)}`, W);
+            // W2: the ❯ is the GUTTER (the left edge), never the line's tail
+            const out = gutterCut(`${p.bold}❯${p.reset} `, `${verbCol} ${liveTarget(c)}`, W);
             out.push(...toolBlockBody(c, W));
             return out;
         }
@@ -760,7 +777,7 @@ class ToolExecution {
  * The affordance is a statement about hidden content: a cell whose body
  * is already whole on screen must not advertise a key that would show it
  * the same thing, and a cell that already carries its own renderer cut
- * (`└ +N earlier rows · ctrl+r`, `└ +N more · ctrl+r`) already teaches
+ * (`└ +N earlier rows · ctrl+o`, `└ +N more · ctrl+o`) already teaches
  * the key at the place the content stops. What is LEFT — and it is the
  * common case — is every settled non-shell call, whose collapsed body is
  * empty: the whole result sits behind the key with nothing on screen
@@ -799,12 +816,12 @@ function hiddenLines(c, W) {
  * against the room the row actually has).
  */
 /** TUI2-R1.5 ⑤ — the cells a settled head row reserves for its
- *  affordance: exactly the shortest tier, " · ctrl+r". The suffix used
+ *  affordance: exactly the shortest tier, " · ctrl+o". The suffix used
  *  to take whatever width happened to be left, so a long target spent it
  *  all and the card said nothing about the lines behind the key. Every
  *  row that fitted its head before still fits it; only a head that would
  *  have eaten the whole row gives up its last nine cells. */
-const SUFFIX_MIN = " · ctrl+r".length;
+const SUFFIX_MIN = " · ctrl+o".length;
 /**
  * TUI2-R1.5 pin 4 — the settled head row's text, with a PINNED cut
  * order.
@@ -814,8 +831,8 @@ const SUFFIX_MIN = " · ctrl+r".length;
  * came last, so the parens were what got cut. The walkthrough caught
  * both consequences —
  *
- *   ✓ shell printf '…' 1 2 … 12 (exit 0 · approv… · ctrl+r
- *   ✓ shell for i in 1 2 3 …                          … · ctrl+r
+ *   ✓ shell printf '…' 1 2 … 12 (exit 0 · approv… · ctrl+o
+ *   ✓ shell for i in 1 2 3 …                          … · ctrl+o
  *
  * — an UNCLOSED parenthesis, and a row that lost the exit code and the
  * duration to a command string that had no claim on them. A cut that
@@ -880,7 +897,7 @@ export function expandSuffix(lines, room) {
     if (lines === null)
         return "";
     const count = `${lines} line${lines === 1 ? "" : "s"}`;
-    for (const tier of [` · ${count} · ctrl+r expands`, ` · ${count} · ctrl+r`, " · ctrl+r"]) {
+    for (const tier of [` · ${count} · ctrl+o expands`, ` · ${count} · ctrl+o`, " · ctrl+o"]) {
         if (tier.length <= room)
             return tier;
     }
@@ -897,7 +914,7 @@ function appendSuffix(row, suffix) {
 /**
  * TUI2-R2 ⑤ (D, candidate 1) — the FOCUS tint.
  *
- * The cell the next ctrl+r will act on brightens its own `ctrl+r` token
+ * The cell the next ctrl+o will act on brightens its own `ctrl+o` token
  * to the code tint; the rest of the suffix — the separator, the count —
  * stays dim, because what is being marked is the KEY's target, not the
  * row. Zero new rows, zero new columns: the affordance the cell already
@@ -905,7 +922,7 @@ function appendSuffix(row, suffix) {
  *
  * Applied to a row rather than composed into it on purpose. The token is
  * emitted from several places (the settled suffix, the renderer's own
- * `└ +N … · ctrl+r` cut rows) and threading a flag through all of them
+ * `└ +N … · ctrl+o` cut rows) and threading a flag through all of them
  * would put the invariant "exactly one bright token" in as many hands as
  * there are emitters. Here it has exactly one.
  *
@@ -913,7 +930,7 @@ function appendSuffix(row, suffix) {
  */
 export function focusToken(row, W) {
     const p = palette();
-    const at = row.lastIndexOf(CTRL_R);
+    const at = row.lastIndexOf(EXPAND_KEY);
     if (at !== -1) {
         // the row already names the key — brighten the token in place, and
         // leave every other span exactly as it was
@@ -927,10 +944,10 @@ export function focusToken(row, W) {
         // attribute like bold is spent everywhere. It closes with washEnd
         // rather than a reset, so the surrounding dim survives instead of
         // having to be re-applied.
-        return `${row.slice(0, at)}${p.lift}${CTRL_R}${p.dim}${row.slice(at + CTRL_R.length)}`;
+        return `${row.slice(0, at)}${p.lift}${EXPAND_KEY}${p.dim}${row.slice(at + EXPAND_KEY.length)}`;
     }
     // A LIVE row does not carry the affordance today, and the live cell is
-    // the one ctrl+r takes FIRST (expandNext scans the live tail before
+    // the one ctrl+o takes FIRST (expandNext scans the live tail before
     // the committed ring) — so the row the key is aimed at was the one row
     // that never said the key existed. The affordance IS the marker here:
     // it appears on the focused row and nowhere else, which is why no
@@ -939,13 +956,15 @@ export function focusToken(row, W) {
     const room = W - visibleWidth(row);
     if (room < SUFFIX_MIN)
         return row; // never at the cost of invariant ①
-    return `${row}${p.dim} · ${p.lift}${CTRL_R}${p.reset}`;
+    return `${row}${p.dim} · ${p.lift}${EXPAND_KEY}${p.reset}`;
 }
-const CTRL_R = "ctrl+r";
+/** DC-41 — the label in ONE place. The key has moved once now, and
+ *  a constant named after its binding is a comment that lies. */
+const EXPAND_KEY = "ctrl+o";
 /** TUI2-R1 (A) — the expanded block's last row: the way back. The
  *  rollup's expanded list carries a second clause (its members' full
  *  outputs live in /last, which the group row cannot show). */
-const COLLAPSE_ROW = "ctrl+r collapses";
+const COLLAPSE_ROW = "ctrl+o collapses";
 /** 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
@@ -1049,7 +1068,7 @@ function countTerm(n, singular, plural) {
  *  DECLARED SUPERSESSION (R3g, 2026-08-28) — A9 also ruled that "the
  *  metadata terms give way LAST". They do not any more: the KEY does.
  *  A9 was taken when this line carried no key, and at a width where the
- *  chip, the full metadata and " · ctrl+r" cannot coexist, a fold with
+ *  chip, the full metadata and " · ctrl+o" cannot coexist, a fold with
  *  no key is the turn's work behind a line with no way back to it. So
  *  the order is now words, then metadata, then — never — the key. The
  *  glyph is ✦ and the zero terms are dropped (R3b), so the example above
@@ -1153,7 +1172,7 @@ export function foldTerms(reads, edits, others) {
  *
  *   thinking   ✧ thinking 4s
  *   acting     ✶ reading 6 files · running 4 shell commands
- *   settled    ✦ thought 9s · read 6 files · ran 4 shell commands · ctrl+r
+ *   settled    ✦ thought 9s · read 6 files · ran 4 shell commands · ctrl+o
  *
  * THE GIVE-WAY LADDER, in order, because at some width everything
  * cannot fit:
@@ -1283,7 +1302,7 @@ function troubleClause(t) {
 /**
  * R4 (C1) — the fold NAMES ITS OWN TARGET.
  *
- * `ctrl+r` used to be printed identically on every fold on the screen,
+ * `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
@@ -1340,7 +1359,7 @@ export function stretchLine(t, W) {
     const mark = t.mark ?? " ";
     // 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
+    // R4 printed `· ctrl+o 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
@@ -1349,7 +1368,7 @@ export function stretchLine(t, W) {
     // 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
+    // exists, `ctrl+o` 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`] : [];
@@ -1441,7 +1460,7 @@ export function turnFold(t, W) {
             out = out.replaceAll(long, short);
         return out;
     };
-    const KEY = " · ctrl+r";
+    const KEY = " · ctrl+o";
     const keyW = KEY.length;
     const key = `${p.dim}${KEY}${p.reset}`;
     if (words === "") {
@@ -1585,11 +1604,11 @@ function toolBlockBody(c, W) {
                     ? delegateSettled(c, W)
                     : // TUI2-R1.5 ④(c) (VD-5): a settled shell collapses like
                         // every other settled call. It used to keep its last
-                        // rows plus a "+N earlier rows · ctrl+r" cut FOREVER —
+                        // rows plus a "+N earlier rows · ctrl+o" cut FOREVER —
                         // six rows per call, so three shells owned a screen. The
                         // approved R1 prototype's state 2 is one line; the head
                         // row's own suffix already names the count and the key,
-                        // and ctrl+r shows the whole block, not a five-row window
+                        // and ctrl+o shows the whole block, not a five-row window
                         // of it.
                         []
             : c.state === "running"
@@ -1639,7 +1658,7 @@ function shellTail(text, W) {
     if (rows.length <= CAP_SHELL_SETTLED)
         return rows;
     const kept = CAP_SHELL_SETTLED - 1;
-    const cut = foldLine(`${p.dim}${NOTE_ROW}+${rows.length - kept} earlier rows · ctrl+r${p.reset}`, W);
+    const cut = foldLine(`${p.dim}${NOTE_ROW}+${rows.length - kept} earlier rows · ctrl+o${p.reset}`, W);
     return [...rows.slice(rows.length - kept), ...cut];
 }
 /** The error text head: the FIRST rows, capped at 3 — the answer is at
@@ -1659,7 +1678,7 @@ function errorBody(c, W) {
     const rows = blockRows(c.resultText.split("\n").slice(skipFirst).join("\n"), W);
     if (rows.length <= CAP_ERROR)
         return rows;
-    const cut = foldLine(`${p.dim}${NOTE_ROW}+${rows.length - (CAP_ERROR - 1)} more · ctrl+r${p.reset}`, W);
+    const cut = foldLine(`${p.dim}${NOTE_ROW}+${rows.length - (CAP_ERROR - 1)} more · ctrl+o${p.reset}`, W);
     return [...rows.slice(0, CAP_ERROR - 1), ...cut];
 }
 /** The running tool's FIXED-height window (W8): exactly 3 rows from
@@ -1686,7 +1705,7 @@ function liveWindow(text, W) {
             rows.push(""); // R7a: blank, not a bar
         return rows;
     }
-    const cut = foldLine(`${p.dim}${NOTE_ROW}+${rows.length - (CAP_LIVE_WINDOW - 1)} earlier rows · ctrl+r${p.reset}`, W);
+    const cut = foldLine(`${p.dim}${NOTE_ROW}+${rows.length - (CAP_LIVE_WINDOW - 1)} earlier rows · ctrl+o${p.reset}`, W);
     return [...rows.slice(rows.length - (CAP_LIVE_WINDOW - 1)), ...cut];
 }
 /**
@@ -1891,7 +1910,7 @@ export function diffBody(diff, W, expanded = false) {
     // W17: the └ cut is ONE row at every width — the count leads, the
     // expand affordances are cuttable (the same one-line shape as W12's
     // delegate row and W18's status row).
-    const cut = (n) => oneLineRow(p, `+${n} rows · ctrl+r to expand · /last for the full diff`, W);
+    const cut = (n) => oneLineRow(p, `+${n} rows · ctrl+o to expand · /last for the full diff`, W);
     // W17: the floor — the head window shows the lines whose fold starts
     // before `head` rows; the tail window the lines whose fold ENDS after
     // `rows.length - tail` (starts[i+1] is line i's end). When the pair
@@ -2062,9 +2081,9 @@ export function formatDuration(totalSeconds) {
  * the compositor-derived counts (the model tail rides AFTER — never
  * model-controlled), the active item first with ▸ (the menu's "the
  * current one"), pending next (≤2), the done items COLLAPSED behind the
- * W10 cut family `└ +N done · ctrl+r`, overflow pending behind
- * `└ +N more · ctrl+r` — every row cut at W so the cap holds at every
- * width. ctrl+r (W15) toggles the full list in place (expanded). SETTLED
+ * W10 cut family `└ +N done · ctrl+o`, overflow pending behind
+ * `└ +N more · ctrl+o` — every row cut at W so the cap holds at every
+ * width. ctrl+o (W15) toggles the full list in place (expanded). SETTLED
  * (done:true): the recap idiom `task done · N items · <duration>` + the
  * FULL final item list in the checklist's existing shape (▖/□/▣ —
  * indented two, the glyph leads, no │ gutter).
@@ -2087,7 +2106,7 @@ class Checklist {
             : `task · ${plural(items.length, "item")} · ${active.length} active · ${doneCount} done`;
         const header = `${p.bold}✦${p.reset} ${escapeTerminal(fixed + tail)}`;
         // the FULL-list forms: SETTLED — the durable record (the fold is
-        // fine — committed content wraps naturally) — and the LIVE ctrl+r
+        // fine — committed content wraps naturally) — and the LIVE ctrl+o
         // toggle (the header CUTS — the block stays one window high; the
         // expanded rows show the ▣ the collapse hid). The live flag picks
         // the glyphs: the settled list keeps the durable ▖, the expanded
@@ -2105,7 +2124,7 @@ class Checklist {
         // LIVE — the fixed window: the header + the item rows CUT at W
         // (one screen row each — the block's height is its row count,
         // CAP_TASK_LIVE, at every width). The cut is the momentary view;
-        // the settle (and the ctrl+r toggle) show everything.
+        // the settle (and the ctrl+o toggle) show everything.
         const itemRows = [];
         if (active.length > 0)
             itemRows.push(`  ${p.bold}▸${p.reset} ${escapeTerminal(active[0].text)}`);
@@ -2113,9 +2132,9 @@ class Checklist {
             itemRows.push(`  □ ${escapeTerminal(item.text)}`);
         const more = pending.length - 2;
         if (more > 0)
-            itemRows.push(`  ${p.dim}└ +${more} more · ctrl+r${p.reset}`);
+            itemRows.push(`  ${p.dim}└ +${more} more · ctrl+o${p.reset}`);
         if (doneCount > 0)
-            itemRows.push(`  ${p.dim}└ +${doneCount} done · ctrl+r${p.reset}`);
+            itemRows.push(`  ${p.dim}└ +${doneCount} done · ctrl+o${p.reset}`);
         return [cutLine(header, W), ...itemRows.map((r) => cutLine(r, W))];
     }
 }
@@ -2128,7 +2147,7 @@ class Checklist {
  *  W21: the question param is gone — the old question slot retires; a
  *  pending approval's status IS the panel's (the compositor derives
  *  it from the bound panel state). */
-/** R8b — THE IDLE HINT GIVES WAY IN ORDER, and `ctrl+o` is on it.
+/** R8b — THE IDLE HINT GIVES WAY IN ORDER, and `ctrl+r` is on it.
  *
  *  The transcript viewer shipped in 0.19.0 and was reachable only from
  *  the `?` sheet: not on the banner's key line, not here. A feature
@@ -2139,17 +2158,17 @@ class Checklist {
  *  when it does not fit — a longer string would take `/ commands` down
  *  with it on a narrow terminal. So the forms are a ladder, and the
  *  order says which affordance is least replaceable: `/ commands`
- *  survives longest because it is the door to everything; `ctrl+o`
+ *  survives longest because it is the door to everything; `ctrl+r`
  *  outranks `↑ history` because pressing up is how a person finds the
- *  history by accident, and nothing finds ctrl+o by accident. */
+ *  history by accident, and nothing finds ctrl+r by accident. */
 export function idleHint(room) {
     // The third rung is today's hint, kept so that NO width loses
     // something that used to fit: without it, a room of 24-30 columns
     // fell all the way to `/ commands` even though the old form fitted.
     // So the ladder is not a strict ranking of the three affordances —
-    // it is the widest honest form at each room, and ctrl+o is on the
+    // it is the widest honest form at each room, and ctrl+r is on the
     // first two rungs rather than on all of them.
-    for (const form of [" / commands · ↑ history · ctrl+o transcript", " / commands · ctrl+o transcript", " / commands · ↑ history", " / commands"]) {
+    for (const form of [" / commands · ↑ history · ctrl+r transcript", " / commands · ctrl+r transcript", " / commands · ↑ history", " / commands"]) {
         if (visibleWidth(form) <= room)
             return form;
     }

package/dist/render.d.ts

@@ -79,7 +79,7 @@ export interface Palette {
     readonly washEnd: string;
     /** R7a — THE FOCUS MARKER'S EMPHASIS, and it is not a background.
      *
-     *  DC-3 gave the `ctrl+r` token the wash, which is a BACKGROUND once
+     *  DC-3 gave the `ctrl+o` token the wash, which is a BACKGROUND once
      *  a ground is resolved: `48;5;236` on dark reads as a black block
      *  behind the key, on a row that is otherwise plain text. The owner
      *  asked for it gone. The invariant DC-3 was serving — exactly one
@@ -94,6 +94,31 @@ export interface Palette {
      *  is the emphasis. It closes by re-opening the palette's own dim,
      *  like `washEnd`, so the surrounding span survives. */
     readonly lift: string;
+    /** R9 P3 — THE ONE GREY ALLOWED ON THE WASH.
+     *
+     *  §2.1 bars `dim` from the wash and the measurement is why: `#767676`
+     *  on `#EEEEEE` is 3.91:1, under the 4.5:1 floor. A washed surface
+     *  carrying metadata rows — a slab's `… N earlier lines`, its outcome
+     *  line — still wants them quieter than the output they annotate, so
+     *  the palette gains a grey chosen FOR the wash rather than against
+     *  the ground:
+     *
+     *    light  241 `#626262`  5.26:1 on the wash, 6.10:1 on the ground
+     *    dark   247 `#9E9E9E`  4.93:1 on the wash, 6.22:1 on the ground
+     *
+     *  §2.1 is untouched — `dim` still may not sit on the wash. This is a
+     *  different token with a different job, the way `warn` was the mono
+     *  ruling's own set gaining its missing member.
+     *
+     *  With NO ground it is NOTHING: §3.1 forbids an absolute foreground
+     *  in a palette that has not established a background, and rung 4's
+     *  wash is reverse video, where any foreground grey inverts into a
+     *  grey block. Body text on the surface is the correct degradation.
+     *  It closes with 39 (the default foreground) rather than SGR 0, for
+     *  the reason `washEnd` closes with 49: the wash underneath it must
+     *  survive the close. */
+    readonly washDim: string;
+    readonly washDimEnd: string;
     readonly reset: string;
 }
 /**

package/dist/render.js

@@ -28,7 +28,20 @@ const BASE = { bold: "\x1b[1m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32
  * 4's principle exactly: when the ground is unknown, use the thing that
  * is correct on any ground rather than guessing one.
  */
-const withWash = (wash, washEnd, red = BASE.red, dim = BASE.dim) => ({ ...BASE, red, dim, wash, washEnd, code: wash, lift: "\x1b[22m\x1b[39m\x1b[1m" });
+/** `washDimEnd` is DERIVED, never passed: a grey that cannot be closed
+ *  without taking the wash with it is not a usable token, and deriving
+ *  the close makes the pair impossible to mis-wire at a call site. */
+const withWash = (wash, washEnd, red = BASE.red, dim = BASE.dim, washDim = "") => ({
+    ...BASE,
+    red,
+    dim,
+    wash,
+    washEnd,
+    washDim,
+    washDimEnd: washDim === "" ? "" : "\x1b[39m",
+    code: wash,
+    lift: "\x1b[22m\x1b[39m\x1b[1m",
+});
 /**
  * DC-3 — one table per ground.
  *
@@ -50,13 +63,13 @@ const withWash = (wash, washEnd, red = BASE.red, dim = BASE.dim) => ({ ...BASE,
  * attribute is exactly the "correct on any ground" degradation there.
  */
 export const COLOR_NEUTRAL = withWash("\x1b[7m", "\x1b[27m");
-export const COLOR_LIGHT = withWash("\x1b[48;5;255m", "\x1b[49m", "\x1b[38;5;124m", "\x1b[38;5;243m");
-export const COLOR_DARK = withWash("\x1b[48;5;236m", "\x1b[49m", "\x1b[38;5;173m", "\x1b[38;5;246m");
+export const COLOR_LIGHT = withWash("\x1b[48;5;255m", "\x1b[49m", "\x1b[38;5;124m", "\x1b[38;5;243m", "\x1b[38;5;241m");
+export const COLOR_DARK = withWash("\x1b[48;5;236m", "\x1b[49m", "\x1b[38;5;173m", "\x1b[38;5;246m", "\x1b[38;5;247m");
 /** The historical name — the palette for a colour TTY whose ground has
  *  not been established. Unchanged in every byte except `code`, which
  *  was the defect. */
 export const COLOR_ON = COLOR_NEUTRAL;
-export const COLOR_OFF = { bold: "", dim: "", red: "", green: "", warn: "", code: "", italic: "", italicEnd: "", underline: "", underlineEnd: "", rv: "", rvEnd: "", wash: "", washEnd: "", lift: "", reset: "" };
+export const COLOR_OFF = { bold: "", dim: "", red: "", green: "", warn: "", code: "", italic: "", italicEnd: "", underline: "", underlineEnd: "", rv: "", rvEnd: "", wash: "", washEnd: "", washDim: "", washDimEnd: "", lift: "", reset: "" };
 /** DC-3 — the resolved ground, set once at startup when the terminal
  *  answers (see `ground.ts`). It starts UNKNOWN and may stay that way
  *  forever; that is a supported state, not a failure. */
@@ -414,7 +427,7 @@ export function bannerLines(W, H, version, extensionsText, resume = [], now = Da
     if (meta !== undefined && W >= 40) {
         // R2/DC-2's device: the keys row is a list of independent clauses,
         // so a narrow terminal drops whole clauses from the end rather than
-        // cutting one in half. `ctrl+r ex (+8)` teaches nothing.
+        // cutting one in half. `ctrl+o ex (+8)` teaches nothing.
         const clauses = BANNER_KEYS.split(" \u00b7 ");
         let keys = clauses[0];
         for (let n = clauses.length; n > 1; n -= 1) {

package/dist/strings.js

@@ -51,7 +51,7 @@ export function projectTrustView(root, files) {
         name: "project trust",
         title: root,
         speaker: "kiso",
-        statusText: "⏸ project trust",
+        statusText: "❯ project trust",
         args: { kind: "text", lines: projectTrustRows(files) },
         ruleOverride: "trust this project's .kiso?",
         fallbackQuestion: `trust this project's .kiso? (y/n) `,
@@ -109,7 +109,7 @@ export function uncertainView(name, executionId) {
         name: "uncertain execution",
         title: `${name} (${executionId})`,
         speaker: "kiso",
-        statusText: "⏸ uncertain execution",
+        statusText: "❯ uncertain execution",
         args: { kind: "text", lines: [executionId] },
         ruleOverride: "an interrupted execution may have applied — rerun it?",
         simpleOptions: ["rerun it", "abandon it"],
@@ -136,7 +136,7 @@ export function unansweredAskView(executionId) {
         name: "unanswered question",
         title: `ask_user (${executionId})`,
         speaker: "kiso",
-        statusText: "⏸ unanswered question",
+        statusText: "❯ unanswered question",
         args: { kind: "text", lines: [executionId] },
         ruleOverride: "an unanswered question was interrupted — ask it again?",
         simpleOptions: ["ask it again", "drop it"],
@@ -188,12 +188,12 @@ export const KEY_BINDINGS = [
     { keys: "alt+⏎ / ctrl+⏎", what: "redirect" },
     { keys: "/", what: "commands" },
     { keys: "↑↓", what: "history / queue pop" },
-    { keys: "ctrl+r", what: "expand cells" },
+    { keys: "ctrl+o", 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: "ctrl+r", what: "transcript" },
     { keys: "tab", what: "complete (menu / @)" },
     { keys: "?", what: "this sheet" },
     { keys: "ctrl+z / ctrl+y", what: "undo / redo" },
@@ -271,7 +271,7 @@ 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
+    // R5: ctrl+r 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

package/dist/width.d.ts

@@ -3,7 +3,7 @@
  * #16e: "charWidth is the width authority"). The table covers the East
  * Asian Wide/Fullwidth ranges and Emoji_Presentation=Yes; everything
  * else is one column, the box-drawing/brick glyphs █▀▄▞▸ and the text-
- * presentation marks ✓ ✗ ⚠ ⏸ included.
+ * presentation marks ✓ ✗ ⚠ ❯ included.
  *
  * This is the compositor's FLOOR, not a cosmetic detail: a glyph scored
  * one column that a terminal draws in two makes a line whose measured

package/dist/width.js

@@ -3,7 +3,7 @@
  * #16e: "charWidth is the width authority"). The table covers the East
  * Asian Wide/Fullwidth ranges and Emoji_Presentation=Yes; everything
  * else is one column, the box-drawing/brick glyphs █▀▄▞▸ and the text-
- * presentation marks ✓ ✗ ⚠ ⏸ included.
+ * presentation marks ✓ ✗ ⚠ ❯ included.
  *
  * This is the compositor's FLOOR, not a cosmetic detail: a glyph scored
  * one column that a terminal draws in two makes a line whose measured
@@ -19,7 +19,7 @@
  */
 /** TUI2-R2pre ① — the Emoji_Presentation=Yes code points inside
  *  U+2000..U+2BFF. The rest of that span is TEXT presentation and stays
- *  one column: ✓ ✗ ⚠ ⏸ ▞ ▸ and the box-drawing rails are all narrow, and
+ *  one column: ✓ ✗ ⚠ ❯ ▞ ▸ and the box-drawing rails are all narrow, and
  *  widening any of them would move every card head on the screen. Listed
  *  as ranges because that is what the property is — the singles are
  *  singles in Unicode too. */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui-cells",
-	"version": "0.20.3",
+	"version": "0.21.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",