@vincemakes/kiso-tui 0.20.0 → 0.20.1

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.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) {
@@ -1426,7 +1429,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 +3266,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));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.20.0",
+	"version": "0.20.1",
 	"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.1"
 	}
 }