@glissade/scene 0.61.0-pre.0 → 0.61.0-pre.1

package/dist/describe.js

@@ -23,7 +23,7 @@ import { easings, listValueTypes } from "@glissade/core";
 * never pulled onto the base embed path — a scene that never calls `describe()`
 * pays zero bytes for it.
 */
-const RAW_VERSION = "0.61.0-pre.0";
+const RAW_VERSION = "0.61.0-pre.1";
 const PACKAGE_VERSION = RAW_VERSION.includes("GLISSADE_".concat("VERSION")) ? "0.0.0-dev" : RAW_VERSION;
 /**
 * Parse the documented positional-arg count from a helper `usage` string — the

package/dist/diagnostics.js

@@ -923,6 +923,17 @@ function sortDiagnostics(diags) {
 }
 //#endregion
 //#region src/diff.ts
+/**
+* `diff` takes two `{ scene, timeline }` STATE PAIRS, not two `(scene, timeline)`
+* args like its sibling diagnostics (critique/exportFidelity) — a plausible misuse.
+* Passing a raw `Scene` would fall through to `evaluate` and throw the cryptic
+* "Invalid value used as weak map key"; catch it here with an actionable message.
+*/
+function assertDiffInput(x, which) {
+	if (x !== null && typeof x === "object" && typeof x.scene === "object" && x.scene !== null) return;
+	const looksLikeScene = x !== null && typeof x === "object" && "nodes" in x && "root" in x && typeof x.resolveTarget === "function";
+	throw new TypeError(looksLikeScene ? `diff expects { scene, timeline } state objects (got a Scene) — did you mean diff({ scene, timeline }, { scene, timeline })? (unlike critique/exportFidelity, diff takes two STATE PAIRS, not scene+timeline args)` : `diff's ${which} argument must be a { scene, timeline } state object`);
+}
 /** Stable JSON of any value — object keys sorted so key ORDER never reads as a
 *  change. NaN/Infinity/undefined are normalized to stable sentinels. */
 function canonical(v) {
@@ -992,6 +1003,8 @@ function trackSignature(track) {
 * to also diff the DisplayList at `at`. Pure read; `diff(a, a)` is EMPTY.
 */
 function diff(a, b, opts = {}) {
+	assertDiffInput(a, "first");
+	assertDiffInput(b, "second");
 	const added = [];
 	const removed = [];
 	const changed = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.61.0-pre.0",
+  "version": "0.61.0-pre.1",
   "description": "glissade scene graph: nodes, transforms, DisplayList emission. Renderer-agnostic; zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {
@@ -81,7 +81,7 @@
   ],
   "dependencies": {
     "yoga-layout": "^3.2.1",
-    "@glissade/core": "0.61.0-pre.0"
+    "@glissade/core": "0.61.0-pre.1"
   },
   "repository": {
     "type": "git",