@vincemakes/kiso-tui 0.1.20 → 0.1.21

package/dist/editor.js

@@ -98,6 +98,12 @@ export class Editor {
     #onRender;
     #menuOpen = false; // v3 §04: the slash-command menu
     #menuSel = 0;
+    // A2 (手感): the session-scoped input history — every submitted TURN
+    // line (never a question answer), capped at 100, never persisted. ↑↓
+    // navigate it ONLY from an empty input or while already browsing.
+    #history = [];
+    #historyIdx = null;
+    #preBrowse = [];
     #pending = ""; // an incomplete ESC/CSI prefix across chunks
     #decoder = new TextDecoder();
     #entered = false;
@@ -233,6 +239,15 @@ export class Editor {
                     this.#scroll = 0;
                     this.#refreshMenu();
                 }
+                else if (this.#historyIdx !== null) {
+                    // A2: Esc exits the history browse — the pre-browse
+                    // (empty) input returns.
+                    this.#historyIdx = null;
+                    this.#chars = [...this.#preBrowse];
+                    this.#cursor = this.#chars.length;
+                    this.#reflow();
+                    this.#onRender();
+                }
                 else {
                     this.#escapeCb?.();
                     i += 1;
@@ -316,13 +331,20 @@ export class Editor {
                 this.#onRender();
             }
         }
-        else if (final === "A" && this.#menuOpen) {
-            // v3 §04: ↑↓ move the menu selection, never the cursor.
-            this.#menuSel = Math.max(0, this.#menuSel - 1);
-            this.#onRender();
-        }
-        else if (final === "B" && this.#menuOpen) {
-            this.#menuSel = Math.min(this.#menuFiltered().length - 1, this.#menuSel + 1);
+        else if (final === "A" || final === "B") {
+            // v3 §04: the menu owns ↑↓ while open (the selection, never the
+            // cursor). A2 (手感): otherwise ↑↓ navigate the session history
+            // — ONLY from an empty input or while already browsing; mid-edit
+            // the cursor semantics are unchanged (↑↓ do nothing).
+            if (this.#menuOpen) {
+                if (final === "A")
+                    this.#menuSel = Math.max(0, this.#menuSel - 1);
+                else
+                    this.#menuSel = Math.min(this.#menuFiltered().length - 1, this.#menuSel + 1);
+            }
+            else if (this.#historyIdx !== null || this.line() === "") {
+                this.#historyMove(final === "A" ? -1 : 1);
+            }
             this.#onRender();
         }
         else if (final === "D") {
@@ -342,6 +364,8 @@ export class Editor {
     }
     // ---- editing ----
     #insert(cp) {
+        if (this.#historyIdx !== null)
+            this.#historyIdx = null; // editing leaves the browse
         this.#chars.splice(this.#cursor, 0, cp);
         this.#cursor += 1;
         this.#reflow();
@@ -351,6 +375,8 @@ export class Editor {
     #backspace() {
         if (this.#cursor === 0)
             return;
+        if (this.#historyIdx !== null)
+            this.#historyIdx = null; // editing leaves the browse
         this.#chars.splice(this.#cursor - 1, 1);
         this.#cursor -= 1;
         this.#reflow();
@@ -397,10 +423,20 @@ export class Editor {
     #submit() {
         let line = String.fromCodePoint(...this.#chars);
         if (this.#menuOpen) {
-            // v3 §04: Enter submits the SELECTED command.
+            // A1 (手感): Enter submits the EXACT selection directly; a
+            // PARTIAL selection COMPLETES the buffer (the Tab semantics)
+            // without submitting — the user reviews and presses Enter
+            // again. The old behavior executed the completed command on
+            // the first Enter, before the user had seen the completion.
             const m = this.#menuFiltered()[this.#menuSel];
-            if (m !== undefined)
-                line = m.name;
+            if (m !== undefined && m.name !== line) {
+                this.#chars = [...m.name].map((ch) => ch.codePointAt(0));
+                this.#cursor = this.#chars.length;
+                this.#reflow();
+                this.#refreshMenu();
+                this.#onRender();
+                return; // completed, not executed
+            }
         }
         this.#chars = [];
         this.#cursor = 0;
@@ -418,8 +454,42 @@ export class Editor {
         else {
             this.#pendingLines.push(line); // nobody wired yet — hold it
         }
+        // A2: the history remembers submitted TURN lines — never question
+        // answers, never empties; adjacent duplicates collapse.
+        if (cb === null && line !== "") {
+            if (this.#history[this.#history.length - 1] !== line)
+                this.#history.push(line);
+            if (this.#history.length > 100)
+                this.#history.shift();
+        }
         this.#onRender();
     }
+    /** A2: step the history browse; a delta past the newest exits back to
+     *  the pre-browse input. */
+    #historyMove(delta) {
+        if (this.#history.length === 0)
+            return;
+        if (this.#historyIdx === null) {
+            this.#preBrowse = this.#chars; // entering from an empty input
+            this.#historyIdx = this.#history.length - 1;
+        }
+        else {
+            const next = this.#historyIdx + delta;
+            if (next < 0)
+                return; // the oldest entry — stay
+            this.#historyIdx = next;
+            if (next >= this.#history.length) {
+                this.#historyIdx = null; // past the newest — exit the browse
+                this.#chars = [...this.#preBrowse];
+                this.#cursor = this.#chars.length;
+                this.#reflow();
+                return;
+            }
+        }
+        this.#chars = [...this.#history[this.#historyIdx]].map((ch) => ch.codePointAt(0));
+        this.#cursor = this.#chars.length;
+        this.#reflow();
+    }
     // ---- width-based horizontal scroll ----
     #reflow() {
         const W = (process.stdout.columns ?? 0) || 80; // degenerate 0 falls back to 80

package/dist/index.d.ts

@@ -7,5 +7,5 @@
 export { Body, type BodyOptions } from "./body.js";
 export { Dock } from "./dock.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, type MenuItem, } from "./editor.js";
-export { bannerLines, COLOR_OFF, COLOR_ON, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderSessionLine, renderStatusLine, renderTerminalGap, renderToolSummary, TAGLINE, truncateRow, type Palette, type PathResolver, type RecapStats, type RenderResult, type RunUsage, } from "./render.js";
+export { bannerLines, COLOR_OFF, COLOR_ON, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderSessionLine, renderStatusLine, renderTerminalGap, renderToolSummary, TAGLINE, truncateRow, type Palette, type PathResolver, type RecapStats, type RenderInput, type RenderResult, type RunUsage, } from "./render.js";
 export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResult } from "./diff.js";

package/dist/render.d.ts

@@ -1,8 +1,12 @@
 /**
- * Event rendering for the terminal. Pure (testable): given events, produce
- * the lines a human sees. Colors are raw ANSI — no dependencies.
+ * Event rendering for the terminal. Pure (testable): given the render
+ * input, produce the lines a human sees. Colors are raw ANSI — no
+ * dependencies.
+ *
+ * 手感批 C5: the input is the tui's OWN data shape (RenderInput), never
+ * kiso-core's Event — the CLI translates Event → RenderInput. The tui
+ * package has ZERO kiso-core imports: input is data, output is bytes.
  */
-import type { Event } from "@vincemakes/kiso-core";
 /**
  * v2a — the palette, centralized (no hard-coded codes elsewhere): ONE
  * accent — blue, ANSI 256 color 75 — for the identity accents (the you>
@@ -39,6 +43,89 @@ export interface RenderResult {
     readonly newline: boolean;
     readonly prompt: boolean;
 }
+/**
+ * 手感批 C5 — the render input, the tui's OWN data shape: the subset of
+ * an event stream the renderer reads, keyed by type. The CLI translates
+ * its Event stream into this (Event → RenderInput) before rendering —
+ * the tui package never imports kiso-core. Field names mirror the
+ * rendered Event members so the render body stays byte-identical.
+ */
+export type RenderInput = {
+    readonly type: "user_input";
+    readonly content: string | readonly {
+        readonly type?: string;
+        readonly text?: string;
+    }[];
+} | {
+    readonly type: "text_delta";
+    readonly text: string;
+} | {
+    readonly type: "text_end";
+} | {
+    readonly type: "thinking";
+    readonly text: string;
+} | {
+    readonly type: "tool_call_end";
+    readonly name: string;
+    readonly input: Readonly<Record<string, unknown>> | null;
+} | {
+    readonly type: "tool_execution_started";
+} | {
+    readonly type: "tool_execution_succeeded";
+} | {
+    readonly type: "tool_execution_failed";
+    readonly error: string;
+} | {
+    readonly type: "tool_result";
+    readonly content: string | readonly {
+        readonly type?: string;
+        readonly text?: string;
+    }[];
+    readonly isError: boolean;
+} | {
+    readonly type: "permission_requested";
+    readonly name: string;
+    readonly input: Readonly<Record<string, unknown>>;
+} | {
+    readonly type: "permission_decided";
+    readonly decision: "approved" | "denied";
+    readonly reason?: string;
+} | {
+    readonly type: "terminal";
+    readonly outcome: {
+        readonly kind: "completed";
+    } | {
+        readonly kind: "max_tokens";
+    } | {
+        readonly kind: "max_turns";
+        readonly turns: number;
+    } | {
+        readonly kind: "error";
+        readonly error: {
+            readonly message: string;
+        };
+    } | {
+        readonly kind: "aborted";
+        readonly by: string;
+    } | {
+        readonly kind: "hook_stopped";
+        readonly hook: string;
+    };
+} | {
+    readonly type: "compacted";
+    readonly cleared: readonly {
+        readonly eventSeq?: number;
+        readonly callId: string;
+    }[];
+} | {
+    readonly type: "summarized";
+    readonly coversToSeq: number;
+} | {
+    readonly type: "uncertain_pending";
+    readonly name: string;
+    readonly executionId: string;
+    readonly error: string;
+};
 /**
  * Render one event. `text` may be a continuation (text_delta appends to the
  * current line); `newline` says whether the line is complete.
@@ -58,7 +145,7 @@ export interface RenderResult {
 export declare function foldThinking(block: string): string;
 /** v2b — the [result] echo truncates at 160 chars + a /last hint. */
 export declare function foldResult(content: string): string;
-export declare function renderEvent(ev: Event, prevThinking?: boolean, resolvePath?: PathResolver): RenderResult;
+export declare function renderEvent(ev: RenderInput, prevThinking?: boolean, resolvePath?: PathResolver): RenderResult;
 /**
  * B 区: one-line summary of a completed tool call, e.g.
  *   ✓ edit src/foo.ts (+12 -3)    ✓ read src/bar.ts (140 lines)

package/dist/render.js

@@ -1,6 +1,11 @@
 /**
- * Event rendering for the terminal. Pure (testable): given events, produce
- * the lines a human sees. Colors are raw ANSI — no dependencies.
+ * Event rendering for the terminal. Pure (testable): given the render
+ * input, produce the lines a human sees. Colors are raw ANSI — no
+ * dependencies.
+ *
+ * 手感批 C5: the input is the tui's OWN data shape (RenderInput), never
+ * kiso-core's Event — the CLI translates Event → RenderInput. The tui
+ * package has ZERO kiso-core imports: input is data, output is bytes.
  */
 export const COLOR_ON = { blue: "\x1b[38;5;75m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", bg: "\x1b[48;5;237m", reset: "\x1b[0m" };
 export const COLOR_OFF = { blue: "", dim: "", red: "", green: "", bg: "", reset: "" };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-tui",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "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",