@flighthq/particleemitter 0.1.0

package/dist/stepParticleEmitter.d.ts

@@ -0,0 +1,21 @@
+import type { ParticleCollider, ParticleEmitter, ParticleEmitterCallbacks, ParticleEmitterConfig, ParticleEmitterState, ParticleForce, WorldTransform2D } from '@flighthq/types';
+/**
+ * Convenience wrapper for the SoA typed-array emitter that folds the canonical three-step update
+ * sequence — `applyParticleForces` → `updateParticleEmitter` → `applyParticleCollisions` — into a
+ * single call.
+ *
+ * The three primitives remain exported for advanced use (custom interleaving, per-force-group
+ * timing, etc.). Use this function for the common case where all forces and colliders apply each
+ * frame in the documented order.
+ *
+ * @param emitter - The SoA particle emitter node.
+ * @param state - Mutable per-emitter simulation state.
+ * @param config - Immutable emitter configuration.
+ * @param deltaTime - Elapsed time in seconds since the last step.
+ * @param forces - Optional force fields to apply before integration (e.g. wind, attractor).
+ * @param colliders - Optional colliders to resolve after integration (e.g. plane, circle).
+ * @param callbacks - Optional spawn/death callbacks.
+ * @param worldTransform - World-space transform for world-space emitters.
+ */
+export declare function stepParticleEmitter(emitter: ParticleEmitter, state: ParticleEmitterState, config: Readonly<ParticleEmitterConfig>, deltaTime: number, forces?: ReadonlyArray<ParticleForce>, colliders?: ReadonlyArray<ParticleCollider>, callbacks?: ParticleEmitterCallbacks, worldTransform?: Readonly<WorldTransform2D>): void;
+//# sourceMappingURL=stepParticleEmitter.d.ts.map

package/dist/stepParticleEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepParticleEmitter.d.ts","sourceRoot":"","sources":["../src/stepParticleEmitter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAIzB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,EACrC,SAAS,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC3C,SAAS,CAAC,EAAE,wBAAwB,EACpC,cAAc,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAC1C,IAAI,CAQN"}

package/dist/stepParticleEmitter.js

@@ -0,0 +1,30 @@
+import { applyParticleCollisions, applyParticleForces } from '@flighthq/particles';
+import { updateParticleEmitter } from './updateParticleEmitter';
+/**
+ * Convenience wrapper for the SoA typed-array emitter that folds the canonical three-step update
+ * sequence — `applyParticleForces` → `updateParticleEmitter` → `applyParticleCollisions` — into a
+ * single call.
+ *
+ * The three primitives remain exported for advanced use (custom interleaving, per-force-group
+ * timing, etc.). Use this function for the common case where all forces and colliders apply each
+ * frame in the documented order.
+ *
+ * @param emitter - The SoA particle emitter node.
+ * @param state - Mutable per-emitter simulation state.
+ * @param config - Immutable emitter configuration.
+ * @param deltaTime - Elapsed time in seconds since the last step.
+ * @param forces - Optional force fields to apply before integration (e.g. wind, attractor).
+ * @param colliders - Optional colliders to resolve after integration (e.g. plane, circle).
+ * @param callbacks - Optional spawn/death callbacks.
+ * @param worldTransform - World-space transform for world-space emitters.
+ */
+export function stepParticleEmitter(emitter, state, config, deltaTime, forces, colliders, callbacks, worldTransform) {
+    if (forces != null && forces.length > 0) {
+        applyParticleForces(emitter, state, forces, deltaTime);
+    }
+    updateParticleEmitter(emitter, state, config, deltaTime, callbacks, worldTransform);
+    if (colliders != null && colliders.length > 0) {
+        applyParticleCollisions(emitter, state, colliders);
+    }
+}
+//# sourceMappingURL=stepParticleEmitter.js.map

package/dist/stepParticleEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepParticleEmitter.js","sourceRoot":"","sources":["../src/stepParticleEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAWnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwB,EACxB,KAA2B,EAC3B,MAAuC,EACvC,SAAiB,EACjB,MAAqC,EACrC,SAA2C,EAC3C,SAAoC,EACpC,cAA2C;IAE3C,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IACD,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IACpF,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/updateParticleEmitter.d.ts

@@ -0,0 +1,8 @@
+import type { ParticleEmitter, ParticleEmitterCallbacks, ParticleEmitterConfig, ParticleEmitterState, WorldTransform2D } from '@flighthq/types';
+export type { ParticleEmitterCallbacks, WorldTransform2D };
+/** True once a finite, non-looping emitter has finished emitting AND all of its
+ *  particles have died — i.e. a one-shot effect that is safe to recycle/remove.
+ *  Always false for infinite or looping emitters (they never finish). */
+export declare function isParticleEmitterComplete(emitter: ParticleEmitter, state: Readonly<ParticleEmitterState>, config: Readonly<ParticleEmitterConfig>): boolean;
+export declare function updateParticleEmitter(emitter: ParticleEmitter, state: ParticleEmitterState, config: Readonly<ParticleEmitterConfig>, deltaTime: number, callbacks?: ParticleEmitterCallbacks, worldTransform?: Readonly<WorldTransform2D>): void;
+//# sourceMappingURL=updateParticleEmitter.d.ts.map

package/dist/updateParticleEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateParticleEmitter.d.ts","sourceRoot":"","sources":["../src/updateParticleEmitter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAIzB,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,CAAC;AAK3D;;yEAEyE;AACzE,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EACrC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAGT;AAQD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,wBAAwB,EACpC,cAAc,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAC1C,IAAI,CAgUN"}

package/dist/updateParticleEmitter.js

@@ -0,0 +1,313 @@
+import { invalidateNodeLocalBounds } from '@flighthq/node';
+import { ensureParticleEmitterStateCapacity, getParticleEmitterSignals, sampleParticleColorCurve, sampleParticleCurve, } from '@flighthq/particles';
+import { reserveParticleEmitter } from './particleEmitter';
+const PARTICLE_TRANSFORM_STRIDE = 4; // must match ./particleEmitter
+const TWO_PI = Math.PI * 2;
+/** True once a finite, non-looping emitter has finished emitting AND all of its
+ *  particles have died — i.e. a one-shot effect that is safe to recycle/remove.
+ *  Always false for infinite or looping emitters (they never finish). */
+export function isParticleEmitterComplete(emitter, state, config) {
+    if (config.duration <= 0 || config.loop)
+        return false;
+    return state.emitterAge >= config.duration && emitter.data.particleCount === 0;
+}
+/** Whether an emitter with the given config is still spawning, given how long it
+ *  has been emitting. Infinite (duration <= 0) and looping emitters always emit. */
+function isEmitting(config, emitterAge) {
+    return config.duration <= 0 || config.loop || emitterAge < config.duration;
+}
+export function updateParticleEmitter(emitter, state, config, deltaTime, callbacks, worldTransform) {
+    const data = emitter.data;
+    // Sync world-space flag to data so renderers can read it.
+    data.worldSpace = config.worldSpace;
+    // Guard against a zero or negative time step: no time has elapsed, so there is
+    // nothing to age, move, or spawn. Critically, this avoids dividing by deltaTime when
+    // computing emitter velocity below — a zero-deltaTime frame that still fires a burst
+    // would otherwise bake Infinity/NaN velocities into freshly spawned particles
+    // and corrupt them for the rest of their lifetime.
+    if (deltaTime <= 0)
+        return;
+    // ── Emitter velocity (for velocity inheritance and trail interpolation) ───────
+    // In world-space mode we track the world origin; in local-space mode we track
+    // the emitter node position in parent space.
+    const trackX = config.worldSpace && worldTransform != null ? worldTransform.tx : emitter.x;
+    const trackY = config.worldSpace && worldTransform != null ? worldTransform.ty : emitter.y;
+    const hasVelInherit = config.velocityInheritance !== 0;
+    let emitterVelX = 0;
+    let emitterVelY = 0;
+    if (!isNaN(state.prevX)) {
+        emitterVelX = (trackX - state.prevX) / deltaTime;
+        emitterVelY = (trackY - state.prevY) / deltaTime;
+    }
+    // ── Phase 1: age all live particles, compact dead ones ──────────────────────
+    const lifetimes = state.lifetimes;
+    const velocities = state.velocities;
+    const scales = state.scales;
+    const rotationSpeeds = state.rotationSpeeds;
+    const gx = config.gravityX * deltaTime;
+    const gy = config.gravityY * deltaTime;
+    const { colorStartR, colorStartG, colorStartB, colorEndR, colorEndG, colorEndB } = config;
+    const hasColorVariance = config.colorStartVarianceR !== 0 ||
+        config.colorStartVarianceG !== 0 ||
+        config.colorStartVarianceB !== 0 ||
+        config.colorEndVarianceR !== 0 ||
+        config.colorEndVarianceG !== 0 ||
+        config.colorEndVarianceB !== 0;
+    const hasColorGradient = hasColorVariance || colorStartR !== colorEndR || colorStartG !== colorEndG || colorStartB !== colorEndB;
+    // Opt-in lifetime curves override the linear paths below; an emitter without
+    // curves never touches these branches beyond a predicted-not-taken check.
+    const alphaCurve = config.alphaCurve;
+    const colorCurve = config.colorCurve;
+    const scaleCurve = config.scaleCurve;
+    const hasAlphaCurve = alphaCurve != null && alphaCurve.length > 0;
+    const hasColorCurve = colorCurve != null && colorCurve.length >= 3;
+    const hasScaleCurve = scaleCurve != null && scaleCurve.length > 0;
+    const hasScaleAnim = config.scaleEnd !== 1 || hasScaleCurve;
+    const hasColorWork = hasColorCurve || hasColorGradient;
+    const hasRotationSpeed = config.rotationSpeedMin !== 0 || config.rotationSpeedMax !== 0;
+    const hasFlipbook = config.frameCount > 1;
+    const onDeath = callbacks?.onDeath;
+    const onSpawn = callbacks?.onSpawn;
+    // Opt-in signals: null when enableParticleEmitterSignals has not been called on this state.
+    const signals = getParticleEmitterSignals(state);
+    let liveCount = data.particleCount;
+    let i = 0;
+    while (i < liveCount) {
+        const lt = i * 2;
+        lifetimes[lt] += deltaTime;
+        if (lifetimes[lt] >= lifetimes[lt + 1]) {
+            if (onDeath !== undefined || signals !== null) {
+                const tt = i * PARTICLE_TRANSFORM_STRIDE;
+                const dx = data.transforms[tt];
+                const dy = data.transforms[tt + 1];
+                onDeath?.(dx, dy);
+                signals?.onParticleDeath.emit(dx, dy);
+            }
+            liveCount--;
+            if (i < liveCount) {
+                const lt2 = liveCount * 2;
+                lifetimes[lt] = lifetimes[lt2];
+                lifetimes[lt + 1] = lifetimes[lt2 + 1];
+                const vt = i * 2;
+                const vt2 = liveCount * 2;
+                velocities[vt] = velocities[vt2];
+                velocities[vt + 1] = velocities[vt2 + 1];
+                const tt = i * PARTICLE_TRANSFORM_STRIDE;
+                const tt2 = liveCount * PARTICLE_TRANSFORM_STRIDE;
+                data.transforms[tt] = data.transforms[tt2];
+                data.transforms[tt + 1] = data.transforms[tt2 + 1];
+                data.transforms[tt + 2] = data.transforms[tt2 + 2];
+                data.transforms[tt + 3] = data.transforms[tt2 + 3];
+                data.alphas[i] = data.alphas[liveCount];
+                data.ids[i] = data.ids[liveCount];
+                const ct = i * 3;
+                const ct2 = liveCount * 3;
+                data.colors[ct] = data.colors[ct2];
+                data.colors[ct + 1] = data.colors[ct2 + 1];
+                data.colors[ct + 2] = data.colors[ct2 + 2];
+                scales[i] = scales[liveCount];
+                rotationSpeeds[i] = rotationSpeeds[liveCount];
+                if (hasColorVariance) {
+                    state.colorBirth[ct] = state.colorBirth[ct2];
+                    state.colorBirth[ct + 1] = state.colorBirth[ct2 + 1];
+                    state.colorBirth[ct + 2] = state.colorBirth[ct2 + 2];
+                    state.colorDeath[ct] = state.colorDeath[ct2];
+                    state.colorDeath[ct + 1] = state.colorDeath[ct2 + 1];
+                    state.colorDeath[ct + 2] = state.colorDeath[ct2 + 2];
+                }
+            }
+            continue;
+        }
+        const vt = i * 2;
+        velocities[vt] += gx;
+        velocities[vt + 1] += gy;
+        const tt = i * PARTICLE_TRANSFORM_STRIDE;
+        data.transforms[tt] += velocities[vt] * deltaTime;
+        data.transforms[tt + 1] += velocities[vt + 1] * deltaTime;
+        const lifeFraction = lifetimes[lt] / lifetimes[lt + 1];
+        data.alphas[i] = hasAlphaCurve
+            ? sampleParticleCurve(alphaCurve, lifeFraction)
+            : config.alphaStart + (config.alphaEnd - config.alphaStart) * lifeFraction;
+        if (hasColorWork) {
+            const ct = i * 3;
+            if (hasColorCurve) {
+                sampleParticleColorCurve(data.colors, ct, colorCurve, lifeFraction);
+            }
+            else if (hasColorVariance) {
+                data.colors[ct] = state.colorBirth[ct] + (state.colorDeath[ct] - state.colorBirth[ct]) * lifeFraction;
+                data.colors[ct + 1] =
+                    state.colorBirth[ct + 1] + (state.colorDeath[ct + 1] - state.colorBirth[ct + 1]) * lifeFraction;
+                data.colors[ct + 2] =
+                    state.colorBirth[ct + 2] + (state.colorDeath[ct + 2] - state.colorBirth[ct + 2]) * lifeFraction;
+            }
+            else {
+                data.colors[ct] = colorStartR + (colorEndR - colorStartR) * lifeFraction;
+                data.colors[ct + 1] = colorStartG + (colorEndG - colorStartG) * lifeFraction;
+                data.colors[ct + 2] = colorStartB + (colorEndB - colorStartB) * lifeFraction;
+            }
+        }
+        if (hasScaleAnim) {
+            const scaleFactor = hasScaleCurve
+                ? sampleParticleCurve(scaleCurve, lifeFraction)
+                : 1 + (config.scaleEnd - 1) * lifeFraction;
+            data.transforms[tt + 3] = scales[i] * scaleFactor;
+        }
+        if (hasRotationSpeed) {
+            data.transforms[tt + 2] += rotationSpeeds[i] * deltaTime;
+        }
+        if (hasFlipbook) {
+            const frame = Math.floor(lifetimes[lt] * config.frameRate) % config.frameCount;
+            data.ids[i] = config.regionIdMin + frame;
+        }
+        i++;
+    }
+    data.particleCount = liveCount;
+    // ── Phase 2: spawn new particles ─────────────────────────────────────────────
+    // A finite, non-looping emitter stops spawning once its duration elapses;
+    // existing particles keep ageing out (use isParticleEmitterComplete to detect the end).
+    const emitting = isEmitting(config, state.emitterAge);
+    if (config.duration > 0 && !config.loop)
+        state.emitterAge += deltaTime;
+    state.spawnAccumulator += emitting ? config.spawnRate * deltaTime : 0;
+    let toSpawn = Math.floor(state.spawnAccumulator);
+    state.spawnAccumulator -= toSpawn;
+    if (emitting && config.burstCount > 0) {
+        state.burstTimer -= deltaTime;
+        if (state.burstTimer <= 0) {
+            toSpawn += config.burstCount;
+            state.burstTimer = config.burstInterval > 0 ? config.burstInterval : Infinity;
+        }
+    }
+    const maxNew = config.maxParticles - liveCount;
+    if (toSpawn > maxNew)
+        toSpawn = maxNew;
+    if (toSpawn > 0) {
+        const newCount = liveCount + toSpawn;
+        reserveParticleEmitter(emitter, newCount);
+        ensureParticleEmitterStateCapacity(state, newCount, hasColorVariance);
+        const baseAngle = Math.atan2(config.directionY, config.directionX);
+        const regionRange = config.regionIdMax - config.regionIdMin;
+        const regionIdMin = config.regionIdMin;
+        const rotSpeedRange = config.rotationSpeedMax - config.rotationSpeedMin;
+        const hasRotSpeed = config.rotationSpeedMin !== 0 || config.rotationSpeedMax !== 0;
+        // World-space trail: distribute spawn origins along the path from prevPos → currentPos.
+        const doTrail = config.worldSpace && worldTransform != null && !isNaN(state.prevX);
+        const prevPathX = doTrail ? state.prevX : trackX;
+        const prevPathY = doTrail ? state.prevY : trackY;
+        for (let s = 0; s < toSpawn; s++) {
+            const idx = liveCount + s;
+            // Lifetime
+            const lifetime = config.lifetimeMin + state.random() * (config.lifetimeMax - config.lifetimeMin);
+            const lt = idx * 2;
+            state.lifetimes[lt] = 0;
+            state.lifetimes[lt + 1] = lifetime;
+            // Velocity direction in local/emitter space
+            const angle = baseAngle + (state.random() - 0.5) * 2 * config.spread;
+            const speed = config.speedMin + state.random() * (config.speedMax - config.speedMin);
+            let vx = Math.cos(angle) * speed;
+            let vy = Math.sin(angle) * speed;
+            // Spawn position (local to emitter, or shape offset)
+            let spawnX = 0;
+            let spawnY = 0;
+            if (config.emitterShape === 'circle' && config.emitterRadius > 0) {
+                const r = Math.sqrt(state.random()) * config.emitterRadius;
+                const a = state.random() * TWO_PI;
+                spawnX = Math.cos(a) * r;
+                spawnY = Math.sin(a) * r;
+            }
+            else if (config.emitterShape === 'rect' && (config.emitterWidth > 0 || config.emitterHeight > 0)) {
+                spawnX = (state.random() - 0.5) * config.emitterWidth;
+                spawnY = (state.random() - 0.5) * config.emitterHeight;
+            }
+            // World-space: transform spawn position and velocity into world space,
+            // and distribute origins along the emitter's movement path (trail interpolation).
+            if (config.worldSpace && worldTransform != null) {
+                const wt = worldTransform;
+                // Trail: interpolate origin between prev and current world position
+                const t = toSpawn > 1 ? s / (toSpawn - 1) : 1;
+                const originX = prevPathX + (trackX - prevPathX) * t;
+                const originY = prevPathY + (trackY - prevPathY) * t;
+                // Apply rotation+scale of world transform to shape offset, then add trail origin
+                const wx = wt.a * spawnX + wt.c * spawnY + originX;
+                const wy = wt.b * spawnX + wt.d * spawnY + originY;
+                spawnX = wx;
+                spawnY = wy;
+                // Rotate velocity by world transform (no translation for vectors)
+                const wvx = wt.a * vx + wt.c * vy;
+                const wvy = wt.b * vx + wt.d * vy;
+                vx = wvx;
+                vy = wvy;
+            }
+            // Velocity inheritance: blend emitter velocity into new particle velocity
+            if (hasVelInherit && !isNaN(state.prevX)) {
+                vx += emitterVelX * config.velocityInheritance;
+                vy += emitterVelY * config.velocityInheritance;
+            }
+            const vt = idx * 2;
+            state.velocities[vt] = vx;
+            state.velocities[vt + 1] = vy;
+            const spawnScale = config.scaleMin + state.random() * (config.scaleMax - config.scaleMin);
+            state.scales[idx] = spawnScale;
+            const tt = idx * PARTICLE_TRANSFORM_STRIDE;
+            data.transforms[tt] = spawnX;
+            data.transforms[tt + 1] = spawnY;
+            data.transforms[tt + 2] = angle;
+            data.transforms[tt + 3] = hasScaleCurve ? spawnScale * sampleParticleCurve(scaleCurve, 0) : spawnScale;
+            data.alphas[idx] = hasAlphaCurve ? sampleParticleCurve(alphaCurve, 0) : config.alphaStart;
+            // Color — curve takes precedence, then per-particle variance, then constants
+            const ct = idx * 3;
+            if (hasColorCurve) {
+                sampleParticleColorCurve(data.colors, ct, colorCurve, 0);
+            }
+            else if (hasColorVariance) {
+                const r0 = clamp01(colorStartR + (state.random() - 0.5) * 2 * config.colorStartVarianceR);
+                const g0 = clamp01(colorStartG + (state.random() - 0.5) * 2 * config.colorStartVarianceG);
+                const b0 = clamp01(colorStartB + (state.random() - 0.5) * 2 * config.colorStartVarianceB);
+                const r1 = clamp01(colorEndR + (state.random() - 0.5) * 2 * config.colorEndVarianceR);
+                const g1 = clamp01(colorEndG + (state.random() - 0.5) * 2 * config.colorEndVarianceG);
+                const b1 = clamp01(colorEndB + (state.random() - 0.5) * 2 * config.colorEndVarianceB);
+                state.colorBirth[ct] = r0;
+                state.colorBirth[ct + 1] = g0;
+                state.colorBirth[ct + 2] = b0;
+                state.colorDeath[ct] = r1;
+                state.colorDeath[ct + 1] = g1;
+                state.colorDeath[ct + 2] = b1;
+                data.colors[ct] = r0;
+                data.colors[ct + 1] = g0;
+                data.colors[ct + 2] = b0;
+            }
+            else {
+                data.colors[ct] = colorStartR;
+                data.colors[ct + 1] = colorStartG;
+                data.colors[ct + 2] = colorStartB;
+            }
+            data.ids[idx] =
+                regionIdMin + (config.frameCount > 1 ? 0 : regionRange > 0 ? (state.random() * regionRange) | 0 : 0);
+            state.rotationSpeeds[idx] = hasRotSpeed ? config.rotationSpeedMin + state.random() * rotSpeedRange : 0;
+            onSpawn?.(spawnX, spawnY);
+            if (signals !== null) {
+                signals.onParticleSpawn.emit(spawnX, spawnY, state.velocities[vt], state.velocities[vt + 1]);
+            }
+        }
+        data.particleCount = newCount;
+    }
+    // Update prev-position tracking for next frame.
+    state.prevX = trackX;
+    state.prevY = trackY;
+    // Mirror the live per-particle velocities into the render data so the velocity G-buffer writer can
+    // smear each particle by its own vector. state.velocities is kept aligned with data.transforms by the
+    // compaction above, so the leading particleCount entries are the live particles in render order.
+    const liveVelocityCount = data.particleCount * 2;
+    if (data.velocities.length >= liveVelocityCount) {
+        data.velocities.set(state.velocities.subarray(0, liveVelocityCount));
+    }
+    // Fire onEmitterComplete when a finite emitter has just finished and all particles are gone.
+    if (signals !== null && isParticleEmitterComplete(emitter, state, config)) {
+        signals.onEmitterComplete.emit();
+    }
+    invalidateNodeLocalBounds(emitter);
+}
+function clamp01(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+//# sourceMappingURL=updateParticleEmitter.js.map

package/dist/updateParticleEmitter.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@flighthq/particleemitter",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/displayobject": "0.1.0",
+    "@flighthq/geometry": "0.1.0",
+    "@flighthq/node": "0.1.0",
+    "@flighthq/particles": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "@flighthq/math": "*",
+    "typescript": "^5.3.0"
+  },
+  "description": "ParticleEmitter display-object composition layer over @flighthq/particles",
+  "sideEffects": false
+}

package/src/deterministic.test.ts

@@ -0,0 +1,53 @@
+import { createRandomSource } from '@flighthq/math';
+import { createParticleEmitterConfig, createParticleEmitterState } from '@flighthq/particles';
+import type { TextureAtlas } from '@flighthq/types';
+
+import { createParticleEmitter } from './particleEmitter';
+import { stepParticleEmitter } from './stepParticleEmitter';
+
+function makeAtlas(): TextureAtlas {
+  return {
+    image: null,
+    regions: [{ id: 0, x: 0, y: 0, width: 32, height: 32, pivotX: null, pivotY: null }],
+  } as unknown as TextureAtlas;
+}
+
+describe('deterministic replay', () => {
+  it('produces byte-identical SoA buffers from two identically-seeded emitters', () => {
+    const atlas = makeAtlas();
+    const config = createParticleEmitterConfig({
+      spawnRate: 20,
+      maxParticles: 100,
+      lifetimeMin: 0.5,
+      lifetimeMax: 2,
+      speedMin: 50,
+      speedMax: 150,
+      spread: Math.PI,
+      gravityY: 100,
+    });
+
+    const emitterA = createParticleEmitter({ data: { atlas } });
+    const stateA = createParticleEmitterState(createRandomSource(42));
+
+    const emitterB = createParticleEmitter({ data: { atlas } });
+    const stateB = createParticleEmitterState(createRandomSource(42));
+
+    const steps = [0.016, 0.033, 0.016, 0.05, 0.016, 0.016, 0.033, 0.016];
+    for (const dt of steps) {
+      stepParticleEmitter(emitterA, stateA, config, dt);
+      stepParticleEmitter(emitterB, stateB, config, dt);
+    }
+
+    expect(emitterA.data.particleCount).toBeGreaterThan(0);
+    expect(emitterA.data.particleCount).toBe(emitterB.data.particleCount);
+
+    const count = emitterA.data.particleCount;
+    expect(emitterA.data.transforms.subarray(0, count * 4)).toEqual(emitterB.data.transforms.subarray(0, count * 4));
+    expect(emitterA.data.alphas.subarray(0, count)).toEqual(emitterB.data.alphas.subarray(0, count));
+    expect(emitterA.data.colors.subarray(0, count * 3)).toEqual(emitterB.data.colors.subarray(0, count * 3));
+    expect(emitterA.data.velocities.subarray(0, count * 2)).toEqual(emitterB.data.velocities.subarray(0, count * 2));
+    expect(stateA.lifetimes.subarray(0, count * 2)).toEqual(stateB.lifetimes.subarray(0, count * 2));
+    expect(stateA.velocities.subarray(0, count * 2)).toEqual(stateB.velocities.subarray(0, count * 2));
+    expect(stateA.scales.subarray(0, count)).toEqual(stateB.scales.subarray(0, count));
+  });
+});

package/src/emitParticleBurst.test.ts

@@ -0,0 +1,102 @@
+import { createRandomSource } from '@flighthq/math';
+import { createParticleEmitterConfig, createParticleEmitterState } from '@flighthq/particles';
+import type { TextureAtlas } from '@flighthq/types';
+
+import { emitParticleBurst } from './emitParticleBurst';
+import { createParticleEmitter } from './particleEmitter';
+import { updateParticleEmitter } from './updateParticleEmitter';
+
+function makeAtlas(): TextureAtlas {
+  return {
+    image: null,
+    regions: [{ id: 0, x: 0, y: 0, width: 32, height: 32, pivotX: null, pivotY: null }],
+  } as TextureAtlas;
+}
+
+describe('emitParticleBurst', () => {
+  it('spawns the requested count at the given point', () => {
+    const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
+    const state = createParticleEmitterState();
+    const config = createParticleEmitterConfig({ speedMin: 0, speedMax: 0, lifetimeMin: 10, lifetimeMax: 10 });
+    const n = emitParticleBurst(emitter, state, config, 8, 200, 300);
+    expect(n).toBe(8);
+    expect(emitter.data.particleCount).toBe(8);
+    // With zero speed and a point emitter, every particle sits at the burst point.
+    for (let i = 0; i < 8; i++) {
+      expect(emitter.data.transforms[i * 4]).toBeCloseTo(200);
+      expect(emitter.data.transforms[i * 4 + 1]).toBeCloseTo(300);
+    }
+  });
+
+  it('respects maxParticles and returns the actual spawn count', () => {
+    const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
+    const state = createParticleEmitterState();
+    const config = createParticleEmitterConfig({ maxParticles: 5, lifetimeMin: 10, lifetimeMax: 10 });
+    expect(emitParticleBurst(emitter, state, config, 100, 0, 0)).toBe(5);
+    expect(emitter.data.particleCount).toBe(5);
+  });
+
+  it('adds to existing particles rather than replacing them', () => {
+    const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
+    const state = createParticleEmitterState();
+    const config = createParticleEmitterConfig({ maxParticles: 100, lifetimeMin: 10, lifetimeMax: 10 });
+    emitParticleBurst(emitter, state, config, 3, 0, 0);
+    emitParticleBurst(emitter, state, config, 4, 0, 0);
+    expect(emitter.data.particleCount).toBe(7);
+  });
+
+  it("does not touch the emitter's continuous-emission bookkeeping", () => {
+    const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
+    const state = createParticleEmitterState();
+    const config = createParticleEmitterConfig({ lifetimeMin: 10, lifetimeMax: 10 });
+    emitParticleBurst(emitter, state, config, 3, 0, 0);
+    expect(state.spawnAccumulator).toBe(0);
+    expect(state.emitterAge).toBe(0);
+  });
+
+  it('is deterministic with a seeded state', () => {
+    const run = (): number[] => {
+      const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
+      const state = createParticleEmitterState(createRandomSource(99));
+      const config = createParticleEmitterConfig({
+        speedMin: 10,
+        speedMax: 200,
+        spread: Math.PI,
+        lifetimeMin: 1,
+        lifetimeMax: 5,
+      });
+      emitParticleBurst(emitter, state, config, 10, 0, 0);
+      return Array.from(state.velocities.slice(0, 20));
+    };
+    expect(run()).toEqual(run());
+  });
+
+  it('composes into a death sub-emitter via onDeath (explosion on expiry)', () => {
+    // Parent: short-lived particles. Child: a burst spawned where each parent dies.
+    const parent = createParticleEmitter({ data: { atlas: makeAtlas() } });
+    const parentState = createParticleEmitterState();
+    const parentConfig = createParticleEmitterConfig({
+      spawnRate: 5,
+      lifetimeMin: 0.5,
+      lifetimeMax: 0.5,
+      speedMin: 0,
+      speedMax: 0,
+    });
+
+    const child = createParticleEmitter({ data: { atlas: makeAtlas() } });
+    const childState = createParticleEmitterState();
+    const childConfig = createParticleEmitterConfig({ maxParticles: 1000, lifetimeMin: 10, lifetimeMax: 10 });
+
+    let deaths = 0;
+    const onDeath = (x: number, y: number): void => {
+      deaths++;
+      emitParticleBurst(child, childState, childConfig, 6, x, y);
+    };
+
+    // Run long enough for the parent particles to spawn and then expire.
+    for (let i = 0; i < 30; i++) updateParticleEmitter(parent, parentState, parentConfig, 1 / 30, { onDeath });
+
+    expect(deaths).toBeGreaterThan(0);
+    expect(child.data.particleCount).toBe(deaths * 6); // 6 child particles per parent death
+  });
+});