@woosh/meep-engine 2.59.5 → 2.60.0

package/build/meep.module.js

@@ -764,7 +764,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);`
  */
@@ -55940,8 +55940,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;
@@ -60407,7 +60408,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);
 
@@ -62751,8 +62752,8 @@ class List {
     }
 
     /**
-     *
-     * @param {[]} json
+     * @template J
+     * @param {J[]} json
      * @param {function} constructor
      */
     fromJSON(json, constructor) {
@@ -64122,7 +64123,7 @@ class Task {
 
         /**
          *
-         * @type {function(Task, executor:{run:function(Task)})}
+         * @type {function(Task, executor:ConcurrentExecutor)}
          */
         this.initialize = initializer;
 
@@ -64216,7 +64217,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      */
     addDependencies(tasks) {
         if (!Array.isArray(tasks)) {
@@ -64272,7 +64273,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      * @return {Promise}
      */
     static promiseAll(tasks) {
@@ -65110,7 +65111,7 @@ class WorkerProxy {
     /**
      * @template T
      * @param {number} name
-     * @param {[]} args
+     * @param {Array} args
      * @return {Promise<T>}
      */
     $submitRequest(name, args) {
@@ -69418,7 +69419,7 @@ class System {
 
 
     /**
-     * @returns {[]} Component classes
+     * @returns {Array} Component classes
      */
     get referenced_components() {
         const result = [];
@@ -70652,14 +70653,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];
 
@@ -71583,7 +71583,7 @@ class OnDemandWorkerManager {
     /**
      * @template T
      * @param {string} name
-     * @param {[]} [parameters]
+     * @param {Array} [parameters]
      * @return {Promise<T>}
      */
     request(name, parameters) {
@@ -72063,55 +72063,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
@@ -74821,7 +74794,7 @@ class Entity {
      * @returns {Entity}
      */
     add(componentInstance) {
-        if (componentInstance === undefined) {
+        if (componentInstance === undefined || componentInstance === null) {
             throw new Error(`Can not add ${componentInstance} to Entity`);
         }
 
@@ -75136,30 +75109,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.
@@ -75277,6 +75226,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 {
@@ -75385,7 +75385,7 @@ class EntityNode {
 
     /**
      *
-     * @param {(EntityNode) => *} visitor
+     * @param {function(node:EntityNode):*} visitor
      * @param {*} [context]
      */
     traverseChildren(visitor, context) {
@@ -75394,7 +75394,7 @@ class EntityNode {
 
     /**
      *
-     * @return {Readonly<EntityNode[]>}
+     * @return {Readonly<Array<EntityNode>>}
      */
     get children() {
         return this.__children;
@@ -77110,8 +77110,8 @@ function textureImagesEqual(a, b) {
 
 /**
  *
- * @param {[]} a
- * @param {[]} b
+ * @param {Array} a
+ * @param {Array} b
  * @returns {boolean}
  */
 function textureMipChainEqual(a, b) {
@@ -79615,7 +79615,7 @@ class ExplicitBinaryBoundingVolumeHierarchy {
 
     /**
      *
-     * @param {(node:number, tree:ExplicitBinaryBoundingVolumeHierarchy)=>void} callback
+     * @param {function(node:number, tree:ExplicitBinaryBoundingVolumeHierarchy):void} callback
      * @param {*} [ctx]
      */
     traverse(callback, ctx) {
@@ -90391,7 +90391,7 @@ class CameraView {
 
         /**
          *
-         * @type {{transform:(Float32Array, Float32Array)=>void, context:*}[]}
+         * @type {Array<{transform:function(Float32Array, Float32Array):void, context:*}>}
          */
         this.projection_modifiers = [];
     }
@@ -93047,8 +93047,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`);
@@ -93760,7 +93760,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) {
@@ -94385,7 +94385,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) {
 
@@ -105511,7 +105511,7 @@ class Localization {
         this.debug = true;
 
         /**
-         * @type {Cache<string[], string>}
+         * @type {Cache<Array<string>, string>}
          * @private
          */
         this.__failure_cache = new Cache({
@@ -105631,7 +105631,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);
     }
@@ -105716,7 +105716,7 @@ class ModuleRegistry {
     #modules = new Map();
     /**
      *
-     * @type {Map<*,string[]>}
+     * @type {Map<*,Array<string>>}
      */
     #reverse_lookup = new Map();
 
@@ -105744,7 +105744,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));
@@ -105762,7 +105762,7 @@ class ModuleRegistry {
 
     /**
      *
-     * @param {String} name
+     * @param {string} name
      * @returns {boolean}
      */
     has(name) {
@@ -105771,7 +105771,7 @@ class ModuleRegistry {
 
     /**
      * @template T
-     * @param {String} name
+     * @param {string} name
      * @param {T} module
      * @returns {boolean}
      */
@@ -110344,7 +110344,7 @@ class InputController {
 
     /**
      *
-     * @param {[]} bindings
+     * @param {Array} bindings
      */
     static from(bindings) {
         const ic = new InputController();
@@ -112571,7 +112571,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
@@ -112590,7 +112590,7 @@ class QuadTreeNode extends AABB2 {
 
     /**
      *
-     * @param {QuadTreeDatum<D>[]} result
+     * @param {Array<QuadTreeDatum<D>>} result
      * @param {number} x0
      * @param {number} y0
      * @param {number} x1
@@ -120169,7 +120169,6 @@ class EngineConfiguration {
     }
 
     /**
-     *
      * @param {System} systems
      */
     addManySystems(...systems) {
@@ -121035,7 +121034,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) {

package/editor/ecs/component/editors/ecs/ParameterLookupTableEditor.js

@@ -120,7 +120,7 @@ export class ParameterLookupTableEditor extends TypeEditor {
 
     /**
      * converts lut color sample to RGB
-     * @param {[]} sample
+     * @param {number[]} sample
      */
     convertRGB(sample){
         sample[0] = Math.floor(sample[0] * 255);

package/package.json

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

package/src/core/bvh2/binary/IndexedBinaryBVH.js

@@ -164,8 +164,9 @@ export default 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;

package/src/core/bvh2/bvh3/ExplicitBinaryBoundingVolumeHierarchy.js

@@ -993,7 +993,7 @@ export class ExplicitBinaryBoundingVolumeHierarchy {
 
     /**
      *
-     * @param {(node:number, tree:ExplicitBinaryBoundingVolumeHierarchy)=>void} callback
+     * @param {function(node:number, tree:ExplicitBinaryBoundingVolumeHierarchy):void} callback
      * @param {*} [ctx]
      */
     traverse(callback, ctx) {

package/src/core/bvh2/serialization/serializeBinaryNode.js

@@ -1,11 +1,11 @@
-import { isLeaf, serializeLeafNode } from "../LeafNode.js";
-import { serializeAABB3 } from "../../geom/3d/aabb/serializeAABB3.js";
+import {serializeAABB3} from "../../geom/3d/aabb/serializeAABB3.js";
+import {isLeaf, serializeLeafNode} from "../LeafNode.js";
 
 /**
  *
  * @param {BinaryBuffer} buffer
  * @param {BinaryNode} node
- * @param {function(buffer:BinaryBuffer, value:*):void} leafValueSerializer
+ * @param {function(buffer:BinaryBuffer,value:any):void} leafValueSerializer
  */
 function serializeBinaryNode(buffer, node, leafValueSerializer) {
     serializeAABB3(buffer, node);
@@ -28,4 +28,4 @@ function serializeBinaryNode(buffer, node, leafValueSerializer) {
     serializeChild(node.right);
 }
 
-export { serializeBinaryNode };
+export {serializeBinaryNode};

package/src/core/collection/list/List.js

@@ -747,8 +747,8 @@ class List {
     }
 
     /**
-     *
-     * @param {[]} json
+     * @template J
+     * @param {J[]} json
      * @param {function} constructor
      */
     fromJSON(json, constructor) {

package/src/core/collection/map/HashMap.js

@@ -168,7 +168,7 @@ export 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);
 

package/src/core/collection/table/RowFirstTableSpec.js

@@ -54,7 +54,7 @@ export const DataType2DataViewWriters = {
  *
  * @param {BinaryDataType[]} types
  * @param {EndianType} [endianType]
- * @returns {(data_view:DataView, byte_offset:number, result:number[])=>void}
+ * @returns {function(data_view:DataView, byte_offset:number, result:number[]):void}
  */
 function genRowReader(types, endianType = EndianType.BigEndian) {
     let offset = 0;

package/src/core/debug/matchers/DescribeAs.js

@@ -13,7 +13,7 @@ export class DescribeAs extends BaseMatcher {
      */
     matcher
     /**
-     * @type {[]}
+     * @type {Array}
      */
     values
 
@@ -21,7 +21,7 @@ export class DescribeAs extends BaseMatcher {
      *
      * @param {string} template
      * @param {Matcher} matcher
-     * @param {[]} values
+     * @param {Array} values
      */
     constructor(template, matcher, values) {
         super();

package/src/core/debug/matchers/IsIn.js

@@ -1,8 +1,11 @@
 import { BaseMatcher } from "../BaseMatcher.js";
 
+/**
+ * @template T
+ */
 export class IsIn extends BaseMatcher {
     /**
-     * @type {[]}
+     * @type {T[]}
      */
     #collection = []
 

package/src/core/debug/matchers/matchers.js

@@ -130,7 +130,7 @@ export function isOneOf(...elements) {
  * @template T
  * @param {string} template
  * @param {Matcher<T>} matcher
- * @param {[]} values
+ * @param {T[]} values
  * @returns {Matcher<T>}
  */
 function describeAs(template, matcher, values) {

package/src/core/events/signal/Signal.js

@@ -17,7 +17,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);`
  */

package/src/core/geom/2d/line/line_segment_compute_line_segment_intersection_vectors_array_2d.js

@@ -7,7 +7,7 @@ import {
  * @param {Vector2} p1
  * @param {Vector2} p2
  * @param {Vector2} p3
- * @returns {[number,number]}
+ * @returns {number[]} 2 elements
  */
 export function line_segment_compute_line_segment_intersection_vectors_array_2d(p0, p1, p2, p3) {
     const p0_x = p0.x;

package/src/core/geom/2d/quad-tree/QuadTreeNode.js

@@ -487,7 +487,7 @@ export 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
@@ -506,7 +506,7 @@ export class QuadTreeNode extends AABB2 {
 
     /**
      *
-     * @param {QuadTreeDatum<D>[]} result
+     * @param {Array<QuadTreeDatum<D>>} result
      * @param {number} x0
      * @param {number} y0
      * @param {number} x1

package/src/core/geom/2d/quad-tree/qt_collect_by_circle.js

@@ -8,7 +8,7 @@ const node_stack = [];
 
 /**
  * @template T
- * @param {QuadTreeDatum<T>[]} result
+ * @param {Array<QuadTreeDatum<T>>} result
  * @param {number} result_offset
  * @param {QuadTreeNode<T>} tree
  * @param {number} x

package/src/core/geom/3d/tetrahedra/TetrahedralMesh.js

@@ -135,7 +135,7 @@ export class TetrahedralMesh {
 
     /**
      * Traverse tetrahedrons
-     * @param {(tet:number,mesh:TetrahedralMesh)=>*} visitor
+     * @param {function(tet:number,mesh:TetrahedralMesh):*} visitor
      * @param {*} [thisArg]
      */
     forEach(visitor, thisArg) {

package/src/core/geom/3d/tetrahedra/validate_tetrahedral_mesh.js

@@ -134,7 +134,7 @@ function is_tetrahedron_degenerate(mesh, tet) {
  *
  * @param {TetrahedralMesh} mesh
  * @param {ArrayLike<number>} points
- * @param {(problem:string)=>*} [consumer]
+ * @param {function(problem:string):*} [consumer]
  * @returns {boolean}
  */
 export function validate_tetrahedral_mesh(mesh, points, consumer = noop) {

package/src/core/geom/packing/miniball/Miniball.js

@@ -162,7 +162,6 @@ class Miniball {
     /**
      * TODO
      *
-     * @return
      * @return {*}
      */
     support() {

package/src/core/geom/packing/miniball/Subspan.js

@@ -273,8 +273,7 @@ export class Subspan {
      *
      * Complexity: O(dim^2).
      *
-     * @param {number} index
-     * index into <i>S</i> of the point to add
+     * @param {number} index index into <i>S</i> of the point to add
      */
     add(index) {
         let o = this.origin();
@@ -310,7 +309,6 @@ export class Subspan {
      * Euclidean coordinates of point <i>p</i>
      * @param {Array} w
      * the squared length of <i>w</i>
-     * @return
      * @return {number}
      */
     shortestVectorToSpan(p, w) {