@woosh/meep-engine 2.110.8 → 2.110.9

package/build/meep.module.js

@@ -1746,10 +1746,10 @@ const EPSILON = 0.000001;
  * Comparison of two numbers with a given tolerance
  * @param {number} a
  * @param {number} b
- * @param {number} tolerance
+ * @param {number} [tolerance]
  * @returns {boolean}
  */
-function epsilonEquals(a, b, tolerance) {
+function epsilonEquals(a, b, tolerance = EPSILON) {
 
     return Math.abs(a - b) <= tolerance;
 }
@@ -2605,10 +2605,10 @@ let Vector3$1 = class Vector3 {
 
         // calculate quat * vector
 
-        var ix = qw * x + qy * z - qz * y;
-        var iy = qw * y + qz * x - qx * z;
-        var iz = qw * z + qx * y - qy * x;
-        var iw = -qx * x - qy * y - qz * z;
+        const ix = qw * x + qy * z - qz * y;
+        const iy = qw * y + qz * x - qx * z;
+        const iz = qw * z + qx * y - qy * x;
+        const iw = -qx * x - qy * y - qz * z;
 
         // calculate result * inverse quat
 
@@ -3190,9 +3190,9 @@ Vector3$1.typeName = "Vector3";
  */
 Vector3$1._dot = v3_dot;
 
-const forward = new Vector3$1();
-const up = new Vector3$1();
-const right = new Vector3$1();
+const scratch_v3_a = new Vector3$1();
+const scratch_v3_b = new Vector3$1();
+const scratch_v3_c = new Vector3$1();
 
 const sin$1 = Math.sin;
 const cos$1 = Math.cos;
@@ -3293,12 +3293,12 @@ let Quaternion$1 = class Quaternion {
      * @param {number} uz up vector
      */
     _lookRotation(fx, fy, fz, ux, uy, uz) {
-        forward.set(fx, fy, fz);
-        forward.normalize();
+        scratch_v3_a.set(fx, fy, fz);
+        scratch_v3_a.normalize();
 
-        right._crossVectors(ux, uy, uz, forward.x, forward.y, forward.z);
+        scratch_v3_c._crossVectors(ux, uy, uz, scratch_v3_a.x, scratch_v3_a.y, scratch_v3_a.z);
 
-        if (right.lengthSq() === 0) {
+        if (scratch_v3_c.lengthSq() === 0) {
             // up and forward are parallel
 
             /*
@@ -3307,32 +3307,32 @@ let Quaternion$1 = class Quaternion {
              */
 
             if (Math.abs(uz) === 1) {
-                forward.x += 0.001;
+                scratch_v3_a.x += 0.001;
             } else {
-                forward.z += 0.001;
+                scratch_v3_a.z += 0.001;
             }
 
-            forward.normalize();
-            right._crossVectors(ux, uy, uz, forward.x, forward.y, forward.z);
+            scratch_v3_a.normalize();
+            scratch_v3_c._crossVectors(ux, uy, uz, scratch_v3_a.x, scratch_v3_a.y, scratch_v3_a.z);
 
         }
 
-        right.normalize();
+        scratch_v3_c.normalize();
 
-        up.crossVectors(forward, right);
+        scratch_v3_b.crossVectors(scratch_v3_a, scratch_v3_c);
 
         // construct partial transform matrix
-        const m00 = right.x;
-        const m10 = right.y;
-        const m20 = right.z;
+        const m00 = scratch_v3_c.x;
+        const m10 = scratch_v3_c.y;
+        const m20 = scratch_v3_c.z;
 
-        const m01 = up.x;
-        const m11 = up.y;
-        const m21 = up.z;
+        const m01 = scratch_v3_b.x;
+        const m11 = scratch_v3_b.y;
+        const m21 = scratch_v3_b.z;
 
-        const m02 = forward.x;
-        const m12 = forward.y;
-        const m22 = forward.z;
+        const m02 = scratch_v3_a.x;
+        const m12 = scratch_v3_a.y;
+        const m22 = scratch_v3_a.z;
 
         this.__setFromRotationMatrix(
             m00, m01, m02,
@@ -3366,7 +3366,7 @@ let Quaternion$1 = class Quaternion {
     }
 
     /**
-     *
+     * Makes this quaternion into an inverse of the other
      * @param {Quaternion} other
      */
     copyInverse(other) {
@@ -3386,7 +3386,7 @@ let Quaternion$1 = class Quaternion {
         const length_sqr = x * x + y * y + z * z + w * w;
 
         if (length_sqr === 0) {
-            this.set(0, 0, 0, 0);
+            this.set(0, 0, 0, 1);
             return;
         }
 
@@ -3442,6 +3442,7 @@ let Quaternion$1 = class Quaternion {
      * @param {number} angle
      */
     _fromAxisAngle(ax, ay, az, angle) {
+
         const halfAngle = angle * 0.5;
 
         const sinA2 = sin$1(halfAngle);
@@ -3480,7 +3481,7 @@ let Quaternion$1 = class Quaternion {
         // perform projection of rotation onto axis
         const d = v3_dot(x, y, z, axis.x, axis.y, axis.z);
 
-        const mag2 = (axis.x * axis.x + axis.y * axis.y + axis.z * axis.z);
+        const mag2 = axis.x * axis.x + axis.y * axis.y + axis.z * axis.z;
 
         const m = d / mag2;
 
@@ -3994,58 +3995,6 @@ let Quaternion$1 = class Quaternion {
         this.set(_x, _y, _z, _w);
     }
 
-    /**
-     * Based on blog post: http://lolengine.net/blog/2013/09/18/beautiful-maths-quaternion-from-vectors
-     * @param {Vector3} from
-     * @param {Vector3} to
-     */
-    fromNonUnitVectors(from, to) {
-        //quat quat::fromtwovectors(vec3 u, vec3 v)
-        // {
-        //     vec3 w = cross(u, v);
-        //     quat q = quat(dot(u, v), w.x, w.y, w.z);
-        //     q.w += length(q);
-        //     return normalize(q);
-        // }
-
-        const ax = from.x;
-        const ay = from.y;
-        const az = from.z;
-
-        const bx = to.x;
-        const by = to.y;
-        const bz = to.z;
-
-        //compute cross product
-        const crossX = ay * bz - az * by;
-        const crossY = az * bx - ax * bz;
-        const crossZ = ax * by - ay * bx;
-
-        const uv_dot = v3_dot(ax, ay, az, bx, by, bz);
-
-
-        const qX = crossX;
-        const qY = crossY;
-        const qZ = crossZ;
-        const qW = uv_dot;
-
-        const p0 = qX * qX + qY * qY + qZ * qZ;
-
-        const l0 = Math.sqrt(p0 + qW * qW);
-
-        const qW_1 = qW + l0;
-
-        //normalize result
-        const l1 = 1 / Math.sqrt(p0 + qW_1 * qW_1);
-
-        const x = qX * l1;
-        const y = qY * l1;
-        const z = qZ * l1;
-        const w = qW * l1;
-
-        this.set(x, y, z, w);
-    }
-
     /**
      * NOTE: Vectors need to be normalized
      * Based on blog post: http://lolengine.net/blog/2013/09/18/beautiful-maths-quaternion-from-vectors
@@ -49026,6 +48975,7 @@ function compute_typed_array_constructor_from_data_type(dt) {
  * @returns {boolean}
  */
 function is_typed_array_equals(a, b) {
+
     if (a === b) {
         // quick shortcut
         return true;
@@ -61405,7 +61355,6 @@ function arrayIndexByEquality(array, element, equals) {
  */
 function arraySetDiff(a, b, equals = strictEquals) {
 
-    // TODO we can do this faster if we use a comparator instead of equality and pre-sort the data
     const uniqueA = a.slice();
     const uniqueB = b.slice();
 
@@ -63456,7 +63405,13 @@ function needsSerialization(value) {
 
 class WorkerProxy {
 
+    /**
+     *
+     * @type {{}}
+     * @private
+     */
     __pending = {};
+
     __isRunning = false;
 
     /**
@@ -63484,11 +63439,12 @@ class WorkerProxy {
     /**
      * Invoke a given method on the worker, as defined by the `WorkerBuilder`
      * @template T
-     * @param {number} name Method's name
+     * @param {string} name Method's name
      * @param {Array} args
      * @return {Promise<T>} eventual result of the invoked method
      */
     $submitRequest(name, args) {
+
         const pending = this.__pending[name];
 
         const argumentCount = args.length;
@@ -63535,7 +63491,13 @@ class WorkerProxy {
         });
     }
 
+    /**
+     *
+     * @param {string} name
+     * @private
+     */
     __makeMethod(name) {
+
         if (this.__pending.hasOwnProperty(name)) {
             throw new Error(`Method '${name}' already defined`);
         }
@@ -63620,15 +63582,16 @@ class WorkerProxy {
     /**
      *
      * @param {number} id
-     * @param {string} methodName
+     * @param {string} method_name
      * @returns {boolean}
      */
-    cancelRequest(id, methodName) {
+    cancelRequest(id, method_name) {
+
         //find request
-        const requestQueue = this.__pending[methodName];
+        const requestQueue = this.__pending[method_name];
 
         if (requestQueue === undefined) {
-            throw new Error(`No request queue for method name '${methodName}'`);
+            throw new Error(`No request queue for method name '${method_name}'`);
         }
 
         const n = requestQueue.length;
@@ -63700,8 +63663,16 @@ const RxMatchFunctionName = /(function\s*)([a-zA-Z0-9_]+)?(\s*\([^\]]*\)\s*\{.*)
 
 class WorkerBuilder {
 
+    /**
+     *
+     * @type {string[]}
+     */
     imports = [];
     methods = {};
+    /**
+     *
+     * @type {{f:function, name:string}[]}
+     */
     functions = [];
     preamble = new LineBuilder();
 
@@ -75918,9 +75889,10 @@ function planeHash(plane) {
  * @template T
  * @param {T[]} array
  * @param {function(T):number} elementHashFunction
+ * @param {*} [thisArg]
  * @returns {number}
  */
-function computeHashArray(array, elementHashFunction) {
+function computeHashArray(array, elementHashFunction, thisArg) {
 
     const numArguments = array.length;
     let hash = numArguments;
@@ -75929,7 +75901,7 @@ function computeHashArray(array, elementHashFunction) {
 
         const singleValue = array[i];
 
-        const elementHash = elementHashFunction(singleValue);
+        const elementHash = elementHashFunction.call(thisArg, singleValue);
 
         hash = ((hash << 5) - hash) + elementHash;
         hash |= 0; // Convert to 32bit integer
@@ -76268,6 +76240,7 @@ function bitmap2sampler_gl(gl, sampler, bitmap) {
  *
  * @param {number[]|Uint8Array} a
  * @param {number[]|Uint8Array} b
+ * @returns {boolean}
  */
 function fastArrayEquals(a, b) {
     if (Array.isArray(a) || Array.isArray(b)) {
@@ -89108,7 +89081,13 @@ function compare_three_objects(a, b) {
  * @param {number} [maxIndex]
  * @return {number} Index
  */
-function binarySearchHighIndex(array, el, compareFunction, minIndex = 0, maxIndex = array.length - 1) {
+function binarySearchHighIndex(
+    array,
+    el,
+    compareFunction,
+    minIndex = 0,
+    maxIndex = array.length - 1
+) {
     let min = minIndex;
     let max = maxIndex;
 
@@ -98072,16 +98051,16 @@ ObjectPoolFactory.prototype.create = ObjectPoolFactory.prototype.get;
  */
 function isArrayEqual(first, second) {
 
-    const il = first.length;
+    const element_count = first.length;
 
-    if (il !== second.length) {
+    if (element_count !== second.length) {
         // arrays are of different size
         return false;
     }
 
     let i = 0;
 
-    for (; i < il; i++) {
+    for (; i < element_count; i++) {
 
         const a = first[i];
         const b = second[i];
@@ -98090,19 +98069,16 @@ function isArrayEqual(first, second) {
             continue;
         }
 
-
-        if (a === undefined) {
-            // A is undefined, and B is something else
-            return false;
-        }
-
-        if (a === null) {
-            // A is null and B is something else
+        if (
+            a === undefined || a === null
+            || b === undefined || b === null
+        ) {
+            // shortcut to avoid working with nulls and undefined values
             return false;
         }
 
         // try "equals" method
-        if (typeof a.equals === "function") {
+        if (typeof a === "object" && typeof a.equals === "function") {
 
             if (!a.equals(b)) {
                 return false;
@@ -115037,7 +115013,7 @@ function removeBindings(mapping, devices, proxies) {
 }
 
 /**
- * @deprecated Use {@link InputSystem} instead
+ * Prefer to use {@link InputSystem} instead
  */
 class InputControllerSystem extends System {
     constructor(devices) {
@@ -116104,6 +116080,17 @@ class EngineHarness {
         this.p = null;
     }
 
+    /**
+     * Quick initialization of the engine in a sensible default configuration
+     * @param {(config:EngineConfiguration,engine:Engine)=>*} [configuration]
+     * @return {Promise<Engine>}
+     */
+    static async bootstrap({ configuration } = {}) {
+        const harness = new EngineHarness();
+
+        return harness.initialize({ configuration });
+    }
+
     /**
      *
      * @param {Engine} engine
@@ -116121,7 +116108,7 @@ class EngineHarness {
     }
 
     /**
-     * @param {(config:EngineConfiguration,engine:Engine)=>*} configuration
+     * @param {(config:EngineConfiguration,engine:Engine)=>*} [configuration]
      * @param {boolean} [enable_localization] Whether or not to load localization data
      * @returns {Promise<Engine>}
      */

package/editor/tools/v2/TransformControls.js

@@ -36,6 +36,11 @@ const _tempQuaternion = new Quaternion();
 const _tempTransform = new Transform();
 
 class TransformControls extends GizmoNode {
+    /**
+     * Entity ID that we are controlling. -1 indicates no entity
+     * @type {number}
+     */
+    object = -1;
 
     /**
      *
@@ -49,7 +54,7 @@ class TransformControls extends GizmoNode {
 
         if (domElement === undefined) {
 
-            console.warn('THREE.TransformControls: The second parameter "domElement" is now mandatory.');
+            console.warn('TransformControls: The second parameter "domElement" is now mandatory.');
             domElement = document;
 
         }
@@ -197,7 +202,7 @@ class TransformControls extends GizmoNode {
     // updateMatrixWorld  updates key transformation variables
     update() {
 
-        if (this.object !== undefined) {
+        if (this.object !== -1) {
 
             this._parentPosition.set(0, 0, 0);
             this._parentScale.set(1, 1, 1);
@@ -222,7 +227,7 @@ class TransformControls extends GizmoNode {
 
     pointerHover(pointer) {
 
-        if (this.object === undefined || this.dragging === true) return;
+        if (this.object === -1 || this.dragging === true) return;
 
         _raycaster.setFromCamera(pointer, this.camera);
 
@@ -242,7 +247,7 @@ class TransformControls extends GizmoNode {
 
     pointerDown(pointer) {
 
-        if (this.object === undefined || this.dragging === true || pointer.button !== 0) return;
+        if (this.object === -1 || this.dragging === true || pointer.button !== 0) return;
 
         const ot = this.object_transform;
 
@@ -301,7 +306,7 @@ class TransformControls extends GizmoNode {
 
         }
 
-        if (object === undefined || axis === null || this.dragging === false || pointer.button !== -1) return;
+        if (object === -1 || axis === null || this.dragging === false || pointer.button !== -1) return;
 
         const object_transform = this.object_transform;
 
@@ -601,7 +606,7 @@ class TransformControls extends GizmoNode {
     // Detatch from object
     detach() {
 
-        this.object = undefined;
+        this.object = -1;
 
         this.visible = false;
         this.axis = null;

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.110.8",
+  "version": "2.110.9",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {
@@ -60,6 +60,7 @@
     "@rollup/plugin-terser": "0.4.3",
     "@rollup/plugin-strip": "3.0.2",
     "@types/three": "^0.135.0",
+    "@types/jest": "29.5.12",
     "babel-jest": "29.5.0",
     "jest": "29.6.4",
     "jest-environment-jsdom": "29.6.4",

package/src/core/UUID.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @deprecated
+ */
 export default class UUID {
     static generate(): string
 }

package/src/core/UUID.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UUID.d.ts","sourceRoot":"","sources":["../../../src/core/UUID.js"],"names":[],"mappings":";;;;AAOA;;;;GAIG;AACH,yBAFa,MAAM,CAIlB"}
+{"version":3,"file":"UUID.d.ts","sourceRoot":"","sources":["../../../src/core/UUID.js"],"names":[],"mappings":";;;;AAEA;;;;;GAKG;AACH,yBAFa,MAAM,CAIlB"}

package/src/core/UUID.js

@@ -1,19 +1,21 @@
-function replacer(c) {
-    const r = Math.random() * 16 | 0, v = c === 'x' ? r : (r & 0x3 | 0x8);
-    return v.toString(16);
-}
-
-const rx = /[xy]/g;
+import { UUID } from "../engine/ecs/guid/UUID.js";
 
 /**
  * Generates a variant 4 fully random UUID in string format
+ * @deprecated
  * NOTE: Prefer to use UUID component class instead as that implementation is more robust and has better entropy when it comes to randomness
  * @returns {string}
  */
 function uuid() {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(rx, replacer);
+    return UUID.v4().toString();
 }
 
+/**
+ * @deprecated
+ */
 export default {
+    /**
+     * @deprecated
+     */
     generate: uuid
 };

package/src/core/collection/array/arraySetDiff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arraySetDiff.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/arraySetDiff.js"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH;;;;EAqCC;6BAjD4B,gCAAgC"}
+{"version":3,"file":"arraySetDiff.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/arraySetDiff.js"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH;;;;EAoCC;6BAhD4B,gCAAgC"}

package/src/core/collection/array/arraySetDiff.js

@@ -17,7 +17,6 @@ export function arraySetDiff(a, b, equals = strictEquals) {
     assert.isArray(b, 'b');
     assert.isFunction(equals, 'equals');
 
-    // TODO we can do this faster if we use a comparator instead of equality and pre-sort the data
     const uniqueA = a.slice();
     const uniqueB = b.slice();
 

package/src/core/collection/array/binarySearchHighIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binarySearchHighIndex.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/binarySearchHighIndex.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,oIALyB,MAAM,aACpB,MAAM,aACN,MAAM,GACL,MAAM,CAwBjB"}
+{"version":3,"file":"binarySearchHighIndex.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/binarySearchHighIndex.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,oIALyB,MAAM,aACpB,MAAM,aACN,MAAM,GACL,MAAM,CA8BjB"}

package/src/core/collection/array/binarySearchHighIndex.js

@@ -7,7 +7,13 @@
  * @param {number} [maxIndex]
  * @return {number} Index
  */
-export function binarySearchHighIndex(array, el, compareFunction, minIndex = 0, maxIndex = array.length - 1) {
+export function binarySearchHighIndex(
+    array,
+    el,
+    compareFunction,
+    minIndex = 0,
+    maxIndex = array.length - 1
+) {
     let min = minIndex;
     let max = maxIndex;
 

package/src/core/collection/array/computeHashArray.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computeHashArray.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/computeHashArray.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,kFAHuB,MAAM,GAChB,MAAM,CAoBlB"}
+{"version":3,"file":"computeHashArray.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/computeHashArray.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,kFAJuB,MAAM,kBAEhB,MAAM,CAoBlB"}

package/src/core/collection/array/computeHashArray.js

@@ -4,9 +4,10 @@ import { assert } from "../../assert.js";
  * @template T
  * @param {T[]} array
  * @param {function(T):number} elementHashFunction
+ * @param {*} [thisArg]
  * @returns {number}
  */
-export function computeHashArray(array, elementHashFunction) {
+export function computeHashArray(array, elementHashFunction, thisArg) {
     assert.isArrayLike(array, 'array');
     assert.isFunction(elementHashFunction, 'elementHashFunction');
 
@@ -17,7 +18,7 @@ export function computeHashArray(array, elementHashFunction) {
 
         const singleValue = array[i];
 
-        const elementHash = elementHashFunction(singleValue);
+        const elementHash = elementHashFunction.call(thisArg, singleValue);
 
         hash = ((hash << 5) - hash) + elementHash;
         hash |= 0; // Convert to 32bit integer

package/src/core/collection/array/fastArrayEquals.d.ts

@@ -2,6 +2,7 @@
  *
  * @param {number[]|Uint8Array} a
  * @param {number[]|Uint8Array} b
+ * @returns {boolean}
  */
 export function fastArrayEquals(a: number[] | Uint8Array, b: number[] | Uint8Array): boolean;
 //# sourceMappingURL=fastArrayEquals.d.ts.map

package/src/core/collection/array/fastArrayEquals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fastArrayEquals.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/fastArrayEquals.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,mCAHW,MAAM,EAAE,GAAC,UAAU,KACnB,MAAM,EAAE,GAAC,UAAU,WAU7B"}
+{"version":3,"file":"fastArrayEquals.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/fastArrayEquals.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,mCAJW,MAAM,EAAE,GAAC,UAAU,KACnB,MAAM,EAAE,GAAC,UAAU,GACjB,OAAO,CAUnB"}

package/src/core/collection/array/fastArrayEquals.js

@@ -5,6 +5,7 @@ import { is_typed_array_equals } from "./typed/is_typed_array_equals.js";
  *
  * @param {number[]|Uint8Array} a
  * @param {number[]|Uint8Array} b
+ * @returns {boolean}
  */
 export function fastArrayEquals(a, b) {
     if (Array.isArray(a) || Array.isArray(b)) {

package/src/core/collection/array/isArrayEqual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isArrayEqual.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/isArrayEqual.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,6DAFY,OAAO,CAqDlB"}
+{"version":3,"file":"isArrayEqual.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/isArrayEqual.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,6DAFY,OAAO,CAkDlB"}

package/src/core/collection/array/isArrayEqual.js

@@ -14,16 +14,16 @@ export function isArrayEqual(first, second) {
     assert.defined(second, 'second');
     assert.isArray(second, 'second');
 
-    const il = first.length;
+    const element_count = first.length;
 
-    if (il !== second.length) {
+    if (element_count !== second.length) {
         // arrays are of different size
         return false;
     }
 
     let i = 0;
 
-    for (; i < il; i++) {
+    for (; i < element_count; i++) {
 
         const a = first[i];
         const b = second[i];
@@ -32,19 +32,16 @@ export function isArrayEqual(first, second) {
             continue;
         }
 
-
-        if (a === undefined) {
-            // A is undefined, and B is something else
-            return false;
-        }
-
-        if (a === null) {
-            // A is null and B is something else
+        if (
+            a === undefined || a === null
+            || b === undefined || b === null
+        ) {
+            // shortcut to avoid working with nulls and undefined values
             return false;
         }
 
         // try "equals" method
-        if (typeof a.equals === "function") {
+        if (typeof a === "object" && typeof a.equals === "function") {
 
             if (!a.equals(b)) {
                 return false;

package/src/core/collection/array/isArrayEqual.spec.d.ts

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