@woosh/meep-engine 2.101.0 → 2.103.0

package/build/meep.module.js

@@ -804,7 +804,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;
@@ -2476,7 +2476,7 @@ let Vector3$1 = class Vector3 {
     }
 
     /**
-     * @param {number} [squaredError=0.01]
+     * @param {number} [squaredError]
      * @return {boolean}
      */
     isNormalized(squaredError = 0.01) {
@@ -4703,7 +4703,7 @@ class Transform {
      * @readonly
      * @type {Float32Array}
      */
-    matrix = allocate_transform_m4();
+    matrix = allocate_m4();
 
     /**
      * Various bit flags, see {@link TransformFlags}
@@ -47472,10 +47472,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) {
@@ -50396,6 +50394,7 @@ class Vector1 extends Number {
      * @param {number} x
      */
     setSilent(x) {
+
         this.x = x;
     }
 
@@ -50635,93 +50634,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 {
     /**
      *
@@ -50806,7 +50718,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
+                );
             }
         }
 
@@ -50890,7 +50805,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
+        );
     }
 
     /**
@@ -83483,7 +83403,7 @@ class ModuleRegistry {
  * @param {TaskGroup|Task} t
  * @returns {boolean}
  */
-function isGroup(t) {
+function isGroupTask(t) {
     return t.children instanceof Array;
 }
 
@@ -83491,7 +83411,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}
@@ -83603,7 +83528,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);
@@ -83626,7 +83551,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);
@@ -83723,7 +83648,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;
@@ -83760,6 +83685,7 @@ class ConcurrentExecutor {
     /**
      *
      * @param {Task} task
+     * @returns {boolean}
      */
     contains(task) {
         if (this.queueUnresolved.indexOf(task) !== -1) {
@@ -96290,6 +96216,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;
 }
 
@@ -102794,50 +102721,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 {
     /**
@@ -117805,4 +117733,98 @@ function v2_angle_between(x0, y0, x1, y1) {
     return Math.acos(theta);
 }
 
-export { AmbientOcclusionPostProcessEffect, Behavior, BehaviorStatus, Blackboard, Cache, EngineConfiguration, EngineHarness, ForwardPlusRenderingPlugin, HashMap, Light, ParallelBehavior, ParallelBehaviorPolicy, SGMesh, SGMeshSystem, SelectorBehavior, SequenceBehavior, ShadedGeometry, ShadedGeometrySystem, Signal, SignalBinding, Transform, dispatchViaProxy, findSignalHandlerIndexByHandle, findSignalHandlerIndexByHandleAndContext, find_path_on_grid_astar, quat3_createFromAxisAngle, v2_angle_between, v2_bearing_angle_towards, v2_distance, v2_dot, v2_length_sqr, v2_magnitude, v4_applyMatrix4, v4_distance_sqr, v4_dot, v4_length_sqr };
+/**
+ *
+ * @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);
+}
+
+export { AmbientOcclusionPostProcessEffect, Behavior, BehaviorStatus, Blackboard, Cache, EngineConfiguration, EngineHarness, ForwardPlusRenderingPlugin, HashMap, Light, ParallelBehavior, ParallelBehaviorPolicy, SGMesh, SGMeshSystem, SelectorBehavior, SequenceBehavior, ShadedGeometry, ShadedGeometrySystem, Signal, SignalBinding, Transform, dispatchViaProxy, findSignalHandlerIndexByHandle, findSignalHandlerIndexByHandleAndContext, find_path_on_grid_astar, quat3_createFromAxisAngle, v2_angle_between, v2_bearing_angle_towards, v2_distance, v2_dot, v2_length_sqr, v2_magnitude, v4_distance_sqr, v4_dot, v4_length_sqr, v4_multiply_mat4 };

package/package.json

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

package/src/core/__module.d.ts

@@ -14,4 +14,8 @@ export { v2_length_sqr } from "./geom/vec2/v2_length_sqr.js";
 export { v2_dot } from "./geom/vec2/v2_dot.js";
 export { v2_bearing_angle_towards } from "./geom/vec2/v2_bearing_angle_towards.js";
 export { v2_angle_between } from "./geom/vec2/v2_angle_between.js";
+export { v4_multiply_mat4 } from "./geom/vec4/v4_multiply_mat4.js";
+export { v4_dot } from "./geom/vec4/v4_dot.js";
+export { v4_length_sqr } from "./geom/vec4/v4_length_sqr.js";
+export { v4_distance_sqr } from "./geom/vec4/v4_distance_sqr.js";
 //# sourceMappingURL=__module.d.ts.map

package/src/core/__module.js

@@ -16,3 +16,7 @@ export { v2_length_sqr } from "./geom/vec2/v2_length_sqr.js";
 export { v2_dot } from "./geom/vec2/v2_dot.js";
 export { v2_bearing_angle_towards } from "./geom/vec2/v2_bearing_angle_towards.js";
 export { v2_angle_between } from "./geom/vec2/v2_angle_between.js";
+export { v4_multiply_mat4 } from "./geom/vec4/v4_multiply_mat4.js";
+export { v4_dot } from "./geom/vec4/v4_dot.js";
+export { v4_length_sqr } from "./geom/vec4/v4_length_sqr.js";
+export { v4_distance_sqr } from "./geom/vec4/v4_distance_sqr.js";

package/src/core/geom/2d/circle/Circle.d.ts

@@ -1,12 +1,4 @@
 export default Circle;
-/**
- * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)
- * @param {Number} [x=0]
- * @param {Number} [y=0]
- * @param {Number} [r=0]
- * @constructor
- */
-declare function Circle(x?: number, y?: number, r?: number): void;
 declare class Circle {
     /**
      * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)

package/src/core/geom/2d/circle/Circle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/circle/Circle.js"],"names":[],"mappings":";AAEA;;;;;;GAMG;AACH,kEAkBC;;IAzBD;;;;;;OAMG;IACH,gDAkBC;IAjBG;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAGd;;;OAGG;IACH,oCAEC;IAED;;;;OAIG;IACH,2CAGC;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAYnB;IAED;;;;OAIG;IACH,cAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;OAKG;IACH,OAJW,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;IAED;;;OAGG;IACH,YAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,SAFa,MAAM,CAMlB"}
+{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/circle/Circle.js"],"names":[],"mappings":";AAEA;IACI;;;;;;OAMG;IACH,gDAkBC;IAjBG;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAGd;;;OAGG;IACH,oCAEC;IAED;;;;OAIG;IACH,2CAGC;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAYnB;IAED;;;;OAIG;IACH,cAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;OAKG;IACH,OAJW,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;IAED;;;OAGG;IACH,YAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,SAFa,MAAM,CAIlB;CACJ"}

package/src/core/geom/2d/circle/Circle.js

@@ -1,105 +1,105 @@
 import { circle_intersects_circle } from "./circle_intersects_circle.js";
 
-/**
- * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)
- * @param {Number} [x=0]
- * @param {Number} [y=0]
- * @param {Number} [r=0]
- * @constructor
- */
-function Circle(x = 0, y = 0, r = 0) {
+class Circle {
     /**
-     * Position along X axis
-     * @type {Number}
+     * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)
+     * @param {Number} [x=0]
+     * @param {Number} [y=0]
+     * @param {Number} [r=0]
+     * @constructor
      */
-    this.x = x;
+    constructor(x = 0, y = 0, r = 0) {
+        /**
+         * Position along X axis
+         * @type {Number}
+         */
+        this.x = x;
+
+        /**
+         * Position along Y axis
+         * @type {Number}
+         */
+        this.y = y;
+
+        /**
+         * Radius
+         * @type {Number}
+         */
+        this.r = r;
+    }
 
     /**
-     * Position along Y axis
-     * @type {Number}
+     *
+     * @param {Vector2} target
      */
-    this.y = y;
+    readPosition(target) {
+        target.set(this.x, this.y);
+    }
 
     /**
-     * Radius
-     * @type {Number}
+     *
+     * @param {Number} deltaX
+     * @param {Number} deltaY
      */
-    this.r = r;
-}
-
-/**
- *
- * @param {Vector2} target
- */
-Circle.prototype.readPosition = function (target) {
-    target.set(this.x, this.y);
-};
-
-/**
- *
- * @param {Number} deltaX
- * @param {Number} deltaY
- */
-Circle.prototype.move = function (deltaX, deltaY) {
-    this.x += deltaX;
-    this.y += deltaY;
-};
+    move(deltaX, deltaY) {
+        this.x += deltaX;
+        this.y += deltaY;
+    }
 
-/**
- *
- * @param {Circle} other
- * @returns {boolean}
- */
-Circle.prototype.overlaps = function (other) {
-    const x0 = this.x;
-    const y0 = this.y;
-    const r0 = this.r;
-
-    const x1 = other.x;
-    const y1 = other.y;
-    const r1 = other.r;
+    /**
+     *
+     * @param {Circle} other
+     * @returns {boolean}
+     */
+    overlaps(other) {
+        const x0 = this.x;
+        const y0 = this.y;
+        const r0 = this.r;
 
-    return circle_intersects_circle(x0, y0, r0, x1, y1, r1);
-};
+        const x1 = other.x;
+        const y1 = other.y;
+        const r1 = other.r;
 
-/**
- *
- * @param {Circle} other
- * @returns {boolean}
- */
-Circle.prototype.equals = function (other) {
-    return this.x === other.x && this.y === other.y && this.r === other.r;
-};
+        return circle_intersects_circle(x0, y0, r0, x1, y1, r1);
+    }
 
-/**
- *
- * @param {number} x
- * @param {number} y
- * @param {number} r
- */
-Circle.prototype.set = function (x, y, r) {
-    this.x = x;
-    this.y = y;
+    /**
+     *
+     * @param {Circle} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        return this.x === other.x && this.y === other.y && this.r === other.r;
+    }
 
-    this.r = r;
-};
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     * @param {number} r
+     */
+    set(x, y, r) {
+        this.x = x;
+        this.y = y;
 
-/**
- *
- * @param {Circle} other
- */
-Circle.prototype.copy = function (other) {
-    this.set(other.x, other.y, other.r);
-};
+        this.r = r;
+    }
 
-/**
- *
- * @returns {Circle}
- */
-Circle.prototype.clone = function () {
-    const result = new Circle(this.x, this.y, this.r);
+    /**
+     *
+     * @param {Circle} other
+     */
+    copy(other) {
+        this.set(other.x, other.y, other.r);
+    }
 
-    return result;
-};
+    /**
+     *
+     * @returns {Circle}
+     */
+    clone() {
+        return new Circle(this.x, this.y, this.r);
+    }
+}
 
 export default Circle;

package/src/core/geom/3d/cone/computeConePlaneSide.js

@@ -1,5 +1,5 @@
+import { v4_dot } from "../../vec4/v4_dot.js";
 import Vector3 from "../../Vector3.js";
-import { v4_dot } from "../../Vector4.js";
 
 const V1 = new Vector3();
 const V2 = new Vector3();

package/src/core/geom/3d/mat4/{allocate_transform_m4.d.ts → allocate_m4.d.ts}

@@ -2,5 +2,5 @@
  * custom Float32Array allocator, allocated memory in continuous chunks
  * @returns {Float32Array}
  */
-export function allocate_transform_m4(): Float32Array;
-//# sourceMappingURL=allocate_transform_m4.d.ts.map
+export function allocate_m4(): Float32Array;
+//# sourceMappingURL=allocate_m4.d.ts.map

package/src/core/geom/3d/mat4/allocate_m4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocate_m4.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/mat4/allocate_m4.js"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,+BAFa,YAAY,CAgBxB"}

package/src/core/geom/3d/mat4/{allocate_transform_m4.js → allocate_m4.js}

@@ -25,7 +25,7 @@ const MATRIX_BYTE_SIZE = 4 * 16;
  * custom Float32Array allocator, allocated memory in continuous chunks
  * @returns {Float32Array}
  */
-export function allocate_transform_m4() {
+export 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;