@woosh/meep-engine 2.59.6 → 2.60.1

package/build/meep.cjs

@@ -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);
 
@@ -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) {
@@ -69553,6 +69554,84 @@ function computeSystemName(system) {
     return system.constructor.name;
 }
 
+/**
+ *
+ * @param {Vector3} out Result will be written here
+ * @param {number} originX Ray origin
+ * @param {number} originY Ray origin
+ * @param {number} originZ Ray origin
+ * @param {number} directionX Ray direction
+ * @param {number} directionY Ray direction
+ * @param {number} directionZ Ray direction
+ * @param {number} normalX Plane normal
+ * @param {number} normalY Plane normal
+ * @param {number} normalZ Plane normal
+ * @param {number} dist Plane distance
+ * @returns {boolean} true if intersection is found, false otherwise
+ */
+function plane3_compute_ray_intersection(
+    out,
+    originX, originY, originZ,
+    directionX, directionY, directionZ,
+    normalX, normalY, normalZ, dist
+) {
+    const denom = v3_dot(directionX, directionY, directionZ, normalX, normalY, normalZ);
+
+    const p = v3_dot(normalX, normalY, normalZ, originX, originY, originZ) + dist;
+
+    if (denom !== 0) {
+
+        const t = -p / denom;
+
+        if (t < 0) {
+            return false;
+        }
+
+        out.set(
+            directionX * t + originX,
+            directionY * t + originY,
+            directionZ * t + originZ
+        );
+
+        return true;
+
+    } else {
+
+        if (p === 0) {
+
+            out.set(originX, originY, originZ);
+
+            return true;
+
+        } else {
+
+            //no intersection
+            return false;
+
+        }
+
+    }
+}
+
+/**
+ * Orthogonal distance of a point to a plane, the distance is positive when the point lies above the plane and negative when the point is below
+ * @param {number} x
+ * @param {number} y
+ * @param {number} z
+ * @param {number} normalX
+ * @param {number} normalY
+ * @param {number} normalZ
+ * @param {number} planeConstant
+ * @returns {number}
+ */
+function v3_distance_above_plane(
+    x, y, z,
+    normalX, normalY, normalZ, planeConstant
+) {
+    // this is the same as v4_dot(v4(x,y,z,1.0), v4(plane.normal, plane.constant));
+    return v3_dot(normalX, normalY, normalZ, x, y, z) + planeConstant;
+}
+
 class ObservedBoolean extends Boolean {
     /**
      *
@@ -69793,21 +69872,6 @@ ObservedEnum.prototype.fromJSON = function (obj) {
     this.set(obj);
 };
 
-//
-
-/**
- *
- * @param {Vector3} result
- * @param {Vector3} input
- * @param {number[]} projection_matrix_inverse inverse of projection matrix
- * @param {number[]} world_matrix world transform
- */
-function unprojectPoint(result, input, projection_matrix_inverse, world_matrix) {
-    result.copy(input);
-    result.applyMatrix4(projection_matrix_inverse);
-    result.applyMatrix4(world_matrix);
-}
-
 const matrix4 = new Matrix4();
 
 /**
@@ -69851,25 +69915,6 @@ function invertQuaternionOrientation(output, input) {
     output.setFromRotationMatrix(m4_scratch);
 }
 
-/**
- * Orthogonal distance of a point to a plane, the distance is positive when the point lies above the plane and negative when the point is below
- * @param {number} x
- * @param {number} y
- * @param {number} z
- * @param {number} normalX
- * @param {number} normalY
- * @param {number} normalZ
- * @param {number} planeConstant
- * @returns {number}
- */
-function v3_distance_above_plane(
-    x, y, z,
-    normalX, normalY, normalZ, planeConstant
-) {
-    // this is the same as v4_dot(v4(x,y,z,1.0), v4(plane.normal, plane.constant));
-    return v3_dot(normalX, normalY, normalZ, x, y, z) + planeConstant;
-}
-
 /**
  *
  * @enum {String}
@@ -69880,63 +69925,19 @@ const ProjectionType = {
     Orthographic: "orthographic"
 };
 
+//
+
 /**
  *
- * @param {Vector3} out Result will be written here
- * @param {number} originX Ray origin
- * @param {number} originY Ray origin
- * @param {number} originZ Ray origin
- * @param {number} directionX Ray direction
- * @param {number} directionY Ray direction
- * @param {number} directionZ Ray direction
- * @param {number} normalX Plane normal
- * @param {number} normalY Plane normal
- * @param {number} normalZ Plane normal
- * @param {number} dist Plane distance
- * @returns {boolean} true if intersection is found, false otherwise
+ * @param {Vector3} result
+ * @param {Vector3} input
+ * @param {number[]} projection_matrix_inverse inverse of projection matrix
+ * @param {number[]} world_matrix world transform
  */
-function plane3_compute_ray_intersection(
-    out,
-    originX, originY, originZ,
-    directionX, directionY, directionZ,
-    normalX, normalY, normalZ, dist
-) {
-    const denom = v3_dot(directionX, directionY, directionZ, normalX, normalY, normalZ);
-
-    const p = v3_dot(normalX, normalY, normalZ, originX, originY, originZ) + dist;
-
-    if (denom !== 0) {
-
-        const t = -p / denom;
-
-        if (t < 0) {
-            return false;
-        }
-
-        out.set(
-            directionX * t + originX,
-            directionY * t + originY,
-            directionZ * t + originZ
-        );
-
-        return true;
-
-    } else {
-
-        if (p === 0) {
-
-            out.set(originX, originY, originZ);
-
-            return true;
-
-        } else {
-
-            //no intersection
-            return false;
-
-        }
-
-    }
+function unprojectPoint(result, input, projection_matrix_inverse, world_matrix) {
+    result.copy(input);
+    result.applyMatrix4(projection_matrix_inverse);
+    result.applyMatrix4(world_matrix);
 }
 
 /**
@@ -69978,7 +69979,7 @@ class Camera {
          *
          * @type {ObservedBoolean}
          */
-        this.active = new ObservedBoolean(false);
+        this.active = new ObservedBoolean(true);
 
         /**
          * Near clipping plane
@@ -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];
 
@@ -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
@@ -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;
@@ -77703,9 +77703,15 @@ function rewriteMaterial(shader) {
     `+shader.fragmentShader;
 }
 
+/**
+ * @typedef {Object} CacheKey
+ * @property {Material} color
+ * @property {Material} depth
+ */
+
 /**
  * @readonly
- * @type {Cache<Material, {color:Material, depth:Material}>}
+ * @type {Cache<Material,CacheKey>}
  */
 const material_cache = new Cache({
     maxWeight: 1024,
@@ -77720,14 +77726,14 @@ class InstancedMeshGroup {
     constructor() {
         /**
          * Instanced geometry
-         * @type {THREE.InstancedBufferGeometry|null}
+         * @type {InstancedBufferGeometry|null}
          * @private
          */
         this.__threeGeometry = null;
 
         /**
          * Geometry of a single instance
-         * @type {THREE.BufferGeometry|null}
+         * @type {BufferGeometry|null}
          * @private
          */
         this.__threeInstanceGeometry = null;
@@ -77755,7 +77761,12 @@ class InstancedMeshGroup {
          */
         this.growConstant = 16;
 
+        /**
+         *
+         * @type {number}
+         */
         this.shrinkFactor = 0.5;
+
         /**
          * Minimum capacity reduction for shrinkage to occur
          * @type {number}
@@ -77920,7 +77931,7 @@ class InstancedMeshGroup {
     /**
      *
      * @param {THREE.Material|THREE.ShaderMaterial} sourceMaterial
-     * @returns {{depth: Material, color: Material}}
+     * @returns {CacheKey}
      */
     #buildMaterial(sourceMaterial) {
         //console.warn(`building material : {id:${sourceMaterial.id}, name: ${sourceMaterial.name}, type: ${sourceMaterial.type}`)
@@ -79617,7 +79628,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 +90404,7 @@ class CameraView {
 
         /**
          *
-         * @type {{transform:(Float32Array, Float32Array)=>void, context:*}[]}
+         * @type {Array<{transform:function(Float32Array, Float32Array):void, context:*}>}
          */
         this.projection_modifiers = [];
     }
@@ -93762,7 +93773,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 +94398,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 +105524,7 @@ class Localization {
         this.debug = true;
 
         /**
-         * @type {Cache<string[], string>}
+         * @type {Cache<Array<string>, string>}
          * @private
          */
         this.__failure_cache = new Cache({
@@ -105633,7 +105644,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 +105729,7 @@ class ModuleRegistry {
     #modules = new Map();
     /**
      *
-     * @type {Map<*,string[]>}
+     * @type {Map<*,Array<string>>}
      */
     #reverse_lookup = new Map();
 
@@ -105746,7 +105757,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 +105775,7 @@ class ModuleRegistry {
 
     /**
      *
-     * @param {String} name
+     * @param {string} name
      * @returns {boolean}
      */
     has(name) {
@@ -105773,7 +105784,7 @@ class ModuleRegistry {
 
     /**
      * @template T
-     * @param {String} name
+     * @param {string} name
      * @param {T} module
      * @returns {boolean}
      */
@@ -112573,7 +112584,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 +112603,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 +120182,6 @@ class EngineConfiguration {
     }
 
     /**
-     *
      * @param {System} systems
      */
     addManySystems(...systems) {
@@ -121037,7 +121047,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) {