@woosh/meep-engine 2.131.16 → 2.131.19

package/src/core/geom/Quaternion.js

@@ -2,6 +2,7 @@ import { assert } from "../assert.js";
 import Signal from "../events/signal/Signal.js";
 import { clamp } from "../math/clamp.js";
 import { clamp01 } from "../math/clamp01.js";
+import { DEG_TO_RAD } from "../math/DEG_TO_RAD.js";
 import { EPSILON } from "../math/EPSILON.js";
 import { epsilonEquals } from "../math/epsilonEquals.js";
 import { lerp } from "../math/lerp.js";
@@ -67,7 +68,7 @@ export class Quaternion {
         this.w = w;
 
         /**
-         * Fired when value of the quaternion changes
+         * Fires when the value of the quaternion changes
          * Signature of the signal data is as follows:
          *      (new_x, new_y, new_z, new_w, old_x, old_y, old_z, old_w)
          * @readonly
@@ -160,6 +161,9 @@ export class Quaternion {
      * Orient quaternion on a `forward` vector, with the spin matching `up` vector
      * Useful for `lookAt` operations, such as for camera or inverse kinematics.
      * Normalizes input, meaning input does not have to be normalized.
+     *
+     * NOTE: `forward` and `up` vectors being the same is allowed, but you will likely get unexpected rotation along the look axis, so prefer not to do it.
+     *
      * @param {number} fx forward vector
      * @param {number} fy forward vector
      * @param {number} fz forward vector
@@ -260,8 +264,12 @@ export class Quaternion {
     }
 
     /**
-     * Calculates the inverse
+     * Calculates the inverse.
+     * Correctly handles unnormalized quaternions.
+     *
+     * If your quaternion is normalized, you can use {@link conjugate} instead for speed.
      * @returns {this}
+     * @see conjugate
      */
     invert() {
         const x = this.x;
@@ -269,14 +277,14 @@ export class Quaternion {
         const z = this.z;
         const w = this.w;
 
-        const length_sqr = x * x + y * y + z * z + w * w;
+        const dot_product = x * x + y * y + z * z + w * w;
 
-        if (length_sqr === 0) {
+        if (dot_product === 0) {
             // 0 magnitude, avoid division by 0 and set identity (arbitrage)
             return this.set(0, 0, 0, 1);
         }
 
-        const invDot = 1.0 / length_sqr;
+        const invDot = 1.0 / dot_product;
 
         const _x = -x * invDot;
         const _y = -y * invDot;
@@ -286,6 +294,15 @@ export class Quaternion {
         return this.set(_x, _y, _z, _w);
     }
 
+    /**
+     * NOTE: this is the same as {@link invert} if the quaternion is normalized.
+     * @returns {this}
+     * @see invert
+     */
+    conjugate() {
+        return this.set(-this.x, -this.y, -this.z, this.w);
+    }
+
     /**
      * Returns angle between this orientation and another
      * @param {Quaternion} other
@@ -602,21 +619,16 @@ export class Quaternion {
         this.lookRotation(forward, up);
     }
 
-    /**
-     * @deprecated use {@link random} instead
-     * @param {function():number} random
-     */
-    setRandom(random) {
-        throw new Error("use .random() instead");
-    }
 
     /**
+     * @deprecated use {@link fromEulerAnglesXYZ} or others specifically.
      *
      * @param {number} x
      * @param {number} y
      * @param {number} z
      * @param {String} [order='XYZ'] a combination of capital letters X,Y,Z. Examples: XYZ, YXZ
      * @returns {this}
+     *
      * @see fromEulerAnglesXYZ
      * @see fromEulerAnglesYXZ
      * @see fromEulerAnglesZXY
@@ -758,6 +770,28 @@ export class Quaternion {
         result.set(psi, theta, phi);
     }
 
+    /**
+     * Set rotation from Euler angles in degrees.
+     *
+     * Order is explicitly XYZ.
+     *
+     * Utility shortcut, same as `fromEulerAnglesXYZ(x * π / 180, y * π / 180, z * π / 180)`
+     *
+     * @param {number} [x] angle in degrees
+     * @param {number} [y] angle in degrees
+     * @param {number} [z] angle in degrees
+     * @returns {this}
+     *
+     * @see fromEulerAnglesXYZ
+     */
+    fromDegrees(x = 0, y = 0, z = 0) {
+        return this.fromEulerAnglesXYZ(
+            x * DEG_TO_RAD,
+            y * DEG_TO_RAD,
+            z * DEG_TO_RAD
+        );
+    }
+
 
     /**
      * XYZ order
@@ -1316,14 +1350,6 @@ export class Quaternion {
         return this;
     }
 
-    /**
-     *
-     * @returns {this}
-     */
-    conjugate() {
-        return this.set(-this.x, -this.y, -this.z, this.w);
-    }
-
     toJSON() {
         return {
             x: this.x,
@@ -1396,7 +1422,10 @@ export class Quaternion {
      * @param {number} [offset]
      * @returns {this}
      */
-    readFromArray(array, offset = 0) {
+    fromArray(array, offset = 0) {
+        assert.defined(array, "array");
+        assert.isNonNegativeInteger(offset, "offset");
+
         return this.set(
             array[offset],
             array[offset + 1],
@@ -1411,7 +1440,10 @@ export class Quaternion {
      * @param {number} [offset]
      * @returns {number[]}
      */
-    writeToArray(array = [], offset = 0) {
+    toArray(array = [], offset = 0) {
+        assert.defined(array, 'array');
+        assert.isNonNegativeInteger(offset, "offset");
+
         array[offset] = this.x;
         array[offset + 1] = this.y;
         array[offset + 2] = this.z;
@@ -1477,10 +1509,17 @@ export class Quaternion {
             && epsilonEquals(this.w, w, tolerance);
     }
 
+    /**
+     * @deprecated use {@link random} instead
+     * @param {function():number} random
+     */
+    setRandom(random) {
+        throw new Error("use .random() instead");
+    }
+
     /**
      * Randomly orient current quaternion
-     * @param {function():number} [random] Defaults to {@link Math.random}
-     * @return {Quaternion}
+     * @param {function():number} [random=Math.random] Random number generator function.
      */
     random(random = Math.random) {
         assert.isFunction(random, 'random');
@@ -1572,9 +1611,20 @@ export class Quaternion {
     }
 }
 
-Quaternion.prototype.fromArray = Quaternion.prototype.readFromArray;
-Quaternion.prototype.toArray = Quaternion.prototype.writeToArray;
-Quaternion.prototype.asArray = Quaternion.prototype.writeToArray;
+/**
+ * @deprecated use `fromArray`
+ */
+Quaternion.prototype.readFromArray = Quaternion.prototype.fromArray;
+
+/**
+ * @deprecated use `toArray`
+ */
+Quaternion.prototype.writeToArray = Quaternion.prototype.toArray;
+
+/**
+ * @deprecated use `toArray`
+ */
+Quaternion.prototype.asArray = Quaternion.prototype.toArray;
 Quaternion.prototype.fromEulerAngles = Quaternion.prototype.fromEulerAnglesXYZ;
 
 /**

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