@dexto/tui 1.15.0-beta.0 → 1.15.0-beta.1

package/dist/signal/trace.cjs

@@ -0,0 +1,142 @@
+"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 trace_exports = {};
+__export(trace_exports, {
+  TRACE_ROLE: () => TRACE_ROLE,
+  fadeColor: () => fadeColor,
+  isQuiet: () => isQuiet,
+  pushSample: () => pushSample,
+  traceKind: () => traceKind,
+  traceRows: () => traceRows
+});
+module.exports = __toCommonJS(trace_exports);
+const MODE_KIND = {
+  idle: "idle",
+  think: "think",
+  stream: "stream",
+  tool: "tool",
+  cloud: "cloud",
+  wait: "wait",
+  fault: "fault",
+  stop: "stop",
+  steer: "tool",
+  offline: "idle",
+  handoff: "cloud",
+  attached: "cloud",
+  done: "idle"
+};
+const TRACE_ROLE = {
+  idle: "tealDim",
+  think: "teal",
+  stream: "teal",
+  tool: "teal",
+  cloud: "cloud",
+  wait: "amber",
+  fault: "red",
+  stop: "dim",
+  flat: "faint"
+};
+const QUIET = /* @__PURE__ */ new Set(["idle", "wait", "stop", "flat"]);
+function traceKind(mode) {
+  return MODE_KIND[mode];
+}
+function isQuiet(kind) {
+  return QUIET.has(kind);
+}
+function rnd(i) {
+  const v = Math.sin(i * 127.1 + 311.7) * 43758.5453;
+  return v - Math.floor(v);
+}
+function amplitude(kind, k, p) {
+  switch (kind) {
+    case "idle":
+      return 0.04 + 0.05 * (0.5 + 0.5 * Math.sin(p / 14));
+    case "think":
+      return 0.18 + 0.22 * (0.5 + 0.5 * Math.sin(p / 6)) * (0.6 + 0.4 * Math.sin(p / 19));
+    case "stream":
+      return 0.16 + 0.5 * rnd(p) ** 1.7 * (0.65 + 0.35 * Math.sin(p / 7));
+    case "tool": {
+      const gap = 3 + Math.floor(rnd(Math.floor((p + 3) / 7)) * 5);
+      return p % gap === 0 ? 0.6 + 0.4 * rnd(p) : p % gap === 1 ? 0.3 : 0.06;
+    }
+    case "cloud":
+      return 0.3 + 0.45 * Math.abs(Math.sin(p / 4.5)) * (0.6 + 0.4 * rnd(Math.floor(p / 8)));
+    case "fault":
+      return k % 9 < 2 ? 1 : 0.15 + 0.6 * rnd(p) ** 2;
+    case "stop":
+      return 0.02;
+    case "wait":
+    case "flat":
+      return 0;
+  }
+}
+function pushSample(history, kind, tick, max) {
+  let run = 0;
+  while (run < history.length && history[run]?.kind === kind) run++;
+  const ramp = kind === "tool" || kind === "fault" ? 1 : Math.min(1, (run + 1) / 6);
+  const amp = Math.max(0, Math.min(1, amplitude(kind, run, tick) * ramp));
+  return [{ kind, amp }, ...history.slice(0, Math.max(0, max - 1))];
+}
+const EIGHTHS = [" ", "\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
+function traceRows(history, width, height) {
+  const half = Math.max(1, Math.floor(height / 2));
+  const levels = half * 8;
+  const fadeFrom = Math.floor(width * 0.35);
+  const rows = Array.from({ length: half * 2 }, () => []);
+  for (let c = 0; c < width; c++) {
+    const sample = history[c] ?? { kind: "flat", amp: 0 };
+    const fade = Math.max(0, (c - fadeFrom) / Math.max(1, width - fadeFrom)) * 0.78;
+    const up = Math.max(1, Math.round(sample.amp * levels));
+    const down = Math.round(sample.amp * levels * 0.92);
+    for (let r = 0; r < half; r++) {
+      const u = Math.max(0, Math.min(8, up - r * 8));
+      rows[half - 1 - r]?.push({
+        ch: EIGHTHS[u] ?? " ",
+        inverse: false,
+        kind: sample.kind,
+        fade
+      });
+      const d = Math.max(0, Math.min(8, down - r * 8));
+      const lower = d === 8 ? { ch: "\u2588", inverse: false } : d > 0 ? { ch: EIGHTHS[8 - d] ?? " ", inverse: true } : { ch: " ", inverse: false };
+      rows[half + r]?.push({ ...lower, kind: sample.kind, fade });
+    }
+  }
+  return rows;
+}
+function mixHex(from, to, t) {
+  const channel = (hex, i) => parseInt(hex.slice(1 + i * 2, 3 + i * 2), 16);
+  const out = [0, 1, 2].map(
+    (i) => Math.round(channel(from, i) + (channel(to, i) - channel(from, i)) * t).toString(16).padStart(2, "0")
+  );
+  return `#${out.join("")}`;
+}
+const HEX = /^#[0-9a-fA-F]{6}$/;
+function fadeColor(color, background, fade) {
+  if (fade <= 0.02 || !HEX.test(color) || !HEX.test(background)) return color;
+  return mixHex(color, background, fade);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TRACE_ROLE,
+  fadeColor,
+  isQuiet,
+  pushSample,
+  traceKind,
+  traceRows
+});

package/dist/signal/trace.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The trace: the session's activity drawn as a signal that scrolls away from the wordmark.
+ * Each column is one sample, taken when it is pushed, so a sample keeps its shape as it ages.
+ * A flat line means nothing is happening.
+ */
+import type { DeckMode } from './components.js';
+import type { Role } from './tone.js';
+export type TraceKind = 'idle' | 'think' | 'stream' | 'tool' | 'cloud' | 'wait' | 'fault' | 'stop' | 'flat';
+export interface TraceSample {
+    kind: TraceKind;
+    /** 0 (carrier line) to 1 (full height). */
+    amp: number;
+}
+export interface TraceCell {
+    ch: string;
+    /** The lower half reuses the upward eighth blocks in reverse video. */
+    inverse: boolean;
+    kind: TraceKind;
+    /** 0 (full colour) to 0.78 (almost background): phosphor persistence. */
+    fade: number;
+}
+export declare const TRACE_ROLE: Readonly<Record<TraceKind, Role>>;
+export declare function traceKind(mode: DeckMode): TraceKind;
+export declare function isQuiet(kind: TraceKind): boolean;
+/**
+ * Push one sample of `kind` taken at clock `tick`. Newest first; at most `max` samples kept.
+ * Smooth kinds ramp in over six columns so a new run doesn't start as a cliff.
+ */
+export declare function pushSample(history: readonly TraceSample[], kind: TraceKind, tick: number, max: number): TraceSample[];
+/**
+ * The trace as `height` rows of `width` cells (height even). The upper half grows up from the
+ * centre line in eighth blocks; the lower half grows down using the same glyphs in reverse video,
+ * so no Unicode 13 "upper eighth" glyphs are needed. Every column draws at least one eighth.
+ */
+export declare function traceRows(history: readonly TraceSample[], width: number, height: number): TraceCell[][];
+/**
+ * A colour faded toward the background. Only hex colours fade; 16-colour and legacy names
+ * stay as they are, since a terminal palette has no in-between shades.
+ */
+export declare function fadeColor(color: string, background: string, fade: number): string;
+//# sourceMappingURL=trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/signal/trace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,SAAS,GACf,MAAM,GACN,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,CAAC;AAEb,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CAChB;AAkBD,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAUxD,CAAC;AAKF,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAEnD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEhD;AAiCD;;;GAGG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACZ,WAAW,EAAE,CAMf;AAID;;;;GAIG;AACH,wBAAgB,SAAS,CACrB,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACf,SAAS,EAAE,EAAE,CA6Bf;AAcD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjF"}

package/dist/signal/trace.js

@@ -0,0 +1,113 @@
+const MODE_KIND = {
+  idle: "idle",
+  think: "think",
+  stream: "stream",
+  tool: "tool",
+  cloud: "cloud",
+  wait: "wait",
+  fault: "fault",
+  stop: "stop",
+  steer: "tool",
+  offline: "idle",
+  handoff: "cloud",
+  attached: "cloud",
+  done: "idle"
+};
+const TRACE_ROLE = {
+  idle: "tealDim",
+  think: "teal",
+  stream: "teal",
+  tool: "teal",
+  cloud: "cloud",
+  wait: "amber",
+  fault: "red",
+  stop: "dim",
+  flat: "faint"
+};
+const QUIET = /* @__PURE__ */ new Set(["idle", "wait", "stop", "flat"]);
+function traceKind(mode) {
+  return MODE_KIND[mode];
+}
+function isQuiet(kind) {
+  return QUIET.has(kind);
+}
+function rnd(i) {
+  const v = Math.sin(i * 127.1 + 311.7) * 43758.5453;
+  return v - Math.floor(v);
+}
+function amplitude(kind, k, p) {
+  switch (kind) {
+    case "idle":
+      return 0.04 + 0.05 * (0.5 + 0.5 * Math.sin(p / 14));
+    case "think":
+      return 0.18 + 0.22 * (0.5 + 0.5 * Math.sin(p / 6)) * (0.6 + 0.4 * Math.sin(p / 19));
+    case "stream":
+      return 0.16 + 0.5 * rnd(p) ** 1.7 * (0.65 + 0.35 * Math.sin(p / 7));
+    case "tool": {
+      const gap = 3 + Math.floor(rnd(Math.floor((p + 3) / 7)) * 5);
+      return p % gap === 0 ? 0.6 + 0.4 * rnd(p) : p % gap === 1 ? 0.3 : 0.06;
+    }
+    case "cloud":
+      return 0.3 + 0.45 * Math.abs(Math.sin(p / 4.5)) * (0.6 + 0.4 * rnd(Math.floor(p / 8)));
+    case "fault":
+      return k % 9 < 2 ? 1 : 0.15 + 0.6 * rnd(p) ** 2;
+    case "stop":
+      return 0.02;
+    case "wait":
+    case "flat":
+      return 0;
+  }
+}
+function pushSample(history, kind, tick, max) {
+  let run = 0;
+  while (run < history.length && history[run]?.kind === kind) run++;
+  const ramp = kind === "tool" || kind === "fault" ? 1 : Math.min(1, (run + 1) / 6);
+  const amp = Math.max(0, Math.min(1, amplitude(kind, run, tick) * ramp));
+  return [{ kind, amp }, ...history.slice(0, Math.max(0, max - 1))];
+}
+const EIGHTHS = [" ", "\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
+function traceRows(history, width, height) {
+  const half = Math.max(1, Math.floor(height / 2));
+  const levels = half * 8;
+  const fadeFrom = Math.floor(width * 0.35);
+  const rows = Array.from({ length: half * 2 }, () => []);
+  for (let c = 0; c < width; c++) {
+    const sample = history[c] ?? { kind: "flat", amp: 0 };
+    const fade = Math.max(0, (c - fadeFrom) / Math.max(1, width - fadeFrom)) * 0.78;
+    const up = Math.max(1, Math.round(sample.amp * levels));
+    const down = Math.round(sample.amp * levels * 0.92);
+    for (let r = 0; r < half; r++) {
+      const u = Math.max(0, Math.min(8, up - r * 8));
+      rows[half - 1 - r]?.push({
+        ch: EIGHTHS[u] ?? " ",
+        inverse: false,
+        kind: sample.kind,
+        fade
+      });
+      const d = Math.max(0, Math.min(8, down - r * 8));
+      const lower = d === 8 ? { ch: "\u2588", inverse: false } : d > 0 ? { ch: EIGHTHS[8 - d] ?? " ", inverse: true } : { ch: " ", inverse: false };
+      rows[half + r]?.push({ ...lower, kind: sample.kind, fade });
+    }
+  }
+  return rows;
+}
+function mixHex(from, to, t) {
+  const channel = (hex, i) => parseInt(hex.slice(1 + i * 2, 3 + i * 2), 16);
+  const out = [0, 1, 2].map(
+    (i) => Math.round(channel(from, i) + (channel(to, i) - channel(from, i)) * t).toString(16).padStart(2, "0")
+  );
+  return `#${out.join("")}`;
+}
+const HEX = /^#[0-9a-fA-F]{6}$/;
+function fadeColor(color, background, fade) {
+  if (fade <= 0.02 || !HEX.test(color) || !HEX.test(background)) return color;
+  return mixHex(color, background, fade);
+}
+export {
+  TRACE_ROLE,
+  fadeColor,
+  isQuiet,
+  pushSample,
+  traceKind,
+  traceRows
+};

package/dist/signal/trace.test.cjs

@@ -0,0 +1,50 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_trace = require("./trace.js");
+function history(kind, count) {
+  let out = [];
+  for (let i = 0; i < count; i++) out = (0, import_trace.pushSample)(out, kind, i, 200);
+  return out;
+}
+(0, import_vitest.describe)("trace", () => {
+  (0, import_vitest.it)("maps every deck mode to a trace kind", () => {
+    (0, import_vitest.expect)((0, import_trace.traceKind)("idle")).toBe("idle");
+    (0, import_vitest.expect)((0, import_trace.traceKind)("stream")).toBe("stream");
+    (0, import_vitest.expect)((0, import_trace.traceKind)("steer")).toBe("tool");
+    (0, import_vitest.expect)((0, import_trace.traceKind)("attached")).toBe("cloud");
+    (0, import_vitest.expect)((0, import_trace.traceKind)("done")).toBe("idle");
+  });
+  (0, import_vitest.it)("keeps newest samples first and caps the history", () => {
+    const h = (0, import_trace.pushSample)(history("idle", 5), "fault", 5, 4);
+    (0, import_vitest.expect)(h).toHaveLength(4);
+    (0, import_vitest.expect)(h[0]?.kind).toBe("fault");
+  });
+  (0, import_vitest.it)("draws a waiting or stopped trace as a one-eighth carrier line", () => {
+    const rows = (0, import_trace.traceRows)(history("wait", 10), 6, 2);
+    (0, import_vitest.expect)(rows[0]?.map((c) => c.ch).join("")).toBe("\u2581\u2581\u2581\u2581\u2581\u2581");
+    (0, import_vitest.expect)(rows[1]?.map((c) => c.ch).join("")).toBe("      ");
+  });
+  (0, import_vitest.it)("fills columns with no history with a flat line", () => {
+    const rows = (0, import_trace.traceRows)([], 3, 2);
+    (0, import_vitest.expect)(rows[0]?.map((c) => c.kind)).toEqual(["flat", "flat", "flat"]);
+  });
+  (0, import_vitest.it)("mirrors activity below the centre line in reverse video", () => {
+    const rows = (0, import_trace.traceRows)(history("fault", 30), 30, 2);
+    const lower = rows[1] ?? [];
+    (0, import_vitest.expect)(lower.some((c) => c.ch !== " ")).toBe(true);
+    (0, import_vitest.expect)(lower.filter((c) => c.ch !== " " && c.ch !== "\u2588").every((c) => c.inverse)).toBe(
+      true
+    );
+  });
+  (0, import_vitest.it)("fades older columns toward the background", () => {
+    const rows = (0, import_trace.traceRows)(history("stream", 40), 40, 2);
+    const fades = (rows[0] ?? []).map((c) => c.fade);
+    (0, import_vitest.expect)(fades[0]).toBe(0);
+    (0, import_vitest.expect)(fades[39]).toBeGreaterThan(0.7);
+  });
+  (0, import_vitest.it)("keeps a sample the same as it scrolls", () => {
+    const a = history("stream", 20);
+    const b = (0, import_trace.pushSample)(a, "stream", 20, 200);
+    (0, import_vitest.expect)(b[1]).toEqual(a[0]);
+  });
+});

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

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

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

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

package/dist/signal/trace.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from "vitest";
+import { pushSample, traceKind, traceRows } from "./trace.js";
+function history(kind, count) {
+  let out = [];
+  for (let i = 0; i < count; i++) out = pushSample(out, kind, i, 200);
+  return out;
+}
+describe("trace", () => {
+  it("maps every deck mode to a trace kind", () => {
+    expect(traceKind("idle")).toBe("idle");
+    expect(traceKind("stream")).toBe("stream");
+    expect(traceKind("steer")).toBe("tool");
+    expect(traceKind("attached")).toBe("cloud");
+    expect(traceKind("done")).toBe("idle");
+  });
+  it("keeps newest samples first and caps the history", () => {
+    const h = pushSample(history("idle", 5), "fault", 5, 4);
+    expect(h).toHaveLength(4);
+    expect(h[0]?.kind).toBe("fault");
+  });
+  it("draws a waiting or stopped trace as a one-eighth carrier line", () => {
+    const rows = traceRows(history("wait", 10), 6, 2);
+    expect(rows[0]?.map((c) => c.ch).join("")).toBe("\u2581\u2581\u2581\u2581\u2581\u2581");
+    expect(rows[1]?.map((c) => c.ch).join("")).toBe("      ");
+  });
+  it("fills columns with no history with a flat line", () => {
+    const rows = traceRows([], 3, 2);
+    expect(rows[0]?.map((c) => c.kind)).toEqual(["flat", "flat", "flat"]);
+  });
+  it("mirrors activity below the centre line in reverse video", () => {
+    const rows = traceRows(history("fault", 30), 30, 2);
+    const lower = rows[1] ?? [];
+    expect(lower.some((c) => c.ch !== " ")).toBe(true);
+    expect(lower.filter((c) => c.ch !== " " && c.ch !== "\u2588").every((c) => c.inverse)).toBe(
+      true
+    );
+  });
+  it("fades older columns toward the background", () => {
+    const rows = traceRows(history("stream", 40), 40, 2);
+    const fades = (rows[0] ?? []).map((c) => c.fade);
+    expect(fades[0]).toBe(0);
+    expect(fades[39]).toBeGreaterThan(0.7);
+  });
+  it("keeps a sample the same as it scrolls", () => {
+    const a = history("stream", 20);
+    const b = pushSample(a, "stream", 20, 200);
+    expect(b[1]).toEqual(a[0]);
+  });
+});

package/dist/signal/use-trace.cjs

@@ -0,0 +1,73 @@
+"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 use_trace_exports = {};
+__export(use_trace_exports, {
+  TRACE_RATE: () => TRACE_RATE,
+  useTrace: () => useTrace
+});
+module.exports = __toCommonJS(use_trace_exports);
+var import_react = require("react");
+var import_caps = require("./caps.js");
+var import_trace = require("./trace.js");
+const TRACE_RATE = 10;
+const STEP_COLUMNS = 6;
+function windowIsQuiet(history, width) {
+  for (let i = 0; i < Math.min(width, history.length); i++) {
+    const sample = history[i];
+    if (sample !== void 0 && !(0, import_trace.isQuiet)(sample.kind)) return false;
+  }
+  return true;
+}
+function useTrace(kind, width, paused) {
+  const { motion } = (0, import_caps.useCaps)();
+  const [history, setHistory] = (0, import_react.useState)([]);
+  const tick = (0, import_react.useRef)(0);
+  const kindRef = (0, import_react.useRef)(kind);
+  kindRef.current = kind;
+  const maxRef = (0, import_react.useRef)(Math.max(1, width));
+  maxRef.current = Math.max(1, width);
+  const settled = (0, import_trace.isQuiet)(kind) && windowIsQuiet(history, width);
+  const running = motion === "full" && !settled && !paused;
+  (0, import_react.useEffect)(() => {
+    if (!running) return;
+    const timer = setInterval(() => {
+      tick.current += 1;
+      const at = tick.current;
+      setHistory((prev) => (0, import_trace.pushSample)(prev, kindRef.current, at, maxRef.current));
+    }, 1e3 / TRACE_RATE);
+    return () => clearInterval(timer);
+  }, [running]);
+  (0, import_react.useEffect)(() => {
+    if (motion !== "reduced") return;
+    setHistory((prev) => {
+      let next = prev;
+      for (let i = 0; i < STEP_COLUMNS; i++) {
+        tick.current += 1;
+        next = (0, import_trace.pushSample)(next, kind, tick.current, maxRef.current);
+      }
+      return next;
+    });
+  }, [motion, kind]);
+  return history;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TRACE_RATE,
+  useTrace
+});

package/dist/signal/use-trace.d.ts

@@ -0,0 +1,5 @@
+import { type TraceKind, type TraceSample } from './trace.js';
+/** Columns per second the trace scrolls at. */
+export declare const TRACE_RATE = 10;
+export declare function useTrace(kind: TraceKind, width: number, paused: boolean): TraceSample[];
+//# sourceMappingURL=use-trace.d.ts.map

package/dist/signal/use-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trace.d.ts","sourceRoot":"","sources":["../../src/signal/use-trace.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnF,+CAA+C;AAC/C,eAAO,MAAM,UAAU,KAAK,CAAC;AAY7B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAmCvF"}

package/dist/signal/use-trace.js

@@ -0,0 +1,48 @@
+import { useEffect, useRef, useState } from "react";
+import { useCaps } from "./caps.js";
+import { isQuiet, pushSample } from "./trace.js";
+const TRACE_RATE = 10;
+const STEP_COLUMNS = 6;
+function windowIsQuiet(history, width) {
+  for (let i = 0; i < Math.min(width, history.length); i++) {
+    const sample = history[i];
+    if (sample !== void 0 && !isQuiet(sample.kind)) return false;
+  }
+  return true;
+}
+function useTrace(kind, width, paused) {
+  const { motion } = useCaps();
+  const [history, setHistory] = useState([]);
+  const tick = useRef(0);
+  const kindRef = useRef(kind);
+  kindRef.current = kind;
+  const maxRef = useRef(Math.max(1, width));
+  maxRef.current = Math.max(1, width);
+  const settled = isQuiet(kind) && windowIsQuiet(history, width);
+  const running = motion === "full" && !settled && !paused;
+  useEffect(() => {
+    if (!running) return;
+    const timer = setInterval(() => {
+      tick.current += 1;
+      const at = tick.current;
+      setHistory((prev) => pushSample(prev, kindRef.current, at, maxRef.current));
+    }, 1e3 / TRACE_RATE);
+    return () => clearInterval(timer);
+  }, [running]);
+  useEffect(() => {
+    if (motion !== "reduced") return;
+    setHistory((prev) => {
+      let next = prev;
+      for (let i = 0; i < STEP_COLUMNS; i++) {
+        tick.current += 1;
+        next = pushSample(next, kind, tick.current, maxRef.current);
+      }
+      return next;
+    });
+  }, [motion, kind]);
+  return history;
+}
+export {
+  TRACE_RATE,
+  useTrace
+};