@glissade/player 0.58.1 → 0.59.0-pre.0

package/dist/index.d.ts

@@ -84,6 +84,17 @@ interface PlayerOptions {
   strictFonts?: boolean;
   /** OS-installed families to treat as registered for strict mode. */
   osFonts?: ReadonlySet<string>;
+  /**
+   * 0.59 "fail-loud ground floor" prod escape hatch. By DEFAULT an unresolvable
+   * track target (a typo'd `<id>/<prop>`) HARD-THROWS `UnboundTargetError` at
+   * bind — the loud dev behavior. Set `production: true` on a SHIPPED embed to
+   * DOWNGRADE that to a one-line dev-warning and skip the dead track, so an
+   * external/unaudited scene degrades instead of failing the whole render. The
+   * burden-to-remember moves to the shipping step (React dev/prod-invariant
+   * polarity); authoring stays loud. Byte-neutral for every valid scene — only
+   * an INVALID scene's behavior differs (throw vs warn).
+   */
+  production?: boolean;
   /**
    * Backend-injection seam (dom-backend memo, Seam 2 — the S3 foundation). A
    * factory that builds the `RenderBackend` mount() drives, given the render

package/dist/index.js

@@ -1,5 +1,5 @@
 import { buildFontRegistry, compileTimeline, signal } from "@glissade/core";
-import { evaluate } from "@glissade/scene";
+import { bindScene, evaluate } from "@glissade/scene";
 import { validateSceneFonts } from "@glissade/scene/diagnostics";
 import { Canvas2DBackend } from "@glissade/backend-canvas2d";
 //#region src/driver.ts
@@ -298,7 +298,11 @@ function mount(initialScene, initialDoc, canvas, opts = {}) {
 		markers: compiled.markers,
 		targets: compiled.tracks.keys()
 	}, opts);
-	const renderNow = () => backend.render(evaluate(scene, doc, playhead.peek()));
+	const unboundMode = opts.production ? "warn" : "throw";
+	const renderNow = () => {
+		bindScene(scene, doc, { onUnbound: unboundMode });
+		backend.render(evaluate(scene, doc, playhead.peek()));
+	};
 	let scheduled = false;
 	const schedule = () => {
 		if (scheduled) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/player",
-  "version": "0.58.1",
+  "version": "0.59.0-pre.0",
   "description": "glissade embed runtime: Player, Drivers (clock, scroll), mount().",
   "license": "Apache-2.0",
   "engines": {
@@ -18,9 +18,9 @@
     "dist"
   ],
   "dependencies": {
-    "@glissade/backend-canvas2d": "0.58.1",
-    "@glissade/core": "0.58.1",
-    "@glissade/scene": "0.58.1"
+    "@glissade/backend-canvas2d": "0.59.0-pre.0",
+    "@glissade/core": "0.59.0-pre.0",
+    "@glissade/scene": "0.59.0-pre.0"
   },
   "repository": {
     "type": "git",