@woosh/meep-engine 2.59.6 → 2.60.0

package/build/meep.module.js

@@ -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);
 
@@ -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) {
@@ -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];
 
@@ -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
@@ -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;
@@ -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 = [];
     }
@@ -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}
      */
@@ -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/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.59.6",
+  "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/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/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) {

package/src/core/graph/coloring/colorizeGraph.js

@@ -118,7 +118,7 @@ function updateNN(NN, a, vertexCount, colors, colorNumber) {
  * @param {number[]} NN
  * @param {number[]} color
  * @param {number} colorNumber
- * @return {(number)[]}
+ * @return {number[]}
  */
 function findSuitableY(vertexCount, a, NN, color, colorNumber) {
     var temp, tmp_y, y = 0;

package/src/core/localization/Localization.js

@@ -1,13 +1,13 @@
-import { distance as levenshtein_distance } from "fastest-levenshtein";
-import { parseTooltipString } from "../../view/tooltip/gml/parser/parseTooltipString.js";
-import { assert } from "../assert.js";
+import {distance as levenshtein_distance} from "fastest-levenshtein";
+import {parseTooltipString} from "../../view/tooltip/gml/parser/parseTooltipString.js";
+import {assert} from "../assert.js";
+import {Cache} from "../cache/Cache.js";
+import {computeHashArray} from "../collection/array/computeHashArray.js";
 import ObservedString from "../model/ObservedString.js";
-import { seedVariablesIntoTemplateString } from "../parser/seedVariablesIntoTemplateString.js";
-import { STRING_TEMPLATE_VARIABLE_REGEX } from "../parser/STRING_TEMPLATE_VARIABLE_REGEX.js";
-import { Cache } from "../cache/Cache.js";
-import { computeStringHash } from "../primitives/strings/computeStringHash.js";
-import { computeHashArray } from "../collection/array/computeHashArray.js";
-import { LanguageMetadata } from "./LanguageMetadata.js";
+import {seedVariablesIntoTemplateString} from "../parser/seedVariablesIntoTemplateString.js";
+import {STRING_TEMPLATE_VARIABLE_REGEX} from "../parser/STRING_TEMPLATE_VARIABLE_REGEX.js";
+import {computeStringHash} from "../primitives/strings/computeStringHash.js";
+import {LanguageMetadata} from "./LanguageMetadata.js";
 
 /**
  * Validation utility method
@@ -56,7 +56,7 @@ export class Localization {
         this.debug = true;
 
         /**
-         * @type {Cache<string[], string>}
+         * @type {Cache<Array<string>, string>}
          * @private
          */
         this.__failure_cache = new Cache({
@@ -176,7 +176,7 @@ export 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);
     }

package/src/core/model/ModuleRegistry.js

@@ -9,7 +9,7 @@ export class ModuleRegistry {
     #modules = new Map();
     /**
      *
-     * @type {Map<*,string[]>}
+     * @type {Map<*,Array<string>>}
      */
     #reverse_lookup = new Map();
 
@@ -37,7 +37,7 @@ export 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));
@@ -55,7 +55,7 @@ export class ModuleRegistry {
 
     /**
      *
-     * @param {String} name
+     * @param {string} name
      * @returns {boolean}
      */
     has(name) {
@@ -64,7 +64,7 @@ export class ModuleRegistry {
 
     /**
      * @template T
-     * @param {String} name
+     * @param {string} name
      * @param {T} module
      * @returns {boolean}
      */

package/src/core/process/task/Task.js

@@ -55,7 +55,7 @@ class Task {
 
         /**
          *
-         * @type {function(Task, executor:{run:function(Task)})}
+         * @type {function(Task, executor:ConcurrentExecutor)}
          */
         this.initialize = initializer;
 
@@ -149,7 +149,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      */
     addDependencies(tasks) {
         if (!Array.isArray(tasks)) {
@@ -205,7 +205,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      * @return {Promise}
      */
     static promiseAll(tasks) {

package/src/engine/EngineConfiguration.js

@@ -91,7 +91,6 @@ export class EngineConfiguration {
     }
 
     /**
-     *
      * @param {System} systems
      */
     addManySystems(...systems) {

package/src/engine/EngineHarness.js

@@ -184,7 +184,7 @@ export 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/src/engine/ecs/EntityComponentDataset.js

@@ -1094,7 +1094,7 @@ export 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) {
@@ -1719,7 +1719,7 @@ export 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) {