@flighthq/particles 0.1.0 → 0.2.1-next.410.a23f189

package/src/validateParticleEmitterConfig.test.ts

@@ -1,18 +1,6 @@
-import { createParticleEmitter } from '@flighthq/sprite';
-import type { TextureAtlas } from '@flighthq/types';
-
 import { createParticleEmitterConfig } from './particleEmitterConfig';
-import { createParticleEmitterState } from './particleEmitterState';
-import { updateParticleEmitter } from './updateParticleEmitter';
 import { normalizeParticleEmitterConfig, validateParticleEmitterConfig } from './validateParticleEmitterConfig';
 
-function makeAtlas(): TextureAtlas {
-  return {
-    image: null,
-    regions: [{ id: 0, x: 0, y: 0, width: 32, height: 32, pivotX: null, pivotY: null }],
-  } as TextureAtlas;
-}
-
 describe('normalizeParticleEmitterConfig', () => {
   it('leaves a valid config materially unchanged', () => {
     const input = createParticleEmitterConfig({ spawnRate: 25, maxParticles: 500, lifetimeMin: 1, lifetimeMax: 2 });
@@ -65,26 +53,6 @@ describe('normalizeParticleEmitterConfig', () => {
     const issues = validateParticleEmitterConfig(createParticleEmitterConfig({ alphaCurve: [0, NaN, 1] }));
     expect(issues.some((i) => i.field === 'alphaCurve' && i.severity === 'error')).toBe(true);
   });
-
-  it('produces a config that simulates without NaN poisoning', () => {
-    // A pathologically corrupt config that would otherwise inject NaN everywhere.
-    const corrupt = createParticleEmitterConfig({
-      spawnRate: NaN,
-      lifetimeMin: NaN,
-      lifetimeMax: NaN,
-      gravityY: Infinity,
-      speedMin: NaN,
-      speedMax: NaN,
-    });
-    const safe = normalizeParticleEmitterConfig(corrupt);
-    const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
-    const state = createParticleEmitterState();
-    for (let i = 0; i < 30; i++) updateParticleEmitter(emitter, state, safe, 1 / 60);
-    expect(emitter.data.particleCount).toBeGreaterThan(0);
-    for (let i = 0; i < emitter.data.particleCount * 4; i++) {
-      expect(Number.isFinite(emitter.data.transforms[i])).toBe(true);
-    }
-  });
 });
 
 describe('validateParticleEmitterConfig', () => {

package/dist/emitParticleBurst.d.ts

@@ -1,15 +0,0 @@
-import type { ParticleEmitter } from '@flighthq/types';
-import type { ParticleEmitterConfig, ParticleEmitterState } from '@flighthq/types';
-/** Emit `count` particles immediately at an arbitrary point (in the emitter's
- *  simulation space), independent of the emitter's own spawn rate, bursts, or
- *  duration. Returns the number actually spawned (capped by `maxParticles`).
- *
- *  This is the building block for sub-emitters: call it from an `onDeath` /
- *  `onSpawn` callback to spawn a child effect at the event position (explosions,
- *  debris, impact sparks), or once per live particle for trails. The child
- *  emitter/state/config are completely independent of the parent.
- *
- *  Spawn randomness is drawn from `state.random`, so a seeded child state keeps
- *  sub-emitter output deterministic. */
-export declare function emitParticleBurst(emitter: ParticleEmitter, state: ParticleEmitterState, config: Readonly<ParticleEmitterConfig>, count: number, x: number, y: number): number;
-//# sourceMappingURL=emitParticleBurst.d.ts.map

package/dist/emitParticleBurst.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emitParticleBurst.d.ts","sourceRoot":"","sources":["../src/emitParticleBurst.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAQnF;;;;;;;;;;wCAUwC;AACxC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,KAAK,EAAE,MAAM,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,MAAM,CAqGR"}

package/dist/emitParticleBurst.js

@@ -1,114 +0,0 @@
-import { reserveParticleEmitter } from '@flighthq/sprite';
-import { sampleParticleColorCurve, sampleParticleCurve } from './curve';
-import { ensureParticleEmitterStateCapacity } from './particleEmitterState';
-const PARTICLE_TRANSFORM_STRIDE = 4;
-const TWO_PI = Math.PI * 2;
-/** Emit `count` particles immediately at an arbitrary point (in the emitter's
- *  simulation space), independent of the emitter's own spawn rate, bursts, or
- *  duration. Returns the number actually spawned (capped by `maxParticles`).
- *
- *  This is the building block for sub-emitters: call it from an `onDeath` /
- *  `onSpawn` callback to spawn a child effect at the event position (explosions,
- *  debris, impact sparks), or once per live particle for trails. The child
- *  emitter/state/config are completely independent of the parent.
- *
- *  Spawn randomness is drawn from `state.random`, so a seeded child state keeps
- *  sub-emitter output deterministic. */
-export function emitParticleBurst(emitter, state, config, count, x, y) {
-    const data = emitter.data;
-    const liveCount = data.particleCount;
-    let toSpawn = Math.floor(count);
-    const maxNew = config.maxParticles - liveCount;
-    if (toSpawn > maxNew)
-        toSpawn = maxNew;
-    if (toSpawn <= 0)
-        return 0;
-    const hasColorVariance = config.colorStartVarianceR !== 0 ||
-        config.colorStartVarianceG !== 0 ||
-        config.colorStartVarianceB !== 0 ||
-        config.colorEndVarianceR !== 0 ||
-        config.colorEndVarianceG !== 0 ||
-        config.colorEndVarianceB !== 0;
-    const newCount = liveCount + toSpawn;
-    reserveParticleEmitter(emitter, newCount);
-    ensureParticleEmitterStateCapacity(state, newCount, hasColorVariance);
-    const { colorStartR, colorStartG, colorStartB, colorEndR, colorEndG, colorEndB } = config;
-    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 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;
-    const random = state.random;
-    for (let sIdx = 0; sIdx < toSpawn; sIdx++) {
-        const idx = liveCount + sIdx;
-        const lifetime = config.lifetimeMin + random() * (config.lifetimeMax - config.lifetimeMin);
-        const lt = idx * 2;
-        state.lifetimes[lt] = 0;
-        state.lifetimes[lt + 1] = lifetime;
-        const angle = baseAngle + (random() - 0.5) * 2 * config.spread;
-        const speed = config.speedMin + random() * (config.speedMax - config.speedMin);
-        state.velocities[idx * 2] = Math.cos(angle) * speed;
-        state.velocities[idx * 2 + 1] = Math.sin(angle) * speed;
-        // Position = burst point + emitter-shape offset.
-        let spawnX = x;
-        let spawnY = y;
-        if (config.emitterShape === 'circle' && config.emitterRadius > 0) {
-            const r = Math.sqrt(random()) * config.emitterRadius;
-            const a = 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 += (random() - 0.5) * config.emitterWidth;
-            spawnY += (random() - 0.5) * config.emitterHeight;
-        }
-        const spawnScale = config.scaleMin + 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;
-        const ct = idx * 3;
-        if (hasColorCurve) {
-            sampleParticleColorCurve(data.colors, ct, colorCurve, 0);
-        }
-        else if (hasColorVariance) {
-            const r0 = clamp01(colorStartR + (random() - 0.5) * 2 * config.colorStartVarianceR);
-            const g0 = clamp01(colorStartG + (random() - 0.5) * 2 * config.colorStartVarianceG);
-            const b0 = clamp01(colorStartB + (random() - 0.5) * 2 * config.colorStartVarianceB);
-            const r1 = clamp01(colorEndR + (random() - 0.5) * 2 * config.colorEndVarianceR);
-            const g1 = clamp01(colorEndG + (random() - 0.5) * 2 * config.colorEndVarianceG);
-            const b1 = clamp01(colorEndB + (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 ? (random() * regionRange) | 0 : 0);
-        state.rotationSpeeds[idx] = hasRotSpeed ? config.rotationSpeedMin + random() * rotSpeedRange : 0;
-    }
-    data.particleCount = newCount;
-    return toSpawn;
-}
-function clamp01(v) {
-    return v < 0 ? 0 : v > 1 ? 1 : v;
-}
-//# sourceMappingURL=emitParticleBurst.js.map

package/dist/emitParticleBurst.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"emitParticleBurst.js","sourceRoot":"","sources":["../src/emitParticleBurst.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAI1D,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAE5E,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AAE3B;;;;;;;;;;wCAUwC;AACxC,MAAM,UAAU,iBAAiB,CAC/B,OAAwB,EACxB,KAA2B,EAC3B,MAAuC,EACvC,KAAa,EACb,CAAS,EACT,CAAS;IAET,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC;IACrC,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAC/C,IAAI,OAAO,GAAG,MAAM;QAAE,OAAO,GAAG,MAAM,CAAC;IACvC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAE3B,MAAM,gBAAgB,GACpB,MAAM,CAAC,mBAAmB,KAAK,CAAC;QAChC,MAAM,CAAC,mBAAmB,KAAK,CAAC;QAChC,MAAM,CAAC,mBAAmB,KAAK,CAAC;QAChC,MAAM,CAAC,iBAAiB,KAAK,CAAC;QAC9B,MAAM,CAAC,iBAAiB,KAAK,CAAC;QAC9B,MAAM,CAAC,iBAAiB,KAAK,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1C,kCAAkC,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAEtE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC1F,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,aAAa,GAAG,UAAU,IAAI,IAAI,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,UAAU,IAAI,IAAI,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,UAAU,IAAI,IAAI,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACvC,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACxE,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,KAAK,CAAC,IAAI,MAAM,CAAC,gBAAgB,KAAK,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAE5B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,GAAG,IAAI,CAAC;QAE7B,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3F,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACnB,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACxB,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QAEnC,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/E,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACpD,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QAExD,iDAAiD;QACjD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;YACrD,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;YAC5B,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC;YACnG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;YACjD,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;QACpD,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpF,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAE/B,MAAM,EAAE,GAAG,GAAG,GAAG,yBAAyB,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,GAAG,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QACvG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QAE1F,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACnB,IAAI,aAAa,EAAE,CAAC;YAClB,wBAAwB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,gBAAgB,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACpF,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACpF,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACpF,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAChF,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAChF,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAChF,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;YAC1B,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC9B,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC9B,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;YAC1B,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC9B,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/G,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,CAAC;IAED,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/prewarmParticleEmitter.d.ts

@@ -1,5 +0,0 @@
-import type { ParticleEmitter } from '@flighthq/types';
-import type { ParticleEmitterConfig, ParticleEmitterState } from '@flighthq/types';
-import type { ParticleEmitterCallbacks, WorldTransform2D } from './updateParticleEmitter';
-export declare function prewarmParticleEmitter(emitter: ParticleEmitter, state: ParticleEmitterState, config: Readonly<ParticleEmitterConfig>, duration: number, stepDeltaTime?: number, callbacks?: ParticleEmitterCallbacks, worldTransform?: Readonly<WorldTransform2D>): void;
-//# sourceMappingURL=prewarmParticleEmitter.d.ts.map

package/dist/prewarmParticleEmitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prewarmParticleEmitter.d.ts","sourceRoot":"","sources":["../src/prewarmParticleEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG1F,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,aAAa,SAAS,EACtB,SAAS,CAAC,EAAE,wBAAwB,EACpC,cAAc,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAC1C,IAAI,CAUN"}

package/dist/prewarmParticleEmitter.js

@@ -1,13 +0,0 @@
-import { updateParticleEmitter } from './updateParticleEmitter';
-export function prewarmParticleEmitter(emitter, state, config, duration, stepDeltaTime = 1 / 60, callbacks, worldTransform) {
-    // A non-positive step would never advance `elapsed`, spinning forever; fall back
-    // to a single step covering the whole duration instead of hanging.
-    const step = stepDeltaTime > 0 ? stepDeltaTime : duration;
-    let elapsed = 0;
-    while (elapsed < duration) {
-        const deltaTime = Math.min(step, duration - elapsed);
-        updateParticleEmitter(emitter, state, config, deltaTime, callbacks, worldTransform);
-        elapsed += deltaTime;
-    }
-}
-//# sourceMappingURL=prewarmParticleEmitter.js.map

package/dist/prewarmParticleEmitter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prewarmParticleEmitter.js","sourceRoot":"","sources":["../src/prewarmParticleEmitter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,UAAU,sBAAsB,CACpC,OAAwB,EACxB,KAA2B,EAC3B,MAAuC,EACvC,QAAgB,EAChB,aAAa,GAAG,CAAC,GAAG,EAAE,EACtB,SAAoC,EACpC,cAA2C;IAE3C,iFAAiF;IACjF,mEAAmE;IACnE,MAAM,IAAI,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;QACrD,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QACpF,OAAO,IAAI,SAAS,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/stepParticleEmitter.d.ts

@@ -1,38 +0,0 @@
-import type { ParticleCollider, ParticleEmitter, ParticleEmitterCallbacks, ParticleEmitterConfig, ParticleEmitterState, ParticleForce, ParticleObject, ParticleObjectsState, ParticleObjectsUpdateOptions, 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;
-/**
- * Convenience wrapper for the object-pool path that folds the canonical three-step update sequence
- * — `applyParticleObjectForces` → `updateParticleObjects` → `applyParticleObjectCollisions` — into
- * a single call.
- *
- * The three primitives remain exported for advanced use. Use this function for the common case
- * where all forces and colliders apply each frame in the documented order.
- *
- * @param objects - The particle object pool (one display object per slot).
- * @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.
- * @param colliders - Optional colliders to resolve after integration.
- * @param updateOptions - Optional emitter position, callbacks, and other per-frame options.
- */
-export declare function stepParticleObjects(objects: readonly ParticleObject[], state: ParticleObjectsState, config: Readonly<ParticleEmitterConfig>, deltaTime: number, forces?: ReadonlyArray<ParticleForce>, colliders?: ReadonlyArray<ParticleCollider>, updateOptions?: ParticleObjectsUpdateOptions): void;
-//# sourceMappingURL=stepParticleEmitter.d.ts.map

package/dist/stepParticleEmitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stepParticleEmitter.d.ts","sourceRoot":"","sources":["../src/stepParticleEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAOzB;;;;;;;;;;;;;;;;;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;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,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,aAAa,CAAC,EAAE,4BAA4B,GAC3C,IAAI,CAQN"}

package/dist/stepParticleEmitter.js

@@ -1,57 +0,0 @@
-import { applyParticleCollisions, applyParticleObjectCollisions } from './applyParticleCollisions';
-import { applyParticleForces, applyParticleObjectForces } from './applyParticleForces';
-import { updateParticleEmitter } from './updateParticleEmitter';
-import { updateParticleObjects } from './updateParticleObjects';
-/**
- * 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);
-    }
-}
-/**
- * Convenience wrapper for the object-pool path that folds the canonical three-step update sequence
- * — `applyParticleObjectForces` → `updateParticleObjects` → `applyParticleObjectCollisions` — into
- * a single call.
- *
- * The three primitives remain exported for advanced use. Use this function for the common case
- * where all forces and colliders apply each frame in the documented order.
- *
- * @param objects - The particle object pool (one display object per slot).
- * @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.
- * @param colliders - Optional colliders to resolve after integration.
- * @param updateOptions - Optional emitter position, callbacks, and other per-frame options.
- */
-export function stepParticleObjects(objects, state, config, deltaTime, forces, colliders, updateOptions) {
-    if (forces != null && forces.length > 0) {
-        applyParticleObjectForces(objects, state, forces, deltaTime);
-    }
-    updateParticleObjects(objects, state, config, deltaTime, updateOptions);
-    if (colliders != null && colliders.length > 0) {
-        applyParticleObjectCollisions(objects, state, colliders);
-    }
-}
-//# sourceMappingURL=stepParticleEmitter.js.map

package/dist/stepParticleEmitter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stepParticleEmitter.js","sourceRoot":"","sources":["../src/stepParticleEmitter.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,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;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAkC,EAClC,KAA2B,EAC3B,MAAuC,EACvC,SAAiB,EACjB,MAAqC,EACrC,SAA2C,EAC3C,aAA4C;IAE5C,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IACD,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACxE,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,6BAA6B,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/updateParticleEmitter.d.ts

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

@@ -1 +0,0 @@
-{"version":3,"file":"updateParticleEmitter.d.ts","sourceRoot":"","sources":["../src/updateParticleEmitter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAMzB,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"}