@woosh/meep-engine 2.106.0 → 2.106.1

package/src/core/geom/Vector3.js

@@ -26,10 +26,23 @@ class Vector3 {
      * @constructor
      */
     constructor(x = 0, y = 0, z = 0) {
+        /**
+         * @type {number}
+         */
         this.x = x;
+        /**
+         * @type {number}
+         */
         this.y = y;
+        /**
+         * @type {number}
+         */
         this.z = z;
 
+        /**
+         * @readonly
+         * @type {Signal<number,number,number,number,number,number>}
+         */
         this.onChanged = new Signal();
     }
 
@@ -336,7 +349,11 @@ class Vector3 {
         const ax = first.x, ay = first.y, az = first.z;
         const bx = second.x, by = second.y, bz = second.z;
 
-        this._crossVectors(ax, ay, az, bx, by, bz);
+        this._crossVectors(
+            ax, ay, az,
+            bx, by, bz
+        );
+
     }
 
     /**
@@ -548,6 +565,7 @@ class Vector3 {
     /**
      *
      * @param {THREE.Matrix4} matrix4
+     * @deprecated use {@link @applyMatrix4} directly instead, pass `mat.elements`
      */
     applyMatrix4_three(matrix4) {
         this.applyMatrix4(matrix4.elements);
@@ -576,7 +594,9 @@ class Vector3 {
      * @param {ArrayLike<number>|number[]|Float32Array} m4
      */
     applyDirectionMatrix4(m4) {
-        const x = this.x, y = this.y, z = this.z;
+        const x = this.x;
+        const y = this.y;
+        const z = this.z;
 
         const _x = m4[0] * x + m4[4] * y + m4[8] * z;
         const _y = m4[1] * x + m4[5] * y + m4[9] * z;
@@ -607,25 +627,34 @@ class Vector3 {
     }
 
     /**
-     *
+     * @deprecated use non-three.js version instead
      * @param {THREE.Matrix3} m
      * @returns {Vector3}
      */
     applyMatrix3_three(m) {
+        this.applyMatrix3(m.elements);
 
-        const x = this.x, y = this.y, z = this.z;
-        const e = m.elements;
+        return this;
+    }
 
-        const _x = e[0] * x + e[3] * y + e[6] * z;
-        const _y = e[1] * x + e[4] * y + e[7] * z;
-        const _z = e[2] * x + e[5] * y + e[8] * z;
+    /**
+     *
+     * @param {number[]|Float32Array} mat
+     */
+    applyMatrix3(mat) {
+        const x = this.x;
+        const y = this.y;
+        const z = this.z;
 
-        return this.set(_x, _y, _z);
+        const _x = mat[0] * x + mat[3] * y + mat[6] * z;
+        const _y = mat[1] * x + mat[4] * y + mat[7] * z;
+        const _z = mat[2] * x + mat[5] * y + mat[8] * z;
 
+        this.set(_x, _y, _z);
     }
 
     /**
-     *
+     * @deprecated use non-three.js version instead
      * @param {THREE.Matrix4} matrix4
      */
     threejs_setFromMatrixPosition(matrix4) {
@@ -710,17 +739,7 @@ class Vector3 {
         const y1 = other.y;
         const z1 = other.z;
 
-        const d = v3_dot(x0, y0, z0, x1, y1, z1);
-
-        const mag2 = (x1 * x1 + y1 * y1 + z1 * z1);
-
-        const m = d / mag2;
-
-        const x = x1 * m;
-        const y = y1 * m;
-        const z = z1 * m;
-
-        this.set(x, y, z);
+        this._projectVectors(x0, y0, z0, x1, y1, z1);
     }
 
     /**
@@ -757,7 +776,10 @@ class Vector3 {
      * @param {number} y1
      * @param {number} z1
      */
-    _projectVectors(x0, y0, z0, x1, y1, z1) {
+    _projectVectors(
+        x0, y0, z0,
+        x1, y1, z1
+    ) {
 
         const d = v3_dot(x0, y0, z0, x1, y1, z1);
 
@@ -779,12 +801,24 @@ class Vector3 {
      * @param {number} theta
      */
     setFromSphericalCoords(radius, phi, theta) {
+        assert.isNumber(radius, 'radius');
+        assert.notNaN(radius, 'radius');
+
+        assert.isNumber(phi, 'phi');
+        assert.notNaN(phi, 'phi');
 
-        const sinPhiRadius = Math.sin(phi) * radius;
+        assert.isNumber(theta, 'theta');
+        assert.notNaN(theta, 'theta');
 
-        const _x = sinPhiRadius * Math.sin(theta);
-        const _y = Math.cos(phi) * radius;
-        const _z = sinPhiRadius * Math.cos(theta);
+        const sin_phi = Math.sin(phi);
+        const cos_phi = Math.cos(phi);
+
+        const sin_theta = Math.sin(theta);
+        const cos_theta = Math.cos(theta);
+
+        const _x = radius * sin_phi * sin_theta;
+        const _y = radius * cos_phi;
+        const _z = radius * sin_phi * cos_theta;
 
         this.set(_x, _y, _z);
     }
@@ -792,11 +826,15 @@ class Vector3 {
     /**
      *
      * @param {function} processor
+     * @param {*} [thisArg]
      * @returns {Vector3}
      */
-    process(processor) {
-        processor(this.x, this.y, this.z);
-        this.onChanged.add(processor);
+    process(processor, thisArg) {
+
+        processor.call(thisArg, this.x, this.y, this.z);
+
+        this.onChanged.add(processor, thisArg);
+
         return this;
     }
 
@@ -810,6 +848,7 @@ class Vector3 {
      */
     fromJSON(json) {
         if (typeof json === 'number') {
+            // special case where input is a number
             this.setScalar(json);
         } else {
             this.copy(json);
@@ -823,6 +862,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     toBinaryBuffer(buffer) {
         buffer.writeFloat64(this.x);
@@ -833,6 +873,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     fromBinaryBuffer(buffer) {
         const x = buffer.readFloat64();
@@ -845,6 +886,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     toBinaryBufferFloat32(buffer) {
         buffer.writeFloat32(this.x);
@@ -855,6 +897,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     fromBinaryBufferFloat32(buffer) {
         const x = buffer.readFloat32();
@@ -974,12 +1017,6 @@ Vector3.prototype.fromArray = Vector3.prototype.readFromArray;
 Vector3.prototype.toArray = Vector3.prototype.writeToArray;
 
 
-/**
- * @readonly
- * @type {boolean}
- */
-Vector3.prototype.isVector3 = true;
-
 /**
  * @readonly
  * @type {Vector3}
@@ -1036,10 +1073,20 @@ Vector3.forward = Object.freeze(new Vector3(0, 0, 1));
  */
 Vector3.back = Object.freeze(new Vector3(0, 0, -1));
 
+/**
+ * @readonly
+ * @type {boolean}
+ */
+Vector3.prototype.isVector3 = true;
+
+/**
+ * @readonly
+ * @type {string}
+ */
 Vector3.typeName = "Vector3";
 
 /**
- *
+ * @deprecated use {@link v3_dot} directly instead
  * @param {number} x0
  * @param {number} y0
  * @param {number} z0

package/src/core/geom/Vector3.spec.js

@@ -7,28 +7,28 @@ test('slerp', () => {
     const v = new Vector3();
 
     v3_slerp(v, 0, 0, 0, 0, 0, 0, 0);
-    expect(v.toJSON()).toEqual({x: 0, y: 0, z: 0});
+    expect(v.toJSON()).toEqual({ x: 0, y: 0, z: 0 });
 
     v3_slerp(v, 0, 0, 0, 0, 0, 0, 1);
-    expect(v.toJSON()).toEqual({x: 0, y: 0, z: 0});
+    expect(v.toJSON()).toEqual({ x: 0, y: 0, z: 0 });
 
     v3_slerp(v, 1, 1, 1, 1, 1, 1, 0);
-    expect(v.toJSON()).toEqual({x: 1, y: 1, z: 1});
+    expect(v.toJSON()).toEqual({ x: 1, y: 1, z: 1 });
 
     v3_slerp(v, 1, 1, 1, 1, 1, 1, 1);
-    expect(v.toJSON()).toEqual({x: 1, y: 1, z: 1});
+    expect(v.toJSON()).toEqual({ x: 1, y: 1, z: 1 });
 
     v3_slerp(v, -1, -1, -1, -1, -1, -1, 0);
-    expect(v.toJSON()).toEqual({x: -1, y: -1, z: -1});
+    expect(v.toJSON()).toEqual({ x: -1, y: -1, z: -1 });
 
     v3_slerp(v, -1, -1, -1, -1, -1, -1, 1);
-    expect(v.toJSON()).toEqual({x: -1, y: -1, z: -1});
+    expect(v.toJSON()).toEqual({ x: -1, y: -1, z: -1 });
 
     v3_slerp(v, 1, 1, 1, -1, -1, -1, 0);
-    expect(v.toJSON()).toEqual({x: 1, y: 1, z: 1});
+    expect(v.toJSON()).toEqual({ x: 1, y: 1, z: 1 });
 
     v3_slerp(v, 1, 1, 1, -1, -1, -1, 1);
-    expect(v.toJSON()).toEqual({x: -1, y: -1, z: -1});
+    expect(v.toJSON()).toEqual({ x: -1, y: -1, z: -1 });
 
 
     v3_slerp(v, 1, 0, 0, 0, 1, 0, 0.5);
@@ -123,10 +123,10 @@ test("iterator symbol", () => {
 
     const iterator = v[Symbol.iterator]();
 
-    expect(iterator.next()).toEqual({value: 5, done: false})
-    expect(iterator.next()).toEqual({value: 7, done: false})
-    expect(iterator.next()).toEqual({value: 11, done: false})
-    expect(iterator.next()).toEqual({done: true})
+    expect(iterator.next()).toEqual({ value: 5, done: false })
+    expect(iterator.next()).toEqual({ value: 7, done: false })
+    expect(iterator.next()).toEqual({ value: 11, done: false })
+    expect(iterator.next()).toEqual({ done: true })
 
 });
 
@@ -181,4 +181,105 @@ test("setFromSphericalCoords", () => {
     expect(v3.x).not.toBeNaN();
     expect(v3.y).not.toBeNaN();
     expect(v3.z).not.toBeNaN();
+});
+
+test("isZero", () => {
+
+    expect(new Vector3(0, 0, 0).isZero()).toBe(true);
+
+    expect(new Vector3(0, 0, 1).isZero()).toBe(false);
+    expect(new Vector3(0, 1, 0).isZero()).toBe(false);
+    expect(new Vector3(1, 0, 0).isZero()).toBe(false);
+
+    expect(new Vector3(0, 0, -1).isZero()).toBe(false);
+    expect(new Vector3(0, -1, 0).isZero()).toBe(false);
+    expect(new Vector3(-1, 0, 0).isZero()).toBe(false);
+
+});
+
+test("multiply", () => {
+
+    const a = new Vector3(1, -3, 5);
+    const b = new Vector3(7, 11, -13);
+
+    a.multiply(b);
+
+    expect(a.x).toEqual(7);
+    expect(a.y).toEqual(-33);
+    expect(a.z).toEqual(-65);
+
+});
+
+test("cross", () => {
+
+    const a = new Vector3(1, -3, 5);
+    const b = new Vector3(7, 11, -13);
+
+    a.cross(b);
+
+    expect(a.x).toEqual(-16);
+    expect(a.y).toEqual(48);
+    expect(a.z).toEqual(32);
+});
+
+test("normalize", () => {
+
+
+    const a = new Vector3(1, 0, 0);
+    a.normalize();
+    expect(a.x).toBeCloseTo(1);
+    expect(a.y).toBeCloseTo(0);
+    expect(a.z).toBeCloseTo(0);
+
+    const b = new Vector3(0, 1, 0);
+
+    b.normalize();
+    expect(b.x).toBeCloseTo(0);
+    expect(b.y).toBeCloseTo(1);
+    expect(b.z).toBeCloseTo(0);
+
+    const c = new Vector3(0, 0, 1);
+
+    c.normalize();
+    expect(c.x).toBeCloseTo(0);
+    expect(c.y).toBeCloseTo(0);
+    expect(c.z).toBeCloseTo(1);
+
+    const d = new Vector3(-1, 0, 0);
+
+    d.normalize();
+    expect(d.x).toBeCloseTo(-1);
+    expect(d.y).toBeCloseTo(0);
+    expect(d.z).toBeCloseTo(0);
+
+    const e = new Vector3(0, -1, 0);
+
+    e.normalize();
+    expect(e.x).toBeCloseTo(0);
+    expect(e.y).toBeCloseTo(-1);
+    expect(e.z).toBeCloseTo(0);
+
+    const f = new Vector3(0, 0, -1);
+
+    f.normalize();
+    expect(f.x).toBeCloseTo(0);
+    expect(f.y).toBeCloseTo(0);
+    expect(f.z).toBeCloseTo(-1);
+
+    // try zero
+    const g = new Vector3(0, 0, 0);
+
+    g.normalize()
+    expect(g.x).toBe(0);
+    expect(g.y).toBe(0);
+    expect(g.z).toBe(0);
+
+    // length resizing
+    const h = new Vector3(-3, -5, -7);
+
+    h.normalize()
+    expect(h.x).toBeCloseTo(-0.329292779969071);
+    expect(h.y).toBeCloseTo(-0.5488212999484517);
+    expect(h.z).toBeCloseTo(-0.7683498199278324);
+
 });

package/src/core/collection/set/Set.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Set.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/set/Set.js"],"names":[],"mappings":";AAOA;;GAEG;AACH;IAiBI;;;;;;OAMG;IACH,yBAIC;IA3BD;;OAEG;IACH;;;MAGE;IAEF;;;OAGG;IACH,aAAU;IAEV,eAAW;IAeX;;;OAGG;IACH,yBAEC;IAED;;;OAGG;IACH,oBAWC;IAED;;;OAGG;IACH,uBAWC;IAED;;;;;OAKG;IACH,wBAIC;IAED;;;OAGG;IACH,WAFa,OAAO,CAInB;IAED;;OAEG;IACH,cAIC;IAED;;;OAGG;IACH,iBAFW,QAAS,QAMnB;IAED;;;OAGG;IACH,qBAFW,QAAS,QAuBnB;IAED;;;;OAIG;IACH,2CAIC;IAED;;;OAGG;IACH,WAFa,GAAG,CAIf;CACJ;mBAjKkB,+BAA+B"}

package/src/core/geom/2d/Geometry2D.d.ts

@@ -1,31 +0,0 @@
-/**
- * 2D version of a polygon collection
- */
-export class Geometry2D {
-    /**
-     *
-     * @param {Geometry2D} g0
-     * @param {number[]} m0 Transform matrix for first geometry (m 3x3)
-     * @param {Geometry2D} g1
-     * @param {number[]} m1 Transform matrix for second geometry (m 3x3)
-     * @returns {boolean}
-     */
-    static overlapExists(g0: Geometry2D, m0: number[], g1: Geometry2D, m1: number[]): boolean;
-    /**
-     * @example [x,y,      x,y,      x,y]
-     * @type {number[]}
-     */
-    vertices: number[];
-    /**
-     * Triplets of indices of vertices making up a polygon
-     * @example [0,1,2,     3,4,5]
-     * @type {number[]}
-     */
-    indices: number[];
-    /**
-     * Bounding box
-     * @type {AABB2}
-     */
-    aabb: AABB2;
-}
-//# sourceMappingURL=Geometry2D.d.ts.map

package/src/core/geom/2d/Geometry2D.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Geometry2D.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/2d/Geometry2D.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IAuBI;;;;;;;OAOG;IACH,yBANW,UAAU,MACV,MAAM,EAAE,MACR,UAAU,MACV,MAAM,EAAE,GACN,OAAO,CAiBnB;IA3CG;;;OAGG;IACH,UAFU,MAAM,EAAE,CAEA;IAElB;;;;OAIG;IACH,SAFU,MAAM,EAAE,CAED;IAEjB;;;OAGG;IACH,YAAuB;CA2B9B"}

package/src/core/geom/2d/Geometry2D.js

@@ -1,59 +0,0 @@
-import AABB2 from "../AABB2.js";
-
-
-const aabb_0 = new AABB2();
-const aabb_1 = new AABB2();
-
-/**
- * 2D version of a polygon collection
- */
-export class Geometry2D {
-    constructor() {
-
-        /**
-         * @example [x,y,      x,y,      x,y]
-         * @type {number[]}
-         */
-        this.vertices = [];
-
-        /**
-         * Triplets of indices of vertices making up a polygon
-         * @example [0,1,2,     3,4,5]
-         * @type {number[]}
-         */
-        this.indices = [];
-
-        /**
-         * Bounding box
-         * @type {AABB2}
-         */
-        this.aabb = new AABB2();
-    }
-
-    /**
-     *
-     * @param {Geometry2D} g0
-     * @param {number[]} m0 Transform matrix for first geometry (m 3x3)
-     * @param {Geometry2D} g1
-     * @param {number[]} m1 Transform matrix for second geometry (m 3x3)
-     * @returns {boolean}
-     */
-    static overlapExists(g0, m0, g1, m1) {
-        // first check for AABB overlap
-
-        aabb_0.copy(g0.aabb);
-        aabb_0.applyMatrix3(m0);
-
-        aabb_1.copy(g1.aabb);
-        aabb_1.applyMatrix3(m1);
-
-        if (!aabb_0.overlapExists(aabb_1)) {
-            //no overlap
-            return false;
-        }
-
-        //overlap between AABBs, test individual triangle pairs
-    }
-}
-
-

package/src/core/geom/2d/UvUtils.d.ts

@@ -1,15 +0,0 @@
-/**
- * based on paper "Elliptification of Rectangular Imagery" by Chamberlain Fong, Joint Mathematics Meetings 2019, SIGMAA-ARTS
- * @param {Vector2} result
- * @param {number} u
- * @param {number} v
- */
-export function uv_mapCircleToSquare(result: Vector2, u: number, v: number): void;
-/**
- * based on paper "Elliptification of Rectangular Imagery" by Chamberlain Fong, Joint Mathematics Meetings 2019, SIGMAA-ARTS
- * @param {Vector2} result
- * @param {number} x
- * @param {number} y
- */
-export function uv_mapSquareToCircle(result: Vector2, x: number, y: number): void;
-//# sourceMappingURL=UvUtils.d.ts.map

package/src/core/geom/2d/UvUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UvUtils.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/2d/UvUtils.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,yDAHW,MAAM,KACN,MAAM,QA2BhB;AAED;;;;;GAKG;AACH,yDAHW,MAAM,KACN,MAAM,QAShB"}

package/src/core/geom/2d/UvUtils.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=UvUtils.spec.d.ts.map

package/src/core/geom/2d/UvUtils.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UvUtils.spec.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/2d/UvUtils.spec.js"],"names":[],"mappings":""}

package/src/core/geom/2d/UvUtils.spec.js

@@ -1,55 +0,0 @@
-import Vector2 from "../Vector2.js";
-import { uv_mapCircleToSquare, uv_mapSquareToCircle } from "./UvUtils.js";
-
-test("uv_mapCircleToSquare", () => {
-    const v = new Vector2();
-
-    function check(inputX, inputY, outputX, outputY) {
-
-        uv_mapCircleToSquare(v, inputX, inputY);
-
-        expect(v.x).toBeCloseTo(outputX);
-        expect(v.y).toBeCloseTo(outputY);
-    }
-
-    check(0, 0, 0, 0);
-
-    check(-1, 0, -1, 0);
-    check(1, 0, 1, 0);
-    check(0, -1, 0, -1);
-    check(0, 1, 0, 1);
-
-    const s = Math.SQRT1_2;
-
-    check(s, s, 1, 1);
-    check(-s, s, -1, 1);
-    check(-s, -s, -1, -1);
-    check(s, -s, 1, -1);
-});
-
-test("uv_mapSquareToCircle", () => {
-
-    const v = new Vector2();
-
-    function check(inputX, inputY, outputX, outputY) {
-
-        uv_mapSquareToCircle(v, inputX, inputY);
-
-        expect(v.x).toBeCloseTo(outputX);
-        expect(v.y).toBeCloseTo(outputY);
-    }
-
-    check(0, 0, 0, 0);
-
-    check(-1, 0, -1, 0);
-    check(1, 0, 1, 0);
-    check(0, -1, 0, -1);
-    check(0, 1, 0, 1);
-
-    const s = Math.SQRT1_2;
-
-    check(1, 1, s, s);
-    check(-1, 1, -s, s);
-    check(-1, -1, -s, -s);
-    check(1, -1, s, -s);
-});