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

package/dist/layout/birth.js

@@ -0,0 +1,148 @@
+/**
+ * Opacity wavefront — present-clock motion, same plane as spinner.
+ *
+ *   W  = left edge of “solid” (wavefront)
+ *   T  = newest-line ink mass (older peek lanes are age-dim only)
+ *
+ * Prominence is distance-from-W, never band-normalized:
+ *
+ *   p(x) = target · falloff^max(0, x − W)   (floored at birthFloor; 0 = ground)
+ *
+ * While T grows, chase A = T − tipWindow and record that catch-up speed as
+ * impulse. When T is frozen (or sealed), A = T and W coasts at the carried
+ * impulse — no gap ease-out, no settle ramp.
+ *
+ * Host steps W; paint samples it. Widget constructors do not bake per-char
+ * prominence or rebuild on the present tick.
+ */
+/** Per-column opacity multiplier past W (`target · falloff^distance`). */
+export const WAVEFRONT_FALLOFF = 0.8;
+export const BIRTH_FRONTIER_DEFAULTS = {
+    tipWindow: 12,
+    birthFloor: 0,
+    falloff: WAVEFRONT_FALLOFF,
+    edgeWidth: 1,
+    baseColsPerSec: 8,
+    gapGain: 2.4,
+    maxColsPerSec: 96,
+};
+export function createBirthFrontier(init) {
+    const T = init?.T ?? 0;
+    const tipW = BIRTH_FRONTIER_DEFAULTS.tipWindow;
+    const W = init?.W ?? (T > 0 ? Math.max(0, T - tipW) : 0);
+    return {
+        W,
+        T,
+        lastStepMs: init?.lastStepMs ?? null,
+        sealed: init?.sealed ?? false,
+        lastAdvanceMs: init?.lastAdvanceMs ?? null,
+        v: init?.v ?? (T > W ? wavefrontSpeed(T - W) : 0),
+    };
+}
+export function birthFrontierLive(state) {
+    if (state.T <= 0)
+        return false;
+    return state.W + 1e-6 < state.T;
+}
+/**
+ * Hot-path catch-up speed (cols/s): grows with gap behind tip.
+ * Endgame does not call this — it coasts at the carried impulse.
+ */
+export function wavefrontSpeed(gap, opts = {}) {
+    const d = { ...BIRTH_FRONTIER_DEFAULTS, ...opts };
+    const g = Math.max(0, gap);
+    return Math.min(d.maxColsPerSec, Math.max(0, d.baseColsPerSec + d.gapGain * g));
+}
+/**
+ * Prominence at continuous stream position `pos`.
+ *
+ * Absolute distance from wavefront — **not** normalized by (T−W).
+ *
+ *   p = target · falloff^max(0, pos − W) , floored at birthFloor
+ *
+ * `T` only gates “fully solid when wavefront has sealed past ink”.
+ */
+export function wavefrontProminence(pos, W, T, targetP, opts = {}) {
+    const d = { ...BIRTH_FRONTIER_DEFAULTS, ...opts };
+    const target = clamp01(targetP);
+    const floor = clamp01(d.birthFloor);
+    if (T <= 0)
+        return target;
+    if (W >= T - 1e-9)
+        return target;
+    const w = Math.max(0, W);
+    const dist = pos - w;
+    if (dist <= 0) {
+        const edgeW = Math.max(1e-6, d.edgeWidth);
+        if (dist <= -edgeW)
+            return target;
+        const intoSolid = -dist / edgeW;
+        const t = smoothstep01(intoSolid);
+        const atEdge = Math.max(floor, target);
+        return target * t + atEdge * (1 - t);
+    }
+    const base = Math.min(0.999, Math.max(1e-6, d.falloff));
+    const raw = target * Math.pow(base, dist);
+    return Math.max(floor, Math.min(target, raw));
+}
+/** Step wavefront. Pure. */
+export function stepBirthFrontier(state, input, opts = {}) {
+    const d = { ...BIRTH_FRONTIER_DEFAULTS, ...opts };
+    const T = Math.max(0, input.T);
+    const nowMs = input.nowMs;
+    const sealed = input.sealed === true || state.sealed;
+    let W = state.W;
+    let v = state.v ?? 0;
+    let lastAdvanceMs = state.lastAdvanceMs;
+    const tipGrew = T > state.T + 1e-9;
+    const tipShrunk = T < state.T - 1e-9;
+    if (tipGrew || lastAdvanceMs == null)
+        lastAdvanceMs = nowMs;
+    // New peek line: T drops to the overflow. Restart from the left; keep
+    // impulse so the new line coasts at the speed the last one had.
+    if (tipShrunk)
+        W = 0;
+    const frozen = sealed || !tipGrew;
+    const lag = frozen || T <= d.tipWindow ? 0 : d.tipWindow;
+    const A = Math.max(0, T - lag);
+    if (state.lastStepMs == null) {
+        W = sealed ? T : Math.max(0, T - d.tipWindow);
+        v = wavefrontSpeed(T - W, d);
+    }
+    else {
+        const dtSec = Math.min(0.25, Math.max(0, (nowMs - state.lastStepMs) / 1000));
+        // Refresh impulse only while actually catching up. Parked-in-lag and
+        // frozen ticks keep the last speed so endgame does not ease out.
+        if ((!frozen && A > W) || v <= 0)
+            v = wavefrontSpeed(T - W, d);
+        if (dtSec > 0 && A > W)
+            W = Math.min(A, W + v * dtSec);
+    }
+    W = clamp(W, 0, T);
+    // SNAP-TO-T: 0.15 live / 0.5 sealed so `birthFrontierLive` (`W + 1e-6 < T`)
+    // can go false. Without the snap, float crawl keeps that true and the
+    // flourish timer never dies.
+    if (T - W < (sealed ? 0.5 : 0.15))
+        W = T;
+    return {
+        W,
+        T,
+        lastStepMs: nowMs,
+        sealed,
+        lastAdvanceMs,
+        v,
+    };
+}
+function smoothstep01(t) {
+    const x = clamp(t, 0, 1);
+    return x * x * (3 - 2 * x);
+}
+function clamp(n, lo, hi) {
+    return Math.min(hi, Math.max(lo, n));
+}
+function clamp01(n) {
+    if (!Number.isFinite(n))
+        return 1;
+    return Math.min(1, Math.max(0, n));
+}
+//# sourceMappingURL=birth.js.map

package/dist/layout/birth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"birth.js","sourceRoot":"","sources":["../../src/layout/birth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAsBrC,MAAM,CAAC,MAAM,uBAAuB,GAA0B;IAC5D,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,iBAAiB;IAC1B,SAAS,EAAE,CAAC;IACZ,cAAc,EAAE,CAAC;IACjB,OAAO,EAAE,GAAG;IACZ,aAAa,EAAE,EAAE;CAClB,CAAC;AAuBF,MAAM,UAAU,mBAAmB,CAAC,IAAkC;IACpE,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,uBAAuB,CAAC,SAAS,CAAC;IAC/C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,CAAC;QACD,CAAC;QACD,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,IAAI;QACpC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;QAC7B,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,IAAI;QAC1C,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,OAA0B,EAAE;IACtE,MAAM,CAAC,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,IAAI,EAAE,CAAC;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,CAAS,EACT,CAAS,EACT,OAAe,EACf,OAA0B,EAAE;IAE5B,MAAM,CAAC,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,IAAI,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI;QAAE,OAAO,MAAM,CAAC;IAEjC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC;IACrB,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC;QAClC,MAAM,SAAS,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC;QAChC,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,iBAAiB,CAC/B,KAAyB,EACzB,KAAyB,EACzB,OAA0B,EAAE;IAE5B,MAAM,CAAC,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,IAAI,EAAE,CAAC;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;IAErD,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAChB,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;IACxC,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IACnC,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAErC,IAAI,OAAO,IAAI,aAAa,IAAI,IAAI;QAAE,aAAa,GAAG,KAAK,CAAC;IAC5D,sEAAsE;IACtE,gEAAgE;IAChE,IAAI,SAAS;QAAE,CAAC,GAAG,CAAC,CAAC;IAErB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC7B,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7E,qEAAqE;QACrE,iEAAiE;QACjE,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnB,4EAA4E;IAC5E,sEAAsE;IACtE,6BAA6B;IAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC;IAEzC,OAAO;QACL,CAAC;QACD,CAAC;QACD,UAAU,EAAE,KAAK;QACjB,MAAM;QACN,aAAa;QACb,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,KAAK,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/layout/children.d.ts

@@ -0,0 +1,5 @@
+import type { LayoutNode } from "./types.js";
+export declare function layoutChildren(node: LayoutNode): readonly LayoutNode[];
+/** Spread of a LayoutNode union does not re-join. */
+export declare function mapLayoutChildren(node: LayoutNode, map: (child: LayoutNode) => LayoutNode): LayoutNode;
+//# sourceMappingURL=children.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"children.d.ts","sourceRoot":"","sources":["../../src/layout/children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAEtE;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,GAAG,UAAU,CAUtG"}

package/dist/layout/children.js

@@ -0,0 +1,19 @@
+export function layoutChildren(node) {
+    return "children" in node && Array.isArray(node.children) ? node.children : [];
+}
+/** Spread of a LayoutNode union does not re-join. */
+export function mapLayoutChildren(node, map) {
+    if (!("children" in node) || !Array.isArray(node.children))
+        return node;
+    let changed = false;
+    const children = node.children.map((child) => {
+        const next = map(child);
+        if (next !== child)
+            changed = true;
+        return next;
+    });
+    if (!changed)
+        return node;
+    return { ...node, children };
+}
+//# sourceMappingURL=children.js.map

package/dist/layout/children.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"children.js","sourceRoot":"","sources":["../../src/layout/children.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,OAAO,UAAU,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,IAAgB,EAAE,GAAsC;IACxF,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,GAAG,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAgB,CAAC;AAC7C,CAAC"}

package/dist/layout/chrome_frame.d.ts

@@ -0,0 +1,254 @@
+/**
+ * ChromeFrame — special layout strategy for boxed prompt chrome.
+ *
+ * Same pattern as Indication: **one lineage** for measure, place, paint, HTML.
+ * Not flex assembly. Outer width is fixed; edges always span it; body sides
+ * track bodyH. Multi-role edge segments (progress rail, hint rule) are first-class.
+ *
+ * Geometry law:
+ *   outerW  = explicit width (clamped to alloc)
+ *   textW   = outerW - 4   // │ + mark + gap + │
+ *   bodyH   = wrap(draft, textW, pre-wrap).length  (≥1)
+ *   totalH  = bodyH + 2    // top + bottom edges
+ *   body cells: │ · text… │  (mark cell: space, picker `›`, or a counter)
+ *   The line above the draft is one chrome rule (shortcuts left / annotation
+ *   right). The hint is flex:0 — keys, colons, actions, and ` · ` take
+ *   their intrinsic width. Only the annotation (filename) shrinks. If the
+ *   hint itself overflows the band, trailing bindings drop as whole units.
+ *   Solo frame fuses that into ╭╮. A stacked frame (joinBottom) splits:
+ *   annotation stays on ╭╮; shortcuts ride the ├┤ T-join, with optional
+ *   joinAnnotation on that same rule's right (session title / above-input).
+ *   No annotation → stacked ╭╮ stays plain (slash catalog).
+ *   Occupied right-rail slots (annotation, status) sit a space plus one
+ *   contour cell off the corner — occupied rims end ` ─╮` / ` ─╯`.
+ *   body hit  = **text column only** (not side bars / mark).
+ *     Selection/copy/contain use this rect — borders are chrome, not content.
+ *     Caret park reads y/h from the same hit; col is content-relative.
+ */
+import { type ChromeQuotaWindow, type LivePaint } from "./live_paint.js";
+import { type ChromeHotkey } from "./paint-hotkey.js";
+import type { ChromeStatusItem, LayoutNode, PaintOp, Rect } from "./types.js";
+import type { Style } from "../buffer/index.js";
+import { type FgProminence } from "../lexicon/index.js";
+export declare const CHROME_FRAME_CHROME_ROWS: 2;
+/** Mark cell default — empty. Picker selection paints `›` via bodyGlyphs. */
+export declare const CHROME_FRAME_DEFAULT_GLYPH = " ";
+/** │ + mark + gap + │ — subtracted from outerW to get the draft column. */
+export declare const CHROME_FRAME_BODY_CHROME: 4;
+/** Default fill hue — contour, not muted. Chroma is warning tint only. */
+export declare const CHROME_FRAME_DEFAULT_PROGRESS_ROLE = "foreground";
+/** Remaining fraction where the fill starts mixing into warning. */
+export declare const CHROME_FRAME_DEFAULT_PROGRESS_GLOW_AT = 0.75;
+/** Hot hue mixed in as remaining drops below {@link CHROME_FRAME_DEFAULT_PROGRESS_GLOW_AT}. */
+export declare const CHROME_FRAME_PROGRESS_GLOW_ROLE = "warning";
+/**
+ * Rounded box-drawing corners (Grok Build / Claude Code prompt chrome).
+ * Unicode light arcs — not square `┌┐└┘`.
+ *   ╭ ╮   U+256D / U+256E
+ *   ╰ ╯   U+2570 / U+256F
+ * (Confirmed in grok binary prompt glyph table: `┌┐└┘╭╮╰╯`.)
+ */
+export declare const CHROME_FRAME_CORNERS: {
+    readonly tl: "╭";
+    readonly tr: "╮";
+    readonly bl: "╰";
+    readonly br: "╯";
+};
+/** T-junction corners when stacking chrome frames (spotlight above input). */
+export declare const CHROME_FRAME_JOIN: {
+    readonly left: "├";
+    readonly right: "┤";
+};
+export type ChromeFrameNode = Extract<LayoutNode, {
+    type: "chrome_frame";
+}>;
+export type ChromeFrameGeom = {
+    outerW: number;
+    textW: number;
+    bodyLines: string[];
+    bodyH: number;
+    totalH: number;
+    glyph: string;
+};
+export type ChromeSeg = {
+    text: string;
+    style: Style;
+    live?: LivePaint;
+};
+/** Draft content width inside `│ · text │` (mark + gap + sides). */
+export declare function chromeFrameTextWidth(outerW: number): number;
+/** Columns from body left edge to the first text cell: `│ · ` → 3. */
+export declare function chromeFrameTextInset(): number;
+/** Text column width inside `│ · text │`. */
+export declare function chromeFrameContentWidth(outerW: number): number;
+export declare function chromeFrameBodyLines(draft: string, outerW: number, placeholder?: string): string[];
+/**
+ * True when the frame is showing empty-state placeholder chrome — body text
+ * is not real draft content and must not participate in text selection/copy
+ * (browser `<input placeholder>` model).
+ */
+export declare function isChromeFrameShowingPlaceholder(node: ChromeFrameNode): boolean;
+/**
+ * Total painted height = body + top chrome (unless omitted) + bottom chrome.
+ */
+export declare function chromeFrameTotalHeight(bodyH: number, opts?: {
+    omitTop?: boolean;
+}): number;
+/** True when shortcuts or annotation should ride the line above the draft. */
+export declare function chromeFrameHasHint(node: ChromeFrameNode): boolean;
+/**
+ * Progress fill geometry (bottom rail). Active run is **right-aligned**
+ * against the status chips; `rest` is the left contour. One role —
+ * paint ramps prominence and de-chromes into the contour.
+ */
+export type ProgressFillSegments = {
+    /** Integer cells of the active fill (right side). */
+    full: number;
+    /** 0..1 fill of the leading (left) boundary cell of the run. */
+    frac: number;
+    /** Left contour remainder. */
+    rest: number;
+    total: number;
+};
+/**
+ * Partition a bar budget into one fill + remainder. Partial cell is
+ * continuous in [0,1) so present can ease without snapping.
+ */
+export declare function progressFillSegments(budget: number, ratio: number): ProgressFillSegments;
+/**
+ * Ramp along the active run: t=0 is fully fused into the contour (p=0),
+ * t=1 is primary against the status chips. Prominence, not lightness —
+ * on light ground the loud end is darker. Hue stays contour until
+ * warning tint starts; no extra chroma on the fill role itself.
+ */
+export declare function progressRampProminence(t: number): number;
+/**
+ * Warning chroma for remaining-fill. 0 at/above `glowAt` remaining,
+ * 1 at empty runway. `glowAt` is the remaining fraction where orange starts.
+ */
+export declare function progressGlowTint(progress: number, glowAt: number): number;
+export declare function measureChromeFrame(node: ChromeFrameNode, maxW: number, maxH: number): ChromeFrameGeom;
+/**
+ * One full-width chrome rule: shortcuts left, annotation right, dashes between.
+ * Solo frame uses ╭╮. Stacked: call twice — annotation on ╭╮, shortcuts on ├┤.
+ */
+export declare function chromeFrameTopSegs(outerW: number, hotkeys: readonly ChromeHotkey[] | null | undefined, opts?: {
+    join?: boolean;
+    /** ╰╯ instead of ╭╮. Ignored when {@link join}. */
+    bottom?: boolean;
+    annotation?: string | null;
+    annotationRole?: string;
+    annotationSegs?: ChromeSeg[];
+    contourRole?: string;
+    contourProminence?: FgProminence;
+    modHeld?: boolean;
+}): ChromeSeg[];
+/** Plain bottom rule (no context bar) — optional T-join corners. */
+export declare function chromeFramePlainBottomSegs(outerW: number, opts?: {
+    join?: boolean;
+    contourRole?: string;
+    contourProminence?: FgProminence;
+}): ChromeSeg[];
+/**
+ * Top edge from multi-style content segs (between corners).
+ * Pads with contour dashes so corners stay at outerW.
+ */
+export declare function chromeFrameTopFromContentSegs(outerW: number, content: ChromeSeg[], opts?: {
+    contourRole?: string;
+    contourProminence?: FgProminence;
+}): ChromeSeg[];
+type StatusRailOpts = {
+    statusItems?: readonly ChromeStatusItem[];
+    quotaWindows?: readonly ChromeQuotaWindow[];
+    contextUsed?: number;
+    contextLimit?: number;
+    modHeld?: boolean;
+    nowMs?: number;
+};
+/** Joined status for measure / hit geometry. Leading space matches paint. */
+export declare function statusRightText(opts: StatusRailOpts): string;
+/** Bottom edge: optional one-hue progress ramp + status, spanning `outerW`. */
+export declare function chromeFrameBottomSegs(outerW: number, opts: {
+    progress?: number;
+    progressRole?: string;
+    /** Remaining fraction where warning chroma starts. Default 0.75. */
+    progressGlowAt?: number;
+    statusItems?: readonly ChromeStatusItem[];
+    quotaWindows?: readonly ChromeQuotaWindow[];
+    contextUsed?: number;
+    contextLimit?: number;
+    modHeld?: boolean;
+    nowMs?: number;
+    /** T-join corners when stacked under another frame. */
+    join?: boolean;
+    /** Skip progress rail — plain rule only. */
+    plain?: boolean;
+    /** Hue of ╰╯ and the unfilled rail. Default foreground. */
+    contourRole?: string;
+    contourProminence?: FgProminence;
+}): ChromeSeg[];
+/** One body row: `│ · text…(padded) │` — always `outerW` cells. */
+export declare function chromeFrameBodyRowSegs(line: string, row: number, outerW: number, glyph: string, opts?: {
+    placeholder?: boolean;
+    /**
+     * Absolute draft offsets of this visual line's content (`line` is
+     * draft.slice(lineStart, lineStart+line.length)). When set with
+     * `selA`/`selB`, selected runs paint with `selected: true`.
+     */
+    lineStart?: number;
+    selA?: number;
+    selB?: number;
+    /** Offsets ≥ this (into draft+completion) paint muted, not as draft. */
+    draftLength?: number;
+    /** 0..1 coverage of the right │ (ghost→primary). Omit → contour ghost. */
+    rightCoverage?: number;
+    contourRole?: string;
+    contourProminence?: FgProminence;
+}): ChromeSeg[];
+/**
+ * Visual body lines of a draft with absolute start offsets into the draft.
+ * Matches {@link chromeFrameBodyLines} partition for pre-wrap soft wrap.
+ */
+export declare function chromeFrameBodyLinesWithStarts(draft: string, outerW: number): Array<{
+    text: string;
+    start: number;
+}>;
+/**
+ * Body row from multi-style content segs.
+ *
+ * Aligned grid: `│ · text… │`   textW = outerW − 4
+ * Selection marks go in `glyph` (`›` / ` `), not in text.
+ */
+export declare function chromeFrameBodyFromContentSegs(content: ChromeSeg[], outerW: number, opts?: {
+    withGlyph?: boolean;
+    /** Glyph cell for this row (1 display col preferred). */
+    glyph?: string;
+    row?: number;
+    /** 0..1 coverage of the right │ (ghost→primary). Omit → contour ghost. */
+    rightCoverage?: number;
+    contourRole?: string;
+    contourProminence?: FgProminence;
+}): ChromeSeg[];
+/**
+ * Resolve glyph cell for body row i.
+ * bodyGlyphs wins; else draft mode uses frame glyph on row 0 only.
+ */
+export declare function chromeFrameRowGlyph(node: ChromeFrameNode, row: number, frameGlyph: string): string;
+/** Emit horizontal segment runs as text paint ops at (x, y). */
+export declare function segsToPaintOps(segs: ChromeSeg[], x: number, y: number, clipW: number): PaintOp[];
+/**
+ * Full paint ops for a chrome_frame placed at `rect`.
+ *
+ * Row map (always full `w` cells per edge/body line):
+ *   y+0          ╭╮ — solo: shortcuts + annotation; stacked: annotation only
+ *   y+1..y+bodyH body (`│  text… │`)
+ *   last         bottom edge, or ├┤ T-join carrying shortcuts + joinAnnotation
+ */
+export declare function chromeFramePaintOps(node: ChromeFrameNode, rect: Rect): {
+    ops: PaintOp[];
+    bodyHit: Rect;
+    progressHit: Rect;
+    geom: ChromeFrameGeom;
+};
+export {};
+//# sourceMappingURL=chrome_frame.d.ts.map

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

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