@inhuman.tools/quickdraw 0.0.0-bootstrap.0 → 0.2.0

package/dist/widgets/shadow-stream.js

@@ -0,0 +1,359 @@
+/**
+ * ShadowStream — labeled, height-bounded, gradient-faded window over a live
+ * text stream (`ShadowStream`, 2026-07-18).
+ *
+ * Render-side only: pure `LayoutNode` construction. Caller owns state cycle
+ * and collapse. Not a "thinking" feature — any streaming process with a header
+ * you want to peek-bound (thinking / searching / compiling / log tail).
+ *
+ * ## Dominating primitive
+ *
+ * Always rendered, always at `base` prominence. What changes is how much of
+ * the stream is shown.
+ *
+ * ## Three states
+ *
+ * - `fully_collapsed` — only the primitive (`▸ thinking`).
+ * - `peek` — the shadow window (default live render).
+ * - `expanded` — `▾ primitive` + full lines (caller may wrap in a rule gutter).
+ *
+ * ## Peek shadow (two axes)
+ *
+ * Paint dissolves FG toward local surface / theme ground. Axes:
+ *
+ * 1. **Vertical age (lanes):** each body row is **full-width uniform** dim by
+ *    age — oldest darkest, gradually de-dims toward newest (`kLine`). Older
+ *    lanes never get a horizontal birth ramp.
+ * 2. **Opacity wavefront:** host steps wavefront `W` on the newest line only.
+ *    Full left of W, gradient after W. Older lanes never wait for W.
+ * 3. **Squeeze oldest:** primitive at `base` + per-char horizontal dissolve
+ *    on the oldest tail (`floor → shadowCap`).
+ *
+ * Peek always ghost-overlays the oldest visible line onto the primitive row.
+ * One-line peek: that row is also the birth tip. Taller peeks: oldest
+ * squeezes; middle lanes age; newest carries the wavefront.
+ */
+import { Text } from "./text.js";
+import { BIRTH_FRONTIER_DEFAULTS, birthLive } from "../layout/index.js";
+import { displayWidth, splitAtWidth } from "../measure/index.js";
+/** Defaults match ShadowStream module attrs + birth-band audit pins. */
+const SHADOW_STREAM_DEFAULTS = {
+    primitive: "thinking",
+    height: 3,
+    base: 0.6,
+    /** Full-width age floor for oldest lane (clearly dimmer than mid). */
+    floor: 0.12,
+    shadowCap: 0.4,
+    birthFloor: BIRTH_FRONTIER_DEFAULTS.birthFloor,
+    /** Vertical age: >1 = older lanes darker. */
+    kLine: 1.25,
+    kChar: 1.5,
+    falloff: BIRTH_FRONTIER_DEFAULTS.falloff,
+    gap: 3,
+    ellipsis: "…",
+    role: "muted",
+    collapsedIcon: "▸",
+    expandedIcon: "▾",
+};
+function clamp01(n) {
+    if (!Number.isFinite(n))
+        return 1;
+    return Math.min(1, Math.max(0, n));
+}
+/** Default tip window from layout width (aesthetic; distance still uses ink W). */
+function defaultTipWindow(layoutWidth) {
+    const w = Math.max(8, layoutWidth);
+    return Math.min(16, Math.max(8, Math.round(w / 4)));
+}
+function normalize(props) {
+    const d = SHADOW_STREAM_DEFAULTS;
+    const width = Math.max(8, props.width ?? 48);
+    const floor = clamp01(props.floor ?? d.floor);
+    const birthFloor = clamp01(props.birthFloor ?? d.birthFloor);
+    return {
+        primitive: props.primitive ?? d.primitive,
+        lines: toLines(props.lines),
+        state: props.state ?? "peek",
+        width,
+        height: Math.max(1, props.height ?? d.height),
+        base: clamp01(props.base ?? d.base),
+        floor,
+        shadowCap: clamp01(props.shadowCap ?? d.shadowCap),
+        birthFloor,
+        tipWindow: Math.max(1, props.tipWindow ?? defaultTipWindow(width)),
+        role: props.role ?? d.role,
+        surfaceRole: props.surfaceRole,
+        surfaceProminence: props.surfaceProminence,
+        key: props.key ?? "shadow",
+        collapsedIcon: props.collapsedIcon ?? d.collapsedIcon,
+        expandedIcon: props.expandedIcon ?? d.expandedIcon,
+        primitiveLive: props.primitiveLive,
+        wavefront: props.wavefront === true,
+        expandedBodyExternal: props.expandedBodyExternal === true,
+    };
+}
+function toLines(text) {
+    if (text == null)
+        return [];
+    if (Array.isArray(text)) {
+        return text.filter((l) => typeof l === "string" && l.length > 0);
+    }
+    if (typeof text !== "string")
+        return [];
+    return text.split("\n").filter((l) => l.length > 0);
+}
+/**
+ * Vertical prominence by age: age 0 (newest) = base; older → floor over
+ * height-1 steps, slightly exponential (`@k_line`).
+ */
+function ageProminence(age, opts) {
+    if (age <= 0)
+        return opts.base;
+    const denom = Math.max(opts.height - 1, 1);
+    const t = Math.max(1 - age / denom, 0);
+    const k = opts.kLine ?? SHADOW_STREAM_DEFAULTS.kLine;
+    return opts.floor + (opts.base - opts.floor) * Math.pow(t, k);
+}
+/**
+ * Horizontal prominence on the **oldest** squeeze tail: col 0 (left /
+ * consumed) = floor, rising to shadowCap at region right edge (`kChar`).
+ */
+function charProminence(col, region, opts) {
+    if (region <= 1)
+        return opts.floor;
+    const t = Math.min(col / (region - 1), 1);
+    const k = opts.kChar ?? SHADOW_STREAM_DEFAULTS.kChar;
+    return Math.min(opts.floor + (opts.shadowCap - opts.floor) * Math.pow(t, k), opts.shadowCap);
+}
+function textNode(content, key, role, prominence, extra) {
+    return Text(content, {
+        key,
+        whiteSpace: "nowrap",
+        style: {
+            role,
+            prominence,
+            bold: extra?.bold,
+            surfaceRole: extra?.surfaceRole,
+            surfaceProminence: extra?.surfaceRole ? (extra.surfaceProminence ?? 1) : undefined,
+        },
+        live: extra?.live,
+    });
+}
+function surfaceExtra(p) {
+    if (!p.surfaceRole)
+        return {};
+    return {
+        surfaceRole: p.surfaceRole,
+        surfaceProminence: p.surfaceProminence ?? 1,
+    };
+}
+/**
+ * Keep the tail that fits `region` display columns; overflow prefix → `…`.
+ */
+function fitTail(line, region) {
+    const r = Math.max(1, region);
+    if (displayWidth(line) <= r)
+        return line;
+    const keep = Math.max(r - 1, 0);
+    const total = displayWidth(line);
+    const drop = Math.max(total - keep, 0);
+    const [, kept] = splitAtWidth(line, drop);
+    return SHADOW_STREAM_DEFAULTS.ellipsis + kept;
+}
+/**
+ * Micro-offset so column `col` quantizes RGB on a different phase.
+ * ~±½ of an 8-bit step over a typical muted fade span — invisible as
+ * structure, enough to break lockstep hops.
+ */
+function staggerProminence(p, col) {
+    // Golden-ratio phase in [0,1)
+    const phase = (col * 0.618_033_988_7) % 1;
+    // ±~1/160 on prominence — enough that adjacent letters rarely share an
+    // 8-bit RGB step boundary when W crawls (cluster hop → letter crawl).
+    const delta = (phase - 0.5) * (1 / 80);
+    return Math.min(1, Math.max(0, p + delta));
+}
+/** Coalesce adjacent equal-prominence grapheme runs into text nodes. */
+function spansFromProminence(line, prominenceAtCol, opts) {
+    const chars = [...line];
+    if (chars.length === 0)
+        return [];
+    const inkW = displayWidth(line);
+    const coalesce = opts.coalesce !== false;
+    const stagger = opts.quantizeStagger === true;
+    const runs = [];
+    let col = 0;
+    for (const g of chars) {
+        const gW = displayWidth(g);
+        // Trailing edge of this grapheme: distance from ink end.
+        const trailingDist = Math.max(inkW - (col + gW), 0);
+        let p = prominenceAtCol(col, trailingDist);
+        if (stagger)
+            p = staggerProminence(p, col);
+        const last = runs.at(-1);
+        if (coalesce && last && Math.abs(last.p - p) < 1e-6) {
+            last.text += g;
+        }
+        else {
+            runs.push({ text: g, p });
+        }
+        col += gW;
+    }
+    const surf = opts.surfaceRole
+        ? {
+            surfaceRole: opts.surfaceRole,
+            surfaceProminence: opts.surfaceProminence ?? 1,
+        }
+        : {};
+    return runs.map((run, i) => textNode(run.text, `${opts.key}:c${i}`, opts.role, run.p, surf));
+}
+/** Per-char horizontal fade on squeeze oldest tail (left→right dissolve). */
+function fadeSpans(tail, region, opts) {
+    return spansFromProminence(tail, (col) => charProminence(col, region, {
+        floor: opts.floor,
+        shadowCap: opts.shadowCap,
+    }), opts);
+}
+/** Primitive + oldest (or only) body on one row — the ghost overlay. */
+function headerRow(p, line, opts) {
+    const primW = displayWidth(p.primitive);
+    const gap = SHADOW_STREAM_DEFAULTS.gap;
+    const region = Math.max(p.width - primW - gap, 1);
+    const tail = fitTail(line, region);
+    const surf = surfaceExtra(p);
+    const tailNodes = opts?.streamBirth
+        ? [
+            lineNode(p, tail, 0, `${p.key}:shadow`, {
+                streamBirth: opts.streamBirth,
+            }),
+        ]
+        : fadeSpans(tail, region, {
+            role: p.role,
+            key: `${p.key}:shadow`,
+            floor: p.floor,
+            shadowCap: p.shadowCap,
+            ...surf,
+        });
+    return {
+        type: "flex",
+        key: `${p.key}:sq`,
+        style: { direction: "row", gap: 0, width: p.width },
+        children: [
+            textNode(p.primitive, `${p.key}:prim`, p.role, p.base, {
+                live: p.primitiveLive,
+                bold: true,
+                ...surf,
+            }),
+            textNode(" ".repeat(gap), `${p.key}:gap`, p.role, p.floor, surf),
+            ...tailNodes,
+        ],
+    };
+}
+/**
+ * Body line: full-width **uniform** age dim, or newest-line birth tip.
+ * Older lanes never get horizontal birth ramps — only age.
+ */
+function lineNode(p, line, age, key, opts) {
+    const surf = surfaceExtra(p);
+    const targetP = ageProminence(age, p);
+    if (!opts.streamBirth) {
+        return textNode(line, key, p.role, targetP, surf);
+    }
+    return textNode(line, key, p.role, targetP, {
+        ...surf,
+        live: birthLive({
+            siteId: p.key,
+            T: opts.streamBirth.T,
+            offset: opts.streamBirth.offset,
+            target: targetP,
+            birthFloor: p.birthFloor,
+            falloff: BIRTH_FRONTIER_DEFAULTS.falloff,
+            tipWindow: p.tipWindow,
+        }),
+    });
+}
+/** Newest-line mass. Offset 0 — W is local to this line. */
+function newestStreamBirth(_p, body) {
+    if (body.length === 0)
+        return undefined;
+    const last = body.at(-1);
+    return { T: displayWidth(last), offset: 0 };
+}
+function peekChildren(p) {
+    const n = p.lines.length;
+    const surf = surfaceExtra(p);
+    if (n === 0) {
+        return [
+            textNode(p.primitive, `${p.key}:prim`, p.role, p.base, {
+                live: p.primitiveLive,
+                bold: true,
+                ...surf,
+            }),
+        ];
+    }
+    const window = p.lines.slice(-p.height);
+    const len = window.length;
+    const oldest = window[0];
+    const rest = window.slice(1);
+    const birth = newestStreamBirth(p, window);
+    if (rest.length === 0) {
+        return [
+            headerRow(p, oldest, {
+                streamBirth: p.wavefront ? birth : undefined,
+            }),
+        ];
+    }
+    const restRows = rest.map((line, i) => {
+        const age = len - 2 - i;
+        const isNewest = age === 0;
+        return lineNode(p, line, Math.max(age, 0), `${p.key}:l${i + 1}`, {
+            streamBirth: isNewest && p.wavefront ? birth : undefined,
+        });
+    });
+    return [headerRow(p, oldest), ...restRows];
+}
+/**
+ * Pure LayoutNode tree for a ShadowStream.
+ * Root is a column flex; does not wrap Indication — caller composes.
+ */
+export function ShadowStream(props = {}) {
+    const p = normalize(props);
+    let kids;
+    const surf = surfaceExtra(p);
+    switch (p.state) {
+        case "fully_collapsed":
+            kids = [
+                textNode(`${p.collapsedIcon} ${p.primitive}`, `${p.key}:prim`, p.role, p.base, {
+                    live: p.primitiveLive,
+                    bold: true,
+                    ...surf,
+                }),
+            ];
+            break;
+        case "expanded":
+            // No tip rubber-band — peek-only feature (audit S6).
+            kids = [
+                textNode(`${p.expandedIcon} ${p.primitive}`, `${p.key}:prim`, p.role, p.base, {
+                    live: p.primitiveLive,
+                    bold: true,
+                    ...surf,
+                }),
+            ];
+            if (!p.expandedBodyExternal) {
+                for (let i = 0; i < p.lines.length; i++) {
+                    kids.push(textNode(p.lines[i], `${p.key}:x${i}`, p.role, p.base, surf));
+                }
+            }
+            break;
+        case "peek":
+            kids = peekChildren(p);
+            break;
+    }
+    return {
+        type: "flex",
+        key: p.key,
+        style: { direction: "column", gap: 0, width: p.width },
+        children: kids,
+    };
+}
+//# sourceMappingURL=shadow-stream.js.map

package/dist/widgets/shadow-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-stream.js","sourceRoot":"","sources":["../../src/widgets/shadow-stream.ts"],"names":[],"mappings":"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"}

package/dist/widgets/speech.d.ts

@@ -0,0 +1,36 @@
+import { type LayoutNode } from "../layout/index.js";
+/**
+ * `"12:00 AM"` is 8 cells. Shorter `H:MM AM/PM` faces right-pad in this slot
+ * so AM/PM stays a column — do not shrink-wrap the clock.
+ */
+export declare const SPEECH_STAMP_CELLS = 8;
+export declare const SPEECH_STAMP_GAP = 1;
+export declare const SPEECH_STAMP_RESERVE: number;
+export declare function speechBodyWidth(contentW: number): number;
+/** Local wall clock. `H:MM AM/PM` — no leading hour zero. */
+export declare function formatClock12h(atMs: number): string;
+export declare const SIGIL_USER = "\u276F";
+/** Stamp-rail width for a user floor in a column of `columnW`. */
+export declare function userSpeechRailWidth(columnW: number): number;
+/** Indication inset, then the user floor's right pad, so both clocks share a column. */
+export declare function replySpeechRailWidth(columnW: number): number;
+export type SpeechVoice = "user" | "assistant";
+export type SpeechModel = {
+    readonly text: string;
+    readonly voice?: SpeechVoice;
+    readonly live?: boolean;
+    readonly failed?: boolean;
+    /** Epoch ms. Null keeps the 8-cell rail empty. */
+    readonly atMs?: number | null;
+};
+export declare function Speech(model: SpeechModel, opts: {
+    key: string;
+    width?: number;
+}): LayoutNode;
+/** Markdown / text child inside the stamp rail. */
+export declare function speechBodyNode(node: LayoutNode): LayoutNode | undefined;
+export declare function replaceSpeechBody(node: LayoutNode, body: LayoutNode): LayoutNode;
+export declare function Recall(text: string, opts: {
+    key: string;
+}): LayoutNode;
+//# sourceMappingURL=speech.d.ts.map

package/dist/widgets/speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../../src/widgets/speech.ts"],"names":[],"mappings":"AAQA,OAAO,EAAmD,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGtG;;;GAGG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,oBAAoB,QAAwC,CAAC;AAI1E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AA2DD,eAAO,MAAM,UAAU,WAAM,CAAC;AAQ9B,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAKD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAyD5F;AA0CD,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAIvE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAqBhF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAYtE"}

package/dist/widgets/speech.js

@@ -0,0 +1,238 @@
+/**
+ * Transcript speech / recall. Glyph and role only — no session, no PEW.
+ * Prompt and reply share one voice (foreground @ primary). Bold + ❯ is the
+ * user mark, one cell inside a surface floor at mist. Replies do not recede
+ * to muted or secondary.
+ */
+import { Markdown } from "./markdown.js";
+import { Text } from "./text.js";
+import { INDICATION_CONTENT_INSET, INDICATION_VOID_GLYPH } from "../layout/index.js";
+import { BgP, FgP } from "../lexicon/index.js";
+/**
+ * `"12:00 AM"` is 8 cells. Shorter `H:MM AM/PM` faces right-pad in this slot
+ * so AM/PM stays a column — do not shrink-wrap the clock.
+ */
+export const SPEECH_STAMP_CELLS = 8;
+export const SPEECH_STAMP_GAP = 1;
+export const SPEECH_STAMP_RESERVE = SPEECH_STAMP_CELLS + SPEECH_STAMP_GAP;
+const STAMP_VOICE = { role: "foreground", prominence: FgP.ghost };
+export function speechBodyWidth(contentW) {
+    return Math.max(8, contentW - SPEECH_STAMP_RESERVE);
+}
+/** Local wall clock. `H:MM AM/PM` — no leading hour zero. */
+export function formatClock12h(atMs) {
+    if (!Number.isFinite(atMs))
+        return "";
+    const date = new Date(atMs);
+    const minutes = date.getMinutes();
+    let hour = date.getHours();
+    const suffix = hour >= 12 ? "PM" : "AM";
+    hour %= 12;
+    if (hour === 0)
+        hour = 12;
+    return `${hour}:${String(minutes).padStart(2, "0")} ${suffix}`;
+}
+function stampFace(atMs) {
+    if (atMs == null || !Number.isFinite(atMs))
+        return "";
+    return formatClock12h(atMs).padStart(SPEECH_STAMP_CELLS, " ");
+}
+function withStampRail(body, opts) {
+    const bodyW = speechBodyWidth(opts.contentW);
+    return {
+        type: "box",
+        key: `${opts.key}:rail`,
+        style: { width: opts.contentW },
+        children: [
+            {
+                type: "flex",
+                key: `${opts.key}:cols`,
+                style: { direction: "row", gap: SPEECH_STAMP_GAP, alignItems: "flex_start" },
+                children: [
+                    {
+                        type: "box",
+                        key: `${opts.key}:body`,
+                        style: { width: bodyW, flex: 1 },
+                        children: [body],
+                    },
+                    {
+                        type: "box",
+                        key: `${opts.key}:stamp`,
+                        style: { width: SPEECH_STAMP_CELLS, height: 1 },
+                        children: [
+                            Text(stampFace(opts.atMs), {
+                                key: `${opts.key}:stamp-text`,
+                                whiteSpace: "nowrap",
+                                userSelect: "none",
+                                style: STAMP_VOICE,
+                            }),
+                        ],
+                    },
+                ],
+            },
+        ],
+    };
+}
+function indication(opts) {
+    return {
+        type: "indication",
+        key: opts.key,
+        gutter: opts.gutter,
+        style: opts.style,
+        children: opts.children,
+    };
+}
+export const SIGIL_USER = "❯";
+const USER_BLOCK_PAD = 1;
+/** Law 6 gap, so user prose stays in the same column as a reply. */
+const USER_MARK_GAP = 1;
+/** Neutral floor: hue and chroma stay on the `surface` seed. Mist is the low BG step. */
+const USER_BLOCK_BG = { bgRole: "surface", bgProminence: BgP.mist };
+/** Stamp-rail width for a user floor in a column of `columnW`. */
+export function userSpeechRailWidth(columnW) {
+    return Math.max(8, columnW - USER_BLOCK_PAD * 2 - 1 - USER_MARK_GAP);
+}
+/** Indication inset, then the user floor's right pad, so both clocks share a column. */
+export function replySpeechRailWidth(columnW) {
+    return Math.max(8, columnW - INDICATION_CONTENT_INSET - USER_BLOCK_PAD);
+}
+/** Body of a prompt or a reply. User adds bold; fail swaps the role. */
+const SPEECH_VOICE = { role: "foreground", prominence: FgP.primary };
+export function Speech(model, opts) {
+    const voice = model.voice ?? "assistant";
+    const key = opts.key;
+    const contentW = opts.width ?? 48;
+    const bodyW = speechBodyWidth(contentW);
+    const rail = (body) => withStampRail(body, { key, contentW, atMs: model.atMs });
+    if (voice === "user") {
+        const userVoice = { ...SPEECH_VOICE, bold: true };
+        const body = model.text === ""
+            ? Text(model.text, {
+                key: `${key}:text`,
+                whiteSpace: "pre-wrap",
+                style: userVoice,
+            })
+            : Markdown(model.text, { key: `${key}:md`, width: bodyW, style: SPEECH_VOICE });
+        return {
+            type: "box",
+            key: `${key}:speech-user`,
+            style: { padding: USER_BLOCK_PAD, background: USER_BLOCK_BG },
+            children: [
+                {
+                    type: "flex",
+                    key: `${key}:user-line`,
+                    style: { direction: "row", gap: USER_MARK_GAP, alignItems: "flex_start" },
+                    children: [
+                        Text(SIGIL_USER, {
+                            key: `${key}:chevron`,
+                            whiteSpace: "nowrap",
+                            style: userVoice,
+                        }),
+                        rail(body),
+                    ],
+                },
+            ],
+        };
+    }
+    const live = model.live === true;
+    const failed = model.failed === true;
+    const bodyVoice = failed ? { role: "error" } : SPEECH_VOICE;
+    const body = failed || model.text === ""
+        ? Text(model.text, {
+            key: `${key}:text`,
+            whiteSpace: "pre-wrap",
+            style: bodyVoice,
+        })
+        : Markdown(model.text, { key: `${key}:md`, width: bodyW, style: bodyVoice });
+    return indication({
+        key: `${key}:speech`,
+        gutter: { kind: "top", glyph: INDICATION_VOID_GLYPH },
+        style: {
+            role: failed ? "error" : "foreground",
+            prominence: live && !failed ? FgP.rising : FgP.primary,
+        },
+        children: [rail(body)],
+    });
+}
+function railBox(node) {
+    if (node.type === "indication") {
+        const rail = node.children?.[0];
+        return rail?.type === "box" ? rail : undefined;
+    }
+    if (node.type !== "box")
+        return undefined;
+    const row = node.children?.[0];
+    if (row?.type !== "flex")
+        return undefined;
+    const rail = row.children?.[1];
+    return rail?.type === "box" ? rail : undefined;
+}
+function speechRail(rail) {
+    const cols = rail.children?.[0];
+    if (cols?.type !== "flex")
+        return null;
+    const bodyBox = cols.children?.[0];
+    const body = bodyBox?.type === "box" ? bodyBox.children?.[0] : undefined;
+    if (bodyBox?.type !== "box" || body == undefined)
+        return null;
+    return { rail, cols, bodyBox, body };
+}
+function railWithBody(parts, body) {
+    return {
+        ...parts.rail,
+        children: [
+            {
+                ...parts.cols,
+                children: [{ ...parts.bodyBox, children: [body] }, ...(parts.cols.children?.slice(1) ?? [])],
+            },
+        ],
+    };
+}
+/** Markdown / text child inside the stamp rail. */
+export function speechBodyNode(node) {
+    const rail = railBox(node);
+    if (rail == null)
+        return undefined;
+    return speechRail(rail)?.body;
+}
+export function replaceSpeechBody(node, body) {
+    const rail = railBox(node);
+    if (rail == null)
+        return node;
+    const parts = speechRail(rail);
+    if (parts == null)
+        return node;
+    const nextRail = railWithBody(parts, body);
+    if (node.type === "indication") {
+        return { ...node, children: [nextRail, ...(node.children?.slice(1) ?? [])] };
+    }
+    if (node.type !== "box")
+        return node;
+    const row = node.children?.[0];
+    if (row?.type !== "flex")
+        return node;
+    const chevron = row.children?.[0];
+    if (chevron == null)
+        return node;
+    return {
+        ...node,
+        children: [
+            { ...row, children: [chevron, nextRail, ...(row.children?.slice(2) ?? [])] },
+            ...(node.children?.slice(1) ?? []),
+        ],
+    };
+}
+export function Recall(text, opts) {
+    return indication({
+        key: `${opts.key}:row`,
+        gutter: { kind: "top", glyph: INDICATION_VOID_GLYPH },
+        children: [
+            Text(text, {
+                key: `${opts.key}:text`,
+                whiteSpace: "pre-wrap",
+                style: { role: "muted" },
+            }),
+        ],
+    });
+}
+//# sourceMappingURL=speech.js.map

package/dist/widgets/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../../src/widgets/speech.ts"],"names":[],"mappings":"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"}