@dexto/tui 1.14.6 → 1.15.0-beta.1

package/dist/signal/harness.test.cjs

@@ -0,0 +1,84 @@
+"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_ink = require("ink");
+var import_chalk = __toESM(require("chalk"), 1);
+var import_vitest = require("vitest");
+var import_caps = require("./caps.js");
+var import_harness = require("./harness.js");
+var import_tone = require("./tone.js");
+function Teal() {
+  const tone = (0, import_tone.useTone)();
+  return (0, import_react.createElement)(import_ink.Text, { color: tone("teal") }, "hi");
+}
+(0, import_vitest.describe)("renderFrame", () => {
+  (0, import_vitest.it)("returns the frame as plain text on a terminal without colour", () => {
+    (0, import_vitest.expect)((0, import_harness.renderFrame)((0, import_react.createElement)(Teal), { columns: 40, terminal: "no-color" })).toBe("hi");
+  });
+  (0, import_vitest.it)("draws each terminal with its own palette, with escapes made visible", () => {
+    const frame = (terminal) => (0, import_harness.renderFrame)((0, import_react.createElement)(Teal), { columns: 40, terminal });
+    (0, import_vitest.expect)(frame("truecolor-dark")).toBe("\u241B[38;2;78;201;176mhi\u241B[39m");
+    (0, import_vitest.expect)(frame("truecolor-light")).toBe("\u241B[38;2;11;122;104mhi\u241B[39m");
+    (0, import_vitest.expect)(frame("256-dark")).toBe("\u241B[38;5;115mhi\u241B[39m");
+    (0, import_vitest.expect)(frame("16-dark")).toBe("\u241B[36mhi\u241B[39m");
+  });
+  (0, import_vitest.it)("wraps at the given width", () => {
+    const long = (0, import_react.createElement)(import_ink.Text, null, "aaaa bbbb");
+    (0, import_vitest.expect)((0, import_harness.renderFrame)(long, { columns: 5, terminal: "no-color" })).toBe("aaaa\nbbbb");
+  });
+  (0, import_vitest.it)("draws only the settled frame after an update on mount", () => {
+    function Settles() {
+      const [word, setWord] = (0, import_react.useState)("first");
+      (0, import_react.useLayoutEffect)(() => setWord("settled"), []);
+      return (0, import_react.createElement)(import_ink.Text, null, word);
+    }
+    (0, import_vitest.expect)((0, import_harness.renderFrame)((0, import_react.createElement)(Settles), { columns: 40, terminal: "no-color" })).toBe(
+      "settled"
+    );
+  });
+  (0, import_vitest.it)("returns an empty frame when an update on mount clears the screen", () => {
+    function Clears() {
+      const [shown, setShown] = (0, import_react.useState)(true);
+      (0, import_react.useLayoutEffect)(() => setShown(false), []);
+      return shown ? (0, import_react.createElement)(import_ink.Text, null, "first") : null;
+    }
+    (0, import_vitest.expect)((0, import_harness.renderFrame)((0, import_react.createElement)(Clears), { columns: 40, terminal: "no-color" })).toBe("");
+  });
+  (0, import_vitest.it)("puts the process-wide caps and chalk level back, even when rendering throws", () => {
+    const caps = (0, import_caps.getCaps)();
+    const level = import_chalk.default.level;
+    (0, import_harness.renderFrame)((0, import_react.createElement)(Teal), { columns: 40, terminal: "truecolor-light" });
+    (0, import_vitest.expect)((0, import_caps.getCaps)()).toBe(caps);
+    (0, import_vitest.expect)(import_chalk.default.level).toBe(level);
+    function Throws() {
+      throw new Error("boom");
+    }
+    try {
+      (0, import_harness.renderFrame)((0, import_react.createElement)(Throws), { columns: 40, terminal: "truecolor-light" });
+    } catch {
+    }
+    (0, import_vitest.expect)((0, import_caps.getCaps)()).toBe(caps);
+    (0, import_vitest.expect)(import_chalk.default.level).toBe(level);
+  });
+});

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

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

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

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

package/dist/signal/harness.test.js

@@ -0,0 +1,61 @@
+import { createElement, useLayoutEffect, useState } from "react";
+import { Text } from "ink";
+import chalk from "chalk";
+import { describe, expect, it } from "vitest";
+import { getCaps } from "./caps.js";
+import { renderFrame } from "./harness.js";
+import { useTone } from "./tone.js";
+function Teal() {
+  const tone = useTone();
+  return createElement(Text, { color: tone("teal") }, "hi");
+}
+describe("renderFrame", () => {
+  it("returns the frame as plain text on a terminal without colour", () => {
+    expect(renderFrame(createElement(Teal), { columns: 40, terminal: "no-color" })).toBe("hi");
+  });
+  it("draws each terminal with its own palette, with escapes made visible", () => {
+    const frame = (terminal) => renderFrame(createElement(Teal), { columns: 40, terminal });
+    expect(frame("truecolor-dark")).toBe("\u241B[38;2;78;201;176mhi\u241B[39m");
+    expect(frame("truecolor-light")).toBe("\u241B[38;2;11;122;104mhi\u241B[39m");
+    expect(frame("256-dark")).toBe("\u241B[38;5;115mhi\u241B[39m");
+    expect(frame("16-dark")).toBe("\u241B[36mhi\u241B[39m");
+  });
+  it("wraps at the given width", () => {
+    const long = createElement(Text, null, "aaaa bbbb");
+    expect(renderFrame(long, { columns: 5, terminal: "no-color" })).toBe("aaaa\nbbbb");
+  });
+  it("draws only the settled frame after an update on mount", () => {
+    function Settles() {
+      const [word, setWord] = useState("first");
+      useLayoutEffect(() => setWord("settled"), []);
+      return createElement(Text, null, word);
+    }
+    expect(renderFrame(createElement(Settles), { columns: 40, terminal: "no-color" })).toBe(
+      "settled"
+    );
+  });
+  it("returns an empty frame when an update on mount clears the screen", () => {
+    function Clears() {
+      const [shown, setShown] = useState(true);
+      useLayoutEffect(() => setShown(false), []);
+      return shown ? createElement(Text, null, "first") : null;
+    }
+    expect(renderFrame(createElement(Clears), { columns: 40, terminal: "no-color" })).toBe("");
+  });
+  it("puts the process-wide caps and chalk level back, even when rendering throws", () => {
+    const caps = getCaps();
+    const level = chalk.level;
+    renderFrame(createElement(Teal), { columns: 40, terminal: "truecolor-light" });
+    expect(getCaps()).toBe(caps);
+    expect(chalk.level).toBe(level);
+    function Throws() {
+      throw new Error("boom");
+    }
+    try {
+      renderFrame(createElement(Throws), { columns: 40, terminal: "truecolor-light" });
+    } catch {
+    }
+    expect(getCaps()).toBe(caps);
+    expect(chalk.level).toBe(level);
+  });
+});

package/dist/signal/index.cjs

@@ -0,0 +1,76 @@
+"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 signal_exports = {};
+__export(signal_exports, {
+  ActorRow: () => import_components.ActorRow,
+  CUT_ROWS: () => import_cut.CUT_ROWS,
+  CutText: () => import_components.CutText,
+  DECK_MODES: () => import_components.DECK_MODES,
+  Deck: () => import_components.Deck,
+  GateFrame: () => import_components.GateFrame,
+  StepRow: () => import_components.StepRow,
+  Wordmark: () => import_components.Wordmark,
+  actorMarginWidth: () => import_components.actorMarginWidth,
+  cutLines: () => import_cut.cutLines,
+  cutWidth: () => import_cut.cutWidth,
+  detectBackgroundTheme: () => import_background.detectBackgroundTheme,
+  detectCaps: () => import_caps.detectCaps,
+  getCaps: () => import_caps.getCaps,
+  glyphText: () => import_glyphs.glyphText,
+  markdownChalk: () => import_paint.markdownChalk,
+  paint: () => import_paint.paint,
+  resolveTone: () => import_tone.resolveTone,
+  setCaps: () => import_caps.setCaps,
+  tone: () => import_tone.tone,
+  useCaps: () => import_caps.useCaps,
+  useTone: () => import_tone.useTone
+});
+module.exports = __toCommonJS(signal_exports);
+var import_caps = require("./caps.js");
+var import_background = require("./background.js");
+var import_tone = require("./tone.js");
+var import_paint = require("./paint.js");
+var import_glyphs = require("./glyphs.js");
+var import_cut = require("./cut.js");
+var import_components = require("./components.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ActorRow,
+  CUT_ROWS,
+  CutText,
+  DECK_MODES,
+  Deck,
+  GateFrame,
+  StepRow,
+  Wordmark,
+  actorMarginWidth,
+  cutLines,
+  cutWidth,
+  detectBackgroundTheme,
+  detectCaps,
+  getCaps,
+  glyphText,
+  markdownChalk,
+  paint,
+  resolveTone,
+  setCaps,
+  tone,
+  useCaps,
+  useTone
+});

package/dist/signal/index.d.ts

@@ -0,0 +1,8 @@
+export { detectCaps, getCaps, setCaps, useCaps, type Caps, type ColorTier, type GlyphTier, type LogoTier, type Motion, type Palette, type ThemeName, } from './caps.js';
+export { detectBackgroundTheme } from './background.js';
+export { resolveTone, tone, useTone, type Role } from './tone.js';
+export { markdownChalk, paint } from './paint.js';
+export { glyphText } from './glyphs.js';
+export { CUT_ROWS, cutLines, cutWidth } from './cut.js';
+export { ActorRow, CutText, DECK_MODES, Deck, GateFrame, StepRow, Wordmark, actorMarginWidth, type ActorKind, type ActorRowProps, type CutTextProps, type DeckCredits, type DeckMode, type DeckProps, type DeckState, type DeckStatus, type DeckWhere, type GateFrameProps, type Step, type StepRowProps, type StepState, type WordmarkProps, } from './components.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/signal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EACV,OAAO,EACP,OAAO,EACP,OAAO,EACP,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,KAAK,SAAS,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EACH,QAAQ,EACR,OAAO,EACP,UAAU,EACV,IAAI,EACJ,SAAS,EACT,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/signal/index.js

@@ -0,0 +1,45 @@
+import {
+  detectCaps,
+  getCaps,
+  setCaps,
+  useCaps
+} from "./caps.js";
+import { detectBackgroundTheme } from "./background.js";
+import { resolveTone, tone, useTone } from "./tone.js";
+import { markdownChalk, paint } from "./paint.js";
+import { glyphText } from "./glyphs.js";
+import { CUT_ROWS, cutLines, cutWidth } from "./cut.js";
+import {
+  ActorRow,
+  CutText,
+  DECK_MODES,
+  Deck,
+  GateFrame,
+  StepRow,
+  Wordmark,
+  actorMarginWidth
+} from "./components.js";
+export {
+  ActorRow,
+  CUT_ROWS,
+  CutText,
+  DECK_MODES,
+  Deck,
+  GateFrame,
+  StepRow,
+  Wordmark,
+  actorMarginWidth,
+  cutLines,
+  cutWidth,
+  detectBackgroundTheme,
+  detectCaps,
+  getCaps,
+  glyphText,
+  markdownChalk,
+  paint,
+  resolveTone,
+  setCaps,
+  tone,
+  useCaps,
+  useTone
+};

package/dist/signal/kit.snapshot.test.cjs

@@ -0,0 +1,56 @@
+"use strict";
+var import_react = require("react");
+var import_ink = require("ink");
+var import_vitest = require("vitest");
+var import_components = require("./components.js");
+var import_harness = require("./harness.js");
+const STEP = {
+  state: "ok",
+  verb: "EDIT",
+  target: "packages/tui/src/signal/tone.ts",
+  detail: "+12 \u22123",
+  time: "0.4s",
+  cloud: false
+};
+const PARTS = {
+  "Wordmark rows=1": (0, import_react.createElement)(import_components.Wordmark, { rows: 1 }),
+  "Wordmark rows=4": (0, import_react.createElement)(import_components.Wordmark, { rows: 4 }),
+  CutText: (0, import_react.createElement)(import_components.CutText, { text: "usage" }),
+  "ActorRow agent": (0, import_react.createElement)(import_components.ActorRow, {
+    actor: "agent",
+    children: (0, import_react.createElement)(import_ink.Text, null, "Fixed the auth tests.")
+  }),
+  "ActorRow cloud": (0, import_react.createElement)(import_components.ActorRow, {
+    actor: "cloud",
+    label: "nightly",
+    children: (0, import_react.createElement)(import_ink.Text, null, "Running on a Dexto computer.")
+  }),
+  "StepRow ok": (0, import_react.createElement)(import_components.StepRow, { step: STEP }),
+  "StepRow fail": (0, import_react.createElement)(import_components.StepRow, { step: { ...STEP, state: "fail", detail: null } }),
+  "StepRow wait": (0, import_react.createElement)(import_components.StepRow, { step: { ...STEP, state: "wait", time: null } }),
+  "StepRow cloud": (0, import_react.createElement)(import_components.StepRow, { step: { ...STEP, cloud: true } }),
+  GateFrame: (0, import_react.createElement)(import_components.GateFrame, {
+    title: "NEEDS YOU \xB7 RUN A COMMAND",
+    hint: "\u23CE approve \xB7 esc deny",
+    children: (0, import_react.createElement)(import_ink.Text, null, "pnpm db:migrate --env staging")
+  })
+};
+(0, import_vitest.describe)("ActorRow margin", () => {
+  (0, import_vitest.it)("keeps a gap between a label that fills the margin and the text", () => {
+    const row = (0, import_react.createElement)(import_components.ActorRow, {
+      actor: "cloud",
+      label: "nightly",
+      children: (0, import_react.createElement)(import_ink.Text, null, "Running")
+    });
+    const out = (0, import_harness.renderFrame)(row, { columns: 100, terminal: "no-color" });
+    (0, import_vitest.expect)(out).toMatch(/^ \S+ Running$/);
+  });
+});
+import_vitest.describe.each(import_harness.TERMINAL_NAMES)("Signal kit on %s", (terminal) => {
+  import_vitest.describe.each([100, 40])("at %i columns", (columns) => {
+    import_vitest.it.each(Object.keys(PARTS))("%s", (name) => {
+      const part = PARTS[name];
+      (0, import_vitest.expect)((0, import_harness.renderFrame)(part, { columns, terminal })).toMatchSnapshot();
+    });
+  });
+});

package/dist/signal/kit.snapshot.test.d.ts

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

package/dist/signal/kit.snapshot.test.d.ts.map

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

package/dist/signal/kit.snapshot.test.js

@@ -0,0 +1,55 @@
+import { createElement } from "react";
+import { Text } from "ink";
+import { describe, expect, it } from "vitest";
+import { ActorRow, CutText, GateFrame, StepRow, Wordmark } from "./components.js";
+import { TERMINAL_NAMES, renderFrame } from "./harness.js";
+const STEP = {
+  state: "ok",
+  verb: "EDIT",
+  target: "packages/tui/src/signal/tone.ts",
+  detail: "+12 \u22123",
+  time: "0.4s",
+  cloud: false
+};
+const PARTS = {
+  "Wordmark rows=1": createElement(Wordmark, { rows: 1 }),
+  "Wordmark rows=4": createElement(Wordmark, { rows: 4 }),
+  CutText: createElement(CutText, { text: "usage" }),
+  "ActorRow agent": createElement(ActorRow, {
+    actor: "agent",
+    children: createElement(Text, null, "Fixed the auth tests.")
+  }),
+  "ActorRow cloud": createElement(ActorRow, {
+    actor: "cloud",
+    label: "nightly",
+    children: createElement(Text, null, "Running on a Dexto computer.")
+  }),
+  "StepRow ok": createElement(StepRow, { step: STEP }),
+  "StepRow fail": createElement(StepRow, { step: { ...STEP, state: "fail", detail: null } }),
+  "StepRow wait": createElement(StepRow, { step: { ...STEP, state: "wait", time: null } }),
+  "StepRow cloud": createElement(StepRow, { step: { ...STEP, cloud: true } }),
+  GateFrame: createElement(GateFrame, {
+    title: "NEEDS YOU \xB7 RUN A COMMAND",
+    hint: "\u23CE approve \xB7 esc deny",
+    children: createElement(Text, null, "pnpm db:migrate --env staging")
+  })
+};
+describe("ActorRow margin", () => {
+  it("keeps a gap between a label that fills the margin and the text", () => {
+    const row = createElement(ActorRow, {
+      actor: "cloud",
+      label: "nightly",
+      children: createElement(Text, null, "Running")
+    });
+    const out = renderFrame(row, { columns: 100, terminal: "no-color" });
+    expect(out).toMatch(/^ \S+ Running$/);
+  });
+});
+describe.each(TERMINAL_NAMES)("Signal kit on %s", (terminal) => {
+  describe.each([100, 40])("at %i columns", (columns) => {
+    it.each(Object.keys(PARTS))("%s", (name) => {
+      const part = PARTS[name];
+      expect(renderFrame(part, { columns, terminal })).toMatchSnapshot();
+    });
+  });
+});

package/dist/signal/no-raw-colours.test.cjs

@@ -0,0 +1,32 @@
+"use strict";
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+var import_node_url = require("node:url");
+var import_vitest = require("vitest");
+const import_meta = {};
+const SRC = (0, import_node_path.join)((0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(import_meta.url)), "..");
+const NAMES = "black|red|green|yellow|blue|magenta|cyan|white|gray|grey|blackBright|redBright|greenBright|yellowBright|blueBright|magentaBright|cyanBright|whiteBright";
+const RAW_PROP = new RegExp(`\\b\\w*[cC]olor=(["'])(${NAMES}|#[0-9a-fA-F]{3,8})\\1`);
+const RAW_VALUE = new RegExp(`(["'])(${NAMES}|#[0-9a-fA-F]{6})\\1`);
+const RAW_CHALK = new RegExp(`\\bchalk(\\.\\w+)*\\.(${NAMES}|rgb|hex|bgRgb|bgHex|ansi256)\\b`);
+function sourceFiles(dir) {
+  return (0, import_node_fs.readdirSync)(dir, { withFileTypes: true }).flatMap((entry) => {
+    const path = (0, import_node_path.join)(dir, entry.name);
+    if (entry.isDirectory()) return entry.name === "signal" ? [] : sourceFiles(path);
+    return /\.tsx?$/.test(entry.name) && !/\.test\.tsx?$/.test(entry.name) ? [path] : [];
+  });
+}
+(0, import_vitest.describe)("TUI colours", () => {
+  (0, import_vitest.it)("come from tone(role), not raw colour names or hex", () => {
+    const offenders = [];
+    for (const file of sourceFiles(SRC)) {
+      (0, import_node_fs.readFileSync)(file, "utf8").split("\n").forEach((line, i) => {
+        if (/^\s*(\/\/|\*)/.test(line)) return;
+        if (RAW_CHALK.test(line) || RAW_PROP.test(line) || RAW_VALUE.test(line.replace(/(tone|paint)\('\w+'\)/g, ""))) {
+          offenders.push(`${(0, import_node_path.relative)(SRC, file)}:${i + 1}: ${line.trim()}`);
+        }
+      });
+    }
+    (0, import_vitest.expect)(offenders).toEqual([]);
+  });
+});

package/dist/signal/no-raw-colours.test.d.ts

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

package/dist/signal/no-raw-colours.test.d.ts.map

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

package/dist/signal/no-raw-colours.test.js

@@ -0,0 +1,30 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+const SRC = join(dirname(fileURLToPath(import.meta.url)), "..");
+const NAMES = "black|red|green|yellow|blue|magenta|cyan|white|gray|grey|blackBright|redBright|greenBright|yellowBright|blueBright|magentaBright|cyanBright|whiteBright";
+const RAW_PROP = new RegExp(`\\b\\w*[cC]olor=(["'])(${NAMES}|#[0-9a-fA-F]{3,8})\\1`);
+const RAW_VALUE = new RegExp(`(["'])(${NAMES}|#[0-9a-fA-F]{6})\\1`);
+const RAW_CHALK = new RegExp(`\\bchalk(\\.\\w+)*\\.(${NAMES}|rgb|hex|bgRgb|bgHex|ansi256)\\b`);
+function sourceFiles(dir) {
+  return readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+    const path = join(dir, entry.name);
+    if (entry.isDirectory()) return entry.name === "signal" ? [] : sourceFiles(path);
+    return /\.tsx?$/.test(entry.name) && !/\.test\.tsx?$/.test(entry.name) ? [path] : [];
+  });
+}
+describe("TUI colours", () => {
+  it("come from tone(role), not raw colour names or hex", () => {
+    const offenders = [];
+    for (const file of sourceFiles(SRC)) {
+      readFileSync(file, "utf8").split("\n").forEach((line, i) => {
+        if (/^\s*(\/\/|\*)/.test(line)) return;
+        if (RAW_CHALK.test(line) || RAW_PROP.test(line) || RAW_VALUE.test(line.replace(/(tone|paint)\('\w+'\)/g, ""))) {
+          offenders.push(`${relative(SRC, file)}:${i + 1}: ${line.trim()}`);
+        }
+      });
+    }
+    expect(offenders).toEqual([]);
+  });
+});

package/dist/signal/paint.cjs

@@ -0,0 +1,76 @@
+"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 __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 __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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var paint_exports = {};
+__export(paint_exports, {
+  markdownChalk: () => markdownChalk,
+  paint: () => paint
+});
+module.exports = __toCommonJS(paint_exports);
+var import_chalk = __toESM(require("chalk"), 1);
+var import_caps = require("./caps.js");
+var import_tone = require("./tone.js");
+function isColorName(color) {
+  return import_chalk.foregroundColorNames.includes(color);
+}
+function chalkForTone(color) {
+  if (color.startsWith("#")) return import_chalk.default.hex(color);
+  return isColorName(color) ? import_chalk.default[color] : import_chalk.default;
+}
+function paint(role) {
+  return chalkForTone((0, import_tone.tone)(role));
+}
+function markdownChalk(color) {
+  if ((0, import_caps.getCaps)().palette === "signal" || color === "" || color.startsWith("#")) {
+    return chalkForTone(color);
+  }
+  switch (color) {
+    case "gray":
+      return import_chalk.default.gray;
+    case "blue":
+      return import_chalk.default.blue;
+    case "cyan":
+      return import_chalk.default.cyan;
+    case "green":
+      return import_chalk.default.green;
+    case "yellow":
+    case "orange":
+      return import_chalk.default.rgb(255, 165, 0);
+    case "red":
+      return import_chalk.default.red;
+    case "magenta":
+      return import_chalk.default.green;
+    default:
+      return import_chalk.default.white;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  markdownChalk,
+  paint
+});

package/dist/signal/paint.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `tone(role)` for text coloured with chalk rather than an Ink prop: the exit summary written
+ * straight to stdout, /help, and wrapped markdown.
+ */
+import { type ChalkInstance } from 'chalk';
+import { type Role } from './tone.js';
+/** The chalk for a role in this terminal. Reads caps on each call, so call it at draw time. */
+export declare function paint(role: Role): ChalkInstance;
+/**
+ * The chalk for wrapped markdown, given the Ink colour the same text has when unwrapped.
+ * Markdown has its own name mapping on the legacy palette, kept so nothing there changes.
+ * Removed when the Signal palette becomes the default.
+ */
+export declare function markdownChalk(color: string): ChalkInstance;
+//# sourceMappingURL=paint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/signal/paint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAc,EAAwB,KAAK,aAAa,EAA4B,MAAM,OAAO,CAAC;AAElG,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAY5C,+FAA+F;AAC/F,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAuB1D"}

package/dist/signal/paint.js

@@ -0,0 +1,41 @@
+import chalk, { foregroundColorNames } from "chalk";
+import { getCaps } from "./caps.js";
+import { tone } from "./tone.js";
+function isColorName(color) {
+  return foregroundColorNames.includes(color);
+}
+function chalkForTone(color) {
+  if (color.startsWith("#")) return chalk.hex(color);
+  return isColorName(color) ? chalk[color] : chalk;
+}
+function paint(role) {
+  return chalkForTone(tone(role));
+}
+function markdownChalk(color) {
+  if (getCaps().palette === "signal" || color === "" || color.startsWith("#")) {
+    return chalkForTone(color);
+  }
+  switch (color) {
+    case "gray":
+      return chalk.gray;
+    case "blue":
+      return chalk.blue;
+    case "cyan":
+      return chalk.cyan;
+    case "green":
+      return chalk.green;
+    case "yellow":
+    case "orange":
+      return chalk.rgb(255, 165, 0);
+    case "red":
+      return chalk.red;
+    case "magenta":
+      return chalk.green;
+    default:
+      return chalk.white;
+  }
+}
+export {
+  markdownChalk,
+  paint
+};