@glissade/core 0.58.1 → 0.59.0-pre.0

package/dist/index.d.ts

@@ -448,6 +448,23 @@ interface BindOptions {
    * the generic "no property signal resolves to it".
    */
   unboundMessage?: (target: string) => string | undefined;
+  /**
+   * 0.59 "fail-loud ground floor" MODE GATE. What binding does when a track
+   * target fails to resolve to any property signal:
+   *
+   * - `'throw'` (DEFAULT — loud) raises {@link UnboundTargetError} at bind, the
+   *   dev/CI behavior authors want (a typo'd target is a build error, §2.2).
+   * - `'warn'` DOWNGRADES the throw to a one-line dev-warning and SKIPS the
+   *   track. Shipped/prod embeds opt into this via `mount({ production: true })`,
+   *   so an external scene degrades (the offending track simply doesn't apply)
+   *   instead of hard-failing the whole render.
+   *
+   * DETERMINISM (0.59 invariant): the leaf `if (!sig)` below is the ONLY branch
+   * that differs between modes. A VALID scene (every target resolves) never
+   * reaches it, so both modes install the IDENTICAL bindings and produce
+   * byte-identical output — the mode is byte-neutral for every valid scene.
+   */
+  onUnbound?: 'throw' | 'warn';
 }
 /**
  * Bind a compiled timeline's tracks to property signals. `resolve` returns

package/dist/index.js

@@ -967,7 +967,14 @@ function bindTimeline(compiled, resolve, playhead = createPlayhead(), options =
 	const samplers = /* @__PURE__ */ new Map();
 	for (const [target, tr] of compiled.tracks) {
 		const sig = resolve(target);
-		if (!sig) throw new UnboundTargetError(target, options.unboundMessage?.(target));
+		if (!sig) {
+			const message = options.unboundMessage?.(target);
+			if (options.onUnbound === "warn") {
+				emitDevWarning(message ?? `timeline targets '${target}' but no property signal resolves to it — track skipped (production mode)`);
+				continue;
+			}
+			throw new UnboundTargetError(target, message);
+		}
 		const got = tr.type;
 		const expects = sig.expects;
 		if (expects !== void 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/core",
-  "version": "0.58.1",
+  "version": "0.59.0-pre.0",
   "description": "glissade core: signals, tracks, timeline document, evaluation, easing, springs, seeded RNG. Zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {