@woosh/meep-engine 2.124.10 → 2.124.12

package/README.md

@@ -13,7 +13,7 @@ To help get you started, various samples are provided under `/samples` folder. F
 
 ## Quality
 
-Meep is covered by 2,508 unit tests
+Meep is covered by 2,669 unit tests
 
 The aim is to [ensure quality](https://about.codecov.io/blog/the-case-against-100-code-coverage/). As a result, the tests are written to cover complex code first and to exhaustively validate critical algorithms.
 Most of the test code is significantly larger than the code that is being tested.

package/package.json

@@ -5,7 +5,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.124.10",
+  "version": "2.124.12",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/assert.d.ts

@@ -128,6 +128,14 @@ export namespace assert {
     import isFiniteNumber = isFinite;
     export { isFiniteNumber };
     /**
+     * More powerful and flexible assertion API based on matchers.
+     * Allows complex matching criteria to be constructed.
+     *
+     * see {@link Matcher}
+     * @example
+     *  assert.that(value,'value', anyOf(isNull(),isUndefined())); // will trigger iff !(value === undefined || value === null)
+     *  assert.that(value, 'value', isOneOf([3,7])); // will only trigger iff !(value === 3 || value === 7)
+     *
      * @template T
      * @param {T} value
      * @param {string} name

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

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/core/assert.js"],"names":[],"mappings":"AAgDA;;;;GAIG;AACH,0BAHW,OAAO,MACP,MAAM,QAMhB;;IAsJD;;;;;OAKG;IACH,eALa,CAAC,SACH,CAAC,0BAED,MAAM,QAUhB;;;;;;;;;;;;;;;IAmBD;;;;;;OAMG;IACH,oCALW,GAAC,SACD,KAAK,eACL,MAAM,eACN,MAAM,QAKhB;IAGD;;;;OAIG;IACH,gCAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,gCAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,iCAHW,OAAO,GAAC,GAAC,SACT,MAAM,QAQhB;IAED;;;;OAIG;IACH,kCAHW,WAAS,GAAC,SACV,MAAM,QAQhB;IAED;;;;OAIG;IACH,gCAHW,MAAO,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,iCAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,4CAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,wBAJa,CAAC,SACH,CAAC,EAAE,SACH,MAAM,QAOhB;IAED;;;;OAIG;IACH,4BAJa,CAAC,SACH,SAAS,CAAC,CAAC,CAAC,GAAC,CAAC,EAAE,GAAC,WAAW,GAAC,YAAY,SACzC,MAAM,QAOhB;IAGD;;;;OAIG;IACH,+BAHW,GAAC,uBASX;IAED;;;;OAIG;IACH,iCAHW,GAAC,uBASX;IAGD;;;;OAIG;IACH,8BAHW,GAAC,uBAOX;IAED;;;;OAIG;IACH,+BAHW,GAAC,uBASX;IAED;;;;OAIG;IACH,8BAHW,MAAM,SACN,MAAM,QAMhB;IAED;;;;;OAKG;IACH,gCAHW,MAAM,SACN,MAAM,QAMhB;;;IAQD;;;;;OAKG;IACH,qBALa,CAAC,SACH,CAAC,QACD,MAAM,WACN,OAAO,CAAC,CAAC,CAAC,QAkBpB;;AApcD;;;;;GAKG;AACH,0BALa,CAAC,KACH,CAAC,KACD,CAAC,MACD,MAAM,QAIhB;AAED;;;;GAIG;AACH,0BAHW,OAAO,MACP,MAAM,QAIhB;AAhCD;;;;;GAKG;AACH,uBALa,CAAC,KACH,CAAC,KACD,CAAC,MACD,MAAM,QAShB;AAqBD;;;;;GAKG;AACH,kCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAIhB;AAaD;;;;;GAKG;AACH,gCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,uCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AA5CD;;;;;GAKG;AACH,6BAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,oCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAKD;;;;;GAKG;AACH,+BAJW,GAAC,QACD,MAAM,cACN,MAAM,QAehB;AAED;;;;;GAKG;AACH,0BALa,CAAC,YACH,CAAC,EAAE,UACH,CAAC,YACD,MAAM,QAIhB;AAED;;;;;GAKG;AACH,4BALa,CAAC,YACH,CAAC,EAAE,UACH,CAAC,YACD,MAAM,QAIhB;AAED;;;;;GAKG;AACH,4BALa,CAAC,KACH,CAAC,EAAE,GAAC,SAAS,CAAC,CAAC,CAAC,GAAC,YAAY,GAAC,UAAU,KACxC,CAAC,EAAE,GAAC,SAAS,CAAC,CAAC,CAAC,GAAC,YAAY,GAAC,UAAU,YACxC,MAAM,QAMhB"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/core/assert.js"],"names":[],"mappings":"AAgDA;;;;GAIG;AACH,0BAHW,OAAO,MACP,MAAM,QAMhB;;IAsJD;;;;;OAKG;IACH,eALa,CAAC,SACH,CAAC,0BAED,MAAM,QAUhB;;;;;;;;;;;;;;;IAmBD;;;;;;OAMG;IACH,oCALW,GAAC,SACD,KAAK,eACL,MAAM,eACN,MAAM,QAKhB;IAGD;;;;OAIG;IACH,gCAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,gCAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,iCAHW,OAAO,GAAC,GAAC,SACT,MAAM,QAQhB;IAED;;;;OAIG;IACH,kCAHW,WAAS,GAAC,SACV,MAAM,QAQhB;IAED;;;;OAIG;IACH,gCAHW,MAAO,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,iCAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,4CAHW,MAAM,GAAC,GAAC,SACR,MAAM,QAQhB;IAED;;;;OAIG;IACH,wBAJa,CAAC,SACH,CAAC,EAAE,SACH,MAAM,QAOhB;IAED;;;;OAIG;IACH,4BAJa,CAAC,SACH,SAAS,CAAC,CAAC,CAAC,GAAC,CAAC,EAAE,GAAC,WAAW,GAAC,YAAY,SACzC,MAAM,QAOhB;IAGD;;;;OAIG;IACH,+BAHW,GAAC,uBASX;IAED;;;;OAIG;IACH,iCAHW,GAAC,uBASX;IAGD;;;;OAIG;IACH,8BAHW,GAAC,uBAOX;IAED;;;;OAIG;IACH,+BAHW,GAAC,uBASX;IAED;;;;OAIG;IACH,8BAHW,MAAM,SACN,MAAM,QAMhB;IAED;;;;;OAKG;IACH,gCAHW,MAAM,SACN,MAAM,QAMhB;;;IAQD;;;;;;;;;;;;;OAaG;IACH,qBALa,CAAC,SACH,CAAC,QACD,MAAM,WACN,OAAO,CAAC,CAAC,CAAC,QAwBpB;;AAldD;;;;;GAKG;AACH,0BALa,CAAC,KACH,CAAC,KACD,CAAC,MACD,MAAM,QAIhB;AAED;;;;GAIG;AACH,0BAHW,OAAO,MACP,MAAM,QAIhB;AAhCD;;;;;GAKG;AACH,uBALa,CAAC,KACH,CAAC,KACD,CAAC,MACD,MAAM,QAShB;AAqBD;;;;;GAKG;AACH,kCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAIhB;AAaD;;;;;GAKG;AACH,gCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,uCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AA5CD;;;;;GAKG;AACH,6BAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,oCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAKD;;;;;GAKG;AACH,+BAJW,GAAC,QACD,MAAM,cACN,MAAM,QAehB;AAED;;;;;GAKG;AACH,0BALa,CAAC,YACH,CAAC,EAAE,UACH,CAAC,YACD,MAAM,QAIhB;AAED;;;;;GAKG;AACH,4BALa,CAAC,YACH,CAAC,EAAE,UACH,CAAC,YACD,MAAM,QAIhB;AAED;;;;;GAKG;AACH,4BALa,CAAC,KACH,CAAC,EAAE,GAAC,SAAS,CAAC,CAAC,CAAC,GAAC,YAAY,GAAC,UAAU,KACxC,CAAC,EAAE,GAAC,SAAS,CAAC,CAAC,CAAC,GAAC,YAAY,GAAC,UAAU,YACxC,MAAM,QAMhB"}

package/src/core/assert.js

@@ -448,16 +448,30 @@ assert.isFinite = function (value, name = "value") {
 assert.isFiniteNumber = assert.isFinite;
 
 /**
+ * More powerful and flexible assertion API based on matchers.
+ * Allows complex matching criteria to be constructed.
+ *
+ * see {@link Matcher}
+ * @example
+ *  assert.that(value,'value', anyOf(isNull(),isUndefined())); // will trigger iff !(value === undefined || value === null)
+ *  assert.that(value, 'value', isOneOf([3,7])); // will only trigger iff !(value === 3 || value === 7)
+ *
  * @template T
  * @param {T} value
  * @param {string} name
  * @param {Matcher<T>} matcher
  */
 assert.that = function (value, name, matcher) {
+    assert.isString(name, 'name');
+    assert.defined(matcher, 'matcher');
+
     if (matcher.matches(value)) {
         return;
     }
 
+    // if we got here, our assertion has failed
+    // construct failure message
+
     const mismatch_description = new InMemoryDescriptor();
 
     mismatch_description.appendText(`Expected ${name} to be `);

package/src/core/debug/matchers/IsFinite.d.ts

@@ -0,0 +1,6 @@
+export class IsFinite extends BaseMatcher {
+    matches(item: any, mismatch_description: any): boolean;
+    describeTo(description: any): void;
+}
+import { BaseMatcher } from "../BaseMatcher.js";
+//# sourceMappingURL=IsFinite.d.ts.map

package/src/core/debug/matchers/IsFinite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsFinite.d.ts","sourceRoot":"","sources":["../../../../../src/core/debug/matchers/IsFinite.js"],"names":[],"mappings":"AAEA;IACI,uDAEC;IAED,mCAEC;CACJ;4BAV2B,mBAAmB"}

package/src/core/debug/matchers/IsFinite.js

@@ -0,0 +1,11 @@
+import { BaseMatcher } from "../BaseMatcher.js";
+
+export class IsFinite extends BaseMatcher {
+    matches(item, mismatch_description) {
+        return Number.isFinite(item);
+    }
+
+    describeTo(description) {
+        description.appendText("finite");
+    }
+}

package/src/core/debug/matchers/IsInteger.d.ts

@@ -0,0 +1,6 @@
+export class IsInteger extends BaseMatcher {
+    matches(item: any, mismatch_description: any): boolean;
+    describeTo(description: any): void;
+}
+import { BaseMatcher } from "../BaseMatcher.js";
+//# sourceMappingURL=IsInteger.d.ts.map

package/src/core/debug/matchers/IsInteger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsInteger.d.ts","sourceRoot":"","sources":["../../../../../src/core/debug/matchers/IsInteger.js"],"names":[],"mappings":"AAEA;IACI,uDAEC;IAED,mCAEC;CACJ;4BAV2B,mBAAmB"}

package/src/core/debug/matchers/IsInteger.js

@@ -0,0 +1,11 @@
+import { BaseMatcher } from "../BaseMatcher.js";
+
+export class IsInteger extends BaseMatcher {
+    matches(item, mismatch_description) {
+        return Number.isInteger(item);
+    }
+
+    describeTo(description) {
+        description.appendText("integer");
+    }
+}

package/src/core/debug/matchers/IsUndefined.js

@@ -9,3 +9,4 @@ export class IsUndefined extends BaseMatcher {
         description.appendText("undefined");
     }
 }
+

package/src/core/debug/matchers/matchers.d.ts

@@ -48,6 +48,9 @@ export function isUndefined<T_1>(): Matcher<T_1>;
  * @return {Matcher<T>}
  */
 export function isDefined<T_1>(): Matcher<T_1>;
+export function isFinite(): IsFinite;
+export function isInfinite(): Matcher<any>;
+export function isInteger(): IsInteger;
 /**
  * @template T
  * @param {Matcher|T} value
@@ -85,4 +88,6 @@ export function nothing<T_1>(message?: string): Matcher<T_1>;
  */
 export function isNotUndefined<T_1>(): Matcher<T_1>;
 import { Matcher } from "../Matcher.js";
+import { IsFinite } from "./IsFinite.js";
+import { IsInteger } from "./IsInteger.js";
 //# sourceMappingURL=matchers.d.ts.map

package/src/core/debug/matchers/matchers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../../../../src/core/debug/matchers/matchers.js"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wCAHW,OAAO,CAAC,GAAC,CAAC,GACT,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,wCAHW,OAAO,CAAC,GAAC,CAAC,GACT,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,kCAHW,OAAO,CAAC,GAAC,CAAC,GACT,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,oCAHW,GAAC,GACA,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,uCAHW,GAAC,GACA,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,+BAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,kCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,oCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,kCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAQD;;;;GAIG;AACH,oCAHW,eAAQ,GAAC,GACR,OAAO,CAAC,GAAC,CAAC,CAQrB;AAED;;;;GAIG;AACH,iCAHW,GAAC,EAAE,GACD,OAAO,CAAC,GAAC,CAAC,CAItB;AAGD;;;;GAIG;AACH,0CAHW,GAAC,GACA,OAAO,CAAC,GAAC,CAAC,CAIrB;AAcD;;;;;GAKG;AACH,wCAHW,MAAM,GACL,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,uCAHW,MAAM,GACL,OAAO,CAAC,GAAC,CAAC,CAUrB;AAjFD;;;GAGG;AACH,uCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;wBAvFuB,eAAe"}
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../../../../src/core/debug/matchers/matchers.js"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wCAHW,OAAO,CAAC,GAAC,CAAC,GACT,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,wCAHW,OAAO,CAAC,GAAC,CAAC,GACT,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,kCAHW,OAAO,CAAC,GAAC,CAAC,GACT,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,oCAHW,GAAC,GACA,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,uCAHW,GAAC,GACA,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,+BAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,kCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,oCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;GAGG;AACH,kCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;AAQD,qCAEC;AAED,2CAEC;AAED,uCAEC;AAED;;;;GAIG;AACH,oCAHW,eAAQ,GAAC,GACR,OAAO,CAAC,GAAC,CAAC,CAQrB;AAED;;;;GAIG;AACH,iCAHW,GAAC,EAAE,GACD,OAAO,CAAC,GAAC,CAAC,CAItB;AAGD;;;;GAIG;AACH,0CAHW,GAAC,GACA,OAAO,CAAC,GAAC,CAAC,CAIrB;AAcD;;;;;GAKG;AACH,wCAHW,MAAM,GACL,OAAO,CAAC,GAAC,CAAC,CAIrB;AAED;;;;GAIG;AACH,uCAHW,MAAM,GACL,OAAO,CAAC,GAAC,CAAC,CAUrB;AA7FD;;;GAGG;AACH,uCAFY,OAAO,CAAC,GAAC,CAAC,CAIrB;wBAzFuB,eAAe;yBAMd,eAAe;0BAEd,gBAAgB"}

package/src/core/debug/matchers/matchers.js

@@ -4,7 +4,9 @@ import { AnyOf } from "./AnyOf.js";
 import { DescribeAs } from "./DescribeAs.js";
 import { IsAnything } from "./IsAnything.js";
 import { IsEqual } from "./IsEqual.js";
+import { IsFinite } from "./IsFinite.js";
 import { IsIn } from "./IsIn.js";
+import { IsInteger } from "./IsInteger.js";
 import { IsIterableContaining } from "./IsIterableContaining.js";
 import { IsNot } from "./IsNot.js";
 import { IsNull } from "./IsNull.js";
@@ -93,6 +95,18 @@ export function isDefined() {
  */
 export const isNotUndefined = isDefined;
 
+export function isFinite(){
+    return new IsFinite();
+}
+
+export function isInfinite(){
+    return not(isFinite());
+}
+
+export function isInteger(){
+    return new IsInteger();
+}
+
 /**
  * @template T
  * @param {Matcher|T} value

package/src/core/math/interval/NumericInterval.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Defines a numeric interval, by min and max.
+ * Provides a suite of interval logic operations.
+ * Interval can be of 0 width.
+ */
 export class NumericInterval {
     /**
      *
@@ -25,13 +30,15 @@ export class NumericInterval {
      *
      * @param {number} min
      * @param {number} max
+     * @returns {this}
      */
-    set(min: number, max: number): void;
+    set(min: number, max: number): this;
     /**
      *
      * @param {number} value
+     * @returns {this}
      */
-    multiplyScalar(value: number): void;
+    multiplyScalar(value: number): this;
     /**
      * Compute normalized position of input within this interval, where result is 0 if input is equal to `min`, and 1 when input is equal to `max`
      * @param {number} v value to be normalized
@@ -49,11 +56,6 @@ export class NumericInterval {
      * @returns {boolean}
      */
     isExact(): boolean;
-    /**
-     *
-     * @returns {number}
-     */
-    computeAverage(): number;
     /**
      *
      * @param {function} random Random number generator function, must return values between 0 and 1
@@ -65,6 +67,19 @@ export class NumericInterval {
         min: number;
         max: number;
     };
+    /**
+     *
+     * @param {number[]|Float32Array|Float64Array} array
+     * @param {number} [offset=0]
+     */
+    fromArray(array: number[] | Float32Array | Float64Array, offset?: number): this;
+    /**
+     *
+     * @param {number[]|Float32Array|Float64Array} [destination=[]]
+     * @param {number} [offset=0]
+     * @return {number[]}
+     */
+    toArray(destination?: number[] | Float32Array | Float64Array, offset?: number): number[];
     toString(): string;
     /**
      *
@@ -79,8 +94,27 @@ export class NumericInterval {
     /**
      *
      * @param {NumericInterval} other
+     * @returns {this}
+     */
+    copy(other: NumericInterval): this;
+    /**
+     * Performs union operation with another interval, mutates current interval.
+     * @param {NumericInterval} other
+     * @returns {this}
+     */
+    union(other: NumericInterval): this;
+    /**
+     *
+     * @param {NumericInterval} other
+     * @return {boolean}
      */
-    copy(other: NumericInterval): void;
+    overlaps(other: NumericInterval): boolean;
+    /**
+     *
+     * @param {NumericInterval} other
+     * @return {boolean}
+     */
+    contains(other: NumericInterval): boolean;
     /**
      *
      * @param {NumericInterval} other
@@ -93,10 +127,16 @@ export class NumericInterval {
      */
     hash(): number;
     /**
-     * Distance between min and max (= max - min)
+     * Distance between min and max (`= max - min`)
      * @returns {number}
      */
     get span(): number;
+    get middle(): number;
+    /**
+     * @deprecated use {@link middle} instead
+     * @returns {number}
+     */
+    computeAverage(): number;
     /**
      * @readonly
      * @type {boolean}

package/src/core/math/interval/NumericInterval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumericInterval.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/interval/NumericInterval.js"],"names":[],"mappings":"AAKA;IACI;;;;;OAKG;IACH,kBAJW,MAAM,QACN,MAAM,EA4BhB;IAhBG;;;OAGG;IACH,KAFU,MAAM,CAEF;IACd;;;OAGG;IACH,KAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,oBAFU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAEnB;IAIjC;;;;OAIG;IACH,SAHW,MAAM,OACN,MAAM,QA0BhB;IAGD;;;OAGG;IACH,sBAFW,MAAM,QAahB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,UAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,WAFa,OAAO,CAInB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,gCAFa,MAAM,CAMlB;IAED,0BAEC;IAED;;;MAKC;IAED,mBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAKtB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAKtB;IAED;;;OAGG;IACH,YAFW,eAAe,QAIzB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,QAFa,MAAM,CAQlB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAGL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAN1C;;mBAUS,eAAe;kBAMf,eAAe;iBAMf,eAAe;;mBAhON,+BAA+B"}
+{"version":3,"file":"NumericInterval.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/interval/NumericInterval.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACI;;;;;OAKG;IACH,kBAJW,MAAM,QACN,MAAM,EA4BhB;IAhBG;;;OAGG;IACH,KAFU,MAAM,CAEF;IACd;;;OAGG;IACH,KAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,oBAFU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAEnB;IAIjC;;;;;OAKG;IACH,SAJW,MAAM,OACN,MAAM,GACJ,IAAI,CA6BhB;IAGD;;;;OAIG;IACH,sBAHW,MAAM,GACJ,IAAI,CAchB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,UAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,WAFa,OAAO,CAInB;IAGD;;;;OAIG;IACH,gCAFa,MAAM,CAOlB;IAED,0BAEC;IAED;;;MAKC;IAED;;;;OAIG;IACH,iBAHW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,WAClC,MAAM,QAIhB;IAED;;;;;OAKG;IACH,sBAJW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,WAClC,MAAM,GACL,MAAM,EAAE,CAOnB;IAED,mBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAKtB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAKtB;IAED;;;;OAIG;IACH,YAHW,eAAe,GACb,IAAI,CAIhB;IAED;;;;OAIG;IACH,aAHW,eAAe,GACb,IAAI,CAShB;IAED;;;;OAIG;IACH,gBAHW,eAAe,GACd,OAAO,CAMlB;IAED;;;;OAIG;IACH,gBAHW,eAAe,GACd,OAAO,CAMlB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAQlB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED,qBAEC;IAED;;;OAGG;IACH,kBAFa,MAAM,CAIlB;IAGL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAN1C;;mBAUS,eAAe;kBAMf,eAAe;iBAMf,eAAe;;mBA9SN,+BAA+B"}

package/src/core/math/interval/NumericInterval.js

@@ -3,6 +3,11 @@ import Signal from "../../events/signal/Signal.js";
 import { computeHashFloat } from "../../primitives/numbers/computeHashFloat.js";
 import { inverseLerp } from "../inverseLerp.js";
 
+/**
+ * Defines a numeric interval, by min and max.
+ * Provides a suite of interval logic operations.
+ * Interval can be of 0 width.
+ */
 export class NumericInterval {
     /**
      *
@@ -42,6 +47,7 @@ export class NumericInterval {
      *
      * @param {number} min
      * @param {number} max
+     * @returns {this}
      */
     set(min, max) {
         assert.isNumber(min, 'min');
@@ -56,23 +62,27 @@ export class NumericInterval {
         const oldMax = this.max;
 
         if (min === oldMin && max === oldMax) {
-            return;
+            // no change
+            return this;
         }
 
         this.min = min;
         this.max = max;
 
         if (!this.onChanged.hasHandlers()) {
-            return;
+            return this;
         }
 
         this.onChanged.send4(min, max, oldMin, oldMax);
+
+        return this;
     }
 
 
     /**
      *
      * @param {number} value
+     * @returns {this}
      */
     multiplyScalar(value) {
         const v0 = this.min * value;
@@ -82,9 +92,10 @@ export class NumericInterval {
             //probably negative scale
             this.set(v1, v0);
         } else {
-
             this.set(v0, v1);
         }
+
+        return this;
     }
 
     /**
@@ -113,13 +124,6 @@ export class NumericInterval {
         return this.min === this.max;
     }
 
-    /**
-     *
-     * @returns {number}
-     */
-    computeAverage() {
-        return (this.min + this.max) * 0.5;
-    }
 
     /**
      *
@@ -129,7 +133,8 @@ export class NumericInterval {
     sampleRandom(random) {
         assert.isFunction(random, "random");
 
-        return this.min + random() * (this.max - this.min);
+        const span = this.max - this.min;
+        return this.min + random() * span;
     }
 
     fromJSON(json) {
@@ -143,6 +148,28 @@ export class NumericInterval {
         };
     }
 
+    /**
+     *
+     * @param {number[]|Float32Array|Float64Array} array
+     * @param {number} [offset=0]
+     */
+    fromArray(array, offset = 0) {
+        return this.set(array[offset], array[offset + 1]);
+    }
+
+    /**
+     *
+     * @param {number[]|Float32Array|Float64Array} [destination=[]]
+     * @param {number} [offset=0]
+     * @return {number[]}
+     */
+    toArray(destination = [], offset = 0) {
+        destination[offset] = this.min;
+        destination[offset + 1] = this.max;
+
+        return destination;
+    }
+
     toString() {
         return `NumericInterval{ min=${this.min}, max=${this.max} }`;
     }
@@ -168,9 +195,46 @@ export class NumericInterval {
     /**
      *
      * @param {NumericInterval} other
+     * @returns {this}
      */
     copy(other) {
-        this.set(other.min, other.max);
+        return this.set(other.min, other.max);
+    }
+
+    /**
+     * Performs union operation with another interval, mutates current interval.
+     * @param {NumericInterval} other
+     * @returns {this}
+     */
+    union(other) {
+        assert.equal(other.isNumericInterval, true, "other must be a NumericInterval");
+
+        return this.set(
+            Math.min(this.min, other.min),
+            Math.max(this.max, other.max)
+        );
+    }
+
+    /**
+     *
+     * @param {NumericInterval} other
+     * @return {boolean}
+     */
+    overlaps(other) {
+        assert.equal(other.isNumericInterval, true, "other must be a NumericInterval");
+
+        return this.min < other.max && this.max > other.min;
+    }
+
+    /**
+     *
+     * @param {NumericInterval} other
+     * @return {boolean}
+     */
+    contains(other) {
+        assert.equal(other.isNumericInterval, true, "other must be a NumericInterval");
+
+        return this.min <= other.min && this.max >= other.max;
     }
 
     /**
@@ -179,6 +243,8 @@ export class NumericInterval {
      * @returns {boolean}
      */
     equals(other) {
+        assert.equal(other.isNumericInterval, true, "other must be a NumericInterval");
+
         return this.min === other.min && this.max === other.max;
     }
 
@@ -195,12 +261,24 @@ export class NumericInterval {
     }
 
     /**
-     * Distance between min and max (= max - min)
+     * Distance between min and max (`= max - min`)
      * @returns {number}
      */
     get span() {
         return this.max - this.min;
     }
+
+    get middle() {
+        return (this.max + this.min) * 0.5;
+    }
+
+    /**
+     * @deprecated use {@link middle} instead
+     * @returns {number}
+     */
+    computeAverage() {
+        return this.middle;
+    }
 }
 
 /**

package/src/core/math/spline/spline_hermite3.d.ts

@@ -7,6 +7,9 @@
  * @param {number} m0 first tangent (tangent exiting from first value)
  * @param {number} m1 second tangent (tangent entering into second value)
  * @return {number}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function spline_hermite3(t: number, p0: number, p1: number, m0: number, m1: number): number;
 //# sourceMappingURL=spline_hermite3.d.ts.map

package/src/core/math/spline/spline_hermite3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spline_hermite3.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline_hermite3.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,mCAPW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACL,MAAM,CAajB"}
+{"version":3,"file":"spline_hermite3.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline_hermite3.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,mCAVW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACL,MAAM,CAgBjB"}

package/src/core/math/spline/spline_hermite3.js

@@ -7,6 +7,9 @@
  * @param {number} m0 first tangent (tangent exiting from first value)
  * @param {number} m1 second tangent (tangent entering into second value)
  * @return {number}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function spline_hermite3(t, p0, p1, m0, m1) {
 

package/src/core/math/spline/spline_hermite3_bounds.d.ts

@@ -1,17 +1,17 @@
 /**
- * Compute bounds of a 3-rd degree hermite curve
- * Note that this is a 1d case solver
+ * Compute `y0,y1` bounds of a cubic hermite spline.
  * Lower bound will be written into result[offset], upper bounds will be written into result[offset+result_stride]
- * Solution is based on https://stackoverflow.com/questions/24809978/calculating-the-bounding-box-of-cubic-bezier-curve
- * Differentiation of hermite polynomial is done in WolframAlpha
- * 0 = 3 t^2 (m0 + m1 + 2 p0 - 2 p1) - 2 t (2 m0 + m1 + 3 p0 - 3 p1) + m0
- * @param {number[]|Float32Array} result
+ *
+ * @param {number[]|Float32Array} result output will be written here, only y0 and y1
  * @param {number} result_offset offset into the result array
- * @param {number} result_stride
+ * @param {number} result_stride useful for mixing multidimensional results
  * @param {number} p0
  * @param {number} p1
  * @param {number} m0
  * @param {number} m1
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function spline_hermite3_bounds(result: number[] | Float32Array, result_offset: number, result_stride: number, p0: number, p1: number, m0: number, m1: number): void;
 //# sourceMappingURL=spline_hermite3_bounds.d.ts.map

package/src/core/math/spline/spline_hermite3_bounds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spline_hermite3_bounds.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline_hermite3_bounds.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,+CARW,MAAM,EAAE,GAAC,YAAY,iBACrB,MAAM,iBACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QA4EhB"}
+{"version":3,"file":"spline_hermite3_bounds.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline_hermite3_bounds.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,+CAXW,MAAM,EAAE,GAAC,YAAY,iBACrB,MAAM,iBACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAqFhB"}

package/src/core/math/spline/spline_hermite3_bounds.js

@@ -4,19 +4,19 @@ import { min2 } from "../min2.js";
 import { spline_hermite3 } from "./spline_hermite3.js";
 
 /**
- * Compute bounds of a 3-rd degree hermite curve
- * Note that this is a 1d case solver
+ * Compute `y0,y1` bounds of a cubic hermite spline.
  * Lower bound will be written into result[offset], upper bounds will be written into result[offset+result_stride]
- * Solution is based on https://stackoverflow.com/questions/24809978/calculating-the-bounding-box-of-cubic-bezier-curve
- * Differentiation of hermite polynomial is done in WolframAlpha
- * 0 = 3 t^2 (m0 + m1 + 2 p0 - 2 p1) - 2 t (2 m0 + m1 + 3 p0 - 3 p1) + m0
- * @param {number[]|Float32Array} result
+ *
+ * @param {number[]|Float32Array} result output will be written here, only y0 and y1
  * @param {number} result_offset offset into the result array
- * @param {number} result_stride
+ * @param {number} result_stride useful for mixing multidimensional results
  * @param {number} p0
  * @param {number} p1
  * @param {number} m0
  * @param {number} m1
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function spline_hermite3_bounds(
     result,
@@ -24,6 +24,12 @@ export function spline_hermite3_bounds(
     result_stride,
     p0, p1, m0, m1) {
 
+    /*
+     Solution is based on https://stackoverflow.com/questions/24809978/calculating-the-bounding-box-of-cubic-bezier-curve
+     Differentiation of hermite polynomial is done in WolframAlpha:
+     0 = 3 t^2 (m0 + m1 + 2 p0 - 2 p1) - 2 t (2 m0 + m1 + 3 p0 - 3 p1) + m0
+    */
+
     assert.greaterThan(result_stride, 0, 'result_stride must be greater than 0');
     assert.isInteger(result_stride, 'result_stride');
 

package/src/core/model/ObservedBoolean.d.ts

@@ -2,10 +2,10 @@ export default ObservedBoolean;
 declare class ObservedBoolean extends Boolean {
     /**
      *
-     * @param {boolean} value
+     * @param {boolean} [value=false]
      * @constructor
      */
-    constructor(value: boolean);
+    constructor(value?: boolean);
     /**
      * @readonly
      * @type {Signal<boolean,boolean>}
@@ -50,7 +50,7 @@ declare class ObservedBoolean extends Boolean {
     process(f: (arg0: boolean, arg1: boolean) => any, thisArg?: any): this;
     /**
      *
-     * @returns {Boolean}
+     * @returns {boolean}
      */
     getValue(): boolean;
     /**

package/src/core/model/ObservedBoolean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedBoolean.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedBoolean.js"],"names":[],"mappings":";AAGA;IAQI;;;;OAIG;IACH,mBAHW,OAAO,EAcjB;IAtBD;;;OAGG;IACH,oBAFU,MAAM,CAAC,OAAO,EAAC,OAAO,CAAC,CAER;IAYrB;;;;OAIG;IACH,gBAAoB;IAmBxB;;;;OAIG;IACH,WAHW,OAAO,GACL,eAAe,CAa3B;IAED,gBAEC;IAED,iBAEC;IAED;;;OAGG;IACH,YAFW,eAAe,QAIzB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,YAFY,MAAM,CAIjB;IAED;;;;;OAKG;IACH,WAJW,CAAS,IAAO,EAAP,OAAO,EAAC,IAAO,EAAP,OAAO,QAAC,YACzB,GAAC,GACC,IAAI,CAWhB;IAED;;;OAGG;IACH,oBAEC;IAED;;OAEG;IACH,eAEC;IAED,kBAEC;IAED,yBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAKtB;IAeL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAlB1C;;eAIS,eAAe;cAMf,eAAe;;mBAjKN,4BAA4B"}
+{"version":3,"file":"ObservedBoolean.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedBoolean.js"],"names":[],"mappings":";AAGA;IAQI;;;;OAIG;IACH,oBAHW,OAAO,EAcjB;IAtBD;;;OAGG;IACH,oBAFU,MAAM,CAAC,OAAO,EAAC,OAAO,CAAC,CAER;IAYrB;;;;OAIG;IACH,gBAAoB;IAmBxB;;;;OAIG;IACH,WAHW,OAAO,GACL,eAAe,CAa3B;IAED,gBAEC;IAED,iBAEC;IAED;;;OAGG;IACH,YAFW,eAAe,QAIzB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,YAFY,MAAM,CAIjB;IAED;;;;;OAKG;IACH,WAJW,CAAS,IAAO,EAAP,OAAO,EAAC,IAAO,EAAP,OAAO,QAAC,YACzB,GAAC,GACC,IAAI,CAWhB;IAED;;;OAGG;IACH,YAFa,OAAO,CAInB;IAED;;OAEG;IACH,eAEC;IAED,kBAEC;IAED,yBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAKtB;IAeL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAlB1C;;eAIS,eAAe;cAMf,eAAe;;mBAjKN,4BAA4B"}

package/src/core/model/ObservedBoolean.js

@@ -11,10 +11,10 @@ class ObservedBoolean extends Boolean {
 
     /**
      *
-     * @param {boolean} value
+     * @param {boolean} [value=false]
      * @constructor
      */
-    constructor(value) {
+    constructor(value=false) {
         super();
 
         assert.isBoolean(value, 'value');
@@ -113,7 +113,7 @@ class ObservedBoolean extends Boolean {
 
     /**
      *
-     * @returns {Boolean}
+     * @returns {boolean}
      */
     getValue() {
         return this.__value;

package/src/core/model/ObservedEnum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedEnum.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedEnum.js"],"names":[],"mappings":";AAGA;IACI;;;;;OAKG;IACH,mBAJW,CAAC;;OAiBX;IATG;;;;OAIG;IACH,gBAAoB;IACpB;;MAA0B;IAE1B,0DAA6B;IAGjC;;;OAGG;IACH;;MAEC;IAED;;;;OAIG;IACH,WAHW,CAAC,GACC,YAAY,CAYxB;IAED;;;;OAIG;IACH,OAJa,CAAC,SACH,YAAY,CAAC,CAAC,CAAC,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,YAFW,YAAY,QAItB;IAED;;;OAGG;IACH,YAFa,CAAC,CAIb;IAED,eAEC;IAED;;;;;OAKG;IACH,mBAJW,CAAS,IAAC,EAAD,CAAC,EAAC,IAAC,EAAD,CAAC,QAAC,YACb,GAAC,GACC,IAAI,CAUhB;IAED,YAEC;IAED,yBAEC;CACJ;mBArGkB,4BAA4B"}
+{"version":3,"file":"ObservedEnum.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedEnum.js"],"names":[],"mappings":";AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IACI;;;;OAIG;IACH,mBAHW,CAAC;;OAyBX;IAlBG;;;;OAIG;IACH,gBAAoB;IACpB;;;;OAIG;IACH,mBAA0B;IAE1B;;;OAGG;IACH,oBAFU,MAAM,CAAC,CAAC,EAAC,CAAC,CAAC,CAEQ;IAGjC;;;OAGG;IACH;;MAEC;IAED;;;;OAIG;IACH,WAHW,CAAC,GACC,YAAY,CAYxB;IAED;;;;OAIG;IACH,mBAHW,YAAY,CAAC,GAAC,CAAC,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,QAFY,MAAM,CAcjB;IAED;;;OAGG;IACH,YAFW,YAAY,QAItB;IAED;;;OAGG;IACH,YAFa,CAAC,CAIb;IAED;;;;;OAKG;IACH,mBAJW,CAAS,IAAC,EAAD,CAAC,EAAC,IAAC,EAAD,CAAC,QAAC,YACb,GAAC,GACC,IAAI,CAUhB;IAED,YAEC;IAED,yBAEC;CACJ;mBA9IkB,4BAA4B"}