@lumencast/runtime 0.1.0

package/dist/overlay/control.js

@@ -0,0 +1,127 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSignals } from "@preact/signals-react/runtime";
+import { useLumencastRuntime } from "./runtime-context";
+const PANEL_STYLE = {
+    position: "fixed",
+    bottom: 12,
+    left: 12,
+    zIndex: 100_000,
+    width: 320,
+    maxHeight: "70vh",
+    overflowY: "auto",
+    padding: 12,
+    fontFamily: "system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
+    fontSize: 12,
+    color: "#e5e7eb",
+    background: "rgba(17, 24, 39, 0.92)",
+    border: "1px solid rgba(75, 85, 99, 0.6)",
+    borderRadius: 10,
+    boxShadow: "0 8px 32px rgba(0, 0, 0, 0.45)",
+};
+const ROW_STYLE = {
+    display: "flex",
+    flexDirection: "column",
+    gap: 4,
+    padding: "6px 0",
+    borderBottom: "1px solid rgba(75, 85, 99, 0.35)",
+};
+const LABEL_STYLE = {
+    color: "#9ca3af",
+    fontSize: 10.5,
+    letterSpacing: "0.02em",
+    textTransform: "uppercase",
+};
+const INPUT_STYLE = {
+    background: "rgba(31, 41, 55, 0.8)",
+    border: "1px solid rgba(75, 85, 99, 0.6)",
+    borderRadius: 6,
+    color: "#f9fafb",
+    padding: "4px 6px",
+    fontSize: 12,
+    width: "100%",
+};
+export function ControlPanel() {
+    const { bundle, store, sendInput } = useLumencastRuntime();
+    useSignals();
+    const inputs = bundle.operator_inputs ?? [];
+    if (inputs.length === 0)
+        return null;
+    // Group entries by `group` field for readability.
+    const groups = new Map();
+    for (const entry of inputs) {
+        const g = entry.group ?? "General";
+        const list = groups.get(g) ?? [];
+        list.push(entry);
+        groups.set(g, list);
+    }
+    return (_jsxs("div", { style: PANEL_STYLE, "data-testid": "lumencast-control-panel", children: [_jsx("div", { style: {
+                    fontWeight: 600,
+                    fontSize: 11,
+                    letterSpacing: "0.06em",
+                    color: "#9ca3af",
+                    textTransform: "uppercase",
+                    marginBottom: 6,
+                }, children: "Operator inputs" }), [...groups.entries()].map(([group, entries]) => (_jsxs("div", { style: { marginBottom: 8 }, children: [_jsx("div", { style: {
+                            color: "#6b7280",
+                            fontSize: 10,
+                            letterSpacing: "0.04em",
+                            textTransform: "uppercase",
+                            padding: "4px 0",
+                        }, children: group }), entries.map((entry) => (_jsx(InputRow, { entry: entry, currentValue: store.signal(entry.path).value, onCommit: (v) => 
+                        // Operator-control values come from form widgets typed per
+                        // OperatorInput.type; coerce to LeafValue at the boundary.
+                        sendInput([
+                            {
+                                path: entry.path,
+                                value: v,
+                            },
+                        ]) }, entry.path)))] }, group)))] }));
+}
+function InputRow({ entry, currentValue, onCommit, }) {
+    return (_jsxs("div", { style: ROW_STYLE, children: [_jsx("span", { style: LABEL_STYLE, children: entry.label }), _jsx(Editor, { entry: entry, currentValue: currentValue, onCommit: onCommit })] }));
+}
+function Editor({ entry, currentValue, onCommit, }) {
+    switch (entry.type) {
+        case "boolean": {
+            const checked = currentValue === true;
+            return (_jsxs("label", { style: { display: "flex", alignItems: "center", gap: 6 }, children: [_jsx("input", { type: "checkbox", checked: checked, onChange: (e) => onCommit(e.target.checked) }), _jsx("span", { style: { fontSize: 11, color: "#d1d5db" }, children: checked ? "on" : "off" })] }));
+        }
+        case "number": {
+            const min = entry.min;
+            const max = entry.max;
+            const step = entry.step;
+            return (_jsx("input", { type: "number", style: INPUT_STYLE, value: typeof currentValue === "number" ? currentValue : "", min: min, max: max, step: step, onChange: (e) => {
+                    const n = Number(e.target.value);
+                    if (Number.isFinite(n))
+                        onCommit(n);
+                } }));
+        }
+        case "text": {
+            const max = entry.max_length;
+            return (_jsx("input", { type: "text", style: INPUT_STYLE, value: typeof currentValue === "string" ? currentValue : "", maxLength: max, onChange: (e) => onCommit(e.target.value) }));
+        }
+        case "colour": {
+            return (_jsx("input", { type: "color", style: INPUT_STYLE, value: typeof currentValue === "string" ? currentValue : "#000000", onChange: (e) => onCommit(e.target.value) }));
+        }
+        case "duration": {
+            return (_jsx("input", { type: "number", style: INPUT_STYLE, value: typeof currentValue === "number" ? currentValue : "", min: 0, step: 100, onChange: (e) => {
+                    const n = Number(e.target.value);
+                    if (Number.isFinite(n) && n >= 0)
+                        onCommit(n);
+                } }));
+        }
+        case "select":
+        case "enum": {
+            const options = entry.enum_values ??
+                entry.options ??
+                [];
+            return (_jsx("select", { style: INPUT_STYLE, value: typeof currentValue === "string" ? currentValue : "", onChange: (e) => onCommit(e.target.value), children: options.map((opt) => (_jsx("option", { value: opt, children: opt }, opt))) }));
+        }
+        case "path-ref":
+        default:
+            // FIXME (v2) — `path-ref` UX is deferred ; for now show a plain
+            // text entry so the value is still editable.
+            return (_jsx("input", { type: "text", style: INPUT_STYLE, value: typeof currentValue === "string" ? currentValue : "", onChange: (e) => onCommit(e.target.value) }));
+    }
+}
+//# sourceMappingURL=control.js.map

package/dist/overlay/control.js.map

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

package/dist/overlay/runtime-context.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode } from "react";
+import type { Patch } from "@lumencast/protocol";
+import type { Store } from "../state/store";
+import type { RenderBundle } from "../render/bundle";
+import type { ConnectionStatus } from "../transport/ws";
+import type { LumencastMode } from "../types";
+export interface LumencastRuntime {
+    mode: LumencastMode;
+    store: Store;
+    bundle: RenderBundle;
+    status: ConnectionStatus;
+    /** Send LSDP/1 input patches to the server. */
+    sendInput: (patches: Patch[]) => void;
+}
+export declare function LumencastRuntimeProvider({ value, children, }: {
+    value: LumencastRuntime;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useLumencastRuntime(): LumencastRuntime;
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/overlay/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/overlay/runtime-context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC;CACvC;AAID,wBAAgB,wBAAwB,CAAC,EACvC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CAEA;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAQtD"}

package/dist/overlay/runtime-context.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const Ctx = createContext(null);
+export function LumencastRuntimeProvider({ value, children, }) {
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+export function useLumencastRuntime() {
+    const v = useContext(Ctx);
+    if (!v) {
+        throw new Error("Lumencast overlay components must be rendered inside LumencastRuntimeProvider");
+    }
+    return v;
+}
+//# sourceMappingURL=runtime-context.js.map

package/dist/overlay/runtime-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.js","sourceRoot":"","sources":["../../src/overlay/runtime-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAgBlE,MAAM,GAAG,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AAEzD,MAAM,UAAU,wBAAwB,CAAC,EACvC,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,KAAC,GAAG,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAgB,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/overlay/status-pill.d.ts

@@ -0,0 +1,2 @@
+export declare function StatusPill(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=status-pill.d.ts.map

package/dist/overlay/status-pill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-pill.d.ts","sourceRoot":"","sources":["../../src/overlay/status-pill.tsx"],"names":[],"mappings":"AAcA,wBAAgB,UAAU,4CAsBzB"}

package/dist/overlay/status-pill.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLumencastRuntime } from "./runtime-context";
+const COLOURS = {
+    live: "rgba(34, 197, 94, 0.85)",
+    connecting: "rgba(234, 179, 8, 0.85)",
+    disconnected: "rgba(239, 68, 68, 0.85)",
+};
+const LABELS = {
+    live: "live",
+    connecting: "reconnecting",
+    disconnected: "disconnected",
+};
+export function StatusPill() {
+    const { status } = useLumencastRuntime();
+    return (_jsx("div", { "data-testid": "lumencast-status-pill", style: {
+            position: "fixed",
+            top: 12,
+            right: 12,
+            padding: "4px 10px",
+            fontSize: 11,
+            fontFamily: "system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
+            color: "white",
+            background: COLOURS[status] ?? "#444",
+            borderRadius: 999,
+            userSelect: "none",
+            pointerEvents: "none",
+        }, children: LABELS[status] ?? status }));
+}
+//# sourceMappingURL=status-pill.js.map

package/dist/overlay/status-pill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-pill.js","sourceRoot":"","sources":["../../src/overlay/status-pill.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,OAAO,GAA2B;IACtC,IAAI,EAAE,yBAAyB;IAC/B,UAAU,EAAE,yBAAyB;IACrC,YAAY,EAAE,yBAAyB;CACxC,CAAC;AAEF,MAAM,MAAM,GAA2B;IACrC,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,cAAc;CAC7B,CAAC;AAEF,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACzC,OAAO,CACL,6BACc,uBAAuB,EACnC,KAAK,EAAE;YACL,QAAQ,EAAE,OAAO;YACjB,GAAG,EAAE,EAAE;YACP,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,0DAA0D;YACtE,KAAK,EAAE,OAAO;YACd,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;YACrC,YAAY,EAAE,GAAG;YACjB,UAAU,EAAE,MAAM;YAClB,aAAa,EAAE,MAAM;SACtB,YAEA,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,GACrB,CACP,CAAC;AACJ,CAAC"}

package/dist/overlay/test.d.ts

@@ -0,0 +1,5 @@
+/** Test-mode overlay : adapter mocker + state inspector + time
+ *  controls. Drives the server's __test.* family via the same `sendInput`
+ *  channel. */
+export declare function TestPanel(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=test.d.ts.map

package/dist/overlay/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/overlay/test.tsx"],"names":[],"mappings":"AAiDA;;eAEe;AACf,wBAAgB,SAAS,4CAmGxB"}

package/dist/overlay/test.js

@@ -0,0 +1,116 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSignals } from "@preact/signals-react/runtime";
+import { useState } from "react";
+import { useLumencastRuntime } from "./runtime-context";
+const PANEL_STYLE = {
+    position: "fixed",
+    bottom: 12,
+    right: 12,
+    zIndex: 100_001,
+    width: 360,
+    maxHeight: "70vh",
+    overflowY: "auto",
+    padding: 12,
+    fontFamily: "system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
+    fontSize: 12,
+    color: "#e5e7eb",
+    background: "rgba(8, 47, 73, 0.92)",
+    border: "1px solid rgba(56, 189, 248, 0.4)",
+    borderRadius: 10,
+    boxShadow: "0 8px 32px rgba(0, 0, 0, 0.45)",
+};
+const SECTION_TITLE = {
+    fontWeight: 600,
+    fontSize: 11,
+    letterSpacing: "0.06em",
+    color: "#7dd3fc",
+    textTransform: "uppercase",
+    marginBottom: 6,
+};
+const BUTTON_STYLE = {
+    background: "rgba(14, 165, 233, 0.4)",
+    border: "1px solid rgba(125, 211, 252, 0.5)",
+    borderRadius: 6,
+    color: "#f0f9ff",
+    padding: "3px 8px",
+    fontSize: 11,
+    cursor: "pointer",
+};
+const ADAPTER_ROW = {
+    display: "flex",
+    flexDirection: "column",
+    gap: 4,
+    padding: "6px 0",
+    borderBottom: "1px solid rgba(56, 189, 248, 0.2)",
+};
+/** Test-mode overlay : adapter mocker + state inspector + time
+ *  controls. Drives the server's __test.* family via the same `sendInput`
+ *  channel. */
+export function TestPanel() {
+    const { bundle, store, sendInput } = useLumencastRuntime();
+    useSignals();
+    const [filter, setFilter] = useState("");
+    const adapters = bundle.external_adapters ?? [];
+    const stateRecord = store.toRecord();
+    const filteredEntries = Object.entries(stateRecord).filter(([k]) => filter === "" || k.includes(filter));
+    return (_jsxs("div", { style: PANEL_STYLE, "data-testid": "lumencast-test-panel", children: [_jsx("div", { style: SECTION_TITLE, children: "Time" }), _jsxs("div", { style: { display: "flex", gap: 6, marginBottom: 8 }, children: [_jsx("button", { type: "button", style: BUTTON_STYLE, onClick: () => sendInput([{ path: "__test.tick", value: 100 }]), children: "tick +100ms" }), _jsx("button", { type: "button", style: BUTTON_STYLE, onClick: () => sendInput([{ path: "__test.tick", value: 1_000 }]), children: "tick +1s" }), _jsx("button", { type: "button", style: BUTTON_STYLE, onClick: () => sendInput([{ path: "__test.reset", value: true }]), children: "reset" })] }), _jsx("div", { style: SECTION_TITLE, children: "External adapters" }), adapters.length === 0 && (_jsx("div", { style: { color: "#94a3b8", fontStyle: "italic", fontSize: 11 }, children: "No external adapters declared in this scene." })), adapters.map((adapter) => (_jsx(AdapterRow, { adapter: adapter, onMock: (payload) => 
+                // LSDP/1 patch values must be leaf — JSON-encode the structured payload.
+                sendInput([
+                    {
+                        path: "__test.mock_adapter",
+                        value: JSON.stringify({ key: adapter.key, payload }),
+                    },
+                ]) }, adapter.key))), _jsx("div", { style: { ...SECTION_TITLE, marginTop: 12 }, children: "State" }), _jsx("input", { type: "text", placeholder: "filter paths\u2026", value: filter, onChange: (e) => setFilter(e.target.value), style: {
+                    background: "rgba(8, 47, 73, 0.6)",
+                    border: "1px solid rgba(125, 211, 252, 0.4)",
+                    borderRadius: 6,
+                    color: "#e0f2fe",
+                    padding: "4px 6px",
+                    fontSize: 11,
+                    width: "100%",
+                    marginBottom: 6,
+                } }), _jsx("div", { style: { fontFamily: "monospace", fontSize: 10.5 }, children: filteredEntries.map(([path, value]) => (_jsxs("div", { style: {
+                        display: "grid",
+                        gridTemplateColumns: "1fr auto",
+                        gap: 8,
+                        padding: "2px 0",
+                        borderBottom: "1px dashed rgba(125, 211, 252, 0.15)",
+                    }, children: [_jsx("span", { style: { color: "#bae6fd" }, children: path }), _jsx("span", { style: { color: "#fef3c7" }, children: formatValue(value) })] }, path))) })] }));
+}
+function AdapterRow({ adapter, onMock, }) {
+    const [draft, setDraft] = useState("{}");
+    return (_jsxs("div", { style: ADAPTER_ROW, children: [_jsxs("div", { style: {
+                    display: "flex",
+                    justifyContent: "space-between",
+                    alignItems: "center",
+                }, children: [_jsx("span", { style: { color: "#e0f2fe" }, children: adapter.label }), _jsx("span", { style: { color: "#94a3b8", fontSize: 10 }, children: adapter.kind })] }), _jsx("textarea", { value: draft, onChange: (e) => setDraft(e.target.value), rows: 2, style: {
+                    fontFamily: "monospace",
+                    fontSize: 10.5,
+                    background: "rgba(8, 47, 73, 0.6)",
+                    color: "#e0f2fe",
+                    border: "1px solid rgba(125, 211, 252, 0.3)",
+                    borderRadius: 4,
+                    padding: 4,
+                    resize: "vertical",
+                } }), _jsx("button", { type: "button", style: BUTTON_STYLE, onClick: () => {
+                    try {
+                        const parsed = JSON.parse(draft);
+                        onMock(parsed);
+                    }
+                    catch {
+                        onMock(draft);
+                    }
+                }, children: "fire" })] }));
+}
+function formatValue(value) {
+    if (value === undefined)
+        return "—";
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    if (typeof value === "object")
+        return JSON.stringify(value);
+    return String(value);
+}
+//# sourceMappingURL=test.js.map

package/dist/overlay/test.js.map

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

package/dist/render/bundle.d.ts

@@ -0,0 +1,102 @@
+import type { Transition } from "../animate/transitions.js";
+import type { Keyframes } from "../animate/keyframes.js";
+export type RenderKind = "stack" | "grid" | "frame" | "text" | "image" | "shape" | "media" | "repeat" | "instance";
+export interface RenderNode {
+    kind: RenderKind;
+    /** Stable identifier for keyed reconciliation. */
+    id?: string;
+    /** Static props (frozen at build/compile time). */
+    props?: Record<string, unknown>;
+    /** Prop name → state path. The render layer subscribes the path's signal
+     *  and applies the value to the named prop on each change. */
+    bindings?: Record<string, string>;
+    /** Default transition per bound prop. Aligns with LSML 1.0 §6 `animate`
+     *  directives. The runtime applies these as CSS transitions / Framer Motion
+     *  configs at render time. */
+    transitions?: Record<string, Transition>;
+    /** 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
+     *  (no blending — see §6.6 last paragraph). */
+    keyframes?: Keyframes;
+    /** LSML 1.1 §6.7 — only meaningful on `repeat`. Each iteration's
+     *  animations start `index * stagger_ms` after iteration 0. */
+    stagger_ms?: number;
+    /** Children — already-inlined primitives only. */
+    children?: RenderNode[];
+}
+export type OperatorInputType = "boolean" | "number" | "text" | "select" | "enum" | "path-ref" | "colour" | "duration";
+export interface OperatorInput {
+    path: string;
+    label: string;
+    type: OperatorInputType;
+    default?: unknown;
+    group?: string;
+    writable_by?: string[];
+    [extra: string]: unknown;
+}
+export interface ExternalAdapter {
+    key: string;
+    label: string;
+    kind: string;
+    target_paths: string[];
+    [extra: string]: unknown;
+}
+export interface Asset {
+    id: string;
+    url: string;
+    kind: string;
+    [extra: string]: unknown;
+}
+export interface RenderBundle {
+    scene_version: string;
+    root: RenderNode;
+    operator_inputs?: OperatorInput[];
+    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. */
+    profiles?: string[];
+}
+/**
+ * Profiles the JS runtime advertises support for. Bundle authors who
+ * declare `profiles: [...]` get a hard `BUNDLE_INCOMPATIBLE` rejection
+ * when any entry is not in this set (LSML 1.1 §17.3.1).
+ *
+ * 1.1 ships with no standard profiles ; future minors / vendor specs
+ * register here. The `x-lumencast.color-srgb-1.0` entry is the
+ * default-color-space marker ; bundles that opt into a perceptual
+ * space (OKLCH) would request a different profile and currently
+ * reject.
+ */
+export declare const SUPPORTED_PROFILES: ReadonlySet<string>;
+export declare class BundleIncompatibleError extends Error {
+    readonly code: "BUNDLE_INCOMPATIBLE";
+    readonly unsupportedProfiles: string[];
+    constructor(unsupportedProfiles: string[]);
+}
+/** Validate a bundle's `profiles[]` against the runtime's supported
+ * set. Throws `BundleIncompatibleError` listing every offending entry
+ * when at least one is not supported. */
+export declare function validateBundleProfiles(bundle: {
+    profiles?: string[];
+}, supported?: ReadonlySet<string>): void;
+export interface BundleFetcher {
+    /** Fetch the bundle for a scene version. Cached forever by hash. */
+    get(sceneId: string, sceneVersion: string): Promise<RenderBundle>;
+    /** Inject a bundle directly — used by tests and for the "scene already in
+     *  flight" handoff path. */
+    preload(bundle: RenderBundle): void;
+}
+export interface BundleFetcherOptions {
+    /** Base URL of the server. The fetcher constructs
+     *  `${baseUrl}/lsdp/v1/scenes/{id}/bundle?v={hash}`. */
+    baseUrl: string;
+    /** Path prefix for bundle resolution. Defaults to `/lsdp/v1/scenes`. */
+    pathPrefix?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare function createBundleFetcher(opts: BundleFetcherOptions): BundleFetcher;
+//# sourceMappingURL=bundle.d.ts.map

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

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

package/dist/render/bundle.js

@@ -0,0 +1,86 @@
+// Render bundle — the runtime's flat, pre-compiled representation of a scene.
+//
+// The bundle is content-addressed by `scene_version` (sha256 of the
+// canonical JSON form). Lumencast fetches it once per `scene_version` and
+// caches forever; the server serves it with long-TTL immutable cache headers.
+//
+// Note on shape: this `RenderBundle` is the flat, runtime-internal form. The
+// canonical *authoring* format (LSML 1.0, see lumencast-protocol/spec/LSML-1.md)
+// uses inline `bind: { value: "path" }` per primitive instead of a `bindings`
+// map. A compiler step (forthcoming `@lumencast/compiler`) will translate
+// LSML 1.0 → RenderBundle. For now, callers who want to feed an LSML 1.0
+// bundle pre-compile or use a hand-rolled adapter.
+/**
+ * Profiles the JS runtime advertises support for. Bundle authors who
+ * declare `profiles: [...]` get a hard `BUNDLE_INCOMPATIBLE` rejection
+ * when any entry is not in this set (LSML 1.1 §17.3.1).
+ *
+ * 1.1 ships with no standard profiles ; future minors / vendor specs
+ * register here. The `x-lumencast.color-srgb-1.0` entry is the
+ * default-color-space marker ; bundles that opt into a perceptual
+ * space (OKLCH) would request a different profile and currently
+ * reject.
+ */
+export const SUPPORTED_PROFILES = new Set([
+    "x-lumencast.color-srgb-1.0",
+]);
+export class BundleIncompatibleError extends Error {
+    code = "BUNDLE_INCOMPATIBLE";
+    unsupportedProfiles;
+    constructor(unsupportedProfiles) {
+        super(`BUNDLE_INCOMPATIBLE: profile(s) not supported by this runtime: ${unsupportedProfiles.join(", ")}`);
+        this.name = "BundleIncompatibleError";
+        this.unsupportedProfiles = unsupportedProfiles;
+    }
+}
+/** Validate a bundle's `profiles[]` against the runtime's supported
+ * set. Throws `BundleIncompatibleError` listing every offending entry
+ * when at least one is not supported. */
+export function validateBundleProfiles(bundle, supported = SUPPORTED_PROFILES) {
+    const profiles = bundle.profiles;
+    if (!profiles || profiles.length === 0)
+        return;
+    const missing = profiles.filter((p) => !supported.has(p));
+    if (missing.length > 0) {
+        throw new BundleIncompatibleError(missing);
+    }
+}
+class FetcherImpl {
+    cache = new Map();
+    baseUrl;
+    pathPrefix;
+    fetchImpl;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, "");
+        this.pathPrefix = (opts.pathPrefix ?? "/lsdp/v1/scenes").replace(/\/$/, "");
+        this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+    }
+    preload(bundle) {
+        // LSML 1.1 §17.3.1 — reject early if any declared profile is
+        // unsupported by this runtime. Authors get an actionable error
+        // instead of a silent rendering glitch.
+        validateBundleProfiles(bundle);
+        this.cache.set(bundle.scene_version, bundle);
+    }
+    async get(sceneId, sceneVersion) {
+        const cached = this.cache.get(sceneVersion);
+        if (cached)
+            return cached;
+        const url = `${this.baseUrl}${this.pathPrefix}/${encodeURIComponent(sceneId)}/bundle?v=${encodeURIComponent(sceneVersion)}`;
+        const response = await this.fetchImpl(url);
+        if (!response.ok) {
+            throw new Error(`bundle fetch failed: ${response.status} ${response.statusText}`);
+        }
+        const json = (await response.json());
+        if (json.scene_version !== sceneVersion) {
+            throw new Error(`bundle scene_version mismatch: expected ${sceneVersion}, got ${json.scene_version}`);
+        }
+        validateBundleProfiles(json);
+        this.cache.set(sceneVersion, json);
+        return json;
+    }
+}
+export function createBundleFetcher(opts) {
+    return new FetcherImpl(opts);
+}
+//# sourceMappingURL=bundle.js.map

package/dist/render/bundle.js.map

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

package/dist/render/fill.d.ts

@@ -0,0 +1,41 @@
+import type { CSSProperties, ReactElement } from "react";
+export interface FillStop {
+    offset: number;
+    color: string;
+    opacity?: number;
+}
+export type Fill = {
+    kind: "solid";
+    color: string;
+    opacity?: number;
+} | {
+    kind: "linear-gradient";
+    angle_deg?: number;
+    stops: FillStop[];
+    opacity?: number;
+} | {
+    kind: "radial-gradient";
+    center?: {
+        x: number;
+        y: number;
+    };
+    radius?: number;
+    stops: FillStop[];
+    opacity?: number;
+};
+export interface FillRenderResult {
+    /** SVG <defs> contributions (gradient definitions). */
+    defs: ReactElement[];
+    /** Reference to use as the `fill` attribute on the shape. */
+    ref: string;
+}
+/** Compile a Fill into an SVG `<defs>` entry + a `fill="url(#…)"` ref.
+ * Solid fills produce no defs and return the colour directly. */
+export declare function renderFill(fill: Fill): FillRenderResult;
+/** 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. */
+export declare function backgroundsToCss(fills: Fill[]): CSSProperties;
+/** Coerce loose JSON into a Fill array. Returns [] for non-arrays. */
+export declare function parseFills(value: unknown): Fill[];
+//# sourceMappingURL=fill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../src/render/fill.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAEzD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,IAAI,GACZ;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAQN,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;iEACiE;AACjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAuDvD;AAED;;qEAEqE;AACrE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,aAAa,CAM7D;AAoCD,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,CAGjD"}