@woosh/meep-engine 3.44.0 → 3.46.0

package/src/engine/graphics/ecs/animation/animator/AnimationClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/animation/animator/AnimationClip.js"],"names":[],"mappings":"AAMA;IACI;;;OAGG;IACH,6BAAW;IAEX;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,OAFU,MAAM,GAAC,iBAAiB,CAExB;IAEV;;;;;;;;;;;;;;;;;;;OAmBG;IACH,8BALW,MAAM,sCAEN,MAAM,SACN,MAAM,QAoGhB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,SACxB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,OAAO,CAInB;IAGD;;;;OAIG;IACH,cAHW,aAAa,GACX,OAAO,CAYnB;IAED;;OAEG;IACH,QAFa,MAAM,CASlB;CACJ;kCAzNiC,wBAAwB"}
+{"version":3,"file":"AnimationClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/animation/animator/AnimationClip.js"],"names":[],"mappings":"AAOA;IACI;;;OAGG;IACH,6BAAW;IAEX;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,OAFU,MAAM,GAAC,iBAAiB,CAExB;IAEV;;;;;;;;;;;;;;;;;;;OAmBG;IACH,8BALW,MAAM,sCAEN,MAAM,SACN,MAAM,QAoGhB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,SACxB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,OAAO,CAInB;IAGD;;;;OAIG;IACH,cAHW,aAAa,GACX,OAAO,CAYnB;IAED;;OAEG;IACH,QAFa,MAAM,CAWlB;CACJ;kCA3NiC,wBAAwB"}

package/src/engine/graphics/ecs/animation/animator/AnimationClip.js

@@ -1,4 +1,5 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../../../core/math/hash/hash_mix3.js";
 import { min2 } from "../../../../../core/math/min2.js";
 import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
 import { AnimationClipFlag } from "./AnimationClipFlag.js";
@@ -211,10 +212,12 @@ export class AnimationClip {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
-            this.flags,
-            computeHashFloat(this.weight),
-            computeHashFloat(this.timeScale),
+        return hash_mix2(
+            hash_mix3(
+                this.flags,
+                computeHashFloat(this.weight),
+                computeHashFloat(this.timeScale)
+            ),
             this.def.hash()
         );
     }

package/src/engine/graphics/ecs/animation/animator/AnimationClipDefinition.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../../../core/math/hash/hash_mix3.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";
@@ -106,7 +106,7 @@ export class AnimationClipDefinition {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.name),
             computeHashArray(this.notifications, invokeObjectHash),
             computeHashArray(this.tags, computeStringHash)

package/src/engine/graphics/ecs/animation/animator/AnimationNotification.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
 import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
 
 export class AnimationNotification {
@@ -33,7 +33,7 @@ export class AnimationNotification {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
+        return hash_mix2(
             computeHashFloat(this.time),
             this.def.hash()
         );

package/src/engine/graphics/ecs/animation/animator/AnimationNotificationDefinition.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
 import { computeObjectHash } from "../../../../../core/math/hash/computeObjectHash.js";
 import { objectDeepEquals } from "../../../../../core/model/object/objectDeepEquals.js";
 import { computeStringHash } from "../../../../../core/primitives/strings/computeStringHash.js";
@@ -34,7 +34,7 @@ export class AnimationNotificationDefinition {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
+        return hash_mix2(
             computeStringHash(this.event),
             computeObjectHash(this.data)
         );

package/src/engine/graphics/ecs/animation/animator/graph/definition/AnimationGraphDefinition.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../../../../../core/math/hash/hash_mix3.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";
@@ -54,7 +54,7 @@ export class AnimationGraphDefinition {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
+        return hash_mix3(
             this.startingSate.hash(),
             computeHashArray(this.states, invokeObjectHash),
             computeHashArray(this.transitions, invokeObjectHash)

package/src/engine/graphics/ecs/animation/animator/graph/definition/AnimationStateDefinition.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../../../core/math/hash/hash_mix2.js";
 import { AnimationStateType } from "../AnimationStateType.js";
 
 export class AnimationStateDefinition {
@@ -82,7 +82,7 @@ export class AnimationStateDefinition {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
+        return hash_mix2(
             this.type,
             this.motion.hash()
         );

package/src/engine/graphics/ecs/animation/animator/graph/definition/AnimationTransitionDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationTransitionDefinition.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/engine/graphics/ecs/animation/animator/graph/definition/AnimationTransitionDefinition.js"],"names":[],"mappings":"AAIA;IACI;;;OAGG;IACH,OAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,UAFU,MAAM,CAED;IAEf;;;OAGG;IACH,iCAAc;IAEd;;;OAGG;IACH,iCAAc;IAEd;;;;OAIG;IACH,cAHW,6BAA6B,GAC3B,OAAO,CAYnB;IAED;;OAEG;IACH,QAFa,MAAM,CASlB;CACJ"}
+{"version":3,"file":"AnimationTransitionDefinition.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/engine/graphics/ecs/animation/animator/graph/definition/AnimationTransitionDefinition.js"],"names":[],"mappings":"AAKA;IACI;;;OAGG;IACH,OAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,UAFU,MAAM,CAED;IAEf;;;OAGG;IACH,iCAAc;IAEd;;;OAGG;IACH,iCAAc;IAEd;;;;OAIG;IACH,cAHW,6BAA6B,GAC3B,OAAO,CAYnB;IAED;;OAEG;IACH,QAFa,MAAM,CAWlB;CACJ"}

package/src/engine/graphics/ecs/animation/animator/graph/definition/AnimationTransitionDefinition.js

@@ -1,4 +1,5 @@
-import { combine_hash } from "../../../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../../../../../core/math/hash/hash_mix3.js";
 import { computeHashFloat } from "../../../../../../../core/primitives/numbers/computeHashFloat.js";
 import { computeStringHash } from "../../../../../../../core/primitives/strings/computeStringHash.js";
 
@@ -48,10 +49,12 @@ export class AnimationTransitionDefinition {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
-            computeStringHash(this.event),
-            computeHashFloat(this.duration),
-            this.source.hash(),
+        return hash_mix2(
+            hash_mix3(
+                computeStringHash(this.event),
+                computeHashFloat(this.duration),
+                this.source.hash()
+            ),
             this.target.hash()
         );
     }

package/src/engine/graphics/ecs/decal/v2/Decal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Decal.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/decal/v2/Decal.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;IAmGI,+BAMC;IAvGD;;;;;;;OAOG;IACH,KAFU,MAAM,CAEP;IAET;;;OAGG;IACH,YAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,YAFU,MAAM,CAEA;IAEhB;;;;;OAKG;IACH,SAFU,MAAM,CAEH;IAEb;;;;OAIG;IACH,cAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,OAFU,KAAK,CAEe;IAE9B;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,gBAFU,KAAK,CAEwB;IAEvC;;;;OAIG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,yBAAwB;IAExB;;;;OAIG;IACH,qBAAoB;IAEpB;;;;;;OAMG;IACH,yBAEC;IAUD;;;;;;;;;;;;MAcC;IAED;;;;;;;;;;;;aA+CC;IAED,eAkBC;IAED;;;;OAIG;IACH,cAHW,KAAK,GACH,OAAO,CAenB;CACJ;;;;sBAnPqB,oCAAoC"}
+{"version":3,"file":"Decal.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/decal/v2/Decal.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;IAmGI,+BAMC;IAvGD;;;;;;;OAOG;IACH,KAFU,MAAM,CAEP;IAET;;;OAGG;IACH,YAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,YAFU,MAAM,CAEA;IAEhB;;;;;OAKG;IACH,SAFU,MAAM,CAEH;IAEb;;;;OAIG;IACH,cAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,OAFU,KAAK,CAEe;IAE9B;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,gBAFU,KAAK,CAEwB;IAEvC;;;;OAIG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,yBAAwB;IAExB;;;;OAIG;IACH,qBAAoB;IAEpB;;;;;;OAMG;IACH,yBAEC;IAUD;;;;;;;;;;;;MAcC;IAED;;;;;;;;;;;;aA+CC;IAED,eAkBC;IAED;;;;OAIG;IACH,cAHW,KAAK,GACH,OAAO,CAenB;CACJ;;;;sBApPqB,oCAAoC"}

package/src/engine/graphics/ecs/decal/v2/Decal.js

@@ -2,7 +2,8 @@ import { Color } from "../../../../../core/color/Color.js";
 import { computeStringHash } from "../../../../../core/primitives/strings/computeStringHash.js";
 import { assert } from "../../../../../core/assert.js";
 import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../../../core/math/hash/hash_mix3.js";
 
 /**
  * A projected surface decal.
@@ -203,21 +204,21 @@ export class Decal {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.uri) ^ this.color.hash(),
-            combine_hash(
-                combine_hash(
+            hash_mix2(
+                hash_mix2(
                     computeStringHash(this.uri_albedo),
                     computeStringHash(this.uri_normal)
                 ),
-                combine_hash(
+                hash_mix2(
                     computeStringHash(this.uri_orm),
                     computeStringHash(this.uri_emissive)
                 )
             ),
-            combine_hash(
-                combine_hash(computeHashFloat(this.roughness), computeHashFloat(this.metalness)),
-                combine_hash(this.emissive_color.hash(), computeHashFloat(this.emissive_intensity))
+            hash_mix2(
+                hash_mix2(computeHashFloat(this.roughness), computeHashFloat(this.metalness)),
+                hash_mix2(this.emissive_color.hash(), computeHashFloat(this.emissive_intensity))
             )
         );
     }

package/src/engine/graphics/geometry/geometry_construct_triangle_normal_area_weighted.d.ts

@@ -17,6 +17,8 @@
  * to synthesise some arbitrary unit vector and hand it over as though it were a
  * measurement.
  *
+ * An indexed form of {@link tri3_compute_normal_area_weighted_array}, which holds the arithmetic.
+ *
  * Single-face callers — a raycast normal, a plane side test — want
  * {@link geometry_construct_triangle_normal} instead.
  *

package/src/engine/graphics/geometry/geometry_construct_triangle_normal_area_weighted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry_construct_triangle_normal_area_weighted.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/geometry/geometry_construct_triangle_normal_area_weighted.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,sEARW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,cAClC,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,aACN,MAAM,EAAE,GAAC,YAAY,GACnB,IAAI,CAwBhB"}
+{"version":3,"file":"geometry_construct_triangle_normal_area_weighted.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/geometry/geometry_construct_triangle_normal_area_weighted.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,sEARW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,cAClC,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,aACN,MAAM,EAAE,GAAC,YAAY,GACnB,IAAI,CAShB"}

package/src/engine/graphics/geometry/geometry_construct_triangle_normal_area_weighted.js

@@ -1,3 +1,5 @@
+import { tri3_compute_normal_area_weighted_array } from "../../../core/geom/3d/triangle/tri3_compute_normal_area_weighted_array.js";
+
 /**
  * The face normal of an indexed triangle, NOT normalised — the raw
  * `(c - b) × (a - b)`, whose magnitude is twice the triangle's area.
@@ -17,6 +19,8 @@
  * to synthesise some arbitrary unit vector and hand it over as though it were a
  * measurement.
  *
+ * An indexed form of {@link tri3_compute_normal_area_weighted_array}, which holds the arithmetic.
+ *
  * Single-face callers — a raycast normal, a plane side test — want
  * {@link geometry_construct_triangle_normal} instead.
  *
@@ -29,25 +33,10 @@
  * @returns {void}
  */
 export function geometry_construct_triangle_normal_area_weighted(out, out_offset, a, b, c, positions) {
-
-    const a_address = a * 3;
-    const b_address = b * 3;
-    const c_address = c * 3;
-
-    const bx = positions[b_address];
-    const by = positions[b_address + 1];
-    const bz = positions[b_address + 2];
-
-    const cb_x = positions[c_address] - bx;
-    const cb_y = positions[c_address + 1] - by;
-    const cb_z = positions[c_address + 2] - bz;
-
-    const ab_x = positions[a_address] - bx;
-    const ab_y = positions[a_address + 1] - by;
-    const ab_z = positions[a_address + 2] - bz;
-
-    // the same winding `tri3_compute_normal` uses, so the direction agrees
-    out[out_offset] = cb_y * ab_z - cb_z * ab_y;
-    out[out_offset + 1] = cb_z * ab_x - cb_x * ab_z;
-    out[out_offset + 2] = cb_x * ab_y - cb_y * ab_x;
+    tri3_compute_normal_area_weighted_array(
+        out, out_offset,
+        positions, a * 3,
+        positions, b * 3,
+        positions, c * 3
+    );
 }

package/src/engine/graphics/render/frame_graph/resource/TextureResourceDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureResourceDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/render/frame_graph/resource/TextureResourceDescriptor.js"],"names":[],"mappings":"AAMA;IAoEI;;;;;;kCAiBC;IAnFD;;;OAGG;IACH,QAFU,MAAM,CAEL;IACX;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,QAFU,cAAc,CAEM;IAE9B;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,eAFU,MAAM,CAE0B;IAe1C;;;;OAIG;IACH,cAHW,yBAAyB,GACvB,OAAO,CAkBnB;CAqBJ;mCAzFkC,yBAAyB;+BAH7B,mDAAmD"}
+{"version":3,"file":"TextureResourceDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/render/frame_graph/resource/TextureResourceDescriptor.js"],"names":[],"mappings":"AAOA;IAsEI;;;;;;kCAiBC;IArFD;;;OAGG;IACH,QAFU,MAAM,CAEL;IACX;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,QAFU,cAAc,CAEM;IAE9B;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,eAFU,MAAM,CAE0B;IAiB1C;;;;OAIG;IACH,cAHW,yBAAyB,GACvB,OAAO,CAkBnB;CAqBJ;mCA3FkC,yBAAyB;+BAJ7B,mDAAmD"}

package/src/engine/graphics/render/frame_graph/resource/TextureResourceDescriptor.js

@@ -1,5 +1,6 @@
 import { BinaryDataType } from "../../../../../core/binary/type/BinaryDataType.js";
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../../../core/primitives/strings/computeStringHash.js";
 import { ResourceDescriptor } from "./ResourceDescriptor.js";
 import { TextureInitialState } from "./TextureInitialState.js";
@@ -40,11 +41,13 @@ export class TextureResourceDescriptor extends ResourceDescriptor {
     }
 
     hash() {
-        return combine_hash(
-            this.width,
-            this.height,
-            computeStringHash(this.format),
-            this.channel_count,
+        return hash_mix2(
+            hash_mix3(
+                this.width,
+                this.height,
+                computeStringHash(this.format)
+            ),
+            this.channel_count
         )
     }
 

package/src/engine/graphics3/AnimationGraphSystem.d.ts

@@ -6,6 +6,10 @@
  * components, whoever put them there — a model `MeshSystem` loaded, or a rig built in code. New
  * clips are a new component, which this system sees as the entity leaving and coming back.
  *
+ * **Every node the clips key holds a row here** ({@link hold_clip_targets}), from the graph being
+ * bound to the clips until they go. A clip binds only once all of them do, and a keyed node outside
+ * every skin with nothing drawn under it — a socket, say — is held by no other system.
+ *
  * **It is the CPU that plays the animation and the GPU that draws it.** Shade can advance a clip
  * itself, and this never asks it to — `AnimationClipFlags.Playing` is left clear and every audible
  * clip's time is written down each frame from the controller's own clock. That is I-4: the pose
@@ -66,6 +70,7 @@ export class AnimationGraphSystem extends System<any> {
      * @param {number} entity
      */
     unlink(controller: AnimationGraphController, clips: AnimationClips, entity: number): void;
+    startup(entityManager: any): Promise<void>;
     shutdown(entityManager: any): Promise<void>;
     #private;
 }

package/src/engine/graphics3/AnimationGraphSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationGraphSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/AnimationGraphSystem.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAkBI;;;OAGG;IACH,oDAgBC;IAPG,0EAA8D;IAI9D,gFAEC;IAGL;;;;;;;;;OASG;IACH,iBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAchB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,6BANW,YAAY,EAAE,UACd,MAAM,GACJ,OAAO,CAgDnB;IAED;;;;OAIG;IACH,mBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAYhB;IAED,4CAQC;;CAkJJ;uBAzUsB,kBAAkB;yCAEA,yCAAyC;+BADnD,+BAA+B;4CAHlB,iDAAiD;6BAChE,qDAAqD"}
+{"version":3,"file":"AnimationGraphSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/AnimationGraphSystem.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAyBI;;;OAGG;IACH,oDAgBC;IAPG,0EAA8D;IAI9D,gFAEC;IAGL;;;;;;;;;OASG;IACH,iBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAehB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,6BANW,YAAY,EAAE,UACd,MAAM,GACJ,OAAO,CAgDnB;IAED;;;;OAIG;IACH,mBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAkBhB;IAED,2CAaC;IAED,4CAWC;;CA2JJ;uBAvXsB,kBAAkB;yCAEA,yCAAyC;+BADnD,+BAA+B;4CAHlB,iDAAiD;6BAChE,qDAAqD"}

package/src/engine/graphics3/AnimationGraphSystem.js

@@ -6,7 +6,8 @@ import { System } from "../ecs/System.js";
 import { AnimationClips } from "./animation/AnimationClips.js";
 import { AnimationGraphController } from "./animation/AnimationGraphController.js";
 import { write_graph_playback } from "./animation/write_graph_playback.js";
-import { register_clips, unregister_clips } from "./register_clips.js";
+import { hold_clip_targets, register_clips, release_clip_targets, unregister_clips } from "./register_clips.js";
+import { RowChains } from "./RowChains.js";
 
 /**
  * Drives every entity's {@link AnimationGraphController}: runs its clock, and tells the renderer
@@ -16,6 +17,10 @@ import { register_clips, unregister_clips } from "./register_clips.js";
  * components, whoever put them there — a model `MeshSystem` loaded, or a rig built in code. New
  * clips are a new component, which this system sees as the entity leaving and coming back.
  *
+ * **Every node the clips key holds a row here** ({@link hold_clip_targets}), from the graph being
+ * bound to the clips until they go. A clip binds only once all of them do, and a keyed node outside
+ * every skin with nothing drawn under it — a socket, say — is held by no other system.
+ *
  * **It is the CPU that plays the animation and the GPU that draws it.** Shade can advance a clip
  * itself, and this never asks it to — `AnimationClipFlags.Playing` is left clear and every audible
  * clip's time is written down each frame from the controller's own clock. That is I-4: the pose
@@ -41,10 +46,17 @@ export class AnimationGraphSystem extends System {
     #scene;
 
     /**
-     * @type {Map<number, {controller: AnimationGraphController, clips: ShadeAnimationClip[], bound: boolean, clip_registration: ClipRegistration|null, slots: Int32Array, played_slots: Int32Array, clip_ids: Int32Array, weights: Float32Array, poses: PosePlayback[]}>}
+     * @type {Map<number, {controller: AnimationGraphController, clips: ShadeAnimationClip[], bound: boolean, held: boolean, clip_registration: ClipRegistration|null, slots: Int32Array, played_slots: Int32Array, clip_ids: Int32Array, weights: Float32Array, poses: PosePlayback[]}>}
      */
     #entries = new Map();
 
+    /**
+     * The chains of the nodes the clips key. Null until the system has a dataset.
+     *
+     * @type {RowChains|null}
+     */
+    #chains = null;
+
     /**
      * @param {GraphicsEngine} graphics
      * @param {Scene} scene
@@ -82,6 +94,7 @@ export class AnimationGraphSystem extends System {
             controller,
             clips: clips.clips,
             bound: false,
+            held: false,
             clip_registration: null,
             slots: new Int32Array(0),
             played_slots: new Int32Array(0),
@@ -172,11 +185,32 @@ export class AnimationGraphSystem extends System {
 
         if (entry !== undefined) {
             this.#release_clips(entry);
+
+            if (entry.held) {
+                release_clip_targets(this.#chains, entry.clips);
+
+                entry.held = false;
+            }
         }
 
         this.#entries.delete(entity);
     }
 
+    async startup(entityManager) {
+        // the scene's rows are this dataset's entities; the first system to place one says so
+        const dataset = entityManager.dataset;
+        const scene = this.#scene;
+
+        assert.ok(
+            scene.dataset === null || scene.dataset === undefined || scene.dataset === dataset,
+            'the scene is bound to another dataset'
+        );
+
+        scene.dataset = dataset;
+
+        this.#chains = new RowChains(dataset);
+    }
+
     async shutdown(entityManager) {
         for (const entry of this.#entries.values()) {
             entry.controller.unlink();
@@ -185,6 +219,9 @@ export class AnimationGraphSystem extends System {
         }
 
         this.#entries.clear();
+
+        this.#chains.destroy();
+        this.#chains = null;
     }
 
     /**
@@ -223,6 +260,9 @@ export class AnimationGraphSystem extends System {
         // that fires an ability while the renderer is being replaced still fires it.
         const manager = context === null ? null : context.animation_manager;
 
+        // a new context after a restart is acquired in whole; until there is one, holds are recorded
+        this.#chains.bind(context === null ? null : context.rows);
+
         for (const [entity, entry] of this.#entries) {
             if (!entry.bound) {
                 this.#bind_clips(entry, entity, ecd);
@@ -302,6 +342,12 @@ export class AnimationGraphSystem extends System {
         entry.poses = clips.map(() => new PosePlayback());
 
         entry.bound = true;
+
+        // past the throw above, so a graph that cannot be bound holds nothing; and before anything
+        // registers, so the clips bind in the update that registers them
+        hold_clip_targets(this.#chains, clips);
+
+        entry.held = true;
     }
 
     /**

package/src/engine/graphics3/AnimationSystem.d.ts

@@ -11,6 +11,10 @@
  * components, whoever put them there — a model `MeshSystem` loaded, or a rig built in code. New
  * clips are a new component, which this system sees as the entity leaving and coming back.
  *
+ * **Every node the clips key holds a row here** ({@link hold_clip_targets}), from the clips being
+ * taken up until they go. A clip binds only once all of them do, and a keyed node outside every skin
+ * with nothing drawn under it is held by no other system.
+ *
  * **It is the CPU that plays the animation and the GPU that draws it.** Shade can advance a clip
  * itself, and this never asks it to — `AnimationClipFlags.Playing` is left clear and every audible
  * clip's time is written down each frame from the player's own clock. That is I-4: the pose
@@ -76,6 +80,7 @@ export class AnimationSystem extends System<any> {
      * @param {number} entity
      */
     unlink(component: Animation, clips: AnimationClips, entity: number): void;
+    startup(entityManager: any): Promise<void>;
     shutdown(entityManager: any): Promise<void>;
     #private;
 }

package/src/engine/graphics3/AnimationSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/AnimationSystem.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAkBI;;;OAGG;IACH,oDAgBC;IAPG,2DAA+C;IAI/C,iEAEC;IAGL;;;;;;;;OAQG;IACH,qBAHW,MAAM,GACJ,cAAc,CAU1B;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,6BANW,YAAY,EAAE,UACd,MAAM,GACJ,OAAO,CAyCnB;IAED;;;;;;;;OAQG;IACH,gBAJW,SAAS,SACT,cAAc,UACd,MAAM,QAYhB;IAED;;;;OAIG;IACH,kBAJW,SAAS,SACT,cAAc,UACd,MAAM,QAUhB;IAED,4CAMC;;CAsKJ;uBAxWsB,kBAAkB;0BADf,+BAA+B;+BAE1B,+BAA+B;4CAJlB,iDAAiD;6BAChE,qDAAqD"}
+{"version":3,"file":"AnimationSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/AnimationSystem.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAyBI;;;OAGG;IACH,oDAgBC;IAPG,2DAA+C;IAI/C,iEAEC;IAGL;;;;;;;;OAQG;IACH,qBAHW,MAAM,GACJ,cAAc,CAU1B;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,6BANW,YAAY,EAAE,UACd,MAAM,GACJ,OAAO,CAyCnB;IAED;;;;;;;;OAQG;IACH,gBAJW,SAAS,SACT,cAAc,UACd,MAAM,QAahB;IAED;;;;OAIG;IACH,kBAJW,SAAS,SACT,cAAc,UACd,MAAM,QAgBhB;IAED,2CAaC;IAED,4CASC;;CA8KJ;uBArZsB,kBAAkB;0BADf,+BAA+B;+BAE1B,+BAA+B;4CAJlB,iDAAiD;6BAChE,qDAAqD"}

package/src/engine/graphics3/AnimationSystem.js

@@ -7,7 +7,8 @@ import { System } from "../ecs/System.js";
 import { AnimationClips } from "./animation/AnimationClips.js";
 import { ClipListPlayer } from "./animation/ClipListPlayer.js";
 import { write_clip_playback } from "./animation/write_clip_playback.js";
-import { register_clips, unregister_clips } from "./register_clips.js";
+import { hold_clip_targets, register_clips, release_clip_targets, unregister_clips } from "./register_clips.js";
+import { RowChains } from "./RowChains.js";
 
 /**
  * @type {ClipPlayback[]}
@@ -27,6 +28,10 @@ const NOTHING = Object.freeze([]);
  * components, whoever put them there — a model `MeshSystem` loaded, or a rig built in code. New
  * clips are a new component, which this system sees as the entity leaving and coming back.
  *
+ * **Every node the clips key holds a row here** ({@link hold_clip_targets}), from the clips being
+ * taken up until they go. A clip binds only once all of them do, and a keyed node outside every skin
+ * with nothing drawn under it is held by no other system.
+ *
  * **It is the CPU that plays the animation and the GPU that draws it.** Shade can advance a clip
  * itself, and this never asks it to — `AnimationClipFlags.Playing` is left clear and every audible
  * clip's time is written down each frame from the player's own clock. That is I-4: the pose
@@ -51,10 +56,17 @@ export class AnimationSystem extends System {
     #scene;
 
     /**
-     * @type {Map<number, {player: ClipListPlayer, clips: ShadeAnimationClip[], bound: boolean, clip_registration: ClipRegistration|null, played_slots: Int32Array, written: Float32Array, poses: PosePlayback[]}>}
+     * @type {Map<number, {player: ClipListPlayer, clips: ShadeAnimationClip[], bound: boolean, held: boolean, clip_registration: ClipRegistration|null, played_slots: Int32Array, written: Float32Array, poses: PosePlayback[]}>}
      */
     #entries = new Map();
 
+    /**
+     * The chains of the nodes the clips key. Null until the system has a dataset.
+     *
+     * @type {RowChains|null}
+     */
+    #chains = null;
+
     /**
      * @param {GraphicsEngine} graphics
      * @param {Scene} scene
@@ -169,6 +181,7 @@ export class AnimationSystem extends System {
             player: ClipListPlayer.from(component),
             clips: clips.clips,
             bound: false,
+            held: false,
             clip_registration: null,
             played_slots: new Int32Array(0),
             written: new Float32Array(0),
@@ -186,17 +199,41 @@ export class AnimationSystem extends System {
 
         if (entry !== undefined) {
             this.#release_clips(entry);
+
+            if (entry.held) {
+                release_clip_targets(this.#chains, entry.clips);
+
+                entry.held = false;
+            }
         }
 
         this.#entries.delete(entity);
     }
 
+    async startup(entityManager) {
+        // the scene's rows are this dataset's entities; the first system to place one says so
+        const dataset = entityManager.dataset;
+        const scene = this.#scene;
+
+        assert.ok(
+            scene.dataset === null || scene.dataset === undefined || scene.dataset === dataset,
+            'the scene is bound to another dataset'
+        );
+
+        scene.dataset = dataset;
+
+        this.#chains = new RowChains(dataset);
+    }
+
     async shutdown(entityManager) {
         for (const entry of this.#entries.values()) {
             this.#release_clips(entry);
         }
 
         this.#entries.clear();
+
+        this.#chains.destroy();
+        this.#chains = null;
     }
 
     /**
@@ -328,6 +365,11 @@ export class AnimationSystem extends System {
         entry.poses = clips.map(() => new PosePlayback());
 
         entry.bound = true;
+
+        // before anything registers, so the clips bind in the update that registers them
+        hold_clip_targets(this.#chains, clips);
+
+        entry.held = true;
     }
 
     /**
@@ -342,6 +384,9 @@ export class AnimationSystem extends System {
         // that ends while the renderer is being replaced still says so.
         const manager = context === null ? null : context.animation_manager;
 
+        // a new context after a restart is acquired in whole; until there is one, holds are recorded
+        this.#chains.bind(context === null ? null : context.rows);
+
         for (const [entity, entry] of this.#entries) {
             if (!entry.bound) {
                 this.#bind(entry, entity, ecd);