@woosh/meep-engine 2.108.4 → 2.109.1

package/build/meep.cjs

@@ -557,7 +557,7 @@ assert.isArray = function (value, name = 'value') {
 
 /**
  * @template T
- * @param {ArrayLike<T>|T[]} value
+ * @param {ArrayLike<T>|T[]|Uint32Array|Float32Array} value
  * @param {string} name
  */
 assert.isArrayLike = function (value, name = 'value') {
@@ -3608,7 +3608,7 @@ let Quaternion$1 = class Quaternion {
     /**
      *
      * @param {Quaternion} other
-     * @param {number} max_delta
+     * @param {number} max_delta in radians
      */
     rotateTowards(other, max_delta) {
         Quaternion.rotateTowards(this, this, other, max_delta);
@@ -4987,6 +4987,19 @@ class Transform {
         return result;
     }
 
+    /**
+     *
+     * @param {number[]|Float32Array} mat
+     * @returns {Transform}
+     */
+    static fromMatrix(mat) {
+        const result = new Transform();
+
+        result.fromMatrix4(mat);
+
+        return result;
+    }
+
     /**
      * Multiply two transforms, result it written into this one
      * @param {Transform} a
@@ -5000,17 +5013,18 @@ class Transform {
 
     /**
      *
-     * @param {mat4|number[]|Float32Array} m
+     * @param {mat4|number[]|Float32Array} matrix
      */
-    fromMatrix4(m) {
+    fromMatrix4(matrix) {
+
         // we know we are changing the matrix, so we're going to need to disable the flag that sets matrix from position/rotation/scale changes
         const ad = this.getFlag(TransformFlags.AutomaticChangeDetection);
 
         this.clearFlag(TransformFlags.AutomaticChangeDetection);
 
-        this.matrix.set(m);
+        this.matrix.set(matrix);
 
-        decompose_matrix_4_array(m, this.position, this.rotation, this.scale);
+        decompose_matrix_4_array(matrix, this.position, this.rotation, this.scale);
 
         // restore value of the flag
         this.writeFlag(TransformFlags.AutomaticChangeDetection, ad);
@@ -59941,7 +59955,7 @@ const DEFAULT_INITIAL_CAPACITY_POWER = 4;
  * @readonly
  * @type {number}
  */
-const DEFAULT_INITIAL_CAPACITY = 2 ** DEFAULT_INITIAL_CAPACITY_POWER;
+const DEFAULT_INITIAL_CAPACITY$1 = 2 ** DEFAULT_INITIAL_CAPACITY_POWER;
 
 /**
  * @readonly
@@ -60070,7 +60084,7 @@ class HashMap {
     constructor({
                     keyHashFunction = invokeObjectHash,
                     keyEqualityFunction = invokeObjectEquals,
-                    capacity = DEFAULT_INITIAL_CAPACITY,
+                    capacity = DEFAULT_INITIAL_CAPACITY$1,
                     loadFactor = DEFAULT_LOAD_FACTOR
                 } = {}) {
 
@@ -69343,6 +69357,36 @@ function computeSystemName(system) {
     return system.constructor.name;
 }
 
+/**
+ *
+ * @param {Object3D} object
+ */
+function threeUpdateMatrix(object) {
+    object.updateMatrix();
+
+    const children = object.children;
+    for (let i = 0, childCount = children.length; i < childCount; i++) {
+        const child = children[i];
+
+        threeUpdateMatrix(child);
+    }
+}
+
+/**
+ *
+ * @param {Object3D} object3
+ */
+function threeUpdateTransform(object3) {
+
+    /**
+     signal that transformation matrix should be updated
+     @see https://threejs.org/docs/index.html#api/core/Object3D.matrixWorldNeedsUpdate
+     */
+    threeUpdateMatrix(object3);
+
+    object3.updateMatrixWorld(false);
+}
+
 /**
  *
  * @param {Camera} c
@@ -70089,50 +70133,43 @@ function set_camera_aspect_ratio(camera, width, height) {
 
 /**
  *
- * @param {Object3D} object
+ * @param {Camera} camera
  */
-function threeUpdateMatrix(object) {
-    object.updateMatrix();
+function update_camera_transform(camera) {
 
-    const children = object.children;
-    for (let i = 0, childCount = children.length; i < childCount; i++) {
-        const child = children[i];
+    const three_camera = camera.object;
 
-        threeUpdateMatrix(child);
+    if (three_camera === null) {
+        return;
     }
+
+    three_camera.updateProjectionMatrix();
+    threeUpdateTransform(three_camera);
 }
 
 /**
  *
- * @param {Object3D} object3
+ * @param {THREE.Camera} object
+ * @param {Quaternion} rotation
  */
-function threeUpdateTransform(object3) {
+function three_camera_set_transform_rotation(object, rotation) {
 
-    /**
-     signal that transformation matrix should be updated
-     @see https://threejs.org/docs/index.html#api/core/Object3D.matrixWorldNeedsUpdate
+    /*
+    NOTE: I'm not sure why, but three.js camera points in the opposite direction to normal objects
+    See: https://github.com/mrdoob/three.js/blob/412b99a7f26e117ea97f40eb53d010ab81aa3279/src/core/Object3D.js#L282
      */
-    threeUpdateMatrix(object3);
 
-    object3.updateMatrixWorld(false);
-}
-
-/**
- *
- * @param {Camera} camera
- */
-function update_camera_transform(camera) {
+    invertQuaternionOrientation(object.quaternion, rotation);
 
-    const three_camera = camera.object;
+    object.rotation.setFromQuaternion(object.quaternion);
 
-    if (three_camera === null) {
-        return;
-    }
+    // rotation.__setThreeEuler(camera.object.rotation); // seems unnecessary, based on Object3D.lookAt implementation
+    // camera.object.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
+
+    object.updateProjectionMatrix();
+    threeUpdateTransform(object);
+}
 
-    three_camera.updateProjectionMatrix();
-    threeUpdateTransform(three_camera);
-}
-
 class CameraSystem extends System {
     /**
      *
@@ -70221,19 +70258,7 @@ class CameraSystem extends System {
         function synchronizeRotation() {
             const rotation = transform.rotation;
 
-            /*
-            NOTE: I'm not sure why, but three.js camera points in the opposite direction to normal objects
-            See: https://github.com/mrdoob/three.js/blob/412b99a7f26e117ea97f40eb53d010ab81aa3279/src/core/Object3D.js#L282
-             */
-
-            invertQuaternionOrientation(camera.object.quaternion, rotation);
-
-            camera.object.rotation.setFromQuaternion(camera.object.quaternion);
-
-            // rotation.__setThreeEuler(camera.object.rotation); // seems unnecessary, based on Object3D.lookAt implementation
-            // camera.object.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
-
-            update_camera_transform(camera);
+            three_camera_set_transform_rotation(camera.object, rotation);
         }
 
         function rebuild() {
@@ -70752,16 +70777,25 @@ const EntityFlags = {
     WatchDestruction: 4
 };
 
+/**
+ * Align to the nearest number divisible by 32, rounding up
+ * @param {number} n
+ * @returns {number}
+ */
+function align_32(n) {
+    return ((n + 31) >>> 5) << 5
+}
+
 /**
  * de Bruijn sequence
  * @see https://graphics.stanford.edu/~seander/bithacks.html
  * @type {Uint8Array}
  */
-const msb_lut = new Uint8Array([
+const msb_lut_de_bruijn = new Uint8Array([
     0, 1, 28, 2, 29, 14, 24, 3, 30, 22, 20, 15, 25, 17, 4, 8,
     31, 27, 13, 23, 21, 19, 16, 7, 26, 12, 18, 6, 11, 5, 10, 9
-]);
-
+]);
+
 /**
  * Get index of the least significant set bit
  * Also known as ctz32 or "count trailing zeroes"
@@ -70770,9 +70804,9 @@ const msb_lut = new Uint8Array([
  * @returns {number}
  */
 function lsb_32(v) {
-    return msb_lut[((v & -v) * 0x077CB531) >>> 27];
-}
-
+    return msb_lut_de_bruijn[((v & -v) * 0x077CB531) >>> 27];
+}
+
 /**
  * Used for overallocating space when bit set needs to grow
  * @constant
@@ -70793,12 +70827,20 @@ const SHRINK_FACTOR$1 = 0.5;
  */
 const RESIZE_COUNT_THRESHOLD = 128;
 
+/**
+ * @readonly
+ * @type {number}
+ */
+const DEFAULT_INITIAL_CAPACITY = 64;
+
 class BitSet {
     /**
      * Dynamically sized bit field
      * @constructor
+     * @param {number} [initial_capacity]
      */
-    constructor() {
+    constructor(initial_capacity = DEFAULT_INITIAL_CAPACITY) {
+
         /**
          * Number of bits currently in use
          * @private
@@ -70811,7 +70853,7 @@ class BitSet {
          * @private
          * @type {number}
          */
-        this.__capacity = 64;
+        this.__capacity = align_32(initial_capacity);
 
         /**
          * Uint32-backed storage
@@ -71337,9 +71379,7 @@ class BitSet {
      * @returns {BitSet}
      */
     static fixedSize(x) {
-        const r = new BitSet();
-
-        r.setCapacity(x);
+        const r = new BitSet(x);
 
         //prevent resizing
         r.__shrinkFactor = 0;