@woosh/meep-engine 2.84.4 → 2.84.5

package/build/meep.module.js

@@ -72502,6 +72502,7 @@ class Entity {
      * @returns {*|null}
      */
     removeComponent(klass) {
+
         const elements = this.components;
         const n = elements.length;
 
@@ -72627,6 +72628,7 @@ class Entity {
             dataset.removeEntity(entity);
 
             this.id = -1;
+            this.generation = -1;
 
             this.clearFlag(EntityFlags.Built);
 
@@ -72652,6 +72654,7 @@ class Entity {
         }
 
         const entity = this.id = dataset.createEntity();
+        this.generation = dataset.getEntityGeneration(entity);
         this.dataset = dataset;
 
         let i;
@@ -72709,6 +72712,7 @@ class Entity {
         r.setFlag(EntityFlags.Built);
         r.id = entity;
         r.dataset = dataset;
+        r.generation = dataset.getEntityGeneration(entity);
 
         return r;
     }
@@ -84050,7 +84054,13 @@ class AssetDescription {
     toString() {
         return `{ type: '${this.type}', path: '${this.path}' }`;
     }
-}
+}
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+AssetDescription.prototype.isAssetDescription = true;
 
 /**
  * @enum {number}
@@ -92360,6 +92370,15 @@ class EntityComponentDataset {
      * @type {BitSet}
      */
     entityOccupancy = new BitSet();
+
+    /**
+     * For each entity ID records generation when entity was created
+     * Values are invalid for unused entity IDs
+     * @private
+     * @type {Uint32Array}
+     */
+    entityGeneration = new Uint32Array(0);
+
     /**
      * @private
      * @type {BitSet}
@@ -92411,7 +92430,7 @@ class EntityComponentDataset {
 
     /**
      * @readonly
-     * @type {Signal}
+     * @type {Signal<number>}
      */
     onEntityCreated = new Signal();
 
@@ -92961,38 +92980,79 @@ class EntityComponentDataset {
 
     /**
      *
-     * @returns {number} entityIndex
+     * @param {number} min_size
      */
-    createEntity() {
-        const entityIndex = this.entityOccupancy.nextClearBit(0);
-        this.entityOccupancy.set(entityIndex, true);
+    enlargeGenerationTable(min_size) {
+        const old_generation_table_size = this.entityGeneration.length;
 
-        this.entityCount++;
+        const new_size = max3(
+            min_size,
+            Math.ceil(old_generation_table_size * 1.2),
+            old_generation_table_size + 16
+        );
 
-        this.onEntityCreated.send1(entityIndex);
+        const new_generation_table = new Uint32Array(new_size);
 
-        this.generation++;
+        new_generation_table.set(this.entityGeneration);
 
-        return entityIndex;
+        this.entityGeneration = new_generation_table;
     }
 
     /**
-     *
-     * @param {number} entityIndex
-     * @throws {Error} if entity index is already in use
+     * Produces generation ID for a given entity
+     * @param {number} entity_id
+     * @returns {number}
      */
-    createEntitySpecific(entityIndex) {
-        if (this.entityExists(entityIndex)) {
-            throw new Error(`EntityId ${entityIndex} is already in use`);
+    getEntityGeneration(entity_id) {
+        return this.entityGeneration[entity_id];
+    }
+
+    /**
+     * @private
+     * @param {number} entity_id
+     */
+    createEntityUnsafe(entity_id) {
+        this.entityOccupancy.set(entity_id, true);
+
+        // record entity generation
+        if (this.entityGeneration.length <= entity_id) {
+            // needs to be resized
+            this.enlargeGenerationTable(entity_id + 1);
         }
 
-        this.entityOccupancy.set(entityIndex, true);
+        const current_generation = this.generation;
+        this.generation = current_generation + 1;
+
+        this.entityGeneration[entity_id] = current_generation;
 
         this.entityCount++;
 
-        this.onEntityCreated.send1(entityIndex);
+        this.onEntityCreated.send1(entity_id);
+    }
+
+    /**
+     *
+     * @returns {number} entityIndex
+     */
+    createEntity() {
+        const entity_id = this.entityOccupancy.nextClearBit(0);
+
+        this.createEntityUnsafe(entity_id);
+
+        return entity_id;
+    }
+
+    /**
+     *
+     * @param {number} entity_id
+     * @throws {Error} if entity index is already in use
+     */
+    createEntitySpecific(entity_id) {
+        if (this.entityExists(entity_id)) {
+            throw new Error(`EntityId ${entity_id} is already in use`);
+        }
 
-        this.generation++;
+        this.createEntityUnsafe(entity_id);
     }
 
     /**
@@ -93117,7 +93177,7 @@ class EntityComponentDataset {
         const componentClass = this.componentTypeMap[componentIndex];
 
         //dispatch event to components
-        this.sendEvent(entityIndex, EventType.ComponentRemoved, {klass: componentClass, instance: componentInstance});
+        this.sendEvent(entityIndex, EventType.ComponentRemoved, { klass: componentClass, instance: componentInstance });
     }
 
     /**
@@ -93218,7 +93278,7 @@ class EntityComponentDataset {
         const componentClass = this.componentTypeMap[componentIndex];
 
         //dispatch event to components
-        this.sendEvent(entityIndex, EventType.ComponentAdded, {klass: componentClass, instance: componentInstance});
+        this.sendEvent(entityIndex, EventType.ComponentAdded, { klass: componentClass, instance: componentInstance });
     }
 
     /**

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.84.4",
+  "version": "2.84.5",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/engine/asset/AssetDescription.js

@@ -49,3 +49,9 @@ export class AssetDescription {
         return `{ type: '${this.type}', path: '${this.path}' }`;
     }
 }
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+AssetDescription.prototype.isAssetDescription = true;

package/src/engine/ecs/Entity.js

@@ -205,6 +205,8 @@ class Entity {
      * @returns {*|null}
      */
     removeComponent(klass) {
+        assert.defined(klass, 'klass');
+
         const elements = this.components;
         const n = elements.length;
 
@@ -332,6 +334,7 @@ class Entity {
             dataset.removeEntity(entity);
 
             this.id = -1;
+            this.generation = -1;
 
             this.clearFlag(EntityFlags.Built);
 
@@ -359,6 +362,7 @@ class Entity {
         }
 
         const entity = this.id = dataset.createEntity();
+        this.generation = dataset.getEntityGeneration(entity);
         this.dataset = dataset;
 
         let i;
@@ -416,6 +420,7 @@ class Entity {
         r.setFlag(EntityFlags.Built);
         r.id = entity;
         r.dataset = dataset;
+        r.generation = dataset.getEntityGeneration(entity);
 
         return r;
     }

package/src/engine/ecs/EntityComponentDataset.js

@@ -1,13 +1,14 @@
-import {BitSet} from "../../core/binary/BitSet.js";
-import {assert} from "../../core/assert.js";
+import { assert } from "../../core/assert.js";
+import { BitSet } from "../../core/binary/BitSet.js";
+import { array_shrink_to_size } from "../../core/collection/array/array_shrink_to_size.js";
+import { arraySetDiff } from "../../core/collection/array/arraySetDiff.js";
 import Signal, {
     findSignalHandlerIndexByHandle,
     findSignalHandlerIndexByHandleAndContext
 } from "../../core/events/signal/Signal.js";
-import {EventType} from "./EntityManager.js";
-import {SignalHandler} from "../../core/events/signal/SignalHandler.js";
-import {arraySetDiff} from "../../core/collection/array/arraySetDiff.js";
-import {array_shrink_to_size} from "../../core/collection/array/array_shrink_to_size.js";
+import { SignalHandler } from "../../core/events/signal/SignalHandler.js";
+import { max3 } from "../../core/math/max3.js";
+import { EventType } from "./EntityManager.js";
 
 /**
  *
@@ -116,6 +117,15 @@ export class EntityComponentDataset {
      * @type {BitSet}
      */
     entityOccupancy = new BitSet();
+
+    /**
+     * For each entity ID records generation when entity was created
+     * Values are invalid for unused entity IDs
+     * @private
+     * @type {Uint32Array}
+     */
+    entityGeneration = new Uint32Array(0);
+
     /**
      * @private
      * @type {BitSet}
@@ -167,7 +177,7 @@ export class EntityComponentDataset {
 
     /**
      * @readonly
-     * @type {Signal}
+     * @type {Signal<number>}
      */
     onEntityCreated = new Signal();
 
@@ -448,6 +458,7 @@ export class EntityComponentDataset {
      */
     setComponentTypeMap(map) {
         assert.defined(map, "map");
+        assert.isArray(map, 'map');
 
         const newComponentTypeCount = map.length;
 
@@ -726,38 +737,79 @@ export class EntityComponentDataset {
 
     /**
      *
-     * @returns {number} entityIndex
+     * @param {number} min_size
      */
-    createEntity() {
-        const entityIndex = this.entityOccupancy.nextClearBit(0);
-        this.entityOccupancy.set(entityIndex, true);
+    enlargeGenerationTable(min_size) {
+        const old_generation_table_size = this.entityGeneration.length;
 
-        this.entityCount++;
+        const new_size = max3(
+            min_size,
+            Math.ceil(old_generation_table_size * 1.2),
+            old_generation_table_size + 16
+        );
 
-        this.onEntityCreated.send1(entityIndex);
+        const new_generation_table = new Uint32Array(new_size);
 
-        this.generation++;
+        new_generation_table.set(this.entityGeneration);
 
-        return entityIndex;
+        this.entityGeneration = new_generation_table
     }
 
     /**
-     *
-     * @param {number} entityIndex
-     * @throws {Error} if entity index is already in use
+     * Produces generation ID for a given entity
+     * @param {number} entity_id
+     * @returns {number}
+     */
+    getEntityGeneration(entity_id) {
+        return this.entityGeneration[entity_id];
+    }
+
+    /**
+     * @private
+     * @param {number} entity_id
      */
-    createEntitySpecific(entityIndex) {
-        if (this.entityExists(entityIndex)) {
-            throw new Error(`EntityId ${entityIndex} is already in use`);
+    createEntityUnsafe(entity_id) {
+        this.entityOccupancy.set(entity_id, true);
+
+        // record entity generation
+        if (this.entityGeneration.length <= entity_id) {
+            // needs to be resized
+            this.enlargeGenerationTable(entity_id + 1);
         }
 
-        this.entityOccupancy.set(entityIndex, true);
+        const current_generation = this.generation;
+        this.generation = current_generation + 1;
+
+        this.entityGeneration[entity_id] = current_generation;
 
         this.entityCount++;
 
-        this.onEntityCreated.send1(entityIndex);
+        this.onEntityCreated.send1(entity_id);
+    }
+
+    /**
+     *
+     * @returns {number} entityIndex
+     */
+    createEntity() {
+        const entity_id = this.entityOccupancy.nextClearBit(0);
+
+        this.createEntityUnsafe(entity_id);
+
+        return entity_id;
+    }
+
+    /**
+     *
+     * @param {number} entity_id
+     * @throws {Error} if entity index is already in use
+     */
+    createEntitySpecific(entity_id) {
+        if (this.entityExists(entity_id)) {
+            throw new Error(`EntityId ${entity_id} is already in use`);
+        }
 
-        this.generation++;
+        this.createEntityUnsafe(entity_id);
     }
 
     /**
@@ -887,7 +939,7 @@ export class EntityComponentDataset {
         const componentClass = this.componentTypeMap[componentIndex];
 
         //dispatch event to components
-        this.sendEvent(entityIndex, EventType.ComponentRemoved, {klass: componentClass, instance: componentInstance});
+        this.sendEvent(entityIndex, EventType.ComponentRemoved, { klass: componentClass, instance: componentInstance });
     }
 
     /**
@@ -999,7 +1051,7 @@ export class EntityComponentDataset {
         const componentClass = this.componentTypeMap[componentIndex];
 
         //dispatch event to components
-        this.sendEvent(entityIndex, EventType.ComponentAdded, {klass: componentClass, instance: componentInstance});
+        this.sendEvent(entityIndex, EventType.ComponentAdded, { klass: componentClass, instance: componentInstance });
     }
 
     /**