@woosh/meep-engine 2.131.17 → 2.131.20

package/src/core/geom/Vector3.d.ts

@@ -517,6 +517,9 @@ export class Vector3 implements Iterable<number> {
     _projectVectors(x0: number, y0: number, z0: number, x1: number, y1: number, z1: number): this;
     /**
      * Convert spherical coordinates to cartesian
+     *
+     * We assume Y-up coordinate system.
+     *
      * @param {number} radius
      * @param {number} phi Also known as Azimuth
      * @param {number} theta Also known as Elevation

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

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

package/src/core/geom/Vector3.js

@@ -39,11 +39,11 @@ export class Vector3 {
         assert.isNumber(x, 'x');
         assert.notNaN(x, 'x');
 
-        assert.isNumber(y, 'x');
-        assert.notNaN(y, 'x');
+        assert.isNumber(y, 'y');
+        assert.notNaN(y, 'y');
 
-        assert.isNumber(z, 'x');
-        assert.notNaN(z, 'x');
+        assert.isNumber(z, 'z');
+        assert.notNaN(z, 'z');
 
         /**
          * Do not assign directly, use {@link set} method instead
@@ -141,6 +141,9 @@ export class Vector3 {
      * @returns {this}
      */
     fromArray(array, offset = 0) {
+        assert.defined(array, "array");
+        assert.isNonNegativeInteger(offset, "offset");
+
         return this.set(
             array[offset],
             array[offset + 1],
@@ -154,6 +157,8 @@ export class Vector3 {
      * @returns {number[]}
      */
     toArray(array = [], offset = 0) {
+        assert.isNonNegativeInteger(offset, "offset");
+
         array[offset] = this.x;
         array[offset + 1] = this.y;
         array[offset + 2] = this.z;
@@ -659,6 +664,8 @@ export class Vector3 {
      * @returns {this}
      */
     applyQuaternion(q) {
+        // NOTE: the logic is inlines for speed
+
         //transform point into quaternion
 
         const x = this.x;
@@ -936,9 +943,9 @@ export class Vector3 {
 
         const d = v3_dot(x0, y0, z0, x1, y1, z1);
 
-        const mag2 = (x1 * x1 + y1 * y1 + z1 * z1);
+        const length_sqr = (x1 * x1 + y1 * y1 + z1 * z1);
 
-        const m = d / mag2;
+        const m = d / length_sqr;
 
         const x = x1 * m;
         const y = y1 * m;
@@ -949,6 +956,9 @@ export class Vector3 {
 
     /**
      * Convert spherical coordinates to cartesian
+     *
+     * We assume Y-up coordinate system.
+     *
      * @param {number} radius
      * @param {number} phi Also known as Azimuth
      * @param {number} theta Also known as Elevation

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

@@ -1,5 +1,5 @@
 /**
- * Perform cubic hermite interpolation
+ * Perform cubic Hermite interpolation
  * @see https://en.wikipedia.org/wiki/Cubic_Hermite_spline
  * @param {number} t normalized interpolation position in interval [0,1]
  * @param {number} p0 first value

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

@@ -1,5 +1,5 @@
 /**
- * Perform cubic hermite interpolation
+ * Perform cubic Hermite interpolation
  * @see https://en.wikipedia.org/wiki/Cubic_Hermite_spline
  * @param {number} t normalized interpolation position in interval [0,1]
  * @param {number} p0 first value

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

@@ -1,5 +1,5 @@
 /**
- * Compute `y0,y1` bounds of a cubic hermite spline.
+ * 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]
  *
  * @param {number[]|Float32Array} result output will be written here, only y0 and y1

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

@@ -4,7 +4,7 @@ import { min2 } from "../min2.js";
 import { spline3_hermite } from "./spline3_hermite.js";
 
 /**
- * Compute `y0,y1` bounds of a cubic hermite spline.
+ * 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]
  *
  * @param {number[]|Float32Array} result output will be written here, only y0 and y1
@@ -26,7 +26,7 @@ export function spline3_hermite_bounds(
 
     /*
      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:
+     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
     */
 

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

@@ -1,12 +1,14 @@
 /**
- * Returns the first-order partial derivative of a hermite curve with control points p0, m0, p1, m1 at the parameter t in [0,1].
+ * Returns the first-order partial derivative of a Hermite curve with control points p0, m0, p1, m1 at the parameter t in [0,1].
  *
- * @param {number} t
- * @param {number} p0
- * @param {number} p1
- * @param {number} m0
- * @param {number} m1
+ * @param {number} t normalized interpolation position in interval [0,1]
+ * @param {number} p0 first value
+ * @param {number} p1 second value
+ * @param {number} m0 first tangent
+ * @param {number} m1 second tangent
  * @returns {number}
+ *
+ * @see spline3_hermite_integral
  */
 export function spline3_hermite_derivative(t: number, p0: number, p1: number, m0: number, m1: number): number;
 //# sourceMappingURL=spline3_hermite_derivative.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"spline3_hermite_derivative.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_derivative.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,8CAPW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAclB"}
+{"version":3,"file":"spline3_hermite_derivative.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_derivative.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,8CATW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAgBlB"}

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

@@ -1,12 +1,14 @@
 /**
- * Returns the first-order partial derivative of a hermite curve with control points p0, m0, p1, m1 at the parameter t in [0,1].
+ * Returns the first-order partial derivative of a Hermite curve with control points p0, m0, p1, m1 at the parameter t in [0,1].
  *
- * @param {number} t
- * @param {number} p0
- * @param {number} p1
- * @param {number} m0
- * @param {number} m1
+ * @param {number} t normalized interpolation position in interval [0,1]
+ * @param {number} p0 first value
+ * @param {number} p1 second value
+ * @param {number} m0 first tangent
+ * @param {number} m1 second tangent
  * @returns {number}
+ *
+ * @see spline3_hermite_integral
  */
 export function spline3_hermite_derivative(t, p0, p1, m0, m1) {
 
@@ -20,4 +22,5 @@ export function spline3_hermite_derivative(t, p0, p1, m0, m1) {
 
     return dcx1 * p0 + dcx2 * p1 + dcv1 * m0 + dcv2 * m1
 
-}
+}
+

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

@@ -0,0 +1,14 @@
+/**
+ * Calculates the integral (area under the curve) of a cubic hermite spline from 0 to t.
+ *
+ * @param {number} t normalized interpolation position in interval [0,1]
+ * @param {number} p0 first value
+ * @param {number} p1 second value
+ * @param {number} m0 first tangent
+ * @param {number} m1 second tangent
+ * @returns {number} The definite integral from 0 to t
+ *
+ * @see spline3_hermite_derivative
+ */
+export function spline3_hermite_integral(t: number, p0: number, p1: number, m0: number, m1: number): number;
+//# sourceMappingURL=spline3_hermite_integral.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline3_hermite_integral.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_integral.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,4CATW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CA0BlB"}

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

@@ -0,0 +1,35 @@
+/**
+ * Calculates the integral (area under the curve) of a cubic hermite spline from 0 to t.
+ *
+ * @param {number} t normalized interpolation position in interval [0,1]
+ * @param {number} p0 first value
+ * @param {number} p1 second value
+ * @param {number} m0 first tangent
+ * @param {number} m1 second tangent
+ * @returns {number} The definite integral from 0 to t
+ *
+ * @see spline3_hermite_derivative
+ */
+export function spline3_hermite_integral(t, p0, p1, m0, m1) {
+    const t2 = t * t;
+    const t3 = t2 * t;
+    const t4 = t3 * t;
+
+    // Integral of (2t^3 - 3t^2 + 1)
+    // Result: 0.5t^4 - t^3 + t
+    const int_p0 = 0.5 * t4 - t3 + t;
+
+    // Integral of (t^3 - 2t^2 + t)
+    // Result: 0.25t^4 - (2/3)t^3 + 0.5t^2
+    const int_m0 = 0.25 * t4 - (2.0 / 3.0) * t3 + 0.5 * t2;
+
+    // Integral of (t^3 - t^2)
+    // Result: 0.25t^4 - (1/3)t^3
+    const int_m1 = 0.25 * t4 - (1.0 / 3.0) * t3;
+
+    // Integral of (3t^2 - 2t^3)
+    // Result: t^3 - 0.5t^4
+    const int_p1 = t3 - 0.5 * t4;
+
+    return int_p0 * p0 + int_m0 * m0 + int_m1 * m1 + int_p1 * p1;
+}

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

@@ -1,5 +1,5 @@
 /**
- * Subdivides a hermite curve into two hermite curves.
+ * Subdivides a Hermite curve into two hermite curves.
  * The result is written in form [a_p0, a_p1, a_m0, a_m1, b_p0, b_p1, b_m0, b_m1], note the stride and offset.
  * @param {number[]} output where to write the result
  * @param {number} output_offset where to start writing

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

@@ -3,7 +3,7 @@ import { spline3_hermite } from "./spline3_hermite.js";
 import { spline3_hermite_derivative } from "./spline3_hermite_derivative.js";
 
 /**
- * Subdivides a hermite curve into two hermite curves.
+ * Subdivides a Hermite curve into two hermite curves.
  * The result is written in form [a_p0, a_p1, a_m0, a_m1, b_p0, b_p1, b_m0, b_m1], note the stride and offset.
  * @param {number[]} output where to write the result
  * @param {number} output_offset where to start writing

package/src/core/model/node-graph/NodeGraph.d.ts

@@ -223,6 +223,7 @@ export class NodeGraph {
      * @returns {number} number of found connections
      */
     getConnectionsAttachedToNode(id: number, result: number[]): number;
+    toString(): string;
     /**
      * Useful for type checks
      * @example

package/src/core/model/node-graph/NodeGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeGraph.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/node-graph/NodeGraph.js"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH;IAEI;;;;OAIG;IACH,uBAAmB;IAEnB;;;;;OAKG;IACH,6BAAyB;IAEzB;;;;;OAKG;IACH,4BAA0B;IAE1B;;;;;OAKG;IACH,kCAAgC;IAQhC;;;;;OAKG;IACH,+BAEC;IAED;;OAEG;IACH;QACI;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;MAEL;IAEF;;OAEG;IACH,cAQC;IAED;;;OAGG;IACH,YAFW,SAAS,QAYnB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;;;OAMG;IACH,aAHW,SAAS,GACP;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAe5D;IAED;;;;;;;;OAQG;IACH,sCAJW,YAAY,EAAE,GAEZ;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAmF5D;IAED;;;;OAIG;IACH,8BAHoB,YAAY,+BAK/B;IAED;;;;OAIG;IACH,oCAHoB,UAAU,+BAK7B;IAED;;;;OAIG;IACH,YAFY,YAAY,EAAE,CAIzB;IAED;;;;OAIG;IACH,kBAFY,UAAU,EAAE,CAIvB;IAED;;;;OAIG;IACH,cAHW,YAAY,GACV,OAAO,CAgBnB;IAED;;;;OAIG;IACH,qDAFa,YAAY,EAAE,CAsB1B;IAED;;;;OAIG;IACH,0DAFa,YAAY,EAAE,CAqB1B;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,YAAY,GAAC,SAAS,CAkBlC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,GACJ,YAAY,CAWxB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,UAAU,GAAC,SAAS,CAgBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,WACN,MAAM,GACJ,4BAA0B,SAAS,CAY/C;IAED;;;;OAIG;IACH,mCAFa,MAAM,CAclB;IAED;;;OAGG;IACH,cAFW,YAAY,QAkBtB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CA8BnB;IAED;;;;;;;;OAQG;IACH,uCANW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAqClB;IAED;;;;;;;;OAQG;IACH,6BAPW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAuDlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,OAAO,CAyBnB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,UACN,MAAM,EAAE,GACN,MAAM,CAyBlB;IAGL;;;;;;;;OAQG;IACH,sBAFU,OAAO,CAEc;;CAX9B;6BAtqB4B,wBAAwB;2BAD1B,iBAAiB"}
+{"version":3,"file":"NodeGraph.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/node-graph/NodeGraph.js"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH;IAEI;;;;OAIG;IACH,uBAAmB;IAEnB;;;;;OAKG;IACH,6BAAyB;IAEzB;;;;;OAKG;IACH,4BAA0B;IAE1B;;;;;OAKG;IACH,kCAAgC;IAQhC;;;;;OAKG;IACH,+BAEC;IAED;;OAEG;IACH;QACI;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;MAEL;IAEF;;OAEG;IACH,cAQC;IAED;;;OAGG;IACH,YAFW,SAAS,QAYnB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;;;OAMG;IACH,aAHW,SAAS,GACP;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAe5D;IAED;;;;;;;;OAQG;IACH,sCAJW,YAAY,EAAE,GAEZ;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAmF5D;IAED;;;;OAIG;IACH,8BAHoB,YAAY,+BAK/B;IAED;;;;OAIG;IACH,oCAHoB,UAAU,+BAK7B;IAED;;;;OAIG;IACH,YAFY,YAAY,EAAE,CAIzB;IAED;;;;OAIG;IACH,kBAFY,UAAU,EAAE,CAIvB;IAED;;;;OAIG;IACH,cAHW,YAAY,GACV,OAAO,CAgBnB;IAED;;;;OAIG;IACH,qDAFa,YAAY,EAAE,CAsB1B;IAED;;;;OAIG;IACH,0DAFa,YAAY,EAAE,CAqB1B;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,YAAY,GAAC,SAAS,CAkBlC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,GACJ,YAAY,CAWxB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,UAAU,GAAC,SAAS,CAgBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,WACN,MAAM,GACJ,4BAA0B,SAAS,CAY/C;IAED;;;;OAIG;IACH,mCAFa,MAAM,CAclB;IAED;;;OAGG;IACH,cAFW,YAAY,QAkBtB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CA8BnB;IAED;;;;;;;;OAQG;IACH,uCANW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAqClB;IAED;;;;;;;;OAQG;IACH,6BAPW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAuDlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,OAAO,CAyBnB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,UACN,MAAM,EAAE,GACN,MAAM,CAyBlB;IAED,mBAEC;IAGL;;;;;;;;OAQG;IACH,sBAFU,OAAO,CAEc;;CAX9B;6BA1qB4B,wBAAwB;2BAD1B,iBAAiB"}

package/src/core/model/node-graph/NodeGraph.js

@@ -682,6 +682,10 @@ export class NodeGraph {
 
         return count;
     }
+
+    toString() {
+        return `NodeGraph{ nodes=${this.nodes.length}, connections=${this.connections.length}, version=${this.version} }`
+    }
 }
 
 /**

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

@@ -0,0 +1,17 @@
+/**
+ * Fits a smooth {@link AnimationCurve} to a set of discrete 2D points using adaptive Cubic Hermite Spline fitting.
+ *
+ * This utility performs data reduction (lossy compression) on dense time-series data.
+ * It recursively subdivides the dataset, inserting {@link Keyframe}s only where the interpolated curve deviates from the original points by more than `maxError`.
+ *
+ * Tangents are automatically estimated based on the slope of the input data (Catmull-Rom style), ensuring smooth transitions between keyframes.
+ *
+ * @param {number[]} points flat array of coordinates [x0, y0, x1, y1, ... xn, yn]
+ * @param {number} [input_offset] flat offset into the input array where to start reading data
+ * @param {number} [input_count] number of points to fit, counted in points i.e., pairs of (x,y) values
+ * @param {number} [maxError] Maximum allowed deviation. Higher values produce fewer keys (more compression), lower values preserve more detail.
+ * @returns {AnimationCurve}
+ */
+export function animation_curve_fit(points: number[], input_offset?: number, input_count?: number, maxError?: number): AnimationCurve;
+import { AnimationCurve } from "./AnimationCurve.js";
+//# sourceMappingURL=animation_curve_fit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation_curve_fit.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_fit.js"],"names":[],"mappings":"AAkEA;;;;;;;;;;;;;GAaG;AACH,4CANW,MAAM,EAAE,iBACR,MAAM,gBACN,MAAM,aACN,MAAM,GACJ,cAAc,CAoH1B;+BA/L8B,qBAAqB"}

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

@@ -0,0 +1,195 @@
+import { assert } from "../../../core/assert.js";
+import { spline3_hermite } from "../../../core/math/spline/spline3_hermite.js";
+import { number_compare_ascending } from "../../../core/primitives/numbers/number_compare_ascending.js";
+import { AnimationCurve } from "./AnimationCurve.js";
+import { Keyframe } from "./Keyframe.js";
+
+/**
+ * Calculates a Catmull-Rom style tangent (slope) for a point in the dataset.
+ * @param {number[]} points
+ * @param {number} points_offset
+ * @param {number} points_count
+ * @param {number} index
+ */
+function calculateTangent(
+    points,
+    points_offset,
+    points_count,
+    index
+) {
+
+    const current = points_offset + index * 2;
+
+    // Handle boundaries: Linear slope to neighbor
+    if (index === 0) {
+        const next = points_offset + 2;
+
+        const dt = points[next] - points[current];
+
+        if (dt === 0) {
+            return 0;
+        } else {
+            return (points[next + 1] - points[current + 1]) / dt;
+        }
+
+    }
+    if (index === points_count - 1) {
+        const prev = points_offset + (points_count - 2) * 2;
+
+        const dt = points[current] - points[prev];
+
+        if (dt === 0) {
+            return 0;
+        } else {
+            return (points[current + 1] - points[prev + 1]) / dt;
+        }
+
+    }
+
+    // Handle internal points: Average slope between prev and next (Finite Difference)
+    const next = points_offset + (index + 1) * 2;
+    const prev = points_offset + (index - 1) * 2;
+
+    // A simpler approach is the slope between prev and next directly:
+    // return (next.value - prev.value) / (next.time - prev.time);
+
+    // However, weighted average often looks better for non-uniform time steps:
+    const dt0 = points[current] - points[prev];
+    const slope0 = dt0 === 0 ? 0 : (points[current + 1] - points[prev + 1]) / dt0;
+
+    const dt1 = points[next] - points[current];
+    const slope1 = dt1 === 0 ? 0 : (points[next + 1] - points[current + 1]) / dt1;
+
+    // Average the slopes
+    return (slope0 + slope1) * 0.5;
+}
+
+/**
+ * Fits a smooth {@link AnimationCurve} to a set of discrete 2D points using adaptive Cubic Hermite Spline fitting.
+ *
+ * This utility performs data reduction (lossy compression) on dense time-series data.
+ * It recursively subdivides the dataset, inserting {@link Keyframe}s only where the interpolated curve deviates from the original points by more than `maxError`.
+ *
+ * Tangents are automatically estimated based on the slope of the input data (Catmull-Rom style), ensuring smooth transitions between keyframes.
+ *
+ * @param {number[]} points flat array of coordinates [x0, y0, x1, y1, ... xn, yn]
+ * @param {number} [input_offset] flat offset into the input array where to start reading data
+ * @param {number} [input_count] number of points to fit, counted in points i.e., pairs of (x,y) values
+ * @param {number} [maxError] Maximum allowed deviation. Higher values produce fewer keys (more compression), lower values preserve more detail.
+ * @returns {AnimationCurve}
+ */
+export function animation_curve_fit(
+    points,
+    input_offset = 0,
+    input_count = ((points.length - input_offset) / 2),
+    maxError = 0.01
+) {
+    assert.defined(points, 'points');
+    assert.isNonNegativeInteger(input_offset, 'input_offset');
+    assert.isNonNegativeInteger(input_count, 'input_count');
+    assert.notNaN(maxError, 'maxError');
+    assert.greaterThanOrEqual(maxError, 0, 'maxError must be non-negative');
+
+    if (input_count === 0) {
+        return new AnimationCurve();
+    }
+
+    if (input_count === 1) {
+        return AnimationCurve.from([Keyframe.from(points[input_offset], points[input_offset + 1])]);
+    }
+
+    // 1. Identify which indices from the source array we need to keep as Keyframes
+    const keyIndices = new Set();
+
+    // Always keep first and last
+    keyIndices.add(0);
+    keyIndices.add(input_count - 1);
+
+    /**
+     * Recursive function to find split points
+     * @param {number} firstIndex
+     * @param {number} lastIndex
+     */
+    function fitSegment(firstIndex, lastIndex) {
+        if (lastIndex - firstIndex <= 1) {
+            // done
+            return;
+        }
+
+        // A. Estimate tangents for the start and end of this segment
+        // We calculate tangents based on the *original* dense data to ensure accurate slope
+        const m0 = calculateTangent(points, input_offset, input_count, firstIndex);
+        const m1 = calculateTangent(points, input_offset, input_count, lastIndex);
+
+        const address_0 = input_offset + firstIndex * 2;
+        const address_1 = input_offset + lastIndex * 2;
+
+        const tStart = points[address_0];
+        const tEnd = points[address_1];
+        const vStart = points[address_0 + 1];
+        const vEnd = points[address_1 + 1];
+        const duration = tEnd - tStart;
+
+        if (duration < 1e-12) {
+            // duration is very low, we're in division-by-zero territory
+            return;
+        }
+
+        // B. Find the point in this range with the greatest error vs the hypothetical curve
+        let maxSegmentError = 0;
+        let splitIndex = -1;
+
+        for (let i = firstIndex + 1; i < lastIndex; i++) {
+            const address = input_offset + i * 2;
+
+            // Normalize time t to [0, 1] for the Hermite formula
+            const t = (points[address] - tStart) / duration;
+
+            // Evaluate Cubic Hermite Spline
+            const evaluatedValue = spline3_hermite(t, vStart, vEnd, m0 * duration, m1 * duration);
+
+            const error = Math.abs(points[address + 1] - evaluatedValue);
+
+            if (error > maxSegmentError) {
+                maxSegmentError = error;
+                splitIndex = i;
+            }
+        }
+
+        // C. If error is too high, mark the split point as a Keyframe and recurse
+        if (maxSegmentError > maxError) {
+            keyIndices.add(splitIndex);
+            fitSegment(firstIndex, splitIndex);
+            fitSegment(splitIndex, lastIndex);
+        }
+    }
+
+    // Start the recursion
+    fitSegment(0, input_count - 1);
+
+    // 2. Build the final curve from the selected indices
+    const sortedIndices = Array.from(keyIndices).sort(number_compare_ascending);
+
+    /**
+     *
+     * @type {Keyframe[]}
+     */
+    const resultKeys = [];
+
+    const fitted_key_count = sortedIndices.length;
+
+    for (let i = 0; i < fitted_key_count; i++) {
+        const idx = sortedIndices[i];
+        const address = input_offset + idx * 2;
+
+        // Calculate the smooth tangent for this key
+        // Note: For sharp transitions, you might want to break continuity,
+        // but for approximation, continuous slope is usually desired.
+        const tangent = calculateTangent(points, input_offset, input_count, idx);
+
+        // Create a keyframe. Assuming inTangent == outTangent for smooth fitting.
+        resultKeys.push(Keyframe.from(points[address], points[address + 1], tangent, tangent));
+    }
+
+    return AnimationCurve.from(resultKeys);
+}

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;;;;;;;;;;GAUG;AACH,kFANW,MAAM,GACJ,MAAM,CAqDlB"}
+{"version":3,"file":"animation_curve_optimize.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_optimize.js"],"names":[],"mappings":"AA+EA;;;;;;;;;;GAUG;AACH,kFANW,MAAM,GACJ,MAAM,CAoElB"}