@woosh/meep-engine 2.124.11 → 2.124.13

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/AnimationUtils.js

@@ -1,8 +1,8 @@
 import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
 import Timer from "../ecs/components/Timer.js";
 import Entity from "../ecs/Entity.js";
-import { whenAllEntitiesDestroyed, whenEntityDestroyed } from "../ecs/EntityBuilderUtils.js";
 import { Transform } from "../ecs/transform/Transform.js";
+import { whenAllEntitiesDestroyed, whenEntityDestroyed } from "../ecs/util/EntityBuilderUtils.js";
 import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
 import { createSound, createTimer } from "../EntityCreator.js";
 import Mesh from "../graphics/ecs/mesh/Mesh.js";

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

@@ -3,6 +3,15 @@
  * Values are stored in {@link Keyframe}s, interpolation is defined by tangents on {@link Keyframe}s.
  * The curve is a cubic Hermite spline, see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
  *
+ * @example
+ *  const jump_curve = AnimationCurve.from([
+ *      Keyframe.from(0, 0), // start at height 0
+ *      Keyframe.from(0.3, 2), // at time 0.3, jump height will be 2 meters
+ *      Keyframe.from(1, 0) // at time 1.0, land back on the ground
+ *  ]);
+ *
+ *  jump_curve.evaluate(0.1); // what is the height at time 0.1?
+ *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
  */
@@ -23,7 +32,7 @@ export class AnimationCurve {
      */
     static easeInOut(timeStart?: number, valueStart?: number, timeEnd?: number, valueEnd?: number): AnimationCurve;
     /**
-     *
+     * A flat-line curve with a specific start and end times
      * @param {number} [timeStart]
      * @param {number} [timeEnd]
      * @param {number} [value]
@@ -31,7 +40,7 @@ export class AnimationCurve {
      */
     static constant(timeStart?: number, timeEnd?: number, value?: number): AnimationCurve;
     /**
-     *
+     * Curve with two keyframes connected by a straight line
      * @param {number} [timeStart]
      * @param {number} [valueStart]
      * @param {number} [timeEnd]
@@ -45,13 +54,14 @@ export class AnimationCurve {
      */
     readonly keys: Keyframe[];
     /**
-     *
+     * Add a new keyframe into the animation.
+     * Keyframes can be added out of order, they will be inserted into correct chronological position.
      * @param {Keyframe} key
      * @returns {number} key index where it was inserted at
      */
     add(key: Keyframe): number;
     /**
-     *
+     * Insert multiple keyframes. Input doesn't need to be sorted.
      * @param {Keyframe[]} keys
      */
     addMany(keys: Keyframe[]): void;
@@ -62,26 +72,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;;;;;;;;;;;;;;;;GAgBG;AACH;IA6WI;;;;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;IA3aD;;;OAGG;IACH,eAFU,QAAQ,EAAE,CAEV;IAEV;;;;;OAKG;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;yBA1cwB,eAAe"}

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

@@ -24,6 +24,15 @@ function compareKeyframeToTime(time, keyframe) {
  * Values are stored in {@link Keyframe}s, interpolation is defined by tangents on {@link Keyframe}s.
  * The curve is a cubic Hermite spline, see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
  *
+ * @example
+ *  const jump_curve = AnimationCurve.from([
+ *      Keyframe.from(0, 0), // start at height 0
+ *      Keyframe.from(0.3, 2), // at time 0.3, jump height will be 2 meters
+ *      Keyframe.from(1, 0) // at time 1.0, land back on the ground
+ *  ]);
+ *
+ *  jump_curve.evaluate(0.1); // what is the height at time 0.1?
+ *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
  */
@@ -35,7 +44,8 @@ export class AnimationCurve {
     keys = [];
 
     /**
-     *
+     * Add a new keyframe into the animation.
+     * Keyframes can be added out of order, they will be inserted into correct chronological position.
      * @param {Keyframe} key
      * @returns {number} key index where it was inserted at
      */
@@ -62,6 +72,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 +83,7 @@ export class AnimationCurve {
     }
 
     /**
-     *
+     * Insert multiple keyframes. Input doesn't need to be sorted.
      * @param {Keyframe[]} keys
      */
     addMany(keys) {
@@ -103,27 +114,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 +138,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 +154,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 +171,7 @@ export class AnimationCurve {
     }
 
     /**
-     * Time difference between first and last frame
+     * Time difference between first and last frame.
      * @returns {number}
      */
     get duration() {
@@ -172,6 +180,7 @@ export class AnimationCurve {
         const key_count = keys.length;
 
         if (key_count < 2) {
+            // too few frames to compare
             return 0;
         }
 
@@ -392,6 +401,19 @@ export class AnimationCurve {
 
     }
 
+    /**
+     *
+     * @param {Keyframe[]} keys
+     * @returns {AnimationCurve}
+     */
+    static from(keys) {
+        const curve = new AnimationCurve();
+
+        curve.addMany(keys);
+
+        return curve;
+    }
+
     /**
      *
      * @param {number} [timeStart]
@@ -411,7 +433,7 @@ export class AnimationCurve {
     }
 
     /**
-     *
+     * A flat-line curve with a specific start and end times
      * @param {number} [timeStart]
      * @param {number} [timeEnd]
      * @param {number} [value]
@@ -425,7 +447,7 @@ export class AnimationCurve {
     }
 
     /**
-     *
+     * Curve with two keyframes connected by a straight line
      * @param {number} [timeStart]
      * @param {number} [valueStart]
      * @param {number} [timeEnd]

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

@@ -1,5 +1,7 @@
 /**
- * Single keyframe of {@link AnimationCurve}
+ * Single keyframe of {@link AnimationCurve}.
+ * Note that {@link AnimationCurve} relies on Keyframes to be static, so treat them as immutable.
+ * Do not change keyframe values unless you understand the implications of doing so.
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
@@ -20,7 +22,7 @@ export class Keyframe {
      */
     value: number;
     /**
-     * Timestamp
+     * Timestamp/position for the value
      * @type {number}
      */
     time: number;

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

@@ -1 +1 @@
-{"version":3,"file":"Keyframe.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/Keyframe.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IAyBI;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,GACL,QAAQ,CAQnB;IAtCD;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,MAAM,CAED;IAkBf;;;;;;OAMG;IACH,UALW,MAAM,SACN,MAAM,aACN,MAAM,cACN,MAAM,QAmBhB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAQnB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAOlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAKjB;IAED;;;;;MAOC;IAED;;;;;aAQC;IAIL;;;;OAIG;IACH,qBAFU,OAAO,CAEY;CAP5B"}
+{"version":3,"file":"Keyframe.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/Keyframe.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH;IAyBI;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,GACL,QAAQ,CAQnB;IAtCD;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,MAAM,CAED;IAkBf;;;;;;OAMG;IACH,UALW,MAAM,SACN,MAAM,aACN,MAAM,cACN,MAAM,QAqBhB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAQnB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAOlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAKjB;IAED;;;;;MAOC;IAED;;;;;aAQC;IAIL;;;;OAIG;IACH,qBAFU,OAAO,CAEY;CAP5B"}

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

@@ -2,7 +2,9 @@ import { assert } from "../../../core/assert.js";
 import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
 
 /**
- * Single keyframe of {@link AnimationCurve}
+ * Single keyframe of {@link AnimationCurve}.
+ * Note that {@link AnimationCurve} relies on Keyframes to be static, so treat them as immutable.
+ * Do not change keyframe values unless you understand the implications of doing so.
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
@@ -15,7 +17,7 @@ export class Keyframe {
     value = 0;
 
     /**
-     * Timestamp
+     * Timestamp/position for the value
      * @type {number}
      */
     time = 0;
@@ -64,9 +66,11 @@ export class Keyframe {
 
         assert.isNumber(inTangent, 'inTangent');
         assert.notNaN(inTangent, 'inTangent');
+        assert.isFinite(inTangent, 'inTangent');
 
         assert.isNumber(outTangent, 'outTangent');
         assert.notNaN(outTangent, 'outTangent');
+        assert.isFinite(outTangent, 'outTangent');
 
         this.time = time;
         this.value = value;

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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"}