@codexo/exojs 0.11.0 → 0.13.0

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

@@ -1,25 +0,0 @@
-/**
- * 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

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

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

@@ -1,20 +0,0 @@
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-import { UpdateModule } from './UpdateModule';
-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

@@ -1,43 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"Drag.js","sources":["../../../../../src/particles/modules/Drag.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;AASG;AACG,MAAO,IAAK,SAAQ,YAAY,CAAA;AAC7B,IAAA,IAAI;AAEX,IAAA,WAAA,CAAmB,IAAY,EAAA;AAC7B,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;IAClB;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;QACtD,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;AAClC,YAAA,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM;AACjB,YAAA,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM;QACnB;IACF;IAEgB,IAAI,GAAA;QAClB,OAAO;AACL,YAAA,GAAG,EAAE,MAAM;YACX,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzC,YAAA,IAAI,EAAE;;;AAGC,YAAA,CAAA;SACR;IACH;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AAC1D,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;IAC9C;AACD;;;;"}

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

@@ -1,28 +0,0 @@
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-import { UpdateModule } from './UpdateModule';
-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

@@ -1,65 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"OrbitalForce.js","sources":["../../../../../src/particles/modules/OrbitalForce.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;;;;;;AAeG;AACG,MAAO,YAAa,SAAQ,YAAY,CAAA;AACrC,IAAA,CAAC;AACD,IAAA,CAAC;AACD,IAAA,YAAY;AAEnB,IAAA,WAAA,CAAmB,CAAS,EAAE,CAAS,EAAE,YAAoB,EAAA;AAC3D,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,YAAY,GAAG,YAAY;IAClC;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;AACtD,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;YAClC,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;QACvB;IACF;IAEgB,IAAI,GAAA;QAClB,OAAO;AACL,YAAA,GAAG,EAAE,cAAc;AACnB,YAAA,QAAQ,EAAE;AACR,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;AAC/B,aAAA;AACD,YAAA,IAAI,EAAE;;;;AAIC,YAAA,CAAA;SACR;IACH;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AAC1D,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;IACvC;AACD;;;;"}

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

@@ -1,41 +0,0 @@
-import { Color } from '@/core/Color';
-import { Vector } from '@/math/Vector';
-import type { Distribution } from '@/particles/distributions/Distribution';
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-import { SpawnModule } from './SpawnModule';
-/**
- * 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

@@ -1,76 +0,0 @@
-import { Color } from '../../core/Color.js';
-import { Vector } from '../../math/Vector.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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-import { UpdateModule } from './UpdateModule';
-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

@@ -1,76 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"RepelFromPoint.js","sources":["../../../../../src/particles/modules/RepelFromPoint.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;AAUG;AACG,MAAO,cAAe,SAAQ,YAAY,CAAA;AACvC,IAAA,CAAC;AACD,IAAA,CAAC;AACD,IAAA,QAAQ;AACR,IAAA,MAAM;IAEb,WAAA,CAAmB,CAAS,EAAE,CAAS,EAAE,QAAgB,EAAE,MAAM,GAAG,CAAC,EAAA;AACnE,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;IACtB;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;AACtD,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;YAClC,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;QACnB;IACF;IAEgB,IAAI,GAAA;QAClB,OAAO;AACL,YAAA,GAAG,EAAE,gBAAgB;AACrB,YAAA,QAAQ,EAAE;AACR,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;AAChC,aAAA;AACD,YAAA,IAAI,EAAE;;;;;;;;;;;AAWC,YAAA,CAAA;SACR;IACH;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AAC1D,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;IACjD;AACD;;;;"}

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

@@ -1,20 +0,0 @@
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-import { UpdateModule } from './UpdateModule';
-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

@@ -1,41 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"RotateOverLifetime.js","sources":["../../../../../src/particles/modules/RotateOverLifetime.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;AASG;AACG,MAAO,kBAAmB,SAAQ,YAAY,CAAA;AAC3C,IAAA,mBAAmB;AAE1B,IAAA,WAAA,CAAmB,mBAA2B,EAAA;AAC5C,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,mBAAmB,GAAG,mBAAmB;IAChD;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;AACtD,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;AAClC,YAAA,cAAc,CAAC,CAAC,CAAC,IAAI,KAAK;QAC5B;IACF;IAEgB,IAAI,GAAA;QAClB,OAAO;AACL,YAAA,GAAG,EAAE,oBAAoB;YACzB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxD,YAAA,IAAI,EAAE;;AAEC,YAAA,CAAA;SACR;IACH;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AAC1D,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC;IAC7D;AACD;;;;"}

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

@@ -1,26 +0,0 @@
-import type { Curve } from '@/particles/distributions/Curve';
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-import { UpdateModule } from './UpdateModule';
-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;

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

@@ -1,59 +0,0 @@
-import { UpdateModule } from './UpdateModule.js';
-
-/// <reference types="@webgpu/types" />
-const lookupSize = 256;
-/**
- * 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.
- */
-class ScaleOverLifetime extends UpdateModule {
-    curve;
-    constructor(curve) {
-        super();
-        this.curve = curve;
-    }
-    apply(system, _dt) {
-        const { scaleX, scaleY, elapsed, lifetime, liveCount } = system;
-        const curve = this.curve;
-        for (let i = 0; i < liveCount; i++) {
-            const t = elapsed[i] / lifetime[i];
-            const s = curve.evaluate(t);
-            scaleX[i] = s;
-            scaleY[i] = s;
-        }
-    }
-    wgsl() {
-        return {
-            key: 'ScaleOverLifetime',
-            textures: [{ name: 'curve', format: 'r32float' }],
-            body: `
-                let scaleT = clamp(timing[idx].x / max(timing[idx].y, 0.000001), 0.0, 1.0);
-                let scaleSample = textureSampleLevel(u_ScaleOverLifetime_curve, u_ScaleOverLifetime_curve_sampler, scaleT, 0.0).r;
-                scales[idx] = vec2<f32>(scaleSample, scaleSample);
-            `,
-        };
-    }
-    uploadTextures(device, textures) {
-        const texture = textures.get('curve');
-        if (texture === undefined) {
-            return;
-        }
-        const data = new Float32Array(lookupSize);
-        for (let i = 0; i < lookupSize; i++) {
-            data[i] = this.curve.evaluate(i / (lookupSize - 1));
-        }
-        device.queue.writeTexture({ texture }, data.buffer, { offset: 0, bytesPerRow: lookupSize * 4, rowsPerImage: 1 }, { width: lookupSize, height: 1, depthOrArrayLayers: 1 });
-    }
-}
-
-export { ScaleOverLifetime };
-//# sourceMappingURL=ScaleOverLifetime.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ScaleOverLifetime.js","sources":["../../../../../src/particles/modules/ScaleOverLifetime.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;AAQA,MAAM,UAAU,GAAG,GAAG;AAEtB;;;;;;;;;;;;AAYG;AACG,MAAO,iBAAkB,SAAQ,YAAY,CAAA;AAC1C,IAAA,KAAK;AAEZ,IAAA,WAAA,CAAmB,KAAY,EAAA;AAC7B,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK;IACpB;IAEgB,KAAK,CAAC,MAAsB,EAAE,GAAW,EAAA;AACvD,QAAA,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;AAC/D,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK;AAExB,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;YAClC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE3B,YAAA,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;AACb,YAAA,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QACf;IACF;IAEgB,IAAI,GAAA;QAClB,OAAO;AACL,YAAA,GAAG,EAAE,mBAAmB;YACxB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACjD,YAAA,IAAI,EAAE;;;;AAIC,YAAA,CAAA;SACR;IACH;IAEgB,cAAc,CAAC,MAAiB,EAAE,QAAyC,EAAA;QACzF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAErC,QAAA,IAAI,OAAO,KAAK,SAAS,EAAE;YACzB;QACF;AAEA,QAAA,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC;AAEzC,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE;AACnC,YAAA,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;QACrD;AAEA,QAAA,MAAM,CAAC,KAAK,CAAC,YAAY,CACvB,EAAE,OAAO,EAAE,EACX,IAAI,CAAC,MAAM,EACX,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,UAAU,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAC3D,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,CACxD;IACH;AACD;;;;"}

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

@@ -1,30 +0,0 @@
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-/**
- * Per-frame particle spawner. Subclasses decide how many particles to emit
- * each tick (rate-based, burst, on-demand) and write their initial values
- * directly into the system's typed-array slots.
- *
- * Implementation pattern:
- *
- * ```ts
- * apply(system, dt) {
- *     const count = this.computeSpawnCount(dt);
- *     for (let i = 0; i < count; i++) {
- *         const slot = system.spawn();
- *         if (slot < 0) break;          // capacity exhausted
- *         system.posX[slot] = ...;
- *         system.velX[slot] = ...;
- *         system.lifetime[slot] = ...;
- *         // ...etc
- *     }
- * }
- * ```
- *
- * Spawn modules run before integration each frame. Multiple modules can be
- * registered on one system and execute in registration order.
- */
-export declare abstract class SpawnModule {
-    abstract apply(system: ParticleSystem, dt: number): void;
-    /** Optional cleanup hook called from `ParticleSystem.destroy`. */
-    destroy(): void;
-}

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

@@ -1,31 +0,0 @@
-/**
- * Per-frame particle spawner. Subclasses decide how many particles to emit
- * each tick (rate-based, burst, on-demand) and write their initial values
- * directly into the system's typed-array slots.
- *
- * Implementation pattern:
- *
- * ```ts
- * apply(system, dt) {
- *     const count = this.computeSpawnCount(dt);
- *     for (let i = 0; i < count; i++) {
- *         const slot = system.spawn();
- *         if (slot < 0) break;          // capacity exhausted
- *         system.posX[slot] = ...;
- *         system.velX[slot] = ...;
- *         system.lifetime[slot] = ...;
- *         // ...etc
- *     }
- * }
- * ```
- *
- * Spawn modules run before integration each frame. Multiple modules can be
- * registered on one system and execute in registration order.
- */
-class SpawnModule {
-    /** Optional cleanup hook called from `ParticleSystem.destroy`. */
-    destroy() { }
-}
-
-export { SpawnModule };
-//# sourceMappingURL=SpawnModule.js.map

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

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