@codexo/exojs 0.7.12 → 0.8.0

package/dist/esm/particles/modules/ColorOverSpeed.js

@@ -0,0 +1,86 @@
+import { UpdateModule } from './UpdateModule.js';
+import { Color } from '../../core/Color.js';
+
+/// <reference types="@webgpu/types" />
+const lookupSize = 256;
+/**
+ * Per-frame, per-particle color sampler driven by velocity magnitude rather
+ * than lifetime ratio. Each live particle's tint is set to the gradient
+ * evaluated at `clamp((|velocity| - minSpeed) / (maxSpeed - minSpeed), 0, 1)`.
+ *
+ * Use cases: heat-mapping (slow=blue, fast=red), velocity-tinted trails,
+ * speed-gated highlights.
+ *
+ * GPU-eligible: gradient uploaded as a 256-tap 1D RGBA8 texture, sampled
+ * with linear filtering. Replaces the full color word — pair with a
+ * separate {@link AlphaFadeOverLifetime} after this module if you want to
+ * keep alpha controlled by lifetime.
+ */
+class ColorOverSpeed extends UpdateModule {
+    gradient;
+    minSpeed;
+    maxSpeed;
+    constructor(gradient, minSpeed, maxSpeed) {
+        super();
+        this.gradient = gradient;
+        this.minSpeed = minSpeed;
+        this.maxSpeed = maxSpeed;
+    }
+    apply(system, _dt) {
+        const { velX, velY, color, liveCount } = system;
+        const gradient = this.gradient;
+        const min = this.minSpeed;
+        const span = Math.max(1e-5, this.maxSpeed - this.minSpeed);
+        for (let i = 0; i < liveCount; i++) {
+            const speed = Math.sqrt(velX[i] * velX[i] + velY[i] * velY[i]);
+            const t = Math.max(0, Math.min(1, (speed - min) / span));
+            color[i] = gradient.evaluateRgba(t);
+        }
+    }
+    wgsl() {
+        return {
+            key: 'ColorOverSpeed',
+            uniforms: [
+                { name: 'minSpeed', type: 'f32' },
+                { name: 'invSpan', type: 'f32' },
+            ],
+            textures: [{ name: 'gradient', format: 'rgba8unorm' }],
+            body: `
+                let speedMag = length(velocities[idx]);
+                let speedT = clamp((speedMag - modules.u_ColorOverSpeed.minSpeed) * modules.u_ColorOverSpeed.invSpan, 0.0, 1.0);
+                let speedSample = textureSampleLevel(u_ColorOverSpeed_gradient, u_ColorOverSpeed_gradient_sampler, speedT, 0.0);
+                let speedR = u32(speedSample.r * 255.0) & 255u;
+                let speedG = u32(speedSample.g * 255.0) & 255u;
+                let speedB = u32(speedSample.b * 255.0) & 255u;
+                let speedA = u32(speedSample.a * 255.0) & 255u;
+                color[idx] = (speedA << 24u) | (speedB << 16u) | (speedG << 8u) | speedR;
+            `,
+        };
+    }
+    writeUniforms(view, offset) {
+        const span = Math.max(1e-5, this.maxSpeed - this.minSpeed);
+        view.setFloat32(offset + 0, this.minSpeed, true);
+        view.setFloat32(offset + 4, 1 / span, true);
+    }
+    uploadTextures(device, textures) {
+        const texture = textures.get('gradient');
+        if (texture === undefined) {
+            return;
+        }
+        const data = new Uint8Array(lookupSize * 4);
+        const scratch = new Color();
+        for (let i = 0; i < lookupSize; i++) {
+            const t = i / (lookupSize - 1);
+            this.gradient.evaluate(t, scratch);
+            const o = i * 4;
+            data[o + 0] = scratch.r & 255;
+            data[o + 1] = scratch.g & 255;
+            data[o + 2] = scratch.b & 255;
+            data[o + 3] = ((scratch.a * 255) | 0) & 255;
+        }
+        device.queue.writeTexture({ texture }, data.buffer, { offset: 0, bytesPerRow: lookupSize * 4, rowsPerImage: 1 }, { width: lookupSize, height: 1, depthOrArrayLayers: 1 });
+    }
+}
+
+export { ColorOverSpeed };
+//# sourceMappingURL=ColorOverSpeed.js.map

package/dist/esm/particles/modules/ColorOverSpeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorOverSpeed.js","sources":["../../../../../src/particles/modules/ColorOverSpeed.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/particles/modules/DeathModule.d.ts

@@ -0,0 +1,24 @@
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+/**
+ * Per-particle hook invoked exactly once when a particle expires, before
+ * its slot is recycled by the compaction pass. The dying particle's data
+ * is still readable at `system.posX[slot]` etc.
+ *
+ * Use for sub-emitters (spawn child particles where this one died), event
+ * dispatch (trigger an audio cue, score event), or trail termination.
+ *
+ * Implementation pattern:
+ *
+ * ```ts
+ * onDeath(system, slot) {
+ *     const x = system.posX[slot];
+ *     const y = system.posY[slot];
+ *     this._childSystem.spawnBurstAt(x, y, 8);
+ * }
+ * ```
+ */
+export declare abstract class DeathModule {
+    abstract onDeath(system: ParticleSystem, slot: number): void;
+    /** Optional cleanup hook called from `ParticleSystem.destroy`. */
+    destroy(): void;
+}

package/dist/esm/particles/modules/DeathModule.js

@@ -0,0 +1,25 @@
+/**
+ * Per-particle hook invoked exactly once when a particle expires, before
+ * its slot is recycled by the compaction pass. The dying particle's data
+ * is still readable at `system.posX[slot]` etc.
+ *
+ * Use for sub-emitters (spawn child particles where this one died), event
+ * dispatch (trigger an audio cue, score event), or trail termination.
+ *
+ * Implementation pattern:
+ *
+ * ```ts
+ * onDeath(system, slot) {
+ *     const x = system.posX[slot];
+ *     const y = system.posY[slot];
+ *     this._childSystem.spawnBurstAt(x, y, 8);
+ * }
+ * ```
+ */
+class DeathModule {
+    /** Optional cleanup hook called from `ParticleSystem.destroy`. */
+    destroy() { }
+}
+
+export { DeathModule };
+//# sourceMappingURL=DeathModule.js.map

package/dist/esm/particles/modules/DeathModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeathModule.js","sources":["../../../../../src/particles/modules/DeathModule.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;AAiBG;MACmB,WAAW,CAAA;;AAGtB,IAAA,OAAO,KAAU;AAC3B;;;;"}

package/dist/esm/particles/modules/Drag.d.ts

@@ -0,0 +1,20 @@
+import { UpdateModule } from './UpdateModule';
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+import type { WgslContribution } from './WgslContribution';
+/**
+ * Exponential velocity damping. Each frame multiplies every live particle's
+ * velocity by `(1 - drag * dt)`, simulating linear air resistance.
+ *
+ * `drag = 0` is no damping; `drag = 1` halves velocity in ~1 second; higher
+ * values slow particles faster. Negative values accelerate (don't do that
+ * unless you mean it).
+ *
+ * GPU-eligible.
+ */
+export declare class Drag extends UpdateModule {
+    drag: number;
+    constructor(drag: number);
+    apply(system: ParticleSystem, dt: number): void;
+    wgsl(): WgslContribution;
+    writeUniforms(view: DataView, offset: number): void;
+}

package/dist/esm/particles/modules/Drag.js

@@ -0,0 +1,45 @@
+import { UpdateModule } from './UpdateModule.js';
+
+/**
+ * Exponential velocity damping. Each frame multiplies every live particle's
+ * velocity by `(1 - drag * dt)`, simulating linear air resistance.
+ *
+ * `drag = 0` is no damping; `drag = 1` halves velocity in ~1 second; higher
+ * values slow particles faster. Negative values accelerate (don't do that
+ * unless you mean it).
+ *
+ * GPU-eligible.
+ */
+class Drag extends UpdateModule {
+    drag;
+    constructor(drag) {
+        super();
+        this.drag = drag;
+    }
+    apply(system, dt) {
+        const { velX, velY, liveCount } = system;
+        const factor = 1 - this.drag * dt;
+        for (let i = 0; i < liveCount; i++) {
+            velX[i] *= factor;
+            velY[i] *= factor;
+        }
+    }
+    wgsl() {
+        return {
+            key: 'Drag',
+            uniforms: [
+                { name: 'drag', type: 'f32' },
+            ],
+            body: `
+                let dragFactor = 1.0 - modules.u_Drag.drag * dt;
+                velocities[idx] = velocities[idx] * dragFactor;
+            `,
+        };
+    }
+    writeUniforms(view, offset) {
+        view.setFloat32(offset + 0, this.drag, true);
+    }
+}
+
+export { Drag };
+//# sourceMappingURL=Drag.js.map

package/dist/esm/particles/modules/Drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Drag.js","sources":["../../../../../src/particles/modules/Drag.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;AASG;AACG,MAAO,IAAK,SAAQ,YAAY,CAAA;AAC3B,IAAA,IAAI;AAEX,IAAA,WAAA,CAAmB,IAAY,EAAA;AAC3B,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;IACpB;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;QACpD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM;QACxC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE;AAEjC,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;AAChC,YAAA,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM;AACjB,YAAA,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM;QACrB;IACJ;IAEgB,IAAI,GAAA;QAChB,OAAO;AACH,YAAA,GAAG,EAAE,MAAM;AACX,YAAA,QAAQ,EAAE;AACN,gBAAA,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE;AAChC,aAAA;AACD,YAAA,IAAI,EAAE;;;AAGL,YAAA,CAAA;SACJ;IACL;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AACxD,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;IAChD;AACH;;;;"}

package/dist/esm/particles/modules/OrbitalForce.d.ts

@@ -0,0 +1,28 @@
+import { UpdateModule } from './UpdateModule';
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+import type { WgslContribution } from './WgslContribution';
+/**
+ * Applies a tangential acceleration around a center point — perpendicular
+ * to the radial vector `(particle − center)`. Combined with an attract /
+ * repel module that controls the radial distance, this produces orbital,
+ * spiral, or vortex motion.
+ *
+ * `angularSpeed` is the target angular velocity in radians/second. The
+ * effective tangential acceleration scales with `radius * angularSpeed`,
+ * so distant particles get pushed harder (matching uniform circular
+ * motion). Positive values orbit counter-clockwise, negative clockwise.
+ *
+ * Use cases: galactic spirals, smoke vortices around an attractor, wind
+ * eddies. Layer with {@link AttractToPoint} for stable orbits.
+ *
+ * GPU-eligible.
+ */
+export declare class OrbitalForce extends UpdateModule {
+    x: number;
+    y: number;
+    angularSpeed: number;
+    constructor(x: number, y: number, angularSpeed: number);
+    apply(system: ParticleSystem, dt: number): void;
+    wgsl(): WgslContribution;
+    writeUniforms(view: DataView, offset: number): void;
+}

package/dist/esm/particles/modules/OrbitalForce.js

@@ -0,0 +1,65 @@
+import { UpdateModule } from './UpdateModule.js';
+
+/**
+ * Applies a tangential acceleration around a center point — perpendicular
+ * to the radial vector `(particle − center)`. Combined with an attract /
+ * repel module that controls the radial distance, this produces orbital,
+ * spiral, or vortex motion.
+ *
+ * `angularSpeed` is the target angular velocity in radians/second. The
+ * effective tangential acceleration scales with `radius * angularSpeed`,
+ * so distant particles get pushed harder (matching uniform circular
+ * motion). Positive values orbit counter-clockwise, negative clockwise.
+ *
+ * Use cases: galactic spirals, smoke vortices around an attractor, wind
+ * eddies. Layer with {@link AttractToPoint} for stable orbits.
+ *
+ * GPU-eligible.
+ */
+class OrbitalForce extends UpdateModule {
+    x;
+    y;
+    angularSpeed;
+    constructor(x, y, angularSpeed) {
+        super();
+        this.x = x;
+        this.y = y;
+        this.angularSpeed = angularSpeed;
+    }
+    apply(system, dt) {
+        const { posX, posY, velX, velY, liveCount } = system;
+        const { x, y, angularSpeed } = this;
+        const omega = angularSpeed * dt;
+        for (let i = 0; i < liveCount; i++) {
+            const dx = posX[i] - x;
+            const dy = posY[i] - y;
+            // Perpendicular vector: (-dy, dx) for counter-clockwise.
+            velX[i] += -dy * omega;
+            velY[i] += dx * omega;
+        }
+    }
+    wgsl() {
+        return {
+            key: 'OrbitalForce',
+            uniforms: [
+                { name: 'center', type: 'vec2<f32>' },
+                { name: 'angularSpeed', type: 'f32' },
+                { name: '_pad0', type: 'f32' },
+            ],
+            body: `
+                let orbitDelta = positions[idx] - modules.u_OrbitalForce.center;
+                let orbitOmega = modules.u_OrbitalForce.angularSpeed * dt;
+                velocities[idx] = velocities[idx] + vec2<f32>(-orbitDelta.y, orbitDelta.x) * orbitOmega;
+            `,
+        };
+    }
+    writeUniforms(view, offset) {
+        view.setFloat32(offset + 0, this.x, true);
+        view.setFloat32(offset + 4, this.y, true);
+        view.setFloat32(offset + 8, this.angularSpeed, true);
+        view.setFloat32(offset + 12, 0, true);
+    }
+}
+
+export { OrbitalForce };
+//# sourceMappingURL=OrbitalForce.js.map

package/dist/esm/particles/modules/OrbitalForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitalForce.js","sources":["../../../../../src/particles/modules/OrbitalForce.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;;;;;;AAeG;AACG,MAAO,YAAa,SAAQ,YAAY,CAAA;AACnC,IAAA,CAAC;AACD,IAAA,CAAC;AACD,IAAA,YAAY;AAEnB,IAAA,WAAA,CAAmB,CAAS,EAAE,CAAS,EAAE,YAAoB,EAAA;AACzD,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,YAAY,GAAG,YAAY;IACpC;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;AACpD,QAAA,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM;QACpD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI;AACnC,QAAA,MAAM,KAAK,GAAG,YAAY,GAAG,EAAE;AAE/B,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;YAChC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACtB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;;YAEtB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK;AACtB,YAAA,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK;QACzB;IACJ;IAEgB,IAAI,GAAA;QAChB,OAAO;AACH,YAAA,GAAG,EAAE,cAAc;AACnB,YAAA,QAAQ,EAAE;AACN,gBAAA,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;AACrC,gBAAA,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE;AACrC,gBAAA,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE;AACjC,aAAA;AACD,YAAA,IAAI,EAAE;;;;AAIL,YAAA,CAAA;SACJ;IACL;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AACxD,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;AACzC,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;AACzC,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC;IACzC;AACH;;;;"}

package/dist/esm/particles/modules/RateSpawn.d.ts

@@ -0,0 +1,41 @@
+import { Vector } from '@/math/Vector';
+import { Color } from '@/core/Color';
+import { SpawnModule } from './SpawnModule';
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+import type { Distribution } from '@/particles/distributions/Distribution';
+/**
+ * Per-property spawn configuration. Every entry is a {@link Distribution}
+ * sampled once per spawned particle. Omitting an entry leaves the slot's
+ * field at its zero/default value (zero position/velocity/rotation, unit
+ * scale, opaque white, lifetime 1 s).
+ */
+export interface RateSpawnConfig {
+    /** Particles emitted per second. Sampled each frame. */
+    rate: Distribution<number>;
+    /** Total lifetime in seconds. Required — drives expiry. Default 1. */
+    lifetime?: Distribution<number>;
+    position?: Distribution<Vector>;
+    velocity?: Distribution<Vector>;
+    scale?: Distribution<Vector>;
+    rotation?: Distribution<number>;
+    rotationSpeed?: Distribution<number>;
+    /** Initial tint at spawn. For per-frame fade use a `ColorOverLifetime` update module. */
+    tint?: Distribution<Color>;
+    textureIndex?: Distribution<number>;
+}
+/**
+ * Continuous, rate-based spawner. Emits a {@link RateSpawnConfig.rate}
+ * sample per second; sub-frame fractions accumulate so low rates (e.g.
+ * 0.5 particles/s) remain accurate over time.
+ *
+ * Each property is independently randomised via its {@link Distribution}.
+ * Every spawned particle gets a fresh sample for every configured field.
+ */
+export declare class RateSpawn extends SpawnModule {
+    config: RateSpawnConfig;
+    private _accumulator;
+    private readonly _vec;
+    private readonly _color;
+    constructor(config: RateSpawnConfig);
+    apply(system: ParticleSystem, dt: number): void;
+}

package/dist/esm/particles/modules/RateSpawn.js

@@ -0,0 +1,76 @@
+import { Vector } from '../../math/Vector.js';
+import { Color } from '../../core/Color.js';
+import { SpawnModule } from './SpawnModule.js';
+
+/**
+ * Continuous, rate-based spawner. Emits a {@link RateSpawnConfig.rate}
+ * sample per second; sub-frame fractions accumulate so low rates (e.g.
+ * 0.5 particles/s) remain accurate over time.
+ *
+ * Each property is independently randomised via its {@link Distribution}.
+ * Every spawned particle gets a fresh sample for every configured field.
+ */
+class RateSpawn extends SpawnModule {
+    config;
+    _accumulator = 0;
+    _vec = new Vector();
+    _color = new Color();
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    apply(system, dt) {
+        const cfg = this.config;
+        const rate = cfg.rate.sample();
+        this._accumulator += rate * dt;
+        const count = this._accumulator | 0;
+        if (count <= 0) {
+            return;
+        }
+        this._accumulator -= count;
+        const v = this._vec;
+        const c = this._color;
+        for (let i = 0; i < count; i++) {
+            const slot = system.spawn();
+            if (slot < 0) {
+                this._accumulator = 0;
+                return;
+            }
+            system.lifetime[slot] = cfg.lifetime ? cfg.lifetime.sample() : 1;
+            if (cfg.position) {
+                cfg.position.sample(v);
+                system.posX[slot] = v.x;
+                system.posY[slot] = v.y;
+            }
+            else {
+                system.posX[slot] = 0;
+                system.posY[slot] = 0;
+            }
+            if (cfg.velocity) {
+                cfg.velocity.sample(v);
+                system.velX[slot] = v.x;
+                system.velY[slot] = v.y;
+            }
+            else {
+                system.velX[slot] = 0;
+                system.velY[slot] = 0;
+            }
+            if (cfg.scale) {
+                cfg.scale.sample(v);
+                system.scaleX[slot] = v.x;
+                system.scaleY[slot] = v.y;
+            }
+            else {
+                system.scaleX[slot] = 1;
+                system.scaleY[slot] = 1;
+            }
+            system.rotations[slot] = cfg.rotation ? cfg.rotation.sample() : 0;
+            system.rotationSpeeds[slot] = cfg.rotationSpeed ? cfg.rotationSpeed.sample() : 0;
+            system.color[slot] = cfg.tint ? cfg.tint.sample(c).toRgba() : 0xffffffff;
+            system.textureIndex[slot] = cfg.textureIndex ? (cfg.textureIndex.sample() | 0) : 0;
+        }
+    }
+}
+
+export { RateSpawn };
+//# sourceMappingURL=RateSpawn.js.map

package/dist/esm/particles/modules/RateSpawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateSpawn.js","sources":["../../../../../src/particles/modules/RateSpawn.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/particles/modules/RepelFromPoint.d.ts

@@ -0,0 +1,24 @@
+import { UpdateModule } from './UpdateModule';
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+import type { WgslContribution } from './WgslContribution';
+/**
+ * Pushes every live particle away from a fixed point in the system's local
+ * coordinate space. Acceleration magnitude is `strength` (units / s²)
+ * along the direction `(particle − point)`. The optional `radius` controls
+ * the influence range — particles farther than `radius` are unaffected.
+ * Setting `radius = 0` (default) means infinite range with no falloff.
+ *
+ * Use cases: shockwaves, explosion blast, mouse-cursor repel field.
+ *
+ * GPU-eligible.
+ */
+export declare class RepelFromPoint extends UpdateModule {
+    x: number;
+    y: number;
+    strength: number;
+    radius: number;
+    constructor(x: number, y: number, strength: number, radius?: number);
+    apply(system: ParticleSystem, dt: number): void;
+    wgsl(): WgslContribution;
+    writeUniforms(view: DataView, offset: number): void;
+}

package/dist/esm/particles/modules/RepelFromPoint.js

@@ -0,0 +1,76 @@
+import { UpdateModule } from './UpdateModule.js';
+
+/**
+ * Pushes every live particle away from a fixed point in the system's local
+ * coordinate space. Acceleration magnitude is `strength` (units / s²)
+ * along the direction `(particle − point)`. The optional `radius` controls
+ * the influence range — particles farther than `radius` are unaffected.
+ * Setting `radius = 0` (default) means infinite range with no falloff.
+ *
+ * Use cases: shockwaves, explosion blast, mouse-cursor repel field.
+ *
+ * GPU-eligible.
+ */
+class RepelFromPoint extends UpdateModule {
+    x;
+    y;
+    strength;
+    radius;
+    constructor(x, y, strength, radius = 0) {
+        super();
+        this.x = x;
+        this.y = y;
+        this.strength = strength;
+        this.radius = radius;
+    }
+    apply(system, dt) {
+        const { posX, posY, velX, velY, liveCount } = system;
+        const { x, y, strength, radius } = this;
+        const radiusSq = radius * radius;
+        for (let i = 0; i < liveCount; i++) {
+            const dx = posX[i] - x;
+            const dy = posY[i] - y;
+            const distSq = dx * dx + dy * dy;
+            if (distSq < 1e-10)
+                continue;
+            if (radius > 0 && distSq > radiusSq)
+                continue;
+            const dist = Math.sqrt(distSq);
+            const falloff = radius > 0 ? 1 - dist / radius : 1;
+            const a = (strength * falloff * dt) / dist;
+            velX[i] += dx * a;
+            velY[i] += dy * a;
+        }
+    }
+    wgsl() {
+        return {
+            key: 'RepelFromPoint',
+            uniforms: [
+                { name: 'point', type: 'vec2<f32>' },
+                { name: 'strength', type: 'f32' },
+                { name: 'radius', type: 'f32' },
+            ],
+            body: `
+                let repelDelta = positions[idx] - modules.u_RepelFromPoint.point;
+                let repelDistSq = dot(repelDelta, repelDelta);
+                let repelRadius = modules.u_RepelFromPoint.radius;
+                let repelInRange = (repelRadius <= 0.0) || (repelDistSq <= repelRadius * repelRadius);
+                if (repelDistSq > 0.0000001 && repelInRange) {
+                    let repelDist = sqrt(repelDistSq);
+                    let repelFalloff = select(1.0, 1.0 - repelDist / max(repelRadius, 0.000001), repelRadius > 0.0);
+                    let repelAccel = (modules.u_RepelFromPoint.strength * repelFalloff * dt) / repelDist;
+                    velocities[idx] = velocities[idx] + repelDelta * repelAccel;
+                }
+            `,
+        };
+    }
+    writeUniforms(view, offset) {
+        view.setFloat32(offset + 0, this.x, true);
+        view.setFloat32(offset + 4, this.y, true);
+        view.setFloat32(offset + 8, this.strength, true);
+        view.setFloat32(offset + 12, this.radius, true);
+    }
+}
+
+export { RepelFromPoint };
+//# sourceMappingURL=RepelFromPoint.js.map

package/dist/esm/particles/modules/RepelFromPoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepelFromPoint.js","sources":["../../../../../src/particles/modules/RepelFromPoint.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;AAUG;AACG,MAAO,cAAe,SAAQ,YAAY,CAAA;AACrC,IAAA,CAAC;AACD,IAAA,CAAC;AACD,IAAA,QAAQ;AACR,IAAA,MAAM;IAEb,WAAA,CAAmB,CAAS,EAAE,CAAS,EAAE,QAAgB,EAAE,MAAM,GAAG,CAAC,EAAA;AACjE,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;IACxB;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;AACpD,QAAA,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM;QACpD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;AACvC,QAAA,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM;AAEhC,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;YAChC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACtB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACtB,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;YAEhC,IAAI,MAAM,GAAG,KAAK;gBAAE;AACpB,YAAA,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,QAAQ;gBAAE;YAErC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;AAC9B,YAAA,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,QAAQ,GAAG,OAAO,GAAG,EAAE,IAAI,IAAI;AAE1C,YAAA,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;AACjB,YAAA,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;QACrB;IACJ;IAEgB,IAAI,GAAA;QAChB,OAAO;AACH,YAAA,GAAG,EAAE,gBAAgB;AACrB,YAAA,QAAQ,EAAE;AACN,gBAAA,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE;AACpC,gBAAA,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;AACjC,gBAAA,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;AAClC,aAAA;AACD,YAAA,IAAI,EAAE;;;;;;;;;;;AAWL,YAAA,CAAA;SACJ;IACL;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AACxD,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;AACzC,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;AACzC,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;AAChD,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;IACnD;AACH;;;;"}

package/dist/esm/particles/modules/RotateOverLifetime.d.ts

@@ -0,0 +1,20 @@
+import { UpdateModule } from './UpdateModule';
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+import type { WgslContribution } from './WgslContribution';
+/**
+ * Adds a constant angular acceleration to every live particle each frame
+ * (analogous to the legacy `TorqueAffector`). The system's integrate pass
+ * advances `rotation` from `rotationSpeed`; this module increments
+ * `rotationSpeed` itself.
+ *
+ * Units: degrees per second². Negative values decelerate spin.
+ *
+ * GPU-eligible.
+ */
+export declare class RotateOverLifetime extends UpdateModule {
+    angularAcceleration: number;
+    constructor(angularAcceleration: number);
+    apply(system: ParticleSystem, dt: number): void;
+    wgsl(): WgslContribution;
+    writeUniforms(view: DataView, offset: number): void;
+}

package/dist/esm/particles/modules/RotateOverLifetime.js

@@ -0,0 +1,43 @@
+import { UpdateModule } from './UpdateModule.js';
+
+/**
+ * Adds a constant angular acceleration to every live particle each frame
+ * (analogous to the legacy `TorqueAffector`). The system's integrate pass
+ * advances `rotation` from `rotationSpeed`; this module increments
+ * `rotationSpeed` itself.
+ *
+ * Units: degrees per second². Negative values decelerate spin.
+ *
+ * GPU-eligible.
+ */
+class RotateOverLifetime extends UpdateModule {
+    angularAcceleration;
+    constructor(angularAcceleration) {
+        super();
+        this.angularAcceleration = angularAcceleration;
+    }
+    apply(system, dt) {
+        const { rotationSpeeds, liveCount } = system;
+        const delta = this.angularAcceleration * dt;
+        for (let i = 0; i < liveCount; i++) {
+            rotationSpeeds[i] += delta;
+        }
+    }
+    wgsl() {
+        return {
+            key: 'RotateOverLifetime',
+            uniforms: [
+                { name: 'angularAcceleration', type: 'f32' },
+            ],
+            body: `
+                rotInfo[idx].y = rotInfo[idx].y + modules.u_RotateOverLifetime.angularAcceleration * dt;
+            `,
+        };
+    }
+    writeUniforms(view, offset) {
+        view.setFloat32(offset + 0, this.angularAcceleration, true);
+    }
+}
+
+export { RotateOverLifetime };
+//# sourceMappingURL=RotateOverLifetime.js.map

package/dist/esm/particles/modules/RotateOverLifetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RotateOverLifetime.js","sources":["../../../../../src/particles/modules/RotateOverLifetime.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;AASG;AACG,MAAO,kBAAmB,SAAQ,YAAY,CAAA;AACzC,IAAA,mBAAmB;AAE1B,IAAA,WAAA,CAAmB,mBAA2B,EAAA;AAC1C,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,mBAAmB,GAAG,mBAAmB;IAClD;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;AACpD,QAAA,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,MAAM;AAC5C,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,GAAG,EAAE;AAE3C,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;AAChC,YAAA,cAAc,CAAC,CAAC,CAAC,IAAI,KAAK;QAC9B;IACJ;IAEgB,IAAI,GAAA;QAChB,OAAO;AACH,YAAA,GAAG,EAAE,oBAAoB;AACzB,YAAA,QAAQ,EAAE;AACN,gBAAA,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,KAAK,EAAE;AAC/C,aAAA;AACD,YAAA,IAAI,EAAE;;AAEL,YAAA,CAAA;SACJ;IACL;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AACxD,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC;IAC/D;AACH;;;;"}

package/dist/esm/particles/modules/ScaleOverLifetime.d.ts

@@ -0,0 +1,26 @@
+import { UpdateModule } from './UpdateModule';
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+import type { Curve } from '@/particles/distributions/Curve';
+import type { WgslContribution } from './WgslContribution';
+/**
+ * Sets every live particle's scale to a curve sampled at the particle's
+ * current lifetime ratio. Both axes share one curve — for non-uniform
+ * scaling layer two ScaleOverLifetime modules with separate `axis` filters
+ * (or extend with a per-axis variant).
+ *
+ * Common patterns: shrink-to-zero (start at 1, end at 0), pulse (sine-like
+ * curve up to peak then down), slow-grow (linear ramp).
+ *
+ * GPU-eligible: the curve is uploaded once as a 256-tap 1D R32F texture and
+ * sampled with linear filtering on the GPU — no curve evaluation cost in
+ * the inner loop.
+ */
+export declare class ScaleOverLifetime extends UpdateModule {
+    curve: Curve;
+    constructor(curve: Curve);
+    apply(system: ParticleSystem, _dt: number): void;
+    wgsl(): WgslContribution;
+    uploadTextures(device: GPUDevice, textures: ReadonlyMap<string, GPUTexture>): void;
+}
+/** Texture width for the curve lookup table. Exposed for ParticleGpuState. */
+export declare const scaleLookupSize = 256;