@vincemakes/kiso-tui 0.1.36 → 0.1.38

package/dist/editor.d.ts

@@ -16,12 +16,8 @@
  * The editor is a SINGLE line: bracketed paste (?2004h) unwraps and
  * inserts, internal newlines become spaces.
  */
-/** A code point's display width: 2 for the wide ranges, 1 otherwise. */
-export declare function charWidth(cp: number): number;
-/** Display width of a code-point array (cursor math, scrolling). */
-export declare function widthOf(chars: readonly number[]): number;
-/** Display width of a string. */
-export declare function displayWidth(text: string): number;
+import { charWidth, displayWidth, widthOf } from "./width.js";
+export { charWidth, displayWidth, widthOf };
 export declare const PROMPT = "\u258C ";
 export declare const PROMPT_WIDTH: number;
 /** v3 §04 — the slash-command menu's command table (English one-liners). */
@@ -45,6 +41,7 @@ export declare class Editor {
     onSigint(cb: () => void): void;
     onEot(cb: () => void): void;
     onEscape(cb: () => void): void;
+    onExpand(cb: () => void): void;
     /** The whole buffer as text (the CLI's line()/clearLine()). */
     line(): string;
     clearLine(): void;

package/dist/editor.js

@@ -16,56 +16,10 @@
  * The editor is a SINGLE line: bracketed paste (?2004h) unwraps and
  * inserts, internal newlines become spaces.
  */
-/** A code point's display width: 2 for the wide ranges, 1 otherwise. */
-export function charWidth(cp) {
-    if (cp >= 0x1100 && cp <= 0x115f)
-        return 2; // hangul jamo
-    if (cp >= 0x2e80 && cp <= 0x303e)
-        return 2; // radicals .. CJK punctuation
-    if (cp >= 0x3041 && cp <= 0x33ff)
-        return 2; // kana, CJK compat
-    if (cp >= 0x3400 && cp <= 0x4dbf)
-        return 2; // CJK ext A
-    if (cp >= 0x4e00 && cp <= 0x9fff)
-        return 2; // CJK unified
-    if (cp >= 0xa000 && cp <= 0xa4cf)
-        return 2; // yi
-    if (cp >= 0xa960 && cp <= 0xa97f)
-        return 2; // hangul jamo ext
-    if (cp >= 0xac00 && cp <= 0xd7a3)
-        return 2; // hangul syllables
-    if (cp >= 0xf900 && cp <= 0xfaff)
-        return 2; // CJK compat ideographs
-    if (cp >= 0xfe10 && cp <= 0xfe19)
-        return 2; // vertical forms
-    if (cp >= 0xfe30 && cp <= 0xfe6f)
-        return 2; // CJK compat forms
-    if (cp >= 0xff00 && cp <= 0xff60)
-        return 2; // fullwidth forms
-    if (cp >= 0xffe0 && cp <= 0xffe6)
-        return 2; // fullwidth signs
-    if (cp >= 0x1f300 && cp <= 0x1f64f)
-        return 2; // emoji (misc + emoticons)
-    if (cp >= 0x1f900 && cp <= 0x1f9ff)
-        return 2; // supplemental emoji
-    if (cp >= 0x20000 && cp <= 0x3fffd)
-        return 2; // CJK ext B..G
-    return 1;
-}
-/** Display width of a code-point array (cursor math, scrolling). */
-export function widthOf(chars) {
-    let w = 0;
-    for (const cp of chars)
-        w += charWidth(cp);
-    return w;
-}
-/** Display width of a string. */
-export function displayWidth(text) {
-    let w = 0;
-    for (const ch of text)
-        w += charWidth(ch.codePointAt(0));
-    return w;
-}
+import { charWidth, displayWidth, widthOf } from "./width.js";
+// the width primitives moved to width.ts (W1, the single width
+// authority) — re-exported so the editor's public surface is unchanged.
+export { charWidth, displayWidth, widthOf };
 import { palette } from "./render.js";
 // TUI v4 #16d: the input row is the blue brick + the edit area — the
 // "you>" text is gone (the brick IS the prompt; the pipe path's readline
@@ -98,7 +52,15 @@ export class Editor {
     #pendingLines = []; // submits before onLine is wired (startup) — never dropped
     #sigintCb = null;
     #eotCb = null;
-    #escapeCb = null;
+    // W18: the escape LIST — the run-abort (chat) and the /compact cancel
+    // (dispatch) coexist; a listener removes itself via an unarmed guard
+    // (the compact's handler no-ops after its abort has fired).
+    #escapeCbs = [];
+    // W15: the expand-key list (ctrl+r) — the CLI's dispatch decides the
+    // target (a live cell toggles in place; a committed cell appends the
+    // expanded block). Mirrors the escape list: multiple listeners can
+    // coexist; the editor never interprets the key itself.
+    #expandCbs = [];
     #onRender;
     #menuOpen = false; // v3 §04: the slash-command menu
     #menuSel = 0;
@@ -136,7 +98,10 @@ export class Editor {
         this.#eotCb = cb;
     }
     onEscape(cb) {
-        this.#escapeCb = cb;
+        this.#escapeCbs.push(cb);
+    }
+    onExpand(cb) {
+        this.#expandCbs.push(cb);
     }
     /** The whole buffer as text (the CLI's line()/clearLine()). */
     line() {
@@ -253,7 +218,8 @@ export class Editor {
                     this.#onRender();
                 }
                 else {
-                    this.#escapeCb?.();
+                    for (const cb of [...this.#escapeCbs])
+                        cb();
                     i += 1;
                 }
             }
@@ -314,6 +280,13 @@ export class Editor {
                 }
                 i += 1;
             }
+            else if (c === "\x12") {
+                // W15: the expand key (ctrl+r) — rides the chain like a
+                // command, the editor just forwards it.
+                for (const cb of [...this.#expandCbs])
+                    cb();
+                i += 1;
+            }
             else if (c !== undefined && c < " ") {
                 i += 1; // other control — ignored
             }
@@ -497,7 +470,7 @@ export class Editor {
     // ---- width-based horizontal scroll ----
     #reflow() {
         const W = (process.stdout.columns ?? 0) || 80; // degenerate 0 falls back to 80
-        const maxW = Math.max(1, W - PROMPT_WIDTH - 1); // 1 col for the "…"
+        const maxW = Math.max(1, W - PROMPT_WIDTH - 4); // W6: the box's walls (2+2) — the visible line fits the box's inner width; the "…" rides inside
         const curCol = widthOf(this.#chars.slice(0, this.#cursor));
         const scrolledW = widthOf(this.#chars.slice(0, this.#scroll));
         if (curCol < scrolledW) {

package/dist/index.d.ts

@@ -8,5 +8,5 @@
 export { Body, Dock, CURSOR_MARKER, type BodyOptions } from "./compositor.js";
 export { Container, foldLine, 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, 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 { bannerLines, COLOR_OFF, COLOR_ON, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, truncateRow, type Palette, type PathResolver, type RecapStats, type ResumeMeta, type RenderInput, type RenderResult, type RunUsage, } from "./render.js";
 export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResult } from "./diff.js";

package/dist/index.js

@@ -8,5 +8,5 @@
 export { Body, Dock, CURSOR_MARKER } from "./compositor.js";
 export { Container, foldLine, visibleWidth, SPINNER } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, } from "./editor.js";
-export { bannerLines, COLOR_OFF, COLOR_ON, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderSessionLine, renderStatusLine, renderTerminalGap, renderToolSummary, TAGLINE, truncateRow, } from "./render.js";
+export { bannerLines, COLOR_OFF, COLOR_ON, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, truncateRow, } from "./render.js";
 export { editFileDiff, truncateDiff, writeFileDiff } from "./diff.js";

package/dist/render.d.ts

@@ -25,6 +25,8 @@ export interface Palette {
     readonly red: string;
     readonly green: string;
     readonly code: string;
+    readonly rv: string;
+    readonly rvEnd: string;
     readonly reset: string;
 }
 export declare const COLOR_ON: Palette;
@@ -175,7 +177,12 @@ export declare function renderEvent(ev: RenderInput, prevThinking?: boolean, res
 export declare function renderToolSummary(name: string, input: Record<string, unknown>, result: {
     content: string;
     isError: boolean;
-}): string;
+}, reason?: string | null): string;
+/** W15 — the expand header's target: the tool call's subject (the path
+ *  for the *_file tools, the command for shell) — the same extraction
+ *  the summary detail uses, WITHOUT the counts (the header names what
+ *  was expanded, not its size). */
+export declare function toolTarget(name: string, input: Record<string, unknown>): string;
 /** k-units for the status line: 12345 → 12.3k, 800 → 800, null → ?. */
 export declare function kUnit(value: number | null): string;
 /** B area: usage data gathered from the run's usage events. */
@@ -212,11 +219,24 @@ export declare function renderTerminalGap(statusLine: string | null): string;
  * Pure.
  */
 export declare const TAGLINE = "the coding agent that survives kill -9";
-/** v3 §01: truncate a row at `width`, marking the hidden span " (+N)". */
+/** v3 §01 (W1): truncate a row at `width`, marking the hidden span
+ *  " (+N)". W1: the width math is the charWidth authority (the banner's
+ *  brick glyphs are 1 cell — the art's 38 columns clear 40), and the
+ *  marker's own cells are part of the row — the visible cut leaves room
+ *  for it, so a truncated row never exceeds W (a cut row carries the
+ *  marker INSIDE the width; a row that fits is returned untouched). */
 export declare function truncateRow(row: string, width: number): string;
-/** v3 §01 (V6-2): the banner lines for a width W — logo (skipped under
- *  40 columns) + blank + "kiso vX — tagline" + extensions. */
-export declare function bannerLines(W: number, version: string, extensionsText: string): string[];
+/** v3 §01 (V6-2) + W1: the banner lines for a width W and height H —
+ *  the tier table (extends the existing "under 40 columns, skip the
+ *  logo" rule with a HEIGHT input):
+ *    W ≥ 40 and H ≥ 20 → BIG (the 36x6 wordmark, 2-column indent)
+ *    W ≥ 40 and 14–19 rows → COMPACT (v6's LOGO_ROWS, byte-identical)
+ *    anything smaller → text rows only
+ *  then the blank, then "vX — tagline" — the art IS the wordmark, so the
+ *  text row does not repeat the name — then extensions — then the W5
+ *  resume list (BIG only, W5). Every row truncates at the terminal width
+ *  with a " (+N)" marker. Pure. */
+export declare function bannerLines(W: number, H: number, version: string, extensionsText: string, resume?: readonly ResumeMeta[], now?: number): string[];
 /** v3 §02 — the recap line that ends a run, replacing the "done" label +
  *  the old status line. All fields derive LOCALLY from the event stream
  *  (zero tokens): wall seconds, tool counts, usage, cache hit %, ctx left.
@@ -227,6 +247,11 @@ export interface RecapStats {
     readonly edits: number;
     readonly usage: RunUsage;
     readonly ctxLeftPct: number | null;
+    /** W19 — the mode the turn ran under. Under "plan" the recap becomes
+     *  the way-forward row (the claimed shape): a plan turn's currency is
+     *  the plan, not the tool count — the timing and tool-count parts
+     *  drop, and the two /mode hints replace them. */
+    readonly mode?: string;
 }
 export declare function renderRecap(s: RecapStats): string;
 /** One-line summary of a session, for `kiso sessions`. */
@@ -237,3 +262,19 @@ export declare function renderSessionLine(meta: {
     runs: number;
     updatedAt: number;
 }): string;
+/** W5 — the opening-screen resume list. Every field already exists
+ *  behind renderSessionLine / `kiso sessions`: the relative time, the
+ *  title, then the right-aligned "N events · M runs". The columns are
+ *  fixed per W: 4 indent + 7 when + 1 + the title (the ONLY flexible
+ *  field — cut with the ellipsis marker INSIDE the width) + 1 + the meta
+ *  (padStart to metaW). The done-when: the meta's right edge lands at
+ *  exactly W on every row. Returns PLAIN rows — the banner's uniform dim
+ *  wrap styles them (no dim+bold SGR composition). */
+export interface ResumeMeta {
+    readonly title: string;
+    readonly events: number;
+    readonly runs: number;
+    readonly updatedAt: number;
+}
+export declare function relativeTime(updatedAt: number, now: number): string;
+export declare function renderResumeList(metas: readonly ResumeMeta[], W: number, now: number): string[];

package/dist/render.js

@@ -7,8 +7,9 @@
  * 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 = { bold: "\x1b[1m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", code: "\x1b[38;5;110m", reset: "\x1b[0m" };
-export const COLOR_OFF = { bold: "", dim: "", red: "", green: "", code: "", reset: "" };
+import { charWidth, displayWidth } from "./width.js";
+export const COLOR_ON = { bold: "\x1b[1m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", code: "\x1b[38;5;110m", rv: "\x1b[7m", rvEnd: "\x1b[27m", reset: "\x1b[0m" };
+export const COLOR_OFF = { bold: "", dim: "", red: "", green: "", code: "", rv: "", rvEnd: "", reset: "" };
 export function palette() {
     return process.env.NO_COLOR === undefined && process.stdout.isTTY ? COLOR_ON : COLOR_OFF;
 }
@@ -188,9 +189,16 @@ function approvalDetail(name, input, resolvePath) {
  * edit/write show +/- line counts, read shows lines, shell shows the exit
  * code; failures (isError) are ✗. Pure and deterministic.
  */
-export function renderToolSummary(name, input, result) {
+export function renderToolSummary(name, input, result, reason = null) {
     // v2a/v5: ✓ is a bold identity accent; ✗ stays red.
     const p = palette();
+    // W19: a DENIED call (the "denied" tag) renders the pinned row — the
+    // FULL call name, the target, the reason in the W4 parentheses idiom,
+    // and NO timing metadata (the call never ran — (0.0s) would be noise).
+    // The same row in the interactive and pipe paths, byte-clean on a pipe.
+    if (reason !== null) {
+        return `${p.red}✗${p.reset} ${escapeTerminal(`${name} ${toolTarget(name, input)} (${reason})`)}`;
+    }
     const mark = result.isError ? `${p.red}✗${p.reset}` : `${p.bold}✓${p.reset}`;
     const shortName = name.replace("_file", "");
     const detail = toolSummaryDetail(name, input, result);
@@ -232,6 +240,24 @@ function toolSummaryDetail(name, input, result) {
             return String(input.path ?? input.command ?? "");
     }
 }
+/** W15 — the expand header's target: the tool call's subject (the path
+ *  for the *_file tools, the command for shell) — the same extraction
+ *  the summary detail uses, WITHOUT the counts (the header names what
+ *  was expanded, not its size). */
+export function toolTarget(name, input) {
+    switch (name) {
+        case "read_file":
+        case "write_file":
+        case "edit_file":
+            return String(input.path ?? "?");
+        case "shell":
+            return String(input.command ?? "?");
+        case "list_dir":
+            return String(input.path ?? "(root)");
+        default:
+            return String(input.path ?? input.command ?? "");
+    }
+}
 /** The exit code of a shell result: parsed from the failure text, 0 on success. */
 function exitCodeOf(result) {
     if (!result.isError)
@@ -293,47 +319,94 @@ export function renderTerminalGap(statusLine) {
  * Pure.
  */
 export const TAGLINE = "the coding agent that survives kill -9";
+/** v6's existing logo — W1's COMPACT tier, byte-identical, no redraw. */
 const LOGO_ROWS = ["█ █ ▀█▀ █▀▀ █▀█", "█▀▄  █  ▀▀█ █ █", "▀ ▀ ▀▀▀ ▀▀▀ ▀▀▀"];
-/** Display width of a row (1-cell ASCII; 2-cell CJK/wide). */
-function displayW(row) {
-    let w = 0;
-    for (let i = 0; i < row.length; i += 1) {
-        const cp = row.codePointAt(i);
-        w += cp > 0xff ? 2 : 1;
-    }
-    return w;
-}
-/** v3 §01: truncate a row at `width`, marking the hidden span " (+N)". */
+/** W1's BIG tier (36x6, `█` and space only — no half-blocks, so there is
+ *  no tile seam to lose in a font that renders ▀ ▄ at the wrong height).
+ *  Each pixel is two cells wide on purpose (a terminal cell is ~1:2);
+ *  the render indents two — 38 columns total, clears 40. */
+const BIG_LOGO_ROWS = [
+    "██    ██  ██████  ████████  ████████",
+    "██  ██      ██    ██        ██    ██",
+    "████        ██    ████████  ██    ██",
+    "████        ██          ██  ██    ██",
+    "██  ██      ██          ██  ██    ██",
+    "██    ██  ██████  ████████  ████████",
+];
+/** v3 §01 (W1): truncate a row at `width`, marking the hidden span
+ *  " (+N)". W1: the width math is the charWidth authority (the banner's
+ *  brick glyphs are 1 cell — the art's 38 columns clear 40), and the
+ *  marker's own cells are part of the row — the visible cut leaves room
+ *  for it, so a truncated row never exceeds W (a cut row carries the
+ *  marker INSIDE the width; a row that fits is returned untouched). */
 export function truncateRow(row, width) {
-    if (displayW(row) <= width)
+    const total = displayWidth(row);
+    if (total <= width)
         return row;
-    const cut = Math.max(0, width - 4);
-    let w = 0;
-    let i = 0;
-    for (; i < row.length; i += 1) {
-        const cw = row.codePointAt(i) > 0xff ? 2 : 1;
-        if (w + cw > cut)
-            break;
-        w += cw;
+    // iterate the marker to a fixpoint: the marker's width changes the
+    // cut, the cut changes the hidden count the marker reports
+    let marker = " (+0)";
+    for (;;) {
+        const cut = Math.max(0, width - displayWidth(marker));
+        let w = 0;
+        let i = 0;
+        while (i < row.length) {
+            const cp = row.codePointAt(i);
+            const cw = charWidth(cp);
+            if (w + cw > cut)
+                break;
+            w += cw;
+            i += cp > 0xffff ? 2 : 1; // code-point stepping — never split a pair
+        }
+        const next = ` (+${total - w})`;
+        if (next === marker)
+            return `${row.slice(0, i)}${next}`;
+        marker = next;
     }
-    return `${row.slice(0, i)} (+${displayW(row) - w})`;
 }
-/** v3 §01 (V6-2): the banner lines for a width W — logo (skipped under
- *  40 columns) + blank + "kiso vX — tagline" + extensions. */
-export function bannerLines(W, version, extensionsText) {
+/** v3 §01 (V6-2) + W1: the banner lines for a width W and height H —
+ *  the tier table (extends the existing "under 40 columns, skip the
+ *  logo" rule with a HEIGHT input):
+ *    W ≥ 40 and H ≥ 20 → BIG (the 36x6 wordmark, 2-column indent)
+ *    W ≥ 40 and 14–19 rows → COMPACT (v6's LOGO_ROWS, byte-identical)
+ *    anything smaller → text rows only
+ *  then the blank, then "vX — tagline" — the art IS the wordmark, so the
+ *  text row does not repeat the name — then extensions — then the W5
+ *  resume list (BIG only, W5). Every row truncates at the terminal width
+ *  with a " (+N)" marker. Pure. */
+export function bannerLines(W, H, version, extensionsText, resume = [], now = Date.now()) {
     const rows = [];
     if (W >= 40) {
-        for (const r of LOGO_ROWS)
-            rows.push(truncateRow(r, W));
-        rows.push("");
+        if (H >= 20) {
+            for (const r of BIG_LOGO_ROWS)
+                rows.push(truncateRow(`  ${r}`, W));
+        }
+        else if (H >= 14) {
+            for (const r of LOGO_ROWS)
+                rows.push(truncateRow(r, W));
+        }
     }
-    rows.push(truncateRow(`kiso v${version} — ${TAGLINE}`, W));
+    if (rows.length > 0)
+        rows.push("");
+    rows.push(truncateRow(`v${version} — ${TAGLINE}`, W));
     if (extensionsText !== "")
         rows.push(truncateRow(extensionsText, W));
+    if (W >= 40 && H >= 20 && resume.length > 0) {
+        rows.push("", ...renderResumeList(resume, W, now));
+    }
     return rows;
 }
 export function renderRecap(s) {
     const p = palette();
+    // W19: under plan the recap is the way out of the mode — the header
+    // names the mode's posture, the hints name the exits (the ONLY
+    // controls — /mode is the only way to leave plan mode).
+    if (s.mode === "plan") {
+        const parts = ["plan ready", "/mode default executes", "/mode accept-edits auto-approves edits"];
+        if (s.ctxLeftPct !== null)
+            parts.push(`ctx left ~${Math.round(s.ctxLeftPct)}%`);
+        return `${p.bold}▞${p.reset} ${parts.join(" · ")}\n`;
+    }
     const parts = [`${s.seconds}s`, `${s.tools} tool${s.tools === 1 ? "" : "s"}${s.edits > 0 ? ` (${s.edits} edit${s.edits === 1 ? "" : "s"})` : ""}`];
     if (s.usage.known) {
         const seg = `${s.usage.in !== null ? `in ${kUnit(s.usage.in)}` : ""}${s.usage.in !== null && s.usage.out !== null ? " " : ""}${s.usage.out !== null ? `out ${kUnit(s.usage.out)}` : ""}`;
@@ -353,3 +426,50 @@ export function renderSessionLine(meta) {
     // round 8: the title is the user's first prompt — model/user text, escaped.
     return `${meta.id.padEnd(24)} ${meta.runs} runs ${String(meta.events).padStart(5)} events  ${when}  ${escapeTerminal(meta.title)}`;
 }
+export function relativeTime(updatedAt, now) {
+    const s = Math.max(0, now - updatedAt) / 1000;
+    if (s < 60)
+        return "now";
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ago`;
+    const d = Math.floor(h / 24);
+    if (d < 7)
+        return `${d}d ago`;
+    return `${Math.floor(d / 7)}w ago`;
+}
+function titleCut(text, max) {
+    if (displayWidth(text) <= max)
+        return text;
+    const room = max - displayWidth("…");
+    let w = 0;
+    let i = 0;
+    while (i < text.length) {
+        const cp = text.codePointAt(i);
+        const cw = charWidth(cp);
+        if (w + cw > room)
+            break;
+        w += cw;
+        i += cp > 0xffff ? 2 : 1;
+    }
+    return text.slice(0, i) + "…";
+}
+export function renderResumeList(metas, W, now) {
+    if (metas.length === 0)
+        return [];
+    const rows = ["  ▞ resume"];
+    const whens = metas.map((m) => relativeTime(m.updatedAt, now));
+    const metaTexts = metas.map((m) => `${m.events} events · ${m.runs} runs`);
+    const metaW = Math.max(...metaTexts.map((t) => t.length));
+    const titleW = Math.max(1, W - 13 - metaW);
+    for (let i = 0; i < metas.length; i += 1) {
+        const title = escapeTerminal(metas[i].title);
+        const shown = titleCut(title, titleW);
+        const pad = titleW - displayWidth(shown);
+        rows.push(`    ${whens[i].padEnd(7)} ${shown}${" ".repeat(pad)} ${metaTexts[i].padStart(metaW)}`);
+    }
+    return rows;
+}

package/dist/width.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The display-width primitives — the SINGLE width authority (TUI v5
+ * #16e: "charWidth is the width authority"). The eastAsianWidth table
+ * is a ~40-line subset (CJK ideographs/kana/hangul/fullwidth/common
+ * wide symbols = 2, everything else = 1 — the box-drawing/brick glyphs
+ * █▀▄▞▸ are narrow). Known limitation, documented in the README: emoji
+ * ZWJ clusters are not guaranteed perfect — each code point counts as
+ * its width. Zero dependencies (importable from any module).
+ */
+/** A code point's display width: 2 for the wide ranges, 1 otherwise. */
+export declare function charWidth(cp: number): number;
+/** Display width of a code-point array (cursor math, scrolling). */
+export declare function widthOf(chars: readonly number[]): number;
+/** Display width of a string. */
+export declare function displayWidth(text: string): number;

package/dist/width.js

@@ -0,0 +1,59 @@
+/**
+ * The display-width primitives — the SINGLE width authority (TUI v5
+ * #16e: "charWidth is the width authority"). The eastAsianWidth table
+ * is a ~40-line subset (CJK ideographs/kana/hangul/fullwidth/common
+ * wide symbols = 2, everything else = 1 — the box-drawing/brick glyphs
+ * █▀▄▞▸ are narrow). Known limitation, documented in the README: emoji
+ * ZWJ clusters are not guaranteed perfect — each code point counts as
+ * its width. Zero dependencies (importable from any module).
+ */
+/** A code point's display width: 2 for the wide ranges, 1 otherwise. */
+export function charWidth(cp) {
+    if (cp >= 0x1100 && cp <= 0x115f)
+        return 2; // hangul jamo
+    if (cp >= 0x2e80 && cp <= 0x303e)
+        return 2; // radicals .. CJK punctuation
+    if (cp >= 0x3041 && cp <= 0x33ff)
+        return 2; // kana, CJK compat
+    if (cp >= 0x3400 && cp <= 0x4dbf)
+        return 2; // CJK ext A
+    if (cp >= 0x4e00 && cp <= 0x9fff)
+        return 2; // CJK unified
+    if (cp >= 0xa000 && cp <= 0xa4cf)
+        return 2; // yi
+    if (cp >= 0xa960 && cp <= 0xa97f)
+        return 2; // hangul jamo ext
+    if (cp >= 0xac00 && cp <= 0xd7a3)
+        return 2; // hangul syllables
+    if (cp >= 0xf900 && cp <= 0xfaff)
+        return 2; // CJK compat ideographs
+    if (cp >= 0xfe10 && cp <= 0xfe19)
+        return 2; // vertical forms
+    if (cp >= 0xfe30 && cp <= 0xfe6f)
+        return 2; // CJK compat forms
+    if (cp >= 0xff00 && cp <= 0xff60)
+        return 2; // fullwidth forms
+    if (cp >= 0xffe0 && cp <= 0xffe6)
+        return 2; // fullwidth signs
+    if (cp >= 0x1f300 && cp <= 0x1f64f)
+        return 2; // emoji (misc + emoticons)
+    if (cp >= 0x1f900 && cp <= 0x1f9ff)
+        return 2; // supplemental emoji
+    if (cp >= 0x20000 && cp <= 0x3fffd)
+        return 2; // CJK ext B..G
+    return 1;
+}
+/** Display width of a code-point array (cursor math, scrolling). */
+export function widthOf(chars) {
+    let w = 0;
+    for (const cp of chars)
+        w += charWidth(cp);
+    return w;
+}
+/** Display width of a string. */
+export function displayWidth(text) {
+    let w = 0;
+    for (const ch of text)
+        w += charWidth(ch.codePointAt(0));
+    return w;
+}

package/package.json

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