@woosh/meep-engine 2.101.0 → 2.103.0

package/build/meep.cjs

@@ -806,7 +806,7 @@ const MATRIX_BYTE_SIZE = 4 * 16;
  * custom Float32Array allocator, allocated memory in continuous chunks
  * @returns {Float32Array}
  */
-function allocate_transform_m4() {
+function allocate_m4() {
     if (transform_bucket_cursor >= TRANSFORM_ALLOCATOR_BUCKET_CAPACITY) {
         transform_bucket = new ArrayBuffer(TRANSFORM_ALLOCATOR_BUCKET_CAPACITY * MATRIX_BYTE_SIZE);
         transform_bucket_cursor = 0;
@@ -2478,7 +2478,7 @@ let Vector3$1 = class Vector3 {
     }
 
     /**
-     * @param {number} [squaredError=0.01]
+     * @param {number} [squaredError]
      * @return {boolean}
      */
     isNormalized(squaredError = 0.01) {
@@ -4705,7 +4705,7 @@ class Transform {
      * @readonly
      * @type {Float32Array}
      */
-    matrix = allocate_transform_m4();
+    matrix = allocate_m4();
 
     /**
      * Various bit flags, see {@link TransformFlags}
@@ -47474,10 +47474,8 @@ function v2_dot(x0, y0, x1, y1) {
 class Vector2 {
     /**
      *
-     * @param {number} [x=0
+     * @param {number} [x=0]
      * @param {number} [y=0]
-     * @property {number} x
-     * @property {number} y
      * @constructor
      */
     constructor(x = 0, y = 0) {
@@ -50398,6 +50396,7 @@ class Vector1 extends Number {
      * @param {number} x
      */
     setSilent(x) {
+
         this.x = x;
     }
 
@@ -50637,93 +50636,6 @@ function computeHashIntegerArray(...value) {
  */
 
 
-/**
- *
- * @param {number[]} result
- * @param {number[]} input
- * @param {number[]} mat4
- */
-function v4_applyMatrix4(result, input, mat4) {
-    const a0 = mat4[0];
-    const a1 = mat4[1];
-    const a2 = mat4[2];
-    const a3 = mat4[3];
-
-    const b0 = mat4[4];
-    const b1 = mat4[5];
-    const b2 = mat4[6];
-    const b3 = mat4[7];
-
-    const c0 = mat4[8];
-    const c1 = mat4[9];
-    const c2 = mat4[10];
-    const c3 = mat4[11];
-
-    const d0 = mat4[12];
-    const d1 = mat4[13];
-    const d2 = mat4[14];
-    const d3 = mat4[15];
-
-    const _x = input[0];
-    const _y = input[1];
-    const _z = input[2];
-    const _w = input[3];
-
-    const x = a0 * _x + b0 * _y + c0 * _z + d0 * _w;
-    const y = a1 * _x + b1 * _y + c1 * _z + d1 * _w;
-    const z = a2 * _x + b2 * _y + c2 * _z + d2 * _w;
-    const w = a3 * _x + b3 * _y + c3 * _z + d3 * _w;
-
-    result[0] = x;
-    result[1] = y;
-    result[2] = z;
-    result[3] = w;
-}
-
-/**
- *
- * @param {number} x0
- * @param {number} y0
- * @param {number} z0
- * @param {number} w0
- * @param {number} x1
- * @param {number} y1
- * @param {number} z1
- * @param {number} w1
- * @returns {number}
- */
-function v4_dot(x0, y0, z0, w0, x1, y1, z1, w1) {
-    return (x0 * x1 + y0 * y1 + z0 * z1 + w0 * w1);
-}
-
-/**
- *
- * @param {number} x
- * @param {number} y
- * @param {number} z
- * @param {number} w
- * @returns {number}
- */
-function v4_length_sqr(x, y, z, w) {
-    return x * x + y * y + z * z + w * w;
-}
-
-/**
- *
- * @param {number} x0
- * @param {number} y0
- * @param {number} z0
- * @param {number} w0
- * @param {number} x1
- * @param {number} y1
- * @param {number} z1
- * @param {number} w1
- * @returns {number}
- */
-function v4_distance_sqr(x0, y0, z0, w0, x1, y1, z1, w1) {
-    return v4_length_sqr(x0 - x1, y0 - y1, z0 - z1, w0 - w1);
-}
-
 class Vector4 {
     /**
      *
@@ -50808,7 +50720,10 @@ class Vector4 {
             this.w = w;
 
             if (this.onChanged.hasHandlers()) {
-                this.onChanged.dispatch(x, y, z, w, _x, _y, _z, _w);
+                this.onChanged.send8(
+                    x, y, z, w,
+                    _x, _y, _z, _w
+                );
             }
         }
 
@@ -50892,7 +50807,12 @@ class Vector4 {
      * @returns {Vector4}
      */
     add3(v3) {
-        return this.set(this.x + v3.x, this.y + v3.y, this.z + v3.z, this.w);
+        return this.set(
+            this.x + v3.x,
+            this.y + v3.y,
+            this.z + v3.z,
+            this.w
+        );
     }
 
     /**
@@ -83485,7 +83405,7 @@ class ModuleRegistry {
  * @param {TaskGroup|Task} t
  * @returns {boolean}
  */
-function isGroup(t) {
+function isGroupTask(t) {
     return t.children instanceof Array;
 }
 
@@ -83493,7 +83413,12 @@ function isGroup(t) {
  * @class
  */
 class ConcurrentExecutor {
+    /**
+     * How many time-slice cycles have been executed this far. This is a monotonically increasing counter
+     * @type {number}
+     */
     #cycle_count = 0;
+
     /**
      * Handle of the last scheduled `setTimeout`
      * @type {number}
@@ -83605,7 +83530,7 @@ class ConcurrentExecutor {
                 const child = children[i];
                 child.on.completed.add(subTaskCompleted);
                 child.on.failed.add(subTaskFailed);
-                if (isGroup(child)) {
+                if (isGroupTask(child)) {
                     this.runGroup(child);
                 } else {
                     this.run(child);
@@ -83628,7 +83553,7 @@ class ConcurrentExecutor {
         for (let i = 0; i < n; i++) {
             const child = children[i];
 
-            if (isGroup(child)) {
+            if (isGroupTask(child)) {
                 this.removeGroup(child);
             } else {
                 this.removeTask(child);
@@ -83725,7 +83650,7 @@ class ConcurrentExecutor {
     }
 
     /**
-     * Go through unresolved queue and move tasks who's dependencies have been completed to ready queue or fail them
+     * Go through unresolved queue and move tasks whose dependencies have been completed to ready queue or fail them
      */
     resolveTasks() {
         const queueUnresolved = this.queueUnresolved;
@@ -83762,6 +83687,7 @@ class ConcurrentExecutor {
     /**
      *
      * @param {Task} task
+     * @returns {boolean}
      */
     contains(task) {
         if (this.queueUnresolved.indexOf(task) !== -1) {
@@ -96292,6 +96218,7 @@ const source = typeof performance === "undefined" ? Date : performance;
  * @returns {number}
  */
 function current_time_in_seconds() {
+    // time source produces value in milliseconds, we need to scale to seconds
     return source.now() * 1e-3;
 }
 
@@ -102796,50 +102723,51 @@ Notification.prototype.isNotification = true;
  */
 
 
-function NotificationLog() {
+class NotificationLog {
     /**
      * @readonly
      * @type {List<Notification>}
      */
-    this.elements = new List();
+    elements = new List();
 
     /**
      * Once number of entries in the log reaches this amount, the earliest entries will be removed to make space for new ones
      * @type {number}
      */
-    this.maxLength = 1000;
-}
+    maxLength = 1000;
 
-/**
- *
- * @param {{}} options See Notification.constructor for details
- * @returns {Notification}
- */
-NotificationLog.prototype.add = function (options) {
-    const notification = new Notification(options);
+    /**
+     *
+     * @param {{}} options See {@link Notification.constructor} for details
+     * @returns {Notification}
+     */
+    add(options) {
+        const notification = new Notification(options);
 
-    this.addNotification(notification);
+        this.addNotification(notification);
 
-    return notification;
-};
+        return notification;
+    }
 
-/**
- *
- * @param {Notification} notification
- */
-NotificationLog.prototype.addNotification = function (notification) {
+    /**
+     *
+     * @param {Notification} notification
+     */
+    addNotification(notification) {
 
-    // Crop notification log to size
-    const length = this.elements.length;
+        // Crop notification log to size
+        const length = this.elements.length;
 
-    const target = this.maxLength - 1;
+        const target = this.maxLength - 1;
 
-    if (length > target) {
-        this.elements.crop(length - target, length);
-    }
+        if (length > target) {
+            // too many elements, drop some
+            this.elements.crop(length - target, length);
+        }
 
-    this.elements.add(notification);
-};
+        this.elements.add(notification);
+    }
+}
 
 class LogDisplay {
     /**
@@ -117807,6 +117735,100 @@ function v2_angle_between(x0, y0, x1, y1) {
     return Math.acos(theta);
 }
 
+/**
+ *
+ * @param {number[]} result
+ * @param {number[]} input
+ * @param {number[]} mat4
+ */
+function v4_multiply_mat4(result, input, mat4) {
+    const a0 = mat4[0];
+    const a1 = mat4[1];
+    const a2 = mat4[2];
+    const a3 = mat4[3];
+
+    const b0 = mat4[4];
+    const b1 = mat4[5];
+    const b2 = mat4[6];
+    const b3 = mat4[7];
+
+    const c0 = mat4[8];
+    const c1 = mat4[9];
+    const c2 = mat4[10];
+    const c3 = mat4[11];
+
+    const d0 = mat4[12];
+    const d1 = mat4[13];
+    const d2 = mat4[14];
+    const d3 = mat4[15];
+
+    const _x = input[0];
+    const _y = input[1];
+    const _z = input[2];
+    const _w = input[3];
+
+    const x = a0 * _x + b0 * _y + c0 * _z + d0 * _w;
+    const y = a1 * _x + b1 * _y + c1 * _z + d1 * _w;
+    const z = a2 * _x + b2 * _y + c2 * _z + d2 * _w;
+    const w = a3 * _x + b3 * _y + c3 * _z + d3 * _w;
+
+    result[0] = x;
+    result[1] = y;
+    result[2] = z;
+    result[3] = w;
+}
+
+/**
+ *
+ * @param {number} x0
+ * @param {number} y0
+ * @param {number} z0
+ * @param {number} w0
+ * @param {number} x1
+ * @param {number} y1
+ * @param {number} z1
+ * @param {number} w1
+ * @returns {number}
+ */
+function v4_dot(
+    x0, y0, z0, w0,
+    x1, y1, z1, w1
+) {
+
+    return (x0 * x1 + y0 * y1 + z0 * z1 + w0 * w1);
+}
+
+/**
+ *
+ * @param {number} x
+ * @param {number} y
+ * @param {number} z
+ * @param {number} w
+ * @returns {number}
+ */
+function v4_length_sqr(x, y, z, w) {
+    return x * x + y * y + z * z + w * w;
+}
+
+/**
+ *
+ * @param {number} x0
+ * @param {number} y0
+ * @param {number} z0
+ * @param {number} w0
+ * @param {number} x1
+ * @param {number} y1
+ * @param {number} z1
+ * @param {number} w1
+ * @returns {number}
+ */
+function v4_distance_sqr(
+    x0, y0, z0, w0,
+    x1, y1, z1, w1
+) {
+    return v4_length_sqr(x0 - x1, y0 - y1, z0 - z1, w0 - w1);
+}
+
 exports.AmbientOcclusionPostProcessEffect = AmbientOcclusionPostProcessEffect;
 exports.Behavior = Behavior;
 exports.BehaviorStatus = BehaviorStatus;
@@ -117839,7 +117861,7 @@ exports.v2_distance = v2_distance;
 exports.v2_dot = v2_dot;
 exports.v2_length_sqr = v2_length_sqr;
 exports.v2_magnitude = v2_magnitude;
-exports.v4_applyMatrix4 = v4_applyMatrix4;
 exports.v4_distance_sqr = v4_distance_sqr;
 exports.v4_dot = v4_dot;
 exports.v4_length_sqr = v4_length_sqr;
+exports.v4_multiply_mat4 = v4_multiply_mat4;