@dexto/tui 1.14.6 → 1.15.0-beta.1

package/dist/signal/components.test.cjs

@@ -0,0 +1,156 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_react = require("react");
+var import_node_stream = require("node:stream");
+var import_ink = require("ink");
+var import_strip_ansi = __toESM(require("strip-ansi"), 1);
+var import_vitest = require("vitest");
+var import_caps = require("./caps.js");
+var import_components = require("./components.js");
+var import_wordmark = require("./wordmark.js");
+function frame(element, columns) {
+  const stdout = Object.assign(new import_node_stream.PassThrough(), { columns, rows: 40, isTTY: false });
+  let output = "";
+  stdout.on("data", (chunk) => {
+    output += String(chunk);
+  });
+  const view = (0, import_ink.render)(element, {
+    stdout,
+    debug: true,
+    patchConsole: false,
+    exitOnCtrlC: false
+  });
+  view.unmount();
+  stdout.destroy();
+  return (0, import_strip_ansi.default)(output);
+}
+const step = {
+  state: "wait",
+  verb: "RUN",
+  target: "pnpm db:migrate --env staging",
+  detail: "+12 \u22123",
+  time: "0.4s",
+  cloud: false
+};
+(0, import_vitest.describe)("Signal kit parts", () => {
+  let saved;
+  (0, import_vitest.beforeEach)(() => {
+    saved = (0, import_caps.getCaps)();
+    (0, import_caps.setCaps)({ ...saved, color: "none", glyphs: "unicode", logo: "quadrant" });
+  });
+  (0, import_vitest.afterEach)(() => (0, import_caps.setCaps)(saved));
+  (0, import_vitest.it)("Wordmark draws the logo art that fits the rows", () => {
+    const out = frame((0, import_react.createElement)(import_components.Wordmark, { rows: 3 }), 80);
+    for (const line of (0, import_wordmark.pickWordmark)("quadrant", 3).text) (0, import_vitest.expect)(out).toContain(line.trimEnd());
+  });
+  (0, import_vitest.it)("Wordmark draws the ASCII art on terminals without UTF-8", () => {
+    (0, import_caps.setCaps)({ ...(0, import_caps.getCaps)(), glyphs: "ascii" });
+    const out = frame((0, import_react.createElement)(import_components.Wordmark, { rows: 4 }), 80);
+    for (const line of (0, import_wordmark.pickWordmark)("ascii", 4).text) (0, import_vitest.expect)(out).toContain(line.trimEnd());
+  });
+  (0, import_vitest.it)("CutText draws three rows of half blocks, or the plain word in ASCII", () => {
+    (0, import_vitest.expect)(frame((0, import_react.createElement)(import_components.CutText, { text: "de" }), 80)).toContain("\u2580\u2580\u2580\u2580\u2584 \u2580\u2580\u2580\u2580\u2580");
+    (0, import_caps.setCaps)({ ...(0, import_caps.getCaps)(), glyphs: "ascii" });
+    (0, import_vitest.expect)(frame((0, import_react.createElement)(import_components.CutText, { text: "usage" }), 80)).toContain("USAGE");
+  });
+  (0, import_vitest.it)("StepRow lays out verb, target, detail, time and the state word", () => {
+    const out = frame((0, import_react.createElement)(import_components.StepRow, { step }), 100);
+    (0, import_vitest.expect)(out).toMatch(/▸ RUN\s+pnpm db:migrate --env staging\s+\+12 −3 0\.4s\s+NEEDS YOU/);
+  });
+  (0, import_vitest.it)("StepRow draws ASCII glyphs on terminals without UTF-8", () => {
+    (0, import_caps.setCaps)({ ...(0, import_caps.getCaps)(), glyphs: "ascii" });
+    const out = frame((0, import_react.createElement)(import_components.StepRow, { step: { ...step, state: "ok" } }), 100);
+    (0, import_vitest.expect)(out).toMatch(/^\* RUN\s+pnpm db:migrate --env staging\s+\+12 -3 0\.4s/m);
+    (0, import_vitest.expect)(out).not.toMatch(/[▪▸▫◆−]/);
+  });
+  (0, import_vitest.it)("re-renders mounted parts when caps change", async () => {
+    const stdout = Object.assign(new import_node_stream.PassThrough(), { columns: 100, rows: 40, isTTY: false });
+    let output = "";
+    stdout.on("data", (chunk) => {
+      output += String(chunk);
+    });
+    const view = (0, import_ink.render)((0, import_react.createElement)(import_components.StepRow, { step }), {
+      stdout,
+      debug: true,
+      patchConsole: false,
+      exitOnCtrlC: false
+    });
+    try {
+      (0, import_vitest.expect)((0, import_strip_ansi.default)(output)).toContain("\u25B8 RUN");
+      (0, import_caps.setCaps)({ ...(0, import_caps.getCaps)(), glyphs: "ascii" });
+      await import_vitest.vi.waitFor(() => (0, import_vitest.expect)((0, import_strip_ansi.default)(output)).toContain("> RUN"));
+    } finally {
+      view.unmount();
+      stdout.destroy();
+    }
+  });
+  (0, import_vitest.it)("ActorRow puts the actor in the margin, or a glyph when narrow", () => {
+    const child = (0, import_react.createElement)(import_ink.Text, null, "hello");
+    (0, import_vitest.expect)(frame((0, import_react.createElement)(import_components.ActorRow, { actor: "agent", children: child }), 80)).toMatch(
+      / AGENT\s+hello/
+    );
+    (0, import_vitest.expect)(frame((0, import_react.createElement)(import_components.ActorRow, { actor: "you", children: child }), 40)).toMatch(
+      /› hello/
+    );
+  });
+  (0, import_vitest.it)("GateFrame shows its title, body and hint", () => {
+    const out = frame(
+      (0, import_react.createElement)(import_components.GateFrame, {
+        title: "NEEDS YOU \xB7 RUN A COMMAND",
+        hint: "y once \xB7 n deny",
+        children: (0, import_react.createElement)(import_ink.Text, null, "$ pnpm db:migrate")
+      }),
+      80
+    );
+    (0, import_vitest.expect)(out).toContain("NEEDS YOU \xB7 RUN A COMMAND");
+    (0, import_vitest.expect)(out).toContain("$ pnpm db:migrate");
+    (0, import_vitest.expect)(out).toContain("y once \xB7 n deny");
+  });
+  (0, import_vitest.it)("Deck shows the mode, the gate, then the input", () => {
+    const out = frame(
+      (0, import_react.createElement)(import_components.Deck, {
+        collapsed: false,
+        paused: false,
+        state: {
+          mode: "wait",
+          readout: "paused 0:14",
+          status: {
+            model: "dexto/sonnet-5.5",
+            contextUsedTokens: 46e3,
+            contextMaxTokens: 2e5,
+            where: { kind: "local" },
+            branch: "main",
+            dirtyFiles: 3,
+            credits: { kind: "balance", balance: 1284, spend: null }
+          }
+        },
+        gate: (0, import_react.createElement)(import_ink.Text, null, "GATE"),
+        children: (0, import_react.createElement)(import_ink.Text, null, "\u203A input")
+      }),
+      100
+    );
+    (0, import_vitest.expect)(out).toContain("NEEDS YOU \xB7 paused 0:14");
+    (0, import_vitest.expect)(out.indexOf("GATE")).toBeLessThan(out.indexOf("\u203A input"));
+  });
+});

package/dist/signal/components.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=components.test.d.ts.map

package/dist/signal/components.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.test.d.ts","sourceRoot":"","sources":["../../src/signal/components.test.ts"],"names":[],"mappings":""}

package/dist/signal/components.test.js

@@ -0,0 +1,133 @@
+import { createElement } from "react";
+import { PassThrough } from "node:stream";
+import { render, Text } from "ink";
+import stripAnsi from "strip-ansi";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getCaps, setCaps } from "./caps.js";
+import { ActorRow, CutText, Deck, GateFrame, StepRow, Wordmark } from "./components.js";
+import { pickWordmark } from "./wordmark.js";
+function frame(element, columns) {
+  const stdout = Object.assign(new PassThrough(), { columns, rows: 40, isTTY: false });
+  let output = "";
+  stdout.on("data", (chunk) => {
+    output += String(chunk);
+  });
+  const view = render(element, {
+    stdout,
+    debug: true,
+    patchConsole: false,
+    exitOnCtrlC: false
+  });
+  view.unmount();
+  stdout.destroy();
+  return stripAnsi(output);
+}
+const step = {
+  state: "wait",
+  verb: "RUN",
+  target: "pnpm db:migrate --env staging",
+  detail: "+12 \u22123",
+  time: "0.4s",
+  cloud: false
+};
+describe("Signal kit parts", () => {
+  let saved;
+  beforeEach(() => {
+    saved = getCaps();
+    setCaps({ ...saved, color: "none", glyphs: "unicode", logo: "quadrant" });
+  });
+  afterEach(() => setCaps(saved));
+  it("Wordmark draws the logo art that fits the rows", () => {
+    const out = frame(createElement(Wordmark, { rows: 3 }), 80);
+    for (const line of pickWordmark("quadrant", 3).text) expect(out).toContain(line.trimEnd());
+  });
+  it("Wordmark draws the ASCII art on terminals without UTF-8", () => {
+    setCaps({ ...getCaps(), glyphs: "ascii" });
+    const out = frame(createElement(Wordmark, { rows: 4 }), 80);
+    for (const line of pickWordmark("ascii", 4).text) expect(out).toContain(line.trimEnd());
+  });
+  it("CutText draws three rows of half blocks, or the plain word in ASCII", () => {
+    expect(frame(createElement(CutText, { text: "de" }), 80)).toContain("\u2580\u2580\u2580\u2580\u2584 \u2580\u2580\u2580\u2580\u2580");
+    setCaps({ ...getCaps(), glyphs: "ascii" });
+    expect(frame(createElement(CutText, { text: "usage" }), 80)).toContain("USAGE");
+  });
+  it("StepRow lays out verb, target, detail, time and the state word", () => {
+    const out = frame(createElement(StepRow, { step }), 100);
+    expect(out).toMatch(/▸ RUN\s+pnpm db:migrate --env staging\s+\+12 −3 0\.4s\s+NEEDS YOU/);
+  });
+  it("StepRow draws ASCII glyphs on terminals without UTF-8", () => {
+    setCaps({ ...getCaps(), glyphs: "ascii" });
+    const out = frame(createElement(StepRow, { step: { ...step, state: "ok" } }), 100);
+    expect(out).toMatch(/^\* RUN\s+pnpm db:migrate --env staging\s+\+12 -3 0\.4s/m);
+    expect(out).not.toMatch(/[▪▸▫◆−]/);
+  });
+  it("re-renders mounted parts when caps change", async () => {
+    const stdout = Object.assign(new PassThrough(), { columns: 100, rows: 40, isTTY: false });
+    let output = "";
+    stdout.on("data", (chunk) => {
+      output += String(chunk);
+    });
+    const view = render(createElement(StepRow, { step }), {
+      stdout,
+      debug: true,
+      patchConsole: false,
+      exitOnCtrlC: false
+    });
+    try {
+      expect(stripAnsi(output)).toContain("\u25B8 RUN");
+      setCaps({ ...getCaps(), glyphs: "ascii" });
+      await vi.waitFor(() => expect(stripAnsi(output)).toContain("> RUN"));
+    } finally {
+      view.unmount();
+      stdout.destroy();
+    }
+  });
+  it("ActorRow puts the actor in the margin, or a glyph when narrow", () => {
+    const child = createElement(Text, null, "hello");
+    expect(frame(createElement(ActorRow, { actor: "agent", children: child }), 80)).toMatch(
+      / AGENT\s+hello/
+    );
+    expect(frame(createElement(ActorRow, { actor: "you", children: child }), 40)).toMatch(
+      /› hello/
+    );
+  });
+  it("GateFrame shows its title, body and hint", () => {
+    const out = frame(
+      createElement(GateFrame, {
+        title: "NEEDS YOU \xB7 RUN A COMMAND",
+        hint: "y once \xB7 n deny",
+        children: createElement(Text, null, "$ pnpm db:migrate")
+      }),
+      80
+    );
+    expect(out).toContain("NEEDS YOU \xB7 RUN A COMMAND");
+    expect(out).toContain("$ pnpm db:migrate");
+    expect(out).toContain("y once \xB7 n deny");
+  });
+  it("Deck shows the mode, the gate, then the input", () => {
+    const out = frame(
+      createElement(Deck, {
+        collapsed: false,
+        paused: false,
+        state: {
+          mode: "wait",
+          readout: "paused 0:14",
+          status: {
+            model: "dexto/sonnet-5.5",
+            contextUsedTokens: 46e3,
+            contextMaxTokens: 2e5,
+            where: { kind: "local" },
+            branch: "main",
+            dirtyFiles: 3,
+            credits: { kind: "balance", balance: 1284, spend: null }
+          }
+        },
+        gate: createElement(Text, null, "GATE"),
+        children: createElement(Text, null, "\u203A input")
+      }),
+      100
+    );
+    expect(out).toContain("NEEDS YOU \xB7 paused 0:14");
+    expect(out.indexOf("GATE")).toBeLessThan(out.indexOf("\u203A input"));
+  });
+});

package/dist/signal/cut.cjs

@@ -0,0 +1,103 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cut_exports = {};
+__export(cut_exports, {
+  CUT_ROWS: () => CUT_ROWS,
+  cutLines: () => cutLines,
+  cutWidth: () => cutWidth
+});
+module.exports = __toCommonJS(cut_exports);
+const CUT = {
+  A: [".###.", "#...#", "#.###", "#...#", "#...#"],
+  B: ["####.", "#...#", "####.", "#...#", "####."],
+  C: [".####", "#....", "#....", "#....", ".####"],
+  D: ["####.", "....#", "....#", "....#", "####."],
+  E: ["#####", ".....", "####.", ".....", "#####"],
+  F: ["#####", ".....", "####.", "#....", "#...."],
+  G: [".####", "#....", "#..##", "#...#", ".####"],
+  H: ["#...#", "#...#", "##.##", "#...#", "#...#"],
+  I: ["###", "...", ".#.", ".#.", "###"],
+  J: ["....#", "....#", "....#", "#...#", ".###."],
+  K: ["#...#", "#..#.", "###..", "#..#.", "#...#"],
+  L: ["#....", "#....", "#....", ".....", "#####"],
+  M: ["#...#", "##.##", "#.#.#", "#...#", "#...#"],
+  N: ["#...#", "##..#", "#.#.#", "#..##", "#...#"],
+  O: ["##.##", "#...#", "#...#", "#...#", "##.##"],
+  P: ["####.", "....#", "####.", "#....", "#...."],
+  Q: [".###.", "#...#", "#...#", "#..#.", ".##.#"],
+  R: ["####.", "....#", "####.", "#..#.", "#...#"],
+  S: [".####", "#....", ".###.", "....#", "####."],
+  T: ["#####", ".....", "..#..", "..#..", "..#.."],
+  U: ["#...#", "#...#", "#...#", "#...#", ".###."],
+  V: ["#...#", "#...#", "#...#", ".#.#.", "..#.."],
+  W: ["#...#", "#...#", "#.#.#", "##.##", "#...#"],
+  X: ["#...#", ".#.#.", "..#..", ".#...", "#...#"],
+  Y: ["#...#", ".#.#.", "..#..", "..#..", "..#.."],
+  Z: ["#####", "...#.", "..#..", ".#...", "#####"],
+  "0": ["##.##", "#...#", "#.#.#", "#...#", "##.##"],
+  "1": [".##.", "..#.", "..#.", "..#.", ".###"],
+  "2": ["####.", "....#", ".###.", "#....", "#####"],
+  "3": ["####.", "....#", ".###.", "....#", "####."],
+  "4": ["#...#", "#...#", ".####", "....#", "....#"],
+  "5": ["#####", "#....", "####.", "....#", "####."],
+  "6": [".###.", "#....", "####.", "#...#", ".###."],
+  "7": ["#####", "....#", "...#.", "..#..", "..#.."],
+  "8": [".###.", "#...#", ".###.", "#...#", ".###."],
+  "9": [".###.", "#...#", ".####", "....#", ".###."],
+  " ": ["..", "..", "..", "..", ".."],
+  ",": ["..", "..", "..", ".#", "#."],
+  ".": [".", ".", ".", ".", "#"],
+  ":": [".", "#", ".", "#", "."],
+  "-": ["...", "...", "###", "...", "..."],
+  "/": ["....#", "...#.", "..#..", ".#...", "#...."],
+  "%": ["#..#", "..#.", ".#..", "#..#", "...."],
+  $: [".####", "#.#..", ".###.", "..#.#", "####."]
+};
+const CUT_ROWS = 3;
+function glyphFor(ch) {
+  return CUT[ch] ?? CUT[" "] ?? [];
+}
+function cutWidth(text) {
+  const chars = [...text.toUpperCase()];
+  if (chars.length === 0) return 0;
+  return chars.reduce((w, ch) => w + (glyphFor(ch)[0]?.length ?? 0) + 1, -1);
+}
+function cutLines(text) {
+  const lines = ["", "", ""];
+  [...text.toUpperCase()].forEach((ch, i) => {
+    const g = glyphFor(ch);
+    const gw = g[0]?.length ?? 0;
+    for (let r = 0; r < CUT_ROWS; r++) {
+      let row = i === 0 ? "" : " ";
+      for (let c = 0; c < gw; c++) {
+        const top = g[r * 2]?.[c] === "#";
+        const bottom = g[r * 2 + 1]?.[c] === "#";
+        row += top && bottom ? "\u2588" : top ? "\u2580" : bottom ? "\u2584" : " ";
+      }
+      lines[r] += row;
+    }
+  });
+  return lines;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CUT_ROWS,
+  cutLines,
+  cutWidth
+});

package/dist/signal/cut.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cut type: the display face. 5-pixel glyphs drawn with half blocks over 3 rows. The letters
+ * follow the wordmark and never join: open-left D, stemless E, floating T stem, split O.
+ */
+/** Rows of cut type, always 3 tall. */
+export declare const CUT_ROWS = 3;
+/** Cell width of `text` in cut type: glyphs plus one blank column between them. */
+export declare function cutWidth(text: string): number;
+/** The 3 text lines that draw `text` in cut type (half blocks, trailing spaces kept). */
+export declare function cutLines(text: string): string[];
+//# sourceMappingURL=cut.d.ts.map

package/dist/signal/cut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut.d.ts","sourceRoot":"","sources":["../../src/signal/cut.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiDH,uCAAuC;AACvC,eAAO,MAAM,QAAQ,IAAI,CAAC;AAM1B,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB/C"}

package/dist/signal/cut.js

@@ -0,0 +1,77 @@
+const CUT = {
+  A: [".###.", "#...#", "#.###", "#...#", "#...#"],
+  B: ["####.", "#...#", "####.", "#...#", "####."],
+  C: [".####", "#....", "#....", "#....", ".####"],
+  D: ["####.", "....#", "....#", "....#", "####."],
+  E: ["#####", ".....", "####.", ".....", "#####"],
+  F: ["#####", ".....", "####.", "#....", "#...."],
+  G: [".####", "#....", "#..##", "#...#", ".####"],
+  H: ["#...#", "#...#", "##.##", "#...#", "#...#"],
+  I: ["###", "...", ".#.", ".#.", "###"],
+  J: ["....#", "....#", "....#", "#...#", ".###."],
+  K: ["#...#", "#..#.", "###..", "#..#.", "#...#"],
+  L: ["#....", "#....", "#....", ".....", "#####"],
+  M: ["#...#", "##.##", "#.#.#", "#...#", "#...#"],
+  N: ["#...#", "##..#", "#.#.#", "#..##", "#...#"],
+  O: ["##.##", "#...#", "#...#", "#...#", "##.##"],
+  P: ["####.", "....#", "####.", "#....", "#...."],
+  Q: [".###.", "#...#", "#...#", "#..#.", ".##.#"],
+  R: ["####.", "....#", "####.", "#..#.", "#...#"],
+  S: [".####", "#....", ".###.", "....#", "####."],
+  T: ["#####", ".....", "..#..", "..#..", "..#.."],
+  U: ["#...#", "#...#", "#...#", "#...#", ".###."],
+  V: ["#...#", "#...#", "#...#", ".#.#.", "..#.."],
+  W: ["#...#", "#...#", "#.#.#", "##.##", "#...#"],
+  X: ["#...#", ".#.#.", "..#..", ".#...", "#...#"],
+  Y: ["#...#", ".#.#.", "..#..", "..#..", "..#.."],
+  Z: ["#####", "...#.", "..#..", ".#...", "#####"],
+  "0": ["##.##", "#...#", "#.#.#", "#...#", "##.##"],
+  "1": [".##.", "..#.", "..#.", "..#.", ".###"],
+  "2": ["####.", "....#", ".###.", "#....", "#####"],
+  "3": ["####.", "....#", ".###.", "....#", "####."],
+  "4": ["#...#", "#...#", ".####", "....#", "....#"],
+  "5": ["#####", "#....", "####.", "....#", "####."],
+  "6": [".###.", "#....", "####.", "#...#", ".###."],
+  "7": ["#####", "....#", "...#.", "..#..", "..#.."],
+  "8": [".###.", "#...#", ".###.", "#...#", ".###."],
+  "9": [".###.", "#...#", ".####", "....#", ".###."],
+  " ": ["..", "..", "..", "..", ".."],
+  ",": ["..", "..", "..", ".#", "#."],
+  ".": [".", ".", ".", ".", "#"],
+  ":": [".", "#", ".", "#", "."],
+  "-": ["...", "...", "###", "...", "..."],
+  "/": ["....#", "...#.", "..#..", ".#...", "#...."],
+  "%": ["#..#", "..#.", ".#..", "#..#", "...."],
+  $: [".####", "#.#..", ".###.", "..#.#", "####."]
+};
+const CUT_ROWS = 3;
+function glyphFor(ch) {
+  return CUT[ch] ?? CUT[" "] ?? [];
+}
+function cutWidth(text) {
+  const chars = [...text.toUpperCase()];
+  if (chars.length === 0) return 0;
+  return chars.reduce((w, ch) => w + (glyphFor(ch)[0]?.length ?? 0) + 1, -1);
+}
+function cutLines(text) {
+  const lines = ["", "", ""];
+  [...text.toUpperCase()].forEach((ch, i) => {
+    const g = glyphFor(ch);
+    const gw = g[0]?.length ?? 0;
+    for (let r = 0; r < CUT_ROWS; r++) {
+      let row = i === 0 ? "" : " ";
+      for (let c = 0; c < gw; c++) {
+        const top = g[r * 2]?.[c] === "#";
+        const bottom = g[r * 2 + 1]?.[c] === "#";
+        row += top && bottom ? "\u2588" : top ? "\u2580" : bottom ? "\u2584" : " ";
+      }
+      lines[r] += row;
+    }
+  });
+  return lines;
+}
+export {
+  CUT_ROWS,
+  cutLines,
+  cutWidth
+};

package/dist/signal/cut.test.cjs

@@ -0,0 +1,20 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_cut = require("./cut.js");
+(0, import_vitest.describe)("cut type", () => {
+  (0, import_vitest.it)("draws three rows as wide as cutWidth says", () => {
+    const lines = (0, import_cut.cutLines)("Usage 42%");
+    (0, import_vitest.expect)(lines).toHaveLength(3);
+    for (const line of lines) (0, import_vitest.expect)([...line]).toHaveLength((0, import_cut.cutWidth)("Usage 42%"));
+  });
+  (0, import_vitest.it)("keeps the wordmark cuts: open-left D, stemless E", () => {
+    (0, import_vitest.expect)((0, import_cut.cutLines)("DE")).toEqual(["\u2580\u2580\u2580\u2580\u2584 \u2580\u2580\u2580\u2580\u2580", "    \u2588 \u2580\u2580\u2580\u2580 ", "\u2580\u2580\u2580\u2580  \u2580\u2580\u2580\u2580\u2580"]);
+  });
+  (0, import_vitest.it)("draws unknown characters as a space", () => {
+    (0, import_vitest.expect)((0, import_cut.cutWidth)("~")).toBe((0, import_cut.cutWidth)(" "));
+  });
+  (0, import_vitest.it)("is empty for empty text", () => {
+    (0, import_vitest.expect)((0, import_cut.cutWidth)("")).toBe(0);
+    (0, import_vitest.expect)((0, import_cut.cutLines)("")).toEqual(["", "", ""]);
+  });
+});

package/dist/signal/cut.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cut.test.d.ts.map

package/dist/signal/cut.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut.test.d.ts","sourceRoot":"","sources":["../../src/signal/cut.test.ts"],"names":[],"mappings":""}

package/dist/signal/cut.test.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vitest";
+import { cutLines, cutWidth } from "./cut.js";
+describe("cut type", () => {
+  it("draws three rows as wide as cutWidth says", () => {
+    const lines = cutLines("Usage 42%");
+    expect(lines).toHaveLength(3);
+    for (const line of lines) expect([...line]).toHaveLength(cutWidth("Usage 42%"));
+  });
+  it("keeps the wordmark cuts: open-left D, stemless E", () => {
+    expect(cutLines("DE")).toEqual(["\u2580\u2580\u2580\u2580\u2584 \u2580\u2580\u2580\u2580\u2580", "    \u2588 \u2580\u2580\u2580\u2580 ", "\u2580\u2580\u2580\u2580  \u2580\u2580\u2580\u2580\u2580"]);
+  });
+  it("draws unknown characters as a space", () => {
+    expect(cutWidth("~")).toBe(cutWidth(" "));
+  });
+  it("is empty for empty text", () => {
+    expect(cutWidth("")).toBe(0);
+    expect(cutLines("")).toEqual(["", "", ""]);
+  });
+});

package/dist/signal/deck-layout.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var deck_layout_exports = {};
+__export(deck_layout_exports, {
+  MID_READOUT_COLUMNS: () => MID_READOUT_COLUMNS,
+  WIDE_COLUMNS: () => WIDE_COLUMNS,
+  deckLayout: () => deckLayout,
+  formatTokens: () => formatTokens
+});
+module.exports = __toCommonJS(deck_layout_exports);
+const WIDE_COLUMNS = 100;
+const MID_READOUT_COLUMNS = 24;
+function deckLayout(columns, wordmarkColumns) {
+  if (columns >= WIDE_COLUMNS) {
+    return {
+      band: "wide",
+      bandRows: 3,
+      statusRow: false,
+      blockWidth: Math.min(36, Math.max(30, Math.floor(columns * 0.26)))
+    };
+  }
+  if (columns >= wordmarkColumns + MID_READOUT_COLUMNS) {
+    return { band: "mid", bandRows: 3, statusRow: true, blockWidth: 0 };
+  }
+  return { band: "bare", bandRows: 2, statusRow: true, blockWidth: 0 };
+}
+function formatTokens(tokens) {
+  if (tokens >= 1e6) return `${trimZero((tokens / 1e6).toFixed(1))}M`;
+  if (tokens >= 1e3) return `${Math.round(tokens / 1e3)}k`;
+  return String(tokens);
+}
+function trimZero(value) {
+  return value.endsWith(".0") ? value.slice(0, -2) : value;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MID_READOUT_COLUMNS,
+  WIDE_COLUMNS,
+  deckLayout,
+  formatTokens
+});

package/dist/signal/deck-layout.d.ts

@@ -0,0 +1,29 @@
+/**
+ * How the deck steps down with width. Under 3 rows the wordmark stops being legible, so the
+ * narrowest step drops it and keeps the trace.
+ *
+ *   ≥100 cols  wide  band with the status block on its right, then input      = 4 rows
+ *   mid        band (wordmark, trace, mode · readout), input, status row      = 5 rows
+ *   bare       trace only, input, status row led by the readout               = 4 rows
+ *
+ * The middle step needs room for the mode and readout beside the wordmark (39 columns for the
+ * 3-row quadrant drawing, so from 66 columns); narrower than that the deck goes bare.
+ */
+export type DeckBand = 'wide' | 'mid' | 'bare';
+export interface DeckLayout {
+    band: DeckBand;
+    /** Rows the band takes above the gate and input. */
+    bandRows: 2 | 3;
+    /** Whether the status sits in its own row under the input. */
+    statusRow: boolean;
+    /** Width of the status block beside the trace; 0 when there is none. */
+    blockWidth: number;
+}
+export declare const WIDE_COLUMNS = 100;
+/** Columns the mode and readout need beside the wordmark in the middle step. */
+export declare const MID_READOUT_COLUMNS = 24;
+/** `wordmarkColumns`: the 3-row wordmark's width plus its margins. */
+export declare function deckLayout(columns: number, wordmarkColumns: number): DeckLayout;
+/** 46k, 1.2M, 850. */
+export declare function formatTokens(tokens: number): string;
+//# sourceMappingURL=deck-layout.d.ts.map

package/dist/signal/deck-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck-layout.d.ts","sourceRoot":"","sources":["../../src/signal/deck-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,oDAAoD;IACpD,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAa/E;AAED,sBAAsB;AACtB,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAInD"}