@woosh/meep-engine 2.59.5 → 2.60.0

package/build/meep.cjs

@@ -766,7 +766,7 @@ const dispatch_stack = [];
 let dispatch_stack_top = 0;
 
 /**
- * Signal is a type of event bus. You can subscribe to events using {@link add) method and dispatch using sendN method where N is the number of arguments you wish to pass
+ * Signal is a type of event bus. You can subscribe to events using {@link add} method and dispatch using sendN method where N is the number of arguments you wish to pass
  * Signal is different from a normal event bus in that 1 signal corresponds to 1 event type. For example, in HTML you have `addEventListener` which lets you subscribe to any kind of event, let's use "mousedown" as a reference. Using a Signal you would instead have a signal corresponding to "mousedown" and dispatch this signal only for this event.
  * @example `const mouseDown = new Signal<MouseEvent>(); mouseDown.send1(myMouseEvent);`
  */
@@ -55942,8 +55942,9 @@ class IndexedBinaryBVH {
     }
 
     /**
+     * @template T
      * @deprecated use {@link #writeLeaf} instead followed by {@link #unsortedBuiltIntermediate}
-     * @param {function(index:number,offset:number,data:*, writeBox:function):*} visitor
+     * @param {function(index:number,offset:number,data:T, writeBox:function):void} visitor
      */
     setLeafs(visitor) {
         let offset = this.binaryNodeCount * 6;
@@ -60409,7 +60410,7 @@ class HashMap {
 
     /**
      * Note that dead entries are marked as such with a special reserved hash values, so records can be reused for new entries
-     * @type {MapEntry<K,V>[]}
+     * @type {Array<MapEntry<K,V>>}
      */
     #entries = new Array(0);
 
@@ -62753,8 +62754,8 @@ class List {
     }
 
     /**
-     *
-     * @param {[]} json
+     * @template J
+     * @param {J[]} json
      * @param {function} constructor
      */
     fromJSON(json, constructor) {
@@ -64124,7 +64125,7 @@ class Task {
 
         /**
          *
-         * @type {function(Task, executor:{run:function(Task)})}
+         * @type {function(Task, executor:ConcurrentExecutor)}
          */
         this.initialize = initializer;
 
@@ -64218,7 +64219,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      */
     addDependencies(tasks) {
         if (!Array.isArray(tasks)) {
@@ -64274,7 +64275,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      * @return {Promise}
      */
     static promiseAll(tasks) {
@@ -65112,7 +65113,7 @@ class WorkerProxy {
     /**
      * @template T
      * @param {number} name
-     * @param {[]} args
+     * @param {Array} args
      * @return {Promise<T>}
      */
     $submitRequest(name, args) {
@@ -69420,7 +69421,7 @@ class System {
 
 
     /**
-     * @returns {[]} Component classes
+     * @returns {Array} Component classes
      */
     get referenced_components() {
         const result = [];
@@ -70654,14 +70655,13 @@ ResourceAccessSpecification.prototype.isResourceAccessSpecification = true;
 class CameraSystem extends System {
     /**
      *
-     * @param {THREE.Scene} scene
      * @param {GraphicsEngine} graphics
      * @constructor
      */
-    constructor(scene, graphics) {
+    constructor(graphics) {
         super();
 
-        this.scene = scene;
+        this.scene = graphics.scene;
 
         this.dependencies = [Camera, Transform];
 
@@ -71585,7 +71585,7 @@ class OnDemandWorkerManager {
     /**
      * @template T
      * @param {string} name
-     * @param {[]} [parameters]
+     * @param {Array} [parameters]
      * @return {Promise<T>}
      */
     request(name, parameters) {
@@ -72065,55 +72065,28 @@ class TerrainSystem extends System {
 }
 
 /**
- *  Component representing logical attachment to another entity, when parent disappears - so does the child
+ * Remove first occurrence of element from the array
+ * @template T
+ * @param {T[]} array
+ * @param {T} element
+ * @param {number} [start_index]
+ * @param {number} [length]
+ * @return {boolean} true if element was removed, false if it was not found
  */
-class ParentEntity {
-    /**
-     * * @constructor
-     */
-    constructor() {
-        /**
-         * Entity representing logical parent.
-         * Must not be mutated (changed) while component is attached to a dataset
-         * @type {number}
-         */
-        this.entity = -1;
-    }
-
-    /**
-     *
-     * @param {number} entity
-     * @returns {ParentEntity}
-     */
-    static from(entity) {
-        const r = new ParentEntity();
-
-        r.entity = entity;
+function array_remove_first(array, element, start_index = 0, length = array.length) {
 
-        return r;
-    }
+    const end_index = start_index + length;
 
-    toJSON() {
-        return {
-            entity: this.entity,
-        };
-    }
+    for (let i = start_index; i < end_index; i++) {
+        if (array[i] === element) {
+            array.splice(i, 1);
 
-    fromJSON({ entity }) {
-        this.entity = entity;
+            return true;
+        }
     }
-}
 
-/**
- * @readonly
- * @type {string}
- */
-ParentEntity.typeName = "ParentEntity";
-/**
- *
- * @type {boolean}
- */
-ParentEntity.serializable = false;
+    return false;
+}
 
 /**
  * de Bruijn sequence
@@ -74823,7 +74796,7 @@ class Entity {
      * @returns {Entity}
      */
     add(componentInstance) {
-        if (componentInstance === undefined) {
+        if (componentInstance === undefined || componentInstance === null) {
             throw new Error(`Can not add ${componentInstance} to Entity`);
         }
 
@@ -75138,30 +75111,6 @@ function checkExistingComponents(entity, components, dataset) {
     return true;
 }
 
-/**
- * Remove first occurrence of element from the array
- * @template T
- * @param {T[]} array
- * @param {T} element
- * @param {number} [start_index]
- * @param {number} [length]
- * @return {boolean} true if element was removed, false if it was not found
- */
-function array_remove_first(array, element, start_index = 0, length = array.length) {
-
-    const end_index = start_index + length;
-
-    for (let i = start_index; i < end_index; i++) {
-        if (array[i] === element) {
-            array.splice(i, 1);
-
-            return true;
-        }
-    }
-
-    return false;
-}
-
 const TransformAttachmentFlags = {
     /**
      * Update will be performed when component is attached.
@@ -75279,6 +75228,57 @@ const EntityNodeFlags = {
     TransformObserved: 2
 };
 
+/**
+ *  Component representing logical attachment to another entity, when parent disappears - so does the child
+ */
+class ParentEntity {
+    /**
+     * * @constructor
+     */
+    constructor() {
+        /**
+         * Entity representing logical parent.
+         * Must not be mutated (changed) while component is attached to a dataset
+         * @type {number}
+         */
+        this.entity = -1;
+    }
+
+    /**
+     *
+     * @param {number} entity
+     * @returns {ParentEntity}
+     */
+    static from(entity) {
+        const r = new ParentEntity();
+
+        r.entity = entity;
+
+        return r;
+    }
+
+    toJSON() {
+        return {
+            entity: this.entity,
+        };
+    }
+
+    fromJSON({ entity }) {
+        this.entity = entity;
+    }
+}
+
+/**
+ * @readonly
+ * @type {string}
+ */
+ParentEntity.typeName = "ParentEntity";
+/**
+ *
+ * @type {boolean}
+ */
+ParentEntity.serializable = false;
+
 const DEFAULT_FLAGS$1 = EntityNodeFlags.LiveManagement;
 
 class EntityNode {
@@ -75387,7 +75387,7 @@ class EntityNode {
 
     /**
      *
-     * @param {(EntityNode) => *} visitor
+     * @param {function(node:EntityNode):*} visitor
      * @param {*} [context]
      */
     traverseChildren(visitor, context) {
@@ -75396,7 +75396,7 @@ class EntityNode {
 
     /**
      *
-     * @return {Readonly<EntityNode[]>}
+     * @return {Readonly<Array<EntityNode>>}
      */
     get children() {
         return this.__children;
@@ -77112,8 +77112,8 @@ function textureImagesEqual(a, b) {
 
 /**
  *
- * @param {[]} a
- * @param {[]} b
+ * @param {Array} a
+ * @param {Array} b
  * @returns {boolean}
  */
 function textureMipChainEqual(a, b) {
@@ -79617,7 +79617,7 @@ class ExplicitBinaryBoundingVolumeHierarchy {
 
     /**
      *
-     * @param {(node:number, tree:ExplicitBinaryBoundingVolumeHierarchy)=>void} callback
+     * @param {function(node:number, tree:ExplicitBinaryBoundingVolumeHierarchy):void} callback
      * @param {*} [ctx]
      */
     traverse(callback, ctx) {
@@ -90393,7 +90393,7 @@ class CameraView {
 
         /**
          *
-         * @type {{transform:(Float32Array, Float32Array)=>void, context:*}[]}
+         * @type {Array<{transform:function(Float32Array, Float32Array):void, context:*}>}
          */
         this.projection_modifiers = [];
     }
@@ -93049,8 +93049,8 @@ class EntityComponentDataset {
     /**
      * Convenience method for retrieving a collection of components for a given entity
      * @param {number} entity ID of the entity
-     * @param {[]} componentClasses Classes of components to extract
-     * @returns {[]}
+     * @param {Array} componentClasses Classes of components to extract
+     * @returns {Array}
      */
     getComponents(entity, componentClasses) {
         assert.ok(this.entityExists(entity), `Entity ${entity} doesn't exist`);
@@ -93762,7 +93762,7 @@ class EntityComponentDataset {
      * Performs traversal on a subset of entities which have specified components.
      * @example traverseEntities([Transform,Renderable,Tag],function(transform, renderable, tag, entity){ ... }, this);
      * @param {Array} classes
-     * @param {function:boolean?} visitor Visitor can return optional "false" to terminate traversal earlier
+     * @param {function(...args):boolean} visitor Visitor can return optional "false" to terminate traversal earlier
      * @param {object} [thisArg] specifies context object on which callbacks are to be called, optional
      */
     traverseEntities(classes, visitor, thisArg) {
@@ -94387,7 +94387,7 @@ class EntityComponentDataset {
     /**
      * Main utility of this method is to facilitate serialization.
      * @param {Array} componentClasses
-     * @param {function(componentIndex:number,components:[], componentCount:number)} visitor
+     * @param {function(componentIndex:number,components:Array, componentCount:number)} visitor
      */
     traverseEntitiesCompactedFiltered(componentClasses, visitor) {
 
@@ -105513,7 +105513,7 @@ class Localization {
         this.debug = true;
 
         /**
-         * @type {Cache<string[], string>}
+         * @type {Cache<Array<string>, string>}
          * @private
          */
         this.__failure_cache = new Cache({
@@ -105633,7 +105633,7 @@ class Localization {
      * @param {number} value
      */
     formatIntegerByThousands(value) {
-        const formatter = new Intl.NumberFormat(this.locale.getValue(), { useGrouping: true });
+        const formatter = new Intl.NumberFormat(this.locale.getValue(), {useGrouping: true});
 
         return formatter.format(value);
     }
@@ -105718,7 +105718,7 @@ class ModuleRegistry {
     #modules = new Map();
     /**
      *
-     * @type {Map<*,string[]>}
+     * @type {Map<*,Array<string>>}
      */
     #reverse_lookup = new Map();
 
@@ -105746,7 +105746,7 @@ class ModuleRegistry {
 
     /**
      *
-     * @param {(name:string, module:*)=>void} visitor
+     * @param {function(name:string,module:*):void} visitor
      */
     traverse(visitor) {
         this.#modules.forEach((klass, name) => visitor(name, klass));
@@ -105764,7 +105764,7 @@ class ModuleRegistry {
 
     /**
      *
-     * @param {String} name
+     * @param {string} name
      * @returns {boolean}
      */
     has(name) {
@@ -105773,7 +105773,7 @@ class ModuleRegistry {
 
     /**
      * @template T
-     * @param {String} name
+     * @param {string} name
      * @param {T} module
      * @returns {boolean}
      */
@@ -110346,7 +110346,7 @@ class InputController {
 
     /**
      *
-     * @param {[]} bindings
+     * @param {Array} bindings
      */
     static from(bindings) {
         const ic = new InputController();
@@ -112573,7 +112573,7 @@ class QuadTreeNode extends AABB2 {
 
     /**
      *
-     * @param {QuadTreeDatum<D>[]} result
+     * @param {Array<QuadTreeDatum<D>>} result
      * @param {number} x
      * @param {number} y
      * @returns {number} number of intersecting objects added to the result
@@ -112592,7 +112592,7 @@ class QuadTreeNode extends AABB2 {
 
     /**
      *
-     * @param {QuadTreeDatum<D>[]} result
+     * @param {Array<QuadTreeDatum<D>>} result
      * @param {number} x0
      * @param {number} y0
      * @param {number} x1
@@ -120171,7 +120171,6 @@ class EngineConfiguration {
     }
 
     /**
-     *
      * @param {System} systems
      */
     addManySystems(...systems) {
@@ -121037,7 +121036,7 @@ class EngineHarness {
             em.addSystem(new TopDownCameraControllerSystem());
         }
         if (em.getSystem(CameraSystem) === null) {
-            em.addSystem(new CameraSystem(engine.graphics.scene, engine.graphics));
+            em.addSystem(new CameraSystem(engine.graphics));
         }
 
         if (em.getSystem(SoundListenerSystem) === null) {