@woosh/meep-engine 2.102.0 → 2.103.0

package/build/meep.module.js

@@ -2476,7 +2476,7 @@ let Vector3$1 = class Vector3 {
     }
 
     /**
-     * @param {number} [squaredError=0.01]
+     * @param {number} [squaredError]
      * @return {boolean}
      */
     isNormalized(squaredError = 0.01) {
@@ -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;
     }
 
@@ -83404,7 +83403,7 @@ class ModuleRegistry {
  * @param {TaskGroup|Task} t
  * @returns {boolean}
  */
-function isGroup(t) {
+function isGroupTask(t) {
     return t.children instanceof Array;
 }
 
@@ -83412,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}
@@ -83524,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);
@@ -83547,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);
@@ -83644,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;
@@ -83681,6 +83685,7 @@ class ConcurrentExecutor {
     /**
      *
      * @param {Task} task
+     * @returns {boolean}
      */
     contains(task) {
         if (this.queueUnresolved.indexOf(task) !== -1) {
@@ -96211,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;
 }
 
@@ -102715,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 {
     /**

package/package.json

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

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/ConicRay.d.ts

@@ -1,6 +1,7 @@
 /**
  * Represents a direction vector+angle
  * Mainly used inside particle systems for pick a motion direction at spawn
+ * @copyright "Company Named Limited"
  */
 export class ConicRay {
     /**
@@ -14,9 +15,10 @@ export class ConicRay {
     static fromScalars(x: number, y: number, z: number, angle: number): ConicRay;
     /**
      * Must be normalized
+     * @readonly
      * @type {Vector3}
      */
-    direction: Vector3;
+    readonly direction: Vector3;
     /**
      * Half-angle of the cone, that is the angle between the center axis and the edge of the cone
      * In radians

package/src/core/geom/ConicRay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConicRay.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/ConicRay.js"],"names":[],"mappings":"AAQA;;;GAGG;AACH;IA2KI;;;;;;;OAOG;IACH,sBANW,MAAM,KACN,MAAM,KACN,MAAM,SACN,MAAM,GACJ,QAAQ,CAWpB;IA1LD;;;OAGG;IACH,WAFU,OAAO,CAEgB;IAEjC;;;;OAIG;IACH,OAFU,MAAM,CAEN;IAEV;;;MAKC;IAED,0BAGC;IAED;;;OAGG;IACH,2CAGC;IAED;;;OAGG;IACH,6CAMC;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAInB;IAED;;;;;OAKG;IACH,qBAJW,QAAQ,cACR,MAAM,GACJ,OAAO,CAKnB;IAED,eAKC;IAED;;;OAGG;IACH,YAFW,QAAQ,QAKlB;IAED;;;;OAIG;IACH,4BAHW,OAAO,GACL,OAAO,CAMnB;IAED;;;;;OAKG;IACH,gDAFW,OAAO,QAsEjB;CAoBJ;oBApMmB,cAAc"}
+{"version":3,"file":"ConicRay.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/ConicRay.js"],"names":[],"mappings":"AAQA;;;;GAIG;AACH;IA4KI;;;;;;;OAOG;IACH,sBANW,MAAM,KACN,MAAM,KACN,MAAM,SACN,MAAM,GACJ,QAAQ,CAWpB;IA3LD;;;;OAIG;IACH,oBAFU,OAAO,CAEgB;IAEjC;;;;OAIG;IACH,OAFU,MAAM,CAEN;IAEV;;;MAKC;IAED,0BAGC;IAED;;;OAGG;IACH,2CAGC;IAED;;;OAGG;IACH,6CAMC;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAInB;IAED;;;;;OAKG;IACH,qBAJW,QAAQ,cACR,MAAM,GACJ,OAAO,CAKnB;IAED,eAKC;IAED;;;OAGG;IACH,YAFW,QAAQ,QAKlB;IAED;;;;OAIG;IACH,4BAHW,OAAO,GACL,OAAO,CAMnB;IAED;;;;;OAKG;IACH,gDAFW,OAAO,QAsEjB;CAoBJ;oBAtMmB,cAAc"}

package/src/core/geom/ConicRay.js

@@ -1,19 +1,21 @@
-import {assert} from "../assert.js";
-import {computeHashIntegerArray} from "../collection/array/computeHashIntegerArray.js";
-import {EPSILON} from "../math/EPSILON.js";
-import {epsilonEquals} from "../math/epsilonEquals.js";
-import {computeHashFloat} from "../primitives/numbers/computeHashFloat.js";
+import { assert } from "../assert.js";
+import { computeHashIntegerArray } from "../collection/array/computeHashIntegerArray.js";
+import { EPSILON } from "../math/EPSILON.js";
+import { epsilonEquals } from "../math/epsilonEquals.js";
+import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 import Vector3 from "./Vector3.js";
 
 
 /**
  * Represents a direction vector+angle
  * Mainly used inside particle systems for pick a motion direction at spawn
+ * @copyright "Company Named Limited"
  */
 export class ConicRay {
 
     /**
      * Must be normalized
+     * @readonly
      * @type {Vector3}
      */
     direction = new Vector3(0, 1, 0);

package/src/core/geom/Vector1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Vector1.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector1.js"],"names":[],"mappings":";AAWA;IAwPI;;;;;OAKG;IACH,kBAJW,OAAO,KACP,OAAO,GACN,MAAM,CAIjB;IA/PD;;;;;;OAMG;IACH,gBALW,MAAM,EAchB;IAHG,UAAU;IAEV,0DAA6B;IAWjC;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAHW,OAAO,GACL,MAAM,CAIlB;IAED;;;;OAIG;IACH,OAHW,MAAM,GACJ,OAAO,CAgBnB;IAED;;;OAGG;IACH,aAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,UAFY,OAAO,CAIlB;IAED,kBAEC;IAED,kBAEC;IAED;;;;OAIG;IACH,iBAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,WAFW,OAAO,8BAAwB,WAIzC;IAED;;;;OAIG;IACH,iBAFY,OAAO,CAIlB;IAED;;;;OAIG;IACH,WAHW,OAAO,GACL,OAAO,CAInB;IAED;;;;OAIG;IACH,gBAHW,OAAO,GACL,OAAO,CAInB;IAED;;;OAGG;IACH,kBAFW,MAAM,QAIhB;IAED;;;;;OAKG;IACH,WAJW,MAAM,QACN,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,YAFW,OAAO,8BAAwB,QAIzC;IAED;;;OAGG;IACH,SAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,OAAO,GACL,OAAO,CAInB;IAED;;OAEG;IACH,QAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,4BAGC;IAED,iBAEC;IAED,yBAEC;IAED;;;;OAIG;IACH,qBAHW,MAAM,EAAE,WACR,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,EAAE,WACR,MAAM,QAIhB;IAED,oBAEC;IAED;;;OAGG;IACH,2CAEC;IAED;;;OAGG;IACH,6CAIC;IAgBD,mBAEC;IAND,gBAEC;IAaL;;;OAGG;IACH,oBAFU,OAAO,CAEU;IAXvB,sDAIC;CACJ;;;cAYS,OAAO;aAMP,OAAO;;mBAtSE,4BAA4B"}
+{"version":3,"file":"Vector1.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector1.js"],"names":[],"mappings":";AAWA;IA2PI;;;;;OAKG;IACH,kBAJW,OAAO,KACP,OAAO,GACN,MAAM,CAIjB;IAlQD;;;;;;OAMG;IACH,gBALW,MAAM,EAchB;IAHG,UAAU;IAEV,0DAA6B;IAWjC;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAHW,OAAO,GACL,MAAM,CAIlB;IAED;;;;OAIG;IACH,OAHW,MAAM,GACJ,OAAO,CAgBnB;IAED;;;OAGG;IACH,aAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,UAFY,OAAO,CAIlB;IAED,kBAEC;IAED,kBAEC;IAED;;;;OAIG;IACH,iBAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,WAFW,OAAO,8BAAwB,WAIzC;IAED;;;;OAIG;IACH,iBAFY,OAAO,CAIlB;IAED;;;;OAIG;IACH,WAHW,OAAO,GACL,OAAO,CAInB;IAED;;;;OAIG;IACH,gBAHW,OAAO,GACL,OAAO,CAInB;IAED;;;OAGG;IACH,kBAFW,MAAM,QAIhB;IAED;;;;;OAKG;IACH,WAJW,MAAM,QACN,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,YAFW,OAAO,8BAAwB,QAIzC;IAED;;;OAGG;IACH,SAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,OAAO,GACL,OAAO,CAInB;IAED;;OAEG;IACH,QAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,4BAGC;IAED,iBAEC;IAED,yBAEC;IAED;;;;OAIG;IACH,qBAHW,MAAM,EAAE,WACR,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,EAAE,WACR,MAAM,QAIhB;IAED,oBAEC;IAED;;;OAGG;IACH,2CAEC;IAED;;;OAGG;IACH,6CAIC;IAgBD,mBAEC;IAND,gBAEC;IAaL;;;OAGG;IACH,oBAFU,OAAO,CAEU;IAXvB,sDAIC;CACJ;;;cAYS,OAAO;aAMP,OAAO;;mBAzSE,4BAA4B"}

package/src/core/geom/Vector1.js

@@ -87,6 +87,9 @@ class Vector1 extends Number {
      * @param {number} x
      */
     setSilent(x) {
+        assert.isNumber( x,'x');
+        assert.notNaN(x, 'x');
+
         this.x = x;
     }
 

package/src/core/geom/Vector2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Vector2.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector2.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Vector2.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector2.js"],"names":[],"mappings":"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"}

package/src/core/geom/Vector2.js

@@ -20,10 +20,8 @@ import { v2_magnitude } from "./vec2/v2_magnitude.js";
 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) {
@@ -111,6 +109,11 @@ class Vector2 {
      * @param {number} y
      */
     setSilent(x, y) {
+        assert.isNumber(x, 'x');
+        assert.isNumber(y, 'y');
+
+        assert.notNaN(x, 'x');
+        assert.notNaN(y, 'y');
 
         this.x = x;
         this.y = y;

package/src/core/geom/Vector3.js

@@ -407,7 +407,7 @@ class Vector3 {
     }
 
     /**
-     * @param {number} [squaredError=0.01]
+     * @param {number} [squaredError]
      * @return {boolean}
      */
     isNormalized(squaredError = 0.01) {

package/src/core/geom/vec3/v3_angle_cos_between.spec.d.ts

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

package/src/core/geom/vec3/v3_angle_cos_between.spec.d.ts.map

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

package/src/core/geom/vec3/v3_angle_cos_between.spec.js

@@ -0,0 +1,124 @@
+import { v3_angle_cos_between } from "./v3_angle_cos_between.js";
+
+function validate_result(value) {
+    expect(typeof value).toBe("number");
+    expect(value).not.toBeNaN();
+    expect(value).toBeGreaterThanOrEqual(-1);
+    expect(value).toBeLessThanOrEqual(1);
+}
+
+test("zero-length vectors produce valid results", () => {
+
+    validate_result(v3_angle_cos_between(
+        0, 0, 0,
+        0, 0, 0
+    ));
+
+    validate_result(v3_angle_cos_between(
+        1, 0, 0,
+        0, 0, 0
+    ));
+
+    validate_result(v3_angle_cos_between(
+        0, 1, 0,
+        0, 0, 0
+    ));
+
+    validate_result(v3_angle_cos_between(
+        0, 0, 1,
+        0, 0, 0
+    ));
+
+    validate_result(v3_angle_cos_between(
+        0, 0, 0,
+        1, 0, 0
+    ));
+
+    validate_result(v3_angle_cos_between(
+        0, 0, 0,
+        0, 1, 0
+    ));
+
+    validate_result(v3_angle_cos_between(
+        0, 0, 0,
+        0, 0, 1
+    ));
+
+});
+test("Right angles", () => {
+
+    expect(v3_angle_cos_between(
+        1, 0, 0,
+        0, 1, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        1, 0, 0,
+        0, 0, 1
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        -1, 0, 0,
+        0, 1, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        -1, 0, 0,
+        0, 0, 1
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, 1, 0,
+        1, 0, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, 1, 0,
+        0, 0, 1
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, -1, 0,
+        1, 0, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, -1, 0,
+        0, 0, 1
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, 0, 1,
+        1, 0, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, 0, 1,
+        0, 1, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, 0, -1,
+        1, 0, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        0, 0, -1,
+        0, 1, 0
+    )).toBeCloseTo(0);
+
+});
+
+test("non-uniform vectors", () => {
+
+    expect(v3_angle_cos_between(
+        3, 0, 0,
+        0, 7, 0
+    )).toBeCloseTo(0);
+
+    expect(v3_angle_cos_between(
+        -3, 0, 0,
+        0, 7, 0
+    )).toBeCloseTo(0);
+
+});

package/src/core/geom/vec3/v3_distance_above_plane.d.ts

@@ -1,4 +1,13 @@
-export declare function v3_distance_above_plane(
-    x: number, y: number, z: number,
-    normalX: number, normalY: number, normalZ: number, planeConstant: number
-): number
+/**
+ * Orthogonal distance of a point to a plane, the distance is positive when the point lies above the plane and negative when the point is below
+ * @param {number} x
+ * @param {number} y
+ * @param {number} z
+ * @param {number} normalX
+ * @param {number} normalY
+ * @param {number} normalZ
+ * @param {number} planeConstant
+ * @returns {number}
+ */
+export function v3_distance_above_plane(x: number, y: number, z: number, normalX: number, normalY: number, normalZ: number, planeConstant: number): number;
+//# sourceMappingURL=v3_distance_above_plane.d.ts.map

package/src/core/geom/vec3/v3_distance_sqr.d.ts

@@ -1 +1,12 @@
-export function v3_distance_sqr(x0: number, y0: number, z0: number, x1: number, y1: number, z1: number): number
+/**
+ *
+ * @param {number} x0
+ * @param {number} y0
+ * @param {number} z0
+ * @param {number} x1
+ * @param {number} y1
+ * @param {number} z1
+ * @returns {number}
+ */
+export function v3_distance_sqr(x0: number, y0: number, z0: number, x1: number, y1: number, z1: number): number;
+//# sourceMappingURL=v3_distance_sqr.d.ts.map