@aura3d/engine 4.0.3 → 4.0.4

package/dist/math/curves/CurveBase.d.ts

@@ -0,0 +1,49 @@
+import { Vector2 } from "../Vector2.js";
+import { Vector3 } from "../Vector3.js";
+import type { Curve, FrenetFrame } from "../Curves.js";
+/**
+ * Abstract base implementing the frozen {@link Curve} contract with three.js
+ * `Curve` semantics: cached arc-length table (rebuilt once unless
+ * {@link updateArcLengths} is called), binary-search `getUtoTmapping`,
+ * finite-difference tangents and rotation-minimizing Frenet frames.
+ *
+ * Aura3D curves keep their control data in readonly fields; `getPoint` is the
+ * only abstract method — everything else derives from it exactly like three.
+ */
+export declare abstract class CurveBase<V extends Vector2 | Vector3> implements Curve<V> {
+    /** Samples used for the arc-length table (three.js `arcLengthDivisions`). */
+    arcLengthDivisions: number;
+    /** Set by {@link updateArcLengths}; invalidates the cached length table. */
+    needsUpdate: boolean;
+    protected cacheArcLengths: number[] | null;
+    /** Parametric point at `t` ∈ [0,1] (implementations define clamping). */
+    abstract getPoint(t: number): V;
+    getPointAt(u: number): V;
+    getPoints(divisions?: number): V[];
+    getSpacedPoints(divisions?: number): V[];
+    getLength(): number;
+    /**
+     * Cumulative arc lengths sampled at `divisions` uniform `t` values. The
+     * table is built once and cached until `divisions` changes or
+     * {@link updateArcLengths} is invoked (three.js `Curve.getLengths`).
+     */
+    getLengths(divisions?: number): number[];
+    updateArcLengths(): void;
+    /**
+     * Binary search over the cached arc-length table + linear interpolation,
+     * mapping normalized arc length `u` to curve parameter `t`
+     * (three.js `Curve.getUtoTmapping`).
+     */
+    getUtoTmapping(u: number): number;
+    /** Finite-difference unit tangent at `t` (three.js `Curve.getTangent`). */
+    getTangent(t: number): V;
+    getTangentAt(u: number): V;
+    /**
+     * Rotation-minimizing tangent/normal/binormal frames — three.js
+     * `Curve.computeFrenetFrames`. Only defined for `Vector3` curves; returns
+     * `null` for `Vector2` curves.
+     */
+    computeFrenetFrames(segments: number, closed?: boolean): FrenetFrame | null;
+    clone(): this;
+}
+//# sourceMappingURL=CurveBase.d.ts.map

package/dist/math/curves/CurveBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurveBase.d.ts","sourceRoot":"","sources":["../../../../../packages/math/src/curves/CurveBase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAcvD;;;;;;;;GAQG;AACH,8BAAsB,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAC9E,6EAA6E;IAC7E,kBAAkB,SAAO;IAEzB,4EAA4E;IAC5E,WAAW,UAAQ;IAEnB,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAQ;IAElD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC;IAE/B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC;IAKxB,SAAS,CAAC,SAAS,SAAI,GAAG,CAAC,EAAE;IAQ7B,eAAe,CAAC,SAAS,SAAI,GAAG,CAAC,EAAE;IAQnC,SAAS,IAAI,MAAM;IAKnB;;;;OAIG;IACH,UAAU,CAAC,SAAS,GAAE,MAAgC,GAAG,MAAM,EAAE;IAwBjE,gBAAgB,IAAI,IAAI;IAKxB;;;;OAIG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAsCjC,2EAA2E;IAC3E,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC;IAWxB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC;IAK1B;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,WAAW,GAAG,IAAI;IAiEzE,KAAK,IAAI,IAAI;CAGd"}

package/dist/math/curves/CurveBase.js

@@ -0,0 +1,199 @@
+import { Quaternion } from "../Quaternion.js";
+import { Vector2 } from "../Vector2.js";
+import { Vector3 } from "../Vector3.js";
+function subVectors(a, b) {
+    return a.subtract(b);
+}
+function distance(a, b) {
+    return a.distanceTo(b);
+}
+function clamp01(v, lo = -1, hi = 1) {
+    return Math.max(lo, Math.min(hi, v));
+}
+/**
+ * Abstract base implementing the frozen {@link Curve} contract with three.js
+ * `Curve` semantics: cached arc-length table (rebuilt once unless
+ * {@link updateArcLengths} is called), binary-search `getUtoTmapping`,
+ * finite-difference tangents and rotation-minimizing Frenet frames.
+ *
+ * Aura3D curves keep their control data in readonly fields; `getPoint` is the
+ * only abstract method — everything else derives from it exactly like three.
+ */
+export class CurveBase {
+    /** Samples used for the arc-length table (three.js `arcLengthDivisions`). */
+    arcLengthDivisions = 200;
+    /** Set by {@link updateArcLengths}; invalidates the cached length table. */
+    needsUpdate = true;
+    cacheArcLengths = null;
+    getPointAt(u) {
+        const t = this.getUtoTmapping(u);
+        return this.getPoint(t);
+    }
+    getPoints(divisions = 5) {
+        const points = [];
+        for (let d = 0; d <= divisions; d += 1) {
+            points.push(this.getPoint(d / divisions));
+        }
+        return points;
+    }
+    getSpacedPoints(divisions = 5) {
+        const points = [];
+        for (let d = 0; d <= divisions; d += 1) {
+            points.push(this.getPointAt(d / divisions));
+        }
+        return points;
+    }
+    getLength() {
+        const lengths = this.getLengths();
+        return lengths[lengths.length - 1];
+    }
+    /**
+     * Cumulative arc lengths sampled at `divisions` uniform `t` values. The
+     * table is built once and cached until `divisions` changes or
+     * {@link updateArcLengths} is invoked (three.js `Curve.getLengths`).
+     */
+    getLengths(divisions = this.arcLengthDivisions) {
+        if (this.cacheArcLengths !== null &&
+            this.cacheArcLengths.length === divisions + 1 &&
+            !this.needsUpdate) {
+            return this.cacheArcLengths;
+        }
+        this.needsUpdate = false;
+        const cache = [0];
+        let last = this.getPoint(0);
+        let sum = 0;
+        for (let p = 1; p <= divisions; p += 1) {
+            const current = this.getPoint(p / divisions);
+            sum += distance(current, last);
+            cache.push(sum);
+            last = current;
+        }
+        this.cacheArcLengths = cache;
+        return cache;
+    }
+    updateArcLengths() {
+        this.needsUpdate = true;
+        this.getLengths();
+    }
+    /**
+     * Binary search over the cached arc-length table + linear interpolation,
+     * mapping normalized arc length `u` to curve parameter `t`
+     * (three.js `Curve.getUtoTmapping`).
+     */
+    getUtoTmapping(u) {
+        const arcLengths = this.getLengths();
+        let i = 0;
+        const il = arcLengths.length;
+        const targetArcLength = u * arcLengths[il - 1];
+        // binary search
+        let low = 0;
+        let high = il - 1;
+        let comparison;
+        while (low <= high) {
+            i = Math.floor(low + (high - low) / 2);
+            comparison = arcLengths[i] - targetArcLength;
+            if (comparison < 0) {
+                low = i + 1;
+            }
+            else if (comparison > 0) {
+                high = i - 1;
+            }
+            else {
+                high = i;
+                break;
+            }
+        }
+        i = high;
+        if (arcLengths[i] === targetArcLength) {
+            return i / (il - 1);
+        }
+        const lengthBefore = arcLengths[i];
+        const lengthAfter = arcLengths[i + 1];
+        const segmentLength = lengthAfter - lengthBefore;
+        const segmentFraction = segmentLength === 0 ? 0 : (targetArcLength - lengthBefore) / segmentLength;
+        return (i + segmentFraction) / (il - 1);
+    }
+    /** Finite-difference unit tangent at `t` (three.js `Curve.getTangent`). */
+    getTangent(t) {
+        const delta = 0.0001;
+        let t1 = t - delta;
+        let t2 = t + delta;
+        if (t1 < 0)
+            t1 = 0;
+        if (t2 > 1)
+            t2 = 1;
+        const pt1 = this.getPoint(t1);
+        const pt2 = this.getPoint(t2);
+        return subVectors(pt2, pt1).normalize();
+    }
+    getTangentAt(u) {
+        const t = this.getUtoTmapping(u);
+        return this.getTangent(t);
+    }
+    /**
+     * Rotation-minimizing tangent/normal/binormal frames — three.js
+     * `Curve.computeFrenetFrames`. Only defined for `Vector3` curves; returns
+     * `null` for `Vector2` curves.
+     */
+    computeFrenetFrames(segments, closed = false) {
+        if (!(this.getPoint(0) instanceof Vector3)) {
+            return null;
+        }
+        const tangents = [];
+        const normals = [];
+        const binormals = [];
+        for (let i = 0; i <= segments; i += 1) {
+            const u = i / segments;
+            tangents[i] = this.getTangentAt(u);
+        }
+        // Initial normal: pick the smallest-magnitude tangent axis, orthogonalize.
+        let normal = new Vector3(0, 0, 0);
+        let min = Number.MAX_VALUE;
+        const tx = Math.abs(tangents[0].x);
+        const ty = Math.abs(tangents[0].y);
+        const tz = Math.abs(tangents[0].z);
+        if (tx <= min) {
+            min = tx;
+            normal = new Vector3(1, 0, 0);
+        }
+        if (ty <= min) {
+            min = ty;
+            normal = new Vector3(0, 1, 0);
+        }
+        if (tz <= min) {
+            normal = new Vector3(0, 0, 1);
+        }
+        const vec0 = tangents[0].cross(normal).normalize();
+        normals[0] = tangents[0].cross(vec0);
+        binormals[0] = tangents[0].cross(normals[0]);
+        // Parallel transport the frame along the curve.
+        for (let i = 1; i <= segments; i += 1) {
+            let n = normals[i - 1];
+            const vec = tangents[i - 1].cross(tangents[i]);
+            if (vec.length() > Number.EPSILON) {
+                const axis = vec.normalize();
+                const theta = Math.acos(clamp01(tangents[i - 1].dot(tangents[i])));
+                n = n.rotateByQuaternion(Quaternion.fromAxisAngle(axis, theta));
+            }
+            normals[i] = n;
+            binormals[i] = tangents[i].cross(n);
+        }
+        if (closed === true) {
+            let theta = Math.acos(clamp01(normals[0].dot(normals[segments])));
+            theta /= segments;
+            if (tangents[0].dot(normals[0].cross(normals[segments])) > 0) {
+                theta = -theta;
+            }
+            for (let i = 1; i <= segments; i += 1) {
+                const n = normals[i].rotateByQuaternion(Quaternion.fromAxisAngle(tangents[i], theta * i));
+                normals[i] = n;
+                binormals[i] = tangents[i].cross(n);
+            }
+        }
+        return { tangents, normals, binormals };
+    }
+    clone() {
+        throw new Error("CurveBase.clone must be implemented by subclasses.");
+    }
+}
+//# sourceMappingURL=CurveBase.js.map

package/dist/math/curves/CurveBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurveBase.js","sourceRoot":"","sources":["../../../../../packages/math/src/curves/CurveBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,SAAS,UAAU,CAA8B,CAAI,EAAE,CAAI;IACzD,OAAQ,CAAa,CAAC,QAAQ,CAAC,CAAY,CAAM,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,CAAoB,EAAE,CAAoB;IAC1D,OAAQ,CAAa,CAAC,UAAU,CAAC,CAAY,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,OAAO,CAAC,CAAS,EAAE,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAgB,SAAS;IAC7B,6EAA6E;IAC7E,kBAAkB,GAAG,GAAG,CAAC;IAEzB,4EAA4E;IAC5E,WAAW,GAAG,IAAI,CAAC;IAET,eAAe,GAAoB,IAAI,CAAC;IAKlD,UAAU,CAAC,CAAS;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,CAAC,SAAS,GAAG,CAAC;QACrB,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,eAAe,CAAC,SAAS,GAAG,CAAC;QAC3B,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,YAAoB,IAAI,CAAC,kBAAkB;QACpD,IACE,IAAI,CAAC,eAAe,KAAK,IAAI;YAC7B,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,SAAS,GAAG,CAAC;YAC7C,CAAC,IAAI,CAAC,WAAW,EACjB,CAAC;YACD,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAEzB,MAAM,KAAK,GAAa,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;YAC7C,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,IAAI,GAAG,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,CAAS;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;QAE7B,MAAM,eAAe,GAAG,CAAC,GAAG,UAAU,CAAC,EAAE,GAAG,CAAC,CAAE,CAAC;QAEhD,gBAAgB;QAChB,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QAClB,IAAI,UAAkB,CAAC;QACvB,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YACnB,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAE,GAAG,eAAe,CAAC;YAC9C,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACnB,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC1B,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,CAAC,CAAC;gBACT,MAAM;YACR,CAAC;QACH,CAAC;QACD,CAAC,GAAG,IAAI,CAAC;QAET,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,eAAe,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACtB,CAAC;QAED,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QACpC,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvC,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;QAEjD,MAAM,eAAe,GAAG,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,YAAY,CAAC,GAAG,aAAa,CAAC;QAEnG,OAAO,CAAC,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,2EAA2E;IAC3E,UAAU,CAAC,CAAS;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;YAAE,EAAE,GAAG,CAAC,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;YAAE,EAAE,GAAG,CAAC,CAAC;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC9B,OAAQ,UAAU,CAAC,GAAG,EAAE,GAAG,CAAa,CAAC,SAAS,EAAO,CAAC;IAC5D,CAAC;IAED,YAAY,CAAC,CAAS;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,QAAgB,EAAE,MAAM,GAAG,KAAK;QAClD,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAc,EAAE,CAAC;QAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACvB,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAY,CAAC;QAChD,CAAC;QAED,2EAA2E;QAC3E,IAAI,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,GAAG,EAAE,CAAC;YACT,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,GAAG,EAAE,CAAC;YACT,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;QACpD,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;QAE/C,gDAAgD;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC;YACjD,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;gBACrE,CAAC,GAAG,CAAC,CAAC,kBAAkB,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACf,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAE,CAAC,CAAC,CAAC,CAAC;YACpE,KAAK,IAAI,QAAQ,CAAC;YAClB,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChE,KAAK,GAAG,CAAC,KAAK,CAAC;YACjB,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC5F,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACf,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK;QACH,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/math/curves/CurvePath.d.ts

@@ -0,0 +1,34 @@
+import { Vector2 } from "../Vector2.js";
+import { Vector3 } from "../Vector3.js";
+import { CurveBase } from "./CurveBase.js";
+/**
+ * Concatenation of curves parameterized over the total arc length —
+ * three.js `CurvePath` parity (per-curve length cache, `getCurveLengths`,
+ * `autoClose`, `closePath`).
+ */
+export declare class CurvePath<V extends Vector2 | Vector3> extends CurveBase<V> {
+    readonly curves: CurveBase<V>[];
+    /** When true, `getPoints`/`getSpacedPoints` append the first point. */
+    autoClose: boolean;
+    /** Per-subcurve cumulative length cache (three.js `cacheLengths`). */
+    protected cacheLengths: number[] | null;
+    add(curve: CurveBase<V>): void;
+    /**
+     * Appends a `LineCurve`/`LineCurve3` from the last curve's end back to the
+     * first curve's start when they differ.
+     */
+    closePath(): this;
+    getPoint(t: number): V;
+    /**
+     * Total path length — overrides the base implementation because in a
+     * CurvePath `getPoint` depends on `getLength` (three does the same).
+     */
+    getLength(): number;
+    updateArcLengths(): void;
+    /** Cumulative sub-curve lengths (cached while `curves` is unchanged). */
+    getCurveLengths(): number[];
+    getSpacedPoints(divisions?: number): V[];
+    getPoints(divisions?: number): V[];
+    clone(): this;
+}
+//# sourceMappingURL=CurvePath.d.ts.map

package/dist/math/curves/CurvePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurvePath.d.ts","sourceRoot":"","sources":["../../../../../packages/math/src/curves/CurvePath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAW3C;;;;GAIG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAM;IAErC,uEAAuE;IACvE,SAAS,UAAS;IAElB,sEAAsE;IACtE,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAQ;IAE/C,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAI9B;;;OAGG;IACH,SAAS,IAAI,IAAI;IAajB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC;IAoBtB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAKV,gBAAgB,IAAI,IAAI;IAMjC,yEAAyE;IACzE,eAAe,IAAI,MAAM,EAAE;IAc3B,eAAe,CAAC,SAAS,SAAK,GAAG,CAAC,EAAE;IAWpC,SAAS,CAAC,SAAS,SAAK,GAAG,CAAC,EAAE;IAyB9B,KAAK,IAAI,IAAI;CAMd"}

package/dist/math/curves/CurvePath.js

@@ -0,0 +1,135 @@
+import { Vector2 } from "../Vector2.js";
+import { Vector3 } from "../Vector3.js";
+import { CurveBase } from "./CurveBase.js";
+import { LineCurve } from "./LineCurve.js";
+import { LineCurve3 } from "./LineCurve3.js";
+/** Component equality across the Vector2 | Vector3 union. */
+function vecEquals(a, b) {
+    if (a instanceof Vector2 && b instanceof Vector2)
+        return a.equals(b);
+    if (a instanceof Vector3 && b instanceof Vector3)
+        return a.equals(b);
+    return false;
+}
+/**
+ * Concatenation of curves parameterized over the total arc length —
+ * three.js `CurvePath` parity (per-curve length cache, `getCurveLengths`,
+ * `autoClose`, `closePath`).
+ */
+export class CurvePath extends CurveBase {
+    curves = [];
+    /** When true, `getPoints`/`getSpacedPoints` append the first point. */
+    autoClose = false;
+    /** Per-subcurve cumulative length cache (three.js `cacheLengths`). */
+    cacheLengths = null;
+    add(curve) {
+        this.curves.push(curve);
+    }
+    /**
+     * Appends a `LineCurve`/`LineCurve3` from the last curve's end back to the
+     * first curve's start when they differ.
+     */
+    closePath() {
+        const startPoint = this.curves[0].getPoint(0);
+        const endPoint = this.curves[this.curves.length - 1].getPoint(1);
+        if (!vecEquals(startPoint, endPoint)) {
+            if (startPoint instanceof Vector2) {
+                this.curves.push(new LineCurve(endPoint, startPoint));
+            }
+            else {
+                this.curves.push(new LineCurve3(endPoint, startPoint));
+            }
+        }
+        return this;
+    }
+    getPoint(t) {
+        if (this.curves.length === 0)
+            throw new RangeError("CurvePath is empty.");
+        // locate the sub-curve covering arc-length distance d = t * total length
+        const d = t * this.getLength();
+        const curveLengths = this.getCurveLengths();
+        let i = 0;
+        while (i < curveLengths.length) {
+            if (curveLengths[i] >= d) {
+                const diff = curveLengths[i] - d;
+                const curve = this.curves[i];
+                const segmentLength = curve.getLength();
+                const u = segmentLength === 0 ? 0 : 1 - diff / segmentLength;
+                return curve.getPointAt(u);
+            }
+            i += 1;
+        }
+        // t beyond the end: return the last point (three returns null)
+        return this.curves[this.curves.length - 1].getPoint(1);
+    }
+    /**
+     * Total path length — overrides the base implementation because in a
+     * CurvePath `getPoint` depends on `getLength` (three does the same).
+     */
+    getLength() {
+        const lens = this.getCurveLengths();
+        return lens[lens.length - 1] ?? 0;
+    }
+    updateArcLengths() {
+        this.needsUpdate = true;
+        this.cacheLengths = null;
+        this.getCurveLengths();
+    }
+    /** Cumulative sub-curve lengths (cached while `curves` is unchanged). */
+    getCurveLengths() {
+        if (this.cacheLengths && this.cacheLengths.length === this.curves.length) {
+            return this.cacheLengths;
+        }
+        const lengths = [];
+        let sums = 0;
+        for (const curve of this.curves) {
+            sums += curve.getLength();
+            lengths.push(sums);
+        }
+        this.cacheLengths = lengths;
+        return lengths;
+    }
+    getSpacedPoints(divisions = 40) {
+        const points = [];
+        for (let i = 0; i <= divisions; i += 1) {
+            points.push(this.getPoint(i / divisions));
+        }
+        if (this.autoClose) {
+            points.push(points[0]);
+        }
+        return points;
+    }
+    getPoints(divisions = 12) {
+        const points = [];
+        let last;
+        for (const curve of this.curves) {
+            const c = curve;
+            const resolution = c.isEllipseCurve
+                ? divisions * 2
+                : c.isLineCurve || c.isLineCurve3
+                    ? 1
+                    : c.isSplineCurve
+                        ? divisions * (c.points?.length ?? 1)
+                        : divisions;
+            const pts = curve.getPoints(resolution);
+            for (const point of pts) {
+                if (last && vecEquals(last, point))
+                    continue; // no consecutive duplicates
+                points.push(point);
+                last = point;
+            }
+        }
+        if (this.autoClose && points.length > 1 && !vecEquals(points[points.length - 1], points[0])) {
+            points.push(points[0]);
+        }
+        return points;
+    }
+    clone() {
+        const copy = new CurvePath();
+        for (const curve of this.curves)
+            copy.add(curve.clone());
+        copy.autoClose = this.autoClose;
+        return copy;
+    }
+}
+//# sourceMappingURL=CurvePath.js.map

package/dist/math/curves/CurvePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurvePath.js","sourceRoot":"","sources":["../../../../../packages/math/src/curves/CurvePath.ts"],"names":[],"mappings":"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"}

package/dist/math/curves/EllipseCurve.d.ts

@@ -0,0 +1,18 @@
+import { Vector2 } from "../Vector2.js";
+import { CurveBase } from "./CurveBase.js";
+/** 2D ellipse arc — three.js `EllipseCurve` parity. */
+export declare class EllipseCurve extends CurveBase<Vector2> {
+    readonly aX: number;
+    readonly aY: number;
+    readonly xRadius: number;
+    readonly yRadius: number;
+    readonly aStartAngle: number;
+    readonly aEndAngle: number;
+    readonly aClockwise: boolean;
+    readonly aRotation: number;
+    readonly isEllipseCurve: true;
+    constructor(aX?: number, aY?: number, xRadius?: number, yRadius?: number, aStartAngle?: number, aEndAngle?: number, aClockwise?: boolean, aRotation?: number);
+    getPoint(t: number): Vector2;
+    clone(): this;
+}
+//# sourceMappingURL=EllipseCurve.d.ts.map

package/dist/math/curves/EllipseCurve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EllipseCurve.d.ts","sourceRoot":"","sources":["../../../../../packages/math/src/curves/EllipseCurve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,uDAAuD;AACvD,qBAAa,YAAa,SAAQ,SAAS,CAAC,OAAO,CAAC;IAIhD,QAAQ,CAAC,EAAE;IACX,QAAQ,CAAC,EAAE;IACX,QAAQ,CAAC,OAAO;IAChB,QAAQ,CAAC,OAAO;IAChB,QAAQ,CAAC,WAAW;IACpB,QAAQ,CAAC,SAAS;IAClB,QAAQ,CAAC,UAAU;IACnB,QAAQ,CAAC,SAAS;IAVpB,QAAQ,CAAC,cAAc,EAAG,IAAI,CAAU;gBAG7B,EAAE,SAAI,EACN,EAAE,SAAI,EACN,OAAO,SAAI,EACX,OAAO,SAAI,EACX,WAAW,SAAI,EACf,SAAS,SAAc,EACvB,UAAU,UAAQ,EAClB,SAAS,SAAI;IAKxB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAyC5B,KAAK,IAAI,IAAI;CAMd"}

package/dist/math/curves/EllipseCurve.js

@@ -0,0 +1,67 @@
+import { Vector2 } from "../Vector2.js";
+import { CurveBase } from "./CurveBase.js";
+/** 2D ellipse arc — three.js `EllipseCurve` parity. */
+export class EllipseCurve extends CurveBase {
+    aX;
+    aY;
+    xRadius;
+    yRadius;
+    aStartAngle;
+    aEndAngle;
+    aClockwise;
+    aRotation;
+    isEllipseCurve = true;
+    constructor(aX = 0, aY = 0, xRadius = 1, yRadius = 1, aStartAngle = 0, aEndAngle = Math.PI * 2, aClockwise = false, aRotation = 0) {
+        super();
+        this.aX = aX;
+        this.aY = aY;
+        this.xRadius = xRadius;
+        this.yRadius = yRadius;
+        this.aStartAngle = aStartAngle;
+        this.aEndAngle = aEndAngle;
+        this.aClockwise = aClockwise;
+        this.aRotation = aRotation;
+    }
+    getPoint(t) {
+        const twoPi = Math.PI * 2;
+        let deltaAngle = this.aEndAngle - this.aStartAngle;
+        const samePoints = Math.abs(deltaAngle) < Number.EPSILON;
+        // ensures that deltaAngle is 0 .. 2 PI
+        while (deltaAngle < 0)
+            deltaAngle += twoPi;
+        while (deltaAngle > twoPi)
+            deltaAngle -= twoPi;
+        if (deltaAngle < Number.EPSILON) {
+            if (samePoints) {
+                deltaAngle = 0;
+            }
+            else {
+                deltaAngle = twoPi;
+            }
+        }
+        if (this.aClockwise === true && !samePoints) {
+            if (deltaAngle === twoPi) {
+                deltaAngle = -twoPi;
+            }
+            else {
+                deltaAngle = deltaAngle - twoPi;
+            }
+        }
+        const angle = this.aStartAngle + t * deltaAngle;
+        let x = this.aX + this.xRadius * Math.cos(angle);
+        let y = this.aY + this.yRadius * Math.sin(angle);
+        if (this.aRotation !== 0) {
+            const cos = Math.cos(this.aRotation);
+            const sin = Math.sin(this.aRotation);
+            const tx = x - this.aX;
+            const ty = y - this.aY;
+            x = tx * cos - ty * sin + this.aX;
+            y = tx * sin + ty * cos + this.aY;
+        }
+        return new Vector2(x, y);
+    }
+    clone() {
+        return new EllipseCurve(this.aX, this.aY, this.xRadius, this.yRadius, this.aStartAngle, this.aEndAngle, this.aClockwise, this.aRotation);
+    }
+}
+//# sourceMappingURL=EllipseCurve.js.map

package/dist/math/curves/EllipseCurve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EllipseCurve.js","sourceRoot":"","sources":["../../../../../packages/math/src/curves/EllipseCurve.ts"],"names":[],"mappings":"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"}

package/dist/math/curves/Interpolations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Scalar spline/Bézier basis functions shared by the curve classes —
+ * three.js `extras/core/Interpolations.js` parity.
+ */
+/** Catmull-Rom spline interpolation (uniform, tension 0.5). */
+export declare function CatmullRom(t: number, p0: number, p1: number, p2: number, p3: number): number;
+export declare function QuadraticBezier(t: number, p0: number, p1: number, p2: number): number;
+export declare function CubicBezier(t: number, p0: number, p1: number, p2: number, p3: number): number;
+//# sourceMappingURL=Interpolations.d.ts.map

package/dist/math/curves/Interpolations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Interpolations.d.ts","sourceRoot":"","sources":["../../../../../packages/math/src/curves/Interpolations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAM5F;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGrF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG7F"}

package/dist/math/curves/Interpolations.js

@@ -0,0 +1,21 @@
+/**
+ * Scalar spline/Bézier basis functions shared by the curve classes —
+ * three.js `extras/core/Interpolations.js` parity.
+ */
+/** Catmull-Rom spline interpolation (uniform, tension 0.5). */
+export function CatmullRom(t, p0, p1, p2, p3) {
+    const v0 = (p2 - p0) * 0.5;
+    const v1 = (p3 - p1) * 0.5;
+    const t2 = t * t;
+    const t3 = t * t2;
+    return (2 * p1 - 2 * p2 + v0 + v1) * t3 + (-3 * p1 + 3 * p2 - 2 * v0 - v1) * t2 + v0 * t + p1;
+}
+export function QuadraticBezier(t, p0, p1, p2) {
+    const k = 1 - t;
+    return k * k * p0 + 2 * (1 - t) * t * p1 + t * t * p2;
+}
+export function CubicBezier(t, p0, p1, p2, p3) {
+    const k = 1 - t;
+    return k * k * k * p0 + 3 * k * k * t * p1 + 3 * (1 - t) * t * t * p2 + t * t * t * p3;
+}
+//# sourceMappingURL=Interpolations.js.map

package/dist/math/curves/Interpolations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Interpolations.js","sourceRoot":"","sources":["../../../../../packages/math/src/curves/Interpolations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;IAClF,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IAClB,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;IAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;IACnF,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AACzF,CAAC"}

package/dist/math/curves/LineCurve.d.ts

@@ -0,0 +1,16 @@
+import { Vector2 } from "../Vector2.js";
+import { CurveBase } from "./CurveBase.js";
+/** 2D line segment — three.js `LineCurve` parity. */
+export declare class LineCurve extends CurveBase<Vector2> {
+    readonly v1: Vector2;
+    readonly v2: Vector2;
+    readonly isLineCurve: true;
+    constructor(v1?: Vector2, v2?: Vector2);
+    getPoint(t: number): Vector2;
+    /** Linear curve: `u` is already arc-length uniform. */
+    getPointAt(u: number): Vector2;
+    getTangent(_t: number): Vector2;
+    getTangentAt(u: number): Vector2;
+    clone(): this;
+}
+//# sourceMappingURL=LineCurve.d.ts.map

package/dist/math/curves/LineCurve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineCurve.d.ts","sourceRoot":"","sources":["../../../../../packages/math/src/curves/LineCurve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qDAAqD;AACrD,qBAAa,SAAU,SAAQ,SAAS,CAAC,OAAO,CAAC;IAI7C,QAAQ,CAAC,EAAE,EAAE,OAAO;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO;IAJtB,QAAQ,CAAC,WAAW,EAAG,IAAI,CAAU;gBAG1B,EAAE,GAAE,OAA2B,EAC/B,EAAE,GAAE,OAA2B;IAK1C,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAK5B,uDAAuD;IACvD,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAI9B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAIhC,KAAK,IAAI,IAAI;CAGd"}

package/dist/math/curves/LineCurve.js

@@ -0,0 +1,32 @@
+import { Vector2 } from "../Vector2.js";
+import { CurveBase } from "./CurveBase.js";
+/** 2D line segment — three.js `LineCurve` parity. */
+export class LineCurve extends CurveBase {
+    v1;
+    v2;
+    isLineCurve = true;
+    constructor(v1 = new Vector2(0, 0), v2 = new Vector2(0, 0)) {
+        super();
+        this.v1 = v1;
+        this.v2 = v2;
+    }
+    getPoint(t) {
+        if (t === 1)
+            return this.v2;
+        return this.v2.subtract(this.v1).multiplyScalar(t).add(this.v1);
+    }
+    /** Linear curve: `u` is already arc-length uniform. */
+    getPointAt(u) {
+        return this.getPoint(u);
+    }
+    getTangent(_t) {
+        return this.v2.subtract(this.v1).normalize();
+    }
+    getTangentAt(u) {
+        return this.getTangent(u);
+    }
+    clone() {
+        return new LineCurve(this.v1, this.v2);
+    }
+}
+//# sourceMappingURL=LineCurve.js.map

package/dist/math/curves/LineCurve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineCurve.js","sourceRoot":"","sources":["../../../../../packages/math/src/curves/LineCurve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qDAAqD;AACrD,MAAM,OAAO,SAAU,SAAQ,SAAkB;IAIpC;IACA;IAJF,WAAW,GAAG,IAAa,CAAC;IAErC,YACW,KAAc,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,KAAc,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QAExC,KAAK,EAAE,CAAC;QAHC,OAAE,GAAF,EAAE,CAA6B;QAC/B,OAAE,GAAF,EAAE,CAA6B;IAG1C,CAAC;IAED,QAAQ,CAAC,CAAS;QAChB,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,uDAAuD;IACvD,UAAU,CAAC,CAAS;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;IAC/C,CAAC;IAED,YAAY,CAAC,CAAS;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAS,CAAC;IACjD,CAAC;CACF"}