@triforge/curve-core 0.1.0

package/dist/core/BaseCurve.d.ts

@@ -0,0 +1,44 @@
+import { Vector3 } from 'three';
+/**
+ * Abstract base for all curve types.
+ * Mirrors Blender's internal curve spline: evaluate at parameter t ∈ [0,1].
+ */
+export declare abstract class BaseCurve {
+    abstract readonly curveType: string;
+    /** All scalar inputs live here for GSAP/keyframe compatibility. */
+    abstract parameters: Record<string, number>;
+    /**
+     * Evaluate the curve at parameter t ∈ [0,1].
+     * t=0 → start point, t=1 → end point.
+     */
+    abstract getPoint(t: number, target?: Vector3): Vector3;
+    /**
+     * Tangent vector at t (unit length).
+     * Default: finite difference. Override for analytic tangents.
+     */
+    getTangent(t: number, target?: Vector3): Vector3;
+    /** Arc length of the curve, sampled at `divisions` points. */
+    getLength(divisions?: number): number;
+    /**
+     * Build a cumulative arc-length LUT (lookup table).
+     * Returns array of {t, len} pairs with `divisions+1` entries.
+     * Used internally for uniform-speed parameterization.
+     */
+    buildArcLengthLUT(divisions?: number): {
+        t: number;
+        len: number;
+    }[];
+    /**
+     * Map a uniform arc-length fraction u ∈ [0,1] → curve parameter t ∈ [0,1].
+     * Enables constant-speed path-follow.
+     */
+    getUtoTmapping(u: number, lut: {
+        t: number;
+        len: number;
+    }[]): number;
+    /**
+     * Sample N evenly-spaced points along the curve (arc-length uniform).
+     */
+    getSpacedPoints(count: number, divisions?: number): Vector3[];
+}
+//# sourceMappingURL=BaseCurve.d.ts.map

package/dist/core/BaseCurve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCurve.d.ts","sourceRoot":"","sources":["../../src/core/BaseCurve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B;;;GAGG;AACH,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IACnC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE3C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAEvD;;;OAGG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,UAAgB,GAAG,OAAO;IAStD,8DAA8D;IAC9D,SAAS,CAAC,SAAS,SAAM,GAAG,MAAM;IAWlC;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,SAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE;IAchE;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,MAAM;IAiBpE;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,OAAO,EAAE;CAO3D"}

package/dist/core/BaseCurve.js

@@ -0,0 +1,83 @@
+import { Vector3 } from 'three';
+/**
+ * Abstract base for all curve types.
+ * Mirrors Blender's internal curve spline: evaluate at parameter t ∈ [0,1].
+ */
+export class BaseCurve {
+    /**
+     * Tangent vector at t (unit length).
+     * Default: finite difference. Override for analytic tangents.
+     */
+    getTangent(t, target = new Vector3()) {
+        const delta = 1e-4;
+        const t0 = Math.max(0, t - delta);
+        const t1 = Math.min(1, t + delta);
+        const p0 = this.getPoint(t0);
+        const p1 = this.getPoint(t1);
+        return target.subVectors(p1, p0).normalize();
+    }
+    /** Arc length of the curve, sampled at `divisions` points. */
+    getLength(divisions = 200) {
+        let len = 0;
+        let prev = this.getPoint(0);
+        for (let i = 1; i <= divisions; i++) {
+            const cur = this.getPoint(i / divisions);
+            len += prev.distanceTo(cur);
+            prev = cur;
+        }
+        return len;
+    }
+    /**
+     * Build a cumulative arc-length LUT (lookup table).
+     * Returns array of {t, len} pairs with `divisions+1` entries.
+     * Used internally for uniform-speed parameterization.
+     */
+    buildArcLengthLUT(divisions = 200) {
+        const lut = [{ t: 0, len: 0 }];
+        let acc = 0;
+        let prev = this.getPoint(0);
+        for (let i = 1; i <= divisions; i++) {
+            const ti = i / divisions;
+            const cur = this.getPoint(ti);
+            acc += prev.distanceTo(cur);
+            lut.push({ t: ti, len: acc });
+            prev = cur;
+        }
+        return lut;
+    }
+    /**
+     * Map a uniform arc-length fraction u ∈ [0,1] → curve parameter t ∈ [0,1].
+     * Enables constant-speed path-follow.
+     */
+    getUtoTmapping(u, lut) {
+        const totalLen = lut[lut.length - 1].len;
+        const target = u * totalLen;
+        // Binary search for the segment
+        let lo = 0, hi = lut.length - 1;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (lut[mid].len < target)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        if (lo === 0)
+            return 0;
+        const a = lut[lo - 1], b = lut[lo];
+        if (b.len === a.len)
+            return b.t;
+        const alpha = (target - a.len) / (b.len - a.len);
+        return a.t + alpha * (b.t - a.t);
+    }
+    /**
+     * Sample N evenly-spaced points along the curve (arc-length uniform).
+     */
+    getSpacedPoints(count, divisions = 200) {
+        const lut = this.buildArcLengthLUT(divisions);
+        return Array.from({ length: count }, (_, i) => {
+            const t = this.getUtoTmapping(i / (count - 1), lut);
+            return this.getPoint(t);
+        });
+    }
+}
+//# sourceMappingURL=BaseCurve.js.map

package/dist/core/BaseCurve.js.map

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

package/dist/core/BezierCurve.d.ts

@@ -0,0 +1,63 @@
+import { Vector3 } from 'three';
+import { BaseCurve } from './BaseCurve.js';
+/**
+ * BezierCurve — cubic Bezier spline through one or more segments.
+ * Blender: Bezier Curve spline type.
+ *
+ * Control points are stored as [anchor, handleRight, …, handleLeft, anchor] triplets.
+ * Each segment is defined by: anchor0, handleRight0, handleLeft1, anchor1.
+ *
+ * For a single segment, 4 control points: p0, p1 (right handle of p0), p2 (left handle of p1), p3.
+ * For N segments, 3N+1 points.
+ */
+export declare class BezierCurve extends BaseCurve {
+    readonly curveType = "BezierCurve";
+    parameters: Record<string, number>;
+    /** Flat array of control points: [p0, h0r, h1l, p1, h1r, h2l, p2, ...] */
+    private _points;
+    /** Whether the curve is closed (last point connects to first). */
+    closed: boolean;
+    constructor(points: Vector3[], closed?: boolean);
+    get points(): readonly Vector3[];
+    /** Number of Bezier segments. */
+    get segmentCount(): number;
+    getPoint(t: number, target?: Vector3): Vector3;
+    getTangent(t: number, target?: Vector3): Vector3;
+}
+/**
+ * Build aligned-handle control points.
+ * Blender: Aligned handle type — both handles share the same direction (mirrored).
+ * The caller supplies the right handle for each anchor; the left handle is the mirror.
+ *
+ * @param anchors       Anchor positions (one per control point).
+ * @param rightHandles  Right handle per anchor. Must be same length as anchors.
+ * @param closed        Whether the curve closes back on the first anchor.
+ * @returns Flat control-point array accepted by the BezierCurve constructor.
+ */
+export declare function buildAlignedHandles(anchors: Vector3[], rightHandles: Vector3[], closed?: boolean): Vector3[];
+/**
+ * Build vector-handle control points.
+ * Blender: Vector handle type — each handle points straight toward the adjacent anchor.
+ *
+ * @param anchors Anchor positions.
+ * @param closed  Whether the curve closes back on the first anchor.
+ * @returns Flat control-point array accepted by the BezierCurve constructor.
+ */
+export declare function buildVectorHandles(anchors: Vector3[], closed?: boolean): Vector3[];
+/**
+ * Build free-handle control points.
+ * Blender: Free handle type — each handle is fully user-specified; no mirroring.
+ *
+ * @param anchors      Anchor positions.
+ * @param leftHandles  Left (incoming) handle per anchor. Must be same length as anchors.
+ * @param rightHandles Right (outgoing) handle per anchor. Must be same length as anchors.
+ * @returns Flat control-point array accepted by the BezierCurve constructor.
+ */
+export declare function buildFreeHandles(anchors: Vector3[], leftHandles: Vector3[], rightHandles: Vector3[]): Vector3[];
+/**
+ * Build a smooth Bezier curve through a set of anchor points with auto-handles.
+ * Blender: Smart Bezier / Auto handles.
+ * Uses Catmull-Rom–style handle generation for smooth passage through all points.
+ */
+export declare function buildAutoHandles(anchors: Vector3[], closed?: boolean, tension?: number): Vector3[];
+//# sourceMappingURL=BezierCurve.d.ts.map

package/dist/core/BezierCurve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BezierCurve.d.ts","sourceRoot":"","sources":["../../src/core/BezierCurve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,QAAQ,CAAC,SAAS,iBAAgB;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAK;IAEvC,0EAA0E;IAC1E,OAAO,CAAC,OAAO,CAAW;IAC1B,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAA;gBAEH,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,UAAQ;IAO7C,IAAI,MAAM,IAAI,SAAS,OAAO,EAAE,CAAwB;IAExD,iCAAiC;IACjC,IAAI,YAAY,IAAI,MAAM,CAIzB;IAED,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,UAAgB,GAAG,OAAO;IAgBpD,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,UAAgB,GAAG,OAAO;CAevD;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAAE,EAClB,YAAY,EAAE,OAAO,EAAE,EACvB,MAAM,UAAQ,GACb,OAAO,EAAE,CA2BX;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,UAAQ,GAAG,OAAO,EAAE,CA2ChF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAAE,EAClB,WAAW,EAAE,OAAO,EAAE,EACtB,YAAY,EAAE,OAAO,EAAE,GACtB,OAAO,EAAE,CAwBX;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,UAAQ,EAAE,OAAO,SAAM,GAAG,OAAO,EAAE,CAoC7F"}

package/dist/core/BezierCurve.js

@@ -0,0 +1,218 @@
+import { Vector3 } from 'three';
+import { BaseCurve } from './BaseCurve.js';
+/**
+ * BezierCurve — cubic Bezier spline through one or more segments.
+ * Blender: Bezier Curve spline type.
+ *
+ * Control points are stored as [anchor, handleRight, …, handleLeft, anchor] triplets.
+ * Each segment is defined by: anchor0, handleRight0, handleLeft1, anchor1.
+ *
+ * For a single segment, 4 control points: p0, p1 (right handle of p0), p2 (left handle of p1), p3.
+ * For N segments, 3N+1 points.
+ */
+export class BezierCurve extends BaseCurve {
+    constructor(points, closed = false) {
+        super();
+        this.curveType = 'BezierCurve';
+        this.parameters = {};
+        if (points.length < 4)
+            throw new Error('BezierCurve requires at least 4 control points (1 segment)');
+        this._points = points;
+        this.closed = closed;
+    }
+    get points() { return this._points; }
+    /** Number of Bezier segments. */
+    get segmentCount() {
+        return this.closed
+            ? Math.floor(this._points.length / 3)
+            : Math.floor((this._points.length - 1) / 3);
+    }
+    getPoint(t, target = new Vector3()) {
+        t = Math.max(0, Math.min(1, t));
+        const segments = this.segmentCount;
+        const seg = Math.min(Math.floor(t * segments), segments - 1);
+        const local = t * segments - seg;
+        const base = seg * 3;
+        const n = this._points.length;
+        const p0 = this._points[base % n];
+        const p1 = this._points[(base + 1) % n];
+        const p2 = this._points[(base + 2) % n];
+        const p3 = this._points[(base + 3) % n];
+        return deCasteljau(p0, p1, p2, p3, local, target);
+    }
+    getTangent(t, target = new Vector3()) {
+        t = Math.max(0, Math.min(1, t));
+        const segments = this.segmentCount;
+        const seg = Math.min(Math.floor(t * segments), segments - 1);
+        const local = t * segments - seg;
+        const base = seg * 3;
+        const n = this._points.length;
+        const p0 = this._points[base % n];
+        const p1 = this._points[(base + 1) % n];
+        const p2 = this._points[(base + 2) % n];
+        const p3 = this._points[(base + 3) % n];
+        return cubicBezierTangent(p0, p1, p2, p3, local, target);
+    }
+}
+/** Cubic Bezier evaluation via de Casteljau (numerically stable). */
+function deCasteljau(p0, p1, p2, p3, t, out) {
+    const mt = 1 - t;
+    const x = mt * mt * mt * p0.x + 3 * mt * mt * t * p1.x + 3 * mt * t * t * p2.x + t * t * t * p3.x;
+    const y = mt * mt * mt * p0.y + 3 * mt * mt * t * p1.y + 3 * mt * t * t * p2.y + t * t * t * p3.y;
+    const z = mt * mt * mt * p0.z + 3 * mt * mt * t * p1.z + 3 * mt * t * t * p2.z + t * t * t * p3.z;
+    return out.set(x, y, z);
+}
+/** Cubic Bezier derivative (tangent) — analytic. */
+function cubicBezierTangent(p0, p1, p2, p3, t, out) {
+    const mt = 1 - t;
+    const x = 3 * (mt * mt * (p1.x - p0.x) + 2 * mt * t * (p2.x - p1.x) + t * t * (p3.x - p2.x));
+    const y = 3 * (mt * mt * (p1.y - p0.y) + 2 * mt * t * (p2.y - p1.y) + t * t * (p3.y - p2.y));
+    const z = 3 * (mt * mt * (p1.z - p0.z) + 2 * mt * t * (p2.z - p1.z) + t * t * (p3.z - p2.z));
+    const len = Math.sqrt(x * x + y * y + z * z) || 1;
+    return out.set(x / len, y / len, z / len);
+}
+/**
+ * Build aligned-handle control points.
+ * Blender: Aligned handle type — both handles share the same direction (mirrored).
+ * The caller supplies the right handle for each anchor; the left handle is the mirror.
+ *
+ * @param anchors       Anchor positions (one per control point).
+ * @param rightHandles  Right handle per anchor. Must be same length as anchors.
+ * @param closed        Whether the curve closes back on the first anchor.
+ * @returns Flat control-point array accepted by the BezierCurve constructor.
+ */
+export function buildAlignedHandles(anchors, rightHandles, closed = false) {
+    const n = anchors.length;
+    if (n < 2)
+        throw new Error('Need at least 2 anchor points');
+    if (rightHandles.length !== n)
+        throw new Error('rightHandles must have the same length as anchors');
+    const pts = [];
+    for (let i = 0; i < n; i++) {
+        const cur = anchors[i];
+        const hr = rightHandles[i];
+        // Left handle is the mirror of the right handle across the anchor
+        const hl = new Vector3(2 * cur.x - hr.x, 2 * cur.y - hr.y, 2 * cur.z - hr.z);
+        if (i === 0) {
+            pts.push(cur.clone(), hr.clone());
+        }
+        else if (i === n - 1 && !closed) {
+            pts.push(hl, cur.clone());
+        }
+        else {
+            pts.push(hl, cur.clone(), hr.clone());
+        }
+    }
+    return pts;
+}
+/**
+ * Build vector-handle control points.
+ * Blender: Vector handle type — each handle points straight toward the adjacent anchor.
+ *
+ * @param anchors Anchor positions.
+ * @param closed  Whether the curve closes back on the first anchor.
+ * @returns Flat control-point array accepted by the BezierCurve constructor.
+ */
+export function buildVectorHandles(anchors, closed = false) {
+    const n = anchors.length;
+    if (n < 2)
+        throw new Error('Need at least 2 anchor points');
+    const pts = [];
+    const scale = 1 / 3;
+    for (let i = 0; i < n; i++) {
+        const cur = anchors[i];
+        const prev = anchors[(i - 1 + n) % n];
+        const next = anchors[(i + 1) % n];
+        const isFirst = !closed && i === 0;
+        const isLast = !closed && i === n - 1;
+        // Right handle: points toward next anchor (or stays at cur for open-end last)
+        const hr = isLast
+            ? cur.clone()
+            : new Vector3(cur.x + (next.x - cur.x) * scale, cur.y + (next.y - cur.y) * scale, cur.z + (next.z - cur.z) * scale);
+        // Left handle: points toward prev anchor (or stays at cur for open-end first)
+        const hl = isFirst
+            ? cur.clone()
+            : new Vector3(cur.x + (prev.x - cur.x) * scale, cur.y + (prev.y - cur.y) * scale, cur.z + (prev.z - cur.z) * scale);
+        if (i === 0) {
+            pts.push(cur.clone(), hr);
+        }
+        else if (i === n - 1 && !closed) {
+            pts.push(hl, cur.clone());
+        }
+        else {
+            pts.push(hl, cur.clone(), hr);
+        }
+    }
+    return pts;
+}
+/**
+ * Build free-handle control points.
+ * Blender: Free handle type — each handle is fully user-specified; no mirroring.
+ *
+ * @param anchors      Anchor positions.
+ * @param leftHandles  Left (incoming) handle per anchor. Must be same length as anchors.
+ * @param rightHandles Right (outgoing) handle per anchor. Must be same length as anchors.
+ * @returns Flat control-point array accepted by the BezierCurve constructor.
+ */
+export function buildFreeHandles(anchors, leftHandles, rightHandles) {
+    const n = anchors.length;
+    if (n < 2)
+        throw new Error('Need at least 2 anchor points');
+    if (leftHandles.length !== n || rightHandles.length !== n) {
+        throw new Error('leftHandles and rightHandles must have the same length as anchors');
+    }
+    const pts = [];
+    for (let i = 0; i < n; i++) {
+        const cur = anchors[i];
+        const hr = rightHandles[i];
+        const hl = leftHandles[i];
+        if (i === 0) {
+            pts.push(cur.clone(), hr.clone());
+        }
+        else if (i === n - 1) {
+            pts.push(hl.clone(), cur.clone());
+        }
+        else {
+            pts.push(hl.clone(), cur.clone(), hr.clone());
+        }
+    }
+    return pts;
+}
+/**
+ * Build a smooth Bezier curve through a set of anchor points with auto-handles.
+ * Blender: Smart Bezier / Auto handles.
+ * Uses Catmull-Rom–style handle generation for smooth passage through all points.
+ */
+export function buildAutoHandles(anchors, closed = false, tension = 0.5) {
+    const n = anchors.length;
+    if (n < 2)
+        throw new Error('Need at least 2 anchor points');
+    const pts = [];
+    for (let i = 0; i < n; i++) {
+        const prev = anchors[(i - 1 + n) % n];
+        const cur = anchors[i];
+        const next = anchors[(i + 1) % n];
+        const isFirst = !closed && i === 0;
+        const isLast = !closed && i === n - 1;
+        // Tangent direction: difference of neighbours
+        const dx = isFirst ? (next.x - cur.x) : isLast ? (cur.x - prev.x) : (next.x - prev.x) * tension;
+        const dy = isFirst ? (next.y - cur.y) : isLast ? (cur.y - prev.y) : (next.y - prev.y) * tension;
+        const dz = isFirst ? (next.z - cur.z) : isLast ? (cur.z - prev.z) : (next.z - prev.z) * tension;
+        const scale = 1 / 3;
+        // Left handle (incoming)
+        const hl = new Vector3(cur.x - dx * scale, cur.y - dy * scale, cur.z - dz * scale);
+        // Right handle (outgoing)
+        const hr = new Vector3(cur.x + dx * scale, cur.y + dy * scale, cur.z + dz * scale);
+        if (i === 0) {
+            pts.push(cur.clone(), hr);
+        }
+        else if (i === n - 1) {
+            pts.push(hl, cur.clone());
+        }
+        else {
+            pts.push(hl, cur.clone(), hr);
+        }
+    }
+    return pts;
+}
+//# sourceMappingURL=BezierCurve.js.map

package/dist/core/BezierCurve.js.map

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

package/dist/core/CatmullRomCurve.d.ts

@@ -0,0 +1,28 @@
+import { Vector3 } from 'three';
+import { BaseCurve } from './BaseCurve.js';
+/**
+ * CatmullRomCurve — smooth interpolating spline through all control points.
+ * Blender: Poly spline with smooth interpolation / Path animation target.
+ *
+ * Unlike Bezier, every point lies ON the curve. Ideal for camera paths,
+ * particle guides, and path-follow animations.
+ *
+ * Supports Catmull-Rom (tension=0.5) and general tension control.
+ * Blender uses Catmull-Rom for its path animation curves by default.
+ */
+export declare class CatmullRomCurve extends BaseCurve {
+    readonly curveType = "CatmullRomCurve";
+    parameters: {
+        tension: number;
+    };
+    private _points;
+    closed: boolean;
+    constructor(points: Vector3[], opts?: {
+        tension?: number;
+        closed?: boolean;
+    });
+    get points(): readonly Vector3[];
+    getPoint(t: number, target?: Vector3): Vector3;
+    getTangent(t: number, target?: Vector3): Vector3;
+}
+//# sourceMappingURL=CatmullRomCurve.d.ts.map

package/dist/core/CatmullRomCurve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatmullRomCurve.d.ts","sourceRoot":"","sources":["../../src/core/CatmullRomCurve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,SAAS,qBAAoB;IACtC,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAE/B,OAAO,CAAC,OAAO,CAAW;IAC1B,MAAM,EAAE,OAAO,CAAA;gBAEH,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;IAQhF,IAAI,MAAM,IAAI,SAAS,OAAO,EAAE,CAAwB;IAExD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,UAAgB,GAAG,OAAO;IA6BpD,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,UAAgB,GAAG,OAAO;CAyBvD"}

package/dist/core/CatmullRomCurve.js

@@ -0,0 +1,100 @@
+import { Vector3 } from 'three';
+import { BaseCurve } from './BaseCurve.js';
+/**
+ * CatmullRomCurve — smooth interpolating spline through all control points.
+ * Blender: Poly spline with smooth interpolation / Path animation target.
+ *
+ * Unlike Bezier, every point lies ON the curve. Ideal for camera paths,
+ * particle guides, and path-follow animations.
+ *
+ * Supports Catmull-Rom (tension=0.5) and general tension control.
+ * Blender uses Catmull-Rom for its path animation curves by default.
+ */
+export class CatmullRomCurve extends BaseCurve {
+    constructor(points, opts = {}) {
+        super();
+        this.curveType = 'CatmullRomCurve';
+        if (points.length < 2)
+            throw new Error('CatmullRomCurve requires at least 2 points');
+        this._points = points;
+        this.closed = opts.closed ?? false;
+        this.parameters = { tension: opts.tension ?? 0.5 };
+    }
+    get points() { return this._points; }
+    getPoint(t, target = new Vector3()) {
+        t = Math.max(0, Math.min(1, t));
+        const pts = this._points;
+        const n = pts.length;
+        const segments = this.closed ? n : n - 1;
+        const seg = Math.min(Math.floor(t * segments), segments - 1);
+        const local = t * segments - seg;
+        const alpha = this.parameters.tension;
+        let p0, p1, p2, p3;
+        if (this.closed) {
+            p0 = pts[(seg - 1 + n) % n];
+            p1 = pts[seg % n];
+            p2 = pts[(seg + 1) % n];
+            p3 = pts[(seg + 2) % n];
+        }
+        else {
+            // Clamp phantom points at both ends
+            p0 = seg === 0 ? pts[0] : pts[seg - 1];
+            p1 = pts[seg];
+            p2 = pts[seg + 1];
+            p3 = seg + 2 < n ? pts[seg + 2] : pts[n - 1];
+        }
+        return catmullRom(p0, p1, p2, p3, local, alpha, target);
+    }
+    getTangent(t, target = new Vector3()) {
+        t = Math.max(0, Math.min(1, t));
+        const pts = this._points;
+        const n = pts.length;
+        const segments = this.closed ? n : n - 1;
+        const seg = Math.min(Math.floor(t * segments), segments - 1);
+        const local = t * segments - seg;
+        const alpha = this.parameters.tension;
+        let p0, p1, p2, p3;
+        if (this.closed) {
+            p0 = pts[(seg - 1 + n) % n];
+            p1 = pts[seg % n];
+            p2 = pts[(seg + 1) % n];
+            p3 = pts[(seg + 2) % n];
+        }
+        else {
+            p0 = seg === 0 ? pts[0] : pts[seg - 1];
+            p1 = pts[seg];
+            p2 = pts[seg + 1];
+            p3 = seg + 2 < n ? pts[seg + 2] : pts[n - 1];
+        }
+        return catmullRomTangent(p0, p1, p2, p3, local, alpha, target);
+    }
+}
+/** Cubic Hermite form of Catmull-Rom. alpha = tension (0.5 = standard). */
+function catmullRom(p0, p1, p2, p3, t, alpha, out) {
+    const t2 = t * t, t3 = t2 * t;
+    // Tangent vectors at p1 and p2
+    const m1x = alpha * (p2.x - p0.x), m1y = alpha * (p2.y - p0.y), m1z = alpha * (p2.z - p0.z);
+    const m2x = alpha * (p3.x - p1.x), m2y = alpha * (p3.y - p1.y), m2z = alpha * (p3.z - p1.z);
+    // Hermite basis
+    const h00 = 2 * t3 - 3 * t2 + 1;
+    const h10 = t3 - 2 * t2 + t;
+    const h01 = -2 * t3 + 3 * t2;
+    const h11 = t3 - t2;
+    return out.set(h00 * p1.x + h10 * m1x + h01 * p2.x + h11 * m2x, h00 * p1.y + h10 * m1y + h01 * p2.y + h11 * m2y, h00 * p1.z + h10 * m1z + h01 * p2.z + h11 * m2z);
+}
+function catmullRomTangent(p0, p1, p2, p3, t, alpha, out) {
+    const t2 = t * t;
+    const m1x = alpha * (p2.x - p0.x), m1y = alpha * (p2.y - p0.y), m1z = alpha * (p2.z - p0.z);
+    const m2x = alpha * (p3.x - p1.x), m2y = alpha * (p3.y - p1.y), m2z = alpha * (p3.z - p1.z);
+    // Derivative of Hermite basis
+    const dh00 = 6 * t2 - 6 * t;
+    const dh10 = 3 * t2 - 4 * t + 1;
+    const dh01 = -6 * t2 + 6 * t;
+    const dh11 = 3 * t2 - 2 * t;
+    const x = dh00 * p1.x + dh10 * m1x + dh01 * p2.x + dh11 * m2x;
+    const y = dh00 * p1.y + dh10 * m1y + dh01 * p2.y + dh11 * m2y;
+    const z = dh00 * p1.z + dh10 * m1z + dh01 * p2.z + dh11 * m2z;
+    const len = Math.sqrt(x * x + y * y + z * z) || 1;
+    return out.set(x / len, y / len, z / len);
+}
+//# sourceMappingURL=CatmullRomCurve.js.map

package/dist/core/CatmullRomCurve.js.map

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

package/dist/core/NURBSCurve.d.ts

@@ -0,0 +1,42 @@
+import { Vector3 } from 'three';
+import { BaseCurve } from './BaseCurve.js';
+/**
+ * NURBSCurve — Non-Uniform Rational B-Spline.
+ * Blender: NURBS spline type.
+ *
+ * Supports arbitrary degree (order = degree + 1), non-uniform knots, and per-point weights.
+ * A weight > 1 pulls the curve toward that control point; weight = 1 is uniform (B-spline).
+ * Circle arcs require weight = cos(θ/2) where θ is the arc angle.
+ */
+export declare class NURBSCurve extends BaseCurve {
+    readonly curveType = "NURBSCurve";
+    parameters: Record<string, number>;
+    private _points;
+    private _weights;
+    private _knots;
+    /** Blender: Order U — degree = order - 1. Default 4 (cubic). */
+    order: number;
+    closed: boolean;
+    constructor(points: Vector3[], opts?: {
+        order?: number;
+        weights?: number[];
+        knots?: number[];
+        closed?: boolean;
+    });
+    get points(): readonly Vector3[];
+    get weights(): readonly number[];
+    get knots(): readonly number[];
+    getPoint(t: number, target?: Vector3): Vector3;
+}
+/** Open uniform knot vector for n control points and given order (clamped at both ends). */
+export declare function buildOpenUniformKnots(n: number, order: number): number[];
+/**
+ * Build a NURBS circle in XY plane with given radius.
+ * Uses 9 control points with cos(45°) weights for exact circular arcs.
+ */
+export declare function buildNURBSCircle(radius?: number): {
+    points: Vector3[];
+    weights: number[];
+    knots: number[];
+};
+//# sourceMappingURL=NURBSCurve.d.ts.map

package/dist/core/NURBSCurve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NURBSCurve.d.ts","sourceRoot":"","sources":["../../src/core/NURBSCurve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACvC,QAAQ,CAAC,SAAS,gBAAe;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAK;IAEvC,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAU;IACxB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;gBAEH,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE;QACnC,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,MAAM,CAAC,EAAE,OAAO,CAAA;KACZ;IAWN,IAAI,MAAM,IAAK,SAAS,OAAO,EAAE,CAAwB;IACzD,IAAI,OAAO,IAAI,SAAS,MAAM,EAAE,CAA0B;IAC1D,IAAI,KAAK,IAAM,SAAS,MAAM,EAAE,CAAwB;IAExD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,UAAgB,GAAG,OAAO;CAwBrD;AAiBD,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAUxE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAI,GAAG;IAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBtG"}