@flighthq/particles 0.1.0

package/dist/emitParticleBurst.d.ts

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

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

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

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from './applyParticleCollisions';
+export * from './applyParticleForces';
+export * from './curve';
+export * from './emitParticleBurst';
+export * from './particleEmitterConfig';
+export * from './particleEmitterSignals';
+export * from './particleEmitterState';
+export * from './particleObjectsState';
+export * from './prewarmParticleEmitter';
+export * from './stepParticleEmitter';
+export * from './updateParticleEmitter';
+export * from './updateParticleObjects';
+export * from './validateParticleEmitterConfig';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from './applyParticleCollisions';
+export * from './applyParticleForces';
+export * from './curve';
+export * from './emitParticleBurst';
+export * from './particleEmitterConfig';
+export * from './particleEmitterSignals';
+export * from './particleEmitterState';
+export * from './particleObjectsState';
+export * from './prewarmParticleEmitter';
+export * from './stepParticleEmitter';
+export * from './updateParticleEmitter';
+export * from './updateParticleObjects';
+export * from './validateParticleEmitterConfig';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/particleEmitterConfig.d.ts

@@ -0,0 +1,4 @@
+import type { ParticleBlendMode, ParticleEmitterConfig, ParticleEmitterShape } from '@flighthq/types';
+export type { ParticleBlendMode, ParticleEmitterConfig, ParticleEmitterShape };
+export declare function createParticleEmitterConfig(config?: Partial<ParticleEmitterConfig>): ParticleEmitterConfig;
+//# sourceMappingURL=particleEmitterConfig.d.ts.map

package/dist/particleEmitterConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleEmitterConfig.d.ts","sourceRoot":"","sources":["../src/particleEmitterConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEtG,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;AAE/E,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAmD1G"}

package/dist/particleEmitterConfig.js

@@ -0,0 +1,53 @@
+export function createParticleEmitterConfig(config) {
+    return {
+        alphaCurve: config?.alphaCurve ?? null,
+        alphaEnd: config?.alphaEnd ?? 0,
+        alphaStart: config?.alphaStart ?? 1,
+        blendMode: config?.blendMode ?? null,
+        burstCount: config?.burstCount ?? 0,
+        burstInterval: config?.burstInterval ?? 0,
+        colorCurve: config?.colorCurve ?? null,
+        colorEndB: config?.colorEndB ?? 1,
+        colorEndG: config?.colorEndG ?? 1,
+        colorEndR: config?.colorEndR ?? 1,
+        colorEndVarianceB: config?.colorEndVarianceB ?? 0,
+        colorEndVarianceG: config?.colorEndVarianceG ?? 0,
+        colorEndVarianceR: config?.colorEndVarianceR ?? 0,
+        colorStartB: config?.colorStartB ?? 1,
+        colorStartG: config?.colorStartG ?? 1,
+        colorStartR: config?.colorStartR ?? 1,
+        colorStartVarianceB: config?.colorStartVarianceB ?? 0,
+        colorStartVarianceG: config?.colorStartVarianceG ?? 0,
+        colorStartVarianceR: config?.colorStartVarianceR ?? 0,
+        directionX: config?.directionX ?? 0,
+        directionY: config?.directionY ?? -1,
+        duration: config?.duration ?? 0,
+        emitterHeight: config?.emitterHeight ?? 0,
+        emitterRadius: config?.emitterRadius ?? 0,
+        emitterShape: config?.emitterShape ?? 'point',
+        emitterWidth: config?.emitterWidth ?? 0,
+        frameCount: config?.frameCount ?? 1,
+        frameRate: config?.frameRate ?? 12,
+        gravityX: config?.gravityX ?? 0,
+        gravityY: config?.gravityY ?? 0,
+        lifetimeMax: config?.lifetimeMax ?? 1,
+        lifetimeMin: config?.lifetimeMin ?? 0.5,
+        loop: config?.loop ?? true,
+        maxParticles: config?.maxParticles ?? 1000,
+        regionIdMax: config?.regionIdMax ?? 1,
+        regionIdMin: config?.regionIdMin ?? 0,
+        rotationSpeedMax: config?.rotationSpeedMax ?? 0,
+        rotationSpeedMin: config?.rotationSpeedMin ?? 0,
+        scaleCurve: config?.scaleCurve ?? null,
+        scaleEnd: config?.scaleEnd ?? 1,
+        scaleMax: config?.scaleMax ?? 1,
+        scaleMin: config?.scaleMin ?? 1,
+        spawnRate: config?.spawnRate ?? 10,
+        speedMax: config?.speedMax ?? 100,
+        speedMin: config?.speedMin ?? 50,
+        spread: config?.spread ?? Math.PI,
+        velocityInheritance: config?.velocityInheritance ?? 0,
+        worldSpace: config?.worldSpace ?? false,
+    };
+}
+//# sourceMappingURL=particleEmitterConfig.js.map

package/dist/particleEmitterConfig.js.map

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

package/dist/particleEmitterSignals.d.ts

@@ -0,0 +1,20 @@
+import type { ParticleEmitterSignals } from '@flighthq/types';
+export type { ParticleEmitterSignals };
+/** Create a fresh {@link ParticleEmitterSignals} group. Called by
+ *  {@link enableParticleEmitterSignals} on first use; exported for unit testing. */
+export declare function createParticleEmitterSignals(): ParticleEmitterSignals;
+/** Opt-in signals for a typed-array particle emitter.
+ *
+ *  Returns the {@link ParticleEmitterSignals} group attached to `state`, creating it on
+ *  first call. The cost of signals is zero until this function is called — keeping it
+ *  opt-in honors the `enable*` convention and avoids allocation for emitters that do not
+ *  need loose multi-listener notification.
+ *
+ *  Connect to the returned signals; they are fired by the simulation functions
+ *  (`updateParticleEmitter`, `stepParticleEmitter`) when the state carries signals.
+ *  Use `getParticleEmitterSignals` to read without creating. */
+export declare function enableParticleEmitterSignals(state: object): ParticleEmitterSignals;
+/** Return the {@link ParticleEmitterSignals} attached to `state`, or `null` if signals
+ *  have not been enabled for this emitter. */
+export declare function getParticleEmitterSignals(state: object): ParticleEmitterSignals | null;
+//# sourceMappingURL=particleEmitterSignals.d.ts.map

package/dist/particleEmitterSignals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleEmitterSignals.d.ts","sourceRoot":"","sources":["../src/particleEmitterSignals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAEvC;oFACoF;AACpF,wBAAgB,4BAA4B,IAAI,sBAAsB,CAMrE;AAED;;;;;;;;;gEASgE;AAChE,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAGlF;AAED;8CAC8C;AAC9C,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAEtF"}

package/dist/particleEmitterSignals.js

@@ -0,0 +1,33 @@
+import { createSignal } from '@flighthq/signals';
+/** Create a fresh {@link ParticleEmitterSignals} group. Called by
+ *  {@link enableParticleEmitterSignals} on first use; exported for unit testing. */
+export function createParticleEmitterSignals() {
+    return {
+        onEmitterComplete: createSignal(),
+        onParticleDeath: createSignal(),
+        onParticleSpawn: createSignal(),
+    };
+}
+/** Opt-in signals for a typed-array particle emitter.
+ *
+ *  Returns the {@link ParticleEmitterSignals} group attached to `state`, creating it on
+ *  first call. The cost of signals is zero until this function is called — keeping it
+ *  opt-in honors the `enable*` convention and avoids allocation for emitters that do not
+ *  need loose multi-listener notification.
+ *
+ *  Connect to the returned signals; they are fired by the simulation functions
+ *  (`updateParticleEmitter`, `stepParticleEmitter`) when the state carries signals.
+ *  Use `getParticleEmitterSignals` to read without creating. */
+export function enableParticleEmitterSignals(state) {
+    const s = state;
+    return (s[signalsSlot] ??= createParticleEmitterSignals());
+}
+/** Return the {@link ParticleEmitterSignals} attached to `state`, or `null` if signals
+ *  have not been enabled for this emitter. */
+export function getParticleEmitterSignals(state) {
+    return state[signalsSlot] ?? null;
+}
+// Per-emitter state slot for signal storage. Keyed by a module-level symbol so
+// there is no collision with other packages that might attach state to the same object.
+const signalsSlot = Symbol('particleEmitterSignals');
+//# sourceMappingURL=particleEmitterSignals.js.map

package/dist/particleEmitterSignals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleEmitterSignals.js","sourceRoot":"","sources":["../src/particleEmitterSignals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD;oFACoF;AACpF,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,iBAAiB,EAAE,YAAY,EAAE;QACjC,eAAe,EAAE,YAAY,EAAE;QAC/B,eAAe,EAAE,YAAY,EAAE;KAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;;gEASgE;AAChE,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,MAAM,CAAC,GAAG,KAA2D,CAAC;IACtE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,4BAA4B,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;8CAC8C;AAC9C,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAQ,KAA4D,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;AAC5F,CAAC;AAED,+EAA+E;AAC/E,wFAAwF;AACxF,MAAM,WAAW,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/particleEmitterState.d.ts

@@ -0,0 +1,7 @@
+import type { ParticleEmitterState, RandomSource } from '@flighthq/types';
+export declare function createParticleEmitterState(random?: RandomSource): ParticleEmitterState;
+/** Grow the per-particle state arrays to hold at least `capacity` particles.
+ *  No-op when already large enough. `colorBirth`/`colorDeath` are only grown when
+ *  the emitter uses color variance (they stay empty otherwise). */
+export declare function ensureParticleEmitterStateCapacity(state: ParticleEmitterState, capacity: number, hasColorVariance: boolean): void;
+//# sourceMappingURL=particleEmitterState.d.ts.map

package/dist/particleEmitterState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleEmitterState.d.ts","sourceRoot":"","sources":["../src/particleEmitterState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1E,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,YAA0B,GAAG,oBAAoB,CAenG;AAED;;mEAEmE;AACnE,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,OAAO,GACxB,IAAI,CAgBN"}

package/dist/particleEmitterState.js

@@ -0,0 +1,38 @@
+import { reserveFloat32Array } from '@flighthq/geometry';
+export function createParticleEmitterState(random = Math.random) {
+    return {
+        burstTimer: 0,
+        colorBirth: new Float32Array(),
+        colorDeath: new Float32Array(),
+        emitterAge: 0,
+        lifetimes: new Float32Array(),
+        prevX: NaN,
+        prevY: NaN,
+        random,
+        rotationSpeeds: new Float32Array(),
+        scales: new Float32Array(),
+        spawnAccumulator: 0,
+        velocities: new Float32Array(),
+    };
+}
+/** Grow the per-particle state arrays to hold at least `capacity` particles.
+ *  No-op when already large enough. `colorBirth`/`colorDeath` are only grown when
+ *  the emitter uses color variance (they stay empty otherwise). */
+export function ensureParticleEmitterStateCapacity(state, capacity, hasColorVariance) {
+    if (state.lifetimes.length >= capacity * 2) {
+        if (hasColorVariance && state.colorBirth.length < capacity * 3) {
+            state.colorBirth = reserveFloat32Array(state.colorBirth, capacity * 3);
+            state.colorDeath = reserveFloat32Array(state.colorDeath, capacity * 3);
+        }
+        return;
+    }
+    state.lifetimes = reserveFloat32Array(state.lifetimes, capacity * 2);
+    state.velocities = reserveFloat32Array(state.velocities, capacity * 2);
+    state.scales = reserveFloat32Array(state.scales, capacity);
+    state.rotationSpeeds = reserveFloat32Array(state.rotationSpeeds, capacity);
+    if (hasColorVariance) {
+        state.colorBirth = reserveFloat32Array(state.colorBirth, capacity * 3);
+        state.colorDeath = reserveFloat32Array(state.colorDeath, capacity * 3);
+    }
+}
+//# sourceMappingURL=particleEmitterState.js.map

package/dist/particleEmitterState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleEmitterState.js","sourceRoot":"","sources":["../src/particleEmitterState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,UAAU,0BAA0B,CAAC,SAAuB,IAAI,CAAC,MAAM;IAC3E,OAAO;QACL,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,IAAI,YAAY,EAAE;QAC9B,UAAU,EAAE,IAAI,YAAY,EAAE;QAC9B,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,IAAI,YAAY,EAAE;QAC7B,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,GAAG;QACV,MAAM;QACN,cAAc,EAAE,IAAI,YAAY,EAAE;QAClC,MAAM,EAAE,IAAI,YAAY,EAAE;QAC1B,gBAAgB,EAAE,CAAC;QACnB,UAAU,EAAE,IAAI,YAAY,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;mEAEmE;AACnE,MAAM,UAAU,kCAAkC,CAChD,KAA2B,EAC3B,QAAgB,EAChB,gBAAyB;IAEzB,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,gBAAgB,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;YACvE,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,OAAO;IACT,CAAC;IACD,KAAK,CAAC,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACvE,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,KAAK,CAAC,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC3E,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;QACvE,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/particleObjectsState.d.ts

@@ -0,0 +1,4 @@
+import type { ParticleObjectsState, RandomSource } from '@flighthq/types';
+export declare function createParticleObjectsState(capacity: number, random?: RandomSource): ParticleObjectsState;
+export declare function ensureParticleObjectsStateCapacity(state: ParticleObjectsState, capacity: number): void;
+//# sourceMappingURL=particleObjectsState.d.ts.map

package/dist/particleObjectsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleObjectsState.d.ts","sourceRoot":"","sources":["../src/particleObjectsState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1E,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,YAA0B,GAAG,oBAAoB,CAarH;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMtG"}

package/dist/particleObjectsState.js

@@ -0,0 +1,24 @@
+import { reserveFloat32Array } from '@flighthq/geometry';
+export function createParticleObjectsState(capacity, random = Math.random) {
+    return {
+        burstTimer: 0,
+        emitterAge: 0,
+        lifetimes: new Float32Array(capacity * 2),
+        prevX: NaN,
+        prevY: NaN,
+        random,
+        rotationSpeeds: new Float32Array(capacity),
+        scales: new Float32Array(capacity),
+        spawnAccumulator: 0,
+        velocities: new Float32Array(capacity * 2),
+    };
+}
+export function ensureParticleObjectsStateCapacity(state, capacity) {
+    if (state.lifetimes.length >= capacity * 2)
+        return;
+    state.lifetimes = reserveFloat32Array(state.lifetimes, capacity * 2);
+    state.velocities = reserveFloat32Array(state.velocities, capacity * 2);
+    state.scales = reserveFloat32Array(state.scales, capacity);
+    state.rotationSpeeds = reserveFloat32Array(state.rotationSpeeds, capacity);
+}
+//# sourceMappingURL=particleObjectsState.js.map

package/dist/particleObjectsState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleObjectsState.js","sourceRoot":"","sources":["../src/particleObjectsState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,UAAU,0BAA0B,CAAC,QAAgB,EAAE,SAAuB,IAAI,CAAC,MAAM;IAC7F,OAAO;QACL,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,IAAI,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC;QACzC,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,GAAG;QACV,MAAM;QACN,cAAc,EAAE,IAAI,YAAY,CAAC,QAAQ,CAAC;QAC1C,MAAM,EAAE,IAAI,YAAY,CAAC,QAAQ,CAAC;QAClC,gBAAgB,EAAE,CAAC;QACnB,UAAU,EAAE,IAAI,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAA2B,EAAE,QAAgB;IAC9F,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO;IACnD,KAAK,CAAC,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACvE,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,KAAK,CAAC,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC"}

package/dist/prewarmParticleEmitter.d.ts

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

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

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

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

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

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

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

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

@@ -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":"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"}