@vincemakes/kiso-tui 0.20.0 → 0.20.2

package/dist/at-picker.d.ts

@@ -12,6 +12,7 @@
  * lexical order of the path (never localeCompare, whose result depends
  * on the machine's locale).
  */
+import { bandHeader } from "@vincemakes/kiso-tui-cells/strings";
 /** The bound source's item — a repo-relative path and nothing else.
  *  Structural: the CLI passes whatever it likes as long as it has a
  *  path (slice 5 passes exactly this). */
@@ -168,4 +169,4 @@ export declare function atPanelRows(state: {
  * composer and every panel now share, so a band opens the way everything
  * else does and the label tells you WHICH band in the same row.
  */
-export declare function bandHeader(label: string, W: number): string;
+export { bandHeader };

package/dist/at-picker.js

@@ -14,6 +14,7 @@
  */
 import { escapeTerminal, palette } from "./render.js";
 import { selectionBar, visibleWidth, widthCut } from "./components.js";
+import { bandHeader } from "@vincemakes/kiso-tui-cells/strings";
 /**
  * KC3 §5 — the ONE cap. The file list is computed per open with no
  * index and no watcher, so its cost is bounded here rather than
@@ -263,8 +264,8 @@ export function atPanelRows(state, W) {
  * composer and every panel now share, so a band opens the way everything
  * else does and the label tells you WHICH band in the same row.
  */
-export function bandHeader(label, W) {
-    const p = palette();
-    const head = `\u2500\u2500\u2500 ${label} `;
-    return `${p.dim}${widthCut(`${head}${"\u2500".repeat(Math.max(1, W - head.length))}`, Math.max(1, W))}${p.reset}`;
-}
+// R8b: bandHeader MOVED to tui-cells/strings.ts — the keys sheet needs
+// it and lives there, and `components.ts` already imports that module,
+// so the dependency only runs one way. Re-exported here so every
+// existing import site is untouched.
+export { bandHeader };

package/dist/compositor.d.ts

@@ -227,6 +227,22 @@ export declare class Body {
      *  there is no pointer, so there is nothing a pointer could reach
      *  that a keyboard cannot. */
     viewerKey(cmd: "up" | "down" | "toggle" | "all" | "pageUp" | "pageDown" | "home" | "end"): void;
+    /**
+     * DC-35 — ctrl+r does not print the same expansion twice in a row.
+     *
+     * The ring walks newest-back and restarts its cycle once every entry
+     * has been opened (R4/C1, which is what makes the walk immune to the
+     * ring growing underneath it). With a ring of ONE the restart is
+     * immediate, so holding the key appended the identical block over
+     * and over — the owner got three copies of the same four rows, each
+     * closing with `ctrl+r opens the one before it`, a footer naming
+     * something that does not exist.
+     *
+     * The bar is the BOTTOM of the transcript, not "ever shown": once
+     * other content has arrived the expansion has scrolled up and
+     * re-opening it is the point of the key, so the guard clears itself
+     * the moment a cell is added.
+     */
     expandNext(): {
         kind: "toggled";
     } | {
@@ -234,6 +250,7 @@ export declare class Body {
         lines: string[];
     } | {
         kind: "none";
+        why?: "already-last";
     };
     /** Docked = the chrome is live (a color TTY with a real size). */
     get active(): boolean;

package/dist/compositor.js

@@ -43,7 +43,7 @@
  * line-mode bytes byte-for-byte (the e2e guards them).
  */
 import { truncateDiff } from "./diff.js";
-import { displayWidth } from "./editor.js";
+import { MENU_ITEMS, displayWidth } from "./editor.js";
 import { leadWidth } from "./width.js"; // W23: the ONE width authority (the editor, #inputRow, and editCol share it)
 // KC3.5: the panel-slot reads come from the DISPATCHERS — one source
 // for four reads, so an ask can never render half as an approval.
@@ -52,7 +52,7 @@ import { MOUSE_OFF } from "./editor.js";
 import { atPanelRows, bandHeader } from "./at-picker.js";
 // TUI2-R2 ②: the session picker's rows — the band's third occupant.
 import { sessionPickerRows } from "./session-picker.js";
-import { ACT_SLOT_ROWS, Container, ROLLUP_NOUN, MOTION_FRAMES, MdStream, bodySpacing, boxBottom, boxTop, cellComponent, exploreCounts, foldCountsObjects, foldTerms, focusToken, exploreRows, foldLine, cutLine, isExploreTool, moreRunningRow, pendingQueueRows, slotPad, slotTail, statusLine, stretchLine, turnFold, visibleWidth, breathFrame, } from "./components.js";
+import { ACT_SLOT_ROWS, Container, ROLLUP_NOUN, MOTION_FRAMES, MdStream, bodySpacing, boxBottom, boxTop, cellComponent, exploreCounts, foldCountsObjects, foldTerms, focusToken, exploreRows, foldLine, gutterCut, cutLine, isExploreTool, moreRunningRow, pendingQueueRows, slotPad, slotTail, statusLine, stretchLine, turnFold, visibleWidth, breathFrame, } from "./components.js";
 import { bannerLines, escapeTerminal, foldResult, foldThinking, palette, renderTerminalGap, renderToolSummary, toolTarget } from "./render.js";
 import { displayVerb, keysSheetRows } from "./strings.js";
 // R5 — the transcript viewer's PURE projection. The compositor supplies
@@ -77,6 +77,9 @@ const CHROME_ROWS = 4; // box top + input + box bottom + status — the design
  *  same unbounded height the projection exists to remove; the rest are
  *  COUNTED, never dropped silently. */
 const LIVE_ACT_HEADS = 3;
+/** R8 — the command band's window: five rows plus a counter, the same
+ *  budget the composer's own ceiling can afford above it. */
+const MENU_WINDOW = 5;
 /** W13 / TUI2-R1 (B) — a rolled run's TITLE: the exploration sentence on
  *  a mixed run, W13's verb+count on a single-name one. */
 function rolledTitle(cell) {
@@ -1333,7 +1336,42 @@ export class Body {
             cutLine(`${p.dim} ${viewerHint(this.#viewer, entries)}${p.reset}`, W),
         ];
     }
+    /** DC-35 — the last block this key appended, and the cell count when
+     *  it did. An expansion earns its rows by showing something the
+     *  transcript does not already END with. */
+    #lastAppend = null;
+    /**
+     * DC-35 — ctrl+r does not print the same expansion twice in a row.
+     *
+     * The ring walks newest-back and restarts its cycle once every entry
+     * has been opened (R4/C1, which is what makes the walk immune to the
+     * ring growing underneath it). With a ring of ONE the restart is
+     * immediate, so holding the key appended the identical block over
+     * and over — the owner got three copies of the same four rows, each
+     * closing with `ctrl+r opens the one before it`, a footer naming
+     * something that does not exist.
+     *
+     * The bar is the BOTTOM of the transcript, not "ever shown": once
+     * other content has arrived the expansion has scrolled up and
+     * re-opening it is the point of the key, so the guard clears itself
+     * the moment a cell is added.
+     */
     expandNext() {
+        const out = this.#expandNextRaw();
+        if (out.kind !== "appended")
+            return out;
+        const lines = out.lines.join("\n");
+        if (this.#lastAppend !== null && this.#lastAppend.lines === lines && this.#lastAppend.atCells === this.#cells.length) {
+            // NOT the same answer as "nothing is folded". The caller says
+            // which, because a reader who pressed the key deserves to know
+            // whether there is nothing to open or whether they are already
+            // looking at it.
+            return { kind: "none", why: "already-last" };
+        }
+        this.#lastAppend = { lines, atCells: this.#cells.length };
+        return out;
+    }
+    #expandNextRaw() {
         for (let i = this.#cells.length - 1; i >= this.#committed; i -= 1) {
             const cell = this.#cells[i];
             if (cell.kind === "tool" && cell.state !== "pending") {
@@ -1426,7 +1464,9 @@ export class Body {
                     // always the part a reader could use.
                     `${p.bold}✦${p.reset} expanded · ${escapeTerminal(head.length === 0 ? "thinking" : head.join(" · "))} · ${back}`,
                     ...body,
-                    `  ${p.dim}└ end of expansion · ctrl+r opens the one before it${p.reset}`,
+                    // R8a: an in-block note takes the block's indent, not a
+                    // second corner — the corner opens the body above it.
+                    `${p.dim}    end of expansion · ctrl+r opens the one before it${p.reset}`,
                 ],
             };
         }
@@ -3261,14 +3301,40 @@ export class Body {
         // picker's does. Both render frameless directly above the composer,
         // so with scrollback behind them there was nothing to say where the
         // surface began — the rows read as more history.
+        // R8 — THE BAND IS A WINDOW, and the rows are a table.
+        //
+        // It used to draw every match and fold each long description over
+        // as many rows as it took, which is why a bare `/` could not open
+        // it: eleven commands plus wraps is most of a short terminal. A
+        // fixed window is what lets the trigger be the `/` the banner
+        // advertises (see the editor's #menuFiltered).
+        //
+        // Three shape rules, all of them §1.3 or §1.2:
+        //  - the leading `/` comes off the rows. It is already on the
+        //    input line directly below, so printing it eleven more times
+        //    is a mark carrying no fact the screen does not have.
+        //  - the name column is padded to the longest command in the
+        //    WHOLE list, not the visible slice, so the descriptions do
+        //    not shift sideways as the window scrolls.
+        //  - a description is CUT, never folded — a folded row would
+        //    break the window's height, which is the thing being bought.
+        const items = menu.items;
+        const col = MENU_ITEMS.reduce((n, m) => Math.max(n, m.name.length - 1), 0);
+        const windowed = items.length > MENU_WINDOW;
+        // the window's top is derived from the selection alone (this
+        // method is re-entered per frame and keeps no state): centre it,
+        // clamped to the ends.
+        const top = windowed ? Math.max(0, Math.min(menu.selected - ((MENU_WINDOW - 1) >> 1), items.length - MENU_WINDOW)) : 0;
         const rows = [bandHeader("commands", W)];
-        for (let i = 0; i < menu.items.length; i += 1) {
-            const item = menu.items[i];
-            const text = i === menu.selected
-                ? `${p.bold}▸ ${item.name}${p.reset} ${item.desc}`
-                : `${p.dim}  ${item.name} ${item.desc}${p.reset}`;
-            rows.push(...foldLine(text, W));
-        }
+        for (let i = top; i < Math.min(items.length, top + MENU_WINDOW); i += 1) {
+            const item = items[i];
+            const label = `${item.name.slice(1).padEnd(col)} ${item.desc}`;
+            rows.push(...(i === menu.selected ? gutterCut(`${p.bold}▸${p.reset} `, `${p.bold}${label}${p.reset}`, W) : gutterCut("  ", `${p.dim}${label}${p.reset}`, W)));
+        }
+        // the counter earns its row only when the list is CUT — over a
+        // list you can see all of, it says nothing the rows do not.
+        if (windowed)
+            rows.push(`  ${p.dim}(${menu.selected + 1}/${items.length})${p.reset}`);
         return rows;
     }
     /** ONE input row's bytes — the marker embedded at `embedAt` (the

package/dist/editor.js

@@ -542,11 +542,20 @@ export class Editor {
             return null;
         return { items: this.#menuFiltered(), selected: this.#menuSel };
     }
-    /** v3 §04: the filtered command list for the current buffer — open
-     *  only while the line is "/" + something (a bare "/" waits). */
+    /** v3 §04: the filtered command list for the current buffer.
+     *
+     *  A BARE `/` OPENS IT (owner-ruled 2026-09-01). It used to wait for
+     *  a second character, which made the key the banner advertises —
+     *  `/ commands` — a thing you had to already know the answer to: the
+     *  list that tells you the commands appeared only once you had typed
+     *  one. The reason for the wait was real and is fixed on the other
+     *  side: the band drew EVERY match with no window, so a bare `/`
+     *  would have piled eleven rows plus wraps above the composer. The
+     *  band windows now (see the compositor's #menuRows), so the trigger
+     *  no longer has to do the rationing. */
     #menuFiltered() {
         const line = this.line();
-        if (!line.startsWith("/") || line === "/")
+        if (!line.startsWith("/"))
             return [];
         return MENU_ITEMS.filter((m) => m.name.startsWith(line));
     }
@@ -995,7 +1004,11 @@ export class Editor {
                         i += 1;
                         continue;
                     }
-                    if (!typing && (c === "t" || c === "T")) {
+                    // DC-36: no `t` row means no custom phase to enter — the
+                    // option list IS the world (a closed set), and a key
+                    // that leads to a surface the panel does not draw is
+                    // worse than an absent key.
+                    if (!typing && (c === "t" || c === "T") && this.#panel?.view.pick?.typeHint !== undefined) {
                         panel.pick = { cursor: panel.pick.cursor, phase: "custom" };
                         this.#chars = [];
                         this.#cursor = 0;

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  * editor, the diff renderer, and the palette.
  */
 export { Body, Dock, CURSOR_MARKER, type BodyOptions } from "./compositor.js";
-export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, PICK_MAX, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, type PickOption, type PickResult, type PickRuntime, type PickSpec, type PanelArgs, type PanelFlavor, type PanelPhase, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, type SaferAnswer, type SaferFailure, type SaferOption, type SaferRuntime, panelOptions, type PanelOption, type PanelOptionKind, type PanelState, type PanelVerdict, type PanelView, } from "./approval-panel.js";
+export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, PICK_MAX, modePickView, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, type PickOption, type PickResult, type PickRuntime, type PickSpec, type PanelArgs, type PanelFlavor, type PanelPhase, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, type SaferAnswer, type SaferFailure, type SaferOption, type SaferRuntime, panelOptions, type PanelOption, type PanelOptionKind, type PanelState, type PanelVerdict, type PanelView, } from "./approval-panel.js";
 export { Container, foldLine, foldWords, visibleWidth, SPINNER, type Component, type FrameCtx } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, type MenuItem, } from "./editor.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, type Palette, type PathResolver, type RecapStats, type ResumeMeta, type RenderInput, type RenderResult, type RunUsage, } from "./render.js";

package/dist/index.js

@@ -12,7 +12,7 @@ export { Body, Dock, CURSOR_MARKER } from "./compositor.js";
 // approval is pending (the shape authority is the committed preview).
 export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, 
 // TUI2-R2 ④: the pick payload — the panel slot's third occupant.
-PICK_MAX, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, panelOptions, } from "./approval-panel.js";
+PICK_MAX, modePickView, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, panelOptions, } from "./approval-panel.js";
 export { Container, foldLine, foldWords, visibleWidth, SPINNER } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, } from "./editor.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, } from "./render.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.20.0",
+	"version": "0.20.2",
 	"description": "kiso tui — the pure terminal layer (cell renderer, dock, raw editor, diff, palette). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",
@@ -35,6 +35,6 @@
 	},
 	"homepage": "https://github.com/vincemakes/kiso/tree/main/packages/tui#readme",
 	"dependencies": {
-		"@vincemakes/kiso-tui-cells": "0.20.0"
+		"@vincemakes/kiso-tui-cells": "0.20.2"
 	}
 }