@lumencast/runtime 0.8.0 → 0.9.0

package/dist/{index-N-VqrIxN.js → index-DrXsLYhe.js}

@@ -1,43 +1,47 @@
-import { batch as w, signal as p } from "@preact/signals-react";
-import { createRoot as $ } from "react-dom/client";
-import { createContext as Y, useContext as K, lazy as S, Suspense as Z, createElement as J, StrictMode as Q } from "react";
-import { jsx as l } from "react/jsx-runtime";
+import { batch as w, signal as g } from "@preact/signals-react";
+import { createRoot as D } from "react-dom/client";
+import { createContext as K, useContext as C, lazy as S, Suspense as Z, createElement as J, StrictMode as Q } from "react";
+import { jsx as h } from "react/jsx-runtime";
 import { useSignals as V } from "@preact/signals-react/runtime";
 import { AnimatePresence as ee, motion as te } from "framer-motion";
-import { SequenceTracker as se, encodeFrame as R, input as ne, WS_SUBPROTOCOLS as re, WS_SUBPROTOCOL_V1_1 as ie, subscribe as oe, decodeServerFrame as ce, LumencastError as O } from "@lumencast/protocol";
-const D = Y(null);
+import { SequenceTracker as se, encodeFrame as O, input as ne, WS_SUBPROTOCOLS as re, WS_SUBPROTOCOL_V1_1 as ie, subscribe as oe, decodeServerFrame as ce, LumencastError as L } from "@lumencast/protocol";
+const T = K(null);
 function F({
   value: t,
   children: e
 }) {
-  return /* @__PURE__ */ l(D.Provider, { value: t, children: e });
+  return /* @__PURE__ */ h(T.Provider, { value: t, children: e });
 }
 function Ve() {
-  const t = K(D);
+  const t = C(T);
   if (!t)
     throw new Error(
       "Lumencast overlay components must be rendered inside LumencastRuntimeProvider"
     );
   return t;
 }
+function et() {
+  return C(T);
+}
 const ae = S(
-  () => import("./broadcast-Gcd-dmC7.js").then((t) => ({ default: t.BroadcastMode }))
+  () => import("./broadcast-ryjLRD5q.js").then((t) => ({ default: t.BroadcastMode }))
 ), ue = S(
-  () => import("./control-C5TfClga.js").then((t) => ({ default: t.ControlMode }))
-), le = S(() => import("./test-CA30C2By.js").then((t) => ({ default: t.TestMode })));
+  () => import("./control-AgxbXOVS.js").then((t) => ({ default: t.ControlMode }))
+), le = S(() => import("./test-CaRHj_J6.js").then((t) => ({ default: t.TestMode })));
 function he({
   mode: t,
   store: e,
   bundleSignal: s,
   statusSignal: n,
   crossfadeKeySignal: r,
-  sendInput: i
+  sendInput: i,
+  resolveCaptureDevice: c
 }) {
   V();
-  const c = s.value, a = n.value, f = r.value;
-  if (!c) return null;
-  const u = t === "broadcast" ? ae : t === "control" ? ue : le;
-  return /* @__PURE__ */ l(ee, { mode: "sync", children: /* @__PURE__ */ l(
+  const a = s.value, f = n.value, u = r.value;
+  if (!a) return null;
+  const p = t === "broadcast" ? ae : t === "control" ? ue : le;
+  return /* @__PURE__ */ h(ee, { mode: "sync", children: /* @__PURE__ */ h(
     te.div,
     {
       initial: { opacity: 0 },
@@ -45,33 +49,34 @@ function he({
       exit: { opacity: 0 },
       transition: { duration: 0.4, ease: "easeInOut" },
       style: { position: "absolute", inset: 0 },
-      children: /* @__PURE__ */ l(
+      children: /* @__PURE__ */ h(
         F,
         {
           value: {
             mode: t,
             store: e,
-            bundle: c,
-            status: a,
-            sendInput: i
+            bundle: a,
+            status: f,
+            sendInput: i,
+            ...c !== void 0 ? { resolveCaptureDevice: c } : {}
           },
-          children: /* @__PURE__ */ l(Z, { fallback: null, children: /* @__PURE__ */ l(u, {}) })
+          children: /* @__PURE__ */ h(Z, { fallback: null, children: /* @__PURE__ */ h(p, {}) })
         }
       )
     },
-    f
+    u
   ) });
 }
-const fe = "<anon>", v = /* @__PURE__ */ new Set();
-function C(t) {
-  return v.add(t), () => {
-    v.delete(t);
+const fe = "<anon>", b = /* @__PURE__ */ new Set();
+function q(t) {
+  return b.add(t), () => {
+    b.delete(t);
   };
 }
-function q(t, e, s) {
+function B(t, e, s) {
   const n = { nodeId: t ?? fe, field: e, reason: s };
-  if (v.size > 0) {
-    for (const r of v)
+  if (b.size > 0) {
+    for (const r of b)
       try {
         r(n);
       } catch {
@@ -83,21 +88,21 @@ const de = 100, me = 4, pe = 64, ge = {
   blur: de,
   brightness: me
 };
-function L(t, e) {
+function N(t, e) {
   if (typeof e != "number" || !Number.isFinite(e) || e < 0 || Object.is(e, -0)) return null;
   const s = ge[t];
   return e > s ? s : e;
 }
-const ve = /^blur\((\d{1,7}(?:\.\d{1,4})?)px\) brightness\((\d{1,7}(?:\.\d{1,4})?)\)$/, et = "blur(0px) brightness(1)";
+const ve = /^blur\((\d{1,7}(?:\.\d{1,4})?)px\) brightness\((\d{1,7}(?:\.\d{1,4})?)\)$/, tt = "blur(0px) brightness(1)";
 function be(t) {
   if (typeof t != "string" || t.length === 0 || t.length > pe) return null;
   const e = ve.exec(t);
   if (!e) return null;
-  const s = L("blur", Number(e[1])), n = L("brightness", Number(e[2]));
+  const s = N("blur", Number(e[1])), n = N("brightness", Number(e[2]));
   return s === null || n === null ? null : `blur(${s}px) brightness(${n})`;
 }
 function ye(t, e) {
-  q(
+  B(
     e,
     t,
     "rejected unsafe filter value : outside the R8 caps or not a finite number >= 0"
@@ -109,7 +114,7 @@ const ke = { duration: 0 }, we = {
   "cubic-out": "easeOut",
   "cubic-in-out": "easeInOut"
 };
-function tt(t) {
+function st(t) {
   return !t || t.kind === "none" ? ke : t.kind === "tween" ? {
     type: "tween",
     duration: (t.duration_ms ?? 0) / 1e3,
@@ -142,7 +147,7 @@ const Se = {
   duration_ms: 400,
   ease: "cubic-out"
 };
-function st(t, e, s) {
+function nt(t, e, s) {
   for (const n of e) {
     const r = t(n);
     if (r !== void 0) return r;
@@ -155,7 +160,7 @@ function st(t, e, s) {
     return Te;
   }
 }
-function nt(t, e, s) {
+function rt(t, e, s) {
   if (!e || Object.keys(e).length === 0)
     return { initial: t, animate: t };
   let n = e;
@@ -204,11 +209,11 @@ class Re {
   transitions = /* @__PURE__ */ new Map();
   signal(e) {
     let s = this.signals.get(e);
-    return s || (s = p(void 0), this.signals.set(e, s)), s;
+    return s || (s = g(void 0), this.signals.set(e, s)), s;
   }
   transitionSignal(e) {
     let s = this.transitions.get(e);
-    return s || (s = p(void 0), this.transitions.set(e, s)), s;
+    return s || (s = g(void 0), this.transitions.set(e, s)), s;
   }
   set(e, s) {
     const n = this.signal(e);
@@ -246,7 +251,7 @@ class Re {
     return e;
   }
 }
-function B() {
+function W() {
   return new Re();
 }
 function k(t, e) {
@@ -265,13 +270,17 @@ function k(t, e) {
   return !0;
 }
 const Oe = /* @__PURE__ */ new Set([
-  "x-lumencast.color-srgb-1.0"
-]), Le = /^x-[a-z0-9-]+(?:\.[a-z0-9-]+)*$/, Ne = /^(?:0|[1-9][0-9]*)$/, N = ".authoring";
-function Ue(t) {
+  "x-lumencast.color-srgb-1.0",
+  // RFC-0001 / ADR 004 — this runtime ships the Zab capture plugin, so a
+  // bundle declaring `x-zab.capture/1` in `profiles[]` is compatible (it is
+  // NOT rejected as BUNDLE_INCOMPATIBLE, §17.3.1).
+  "x-zab.capture/1"
+]), Le = /^x-[a-z0-9-]+(?:\.[a-z0-9-]+)*$/, Ne = /^(?:0|[1-9][0-9]*)$/, x = ".authoring";
+function xe(t) {
   const e = t.indexOf("/");
   if (e < 0) return !1;
   const s = t.slice(0, e), n = t.slice(e + 1);
-  return !Ne.test(n) || !s.endsWith(N) ? !1 : Le.test(s.slice(0, -N.length));
+  return !Ne.test(n) || !s.endsWith(x) ? !1 : Le.test(s.slice(0, -x.length));
 }
 class U extends Error {
   code = "BUNDLE_INCOMPATIBLE";
@@ -284,17 +293,17 @@ class U extends Error {
     ), this.name = "BundleIncompatibleError", this.unsupportedProfiles = e;
   }
 }
-function x(t, e = Oe) {
+function P(t, e = Oe) {
   const s = t.profiles;
   if (!s) return;
   if (!Array.isArray(s))
     throw new U(["<malformed: profiles is not an array>"]);
   if (s.length === 0) return;
-  const n = s.filter((r) => typeof r != "string" || !Ue(r) && !e.has(r)).map((r) => typeof r == "string" ? r : "<malformed: non-string profile entry>");
+  const n = s.filter((r) => typeof r != "string" || !xe(r) && !e.has(r)).map((r) => typeof r == "string" ? r : "<malformed: non-string profile entry>");
   if (n.length > 0)
     throw new U(n);
 }
-class xe {
+class Ue {
   cache = /* @__PURE__ */ new Map();
   baseUrl;
   pathPrefix;
@@ -317,7 +326,7 @@ class xe {
     return this.resolveUrl ? this.resolveUrl(e, s) : `${this.baseUrl}${this.pathPrefix}/${encodeURIComponent(e)}/bundle?v=${encodeURIComponent(s)}`;
   }
   preload(e) {
-    x(e), this.cache.set(e.scene_version, e);
+    P(e), this.cache.set(e.scene_version, e);
   }
   async get(e, s) {
     const n = this.cache.get(s);
@@ -330,13 +339,13 @@ class xe {
       throw new Error(
         `bundle scene_version mismatch: expected ${s}, got ${a.scene_version}`
       );
-    return x(a), this.cache.set(s, a), a;
+    return P(a), this.cache.set(s, a), a;
   }
 }
 function Pe(t) {
-  return new xe(t);
+  return new Ue(t);
 }
-const g = {
+const v = {
   initial: 200,
   max: 5e3,
   factor: 2,
@@ -368,10 +377,10 @@ class je {
 }
 function Me(t = {}) {
   const e = {
-    initial: t.initial ?? g.initial,
-    max: t.max ?? g.max,
-    factor: t.factor ?? g.factor,
-    jitter: t.jitter ?? g.jitter
+    initial: t.initial ?? v.initial,
+    max: t.max ?? v.max,
+    factor: t.factor ?? v.factor,
+    jitter: t.jitter ?? v.jitter
   };
   if (e.initial <= 0) throw new RangeError("initial must be > 0");
   if (e.max < e.initial) throw new RangeError("max must be >= initial");
@@ -420,11 +429,11 @@ class $e {
    *  authenticate the render-bundle GET with the same credential. A
    *  `LumencastTokenProvider` is awaited. */
   resolveCurrentToken() {
-    return P(this.token);
+    return j(this.token);
   }
   /** Send `input` patches to the server. No-op if not connected. */
   sendInput(e) {
-    !this.socket || this.socket.readyState !== this.WebSocketCtor.OPEN || e.length !== 0 && this.socket.send(R(ne(e)));
+    !this.socket || this.socket.readyState !== this.WebSocketCtor.OPEN || e.length !== 0 && this.socket.send(O(ne(e)));
   }
   /** Replace the auth token. Closes and reopens with the new token. */
   setToken(e) {
@@ -440,7 +449,7 @@ class $e {
     this.setStatus("connecting");
     let e;
     try {
-      e = await P(this.token);
+      e = await j(this.token);
     } catch (n) {
       this.opts.onTransportError?.(
         new m(
@@ -479,7 +488,7 @@ class $e {
       ...this.opts.session !== void 0 ? { session: this.opts.session } : {},
       ...r !== void 0 ? { since_sequence: r } : {}
     });
-    this.socket.send(R(i));
+    this.socket.send(O(i));
   }
   handleMessage(e) {
     const s = typeof e.data == "string" ? e.data : "";
@@ -488,7 +497,7 @@ class $e {
     try {
       n = ce(s);
     } catch (r) {
-      const i = (r instanceof O, r.message), c = r instanceof O ? r.code : "INTERNAL";
+      const i = (r instanceof L, r.message), c = r instanceof L ? r.code : "INTERNAL";
       this.opts.onTransportError?.(new m(`codec: ${i}`, !0, c, r)), this.closeSocket(), this.scheduleReconnect();
       return;
     }
@@ -571,7 +580,7 @@ class $e {
     this.status !== e && (this.status = e, this.opts.onStatus?.(e));
   }
 }
-async function P(t) {
+async function j(t) {
   return typeof t == "string" ? t : await t.fetch();
 }
 function De(t) {
@@ -586,26 +595,26 @@ function De(t) {
       throw new TypeError("mount: `scene` is required when mode === 'test'");
   }
 }
-function rt(t) {
+function it(t) {
   De(t), t.onStatus?.("disconnected");
-  const e = B(), s = Ce(t.serverUrl), n = Pe({
+  const e = W(), s = Fe(t.serverUrl), n = Pe({
     baseUrl: s,
     ...t.resolveBundleUrl !== void 0 ? { resolveUrl: t.resolveBundleUrl } : {},
     getAuthToken: () => d.resolveCurrentToken()
-  }), r = p(null), i = p("disconnected"), c = p("__initial__"), a = (o) => {
+  }), r = g(null), i = g("disconnected"), c = g("__initial__"), a = (o) => {
     i.value = o, t.onStatus?.(o);
   }, f = (o) => {
     t.onError?.(o);
   };
   let u = !0;
-  const b = t.onDiagnostic ? C(t.onDiagnostic) : void 0, d = new $e({
+  const p = t.onDiagnostic ? q(t.onDiagnostic) : void 0, d = new $e({
     url: t.serverUrl,
     token: t.token,
     ...t.scene !== void 0 ? { scene: t.scene } : {},
     ...t.testSession !== void 0 ? { session: t.testSession } : {},
     onStatus: a,
     onSnapshot: (o) => {
-      u && (z(
+      u && (H(
         n,
         r,
         c,
@@ -642,51 +651,54 @@ function rt(t) {
       });
     },
     onTransportError: (o) => {
-      f(Fe(o));
+      f(Ce(o));
     }
   });
   d.start();
-  const T = $(t.target);
-  return T.render(
+  const _ = D(t.target);
+  return _.render(
     J(he, {
       mode: t.mode,
       store: e,
       bundleSignal: r,
       statusSignal: i,
       crossfadeKeySignal: c,
-      sendInput: (o) => d.sendInput(o)
+      sendInput: (o) => d.sendInput(o),
+      // ADR 004 §A1.3 — thread the host capture resolver to the runtime context
+      // so the `x-zab.capture` primitive's ACQUIRE mode can pin a device.
+      ...t.resolveCaptureDevice !== void 0 ? { resolveCaptureDevice: t.resolveCaptureDevice } : {}
     })
   ), {
     disconnect() {
-      u && (u = !1, b?.(), d.close(), T.unmount());
+      u && (u = !1, p?.(), d.close(), _.unmount());
     },
     setToken(o) {
       u && d.setToken(o);
     }
   };
-  async function z(o, y, H, _, E, G, X) {
-    let I;
+  async function H(o, y, G, E, I, X, Y) {
+    let A;
     try {
-      I = await o.get(_, E);
-    } catch (A) {
-      X({
+      A = await o.get(E, I);
+    } catch (R) {
+      Y({
         code: "BUNDLE_FETCH_FAILED",
-        message: A instanceof Error ? A.message : "render bundle fetch failed",
+        message: R instanceof Error ? R.message : "render bundle fetch failed",
         recoverable: !0
       });
       return;
     }
-    u && (G(), y.value = I, H.value = `${_}::${E}`);
+    u && (X(), y.value = A, G.value = `${E}::${I}`);
   }
 }
-function Fe(t) {
+function Ce(t) {
   return {
     code: t.code,
     message: t.message,
     recoverable: t.recoverable
   };
 }
-function Ce(t) {
+function Fe(t) {
   try {
     const e = new URL(t);
     return `${e.protocol === "wss:" ? "https:" : "http:"}//${e.host}`;
@@ -711,13 +723,13 @@ const qe = [
   // compiler and consumed by the Tree (built into a `<mask>` SVG element).
   "mask"
 ];
-function h(t) {
+function l(t) {
   return /* @__PURE__ */ new Set([...qe, ...t]);
 }
 const Be = {
-  stack: h(["direction", "gap", "wrap", "crossGap", "align", "justify"]),
-  grid: h(["cols", "rows", "gap"]),
-  frame: h([
+  stack: l(["direction", "gap", "wrap", "crossGap", "align", "justify"]),
+  grid: l(["cols", "rows", "gap"]),
+  frame: l([
     "x",
     "y",
     "width",
@@ -728,7 +740,7 @@ const Be = {
     "backgrounds",
     "clipsContent"
   ]),
-  text: h([
+  text: l([
     "value",
     "size",
     "font",
@@ -742,8 +754,8 @@ const Be = {
     "fontStyle",
     "maxLines"
   ]),
-  image: h(["src", "alt", "fit", "position", "width", "height"]),
-  shape: h([
+  image: l(["src", "alt", "fit", "position", "width", "height"]),
+  shape: l([
     "geometry",
     "kind",
     "width",
@@ -758,8 +770,13 @@ const Be = {
     "paths",
     "ariaLabel"
   ]),
-  media: h(["src", "loop", "mute", "autoplay", "fit"]),
-  instance: h(["scene_id", "scene_version", "size", "position"]),
+  media: l(["src", "loop", "mute", "autoplay", "fit"]),
+  instance: l(["scene_id", "scene_version", "size", "position"]),
+  // RFC-0001 / ADR 004 — vendor capture placeholder. `width`/`height` are the
+  // flattened geometry (universal) ; the `x-zab.*` props are carried as
+  // metadata (the renderer reserves the box, ignores deviceRef). Listed so
+  // they are NOT flagged as silent drops by the anti-drop audit.
+  "x-zab.capture": l(["x-zab.sourceKind", "x-zab.deviceRef", "width", "height"]),
   // `repeat` is dispatched specially by the tree ; its only consumed
   // binding is `items`.
   repeat: /* @__PURE__ */ new Set(["items"])
@@ -768,16 +785,16 @@ function We(t, e) {
   const s = Be[t];
   return !!(s === void 0 || s.has(e) || t === "instance" && (e === "params" || e.startsWith("params.")));
 }
-const j = /* @__PURE__ */ new WeakSet();
-function it(t) {
-  if (j.has(t)) return;
-  j.add(t);
+const M = /* @__PURE__ */ new WeakSet();
+function ot(t) {
+  if (M.has(t)) return;
+  M.add(t);
   const e = /* @__PURE__ */ new Set([
     ...Object.keys(t.props ?? {}),
     ...Object.keys(t.bindings ?? {})
   ]);
   for (const s of e)
-    We(t.kind, s) || q(
+    We(t.kind, s) || B(
       t.id,
       `${t.kind}.${s}`,
       "is not consumed by this primitive's renderer ; the prop is ignored (anti-silent-drop, ADR 001 §3.4)"
@@ -785,17 +802,17 @@ function it(t) {
 }
 const ze = { width: 1920, height: 1080 }, He = () => {
 };
-function ot(t) {
+function ct(t) {
   const e = t.stage ?? ze, s = t.target;
   s.style.position ||= "relative", s.style.width = `${e.width}px`, s.style.height = `${e.height}px`, s.style.overflow = "hidden";
-  const n = t.onDiagnostic ? C(t.onDiagnostic) : void 0, r = B();
+  const n = t.onDiagnostic ? q(t.onDiagnostic) : void 0, r = W();
   r.reset(t.defaults ?? {});
-  const i = $(s);
+  const i = D(s);
   return {
     ready: new Promise((a) => {
-      import("./broadcast-Gcd-dmC7.js").then(({ BroadcastMode: f }) => {
+      import("./broadcast-ryjLRD5q.js").then(({ BroadcastMode: f }) => {
         i.render(
-          /* @__PURE__ */ l(Q, { children: /* @__PURE__ */ l(
+          /* @__PURE__ */ h(Q, { children: /* @__PURE__ */ h(
             F,
             {
               value: {
@@ -805,15 +822,15 @@ function ot(t) {
                 status: "live",
                 sendInput: He
               },
-              children: /* @__PURE__ */ l(f, {})
+              children: /* @__PURE__ */ h(f, {})
             }
           ) })
         );
         const u = new Promise((d) => {
           requestAnimationFrame(() => requestAnimationFrame(() => d()));
-        }), b = typeof document < "u" && document.fonts ? document.fonts.ready.then(() => {
+        }), p = typeof document < "u" && document.fonts ? document.fonts.ready.then(() => {
         }) : Promise.resolve();
-        Promise.all([u, b]).then(() => a());
+        Promise.all([u, p]).then(() => a());
       });
     }),
     unmount() {
@@ -821,30 +838,30 @@ function ot(t) {
     }
   };
 }
-function W(t, e) {
+function z(t, e) {
   if (typeof t != "string") return t;
   if (e[t]) return e[t];
   const s = /^assets\/([A-Za-z0-9]+)\.[A-Za-z0-9]+$/.exec(t);
   return s && s[1] !== void 0 && e[s[1]] ? e[s[1]] : t;
 }
-function M(t, e) {
+function $(t, e) {
   if (t === null || typeof t != "object") return;
   if (Array.isArray(t)) {
-    for (const n of t) M(n, e);
+    for (const n of t) $(n, e);
     return;
   }
   const s = t;
-  "src" in s && (s.src = W(s.src, e));
+  "src" in s && (s.src = z(s.src, e));
   for (const n of Object.values(s))
-    n && typeof n == "object" && M(n, e);
+    n && typeof n == "object" && $(n, e);
 }
-function ct(t, e) {
+function at(t, e) {
   const s = { ...t };
   for (const [n, r] of Object.entries(s))
-    n.startsWith("__lit.image.") && (s[n] = W(r, e));
+    n.startsWith("__lit.image.") && (s[n] = z(r, e));
   return s;
 }
-async function at(t) {
+async function ut(t) {
   const e = [];
   for (const s of t)
     try {
@@ -860,26 +877,27 @@ async function at(t) {
 export {
   fe as A,
   U as B,
-  et as F,
+  tt as F,
   Be as P,
   Oe as S,
-  it as a,
-  C as b,
-  L as c,
-  Ue as d,
-  q as e,
-  rt as f,
-  ot as g,
-  W as h,
-  at as i,
-  ct as j,
-  M as k,
-  nt as m,
-  st as r,
+  et as a,
+  ot as b,
+  N as c,
+  q as d,
+  B as e,
+  xe as f,
+  it as g,
+  ct as h,
+  ut as i,
+  z as j,
+  at as k,
+  $ as l,
+  rt as m,
+  nt as r,
   be as s,
-  tt as t,
+  st as t,
   Ve as u,
-  x as v,
+  P as v,
   ye as w
 };
-//# sourceMappingURL=index-N-VqrIxN.js.map
+//# sourceMappingURL=index-DrXsLYhe.js.map