@lumencast/runtime 0.3.0 → 0.5.0

package/dist/render/bind-animate.js

@@ -0,0 +1,329 @@
+// LSML 1.1 §6.3 `bindAnimate` — continuous interpolation toward a live
+// leaf value (ADR 001 §3.3, issue #33).
+//
+// Per binding, the hook subscribes the existing leaf-grain signal and
+// retargets a Framer motion value on change — NO remount, the DOM node
+// is identical before/after (RC#6). Scalar channels (§6.1) ride motion
+// values attached to a wrapping `motion.div` ; colour channels (§6.5)
+// are interpolated component-wise in sRGB through the strict shared
+// parser and flow back into the primitive's resolved prop (which
+// re-validates them — RC#11 belt and braces).
+//
+// Anti-DoS (Bastion RC#13) : deltas are coalesced per frame — one
+// retarget max per rAF per binding, whatever the producer's rate
+// (1 kHz tested in E2E). Retargets interrupt in-flight springs with
+// velocity carry (§6.2/§6.4 — framer preserves a motion value's
+// velocity when a spring animation is replaced ; no snap).
+//
+// R8 runtime half (issue #42) : `filter.blur` / `filter.brightness`
+// values arriving live re-pass the same caps as the compiler before
+// they may touch the composed CSS filter (see filter-clamp.ts).
+//
+// Stagger (§6.7) : inside a `repeat` iteration the FIRST animated
+// retarget per binding is delayed by the ambient StaggerContext delay ;
+// steady-state retargets are never delayed (a permanently-lagging gauge
+// would defeat the purpose of a live binding). Documented hypothesis —
+// the spec only constrains animation *starts*.
+import { animate, useMotionValue, useTransform, } from "framer-motion";
+import { effect } from "@preact/signals-react";
+import { useContext, useEffect, useMemo, useRef, useState } from "react";
+import { scopedPath } from "./scope";
+import { StaggerContext } from "./stagger-context";
+import { toFramer } from "../animate/transitions";
+import { createFrameCoalescer } from "../animate/frame-coalescer";
+import { clampFilterChannel, warnRejectedFilter } from "./filter-clamp";
+import { warnRejectedColor } from "./css-color";
+import { emitDiagnostic } from "./diagnostics";
+import { cssColorToRgba, mixRgba, serializeRgba } from "./color-interp";
+/** §6.5 colour-typed bindAnimate keys → the runtime prop name the
+ *  primitive reads (and re-validates through `parseCssColor`). */
+export const BIND_ANIMATE_COLOR_PROPS = {
+    "style.color": "colour",
+    fill: "fill",
+    background: "background",
+};
+/**
+ * Validate + normalise one live bindAnimate value into per-channel
+ * numeric targets. Returns `null` on rejection (wrong JSON shape per
+ * §6.3, non-finite numbers, filter values outside the R8 caps when the
+ * channel rejects rather than clamps). A `null` keeps the last
+ * known-good target — the raw input never reaches a style.
+ *
+ * Exported pure for the hostile-delta fixture suite (issue #42).
+ */
+export function resolveScalarTargets(key, raw) {
+    switch (key) {
+        case "opacity": {
+            const v = toFiniteScalar(raw);
+            if (v === null)
+                return null;
+            return { opacity: v < 0 ? 0 : v > 1 ? 1 : v };
+        }
+        case "transform.translate": {
+            if (!Array.isArray(raw) || raw.length !== 2)
+                return null;
+            const tx = toFiniteScalar(raw[0]);
+            const ty = toFiniteScalar(raw[1]);
+            if (tx === null || ty === null)
+                return null;
+            return { x: tx, y: ty };
+        }
+        case "transform.scale": {
+            const s = toFiniteScalar(raw);
+            if (s !== null)
+                return { scaleX: s, scaleY: s };
+            if (Array.isArray(raw) && raw.length === 2) {
+                const sx = toFiniteScalar(raw[0]);
+                const sy = toFiniteScalar(raw[1]);
+                if (sx === null || sy === null)
+                    return null;
+                return { scaleX: sx, scaleY: sy };
+            }
+            return null;
+        }
+        case "transform.rotate": {
+            const v = toFiniteScalar(raw);
+            if (v === null)
+                return null;
+            return { rotate: v };
+        }
+        case "filter.blur": {
+            const v = clampFilterChannel("blur", raw);
+            return v === null ? null : { blur: v };
+        }
+        case "filter.brightness": {
+            const v = clampFilterChannel("brightness", raw);
+            return v === null ? null : { brightness: v };
+        }
+        default:
+            return null;
+    }
+}
+// ── IEEE-754 `-0` policy (R8 / PR #39 coherence, issue #33) ───────────
+// `-0 < 0` is FALSE, so a plain sign clamp lets -0 through. Uniform
+// rule : no -0 ever reaches a motion value or a style. Per channel :
+//   · opacity — the negative case CLAMPS to 0 (`-5 → 0`), so -0 follows
+//     the same line and normalises to +0 (rejecting -0 while clamping
+//     -5 would be incoherent within the channel) ;
+//   · translate / scale / rotate — negatives are valid values and
+//     `-0 == 0` is mathematically neutral, so -0 normalises to +0 (a
+//     producer computing `-x` at x = 0 must not be rejected into a
+//     stale last-good) ;
+//   · filter.blur / filter.brightness — REJECTED (null → last-good) by
+//     `clampFilterChannel` : the R8 gate treats any negative sign,
+//     including -0, as hostile input (compiler mirror, issues #39/#41
+//     — do not relax here).
+/** Finite-number gate + `-0 → +0` normalisation for the generic scalar
+ *  channels (filter channels go through `clampFilterChannel` instead). */
+function toFiniteScalar(v) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        return null;
+    return Object.is(v, -0) ? 0 : v;
+}
+/** Default retarget transition when neither a per-leaf wire directive
+ *  nor a compiled `transitions` entry resolves : the §6.2 default
+ *  spring (stiffness 170, damping 26, mass 1). A spring is the only
+ *  curve with well-defined retarget semantics (velocity carry) — a
+ *  documented hypothesis, see the PR for issue #33. */
+export const DEFAULT_BIND_ANIMATE_TRANSITION = {
+    kind: "spring",
+    stiffness: 170,
+    damping: 26,
+    mass: 1,
+};
+/** node.transitions lookup key for each bindAnimate key (mirrors the
+ *  compiler's `transitionKeysForBindAnimate`). */
+function transitionLookupKey(key) {
+    switch (key) {
+        case "opacity":
+            return "opacity";
+        case "transform.translate":
+            return "x";
+        case "transform.scale":
+            return "scale";
+        case "transform.rotate":
+            return "rotate";
+        case "filter.blur":
+        case "filter.brightness":
+            return "filter";
+        default:
+            return BIND_ANIMATE_COLOR_PROPS[key] ?? key;
+    }
+}
+const NO_COLORS = {};
+/**
+ * Drive a node's `animateBindings`. Must be called unconditionally
+ * (hook) ; cheap no-op when the node has no bindings.
+ */
+export function useBindAnimate(node, store, scope) {
+    const bindings = node.animateBindings;
+    const staggerDelayMs = useContext(StaggerContext);
+    // Fixed channel set — created unconditionally so hook order is
+    // stable ; unbound channels stay at their identity value.
+    const opacity = useMotionValue(1);
+    const x = useMotionValue(0);
+    const y = useMotionValue(0);
+    const scaleX = useMotionValue(1);
+    const scaleY = useMotionValue(1);
+    const rotate = useMotionValue(0);
+    const blur = useMotionValue(0);
+    const brightness = useMotionValue(1);
+    // Composed CSS filter — both functions always present so framer
+    // interpolates structurally-identical lists (same form as the
+    // compiler emits, clamped per R8).
+    const filter = useTransform([blur, brightness], ([b, br]) => `blur(${b}px) brightness(${br})`);
+    const [colorProps, setColorProps] = useState(NO_COLORS);
+    const channels = useRef({
+        opacity,
+        x,
+        y,
+        scaleX,
+        scaleY,
+        rotate,
+        blur,
+        brightness,
+    });
+    useEffect(() => {
+        if (!bindings || Object.keys(bindings).length === 0)
+            return;
+        const mvs = channels.current;
+        const controls = new Map();
+        const colorState = new Map();
+        const animatedOnce = new Set();
+        let mounted = false;
+        const transitionFor = (key, fullPath) => {
+            const live = store.transitionSignal(fullPath).peek();
+            const declared = live ?? node.transitions?.[transitionLookupKey(key)];
+            const base = toFramer(declared ?? DEFAULT_BIND_ANIMATE_TRANSITION);
+            // §6.7 — stagger delays only the first animated retarget.
+            if (staggerDelayMs > 0 && !animatedOnce.has(key)) {
+                return { ...base, delay: staggerDelayMs / 1000 };
+            }
+            return base;
+        };
+        const dispatch = (key, value, instant) => {
+            const colorProp = BIND_ANIMATE_COLOR_PROPS[key];
+            const fullPath = scopedPath(scope, bindings[key]);
+            if (colorProp !== undefined) {
+                // §6.5 — canonicalise BOTH endpoints through the strict parser
+                // before interpolating ; never a raw string.
+                const end = cssColorToRgba(value);
+                if (end === null) {
+                    warnRejectedColor(`bindAnimate.${key}`, node.id);
+                    return;
+                }
+                const prev = colorState.get(key);
+                if (instant || prev === undefined) {
+                    colorState.set(key, { current: end });
+                    setColorProps((p) => ({ ...p, [colorProp]: serializeRgba(end) }));
+                    return;
+                }
+                const start = prev.current;
+                const tx = transitionFor(key, fullPath);
+                animatedOnce.add(key);
+                controls.get(`color:${key}`)?.stop();
+                controls.set(`color:${key}`, animate(0, 1, {
+                    ...tx,
+                    onUpdate: (t) => {
+                        const mixed = mixRgba(start, end, t);
+                        prev.current = mixed;
+                        setColorProps((p) => ({ ...p, [colorProp]: serializeRgba(mixed) }));
+                    },
+                }));
+                return;
+            }
+            const targets = resolveScalarTargets(key, value);
+            if (targets === null) {
+                // R9 — the offending value is never logged.
+                if (key.startsWith("filter."))
+                    warnRejectedFilter(`bindAnimate.${key}`, node.id);
+                else
+                    warnRejectedBindValue(key, node.id);
+                return;
+            }
+            if (instant) {
+                // §6.3.1 — on mount the rendered state initialises from the
+                // bound value instantly (there is no previous state).
+                for (const [ch, v] of Object.entries(targets)) {
+                    mvs[ch].jump(v);
+                }
+                return;
+            }
+            const tx = transitionFor(key, fullPath);
+            animatedOnce.add(key);
+            for (const [ch, v] of Object.entries(targets)) {
+                // framer's animate() replaces any in-flight animation on the
+                // motion value and seeds the new spring with the value's
+                // current velocity — §6.2 velocity carry, no snap.
+                controls.set(ch, animate(mvs[ch], v, tx));
+            }
+        };
+        // RC#13 — one retarget max per rAF per binding.
+        const coalescer = createFrameCoalescer((key, value) => dispatch(key, value, false));
+        const disposers = Object.entries(bindings).map(([key, path]) => effect(() => {
+            const v = store.signal(scopedPath(scope, path)).value;
+            if (v === undefined)
+                return;
+            if (!mounted)
+                dispatch(key, v, true);
+            else
+                coalescer.push(key, v);
+        }));
+        mounted = true;
+        return () => {
+            for (const d of disposers)
+                d();
+            coalescer.dispose();
+            for (const c of controls.values())
+                c.stop();
+        };
+        // node/store/scope identity changes re-wire every subscription ;
+        // staggerDelayMs is stable per repeat iteration.
+    }, [node, bindings, store, scope, staggerDelayMs]);
+    const motionStyle = useMemo(() => {
+        if (!bindings)
+            return null;
+        const style = {};
+        let any = false;
+        for (const key of Object.keys(bindings)) {
+            switch (key) {
+                case "opacity":
+                    style.opacity = opacity;
+                    any = true;
+                    break;
+                case "transform.translate":
+                    style.x = x;
+                    style.y = y;
+                    any = true;
+                    break;
+                case "transform.scale":
+                    style.scaleX = scaleX;
+                    style.scaleY = scaleY;
+                    any = true;
+                    break;
+                case "transform.rotate":
+                    style.rotate = rotate;
+                    any = true;
+                    break;
+                case "filter.blur":
+                case "filter.brightness":
+                    style.filter = filter;
+                    any = true;
+                    break;
+                default:
+                    break; // colour keys flow through colorProps, not the wrapper
+            }
+        }
+        if (!any)
+            return null;
+        style.willChange = "transform, opacity, filter";
+        return style;
+    }, [bindings, opacity, x, y, scaleX, scaleY, rotate, filter]);
+    return { motionStyle, colorProps };
+}
+/** R9 diagnostic — shape-invalid bindAnimate value (non-filter
+ *  channels). Structured event, value withheld. */
+function warnRejectedBindValue(key, nodeId) {
+    emitDiagnostic(nodeId, `bindAnimate.${key}`, "rejected bound value : JSON shape does not match the property type (LSML §6.3)");
+}
+//# sourceMappingURL=bind-animate.js.map

package/dist/render/bind-animate.js.map

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

package/dist/render/bundle.d.ts

@@ -22,6 +22,17 @@ export interface RenderNode {
      *  the primitive applies no `initial` and the prior no-mount-play
      *  behaviour holds (backward compatible). */
     animate_initial?: Record<string, number | string>;
+    /** LSML 1.1 §6.3 — animation targets bound to leaf paths
+     *  (`bindAnimate`). Keys are the spec property names (`opacity`,
+     *  `transform.translate`, `transform.scale`, `transform.rotate`,
+     *  `filter.blur`, `filter.brightness`, plus the kind's colour-typed
+     *  property per §6.5 : `style.color` / `fill` / `background`) ; values
+     *  are LeafPaths. The runtime subscribes each path's leaf-grain signal
+     *  and retargets a Framer motion value on change — continuous
+     *  interpolation toward the live value, no remount. Deltas are
+     *  coalesced per frame (one retarget max per rAF per binding,
+     *  ADR 001 RC#13). */
+    animateBindings?: Record<string, string>;
     /** LSML 1.1 §6.6 — multi-step keyframe sequence played on mount or
      *  whenever `keyframes.key` (LeafPath) changes. Coexists with
      *  `transitions` ; the runtime applies whichever was last triggered
@@ -63,9 +74,11 @@ export interface RenderBundle {
     external_adapters?: ExternalAdapter[];
     assets?: Asset[];
     /** LSML 1.1 §17.3 — capability profiles required for correct rendering.
-     * Each entry is a `<vendor>.<name>-<version>` string. The runtime
-     * checks every entry against its supported list ; an unrecognised
-     * profile raises BUNDLE_INCOMPATIBLE per §17.3.1. */
+     * Each entry is an `x-<vendor>.<name>/<version>` string. The runtime
+     * checks every behavioural entry against its supported list ; an
+     * unrecognised behavioural profile raises BUNDLE_INCOMPATIBLE per
+     * §17.3.1. Authoring profiles (`x-<vendor>.authoring/<major>`, §17.5.1)
+     * are advisory : ignored at render time, never a rejection cause. */
     profiles?: string[];
 }
 /**
@@ -80,6 +93,10 @@ export interface RenderBundle {
  * reject.
  */
 export declare const SUPPORTED_PROFILES: ReadonlySet<string>;
+/** True when `id` has the complete authoring-profile form
+ * `x-<vendor>.authoring/<major>` (LSML 1.1 §17.5.1, ADR 001 RC#14).
+ * Such profiles are advisory : ignored at render time, never rejected. */
+export declare function isAuthoringProfile(id: string): boolean;
 export declare class BundleIncompatibleError extends Error {
     readonly code: "BUNDLE_INCOMPATIBLE";
     readonly unsupportedProfiles: string[];
@@ -87,7 +104,20 @@ export declare class BundleIncompatibleError extends Error {
 }
 /** Validate a bundle's `profiles[]` against the runtime's supported
  * set. Throws `BundleIncompatibleError` listing every offending entry
- * when at least one is not supported. */
+ * when at least one behavioural profile is not supported.
+ *
+ * Authoring profiles (`x-<vendor>.authoring/<major>`, LSML 1.1 §17.5.1)
+ * are advisory and skipped : their absence from the supported set is
+ * never a rejection cause. Every other (behavioural) unsupported profile
+ * keeps the hard §17.3.1 `BUNDLE_INCOMPATIBLE` rejection.
+ *
+ * Malformed-shape guard : `bundle` may come from an unchecked
+ * `json as RenderBundle` cast on untrusted server JSON
+ * (`FetcherImpl.get`). A non-array `profiles` or a non-string entry is
+ * therefore reachable at runtime and is rejected as
+ * `BundleIncompatibleError` (typed, code BUNDLE_INCOMPATIBLE) — never a
+ * raw TypeError. The diagnostic never echoes the malformed value, only a
+ * shape placeholder. */
 export declare function validateBundleProfiles(bundle: {
     profiles?: string[];
 }, supported?: ReadonlySet<string>): void;
@@ -98,12 +128,24 @@ export interface BundleFetcher {
      *  flight" handoff path. */
     preload(bundle: RenderBundle): void;
 }
+/** Resolves the absolute URL of a scene's render bundle. Supplied by the
+ *  host (`MountOptions.resolveBundleUrl`) when the server is not at the
+ *  default host-root LSDP/1 layout — e.g. reached through a gateway prefix
+ *  (`https://gw/orion/api/v1/scenes/{id}/render-bundle?v={hash}`). */
+export type BundleUrlResolver = (sceneId: string, sceneVersion: string) => string;
 export interface BundleFetcherOptions {
     /** Base URL of the server. The fetcher constructs
-     *  `${baseUrl}/lsdp/v1/scenes/{id}/bundle?v={hash}`. */
+     *  `${baseUrl}/lsdp/v1/scenes/{id}/bundle?v={hash}`. Ignored when
+     *  `resolveUrl` is provided. */
     baseUrl: string;
-    /** Path prefix for bundle resolution. Defaults to `/lsdp/v1/scenes`. */
+    /** Path prefix for bundle resolution. Defaults to `/lsdp/v1/scenes`.
+     *  Ignored when `resolveUrl` is provided. */
     pathPrefix?: string;
+    /** When set, takes full control of URL construction — the host owns the
+     *  whole URL (base, path prefix and `/bundle` vs `/render-bundle` suffix).
+     *  Lets a gateway-prefixed server be addressed without changing the
+     *  host-root default. */
+    resolveUrl?: BundleUrlResolver;
     fetchImpl?: typeof fetch;
 }
 export declare function createBundleFetcher(opts: BundleFetcherOptions): BundleFetcher;

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

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

package/dist/render/bundle.js

@@ -24,6 +24,45 @@
 export const SUPPORTED_PROFILES = new Set([
     "x-lumencast.color-srgb-1.0",
 ]);
+// LSML 1.1 §17.5.1 + ADR 001 RC#14 — authoring-profile detection.
+//
+// An authoring profile is advisory : a runtime that does not support it
+// MUST NOT reject the bundle and renders the underlying primitives as if
+// the profile were absent. Detection matches the COMPLETE identifier form
+// `x-<vendor>.authoring/<major>` :
+//
+//   - `x-` prefix, then one or more lowercase name segments separated by
+//     dots, where `.authoring` is the EXACT TERMINAL segment before `/` ;
+//   - `<major>` is a bare integer (no `.minor`) ;
+//   - never a substring test : a behavioural profile whose name merely
+//     *contains* `.authoring` in a non-terminal position is NOT exempted
+//     and keeps §17.3.1 hard-rejection semantics.
+//
+// Anti-ReDoS note : both regexes below are anchored and unambiguous —
+// the character classes exclude the `.` and `/` separators, so there is
+// exactly one possible parse per input (linear time, no backtracking).
+const AUTHORING_NAME_RE = /^x-[a-z0-9-]+(?:\.[a-z0-9-]+)*$/;
+const AUTHORING_MAJOR_RE = /^(?:0|[1-9][0-9]*)$/;
+const AUTHORING_SUFFIX = ".authoring";
+/** True when `id` has the complete authoring-profile form
+ * `x-<vendor>.authoring/<major>` (LSML 1.1 §17.5.1, ADR 001 RC#14).
+ * Such profiles are advisory : ignored at render time, never rejected. */
+export function isAuthoringProfile(id) {
+    const slash = id.indexOf("/");
+    if (slash < 0)
+        return false;
+    const name = id.slice(0, slash);
+    const major = id.slice(slash + 1);
+    if (!AUTHORING_MAJOR_RE.test(major))
+        return false;
+    if (!name.endsWith(AUTHORING_SUFFIX))
+        return false;
+    // `name` minus the terminal `.authoring` segment must still be a valid
+    // `x-<vendor>[.<segment>...]` prefix — this is what makes `.authoring`
+    // a real terminal segment rather than a substring of another one
+    // (e.g. `x-evilauthoring/1` or `x-evil.authoring.fx/1` do not match).
+    return AUTHORING_NAME_RE.test(name.slice(0, -AUTHORING_SUFFIX.length));
+}
 export class BundleIncompatibleError extends Error {
     code = "BUNDLE_INCOMPATIBLE";
     unsupportedProfiles;
@@ -35,12 +74,32 @@ export class BundleIncompatibleError extends Error {
 }
 /** Validate a bundle's `profiles[]` against the runtime's supported
  * set. Throws `BundleIncompatibleError` listing every offending entry
- * when at least one is not supported. */
+ * when at least one behavioural profile is not supported.
+ *
+ * Authoring profiles (`x-<vendor>.authoring/<major>`, LSML 1.1 §17.5.1)
+ * are advisory and skipped : their absence from the supported set is
+ * never a rejection cause. Every other (behavioural) unsupported profile
+ * keeps the hard §17.3.1 `BUNDLE_INCOMPATIBLE` rejection.
+ *
+ * Malformed-shape guard : `bundle` may come from an unchecked
+ * `json as RenderBundle` cast on untrusted server JSON
+ * (`FetcherImpl.get`). A non-array `profiles` or a non-string entry is
+ * therefore reachable at runtime and is rejected as
+ * `BundleIncompatibleError` (typed, code BUNDLE_INCOMPATIBLE) — never a
+ * raw TypeError. The diagnostic never echoes the malformed value, only a
+ * shape placeholder. */
 export function validateBundleProfiles(bundle, supported = SUPPORTED_PROFILES) {
     const profiles = bundle.profiles;
-    if (!profiles || profiles.length === 0)
+    if (!profiles)
+        return;
+    if (!Array.isArray(profiles)) {
+        throw new BundleIncompatibleError(["<malformed: profiles is not an array>"]);
+    }
+    if (profiles.length === 0)
         return;
-    const missing = profiles.filter((p) => !supported.has(p));
+    const missing = profiles
+        .filter((p) => typeof p !== "string" || (!isAuthoringProfile(p) && !supported.has(p)))
+        .map((p) => (typeof p === "string" ? p : "<malformed: non-string profile entry>"));
     if (missing.length > 0) {
         throw new BundleIncompatibleError(missing);
     }
@@ -49,12 +108,20 @@ class FetcherImpl {
     cache = new Map();
     baseUrl;
     pathPrefix;
+    resolveUrl;
     fetchImpl;
     constructor(opts) {
         this.baseUrl = opts.baseUrl.replace(/\/$/, "");
         this.pathPrefix = (opts.pathPrefix ?? "/lsdp/v1/scenes").replace(/\/$/, "");
+        this.resolveUrl = opts.resolveUrl;
         this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
     }
+    buildUrl(sceneId, sceneVersion) {
+        if (this.resolveUrl) {
+            return this.resolveUrl(sceneId, sceneVersion);
+        }
+        return `${this.baseUrl}${this.pathPrefix}/${encodeURIComponent(sceneId)}/bundle?v=${encodeURIComponent(sceneVersion)}`;
+    }
     preload(bundle) {
         // LSML 1.1 §17.3.1 — reject early if any declared profile is
         // unsupported by this runtime. Authors get an actionable error
@@ -66,7 +133,7 @@ class FetcherImpl {
         const cached = this.cache.get(sceneVersion);
         if (cached)
             return cached;
-        const url = `${this.baseUrl}${this.pathPrefix}/${encodeURIComponent(sceneId)}/bundle?v=${encodeURIComponent(sceneVersion)}`;
+        const url = this.buildUrl(sceneId, sceneVersion);
         const response = await this.fetchImpl(url);
         if (!response.ok) {
             throw new Error(`bundle fetch failed: ${response.status} ${response.statusText}`);

package/dist/render/bundle.js.map

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

package/dist/render/color-interp.d.ts

@@ -0,0 +1,18 @@
+/** RGBA channels, each in [0, 1]. */
+export type Rgba = readonly [number, number, number, number];
+/**
+ * Canonicalise + convert an untrusted colour value to RGBA channels in
+ * [0, 1]. The value passes through `parseCssColor` FIRST — anything the
+ * strict parser rejects converts to `null` here (never interpolate a
+ * raw string, §6.5 step 1 / RC#11). `currentcolor` is also rejected :
+ * it has no concrete channels without computed-style context.
+ */
+export declare function cssColorToRgba(value: unknown): Rgba | null;
+/** Component-wise sRGB lerp (§6.5 step 2). `t` may overshoot (springs) ;
+ *  channels clamp back into [0, 1] after mixing. */
+export declare function mixRgba(a: Rgba, b: Rgba, t: number): Rgba;
+/** Serialise RGBA back to `rgba()` form (§6.5 step 3). The output is
+ *  always re-accepted by `parseCssColor` (integer channels, alpha with
+ *  at most 4 decimals). */
+export declare function serializeRgba(rgba: Rgba): string;
+//# sourceMappingURL=color-interp.d.ts.map

package/dist/render/color-interp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-interp.d.ts","sourceRoot":"","sources":["../../src/render/color-interp.ts"],"names":[],"mappings":"AAmBA,qCAAqC;AACrC,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AA8J7D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAuC1D;AAqDD;oDACoD;AACpD,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED;;2BAE2B;AAC3B,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAOhD"}