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

package/dist/layout/length.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cell-grid lengths. px is banned — never rewrite to cells.
+ */
+export type Length = number | "auto" | {
+    fr: number;
+} | {
+    pct: number;
+} | {
+    ch: number;
+} | {
+    lh: number;
+};
+/** Resolve length against definite containing-block size (cells). */
+export declare function resolveLength(len: Length | undefined, cb: number, axis?: "main" | "cross"): number | "auto";
+export declare function isFr(len: Length | undefined): len is {
+    fr: number;
+};
+//# sourceMappingURL=length.d.ts.map

package/dist/layout/length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.d.ts","sourceRoot":"","sources":["../../src/layout/length.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1G,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,OAAgB,GAAG,MAAM,GAAG,MAAM,CASnH;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,IAAI;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAEnE"}

package/dist/layout/length.js

@@ -0,0 +1,24 @@
+/**
+ * Cell-grid lengths. px is banned — never rewrite to cells.
+ */
+/** Resolve length against definite containing-block size (cells). */
+export function resolveLength(len, cb, axis = "main") {
+    if (len === undefined || len === "auto")
+        return "auto";
+    if (typeof len === "number")
+        return Math.max(0, Math.floor(len));
+    if ("fr" in len)
+        return "auto"; // fr resolved in flex/grid free-space pass
+    if ("pct" in len)
+        return Math.max(0, Math.floor((cb * len.pct) / 100));
+    if ("ch" in len)
+        return Math.max(0, len.ch);
+    if ("lh" in len)
+        return Math.max(0, len.lh);
+    void axis;
+    return "auto";
+}
+export function isFr(len) {
+    return typeof len === "object" && len !== null && "fr" in len;
+}
+//# sourceMappingURL=length.js.map

package/dist/layout/length.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.js","sourceRoot":"","sources":["../../src/layout/length.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,GAAuB,EAAE,EAAU,EAAE,OAAyB,MAAM;IAChG,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,MAAM,CAAC,CAAC,2CAA2C;IAC3E,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC;IACV,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAuB;IAC1C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC;AAChE,CAAC"}

package/dist/layout/live_paint.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Live paint — predetermined motion owned by the render layer.
+ *
+ * Logic declares **intent** (`spinner` / `elapsed` / `countdown` / `quota`); paint
+ * resolves glyphs and labels from wall clock. Present reads {@link LiveDemand}
+ * from the Frame to choose Hz — fps-on-demand, not a global fixed aesthetic loop.
+ *
+ * Braille frames, spin rates, and duration formatting live **here only**.
+ * Callers never pass tick indices or braille strings.
+ */
+import type { Positioned } from "./types.js";
+/** Named spinner profiles — semantics, not glyphs. */
+export type SpinnerProfile = "thinking" | "tool" | "working";
+/**
+ * Subscription window for the Cmd/Ctrl status overlay. Paint owns remaining
+ * duration from {@link resetAt}; producers never send a spelled string.
+ */
+export type ChromeQuotaWindow = {
+    remainingPercent: number;
+    /** Unix seconds when this window resets. */
+    resetAt?: number;
+};
+/**
+ * Live decoration kind on a paint op / gutter.
+ * - spinner: single-cell rotating glyph
+ * - elapsed: compact duration from startedAt (label text)
+ * - countdown: remaining seconds until retryUntilMs
+ * - quota: remaining windows from resetAt (status-rail overlay)
+ * - birth: opacity wavefront over source text (W is host-stepped)
+ */
+export type LivePaint = {
+    kind: "spinner";
+    profile: SpinnerProfile;
+    /** Target present Hz for this decoration */
+    hz: number;
+} | {
+    kind: "elapsed";
+    startedAt: number;
+    /** Prefix e.g. "thinking · " */
+    prefix?: string;
+    /** Stem before ` · duration`. Default `thinking`. */
+    label?: string;
+    hz: number;
+} | {
+    kind: "countdown";
+    untilMs: number;
+    hz: number;
+} | {
+    kind: "quota";
+    windows: readonly ChromeQuotaWindow[];
+    /** Static occupancy prefix, e.g. `10k/500k`. Paint joins it with remaining. */
+    prefix?: string;
+    hz: number;
+} | {
+    kind: "birth";
+    /** Host frontier key (usually the stream's layout key). */
+    siteId: string;
+    /** Stream ink mass T. */
+    T: number;
+    /** This line's start on the stream axis. */
+    offset: number;
+    /** Prominence left of W. */
+    target: number;
+    birthFloor: number;
+    falloff: number;
+    tipWindow: number;
+    /**
+     * 0 — host arms present from {@link birthFrontierLive}, not this op.
+     * A non-zero hz here would keep ticking after W catches T.
+     */
+    hz: number;
+};
+export type LiveDemand = {
+    /** Max Hz among all live ops in the frame (0 = nothing live). */
+    maxHz: number;
+    /** Counts by kind (debug / metrics). */
+    spinners: number;
+    elapsed: number;
+    quota: number;
+    birth: number;
+};
+/** Default Hz per profile — present takes max across frame. */
+export declare const SPINNER_HZ: Record<SpinnerProfile, number>;
+export declare function spinnerLive(profile?: SpinnerProfile): Extract<LivePaint, {
+    kind: "spinner";
+}>;
+export declare function elapsedLive(startedAt: number, opts?: {
+    prefix?: string;
+    label?: string;
+    hz?: number;
+}): Extract<LivePaint, {
+    kind: "elapsed";
+}>;
+/** Layout measure for {@link formatRetryCountdown}; 999 is the width cap. */
+export declare const RETRY_COUNTDOWN_MEASURE = "Failed to request; retrying in 999 seconds";
+export declare function formatRetryCountdown(untilMs: number, nowMs: number): string;
+export declare function retryCountdownLive(untilMs: number): Extract<LivePaint, {
+    kind: "countdown";
+}>;
+/** 1Hz is enough for minute-rounding remaining labels. */
+export declare function quotaLive(windows: readonly ChromeQuotaWindow[], opts?: {
+    hz?: number;
+    prefix?: string;
+}): Extract<LivePaint, {
+    kind: "quota";
+}>;
+/** Compact token count: `999`, `1.5k`, `10k`, `500k`. */
+export declare function formatTokenCount(n: number): string;
+/** `10k/500k`. Empty when neither used nor a window exists. A known window paints `0/500k`. */
+export declare function formatContextOccupancy(used: number, limit: number): string;
+/** Occupancy prefix joined with live remaining, e.g. `10k/500k · 51% left for 5 hours`. */
+export declare function formatHeldStatus(prefix: string, windows: readonly ChromeQuotaWindow[], nowMs: number): string;
+/**
+ * Narrow rails drop the spelled quota and keep occupancy. Occupancy is the
+ * shorter chip (`10k/500k`); the full hint is `occupancy · 51% left for …`.
+ * A rail with no occupancy has nothing shorter to fall back to.
+ */
+export declare function formatHeldStatusFit(prefix: string, windows: readonly ChromeQuotaWindow[], nowMs: number, maxColumns: number, measure: (text: string) => number): string;
+export declare function birthLive(opts: {
+    siteId: string;
+    T: number;
+    offset: number;
+    target: number;
+    birthFloor: number;
+    falloff: number;
+    tipWindow: number;
+}): Extract<LivePaint, {
+    kind: "birth";
+}>;
+/** Resolve spinner glyph for wall clock (ms). */
+export declare function resolveSpinnerGlyph(profile: SpinnerProfile, nowMs: number): string;
+/** Compact duration — paint-side only. */
+export declare function formatElapsedCompact(ms: number): string;
+/**
+ * Spelled remaining duration. Same grammar as connect.scm `paint-reset`:
+ * nearest minute; skip a leftover 1 minute at hour scale; 59 minutes rounds
+ * up; days keep leftover hours, not minutes.
+ */
+export declare function formatRemainingSpelled(remainingMs: number): string;
+export declare function formatQuotaWindows(windows: readonly ChromeQuotaWindow[], nowMs: number): string;
+/** Resolve live op to display string at nowMs. Birth is style, not a label. */
+export declare function resolveLiveText(live: LivePaint, nowMs: number): string;
+/** Scan paint order for live demand (after layout). */
+export declare function collectLiveDemand(paintOrder: readonly Positioned[]): LiveDemand;
+//# sourceMappingURL=live_paint.d.ts.map

package/dist/layout/live_paint.d.ts.map

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

package/dist/layout/live_paint.js

@@ -0,0 +1,255 @@
+/**
+ * Live paint — predetermined motion owned by the render layer.
+ *
+ * Logic declares **intent** (`spinner` / `elapsed` / `countdown` / `quota`); paint
+ * resolves glyphs and labels from wall clock. Present reads {@link LiveDemand}
+ * from the Frame to choose Hz — fps-on-demand, not a global fixed aesthetic loop.
+ *
+ * Braille frames, spin rates, and duration formatting live **here only**.
+ * Callers never pass tick indices or braille strings.
+ */
+/** Default Hz per profile — present takes max across frame. */
+export const SPINNER_HZ = {
+    thinking: 12,
+    tool: 12,
+    working: 10,
+};
+/** Glyph alphabets — paint-only; never export to model/logic APIs. */
+const SPINNER_GLYPHS = {
+    thinking: "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏",
+    tool: "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏",
+    working: "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏",
+};
+export function spinnerLive(profile = "working") {
+    return {
+        kind: "spinner",
+        profile,
+        hz: SPINNER_HZ[profile],
+    };
+}
+export function elapsedLive(startedAt, opts) {
+    return {
+        kind: "elapsed",
+        startedAt,
+        prefix: opts?.prefix,
+        label: opts?.label,
+        hz: opts?.hz ?? 2, // 2Hz is enough for second-granularity labels
+    };
+}
+/** Layout measure for {@link formatRetryCountdown}; 999 is the width cap. */
+export const RETRY_COUNTDOWN_MEASURE = "Failed to request; retrying in 999 seconds";
+export function formatRetryCountdown(untilMs, nowMs) {
+    const seconds = Math.max(0, Math.ceil((untilMs - nowMs) / 1000));
+    return `Failed to request; retrying in ${seconds} second${seconds === 1 ? "" : "s"}`;
+}
+export function retryCountdownLive(untilMs) {
+    return {
+        kind: "countdown",
+        untilMs,
+        hz: 2,
+    };
+}
+/** 1Hz is enough for minute-rounding remaining labels. */
+export function quotaLive(windows, opts) {
+    const prefix = (opts?.prefix ?? "").trim();
+    return {
+        kind: "quota",
+        windows,
+        ...(prefix === "" ? {} : { prefix }),
+        hz: opts?.hz ?? 1,
+    };
+}
+/** Compact token count: `999`, `1.5k`, `10k`, `500k`. */
+export function formatTokenCount(n) {
+    if (!Number.isFinite(n) || n < 0)
+        return "0";
+    const x = Math.round(n);
+    if (x < 1000)
+        return `${x}`;
+    const k = x / 1000;
+    if (k < 10) {
+        const tenths = (Math.round(k * 10) / 10).toFixed(1);
+        return tenths.endsWith(".0") ? `${tenths.slice(0, -2)}k` : `${tenths}k`;
+    }
+    return `${Math.round(k)}k`;
+}
+/** `10k/500k`. Empty when neither used nor a window exists. A known window paints `0/500k`. */
+export function formatContextOccupancy(used, limit) {
+    const hasLimit = Number.isFinite(limit) && limit > 0;
+    const hasUsed = Number.isFinite(used) && used > 0;
+    if (!hasLimit && !hasUsed)
+        return "";
+    if (!hasLimit)
+        return formatTokenCount(used);
+    return `${formatTokenCount(Number.isFinite(used) && used > 0 ? used : 0)}/${formatTokenCount(limit)}`;
+}
+/** Occupancy prefix joined with live remaining, e.g. `10k/500k · 51% left for 5 hours`. */
+export function formatHeldStatus(prefix, windows, nowMs) {
+    const occupancy = prefix.trim();
+    const quota = formatQuotaWindows(windows, nowMs);
+    if (occupancy === "")
+        return quota;
+    return quota === "" ? occupancy : `${occupancy} · ${quota}`;
+}
+/**
+ * Narrow rails drop the spelled quota and keep occupancy. Occupancy is the
+ * shorter chip (`10k/500k`); the full hint is `occupancy · 51% left for …`.
+ * A rail with no occupancy has nothing shorter to fall back to.
+ */
+export function formatHeldStatusFit(prefix, windows, nowMs, maxColumns, measure) {
+    const full = formatHeldStatus(prefix, windows, nowMs);
+    if (maxColumns <= 0 || measure(full) <= maxColumns)
+        return full;
+    const occupancy = prefix.trim();
+    if (occupancy === "" || occupancy === full)
+        return full;
+    return measure(occupancy) <= maxColumns ? occupancy : full;
+}
+export function birthLive(opts) {
+    return {
+        kind: "birth",
+        siteId: opts.siteId,
+        T: opts.T,
+        offset: opts.offset,
+        target: opts.target,
+        birthFloor: opts.birthFloor,
+        falloff: opts.falloff,
+        tipWindow: opts.tipWindow,
+        hz: 0,
+    };
+}
+/** Resolve spinner glyph for wall clock (ms). */
+export function resolveSpinnerGlyph(profile, nowMs) {
+    const frames = SPINNER_GLYPHS[profile] ?? SPINNER_GLYPHS.working;
+    if (frames.length === 0)
+        return "·";
+    const hz = SPINNER_HZ[profile] ?? 10;
+    const i = Math.floor((Math.max(0, nowMs) * hz) / 1000) % frames.length;
+    return frames[i] ?? frames[0];
+}
+/** Compact duration — paint-side only. */
+export function formatElapsedCompact(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return "";
+    const s = ms / 1000;
+    if (s < 1)
+        return "<1s";
+    if (s < 60) {
+        // In-motion: always one tenth so `3.0s` does not collapse to `3s`
+        // and shift the ghost overlay.
+        return `${s.toFixed(1)}s`;
+    }
+    const m = Math.floor(s / 60);
+    const rem = Math.round(s % 60);
+    return rem > 0 ? `${m}m ${rem}s` : `${m}m`;
+}
+/**
+ * Spelled remaining duration. Same grammar as connect.scm `paint-reset`:
+ * nearest minute; skip a leftover 1 minute at hour scale; 59 minutes rounds
+ * up; days keep leftover hours, not minutes.
+ */
+export function formatRemainingSpelled(remainingMs) {
+    if (!Number.isFinite(remainingMs))
+        return "";
+    const s = Math.max(0, Math.round(remainingMs / 1000));
+    const mins = s === 0 ? 0 : Math.max(1, Math.trunc((s + 30) / 60));
+    if (mins === 0)
+        return "";
+    if (mins < 60)
+        return countWord(mins, "minute");
+    if (mins < 1440) {
+        const h = Math.trunc(mins / 60);
+        const m = mins % 60;
+        if (m === 0 || m === 1)
+            return hoursPhrase(h);
+        if (m === 59)
+            return hoursPhrase(h + 1);
+        return `${countWord(h, "hour")} and ${countWord(m, "minute")}`;
+    }
+    const d = Math.trunc(mins / 1440);
+    const h = Math.trunc((mins % 1440) / 60);
+    if (h === 0)
+        return countWord(d, "day");
+    return `${countWord(d, "day")} and ${countWord(h, "hour")}`;
+}
+export function formatQuotaWindows(windows, nowMs) {
+    const bits = [];
+    for (const window of windows) {
+        const bit = formatQuotaWindow(window, nowMs);
+        if (bit !== "")
+            bits.push(bit);
+    }
+    return bits.join(" · ");
+}
+function formatQuotaWindow(window, nowMs) {
+    if (!Number.isFinite(window.remainingPercent))
+        return "";
+    const left = `${Math.round(Math.max(0, window.remainingPercent))}%`;
+    if (window.resetAt == null || !Number.isFinite(window.resetAt))
+        return left;
+    // A reset deadline expires the snapshot, not just its countdown. Keep the
+    // window hidden until the provider reports fresh usage; assuming 100% here
+    // would also be wrong if another client has already consumed the new window.
+    if (window.resetAt * 1000 <= nowMs)
+        return "";
+    const until = formatRemainingSpelled(window.resetAt * 1000 - nowMs);
+    return until === "" ? left : `${left} left for ${until}`;
+}
+function countWord(n, unit) {
+    return `${n} ${unit}${n === 1 ? "" : "s"}`;
+}
+function hoursPhrase(h) {
+    return h >= 24 ? countWord(Math.trunc(h / 24), "day") : countWord(h, "hour");
+}
+/** Resolve live op to display string at nowMs. Birth is style, not a label. */
+export function resolveLiveText(live, nowMs) {
+    if (live.kind === "spinner") {
+        return resolveSpinnerGlyph(live.profile, nowMs);
+    }
+    if (live.kind === "birth")
+        return "";
+    if (live.kind === "quota") {
+        return formatHeldStatus(live.prefix ?? "", live.windows, nowMs);
+    }
+    if (live.kind === "countdown") {
+        return formatRetryCountdown(live.untilMs, nowMs);
+    }
+    const elapsed = Math.max(0, nowMs - live.startedAt);
+    const label = live.label ?? "thinking";
+    const body = elapsed < 500 ? label : `${label} · ${formatElapsedCompact(elapsed)}`;
+    return live.prefix == null ? body : `${live.prefix}${formatElapsedCompact(elapsed)}`;
+}
+/** Scan paint order for live demand (after layout). */
+export function collectLiveDemand(paintOrder) {
+    let maxHz = 0;
+    let spinners = 0;
+    let elapsed = 0;
+    let quota = 0;
+    let birth = 0;
+    for (const pos of paintOrder) {
+        for (const op of pos.paint) {
+            if (op.kind !== "live")
+                continue;
+            maxHz = Math.max(maxHz, op.live.hz);
+            switch (op.live.kind) {
+                case "spinner": {
+                    spinners += 1;
+                    break;
+                }
+                case "elapsed":
+                case "countdown": {
+                    elapsed += 1;
+                    break;
+                }
+                case "quota": {
+                    quota += 1;
+                    break;
+                }
+                default:
+                    birth += 1;
+            }
+        }
+    }
+    return { maxHz, spinners, elapsed, quota, birth };
+}
+//# sourceMappingURL=live_paint.js.map

package/dist/layout/live_paint.js.map

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

package/dist/layout/markdown.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Markdown subset → LayoutNode tree (our engine only).
+ * No external MD library. CSI stripped by caller via guard when needed.
+ */
+import type { LayoutNode } from "./types.js";
+import type { Style } from "../buffer/index.js";
+export type MarkdownOpts = {
+    key?: string;
+    baseStyle?: Style;
+};
+/** Inline: **bold**, *italic*, `code`, `[text](url)` — one markdown line. */
+export declare function markdownInlineSegs(line: string, base?: Style): {
+    text: string;
+    style: Style;
+}[];
+/**
+ * Parse markdown subset into a column of text nodes.
+ * Headings bold; lists prefixed; fences as code_pad indentation_exception.
+ * Cached so measure+place share node identity (and wrap-cache hits).
+ */
+export declare function markdownToNodes(src: string, opts?: MarkdownOpts): LayoutNode[];
+//# sourceMappingURL=markdown.d.ts.map

package/dist/layout/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/layout/markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,CAAC;AAWF,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,KAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,EAAE,CAmCnG;AA8BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,UAAU,EAAE,CAelF"}

package/dist/layout/markdown.js

@@ -0,0 +1,167 @@
+/**
+ * Markdown subset → LayoutNode tree (our engine only).
+ * No external MD library. CSI stripped by caller via guard when needed.
+ */
+import { FgP } from "../lexicon/index.js";
+/** Body voice — one HK-adjusted prominence. Headings lift to primary. */
+function voiceBase(style) {
+    return {
+        ...style,
+        role: style?.role ?? "foreground",
+        prominence: style?.prominence ?? FgP.secondary,
+    };
+}
+/** Inline: **bold**, *italic*, `code`, `[text](url)` — one markdown line. */
+export function markdownInlineSegs(line, base = {}) {
+    const segs = [];
+    const re = /(\*\*[^*]+\*\*|\*[^*]+\*|`[^`]+`|\[[^\]]+\]\([^)]+\))/g;
+    let last = 0;
+    let m;
+    while ((m = re.exec(line)) !== null) {
+        if (m.index > last) {
+            segs.push({ text: line.slice(last, m.index), style: base });
+        }
+        const tok = m[0];
+        if (tok.startsWith("**")) {
+            segs.push({
+                text: tok.slice(2, -2),
+                style: { ...base, bold: true },
+            });
+        }
+        else if (tok.startsWith("*")) {
+            segs.push({ text: tok.slice(1, -1), style: { ...base, italic: true } });
+        }
+        else if (tok.startsWith("`")) {
+            segs.push({
+                text: tok.slice(1, -1),
+                style: { ...base, role: "code" }, // keep body prominence
+            });
+        }
+        else if (tok.startsWith("[")) {
+            const close = tok.indexOf("]");
+            const label = close > 0 ? tok.slice(1, close) : tok;
+            segs.push({
+                text: label.length > 0 ? label : " ",
+                style: { ...base, role: "accent", underline: true },
+            });
+        }
+        last = m.index + tok.length;
+    }
+    if (last < line.length)
+        segs.push({ text: line.slice(last), style: base });
+    if (segs.length === 0)
+        segs.push({ text: line, style: base });
+    return segs;
+}
+function lineNode(key, line, style) {
+    // engine text is single-style per leaf; flatten bold runs by joining with markers lost → best-effort: strip markers for single style
+    const plain = line
+        .replaceAll(/\*\*([^*]+)\*\*/g, "$1")
+        .replaceAll(/\*([^*]+)\*/g, "$1")
+        .replaceAll(/`([^`]+)`/g, "$1");
+    const bold = /\*\*/.test(line);
+    const italic = !bold && /\*[^*]/.test(line);
+    return {
+        type: "text",
+        key,
+        content: plain,
+        style: { ...style, bold: bold || style.bold, italic: italic || style.italic },
+    };
+}
+const MD_CACHE_LIMIT = 64;
+const mdCache = new Map();
+function mdCacheKey(src, opts) {
+    const style = opts.baseStyle;
+    const styleKey = style == null
+        ? ""
+        : `${style.role ?? ""}:${String(style.prominence ?? "")}:${style.bold === true ? "b" : ""}:${style.italic === true ? "i" : ""}`;
+    return `${opts.key ?? "md"}\0${styleKey}\0${src}`;
+}
+/**
+ * Parse markdown subset into a column of text nodes.
+ * Headings bold; lists prefixed; fences as code_pad indentation_exception.
+ * Cached so measure+place share node identity (and wrap-cache hits).
+ */
+export function markdownToNodes(src, opts = {}) {
+    const cacheKey = mdCacheKey(src, opts);
+    const cached = mdCache.get(cacheKey);
+    if (cached !== undefined) {
+        mdCache.delete(cacheKey);
+        mdCache.set(cacheKey, cached);
+        return cached;
+    }
+    const out = parseMarkdownNodes(src, opts);
+    if (mdCache.size >= MD_CACHE_LIMIT) {
+        const oldest = mdCache.keys().next().value;
+        if (oldest !== undefined)
+            mdCache.delete(oldest);
+    }
+    mdCache.set(cacheKey, out);
+    return out;
+}
+function parseMarkdownNodes(src, opts) {
+    const base = voiceBase(opts.baseStyle);
+    const heading = { ...base, prominence: FgP.primary };
+    const key = opts.key ?? "md";
+    const lines = src.replaceAll("\r\n", "\n").split("\n");
+    const out = [];
+    let i = 0;
+    let n = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // fenced code
+        if (line.trimStart().startsWith("```")) {
+            const body = [];
+            i++;
+            while (i < lines.length && !lines[i].trimStart().startsWith("```")) {
+                body.push(lines[i]);
+                i++;
+            }
+            if (i < lines.length)
+                i++; // close fence
+            out.push({
+                type: "indentation_exception",
+                key: `${key}:fence-${n++}`,
+                kind: "code_pad",
+                children: body.map((l, j) => ({
+                    type: "text",
+                    key: `${key}:c${n}-${j}`,
+                    content: l,
+                    style: { role: "code", prominence: base.prominence ?? FgP.secondary },
+                })),
+            });
+            continue;
+        }
+        // Headings: same role as body, primary prominence. No emphasis hue.
+        if (line.startsWith("### ")) {
+            out.push(lineNode(`${key}:h3-${n++}`, line.slice(4), heading));
+            i++;
+            continue;
+        }
+        if (line.startsWith("## ")) {
+            out.push(lineNode(`${key}:h2-${n++}`, line.slice(3), heading));
+            i++;
+            continue;
+        }
+        if (line.startsWith("# ")) {
+            out.push(lineNode(`${key}:h1-${n++}`, line.slice(2), heading));
+            i++;
+            continue;
+        }
+        if (/^\s*[-*]\s+/.test(line)) {
+            const text = line.replace(/^\s*[-*]\s+/, "· ");
+            out.push(lineNode(`${key}:li-${n++}`, text, base));
+            i++;
+            continue;
+        }
+        if (line.trim() === "") {
+            out.push({ type: "text", key: `${key}:sp-${n++}`, content: " " });
+            i++;
+            continue;
+        }
+        out.push(lineNode(`${key}:p-${n++}`, line, base));
+        i++;
+    }
+    return out.length > 0 ? out : [{ type: "text", key: `${key}:empty`, content: "" }];
+}
+//# sourceMappingURL=markdown.js.map