@lumencast/runtime 0.6.0 → 0.8.0

package/dist/render/fill.js

@@ -1,6 +1,21 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { parseCssColor, warnRejectedColor } from "./css-color";
 import { emitDiagnostic } from "./diagnostics";
+import { gateSrc } from "./allowed-hosts";
+import { parseBlendMode } from "./blend-mode";
+/** LSML 1.2 §3.2 closed `objectFit` enum, re-validated at the RUNTIME (the
+ *  compiler is the other arm of the double-gate, Bastion T4). These are
+ *  exactly the legal CSS `object-fit` / `background-size`-mappable values ;
+ *  anything else is omitted + diagnosed, never passed through to inline CSS.
+ *  Kept local to the runtime — the runtime must not import from the
+ *  compiler (the dependency edge points the other way). */
+const OBJECT_FITS = new Set(["cover", "contain", "fill", "none", "scale-down"]);
+/** Validate an `objectFit` against the closed enum at render. Returns the
+ *  value or `undefined` (caller falls back to the default + diagnoses).
+ *  Never passthrough. */
+export function parseObjectFitRuntime(value) {
+    return typeof value === "string" && OBJECT_FITS.has(value) ? value : undefined;
+}
 let gradientIdSeq = 0;
 function nextGradientId() {
     gradientIdSeq = (gradientIdSeq + 1) % 1_000_000;
@@ -9,26 +24,61 @@ function nextGradientId() {
 /** Compile a Fill into an SVG `<defs>` entry + a `fill="url(#…)"` ref.
  * Solid fills produce no defs and return the colour directly. */
 export function renderFill(fill) {
+    // #L — re-validate the per-fill blend mode once (runtime T4 arm). An absent
+    // or out-of-enum value yields `undefined` → the layer renders `normal`.
+    const mixBlendMode = parseBlendMode(fill.blendMode);
     if (fill.kind === "solid") {
-        // Solid fill — no defs needed, just hand the colour to fill.
-        // SVG fill-opacity composes with element opacity multiplicatively
-        // so we apply both consistently.
-        return { defs: [], ref: fill.color };
+        // Solid fill — no defs needed, just hand the colour to fill. A solid fill
+        // carries its OWN opacity (Figma per-paint alpha, e.g. the bg-texture tiles
+        // at 6% white) ; fold it into the colour so the SVG path actually renders
+        // at that alpha instead of full-strength (the tiles came out 16× too bright
+        // pre-mask, near-black post-mask).
+        const ref = fill.opacity !== undefined ? cssWithOpacity(fill.color, fill.opacity) : fill.color;
+        return { defs: [], ref, mixBlendMode };
+    }
+    if (fill.kind === "image") {
+        // LSML 1.2 §3.2 — image-fill on a shape. Rendered as an SVG <pattern>
+        // holding a single <image> that fills the object bounding box ;
+        // `preserveAspectRatio` reproduces the closed-enum `objectFit`. `src`
+        // is pre-gated (T1/T2) by `gateImageFills`, so it is safe to place on
+        // the SVG <image href>. No bundle-derived markup is interpolated — only
+        // the URL string and closed-enum-derived attribute values.
+        const imgId = nextGradientId();
+        const par = objectFitToPreserveAspectRatio(fill.objectFit);
+        const defs = [
+            _jsx("pattern", { id: imgId, patternContentUnits: "objectBoundingBox", width: "1", height: "1", children: _jsx("image", { href: fill.src, width: "1", height: "1", preserveAspectRatio: par }) }, imgId),
+        ];
+        return { defs, ref: `url(#${imgId})`, mixBlendMode };
     }
     const id = nextGradientId();
     if (fill.kind === "linear-gradient") {
-        // angle_deg : 0 = bottom-to-top per §4.12 (matches CSS `linear-gradient`)
-        const angle = fill.angle_deg ?? 0;
-        // Translate angle (degrees from up) to SVG x1/y1/x2/y2 in user space.
-        const rad = ((angle - 90) * Math.PI) / 180; // 0° → x1=0,y1=1 (bottom-up)
-        const x1 = 0.5 - 0.5 * Math.cos(rad);
-        const y1 = 0.5 - 0.5 * Math.sin(rad);
-        const x2 = 0.5 + 0.5 * Math.cos(rad);
-        const y2 = 0.5 + 0.5 * Math.sin(rad);
+        let x1, y1, x2, y2;
+        // Honour the Figma `gradientTransform` : the gradient axis (offset 0 → 1) is
+        // column 0 = (a, b) of the matrix, in the SVG's y-down space. `angle_deg`
+        // alone ignored it and mis-oriented the picto/caramel gradients (too red).
+        const t = fill.transform;
+        if (Array.isArray(t) && t.length === 6 && Number.isFinite(t[0]) && Number.isFinite(t[1])) {
+            const len = Math.hypot(t[0], t[1]) || 1;
+            const an = t[0] / len;
+            const bn = t[1] / len;
+            x1 = 0.5 - 0.5 * an;
+            y1 = 0.5 - 0.5 * bn;
+            x2 = 0.5 + 0.5 * an;
+            y2 = 0.5 + 0.5 * bn;
+        }
+        else {
+            // angle_deg : 0 = bottom-to-top per §4.12.
+            const angle = fill.angle_deg ?? 0;
+            const rad = ((angle - 90) * Math.PI) / 180; // 0° → x1=0,y1=1 (bottom-up)
+            x1 = 0.5 - 0.5 * Math.cos(rad);
+            y1 = 0.5 - 0.5 * Math.sin(rad);
+            x2 = 0.5 + 0.5 * Math.cos(rad);
+            y2 = 0.5 + 0.5 * Math.sin(rad);
+        }
         const defs = [
             _jsx("linearGradient", { id: id, x1: `${x1 * 100}%`, y1: `${y1 * 100}%`, x2: `${x2 * 100}%`, y2: `${y2 * 100}%`, children: fill.stops.map((s, i) => (_jsx("stop", { offset: s.offset, stopColor: s.color, ...(s.opacity !== undefined ? { stopOpacity: s.opacity } : {}) }, i))) }, id),
         ];
-        return { defs, ref: `url(#${id})` };
+        return { defs, ref: `url(#${id})`, mixBlendMode };
     }
     // radial-gradient
     const cx = fill.center?.x ?? 0.5;
@@ -37,20 +87,102 @@ export function renderFill(fill) {
     const defs = [
         _jsx("radialGradient", { id: id, cx: `${cx * 100}%`, cy: `${cy * 100}%`, r: `${r * 100}%`, children: fill.stops.map((s, i) => (_jsx("stop", { offset: s.offset, stopColor: s.color, ...(s.opacity !== undefined ? { stopOpacity: s.opacity } : {}) }, i))) }, id),
     ];
-    return { defs, ref: `url(#${id})` };
+    return { defs, ref: `url(#${id})`, mixBlendMode };
 }
-/** Compile an array of Fill into a CSS `background-image` value usable
- * on a `<div>` (frame backgrounds — non-SVG context). Returns the CSS
- * string + opacity. Stops use percentages in CSS gradient syntax. */
+/** Map a closed-enum `objectFit` to the CSS `background-size` keyword that
+ *  reproduces the same fit for a `background-image`. `fill`/`none`/`scale-
+ *  down` have no exact 1:1 `background-size` keyword — we approximate with
+ *  the nearest safe keyword (all from the closed enum, never free input). */
+function objectFitToBackgroundSize(fit) {
+    switch (fit) {
+        case "contain":
+        case "scale-down":
+            return "contain";
+        case "none":
+            return "auto";
+        case "fill":
+            return "100% 100%";
+        case "cover":
+        default:
+            return "cover";
+    }
+}
+/** Map a closed-enum `objectFit` to the SVG `<image preserveAspectRatio>`
+ *  value that reproduces the same fit inside a pattern tile. Every returned
+ *  value is a fixed literal (closed enum → fixed mapping) — never free
+ *  input reaching an SVG attribute. */
+function objectFitToPreserveAspectRatio(fit) {
+    switch (fit) {
+        case "contain":
+        case "scale-down":
+            return "xMidYMid meet";
+        case "fill":
+            return "none";
+        case "none":
+            return "xMidYMid meet";
+        case "cover":
+        default:
+            return "xMidYMid slice";
+    }
+}
+/** Compile an array of Fill into background CSS usable on a `<div>` (frame
+ * backgrounds — non-SVG context). Returns `backgroundImage` plus, when an
+ * image-fill is present, the matching `backgroundSize`/`backgroundPosition`/
+ * `backgroundRepeat`. Stops use percentages in CSS gradient syntax.
+ *
+ * Image-fill `src` MUST already be host/scheme-gated (`gateImageFills`) —
+ * `backgroundsToCss` assumes the URL is trusted at this point and only
+ * CSS-escapes it for safe interpolation into `url("…")`. */
 export function backgroundsToCss(fills, nodeId) {
     // Per §4.12, fills[0] renders on top — CSS background-image stacks
     // first → top-most. Match by passing in the same order.
-    const layers = fills.map((f) => fillToCss(f, nodeId)).filter(Boolean);
+    // #L — keep each layer's validated blend keyword aligned with its CSS
+    // layer (a rejected colour drops the layer → drop its blend too), so
+    // `background-blend-mode` stays positionally correct.
+    const kept = [];
+    const layers = [];
+    for (const f of fills) {
+        const css = fillToCss(f, nodeId);
+        if (css) {
+            layers.push(css);
+            kept.push(f);
+        }
+    }
     if (layers.length === 0)
         return {};
-    return { backgroundImage: layers.join(", ") };
+    const css = { backgroundImage: layers.join(", ") };
+    // #L — per-fill-layer blend on a frame background uses CSS
+    // `background-blend-mode` (one keyword per layer, same order). Each value is
+    // re-validated against the closed enum (runtime T4 arm) ; an absent/rejected
+    // value falls back to `normal`. Emitted only when at least one layer carries
+    // a non-`normal` blend, to keep pre-#L output byte-identical (rétro-compat).
+    const blends = kept.map((f) => parseBlendMode(f.blendMode) ?? "normal");
+    if (blends.some((b) => b !== "normal")) {
+        css.backgroundBlendMode = blends.join(", ");
+    }
+    // When any layer is an image-fill, drive its sizing from the (already
+    // validated) objectFit. A single image-fill is the common cover case ;
+    // for the first image-fill we set the background sizing for the whole box.
+    const firstImage = fills.find((f) => f.kind === "image");
+    if (firstImage) {
+        css.backgroundSize = objectFitToBackgroundSize(firstImage.objectFit);
+        css.backgroundPosition = "center";
+        css.backgroundRepeat = "no-repeat";
+    }
+    return css;
+}
+/** CSS-escape a (already host-gated) URL for safe interpolation into a
+ *  `url("…")` token — escape backslash and the double-quote that would
+ *  otherwise break out of the quoted string. */
+function cssUrl(src) {
+    return `url("${src.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}")`;
 }
 function fillToCss(fill, nodeId) {
+    if (fill.kind === "image") {
+        // `src` is pre-gated (T1/T2) by `gateImageFills` ; only escape it for
+        // the CSS string context here.
+        return cssUrl(fill.src);
+    }
     // RC#11 — every colour interpolated into an inline CSS string MUST
     // pass the strict parser first (fills/stops arrive from untrusted
     // bundles AND live LSDP deltas). A rejected colour drops the whole
@@ -61,8 +193,12 @@ function fillToCss(fill, nodeId) {
             warnRejectedColor("fill.color", nodeId);
             return null;
         }
+        // A solid fill carries its OWN opacity (Figma layer-fill alpha, e.g. a 14%
+        // white pill) — apply it like a gradient stop's, else the layer renders
+        // fully opaque and hides whatever it overlays.
+        const c = fill.opacity !== undefined ? cssWithOpacity(color, fill.opacity) : color;
         // Wrap solid in linear-gradient so it can stack with other layers.
-        return `linear-gradient(${color}, ${color})`;
+        return `linear-gradient(${c}, ${c})`;
     }
     const safeStops = [];
     for (const s of fill.stops) {
@@ -76,7 +212,17 @@ function fillToCss(fill, nodeId) {
     }
     const stops = safeStops.join(", ");
     if (fill.kind === "linear-gradient") {
-        const angle = fill.angle_deg ?? 0;
+        let angle = fill.angle_deg ?? 0;
+        // Honour the Figma `gradientTransform` when present : the gradient's main
+        // axis (offset 0 → 1) is column 0 = (a, b) of the 2×3 matrix. CSS `Ndeg`
+        // measures clockwise from "up" and screen-y points down, so that direction
+        // maps to `atan2(a, -b)`. `angle_deg` alone ignored the matrix and rendered
+        // the Cover's warm base as a 270° (horizontal) wash instead of the real 180°
+        // (warm at top) — leaving the top-right black under the Ruby20 hard-light.
+        const t = fill.transform;
+        if (Array.isArray(t) && t.length === 6 && Number.isFinite(t[0]) && Number.isFinite(t[1])) {
+            angle = ((Math.atan2(t[0], -t[1]) * 180) / Math.PI + 360) % 360;
+        }
         return `linear-gradient(${angle}deg, ${stops})`;
     }
     // radial-gradient
@@ -110,6 +256,13 @@ function cssWithOpacity(color, opacity) {
 export function sanitizeFills(fills, field, nodeId) {
     const out = [];
     for (const fill of fills) {
+        // Image-fills carry no colour — they are colour-clean by construction.
+        // Their `src` is gated separately (`gateImageFills`, T1/T2) ; pass them
+        // through here unchanged so `sanitizeFills` only owns colour validation.
+        if (fill.kind === "image") {
+            out.push(fill);
+            continue;
+        }
         if (fill.kind === "solid") {
             const color = parseCssColor(fill.color);
             if (color === null) {
@@ -151,12 +304,58 @@ export function parseFills(value, field, nodeId) {
             }
         }
     }
-    return value.filter(isFill);
+    // Image-fill `objectFit` is re-validated against the closed enum here
+    // (Bastion T4 runtime arm) : a hostile / unknown value is dropped with a
+    // diagnostic and the fill falls back to the default fit — never passed
+    // through to inline CSS. `src` is NOT gated here (it needs the host
+    // allowlist) — `gateImageFills` does that downstream, before render.
+    return value.filter(isFill).map((v) => {
+        let fill = v;
+        // #L — re-validate a per-fill `blendMode` against the closed enum (runtime
+        // T4 arm). An out-of-enum value is diagnosed + stripped (the layer falls
+        // back to `normal`), never passed through to inline CSS. Applies to every
+        // fill kind.
+        if (fill.blendMode !== undefined && parseBlendMode(fill.blendMode) === undefined) {
+            emitDiagnostic(nodeId, field !== undefined ? `${field}.blendMode` : "fill.blendMode", "is not a recognised mix-blend-mode ; falling back to normal (ADR 002 §3.2)");
+            const { blendMode: _drop, ...rest } = fill;
+            fill = rest;
+        }
+        if (fill.kind !== "image")
+            return fill;
+        if (fill.objectFit === undefined)
+            return fill;
+        const fit = parseObjectFitRuntime(fill.objectFit);
+        if (fit === undefined) {
+            emitDiagnostic(nodeId, field !== undefined ? `${field}.objectFit` : "fill.objectFit", "is not a recognised object-fit ; falling back to default (ADR 002 §3.2)");
+            const { objectFit: _drop, ...rest } = fill;
+            return rest;
+        }
+        return { ...fill, objectFit: fit };
+    });
 }
 function isFill(v) {
     if (typeof v !== "object" || v === null)
         return false;
     const k = v.kind;
-    return k === "solid" || k === "linear-gradient" || k === "radial-gradient";
+    if (k === "solid" || k === "linear-gradient" || k === "radial-gradient")
+        return true;
+    // An image-fill must carry a string `src` to be structurally valid ; a
+    // malformed image entry is dropped like any other unrenderable fill.
+    return k === "image" && typeof v.src === "string";
+}
+/**
+ * Drop every image-fill whose `src` fails the host/scheme allowlist
+ * (Bastion T1/T2), BEFORE any image-fill reaches the DOM. A rejected
+ * image-fill is omitted entirely (never a passthrough URL) with an
+ * R9-clean diagnostic emitted by `gateSrc`. Non-image fills pass through
+ * untouched. Call this once, after `parseFills`, with the active
+ * `allowedHosts` from `useAllowedHosts()`.
+ */
+export function gateImageFills(fills, allowedHosts, field, nodeId) {
+    return fills.filter((fill) => {
+        if (fill.kind !== "image")
+            return true;
+        return gateSrc(fill.src, allowedHosts, `${field}.src`, nodeId) !== undefined;
+    });
 }
 //# sourceMappingURL=fill.js.map

package/dist/render/fill.js.map

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

package/dist/render/headless.d.ts

@@ -0,0 +1,39 @@
+import { type DiagnosticHandler } from "./diagnostics.js";
+import type { RenderBundle } from "./bundle.js";
+export interface HeadlessRenderOptions {
+    /** Already-compiled bundle (via `@lumencast/compiler` on the host side). */
+    bundle: RenderBundle;
+    /** A live, mounted DOM node. Its size is set from `stage` unless the host
+     *  has already dimensioned it (see `stage`). */
+    target: HTMLElement;
+    /** Initial leaf-grain store state (`store.reset(defaults)`) — the bound
+     *  values the bundle reads (`__lit.*`, score, names…). */
+    defaults?: Record<string, unknown>;
+    /** Stage dimensions in CSS px. Defaults to 1920×1080. Applied to `target`
+     *  as `width`/`height`/`position:relative`/`overflow:hidden` so the
+     *  screenshot frame matches the reference exactly. */
+    stage?: {
+        width: number;
+        height: number;
+    };
+    /** Anti-drop diagnostics channel (ADR 001 §3.4): omitted assets, unhonoured
+     *  fields surface here as `{ nodeId, field, reason }` (never a value — R9).
+     *  Wired to the same global channel `mount()` uses. */
+    onDiagnostic?: DiagnosticHandler;
+}
+export interface HeadlessRenderHandle {
+    /** Resolves after the scene has rendered, two animation frames have passed
+     *  AND `document.fonts.ready` (ADR 003 §3.3) — i.e. the DOM is laid out and
+     *  fonts are loaded, so a screenshot taken now is fidelity-faithful. */
+    ready: Promise<void>;
+    /** Tear down the React root and detach the diagnostics handler. */
+    unmount(): void;
+}
+/**
+ * Render `bundle` into `target` through the production broadcast path and
+ * resolve `ready` once it is settled. The runtime performs NO network fetch and
+ * takes NO screenshot — it produces a settled live DOM and a readiness signal,
+ * nothing more (ADR 003 D5).
+ */
+export declare function renderBundleHeadless(opts: HeadlessRenderOptions): HeadlessRenderHandle;
+//# sourceMappingURL=headless.d.ts.map

package/dist/render/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../src/render/headless.tsx"],"names":[],"mappings":"AA0BA,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,MAAM,EAAE,YAAY,CAAC;IACrB;oDACgD;IAChD,MAAM,EAAE,WAAW,CAAC;IACpB;8DAC0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;0DAEsD;IACtD,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C;;2DAEuD;IACvD,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC;;4EAEwE;IACxE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,mEAAmE;IACnE,OAAO,IAAI,IAAI,CAAC;CACjB;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CA4DtF"}

package/dist/render/headless.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// Public headless render entry — render an already-compiled `RenderBundle`
+// into a live DOM node, no WebSocket, ready when layout + fonts have settled
+// (ADR 003 §3.1). The host (Playwright / Chromium / a CEF offscreen surface)
+// screenshots `target` once `ready` resolves. The runtime does DOM + readiness
+// ONLY — no screenshot, no fetch (ADR 003 D5/D3).
+//
+// This is the zero-loss harness (ADR 002 #J) generalised: it mounts the EXACT
+// production seam —
+//   LumencastRuntimeProvider{ mode:"broadcast", status:"live" } > BroadcastMode
+// — into a real `createRoot(target)`, NOT `renderToStaticMarkup` (which yields
+// unlaid-out markup: unmeasured fonts, uncomposited masks → an infidel PNG,
+// ADR 003 §3.1). `BroadcastMode` is dynamically imported so the headless
+// function adds no weight to the eager `mount`/broadcast path (ADR 003 §4,
+// RC6); the heavy render code already lives in the broadcast/tree chunks.
+//
+// Asset resolution is the HOST's job, done in the bundle BEFORE this call
+// (ADR 003 §3.2): the runtime renders the bundle as-is, gating every remaining
+// `src` through the unchanged deny-by-default host-allow gate inside
+// `BroadcastMode` (`AllowedHostsProvider`). A `src` on a host not in the
+// bundle's `allowedHosts` is omitted + a diagnostic is emitted — never faked
+// (ADR 002 borne, D4). Use `render/asset-resolve` helpers to pre-resolve.
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { createStore } from "../state/store.js";
+import { LumencastRuntimeProvider } from "../overlay/runtime-context.js";
+import { addDiagnosticsHandler } from "./diagnostics.js";
+/** Default stage size — the Figma 817:3 cover frame, the SSIM reference. */
+const DEFAULT_STAGE = { width: 1920, height: 1080 };
+const noop = () => { };
+/**
+ * Render `bundle` into `target` through the production broadcast path and
+ * resolve `ready` once it is settled. The runtime performs NO network fetch and
+ * takes NO screenshot — it produces a settled live DOM and a readiness signal,
+ * nothing more (ADR 003 D5).
+ */
+export function renderBundleHeadless(opts) {
+    const stage = opts.stage ?? DEFAULT_STAGE;
+    const target = opts.target;
+    // Pose the stage so the screenshot frame is exact (mirrors harness.html).
+    target.style.position ||= "relative";
+    target.style.width = `${stage.width}px`;
+    target.style.height = `${stage.height}px`;
+    target.style.overflow = "hidden";
+    const removeDiagnostics = opts.onDiagnostic
+        ? addDiagnosticsHandler(opts.onDiagnostic)
+        : undefined;
+    const store = createStore();
+    store.reset(opts.defaults ?? {});
+    const root = createRoot(target);
+    const ready = new Promise((resolve) => {
+        // BroadcastMode is dynamically imported so its (and the tree's) weight is
+        // not pulled into the eager `mount` entry chunk (RC6). It is already a
+        // separate chunk reused from the broadcast path.
+        void import("../modes/broadcast.js").then(({ BroadcastMode }) => {
+            root.render(_jsx(StrictMode, { children: _jsx(LumencastRuntimeProvider, { value: {
+                        mode: "broadcast",
+                        store,
+                        bundle: opts.bundle,
+                        status: "live",
+                        sendInput: noop,
+                    }, children: _jsx(BroadcastMode, {}) }) }));
+            // Settle: two animation frames (layout) AND fonts loaded (ADR 003 §3.3).
+            // Both must complete before `ready` resolves, so a screenshot taken on
+            // `ready` uses the brand glyphs, not the fallback font (no FOUT freeze).
+            const framesSettled = new Promise((res) => {
+                requestAnimationFrame(() => requestAnimationFrame(() => res()));
+            });
+            const fontsReady = typeof document !== "undefined" && document.fonts
+                ? document.fonts.ready.then(() => undefined)
+                : Promise.resolve();
+            void Promise.all([framesSettled, fontsReady]).then(() => resolve());
+        });
+    });
+    return {
+        ready,
+        unmount() {
+            removeDiagnostics?.();
+            root.unmount();
+        },
+    };
+}
+//# sourceMappingURL=headless.js.map

package/dist/render/headless.js.map

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

package/dist/render/mask.d.ts

@@ -0,0 +1,87 @@
+import type { ReactElement, CSSProperties } from "react";
+/** Resolve a shape `mask.source.ref` to its inlined mask-coverage geometry
+ *  (#K). The Tree supplies this from its one-pass `id → shape` index ; it
+ *  returns `null` for a PENDING ref (id absent from the index) so the mask is
+ *  omitted, never crashing. The resolver inlines ONLY the referenced shape's
+ *  geometry — never its own mask (anti-cycle, profondeur = 1). */
+export type ShapeRefResolver = (ref: string) => ReactElement | null;
+/** Feather pad (px). The group/shape mask wrapper's `overflow:hidden` box is
+ *  grown by this on every side (tree.tsx, `inset:-PAD`) and the coverage is
+ *  shifted back by the same amount (buildMask) so a BLURRED mask rim isn't
+ *  re-cut into a hard square at the box edge. Generous enough for the
+ *  bg-texture ellipse's ~3σ (53.88 CSS sigma) feather. Sharp masks are
+ *  unaffected (their alpha-0 region simply sits inside the grown box). */
+export declare const MASK_FEATHER_PAD = 180;
+/** A typed mask source, the only shapes the builder accepts. Anything else
+ *  (string, missing discriminant, extra markup) is rejected. A `group` source
+ *  (#O) references a GROUP/FRAME container by id, composited downstream. */
+export type MaskSource = {
+    kind: "shape";
+    ref: string;
+} | {
+    kind: "image";
+    src: string;
+    srcRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+} | {
+    kind: "group";
+    ref: string;
+};
+/** The typed mask spec as it reaches the runtime (compiler-lowered or a live
+ *  LSDP delta). All fields are re-validated here — nothing is trusted. */
+export interface MaskSpec {
+    source: MaskSource;
+    type: "alpha" | "luminance";
+    op: "intersect" | "subtract" | "union";
+    position?: {
+        x: number;
+        y: number;
+    };
+    size?: {
+        w: number;
+        h: number;
+    };
+}
+/** What a successfully-built mask contributes to the render. */
+export interface BuiltMask {
+    /** The `<mask>` element to drop into the masked element's SVG `<defs>`. */
+    def: ReactElement;
+    /** Inline style applying the mask to the masked subtree's wrapper. */
+    style: CSSProperties;
+    /** The generated mask id (for `url(#…)` wiring and test assertions). */
+    id: string;
+    /** True when the coverage is FEATHERED (a blurred edge) : the masked wrapper
+     *  must grow by MASK_FEATHER_PAD (tree.tsx) so the soft rim isn't re-cut into a
+     *  square, and the coverage here is pre-shifted by the same pad. A sharp mask
+     *  leaves this false and skips the pad entirely (no structural change). */
+    feather: boolean;
+}
+/**
+ * Validate a loose `mask` value into a strict {@link MaskSpec}, or `null`.
+ * Re-runs the closed-enum gates (T4) and the source-shape discriminant ;
+ * a malformed mask is dropped whole (it cannot be partially honoured).
+ */
+export declare function parseMaskSpec(value: unknown, nodeId: string | undefined): MaskSpec | null;
+/**
+ * Build a `<mask>` element + the CSS reference from a typed mask spec.
+ * Returns `null` when the mask must be omitted (bad enum, rejected host,
+ * unsafe ref) — the caller renders the subtree unmasked.
+ *
+ * @param mask          the typed spec (already enum-checked by parseMaskSpec,
+ *                      but re-checked here so the builder is safe standalone).
+ * @param allowedHosts  the bundle's `assets.allowedHosts` ; an image source is
+ *                      gated against it (T1/T2) before reaching `<image href>`.
+ * @param nodeId        for diagnostics (never carries a value, R9).
+ * @param resolveShape  resolves a shape `mask.source.ref` to its inlined
+ *                      coverage geometry (#K). Omitted / returns `null` ⇒ the
+ *                      shape source is pending → the whole mask is omitted.
+ */
+export declare function buildMask(mask: MaskSpec, allowedHosts: readonly string[] | undefined, nodeId: string | undefined, resolveShape?: ShapeRefResolver, boxSize?: {
+    w?: number;
+    h?: number;
+}, feather?: boolean): BuiltMask | null;
+//# sourceMappingURL=mask.d.ts.map

package/dist/render/mask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../../src/render/mask.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAIzD;;;;kEAIkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;AAOpE;;;;;0EAK0E;AAC1E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAKpC;;4EAE4E;AAC5E,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;0EAC0E;AAC1E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAC5B,EAAE,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,GAAG,EAAE,YAAY,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,aAAa,CAAC;IACrB,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX;;;+EAG2E;IAC3E,OAAO,EAAE,OAAO,CAAC;CAClB;AAoBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAuDzF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,CAAC,EAAE,gBAAgB,EAC/B,OAAO,CAAC,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACpC,OAAO,UAAQ,GACd,SAAS,GAAG,IAAI,CAsMlB"}