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

package/dist/layout/paint.js

@@ -0,0 +1,189 @@
+/**
+ * paintFrame: Frame → cell buffer. Always lowers styles through a resolver.
+ * Dual-dirty: reuse an existing Frame, pass a new theme.resolveStyle —
+ * zero layout() calls.
+ *
+ * Theme defaults to ambient {@link paintTheme} (active theme + depth). Hosts
+ * that attune at boot can omit the third arg; product present should still
+ * pass an explicit binding. Empty `{}` is not legal — resolveStyle is required.
+ */
+import { wavefrontProminence } from "./birth.js";
+import { resolveLiveText } from "./live_paint.js";
+import { paintTheme } from "./paint_theme.js";
+import { fillBgFx, put } from "../buffer/index.js";
+import { FgP } from "../lexicon/index.js";
+import { displayWidth, splitAtWidth, takeGrapheme } from "../measure/index.js";
+import { ansi256ToRgb } from "../theme/ansi256.js";
+function applyThemeStyle(style, theme) {
+    return theme.resolveStyle(style);
+}
+function inScissor(s, x, y) {
+    if (!s)
+        return true;
+    return x >= s.x && x < s.x + s.w && y >= s.y && y < s.y + s.h;
+}
+/** Skip a grapheme cluster if any of its cells sit outside the scissor. */
+function putInClip(buf, x, y, text, style, scissor) {
+    if (!scissor) {
+        put(buf, x, y, text, style);
+        return;
+    }
+    if (y < scissor.y || y >= scissor.y + scissor.h)
+        return;
+    const [head] = splitAtWidth(text, 10_000);
+    let cx = x;
+    let rest = head;
+    while (rest.length > 0) {
+        const [g, tail] = takeGrapheme(rest);
+        if (!g)
+            break;
+        const gW = Math.max(1, displayWidth(g));
+        let ok = true;
+        for (let k = 0; k < gW; k++) {
+            if (!inScissor(scissor, cx + k, y)) {
+                ok = false;
+                break;
+            }
+        }
+        if (ok)
+            put(buf, cx, y, g, style);
+        cx += gW;
+        rest = tail;
+    }
+}
+/** Resolve transparent ink against the furniture already painted beneath it. */
+function paintText(buf, x, y, text, intent, theme, scissor) {
+    const explicitSurface = intent.surfaceRole ||
+        intent.surfaceRgb ||
+        intent.fuseRole ||
+        intent.bgRole ||
+        intent.bgRgb ||
+        intent.bg !== undefined ||
+        intent.bgFx ||
+        intent.cast === "transparent";
+    if (explicitSurface || y < 0 || y >= buf.height) {
+        putInClip(buf, x, y, text, applyThemeStyle(intent, theme), scissor);
+        return;
+    }
+    let col = x;
+    let remaining = text;
+    const styles = new Map();
+    while (remaining.length > 0) {
+        const [head, tail] = takeGrapheme(remaining);
+        if (!head)
+            break;
+        const under = col >= 0 && col < buf.width ? buf.cells[y * buf.width + col]?.style : undefined;
+        const surfaceRgb = under?.bgRgb ?? (under?.bg === undefined ? undefined : ansi256ToRgb(under.bg));
+        const key = surfaceRgb ? `${surfaceRgb.r},${surfaceRgb.g},${surfaceRgb.b}` : "ground";
+        let style = styles.get(key);
+        if (!style) {
+            style = applyThemeStyle(surfaceRgb ? { ...intent, surfaceRgb } : intent, theme);
+            styles.set(key, style);
+        }
+        putInClip(buf, col, y, head, style, scissor);
+        col += Math.max(1, displayWidth(head));
+        remaining = tail;
+    }
+}
+function paintBirthLine(buf, op, theme, birth, scissor) {
+    const live = op.live;
+    if (live.kind !== "birth")
+        return;
+    const src = op.content ?? "";
+    if (!src)
+        return;
+    const rest = Math.max(0, live.T - live.tipWindow);
+    const W = birth?.get(live.siteId) ?? rest;
+    const fieldOpts = { birthFloor: live.birthFloor, falloff: live.falloff };
+    let col = 0;
+    let restText = src;
+    while (restText.length > 0 && col < op.rect.w) {
+        const [head, tail] = takeGrapheme(restText);
+        if (!head)
+            break;
+        const gW = Math.max(1, displayWidth(head));
+        const mid = live.offset + col + gW / 2;
+        const p = wavefrontProminence(mid, W, live.T, live.target, fieldOpts);
+        if (p <= 1 / 255) {
+            col += gW;
+            restText = tail;
+            continue;
+        }
+        paintText(buf, op.rect.x + col, op.rect.y, head, { ...op.style, prominence: p }, theme, scissor);
+        col += gW;
+        restText = tail;
+    }
+}
+export function paintFrame(frame, buf, theme = paintTheme(), opts = {}) {
+    const nowMs = opts.nowMs ?? Date.now();
+    for (const pos of frame.paintOrder) {
+        const scissor = pos.clip;
+        for (const op of pos.paint) {
+            switch (op.kind) {
+                case "live": {
+                    if (op.live.kind === "birth") {
+                        paintBirthLine(buf, op, theme, opts.birth, scissor);
+                        break;
+                    }
+                    const text = resolveLiveText(op.live, nowMs);
+                    // Spinner is 1 cell; elapsed is one line clipped to rect.w columns.
+                    const [line] = splitAtWidth(text, Math.max(1, op.rect.w));
+                    paintText(buf, op.rect.x, op.rect.y, line || " ", op.style, theme, scissor);
+                    break;
+                }
+                case "fill": {
+                    const style = applyThemeStyle(op.style, theme);
+                    // Procedural bg: write markers + baked UV only. Present materializes RGB.
+                    if (style.bgFx) {
+                        fillBgFx(buf, op.rect, style.bgFx, scissor);
+                        break;
+                    }
+                    const ch = " ";
+                    for (let dy = 0; dy < op.rect.h; dy++) {
+                        putInClip(buf, op.rect.x, op.rect.y + dy, ch.repeat(Math.max(0, op.rect.w)), style, scissor);
+                    }
+                    break;
+                }
+                case "border": {
+                    // Unstyled border ops (no fg/fgRgb/role stated) default to the
+                    // border role at ghost prominence — the system-wide default
+                    // border, never a bare index.
+                    const base = op.style.fg === undefined && !op.style.fgRgb && !op.style.role
+                        ? { ...op.style, role: "border", prominence: op.style.prominence ?? FgP.ghost }
+                        : op.style;
+                    const style = applyThemeStyle(base, theme);
+                    const { x, y, w, h } = op.rect;
+                    if (w <= 0 || h <= 0)
+                        break;
+                    const hLine = "─".repeat(Math.max(0, w - 2));
+                    if (h >= 1) {
+                        const top = w >= 2 ? `┌${hLine}┐` : "│";
+                        putInClip(buf, x, y, top.slice(0, w), style, scissor);
+                    }
+                    if (h >= 2) {
+                        const bot = w >= 2 ? `└${hLine}┘` : "│";
+                        putInClip(buf, x, y + h - 1, bot.slice(0, w), style, scissor);
+                    }
+                    for (let dy = 1; dy < h - 1; dy++) {
+                        putInClip(buf, x, y + dy, "│", style, scissor);
+                        if (w >= 2)
+                            putInClip(buf, x + w - 1, y + dy, "│", style, scissor);
+                    }
+                    break;
+                }
+                case "text": {
+                    for (let i = 0; i < op.lines.length && i < op.rect.h; i++) {
+                        // Clip by display columns, not code units (CJK/emoji safe).
+                        const [head] = splitAtWidth(op.lines[i], op.rect.w);
+                        paintText(buf, op.rect.x, op.rect.y + i, head, op.style, theme, scissor);
+                    }
+                    break;
+                }
+                case "raw":
+                    op.paint(op.rect, buf);
+                    break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=paint.js.map

package/dist/layout/paint.js.map

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

package/dist/layout/paint_theme.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Theme → paint binding: a {@link Theme} plus a {@link ColorDepth} become the
+ * `resolveStyle` callback `paintFrame` calls per style. Dual-dirty recolor is
+ * exactly re-binding this and painting the SAME frame again.
+ *
+ * `attuneTheme` is the explicit form and the one new callers should use: pass a
+ * theme, get its paint binding, hold it. Live ground changes go through
+ * {@link ThemeStore} (host reaction drops cached RGB; polarity flip drops the
+ * Frame). The module-level `active` / `depth` below are an AMBIENT fallback
+ * for the deprecated tree's builders, which read the theme from nowhere; they
+ * are not a second source of truth for anyone who can pass an argument. A host
+ * that relies on the ambient pair must SET it at boot — reading it without
+ * ever calling `setActiveTheme` is how a session silently paints the untuned
+ * default ground no matter what the terminal actually is.
+ *
+ * Lives in layout, not theme: `PaintTheme` is layout's own type and `Style` is
+ * buffer's, both of which theme deliberately avoids depending on (it mirrors
+ * `Style` structurally as `StyleLike` for that reason).
+ */
+import type { Theme as PaintTheme } from "./types.js";
+import { type ColorDepth } from "../capabilities/index.js";
+import type { Rgb } from "../lexicon/index.js";
+import { type Theme } from "../theme/index.js";
+/** Replace active theme (e.g. after OSC 11 attunement). */
+export declare function setActiveTheme(theme: Theme): void;
+export declare function setColorDepth(d: ColorDepth): void;
+/**
+ * A theme and its paint binding, together.
+ *
+ * The pair, not either half, is what a host actually needs: `paint` goes to
+ * `paintFrame`, and `theme.ground` is what selection recolor levels against.
+ * Holding one of these is the explicit alternative to reading the ambient
+ * globals — which is why it carries no setter.
+ */
+export interface ThemeBinding {
+    readonly theme: Theme;
+    readonly depth: ColorDepth;
+    /** `resolveStyle` bound to `theme` + `depth`. Pass straight to `paintFrame`. */
+    readonly paint: PaintTheme;
+}
+/**
+ * Build a binding from an explicit theme (or a measured ground OKLCH L, which
+ * rebuilds the seed table against it). Touches no module state in either
+ * direction: a host that calls this owns its theme.
+ *
+ * Pass `depth` explicitly whenever a real answer exists — the canonical
+ * source is `resolvePresentConfig().colorDepth`
+ * (`../runtime/index.js`, itself falling back to
+ * `guessColorDepth(env)` from capabilities when no probe ran, so `NO_COLOR`
+ * still reaches `mono` without a TTY probe). When `depth` is omitted (probe
+ * threw, host has no caps yet), fall back to `guessColorDepth()` — an honest
+ * env read (COLORTERM/TERM/NO_COLOR), never a hard demotion to `ansi16`.
+ * Hard-ansi16 was collapsing truecolor sessions to 16 colors whenever the
+ * OSC probe timed out; env is the right under-claim ladder for that case.
+ */
+export declare function attuneTheme(opts?: {
+    theme?: Theme;
+    /** Ground OKLCH L from OSC 11 (`groundFromOsc11`). Ignored when `theme` is given. */
+    ground?: number;
+    /** Probed terminal background RGB. Ignored when `theme` is given. */
+    groundRgb?: Rgb;
+    depth?: ColorDepth;
+    /**
+     * Default region prominence (backdrop fade of ALL paint) — its own axis,
+     * never the BG ladder. Bare 0–1, not a {@link BgProminence}: `BgP` is fill
+     * solidity of painted furniture, a call-site-level `bgProminence`, not this.
+     */
+    regionProminence?: number;
+}): ThemeBinding;
+/**
+ * Layout paint Theme with ColorResolver bound to the given theme/depth, or to
+ * the ambient pair when omitted (the deprecated builders' path).
+ */
+export declare function paintTheme(opts?: {
+    theme?: Theme;
+    depth?: ColorDepth;
+    /**
+     * Backdrop fade of ALL paint (fg + bg alike) — its own argument, never the
+     * BG ladder. A bare 0–1, not a {@link BgProminence}: conflating the two
+     * (passing `BgP.wash` here) mixes "how solid is this furniture" into "how
+     * present is this whole region", which are independent per decision 1.
+     */
+    regionProminence?: number;
+}): PaintTheme;
+//# sourceMappingURL=paint_theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paint_theme.d.ts","sourceRoot":"","sources":["../../src/layout/paint_theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAA8D,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK3G,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEjD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAEjD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,IAAI,GAAE;IACJ,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACtB,GACL,YAAY,CAed;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,UAAU,CAWb"}

package/dist/layout/paint_theme.js

@@ -0,0 +1,76 @@
+/**
+ * Theme → paint binding: a {@link Theme} plus a {@link ColorDepth} become the
+ * `resolveStyle` callback `paintFrame` calls per style. Dual-dirty recolor is
+ * exactly re-binding this and painting the SAME frame again.
+ *
+ * `attuneTheme` is the explicit form and the one new callers should use: pass a
+ * theme, get its paint binding, hold it. Live ground changes go through
+ * {@link ThemeStore} (host reaction drops cached RGB; polarity flip drops the
+ * Frame). The module-level `active` / `depth` below are an AMBIENT fallback
+ * for the deprecated tree's builders, which read the theme from nowhere; they
+ * are not a second source of truth for anyone who can pass an argument. A host
+ * that relies on the ambient pair must SET it at boot — reading it without
+ * ever calling `setActiveTheme` is how a session silently paints the untuned
+ * default ground no matter what the terminal actually is.
+ *
+ * Lives in layout, not theme: `PaintTheme` is layout's own type and `Style` is
+ * buffer's, both of which theme deliberately avoids depending on (it mirrors
+ * `Style` structurally as `StyleLike` for that reason).
+ */
+import { guessColorDepth } from "../capabilities/index.js";
+import { buildTheme, defaultTheme, groundFromRgb, makeStyleResolver } from "../theme/index.js";
+let active = defaultTheme;
+let depth = "truecolor";
+/** Replace active theme (e.g. after OSC 11 attunement). */
+export function setActiveTheme(theme) {
+    active = theme;
+}
+export function setColorDepth(d) {
+    depth = d;
+}
+/**
+ * Build a binding from an explicit theme (or a measured ground OKLCH L, which
+ * rebuilds the seed table against it). Touches no module state in either
+ * direction: a host that calls this owns its theme.
+ *
+ * Pass `depth` explicitly whenever a real answer exists — the canonical
+ * source is `resolvePresentConfig().colorDepth`
+ * (`../runtime/index.js`, itself falling back to
+ * `guessColorDepth(env)` from capabilities when no probe ran, so `NO_COLOR`
+ * still reaches `mono` without a TTY probe). When `depth` is omitted (probe
+ * threw, host has no caps yet), fall back to `guessColorDepth()` — an honest
+ * env read (COLORTERM/TERM/NO_COLOR), never a hard demotion to `ansi16`.
+ * Hard-ansi16 was collapsing truecolor sessions to 16 colors whenever the
+ * OSC probe timed out; env is the right under-claim ladder for that case.
+ */
+export function attuneTheme(opts = {}) {
+    const ground = opts.ground ??
+        (opts.groundRgb === undefined ? undefined : groundFromRgb(opts.groundRgb.r, opts.groundRgb.g, opts.groundRgb.b));
+    const theme = opts.theme ??
+        (ground === undefined && opts.groundRgb === undefined
+            ? defaultTheme
+            : buildTheme({ ground, groundRgb: opts.groundRgb }));
+    const depthUsed = opts.depth ?? guessColorDepth();
+    return {
+        theme,
+        depth: depthUsed,
+        paint: paintTheme({ theme, depth: depthUsed, regionProminence: opts.regionProminence }),
+    };
+}
+/**
+ * Layout paint Theme with ColorResolver bound to the given theme/depth, or to
+ * the ambient pair when omitted (the deprecated builders' path).
+ */
+export function paintTheme(opts) {
+    const t = opts?.theme ?? active;
+    const d = opts?.depth ?? depth;
+    const resolve = makeStyleResolver({
+        theme: t,
+        depth: d,
+        regionProminence: opts?.regionProminence,
+    });
+    return {
+        resolveStyle: (style) => resolve(style),
+    };
+}
+//# sourceMappingURL=paint_theme.js.map

package/dist/layout/paint_theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint_theme.js","sourceRoot":"","sources":["../../src/layout/paint_theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,eAAe,EAAmB,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAc,MAAM,mBAAmB,CAAC;AAE3G,IAAI,MAAM,GAAU,YAAY,CAAC;AACjC,IAAI,KAAK,GAAe,WAAW,CAAC;AAEpC,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAa;IACzC,KAAK,GAAG,CAAC,CAAC;AACZ,CAAC;AAiBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,OAaI,EAAE;IAEN,MAAM,MAAM,GACV,IAAI,CAAC,MAAM;QACX,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACnH,MAAM,KAAK,GACT,IAAI,CAAC,KAAK;QACV,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YACnD,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;IAClD,OAAO;QACL,KAAK;QACL,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;KACxF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAU1B;IACC,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,IAAI,MAAM,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;IAC/B,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,gBAAgB,EAAE,IAAI,EAAE,gBAAgB;KACzC,CAAC,CAAC;IACH,OAAO;QACL,YAAY,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAU;KACxD,CAAC;AACJ,CAAC"}

package/dist/layout/progress.d.ts

@@ -0,0 +1,31 @@
+import type { LayoutNode } from "./types.js";
+/**
+ * Chrome-frame progress ease — renderer-plane motion.
+ *
+ * Logic declares a target 0..1 (and optional role). The host holds displayed
+ * value and eases toward the target; paint samples the displayed number.
+ * Same cut as birth: TEA names the end state, present interpolates.
+ */
+export declare const PROGRESS_EASE_MS = 240;
+export declare function easeInOutCubic(t: number): number;
+export type ProgressBarAnim = {
+    readonly displayed: number;
+    readonly displayedRole?: string;
+    readonly from: number;
+    readonly to: number;
+    readonly fromRole?: string;
+    readonly toRole?: string;
+    readonly startedAt: number;
+    readonly durationMs: number;
+};
+export declare function stepProgressBar(prev: ProgressBarAnim | undefined, target: number, targetRole: string | undefined, nowMs: number): ProgressBarAnim;
+/** Still interpolating — host keeps the present timer armed. */
+export declare function progressBarLive(anim: ProgressBarAnim): boolean;
+export type ProgressSite = {
+    readonly key: string;
+    readonly progress: number;
+    readonly role?: string;
+};
+/** Walk a tree for chrome_frame progress targets (host steps these). */
+export declare function collectProgressSites(node: LayoutNode): ProgressSite[];
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/layout/progress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;GAMG;AAEH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhD;AAOD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,GAAG,SAAS,EACjC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,GACZ,eAAe,CAiCjB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAG9D;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE,CAIrE"}

package/dist/layout/progress.js

@@ -0,0 +1,83 @@
+import { layoutChildren } from "./children.js";
+/**
+ * Chrome-frame progress ease — renderer-plane motion.
+ *
+ * Logic declares a target 0..1 (and optional role). The host holds displayed
+ * value and eases toward the target; paint samples the displayed number.
+ * Same cut as birth: TEA names the end state, present interpolates.
+ */
+export const PROGRESS_EASE_MS = 240;
+export function easeInOutCubic(t) {
+    const x = Number.isFinite(t) ? Math.max(0, Math.min(1, t)) : 0;
+    return x < 0.5 ? 4 * x * x * x : 1 - (-2 * x + 2) ** 3 / 2;
+}
+function clamp01(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(1, n));
+}
+export function stepProgressBar(prev, target, targetRole, nowMs) {
+    const to = clamp01(target);
+    if (prev === undefined) {
+        return {
+            displayed: to,
+            displayedRole: targetRole,
+            from: to,
+            to,
+            fromRole: targetRole,
+            toRole: targetRole,
+            startedAt: nowMs,
+            durationMs: PROGRESS_EASE_MS,
+        };
+    }
+    const targetChanged = Math.abs(prev.to - to) > 1e-4 || (prev.toRole ?? "") !== (targetRole ?? "");
+    if (targetChanged) {
+        return {
+            displayed: prev.displayed,
+            displayedRole: prev.displayedRole,
+            from: prev.displayed,
+            to,
+            fromRole: prev.displayedRole,
+            toRole: targetRole,
+            startedAt: nowMs,
+            durationMs: PROGRESS_EASE_MS,
+        };
+    }
+    const u = easeInOutCubic((nowMs - prev.startedAt) / Math.max(1, prev.durationMs));
+    return {
+        ...prev,
+        displayed: prev.from + (prev.to - prev.from) * u,
+        displayedRole: u < 0.5 ? prev.fromRole : prev.toRole,
+    };
+}
+/** Still interpolating — host keeps the present timer armed. */
+export function progressBarLive(anim) {
+    if (Math.abs(anim.displayed - anim.to) > 1e-3)
+        return true;
+    return (anim.displayedRole ?? "") !== (anim.toRole ?? "");
+}
+/** Walk a tree for chrome_frame progress targets (host steps these). */
+export function collectProgressSites(node) {
+    const out = [];
+    walk(node, out);
+    return out;
+}
+function walk(node, out) {
+    if (node.type === "chrome_frame") {
+        const key = node.key;
+        const progress = node.progress;
+        if (key && typeof progress === "number" && node.plainBottom !== true) {
+            out.push({
+                key,
+                progress,
+                role: node.progressRole,
+            });
+        }
+    }
+    for (const child of layoutChildren(node))
+        walk(child, out);
+    if (node.type === "disclosure") {
+        walk(node.summary, out);
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/layout/progress.js.map

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

package/dist/layout/selection.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Selection state model — buffer-cell-space ranges with granularity.
+ *
+ * State lives renderer/main-side (the buffer owner). The host wires mouse
+ * gestures (Phase 1d) and keyboard selection into transitions on this type;
+ * paint (Phase 1c) reads it to mark cells `selected`.
+ *
+ * Two cooperating concepts:
+ *
+ *  1. GLOBAL state (this module): anchor/active cells + granularity. Knows
+ *     "this cell is fully inside the selection range" — the cheap, geometry-
+ *     only membership test. Does NOT know what text a cell renders.
+ *
+ *  2. COMPONENT-delegated serialization (Phase 2b): each widget declares how
+ *     its cells map back to semantic content (markdown source, diff text,
+ *     code). The global layer asks "is this cell selected?" and the component
+ *     answers "what text does it produce?"
+ *
+ * Geometry law (the bifunctor):
+ *  - `"char"` / `"word"` — **stream** range in document order (row-major).
+ *    Multi-line: first row from start.col→EOL, middle rows full width, last
+ *    row SOL→end.col. Same model every terminal/editor uses for drag-select.
+ *  - `"line"` — full row width for every row in the vertical span.
+ *  - `"rect"` — axis-aligned column block (Alt+drag / tmux rectangle).
+ *  - `"structural"` — bounding box of a LayoutNode (refined by component).
+ *
+ * Cell coordinates are 0-indexed buffer cells (matching `elementAt`'s
+ * internal rect math after the 1-based SGR subtraction).
+ */
+import type { Rect } from "./types.js";
+/** 0-indexed buffer cell. */
+export type Cell = {
+    col: number;
+    row: number;
+};
+/**
+ * Selection granularity — what a drag or extend operation selects.
+ *
+ * - `"char"`       — stream range, cell-by-cell (the bare-drag default)
+ * - `"word"`       — stream range, endpoints snapped to word bounds
+ * - `"line"`       — whole logical lines (triple-click; code/diff/log default)
+ * - `"rect"`       — rectangular/columnar block (Alt+drag, tmux rectangle-toggle)
+ * - `"structural"` — a LayoutNode subtree (Ctrl+W walk; the Phase 4 moat)
+ */
+export type SelectionGranularity = "char" | "word" | "line" | "rect" | "structural";
+/**
+ * Active text selection. `null` = no selection.
+ *
+ * - `anchor` — where the selection started (fixed during a drag)
+ * - `active` — the moving end (follows the pointer / keyboard endpoint)
+ * - `granularity` — how drag/extend snaps the range
+ * - `anchorKey` — the LayoutNode key the anchor started in
+ * - `contain` — when set (anchor under `userSelect: "contain"`, e.g. composer
+ *   input), every geometry query and endpoint clamp is confined to this rect.
+ *   Selection never paints or serializes outside the input.
+ */
+export type SelectionState = {
+    anchor: Cell;
+    active: Cell;
+    granularity: SelectionGranularity;
+    /** LayoutNode key at the anchor (structural walk / contain node). */
+    anchorKey?: string;
+    /**
+     * Confinement rect from `userSelect: "contain"` (buffer coords, inclusive
+     * origin + size). CSS textarea model: drag cannot leave this box.
+     */
+    contain?: Rect;
+};
+/** Clamp a cell into a rect (inclusive). */
+export declare function clampCell(cell: Cell, rect: Rect): Cell;
+/**
+ * Start a new selection at a cell. Anchor and active both start at the cell;
+ * a subsequent drag/extend moves `active`. When `contain` is set, the cell is
+ * clamped into that rect and the confinement rides on the state.
+ */
+export declare function startSelection(cell: Cell, granularity?: SelectionGranularity, anchorKey?: string, contain?: Rect): SelectionState;
+/** Move the active end (drag / shift-click extend / keyboard arrow). */
+export declare function extendSelection(sel: SelectionState | null, cell: Cell): SelectionState | null;
+/** Clear the selection. */
+export declare function clearSelection(): SelectionState | null;
+/**
+ * True when anchor and active are the same cell (collapsed caret / click
+ * without drag). Copy-on-select hosts should skip OSC 52 for collapsed
+ * selections unless multi-click expanded the range.
+ */
+export declare function isCollapsed(sel: SelectionState | null): boolean;
+/**
+ * True when the selection covers more than one cell under its geometry law.
+ * For `"line"` a single-row collapsed click still selects the full line, so
+ * this is true whenever granularity is line (or structural) even if collapsed.
+ */
+export declare function hasCopyableExtent(sel: SelectionState | null): boolean;
+/**
+ * Stream endpoints in document order (start ≤ end). Used by char/word geometry.
+ * Anchor/active may be in either drag direction.
+ */
+export declare function streamEndpoints(sel: SelectionState): {
+    start: Cell;
+    end: Cell;
+};
+/**
+ * Bounding rect envelope of the selection in buffer coordinates.
+ *
+ * For multi-line stream (`"char"`/`"word"`) and `"line"`, the envelope spans
+ * full row width when `rowWidth` is supplied — paint loops walk this rect and
+ * filter with {@link rowRange}. When `rowWidth` is omitted, multi-line
+ * stream uses a conservative full-width sentinel (caller should prefer
+ * providing width).
+ *
+ * For `"rect"` the envelope IS the selected region.
+ */
+export declare function selectionRect(sel: SelectionState, rowWidth?: number): Rect;
+/**
+ * Column range selected on a given row, or `null` if the row is outside the
+ * selection. Returned range is **inclusive** on both ends: `[startCol, endCol]`.
+ *
+ * Geometry by granularity:
+ * - `"char"` / `"word"` — stream: first/middle/last row rules
+ * - `"line"` — full row `[0, rowWidth-1]`
+ * - `"rect"` / `"structural"` — axis box columns on every selected row
+ */
+export declare function rowRange(sel: SelectionState, row: number, rowWidth: number): readonly [number, number] | null;
+export declare function wordBoundsOnRow(cells: readonly string[], col: number): readonly [number, number];
+/**
+ * Expand a collapsed (or any) selection to the full word under `cell`.
+ * Sets anchor to word start and active to word end on that row.
+ */
+export declare function expandToWordAt(cell: Cell, getRowCells: (row: number) => readonly string[] | null | undefined, anchorKey?: string, contain?: Rect): SelectionState;
+/**
+ * Expand to full line under `cell` (triple-click). Anchor at col 0, active at
+ * last content-ish col when `rowWidth` known; granularity `"line"` so
+ * {@link rowRange} already spans full width either way. With `contain`, the
+ * "line" is the input row only (cols of the box), never the whole terminal.
+ */
+export declare function expandToLineAt(cell: Cell, rowWidth: number, anchorKey?: string, contain?: Rect): SelectionState;
+//# sourceMappingURL=selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/layout/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,6BAA6B;AAC7B,MAAM,MAAM,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,oBAAoB,CAAC;IAClC,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAOtD;AAkBD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,WAAW,GAAE,oBAA6B,EAC1C,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,IAAI,GACb,cAAc,CAGhB;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,cAAc,GAAG,IAAI,CAI7F;AAED,2BAA2B;AAC3B,wBAAgB,cAAc,IAAI,cAAc,GAAG,IAAI,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAQrE;AAOD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG;IACpD,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACX,CAKA;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,GAAE,MAAgC,GAAG,IAAI,CAkCnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA+B7G;AA+BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAUhG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,EAClE,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,IAAI,GACb,cAAc,CAmBhB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,cAAc,CAkB/G"}