sparcoon 0.1.0 → 0.2.0

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

@@ -1,5 +1,3 @@
-import { FXParticleNormalsMode } from "../instancedParticle/FXParticleNormalsMode";
-import { FXParticleRenderingMode } from "../instancedParticle/FXParticleRenderingMode";
 export interface FXEmitterPlayOptions {
     duration: number;
 }
@@ -8,5 +6,3 @@ 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;

package/dist/emitter/FXEmitter.Internal.js

@@ -0,0 +1,7 @@
+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;
+
+export { EMITTER_DEFAULT_AUTOMATICALLY_DESTROY_MODULES, EMITTER_DEFAULT_CAPACITY_STEP, EMITTER_DEFAULT_CAST_SHADOW, EMITTER_DEFAULT_EXPECTED_CAPACITY, EMITTER_DEFAULT_RECEIVE_SHADOW };

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

@@ -1,33 +1,26 @@
-import { Object3D, type Blending } from "three";
-import type { FXBehaviorModule } from "../behaviorModules/FXBehaviorModule";
-import { FXParticleNormalsMode } from "../instancedParticle/FXParticleNormalsMode";
-import { FXParticleRenderingMode } from "../instancedParticle/FXParticleRenderingMode";
-import type { FXRenderingModule } from "../renderingModules/FXRenderingModule";
-import type { FXSpawnModule } from "../spawnModules/FXSpawnModule";
+import { Object3D } from "three";
+import type { FXMaterial } from "../materials/FXMaterial";
+import type { FXBehaviorModule } from "./behavior/FXBehaviorModule";
 import type { FXEmitterPlayOptions } from "./FXEmitter.Internal";
-export { FXParticleNormalsMode, FXParticleRenderingMode };
+import type { FXSpawnModule } from "./spawn/FXSpawnModule";
 export interface FXEmitterOptions {
     expectedCapacity: number;
     capacityStep: number;
     automaticallyDestroyModules: boolean;
-    blending: Blending;
-    useAlphaHashing: boolean;
     castShadow: boolean;
     receiveShadow: boolean;
-    renderingMode: FXParticleRenderingMode;
-    normalsMode: FXParticleNormalsMode;
 }
 export declare class FXEmitter extends Object3D {
     private readonly spawnSequence;
     private readonly behaviorSequence;
-    private readonly renderingSequence;
     automaticallyDestroyModules: boolean;
     private readonly mesh;
+    private readonly material;
     private emissionRate;
     private emissionAccumulator;
     private emissionDuration;
     private emissionElapsed;
-    constructor(spawnSequence: FXSpawnModule[], behaviorSequence: readonly FXBehaviorModule[], renderingSequence: readonly FXRenderingModule[], options?: Partial<FXEmitterOptions>);
+    constructor(spawnSequence: FXSpawnModule[], behaviorSequence: readonly FXBehaviorModule[], material: FXMaterial, options?: Partial<FXEmitterOptions>);
     static onWillRender: (deltaTime: number) => void;
     destroy(): void;
     burst(count: number): void;

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

@@ -1,20 +1,16 @@
-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 { collectProperties } from '../instancedParticle/FXInstancedParticle.Internal.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 { 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 +74,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 +103,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 +143,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 → emitter/behavior}/FXBehaviorDirectionalGravity.d.ts

@@ -1,5 +1,5 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import { type FXVector3Config } from "../miscellaneous/miscellaneous";
+import type { Vector3Like } from "../../miscellaneous/math";
+import { type FXVector3Config } from "../../miscellaneous/miscellaneous";
 import { FXBehaviorModule } from "./FXBehaviorModule";
 /**
  * Applies constant acceleration to all particles.

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

@@ -1,5 +1,5 @@
-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 { 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';
 
 /**

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

@@ -1,5 +1,5 @@
 import type { InstancedBufferAttribute } from "three";
-import type { FXPropertyName } from "../instancedParticle/shared";
+import type { FXPropertyName } from "../../instancedParticle/shared";
 /**
  * Base class for particle behavior modules.
  *

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

@@ -1,5 +1,5 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import { type FXRange, type FXRangeConfig, type FXVector3Config } from "../miscellaneous/miscellaneous";
+import type { Vector3Like } from "../../miscellaneous/math";
+import { type FXRange, type FXRangeConfig, type FXVector3Config } from "../../miscellaneous/miscellaneous";
 import { FXBehaviorModule } from "./FXBehaviorModule";
 /**
  * Applies gravity attraction toward a point.

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

@@ -1,6 +1,6 @@
 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 { 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';
 
 /**

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

@@ -1,4 +1,4 @@
-import { type FXAspectConfig, type FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXAspectConfig, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXBehaviorModule } from "./FXBehaviorModule";
 /**
  * Animates particle scale over lifetime.

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

@@ -1,6 +1,6 @@
 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 { 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';
 
 /**

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

@@ -1,4 +1,4 @@
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXRange, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXBehaviorModule } from "./FXBehaviorModule";
 /**
  * Reduces particle angular velocity over time.

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

@@ -1,6 +1,6 @@
 import { MathUtils } from 'three';
-import { assertValidNonNegativeNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_TORQUE } from '../miscellaneous/miscellaneous.js';
+import { assertValidNonNegativeNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_RANDOM_B, BUILTIN_OFFSET_TORQUE } from '../../miscellaneous/miscellaneous.js';
 import { FXBehaviorModule } from './FXBehaviorModule.js';
 
 /**

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

@@ -1,4 +1,4 @@
-import type { FXRange, FXRangeConfig } from "../miscellaneous/miscellaneous";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXBehaviorModule } from "./FXBehaviorModule";
 /**
  * Applies noise-based angular acceleration to particles.

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

@@ -1,7 +1,7 @@
-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 { 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';
 
 const generateNoise3D = modExports.makeNoise3D();

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

@@ -1,4 +1,4 @@
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXRange, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXBehaviorModule } from "./FXBehaviorModule";
 /**
  * Reduces particle velocity over time.

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

@@ -1,6 +1,6 @@
 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 { 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';
 
 /**

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

@@ -1,4 +1,4 @@
-import type { FXRange, FXRangeConfig } from "../miscellaneous/miscellaneous";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXBehaviorModule } from "./FXBehaviorModule";
 /**
  * Applies noise-based acceleration to particles.

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

@@ -1,7 +1,7 @@
-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 { 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';
 
 const generateNoise3D0 = modExports.makeNoise3D();

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

@@ -1,5 +1,5 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import { type FXVector3Config } from "../miscellaneous/miscellaneous";
+import type { Vector3Like } from "../../miscellaneous/math";
+import { type FXVector3Config } from "../../miscellaneous/miscellaneous";
 import { FXSpawnModule } from "./FXSpawnModule";
 /**
  * Spawns particles at random positions within an axis-aligned bounding box.

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

@@ -1,6 +1,6 @@
 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 { 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';
 
 /**

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

@@ -1,4 +1,4 @@
-import type { FXPropertyName } from "../instancedParticle/shared";
+import type { FXPropertyName } from "../../instancedParticle/shared";
 /**
  * Base class for particle spawn modules.
  *

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

@@ -1,5 +1,5 @@
-import type { Vector3Like } from "../miscellaneous/math";
-import type { FXVector3Config } from "../miscellaneous/miscellaneous";
+import type { Vector3Like } from "../../miscellaneous/math";
+import { type FXVector3Config } from "../../miscellaneous/miscellaneous";
 import { FXSpawnModule } from "./FXSpawnModule";
 /**
  * Sets particle spawn position offset.

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

@@ -1,5 +1,5 @@
-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 { 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';
 
 /**

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

@@ -1,4 +1,4 @@
-import type { FXRange, FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXRange, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXSpawnModule } from "./FXSpawnModule";
 /**
  * Assigns random lifetime to particles.

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

@@ -1,6 +1,6 @@
 import { MathUtils } from 'three';
-import { assertValidPositiveNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_LIFETIME, BUILTIN_OFFSET_AGE } from '../miscellaneous/miscellaneous.js';
+import { assertValidPositiveNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_LIFETIME, BUILTIN_OFFSET_AGE } from '../../miscellaneous/miscellaneous.js';
 import { FXSpawnModule } from './FXSpawnModule.js';
 
 /**

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

@@ -1,4 +1,4 @@
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXRange, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXSpawnModule } from "./FXSpawnModule";
 /**
  * Assigns random rotation to particles.

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

@@ -1,6 +1,6 @@
 import { MathUtils } from 'three';
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_ROTATION } from '../miscellaneous/miscellaneous.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_ROTATION } from '../../miscellaneous/miscellaneous.js';
 import { FXSpawnModule } from './FXSpawnModule.js';
 
 /**

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

@@ -1,4 +1,4 @@
-import { type FXAspectConfig, type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXAspectConfig, type FXRange, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXSpawnModule } from "./FXSpawnModule";
 /**
  * Assigns random scale to particles.

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

@@ -1,6 +1,6 @@
 import { MathUtils } from 'three';
-import { assertValidPositiveNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, resolveAspect, BUILTIN_OFFSET_SCALE_X, BUILTIN_OFFSET_SCALE_Y } from '../miscellaneous/miscellaneous.js';
+import { assertValidPositiveNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, resolveAspect, BUILTIN_OFFSET_SCALE_X, BUILTIN_OFFSET_SCALE_Y } from '../../miscellaneous/miscellaneous.js';
 import { FXSpawnModule } from './FXSpawnModule.js';
 
 /**

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

@@ -1,4 +1,4 @@
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXRange, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXSpawnModule } from "./FXSpawnModule";
 /**
  * Assigns random angular velocity to particles.

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

@@ -1,6 +1,6 @@
 import { MathUtils } from 'three';
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_TORQUE } from '../miscellaneous/miscellaneous.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_TORQUE } from '../../miscellaneous/miscellaneous.js';
 import { FXSpawnModule } from './FXSpawnModule.js';
 
 /**

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

@@ -1,5 +1,5 @@
 import { Vector3 } from "three";
-import { type FXRange, type FXRangeConfig } from "../miscellaneous/miscellaneous";
+import { type FXRange, type FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXSpawnModule } from "./FXSpawnModule";
 export declare class FXSpawnRandomVelocity extends FXSpawnModule<{
     builtin: "Matrix4";

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

@@ -1,6 +1,6 @@
 import { Vector3, MathUtils } from 'three';
-import { assertValidNumber } from '../miscellaneous/asserts.js';
-import { resolveFXRangeConfig, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../miscellaneous/miscellaneous.js';
+import { assertValidNumber } from '../../miscellaneous/asserts.js';
+import { resolveFXRangeConfig, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y, BUILTIN_OFFSET_VELOCITY_Z } from '../../miscellaneous/miscellaneous.js';
 import { FXSpawnModule } from './FXSpawnModule.js';
 
 const TEMP_TANGENT = new Vector3();

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

@@ -0,0 +1,38 @@
+import { FXSpawnModule } from "./FXSpawnModule";
+/**
+ * Spawns particles at random positions within a spherical shell.
+ *
+ * The `angle` parameter controls the polar spread from the equatorial plane:
+ * - `0` - flat disk (XZ plane only)
+ * - `Math.PI / 2` - full sphere
+ * - Values in between produce a spherical band/zone
+ */
+export declare class FXSpawnSphere extends FXSpawnModule<{
+    builtin: "Matrix4";
+}> {
+    private innerRadiusInternal;
+    private outerRadiusInternal;
+    private angleInternal;
+    /**
+     * @param innerRadius - Minimum spawn radius (0 = spawn from center)
+     * @param outerRadius - Maximum spawn radius
+     * @param angle - Polar half-angle from equatorial plane: 0 = disk, Math.PI/2 = full sphere
+     */
+    constructor(innerRadius?: number, outerRadius?: number, angle?: number);
+    /**
+     * Polar half-angle from the equatorial plane.
+     * - `0` — flat disk
+     * - `Math.PI / 2` — full sphere
+     */
+    get angle(): number;
+    /** Minimum spawn radius */
+    get innerRadius(): number;
+    /** Maximum spawn radius */
+    get outerRadius(): number;
+    /** Minimum spawn radius */
+    set innerRadius(value: number);
+    /** Maximum spawn radius */
+    set outerRadius(value: number);
+    /** @see {@link angle} */
+    set angle(value: number);
+}

package/dist/emitter/spawn/FXSpawnSphere.js

@@ -0,0 +1,89 @@
+import { MathUtils } from 'three';
+import { assertValidNonNegativeNumber, assertValidNumber } from '../../miscellaneous/asserts.js';
+import { BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_POSITION_Z } from '../../miscellaneous/miscellaneous.js';
+import { FXSpawnModule } from './FXSpawnModule.js';
+
+/**
+ * Spawns particles at random positions within a spherical shell.
+ *
+ * The `angle` parameter controls the polar spread from the equatorial plane:
+ * - `0` - flat disk (XZ plane only)
+ * - `Math.PI / 2` - full sphere
+ * - Values in between produce a spherical band/zone
+ */
+class FXSpawnSphere extends FXSpawnModule {
+    /**
+     * @param innerRadius - Minimum spawn radius (0 = spawn from center)
+     * @param outerRadius - Maximum spawn radius
+     * @param angle - Polar half-angle from equatorial plane: 0 = disk, Math.PI/2 = full sphere
+     */
+    constructor(innerRadius = 0, outerRadius = 1, angle = Math.PI / 2) {
+        super();
+        /** @internal */
+        this.requiredProperties = { builtin: "Matrix4" };
+        this._private_innerRadiusInternal = innerRadius;
+        this._private_outerRadiusInternal = outerRadius;
+        this._private_angleInternal = angle;
+        assertValidNonNegativeNumber(innerRadius, "FXSpawnSphere.constructor.innerRadius");
+        assertValidNonNegativeNumber(outerRadius, "FXSpawnSphere.constructor.outerRadius");
+        assertValidNumber(angle, "FXSpawnSphere.constructor.angle");
+    }
+    /**
+     * Polar half-angle from the equatorial plane.
+     * - `0` — flat disk
+     * - `Math.PI / 2` — full sphere
+     */
+    get angle() {
+        return this._private_angleInternal;
+    }
+    /** Minimum spawn radius */
+    get innerRadius() {
+        return this._private_innerRadiusInternal;
+    }
+    /** Maximum spawn radius */
+    get outerRadius() {
+        return this._private_outerRadiusInternal;
+    }
+    /** Minimum spawn radius */
+    set innerRadius(value) {
+        assertValidNonNegativeNumber(value, "FXSpawnSphere.innerRadius");
+        this._private_innerRadiusInternal = value;
+    }
+    /** Maximum spawn radius */
+    set outerRadius(value) {
+        assertValidNonNegativeNumber(value, "FXSpawnSphere.outerRadius");
+        this._private_outerRadiusInternal = value;
+    }
+    /** @see {@link angle} */
+    set angle(value) {
+        assertValidNumber(value, "FXSpawnSphere.angle");
+        this._private_angleInternal = value;
+    }
+    /** @internal */
+    spawn(properties, instanceBegin, instanceEnd) {
+        const { builtin } = properties;
+        const { array, itemSize } = builtin;
+        const inner = this._private_innerRadiusInternal;
+        const outer = this._private_outerRadiusInternal;
+        const sinAngle = Math.sin(this._private_angleInternal);
+        // Volume-uniform radius sampling within the shell
+        const inner3 = inner * inner * inner;
+        const outer3 = outer * outer * outer;
+        for (let i = instanceBegin; i < instanceEnd; i++) {
+            // Uniform volume-weighted radius
+            const r = Math.cbrt(MathUtils.randFloat(inner3, outer3));
+            // Uniform sampling on spherical zone:
+            // cosTheta in [-sinAngle, sinAngle] gives latitude range [-angle, +angle]
+            const cosTheta = MathUtils.randFloat(-sinAngle, sinAngle);
+            const sinTheta = Math.sqrt(1 - cosTheta * cosTheta);
+            const phi = MathUtils.randFloat(0, Math.PI * 2);
+            const itemOffset = i * itemSize;
+            array[itemOffset + BUILTIN_OFFSET_POSITION_X] = r * sinTheta * Math.cos(phi);
+            array[itemOffset + BUILTIN_OFFSET_POSITION_Y] = r * cosTheta;
+            array[itemOffset + BUILTIN_OFFSET_POSITION_Z] = r * sinTheta * Math.sin(phi);
+        }
+        builtin.needsUpdate = true;
+    }
+}
+
+export { FXSpawnSphere };

package/dist/index.d.ts

@@ -1,20 +1,24 @@
-export { FXBehaviorDirectionalGravity } from "./behaviorModules/FXBehaviorDirectionalGravity";
-export { FXBehaviorPointGravity } from "./behaviorModules/FXBehaviorPointGravity";
-export { FXBehaviorScaleOverLife } from "./behaviorModules/FXBehaviorScaleOverLife";
-export { FXBehaviorTorqueDamping } from "./behaviorModules/FXBehaviorTorqueDamping";
-export { FXBehaviorTorqueNoise } from "./behaviorModules/FXBehaviorTorqueNoise";
-export { FXBehaviorVelocityDamping } from "./behaviorModules/FXBehaviorVelocityDamping";
-export { FXBehaviorVelocityNoise } from "./behaviorModules/FXBehaviorVelocityNoise";
-export { FXColor } from "./color/FXColor";
-export { FXEmitter, FXParticleNormalsMode, FXParticleRenderingMode } from "./elements/FXEmitter";
-export { FXRenderingAnimatedTexture } from "./renderingModules/FXRenderingAnimatedTexture";
-export { FXRenderingColorOverLife } from "./renderingModules/FXRenderingColorOverLife";
-export { FXRenderingColorOverVelocity } from "./renderingModules/FXRenderingColorOverVelocity";
-export { FXRenderingTexture } from "./renderingModules/FXRenderingTexture";
-export { FXSpawnBox } from "./spawnModules/FXSpawnBox";
-export { FXSpawnOffset } from "./spawnModules/FXSpawnOffset";
-export { FXSpawnRandomLifetime } from "./spawnModules/FXSpawnRandomLifetime";
-export { FXSpawnRandomRotation } from "./spawnModules/FXSpawnRandomRotation";
-export { FXSpawnRandomScale } from "./spawnModules/FXSpawnRandomScale";
-export { FXSpawnRandomTorque } from "./spawnModules/FXSpawnRandomTorque";
-export { FXSpawnRandomVelocity } from "./spawnModules/FXSpawnRandomVelocity";
+export { FXBehaviorDirectionalGravity } from "./emitter/behavior/FXBehaviorDirectionalGravity";
+export { FXBehaviorPointGravity } from "./emitter/behavior/FXBehaviorPointGravity";
+export { FXBehaviorScaleOverLife } from "./emitter/behavior/FXBehaviorScaleOverLife";
+export { FXBehaviorTorqueDamping } from "./emitter/behavior/FXBehaviorTorqueDamping";
+export { FXBehaviorTorqueNoise } from "./emitter/behavior/FXBehaviorTorqueNoise";
+export { FXBehaviorVelocityDamping } from "./emitter/behavior/FXBehaviorVelocityDamping";
+export { FXBehaviorVelocityNoise } from "./emitter/behavior/FXBehaviorVelocityNoise";
+export { FXEmitter } from "./emitter/FXEmitter";
+export { FXSpawnBox } from "./emitter/spawn/FXSpawnBox";
+export { FXSpawnOffset } from "./emitter/spawn/FXSpawnOffset";
+export { FXSpawnRandomLifetime } from "./emitter/spawn/FXSpawnRandomLifetime";
+export { FXSpawnRandomRotation } from "./emitter/spawn/FXSpawnRandomRotation";
+export { FXSpawnRandomScale } from "./emitter/spawn/FXSpawnRandomScale";
+export { FXSpawnRandomTorque } from "./emitter/spawn/FXSpawnRandomTorque";
+export { FXSpawnRandomVelocity } from "./emitter/spawn/FXSpawnRandomVelocity";
+export { FXSpawnSphere } from "./emitter/spawn/FXSpawnSphere";
+export { FXAnimatedTextureNode } from "./materials/color-nodes/FXAnimatedTextureNode";
+export { FXColorNode } from "./materials/color-nodes/FXColorNode";
+export { FXColorOverLifeNode } from "./materials/color-nodes/FXColorOverLifeNode";
+export { FXStaticTextureNode } from "./materials/color-nodes/FXStaticTextureNode";
+export { FXDiffuseMaterial, FXParticleNormalsMode, } from "./materials/FXDiffuseMaterial/FXDiffuseMaterial";
+export { FXMaterial } from "./materials/FXMaterial";
+export { FXUnlitMaterial } from "./materials/FXUnlitMaterial/FXUnlitMaterial";
+export { FXColor } from "./miscellaneous/color/FXColor";