@lumencast/runtime 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumencast/runtime",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Browser runtime for Lumencast — mount(), LSDP/1 transport, leaf-grain store, LSML render, animations, overlays.",
   "license": "Apache-2.0",
   "type": "module",
@@ -36,7 +36,7 @@
     "framer-motion": "^12.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@lumencast/protocol": "0.2.0"
+    "@lumencast/protocol": "0.3.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.49.1",
@@ -49,8 +49,8 @@
     "vite-plugin-dts": "^4.5.0",
     "vitest": "^4.1.5",
     "ws": "^8.18.0",
-    "@lumencast/server": "0.2.0",
-    "@lumencast/dev-server": "0.2.0"
+    "@lumencast/server": "0.3.0",
+    "@lumencast/dev-server": "0.3.0"
   },
   "scripts": {
     "dev": "vite",

package/src/animate/transitions.ts

@@ -79,6 +79,60 @@ export function toFramer(t: Transition | undefined): FramerTransition {
   };
 }
 
+// --- mount-play (LSML 1.1 `animate.from`) ---------------------------
+
+/** Identity (animation-end) value for each framer key an `animate.from`
+ *  may declare. A primitive that doesn't natively animate a given key
+ *  still converges it to this neutral value on mount so the element ends
+ *  up visually correct (e.g. a `from.scale: 0.85` settles at `scale: 1`). */
+const INITIAL_IDENTITY: Record<string, number> = {
+  opacity: 1,
+  scale: 1,
+  rotate: 0,
+  x: 0,
+  y: 0,
+};
+
+export interface MountPlay {
+  initial: Record<string, number | string>;
+  animate: Record<string, number | string>;
+}
+
+/**
+ * Build framer-motion `initial` / `animate` props for a primitive that
+ * may carry an LSML 1.1 `animate.from` initial state.
+ *
+ * `base` is the primitive's own animated target (e.g. `{ opacity }` for
+ * Image/Text/Shape, or `{ opacity, x, y, scale, rotate }` for Frame).
+ * `initial` is the lowered `animate.from` map (or `undefined`).
+ *
+ * When `initial` is absent, this returns `{ initial: base, animate: base }`
+ * — framer mounts at the target and never moves, exactly the prior
+ * no-mount-play behaviour (backward compatible). When `initial` is
+ * present, the element mounts at `initial` and animates to `base`,
+ * augmented with identity convergence for any `from` key the primitive
+ * doesn't already drive — so the mount-play plays out and settles
+ * correctly even on opacity-only primitives.
+ */
+export function mountPlay(
+  base: Record<string, number | string>,
+  initial: Record<string, number | string> | undefined,
+): MountPlay {
+  if (!initial || Object.keys(initial).length === 0) {
+    // No `from` → mount directly at target. Pinning `initial` to the
+    // target (rather than letting framer infer from current style)
+    // preserves the existing "no jump, no mount-play" behaviour.
+    return { initial: base, animate: base };
+  }
+  const animate: Record<string, number | string> = { ...base };
+  for (const key of Object.keys(initial)) {
+    if (!(key in animate)) {
+      animate[key] = INITIAL_IDENTITY[key] ?? 0;
+    }
+  }
+  return { initial, animate };
+}
+
 /**
  * Parse a wire-format `TransitionSpec` (LSDP/1.1 §3.2.2) into the
  * runtime's local Transition type. Returns `undefined` for malformed

package/src/render/bundle.ts

@@ -40,6 +40,14 @@ export interface RenderNode {
    *  directives. The runtime applies these as CSS transitions / Framer Motion
    *  configs at render time. */
   transitions?: Record<string, Transition>;
+  /** LSML 1.1 §6 `animate.from` — mount-time initial state, lowered to a
+   *  flat framer-motion `initial` map (keys: `opacity`, `scale`, `rotate`,
+   *  `x`, `y`, `filter`). When present, the rendering primitive passes this
+   *  as framer-motion `initial={...}` so the element mounts in this state
+   *  and animates to its declared target on mount (mount-play). When absent,
+   *  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.6 — multi-step keyframe sequence played on mount or
    *  whenever `keyframes.key` (LeafPath) changes. Coexists with
    *  `transitions` ; the runtime applies whichever was last triggered

package/src/render/primitives/frame.tsx

@@ -1,7 +1,7 @@
 import { motion } from "framer-motion";
 import type { CSSProperties } from "react";
 import type { PrimitiveProps } from "./index";
-import { toFramer } from "../../animate/transitions";
+import { toFramer, mountPlay } from "../../animate/transitions";
 import { backgroundsToCss, parseFills } from "../fill";
 
 /** Absolute-positioned container with size + transform + opacity.
@@ -13,7 +13,7 @@ import { backgroundsToCss, parseFills } from "../fill";
  *  legacy `background` (single color). The array form supports stacked
  *  fills with linear / radial gradients ; first entry renders on top.
  */
-export function Frame({ resolved, transitionFor, children }: PrimitiveProps) {
+export function Frame({ resolved, transitionFor, animateInitial, children }: PrimitiveProps) {
   const x = numberOr(resolved.x, 0);
   const y = numberOr(resolved.y, 0);
   const width = sizeProp(resolved.width);
@@ -50,16 +50,13 @@ export function Frame({ resolved, transitionFor, children }: PrimitiveProps) {
     style.background = legacyBackground;
   }
 
+  const play = mountPlay({ opacity, x, y, scale, rotate }, animateInitial);
+
   return (
     <motion.div
       style={style}
-      animate={{
-        opacity,
-        x,
-        y,
-        scale,
-        rotate,
-      }}
+      initial={play.initial}
+      animate={play.animate}
       transition={toFramer(tx)}
     >
       {children}

package/src/render/primitives/image.tsx

@@ -1,10 +1,12 @@
 import { motion } from "framer-motion";
 import type { PrimitiveProps } from "./index";
-import { toFramer } from "../../animate/transitions";
+import { toFramer, mountPlay } from "../../animate/transitions";
 
 /** Image leaf. `src`, `fit` (cover/contain/fill), `position`,
- *  `opacity`. Opacity is animated when a transition is declared. */
-export function Image({ resolved, transitionFor }: PrimitiveProps) {
+ *  `opacity`. Opacity is animated when a transition is declared. When an
+ *  `animate.from` is lowered onto the node, it mounts at that state and
+ *  plays to its target on mount (mount-play). */
+export function Image({ resolved, transitionFor, animateInitial }: PrimitiveProps) {
   const src = resolved.src as string | undefined;
   if (!src) return null;
   const fit = (resolved.fit as string | undefined) ?? "contain";
@@ -17,6 +19,7 @@ export function Image({ resolved, transitionFor }: PrimitiveProps) {
   const height = dimOr(resolved.height, "100%");
 
   const tx = transitionFor("opacity") ?? transitionFor("src");
+  const play = mountPlay({ opacity }, animateInitial);
 
   return (
     <motion.img
@@ -26,9 +29,10 @@ export function Image({ resolved, transitionFor }: PrimitiveProps) {
         objectPosition: position,
         width,
         height,
-        willChange: "opacity",
+        willChange: "opacity, transform",
       }}
-      animate={{ opacity }}
+      initial={play.initial}
+      animate={play.animate}
       transition={toFramer(tx)}
       draggable={false}
     />

package/src/render/primitives/index.ts

@@ -20,6 +20,12 @@ import { Instance } from "./instance";
 export interface PrimitiveProps {
   resolved: Record<string, unknown>;
   transitionFor: (key: string) => Transition | undefined;
+  /** LSML 1.1 `animate.from` lowered to a flat framer `initial` map
+   *  (keys: `opacity`, `scale`, `rotate`, `x`, `y`). When present, a
+   *  motion primitive passes it as framer-motion `initial={...}` so the
+   *  element mounts in this state and animates to its rendered target on
+   *  mount (mount-play). `undefined` → no `initial` (no mount-play). */
+  animateInitial?: Record<string, number | string>;
   children?: ReactNode;
 }
 

package/src/render/primitives/shape.tsx

@@ -1,7 +1,7 @@
 import { motion } from "framer-motion";
 import type { ReactElement } from "react";
 import type { PrimitiveProps } from "./index";
-import { toFramer } from "../../animate/transitions";
+import { toFramer, mountPlay } from "../../animate/transitions";
 import { parseFills, renderFill } from "../fill";
 
 interface StrokeSpec {
@@ -18,7 +18,7 @@ interface StrokeSpec {
  *  accepted for 1.0 bundles ; when both are present the array form
  *  wins (the spec forbids mixing, but we tolerate to ease migration).
  */
-export function Shape({ resolved, transitionFor }: PrimitiveProps) {
+export function Shape({ resolved, transitionFor, animateInitial }: PrimitiveProps) {
   const kind = (resolved.kind as string | undefined) ?? "rect";
   const legacyFill = (resolved.fill as string | undefined) ?? "transparent";
   const legacyStroke = (resolved.stroke as string | undefined) ?? "transparent";
@@ -30,6 +30,7 @@ export function Shape({ resolved, transitionFor }: PrimitiveProps) {
 
   const tx = transitionFor("opacity");
   const transition = toFramer(tx);
+  const play = mountPlay({ opacity }, animateInitial);
 
   // LSML 1.1 §4.6 — `fills[]` is the preferred multi-fill form. Fall
   // back to the singular `fill` for 1.0 bundles.
@@ -110,9 +111,10 @@ export function Shape({ resolved, transitionFor }: PrimitiveProps) {
       width={width}
       height={height}
       viewBox={`0 0 ${width} ${height}`}
-      animate={{ opacity }}
+      initial={play.initial}
+      animate={play.animate}
       transition={transition}
-      style={{ willChange: "opacity" }}
+      style={{ willChange: "opacity, transform" }}
     >
       {allDefs.length > 0 && <defs>{allDefs}</defs>}
       {stackedFills.map((ref, i) =>

package/src/render/primitives/text.tsx

@@ -1,11 +1,12 @@
 import { motion } from "framer-motion";
 import type { PrimitiveProps } from "./index";
-import { toFramer } from "../../animate/transitions";
+import { toFramer, mountPlay } from "../../animate/transitions";
 
 /** Text leaf. Value renders as the displayed string ; style props
  *  cover size / weight / colour / alignment. Opacity is animated when
- *  a transition is declared on `opacity` or `value`. */
-export function Text({ resolved, transitionFor }: PrimitiveProps) {
+ *  a transition is declared on `opacity` or `value`. An `animate.from`
+ *  makes it mount-play (initial → target) on mount. */
+export function Text({ resolved, transitionFor, animateInitial }: PrimitiveProps) {
   const value = resolved.value === undefined ? "" : String(resolved.value);
   const size = (resolved.size as string | number | undefined) ?? "1rem";
   const font = resolved.font as string | undefined;
@@ -15,6 +16,7 @@ export function Text({ resolved, transitionFor }: PrimitiveProps) {
   const opacity = numberOr(resolved.opacity, 1);
 
   const tx = transitionFor("opacity") ?? transitionFor("value");
+  const play = mountPlay({ opacity }, animateInitial);
 
   return (
     <motion.span
@@ -27,9 +29,10 @@ export function Text({ resolved, transitionFor }: PrimitiveProps) {
         fontWeight: weight,
         color: colour,
         textAlign: align as React.CSSProperties["textAlign"],
-        willChange: "opacity",
+        willChange: "opacity, transform",
       }}
-      animate={{ opacity }}
+      initial={play.initial}
+      animate={play.animate}
       transition={toFramer(tx)}
     >
       {value}

package/src/render/tree.tsx

@@ -89,7 +89,11 @@ function Node({ node, store }: TreeProps): ReactNode {
 
   const body = (
     <UniversalWrapper {...universal}>
-      <Primitive resolved={resolved} transitionFor={transitionFor}>
+      <Primitive
+        resolved={resolved}
+        transitionFor={transitionFor}
+        animateInitial={node.animate_initial}
+      >
         {children}
       </Primitive>
     </UniversalWrapper>

package/dist/index-X6EOQGho.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-X6EOQGho.js","sources":["../src/overlay/runtime-context.tsx","../src/app.tsx","../src/animate/transitions.ts","../src/state/apply-delta.ts","../src/state/apply-snapshot.ts","../src/state/store.ts","../src/render/bundle.ts","../src/transport/reconnect.ts","../src/transport/ws.ts","../src/internal/validate-options.ts","../src/mount.ts"],"sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\nimport type { Patch } from \"@lumencast/protocol\";\nimport type { Store } from \"../state/store\";\nimport type { RenderBundle } from \"../render/bundle\";\nimport type { ConnectionStatus } from \"../transport/ws\";\nimport type { LumencastMode } from \"../types\";\n\nexport interface LumencastRuntime {\n  mode: LumencastMode;\n  store: Store;\n  bundle: RenderBundle;\n  status: ConnectionStatus;\n  /** Send LSDP/1 input patches to the server. */\n  sendInput: (patches: Patch[]) => void;\n}\n\nconst Ctx = createContext<LumencastRuntime | null>(null);\n\nexport function LumencastRuntimeProvider({\n  value,\n  children,\n}: {\n  value: LumencastRuntime;\n  children: ReactNode;\n}) {\n  return <Ctx.Provider value={value}>{children}</Ctx.Provider>;\n}\n\nexport function useLumencastRuntime(): LumencastRuntime {\n  const v = useContext(Ctx);\n  if (!v) {\n    throw new Error(\n      \"Lumencast overlay components must be rendered inside LumencastRuntimeProvider\",\n    );\n  }\n  return v;\n}\n","// Top-level React component for a mounted Lumencast instance. Reads the runtime\n// signals (bundle / status) and dispatches to the right mode.\n//\n// Per-mode code splitting: BroadcastMode / ControlMode / TestMode live in\n// separate chunks loaded only when the corresponding mode is requested. A\n// broadcast mount never downloads the overlay or test code — the broadcast\n// chunk is the bare minimum a CEF host needs to render the scene.\n//\n// Crossfade: AnimatePresence freezes the props of an exiting child so its render\n// tree keeps using the values it held at the moment it started exiting.\n\nimport { useSignals } from \"@preact/signals-react/runtime\";\nimport type { Signal } from \"@preact/signals-react\";\nimport { AnimatePresence, motion } from \"framer-motion\";\nimport { lazy, Suspense } from \"react\";\nimport type { Patch } from \"@lumencast/protocol\";\nimport type { Store } from \"./state/store.js\";\nimport type { RenderBundle } from \"./render/bundle.js\";\nimport type { ConnectionStatus } from \"./transport/ws.js\";\nimport { LumencastRuntimeProvider } from \"./overlay/runtime-context.js\";\nimport type { LumencastMode } from \"./types.js\";\n\nconst LazyBroadcastMode = lazy(() =>\n  import(\"./modes/broadcast.js\").then((m) => ({ default: m.BroadcastMode })),\n);\nconst LazyControlMode = lazy(() =>\n  import(\"./modes/control.js\").then((m) => ({ default: m.ControlMode })),\n);\nconst LazyTestMode = lazy(() => import(\"./modes/test.js\").then((m) => ({ default: m.TestMode })));\n\nexport interface LumencastAppProps {\n  mode: LumencastMode;\n  store: Store;\n  bundleSignal: Signal<RenderBundle | null>;\n  statusSignal: Signal<ConnectionStatus>;\n  crossfadeKeySignal: Signal<string>;\n  sendInput: (patches: Patch[]) => void;\n}\n\nexport function LumencastApp({\n  mode,\n  store,\n  bundleSignal,\n  statusSignal,\n  crossfadeKeySignal,\n  sendInput,\n}: LumencastAppProps) {\n  useSignals();\n\n  const bundle = bundleSignal.value;\n  const status = statusSignal.value;\n  const trackKey = crossfadeKeySignal.value;\n  if (!bundle) return null;\n\n  const ModeComponent =\n    mode === \"broadcast\" ? LazyBroadcastMode : mode === \"control\" ? LazyControlMode : LazyTestMode;\n\n  return (\n    <AnimatePresence mode=\"sync\">\n      <motion.div\n        key={trackKey}\n        initial={{ opacity: 0 }}\n        animate={{ opacity: 1 }}\n        exit={{ opacity: 0 }}\n        transition={{ duration: 0.4, ease: \"easeInOut\" }}\n        style={{ position: \"absolute\", inset: 0 }}\n      >\n        <LumencastRuntimeProvider\n          value={{\n            mode,\n            store,\n            bundle,\n            status,\n            sendInput,\n          }}\n        >\n          <Suspense fallback={null}>\n            <ModeComponent />\n          </Suspense>\n        </LumencastRuntimeProvider>\n      </motion.div>\n    </AnimatePresence>\n  );\n}\n","// Local Transition type + Framer Motion translation.\n//\n// LSML 1.0 §6 declares `animate` directives at the primitive level (transition,\n// transform, opacity, filter). LSDP/1.1 §3.2.2 added per-leaf transition\n// directives on delta patches — incoming deltas can carry a transition hint\n// that overrides the bundle-level default for the next animation cycle.\n// `parseWireTransition` ingests the wire shape ; `Store.lastTransition(path)`\n// surfaces the most-recent directive to the renderer.\n//\n// We deliberately animate only GPU-friendly properties (transform, opacity,\n// filter). Primitives enforce this at the DOM level by exposing those props as\n// motion-bindable values rather than raw CSS.\n\nexport type TransitionKind = \"none\" | \"tween\" | \"spring\" | \"crossfade\";\n\nexport interface TweenTransition {\n  kind: \"tween\";\n  duration_ms: number;\n  ease?: \"linear\" | \"cubic-in\" | \"cubic-out\" | \"cubic-in-out\";\n}\n\nexport interface SpringTransition {\n  kind: \"spring\";\n  stiffness?: number;\n  damping?: number;\n}\n\nexport interface CrossfadeTransition {\n  kind: \"crossfade\";\n  duration_ms?: number;\n}\n\nexport interface NoTransition {\n  kind: \"none\";\n}\n\nexport type Transition = NoTransition | TweenTransition | SpringTransition | CrossfadeTransition;\n\nexport type FramerEasing = \"linear\" | \"easeIn\" | \"easeOut\" | \"easeInOut\";\n\nexport interface FramerTransition {\n  duration?: number;\n  ease?: FramerEasing;\n  type?: \"tween\" | \"spring\";\n  stiffness?: number;\n  damping?: number;\n}\n\nconst NO_ANIMATION: FramerTransition = { duration: 0 };\n\nconst EASE_MAP: Record<string, FramerEasing> = {\n  linear: \"linear\",\n  \"cubic-in\": \"easeIn\",\n  \"cubic-out\": \"easeOut\",\n  \"cubic-in-out\": \"easeInOut\",\n};\n\nexport function toFramer(t: Transition | undefined): FramerTransition {\n  if (!t || t.kind === \"none\") return NO_ANIMATION;\n  if (t.kind === \"tween\") {\n    return {\n      type: \"tween\",\n      duration: (t.duration_ms ?? 0) / 1000,\n      ease: t.ease ? (EASE_MAP[t.ease] ?? \"easeOut\") : \"easeOut\",\n    };\n  }\n  if (t.kind === \"spring\") {\n    return {\n      type: \"spring\",\n      ...(t.stiffness !== undefined ? { stiffness: t.stiffness } : {}),\n      ...(t.damping !== undefined ? { damping: t.damping } : {}),\n    };\n  }\n  // crossfade at the per-prop level degenerates into a tween on opacity.\n  return {\n    type: \"tween\",\n    duration: (t.duration_ms ?? 400) / 1000,\n    ease: \"easeInOut\",\n  };\n}\n\n/**\n * Parse a wire-format `TransitionSpec` (LSDP/1.1 §3.2.2) into the\n * runtime's local Transition type. Returns `undefined` for malformed\n * input so the caller falls back to whatever bundle-level default\n * applies. The wire shape uses kebab-case `easing` values\n * (`linear`, `ease-in`, `ease-out`, `ease-in-out`) which we map to\n * the runtime's `cubic-*` vocabulary.\n */\nexport function parseWireTransition(value: unknown): Transition | undefined {\n  if (typeof value !== \"object\" || value === null) return undefined;\n  const v = value as Record<string, unknown>;\n  const kind = v.kind;\n  if (kind === \"snap\") {\n    return { kind: \"none\" };\n  }\n  if (kind === \"tween\") {\n    const duration_ms = typeof v.duration_ms === \"number\" ? v.duration_ms : 0;\n    const easing = WIRE_EASING_MAP[v.easing as string] ?? \"cubic-out\";\n    return { kind: \"tween\", duration_ms, ease: easing };\n  }\n  if (kind === \"spring\") {\n    const out: SpringTransition = { kind: \"spring\" };\n    if (typeof v.stiffness === \"number\") out.stiffness = v.stiffness;\n    if (typeof v.damping === \"number\") out.damping = v.damping;\n    return out;\n  }\n  return undefined;\n}\n\nconst WIRE_EASING_MAP: Record<string, \"linear\" | \"cubic-in\" | \"cubic-out\" | \"cubic-in-out\"> = {\n  linear: \"linear\",\n  \"ease-in\": \"cubic-in\",\n  \"ease-out\": \"cubic-out\",\n  \"ease-in-out\": \"cubic-in-out\",\n};\n","import { batch } from \"@preact/signals-react\";\nimport type { DeltaFrame } from \"@lumencast/protocol\";\nimport type { Store } from \"./store.js\";\nimport { parseWireTransition } from \"../animate/transitions\";\n\n/** Apply an LSDP/1 delta. All patches in the frame land in a single signals\n *  batch — components reading multiple paths see them flip in one render pass.\n *\n *  LSDP/1.1 §3.2.2 — a patch may carry a `transition` directive overriding\n *  the bundle-level default for the next animation cycle on that leaf. We\n *  thread it through the store so the renderer reads the correct directive\n *  alongside the new value. */\nexport function applyDelta(store: Store, frame: DeltaFrame): void {\n  batch(() => {\n    for (const patch of frame.patches) {\n      const transition = parseWireTransition(patch.transition);\n      if (transition !== undefined) {\n        store.setWithTransition(patch.path, patch.value, transition);\n      } else {\n        store.set(patch.path, patch.value);\n      }\n    }\n  });\n}\n","import type { SnapshotFrame } from \"@lumencast/protocol\";\nimport type { Store } from \"./store.js\";\n\n/** Apply an LSDP/1 snapshot to the store. Replaces the entire state — paths\n *  not present in the snapshot are reset to `undefined`. */\nexport function applySnapshot(store: Store, frame: SnapshotFrame): void {\n  store.reset(frame.state);\n}\n","// State store — one signal per leaf path.\n//\n// Integration point between the WS layer (snapshot + delta) and the render\n// layer. Each path Lumencast has ever seen owns a `Signal<unknown>`;\n// readers subscribe via @preact/signals-react `useSignals()` and re-render\n// only when their path's value changes.\n//\n// LSDP/1.1 §3.2.2 — incoming deltas may carry a per-leaf `transition`\n// directive. The store keeps the most-recent directive per path so the\n// renderer can pick it up on the next animation cycle. Snapshots clear\n// any pending transitions for the affected paths (snapshots are not\n// animated transitions).\n\nimport { signal, type Signal, batch } from \"@preact/signals-react\";\nimport type { Transition } from \"../animate/transitions\";\n\nexport interface Store {\n  /** Get-or-create the signal for a path. New paths start as `undefined`. */\n  signal(path: string): Signal<unknown>;\n  /** Apply a single leaf write. */\n  set(path: string, value: unknown): void;\n  /** Apply a single leaf write with an LSDP/1.1 §3.2.2 transition directive.\n   * The directive lives in a separate signal so the renderer can subscribe\n   * to it independently. Passing `undefined` clears any pending directive. */\n  setWithTransition(path: string, value: unknown, transition: Transition | undefined): void;\n  /** Read the most-recent transition directive for a path (or undefined\n   * when no directive has been applied since the last snapshot). The\n   * returned signal is reactive — components reading via `useSignals()`\n   * re-render when the directive changes. */\n  transitionSignal(path: string): Signal<Transition | undefined>;\n  /**\n   * Replace the whole state — used by `apply-snapshot`. Existing signals are\n   * reused (subscribers stay attached); paths missing from the snapshot reset\n   * to `undefined`. Pending per-path transitions are cleared (a snapshot is\n   * a state restore, not an animated change).\n   */\n  reset(state: Record<string, unknown>): void;\n  /** Snapshot of every known path → current value. For debug / state inspector. */\n  toRecord(): Record<string, unknown>;\n}\n\nclass StoreImpl implements Store {\n  private readonly signals = new Map<string, Signal<unknown>>();\n  private readonly transitions = new Map<string, Signal<Transition | undefined>>();\n\n  signal(path: string): Signal<unknown> {\n    let s = this.signals.get(path);\n    if (!s) {\n      s = signal<unknown>(undefined);\n      this.signals.set(path, s);\n    }\n    return s;\n  }\n\n  transitionSignal(path: string): Signal<Transition | undefined> {\n    let s = this.transitions.get(path);\n    if (!s) {\n      s = signal<Transition | undefined>(undefined);\n      this.transitions.set(path, s);\n    }\n    return s;\n  }\n\n  set(path: string, value: unknown): void {\n    const s = this.signal(path);\n    if (!shallowEqual(s.peek(), value)) {\n      s.value = value;\n    }\n  }\n\n  setWithTransition(path: string, value: unknown, transition: Transition | undefined): void {\n    batch(() => {\n      const ts = this.transitionSignal(path);\n      // Update transition before value so the render that observes the\n      // new value sees the correct transition.\n      if (ts.peek() !== transition) ts.value = transition;\n      const s = this.signal(path);\n      if (!shallowEqual(s.peek(), value)) s.value = value;\n    });\n  }\n\n  reset(state: Record<string, unknown>): void {\n    batch(() => {\n      const seen = new Set<string>();\n      for (const [path, value] of Object.entries(state)) {\n        seen.add(path);\n        const s = this.signal(path);\n        if (!shallowEqual(s.peek(), value)) {\n          s.value = value;\n        }\n        // Snapshots are not animated transitions — clear any pending\n        // per-path directive (LSDP/1.1 §3.2.2 — directives apply to\n        // the NEXT delta only, snapshots reseed state authoritatively).\n        const ts = this.transitions.get(path);\n        if (ts && ts.peek() !== undefined) ts.value = undefined;\n      }\n      for (const path of this.signals.keys()) {\n        if (!seen.has(path)) {\n          const s = this.signals.get(path);\n          if (s && s.peek() !== undefined) s.value = undefined;\n        }\n      }\n    });\n  }\n\n  toRecord(): Record<string, unknown> {\n    const out: Record<string, unknown> = {};\n    for (const [path, s] of this.signals.entries()) {\n      out[path] = s.peek();\n    }\n    return out;\n  }\n}\n\nexport function createStore(): Store {\n  return new StoreImpl();\n}\n\nfunction shallowEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  if (typeof a !== typeof b) return false;\n  if (typeof a !== \"object\") return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    for (let i = 0; i < a.length; i++) {\n      if (a[i] !== b[i]) return false;\n    }\n    return true;\n  }\n  const ao = a as Record<string, unknown>;\n  const bo = b as Record<string, unknown>;\n  const ak = Object.keys(ao);\n  const bk = Object.keys(bo);\n  if (ak.length !== bk.length) return false;\n  for (const k of ak) {\n    if (ao[k] !== bo[k]) return false;\n  }\n  return true;\n}\n","// Render bundle — the runtime's flat, pre-compiled representation of a scene.\n//\n// The bundle is content-addressed by `scene_version` (sha256 of the\n// canonical JSON form). Lumencast fetches it once per `scene_version` and\n// caches forever; the server serves it with long-TTL immutable cache headers.\n//\n// Note on shape: this `RenderBundle` is the flat, runtime-internal form. The\n// canonical *authoring* format (LSML 1.0, see lumencast-protocol/spec/LSML-1.md)\n// uses inline `bind: { value: \"path\" }` per primitive instead of a `bindings`\n// map. A compiler step (forthcoming `@lumencast/compiler`) will translate\n// LSML 1.0 → RenderBundle. For now, callers who want to feed an LSML 1.0\n// bundle pre-compile or use a hand-rolled adapter.\n\nimport type { Transition } from \"../animate/transitions.js\";\nimport type { Keyframes } from \"../animate/keyframes.js\";\n\n// --- bundle shape ----------------------------------------------------\n\nexport type RenderKind =\n  | \"stack\"\n  | \"grid\"\n  | \"frame\"\n  | \"text\"\n  | \"image\"\n  | \"shape\"\n  | \"media\"\n  | \"repeat\"\n  | \"instance\";\n\nexport interface RenderNode {\n  kind: RenderKind;\n  /** Stable identifier for keyed reconciliation. */\n  id?: string;\n  /** Static props (frozen at build/compile time). */\n  props?: Record<string, unknown>;\n  /** Prop name → state path. The render layer subscribes the path's signal\n   *  and applies the value to the named prop on each change. */\n  bindings?: Record<string, string>;\n  /** Default transition per bound prop. Aligns with LSML 1.0 §6 `animate`\n   *  directives. The runtime applies these as CSS transitions / Framer Motion\n   *  configs at render time. */\n  transitions?: Record<string, Transition>;\n  /** LSML 1.1 §6.6 — multi-step keyframe sequence played on mount or\n   *  whenever `keyframes.key` (LeafPath) changes. Coexists with\n   *  `transitions` ; the runtime applies whichever was last triggered\n   *  (no blending — see §6.6 last paragraph). */\n  keyframes?: Keyframes;\n  /** LSML 1.1 §6.7 — only meaningful on `repeat`. Each iteration's\n   *  animations start `index * stagger_ms` after iteration 0. */\n  stagger_ms?: number;\n  /** Children — already-inlined primitives only. */\n  children?: RenderNode[];\n}\n\nexport type OperatorInputType =\n  | \"boolean\"\n  | \"number\"\n  | \"text\"\n  | \"select\"\n  | \"enum\"\n  | \"path-ref\"\n  | \"colour\"\n  | \"duration\";\n\nexport interface OperatorInput {\n  path: string;\n  label: string;\n  type: OperatorInputType;\n  default?: unknown;\n  group?: string;\n  writable_by?: string[];\n  [extra: string]: unknown;\n}\n\nexport interface ExternalAdapter {\n  key: string;\n  label: string;\n  kind: string;\n  target_paths: string[];\n  [extra: string]: unknown;\n}\n\nexport interface Asset {\n  id: string;\n  url: string;\n  kind: string;\n  [extra: string]: unknown;\n}\n\nexport interface RenderBundle {\n  scene_version: string;\n  root: RenderNode;\n  operator_inputs?: OperatorInput[];\n  external_adapters?: ExternalAdapter[];\n  assets?: Asset[];\n  /** LSML 1.1 §17.3 — capability profiles required for correct rendering.\n   * Each entry is a `<vendor>.<name>-<version>` string. The runtime\n   * checks every entry against its supported list ; an unrecognised\n   * profile raises BUNDLE_INCOMPATIBLE per §17.3.1. */\n  profiles?: string[];\n}\n\n/**\n * Profiles the JS runtime advertises support for. Bundle authors who\n * declare `profiles: [...]` get a hard `BUNDLE_INCOMPATIBLE` rejection\n * when any entry is not in this set (LSML 1.1 §17.3.1).\n *\n * 1.1 ships with no standard profiles ; future minors / vendor specs\n * register here. The `x-lumencast.color-srgb-1.0` entry is the\n * default-color-space marker ; bundles that opt into a perceptual\n * space (OKLCH) would request a different profile and currently\n * reject.\n */\nexport const SUPPORTED_PROFILES: ReadonlySet<string> = new Set<string>([\n  \"x-lumencast.color-srgb-1.0\",\n]);\n\nexport class BundleIncompatibleError extends Error {\n  public readonly code = \"BUNDLE_INCOMPATIBLE\" as const;\n  public readonly unsupportedProfiles: string[];\n  constructor(unsupportedProfiles: string[]) {\n    super(\n      `BUNDLE_INCOMPATIBLE: profile(s) not supported by this runtime: ${unsupportedProfiles.join(\n        \", \",\n      )}`,\n    );\n    this.name = \"BundleIncompatibleError\";\n    this.unsupportedProfiles = unsupportedProfiles;\n  }\n}\n\n/** Validate a bundle's `profiles[]` against the runtime's supported\n * set. Throws `BundleIncompatibleError` listing every offending entry\n * when at least one is not supported. */\nexport function validateBundleProfiles(\n  bundle: { profiles?: string[] },\n  supported: ReadonlySet<string> = SUPPORTED_PROFILES,\n): void {\n  const profiles = bundle.profiles;\n  if (!profiles || profiles.length === 0) return;\n  const missing = profiles.filter((p) => !supported.has(p));\n  if (missing.length > 0) {\n    throw new BundleIncompatibleError(missing);\n  }\n}\n\n// --- fetch + cache ---------------------------------------------------\n\nexport interface BundleFetcher {\n  /** Fetch the bundle for a scene version. Cached forever by hash. */\n  get(sceneId: string, sceneVersion: string): Promise<RenderBundle>;\n  /** Inject a bundle directly — used by tests and for the \"scene already in\n   *  flight\" handoff path. */\n  preload(bundle: RenderBundle): void;\n}\n\nexport interface BundleFetcherOptions {\n  /** Base URL of the server. The fetcher constructs\n   *  `${baseUrl}/lsdp/v1/scenes/{id}/bundle?v={hash}`. */\n  baseUrl: string;\n  /** Path prefix for bundle resolution. Defaults to `/lsdp/v1/scenes`. */\n  pathPrefix?: string;\n  fetchImpl?: typeof fetch;\n}\n\nclass FetcherImpl implements BundleFetcher {\n  private readonly cache = new Map<string, RenderBundle>();\n  private readonly baseUrl: string;\n  private readonly pathPrefix: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: BundleFetcherOptions) {\n    this.baseUrl = opts.baseUrl.replace(/\\/$/, \"\");\n    this.pathPrefix = (opts.pathPrefix ?? \"/lsdp/v1/scenes\").replace(/\\/$/, \"\");\n    this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);\n  }\n\n  preload(bundle: RenderBundle): void {\n    // LSML 1.1 §17.3.1 — reject early if any declared profile is\n    // unsupported by this runtime. Authors get an actionable error\n    // instead of a silent rendering glitch.\n    validateBundleProfiles(bundle);\n    this.cache.set(bundle.scene_version, bundle);\n  }\n\n  async get(sceneId: string, sceneVersion: string): Promise<RenderBundle> {\n    const cached = this.cache.get(sceneVersion);\n    if (cached) return cached;\n    const url = `${this.baseUrl}${this.pathPrefix}/${encodeURIComponent(sceneId)}/bundle?v=${encodeURIComponent(sceneVersion)}`;\n    const response = await this.fetchImpl(url);\n    if (!response.ok) {\n      throw new Error(`bundle fetch failed: ${response.status} ${response.statusText}`);\n    }\n    const json = (await response.json()) as RenderBundle;\n    if (json.scene_version !== sceneVersion) {\n      throw new Error(\n        `bundle scene_version mismatch: expected ${sceneVersion}, got ${json.scene_version}`,\n      );\n    }\n    validateBundleProfiles(json);\n    this.cache.set(sceneVersion, json);\n    return json;\n  }\n}\n\nexport function createBundleFetcher(opts: BundleFetcherOptions): BundleFetcher {\n  return new FetcherImpl(opts);\n}\n","// Exponential backoff schedule for the WS reconnect loop.\n//\n// Aggressive at first (200 ms, 400 ms, 800 ms…) then capped at 5 s so a\n// sustained outage doesn't hammer the gateway. Jittered to avoid thundering\n// herds when several Lumencast instances reconnect together (e.g. a CEF\n// host + a webview waking from suspend at the same time).\n//\n// The reference schedule in LSDP/1 §7 is \"0 ms, 500 ms, 1 s, 2 s, 4 s, 8 s,\n// 15 s, 30 s, 60 s cap\". This implementation defaults are tighter; both are\n// MAY-bounded by the spec.\n\nexport interface ReconnectScheduleOptions {\n  /** First delay in milliseconds. */\n  initial?: number;\n  /** Maximum delay in milliseconds. */\n  max?: number;\n  /** Multiplicative factor between attempts (>= 1). */\n  factor?: number;\n  /** Jitter as a fraction of the delay (0 disables, 0.2 = ±20 %). */\n  jitter?: number;\n  /** Random source — only injected for tests. */\n  random?: () => number;\n}\n\nconst DEFAULTS: Required<Omit<ReconnectScheduleOptions, \"random\">> = {\n  initial: 200,\n  max: 5_000,\n  factor: 2,\n  jitter: 0.2,\n};\n\nexport interface ReconnectSchedule {\n  /** Returns the delay to wait before the n-th attempt (1-indexed). */\n  delayFor(attempt: number): number;\n  /** Reset to attempt 1 (called on a successful connection). */\n  reset(): void;\n  /** Current attempt counter. */\n  readonly attempt: number;\n}\n\nclass ScheduleImpl implements ReconnectSchedule {\n  private _attempt = 0;\n  constructor(\n    private readonly opts: Required<Omit<ReconnectScheduleOptions, \"random\">>,\n    private readonly random: () => number,\n  ) {}\n\n  get attempt(): number {\n    return this._attempt;\n  }\n\n  delayFor(attempt: number): number {\n    if (!Number.isInteger(attempt) || attempt < 1) {\n      throw new RangeError(`attempt must be a positive integer, got ${attempt}`);\n    }\n    this._attempt = attempt;\n    const base = Math.min(\n      this.opts.initial * Math.pow(this.opts.factor, attempt - 1),\n      this.opts.max,\n    );\n    if (this.opts.jitter <= 0) return base;\n    const offset = (this.random() * 2 - 1) * this.opts.jitter * base;\n    return Math.max(0, base + offset);\n  }\n\n  reset(): void {\n    this._attempt = 0;\n  }\n}\n\nexport function createReconnectSchedule(opts: ReconnectScheduleOptions = {}): ReconnectSchedule {\n  const merged = {\n    initial: opts.initial ?? DEFAULTS.initial,\n    max: opts.max ?? DEFAULTS.max,\n    factor: opts.factor ?? DEFAULTS.factor,\n    jitter: opts.jitter ?? DEFAULTS.jitter,\n  };\n  if (merged.initial <= 0) throw new RangeError(\"initial must be > 0\");\n  if (merged.max < merged.initial) throw new RangeError(\"max must be >= initial\");\n  if (merged.factor < 1) throw new RangeError(\"factor must be >= 1\");\n  if (merged.jitter < 0 || merged.jitter > 1) throw new RangeError(\"jitter must be within [0, 1]\");\n  return new ScheduleImpl(merged, opts.random ?? Math.random);\n}\n","// LSDP/1 WebSocket client.\n//\n// Lifecycle (LSDP/1 §6):\n//   1. open() — opens the WS with subprotocol `lsdp.v1`\n//   2. on open: send `subscribe` with the resolved token (and scene + session\n//      for test mode)\n//   3. server replies `snapshot` (seq=1) → emit onSnapshot\n//   4. subsequent `delta` / `scene_changed` / `error` / `pong` are dispatched\n//   5. on a sequence gap → close + reconnect (fresh snapshot)\n//   6. on close → reconnect with backoff, unless close was triggered by close()\n//   7. setToken() opens a parallel WS with the new token; once its snapshot\n//      lands, atomically swap and close the old socket — no rendering gap\n\nimport {\n  decodeServerFrame,\n  encodeFrame,\n  LumencastError,\n  SequenceTracker,\n  WS_SUBPROTOCOL_V1_1,\n  WS_SUBPROTOCOLS,\n  input as inputFrame,\n  subscribe as subscribeFrame,\n  type DeltaFrame,\n  type ErrorCode,\n  type ErrorFrame,\n  type Patch,\n  type SceneChangedFrame,\n  type SnapshotFrame,\n} from \"@lumencast/protocol\";\nimport type { LumencastToken } from \"../types.js\";\nimport {\n  createReconnectSchedule,\n  type ReconnectSchedule,\n  type ReconnectScheduleOptions,\n} from \"./reconnect.js\";\n\nexport type ConnectionStatus = \"disconnected\" | \"connecting\" | \"live\";\n\nexport interface WsClientOptions {\n  url: string;\n  token: LumencastToken;\n  /** Optional scene identifier (test mode). */\n  scene?: string;\n  /** Optional session identifier (test mode). */\n  session?: string;\n  /** Override the WebSocket constructor (for tests / non-browser hosts). */\n  webSocketImpl?: typeof WebSocket;\n  /** Reconnect tuning. */\n  reconnect?: ReconnectScheduleOptions;\n  /** Inject scheduler for tests. */\n  scheduler?: {\n    setTimeout: typeof globalThis.setTimeout;\n    clearTimeout: typeof globalThis.clearTimeout;\n  };\n\n  onStatus?: (status: ConnectionStatus) => void;\n  onSnapshot?: (frame: SnapshotFrame) => void;\n  onDelta?: (frame: DeltaFrame) => void;\n  onSceneChanged?: (frame: SceneChangedFrame) => void;\n  onServerError?: (frame: ErrorFrame) => void;\n  /** Wire-level / codec / unrecoverable errors. */\n  onTransportError?: (err: TransportError) => void;\n}\n\nexport class TransportError extends Error {\n  public readonly recoverable: boolean;\n  public readonly code: ErrorCode;\n  public override readonly cause?: unknown;\n  constructor(\n    message: string,\n    recoverable: boolean,\n    code: ErrorCode = \"INTERNAL\",\n    cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"TransportError\";\n    this.recoverable = recoverable;\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\ntype Timer = ReturnType<typeof setTimeout>;\n\ninterface InternalScheduler {\n  setTimeout: typeof globalThis.setTimeout;\n  clearTimeout: typeof globalThis.clearTimeout;\n}\n\nexport class WsClient {\n  private status: ConnectionStatus = \"disconnected\";\n  private socket: WebSocket | null = null;\n  private token: LumencastToken;\n  private readonly url: string;\n  private readonly WebSocketCtor: typeof WebSocket;\n  private readonly schedule: ReconnectSchedule;\n  private readonly seq = new SequenceTracker();\n  private readonly opts: WsClientOptions;\n  private readonly scheduler: InternalScheduler;\n\n  private reconnectTimer: Timer | null = null;\n  private active = true;\n\n  constructor(opts: WsClientOptions) {\n    this.opts = opts;\n    this.url = opts.url;\n    this.token = opts.token;\n    const ctor = opts.webSocketImpl ?? globalThis.WebSocket;\n    if (!ctor) {\n      throw new TypeError(\n        \"Lumencast WsClient: no WebSocket implementation found in this environment\",\n      );\n    }\n    this.WebSocketCtor = ctor;\n    this.schedule = createReconnectSchedule(opts.reconnect);\n    this.scheduler = opts.scheduler ?? {\n      setTimeout: globalThis.setTimeout.bind(globalThis),\n      clearTimeout: globalThis.clearTimeout.bind(globalThis),\n    };\n  }\n\n  /** Open and start the connection lifecycle. Idempotent. */\n  start(): void {\n    if (!this.active) return;\n    if (this.socket || this.status === \"connecting\") return;\n    void this.openSocket();\n  }\n\n  /** Send `input` patches to the server. No-op if not connected. */\n  sendInput(patches: Patch[]): void {\n    if (!this.socket || this.socket.readyState !== this.WebSocketCtor.OPEN) return;\n    if (patches.length === 0) return;\n    this.socket.send(encodeFrame(inputFrame(patches)));\n  }\n\n  /** Replace the auth token. Closes and reopens with the new token. */\n  setToken(token: LumencastToken): void {\n    this.token = token;\n    if (!this.active) return;\n    if (this.socket) {\n      this.closeSocket();\n      this.scheduleReconnect(true);\n    }\n  }\n\n  /** Tear down for good. No more reconnect attempts. */\n  close(): void {\n    if (!this.active) return;\n    this.active = false;\n    this.cancelReconnect();\n    this.closeSocket();\n    this.setStatus(\"disconnected\");\n  }\n\n  // --- internals --------------------------------------------------\n\n  private async openSocket(): Promise<void> {\n    if (!this.active) return;\n    this.setStatus(\"connecting\");\n\n    let resolvedToken: string;\n    try {\n      resolvedToken = await resolveToken(this.token);\n    } catch (err) {\n      this.opts.onTransportError?.(\n        new TransportError(\n          `failed to resolve token: ${(err as Error).message}`,\n          true,\n          \"AUTH_DENIED\",\n          err,\n        ),\n      );\n      this.scheduleReconnect();\n      return;\n    }\n    if (!this.active) return;\n\n    let socket: WebSocket;\n    try {\n      // Advertise both 1.1 (preferred) and 1.0 (fallback) ; the server\n      // picks one. Spread to a mutable array — the WebSocket constructor\n      // type expects string[].\n      socket = new this.WebSocketCtor(this.url, [...WS_SUBPROTOCOLS]);\n    } catch (err) {\n      this.opts.onTransportError?.(\n        new TransportError(\n          `failed to open WebSocket: ${(err as Error).message}`,\n          true,\n          \"INTERNAL\",\n          err,\n        ),\n      );\n      this.scheduleReconnect();\n      return;\n    }\n\n    this.socket = socket;\n    socket.onopen = () => this.handleOpen(resolvedToken);\n    socket.onmessage = (event) => this.handleMessage(event);\n    socket.onerror = (event) => this.handleError(event);\n    socket.onclose = (event) => this.handleClose(event);\n  }\n\n  private handleOpen(token: string): void {\n    if (!this.socket) return;\n    // LSDP/1.1 §4.1, §18 — if we have a previously-observed seq AND the\n    // negotiated subprotocol is 1.1, request an incremental resume.\n    // The server will EITHER ship buffered deltas (cache stays valid)\n    // OR a fresh snapshot which we rebase via observeSnapshot.\n    const subprotocol = this.socket.protocol;\n    const canResume = subprotocol === WS_SUBPROTOCOL_V1_1 && this.seq.last > 0;\n    const sinceSequence = canResume ? this.seq.last : undefined;\n    if (!canResume) {\n      // Fresh subscription (no resume) — reset the tracker baseline.\n      this.seq.reset();\n    }\n    const frame = subscribeFrame({\n      token,\n      ...(this.opts.scene !== undefined ? { scene: this.opts.scene } : {}),\n      ...(this.opts.session !== undefined ? { session: this.opts.session } : {}),\n      ...(sinceSequence !== undefined ? { since_sequence: sinceSequence } : {}),\n    });\n    this.socket.send(encodeFrame(frame));\n  }\n\n  private handleMessage(event: MessageEvent): void {\n    const data = typeof event.data === \"string\" ? event.data : \"\";\n    if (!data) return;\n    let frame;\n    try {\n      frame = decodeServerFrame(data);\n    } catch (err) {\n      const message = err instanceof LumencastError ? err.message : (err as Error).message;\n      const code: ErrorCode = err instanceof LumencastError ? err.code : \"INTERNAL\";\n      this.opts.onTransportError?.(new TransportError(`codec: ${message}`, true, code, err));\n      this.closeSocket();\n      this.scheduleReconnect();\n      return;\n    }\n    if (frame === null) return; // unknown frame type — forward-compat ignore\n\n    switch (frame.type) {\n      case \"snapshot\": {\n        // LSDP/1.1 §18.1.1 — snapshot rebases the tracker to its seq\n        // value. This is the ONLY valid way to set or change the\n        // tracker's baseline (handles fresh sub, scene_changed, and\n        // back-pressure recovery uniformly).\n        if (frame.seq < 1) {\n          this.opts.onTransportError?.(\n            new TransportError(`snapshot seq must be >= 1, got ${frame.seq}`, true, \"VERSION_GAP\"),\n          );\n          this.closeSocket();\n          this.scheduleReconnect();\n          return;\n        }\n        this.seq.observeSnapshot(frame.seq);\n        this.schedule.reset();\n        this.setStatus(\"live\");\n        this.opts.onSnapshot?.(frame);\n        return;\n      }\n      case \"delta\": {\n        const obs = this.seq.observe(frame.seq);\n        if (obs.kind === \"gap\") {\n          this.opts.onTransportError?.(\n            new TransportError(\n              `sequence gap: expected ${this.seq.last + 1}, got ${frame.seq}`,\n              true,\n              \"VERSION_GAP\",\n            ),\n          );\n          this.closeSocket();\n          this.scheduleReconnect();\n          return;\n        }\n        if (obs.kind === \"duplicate\") return; // silent drop per LSDP/1 §5\n        this.opts.onDelta?.(frame);\n        return;\n      }\n      case \"scene_changed\": {\n        // The next snapshot will rebase the tracker via observeSnapshot.\n        // Reset here so the tracker doesn't fault on the SceneChanged's\n        // own seq (which advances prev's counter one final step).\n        this.seq.reset();\n        this.opts.onSceneChanged?.(frame);\n        return;\n      }\n      case \"error\": {\n        this.opts.onServerError?.(frame);\n        if (!frame.recoverable) this.close();\n        return;\n      }\n      case \"pong\":\n        return;\n    }\n  }\n\n  private handleError(_event: Event): void {\n    // The browser does not give us a real reason — `close` will follow.\n  }\n\n  private handleClose(event: CloseEvent): void {\n    this.socket = null;\n    if (!this.active) {\n      this.setStatus(\"disconnected\");\n      return;\n    }\n    if (event.code === 4401 || event.code === 4403 || event.code === 1008) {\n      // Auth-related close codes: not recoverable without operator intervention.\n      this.opts.onTransportError?.(\n        new TransportError(`server closed: ${event.code} ${event.reason}`, false, \"AUTH_DENIED\"),\n      );\n      this.close();\n      return;\n    }\n    this.scheduleReconnect();\n  }\n\n  private scheduleReconnect(immediate = false): void {\n    if (!this.active) return;\n    this.cancelReconnect();\n    const attempt = (this.schedule.attempt || 0) + 1;\n    const delay = immediate ? 0 : this.schedule.delayFor(attempt);\n    this.setStatus(\"disconnected\");\n    this.reconnectTimer = this.scheduler.setTimeout(() => {\n      this.reconnectTimer = null;\n      void this.openSocket();\n    }, delay);\n  }\n\n  private cancelReconnect(): void {\n    if (this.reconnectTimer) {\n      this.scheduler.clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n  }\n\n  private closeSocket(): void {\n    if (this.socket) {\n      try {\n        this.socket.close(1000, \"client closing\");\n      } catch {\n        // ignore\n      }\n      this.socket = null;\n    }\n  }\n\n  private setStatus(next: ConnectionStatus): void {\n    if (this.status === next) return;\n    this.status = next;\n    this.opts.onStatus?.(next);\n  }\n}\n\nasync function resolveToken(token: LumencastToken): Promise<string> {\n  if (typeof token === \"string\") return token;\n  return await token.fetch();\n}\n","import type { MountOptions } from \"../types\";\n\n/** Throws on invalid mount options. Exposed separately so unit tests\n *  can exercise it without mounting a real React root. */\nexport function validateOptions(options: MountOptions): void {\n  if (!(options.target instanceof HTMLElement)) {\n    throw new TypeError(\"mount: `target` must be an HTMLElement\");\n  }\n  if (typeof options.serverUrl !== \"string\" || options.serverUrl.length === 0) {\n    throw new TypeError(\"mount: `serverUrl` must be a non-empty string\");\n  }\n  if (options.mode === \"test\") {\n    if (!options.testSession) {\n      throw new TypeError(\"mount: `testSession` is required when mode === 'test'\");\n    }\n    if (!options.scene) {\n      throw new TypeError(\"mount: `scene` is required when mode === 'test'\");\n    }\n  }\n}\n","// Public mount() entry — the only surface a host (browser, CEF, OBS plugin,\n// iframe) interacts with. Lifecycle and contract: see RUNTIME-API.md.\n\nimport { signal } from \"@preact/signals-react\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { createElement } from \"react\";\nimport { LumencastApp } from \"./app.js\";\nimport { applyDelta } from \"./state/apply-delta.js\";\nimport { applySnapshot } from \"./state/apply-snapshot.js\";\nimport { createStore } from \"./state/store.js\";\nimport { createBundleFetcher, type BundleFetcher, type RenderBundle } from \"./render/bundle.js\";\nimport { WsClient, type ConnectionStatus, type TransportError } from \"./transport/ws.js\";\nimport { validateOptions } from \"./internal/validate-options.js\";\nimport type { LumencastError, LumencastHandle, LumencastToken, MountOptions } from \"./types.js\";\n\nexport function mount(options: MountOptions): LumencastHandle {\n  validateOptions(options);\n  options.onStatus?.(\"disconnected\");\n\n  const store = createStore();\n  const baseUrl = deriveBaseUrl(options.serverUrl);\n  const bundleFetcher = createBundleFetcher({ baseUrl });\n\n  const bundleSignal = signal<RenderBundle | null>(null);\n  const statusSignal = signal<ConnectionStatus>(\"disconnected\");\n  const crossfadeKeySignal = signal<string>(\"__initial__\");\n\n  const setStatus = (status: ConnectionStatus): void => {\n    statusSignal.value = status;\n    options.onStatus?.(status);\n  };\n\n  const reportError = (err: LumencastError): void => {\n    options.onError?.(err);\n  };\n\n  let active = true;\n\n  const ws = new WsClient({\n    url: options.serverUrl,\n    token: options.token,\n    ...(options.scene !== undefined ? { scene: options.scene } : {}),\n    ...(options.testSession !== undefined ? { session: options.testSession } : {}),\n    onStatus: setStatus,\n    onSnapshot: (frame) => {\n      if (!active) return;\n      void onSnapshot(\n        bundleFetcher,\n        bundleSignal,\n        crossfadeKeySignal,\n        frame.scene_id,\n        frame.scene_version,\n        () => applySnapshot(store, frame),\n        reportError,\n      );\n      options.onMetric?.({\n        name: \"snapshot_received\",\n        scene_id: frame.scene_id,\n        path_count: Object.keys(frame.state).length,\n      });\n    },\n    onDelta: (frame) => {\n      if (!active) return;\n      const start = performance.now();\n      applyDelta(store, frame);\n      options.onMetric?.({\n        name: \"delta_applied\",\n        duration_ms: performance.now() - start,\n      });\n      options.onMetric?.({ name: \"delta_received\", count: 1, path_count: frame.patches.length });\n    },\n    onSceneChanged: (frame) => {\n      if (!active) return;\n      // The fresh snapshot that follows is the source of truth — it carries\n      // the new scene_version, drives the bundle fetch, and flips the\n      // crossfade key. Nothing eager to do here.\n      options.onMetric?.({\n        name: \"scene_changed\",\n        from: bundleSignal.value?.scene_version ?? null,\n        to: frame.scene_version,\n      });\n    },\n    onServerError: (frame) => {\n      reportError({\n        code: frame.code,\n        message: frame.message,\n        recoverable: frame.recoverable,\n      });\n    },\n    onTransportError: (err) => {\n      reportError(transportToLumencastError(err));\n    },\n  });\n\n  ws.start();\n\n  const root: Root = createRoot(options.target);\n  root.render(\n    createElement(LumencastApp, {\n      mode: options.mode,\n      store,\n      bundleSignal,\n      statusSignal,\n      crossfadeKeySignal,\n      sendInput: (patches) => ws.sendInput(patches),\n    }),\n  );\n\n  return {\n    disconnect() {\n      if (!active) return;\n      active = false;\n      ws.close();\n      root.unmount();\n    },\n    setToken(token: LumencastToken) {\n      if (!active) return;\n      ws.setToken(token);\n    },\n  };\n\n  // --- helpers ----------------------------------------------------------\n\n  async function onSnapshot(\n    fetcher: BundleFetcher,\n    bSignal: typeof bundleSignal,\n    cSignal: typeof crossfadeKeySignal,\n    sceneId: string,\n    sceneVersion: string,\n    applyState: () => void,\n    onErr: (err: LumencastError) => void,\n  ): Promise<void> {\n    let bundle: RenderBundle;\n    try {\n      bundle = await fetcher.get(sceneId, sceneVersion);\n    } catch (err) {\n      onErr({\n        code: \"BUNDLE_FETCH_FAILED\",\n        message: err instanceof Error ? err.message : \"render bundle fetch failed\",\n        recoverable: true,\n      });\n      return;\n    }\n    if (!active) return;\n    applyState();\n    bSignal.value = bundle;\n    cSignal.value = `${sceneId}::${sceneVersion}`;\n  }\n}\n\nfunction transportToLumencastError(err: TransportError): LumencastError {\n  return {\n    code: err.code,\n    message: err.message,\n    recoverable: err.recoverable,\n  };\n}\n\nfunction deriveBaseUrl(wsUrl: string): string {\n  // wss://<host>/lsdp/v1 → https://<host>\n  // ws://<host>/lsdp/v1  → http://<host>\n  try {\n    const u = new URL(wsUrl);\n    const httpScheme = u.protocol === \"wss:\" ? \"https:\" : \"http:\";\n    return `${httpScheme}//${u.host}`;\n  } catch {\n    return \"\";\n  }\n}\n"],"names":["Ctx","createContext","LumencastRuntimeProvider","value","children","jsx","useLumencastRuntime","v","useContext","LazyBroadcastMode","lazy","m","LazyControlMode","LazyTestMode","LumencastApp","mode","store","bundleSignal","statusSignal","crossfadeKeySignal","sendInput","useSignals","bundle","status","trackKey","ModeComponent","AnimatePresence","motion","Suspense","NO_ANIMATION","EASE_MAP","toFramer","parseWireTransition","kind","duration_ms","easing","WIRE_EASING_MAP","out","applyDelta","frame","batch","patch","transition","applySnapshot","StoreImpl","path","signal","s","shallowEqual","ts","state","seen","createStore","a","b","ao","bo","ak","bk","k","SUPPORTED_PROFILES","BundleIncompatibleError","unsupportedProfiles","validateBundleProfiles","supported","profiles","missing","p","FetcherImpl","opts","sceneId","sceneVersion","cached","url","response","json","createBundleFetcher","DEFAULTS","ScheduleImpl","random","attempt","base","offset","createReconnectSchedule","merged","TransportError","message","recoverable","code","cause","WsClient","SequenceTracker","ctor","patches","encodeFrame","inputFrame","token","resolvedToken","resolveToken","err","socket","WS_SUBPROTOCOLS","event","canResume","WS_SUBPROTOCOL_V1_1","sinceSequence","subscribeFrame","data","decodeServerFrame","LumencastError","obs","_event","immediate","delay","next","validateOptions","options","mount","baseUrl","deriveBaseUrl","bundleFetcher","setStatus","reportError","active","ws","onSnapshot","start","transportToLumencastError","root","createRoot","createElement","fetcher","bSignal","cSignal","applyState","onErr","wsUrl","u"],"mappings":"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"}