@woosh/meep-engine 3.60.7 → 3.60.9

package/src/engine/graphics3/LightSystem.js

@@ -9,6 +9,10 @@ import { Light } from "../graphics/ecs/light/Light.js";
 import { LightType } from "../graphics/ecs/light/LightType.js";
 import { TRANSFORM64_EVENT_CHANGE } from "../ecs/transform/TRANSFORM64_EVENT_CHANGE.js";
 
+/**
+ * @typedef {import("../ecs/EntityComponentDataset.js").EntityComponentDataset} EntityComponentDataset
+ */
+
 /**
  * Mirrors light entities into Shade's scene.
  *
@@ -59,8 +63,20 @@ export class LightSystem extends System {
     async startup(entityManager) {
         this.entityManager = entityManager;
 
+        this.#graphics.set_scene(this.#scene);
+    }
+
+    async shutdown(entityManager) {
+        for (const entity of Array.from(this.#entries.keys())) {
+            this.#drop(entity);
+        }
+    }
+
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetAttached(dataset) {
         // 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(
@@ -69,13 +85,14 @@ export class LightSystem extends System {
         );
 
         scene.dataset = dataset;
-
-        this.#graphics.set_scene(scene);
     }
 
-    async shutdown(entityManager) {
-        for (const entity of Array.from(this.#entries.keys())) {
-            this.#drop(entity);
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetDetached(dataset) {
+        if (this.#scene.dataset === dataset) {
+            this.#scene.dataset = null;
         }
     }
 

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

@@ -31,7 +31,6 @@ export class MeshSkinSystem extends System<any> {
      * @returns {Scene}
      */
     get scene(): import("../../shade/renderer/scene/Scene.js").Scene;
-    startup(entityManager: any): Promise<void>;
     shutdown(entityManager: any): Promise<void>;
     /**
      * @param {MeshSkin} skin
@@ -48,6 +47,7 @@ export class MeshSkinSystem extends System<any> {
     #private;
 }
 export type GPUSceneContext = import("../../shade/renderer/scene/GPUSceneContext.js").GPUSceneContext;
+export type EntityComponentDataset = import("../ecs/EntityComponentDataset.js").EntityComponentDataset;
 export type GraphicsEngine = import("./GraphicsEngine.js").GraphicsEngine;
 export type Scene = import("../../shade/renderer/scene/Scene.js").Scene;
 import { System } from "../ecs/System.js";

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

@@ -1 +1 @@
-{"version":3,"file":"MeshSkinSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/MeshSkinSystem.js"],"names":[],"mappings":"AAmDA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IAsCI;;;OAGG;IACH,sBAHW,cAAc,SACd,KAAK,EAYf;IADG,0DAA8C;IAGlD;;OAEG;IACH,iEAEC;IAED,2CAeC;IAED,4CAUC;IAED;;;;OAIG;IACH,WAJW,QAAQ,YACR,cAAc,UACd,MAAM,QAehB;IAED;;;;OAIG;IACH,aAJW,QAAQ,YACR,cAAc,UACd,MAAM,QAIhB;;CA8HJ;8BApTY,OAAO,+CAA+C,EAAE,eAAe;6BACvE,OAAO,qBAAqB,EAAE,cAAc;oBAC5C,OAAO,qCAAqC,EAAE,KAAK;uBATzC,kBAAkB;+BAEV,2CAA2C;yBADjD,qCAAqC"}
+{"version":3,"file":"MeshSkinSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/MeshSkinSystem.js"],"names":[],"mappings":"AAoDA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IA8CI;;;OAGG;IACH,sBAHW,cAAc,SACd,KAAK,EAYf;IADG,0DAA8C;IAGlD;;OAEG;IACH,iEAEC;IAED,4CAEC;IA0DD;;;;OAIG;IACH,WAJW,QAAQ,YACR,cAAc,UACd,MAAM,QAehB;IAED;;;;OAIG;IACH,aAJW,QAAQ,YACR,cAAc,UACd,MAAM,QAIhB;;CAmIJ;8BAjWY,OAAO,+CAA+C,EAAE,eAAe;qCACvE,OAAO,kCAAkC,EAAE,sBAAsB;6BACjE,OAAO,qBAAqB,EAAE,cAAc;oBAC5C,OAAO,qCAAqC,EAAE,KAAK;uBAVzC,kBAAkB;+BAEV,2CAA2C;yBADjD,qCAAqC"}

package/src/engine/graphics3/MeshSkinSystem.js

@@ -7,6 +7,7 @@ import { RowChains } from "./RowChains.js";
 
 /**
  * @typedef {import("../../shade/renderer/scene/GPUSceneContext.js").GPUSceneContext} GPUSceneContext
+ * @typedef {import("../ecs/EntityComponentDataset.js").EntityComponentDataset} EntityComponentDataset
  * @typedef {import("./GraphicsEngine.js").GraphicsEngine} GraphicsEngine
  * @typedef {import("../../shade/renderer/scene/Scene.js").Scene} Scene
  */
@@ -103,7 +104,15 @@ export class MeshSkinSystem extends System {
     #unregistered = [];
 
     /**
-     * The joints' chains. Null until the system has a dataset.
+     * The dataset whose skins are deformed, from {@link handleDatasetAttached} to
+     * {@link handleDatasetDetached}. Null while none is attached.
+     *
+     * @type {EntityComponentDataset|null}
+     */
+    #dataset = null;
+
+    /**
+     * The joints' chains. Null while no dataset is attached.
      *
      * @type {RowChains|null}
      */
@@ -132,11 +141,17 @@ export class MeshSkinSystem extends System {
         return this.#scene;
     }
 
-    async startup(entityManager) {
-        this.entityManager = entityManager;
+    async shutdown(entityManager) {
+        this.#detach();
+    }
+
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetAttached(dataset) {
+        this.#detach();
 
         // 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(
@@ -146,10 +161,29 @@ export class MeshSkinSystem extends System {
 
         scene.dataset = dataset;
 
+        this.#dataset = dataset;
         this.#chains = new RowChains(dataset);
     }
 
-    async shutdown(entityManager) {
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetDetached(dataset) {
+        this.#detach();
+    }
+
+    /**
+     * Let go of the dataset: every skin's registration, the chains, and the scene's name for it. The
+     * next update binds whatever is attached next as a new context.
+     */
+    #detach() {
+        const dataset = this.#dataset;
+
+        if (dataset === null) {
+            return;
+        }
+
+        // the manager unlinks every entity before it detaches; anything left goes the same way
         for (const entity of Array.from(this.#entries.keys())) {
             this.#drop(entity);
         }
@@ -157,6 +191,12 @@ export class MeshSkinSystem extends System {
         this.#chains.destroy();
         this.#chains = null;
 
+        if (this.#scene.dataset === dataset) {
+            this.#scene.dataset = null;
+        }
+
+        this.#dataset = null;
+
         this.#context = null;
         this.#unregistered.length = 0;
     }
@@ -196,6 +236,11 @@ export class MeshSkinSystem extends System {
      * @param {number} time_delta_seconds
      */
     update(time_delta_seconds) {
+        if (this.#dataset === null) {
+            // nothing to deform
+            return;
+        }
+
         const context = this.#graphics.scene_context(this.#scene);
 
         if (context === null) {

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

@@ -86,6 +86,7 @@ export class MeshSystem extends System<any> {
     unlink(model: SGMesh, transform: Transform64, entity: number): void;
     #private;
 }
+export type EntityComponentDataset = import("../ecs/EntityComponentDataset.js").EntityComponentDataset;
 export type SceneBundle = import("../../shade/renderer/loader/SceneBundle.js").SceneBundle;
 export type Prefab = import("./prefab/Prefab.js").Prefab;
 export type PrefabInstance = import("./prefab/PrefabInstance.js").PrefabInstance;

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

@@ -1 +1 @@
-{"version":3,"file":"MeshSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/MeshSystem.js"],"names":[],"mappings":"AAiDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAmDI;;;;OAIG;IACH,sBAJW,cAAc,SACd,KAAK,eACI,MAAM,KAAG,QAAQ,WAAW,CAAC,EAchD;IADG,qDAAyC;IAG7C;;OAEG;IACH,mBAEC;IAED;;;;;;;;;;;;;;OAcG;IACH,oBAJW,MAAM,GACJ,cAAc,GAAC,IAAI,CAW/B;IAED;;;;;;;;OAQG;IACH,yBAJW,MAAM,GACJ,UAAU,CAWtB;IAED;;;;;;;;;;;;OAYG;IACH,6BALW,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,UACvC,MAAM,GACJ,OAAO,CAwCnB;IAED,2CAeC;IAED,4CAMC;IA8BD;;;;OAIG;IACH,YAJW,MAAM,aACN,WAAW,UACX,MAAM,QAkBhB;IAED;;;;OAIG;IACH,cAJW,MAAM,aACN,WAAW,UACX,MAAM,QAIhB;;CA8EJ;0BAvYY,OAAO,4CAA4C,EAAE,WAAW;qBAChE,OAAO,oBAAoB,EAAE,MAAM;6BACnC,OAAO,4BAA4B,EAAE,cAAc;6BACnD,OAAO,qBAAqB,EAAE,cAAc;uBAXlC,kBAAkB;4BACb,iCAAiC;uBAEtC,6CAA6C;sBAJ9C,qCAAqC"}
+{"version":3,"file":"MeshSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/MeshSystem.js"],"names":[],"mappings":"AAkDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAmDI;;;;OAIG;IACH,sBAJW,cAAc,SACd,KAAK,eACI,MAAM,KAAG,QAAQ,WAAW,CAAC,EAchD;IADG,qDAAyC;IAG7C;;OAEG;IACH,mBAEC;IAED;;;;;;;;;;;;;;OAcG;IACH,oBAJW,MAAM,GACJ,cAAc,GAAC,IAAI,CAW/B;IAED;;;;;;;;OAQG;IACH,yBAJW,MAAM,GACJ,UAAU,CAWtB;IAED;;;;;;;;;;;;OAYG;IACH,6BALW,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,UACvC,MAAM,GACJ,OAAO,CAwCnB;IAED,2CAIC;IAED,4CAMC;IAsDD;;;;OAIG;IACH,YAJW,MAAM,aACN,WAAW,UACX,MAAM,QAkBhB;IAED;;;;OAIG;IACH,cAJW,MAAM,aACN,WAAW,UACX,MAAM,QAIhB;;CA8EJ;qCArZY,OAAO,kCAAkC,EAAE,sBAAsB;0BACjE,OAAO,4CAA4C,EAAE,WAAW;qBAChE,OAAO,oBAAoB,EAAE,MAAM;6BACnC,OAAO,4BAA4B,EAAE,cAAc;6BACnD,OAAO,qBAAqB,EAAE,cAAc;uBAZlC,kBAAkB;4BACb,iCAAiC;uBAEtC,6CAA6C;sBAJ9C,qCAAqC"}

package/src/engine/graphics3/MeshSystem.js

@@ -10,6 +10,7 @@ import { prefab_compile } from "./prefab/prefab_compile.js";
 import { prefab_instance_destroy, prefab_instantiate } from "./prefab/prefab_instantiate.js";
 
 /**
+ * @typedef {import("../ecs/EntityComponentDataset.js").EntityComponentDataset} EntityComponentDataset
  * @typedef {import("../../shade/renderer/loader/SceneBundle.js").SceneBundle} SceneBundle
  * @typedef {import("./prefab/Prefab.js").Prefab} Prefab
  * @typedef {import("./prefab/PrefabInstance.js").PrefabInstance} PrefabInstance
@@ -243,8 +244,22 @@ export class MeshSystem extends System {
     async startup(entityManager) {
         this.entityManager = entityManager;
 
+        this.#graphics.set_scene(this.#scene);
+    }
+
+    async shutdown(entityManager) {
+        for (const entity of Array.from(this.#entries.keys())) {
+            this.#drop(entity);
+        }
+
+        this.#models.clear();
+    }
+
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetAttached(dataset) {
         // 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(
@@ -253,16 +268,15 @@ export class MeshSystem extends System {
         );
 
         scene.dataset = dataset;
-
-        this.#graphics.set_scene(scene);
     }
 
-    async shutdown(entityManager) {
-        for (const entity of Array.from(this.#entries.keys())) {
-            this.#drop(entity);
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetDetached(dataset) {
+        if (this.#scene.dataset === dataset) {
+            this.#scene.dataset = null;
         }
-
-        this.#models.clear();
     }
 
     /**

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

@@ -27,6 +27,10 @@
  * replaced, waits: {@link update} notices the scene's GPU context arriving or changing and attaches
  * everything it holds to it. Nothing about the entity is lost meanwhile — the component and the
  * transform are the truth, and the rows are written from them.
+ *
+ * **The primitives are the attached dataset's.** The system names the dataset to the scene when the
+ * entity manager attaches it, and lets go of it when it is detached; while none is attached there is
+ * nothing to place.
  */
 export class ShadedGeometrySystem extends System<any> {
     /**
@@ -39,7 +43,6 @@ export class ShadedGeometrySystem extends System<any> {
      * @returns {Scene}
      */
     get scene(): import("../../shade/renderer/scene/Scene.js").Scene;
-    startup(entityManager: any): Promise<void>;
     shutdown(entityManager: any): Promise<void>;
     /**
      * @param {ShadedGeometry} geometry
@@ -56,6 +59,7 @@ export class ShadedGeometrySystem extends System<any> {
     #private;
 }
 export type GPUSceneContext = import("../../shade/renderer/scene/GPUSceneContext.js").GPUSceneContext;
+export type EntityComponentDataset = import("../ecs/EntityComponentDataset.js").EntityComponentDataset;
 export type GraphicsEngine = import("./GraphicsEngine.js").GraphicsEngine;
 export type Scene = import("../../shade/renderer/scene/Scene.js").Scene;
 import { System } from "../ecs/System.js";

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

@@ -1 +1 @@
-{"version":3,"file":"ShadedGeometrySystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/ShadedGeometrySystem.js"],"names":[],"mappings":"AAgDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH;IAwCI;;;OAGG;IACH,sBAHW,cAAc,SACd,KAAK,EAYf;IADG,6DAAiD;IAGrD;;OAEG;IACH,iEAEC;IAED,2CAeC;IAED,4CAUC;IA4CD;;;;OAIG;IACH,eAJW,cAAc,aACd,WAAW,UACX,MAAM,QAgDhB;IAED;;;;OAIG;IACH,iBAJW,cAAc,aACd,WAAW,UACX,MAAM,QAOhB;;CAuDJ;8BAhUY,OAAO,+CAA+C,EAAE,eAAe;6BACvE,OAAO,qBAAqB,EAAE,cAAc;oBAC5C,OAAO,qCAAqC,EAAE,KAAK;uBAXzC,kBAAkB;4BACb,iCAAiC;+BAG9B,2CAA2C"}
+{"version":3,"file":"ShadedGeometrySystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/ShadedGeometrySystem.js"],"names":[],"mappings":"AAiDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH;IAgDI;;;OAGG;IACH,sBAHW,cAAc,SACd,KAAK,EAYf;IADG,6DAAiD;IAGrD;;OAEG;IACH,iEAEC;IAED,4CAEC;IAyGD;;;;OAIG;IACH,eAJW,cAAc,aACd,WAAW,UACX,MAAM,QAgDhB;IAED;;;;OAIG;IACH,iBAJW,cAAc,aACd,WAAW,UACX,MAAM,QAOhB;;CAuDJ;8BAjXY,OAAO,+CAA+C,EAAE,eAAe;qCACvE,OAAO,kCAAkC,EAAE,sBAAsB;6BACjE,OAAO,qBAAqB,EAAE,cAAc;oBAC5C,OAAO,qCAAqC,EAAE,KAAK;uBAZzC,kBAAkB;4BACb,iCAAiC;+BAG9B,2CAA2C"}

package/src/engine/graphics3/ShadedGeometrySystem.js

@@ -9,6 +9,7 @@ import { RowChains } from "./RowChains.js";
 
 /**
  * @typedef {import("../../shade/renderer/scene/GPUSceneContext.js").GPUSceneContext} GPUSceneContext
+ * @typedef {import("../ecs/EntityComponentDataset.js").EntityComponentDataset} EntityComponentDataset
  * @typedef {import("./GraphicsEngine.js").GraphicsEngine} GraphicsEngine
  * @typedef {import("../../shade/renderer/scene/Scene.js").Scene} Scene
  */
@@ -75,6 +76,10 @@ class Entry {
  * replaced, waits: {@link update} notices the scene's GPU context arriving or changing and attaches
  * everything it holds to it. Nothing about the entity is lost meanwhile — the component and the
  * transform are the truth, and the rows are written from them.
+ *
+ * **The primitives are the attached dataset's.** The system names the dataset to the scene when the
+ * entity manager attaches it, and lets go of it when it is detached; while none is attached there is
+ * nothing to place.
  */
 export class ShadedGeometrySystem extends System {
     /**
@@ -108,9 +113,17 @@ export class ShadedGeometrySystem extends System {
      */
     #unattached = [];
 
+    /**
+     * The dataset whose primitives are placed, from {@link handleDatasetAttached} to
+     * {@link handleDatasetDetached}. Null while none is attached.
+     *
+     * @type {EntityComponentDataset|null}
+     */
+    #dataset = null;
+
     /**
      * Each primitive's chain: its own row and the rows of the entities above it, followed as they
-     * move. Null until the system has a dataset.
+     * move. Null while no dataset is attached.
      *
      * @type {RowChains|null}
      */
@@ -139,11 +152,17 @@ export class ShadedGeometrySystem extends System {
         return this.#scene;
     }
 
-    async startup(entityManager) {
-        this.entityManager = entityManager;
+    async shutdown(entityManager) {
+        this.#detach();
+    }
+
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetAttached(dataset) {
+        this.#detach();
 
         // 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(
@@ -153,10 +172,29 @@ export class ShadedGeometrySystem extends System {
 
         scene.dataset = dataset;
 
+        this.#dataset = dataset;
         this.#chains = new RowChains(dataset);
     }
 
-    async shutdown(entityManager) {
+    /**
+     * @param {EntityComponentDataset} dataset
+     */
+    handleDatasetDetached(dataset) {
+        this.#detach();
+    }
+
+    /**
+     * Let go of the dataset: every primitive's rows, the chains, and the scene's name for it. The
+     * next update binds whatever is attached next as a new context.
+     */
+    #detach() {
+        const dataset = this.#dataset;
+
+        if (dataset === null) {
+            return;
+        }
+
+        // the manager unlinks every entity before it detaches; anything left goes the same way
         for (const entity of Array.from(this.#entries.keys())) {
             this.#drop(entity);
         }
@@ -164,6 +202,12 @@ export class ShadedGeometrySystem extends System {
         this.#chains.destroy();
         this.#chains = null;
 
+        if (this.#scene.dataset === dataset) {
+            this.#scene.dataset = null;
+        }
+
+        this.#dataset = null;
+
         this.#context = null;
         this.#unattached.length = 0;
     }
@@ -174,6 +218,11 @@ export class ShadedGeometrySystem extends System {
      * @param {number} time_delta_seconds
      */
     update(time_delta_seconds) {
+        if (this.#dataset === null) {
+            // nothing to place
+            return;
+        }
+
         const context = this.#graphics.scene_context(this.#scene);
 
         if (context === null) {
@@ -245,7 +294,7 @@ export class ShadedGeometrySystem extends System {
             }
         };
 
-        const dataset = this.entityManager.dataset;
+        const dataset = this.#dataset;
 
         dataset.addEntityEventListener(entity, TRANSFORM64_EVENT_CHANGE, entry.on_world_changed);
         dataset.addEntityEventListener(entity, SHADED_GEOMETRY_EVENT_CHANGE, entry.on_changed);
@@ -307,7 +356,7 @@ export class ShadedGeometrySystem extends System {
 
         this.#entries.delete(entity);
 
-        const dataset = this.entityManager.dataset;
+        const dataset = this.#dataset;
 
         dataset.removeEntityEventListener(entity, TRANSFORM64_EVENT_CHANGE, entry.on_world_changed);
         dataset.removeEntityEventListener(entity, SHADED_GEOMETRY_EVENT_CHANGE, entry.on_changed);

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

@@ -63,6 +63,9 @@ export class WaterSystem extends System<any> {
     get queries(): GPUWaterQueries;
     startup(entityManager: any): Promise<void>;
     shutdown(): Promise<void>;
+    /** The scene's rows are this dataset's entities; the first system to place one says so. */
+    handleDatasetAttached(dataset: any): void;
+    handleDatasetDetached(dataset: any): void;
     link(water: any, geometry: any, transform: any, entity: any): void;
     unlink(water: any, geometry: any, transform: any, entity: any): void;
     update(dt: any): void;

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

@@ -1 +1 @@
-{"version":3,"file":"WaterSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/WaterSystem.js"],"names":[],"mappings":"AAqDA;;;;;;;;;;;;;;;GAeG;AACH;IAEI;;;;OAIG;IACH,iCAFW,OAAO,gDAAgD,EAAE,eAAe,QAIlF;IAqGD,uCAYC;IA/GD,6EAAqD;IACrD,4HAEkF;IA4DlF;;;;;;;;;;;MAAkD;IAClD,6BAAmC;IACnC,6CAAqD;IACrD,iBAAmC;IACnC,qCAA8D;IAE9D,0BAGC;IAJD,mBAAiC;IAMjC;;;;;;;;;;OAUG;IACH,yBAEC;IAED;;;;;OAKG;IACH,+BAEC;IAgBD,2CAOC;IAED,0BAOC;IAED,mEAsBC;IAQD,qEAiBC;IAED,sBA+BC;IA0ED;;;;OAIG;IACH,qEAUC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,sBARW,MAAM,YACN,UAAU,MAAM,CAAC,SACjB,MAAM,aACN,MAAM,UACN,YAAY,iBACZ,MAAM,GACJ,MAAM,CA+ClB;IAED;;;;;;;;;;;;;OAaG;IACH,sBARW,MAAM,aACN,UAAU,MAAM,CAAC,SACjB,MAAM,aACN,MAAM,UACN,YAAY,iBACZ,MAAM,GACJ,MAAM,CAgClB;IAuND,iCAQC;IACD,yBAGC;;CACJ;AAED;IAEI,yBAAsD;IAAvB,YAAoB;IACnD,yBAA4C;CAC/C;AACD;IAEI,yBAAsD;IAAvB,YAAoB;IACnD,yBAAoD;CACvD;uBAvtBsB,kBAAkB;4BAEb,iCAAiC;gCAI7B,kDAAkD;kBARhE,gCAAgC;uBACe,qCAAqC;4CAS1D,iDAAiD;kCAY3D,2CAA2C;gCAT7C,uDAAuD;iCAFtD,gDAAgD;gCACtB,qDAAqD;gCAGhF,mDAAmD"}
+{"version":3,"file":"WaterSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/WaterSystem.js"],"names":[],"mappings":"AAqDA;;;;;;;;;;;;;;;GAeG;AACH;IAEI;;;;OAIG;IACH,iCAFW,OAAO,gDAAgD,EAAE,eAAe,QAIlF;IAqGD,uCAYC;IA/GD,6EAAqD;IACrD,4HAEkF;IA4DlF;;;;;;;;;;;MAAkD;IAClD,6BAAmC;IACnC,6CAAqD;IACrD,iBAAmC;IACnC,qCAA8D;IAE9D,0BAGC;IAJD,mBAAiC;IAMjC;;;;;;;;;;OAUG;IACH,yBAEC;IAED;;;;;OAKG;IACH,+BAEC;IAgBD,2CAKC;IAED,0BAOC;IAED,2FAA2F;IAC3F,0CAGC;IAED,0CAEC;IAED,mEAsBC;IAQD,qEAiBC;IAED,sBA+BC;IA0ED;;;;OAIG;IACH,qEAUC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,sBARW,MAAM,YACN,UAAU,MAAM,CAAC,SACjB,MAAM,aACN,MAAM,UACN,YAAY,iBACZ,MAAM,GACJ,MAAM,CA+ClB;IAED;;;;;;;;;;;;;OAaG;IACH,sBARW,MAAM,aACN,UAAU,MAAM,CAAC,SACjB,MAAM,aACN,MAAM,UACN,YAAY,iBACZ,MAAM,GACJ,MAAM,CAgClB;IAuND,iCAQC;IACD,yBAGC;;CACJ;AAED;IAEI,yBAAsD;IAAvB,YAAoB;IACnD,yBAA4C;CAC/C;AACD;IAEI,yBAAsD;IAAvB,YAAoB;IACnD,yBAAoD;CACvD;uBA/tBsB,kBAAkB;4BAEb,iCAAiC;gCAI7B,kDAAkD;kBARhE,gCAAgC;uBACe,qCAAqC;4CAS1D,iDAAiD;kCAY3D,2CAA2C;gCAT7C,uDAAuD;iCAFtD,gDAAgD;gCACtB,qDAAqD;gCAGhF,mDAAmD"}

package/src/engine/graphics3/WaterSystem.js

@@ -193,8 +193,6 @@ export class WaterSystem extends System {
 
     async startup(entityManager) {
         this.entityManager = entityManager;
-        assert.ok(this.#scene.dataset == null || this.#scene.dataset === entityManager.dataset, 'scene belongs to another dataset');
-        this.#scene.dataset = entityManager.dataset;
         this.#graphics.add_transparency_channel(this.#renderer);
         this.#extensions = [this.#graphics.add_extension(new WaterExtension(this)),
             this.#graphics.add_extension(new WaterSurfaceExtension(this))];
@@ -209,6 +207,16 @@ export class WaterSystem extends System {
         this.#renderer.dispose(); this.#waves.dispose(); this.#context = null;
     }
 
+    /** The scene's rows are this dataset's entities; the first system to place one says so. */
+    handleDatasetAttached(dataset) {
+        assert.ok(this.#scene.dataset == null || this.#scene.dataset === dataset, 'scene belongs to another dataset');
+        this.#scene.dataset = dataset;
+    }
+
+    handleDatasetDetached(dataset) {
+        if (this.#scene.dataset === dataset) { this.#scene.dataset = null; }
+    }
+
     link(water, geometry, transform, entity) {
         // queue: splashes not yet staged, four numbers each (local x, z, radius, kick); staged: the batch on the
         // GPU row until a submitted frame spends it

package/src/engine/graphics3/animation/AnimationClipsSink.d.ts

@@ -27,22 +27,30 @@ export class AnimationClipsSink {
      */
     constructor(graphics: GraphicsEngine, scene: Scene);
     /**
-     * Bind the scene to the dataset and start tracking row chains for keyed nodes.
+     * Whether the driver has a dataset attached.
+     *
+     * @returns {boolean}
+     */
+    get attached(): boolean;
+    /**
+     * Bind the scene to the dataset the driver was attached to, and start tracking row chains for
+     * keyed nodes.
      *
      * @param {EntityComponentDataset} dataset
      */
-    startup(dataset: EntityComponentDataset): void;
+    attach_dataset(dataset: EntityComponentDataset): void;
     /**
-     * Release the GPU registration and playback state of one {@link AnimationClips} during system
-     * shutdown, leaving row-chain teardown to {@link shutdown}.
+     * Release the GPU registration and playback state of one {@link AnimationClips} as the dataset
+     * goes, leaving row-chain teardown to {@link detach_dataset}.
      *
      * @param {AnimationClips} clips
      */
-    unbind_on_shutdown(clips: AnimationClips): void;
+    unbind_on_detach(clips: AnimationClips): void;
     /**
-     * Tear down the row chains on system shutdown.
+     * Tear down the row chains and the scene's name for the dataset, as the driver's dataset is
+     * detached. Nothing happens while none is attached.
      */
-    shutdown(): void;
+    detach_dataset(): void;
     /**
      * Bind the row chains to the current GPU context's rows and answer that context.
      *

package/src/engine/graphics3/animation/AnimationClipsSink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationClipsSink.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/animation/AnimationClipsSink.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;GAcG;AACH;IAoBI;;;OAGG;IACH,sBAHW,cAAc,SACd,KAAK,EAQf;IAED;;;;OAIG;IACH,iBAFW,sBAAsB,QAchC;IAED;;;;;OAKG;IACH,0BAFW,cAAc,QAMxB;IAED;;OAEG;IACH,iBAGC;IAED;;;;;;;OAOG;IACH,gBAFa,eAAe,GAAC,IAAI,CAShC;IAED;;;;;;;;OAQG;IACH,YAFW,cAAc,QAUxB;IAED;;;;;;OAMG;IACH,eAFW,cAAc,QAYxB;IAED;;;;;;;OAOG;IACH,YAJW,cAAc,WACd,eAAe,GAAC,IAAI,iBACpB,OAAO,QAmBjB;;CAyBJ;qCAtMY,OAAO,qCAAqC,EAAE,sBAAsB;8BACpE,OAAO,kDAAkD,EAAE,eAAe;oBAC1E,OAAO,wCAAwC,EAAE,KAAK;6BACtD,OAAO,sBAAsB,EAAE,cAAc;6BAC7C,OAAO,qBAAqB,EAAE,cAAc"}
+{"version":3,"file":"AnimationClipsSink.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/animation/AnimationClipsSink.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;GAcG;AACH;IA4BI;;;OAGG;IACH,sBAHW,cAAc,SACd,KAAK,EAQf;IAED;;;;OAIG;IACH,wBAEC;IAED;;;;;OAKG;IACH,wBAFW,sBAAsB,QAiBhC;IAED;;;;;OAKG;IACH,wBAFW,cAAc,QAMxB;IAED;;;OAGG;IACH,uBAeC;IAED;;;;;;;OAOG;IACH,gBAFa,eAAe,GAAC,IAAI,CAShC;IAED;;;;;;;;OAQG;IACH,YAFW,cAAc,QAUxB;IAED;;;;;;OAMG;IACH,eAFW,cAAc,QAYxB;IAED;;;;;;;OAOG;IACH,YAJW,cAAc,WACd,eAAe,GAAC,IAAI,iBACpB,OAAO,QAmBjB;;CAyBJ;qCAxOY,OAAO,qCAAqC,EAAE,sBAAsB;8BACpE,OAAO,kDAAkD,EAAE,eAAe;oBAC1E,OAAO,wCAAwC,EAAE,KAAK;6BACtD,OAAO,sBAAsB,EAAE,cAAc;6BAC7C,OAAO,qBAAqB,EAAE,cAAc"}

package/src/engine/graphics3/animation/AnimationClipsSink.js

@@ -40,7 +40,15 @@ export class AnimationClipsSink {
     #scene;
 
     /**
-     * The chains of the nodes the clips key. Null until the driver has a dataset.
+     * The driver's dataset, from {@link attach_dataset} to {@link detach_dataset}. Null while none
+     * is attached.
+     *
+     * @type {EntityComponentDataset|null}
+     */
+    #dataset = null;
+
+    /**
+     * The chains of the nodes the clips key. Null while no dataset is attached.
      *
      * @type {RowChains|null}
      */
@@ -59,11 +67,23 @@ export class AnimationClipsSink {
     }
 
     /**
-     * Bind the scene to the dataset and start tracking row chains for keyed nodes.
+     * Whether the driver has a dataset attached.
+     *
+     * @returns {boolean}
+     */
+    get attached() {
+        return this.#dataset !== null;
+    }
+
+    /**
+     * Bind the scene to the dataset the driver was attached to, and start tracking row chains for
+     * keyed nodes.
      *
      * @param {EntityComponentDataset} dataset
      */
-    startup(dataset) {
+    attach_dataset(dataset) {
+        this.detach_dataset();
+
         // the scene's rows are this dataset's entities; the first system to place one says so
         const scene = this.#scene;
 
@@ -74,27 +94,41 @@ export class AnimationClipsSink {
 
         scene.dataset = dataset;
 
+        this.#dataset = dataset;
         this.#chains = new RowChains(dataset);
     }
 
     /**
-     * Release the GPU registration and playback state of one {@link AnimationClips} during system
-     * shutdown, leaving row-chain teardown to {@link shutdown}.
+     * Release the GPU registration and playback state of one {@link AnimationClips} as the dataset
+     * goes, leaving row-chain teardown to {@link detach_dataset}.
      *
      * @param {AnimationClips} clips
      */
-    unbind_on_shutdown(clips) {
+    unbind_on_detach(clips) {
         this.#release_registration(clips);
 
         clips.unbind();
     }
 
     /**
-     * Tear down the row chains on system shutdown.
+     * Tear down the row chains and the scene's name for the dataset, as the driver's dataset is
+     * detached. Nothing happens while none is attached.
      */
-    shutdown() {
+    detach_dataset() {
+        const dataset = this.#dataset;
+
+        if (dataset === null) {
+            return;
+        }
+
         this.#chains.destroy();
         this.#chains = null;
+
+        if (this.#scene.dataset === dataset) {
+            this.#scene.dataset = null;
+        }
+
+        this.#dataset = null;
     }
 
     /**

package/src/engine/network/state/ReplicationSlotTable.d.ts

@@ -10,8 +10,9 @@
  * match the live `(network_id=5, generation=3)` slot, so use-after-free can
  * be detected at parse time on the receiving peer.
  *
- * Storage is two parallel typed arrays indexed by `network_id`, plus a small
- * free-list of reusable IDs. No JS object per slot.
+ * Storage is three parallel typed arrays indexed by `network_id` (entity,
+ * generation, index in the free list), plus a free-list of reusable IDs.
+ * No JS object per slot.
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026
@@ -33,8 +34,10 @@ export class ReplicationSlotTable {
     allocate(entity_id: number): number;
     /**
      * Allocate using an explicit network_id (for the receiving peer that takes its
-     * IDs from the wire). Bumps the slot's generation if it was reused. Throws
-     * if the slot is currently in use.
+     * IDs from the wire). The id may be one this peer freed and the sender has
+     * since recycled; it is taken off the free list, so {@link allocate} will not
+     * hand it out. The slot keeps the generation {@link free} gave it. Throws if
+     * the slot is currently in use.
      *
      * @param {number} network_id
      * @param {number} entity_id
@@ -42,7 +45,8 @@ export class ReplicationSlotTable {
     allocate_at(network_id: number, entity_id: number): void;
     /**
      * Free the slot for `network_id`. Bumps the slot's generation. Slot becomes
-     * available for re-allocation.
+     * available for re-allocation. Freeing a slot that is not in use, including
+     * one past the table's storage, does nothing.
      *
      * @param {number} network_id
      */

package/src/engine/network/state/ReplicationSlotTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReplicationSlotTable.d.ts","sourceRoot":"","sources":["../../../../../src/engine/network/state/ReplicationSlotTable.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH;IAkBI;;OAEG;IACH,mCAFW;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,EA8BvC;IAED;;;;;;OAMG;IACH,oBAHW,MAAM,GACJ,MAAM,CAqBlB;IAED;;;;;;;OAOG;IACH,wBAHW,MAAM,aACN,MAAM,QAoBhB;IAED;;;;;OAKG;IACH,iBAFW,MAAM,QAYhB;IAED;;;;;OAKG;IACH,uBAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;;;OAKG;IACH,uBAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;;;OAKG;IACH,0BAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;OAGG;IACH,cAFa,MAAM,CAIlB;;CAkBJ"}
+{"version":3,"file":"ReplicationSlotTable.d.ts","sourceRoot":"","sources":["../../../../../src/engine/network/state/ReplicationSlotTable.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAmBI;;OAEG;IACH,mCAFW;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,EAqCvC;IAED;;;;;;OAMG;IACH,oBAHW,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;;OASG;IACH,wBAHW,MAAM,aACN,MAAM,QA2BhB;IAED;;;;;;OAMG;IACH,iBAFW,MAAM,QAgBhB;IAED;;;;;OAKG;IACH,uBAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;;;OAKG;IACH,uBAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;;;OAKG;IACH,0BAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;OAGG;IACH,cAFa,MAAM,CAIlB;;CAsBJ"}