@woosh/meep-engine 2.124.11 → 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.11",
+  "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_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"}

package/src/core/model/ObservedEnum.js

@@ -1,16 +1,34 @@
 import { assert } from "../assert.js";
 import Signal from "../events/signal/Signal.js";
 
+/**
+ * Enumerable value abstraction. Think `enum` keyword in TypeScript or any other programming language.
+ * Given a set of valid values, holds one of such values.
+ * This is an observable value, meaning you can subscribe to be notified of changes via {@link onChanged} signal.
+ *
+ * @example
+ *  const v = new ObservedEnum(7, {
+ *      ONE: 1,
+ *      SEVEN: 7
+ *  });
+ *
+ *  v.getValue(); // 7
+ *
+ *  v.set(1);
+ *
+ *  v.getValue(); // 1
+ *
+ *  v.set(2); // will throw error, as 2 is not a valid enum value
+ */
 class ObservedEnum {
     /**
      * @template T
      * @param {T} value
      * @param {Object.<string,T>} validSet
-     * @constructor
      */
     constructor(value, validSet) {
-        assert.equal(typeof validSet, "object", `ValidSet must be of type "object", instead was ${typeof validSet}`);
-        assert.notEqual(Object.values(validSet).indexOf(value), -1, `Value must be one of [${Object.values(validSet).join(", ")}], instead was "${value}"`);
+        assert.isObject(validSet, "validSet");
+        assert.enum(value, validSet, "value");
 
         /**
          *
@@ -18,13 +36,22 @@ class ObservedEnum {
          * @private
          */
         this.__value = value;
+        /**
+         *
+         * @type {Object<string, T>}
+         * @private
+         */
         this.__validSet = validSet;
 
+        /**
+         * @readonly
+         * @type {Signal<T,T>}
+         */
         this.onChanged = new Signal();
     }
 
     /**
-     *
+     * Do not modify result
      * @returns {Object<string, T>}
      */
     getValidValueSet() {
@@ -37,7 +64,7 @@ class ObservedEnum {
      * @returns {ObservedEnum}
      */
     set(value) {
-        assert.notEqual(Object.values(this.__validSet).indexOf(value), -1, `Value must be one of [${Object.values(this.__validSet).join(", ")}], instead was "${value}"`);
+        assert.enum(value, this.__validSet, "value")
 
         const oldValue = this.__value;
         if (oldValue !== value) {
@@ -49,14 +76,32 @@ class ObservedEnum {
     }
 
     /**
-     * @template X
-     * @param {ObservedEnum<X>} other
+     * @template T
+     * @param {ObservedEnum<T>} other
      * @returns {boolean}
      */
     equals(other) {
         return this.__value === other.__value;
     }
 
+    /**
+     *
+     * @return {number}
+     */
+    hash() {
+        let hash = 0;
+
+        for (const n of this.__validSet) {
+            if(this.__validSet[n] === this.__value)    {
+                break;
+            }
+
+            hash++;
+        }
+
+        return hash;
+    }
+
     /**
      *
      * @param {ObservedEnum} other
@@ -73,10 +118,6 @@ class ObservedEnum {
         return this.__value;
     }
 
-    invert() {
-        this.set(!this.__value);
-    }
-
     /**
      *
      * @param {function(T,T)} processor

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

@@ -2,7 +2,7 @@ export default ObservedInteger;
 declare class ObservedInteger extends Number {
     /**
      *
-     * @param {Number} [value]
+     * @param {number} [value=0]
      * @constructor
      */
     constructor(value?: number);
@@ -13,17 +13,17 @@ declare class ObservedInteger extends Number {
     readonly onChanged: Signal;
     /**
      *
-     * @type {Number}
+     * @type {number}
      * @private
      */
     private __value;
     toString(): string;
     /**
      *
-     * @param {Number} value
-     * @returns {ObservedInteger}
+     * @param {number} value
+     * @returns {this}
      */
-    set(value: number): ObservedInteger;
+    set(value: number): this;
     /**
      * Set value without dispatching change notification
      * @param {number} value
@@ -64,7 +64,7 @@ declare class ObservedInteger extends Number {
     decrement(): void;
     /**
      *
-     * @returns {Number}
+     * @returns {number}
      */
     getValue(): number;
     /**
@@ -80,7 +80,7 @@ declare class ObservedInteger extends Number {
     equals(other: ObservedInteger): boolean;
     /**
      *
-     * @returns {Number}
+     * @returns {number}
      */
     hash(): number;
     toJSON(): number;

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

@@ -1 +1 @@
-{"version":3,"file":"ObservedInteger.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedInteger.js"],"names":[],"mappings":";AAGA;IAOI;;;;OAIG;IACH,4BAcC;IAzBD;;;OAGG;IACH,oBAFU,MAAM,CAES;IAcrB;;;;OAIG;IACH,gBAAoB;IAYxB,mBAEC;IAED;;;;OAIG;IACH,oBAFa,eAAe,CAa3B;IAED;;;OAGG;IACH,iBAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,UAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,gBAFW,eAAe,QAIzB;IAED;;;OAGG;IACH,iBAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,WAFW,eAAe,QAIzB;IAED;;;OAGG;IACH,YAFW,MAAM,QAIhB;IAED;;OAEG;IACH,kBAEC;IAED;;OAEG;IACH,kBAEC;IAED;;;OAGG;IACH,mBAEC;IAED;;;OAGG;IACH,YAFW,eAAe,QAIzB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,eAEC;IAED,iBAEC;IAED,yBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAatB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAYtB;IAIL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAP1C;mBAtMkB,4BAA4B"}
+{"version":3,"file":"ObservedInteger.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedInteger.js"],"names":[],"mappings":";AAIA;IAOI;;;;OAIG;IACH,oBAHW,MAAM,EAgBhB;IAxBD;;;OAGG;IACH,oBAFU,MAAM,CAES;IAarB;;;;OAIG;IACH,gBAAoB;IAYxB,mBAEC;IAED;;;;OAIG;IACH,WAHW,MAAM,GACJ,IAAI,CAchB;IAED;;;OAGG;IACH,iBAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,UAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,gBAFW,eAAe,QAIzB;IAED;;;OAGG;IACH,iBAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,WAFW,eAAe,QAIzB;IAED;;;OAGG;IACH,YAFW,MAAM,QAIhB;IAED;;OAEG;IACH,kBAEC;IAED;;OAEG;IACH,kBAEC;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,YAFW,eAAe,QAIzB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED,iBAEC;IAED,yBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAatB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAYtB;IAIL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAP1C;mBAtMkB,4BAA4B"}

package/src/core/model/ObservedInteger.js

@@ -1,4 +1,5 @@
 import { assert } from "../assert.js";
+import { anyOf, isInfinite, isInteger } from "../debug/matchers/matchers.js";
 import Signal from "../events/signal/Signal.js";
 
 class ObservedInteger extends Number {
@@ -10,19 +11,18 @@ class ObservedInteger extends Number {
 
     /**
      *
-     * @param {Number} [value]
+     * @param {number} [value=0]
      * @constructor
      */
     constructor(value = 0) {
         super();
 
         assert.isNumber(value, 'value');
-        assert.ok(Number.isInteger(value) || !Number.isFinite(value), `Value must be an integer, instead was ${value}`);
-
+        assert.that(value,'value',anyOf(isInfinite(),isInteger()))
 
         /**
          *
-         * @type {Number}
+         * @type {number}
          * @private
          */
         this.__value = value;
@@ -31,7 +31,7 @@ class ObservedInteger extends Number {
 
     /**
      *
-     * @returns {Number}
+     * @returns {number}
      */
     valueOf() {
         return this.getValue();
@@ -43,12 +43,13 @@ class ObservedInteger extends Number {
 
     /**
      *
-     * @param {Number} value
-     * @returns {ObservedInteger}
+     * @param {number} value
+     * @returns {this}
      */
     set(value) {
         assert.isNumber(value, 'value');
-        assert.ok(Number.isInteger(value) || !Number.isFinite(value), `Value must be an integer, instead was ${value}`);
+        assert.that(value,'value',anyOf(isInfinite(),isInteger()))
+
 
         const oldValue = this.__value;
         if (oldValue !== value) {
@@ -65,7 +66,7 @@ class ObservedInteger extends Number {
      */
     setSilent(value) {
         assert.isNumber(value, 'value');
-        assert.ok(Number.isInteger(value) || !Number.isFinite(value), `Value must be an integer, instead was ${value}`);
+        assert.that(value,'value',anyOf(isInfinite(),isInteger()))
 
         this.__value = value;
     }
@@ -126,7 +127,7 @@ class ObservedInteger extends Number {
 
     /**
      *
-     * @returns {Number}
+     * @returns {number}
      */
     getValue() {
         return this.__value;
@@ -151,7 +152,7 @@ class ObservedInteger extends Number {
 
     /**
      *
-     * @returns {Number}
+     * @returns {number}
      */
     hash() {
         return this.__value;

package/src/engine/animation/curve/AnimationCurve.d.ts

@@ -51,7 +51,7 @@ export class AnimationCurve {
      */
     add(key: Keyframe): number;
     /**
-     *
+     * Insert multiple keyframes. Input doesn't need to be sorted.
      * @param {Keyframe[]} keys
      */
     addMany(keys: Keyframe[]): void;
@@ -62,26 +62,32 @@ export class AnimationCurve {
      */
     remove(key: Keyframe): boolean;
     /**
-     * Remove all keys
+     * Remove all keys, making the curve empty.
      */
     clear(): void;
     /**
-     * Number of keys
+     * Does this curve have any frames?
+     * @return {boolean} true if keyframe count == 0, false otherwise
+     */
+    isEmpty(): boolean;
+    /**
+     * Number of keys, will be 0 if curve is empty
      * @returns {number}
      */
     get length(): number;
     /**
-     * Time of the first keyframe, returns 0 if there are no keys
+     * Timestamp of the first keyframe, returns 0 if there are no keys
      * @returns {number}
      */
     get start_time(): number;
     /**
-     * Time of the last chronological key in the curve
+     * Time of the last chronological key in the curve.
+     * returns 0 if there are no keys.
      * @return {number}
      */
     get end_time(): number;
     /**
-     * Time difference between first and last frame
+     * Time difference between first and last frame.
      * @returns {number}
      */
     get duration(): number;

package/src/engine/animation/curve/AnimationCurve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationCurve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/AnimationCurve.js"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH;IAkFI;;;;OAIG;IACH,kBAHW,QAAQ,EAAE,GACR,cAAc,CAQ1B;IAgRD;;;;;;;OAOG;IACH,6BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAUzB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,YACN,MAAM,UACN,MAAM,GACL,cAAc,CAOzB;IAED;;;;;;;OAOG;IACH,0BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAYzB;IA9ZD;;;OAGG;IACH,eAFU,QAAQ,EAAE,CAEV;IAEV;;;;OAIG;IACH,SAHW,QAAQ,GACN,MAAM,CAgClB;IAED;;;OAGG;IACH,cAFW,QAAQ,EAAE,QAUpB;IAED;;;;OAIG;IACH,YAHW,QAAQ,GACN,OAAO,CAYnB;IAED;;OAEG;IACH,cAEC;IAeD;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAYlB;IAED;;;OAGG;IACH,gBAFY,MAAM,CAYjB;IAED;;;OAGG;IACH,gBAFa,MAAM,CAelB;IAED;;;;OAIG;IACH,wBAHW,MAAM,GACJ,MAAM,CA0ClB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,MAAM,CAoCjB;IAED;;;;OAIG;IACH,qBAFW,MAAM,QAmChB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAWhB;IAED,0BAKC;IAED;;;;OAIG;IACH,cAHW,cAAc,GACb,OAAO,CAIlB;IAED;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;;OAGG;IACH,SAFY,cAAc,CAQzB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;MAIC;IAED;;aAeC;CAqDJ;yBApbwB,eAAe"}
+{"version":3,"file":"AnimationCurve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/AnimationCurve.js"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH;IA4WI;;;;OAIG;IACH,kBAHW,QAAQ,EAAE,GACR,cAAc,CAQ1B;IAED;;;;;;;OAOG;IACH,6BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAUzB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,YACN,MAAM,UACN,MAAM,GACL,cAAc,CAOzB;IAED;;;;;;;OAOG;IACH,0BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAYzB;IA1aD;;;OAGG;IACH,eAFU,QAAQ,EAAE,CAEV;IAEV;;;;OAIG;IACH,SAHW,QAAQ,GACN,MAAM,CAiClB;IAED;;;OAGG;IACH,cAFW,QAAQ,EAAE,QAUpB;IAED;;;;OAIG;IACH,YAHW,QAAQ,GACN,OAAO,CAYnB;IAED;;OAEG;IACH,cAEC;IAGD;;;OAGG;IACH,WAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAYlB;IAED;;;;OAIG;IACH,gBAFY,MAAM,CAYjB;IAED;;;OAGG;IACH,gBAFa,MAAM,CAgBlB;IAED;;;;OAIG;IACH,wBAHW,MAAM,GACJ,MAAM,CA0ClB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,MAAM,CAoCjB;IAED;;;;OAIG;IACH,qBAFW,MAAM,QAmChB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAWhB;IAED,0BAKC;IAED;;;;OAIG;IACH,cAHW,cAAc,GACb,OAAO,CAIlB;IAED;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;;OAGG;IACH,SAFY,cAAc,CAQzB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;MAIC;IAED;;aAeC;CAkEJ;yBAhcwB,eAAe"}

package/src/engine/animation/curve/AnimationCurve.js

@@ -62,6 +62,7 @@ export class AnimationCurve {
         } else {
 
             // figure out the right place to insert the key
+            // TODO make use of this.getKeyIndexByTime instead
             const i = binarySearchHighIndex(keys, key.time, compareKeyframeToTime, 0, last_key_index);
 
             // insert key at the right place
@@ -72,7 +73,7 @@ export class AnimationCurve {
     }
 
     /**
-     *
+     * Insert multiple keyframes. Input doesn't need to be sorted.
      * @param {Keyframe[]} keys
      */
     addMany(keys) {
@@ -103,27 +104,23 @@ export class AnimationCurve {
     }
 
     /**
-     * Remove all keys
+     * Remove all keys, making the curve empty.
      */
     clear() {
         this.keys.splice(0, this.keys.length);
     }
 
+
     /**
-     *
-     * @param {Keyframe[]} keys
-     * @returns {AnimationCurve}
+     * Does this curve have any frames?
+     * @return {boolean} true if keyframe count == 0, false otherwise
      */
-    static from(keys) {
-        const curve = new AnimationCurve();
-
-        curve.addMany(keys);
-
-        return curve;
+    isEmpty() {
+        return this.keys.length === 0;
     }
 
     /**
-     * Number of keys
+     * Number of keys, will be 0 if curve is empty
      * @returns {number}
      */
     get length() {
@@ -131,7 +128,7 @@ export class AnimationCurve {
     }
 
     /**
-     * Time of the first keyframe, returns 0 if there are no keys
+     * Timestamp of the first keyframe, returns 0 if there are no keys
      * @returns {number}
      */
     get start_time() {
@@ -147,7 +144,8 @@ export class AnimationCurve {
     }
 
     /**
-     * Time of the last chronological key in the curve
+     * Time of the last chronological key in the curve.
+     * returns 0 if there are no keys.
      * @return {number}
      */
     get end_time() {
@@ -163,7 +161,7 @@ export class AnimationCurve {
     }
 
     /**
-     * Time difference between first and last frame
+     * Time difference between first and last frame.
      * @returns {number}
      */
     get duration() {
@@ -172,6 +170,7 @@ export class AnimationCurve {
         const key_count = keys.length;
 
         if (key_count < 2) {
+            // too few frames to compare
             return 0;
         }
 
@@ -392,6 +391,19 @@ export class AnimationCurve {
 
     }
 
+    /**
+     *
+     * @param {Keyframe[]} keys
+     * @returns {AnimationCurve}
+     */
+    static from(keys) {
+        const curve = new AnimationCurve();
+
+        curve.addMany(keys);
+
+        return curve;
+    }
+
     /**
      *
      * @param {number} [timeStart]

package/src/engine/animation/curve/animation_curve_compute_aabb.js

@@ -2,7 +2,7 @@ import { max2 } from "../../../core/math/max2.js";
 import { min2 } from "../../../core/math/min2.js";
 import { spline_hermite3_bounds } from "../../../core/math/spline/spline_hermite3_bounds.js";
 
-const temp_bounds = new Float32Array(4);
+const temp_bounds = new Float32Array(2);
 
 /**
  * Compute bounding box for a given curve. X-axis is time, Y-axis is value.

package/src/engine/animation/curve/animation_curve_optimize.d.ts

@@ -3,9 +3,10 @@
  * Intended to reduce complexity of a curve to improve performance and lower memory usage
  * @param {AnimationCurve} curve
  * @param {number} [error_tolerance] how much of a loss to accept, this is relative to normalized value bounds of the curve
+ * @returns {number} number of removed keys, 0 if curve was unchanged
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
  */
-export function animation_curve_optimize(curve: AnimationCurve, error_tolerance?: number): void;
+export function animation_curve_optimize(curve: AnimationCurve, error_tolerance?: number): number;
 //# sourceMappingURL=animation_curve_optimize.d.ts.map

package/src/engine/animation/curve/animation_curve_optimize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation_curve_optimize.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_optimize.js"],"names":[],"mappings":"AAkDA;;;;;;;;GAQG;AACH,gDANW,cAAc,oBACd,MAAM,QA6ChB"}
+{"version":3,"file":"animation_curve_optimize.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_optimize.js"],"names":[],"mappings":"AAkDA;;;;;;;;;GASG;AACH,gDAPW,cAAc,oBACd,MAAM,GACJ,MAAM,CAkDlB"}

package/src/engine/animation/curve/animation_curve_optimize.js

@@ -53,6 +53,7 @@ function compute_keyframe_value_effect(
  * Intended to reduce complexity of a curve to improve performance and lower memory usage
  * @param {AnimationCurve} curve
  * @param {number} [error_tolerance] how much of a loss to accept, this is relative to normalized value bounds of the curve
+ * @returns {number} number of removed keys, 0 if curve was unchanged
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
@@ -68,6 +69,8 @@ export function animation_curve_optimize(curve, error_tolerance = 1e-3) {
 
     const keyframes = curve.keys;
 
+    const initial_key_count = key_count;
+
     for (let i = 1; i < key_count; i++) {
         const key_previous = keyframes[i - 1];
         const key_current = keyframes[i];
@@ -97,4 +100,7 @@ export function animation_curve_optimize(curve, error_tolerance = 1e-3) {
             key_count--;
         }
     }
+
+    // number of removed keys
+    return initial_key_count - key_count;
 }

package/src/engine/ecs/EntityComponentDataset.d.ts.map

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

package/src/engine/ecs/EntityComponentDataset.js

@@ -1028,9 +1028,9 @@ export class EntityComponentDataset {
     }
 
     /**
-     *
+     * Internally every component class is mapped to an index, this method is used to retrieve such mapping.
      * @param {Function|Class} klass
-     * @returns {number}
+     * @returns {number} integer index, -1 if not found
      */
     computeComponentTypeIndex(klass) {
         assert.defined(klass, "klass");
@@ -1061,6 +1061,9 @@ export class EntityComponentDataset {
     }
 
     /**
+     * Retrieves any instance of a given component.
+     * If no component instances exist - component will be `null` and entity will be `-1`.
+     * Useful for singleton components such as a camera or an audio listener.
      * @template T
      * @param {Class<T>} component_type
      * @returns {{entity:number, component:T}}
@@ -1069,12 +1072,22 @@ export class EntityComponentDataset {
         let entity = -1;
         let component = null;
 
-        this.traverseComponents(component_type, (c, i) => {
-            entity = i;
-            component = c;
+        const index = this.computeComponentTypeIndex(component_type);
 
-            return false;
-        });
+        if(index!== -1) {
+
+            const components = this.components[index];
+            for (const entity_key in components) {
+                const c = components[entity_key];
+
+                if(c !== undefined){
+                    entity = Number(entity_key);
+                    component = c;
+                    break;
+                }
+
+            }
+        }
 
         return {
             entity,