@vincemakes/kiso-tui-cells 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResu
 export { pendingQueueRows } from "./components.js";
 export { charWidth, displayWidth, leadWidth, widthOf } from "./width.js";
 export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, type PanelArgs, type PanelFlavor, type PanelPhase, type PanelSel, type PanelState, type PanelVerdict, type PanelView, } from "./approval-panel.js";
+export { interactivePrompt, projectTrustRows, projectTrustView, projectUntrustedNote, uncertainView, type TrustArtifact, } from "./strings.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, colorInlineCode, escapeTerminal, foldResult, foldThinking, kUnit, palette, relativeTime, renderResumeList, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, type Palette, type ResumeMeta, } from "./render.js";

package/dist/index.js

@@ -18,4 +18,9 @@ export { charWidth, displayWidth, leadWidth, widthOf } from "./width.js";
 // approval is pending. Types + the row/lead/status renderers; the
 // verdict mapping lives in the cli, never here.
 export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, } from "./approval-panel.js";
+// KC3 slice 1 (the extraction): the human-facing strings the CLI's
+// trust-ui.ts used to build inline — the prompt, the project-trust
+// listing/view/note, the uncertain execution's view. The flow stays in
+// the cli; what the human reads is presentation.
+export { interactivePrompt, projectTrustRows, projectTrustView, projectUntrustedNote, uncertainView, } from "./strings.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, colorInlineCode, escapeTerminal, foldResult, foldThinking, kUnit, palette, relativeTime, renderResumeList, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, } from "./render.js";

package/dist/render.d.ts

@@ -11,12 +11,23 @@
  * RETIRED — the identity accents (the you> prompt, the banner tagline,
  * ✓ marks, slash-command names, the input brick) are bright-white BOLD
  * (SGR 1); the user message is the SGR-7 chip (the 2026-08-09 ruling
- * retired the ▍ rail); `code` is the content semantic tint for
- * inline code spans in assistant text (256-color 110 — the cube color
- * nearest the design's #8fb4d8); red for errors, dim for metadata,
- * green for the diff additions. NO_COLOR set, or a non-TTY output →
- * every code is empty, so pipes and CI carry ZERO ANSI (the existing
- * byte-level e2e assertions guard it). Everything not listed is plain.
+ * retired the ▍ rail); red for errors, dim for metadata, green for the
+ * diff additions. NO_COLOR set, or a non-TTY output → every code is
+ * empty, so pipes and CI carry ZERO ANSI (the existing byte-level e2e
+ * assertions guard it). Everything not listed is plain.
+ *
+ * KC3 §2 — THE MONO DISCIPLINE (the owner's 2026-08-17 ruling, a
+ * DECLARED SUPERSESSION under ADR-0051 Amendment 3). The interface's
+ * body is carried by shades of black and white; green ✓, yellow warn
+ * and red error are the ONLY functional exceptions. v5 had already
+ * taken the identity accents to bold; `code` was the one chromatic
+ * entry left — the light BLUE 38;5;110 — and it becomes the light GRAY
+ * 38;5;252. A tint still says "this span is code", which is the job it
+ * was hired for; saying it in a hue was never the job.
+ *
+ * The functional colors are deliberately NOT moved and not
+ * approximated: red stays SGR 31, green stays SGR 32. A reader who has
+ * learned that colour means something must keep being right.
  */
 export interface Palette {
     readonly bold: string;

package/dist/render.js

@@ -6,7 +6,7 @@
  * dependencies (the tui-cells package has none).
  */
 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_ON = { bold: "\x1b[1m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", code: "\x1b[38;5;252m", 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;

package/dist/strings.d.ts

@@ -0,0 +1,60 @@
+/**
+ * tui-cells — the human-facing STRINGS (KC3 slice 1, the ADR-0041
+ * escape hatch: extraction, never a raise): the readline prompt, the
+ * project-trust listing rows and its panel view, the uncertain
+ * execution's panel view, and the non-TTY not-trusted note. All five
+ * were built inline in the CLI's trust-ui.ts before the move.
+ *
+ * The split is the one the ADR names. The FLOW stays in the CLI: who is
+ * asked, when the ask happens, whether a TTY exists, and what a verdict
+ * MEANS (granted loads, refused is sticky, a cancel records nothing) is
+ * trust-ui.ts's and is untouched by this move. What the human READS is
+ * presentation, and presentation belongs to the terminal layer — the
+ * same reasoning that moved the status rows here in KC2 §5.
+ *
+ * Pure by construction: every function is (data) → bytes. No node
+ * builtins, no I/O, no clock — the package's zero-dependency promise is
+ * why the caller passes paths and counts in rather than having them
+ * looked up here.
+ */
+import type { PanelView } from "./approval-panel.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;
+ *  pipe bytes must not change.) */
+export declare function interactivePrompt(): string;
+/** E3 (ADR-0037) — one discovered project artifact: the relative path
+ *  and its content digest. Structural on purpose — the runtime's
+ *  ProjectArtifacts satisfies it without this package importing the
+ *  runtime (it imports nothing). */
+export interface TrustArtifact {
+    readonly path: string;
+    readonly digest: string;
+}
+/**
+ * E3 — the artifact listing: `<path>  (<digest6>)`, one row per file.
+ *
+ * The two callers differ by exactly the INDENT and nothing else: the
+ * scrollback record indents two (its rows sit under the root's own
+ * line), the panel's args do not (the block's frame supplies the
+ * inset). Before the move the two rows were written out separately, two
+ * template literals that had to agree by hand; the parameter keeps the
+ * one real difference visible while making the rest provably identical.
+ */
+export declare function projectTrustRows(files: readonly TrustArtifact[], indent?: string): string[];
+/** E3 — the trust gate's panel: the SIMPLE flavor (1 Yes / 3 No — no
+ *  "don't ask again" rule exists for a project), the root as the title,
+ *  the artifact listing as the always-verbose args, and the question as
+ *  the rule override. The same rows the scrollback records — the panel
+ *  is a bounded block, the record is not. */
+export declare function projectTrustView(root: string, files: readonly TrustArtifact[]): PanelView;
+/** E3 — the non-TTY note: artifacts were found and deliberately NOT
+ *  loaded, with the one path back (run once interactively). Printed to
+ *  stderr by the caller; never silent. */
+export declare function projectUntrustedNote(count: number, root: string): string;
+/** rounds 8/10 — the uncertain execution's panel: the SIMPLE flavor
+ *  again, with the options re-labelled in the rule line (1 rerun · 3
+ *  abandon). The tool name is escaped for the dock-less fallback
+ *  question because it reaches the terminal as raw text there; the
+ *  panel's own rows are escaped by the panel renderer. */
+export declare function uncertainView(name: string, executionId: string): PanelView;

package/dist/strings.js

@@ -0,0 +1,81 @@
+/**
+ * tui-cells — the human-facing STRINGS (KC3 slice 1, the ADR-0041
+ * escape hatch: extraction, never a raise): the readline prompt, the
+ * project-trust listing rows and its panel view, the uncertain
+ * execution's panel view, and the non-TTY not-trusted note. All five
+ * were built inline in the CLI's trust-ui.ts before the move.
+ *
+ * The split is the one the ADR names. The FLOW stays in the CLI: who is
+ * asked, when the ask happens, whether a TTY exists, and what a verdict
+ * MEANS (granted loads, refused is sticky, a cancel records nothing) is
+ * trust-ui.ts's and is untouched by this move. What the human READS is
+ * presentation, and presentation belongs to the terminal layer — the
+ * same reasoning that moved the status rows here in KC2 §5.
+ *
+ * Pure by construction: every function is (data) → bytes. No node
+ * builtins, no I/O, no clock — the package's zero-dependency promise is
+ * why the caller passes paths and counts in rather than having them
+ * looked up here.
+ */
+import { escapeTerminal, palette } from "./render.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;
+ *  pipe bytes must not change.) */
+export function interactivePrompt() {
+    const p = palette();
+    return `${p.bold}you> ${p.reset}`;
+}
+/**
+ * E3 — the artifact listing: `<path>  (<digest6>)`, one row per file.
+ *
+ * The two callers differ by exactly the INDENT and nothing else: the
+ * scrollback record indents two (its rows sit under the root's own
+ * line), the panel's args do not (the block's frame supplies the
+ * inset). Before the move the two rows were written out separately, two
+ * template literals that had to agree by hand; the parameter keeps the
+ * one real difference visible while making the rest provably identical.
+ */
+export function projectTrustRows(files, indent = "") {
+    return files.map((f) => `${indent}${f.path}  (${f.digest.slice(0, 6)})`);
+}
+/** E3 — the trust gate's panel: the SIMPLE flavor (1 Yes / 3 No — no
+ *  "don't ask again" rule exists for a project), the root as the title,
+ *  the artifact listing as the always-verbose args, and the question as
+ *  the rule override. The same rows the scrollback records — the panel
+ *  is a bounded block, the record is not. */
+export function projectTrustView(root, files) {
+    return {
+        flavor: "simple",
+        name: "project trust",
+        title: root,
+        speaker: "kiso",
+        statusText: "▸ project trust",
+        args: { kind: "text", lines: projectTrustRows(files) },
+        ruleOverride: "trust this project's .kiso?",
+        fallbackQuestion: `trust this project's .kiso? (y/n) `,
+    };
+}
+/** E3 — the non-TTY note: artifacts were found and deliberately NOT
+ *  loaded, with the one path back (run once interactively). Printed to
+ *  stderr by the caller; never silent. */
+export function projectUntrustedNote(count, root) {
+    return `[project .kiso] found ${count} artifact(s) in ${root} — not trusted, not loaded (run kiso interactively once to decide)`;
+}
+/** rounds 8/10 — the uncertain execution's panel: the SIMPLE flavor
+ *  again, with the options re-labelled in the rule line (1 rerun · 3
+ *  abandon). The tool name is escaped for the dock-less fallback
+ *  question because it reaches the terminal as raw text there; the
+ *  panel's own rows are escaped by the panel renderer. */
+export function uncertainView(name, executionId) {
+    return {
+        flavor: "simple",
+        name: "uncertain execution",
+        title: `${name} (${executionId})`,
+        speaker: "kiso",
+        statusText: "▸ uncertain execution",
+        args: { kind: "text", lines: [executionId] },
+        ruleOverride: "did the interrupted execution apply? — 1 rerun · 3 abandon",
+        fallbackQuestion: `⚠ interrupted execution: ${escapeTerminal(name)} (${executionId}) — did it apply? (y)es / (n)o `,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-tui-cells",
-  "version": "0.6.0",
+  "version": "0.7.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",
@@ -28,6 +28,10 @@
     "./render": {
       "types": "./dist/render.d.ts",
       "default": "./dist/render.js"
+    },
+    "./strings": {
+      "types": "./dist/strings.d.ts",
+      "default": "./dist/strings.js"
     }
   },
   "files": [