sparcoon 0.5.0 → 0.6.0

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

@@ -1,16 +1,14 @@
 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.
+ * Assigns a random initial rotation to each spawned particle
  */
-export declare class FXSpawnRandomRotation extends FXSpawn<{
+export declare class FXSpawnRotation extends FXSpawn<{
     builtin: "Matrix4";
 }> {
     private rotationInternal;
     /**
-     * @param rotation - Rotation range in radians. Accepts number, tuple, or range object
+     * @param rotation - Rotation range in radians. Defaults to `{ min: -Math.PI, max: Math.PI }`
      */
     constructor(rotation?: FXRangeConfig);
     /** Rotation range in radians */

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

@@ -4,21 +4,19 @@ import { resolveFXRangeConfig, BUILTIN_OFFSET_ROTATION } from '../../miscellaneo
 import { FXSpawn } from './FXSpawn.js';
 
 /**
- * Assigns random rotation to particles.
- *
- * Initial rotation is chosen uniformly from the specified range.
+ * Assigns a random initial rotation to each spawned particle
  */
-class FXSpawnRandomRotation extends FXSpawn {
+class FXSpawnRotation extends FXSpawn {
     /**
-     * @param rotation - Rotation range in radians. Accepts number, tuple, or range object
+     * @param rotation - Rotation range in radians. Defaults to `{ min: -Math.PI, max: Math.PI }`
      */
     constructor(rotation = { min: -Math.PI, max: Math.PI }) {
         super();
         /** @internal */
         this.requiredProperties = { builtin: "Matrix4" };
         this._private_rotationInternal = resolveFXRangeConfig(rotation);
-        assertValidNumber(this._private_rotationInternal.min, "FXSpawnRandomRotation.constructor.rotation.min");
-        assertValidNumber(this._private_rotationInternal.max, "FXSpawnRandomRotation.constructor.rotation.max");
+        assertValidNumber(this._private_rotationInternal.min, "FXSpawnRotation.constructor.rotation.min");
+        assertValidNumber(this._private_rotationInternal.max, "FXSpawnRotation.constructor.rotation.max");
     }
     /** Rotation range in radians */
     get rotation() {
@@ -27,8 +25,8 @@ class FXSpawnRandomRotation extends FXSpawn {
     /** Rotation range in radians */
     set rotation(value) {
         this._private_rotationInternal = resolveFXRangeConfig(value);
-        assertValidNumber(this._private_rotationInternal.min, "FXSpawnRandomRotation.rotation.min");
-        assertValidNumber(this._private_rotationInternal.max, "FXSpawnRandomRotation.rotation.max");
+        assertValidNumber(this._private_rotationInternal.min, "FXSpawnRotation.rotation.min");
+        assertValidNumber(this._private_rotationInternal.max, "FXSpawnRotation.rotation.max");
     }
     /** @internal */
     spawn(properties, instanceBegin, instanceEnd) {
@@ -42,4 +40,4 @@ class FXSpawnRandomRotation extends FXSpawn {
     }
 }
 
-export { FXSpawnRandomRotation };
+export { FXSpawnRotation };

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

@@ -1,18 +1,16 @@
 import type { FXAspectConfig, FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXSpawn } from "./FXSpawn";
 /**
- * Assigns random scale to particles.
- *
- * Base scale is chosen uniformly from the range. Aspect ratio is applied to X scale.
+ * Assigns a random initial scale to each spawned particle
  */
-export declare class FXSpawnRandomScale extends FXSpawn<{
+export declare class FXSpawnScale extends FXSpawn<{
     builtin: "Matrix4";
 }> {
     private scaleInternal;
     private aspectInternal;
     /**
-     * @param scale - Base scale range. Accepts number, tuple, or range object
-     * @param aspect - Width/height ratio. Accepts number or texture
+     * @param scale - Base scale range; must be positive. Defaults to `{ min: 1, max: 2 }`
+     * @param aspect - Width/height ratio; must be positive. Defaults to `1`
      */
     constructor(scale?: FXRangeConfig, aspect?: FXAspectConfig);
     /** Base scale range */

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

@@ -4,24 +4,22 @@ import { resolveFXRangeConfig, resolveAspect, BUILTIN_OFFSET_SCALE_X, BUILTIN_OF
 import { FXSpawn } from './FXSpawn.js';
 
 /**
- * Assigns random scale to particles.
- *
- * Base scale is chosen uniformly from the range. Aspect ratio is applied to X scale.
+ * Assigns a random initial scale to each spawned particle
  */
-class FXSpawnRandomScale extends FXSpawn {
+class FXSpawnScale extends FXSpawn {
     /**
-     * @param scale - Base scale range. Accepts number, tuple, or range object
-     * @param aspect - Width/height ratio. Accepts number or texture
+     * @param scale - Base scale range; must be positive. Defaults to `{ min: 1, max: 2 }`
+     * @param aspect - Width/height ratio; must be positive. Defaults to `1`
      */
-    constructor(scale = { min: 50, max: 100 }, aspect = 1) {
+    constructor(scale = { min: 1, max: 2 }, aspect = 1) {
         super();
         /** @internal */
         this.requiredProperties = { builtin: "Matrix4" };
         this._private_scaleInternal = resolveFXRangeConfig(scale);
         this._private_aspectInternal = resolveAspect(aspect);
-        assertValidPositiveNumber(this._private_scaleInternal.min, "FXSpawnRandomScale.constructor.scale.min");
-        assertValidPositiveNumber(this._private_scaleInternal.max, "FXSpawnRandomScale.constructor.scale.max");
-        assertValidPositiveNumber(this._private_aspectInternal, "FXSpawnRandomScale.constructor.aspect");
+        assertValidPositiveNumber(this._private_scaleInternal.min, "FXSpawnScale.constructor.scale.min");
+        assertValidPositiveNumber(this._private_scaleInternal.max, "FXSpawnScale.constructor.scale.max");
+        assertValidPositiveNumber(this._private_aspectInternal, "FXSpawnScale.constructor.aspect");
     }
     /** Base scale range */
     get scale() {
@@ -34,13 +32,13 @@ class FXSpawnRandomScale extends FXSpawn {
     /** Base scale range */
     set scale(value) {
         this._private_scaleInternal = resolveFXRangeConfig(value);
-        assertValidPositiveNumber(this._private_scaleInternal.min, "FXSpawnRandomScale.scale.min");
-        assertValidPositiveNumber(this._private_scaleInternal.max, "FXSpawnRandomScale.scale.max");
+        assertValidPositiveNumber(this._private_scaleInternal.min, "FXSpawnScale.scale.min");
+        assertValidPositiveNumber(this._private_scaleInternal.max, "FXSpawnScale.scale.max");
     }
     /** Width/height aspect ratio */
     set aspect(value) {
         this._private_aspectInternal = resolveAspect(value);
-        assertValidPositiveNumber(this._private_aspectInternal, "FXSpawnRandomScale.aspect");
+        assertValidPositiveNumber(this._private_aspectInternal, "FXSpawnScale.aspect");
     }
     /** @internal */
     spawn(properties, instanceBegin, instanceEnd) {
@@ -57,4 +55,4 @@ class FXSpawnRandomScale extends FXSpawn {
     }
 }
 
-export { FXSpawnRandomScale };
+export { FXSpawnScale };

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

@@ -1,11 +1,12 @@
 import { FXSpawn } from "./FXSpawn";
 /**
- * Spawns particles at random positions within a spherical shell.
+ * Spawns particles at random positions within a spherical shell
  *
+ * @remarks
  * 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
+ * - Values in between produce a spherical band
  */
 export declare class FXSpawnSphere extends FXSpawn<{
     builtin: "Matrix4";
@@ -14,9 +15,9 @@ export declare class FXSpawnSphere extends FXSpawn<{
     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
+     * @param innerRadius - Minimum spawn radius; must be non-negative. Defaults to `0`
+     * @param outerRadius - Maximum spawn radius; must be non-negative. Defaults to `1`
+     * @param angle - Polar half-angle from equatorial plane in radians. Defaults to `Math.PI / 2`
      */
     constructor(innerRadius?: number, outerRadius?: number, angle?: number);
     /**
@@ -33,6 +34,10 @@ export declare class FXSpawnSphere extends FXSpawn<{
     set innerRadius(value: number);
     /** Maximum spawn radius */
     set outerRadius(value: number);
-    /** @see {@link angle} */
+    /**
+     * Polar half-angle from the equatorial plane.
+     * - `0` - flat disk
+     * - `Math.PI / 2` - full sphere
+     */
     set angle(value: number);
 }

package/dist/emitter/spawn/FXSpawnSphere.js

@@ -4,18 +4,19 @@ import { BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y, BUILTIN_OFFSET_PO
 import { FXSpawn } from './FXSpawn.js';
 
 /**
- * Spawns particles at random positions within a spherical shell.
+ * Spawns particles at random positions within a spherical shell
  *
+ * @remarks
  * 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
+ * - Values in between produce a spherical band
  */
 class FXSpawnSphere extends FXSpawn {
     /**
-     * @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
+     * @param innerRadius - Minimum spawn radius; must be non-negative. Defaults to `0`
+     * @param outerRadius - Maximum spawn radius; must be non-negative. Defaults to `1`
+     * @param angle - Polar half-angle from equatorial plane in radians. Defaults to `Math.PI / 2`
      */
     constructor(innerRadius = 0, outerRadius = 1, angle = Math.PI / 2) {
         super();
@@ -54,7 +55,11 @@ class FXSpawnSphere extends FXSpawn {
         assertValidNonNegativeNumber(value, "FXSpawnSphere.outerRadius");
         this._private_outerRadiusInternal = value;
     }
-    /** @see {@link angle} */
+    /**
+     * Polar half-angle from the equatorial plane.
+     * - `0` - flat disk
+     * - `Math.PI / 2` - full sphere
+     */
     set angle(value) {
         assertValidNumber(value, "FXSpawnSphere.angle");
         this._private_angleInternal = value;

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

@@ -1,16 +1,14 @@
 import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
 import { FXSpawn } from "./FXSpawn";
 /**
- * Assigns random angular velocity to particles.
- *
- * Torque (rotation speed) is chosen uniformly from the specified range.
+ * Assigns a random initial angular velocity to each spawned particle
  */
-export declare class FXSpawnRandomTorque extends FXSpawn<{
+export declare class FXSpawnTorque extends FXSpawn<{
     builtin: "Matrix4";
 }> {
     private torqueInternal;
     /**
-     * @param torque - Angular velocity range in radians/second. Accepts number, tuple, or range object
+     * @param torque - Angular velocity range in radians/second. Defaults to `{ min: -Math.PI, max: Math.PI }`
      */
     constructor(torque?: FXRangeConfig);
     /** Angular velocity range in radians/second */

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

@@ -4,21 +4,19 @@ import { resolveFXRangeConfig, BUILTIN_OFFSET_TORQUE } from '../../miscellaneous
 import { FXSpawn } from './FXSpawn.js';
 
 /**
- * Assigns random angular velocity to particles.
- *
- * Torque (rotation speed) is chosen uniformly from the specified range.
+ * Assigns a random initial angular velocity to each spawned particle
  */
-class FXSpawnRandomTorque extends FXSpawn {
+class FXSpawnTorque extends FXSpawn {
     /**
-     * @param torque - Angular velocity range in radians/second. Accepts number, tuple, or range object
+     * @param torque - Angular velocity range in radians/second. Defaults to `{ min: -Math.PI, max: Math.PI }`
      */
     constructor(torque = { min: -Math.PI, max: Math.PI }) {
         super();
         /** @internal */
         this.requiredProperties = { builtin: "Matrix4" };
         this._private_torqueInternal = resolveFXRangeConfig(torque);
-        assertValidNumber(this._private_torqueInternal.min, "FXSpawnRandomTorque.constructor.torque.min");
-        assertValidNumber(this._private_torqueInternal.max, "FXSpawnRandomTorque.constructor.torque.max");
+        assertValidNumber(this._private_torqueInternal.min, "FXSpawnTorque.constructor.torque.min");
+        assertValidNumber(this._private_torqueInternal.max, "FXSpawnTorque.constructor.torque.max");
     }
     /** Angular velocity range in radians/second */
     get torque() {
@@ -27,8 +25,8 @@ class FXSpawnRandomTorque extends FXSpawn {
     /** Angular velocity range in radians/second */
     set torque(value) {
         this._private_torqueInternal = resolveFXRangeConfig(value);
-        assertValidNumber(this._private_torqueInternal.min, "FXSpawnRandomTorque.torque.min");
-        assertValidNumber(this._private_torqueInternal.max, "FXSpawnRandomTorque.torque.max");
+        assertValidNumber(this._private_torqueInternal.min, "FXSpawnTorque.torque.min");
+        assertValidNumber(this._private_torqueInternal.max, "FXSpawnTorque.torque.max");
     }
     /** @internal */
     spawn(properties, instanceBegin, instanceEnd) {
@@ -42,4 +40,4 @@ class FXSpawnRandomTorque extends FXSpawn {
     }
 }
 
-export { FXSpawnRandomTorque };
+export { FXSpawnTorque };

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

@@ -0,0 +1,32 @@
+import { Vector3 } from "three";
+import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
+import { FXSpawn } from "./FXSpawn";
+/**
+ * Assigns a random initial velocity to each spawned particle within a cone around a direction axis
+ */
+export declare class FXSpawnVelocity extends FXSpawn<{
+    builtin: "Matrix4";
+}> {
+    private angleInternal;
+    private magnitudeInternal;
+    private readonly directionInternal;
+    /**
+     * @param direction - Cone axis; normalized automatically. Defaults to `(0, 1, 0)`
+     * @param angle - Cone half-angle range in radians; `{ min: 0, max: 0 }` fires in a straight line.
+     * Defaults to `{ min: 0, max: Math.PI }`
+     * @param magnitude - Speed range in units/second. Defaults to `{ min: -1, max: 1 }`
+     */
+    constructor(direction?: Vector3, angle?: FXRangeConfig, magnitude?: FXRangeConfig);
+    /** Cone half-angle range in radians */
+    get angle(): FXRange;
+    /** Speed range in units/second */
+    get magnitude(): FXRange;
+    /** Cone axis (always normalized) */
+    get direction(): Vector3;
+    /** Cone half-angle range in radians */
+    set angle(value: FXRangeConfig);
+    /** Speed range in units/second */
+    set magnitude(value: FXRangeConfig);
+    /** Cone axis - normalized on assignment */
+    set direction(value: Vector3);
+}

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

@@ -6,38 +6,53 @@ import { FXSpawn } from './FXSpawn.js';
 const TEMP_TANGENT = new Vector3();
 const TEMP_BITANGENT = new Vector3();
 const TEMP_VELOCITY = new Vector3();
-class FXSpawnRandomVelocity extends FXSpawn {
-    constructor(direction = new Vector3(0, 1, 0), angle = { min: 0, max: Math.PI }, magnitude = { min: -50, max: 50 }) {
+/**
+ * Assigns a random initial velocity to each spawned particle within a cone around a direction axis
+ */
+class FXSpawnVelocity extends FXSpawn {
+    /**
+     * @param direction - Cone axis; normalized automatically. Defaults to `(0, 1, 0)`
+     * @param angle - Cone half-angle range in radians; `{ min: 0, max: 0 }` fires in a straight line.
+     * Defaults to `{ min: 0, max: Math.PI }`
+     * @param magnitude - Speed range in units/second. Defaults to `{ min: -1, max: 1 }`
+     */
+    constructor(direction = new Vector3(0, 1, 0), angle = { min: 0, max: Math.PI }, magnitude = { min: -1, max: 1 }) {
         super();
         /** @internal */
         this.requiredProperties = { builtin: "Matrix4" };
         this._private_directionInternal = direction.clone().normalize();
         this._private_angleInternal = resolveFXRangeConfig(angle);
         this._private_magnitudeInternal = resolveFXRangeConfig(magnitude);
-        assertValidNumber(this._private_angleInternal.min, "FXSpawnRandomVelocity.constructor.angle.min");
-        assertValidNumber(this._private_angleInternal.max, "FXSpawnRandomVelocity.constructor.angle.max");
-        assertValidNumber(this._private_magnitudeInternal.min, "FXSpawnRandomVelocity.constructor.magnitude.min");
-        assertValidNumber(this._private_magnitudeInternal.max, "FXSpawnRandomVelocity.constructor.magnitude.max");
+        assertValidNumber(this._private_angleInternal.min, "FXSpawnVelocity.constructor.angle.min");
+        assertValidNumber(this._private_angleInternal.max, "FXSpawnVelocity.constructor.angle.max");
+        assertValidNumber(this._private_magnitudeInternal.min, "FXSpawnVelocity.constructor.magnitude.min");
+        assertValidNumber(this._private_magnitudeInternal.max, "FXSpawnVelocity.constructor.magnitude.max");
     }
+    /** Cone half-angle range in radians */
     get angle() {
         return this._private_angleInternal;
     }
+    /** Speed range in units/second */
     get magnitude() {
         return this._private_magnitudeInternal;
     }
+    /** Cone axis (always normalized) */
     get direction() {
         return this._private_directionInternal;
     }
+    /** Cone half-angle range in radians */
     set angle(value) {
         this._private_angleInternal = resolveFXRangeConfig(value);
-        assertValidNumber(this._private_angleInternal.min, "FXSpawnRandomVelocity.angle.min");
-        assertValidNumber(this._private_angleInternal.max, "FXSpawnRandomVelocity.angle.max");
+        assertValidNumber(this._private_angleInternal.min, "FXSpawnVelocity.angle.min");
+        assertValidNumber(this._private_angleInternal.max, "FXSpawnVelocity.angle.max");
     }
+    /** Speed range in units/second */
     set magnitude(value) {
         this._private_magnitudeInternal = resolveFXRangeConfig(value);
-        assertValidNumber(this._private_magnitudeInternal.min, "FXSpawnRandomVelocity.magnitude.min");
-        assertValidNumber(this._private_magnitudeInternal.max, "FXSpawnRandomVelocity.magnitude.max");
+        assertValidNumber(this._private_magnitudeInternal.min, "FXSpawnVelocity.magnitude.min");
+        assertValidNumber(this._private_magnitudeInternal.max, "FXSpawnVelocity.magnitude.max");
     }
+    /** Cone axis - normalized on assignment */
     set direction(value) {
         this._private_directionInternal.copy(value).normalize();
     }
@@ -76,4 +91,4 @@ class FXSpawnRandomVelocity extends FXSpawn {
     }
 }
 
-export { FXSpawnRandomVelocity };
+export { FXSpawnVelocity };

package/dist/index.d.ts

@@ -1,30 +1,37 @@
-export { FXBehaviorDirectionalGravity } from "./emitter/behavior/FXBehaviorDirectionalGravity";
-export { FXBehaviorPointGravity } from "./emitter/behavior/FXBehaviorPointGravity";
+export { FXBehaviorDirectionalForce } from "./emitter/behavior/FXBehaviorDirectionalForce";
+export { FXBehaviorPointForce } from "./emitter/behavior/FXBehaviorPointForce";
 export { FXBehaviorScaleOverLife } from "./emitter/behavior/FXBehaviorScaleOverLife";
 export { FXBehaviorTorqueDamping } from "./emitter/behavior/FXBehaviorTorqueDamping";
 export { FXBehaviorTorqueNoise } from "./emitter/behavior/FXBehaviorTorqueNoise";
+export { FXBehaviorTorqueOverLife } from "./emitter/behavior/FXBehaviorTorqueOverLife";
 export { FXBehaviorVelocityDamping } from "./emitter/behavior/FXBehaviorVelocityDamping";
 export { FXBehaviorVelocityNoise } from "./emitter/behavior/FXBehaviorVelocityNoise";
+export { FXBehaviorVelocityOverLife } from "./emitter/behavior/FXBehaviorVelocityOverLife";
 export { FXEmitter } from "./emitter/FXEmitter";
 export { FXSpawnBox } from "./emitter/spawn/FXSpawnBox";
+export { FXSpawnLifetime } from "./emitter/spawn/FXSpawnLifetime";
 export { FXSpawnOffset } from "./emitter/spawn/FXSpawnOffset";
 export { FXSpawnPoint } from "./emitter/spawn/FXSpawnPoint";
-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 { FXSpawnRotation } from "./emitter/spawn/FXSpawnRotation";
+export { FXSpawnScale } from "./emitter/spawn/FXSpawnScale";
 export { FXSpawnSphere } from "./emitter/spawn/FXSpawnSphere";
+export { FXSpawnTorque } from "./emitter/spawn/FXSpawnTorque";
+export { FXSpawnVelocity } from "./emitter/spawn/FXSpawnVelocity";
 export { FXDiffuseMaterial } from "./materials/FXDiffuseMaterial/FXDiffuseMaterial";
 export { FXMaterial } from "./materials/FXMaterial/FXMaterial";
 export { FXUnlitMaterial } from "./materials/FXUnlitMaterial/FXUnlitMaterial";
 export { FXColor } from "./miscellaneous/color/FXColor";
-export { FXColorNode } from "./nodes/color/FXColorNode";
-export { FXColorOverLifeNode } from "./nodes/color/FXColorOverLifeNode";
-export { FXSphericalClipNode } from "./nodes/color/FXSphericalClipNode";
-export { FXFlatNormalNode } from "./nodes/normal/FXFlatNormalNode";
-export { FXNormalNode } from "./nodes/normal/FXNormalNode";
-export { FXSphericalNormalNode } from "./nodes/normal/FXSphericalNormalNode";
-export { FXAnimatedTextureNode } from "./nodes/texture/FXAnimatedTextureNode";
-export { FXStaticTextureNode } from "./nodes/texture/FXStaticTextureNode";
-export { FXTextureNode } from "./nodes/texture/FXTextureNode";
+export { FXCurve1D } from "./miscellaneous/curve/FXCurve1D";
+export type { FXCurve1DAnchor, FXCurve1DConfig, FXCurve1DPoint, } from "./miscellaneous/curve/FXCurve1D";
+export { FXTextureView } from "./miscellaneous/texture/FXTextureView";
+export type { FXTextureAtlasConfig, FXTextureConfig, FXTextureRect, FXTextureSize, FXTextureTrim, } from "./miscellaneous/texture/FXTextureView.Internal";
+export { FXNodeColor } from "./nodes/color/FXNodeColor";
+export { FXNodeColorOverLife } from "./nodes/color/FXNodeColorOverLife";
+export { FXNodeSphericalClip } from "./nodes/color/FXNodeSphericalClip";
+export { FXNodeFlatNormal } from "./nodes/normal/FXNodeFlatNormal";
+export { FXNodeNormal } from "./nodes/normal/FXNodeNormal";
+export { FXNodeSphericalNormal } from "./nodes/normal/FXNodeSphericalNormal";
+export { FXNodeAnimatedTexture } from "./nodes/texture/FXNodeAnimatedTexture";
+export type { FXNodeAnimatedTextureOptions } from "./nodes/texture/FXNodeAnimatedTexture";
+export { FXNodeStaticTexture } from "./nodes/texture/FXNodeStaticTexture";
+export { FXNodeTexture } from "./nodes/texture/FXNodeTexture";

package/dist/index.js

@@ -1,30 +1,34 @@
-export { FXBehaviorDirectionalGravity } from './emitter/behavior/FXBehaviorDirectionalGravity.js';
-export { FXBehaviorPointGravity } from './emitter/behavior/FXBehaviorPointGravity.js';
+export { FXBehaviorDirectionalForce } from './emitter/behavior/FXBehaviorDirectionalForce.js';
+export { FXBehaviorPointForce } from './emitter/behavior/FXBehaviorPointForce.js';
 export { FXBehaviorScaleOverLife } from './emitter/behavior/FXBehaviorScaleOverLife.js';
 export { FXBehaviorTorqueDamping } from './emitter/behavior/FXBehaviorTorqueDamping.js';
 export { FXBehaviorTorqueNoise } from './emitter/behavior/FXBehaviorTorqueNoise.js';
+export { FXBehaviorTorqueOverLife } from './emitter/behavior/FXBehaviorTorqueOverLife.js';
 export { FXBehaviorVelocityDamping } from './emitter/behavior/FXBehaviorVelocityDamping.js';
 export { FXBehaviorVelocityNoise } from './emitter/behavior/FXBehaviorVelocityNoise.js';
+export { FXBehaviorVelocityOverLife } from './emitter/behavior/FXBehaviorVelocityOverLife.js';
 export { FXEmitter } from './emitter/FXEmitter.js';
 export { FXSpawnBox } from './emitter/spawn/FXSpawnBox.js';
+export { FXSpawnLifetime } from './emitter/spawn/FXSpawnLifetime.js';
 export { FXSpawnOffset } from './emitter/spawn/FXSpawnOffset.js';
 export { FXSpawnPoint } from './emitter/spawn/FXSpawnPoint.js';
-export { FXSpawnRandomLifetime } from './emitter/spawn/FXSpawnRandomLifetime.js';
-export { FXSpawnRandomRotation } from './emitter/spawn/FXSpawnRandomRotation.js';
-export { FXSpawnRandomScale } from './emitter/spawn/FXSpawnRandomScale.js';
-export { FXSpawnRandomTorque } from './emitter/spawn/FXSpawnRandomTorque.js';
-export { FXSpawnRandomVelocity } from './emitter/spawn/FXSpawnRandomVelocity.js';
+export { FXSpawnRotation } from './emitter/spawn/FXSpawnRotation.js';
+export { FXSpawnScale } from './emitter/spawn/FXSpawnScale.js';
 export { FXSpawnSphere } from './emitter/spawn/FXSpawnSphere.js';
+export { FXSpawnTorque } from './emitter/spawn/FXSpawnTorque.js';
+export { FXSpawnVelocity } from './emitter/spawn/FXSpawnVelocity.js';
 export { FXDiffuseMaterial } from './materials/FXDiffuseMaterial/FXDiffuseMaterial.js';
 export { FXMaterial } from './materials/FXMaterial/FXMaterial.js';
 export { FXUnlitMaterial } from './materials/FXUnlitMaterial/FXUnlitMaterial.js';
 export { FXColor } from './miscellaneous/color/FXColor.js';
-export { FXColorNode } from './nodes/color/FXColorNode.js';
-export { FXColorOverLifeNode } from './nodes/color/FXColorOverLifeNode.js';
-export { FXSphericalClipNode } from './nodes/color/FXSphericalClipNode.js';
-export { FXFlatNormalNode } from './nodes/normal/FXFlatNormalNode.js';
-export { FXNormalNode } from './nodes/normal/FXNormalNode.js';
-export { FXSphericalNormalNode } from './nodes/normal/FXSphericalNormalNode.js';
-export { FXAnimatedTextureNode } from './nodes/texture/FXAnimatedTextureNode.js';
-export { FXStaticTextureNode } from './nodes/texture/FXStaticTextureNode.js';
-export { FXTextureNode } from './nodes/texture/FXTextureNode.js';
+export { FXCurve1D } from './miscellaneous/curve/FXCurve1D.js';
+export { FXTextureView } from './miscellaneous/texture/FXTextureView.js';
+export { FXNodeColor } from './nodes/color/FXNodeColor.js';
+export { FXNodeColorOverLife } from './nodes/color/FXNodeColorOverLife.js';
+export { FXNodeSphericalClip } from './nodes/color/FXNodeSphericalClip.js';
+export { FXNodeFlatNormal } from './nodes/normal/FXNodeFlatNormal.js';
+export { FXNodeNormal } from './nodes/normal/FXNodeNormal.js';
+export { FXNodeSphericalNormal } from './nodes/normal/FXNodeSphericalNormal.js';
+export { FXNodeAnimatedTexture } from './nodes/texture/FXNodeAnimatedTexture.js';
+export { FXNodeStaticTexture } from './nodes/texture/FXNodeStaticTexture.js';
+export { FXNodeTexture } from './nodes/texture/FXNodeTexture.js';

package/dist/materials/FXDiffuseMaterial/FXDiffuseMaterial.Internal.d.ts

@@ -1,9 +1,9 @@
 import type { Blending } from "three";
 import { Color, MeshLambertMaterial } from "three";
 import type { GLTypeInfo } from "../../instancedParticle/shared";
-import type { FXColorNode } from "../../nodes/color/FXColorNode";
-import type { FXNormalNode } from "../../nodes/normal/FXNormalNode";
-import { FXTextureNode } from "../../nodes/texture/FXTextureNode";
+import type { FXNodeColor } from "../../nodes/color/FXNodeColor";
+import type { FXNodeNormal } from "../../nodes/normal/FXNodeNormal";
+import { FXNodeTexture } from "../../nodes/texture/FXNodeTexture";
 export interface FXScatterUniforms {
     u_ScatterTint: {
         value: Color;
@@ -18,6 +18,6 @@ export interface FXScatterUniforms {
         value: number;
     };
 }
-export declare function buildFXDiffuseMaterial(varyings: Record<string, GLTypeInfo>, blending: Blending, useAlphaHashing: boolean, alphaTest: number, premultipliedAlpha: boolean, albedoNodes: readonly (FXColorNode | FXTextureNode)[], normalNodes: readonly (FXTextureNode | FXNormalNode)[], emissionNodes: readonly (FXColorNode | FXTextureNode)[], scatterUniforms?: FXScatterUniforms, shadowSensitivity?: {
+export declare function buildFXDiffuseMaterial(varyings: Record<string, GLTypeInfo>, blending: Blending, useAlphaHashing: boolean, alphaTest: number, premultipliedAlpha: boolean, albedoNodes: readonly (FXNodeColor | FXNodeTexture)[], normalNodes: readonly (FXNodeTexture | FXNodeNormal)[], emissionNodes: readonly (FXNodeColor | FXNodeTexture)[], scatterUniforms?: FXScatterUniforms, shadowSensitivity?: {
     value: number;
 }): MeshLambertMaterial;

package/dist/materials/FXDiffuseMaterial/FXDiffuseMaterial.Internal.js

@@ -1,6 +1,6 @@
 import { MeshLambertMaterial, Color, DoubleSide } from 'three';
 import { PARTICLE_DEFINES } from '../../miscellaneous/miscellaneous.js';
-import { FXTextureNode } from '../../nodes/texture/FXTextureNode.js';
+import { FXNodeTexture } from '../../nodes/texture/FXNodeTexture.js';
 
 /**
  * Wraps every `getShadow(...)` call in the shader source with
@@ -191,7 +191,7 @@ function buildFXDiffuseMaterial(varyings, blending, useAlphaHashing, alphaTest,
         let fragmentShader = shader.fragmentShader;
         if (useNormals) {
             const normalExpressions = normalNodes.map((node) => {
-                if (node instanceof FXTextureNode) {
+                if (node instanceof FXNodeTexture) {
                     return `normalize(${node.colorExpression}.rgb * 2.0 - 1.0)`;
                 }
                 return node.normalExpression;

package/dist/materials/FXDiffuseMaterial/FXDiffuseMaterial.d.ts

@@ -1,24 +1,74 @@
 import type { ColorRepresentation } from "three";
-import type { FXColorNode } from "../../nodes/color/FXColorNode";
-import type { FXNormalNode } from "../../nodes/normal/FXNormalNode";
-import type { FXTextureNode } from "../../nodes/texture/FXTextureNode";
+import type { FXNodeColor } from "../../nodes/color/FXNodeColor";
+import type { FXNodeNormal } from "../../nodes/normal/FXNodeNormal";
+import type { FXNodeTexture } from "../../nodes/texture/FXNodeTexture";
 import type { FXMaterialOptions } from "../FXMaterial/FXMaterial";
 import { FXMaterial } from "../FXMaterial/FXMaterial";
+/**
+ * Configuration options for {@link FXDiffuseMaterial}
+ */
 export interface FXDiffuseMaterialOptions extends FXMaterialOptions {
-    normalNodes: (FXTextureNode | FXNormalNode)[];
-    emissionNodes: (FXColorNode | FXTextureNode)[];
+    /**
+     * Normal nodes for lighting; multiple nodes are blended together
+     *
+     * @defaultValue `[new FXNodeSphericalNormal()]`
+     */
+    normalNodes: (FXNodeTexture | FXNodeNormal)[];
+    /**
+     * Emission color nodes composited for emissive output
+     *
+     * @defaultValue `[]`
+     */
+    emissionNodes: (FXNodeColor | FXNodeTexture)[];
+    /**
+     * Enable subsurface scattering approximation
+     *
+     * @defaultValue `false`
+     */
     enableScatter: boolean;
+    /**
+     * Tint color applied to the scatter contribution
+     *
+     * @defaultValue `0xffd999`
+     */
     scatterTint: ColorRepresentation;
+    /**
+     * Scatter lobe sharpness; higher values produce a tighter highlight
+     *
+     * @defaultValue `10`
+     */
     scatterPower: number;
+    /**
+     * Forward scatter intensity (light-facing side)
+     *
+     * @defaultValue `1`
+     */
     forwardScatterStrength: number;
+    /**
+     * Back scatter intensity (back-lit side)
+     *
+     * @defaultValue `1`
+     */
     backScatterStrength: number;
+    /**
+     * Shadow influence (`0` = no shadows, `1` = full shadows)
+     *
+     * @defaultValue `1`
+     */
     shadowSensitivity: number;
 }
+/**
+ * Diffuse particle material with lighting, normals, emission, and optional subsurface scattering
+ */
 export declare class FXDiffuseMaterial extends FXMaterial {
     private readonly normalNodes;
     private readonly emissionNodes;
     private readonly scatterUniforms;
     private readonly shadowSensitivity;
+    /**
+     * @param options - Material configuration
+     */
     constructor(options?: Partial<FXDiffuseMaterialOptions>);
+    /** Releases resources held by all albedo, normal, and emission nodes */
     destroy(): void;
 }