@vincemakes/kiso-tui 0.30.0 → 0.31.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kiso contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# @vincemakes/kiso-tui
+
+kiso's terminal layer: the compositor (the scrollback transcript and the
+pinned dock beneath it), the raw-mode editor (prompt, menu, paste, undo),
+the pick panels (model, mode, sessions, the @-file window), the status
+meters, the context ledger, the approval and ask panels, and the key
+bindings sheet. Built on `@vincemakes/kiso-tui-cells` and otherwise
+dependency-free: input is data, output is bytes.
+
+The CLI (`@vincemakes/kiso-code`) drives it; nothing here reads a
+provider or a session store. See the repository README for the
+framework overview.

package/dist/ask-panel.js

@@ -460,7 +460,7 @@ export function panelStatus(view, phase, cursor, ask, pick) {
 }
 export function panelAffordance(view, phase, cursor, ask, pick, safer) {
     if (view.pick !== undefined && pick !== undefined)
-        return pickAffordance(pick);
+        return pickAffordance(pick, view.pick.options[pick.cursor]?.levels !== undefined);
     if (view.ask !== undefined && ask !== undefined)
         return askAffordance(ask, view.ask.questions[ask.qIndex]);
     return basePanelAffordance(view, phase, cursor, safer);

package/dist/compositor.js

@@ -58,6 +58,10 @@ import { sessionPickerRows } from "./session-picker.js";
 import { CAP_PREVIEW, thinkingRow, Container, MOTION_FRAMES, MdStream, bodySpacing, boxBottom, boxTop, cellComponent, gutterCut, cutLine, pendingQueueRows, statusLine, visibleWidth, breathFrame, } from "./components.js";
 import { bannerLines, escapeTerminal, foldResult, foldThinking, palette, renderTerminalGap, renderToolSummary } from "./lines.js";
 import { displayVerb, keysSheetRows } from "./strings.js";
+/** DC-56: does a rendered row carry any visible text once its SGR is
+ *  stripped? A washed pad row is spaces under a background colour — width
+ *  without words. */
+const saysSomething = (row) => row.replace(/\x1b\[[0-9;?]*[A-Za-z]/g, "").trim() !== "";
 // R5 — the transcript viewer's PURE projection. The compositor supplies
 // the entries (it holds the cells); the arrangement lives there.
 import { VIEWER_GUTTER, viewerFlat, viewerHint, viewerInit, viewerMove, viewerRows, viewerScroll, viewerTitle, viewerToggle, viewerToggleAll, } from "./transcript.js";
@@ -936,7 +940,15 @@ export class Body {
             cell.expanded = true;
             const rows = cellComponent(cell).render(inner, ctx);
             cell.expanded = saved;
-            out.push({ head: rows[0] ?? "", body: rows.slice(1) });
+            // DC-56 (owner, 2026-09-09): the head is the first row that SAYS
+            // something. R13's card wears a washed PAD row above its head on
+            // the palettes with a real background (light, dark) and none under
+            // the neutral reverse-video wash — so `rows[0]` was the head on
+            // one palette and a blank washed row on the others, and ctrl+r on
+            // a light terminal showed "5 folds" over five empty grey rows.
+            const first = rows.findIndex((r) => saysSomething(r));
+            const headAt = first < 0 ? 0 : first;
+            out.push({ head: rows[headAt] ?? "", body: rows.slice(headAt + 1) });
         }
         return out;
     }

package/dist/editor.js

@@ -1462,7 +1462,10 @@ export class Editor {
                 this.#move(-1);
         }
         else if (final === "C") {
-            this.#move(1);
+            // OR-7: → walks the pick panel's level axis when one is up; the
+            // composer keeps the key everywhere else, exactly as ← does.
+            if (!this.#panelInput.right())
+                this.#move(1);
         }
         else if (final === "H") {
             this.#cursor = this.#cursorBounds().start; // A3: Home follows Ctrl+A — line-local

package/dist/panel-input.d.ts

@@ -97,8 +97,14 @@ export declare class PanelInput {
      *  panel owned the key (the caller renders); false when no panel is
      *  up. A phase without a list (asking) swallows the key. */
     arrow(dir: "up" | "down"): boolean;
-    /** ← while an ask's option row is up walks the ask; otherwise the key is the composer's. */
+    /** ← while an ask's option row is up walks the ask; while a pick's is
+     *  up it walks the highlighted option's level axis (OR-7); otherwise
+     *  the key is the composer's. */
     left(): boolean;
+    /** → is the level axis's other direction. The ask never owned it (its
+     *  own walk is ← back and enter forward), so this key was the
+     *  composer's alone until OR-7 and still is when no axis is up. */
+    right(): boolean;
     /** TUI2-R3v2 ②: a left-button press on the option rows the
      *  compositor placed. Outside the list — inert. */
     click(span: PanelRowSpan | null | undefined, row: number | undefined): void;

package/dist/panel-input.js

@@ -16,7 +16,7 @@
  * and the mouse hit. The bodies are the same; only the buffer access
  * goes through the host.
  */
-import { PICK_MAX, panelOptions, saferDegradedNote, } from "./approval-panel.js";
+import { PICK_MAX, panelOptions, saferDegradedNote, startLevel, stepLevel, } from "./approval-panel.js";
 import { askCommitCustom, askKey, askOnCustomRow, askStart } from "./ask-panel.js";
 export class PanelInput {
     host;
@@ -49,7 +49,7 @@ export class PanelInput {
             safer: opts?.safer,
             saferRun: null,
             ask: view.ask === undefined ? null : askStart(view.ask),
-            pick: view.pick === undefined ? null : { cursor: 0, phase: "options" },
+            pick: view.pick === undefined ? null : { cursor: 0, phase: "options", level: startLevel(view.pick.options[0]) },
             onCommit,
             stash: this.host.stash(),
         };
@@ -113,8 +113,10 @@ export class PanelInput {
                     this.#pickPanelDigit(Number(c) - 1);
                     return 1;
                 }
+                if (!typing && (c === "h" || c === "l") && this.#levelStep(c === "h" ? -1 : 1))
+                    return 1;
                 if (!typing && (c === "t" || c === "T") && panel.view.pick?.typeHint !== undefined) {
-                    panel.pick = { cursor: panel.pick.cursor, phase: "custom" };
+                    panel.pick = { cursor: panel.pick.cursor, phase: "custom", level: panel.pick.level };
                     this.host.clear();
                     this.host.render();
                     return 1;
@@ -206,7 +208,12 @@ export class PanelInput {
         if (panel.pick !== null && panel.pick.phase === "options") {
             const n = Math.min(panel.view.pick.options.length, PICK_MAX);
             const cur = panel.pick.cursor;
-            panel.pick = { cursor: dir === "up" ? Math.max(0, cur - 1) : Math.min(Math.max(0, n - 1), cur + 1), phase: "options" };
+            const next = dir === "up" ? Math.max(0, cur - 1) : Math.min(Math.max(0, n - 1), cur + 1);
+            // OR-7: the second axis belongs to the highlighted option, so it
+            // re-lands on THAT option's own level. Carrying the previous
+            // row's index across would point at a level this model may not
+            // have — the silent clamp the coordination note exists to end.
+            panel.pick = { cursor: next, phase: "options", level: startLevel(panel.view.pick.options[next]) };
         }
         else if (panel.ask !== null && panel.ask.phase === "options")
             this.#askStep(dir);
@@ -216,14 +223,37 @@ export class PanelInput {
             this.#panelMove(dir === "up" ? -1 : 1);
         return true;
     }
-    /** ← while an ask's option row is up walks the ask; otherwise the key is the composer's. */
+    /** ← while an ask's option row is up walks the ask; while a pick's is
+     *  up it walks the highlighted option's level axis (OR-7); otherwise
+     *  the key is the composer's. */
     left() {
+        if (this.#levelStep(-1))
+            return true;
         const panel = this.#panel;
         if (panel?.ask == null || panel.ask.phase !== "options")
             return false;
         this.#askStep("left");
         return true;
     }
+    /** → is the level axis's other direction. The ask never owned it (its
+     *  own walk is ← back and enter forward), so this key was the
+     *  composer's alone until OR-7 and still is when no axis is up. */
+    right() {
+        return this.#levelStep(1);
+    }
+    /** One step along the highlighted option's levels. False when there is
+     *  no axis to walk, which is what leaves the key to the composer. */
+    #levelStep(dir) {
+        const panel = this.#panel;
+        if (panel === null || panel.pick === null || panel.pick.phase !== "options")
+            return false;
+        const o = panel.view.pick?.options[panel.pick.cursor];
+        if (o?.levels === undefined)
+            return false;
+        panel.pick = { cursor: panel.pick.cursor, phase: "options", level: stepLevel(o, panel.pick.level, dir) };
+        this.host.render();
+        return true;
+    }
     /** TUI2-R3v2 ②: a left-button press on the option rows the
      *  compositor placed. Outside the list — inert. */
     click(span, row) {
@@ -420,7 +450,7 @@ export class PanelInput {
             return;
         if (index < 0 || index >= Math.min(panel.view.pick.options.length, PICK_MAX))
             return;
-        panel.pick = { cursor: index, phase: "options" };
+        panel.pick = { cursor: index, phase: "options", level: startLevel(panel.view.pick.options[index]) };
         this.host.render();
     }
     #pickPanelEnter() {
@@ -436,14 +466,15 @@ export class PanelInput {
         }
         if (panel.view.pick.options.length === 0)
             return; // nothing to take
-        this.#close({ action: "picked", result: { index: panel.pick.cursor } });
+        const level = panel.pick.level;
+        this.#close({ action: "picked", result: { index: panel.pick.cursor }, ...(level === null ? {} : { level }) });
     }
     #pickPanelEsc() {
         const panel = this.#panel;
         if (panel === null || panel.pick === null)
             return;
         if (panel.pick.phase === "custom") {
-            panel.pick = { cursor: panel.pick.cursor, phase: "options" };
+            panel.pick = { cursor: panel.pick.cursor, phase: "options", level: panel.pick.level };
             this.host.clear();
             this.host.render();
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.30.0",
+	"version": "0.31.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.30.0"
+		"@vincemakes/kiso-tui-cells": "0.31.1"
 	}
 }