@vincemakes/kiso-tui-cells 0.25.0 → 0.26.0

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * package); the cli never imports it directly. Experimental — no
  * API-stability promise yet.
  */
-export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, focusToken, ROLLUP_NOUN, foldTerms, CAP_TASK_LIVE, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, type FrameCtx, type RenderLine, type Component, type BodyCell, } from "./components.js";
+export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, foldTerms, CAP_TASK_LIVE, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, type FrameCtx, type RenderLine, type Component, type BodyCell, } from "./components.js";
 export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResult } from "./diff.js";
 export { pendingQueueRows } from "./components.js";
 export { charWidth, displayWidth, leadWidth, widthOf } from "./width.js";

package/dist/index.js

@@ -6,7 +6,7 @@
  * package); the cli never imports it directly. Experimental — no
  * API-stability promise yet.
  */
-export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, focusToken, ROLLUP_NOUN, foldTerms, CAP_TASK_LIVE, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, } from "./components.js";
+export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, foldTerms, CAP_TASK_LIVE, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, } from "./components.js";
 export { editFileDiff, truncateDiff, writeFileDiff } from "./diff.js";
 // W22 (the v8 input round): the pending-queue chips — the SAME
 // UserMessage chip with the □ gutter, pre-rendered above the input

package/dist/render.d.ts

@@ -88,23 +88,6 @@ export interface Palette {
      *  spans and must end without stranding them. */
     readonly wash: string;
     readonly washEnd: string;
-    /** R7a — THE FOCUS MARKER'S EMPHASIS, and it is not a background.
-     *
-     *  DC-3 gave the `ctrl+o` token the wash, which is a BACKGROUND once
-     *  a ground is resolved: `48;5;236` on dark reads as a black block
-     *  behind the key, on a row that is otherwise plain text. The owner
-     *  asked for it gone. The invariant DC-3 was serving — exactly one
-     *  bright token per frame, because the key has exactly one target —
-     *  never required a background; it required CONTRAST against the dim
-     *  siblings, and full-strength bold foreground is more of it than a
-     *  wash was.
-     *
-     *  Three escapes because "dim" has two forms here: SGR 2 in the
-     *  neutral palette, a 256-colour foreground in the resolved ones.
-     *  22 cancels the attribute, 39 restores the default foreground, 1
-     *  is the emphasis. It closes by re-opening the palette's own dim,
-     *  like `washEnd`, so the surrounding span survives. */
-    readonly lift: string;
     /** R9 P3 — THE ONE GREY ALLOWED ON THE WASH.
      *
      *  §2.1 bars `dim` from the wash and the measurement is why: `#767676`
@@ -248,7 +231,20 @@ export interface BannerMeta {
     readonly model: string;
     readonly mode: string;
     readonly cwd: string;
+    /** DC-49 — the workspace IS the user's home directory. Computed by the
+     *  CLI (realpath on both sides); the banner only renders it. */
+    readonly homeWorkspace?: boolean;
 }
+/** W20 — the ONE-ROW cut with the honest mark, SGR-aware. A line that
+ *  fits (≤ W) passes through whole; an overflow cuts the content at
+ *  W−1 — the ellipsis's slot — and the ellipsis rides AFTER the reset
+ *  (post-reset — the PTY needles' convention). The cut row never
+ *  exceeds W (invariant ①). One implementation for every one-row
+ *  surface: the live task rows, the approval panel's lines (W21), the
+ *  help and keys rows, the transcript viewer's rows. (The strings module
+ *  and the viewer each carried a copy; the viewer's put the ellipsis
+ *  before the reset, and now does not.) */
+export declare function cutLine(line: string, W: number): string;
 /** 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

package/dist/render.js

@@ -5,7 +5,7 @@
  * produce the bytes a human sees. Colors are raw ANSI — zero
  * dependencies (the tui-cells package has none).
  */
-import { charWidth, displayWidth } from "./width.js";
+import { charWidth, displayWidth, visibleWidth, widthCut } from "./width.js";
 const BASE = { bold: "\x1b[1m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", warn: "\x1b[33m", italic: "\x1b[3m", italicEnd: "\x1b[23m", underline: "\x1b[4m", underlineEnd: "\x1b[24m", rv: "\x1b[7m", rvEnd: "\x1b[27m", reset: "\x1b[0m" };
 /**
  * DC-9 (design §2.3) — the failure colour is theme-resolved.
@@ -40,7 +40,6 @@ const withWash = (wash, washEnd, red = BASE.red, dim = BASE.dim, washDim = "") =
     washDim,
     washDimEnd: washDim === "" ? "" : "\x1b[39m",
     code: wash,
-    lift: "\x1b[22m\x1b[39m\x1b[1m",
 });
 /**
  * DC-3 — one table per ground.
@@ -69,7 +68,7 @@ export const COLOR_DARK = withWash("\x1b[48;5;236m", "\x1b[49m", "\x1b[38;5;173m
  *  not been established. Unchanged in every byte except `code`, which
  *  was the defect. */
 export const COLOR_ON = COLOR_NEUTRAL;
-export const COLOR_OFF = { bold: "", dim: "", red: "", green: "", warn: "", code: "", italic: "", italicEnd: "", underline: "", underlineEnd: "", rv: "", rvEnd: "", wash: "", washEnd: "", washDim: "", washDimEnd: "", lift: "", reset: "" };
+export const COLOR_OFF = { bold: "", dim: "", red: "", green: "", warn: "", code: "", italic: "", italicEnd: "", underline: "", underlineEnd: "", rv: "", rvEnd: "", wash: "", washEnd: "", washDim: "", washDimEnd: "", reset: "" };
 /** DC-3 — the resolved ground, set once at startup when the terminal
  *  answers (see `ground.ts`). It starts UNKNOWN and may stay that way
  *  forever; that is a supported state, not a failure. */
@@ -292,20 +291,6 @@ export function twinkleFrame(step) {
 /** Both cycles are seven frames, so ONE counter walks them and the two
  *  marks stay in step on a screen showing both. */
 export const MOTION_FRAMES = 7;
-/** DC-18: the display-width prefix of PLAIN text. `widthCut` lives in
- *  components.ts, which imports this module — the dependency runs one
- *  way, so the four lines live here rather than inverting it. */
-function plainCut(text, max) {
-    let w = 0;
-    let i = 0;
-    for (; i < text.length; i += 1) {
-        const cw = charWidth(text.codePointAt(i));
-        if (w + cw > max)
-            break;
-        w += cw;
-    }
-    return text.slice(0, i);
-}
 export const TAGLINE = "the coding agent that survives kill -9";
 /**
  * R2 — the wordmark is retired (2026-08-27, the nineteen-screen review).
@@ -335,6 +320,45 @@ const BANNER_KEYS = "esc interrupt · ctrl+c exit · / commands · @ files · ?
  *  rather than by SGR: they mark sections and are never content. */
 const BANNER_LABELS = ["MODEL", "WORKSPACE", "EXTENSIONS"];
 const LABEL_STOP = Math.max(...BANNER_LABELS.map((l) => l.length)) + 2;
+/** W20 — the ONE-ROW cut with the honest mark, SGR-aware. A line that
+ *  fits (≤ W) passes through whole; an overflow cuts the content at
+ *  W−1 — the ellipsis's slot — and the ellipsis rides AFTER the reset
+ *  (post-reset — the PTY needles' convention). The cut row never
+ *  exceeds W (invariant ①). One implementation for every one-row
+ *  surface: the live task rows, the approval panel's lines (W21), the
+ *  help and keys rows, the transcript viewer's rows. (The strings module
+ *  and the viewer each carried a copy; the viewer's put the ellipsis
+ *  before the reset, and now does not.) */
+export function cutLine(line, W) {
+    if (visibleWidth(line) <= W)
+        return line;
+    let out = "";
+    let width = 0;
+    for (let i = 0; i < line.length;) {
+        if (line[i] === "\x1b") {
+            // exec returns an ARRAY — copying m coerces it (the match), but
+            // m.length is the CAPTURE count (1), not the sequence length:
+            // the old `i += m.length` re-processed the sequence's bracket
+            // text as literal rows, doubling every code in a cut line
+            // (the W21 panel-slot red test). Index 0 is the sequence.
+            const m = /^\x1b\[[0-9;]*m/.exec(line.slice(i))?.[0] ?? line[i];
+            out += m;
+            i += m.length;
+            continue;
+        }
+        const cw = displayWidth(line[i]);
+        if (width + cw > W - 1)
+            break; // reserve the ellipsis's column
+        out += line[i];
+        width += cw;
+        i += 1;
+    }
+    // R8a: the reset comes from the PALETTE, not hardcoded. `\x1b[0m`
+    // here put an escape into every cut row under NO_COLOR and behind a
+    // pipe — the one context COLOR_OFF exists to keep clean (§1.2). A
+    // coloured palette is byte-identical, because its reset IS `\x1b[0m`.
+    return `${out}${palette().reset}…`;
+}
 /** 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
@@ -351,7 +375,7 @@ export function truncateRow(row, width) {
     // terminal — and invariant ① throws rather than truncating. A marker
     // wider than the row it marks is not a marker.
     if (width < 7)
-        return plainCut(row, Math.max(0, width));
+        return widthCut(row, Math.max(0, width));
     // 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)";
@@ -397,13 +421,24 @@ export function bannerLines(W, H, version, extensionsText, resume = [], now = Da
     // measured 11 cells and invariant ① threw AT STARTUP — the function
     // whose own comment preaches "invariant ① holds at every width".
     // The cut is taken on the plain text, per the note above.
-    const namePlain = plainCut(`kiso ${version}`, Math.max(1, W));
+    const namePlain = widthCut(`kiso ${version}`, Math.max(1, W));
     const nameCut = namePlain.slice(0, 4); // "kiso", or its surviving prefix
     const verCut = namePlain.slice(5); // the version, if the width left room for it
     const rows = [`${p.bold}${nameCut}${p.reset}${verCut === "" ? "" : `${p.dim} ${verCut}${p.reset}`}`];
     const facts = [];
     if (meta !== undefined) {
         facts.push([BANNER_LABELS[0], `${meta.model}${meta.mode === "" ? "" : ` · ${meta.mode}`}`], [BANNER_LABELS[1], meta.cwd]);
+        // DC-49 — ONE row under the cwd, and only when the workspace is the
+        // home directory. It STATES a fact and names the remedy; it does not
+        // warn, because the configuration is ALLOWED (owner, 2026-09-06) and
+        // a warning about an allowed thing teaches people to skip rows.
+        //
+        // An empty label puts it in the value column under `WORKSPACE`,
+        // where it reads as a note on that fact rather than a fact of its
+        // own. It must FIT at W=80 under the label indent: a cut row loses
+        // the remedy, which is the only actionable half of the sentence.
+        if (meta.homeWorkspace === true)
+            facts.push(["", "home directory as workspace — cd into a project to narrow it"]);
     }
     if (extensionsText !== "")
         facts.push([BANNER_LABELS[2], extensionsText]);

package/dist/strings.js

@@ -17,8 +17,8 @@
  * why the caller passes paths and counts in rather than having them
  * looked up here.
  */
-import { escapeTerminal, palette } from "./render.js";
-import { displayWidth, visibleWidth } from "./width.js";
+import { cutLine, escapeTerminal, palette } from "./render.js";
+import { displayWidth } from "./width.js";
 /** v2a: the interactive prompt — the identity accent. readline owns the
  *  echo of what the user types; we own the prompt's color. (v2c: the
  *  readline prompt keeps "you> " — the brick ▌ is the dock's row only;
@@ -196,6 +196,14 @@ export const KEY_BINDINGS = [
     { keys: "ctrl+r", what: "transcript" },
     { keys: "tab", what: "complete (menu / @)" },
     { keys: "?", what: "this sheet" },
+    // E1 §1/§3 — the editor's daily three. Three spellings of the word
+    // gestures reach the same code (alt, ctrl+arrow, and alt+b/f where
+    // the terminal sends meta); the sheet names the two a reader is most
+    // likely to have. ctrl+w is listed beside them because it works on
+    // every terminal, including the ones that send none of the three.
+    { keys: "alt+←→ / ctrl+←→", what: "word motion" },
+    { keys: "alt+⌫ / alt+d", what: "delete word (ctrl+w too)" },
+    { keys: "ctrl+x", what: "copy the last answer" },
     { keys: "ctrl+z / ctrl+y", what: "undo / redo" },
 ];
 /**
@@ -279,7 +287,14 @@ const SHEET_GRID = [
     [8, 9],
     // UD-1's undo row shares this one now — the table has an even count
     // again, so no binding needs a row to itself.
+    //
+    // E1 §1/§3 — three more, and the warning above earned itself a second
+    // time: adding them to KEY_BINDINGS without touching this grid pushed
+    // the last three off the sheet, and the "ONE SOURCE" gate caught it
+    // exactly as its comment predicted it would.
     [10, 11],
+    [12, 13],
+    [14],
 ];
 const SHEET_STOPS = [
     [16, 43],
@@ -287,6 +302,18 @@ const SHEET_STOPS = [
     [36],
     [36],
     [36],
+    // E1 §1/§3 — the two-column rows the three new bindings land on.
+    // A THIRD table that must agree with the other two and nothing makes
+    // it: `SHEET_GRID` says which bindings share a row, this says where
+    // their second column starts, and `KEY_BINDINGS` says what they are.
+    // The grid's own comment warned about the pair; the trio is worse.
+    // The stop is 39 here because `alt+⌫ / alt+d delete word (ctrl+w too)`
+    // is the widest first cell on the sheet — a narrower stop packs the
+    // two cells together with a single space and the column disappears.
+    // The last row has ONE binding, so it pads nothing (an empty stop
+    // list, not a stop of 36, which would leave trailing blanks).
+    [39],
+    [],
 ];
 /**
  * TUI2-R1 (D) — the sheet, one screen, static.
@@ -355,7 +382,7 @@ export function keysSheetRows(W) {
         rows.push(row);
     }
     rows.push(`${p.dim}${panelKeysRow(W)}${p.reset}`);
-    return rows.map((row) => cutRow(row, W));
+    return rows.map((row) => cutLine(row, W));
 }
 /**
  * DC-2 — the panel row degrades by CLAUSE.
@@ -364,7 +391,7 @@ export function keysSheetRows(W) {
  * used to lose the tail of the last one, so `t types` became `t`: the
  * reader was told a key existed and not told what it did, on a row that
  * still looked complete. Dropping a whole clause says less; it never
- * says something false. `cutRow`'s ellipsis is the floor below this, for
+ * says something false. `cutLine`'s ellipsis is the floor below this, for
  * a width that cannot hold even the first clause.
  */
 function panelKeysRow(W) {
@@ -376,36 +403,6 @@ function panelKeysRow(W) {
     }
     return clauses[0];
 }
-/** One row, cut at the width — SGR-aware, the ellipsis after the reset
- *  (the cutLine convention; duplicated here rather than imported so the
- *  strings module keeps its no-components-dependency shape). */
-function cutRow(row, W) {
-    // DC-2: a cut is MARKED. This returned the surviving prefix with
-    // nothing to say it was a prefix, so a row that had lost its tail read
-    // as a whole row — the one thing the tree's own fold rule forbids
-    // ("the honest …, never a silent truncate"). The mark costs a column,
-    // so the cut lands one column earlier to pay for it.
-    if (displayWidth(row.replace(/\x1b\[[0-9;]*m/g, "")) <= W)
-        return row;
-    const limit = Math.max(0, W - 1);
-    let out = "";
-    let width = 0;
-    for (let i = 0; i < row.length;) {
-        if (row[i] === "\x1b") {
-            const m = /^\x1b\[[0-9;]*m/.exec(row.slice(i))?.[0] ?? row[i];
-            out += m;
-            i += m.length;
-            continue;
-        }
-        const cw = displayWidth(row[i]);
-        if (width + cw > limit)
-            break;
-        out += row[i];
-        width += cw;
-        i += 1;
-    }
-    return `${out}${palette().reset}\u2026`;
-}
 /** TUI2-R1 (D) — the keys as ONE line, for /help. The same table the
  *  sheet renders, joined — so the two can disagree only by deleting a
  *  test. The sheet is the readable form; this is the greppable one. */
@@ -436,6 +433,7 @@ export function helpRows() {
         // R4 (C4d): a committed row is the terminal's, and cannot be
         // re-wrapped in place (ADR-0046) — this appends it re-folded.
         ["/rewrap", "re-print the recent prose at the current width"],
+        ["/copy", "copy the last answer (raw markdown) — ctrl+x does the same"],
         ["/status", "show session id, event count, and context estimate"],
         ["/mode", "show the approval tier; /mode <name> switches (manual/default/accept-edits/plan/bypass)"],
         ["/model", "list model profiles; /model <name|provider/model> switches"],

package/dist/width.d.ts

@@ -28,6 +28,14 @@ export declare function breakable(cp: number): boolean;
 export declare function widthOf(chars: readonly number[]): number;
 /** Display width of a string. */
 export declare function displayWidth(text: string): number;
+/** The display-width prefix of a text — the cell cut, no mark. Steps
+ *  by CODE POINT, so an astral character (an emoji) counts its true
+ *  width and is never split between its surrogates: the cut lands
+ *  before it when it does not fit. SGR-blind — the caller cuts what it
+ *  has already measured as visible text. The one cutter under
+ *  `cutLine` (the marked one-row cut), the banner's plain rows (DC-18)
+ *  and the approval panel's option-2 rule name (W21). */
+export declare function widthCut(text: string, max: number): string;
 /** The visible width of a RENDERED line — the same table, asked with
  *  the SGR/CSI sequences skipped. The compositor's invariant ① measures
  *  with this, so every producer of a screen row must measure with it

package/dist/width.js

@@ -151,6 +151,26 @@ export function displayWidth(text) {
         w += charWidth(ch.codePointAt(0));
     return w;
 }
+/** The display-width prefix of a text — the cell cut, no mark. Steps
+ *  by CODE POINT, so an astral character (an emoji) counts its true
+ *  width and is never split between its surrogates: the cut lands
+ *  before it when it does not fit. SGR-blind — the caller cuts what it
+ *  has already measured as visible text. The one cutter under
+ *  `cutLine` (the marked one-row cut), the banner's plain rows (DC-18)
+ *  and the approval panel's option-2 rule name (W21). */
+export function widthCut(text, max) {
+    let w = 0;
+    let i = 0;
+    while (i < text.length) {
+        const cp = text.codePointAt(i);
+        const cw = charWidth(cp);
+        if (w + cw > max)
+            break;
+        w += cw;
+        i += cp > 0xffff ? 2 : 1;
+    }
+    return text.slice(0, i);
+}
 /** The visible width of a RENDERED line — the same table, asked with
  *  the SGR/CSI sequences skipped. The compositor's invariant ① measures
  *  with this, so every producer of a screen row must measure with it

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui-cells",
-	"version": "0.25.0",
+	"version": "0.26.0",
 	"description": "kiso tui-cells — the components cell renderer (components, diff, width, the render slice). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",