@woosh/meep-engine 3.19.0 → 3.20.0

package/editor/view/particles/effect/ParticleGraphEditorView.js

@@ -135,10 +135,10 @@ const PARTICLE_TYPE_COLORS = new Map([
  * @type {Array<{name: string, types: string[]}>}
  */
 const PALETTE_CATEGORIES = [
-    { name: "sources", types: ["const", "color", "builtin", "attribute", "random", "curve"] },
+    { name: "sources", types: ["const", "color", "builtin", "attribute", "random"] },
     { name: "output", types: ["setAttribute", "kill"] },
     // The three that are authored data rather than wiring, and are edited as a picture: a gradient
-    // strip and a curve plot. Their own heading, because "a colour ramp" is a thing an
+    // strip and a curve plot. Their own heading, because "a colour ramp" is a thing an
     // author goes looking for by name and would not think to look for under `sources`.
     { name: "ramps", types: ["gradientRGBA", "gradientRGB", "curveLiteral"] },
     { name: "arithmetic", types: ["add", "sub", "mul", "div", "mad", "scale", "min", "max", "pow", "step", "mix", "clamp", "saturate", "smoothstep", "remap", "oneMinus"] },

package/editor/view/particles/effect/ParticleNodeParametersView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleNodeParametersView.d.ts","sourceRoot":"","sources":["../../../../../editor/view/particles/effect/ParticleNodeParametersView.js"],"names":[],"mappings":"AAqCA;IAOI;;;;;;OAMG;IACH;QALyG,MAAM,EAApG,OAAO,qDAAqD,EAAE,sBAAsB;QAE9D,IAAI;QACG,MAAM,SAA1B,MAAM;OA6BzB;IAxBG,mBAAuC;IAIvC;;OAEG;IACH,mBAAgB;;CA4cvB;iBApgBgB,8BAA8B"}
+{"version":3,"file":"ParticleNodeParametersView.d.ts","sourceRoot":"","sources":["../../../../../editor/view/particles/effect/ParticleNodeParametersView.js"],"names":[],"mappings":"AAqCA;IAOI;;;;;;OAMG;IACH;QALyG,MAAM,EAApG,OAAO,qDAAqD,EAAE,sBAAsB;QAE9D,IAAI;QACG,MAAM,SAA1B,MAAM;OA6BzB;IAxBG,mBAAuC;IAIvC;;OAEG;IACH,mBAAgB;;CAmavB;iBA3dgB,8BAA8B"}

package/editor/view/particles/effect/ParticleNodeParametersView.js

@@ -87,9 +87,9 @@ export class ParticleNodeParametersView extends View {
     #buildRow(effect, parameter, commit) {
         const row = new EmptyView({ classList: ['parameter-row', `kind-${parameter.kind}`] });
 
-        if (parameter.kind !== PARTICLE_PARAMETER_KIND.GRADIENT && parameter.kind !== PARTICLE_PARAMETER_KIND.CURVE) {
-            row.addChild(new LabelView(parameter.name, { classList: ['name'] }));
-        }
+        if (parameter.kind !== PARTICLE_PARAMETER_KIND.GRADIENT && parameter.kind !== PARTICLE_PARAMETER_KIND.CURVE) {
+            row.addChild(new LabelView(parameter.name, { classList: ['name'] }));
+        }
 
         if (typeof parameter.description === "string") {
             row.el.setAttribute('title', parameter.description);
@@ -138,10 +138,6 @@ export class ParticleNodeParametersView extends View {
                 row.bindSignal(effect.on.changed, () => control.refresh());
                 break;
 
-            case PARTICLE_PARAMETER_KIND.INTEGER:
-                control = this.#buildIntegerControl(parameter, value, write);
-                break;
-
             case PARTICLE_PARAMETER_KIND.CURVE:
                 control = editor_control(new ParticleCurveEditorView({ read: value, write }));
                 break;
@@ -479,47 +475,10 @@ export class ParticleNodeParametersView extends View {
         return {
             view: new EmptyView({ el: select }),
             write: push,
-            refresh
-        };
-    }
-
-    /**
-     * @param {object} parameter
-     * @param {function():number} read
-     * @param {function(number)} write
-     * @returns {{view: View, write: function(*):void, refresh: function():void}}
-     */
-    #buildIntegerControl(parameter, read, write) {
-        const field = create_input('number');
-
-        field.classList.add('integer');
-        field.setAttribute('min', '0');
-        field.setAttribute('step', '1');
-
-        const push = value => {
-            field.value = String(value ?? 0);
-        };
-
-        field.addEventListener('change', () => {
-            const parsed = Number.parseInt(field.value, 10);
-
-            if (!Number.isInteger(parsed) || parsed < 0) {
-                push(read());
-                return;
-            }
-
-            write(parsed);
-        });
-
-        push(read());
-
-        return {
-            view: new EmptyView({ el: field }),
-            write: push,
-            refresh: () => push(read())
-        };
-    }
-}
+            refresh
+        };
+    }
+}
 
 /**
  * A control that is a view of its own, in the shape the rest of this file uses.

package/package.json

@@ -6,7 +6,7 @@
   "description": "Advanced 3D game engine",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "3.19.0",
+  "version": "3.20.0",
   "exports": {
     "./build/*": "./build/*",
     "./src/*": "./src/*",

package/src/core/collection/array/array_group_by.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array_group_by.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_group_by.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,0IA+BC;2BAzC0B,8BAA8B"}
+{"version":3,"file":"array_group_by.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_group_by.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,0IAqBC;2BA/B0B,8BAA8B"}

package/src/core/collection/array/array_group_by.js

@@ -1,3 +1,4 @@
+import { objectsEqual } from "../../function/objectsEqual.js";
 import { returnZero } from "../../function/returnZero.js";
 import { HashMap } from "../map/HashMap.js";
 
@@ -11,17 +12,7 @@ import { HashMap } from "../map/HashMap.js";
 export function array_group_by(array, grouping_key_producer, keyHashFunction = returnZero) {
     const result = new HashMap({
         keyHashFunction,
-        keyEqualityFunction(a, b) {
-            if (a === b) {
-                return true;
-            }
-
-            if (typeof a === "object" && a !== null && typeof a.equals === "function") {
-                return a.equals(b);
-            }
-
-            return false;
-        }
+        keyEqualityFunction: objectsEqual
     });
 
     for (let i = 0; i < array.length; i++) {

package/src/core/geom/3d/shape/HeightMapShape3D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeightMapShape3D.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/shape/HeightMapShape3D.js"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH;IA4DI;;;;;;;;;;;OAWG;IACH,wCATW,MAAM,UACN,MAAM,UACN,MAAM,gBACN,OAAO,iBACP,MAAM,GAGJ,gBAAgB,CAqB5B;IA1FD;;;;;OAKG;IACH,sBAFU,OAAO,CAEkB;IAEnC;;;;;;;OAOG;IACH,eAFU,OAAO,CAEW;IAE5B;;;;;OAKG;IACH,SAFU,YAAY,IAAI,CAEX;IAEf;;;;;;;;;;;;;;;;OAgBG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;OAKG;IACH,eAA6B;IAG7B,6BAA2B;IAE3B,6BAA2B;IAC3B,6BAA2B;IAmC3B;;;;;;;;;OASG;IACH,sBA+CC;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,OACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;OAQG;IACH,8BALW,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAelB;IAED,wCA8BC;IAED,oCA2BC;IAED;;;;;;;;OAQG;IACH,6CAmBC;IAED;;;;OAIG;IACH,4DA2BC;IAED;;;;;;;;;OASG;IACH,qGAEC;IAED,kFAiBC;IA6CD;;;OAGG;IACH,cAHW,gBAAgB,GACd,OAAO,CAiBnB;IAWL;;;;;;OAMG;IACH,6BAFU,OAAO,CAE4B;CAT5C;gCAvc+B,sBAAsB;wBAD9B,kBAAkB"}
+{"version":3,"file":"HeightMapShape3D.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/shape/HeightMapShape3D.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH;IA4DI;;;;;;;;;;;OAWG;IACH,wCATW,MAAM,UACN,MAAM,UACN,MAAM,gBACN,OAAO,iBACP,MAAM,GAGJ,gBAAgB,CAqB5B;IA1FD;;;;;OAKG;IACH,sBAFU,OAAO,CAEkB;IAEnC;;;;;;;OAOG;IACH,eAFU,OAAO,CAEW;IAE5B;;;;;OAKG;IACH,SAFU,YAAY,IAAI,CAEX;IAEf;;;;;;;;;;;;;;;;OAgBG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;OAKG;IACH,eAA6B;IAG7B,6BAA2B;IAE3B,6BAA2B;IAC3B,6BAA2B;IAmC3B;;;;;;;;;OASG;IACH,sBA+CC;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,OACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;OAQG;IACH,8BALW,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAelB;IAED,wCA8BC;IAED,oCA2BC;IAED;;;;;;;;OAQG;IACH,6CAmBC;IAED;;;;OAIG;IACH,4DA2BC;IAED;;;;;;;;;OASG;IACH,qGAEC;IAED,kFAiBC;IA6CD;;;OAGG;IACH,cAHW,gBAAgB,GACd,OAAO,CAUnB;IAWL;;;;;;OAMG;IACH,6BAFU,OAAO,CAE4B;CAT5C;gCAhc+B,sBAAsB;wBAD9B,kBAAkB"}

package/src/core/geom/3d/shape/HeightMapShape3D.js

@@ -2,6 +2,8 @@ import { hash_mix3 } from "../../../math/hash/hash_mix3.js";
 import { hash_mix2 } from "../../../math/hash/hash_mix2.js";
 import { assert } from "../../../assert.js";
 import { clamp } from "../../../math/clamp.js";
+import { optional_equality } from "../../../model/object/optional_equality.js";
+import { optional_hash } from "../../../model/object/optional_hash.js";
 import { v3_length } from "../../vec3/v3_length.js";
 import { Vector3 } from "../../Vector3.js";
 import { AbstractShape3D } from "./AbstractShape3D.js";
@@ -442,20 +444,13 @@ export class HeightMapShape3D extends AbstractShape3D {
         if (!this.size.equals(other.size)) return false;
         if (this.tessellation !== other.tessellation) return false;
 
-        // strict identity is enough for sampler equality in the common case;
-        // fall through to value equality so two shapes built from independent
-        // but identical sampler instances still compare equal
-        if (this.sampler === other.sampler) return true;
-
-        if (this.sampler === null || other.sampler === null) return false;
-
-        return this.sampler.equals(other.sampler);
+        return optional_equality(this.sampler, other.sampler);
     }
 
     hash() {
         const a = this.orientation.hash();
         const b = this.size.hash();
-        const c = this.sampler !== null ? this.sampler.hash() : 0;
+        const c = optional_hash(this.sampler);
 
         return hash_mix2(hash_mix3(a, b, c), this.tessellation);
     }

package/src/core/model/object/optional_clone.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @template T
+ * @param {T} obj
+ * @return {T}
+ */
+export function optional_clone<T>(obj: T): T;
+//# sourceMappingURL=optional_clone.d.ts.map

package/src/core/model/object/optional_clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional_clone.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/optional_clone.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,6CAcC"}

package/src/core/model/object/optional_equality.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @template {{equals(T):boolean}} T
+ * @param {undefined|null|T} a
+ * @param {undefined|null|T} b
+ * @return {boolean}
+ */
+export function optional_equality<T extends {
+    equals(T: any): boolean;
+}>(a: T, b: T): boolean;
+//# sourceMappingURL=optional_equality.d.ts.map

package/src/core/model/object/optional_equality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional_equality.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/optional_equality.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;oBALyB,OAAO;gBAGpB,OAAO,CAsBlB"}

package/src/{shade/descriptor/util → core/model/object}/optional_equality.js

@@ -1,7 +1,7 @@
 /**
  * @template {{equals(T):boolean}} T
- * @param {undefined|T} a
- * @param {undefined|T} b
+ * @param {undefined|null|T} a
+ * @param {undefined|null|T} b
  * @return {boolean}
  */
 export function optional_equality(a, b) {

package/src/core/model/object/optional_hash.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @template {{hash():number}} T
+ * @param {T|null|undefined} thing
+ * @return {number}
+ */
+export function optional_hash<T extends {
+    hash(): number;
+}>(thing: T): number;
+//# sourceMappingURL=optional_hash.d.ts.map

package/src/core/model/object/optional_hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional_hash.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/optional_hash.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH;YAJsB,MAAM;cAEhB,MAAM,CAYjB"}

package/src/{shade/descriptor/util → core/model/object}/optional_hash.js

@@ -1,12 +1,12 @@
-import { assert } from "../../../core/assert.js";
+import { assert } from "../../assert.js";
 
 /**
  * @template {{hash():number}} T
- * @param {T|undefined} thing
+ * @param {T|null|undefined} thing
  * @return {number}
  */
 export function optional_hash(thing) {
-    if (thing === undefined) {
+    if (thing === undefined || thing === null) {
         return 0;
     }
 

package/src/engine/asset/Asset.d.ts

@@ -37,7 +37,7 @@ export class Asset<T> {
      * @returns {boolean}
      */
     equals(other: Asset<any>): boolean;
-    hash(): any;
+    hash(): number;
     /**
      *
      * @returns {T}

package/src/engine/asset/Asset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Asset.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/Asset.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH;IAcI;;;;;OAKG;IACH,4CAHW,MAAM,EAehB;IA/BD;;;;OAIG;IACH,cAFU,uBAAuB,CAEf;IAElB;;;OAGG;IACH,8BAAmB;IASf;;;OAGG;IACH,mBAAsB;IAEtB;;;OAGG;IACH,UAFU,MAAM,CAEQ;IAG5B;;;;OAIG;IACH,2BAFa,OAAO,CAgBnB;IAED,YAEC;IAED;;;OAGG;IACH,UAFa,CAAC,CAIb;CACJ"}
+{"version":3,"file":"Asset.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/Asset.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IAcI;;;;;OAKG;IACH,4CAHW,MAAM,EAehB;IA/BD;;;;OAIG;IACH,cAFU,uBAAuB,CAEf;IAElB;;;OAGG;IACH,8BAAmB;IASf;;;OAGG;IACH,mBAAsB;IAEtB;;;OAGG;IACH,UAFU,MAAM,CAEQ;IAG5B;;;;OAIG;IACH,2BAFa,OAAO,CAgBnB;IAED,eAEC;IAED;;;OAGG;IACH,UAFa,CAAC,CAIb;CACJ"}

package/src/engine/asset/Asset.js

@@ -1,3 +1,5 @@
+import { optional_hash } from "../../core/model/object/optional_hash.js";
+
 /**
  * @template T
  *
@@ -58,7 +60,7 @@ export class Asset {
     }
 
     hash() {
-        return this.description === null ? 0 : this.description.hash();
+        return optional_hash(this.description);
     }
 
     /**

package/src/engine/ecs/gui/hud/HeadsUpDisplaySystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeadsUpDisplaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/gui/hud/HeadsUpDisplaySystem.js"],"names":[],"mappings":";AAsBA;;;;;GAKG;AACH;IASI;;;OAGG;IACH,4CAmBC;IA/BD,wCAAgC;IAGhC,2HAGE;IAaE,yBAA8B;IAM9B;;;;OAIG;IACH,+BAAiD;IAGrD,iCAGC;IAED,gCAIC;IAED;;;;;;;;;OASG;IACH,sCAkJC;IAED,6BAsBC;CACJ;uBAxPsB,iBAAiB;2BAIb,qBAAqB;uBAFzB,kBAAkB;4CAJG,uDAAuD;6BAKtE,iCAAiC"}
+{"version":3,"file":"HeadsUpDisplaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/gui/hud/HeadsUpDisplaySystem.js"],"names":[],"mappings":";AAsBA;;;;;GAKG;AACH;IASI;;;OAGG;IACH,4CAmBC;IA/BD,wCAAgC;IAGhC,2HAGE;IAaE,yBAA8B;IAM9B;;;;OAIG;IACH,+BAAiD;IAGrD,iCAGC;IAED,gCAIC;IAED;;;;;;;;;OASG;IACH,sCAiJC;IAED,6BAsBC;CACJ;uBAvPsB,iBAAiB;2BAIb,qBAAqB;uBAFzB,kBAAkB;4CAJG,uDAAuD;6BAKtE,iCAAiC"}

package/src/engine/ecs/gui/hud/HeadsUpDisplaySystem.js

@@ -95,9 +95,10 @@ class HeadsUpDisplaySystem extends System {
             y *= transform.scale_y;
             z *= transform.scale_z;
 
-            const q = transform.rotation;
-
-            v3_quaternion_apply(scratch_rotated_offset, 0, x, y, z, q[0], q[1], q[2], q[3]);
+            v3_quaternion_apply(
+                scratch_rotated_offset, 0, x, y, z,
+                transform.rotation_x, transform.rotation_y, transform.rotation_z, transform.rotation_w
+            );
 
             x = scratch_rotated_offset[0];
             y = scratch_rotated_offset[1];
@@ -105,11 +106,9 @@ class HeadsUpDisplaySystem extends System {
         }
 
         // add transform position to get final world position
-        const position = transform.translation;
-
-        x += position[0];
-        y += position[1];
-        z += position[2];
+        x += transform.translation_x;
+        y += transform.translation_y;
+        z += transform.translation_z;
 
         const worldPositionX = x;
         const worldPositionY = y;
@@ -187,8 +186,8 @@ class HeadsUpDisplaySystem extends System {
             ndcY = 0.5 + dy;
         }
 
-        vp.position[0] = ndcX;
-            position[1] = ndcY;
+        // Notify ViewportPositionSystem so it updates the label's placement and visibility.
+        vp.position.set(ndcX, ndcY);
 
         const visible = (!trackedPositionOutOfBounds || vp.stickToScreenEdge) && this.__visibility_predicate.test(worldPositionX, worldPositionY, worldPositionZ);
 

package/src/engine/graphics/ecs/particles/ParticleEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleEffect.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/particles/ParticleEffect.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH;IAoRI;;;;;;;;;;;;;;;;;;OAkBG;IACH;QAZ2G,MAAM,GAAtG,OAAO,+DAA+D,EAAE,cAAc;QACS,OAAO,GAAtG,OAAO,6DAA6D,EAAE,eAAe;QAChE,OAAO,GAA5B,MAAM,GAAC,IAAI;QACK,IAAI,GAApB,MAAM;QACU,UAAU,GAA1B,MAAM;QACW,QAAQ,GAAzB,OAAO;QACS,OAAO,GAAvB,MAAM;QACU,KAAK,GAArB,MAAM;QACyB,MAAM;gBAA9B,MAAM,GAAC,MAAM;;QACO,QAAQ,GAAnC,UAAU,MAAM,CAAC;QACf,cAAc,CA8C1B;IAjVD;;;;;;;;;OASG;IACH,QAFU,OAAO,+DAA+D,EAAE,cAAc,GAAC,IAAI,CAEvF;IAEd;;;;;OAKG;IACH,SAFU,OAAO,6DAA6D,EAAE,eAAe,GAAC,IAAI,CAErF;IAEf;;;;;;;;;OASG;IACH,SAFU,MAAM,GAAC,IAAI,CAEN;IAEf;;;;;;;;OAQG;IACH,MAFU,MAAM,CAEP;IAET;;;;;OAKG;IACH,YAFU,MAAM,CAED;IAEf;;;;;;;;;;OAUG;IACH,UAFU,OAAO,CAED;IAEhB;;;;;;;;;;;;;OAaG;IACH,SAFU,MAAM,CAEJ;IAEZ;;;;;OAKG;IACH,OAFU,MAAM,CAEN;IAEV;;;;;OAKG;IACH,UAFU,YAAY,CAEc;IAEpC,+FAA+F;IAC/F,iBADW,MAAM,CAC0B;IAC3C,gDAAgD;IAChD,aADW,MAAM,CACsB;IACvC,uDAAuD;IACvD,cADW,MAAM,CACuB;IACxC,+DAA+D;IAC/D,iBADW,MAAM,CAC0B;IAC3C,gEAAgE;IAChE,cADW,MAAM,CACuB;IACxC,sFAAsF;IACtF,iBADW,MAAM,CAC0B;IAE3C;;;;;OAKG;IACH,mCAEC;IAED;;;;;;;;;;;;;;;OAeG;IACH;YAJkB,MAAM,GAAC,MAAM;QAElB,cAAc,CAuC1B;IAED;;;;;;;;;OASG;IACH,cAHW,cAAc,GACZ,OAAO,CAsBnB;IAED;;;;OAIG;IACH,QAFa,MAAM,CAuBlB;IAED;;;;;;;;;OASG;IACH,YAHW,cAAc,GACZ,cAAc,CAuB1B;IAED;;OAEG;IACH,SAFa,cAAc,CAI1B;IAkGL;;;;;OAKG;IACH,2BAFU,OAAO,CAEwB;CAtCxC;;kBA4BS,MAAM"}
+{"version":3,"file":"ParticleEffect.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/particles/ParticleEffect.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH;IAoRI;;;;;;;;;;;;;;;;;;OAkBG;IACH;QAZ2G,MAAM,GAAtG,OAAO,+DAA+D,EAAE,cAAc;QACS,OAAO,GAAtG,OAAO,6DAA6D,EAAE,eAAe;QAChE,OAAO,GAA5B,MAAM,GAAC,IAAI;QACK,IAAI,GAApB,MAAM;QACU,UAAU,GAA1B,MAAM;QACW,QAAQ,GAAzB,OAAO;QACS,OAAO,GAAvB,MAAM;QACU,KAAK,GAArB,MAAM;QACyB,MAAM;gBAA9B,MAAM,GAAC,MAAM;;QACO,QAAQ,GAAnC,UAAU,MAAM,CAAC;QACf,cAAc,CA8C1B;IAjVD;;;;;;;;;OASG;IACH,QAFU,OAAO,+DAA+D,EAAE,cAAc,GAAC,IAAI,CAEvF;IAEd;;;;;OAKG;IACH,SAFU,OAAO,6DAA6D,EAAE,eAAe,GAAC,IAAI,CAErF;IAEf;;;;;;;;;OASG;IACH,SAFU,MAAM,GAAC,IAAI,CAEN;IAEf;;;;;;;;OAQG;IACH,MAFU,MAAM,CAEP;IAET;;;;;OAKG;IACH,YAFU,MAAM,CAED;IAEf;;;;;;;;;;OAUG;IACH,UAFU,OAAO,CAED;IAEhB;;;;;;;;;;;;;OAaG;IACH,SAFU,MAAM,CAEJ;IAEZ;;;;;OAKG;IACH,OAFU,MAAM,CAEN;IAEV;;;;;OAKG;IACH,UAFU,YAAY,CAEc;IAEpC,+FAA+F;IAC/F,iBADW,MAAM,CAC0B;IAC3C,gDAAgD;IAChD,aADW,MAAM,CACsB;IACvC,uDAAuD;IACvD,cADW,MAAM,CACuB;IACxC,+DAA+D;IAC/D,iBADW,MAAM,CAC0B;IAC3C,gEAAgE;IAChE,cADW,MAAM,CACuB;IACxC,sFAAsF;IACtF,iBADW,MAAM,CAC0B;IAE3C;;;;;OAKG;IACH,mCAEC;IAED;;;;;;;;;;;;;;;OAeG;IACH;YAJkB,MAAM,GAAC,MAAM;QAElB,cAAc,CAuC1B;IAED;;;;;;;;;OASG;IACH,cAHW,cAAc,GACZ,OAAO,CAsBnB;IAED;;;;OAIG;IACH,QAFa,MAAM,CAuBlB;IAED;;;;;;;;;OASG;IACH,YAHW,cAAc,GACZ,cAAc,CAuB1B;IAED;;OAEG;IACH,SAFa,cAAc,CAI1B;IAgFL;;;;;OAKG;IACH,2BAFU,OAAO,CAEwB;CApBxC;;kBAUS,MAAM"}

package/src/engine/graphics/ecs/particles/ParticleEffect.js

@@ -3,6 +3,8 @@ import { float32_array_hash } from "../../../../core/collection/array/typed/floa
 import { is_typed_array_equals } from "../../../../core/collection/array/typed/is_typed_array_equals.js";
 import { hash_mix2 } from "../../../../core/math/hash/hash_mix2.js";
 import { hash_mix3 } from "../../../../core/math/hash/hash_mix3.js";
+import { optional_equality } from "../../../../core/model/object/optional_equality.js";
+import { optional_hash } from "../../../../core/model/object/optional_hash.js";
 import { computeHashFloat } from "../../../../core/primitives/numbers/computeHashFloat.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
 import {
@@ -278,8 +280,8 @@ export class ParticleEffect {
             && this.render_frame === other.render_frame
             && this.render_velocity === other.render_velocity
             && is_typed_array_equals(this.flipbook, other.flipbook)
-            && optional_equals(this.layout, other.layout)
-            && optional_equals(this.program, other.program);
+            && optional_equality(this.layout, other.layout)
+            && optional_equality(this.program, other.program);
     }
 
     /**
@@ -304,8 +306,8 @@ export class ParticleEffect {
             hash_mix2(bindings, float32_array_hash(this.flipbook, 0, this.flipbook.length)),
             appearance,
             hash_mix2(
-                this.layout === null ? 0 : this.layout.hash(),
-                this.program === null ? 0 : this.program.hash()
+                optional_hash(this.layout),
+                optional_hash(this.program)
             )
         );
     }
@@ -416,24 +418,6 @@ export class ParticleEffect {
     }
 }
 
-/**
- * Compare two things that are either both absent or both know how to compare themselves.
- *
- * A component with no effect is an ordinary state — it is what an entity has while its effect is
- * still being compiled — so `null` has to be a value here rather than a precondition.
- *
- * @param {{equals: function(*): boolean}|null} a
- * @param {{equals: function(*): boolean}|null} b
- * @returns {boolean}
- */
-function optional_equals(a, b) {
-    if (a === null || b === null) {
-        return a === b;
-    }
-
-    return a.equals(b);
-}
-
 /**
  * The name this component is written under, and looked up by when a save is read. A serialization
  * registry infers nothing from a class — see

package/src/shade/descriptor/binding/BindGroupLayoutDescriptor.js

@@ -3,7 +3,7 @@ import { combine_hash } from "../../../core/collection/array/combine_hash.js";
 import { computeHashArray } from "../../../core/collection/array/computeHashArray.js";
 import { isArrayEqual } from "../../../core/collection/array/isArrayEqual.js";
 import { invokeObjectHash } from "../../../core/model/object/invokeObjectHash.js";
-import { optional_clone } from "../util/optional_clone.js";
+import { optional_clone } from "../../../core/model/object/optional_clone.js";
 import { ObjectDescriptorBase } from "../ObjectDescriptorBase.js";
 import { BindGroupLayoutEntry } from "./BindGroupLayoutEntry.js";
 

package/src/shade/descriptor/binding/BindGroupLayoutEntry.js

@@ -1,8 +1,8 @@
 import { assert } from "../../../core/assert.js";
 import { combine_hash } from "../../../core/collection/array/combine_hash.js";
-import { optional_clone } from "../util/optional_clone.js";
-import { optional_equality } from "../util/optional_equality.js";
-import { optional_hash } from "../util/optional_hash.js";
+import { optional_clone } from "../../../core/model/object/optional_clone.js";
+import { optional_equality } from "../../../core/model/object/optional_equality.js";
+import { optional_hash } from "../../../core/model/object/optional_hash.js";
 import { BufferBindingLayout } from "./BufferBindingLayout.js";
 import { ExternalTextureBindingLayout } from "./ExternalTextureBindingLayout.js";
 import { SamplerBindingLayout } from "./SamplerBindingLayout.js";

package/src/shade/descriptor/pipeline/PipelineDescriptorBase.js

@@ -1,6 +1,6 @@
 import { assert } from "../../../core/assert.js";
 import { combine_hash } from "../../../core/collection/array/combine_hash.js";
-import { optional_clone } from "../util/optional_clone.js";
+import { optional_clone } from "../../../core/model/object/optional_clone.js";
 import { ObjectDescriptorBase } from "../ObjectDescriptorBase.js";
 import { PipelineLayoutDescriptor } from "./PipelineLayoutDescriptor.js";
 

package/src/shade/descriptor/pipeline/PipelineLayoutDescriptor.js

@@ -3,7 +3,7 @@ import { combine_hash } from "../../../core/collection/array/combine_hash.js";
 import { computeHashArray } from "../../../core/collection/array/computeHashArray.js";
 import { isArrayEqual } from "../../../core/collection/array/isArrayEqual.js";
 import { invokeObjectHash } from "../../../core/model/object/invokeObjectHash.js";
-import { optional_clone } from "../util/optional_clone.js";
+import { optional_clone } from "../../../core/model/object/optional_clone.js";
 import { BindGroupLayoutDescriptor } from "../binding/BindGroupLayoutDescriptor.js";
 import { ObjectDescriptorBase } from "../ObjectDescriptorBase.js";
 

package/src/shade/descriptor/pipeline/render/ColorTargetState.js

@@ -1,9 +1,9 @@
 import { assert } from "../../../../core/assert.js";
 import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
-import { optional_clone } from "../../util/optional_clone.js";
-import { optional_equality } from "../../util/optional_equality.js";
-import { optional_hash } from "../../util/optional_hash.js";
+import { optional_clone } from "../../../../core/model/object/optional_clone.js";
+import { optional_equality } from "../../../../core/model/object/optional_equality.js";
+import { optional_hash } from "../../../../core/model/object/optional_hash.js";
 import {
     gpu_texture_format_channel_bit_count
 } from "../../texture/format/gpu_texture_format_channel_bit_count.js";

package/src/shade/descriptor/pipeline/render/FragmentState.js

@@ -3,7 +3,7 @@ import { combine_hash } from "../../../../core/collection/array/combine_hash.js"
 import { computeHashArray } from "../../../../core/collection/array/computeHashArray.js";
 import { isArrayEqual } from "../../../../core/collection/array/isArrayEqual.js";
 import { invokeObjectHash } from "../../../../core/model/object/invokeObjectHash.js";
-import { optional_clone } from "../../util/optional_clone.js";
+import { optional_clone } from "../../../../core/model/object/optional_clone.js";
 import { ProgrammableStage } from "../ProgrammableStage.js";
 import { ColorTargetState } from "./ColorTargetState.js";
 

package/src/shade/descriptor/pipeline/render/RenderPipelineDescriptor.js

@@ -1,8 +1,8 @@
 import { assert } from "../../../../core/assert.js";
 import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
-import { optional_clone } from "../../util/optional_clone.js";
-import { optional_equality } from "../../util/optional_equality.js";
-import { optional_hash } from "../../util/optional_hash.js";
+import { optional_clone } from "../../../../core/model/object/optional_clone.js";
+import { optional_equality } from "../../../../core/model/object/optional_equality.js";
+import { optional_hash } from "../../../../core/model/object/optional_hash.js";
 import { PipelineDescriptorBase } from "../PipelineDescriptorBase.js";
 import { DepthStencilState } from "./DepthStencilState.js";
 import { FragmentState } from "./FragmentState.js";

package/src/shade/playground/particle_editor/README.md

@@ -82,7 +82,7 @@ edits it at both altitudes.
   curve, including peaks between keys. Its fields edit the selected key's time, value and tangents.
   The scale stays fixed during a drag and refits on release. Neither ramp is sampled from a table
   at runtime: both are written out into the program as arithmetic, which is what the **Code** tab
-  shows. `Curve Table`, which *is* the table, is the other node — it takes a row handle rather than a curve.
+  shows.
 - The strip along the bottom lists every problem with the effect, from **both** phases, loudest
   first. Click one to jump to the phase it is in and select the node; the node is outlined in the
   graph too.

package/src/shade/playground/particle_system/particle_prototype.d.ts

@@ -1,31 +1,29 @@
 /**
  * Worked examples of authoring particle effects with the node graph + placing them in a scene for a
  * {@link GPUParticleSystem} to run. Demonstrates: distinct per-particle lifecycle (no built-in age — the
- * effect declares it), AnimationCurve sampling over life, flipbook frames, random emission,
+ * effect declares it), authored curves over life, flipbook frames, random emission,
  * additive vs alpha blending, projection modes, soft depth and lighting toggles.
  *
  * These are examples, not engine code, which is why they sit here rather than under
  * `renderer/particles/`: the only thing that opens them is this playground's page, and keeping them
  * on this side of the line means the dependency runs playground -> renderer and never back.
  *
- * `curves` is a `GPUAnimationManager` (or anything with `register_curve(AnimationCurve) -> handle`);
- * `size_curve` / `alpha_curve` are meep `AnimationCurve`s. Both are optional — passing `undefined`
- * yields effects that use constant size/alpha instead (curve handle 0, evaluated as 0 by the
- * disabled provider), which is handy for the headless tests.
+ * `size_curve` / `alpha_curve` are authored curve parameters compiled into arithmetic. Both are
+ * optional; omitted curves leave the initial size/colour unchanged.
  */
 /**
  * A fire effect: buoyant, turbulent, additive-blended camera-facing sprites whose size and opacity
  * follow curves over their lifetime and whose flipbook advances with age.
  *
  * @param {object} [options]
- * @param {number} [options.size_curve] curve handle for size(normalizedAge)
- * @param {number} [options.alpha_curve] curve handle for alpha(normalizedAge)
+ * @param {import("../../renderer/particles/graph/particle_ramp.js").ParticleCurveParameter} [options.size_curve] size(normalizedAge)
+ * @param {import("../../renderer/particles/graph/particle_ramp.js").ParticleCurveParameter} [options.alpha_curve] alpha(normalizedAge)
  * @param {number} [options.flipbook_frames]
  * @returns {{layout: ParticleLayout, effect: object, emitter: object}}
  */
 export function fire_effect({ size_curve, alpha_curve, flipbook_frames }?: {
-    size_curve?: number;
-    alpha_curve?: number;
+    size_curve?: import("../../renderer/particles/graph/particle_ramp.js").ParticleCurveParameter;
+    alpha_curve?: import("../../renderer/particles/graph/particle_ramp.js").ParticleCurveParameter;
     flipbook_frames?: number;
 }): {
     layout: ParticleLayout;

package/src/shade/playground/particle_system/particle_prototype.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"particle_prototype.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/particle_system/particle_prototype.js"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AACH;IAL4B,UAAU,GAA3B,MAAM;IACW,WAAW,GAA5B,MAAM;IACW,eAAe,GAAhC,MAAM;;YACK,cAAc;YAAU,MAAM;aAAW,MAAM;EA+GpE;AAED;;;;GAIG;AACH;YAFsB,cAAc;YAAU,MAAM;aAAW,MAAM;EAYpE;AAED;;;;;;;;;;;;;GAaG;AACH,yCANW,OAAO,+BAA+B,EAAE,KAAK;IAEa,IAAI,GAA9D,OAAO,gCAAgC,EAAE,MAAM;;UAEtC,eAAe;WAAS,eAAe;EAe1D;+BAzL8B,mDAAmD;gCAElD,qDAAqD"}
+{"version":3,"file":"particle_prototype.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/particle_system/particle_prototype.js"],"names":[],"mappings":"AAYA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH;IALsG,UAAU,GAArG,OAAO,iDAAiD,EAAE,sBAAsB;IACW,WAAW,GAAtG,OAAO,iDAAiD,EAAE,sBAAsB;IAC/D,eAAe,GAAhC,MAAM;;YACK,cAAc;YAAU,MAAM;aAAW,MAAM;EA+GpE;AAED;;;;GAIG;AACH;YAFsB,cAAc;YAAU,MAAM;aAAW,MAAM;EAYpE;AAED;;;;;;;;;;;;;GAaG;AACH,yCANW,OAAO,+BAA+B,EAAE,KAAK;IAEa,IAAI,GAA9D,OAAO,gCAAgC,EAAE,MAAM;;UAEtC,eAAe;WAAS,eAAe;EAe1D;+BAvL8B,mDAAmD;gCAElD,qDAAqD"}

package/src/shade/playground/particle_system/particle_prototype.js

@@ -13,17 +13,15 @@ import { ParticleEmitter } from "../../renderer/particles/runtime/ParticleEmitte
 /**
  * Worked examples of authoring particle effects with the node graph + placing them in a scene for a
  * {@link GPUParticleSystem} to run. Demonstrates: distinct per-particle lifecycle (no built-in age — the
- * effect declares it), AnimationCurve sampling over life, flipbook frames, random emission,
+ * effect declares it), authored curves over life, flipbook frames, random emission,
  * additive vs alpha blending, projection modes, soft depth and lighting toggles.
  *
  * These are examples, not engine code, which is why they sit here rather than under
  * `renderer/particles/`: the only thing that opens them is this playground's page, and keeping them
  * on this side of the line means the dependency runs playground -> renderer and never back.
  *
- * `curves` is a `GPUAnimationManager` (or anything with `register_curve(AnimationCurve) -> handle`);
- * `size_curve` / `alpha_curve` are meep `AnimationCurve`s. Both are optional — passing `undefined`
- * yields effects that use constant size/alpha instead (curve handle 0, evaluated as 0 by the
- * disabled provider), which is handy for the headless tests.
+ * `size_curve` / `alpha_curve` are authored curve parameters compiled into arithmetic. Both are
+ * optional; omitted curves leave the initial size/colour unchanged.
  */
 
 /**
@@ -31,8 +29,8 @@ import { ParticleEmitter } from "../../renderer/particles/runtime/ParticleEmitte
  * follow curves over their lifetime and whose flipbook advances with age.
  *
  * @param {object} [options]
- * @param {number} [options.size_curve] curve handle for size(normalizedAge)
- * @param {number} [options.alpha_curve] curve handle for alpha(normalizedAge)
+ * @param {import("../../renderer/particles/graph/particle_ramp.js").ParticleCurveParameter} [options.size_curve] size(normalizedAge)
+ * @param {import("../../renderer/particles/graph/particle_ramp.js").ParticleCurveParameter} [options.alpha_curve] alpha(normalizedAge)
  * @param {number} [options.flipbook_frames]
  * @returns {{layout: ParticleLayout, effect: object, emitter: object}}
  */
@@ -111,12 +109,12 @@ export function fire_effect({ size_curve, alpha_curve, flipbook_frames = 16 } =
 
         // size + alpha from curves over life (or constants if no curve provided)
         if (size_curve !== undefined) {
-            const sc = particle_node(update, "curve", { handle: size_curve }); particle_wire(update, sc, "t", nAge);
+            const sc = particle_node(update, "curveLiteral", { curve: size_curve }); particle_wire(update, sc, "t", nAge);
             particle_wire(update, particle_node(update, "setAttribute", { name: "size" }), "value", sc);
         }
         const color = particle_node(update, "attribute", { name: "color" });
         if (alpha_curve !== undefined) {
-            const ac = particle_node(update, "curve", { handle: alpha_curve }); particle_wire(update, ac, "t", nAge);
+            const ac = particle_node(update, "curveLiteral", { curve: alpha_curve }); particle_wire(update, ac, "t", nAge);
             // color.rgb unchanged, color.a = ac : rebuild via select on a swizzle mask is overkill;
             // simplest: multiply color by (1,1,1,ac_normalized) — approximate by scaling alpha only.
             const alphaVec = particle_node(update, "mul");

package/src/shade/playground/ssr_motion/README.md

@@ -0,0 +1,22 @@
+# SSR cross camera playground
+
+Open `/src/shade/playground/ssr_motion/` on the engine's Vite development server.
+It shares the exact scene, camera lens, resolution and fixed exposure of
+`ssr_variance`: one metallic floor and an emissive cross card with two colored
+markers. Final-image TAA and raster jitter default off independently.
+
+Drag to orbit, right-drag to pan, wheel to zoom, or focus the canvas and use WASD.
+Floor roughness changes live from 0.01 to 1.00. Material changes clear history;
+ordinary camera movement does not. The lateral path uses the same motion-speed
+scale as `ssr_reprojection` (x = 2 sin(phase), phase rate = 0.7 × speed).
+Choose speed 2.0 to reproduce the faster lateral movement.
+
+Pause motion continues sampling at the current pose. Pause rendering freezes the
+image. Step frame submits one 1/60-second frame. SSR parallax, surface-only and
+no-history modes, spatial denoising, final TAA and jitter can be compared separately.
+
+Query controls: `?motion=lateral&speed=2&roughness=0.3`, `taa=on`, `jitter=on`,
+`spatial=off`, and `temporal=0|1|2`. `manual` starts at frame zero with rendering
+paused. `await ssr_motion_ready` exposes the renderer, camera, scene, `pose`,
+`frame`, and `step(n, advance=true)` for controlled experiments. `advance=false`
+keeps the current pose while sampling. Exact stepping requires rendering paused.