@woosh/meep-engine 2.126.28 → 2.126.30

package/package.json

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

package/src/core/events/signal/Signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../../../../src/core/events/signal/Signal.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IACI;;;;OAIG;IACH,iBAAqB;IAErB;;;;OAIG;IACH,cAAU;IAEV;;;OAGG;IACH,YAFU,MAAM,CAED;IAWf;;;OAGG;IACH,cAFW,OAAO,EAIjB;IAfD;;;OAGG;IACH,cAFa,OAAO,CAInB;IAYD;;;;OAIG;IACH,cAHW,MAAM;;KAAY,GAChB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM;;KAAY,GAChB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM;;KAAY,SAClB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM;;KAAY,GAChB,OAAO,CAInB;IAGD;;;;;OAKG;IACH,sCAHW,GAAC,GACC,OAAO,CAcnB;IAED,aAEC;IAED,eAEC;IAED;;;OAGG;IACH,eAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,8BAFW,GAAC,QAUX;IAED;;;;OAIG;IACH,2BAFW,GAAC,QASX;IA8BD;;;;;OAKG;IACH,8BAHW,GAAC,GACC,OAAO,CA2CnB;IAED;;;;;;OAMG;IACH,kBAEC;IAqDD;;;OAGG;IACH,kBAFc,GAAC,EAAA,QA6Cd;IAGD;;;OAGG;IACH,cA0CC;IAED;;;;OAIG;IACH,WAFW,GAAC,QA2CX;IAED;;;;OAIG;IACH,SAHW,GAAC,KACD,GAAC,QA0CX;IAED;;;;;OAKG;IACH,SAJW,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;;;OAMG;IACH,SALW,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;;;;;OAQG;IACH,SAPW,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;;;;;;;OAUG;IACH,SATW,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,MAAM,CAalB;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;;CAPxB"}
+{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../../../../src/core/events/signal/Signal.js"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH;IACI;;;;OAIG;IACH,iBAAqB;IAErB;;;;OAIG;IACH,cAAU;IAEV;;;OAGG;IACH,YAFU,MAAM,CAED;IAWf;;;OAGG;IACH,cAFW,OAAO,EAIjB;IAfD;;;OAGG;IACH,cAFa,OAAO,CAInB;IAYD;;;;OAIG;IACH,cAHW,MAAM;;KAAY,GAChB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM;;KAAY,GAChB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM;;KAAY,SAClB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM;;KAAY,GAChB,OAAO,CAInB;IAGD;;;;;OAKG;IACH,sCAHW,GAAC,GACC,OAAO,CAcnB;IAED,aAEC;IAED,eAEC;IAED;;;OAGG;IACH,eAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,8BAFW,GAAC,QAUX;IAED;;;;OAIG;IACH,2BAFW,GAAC,QASX;IA8BD;;;;;OAKG;IACH,8BAHW,GAAC,GACC,OAAO,CA2CnB;IAED;;;;;;OAMG;IACH,kBAEC;IAqDD;;;OAGG;IACH,kBAFc,GAAC,EAAA,QA6Cd;IAGD;;;OAGG;IACH,cA0CC;IAED;;;;OAIG;IACH,WAFW,GAAC,QA2CX;IAED;;;;OAIG;IACH,SAHW,GAAC,KACD,GAAC,QA0CX;IAED;;;;;OAKG;IACH,SAJW,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;;;OAMG;IACH,SALW,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;;;;;OAQG;IACH,SAPW,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;;;;;;;OAUG;IACH,SATW,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,KACD,GAAC,QA0CX;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,MAAM,CAalB;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;;CAPxB"}

package/src/core/events/signal/Signal.js

@@ -5,10 +5,12 @@ import { SignalHandler, SignalHandlerFlags } from "./SignalHandler.js";
 
 
 /**
- * Signal is a type of event bus. You can subscribe to events using {@link add} method and dispatch using sendN method where N is the number of arguments you wish to pass
+ * Signal is a type of event bus. You can subscribe to events using {@link add} method and dispatch using sendN method where N is the number of arguments you wish to pass.
  * Signal is different from a normal event bus in that 1 signal corresponds to 1 event type. For example, in HTML you have `addEventListener` which lets you subscribe to any kind of event, let's use "mousedown" as a reference.
  * Using a Signal you would instead have a signal corresponding to "mousedown" and dispatch this signal only for this event.
- * @example `const mouseDown = new Signal<MouseEvent>(); mouseDown.send1(myMouseEvent);`
+ * @example
+ *  const mouseDown = new Signal<MouseEvent>();
+ *  mouseDown.send1(myMouseEvent);
  */
 export class Signal {
     /**

package/src/core/events/signal/SignalHandler.d.ts

@@ -2,6 +2,14 @@ export type SignalHandlerFlags = number;
 export namespace SignalHandlerFlags {
     let RemoveAfterExecution: number;
 }
+/**
+ * Represents a handler for signals in the event system.
+ *
+ * Used to encapsulate callback functions along with their execution context and provide flag-based behavior control.
+ * They can be organized into linked lists using the `next` property to form a chain of handlers.
+ *
+ * @see Signal
+ */
 export class SignalHandler {
     /**
      *
@@ -20,7 +28,7 @@ export class SignalHandler {
      */
     private flags;
     /**
-     * Used to determine if handler was added mid-dispatch
+     * Used to determine if the handler was added mid-dispatch
      * @type {number}
      */
     generation: number;

package/src/core/events/signal/SignalHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SignalHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/events/signal/SignalHandler.js"],"names":[],"mappings":"iCAIU,MAAM;;;;AAShB;IAmBI;;;;OAIG;IACH,wCAFW,GAAC,EASX;IA9BD;;;OAGG;IACH,MAFU,aAAa,GAAC,IAAI,CAEhB;IAEZ;;;OAGG;IACH,cAAU;IAEV;;;OAGG;IACH,YAFU,MAAM,CAEA;IAWZ,iBAAoB;IACpB,aAAsB;IAI1B;;;;OAIG;IACH,cAHW,MAAM,GAAC,kBAAkB,GACvB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,kBAAkB,GACvB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,kBAAkB,SACzB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,kBAAkB,GACvB,OAAO,CAInB;IAIL;;;OAGG;IACH,0BAFU,OAAO,CAEsB;CANtC"}
+{"version":3,"file":"SignalHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/events/signal/SignalHandler.js"],"names":[],"mappings":"iCAIU,MAAM;;;;AAShB;;;;;;;GAOG;AACH;IAmBI;;;;OAIG;IACH,wCAFW,GAAC,EASX;IA9BD;;;OAGG;IACH,MAFU,aAAa,GAAC,IAAI,CAEhB;IAEZ;;;OAGG;IACH,cAAU;IAEV;;;OAGG;IACH,YAFU,MAAM,CAEA;IAWZ,iBAAoB;IACpB,aAAsB;IAI1B;;;;OAIG;IACH,cAHW,MAAM,GAAC,kBAAkB,GACvB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,kBAAkB,GACvB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,kBAAkB,SACzB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,kBAAkB,GACvB,OAAO,CAInB;IAIL;;;OAGG;IACH,0BAFU,OAAO,CAEsB;CANtC"}

package/src/core/events/signal/SignalHandler.js

@@ -11,6 +11,14 @@ export const SignalHandlerFlags = {
     RemoveAfterExecution: 1
 };
 
+/**
+ * Represents a handler for signals in the event system.
+ *
+ * Used to encapsulate callback functions along with their execution context and provide flag-based behavior control.
+ * They can be organized into linked lists using the `next` property to form a chain of handlers.
+ *
+ * @see Signal
+ */
 export class SignalHandler {
     /**
      * Optional field. Used for forming linked lists of handlers
@@ -25,7 +33,7 @@ export class SignalHandler {
     flags = 0;
 
     /**
-     * Used to determine if handler was added mid-dispatch
+     * Used to determine if the handler was added mid-dispatch
      * @type {number}
      */
     generation = -1;
@@ -36,7 +44,7 @@ export class SignalHandler {
      * @param {*} [context]
      */
     constructor(handle, context) {
-        assert.notEqual(handle, undefined, 'handle must be defined');
+        assert.defined(handle, 'handle');
         assert.isFunction(handle, 'handle');
 
         this.handle = handle;

package/src/core/fsm/simple/SimpleStateMachine.js

@@ -9,7 +9,7 @@ import { SimpleStateMachineDescription } from "./SimpleStateMachineDescription.j
 export class SimpleStateMachine {
 
     /**
-     *
+     * Current state, -1 indicated "unset"
      * @type {number}
      * @private
      */

package/src/core/geom/2d/spline_bezier2_2d.js

@@ -1,4 +1,4 @@
-import { spline_bezier2 } from "../../math/spline/spline_bezier2.js";
+import { spline2_bezier } from "../../math/spline/spline2_bezier.js";
 
 /**
  *
@@ -19,8 +19,8 @@ export function spline_bezier2_2d(
     t
 ) {
 
-    const x0 = spline_bezier2(t, p0x, p1x, p2x);
-    const y0 = spline_bezier2(t, p0y, p1y, p2y);
+    const x0 = spline2_bezier(t, p0x, p1x, p2x);
+    const y0 = spline2_bezier(t, p0y, p1y, p2y);
 
     result.set(x0, y0);
 }

package/src/core/geom/3d/tetrahedra/visualize_tetrahedral_mesh.d.ts

@@ -2,8 +2,8 @@
  *
  * @param {TetrahedralMesh} mesh
  * @param {number[]} positions
- * @param {string|number} color CSS color definition
- * @param {number} opacity
+ * @param {string|number} [color] CSS color definition
+ * @param {number} [opacity]
  * @returns {Entity}
  */
 export function visualize_tetrahedral_mesh({ mesh, positions, color, opacity }: TetrahedralMesh): Entity;

package/src/core/geom/3d/tetrahedra/visualize_tetrahedral_mesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visualize_tetrahedral_mesh.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/tetrahedra/visualize_tetrahedral_mesh.js"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,gFANW,eAAe,GAIb,MAAM,CA2BlB;mBAxCkB,kCAAkC"}
+{"version":3,"file":"visualize_tetrahedral_mesh.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/tetrahedra/visualize_tetrahedral_mesh.js"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,gFANW,eAAe,GAIb,MAAM,CA8BlB;mBA5CkB,kCAAkC"}

package/src/core/geom/3d/tetrahedra/visualize_tetrahedral_mesh.js

@@ -4,21 +4,25 @@ import { Transform } from "../../../../engine/ecs/transform/Transform.js";
 import { DrawMode } from "../../../../engine/graphics/ecs/mesh-v2/DrawMode.js";
 import { ShadedGeometry } from "../../../../engine/graphics/ecs/mesh-v2/ShadedGeometry.js";
 import { ShadedGeometryFlags } from "../../../../engine/graphics/ecs/mesh-v2/ShadedGeometryFlags.js";
+import { assert } from "../../../assert.js";
 import { build_tetrahedral_mesh_buffer_geometry } from "./graphics/build_tetrahedral_mesh_buffer_geometry.js";
 
 /**
  *
  * @param {TetrahedralMesh} mesh
  * @param {number[]} positions
- * @param {string|number} color CSS color definition
- * @param {number} opacity
+ * @param {string|number} [color] CSS color definition
+ * @param {number} [opacity]
  * @returns {Entity}
  */
 export function visualize_tetrahedral_mesh({
-                                               mesh, positions,
+                                               mesh,
+                                               positions,
                                                color = '#FF00FF',
                                                opacity = 0.35
                                            }) {
+    assert.defined(mesh, 'mesh');
+    assert.defined(positions, 'positions');
 
     const geometry = build_tetrahedral_mesh_buffer_geometry(mesh, positions);
 

package/src/core/geom/vec3/serialization/v3_binary_equality_decode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_binary_equality_decode.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/vec3/serialization/v3_binary_equality_decode.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,kDAPW,YAAY,UACZ,MAAM,EAAE,iBACR,MAAM,QA0ChB"}
+{"version":3,"file":"v3_binary_equality_decode.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/vec3/serialization/v3_binary_equality_decode.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,kDAPW,YAAY,UACZ,MAAM,EAAE,iBACR,MAAM,QAyDhB"}

package/src/core/geom/vec3/serialization/v3_binary_equality_decode.js

@@ -14,7 +14,22 @@ export function v3_binary_equality_decode(buffer, result, result_offset) {
     let y = 0;
     let z = 0;
 
-    if ((header & 7) === 7) {
+    if ((header & 0b01111) === 0b01111) {
+        // special encoded value, all 0
+
+        x = 0;
+        y = 0;
+        z = 0;
+
+    } else if ((header & 0b10111) === 0b10111) {
+
+        // special encoded value, all 1
+
+        x = 1;
+        y = 1;
+        z = 1;
+
+    } else if ((header & 7) === 7) {
         //all scale components are the same
         x = buffer.readFloat32();
         y = x;

package/src/core/geom/vec3/serialization/v3_binary_equality_encode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_binary_equality_encode.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/vec3/serialization/v3_binary_equality_encode.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,kDARW,YAAY,KACZ,MAAM,KACN,MAAM,KACN,MAAM,QA4ChB"}
+{"version":3,"file":"v3_binary_equality_encode.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/vec3/serialization/v3_binary_equality_encode.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,kDARW,YAAY,KACZ,MAAM,KACN,MAAM,KACN,MAAM,QA2DhB"}

package/src/core/geom/vec3/serialization/v3_binary_equality_encode.js

@@ -24,8 +24,23 @@ export function v3_binary_equality_encode(buffer, x, y, z){
         header |= 4;
     }
 
+    if (header === 7) {
+        if(x === 0){
+            // all axes 0
+            header |= 8;
+        }else if(x === 1){
+            // all axes 1
+            header |= 16;
+        }
+    }
+
     buffer.writeUint8(header);
 
+    if(header > 7){
+        // special value encoded in the header
+        return;
+    }
+
     if ((header & 7) === 7) {
         //all components are the same
         buffer.writeFloat32(x);

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

@@ -1,6 +1,6 @@
 /**
- * @deprecated use {@link spline_bezier3} directly
+ * @deprecated use {@link spline3_bezier} directly
  */
-export const cubicCurve: typeof spline_bezier3;
-import { spline_bezier3 } from "./spline_bezier3.js";
+export const cubicCurve: typeof spline3_bezier;
+import { spline3_bezier } from "./spline3_bezier.js";
 //# sourceMappingURL=cubicCurve.d.ts.map

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

@@ -1,6 +1,6 @@
-import { spline_bezier3 } from "./spline_bezier3.js";
+import { spline3_bezier } from "./spline3_bezier.js";
 
 /**
- * @deprecated use {@link spline_bezier3} directly
+ * @deprecated use {@link spline3_bezier} directly
  */
-export const cubicCurve = spline_bezier3;
+export const cubicCurve = spline3_bezier;

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

@@ -1,4 +1,4 @@
-import { cubicCurve } from "./cubicCurve.js";
+import { spline3_bezier } from "./spline3_bezier.js";
 
 /**
  *
@@ -10,6 +10,6 @@ import { cubicCurve } from "./cubicCurve.js";
  */
 export function makeCubicCurve(p0, p1, p2, p3) {
     return function (v) {
-        return cubicCurve(v, p0, p1, p2, p3);
+        return spline3_bezier(v, p0, p1, p2, p3);
     }
 }

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

@@ -0,0 +1,10 @@
+/**
+ * 2-nd (quadratic) degree bezier curve
+ * @param {number} t
+ * @param {number} p0
+ * @param {number} p1
+ * @param {number} p2
+ * @return {number}
+ */
+export function spline2_bezier(t: number, p0: number, p1: number, p2: number): number;
+//# sourceMappingURL=spline2_bezier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline2_bezier.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline2_bezier.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,kCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACL,MAAM,CAMjB"}

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

@@ -0,0 +1,13 @@
+/**
+ * 2-nd (quadratic) degree bezier curve
+ * @param {number} t
+ * @param {number} p0
+ * @param {number} p1
+ * @param {number} p2
+ * @return {number}
+ */
+export function spline2_bezier(t, p0, p1, p2) {
+    const inv_t = 1 - t;
+
+    return inv_t * inv_t * p0 + 2 * inv_t * t * p1 + t * t * p2;
+}

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

@@ -0,0 +1,13 @@
+/**
+ * 3-rd (cubic) degree bezier curve
+ * @see https://www.youtube.com/watch?v=jvPPXbo87ds&t=234s
+ * @see https://en.wikipedia.org/wiki/B%C3%A9zier_curve
+ * @param {number} t factor value between 0..1
+ * @param {number} p0 start point
+ * @param {number} p1 control point
+ * @param {number} p2 control point
+ * @param {number} p3 end point
+ * @returns {number}
+ */
+export function spline3_bezier(t: number, p0: number, p1: number, p2: number, p3: number): number;
+//# sourceMappingURL=spline3_bezier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline3_bezier.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_bezier.js"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,kCAPW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAgBlB"}

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

@@ -0,0 +1,26 @@
+/**
+ * 3-rd (cubic) degree bezier curve
+ * @see https://www.youtube.com/watch?v=jvPPXbo87ds&t=234s
+ * @see https://en.wikipedia.org/wiki/B%C3%A9zier_curve
+ * @param {number} t factor value between 0..1
+ * @param {number} p0 start point
+ * @param {number} p1 control point
+ * @param {number} p2 control point
+ * @param {number} p3 end point
+ * @returns {number}
+ */
+export function spline3_bezier(t, p0, p1, p2, p3) {
+    // first we compute necessary factors for each point
+    const nt = 1 - t;
+
+    const nt_2 = nt * nt;
+
+    const nt_3 = nt_2 * nt;
+
+    const t_2 = t * t;
+
+    const t_3 = t_2 * t;
+
+    // combine factors with point values to produce final result
+    return nt_3 * p0 + 3 * nt_2 * t * p1 + 3 * nt * t_2 * p2 + t_3 * p3;
+}

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

@@ -0,0 +1,15 @@
+/**
+ * Compute bounds of a 3-rd degree bezier curve
+ * Note that this is a 1d case solver
+ * Lower bound will be written into result[offset], upper bounds will be written into result[offset+result_stride]
+ * @see https://github.com/adobe-webplatform/Snap.svg/blob/c8e483c9694517e24b282f8f59f985629f4994ce/src/path.js#L856
+ * @param {number[]|Float32Array} result
+ * @param {number} result_offset offset into the result array
+ * @param {number} result_stride
+ * @param {number} p0
+ * @param {number} p1
+ * @param {number} p2
+ * @param {number} p3
+ */
+export function spline3_bezier_bounds(result: number[] | Float32Array, result_offset: number, result_stride: number, p0: number, p1: number, p2: number, p3: number): void;
+//# sourceMappingURL=spline3_bezier_bounds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline3_bezier_bounds.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_bezier_bounds.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,8CARW,MAAM,EAAE,GAAC,YAAY,iBACrB,MAAM,iBACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAuEhB"}

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

@@ -0,0 +1,89 @@
+import { assert } from "../../assert.js";
+import { max2 } from "../max2.js";
+import { min2 } from "../min2.js";
+import { spline3_bezier } from "./spline3_bezier.js";
+
+/**
+ * Compute bounds of a 3-rd degree bezier curve
+ * Note that this is a 1d case solver
+ * Lower bound will be written into result[offset], upper bounds will be written into result[offset+result_stride]
+ * @see https://github.com/adobe-webplatform/Snap.svg/blob/c8e483c9694517e24b282f8f59f985629f4994ce/src/path.js#L856
+ * @param {number[]|Float32Array} result
+ * @param {number} result_offset offset into the result array
+ * @param {number} result_stride
+ * @param {number} p0
+ * @param {number} p1
+ * @param {number} p2
+ * @param {number} p3
+ */
+export function spline3_bezier_bounds(result, result_offset, result_stride, p0, p1, p2, p3) {
+    assert.greaterThan(result_stride, 0, 'result_stride must be greater than 0');
+    assert.isInteger(result_stride, 'result_stride');
+
+    const b = 6 * p0 - 12 * p1 + 6 * p2;
+    const a = -3 * p0 + 9 * p1 - 9 * p2 + 3 * p3;
+    const c = 3 * p1 - 3 * p0;
+
+    let min = min2(p0, p3);
+    let max = max2(p0, p3);
+
+    if (Math.abs(a) < 1e-12) {
+
+        if (Math.abs(b) >= 1e-12) {
+            const t = -c / b;
+
+            if (0 < t && t < 1) {
+                const value = spline3_bezier(t, p0, p1, p2, p3);
+
+                if (value < min) {
+                    min = value;
+                }
+                if (value > max) {
+                    max = value;
+                }
+
+            }
+
+        }
+
+    } else {
+
+        const b2ac = b * b - 4 * c * a;
+        const sqrtb2ac = Math.sqrt(b2ac);
+
+        if (b2ac >= 0) {
+
+            const t1 = (-b + sqrtb2ac) / (2 * a);
+
+            if (0 < t1 && t1 < 1) {
+                const value = spline3_bezier(t1, p0, p1, p2, p3);
+
+                if (value < min) {
+                    min = value;
+                }
+                if (value > max) {
+                    max = value;
+                }
+            }
+
+            const t2 = (-b - sqrtb2ac) / (2 * a);
+
+            if (0 < t2 && t2 < 1) {
+                const value = spline3_bezier(t2, p0, p1, p2, p3);
+
+                if (value < min) {
+                    min = value;
+                }
+                if (value > max) {
+                    max = value;
+                }
+            }
+
+        }
+
+    }
+
+    result[result_offset] = min;
+    result[result_offset + result_stride] = max;
+}
+

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

@@ -0,0 +1,15 @@
+/**
+ * 1D
+ * Cubic spline.
+ * The result is [v0, m0, v1, m1] where X are values are M are tangents.
+ * @param {Float32Array|number[]} result where to put results
+ * @param {number} result_offset offset to start writing at in result array
+ * @param {number} result_stride how far to step between each written value. Necessary for N-dimensional curves where we want to interleave multiple curves together, such as for color or quaternions
+ * @param {number} p0
+ * @param {number} p1
+ * @param {number} p2
+ * @param {number} p3
+ * @see spline3_hermite_to_bezier
+ */
+export function spline3_bezier_to_hermite(result: Float32Array | number[], result_offset: number, result_stride: number, p0: number, p1: number, p2: number, p3: number): void;
+//# sourceMappingURL=spline3_bezier_to_hermite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline3_bezier_to_hermite.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_bezier_to_hermite.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,kDATW,YAAY,GAAC,MAAM,EAAE,iBACrB,MAAM,iBACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAsBhB"}

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

@@ -0,0 +1,33 @@
+/**
+ * 1D
+ * Cubic spline.
+ * The result is [v0, m0, v1, m1] where X are values are M are tangents.
+ * @param {Float32Array|number[]} result where to put results
+ * @param {number} result_offset offset to start writing at in result array
+ * @param {number} result_stride how far to step between each written value. Necessary for N-dimensional curves where we want to interleave multiple curves together, such as for color or quaternions
+ * @param {number} p0
+ * @param {number} p1
+ * @param {number} p2
+ * @param {number} p3
+ * @see spline3_hermite_to_bezier
+ */
+export function spline3_bezier_to_hermite(
+    result,
+    result_offset,
+    result_stride,
+    p0, p1, p2, p3,
+) {
+
+    // see https://github.com/krishauser/Klampt/blob/0ed16608a3eceee59d04383a17c207ebc33a399f/Python/klampt/math/spline.py#L133
+
+    const TENSION_FACTOR = 3;
+
+    const v0 = (p1 - p0) * TENSION_FACTOR;
+    const v1 = (p3 - p2) * TENSION_FACTOR;
+
+    result[result_offset + 0 * result_stride] = p0;
+    result[result_offset + 1 * result_stride] = v0;
+    result[result_offset + 2 * result_stride] = p3;
+    result[result_offset + 3 * result_stride] = v1;
+
+}

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

@@ -0,0 +1,15 @@
+/**
+ * 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
+ * @param {number} p1 second value
+ * @param {number} m0 first tangent (tangent exiting from first value)
+ * @param {number} m1 second tangent (tangent entering into second value)
+ * @return {number}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
+export function spline3_hermite(t: number, p0: number, p1: number, m0: number, m1: number): number;
+//# sourceMappingURL=spline3_hermite.d.ts.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * 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
+ * @param {number} p1 second value
+ * @param {number} m0 first tangent (tangent exiting from first value)
+ * @param {number} m1 second tangent (tangent entering into second value)
+ * @return {number}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
+export function spline3_hermite(t, p0, p1, m0, m1) {
+
+    const t2 = t * t;
+    const t3 = t2 * t;
+
+    const a = 2 * t3 - 3 * t2 + 1;
+    const b = t3 - 2 * t2 + t;
+    const c = t3 - t2;
+    const d = -2 * t3 + 3 * t2;
+
+    return a * p0 + b * m0 + c * m1 + d * p1;
+}
+

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

@@ -0,0 +1,17 @@
+/**
+ * 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
+ * @param {number} result_offset offset into the result array
+ * @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 spline3_hermite_bounds(result: number[] | Float32Array, result_offset: number, result_stride: number, p0: number, p1: number, m0: number, m1: number): void;
+//# sourceMappingURL=spline3_hermite_bounds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline3_hermite_bounds.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_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"}