@flighthq/particles 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,14 +1,11 @@
 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 './stepParticleObjects';
 export * from './updateParticleObjects';
 export * from './validateParticleEmitterConfig';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -1,14 +1,11 @@
 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 './stepParticleObjects';
 export * from './updateParticleObjects';
 export * from './validateParticleEmitterConfig';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/stepParticleObjects.d.ts

@@ -0,0 +1,19 @@
+import type { ParticleCollider, ParticleEmitterConfig, ParticleForce, ParticleObject, ParticleObjectsState, ParticleObjectsUpdateOptions } from '@flighthq/types';
+/**
+ * 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=stepParticleObjects.d.ts.map

package/dist/stepParticleObjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepParticleObjects.d.ts","sourceRoot":"","sources":["../src/stepParticleObjects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAMzB;;;;;;;;;;;;;;;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/stepParticleObjects.js

@@ -0,0 +1,29 @@
+import { applyParticleObjectCollisions } from './applyParticleCollisions';
+import { applyParticleObjectForces } from './applyParticleForces';
+import { updateParticleObjects } from './updateParticleObjects';
+/**
+ * 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=stepParticleObjects.js.map

package/dist/stepParticleObjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepParticleObjects.js","sourceRoot":"","sources":["../src/stepParticleObjects.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;;;;;;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/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/particles",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/particles"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,14 +32,12 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/geometry": "0.1.0",
-    "@flighthq/math": "0.1.0",
-    "@flighthq/node": "0.1.0",
-    "@flighthq/signals": "0.1.0",
-    "@flighthq/sprite": "0.1.0",
-    "@flighthq/types": "0.1.0"
+    "@flighthq/geometry": "0.2.0",
+    "@flighthq/signals": "0.2.0",
+    "@flighthq/types": "0.2.0"
   },
   "devDependencies": {
+    "@flighthq/math": "*",
     "typescript": "^5.3.0"
   },
   "description": "Particle system: emitter simulation and typed-array-backed particle primitives",

package/src/applyParticleCollisions.test.ts

@@ -1,32 +1,32 @@
-import { createParticleEmitter } from '@flighthq/sprite';
-import type { TextureAtlas } from '@flighthq/types';
+import type { ParticleEmitter, ParticleEmitterData } from '@flighthq/types';
 
 import { applyParticleCollisions, applyParticleObjectCollisions } from './applyParticleCollisions';
-import { createParticleEmitterConfig } from './particleEmitterConfig';
-import { createParticleEmitterState } from './particleEmitterState';
+import { createParticleEmitterState, ensureParticleEmitterStateCapacity } from './particleEmitterState';
 import { createParticleObjectsState } from './particleObjectsState';
-import { updateParticleEmitter } from './updateParticleEmitter';
 import type { ParticleObject } from './updateParticleObjects';
 
-function makeAtlas(): TextureAtlas {
-  return {
-    image: null,
-    regions: [{ id: 0, x: 0, y: 0, width: 32, height: 32, pivotX: null, pivotY: null }],
-  } as TextureAtlas;
+// Node-free SoA emitter fixture: applyParticleCollisions reads only `emitter.data`, so the display
+// node from @flighthq/particleemitter is not needed to unit-test the collision pass.
+function createEmitterFixture(capacity: number): ParticleEmitter {
+  const data: ParticleEmitterData = {
+    alphas: new Float32Array(capacity),
+    atlas: null,
+    colors: new Float32Array(capacity * 3),
+    ids: new Uint16Array(capacity),
+    particleCount: 0,
+    transforms: new Float32Array(capacity * 4),
+    velocities: new Float32Array(capacity * 2),
+    worldSpace: false,
+  };
+  return { data, x: 0, y: 0 } as unknown as ParticleEmitter;
 }
 
-// Spawn one particle, then place it at a known position with a known velocity.
+// One particle at a known position with a known velocity.
 function place(px: number, py: number, vx: number, vy: number) {
-  const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
+  const emitter = createEmitterFixture(1);
   const state = createParticleEmitterState();
-  const config = createParticleEmitterConfig({
-    spawnRate: 1,
-    lifetimeMin: 100,
-    lifetimeMax: 100,
-    speedMin: 0,
-    speedMax: 0,
-  });
-  updateParticleEmitter(emitter, state, config, 1);
+  ensureParticleEmitterStateCapacity(state, 1, false);
+  emitter.data.particleCount = 1;
   emitter.data.transforms[0] = px;
   emitter.data.transforms[1] = py;
   state.velocities[0] = vx;
@@ -55,18 +55,6 @@ describe('applyParticleCollisions', () => {
   });
 
   describe('integration', () => {
-    it('settles a falling particle onto a floor over multiple frames', () => {
-      const { emitter, state } = place(0, 480, 0, 0);
-      const config = createParticleEmitterConfig({ spawnRate: 0, lifetimeMin: 100, lifetimeMax: 100, gravityY: 2000 });
-      const floor = [{ kind: 'PlaneCollider' as const, nx: 0, ny: -1, distance: -500 }];
-      for (let i = 0; i < 60; i++) {
-        updateParticleEmitter(emitter, state, config, 1 / 60);
-        applyParticleCollisions(emitter, state, floor);
-      }
-      expect(emitter.data.transforms[1]).toBeLessThanOrEqual(500 + 1e-3); // never falls through
-      expect(emitter.data.transforms[1]).toBeCloseTo(500, 0); // resting on the floor
-    });
-
     it('is a no-op with no colliders', () => {
       const { emitter, state } = place(0, 520, 0, 100);
       applyParticleCollisions(emitter, state, []);

package/src/applyParticleForces.test.ts

@@ -1,33 +1,35 @@
-import { createParticleEmitter } from '@flighthq/sprite';
-import type { TextureAtlas } from '@flighthq/types';
+import type { ParticleEmitter, ParticleEmitterData } from '@flighthq/types';
 
 import { applyParticleForces, applyParticleObjectForces } from './applyParticleForces';
 import { createParticleEmitterConfig } from './particleEmitterConfig';
-import { createParticleEmitterState } from './particleEmitterState';
+import { createParticleEmitterState, ensureParticleEmitterStateCapacity } from './particleEmitterState';
 import { createParticleObjectsState } from './particleObjectsState';
-import { updateParticleEmitter } from './updateParticleEmitter';
 import type { ParticleObject } from './updateParticleObjects';
 import { updateParticleObjects } from './updateParticleObjects';
 
-function makeAtlas(): TextureAtlas {
-  return {
-    image: null,
-    regions: [{ id: 0, x: 0, y: 0, width: 32, height: 32, pivotX: null, pivotY: null }],
-  } as TextureAtlas;
+// Node-free SoA emitter fixture: applyParticleForces reads only `emitter.data`, so the display
+// node from @flighthq/particleemitter is not needed to unit-test the force pass. Keeping this
+// fixture local preserves particles as a pure sim leaf.
+function createEmitterFixture(capacity: number): ParticleEmitter {
+  const data: ParticleEmitterData = {
+    alphas: new Float32Array(capacity),
+    atlas: null,
+    colors: new Float32Array(capacity * 3),
+    ids: new Uint16Array(capacity),
+    particleCount: 0,
+    transforms: new Float32Array(capacity * 4),
+    velocities: new Float32Array(capacity * 2),
+    worldSpace: false,
+  };
+  return { data, x: 0, y: 0 } as unknown as ParticleEmitter;
 }
 
-// Spawn a single stationary particle at the origin and return its handles.
+// A single stationary particle at the origin with zeroed velocity state.
 function oneParticle() {
-  const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
+  const emitter = createEmitterFixture(1);
   const state = createParticleEmitterState();
-  const config = createParticleEmitterConfig({
-    spawnRate: 1,
-    lifetimeMin: 100,
-    lifetimeMax: 100,
-    speedMin: 0,
-    speedMax: 0,
-  });
-  updateParticleEmitter(emitter, state, config, 1);
+  ensureParticleEmitterStateCapacity(state, 1, false);
+  emitter.data.particleCount = 1;
   return { emitter, state };
 }
 
@@ -117,24 +119,6 @@ describe('applyParticleForces', () => {
     applyParticleForces(emitter, state, [{ kind: 'WindForce', x: 5, y: 0 }], 0);
     expect(state.velocities[0]).toBe(42); // unchanged by either no-op call
   });
-
-  it('integrates with the core update so attractors curve trajectories', () => {
-    const { emitter, state } = oneParticle();
-    const config = createParticleEmitterConfig({
-      spawnRate: 0,
-      speedMin: 0,
-      speedMax: 0,
-      lifetimeMin: 100,
-      lifetimeMax: 100,
-    });
-    const forces = [{ kind: 'AttractorForce' as const, x: 100, y: 0, strength: 200 }];
-    const startX = emitter.data.transforms[0];
-    for (let i = 0; i < 10; i++) {
-      applyParticleForces(emitter, state, forces, 1 / 60);
-      updateParticleEmitter(emitter, state, config, 1 / 60);
-    }
-    expect(emitter.data.transforms[0]).toBeGreaterThan(startX); // drifted toward the attractor
-  });
 });
 
 function makeObject(): ParticleObject {

package/src/curve.test.ts

@@ -1,6 +1,3 @@
-import { createParticleEmitter } from '@flighthq/sprite';
-import type { TextureAtlas } from '@flighthq/types';
-
 import {
   buildParticleColorCurve,
   buildParticleCurve,
@@ -13,16 +10,6 @@ import {
   sampleParticleColorCurve,
   sampleParticleCurve,
 } from './curve';
-import { createParticleEmitterConfig } from './particleEmitterConfig';
-import { createParticleEmitterState } from './particleEmitterState';
-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('buildParticleColorCurve', () => {
   it('bakes an RGB function into an interleaved LUT', () => {
@@ -111,56 +98,6 @@ describe('lerpHsvInPlace', () => {
   });
 });
 
-describe('lifetime curves in updateParticleEmitter', () => {
-  function spawnOne(configOverrides: Parameters<typeof createParticleEmitterConfig>[0]) {
-    const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
-    const state = createParticleEmitterState();
-    const config = createParticleEmitterConfig({
-      spawnRate: 1,
-      lifetimeMin: 1,
-      lifetimeMax: 1,
-      speedMin: 0,
-      speedMax: 0,
-      ...configOverrides,
-    });
-    updateParticleEmitter(emitter, state, config, 1); // spawn one particle
-    return { emitter, state, config };
-  }
-
-  it('alphaCurve drives alpha non-linearly over lifetime', () => {
-    // A curve that is 1 at birth, dips to 0 at mid-life, back to 1 at death.
-    const { emitter, state, config } = spawnOne({ alphaCurve: [1, 0, 1] });
-    updateParticleEmitter(emitter, state, config, 0.5); // → mid-life
-    expect(emitter.data.alphas[0]).toBeCloseTo(0, 2);
-  });
-
-  it('colorCurve overrides the start/end gradient', () => {
-    // green at birth, red at death (interleaved RGB).
-    const { emitter, state, config } = spawnOne({
-      colorCurve: [0, 1, 0, 1, 0, 0],
-      colorStartR: 0.123, // would be used by the linear path; curve must win
-    });
-    updateParticleEmitter(emitter, state, config, 0.5);
-    expect(emitter.data.colors[0]).toBeCloseTo(0.5); // R halfway
-    expect(emitter.data.colors[1]).toBeCloseTo(0.5); // G halfway
-  });
-
-  it('scaleCurve multiplies the spawn scale', () => {
-    const { emitter, state, config } = spawnOne({
-      scaleMin: 2,
-      scaleMax: 2,
-      scaleCurve: [1, 0.5, 0], // shrink to nothing
-    });
-    updateParticleEmitter(emitter, state, config, 0.5); // mid-life → factor 0.5
-    expect(emitter.data.transforms[3]).toBeCloseTo(1, 2); // 2 * 0.5
-  });
-
-  it('sets curve-driven values at spawn time (t=0)', () => {
-    const { emitter } = spawnOne({ alphaCurve: [0.25, 1] });
-    expect(emitter.data.alphas[0]).toBeCloseTo(0.25, 2);
-  });
-});
-
 describe('particleColorCurveFromKeyframes', () => {
   it('bakes an RGB timeline through its middle stop', () => {
     const lut = particleColorCurveFromKeyframes([

package/src/particleEmitterSignals.test.ts

@@ -1,35 +1,9 @@
-import { createParticleEmitter } from '@flighthq/sprite';
-import type { TextureAtlas } from '@flighthq/types';
-
-import { createParticleEmitterConfig } from './particleEmitterConfig';
 import {
   createParticleEmitterSignals,
   enableParticleEmitterSignals,
   getParticleEmitterSignals,
 } from './particleEmitterSignals';
 import { createParticleEmitterState } from './particleEmitterState';
-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 unknown as TextureAtlas;
-}
-
-function spawnOne(configOverrides: Record<string, unknown> = {}) {
-  const emitter = createParticleEmitter({ data: { atlas: makeAtlas() } });
-  const state = createParticleEmitterState();
-  const config = createParticleEmitterConfig({
-    spawnRate: 1,
-    lifetimeMin: 1,
-    lifetimeMax: 1,
-    speedMin: 0,
-    speedMax: 0,
-    ...configOverrides,
-  });
-  return { emitter, state, config };
-}
 
 describe('createParticleEmitterSignals', () => {
   it('creates a signals group with all three signal slots', () => {
@@ -66,60 +40,3 @@ describe('getParticleEmitterSignals', () => {
     expect(getParticleEmitterSignals(state)).toBeNull();
   });
 });
-
-describe('onEmitterComplete signal', () => {
-  it('fires once when a finite non-looping emitter completes', () => {
-    const { emitter, state } = spawnOne({ duration: 0.5, loop: false });
-    const config = createParticleEmitterConfig({
-      duration: 0.5,
-      loop: false,
-      spawnRate: 1,
-      lifetimeMin: 0.1,
-      lifetimeMax: 0.1,
-      speedMin: 0,
-      speedMax: 0,
-    });
-    const signals = enableParticleEmitterSignals(state);
-    const completes: number[] = [];
-    signals.onEmitterComplete.emit = () => completes.push(1);
-    updateParticleEmitter(emitter, state, config, 1); // spawn + age past duration
-    updateParticleEmitter(emitter, state, config, 1); // particles die → complete
-    expect(completes.length).toBeGreaterThan(0);
-  });
-
-  it('does not fire for infinite emitters', () => {
-    const { emitter, state, config } = spawnOne({ duration: 0, loop: true });
-    const signals = enableParticleEmitterSignals(state);
-    const completes: number[] = [];
-    signals.onEmitterComplete.emit = () => completes.push(1);
-    for (let i = 0; i < 10; i++) updateParticleEmitter(emitter, state, config, 1);
-    expect(completes.length).toBe(0);
-  });
-});
-
-describe('onParticleDeath signal', () => {
-  it('fires with the particle position when a particle dies', () => {
-    const { emitter, state, config } = spawnOne();
-    const signals = enableParticleEmitterSignals(state);
-    const deaths: Array<[number, number]> = [];
-    signals.onParticleDeath.emit = (x: number, y: number) => deaths.push([x, y]);
-    updateParticleEmitter(emitter, state, config, 1); // spawn
-    updateParticleEmitter(emitter, state, config, 1.1); // age past lifetime → death
-    expect(deaths.length).toBe(1);
-    expect(Number.isFinite(deaths[0][0])).toBe(true);
-  });
-});
-
-describe('onParticleSpawn signal', () => {
-  it('fires with spawn position and velocity when a particle is spawned', () => {
-    const { emitter, state, config } = spawnOne({ speedMin: 50, speedMax: 50 });
-    const signals = enableParticleEmitterSignals(state);
-    const spawns: Array<[number, number, number, number]> = [];
-    signals.onParticleSpawn.emit = (x: number, y: number, vx: number, vy: number) => spawns.push([x, y, vx, vy]);
-    updateParticleEmitter(emitter, state, config, 1);
-    expect(spawns.length).toBe(1);
-    const [, , vx, vy] = spawns[0];
-    // Speed must match config (allow sign variations by checking magnitude).
-    expect(Math.sqrt(vx * vx + vy * vy)).toBeCloseTo(50, 0);
-  });
-});

package/src/particleEmitterState.test.ts

@@ -1,48 +1,6 @@
-import { createRandomSource } from '@flighthq/math';
-import { createParticleEmitter } from '@flighthq/sprite';
-import type { TextureAtlas } from '@flighthq/types';
-
-import { createParticleEmitterConfig } from './particleEmitterConfig';
 import { createParticleEmitterState, ensureParticleEmitterStateCapacity } from './particleEmitterState';
-import { updateParticleEmitter } from './updateParticleEmitter';
-
-// Runs a short emitter simulation seeded from `seed` and returns the live particle transforms, so a
-// seeded state can be shown to simulate reproducibly (the seeded RNG now lives in @flighthq/math).
-function simulate(seed: number): number[] {
-  const emitter = createParticleEmitter({
-    data: {
-      atlas: {
-        image: null,
-        regions: [{ id: 0, x: 0, y: 0, width: 32, height: 32, pivotX: null, pivotY: null }],
-      } as TextureAtlas,
-    },
-  });
-  const state = createParticleEmitterState(createRandomSource(seed));
-  const config = createParticleEmitterConfig({
-    spawnRate: 20,
-    maxParticles: 100,
-    lifetimeMin: 0.5,
-    lifetimeMax: 1.5,
-    speedMin: 10,
-    speedMax: 200,
-    spread: Math.PI,
-    emitterShape: 'circle',
-    emitterRadius: 25,
-    colorStartVarianceR: 0.5,
-  });
-  for (let f = 0; f < 30; f++) updateParticleEmitter(emitter, state, config, 1 / 60);
-  return Array.from(emitter.data.transforms.slice(0, emitter.data.particleCount * 4));
-}
 
 describe('createParticleEmitterState', () => {
-  it('seeded identically, two states simulate bit-for-bit identically', () => {
-    expect(simulate(42)).toEqual(simulate(42));
-  });
-
-  it('diverges under different seeds', () => {
-    expect(simulate(42)).not.toEqual(simulate(43));
-  });
-
   it('returns empty arrays, zero accumulator, burstTimer=0, and NaN prev position', () => {
     const state = createParticleEmitterState();
     expect(state.lifetimes).toBeInstanceOf(Float32Array);

package/src/stepParticleObjects.test.ts

@@ -0,0 +1,30 @@
+import type { ParticleObject } from '@flighthq/types';
+
+import { createParticleEmitterConfig } from './particleEmitterConfig';
+import { createParticleObjectsState } from './particleObjectsState';
+import { stepParticleObjects } from './stepParticleObjects';
+
+function makeObject(): ParticleObject {
+  return {
+    alpha: 1,
+    blendMode: null,
+    colorTransform: null,
+    rotation: 0,
+    scaleX: 1,
+    scaleY: 1,
+    visible: false,
+    x: 0,
+    y: 0,
+  } as unknown as ParticleObject;
+}
+
+describe('stepParticleObjects', () => {
+  it('spawns into dead slots when called with no forces or colliders', () => {
+    const objects = Array.from({ length: 10 }, makeObject);
+    const state = createParticleObjectsState(10);
+    const config = createParticleEmitterConfig({ spawnRate: 5, lifetimeMin: 10, lifetimeMax: 10 });
+    stepParticleObjects(objects, state, config, 1);
+    const visible = objects.filter((o) => o.visible).length;
+    expect(visible).toBe(5);
+  });
+});

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