@triforge/particle-core 0.1.0

package/dist/forces/FlowFieldForce.d.ts

@@ -0,0 +1,72 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/**
+ * Callback that returns a velocity vector at a world-space position.
+ * Use this to connect FlowFieldForce to a fluid simulation:
+ *
+ * ```typescript
+ * // Outside st-particle-core — no import restriction applies
+ * import { FLIPSimulator } from '@st-fluid-core'
+ * const fluid = new FLIPSimulator({ ... })
+ *
+ * const force = new FlowFieldForce({
+ *   velocityFn: (x, y, z) => {
+ *     const u = fluid.grid.interpU(x, y, z)
+ *     const v = fluid.grid.interpV(x, y, z)
+ *     const w = fluid.grid.interpW(x, y, z)
+ *     return { x: u, y: v, z: w }
+ *   }
+ * })
+ * ```
+ *
+ * When `velocityFn` is provided the built-in noise field is bypassed entirely.
+ */
+export type FlowVelocityFn = (x: number, y: number, z: number) => {
+    x: number;
+    y: number;
+    z: number;
+};
+export interface FlowFieldForceOptions {
+    /** Field strength multiplier. Default 1. */
+    strength?: number;
+    /** Noise scale — spatial frequency of the flow field. Default 1. */
+    scale?: number;
+    /** Animation speed (scrolls the field over time). Default 0.3. */
+    speed?: number;
+    /** How strongly particles align to the field vs keep inertia [0–1]. Default 0.5. */
+    influence?: number;
+    /** Maximum distance from `position` to apply force. 0 = unlimited. Default 0. */
+    maxDistance?: number;
+    /** World-space field origin. Default [0,0,0]. */
+    px?: number;
+    py?: number;
+    pz?: number;
+    /**
+     * Optional external velocity field callback.
+     * When provided, replaces the built-in curl-noise field.
+     * Receives world-space (x,y,z), returns velocity vector.
+     * Use to connect to st-fluid-core FLIPSimulator or any other velocity source.
+     */
+    velocityFn?: FlowVelocityFn;
+}
+/**
+ * FlowFieldForce — steers particles along a smooth 3-D noise velocity field.
+ * Blender: Force Field → Texture (with animated noise).
+ *
+ * Each particle samples a curl-noise-like direction at its world position
+ * and is nudged toward that direction. The field animates over time via
+ * `parameters.speed`.
+ */
+export declare class FlowFieldForce extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space field origin for maxDistance range check. Not GSAP-animatable. */
+    position: Vector3;
+    /** Optional external velocity callback — overrides built-in noise when set. */
+    velocityFn: FlowVelocityFn | null;
+    private _t;
+    constructor(opts?: FlowFieldForceOptions);
+    apply(particle: Particle, dt: number): void;
+    private _noise;
+}
+//# sourceMappingURL=FlowFieldForce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FlowFieldForce.d.ts","sourceRoot":"","sources":["../../src/forces/FlowFieldForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAQ,OAAO,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAO,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAErG,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACrC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,SAAS;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAA;IAEjB,+EAA+E;IAC/E,UAAU,EAAE,cAAc,GAAG,IAAI,CAAA;IAEjC,OAAO,CAAC,EAAE,CAAI;gBAEF,IAAI,GAAE,qBAA0B;IAa5C,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAwC3C,OAAO,CAAC,MAAM;CAIf"}

package/dist/forces/FlowFieldForce.js

@@ -0,0 +1,68 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/**
+ * FlowFieldForce — steers particles along a smooth 3-D noise velocity field.
+ * Blender: Force Field → Texture (with animated noise).
+ *
+ * Each particle samples a curl-noise-like direction at its world position
+ * and is nudged toward that direction. The field animates over time via
+ * `parameters.speed`.
+ */
+export class FlowFieldForce extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this._t = 0;
+        this.position = new Vector3(opts.px ?? 0, opts.py ?? 0, opts.pz ?? 0);
+        this.velocityFn = opts.velocityFn ?? null;
+        this.parameters = {
+            strength: opts.strength ?? 1,
+            scale: opts.scale ?? 1,
+            speed: opts.speed ?? 0.3,
+            influence: opts.influence ?? 0.5,
+            maxDistance: opts.maxDistance ?? 0,
+        };
+    }
+    apply(particle, dt) {
+        const { strength, scale, speed, influence, maxDistance } = this.parameters;
+        this._t += dt * speed;
+        if (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 > maxDistance * maxDistance)
+                return;
+        }
+        let vx, vy, vz;
+        if (this.velocityFn) {
+            // External fluid sim velocity field
+            const v = this.velocityFn(particle.position.x, particle.position.y, particle.position.z);
+            vx = v.x;
+            vy = v.y;
+            vz = v.z;
+        }
+        else {
+            // Built-in curl-noise field
+            const x = particle.position.x * scale;
+            const y = particle.position.y * scale;
+            const z = particle.position.z * scale;
+            const t = this._t;
+            vx = this._noise(x + 0.0, y + 1.7, z + 3.4, t + 0.0)
+                - this._noise(x + 0.0, y - 1.7, z - 3.4, t + 0.0);
+            vy = this._noise(x + 5.2, y + 0.0, z + 1.3, t + 1.1)
+                - this._noise(x - 5.2, y + 0.0, z - 1.3, t + 1.1);
+            vz = this._noise(x + 2.8, y + 4.1, z + 0.0, t + 2.3)
+                - this._noise(x - 2.8, y - 4.1, z + 0.0, t + 2.3);
+        }
+        const len = Math.sqrt(vx * vx + vy * vy + vz * vz) + 1e-6;
+        const nx = vx / len, ny = vy / len, nz = vz / len;
+        const s = strength * influence * dt;
+        particle.velocity.x += nx * s;
+        particle.velocity.y += ny * s;
+        particle.velocity.z += nz * s;
+    }
+    _noise(x, y, z, t) {
+        const n = Math.sin(x * 127.1 + y * 311.7 + z * 74.7 + t * 591.3) * 43758.5453;
+        return (n - Math.floor(n)) * 2 - 1;
+    }
+}
+//# sourceMappingURL=FlowFieldForce.js.map

package/dist/forces/FlowFieldForce.js.map

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

package/dist/forces/ForceField.d.ts

@@ -0,0 +1,26 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/**
+ * Radial push/pull force field — a point in world space that repels or
+ * attracts particles.  Positive strength = repel, negative = attract.
+ *
+ * Force magnitude = strength / (distance ^ falloff), clamped to maxDistance.
+ *
+ * Blender parallel: Force Fields → Force (Type: Force).
+ */
+export declare class ForceField extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space origin of the field.  Not in parameters — not GSAP-animatable. */
+    position: Vector3;
+    constructor(opts?: {
+        strength?: number;
+        falloff?: number;
+        maxDistance?: number;
+        x?: number;
+        y?: number;
+        z?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=ForceField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ForceField.d.ts","sourceRoot":"","sources":["../../src/forces/ForceField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAa,OAAO,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAW,sBAAsB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAO,qBAAqB,CAAA;AAEpD;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAA;gBAEL,IAAI,GAAE;QAChB,QAAQ,CAAC,EAAK,MAAM,CAAA;QACpB,OAAO,CAAC,EAAM,MAAM,CAAA;QACpB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,CAAC,CAAC,EAAY,MAAM,CAAA;QACpB,CAAC,CAAC,EAAY,MAAM,CAAA;QACpB,CAAC,CAAC,EAAY,MAAM,CAAA;KAChB;IAUN,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAsB5C"}

package/dist/forces/ForceField.js

@@ -0,0 +1,41 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/**
+ * Radial push/pull force field — a point in world space that repels or
+ * attracts particles.  Positive strength = repel, negative = attract.
+ *
+ * Force magnitude = strength / (distance ^ falloff), clamped to maxDistance.
+ *
+ * Blender parallel: Force Fields → Force (Type: Force).
+ */
+export class ForceField extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this.position = new Vector3(opts.x ?? 0, opts.y ?? 0, opts.z ?? 0);
+        this.parameters = {
+            strength: opts.strength ?? 1.0,
+            falloff: opts.falloff ?? 1.0,
+            maxDistance: opts.maxDistance ?? 10.0,
+        };
+    }
+    apply(particle, dt) {
+        if (!particle.alive)
+            return;
+        const { strength, falloff, maxDistance } = 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 dist2 = dx * dx + dy * dy + dz * dz;
+        if (dist2 < 1e-10 || dist2 > maxDistance * maxDistance)
+            return;
+        const dist = Math.sqrt(dist2);
+        // Clamp falloff exponent to avoid unbounded forces at zero distance
+        const safeExp = Math.max(0, falloff);
+        const magnitude = strength / Math.pow(Math.max(dist, 0.01), safeExp);
+        const inv = magnitude / dist;
+        particle.velocity.x += dx * inv * dt;
+        particle.velocity.y += dy * inv * dt;
+        particle.velocity.z += dz * inv * dt;
+    }
+}
+//# sourceMappingURL=ForceField.js.map

package/dist/forces/ForceField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForceField.js","sourceRoot":"","sources":["../../src/forces/ForceField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAa,OAAO,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAW,sBAAsB,CAAA;AAGrD;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,SAAS;IAMvC,YAAY,OAOR,EAAE;QACJ,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAClE,IAAI,CAAC,UAAU,GAAG;YAChB,QAAQ,EAAK,IAAI,CAAC,QAAQ,IAAO,GAAG;YACpC,OAAO,EAAM,IAAI,CAAC,OAAO,IAAQ,GAAG;YACpC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;SACtC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAkB,EAAE,EAAU;QAClC,IAAI,CAAC,QAAQ,CAAC,KAAK;YAAE,OAAM;QAE3B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,UAAU,CAAA;QAE1D,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,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;QAEzC,IAAI,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG,WAAW,GAAG,WAAW;YAAE,OAAM;QAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7B,oEAAoE;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QACpC,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;QAEpE,MAAM,GAAG,GAAG,SAAS,GAAG,IAAI,CAAA;QAC5B,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;QACpC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;QACpC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;IACtC,CAAC;CACF"}

package/dist/forces/GravityForce.d.ts

@@ -0,0 +1,9 @@
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/** Directional gravity force (Blender: Force Field → Gravity) */
+export declare class GravityForce extends BaseForce {
+    parameters: Record<string, number>;
+    constructor(strength?: number);
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=GravityForce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GravityForce.d.ts","sourceRoot":"","sources":["../../src/forces/GravityForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,iEAAiE;AACjE,qBAAa,YAAa,SAAQ,SAAS;IACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBAEtB,QAAQ,SAAO;IAK3B,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAG5C"}

package/dist/forces/GravityForce.js

@@ -0,0 +1,12 @@
+import { BaseForce } from '../core/BaseForce.js';
+/** Directional gravity force (Blender: Force Field → Gravity) */
+export class GravityForce extends BaseForce {
+    constructor(strength = 9.81) {
+        super();
+        this.parameters = { strength };
+    }
+    apply(particle, dt) {
+        particle.velocity.y -= this.parameters.strength * dt;
+    }
+}
+//# sourceMappingURL=GravityForce.js.map

package/dist/forces/GravityForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GravityForce.js","sourceRoot":"","sources":["../../src/forces/GravityForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAGhD,iEAAiE;AACjE,MAAM,OAAO,YAAa,SAAQ,SAAS;IAGzC,YAAY,QAAQ,GAAG,IAAI;QACzB,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,UAAU,GAAG,EAAE,QAAQ,EAAE,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,QAAkB,EAAE,EAAU;QAClC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,EAAE,CAAA;IACtD,CAAC;CACF"}

package/dist/forces/HarmonicForce.d.ts

@@ -0,0 +1,22 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/** Spring attraction toward a point (Blender: Force Field → Harmonic) */
+export declare class HarmonicForce extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space field origin for maxDistance range check. Not GSAP-animatable. */
+    position: Vector3;
+    constructor(opts?: {
+        strength?: number;
+        damping?: number;
+        x?: number;
+        y?: number;
+        z?: number;
+        maxDistance?: number;
+        px?: number;
+        py?: number;
+        pz?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=HarmonicForce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HarmonicForce.d.ts","sourceRoot":"","sources":["../../src/forces/HarmonicForce.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,aAAc,SAAQ,SAAS;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAA;gBAEL,IAAI,GAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;QACvE,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KACjC;IAaN,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAY5C"}

package/dist/forces/HarmonicForce.js

@@ -0,0 +1,31 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/** Spring attraction toward a point (Blender: Force Field → Harmonic) */
+export class HarmonicForce extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this.position = new Vector3(opts.px ?? 0, opts.py ?? 0, opts.pz ?? 0);
+        this.parameters = {
+            strength: opts.strength ?? 1,
+            damping: opts.damping ?? 0.5,
+            x: opts.x ?? 0,
+            y: opts.y ?? 0,
+            z: opts.z ?? 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 toTarget = new Vector3(p.x - particle.position.x, p.y - particle.position.y, p.z - particle.position.z);
+        particle.velocity.addScaledVector(toTarget, p.strength * dt);
+        particle.velocity.multiplyScalar(1 - Math.min(p.damping * dt, 1));
+    }
+}
+//# sourceMappingURL=HarmonicForce.js.map

package/dist/forces/HarmonicForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HarmonicForce.js","sourceRoot":"","sources":["../../src/forces/HarmonicForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAS,OAAO,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAGlD,yEAAyE;AACzE,MAAM,OAAO,aAAc,SAAQ,SAAS;IAM1C,YAAY,OAIR,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,GAAG;YACpC,CAAC,EAAY,IAAI,CAAC,CAAC,IAAa,CAAC;YACjC,CAAC,EAAY,IAAI,CAAC,CAAC,IAAa,CAAC;YACjC,CAAC,EAAY,IAAI,CAAC,CAAC,IAAa,CAAC;YACjC,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,QAAQ,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC7G,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAA;QAC5D,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACnE,CAAC;CACF"}

package/dist/forces/LennardJonesForce.d.ts

@@ -0,0 +1,23 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/**
+ * Lennard-Jones inter-particle force — attraction at long range, repulsion
+ * at short range. Models molecular-like particle interaction.
+ * (Blender: Force Field → Lennard-Jones)
+ */
+export declare class LennardJonesForce extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space field origin. Physics and range check both use this. Not GSAP-animatable. */
+    position: Vector3;
+    constructor(opts?: {
+        strength?: number;
+        equilibrium?: number;
+        maxDistance?: number;
+        px?: number;
+        py?: number;
+        pz?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=LennardJonesForce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LennardJonesForce.d.ts","sourceRoot":"","sources":["../../src/forces/LennardJonesForce.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;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,4FAA4F;IAC5F,QAAQ,EAAE,OAAO,CAAA;gBAEL,IAAI,GAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;QAC7D,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;CAiB5C"}

package/dist/forces/LennardJonesForce.js

@@ -0,0 +1,38 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/**
+ * Lennard-Jones inter-particle force — attraction at long range, repulsion
+ * at short range. Models molecular-like particle interaction.
+ * (Blender: Force Field → Lennard-Jones)
+ */
+export class LennardJonesForce extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this.position = new Vector3(opts.px ?? 0, opts.py ?? 0, opts.pz ?? 0);
+        this.parameters = {
+            strength: opts.strength ?? 1,
+            equilibrium: opts.equilibrium ?? 1,
+            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 r0 = p.equilibrium;
+        const ratio = r0 / r;
+        // Simplified LJ: F = ε [ 2(r0/r)^7 - (r0/r)^13 ]
+        const mag = p.strength * (2 * Math.pow(ratio, 7) - Math.pow(ratio, 13));
+        particle.velocity.x -= (dx / r) * mag * dt;
+        particle.velocity.y -= (dy / r) * mag * dt;
+        particle.velocity.z -= (dz / r) * mag * dt;
+    }
+}
+//# sourceMappingURL=LennardJonesForce.js.map

package/dist/forces/LennardJonesForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LennardJonesForce.js","sourceRoot":"","sources":["../../src/forces/LennardJonesForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAS,OAAO,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAGlD;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAM9C,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,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,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,GAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC3B,MAAM,EAAE,GAAM,CAAC,CAAC,WAAW,CAAA;QAC3B,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,CAAA;QACpB,iDAAiD;QACjD,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAA;QACvE,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/MagneticForce.d.ts

@@ -0,0 +1,21 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/** Velocity-dependent lateral force (Blender: Force Field → Magnetic) */
+export declare class MagneticForce extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space field origin for maxDistance range check. Not GSAP-animatable. */
+    position: Vector3;
+    constructor(opts?: {
+        strength?: number;
+        axisX?: number;
+        axisY?: number;
+        axisZ?: number;
+        maxDistance?: number;
+        px?: number;
+        py?: number;
+        pz?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=MagneticForce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MagneticForce.d.ts","sourceRoot":"","sources":["../../src/forces/MagneticForce.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,aAAc,SAAQ,SAAS;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAA;gBAEL,IAAI,GAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;QACjE,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KACjC;IAYN,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAY5C"}

package/dist/forces/MagneticForce.js

@@ -0,0 +1,30 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/** Velocity-dependent lateral force (Blender: Force Field → Magnetic) */
+export class MagneticForce extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this.position = new Vector3(opts.px ?? 0, opts.py ?? 0, opts.pz ?? 0);
+        this.parameters = {
+            strength: opts.strength ?? 1,
+            axisX: opts.axisX ?? 0,
+            axisY: opts.axisY ?? 1,
+            axisZ: opts.axisZ ?? 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 field = new Vector3(p.axisX, p.axisY, p.axisZ).normalize();
+        const force = new Vector3().crossVectors(particle.velocity, field);
+        particle.velocity.addScaledVector(force, p.strength * dt);
+    }
+}
+//# sourceMappingURL=MagneticForce.js.map

package/dist/forces/MagneticForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MagneticForce.js","sourceRoot":"","sources":["../../src/forces/MagneticForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAS,OAAO,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAGlD,yEAAyE;AACzE,MAAM,OAAO,aAAc,SAAQ,SAAS;IAM1C,YAAY,OAIR,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,KAAK,EAAQ,IAAI,CAAC,KAAK,IAAS,CAAC;YACjC,KAAK,EAAQ,IAAI,CAAC,KAAK,IAAS,CAAC;YACjC,KAAK,EAAQ,IAAI,CAAC,KAAK,IAAS,CAAC;YACjC,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,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAA;QAChE,MAAM,KAAK,GAAG,IAAI,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAClE,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAA;IAC3D,CAAC;CACF"}

package/dist/forces/TextureForce.d.ts

@@ -0,0 +1,37 @@
+import { DataTexture } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+export interface TextureForceOptions {
+    /** World units covered by one full texture tile. Default 10. */
+    scale?: number;
+    /** Force multiplier. Default 1. */
+    strength?: number;
+}
+/**
+ * TextureForce — per-particle force direction sampled from a DataTexture.
+ * RGB (or XYZ float) channels map to world-space X/Y/Z force components.
+ *
+ * Uint8 textures: channels [0..255] are remapped to [-1..1].
+ * FloatType textures: channels are used as-is.
+ *
+ * 2D sampling: particle.position XZ is projected onto the texture plane.
+ * Tile wraps, so the field repeats every `scale` world units.
+ * (Blender: Force Fields → Texture)
+ */
+export declare class TextureForce extends BaseForce {
+    /** All scalar inputs — GSAP / keyframe compatible */
+    parameters: {
+        strength: number;
+        scale: number;
+        /** World-space offset applied before UV projection */
+        offsetX: number;
+        offsetZ: number;
+    };
+    private readonly _data;
+    private readonly _width;
+    private readonly _height;
+    private readonly _isFloat;
+    constructor(texture: DataTexture, opts?: TextureForceOptions);
+    apply(particle: Particle, dt: number): void;
+}
+//# sourceMappingURL=TextureForce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TextureForce.d.ts","sourceRoot":"","sources":["../../src/forces/TextureForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,KAAK,CAAC,EAAK,MAAM,CAAA;IACjB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,qDAAqD;IACrD,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAK,MAAM,CAAA;QAChB,sDAAsD;QACtD,OAAO,EAAG,MAAM,CAAA;QAChB,OAAO,EAAG,MAAM,CAAA;KACjB,CAAA;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,OAAO,EAAE,WAAW,EAAE,IAAI,GAAE,mBAAwB;IAgBhE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CA8B5C"}

package/dist/forces/TextureForce.js

@@ -0,0 +1,56 @@
+import { BaseForce } from '../core/BaseForce.js';
+/**
+ * TextureForce — per-particle force direction sampled from a DataTexture.
+ * RGB (or XYZ float) channels map to world-space X/Y/Z force components.
+ *
+ * Uint8 textures: channels [0..255] are remapped to [-1..1].
+ * FloatType textures: channels are used as-is.
+ *
+ * 2D sampling: particle.position XZ is projected onto the texture plane.
+ * Tile wraps, so the field repeats every `scale` world units.
+ * (Blender: Force Fields → Texture)
+ */
+export class TextureForce extends BaseForce {
+    constructor(texture, opts = {}) {
+        super();
+        this.parameters = {
+            strength: opts.strength ?? 1.0,
+            scale: opts.scale ?? 10.0,
+            offsetX: 0,
+            offsetZ: 0,
+        };
+        const img = texture.image;
+        this._data = img.data;
+        this._width = img.width;
+        this._height = img.height;
+        this._isFloat = this._data instanceof Float32Array;
+    }
+    apply(particle, dt) {
+        const { strength, scale, offsetX, offsetZ } = this.parameters;
+        const invScale = 1 / Math.max(scale, 1e-6);
+        // Map particle XZ to tiling UV [0..1)
+        const u = (((particle.position.x - offsetX) * invScale % 1) + 1) % 1;
+        const v = (((particle.position.z - offsetZ) * invScale % 1) + 1) % 1;
+        const px = Math.floor(u * this._width) % this._width;
+        const py = Math.floor(v * this._height) % this._height;
+        const idx = (py * this._width + px) * 4; // RGBA stride
+        let fx, fy, fz;
+        if (this._isFloat) {
+            const d = this._data;
+            fx = d[idx];
+            fy = d[idx + 1];
+            fz = d[idx + 2];
+        }
+        else {
+            const d = this._data;
+            // [0..255] → [-1..1]
+            fx = d[idx] / 127.5 - 1;
+            fy = d[idx + 1] / 127.5 - 1;
+            fz = d[idx + 2] / 127.5 - 1;
+        }
+        particle.velocity.x += fx * strength * dt;
+        particle.velocity.y += fy * strength * dt;
+        particle.velocity.z += fz * strength * dt;
+    }
+}
+//# sourceMappingURL=TextureForce.js.map

package/dist/forces/TextureForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureForce.js","sourceRoot":"","sources":["../../src/forces/TextureForce.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAQ,sBAAsB,CAAA;AAUlD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IAezC,YAAY,OAAoB,EAAE,OAA4B,EAAE;QAC9D,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,UAAU,GAAG;YAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;YAC9B,KAAK,EAAK,IAAI,CAAC,KAAK,IAAO,IAAI;YAC/B,OAAO,EAAG,CAAC;YACX,OAAO,EAAG,CAAC;SACZ,CAAA;QAED,MAAM,GAAG,GAAS,OAAO,CAAC,KAAsF,CAAA;QAChH,IAAI,CAAC,KAAK,GAAQ,GAAG,CAAC,IAAI,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAO,GAAG,CAAC,KAAK,CAAA;QAC3B,IAAI,CAAC,OAAO,GAAM,GAAG,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAK,IAAI,CAAC,KAAK,YAAY,YAAY,CAAA;IACtD,CAAC;IAED,KAAK,CAAC,QAAkB,EAAE,EAAU;QAClC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAA;QAC7D,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAE1C,sCAAsC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QACpE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QAEpE,MAAM,EAAE,GAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAI,IAAI,CAAC,MAAM,CAAA;QACtD,MAAM,EAAE,GAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAA;QACvD,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA,CAAE,cAAc;QAEvD,IAAI,EAAU,EAAE,EAAU,EAAE,EAAU,CAAA;QACtC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAqB,CAAA;YACpC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;YACX,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;YACf,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,IAAI,CAAC,KAAmB,CAAA;YAClC,qBAAqB;YACrB,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAO,KAAK,GAAG,CAAC,CAAA;YAC3B,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;YAC3B,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;QAC7B,CAAC;QAED,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,GAAG,QAAQ,GAAG,EAAE,CAAA;QACzC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,GAAG,QAAQ,GAAG,EAAE,CAAA;QACzC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,GAAG,QAAQ,GAAG,EAAE,CAAA;IAC3C,CAAC;CACF"}

package/dist/forces/TurbulenceForce.d.ts

@@ -0,0 +1,21 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+import type { Particle } from '../core/Particle.js';
+/** Noise-based random force (Blender: Force Field → Turbulence) */
+export declare class TurbulenceForce extends BaseForce {
+    parameters: Record<string, number>;
+    /** World-space field origin for maxDistance range check. Not GSAP-animatable. */
+    position: Vector3;
+    constructor(opts?: {
+        strength?: number;
+        scale?: number;
+        speed?: number;
+        maxDistance?: number;
+        px?: number;
+        py?: number;
+        pz?: number;
+    });
+    apply(particle: Particle, dt: number): void;
+    private _hash;
+}
+//# sourceMappingURL=TurbulenceForce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TurbulenceForce.d.ts","sourceRoot":"","sources":["../../src/forces/TurbulenceForce.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,mEAAmE;AACnE,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAA;gBAEL,IAAI,GAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;QACvE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KACjC;IAWN,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAmB3C,OAAO,CAAC,KAAK;CAId"}

package/dist/forces/TurbulenceForce.js

@@ -0,0 +1,39 @@
+import { Vector3 } from 'three';
+import { BaseForce } from '../core/BaseForce.js';
+/** Noise-based random force (Blender: Force Field → Turbulence) */
+export class TurbulenceForce extends BaseForce {
+    constructor(opts = {}) {
+        super();
+        this.position = new Vector3(opts.px ?? 0, opts.py ?? 0, opts.pz ?? 0);
+        this.parameters = {
+            strength: opts.strength ?? 1,
+            scale: opts.scale ?? 1,
+            speed: opts.speed ?? 1,
+            maxDistance: opts.maxDistance ?? 0,
+        };
+    }
+    apply(particle, dt) {
+        const { strength, scale, speed, maxDistance } = this.parameters;
+        if (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 > maxDistance * maxDistance)
+                return;
+        }
+        const t = performance.now() * 0.001 * speed;
+        const x = particle.position.x * scale;
+        const z = particle.position.z * scale;
+        const nx = this._hash(x + 0.0, z + 13.7, t + 0.0);
+        const ny = this._hash(x + 4.1, z + 7.3, t + 1.3);
+        const nz = this._hash(x + 9.2, z + 2.8, t + 2.7);
+        particle.velocity.x += nx * strength * dt;
+        particle.velocity.y += ny * strength * dt;
+        particle.velocity.z += nz * strength * dt;
+    }
+    _hash(x, y, z) {
+        const n = Math.sin(x * 127.1 + y * 311.7 + z * 74.7) * 43758.5453;
+        return (n - Math.floor(n)) * 2 - 1;
+    }
+}
+//# sourceMappingURL=TurbulenceForce.js.map