@triforge/particle-core 0.1.0

package/dist/forces/BoidForce.d.ts

@@ -0,0 +1,54 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+export interface BoidObstacle {
+    position: Vector3;
+    radius: number;
+}
+/**
+ * Boids flocking AI — implements the classic separation / alignment / cohesion
+ * rules plus Blender Boids panel extras (stubbed as numeric params for GSAP).
+ *
+ * Inject the live pool reference so the force can read neighbour state each tick.
+ * Use ParticleSystem.pool as the source:
+ *
+ *   const boid = new BoidForce(sys.pool)
+ *   sys.addForce(boid)
+ *
+ * Blender parallel: Boids physics type.
+ */
+export declare class BoidForce extends BaseForce {
+    parameters: Record<string, number>;
+    private readonly _pool;
+    /** Live obstacle list — can be mutated at runtime. */
+    obstacles: BoidObstacle[];
+    constructor(pool: Particle[], opts?: {
+        separationRadius?: number;
+        separationStrength?: number;
+        alignmentRadius?: number;
+        alignmentStrength?: number;
+        cohesionRadius?: number;
+        cohesionStrength?: number;
+        maxSpeed?: number;
+        maxForce?: number;
+        separationWeight?: number;
+        alignmentWeight?: number;
+        cohesionWeight?: number;
+        avoidWeight?: number;
+        avoidRadius?: number;
+        flightHeight?: number;
+        bankingAngle?: number;
+        pitchAngle?: number;
+        obstacles?: BoidObstacle[];
+        leaderIndex?: number;
+        leaderWeight?: number;
+        leaderRadius?: number;
+        groundMode?: number;
+        groundLevel?: number;
+        groundStrength?: number;
+        collisionRadius?: number;
+        collisionStiffness?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=BoidForce.d.ts.map

package/dist/forces/BoidForce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoidForce.d.ts","sourceRoot":"","sources":["../../src/forces/BoidForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAY,OAAO,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAU,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAI,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAElC,sDAAsD;IACtD,SAAS,EAAE,YAAY,EAAE,CAAK;gBAElB,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,GAAE;QAClC,gBAAgB,CAAC,EAAI,MAAM,CAAA;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,eAAe,CAAC,EAAK,MAAM,CAAA;QAC3B,iBAAiB,CAAC,EAAG,MAAM,CAAA;QAC3B,cAAc,CAAC,EAAM,MAAM,CAAA;QAC3B,gBAAgB,CAAC,EAAI,MAAM,CAAA;QAC3B,QAAQ,CAAC,EAAY,MAAM,CAAA;QAC3B,QAAQ,CAAC,EAAY,MAAM,CAAA;QAC3B,gBAAgB,CAAC,EAAI,MAAM,CAAA;QAC3B,eAAe,CAAC,EAAK,MAAM,CAAA;QAC3B,cAAc,CAAC,EAAM,MAAM,CAAA;QAC3B,WAAW,CAAC,EAAS,MAAM,CAAA;QAC3B,WAAW,CAAC,EAAS,MAAM,CAAA;QAC3B,YAAY,CAAC,EAAQ,MAAM,CAAA;QAC3B,YAAY,CAAC,EAAQ,MAAM,CAAA;QAC3B,UAAU,CAAC,EAAU,MAAM,CAAA;QAC3B,SAAS,CAAC,EAAW,YAAY,EAAE,CAAA;QAEnC,WAAW,CAAC,EAAS,MAAM,CAAA;QAC3B,YAAY,CAAC,EAAQ,MAAM,CAAA;QAC3B,YAAY,CAAC,EAAQ,MAAM,CAAA;QAE3B,UAAU,CAAC,EAAU,MAAM,CAAA;QAC3B,WAAW,CAAC,EAAS,MAAM,CAAA;QAC3B,cAAc,CAAC,EAAM,MAAM,CAAA;QAE3B,eAAe,CAAC,EAAK,MAAM,CAAA;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;KACvB;IAmCN,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAuM5C"}

package/dist/forces/BoidForce.js

@@ -0,0 +1,233 @@
+import { BaseForce } from '../core/BaseForce.js';
+/**
+ * Boids flocking AI — implements the classic separation / alignment / cohesion
+ * rules plus Blender Boids panel extras (stubbed as numeric params for GSAP).
+ *
+ * Inject the live pool reference so the force can read neighbour state each tick.
+ * Use ParticleSystem.pool as the source:
+ *
+ *   const boid = new BoidForce(sys.pool)
+ *   sys.addForce(boid)
+ *
+ * Blender parallel: Boids physics type.
+ */
+export class BoidForce extends BaseForce {
+    constructor(pool, opts = {}) {
+        super();
+        /** Live obstacle list — can be mutated at runtime. */
+        this.obstacles = [];
+        this._pool = pool;
+        if (opts.obstacles)
+            this.obstacles = opts.obstacles;
+        this.parameters = {
+            separationRadius: opts.separationRadius ?? 0.5,
+            separationStrength: opts.separationStrength ?? 2.0,
+            alignmentRadius: opts.alignmentRadius ?? 1.5,
+            alignmentStrength: opts.alignmentStrength ?? 1.0,
+            cohesionRadius: opts.cohesionRadius ?? 2.0,
+            cohesionStrength: opts.cohesionStrength ?? 0.8,
+            maxSpeed: opts.maxSpeed ?? 5.0,
+            maxForce: opts.maxForce ?? 3.0,
+            separationWeight: opts.separationWeight ?? 0,
+            alignmentWeight: opts.alignmentWeight ?? 0,
+            cohesionWeight: opts.cohesionWeight ?? 0,
+            avoidWeight: opts.avoidWeight ?? 1.0,
+            avoidRadius: opts.avoidRadius ?? 2.0,
+            flightHeight: opts.flightHeight ?? 0,
+            bankingAngle: opts.bankingAngle ?? 0,
+            pitchAngle: opts.pitchAngle ?? 0,
+            // Leader following
+            leaderIndex: opts.leaderIndex ?? -1,
+            leaderWeight: opts.leaderWeight ?? 1.0,
+            leaderRadius: opts.leaderRadius ?? 5.0,
+            // Ground walking
+            groundMode: opts.groundMode ?? 0,
+            groundLevel: opts.groundLevel ?? 0,
+            groundStrength: opts.groundStrength ?? 3.0,
+            // Collision stiffness
+            collisionRadius: opts.collisionRadius ?? 0,
+            collisionStiffness: opts.collisionStiffness ?? 5.0,
+        };
+    }
+    apply(particle, dt) {
+        const p = this.parameters;
+        if (!particle.alive)
+            return;
+        // Accumulators for each rule — three passes in one loop
+        let sepX = 0, sepY = 0, sepZ = 0, sepN = 0;
+        let aliX = 0, aliY = 0, aliZ = 0, aliN = 0;
+        let cohX = 0, cohY = 0, cohZ = 0, cohN = 0;
+        const px = particle.position.x;
+        const py = particle.position.y;
+        const pz = particle.position.z;
+        const sepR2 = p.separationRadius * p.separationRadius;
+        const aliR2 = p.alignmentRadius * p.alignmentRadius;
+        const cohR2 = p.cohesionRadius * p.cohesionRadius;
+        for (let i = 0; i < this._pool.length; i++) {
+            const n = this._pool[i];
+            if (!n.alive || n === particle)
+                continue;
+            const dx = n.position.x - px;
+            const dy = n.position.y - py;
+            const dz = n.position.z - pz;
+            const r2 = dx * dx + dy * dy + dz * dz;
+            // Separation — repel when inside separationRadius
+            if (r2 < sepR2 && r2 > 1e-8) {
+                const r = Math.sqrt(r2);
+                const inv = 1 / r;
+                // Push away (negate direction toward neighbour)
+                sepX -= dx * inv;
+                sepY -= dy * inv;
+                sepZ -= dz * inv;
+                sepN++;
+            }
+            // Alignment — average neighbour velocity
+            if (r2 < aliR2) {
+                aliX += n.velocity.x;
+                aliY += n.velocity.y;
+                aliZ += n.velocity.z;
+                aliN++;
+            }
+            // Cohesion — average neighbour position
+            if (r2 < cohR2) {
+                cohX += n.position.x;
+                cohY += n.position.y;
+                cohZ += n.position.z;
+                cohN++;
+            }
+        }
+        // Accumulate force contributions
+        let fx = 0, fy = 0, fz = 0;
+        if (sepN > 0) {
+            const inv = 1 / sepN;
+            fx += sepX * inv * p.separationStrength;
+            fy += sepY * inv * p.separationStrength;
+            fz += sepZ * inv * p.separationStrength;
+        }
+        if (aliN > 0) {
+            const inv = 1 / aliN;
+            fx += (aliX * inv - particle.velocity.x) * p.alignmentStrength;
+            fy += (aliY * inv - particle.velocity.y) * p.alignmentStrength;
+            fz += (aliZ * inv - particle.velocity.z) * p.alignmentStrength;
+        }
+        if (cohN > 0) {
+            const inv = 1 / cohN;
+            fx += (cohX * inv - px) * p.cohesionStrength;
+            fy += (cohY * inv - py) * p.cohesionStrength;
+            fz += (cohZ * inv - pz) * p.cohesionStrength;
+        }
+        // ── Leader following ────────────────────────────────────────────────────
+        const leaderIdx = Math.round(p.leaderIndex);
+        if (leaderIdx >= 0 && leaderIdx < this._pool.length && p.leaderWeight > 0) {
+            const leader = this._pool[leaderIdx];
+            if (leader.alive && leader !== particle) {
+                const ldx = leader.position.x - px;
+                const ldy = leader.position.y - py;
+                const ldz = leader.position.z - pz;
+                const lDist2 = ldx * ldx + ldy * ldy + ldz * ldz;
+                const lR2 = p.leaderRadius * p.leaderRadius;
+                if (lDist2 < lR2) {
+                    // Steer toward leader — cohesion-like pull weighted by proximity
+                    const proximity = 1 - Math.sqrt(lDist2) / p.leaderRadius;
+                    fx += ldx * p.leaderWeight * proximity;
+                    fy += ldy * p.leaderWeight * proximity;
+                    fz += ldz * p.leaderWeight * proximity;
+                }
+            }
+        }
+        // ── Boid-boid collision stiffness ────────────────────────────────────────
+        if (p.collisionRadius > 0 && p.collisionStiffness > 0) {
+            const cr2 = p.collisionRadius * p.collisionRadius;
+            for (let i = 0; i < this._pool.length; i++) {
+                const n = this._pool[i];
+                if (!n.alive || n === particle)
+                    continue;
+                const cdx = px - n.position.x;
+                const cdy = py - n.position.y;
+                const cdz = pz - n.position.z;
+                const cr2d = cdx * cdx + cdy * cdy + cdz * cdz;
+                if (cr2d < cr2 && cr2d > 1e-10) {
+                    const dist = Math.sqrt(cr2d);
+                    const overlap = p.collisionRadius - dist;
+                    const stiffness = p.collisionStiffness * overlap / dist;
+                    fx += cdx * stiffness;
+                    fy += cdy * stiffness;
+                    fz += cdz * stiffness;
+                }
+            }
+        }
+        // ── Obstacle avoidance ──────────────────────────────────────────────────
+        if (this.obstacles.length > 0 && p.avoidWeight > 0) {
+            const avoidR = p.avoidRadius;
+            const avoidW = p.avoidWeight;
+            for (let o = 0; o < this.obstacles.length; o++) {
+                const obs = this.obstacles[o];
+                const totalR = avoidR + obs.radius;
+                const odx = px - obs.position.x;
+                const ody = py - obs.position.y;
+                const odz = pz - obs.position.z;
+                const odist2 = odx * odx + ody * ody + odz * odz;
+                if (odist2 < totalR * totalR && odist2 > 1e-10) {
+                    const odist = Math.sqrt(odist2);
+                    // Scale force by how close the particle is to the obstacle surface
+                    const proximity = 1 - odist / totalR;
+                    const steer = avoidW * proximity / odist;
+                    fx += odx * steer;
+                    fy += ody * steer;
+                    fz += odz * steer;
+                }
+            }
+        }
+        // ── Flight height restoring force ───────────────────────────────────────
+        if (p.flightHeight !== 0) {
+            fy += (p.flightHeight - py) * 0.5;
+        }
+        // Clamp force magnitude
+        const fMag2 = fx * fx + fy * fy + fz * fz;
+        const maxF2 = p.maxForce * p.maxForce;
+        if (fMag2 > maxF2 && fMag2 > 1e-12) {
+            const scale = p.maxForce / Math.sqrt(fMag2);
+            fx *= scale;
+            fy *= scale;
+            fz *= scale;
+        }
+        // Apply force: dv = F * dt
+        particle.velocity.x += fx * dt;
+        particle.velocity.y += fy * dt;
+        particle.velocity.z += fz * dt;
+        // Clamp speed
+        const vMag2 = particle.velocity.x ** 2 + particle.velocity.y ** 2 + particle.velocity.z ** 2;
+        const maxV2 = p.maxSpeed * p.maxSpeed;
+        if (vMag2 > maxV2 && vMag2 > 1e-12) {
+            const scale = p.maxSpeed / Math.sqrt(vMag2);
+            particle.velocity.x *= scale;
+            particle.velocity.y *= scale;
+            particle.velocity.z *= scale;
+        }
+        // ── Banking / pitch (cosmetic rotation only) ────────────────────────────
+        if (p.bankingAngle !== 0) {
+            // Lateral acceleration ≈ change in horizontal velocity direction
+            // Proxy: cross product of current horizontal velocity with world-up gives lateral
+            const vx = particle.velocity.x, vz = particle.velocity.z;
+            const speed2d = Math.sqrt(vx * vx + vz * vz);
+            if (speed2d > 0.01) {
+                // Signed lateral tilt: use fx (left/right force) scaled by bankingAngle
+                particle.rotation.z = -Math.atan2(fx, p.maxForce) * p.bankingAngle;
+            }
+        }
+        if (p.pitchAngle !== 0) {
+            const vy = particle.velocity.y;
+            particle.rotation.x = Math.atan2(vy, Math.max(0.01, p.maxSpeed)) * p.pitchAngle;
+        }
+        // ── Ground walking mode ──────────────────────────────────────────────────
+        if (p.groundMode >= 0.5) {
+            // Restoring force pushes particle toward groundLevel
+            particle.velocity.y += (p.groundLevel - particle.position.y) * p.groundStrength * dt;
+            // Suppress strong vertical velocity so boids stay near the ground
+            particle.velocity.y *= Math.max(0, 1 - 0.8 * dt);
+            // Align rotation.x to zero (flat ground orientation)
+            particle.rotation.x *= Math.max(0, 1 - 5 * dt);
+        }
+    }
+}
+//# sourceMappingURL=BoidForce.js.map

package/dist/forces/BoidForce.js.map

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

package/dist/forces/ChargeForce.d.ts

@@ -0,0 +1,22 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/**
+ * Radial attract / repel force — positive strength attracts, negative repels.
+ * (Blender: Force Field → Charge / Force)
+ */
+export declare class ChargeForce extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space charge origin. Physics and range check both use this. Not GSAP-animatable. */
+    position: Vector3;
+    constructor(opts?: {
+        strength?: number;
+        falloff?: number;
+        maxDistance?: number;
+        px?: number;
+        py?: number;
+        pz?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=ChargeForce.d.ts.map

package/dist/forces/ChargeForce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargeForce.d.ts","sourceRoot":"","sources":["../../src/forces/ChargeForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAS,OAAO,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,6FAA6F;IAC7F,QAAQ,EAAE,OAAO,CAAA;gBAEL,IAAI,GAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;QACzD,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KACjC;IAUN,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAe5C"}

package/dist/forces/ChargeForce.js

@@ -0,0 +1,35 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/**
+ * Radial attract / repel force — positive strength attracts, negative repels.
+ * (Blender: Force Field → Charge / Force)
+ */
+export class ChargeForce extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this.position = new Vector3(opts.px ?? 0, opts.py ?? 0, opts.pz ?? 0);
+        this.parameters = {
+            strength: opts.strength ?? 1,
+            falloff: opts.falloff ?? 2,
+            maxDistance: opts.maxDistance ?? 0,
+        };
+    }
+    apply(particle, dt) {
+        const p = this.parameters;
+        const dx = particle.position.x - this.position.x;
+        const dy = particle.position.y - this.position.y;
+        const dz = particle.position.z - this.position.z;
+        const r2 = dx * dx + dy * dy + dz * dz;
+        if (r2 < 1e-8)
+            return;
+        if (p.maxDistance > 0 && r2 > p.maxDistance * p.maxDistance)
+            return;
+        const r = Math.sqrt(r2);
+        const mag = p.strength / Math.pow(r, p.falloff);
+        // toward origin = negative direction from particle
+        particle.velocity.x -= (dx / r) * mag * dt;
+        particle.velocity.y -= (dy / r) * mag * dt;
+        particle.velocity.z -= (dz / r) * mag * dt;
+    }
+}
+//# sourceMappingURL=ChargeForce.js.map

package/dist/forces/ChargeForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargeForce.js","sourceRoot":"","sources":["../../src/forces/ChargeForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAS,OAAO,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAGlD;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IAMxC,YAAY,OAGR,EAAE;QACJ,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QACrE,IAAI,CAAC,UAAU,GAAG;YAChB,QAAQ,EAAK,IAAI,CAAC,QAAQ,IAAO,CAAC;YAClC,OAAO,EAAM,IAAI,CAAC,OAAO,IAAQ,CAAC;YAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;SACnC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAkB,EAAE,EAAU;QAClC,MAAM,CAAC,GAAI,IAAI,CAAC,UAAU,CAAA;QAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;QACtC,IAAI,EAAE,GAAG,IAAI;YAAE,OAAM;QACrB,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;YAAE,OAAM;QACnE,MAAM,CAAC,GAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzB,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;QAC/C,mDAAmD;QACnD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAA;QAC1C,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAA;QAC1C,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAA;IAC5C,CAAC;CACF"}

package/dist/forces/CurveGuideForce.d.ts

@@ -0,0 +1,43 @@
+import type { CatmullRomCurve3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/**
+ * CurveGuideForce — attracts particles toward the nearest point on a
+ * CatmullRomCurve3. (Blender: Force Fields → Curve Guide)
+ *
+ * The curve is sampled at `samples` points each construction; the nearest
+ * sample is found each apply() call (O(samples) — keep samples ≤ 256 for
+ * large pools). The particle is attracted to that nearest point.
+ *
+ * parameters.clumpFactor: 0 = attract to nearest point, 1 = also align
+ * velocity toward the curve tangent at that point (Blender: Clump).
+ * parameters.freeEnd:     0 = full curve influence, 1 = weaker at the
+ * end of the curve (Blender: Free End).
+ */
+export declare class CurveGuideForce extends BaseForce {
+    curve: CatmullRomCurve3;
+    parameters: Record<string, number>;
+    private readonly _pts;
+    private readonly _tans;
+    private readonly _tmp;
+    /**
+     * @param curve   A THREE.CatmullRomCurve3 — must be set before the first
+     *                update() call. Can be replaced at runtime; call resample().
+     * @param opts    strength: attraction force magnitude (Blender: Strength).
+     *                clumpFactor: tangent-alignment blend 0–1 (Blender: Clump).
+     *                freeEnd: reduce influence near curve end 0–1 (Blender: Free End).
+     *                samples: internal sampling resolution (default 64).
+     */
+    constructor(curve: CatmullRomCurve3, opts?: {
+        strength?: number;
+        clumpFactor?: number;
+        freeEnd?: number;
+        samples?: number;
+        maxDistance?: number;
+    });
+    /** Re-sample the curve — call after modifying curve control points. */
+    resample(): void;
+    apply(particle: Particle, dt: number): void;
+    private _buildSamples;
+}
+//# sourceMappingURL=CurveGuideForce.d.ts.map

package/dist/forces/CurveGuideForce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurveGuideForce.d.ts","sourceRoot":"","sources":["../../src/forces/CurveGuideForce.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAY,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAQ,qBAAqB,CAAA;AAErD;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAgBnC,KAAK,EAAE,gBAAgB;IAfhC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAE/C;;;;;;;OAOG;gBAEM,KAAK,EAAE,gBAAgB,EAC9B,IAAI,GAAE;QACJ,QAAQ,CAAC,EAAM,MAAM,CAAA;QACrB,WAAW,CAAC,EAAG,MAAM,CAAA;QACrB,OAAO,CAAC,EAAO,MAAM,CAAA;QACrB,OAAO,CAAC,EAAO,MAAM,CAAA;QACrB,WAAW,CAAC,EAAG,MAAM,CAAA;KACjB;IAeR,uEAAuE;IACvE,QAAQ,IAAI,IAAI;IAIhB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAwE3C,OAAO,CAAC,aAAa;CAOtB"}

package/dist/forces/CurveGuideForce.js

@@ -0,0 +1,118 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/**
+ * CurveGuideForce — attracts particles toward the nearest point on a
+ * CatmullRomCurve3. (Blender: Force Fields → Curve Guide)
+ *
+ * The curve is sampled at `samples` points each construction; the nearest
+ * sample is found each apply() call (O(samples) — keep samples ≤ 256 for
+ * large pools). The particle is attracted to that nearest point.
+ *
+ * parameters.clumpFactor: 0 = attract to nearest point, 1 = also align
+ * velocity toward the curve tangent at that point (Blender: Clump).
+ * parameters.freeEnd:     0 = full curve influence, 1 = weaker at the
+ * end of the curve (Blender: Free End).
+ */
+export class CurveGuideForce extends BaseForce {
+    /**
+     * @param curve   A THREE.CatmullRomCurve3 — must be set before the first
+     *                update() call. Can be replaced at runtime; call resample().
+     * @param opts    strength: attraction force magnitude (Blender: Strength).
+     *                clumpFactor: tangent-alignment blend 0–1 (Blender: Clump).
+     *                freeEnd: reduce influence near curve end 0–1 (Blender: Free End).
+     *                samples: internal sampling resolution (default 64).
+     */
+    constructor(curve, opts = {}) {
+        super();
+        this.curve = curve;
+        this._tmp = new Vector3();
+        this.parameters = {
+            strength: opts.strength ?? 1,
+            clumpFactor: opts.clumpFactor ?? 0,
+            freeEnd: opts.freeEnd ?? 0,
+            maxDistance: opts.maxDistance ?? 0,
+        };
+        const n = Math.max(4, Math.min(256, opts.samples ?? 64));
+        this._pts = Array.from({ length: n }, () => new Vector3());
+        this._tans = Array.from({ length: n }, () => new Vector3());
+        this._buildSamples(n);
+    }
+    /** Re-sample the curve — call after modifying curve control points. */
+    resample() {
+        this._buildSamples(this._pts.length);
+    }
+    apply(particle, dt) {
+        const n = this._pts.length;
+        if (n === 0)
+            return;
+        // maxDistance: skip particles too far from the closest curve point
+        const maxD = this.parameters.maxDistance;
+        if (maxD > 0) {
+            let minD2 = Infinity;
+            const px = particle.position.x, py = particle.position.y, pz = particle.position.z;
+            for (let i = 0; i < n; i++) {
+                const q = this._pts[i];
+                const d2 = (px - q.x) ** 2 + (py - q.y) ** 2 + (pz - q.z) ** 2;
+                if (d2 < minD2)
+                    minD2 = d2;
+            }
+            if (minD2 > maxD * maxD)
+                return;
+        }
+        // Find nearest sampled point
+        let nearestIdx = 0;
+        let nearestDist2 = Infinity;
+        const px = particle.position.x;
+        const py = particle.position.y;
+        const pz = particle.position.z;
+        for (let i = 0; i < n; i++) {
+            const q = this._pts[i];
+            const dx = px - q.x;
+            const dy = py - q.y;
+            const dz = pz - q.z;
+            const d2 = dx * dx + dy * dy + dz * dz;
+            if (d2 < nearestDist2) {
+                nearestDist2 = d2;
+                nearestIdx = i;
+            }
+        }
+        const target = this._pts[nearestIdx];
+        const tan = this._tans[nearestIdx];
+        const { strength, clumpFactor, freeEnd } = this.parameters;
+        // Free-end attenuation: t ∈ [0,1] along curve — weaken near the end
+        const t = nearestIdx / Math.max(n - 1, 1);
+        const freeAtt = freeEnd > 0 ? 1 - t * freeEnd : 1;
+        const effStr = strength * freeAtt * dt;
+        // Attraction toward nearest point
+        this._tmp.set(target.x - px, target.y - py, target.z - pz);
+        const dist = this._tmp.length();
+        if (dist > 1e-6 && clumpFactor < 1) {
+            const attStr = effStr * (1 - clumpFactor);
+            particle.velocity.x += (this._tmp.x / dist) * attStr;
+            particle.velocity.y += (this._tmp.y / dist) * attStr;
+            particle.velocity.z += (this._tmp.z / dist) * attStr;
+        }
+        // Tangent alignment (clump): steer velocity toward curve direction
+        if (clumpFactor > 0) {
+            const tanLen = tan.length();
+            if (tanLen > 1e-6) {
+                const tnx = tan.x / tanLen;
+                const tny = tan.y / tanLen;
+                const tnz = tan.z / tanLen;
+                // Project current velocity onto tangent then lerp
+                const dot = particle.velocity.x * tnx + particle.velocity.y * tny + particle.velocity.z * tnz;
+                particle.velocity.x += (dot * tnx - particle.velocity.x) * clumpFactor * effStr;
+                particle.velocity.y += (dot * tny - particle.velocity.y) * clumpFactor * effStr;
+                particle.velocity.z += (dot * tnz - particle.velocity.z) * clumpFactor * effStr;
+            }
+        }
+    }
+    _buildSamples(n) {
+        for (let i = 0; i < n; i++) {
+            const t = i / Math.max(n - 1, 1);
+            this.curve.getPoint(t, this._pts[i]);
+            this.curve.getTangent(t, this._tans[i]);
+        }
+    }
+}
+//# sourceMappingURL=CurveGuideForce.js.map

package/dist/forces/CurveGuideForce.js.map

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

package/dist/forces/DragForce.d.ts

@@ -0,0 +1,19 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/** Velocity-proportional air resistance (Blender: Force Field → Drag) */
+export declare class DragForce extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space field origin for maxDistance range check. Not GSAP-animatable. */
+    position: Vector3;
+    constructor(opts?: {
+        linear?: number;
+        quadratic?: number;
+        maxDistance?: number;
+        px?: number;
+        py?: number;
+        pz?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=DragForce.d.ts.map

package/dist/forces/DragForce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DragForce.d.ts","sourceRoot":"","sources":["../../src/forces/DragForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAS,OAAO,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,yEAAyE;AACzE,qBAAa,SAAU,SAAQ,SAAS;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAA;gBAEL,IAAI,GAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;QACzD,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KACjC;IAUN,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAc5C"}

package/dist/forces/DragForce.js

@@ -0,0 +1,31 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/** Velocity-proportional air resistance (Blender: Force Field → Drag) */
+export class DragForce extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this.position = new Vector3(opts.px ?? 0, opts.py ?? 0, opts.pz ?? 0);
+        this.parameters = {
+            linear: opts.linear ?? 1,
+            quadratic: opts.quadratic ?? 0,
+            maxDistance: opts.maxDistance ?? 0,
+        };
+    }
+    apply(particle, dt) {
+        const p = this.parameters;
+        if (p.maxDistance > 0) {
+            const dx = particle.position.x - this.position.x;
+            const dy = particle.position.y - this.position.y;
+            const dz = particle.position.z - this.position.z;
+            if (dx * dx + dy * dy + dz * dz > p.maxDistance * p.maxDistance)
+                return;
+        }
+        const speed = particle.velocity.length();
+        if (speed < 0.0001)
+            return;
+        const drag = p.linear + p.quadratic * speed;
+        const factor = Math.max(0, 1 - drag * dt);
+        particle.velocity.multiplyScalar(factor);
+    }
+}
+//# sourceMappingURL=DragForce.js.map

package/dist/forces/DragForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DragForce.js","sourceRoot":"","sources":["../../src/forces/DragForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAS,OAAO,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAGlD,yEAAyE;AACzE,MAAM,OAAO,SAAU,SAAQ,SAAS;IAMtC,YAAY,OAGR,EAAE;QACJ,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QACrE,IAAI,CAAC,UAAU,GAAG;YAChB,MAAM,EAAO,IAAI,CAAC,MAAM,IAAS,CAAC;YAClC,SAAS,EAAI,IAAI,CAAC,SAAS,IAAM,CAAC;YAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;SACnC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAkB,EAAE,EAAU;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAA;QACzB,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;YAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;YAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;YAChD,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;gBAAE,OAAM;QACzE,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;QACxC,IAAI,KAAK,GAAG,MAAM;YAAE,OAAM;QAC1B,MAAM,IAAI,GAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,GAAG,KAAK,CAAA;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,CAAA;QACzC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC;CACF"}