sparcoon 0.1.0 → 0.3.0

package/dist/{elements → emitter}/FXEmitter.Internal.d.ts

@@ -1,5 +1,4 @@
-import { FXParticleNormalsMode } from "../instancedParticle/FXParticleNormalsMode";
-import { FXParticleRenderingMode } from "../instancedParticle/FXParticleRenderingMode";
+import type { FXPropertyName, GLTypeInfo } from "../instancedParticle/shared";
 export interface FXEmitterPlayOptions {
     duration: number;
 }
@@ -8,5 +7,6 @@ export declare const EMITTER_DEFAULT_CAPACITY_STEP = 32;
 export declare const EMITTER_DEFAULT_AUTOMATICALLY_DESTROY_MODULES = true;
 export declare const EMITTER_DEFAULT_CAST_SHADOW = false;
 export declare const EMITTER_DEFAULT_RECEIVE_SHADOW = false;
-export declare const EMITTER_DEFAULT_RENDERING_MODE = FXParticleRenderingMode.Unlit;
-export declare const EMITTER_DEFAULT_NORMALS_MODE = FXParticleNormalsMode.Flat;
+export declare function collectProperties(keeper: Record<string, GLTypeInfo>, modules: readonly {
+    requiredProperties?: Record<string, FXPropertyName>;
+}[], debugContext: string): void;

package/dist/emitter/FXEmitter.Internal.js

@@ -0,0 +1,26 @@
+import { resolveGLSLTypeInfo } from '../instancedParticle/shared.js';
+
+const EMITTER_DEFAULT_EXPECTED_CAPACITY = 32;
+const EMITTER_DEFAULT_CAPACITY_STEP = 32;
+const EMITTER_DEFAULT_AUTOMATICALLY_DESTROY_MODULES = true;
+const EMITTER_DEFAULT_CAST_SHADOW = false;
+const EMITTER_DEFAULT_RECEIVE_SHADOW = false;
+function collectProperties(keeper, modules, debugContext) {
+    for (const module of modules) {
+        if (module.requiredProperties === undefined) {
+            continue;
+        }
+        for (const key in module.requiredProperties) {
+            const existingTypeInfo = keeper[key];
+            const newTypeInfo = resolveGLSLTypeInfo(module.requiredProperties[key]);
+            if (existingTypeInfo === undefined) {
+                keeper[key] = newTypeInfo;
+            }
+            else if (existingTypeInfo.glslTypeName !== newTypeInfo.glslTypeName) {
+                throw new Error(`${debugContext}: property conflict for "${key}"`);
+            }
+        }
+    }
+}
+
+export { EMITTER_DEFAULT_AUTOMATICALLY_DESTROY_MODULES, EMITTER_DEFAULT_CAPACITY_STEP, EMITTER_DEFAULT_CAST_SHADOW, EMITTER_DEFAULT_EXPECTED_CAPACITY, EMITTER_DEFAULT_RECEIVE_SHADOW, collectProperties };

package/dist/emitter/FXEmitter.d.ts

@@ -0,0 +1,31 @@
+import { Object3D } from "three";
+import type { FXMaterial } from "../materials/FXMaterial/FXMaterial";
+import type { FXBehavior } from "./behavior/FXBehavior";
+import type { FXEmitterPlayOptions } from "./FXEmitter.Internal";
+import type { FXSpawn } from "./spawn/FXSpawn";
+export interface FXEmitterOptions {
+    expectedCapacity: number;
+    capacityStep: number;
+    automaticallyDestroyModules: boolean;
+    castShadow: boolean;
+    receiveShadow: boolean;
+}
+export declare class FXEmitter extends Object3D {
+    private readonly spawnSequence;
+    private readonly behaviorSequence;
+    automaticallyDestroyModules: boolean;
+    private readonly mesh;
+    private readonly material;
+    private emissionRate;
+    private emissionAccumulator;
+    private emissionDuration;
+    private emissionElapsed;
+    constructor(spawnSequence: FXSpawn[], behaviorSequence: readonly FXBehavior[], material: FXMaterial, options?: Partial<FXEmitterOptions>);
+    static onWillRender: (deltaTime: number) => void;
+    destroy(): void;
+    burst(count: number): void;
+    reset(): void;
+    play(rate: number, options?: Partial<FXEmitterPlayOptions>): void;
+    stop(): void;
+    private readonly onRendering;
+}

package/dist/{elements → emitter}/FXEmitter.js

@@ -1,20 +1,15 @@
-import { Object3D, NormalBlending } from 'three';
+import { Object3D } from 'three';
 import { FXInstancedParticle } from '../instancedParticle/FXInstancedParticle.js';
-import { collectProperties, collectUniforms } from '../instancedParticle/FXInstancedParticle.Internal.js';
-import { buildParticleDepthMaterial } from '../instancedParticle/FXParticleDepthMaterial.js';
-export { FXParticleNormalsMode } from '../instancedParticle/FXParticleNormalsMode.js';
-export { FXParticleRenderingMode } from '../instancedParticle/FXParticleRenderingMode.js';
 import { resolveGLSLTypeInfo } from '../instancedParticle/shared.js';
 import { BUILTIN_OFFSET_AGE, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_POSITION_Z, BUILTIN_OFFSET_VELOCITY_Z, BUILTIN_OFFSET_ROTATION, BUILTIN_OFFSET_TORQUE, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_RANDOM_C } from '../miscellaneous/miscellaneous.js';
-import { EMITTER_DEFAULT_EXPECTED_CAPACITY, EMITTER_DEFAULT_CAPACITY_STEP, EMITTER_DEFAULT_RENDERING_MODE, EMITTER_DEFAULT_NORMALS_MODE, EMITTER_DEFAULT_CAST_SHADOW, EMITTER_DEFAULT_RECEIVE_SHADOW, EMITTER_DEFAULT_AUTOMATICALLY_DESTROY_MODULES } from './FXEmitter.Internal.js';
+import { collectProperties, EMITTER_DEFAULT_EXPECTED_CAPACITY, EMITTER_DEFAULT_CAPACITY_STEP, EMITTER_DEFAULT_CAST_SHADOW, EMITTER_DEFAULT_RECEIVE_SHADOW, EMITTER_DEFAULT_AUTOMATICALLY_DESTROY_MODULES } from './FXEmitter.Internal.js';
 
-const INSTANCES = new Array();
+const EMITTERS = new Array();
 class FXEmitter extends Object3D {
-    constructor(_private_spawnSequence, _private_behaviorSequence, _private_renderingSequence, options = {}) {
+    constructor(_private_spawnSequence, _private_behaviorSequence, material, options = {}) {
         super();
         this._private_spawnSequence = _private_spawnSequence;
         this._private_behaviorSequence = _private_behaviorSequence;
-        this._private_renderingSequence = _private_renderingSequence;
         this._private_emissionRate = 0;
         this._private_emissionAccumulator = 0;
         this._private_emissionDuration = Infinity;
@@ -78,28 +73,27 @@ class FXEmitter extends Object3D {
         const collectedProperties = {
             builtin: resolveGLSLTypeInfo("Matrix4"),
         };
-        collectProperties(collectedProperties, _private_spawnSequence, "FXEmitter.constructor.spawnSequence:");
+        collectProperties(collectedProperties, _private_spawnSequence, "FXEmitter.constructor.spawnSequence");
         collectProperties(collectedProperties, _private_behaviorSequence, "FXEmitter.constructor.behaviorSequence");
-        collectProperties(collectedProperties, _private_renderingSequence, "FXEmitter.constructor.renderingSequence");
-        const collectedUniforms = {};
-        collectUniforms(collectedUniforms, _private_renderingSequence, "FXEmitter.constructor.renderingSequence");
-        this._private_mesh = new FXInstancedParticle(_private_renderingSequence.map((module) => module.source), collectedUniforms, collectedProperties, options.expectedCapacity ?? EMITTER_DEFAULT_EXPECTED_CAPACITY, options.capacityStep ?? EMITTER_DEFAULT_CAPACITY_STEP, options.blending ?? NormalBlending, options.useAlphaHashing ?? false, options.renderingMode ?? EMITTER_DEFAULT_RENDERING_MODE, options.normalsMode ?? EMITTER_DEFAULT_NORMALS_MODE);
+        const threeMaterial = material.buildThreeMaterial(collectedProperties);
+        this._private_mesh = new FXInstancedParticle(collectedProperties, options.expectedCapacity ?? EMITTER_DEFAULT_EXPECTED_CAPACITY, options.capacityStep ?? EMITTER_DEFAULT_CAPACITY_STEP, threeMaterial);
         if (options.castShadow ?? EMITTER_DEFAULT_CAST_SHADOW) {
             this._private_mesh.castShadow = true;
-            this._private_mesh.customDepthMaterial = buildParticleDepthMaterial();
+            this._private_mesh.customDepthMaterial = material.buildDepthMaterial();
         }
         if (options.receiveShadow ?? EMITTER_DEFAULT_RECEIVE_SHADOW) {
             this._private_mesh.receiveShadow = true;
         }
         this.automaticallyDestroyModules =
             options.automaticallyDestroyModules ?? EMITTER_DEFAULT_AUTOMATICALLY_DESTROY_MODULES;
+        this._private_material = material;
         this.add(this._private_mesh);
-        INSTANCES.push(this);
+        EMITTERS.push(this);
     }
     destroy() {
-        const index = INSTANCES.indexOf(this);
+        const index = EMITTERS.indexOf(this);
         if (index !== -1) {
-            INSTANCES.splice(index, 1);
+            EMITTERS.splice(index, 1);
         }
         if (this.automaticallyDestroyModules) {
             for (const module of this._private_spawnSequence) {
@@ -108,9 +102,7 @@ class FXEmitter extends Object3D {
             for (const module of this._private_behaviorSequence) {
                 module.destroy?.();
             }
-            for (const module of this._private_renderingSequence) {
-                module.destroy?.();
-            }
+            this._private_material.destroy();
         }
         this.removeFromParent();
     }
@@ -150,7 +142,7 @@ class FXEmitter extends Object3D {
     }
 }
 FXEmitter.onWillRender = (deltaTime) => {
-    for (const instance of INSTANCES) {
+    for (const instance of EMITTERS) {
         instance._private_onRendering(deltaTime);
     }
 };

package/dist/{behaviorModules/FXBehaviorModule.d.ts → emitter/behavior/FXBehavior.d.ts}

@@ -1,11 +1,11 @@
 import type { InstancedBufferAttribute } from "three";
-import type { FXPropertyName } from "../instancedParticle/shared";
+import type { FXPropertyName } from "../../instancedParticle/shared";
 /**
  * Base class for particle behavior modules.
  *
  * Behavior modules update particle properties each frame.
  */
-export declare abstract class FXBehaviorModule<T extends Record<string, FXPropertyName> = Record<string, FXPropertyName>> {
+export declare abstract class FXBehavior<T extends Record<string, FXPropertyName> = Record<string, FXPropertyName>> {
     abstract readonly requiredProperties: T;
     abstract update(properties: {
         [K in keyof T]: InstancedBufferAttribute;

package/dist/{behaviorModules/FXBehaviorModule.js → emitter/behavior/FXBehavior.js}

@@ -3,7 +3,7 @@
  *
  * Behavior modules update particle properties each frame.
  */
-class FXBehaviorModule {
+class FXBehavior {
 }
 
-export { FXBehaviorModule };
+export { FXBehavior };

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorDirectionalGravity.d.ts

@@ -1,12 +1,12 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import { type FXVector3Config } from "../miscellaneous/miscellaneous";
-import { FXBehaviorModule } from "./FXBehaviorModule";
+import type { Vector3Like } from "../../miscellaneous/math";
+import type { FXVector3Config } from "../../miscellaneous/miscellaneous";
+import { FXBehavior } from "./FXBehavior";
 /**
  * Applies constant acceleration to all particles.
  *
  * Adds the direction vector to particle velocity each frame.
  */
-export declare class FXBehaviorDirectionalGravity extends FXBehaviorModule<{
+export declare class FXBehaviorDirectionalGravity extends FXBehavior<{
     builtin: "Matrix4";
 }> {
     private directionInternal;

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorDirectionalGravity.js

@@ -1,13 +1,13 @@
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXVector3Config, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../miscellaneous/miscellaneous.js';
-import { FXBehaviorModule } from './FXBehaviorModule.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXVector3Config, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../../miscellaneous/miscellaneous.js';
+import { FXBehavior } from './FXBehavior.js';
 
 /**
  * Applies constant acceleration to all particles.
  *
  * Adds the direction vector to particle velocity each frame.
  */
-class FXBehaviorDirectionalGravity extends FXBehaviorModule {
+class FXBehaviorDirectionalGravity extends FXBehavior {
     /**
      * @param direction - Acceleration vector in units/second²
      */

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorPointGravity.d.ts

@@ -1,12 +1,12 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import { type FXRange, type FXRangeConfig, type FXVector3Config } from "../miscellaneous/miscellaneous";
-import { FXBehaviorModule } from "./FXBehaviorModule";
+import type { Vector3Like } from "../../miscellaneous/math";
+import { type FXRange, type FXRangeConfig, type FXVector3Config } from "../../miscellaneous/miscellaneous";
+import { FXBehavior } from "./FXBehavior";
 /**
  * Applies gravity attraction toward a point.
  *
  * Force follows inverse power law: strength / distance^exponent. Particles closer than threshold are unaffected.
  */
-export declare class FXBehaviorPointGravity extends FXBehaviorModule<{
+export declare class FXBehaviorPointGravity extends FXBehavior<{
     builtin: "Matrix4";
 }> {
     private centerInternal;

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorPointGravity.js

@@ -1,14 +1,14 @@
 import { MathUtils } from 'three';
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXVector3Config, resolveFXRangeConfig, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_RANDOM_C, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../miscellaneous/miscellaneous.js';
-import { FXBehaviorModule } from './FXBehaviorModule.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXVector3Config, resolveFXRangeConfig, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_RANDOM_C, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../../miscellaneous/miscellaneous.js';
+import { FXBehavior } from './FXBehavior.js';
 
 /**
  * Applies gravity attraction toward a point.
  *
  * Force follows inverse power law: strength / distance^exponent. Particles closer than threshold are unaffected.
  */
-class FXBehaviorPointGravity extends FXBehaviorModule {
+class FXBehaviorPointGravity extends FXBehavior {
     /**
      * @param center - Gravity center position
      * @param strength - Force multiplier range. Accepts number, tuple, or range object

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorScaleOverLife.d.ts

@@ -1,11 +1,11 @@
-import { type FXAspectConfig, type FXRangeConfig } from "../miscellaneous/miscellaneous";
-import { FXBehaviorModule } from "./FXBehaviorModule";
+import type { FXAspectConfig, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXBehavior } from "./FXBehavior";
 /**
  * Animates particle scale over lifetime.
  *
  * Interpolates between scale anchors based on particle age. Requires at least 2 anchors.
  */
-export declare class FXBehaviorScaleOverLife extends FXBehaviorModule<{
+export declare class FXBehaviorScaleOverLife extends FXBehavior<{
     builtin: "Matrix4";
 }> {
     private readonly scales;

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorScaleOverLife.js

@@ -1,14 +1,14 @@
 import { MathUtils } from 'three';
-import { assertValidNonNegativeNumber, assertValidPositiveNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, resolveAspect, BUILTIN_OFFSET_AGE, BUILTIN_OFFSET_LIFETIME, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_SCALE_X, BUILTIN_OFFSET_SCALE_Y } from '../miscellaneous/miscellaneous.js';
-import { FXBehaviorModule } from './FXBehaviorModule.js';
+import { assertValidNonNegativeNumber, assertValidPositiveNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, resolveAspect, BUILTIN_OFFSET_AGE, BUILTIN_OFFSET_LIFETIME, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_SCALE_X, BUILTIN_OFFSET_SCALE_Y } from '../../miscellaneous/miscellaneous.js';
+import { FXBehavior } from './FXBehavior.js';
 
 /**
  * Animates particle scale over lifetime.
  *
  * Interpolates between scale anchors based on particle age. Requires at least 2 anchors.
  */
-class FXBehaviorScaleOverLife extends FXBehaviorModule {
+class FXBehaviorScaleOverLife extends FXBehavior {
     /**
      * @param scales - Scale anchor points. Each accepts number, tuple, or range object
      * @param aspect - Width/height ratio. Accepts number or texture

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorTorqueDamping.d.ts

@@ -1,11 +1,11 @@
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
-import { FXBehaviorModule } from "./FXBehaviorModule";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXBehavior } from "./FXBehavior";
 /**
  * Reduces particle angular velocity over time.
  *
  * Applies exponential decay to torque. Damping of 0 means no effect, 1 means instant stop.
  */
-export declare class FXBehaviorTorqueDamping extends FXBehaviorModule<{
+export declare class FXBehaviorTorqueDamping extends FXBehavior<{
     builtin: "Matrix4";
 }> {
     private dampingInternal;

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorTorqueDamping.js

@@ -1,14 +1,14 @@
 import { MathUtils } from 'three';
-import { assertValidNonNegativeNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_TORQUE } from '../miscellaneous/miscellaneous.js';
-import { FXBehaviorModule } from './FXBehaviorModule.js';
+import { assertValidNonNegativeNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_TORQUE } from '../../miscellaneous/miscellaneous.js';
+import { FXBehavior } from './FXBehavior.js';
 
 /**
  * Reduces particle angular velocity over time.
  *
  * Applies exponential decay to torque. Damping of 0 means no effect, 1 means instant stop.
  */
-class FXBehaviorTorqueDamping extends FXBehaviorModule {
+class FXBehaviorTorqueDamping extends FXBehavior {
     /**
      * @param damping - Damping coefficient range (0-1). Accepts number, tuple, or range object
      */

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorTorqueNoise.d.ts

@@ -1,11 +1,11 @@
-import type { FXRange, FXRangeConfig } from "../miscellaneous/miscellaneous";
-import { FXBehaviorModule } from "./FXBehaviorModule";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXBehavior } from "./FXBehavior";
 /**
  * Applies noise-based angular acceleration to particles.
  *
  * Uses 2D noise based on particle position. Higher scale means finer noise detail.
  */
-export declare class FXBehaviorTorqueNoise extends FXBehaviorModule<{
+export declare class FXBehaviorTorqueNoise extends FXBehavior<{
     builtin: "Matrix4";
 }> {
     private scaleInternal;

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorTorqueNoise.js

@@ -1,8 +1,8 @@
-import { m as modExports } from '../_virtual/mod.js';
+import { m as modExports } from '../../_virtual/mod.js';
 import { MathUtils } from 'three';
-import { assertValidPositiveNumber, assertValidNonNegativeNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_C, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_TORQUE } from '../miscellaneous/miscellaneous.js';
-import { FXBehaviorModule } from './FXBehaviorModule.js';
+import { assertValidPositiveNumber, assertValidNonNegativeNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_C, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_TORQUE } from '../../miscellaneous/miscellaneous.js';
+import { FXBehavior } from './FXBehavior.js';
 
 const generateNoise3D = modExports.makeNoise3D();
 /**
@@ -10,7 +10,7 @@ const generateNoise3D = modExports.makeNoise3D();
  *
  * Uses 2D noise based on particle position. Higher scale means finer noise detail.
  */
-class FXBehaviorTorqueNoise extends FXBehaviorModule {
+class FXBehaviorTorqueNoise extends FXBehavior {
     /**
      * @param scale - Noise frequency range. Accepts number, tuple, or range object
      * @param strength - Force multiplier range. Accepts number, tuple, or range object

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorVelocityDamping.d.ts

@@ -1,11 +1,11 @@
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
-import { FXBehaviorModule } from "./FXBehaviorModule";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXBehavior } from "./FXBehavior";
 /**
  * Reduces particle velocity over time.
  *
  * Applies exponential decay to velocity. Damping of 0 means no effect, 1 means instant stop.
  */
-export declare class FXBehaviorVelocityDamping extends FXBehaviorModule<{
+export declare class FXBehaviorVelocityDamping extends FXBehavior<{
     builtin: "Matrix4";
 }> {
     private dampingInternal;

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorVelocityDamping.js

@@ -1,14 +1,14 @@
 import { MathUtils } from 'three';
-import { assertValidNonNegativeNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../miscellaneous/miscellaneous.js';
-import { FXBehaviorModule } from './FXBehaviorModule.js';
+import { assertValidNonNegativeNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../../miscellaneous/miscellaneous.js';
+import { FXBehavior } from './FXBehavior.js';
 
 /**
  * Reduces particle velocity over time.
  *
  * Applies exponential decay to velocity. Damping of 0 means no effect, 1 means instant stop.
  */
-class FXBehaviorVelocityDamping extends FXBehaviorModule {
+class FXBehaviorVelocityDamping extends FXBehavior {
     /**
      * @param damping - Damping coefficient range (0-1). Accepts number, tuple, or range object
      */

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorVelocityNoise.d.ts

@@ -1,11 +1,11 @@
-import type { FXRange, FXRangeConfig } from "../miscellaneous/miscellaneous";
-import { FXBehaviorModule } from "./FXBehaviorModule";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXBehavior } from "./FXBehavior";
 /**
  * Applies noise-based acceleration to particles.
  *
  * Uses 2D noise based on particle position. Higher scale means finer noise detail.
  */
-export declare class FXBehaviorVelocityNoise extends FXBehaviorModule<{
+export declare class FXBehaviorVelocityNoise extends FXBehavior<{
     builtin: "Matrix4";
 }> {
     private scaleInternal;

package/dist/{behaviorModules → emitter/behavior}/FXBehaviorVelocityNoise.js

@@ -1,8 +1,8 @@
-import { m as modExports } from '../_virtual/mod.js';
+import { m as modExports } from '../../_virtual/mod.js';
 import { MathUtils } from 'three';
-import { assertValidPositiveNumber, assertValidNonNegativeNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z, BUILTIN_OFFSET_RANDOM_C, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../miscellaneous/miscellaneous.js';
-import { FXBehaviorModule } from './FXBehaviorModule.js';
+import { assertValidPositiveNumber, assertValidNonNegativeNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z, BUILTIN_OFFSET_RANDOM_C, BUILTIN_OFFSET_RANDOM_A, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../../miscellaneous/miscellaneous.js';
+import { FXBehavior } from './FXBehavior.js';
 
 const generateNoise3D0 = modExports.makeNoise3D();
 const generateNoise3D1 = modExports.makeNoise3D();
@@ -12,7 +12,7 @@ const generateNoise3D2 = modExports.makeNoise3D();
  *
  * Uses 2D noise based on particle position. Higher scale means finer noise detail.
  */
-class FXBehaviorVelocityNoise extends FXBehaviorModule {
+class FXBehaviorVelocityNoise extends FXBehavior {
     /**
      * @param scale - Noise frequency range. Accepts number, tuple, or range object
      * @param strength - Force multiplier range. Accepts number, tuple, or range object

package/dist/emitter/spawn/FXSpawn.d.ts

@@ -0,0 +1,9 @@
+import type { FXPropertyName } from "../../instancedParticle/shared";
+/**
+ * Base class for particle spawn modules.
+ *
+ * Spawn modules initialize particle properties when particles are created.
+ */
+export declare abstract class FXSpawn<T extends Record<string, FXPropertyName> = Record<string, FXPropertyName>> {
+    destroy?(): void;
+}

package/dist/{spawnModules/FXSpawnModule.js → emitter/spawn/FXSpawn.js}

@@ -3,7 +3,7 @@
  *
  * Spawn modules initialize particle properties when particles are created.
  */
-class FXSpawnModule {
+class FXSpawn {
 }
 
-export { FXSpawnModule };
+export { FXSpawn };

package/dist/{spawnModules → emitter/spawn}/FXSpawnBox.d.ts

@@ -1,12 +1,12 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import { type FXVector3Config } from "../miscellaneous/miscellaneous";
-import { FXSpawnModule } from "./FXSpawnModule";
+import type { Vector3Like } from "../../miscellaneous/math";
+import type { FXVector3Config } from "../../miscellaneous/miscellaneous";
+import { FXSpawn } from "./FXSpawn";
 /**
  * Spawns particles at random positions within an axis-aligned bounding box.
  *
  * Position is chosen uniformly within the bounds defined by min and max.
  */
-export declare class FXSpawnBox extends FXSpawnModule<{
+export declare class FXSpawnBox extends FXSpawn<{
     builtin: "Matrix4";
 }> {
     private minInternal;

package/dist/{spawnModules → emitter/spawn}/FXSpawnBox.js

@@ -1,14 +1,14 @@
 import { MathUtils } from 'three';
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXVector3Config, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z } from '../miscellaneous/miscellaneous.js';
-import { FXSpawnModule } from './FXSpawnModule.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXVector3Config, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z } from '../../miscellaneous/miscellaneous.js';
+import { FXSpawn } from './FXSpawn.js';
 
 /**
  * Spawns particles at random positions within an axis-aligned bounding box.
  *
  * Position is chosen uniformly within the bounds defined by min and max.
  */
-class FXSpawnBox extends FXSpawnModule {
+class FXSpawnBox extends FXSpawn {
     /**
      * @param min - Minimum corner of the spawn box
      * @param max - Maximum corner of the spawn box

package/dist/{spawnModules/FXSpawnOffset.d.ts → emitter/spawn/FXSpawnPoint.d.ts}

@@ -1,12 +1,12 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import type { FXVector3Config } from "../miscellaneous/miscellaneous";
-import { FXSpawnModule } from "./FXSpawnModule";
+import type { Vector3Like } from "../../miscellaneous/math";
+import type { FXVector3Config } from "../../miscellaneous/miscellaneous";
+import { FXSpawn } from "./FXSpawn";
 /**
  * Sets particle spawn position offset.
  *
  * All particles spawned with this module start at the specified position.
  */
-export declare class FXSpawnOffset extends FXSpawnModule<{
+export declare class FXSpawnPoint extends FXSpawn<{
     builtin: "Matrix4";
 }> {
     private offsetInternal;

package/dist/{spawnModules/FXSpawnOffset.js → emitter/spawn/FXSpawnPoint.js}

@@ -1,13 +1,13 @@
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXVector3Config, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z } from '../miscellaneous/miscellaneous.js';
-import { FXSpawnModule } from './FXSpawnModule.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXVector3Config, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z } from '../../miscellaneous/miscellaneous.js';
+import { FXSpawn } from './FXSpawn.js';
 
 /**
  * Sets particle spawn position offset.
  *
  * All particles spawned with this module start at the specified position.
  */
-class FXSpawnOffset extends FXSpawnModule {
+class FXSpawnPoint extends FXSpawn {
     /**
      * @param offset - Initial particle position offset
      */
@@ -46,4 +46,4 @@ class FXSpawnOffset extends FXSpawnModule {
     }
 }
 
-export { FXSpawnOffset };
+export { FXSpawnPoint };

package/dist/{spawnModules → emitter/spawn}/FXSpawnRandomLifetime.d.ts

@@ -1,11 +1,11 @@
-import type { FXRange, FXRangeConfig } from "../miscellaneous/miscellaneous";
-import { FXSpawnModule } from "./FXSpawnModule";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXSpawn } from "./FXSpawn";
 /**
  * Assigns random lifetime to particles.
  *
  * Lifetime is chosen uniformly from the specified range. Age is set to 0.
  */
-export declare class FXSpawnRandomLifetime extends FXSpawnModule<{
+export declare class FXSpawnRandomLifetime extends FXSpawn<{
     builtin: "Matrix4";
 }> {
     private lifetimeInternal;

package/dist/{spawnModules → emitter/spawn}/FXSpawnRandomLifetime.js

@@ -1,14 +1,14 @@
 import { MathUtils } from 'three';
-import { assertValidPositiveNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_LIFETIME, BUILTIN_OFFSET_AGE } from '../miscellaneous/miscellaneous.js';
-import { FXSpawnModule } from './FXSpawnModule.js';
+import { assertValidPositiveNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_LIFETIME, BUILTIN_OFFSET_AGE } from '../../miscellaneous/miscellaneous.js';
+import { FXSpawn } from './FXSpawn.js';
 
 /**
  * Assigns random lifetime to particles.
  *
  * Lifetime is chosen uniformly from the specified range. Age is set to 0.
  */
-class FXSpawnRandomLifetime extends FXSpawnModule {
+class FXSpawnRandomLifetime extends FXSpawn {
     /**
      * @param lifetime - Lifetime range in seconds. Accepts number, tuple, or range object
      */

package/dist/{spawnModules → emitter/spawn}/FXSpawnRandomRotation.d.ts

@@ -1,11 +1,11 @@
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
-import { FXSpawnModule } from "./FXSpawnModule";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXSpawn } from "./FXSpawn";
 /**
  * Assigns random rotation to particles.
  *
  * Initial rotation is chosen uniformly from the specified range.
  */
-export declare class FXSpawnRandomRotation extends FXSpawnModule<{
+export declare class FXSpawnRandomRotation extends FXSpawn<{
     builtin: "Matrix4";
 }> {
     private rotationInternal;

package/dist/{spawnModules → emitter/spawn}/FXSpawnRandomRotation.js

@@ -1,14 +1,14 @@
 import { MathUtils } from 'three';
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_ROTATION } from '../miscellaneous/miscellaneous.js';
-import { FXSpawnModule } from './FXSpawnModule.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_ROTATION } from '../../miscellaneous/miscellaneous.js';
+import { FXSpawn } from './FXSpawn.js';
 
 /**
  * Assigns random rotation to particles.
  *
  * Initial rotation is chosen uniformly from the specified range.
  */
-class FXSpawnRandomRotation extends FXSpawnModule {
+class FXSpawnRandomRotation extends FXSpawn {
     /**
      * @param rotation - Rotation range in radians. Accepts number, tuple, or range object
      */