@woosh/meep-engine 2.84.3 → 2.84.5

package/build/meep.cjs

@@ -63966,7 +63966,7 @@ Task.prototype.isTask = true;
 /**
  *
  * @param {number|function(*):number} initial
- * @param {number|function(*):number} limit
+ * @param {number|function(*):number} limit limit is excluded from the count, same as `for(;i < limit;)`
  * @param {function(index:int)} callback
  * @returns {Task}
  */
@@ -69664,6 +69664,36 @@ function array_remove_first(array, element, start_index = 0, length = array.leng
     return false;
 }
 
+/**
+ *
+ * @param {*} value
+ * @return {boolean}
+ */
+function isDefined(value) {
+    return value !== undefined;
+}
+
+/**
+ *
+ * @enum
+ */
+const EntityFlags = {
+    /**
+     * Whether the entity is built, set internally
+     */
+    Built: 1,
+    /**
+     * If component type is not registered on the {@link EntityComponentDataset} when calling {@link Entity#build} - will register the component first
+     */
+    RegisterComponents: 2,
+    /**
+     * Entity builder will watch destruction of the entity (subscribe to event), this will make the {@link Entity} automatically
+     * recognize when the corresponding entity is destroyed outside the {@link Entity} API
+     * NOTE: useful to turn off to save a bit of memory, as those event listeners take up a bit of space. Feel free to turn this flag off when you don't care to keep the reference to the {@link Entity}
+     */
+    WatchDestruction: 4
+};
+
 /**
  * de Bruijn sequence
  * @see https://graphics.stanford.edu/~seander/bithacks.html
@@ -72276,78 +72306,6 @@ class EntityManager {
     }
 }
 
-/**
- * @author Alex Goldring
- * @copyright Alex Goldring 2017
- */
-
-
-/**
- *
- * @param {*} value
- * @return {boolean}
- */
-function isDefined(value) {
-    return value !== undefined;
-}
-
-/**
- * performs instanceof match
- * @param {function} type
- * @returns {function(*): boolean}
- */
-function isInstanceOf$1(type) {
-    return function (m) {
-        return m instanceof type;
-    }
-}
-
-/**
- * performs typeof match
- * @param {string} type
- * @returns {function(*): boolean}
- */
-function isTypeOf(type) {
-
-    return function (m) {
-        return typeof m === type;
-    }
-}
-
-/**
- * Joins two matchers via OR
- * @param {function(*):boolean} a
- * @param {function(*):boolean} b
- * @returns {function(*):boolean}
- */
-function or(a, b) {
-
-    return function (m) {
-        return a(m) || b(m);
-    }
-}
-
-/**
- *
- * @enum
- */
-const EntityFlags = {
-    /**
-     * Whether the entity is built, set internally
-     */
-    Built: 1,
-    /**
-     * If component type is not registered on the {@link EntityComponentDataset} when calling {@link Entity#build} - will register the component first
-     */
-    RegisterComponents: 2,
-    /**
-     * Entity builder will watch destruction of the entity (subscribe to event), this will make the {@link Entity} automatically
-     * recognize when the corresponding entity is destroyed outside the {@link Entity} API
-     * NOTE: useful to turn off to save a bit of memory, as those event listeners take up a bit of space. Feel free to turn this flag off when you don't care to keep the reference to the {@link Entity}
-     */
-    WatchDestruction: 4
-};
-
 /**
  * Set of default flags
  * @type {number}
@@ -72546,6 +72504,7 @@ class Entity {
      * @returns {*|null}
      */
     removeComponent(klass) {
+
         const elements = this.components;
         const n = elements.length;
 
@@ -72671,6 +72630,7 @@ class Entity {
             dataset.removeEntity(entity);
 
             this.id = -1;
+            this.generation = -1;
 
             this.clearFlag(EntityFlags.Built);
 
@@ -72696,6 +72656,7 @@ class Entity {
         }
 
         const entity = this.id = dataset.createEntity();
+        this.generation = dataset.getEntityGeneration(entity);
         this.dataset = dataset;
 
         let i;
@@ -72753,6 +72714,7 @@ class Entity {
         r.setFlag(EntityFlags.Built);
         r.id = entity;
         r.dataset = dataset;
+        r.generation = dataset.getEntityGeneration(entity);
 
         return r;
     }
@@ -84094,7 +84056,13 @@ class AssetDescription {
     toString() {
         return `{ type: '${this.type}', path: '${this.path}' }`;
     }
-}
+}
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+AssetDescription.prototype.isAssetDescription = true;
 
 /**
  * @enum {number}
@@ -89825,7 +89793,7 @@ class InputDeviceSwitch {
  * @param klass
  * @returns {boolean}
  */
-function isInstanceOf(thing, klass) {
+function isInstanceOf$1(thing, klass) {
     if (klass === undefined) {
         return false;
     }
@@ -89846,12 +89814,12 @@ function isInstanceOf(thing, klass) {
  * @param {Element} el
  */
 function isFocusable(el) {
-    return isInstanceOf(el, HTMLInputElement)
-        || isInstanceOf(el, HTMLSelectElement)
-        || isInstanceOf(el, HTMLTextAreaElement)
-        || isInstanceOf(el, HTMLAnchorElement)
-        || isInstanceOf(el, HTMLButtonElement)
-        || isInstanceOf(el, HTMLAreaElement)
+    return isInstanceOf$1(el, HTMLInputElement)
+        || isInstanceOf$1(el, HTMLSelectElement)
+        || isInstanceOf$1(el, HTMLTextAreaElement)
+        || isInstanceOf$1(el, HTMLAnchorElement)
+        || isInstanceOf$1(el, HTMLButtonElement)
+        || isInstanceOf$1(el, HTMLAreaElement)
 }
 
 /**
@@ -92404,6 +92372,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}
@@ -92455,7 +92432,7 @@ class EntityComponentDataset {
 
     /**
      * @readonly
-     * @type {Signal}
+     * @type {Signal<number>}
      */
     onEntityCreated = new Signal();
 
@@ -93005,38 +92982,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);
+    }
 
-        this.generation++;
+    /**
+     *
+     * @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.createEntityUnsafe(entity_id);
     }
 
     /**
@@ -93161,7 +93179,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 });
     }
 
     /**
@@ -93262,7 +93280,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 });
     }
 
     /**
@@ -96123,6 +96141,42 @@ function number_pretty_print(value) {
 
 }
 
+/**
+ * performs instanceof match
+ * @param {function} type
+ * @returns {function(*): boolean}
+ */
+function isInstanceOf(type) {
+    return function (m) {
+        return m instanceof type;
+    }
+}
+
+/**
+ * performs typeof match
+ * @param {string} type
+ * @returns {function(*): boolean}
+ */
+function isTypeOf(type) {
+
+    return function (m) {
+        return typeof m === type;
+    }
+}
+
+/**
+ * Joins two matchers via OR
+ * @param {function(*):boolean} a
+ * @param {function(*):boolean} b
+ * @returns {function(*):boolean}
+ */
+function or(a, b) {
+
+    return function (m) {
+        return a(m) || b(m);
+    }
+}
+
 /**
  * Created by Alex on 01/11/2014.
  * @copyright Alex Goldring 2014
@@ -96271,14 +96325,14 @@ function p(m, e, f) {
  * @type {Array.<ValueProcessor>}
  */
 const processors = [
-    p(isInstanceOf$1(ObservedBoolean), extractorGetValue, format),
-    p(isInstanceOf$1(ObservedValue), extractorGetValue, format),
-    p(isInstanceOf$1(ObservedString), extractorGetValue, format),
-    p(isInstanceOf$1(LinearValue), extractorGetValue, formatNumber),
-    p(isInstanceOf$1(BoundedValue), extractBoundedValue, formatArray),
-    p(isInstanceOf$1(Stat), extractorGetValue, formatNumber),
-    p(isInstanceOf$1(Vector1), extractorGetValue, formatNumber),
-    p(isInstanceOf$1(ObservedInteger), extractorGetValue, formatNumber),
+    p(isInstanceOf(ObservedBoolean), extractorGetValue, format),
+    p(isInstanceOf(ObservedValue), extractorGetValue, format),
+    p(isInstanceOf(ObservedString), extractorGetValue, format),
+    p(isInstanceOf(LinearValue), extractorGetValue, formatNumber),
+    p(isInstanceOf(BoundedValue), extractBoundedValue, formatArray),
+    p(isInstanceOf(Stat), extractorGetValue, formatNumber),
+    p(isInstanceOf(Vector1), extractorGetValue, formatNumber),
+    p(isInstanceOf(ObservedInteger), extractorGetValue, formatNumber),
     p(or(isTypedArray, Array.isArray), arrayUnwrap, formatArray),
     p(isTypeOf("number"), passThrough, formatNumber),
     p(isTypeOf("string"), passThrough, passThrough),