sparcoon 0.5.0 → 0.6.1

package/dist/nodes/texture/FXNodeStaticTexture.d.ts

@@ -0,0 +1,18 @@
+import { FXTextureView } from "../../miscellaneous/texture/FXTextureView";
+import type { FXTextureConfig } from "../../miscellaneous/texture/FXTextureView.Internal";
+import { FXNodeTexture } from "./FXNodeTexture";
+/**
+ * Texture node that applies a single static texture to every particle
+ */
+export declare class FXNodeStaticTexture extends FXNodeTexture {
+    private readonly uniformTexture;
+    private readonly uniformUVTransform;
+    private readonly textureViewInternal;
+    /**
+     * @param config - Texture or atlas configuration applied to every particle
+     */
+    constructor(config: FXTextureConfig);
+    /** View describing the texture and its atlas region */
+    get textureView(): FXTextureView;
+    set textureView(config: FXTextureConfig);
+}

package/dist/nodes/texture/FXNodeStaticTexture.js

@@ -0,0 +1,60 @@
+import { getNextInstanceId } from '../../miscellaneous/miscellaneous.js';
+import { FXTextureView } from '../../miscellaneous/texture/FXTextureView.js';
+import { checkSRGBSupport } from '../../miscellaneous/webglCapabilities.js';
+import { FXNodeTexture } from './FXNodeTexture.js';
+
+/**
+ * Texture node that applies a single static texture to every particle
+ */
+class FXNodeStaticTexture extends FXNodeTexture {
+    /**
+     * @param config - Texture or atlas configuration applied to every particle
+     */
+    constructor(config) {
+        super();
+        const id = getNextInstanceId();
+        this._private_uniformTexture = `u_StaticTexture_${id}`;
+        this._private_uniformUVTransform = `u_StaticTextureUVTransform_${id}`;
+        this._private_textureViewInternal = new FXTextureView(config);
+        const uvTransform = this._private_textureViewInternal.calculateUVTransform();
+        this._private_textureViewInternal.setTextureDirtyFalse();
+        this._private_textureViewInternal.setUVTransformDirtyFalse();
+        this.affectsDepth = true;
+        this.cacheKey = "static-texture";
+        this.uniformDeclarations = [
+            `uniform sampler2D ${this._private_uniformTexture};`,
+            `uniform mat3 ${this._private_uniformUVTransform};`,
+        ];
+        this.uniforms = {
+            [this._private_uniformTexture]: { value: this._private_textureViewInternal.texture },
+            [this._private_uniformUVTransform]: { value: uvTransform },
+        };
+        this.helperFunctions = `
+      vec4 fxSampleStaticTexture(sampler2D colorTexture, mat3 uvTransform, vec2 uv) {
+        vec2 transformedUV = (uvTransform * vec3(uv, 1.0)).xy;
+        vec4 color = texture2D(colorTexture, transformedUV);
+        // Apply gamma correction when sRGB textures are not natively supported
+        ${checkSRGBSupport() ? "" : "color = vec4(pow(color.rgb, vec3(2.2)), color.a);"}
+        return color;
+      }
+    `;
+        this.colorExpression = `fxSampleStaticTexture(${this._private_uniformTexture}, ${this._private_uniformUVTransform}, p_uv)`;
+    }
+    /** View describing the texture and its atlas region */
+    get textureView() {
+        return this._private_textureViewInternal;
+    }
+    set textureView(config) {
+        this._private_textureViewInternal.set(config);
+        if (this._private_textureViewInternal.textureDirty) {
+            this.uniforms[this._private_uniformTexture].value = this._private_textureViewInternal.texture;
+            this._private_textureViewInternal.setTextureDirtyFalse();
+        }
+        if (this._private_textureViewInternal.uvTransformDirty) {
+            this._private_textureViewInternal.calculateUVTransform(this.uniforms[this._private_uniformUVTransform].value);
+            this._private_textureViewInternal.setUVTransformDirtyFalse();
+        }
+    }
+}
+
+export { FXNodeStaticTexture };

package/dist/nodes/texture/FXNodeTexture.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Abstract base class for particle texture nodes
+ */
+export declare abstract class FXNodeTexture {
+    /** Releases any GPU resources held by this node */
+    destroy?(): void;
+}

package/dist/nodes/texture/FXNodeTexture.js

@@ -0,0 +1,11 @@
+/**
+ * Abstract base class for particle texture nodes
+ */
+class FXNodeTexture {
+    constructor() {
+        /** @internal */
+        this.affectsDepth = false;
+    }
+}
+
+export { FXNodeTexture };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sparcoon",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Instanced-mesh particle system for Three.js.",
   "keywords": [
     "particles",
@@ -45,6 +45,7 @@
   },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-commonjs": "^29.0.2",
     "@types/node": "^25.0.2",
     "@types/three": "^0.157.0",
     "@typescript-eslint/eslint-plugin": "^8.32.0",
@@ -55,8 +56,5 @@
     "rollup-plugin-typescript2": "^0.36.0",
     "ts-transformer-minify-privates": "^1.0.0",
     "typescript": "^5.8.3"
-  },
-  "dependencies": {
-    "@rollup/plugin-commonjs": "^29.0.2"
   }
 }

package/dist/emitter/behavior/FXBehaviorDirectionalGravity.d.ts

@@ -1,21 +0,0 @@
-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 FXBehavior<{
-    builtin: "Matrix4";
-}> {
-    private directionInternal;
-    /**
-     * @param direction - Acceleration vector in units/second²
-     */
-    constructor(direction: Vector3Like);
-    /** Acceleration vector in units/second² */
-    get direction(): Vector3Like;
-    /** Acceleration vector in units/second² */
-    set direction(value: FXVector3Config);
-}

package/dist/emitter/behavior/FXBehaviorDirectionalGravity.js

@@ -1,51 +0,0 @@
-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 FXBehavior {
-    /**
-     * @param direction - Acceleration vector in units/second²
-     */
-    constructor(direction) {
-        super();
-        /** @internal */
-        this.requiredProperties = { builtin: "Matrix4" };
-        this._private_directionInternal = resolveFXVector3Config(direction);
-        assertValidNumber(this._private_directionInternal.x, "FXBehaviorDirectionalGravity.constructor.direction.x");
-        assertValidNumber(this._private_directionInternal.y, "FXBehaviorDirectionalGravity.constructor.direction.y");
-        assertValidNumber(this._private_directionInternal.z, "FXBehaviorDirectionalGravity.constructor.direction.z");
-    }
-    /** Acceleration vector in units/second² */
-    get direction() {
-        return this._private_directionInternal;
-    }
-    /** Acceleration vector in units/second² */
-    set direction(value) {
-        this._private_directionInternal = resolveFXVector3Config(value);
-        assertValidNumber(this._private_directionInternal.x, "FXBehaviorDirectionalGravity.direction.x");
-        assertValidNumber(this._private_directionInternal.y, "FXBehaviorDirectionalGravity.direction.y");
-        assertValidNumber(this._private_directionInternal.z, "FXBehaviorDirectionalGravity.direction.z");
-    }
-    /** @internal */
-    update(properties, instanceCount, deltaTime) {
-        const { builtin } = properties;
-        const { array, itemSize } = builtin;
-        const offsetX = this._private_directionInternal.x * deltaTime;
-        const offsetY = this._private_directionInternal.y * deltaTime;
-        const offsetZ = this._private_directionInternal.z * deltaTime;
-        for (let i = 0; i < instanceCount; i++) {
-            const itemOffset = i * itemSize;
-            array[itemOffset + BUILTIN_OFFSET_VELOCITY_X] += offsetX;
-            array[itemOffset + BUILTIN_OFFSET_VELOCITY_Y] += offsetY;
-            array[itemOffset + BUILTIN_OFFSET_VELOCITY_Z] += offsetZ;
-        }
-        builtin.needsUpdate = true;
-    }
-}
-
-export { FXBehaviorDirectionalGravity };

package/dist/emitter/behavior/FXBehaviorPointGravity.d.ts

@@ -1,39 +0,0 @@
-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 FXBehavior<{
-    builtin: "Matrix4";
-}> {
-    private centerInternal;
-    private strengthInternal;
-    private exponentInternal;
-    private thresholdInternal;
-    /**
-     * @param center - Gravity center position
-     * @param strength - Force multiplier range. Accepts number, tuple, or range object
-     * @param exponent - Distance power exponent range. Accepts number, tuple, or range object
-     * @param threshold - Minimum distance range. Accepts number, tuple, or range object
-     */
-    constructor(center: Vector3Like, strength: FXRangeConfig, exponent?: FXRangeConfig, threshold?: FXRangeConfig);
-    /** Gravity center position */
-    get center(): Vector3Like;
-    /** Force multiplier range */
-    get strength(): FXRange;
-    /** Distance power exponent range */
-    get exponent(): FXRange;
-    /** Minimum distance range */
-    get threshold(): FXRange;
-    /** Gravity center position */
-    set center(value: FXVector3Config);
-    /** Force multiplier range */
-    set strength(value: FXRangeConfig);
-    /** Distance power exponent range */
-    set exponent(value: FXRangeConfig);
-    /** Minimum distance range */
-    set threshold(value: FXRangeConfig);
-}

package/dist/emitter/behavior/FXBehaviorPointGravity.js

@@ -1,116 +0,0 @@
-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 { 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 FXBehavior {
-    /**
-     * @param center - Gravity center position
-     * @param strength - Force multiplier range. Accepts number, tuple, or range object
-     * @param exponent - Distance power exponent range. Accepts number, tuple, or range object
-     * @param threshold - Minimum distance range. Accepts number, tuple, or range object
-     */
-    constructor(center, strength, exponent = 2, threshold = 1) {
-        super();
-        /** @internal */
-        this.requiredProperties = { builtin: "Matrix4" };
-        this._private_centerInternal = resolveFXVector3Config(center);
-        assertValidNumber(this._private_centerInternal.x, "FXBehaviorPointGravity.constructor.center.x");
-        assertValidNumber(this._private_centerInternal.y, "FXBehaviorPointGravity.constructor.center.y");
-        assertValidNumber(this._private_centerInternal.z, "FXBehaviorPointGravity.constructor.center.z");
-        this._private_strengthInternal = resolveFXRangeConfig(strength);
-        assertValidNumber(this._private_strengthInternal.min, "FXBehaviorPointGravity.constructor.strength.min");
-        assertValidNumber(this._private_strengthInternal.max, "FXBehaviorPointGravity.constructor.strength.max");
-        this._private_exponentInternal = resolveFXRangeConfig(exponent);
-        assertValidNumber(this._private_exponentInternal.min, "FXBehaviorPointGravity.constructor.exponent.min");
-        assertValidNumber(this._private_exponentInternal.max, "FXBehaviorPointGravity.constructor.exponent.max");
-        this._private_thresholdInternal = resolveFXRangeConfig(threshold);
-        assertValidNumber(this._private_thresholdInternal.min, "FXBehaviorPointGravity.constructor.threshold.min");
-        assertValidNumber(this._private_thresholdInternal.max, "FXBehaviorPointGravity.constructor.threshold.max");
-    }
-    /** Gravity center position */
-    get center() {
-        return this._private_centerInternal;
-    }
-    /** Force multiplier range */
-    get strength() {
-        return this._private_strengthInternal;
-    }
-    /** Distance power exponent range */
-    get exponent() {
-        return this._private_exponentInternal;
-    }
-    /** Minimum distance range */
-    get threshold() {
-        return this._private_thresholdInternal;
-    }
-    /** Gravity center position */
-    set center(value) {
-        this._private_centerInternal = resolveFXVector3Config(value);
-        assertValidNumber(this._private_centerInternal.x, "FXBehaviorPointGravity.center.x");
-        assertValidNumber(this._private_centerInternal.y, "FXBehaviorPointGravity.center.y");
-        assertValidNumber(this._private_centerInternal.z, "FXBehaviorPointGravity.center.z");
-    }
-    /** Force multiplier range */
-    set strength(value) {
-        this._private_strengthInternal = resolveFXRangeConfig(value);
-        assertValidNumber(this._private_strengthInternal.min, "FXBehaviorPointGravity.strength.min");
-        assertValidNumber(this._private_strengthInternal.max, "FXBehaviorPointGravity.strength.max");
-    }
-    /** Distance power exponent range */
-    set exponent(value) {
-        this._private_exponentInternal = resolveFXRangeConfig(value);
-        assertValidNumber(this._private_exponentInternal.min, "FXBehaviorPointGravity.exponent.min");
-        assertValidNumber(this._private_exponentInternal.max, "FXBehaviorPointGravity.exponent.max");
-    }
-    /** Minimum distance range */
-    set threshold(value) {
-        this._private_thresholdInternal = resolveFXRangeConfig(value);
-        assertValidNumber(this._private_thresholdInternal.min, "FXBehaviorPointGravity.threshold.min");
-        assertValidNumber(this._private_thresholdInternal.max, "FXBehaviorPointGravity.threshold.max");
-    }
-    /** @internal */
-    update(properties, instanceCount, deltaTime) {
-        const { builtin } = properties;
-        const { array, itemSize } = builtin;
-        for (let i = 0; i < instanceCount; i++) {
-            const itemOffset = i * itemSize;
-            const dx = this._private_centerInternal.x - array[itemOffset + BUILTIN_OFFSET_POSITION_X];
-            const dy = this._private_centerInternal.y - array[itemOffset + BUILTIN_OFFSET_POSITION_Y];
-            const dz = this._private_centerInternal.z - array[itemOffset + BUILTIN_OFFSET_POSITION_Z];
-            // Constant over the life of a particle but different for each particle
-            const thresholdT = array[itemOffset + BUILTIN_OFFSET_RANDOM_A];
-            const threshold = MathUtils.lerp(this.threshold.min, this.threshold.max, thresholdT);
-            const thresholdSquared = threshold * threshold;
-            const distanceSquared = dx * dx + dy * dy + dz * dz;
-            if (distanceSquared < thresholdSquared) {
-                continue;
-            }
-            // Constant over the life of a particle but different for each particle
-            const strengthT = array[itemOffset + BUILTIN_OFFSET_RANDOM_B];
-            const strength = MathUtils.lerp(this._private_strengthInternal.min, this._private_strengthInternal.max, strengthT);
-            // Constant over the life of a particle but different for each particle
-            const exponentT = array[itemOffset + BUILTIN_OFFSET_RANDOM_C];
-            const exponent = MathUtils.lerp(this._private_exponentInternal.min, this._private_exponentInternal.max, exponentT);
-            const distance = Math.sqrt(distanceSquared);
-            const forceMagnitude = strength / Math.pow(distance, exponent);
-            const directionX = dx / distance;
-            const directionY = dy / distance;
-            const directionZ = dz / distance;
-            const accelerationX = directionX * forceMagnitude;
-            const accelerationY = directionY * forceMagnitude;
-            const accelerationZ = directionZ * forceMagnitude;
-            array[itemOffset + BUILTIN_OFFSET_VELOCITY_X] += accelerationX * deltaTime;
-            array[itemOffset + BUILTIN_OFFSET_VELOCITY_Y] += accelerationY * deltaTime;
-            array[itemOffset + BUILTIN_OFFSET_VELOCITY_Z] += accelerationZ * deltaTime;
-        }
-        builtin.needsUpdate = true;
-    }
-}
-
-export { FXBehaviorPointGravity };

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

@@ -1,17 +0,0 @@
-import { Vector3 } from "three";
-import type { FXRange, FXRangeConfig } from "../../miscellaneous/miscellaneous";
-import { FXSpawn } from "./FXSpawn";
-export declare class FXSpawnRandomVelocity extends FXSpawn<{
-    builtin: "Matrix4";
-}> {
-    private angleInternal;
-    private magnitudeInternal;
-    private readonly directionInternal;
-    constructor(direction?: Vector3, angle?: FXRangeConfig, magnitude?: FXRangeConfig);
-    get angle(): FXRange;
-    get magnitude(): FXRange;
-    get direction(): Vector3;
-    set angle(value: FXRangeConfig);
-    set magnitude(value: FXRangeConfig);
-    set direction(value: Vector3);
-}

package/dist/nodes/color/FXColorNode.d.ts

@@ -1,3 +0,0 @@
-export declare abstract class FXColorNode {
-    destroy?(): void;
-}

package/dist/nodes/color/FXColorNode.js

@@ -1,8 +0,0 @@
-class FXColorNode {
-    constructor() {
-        /** @internal */
-        this.affectsDepth = false;
-    }
-}
-
-export { FXColorNode };

package/dist/nodes/color/FXColorOverLifeNode.d.ts

@@ -1,6 +0,0 @@
-import type { FXColor } from "../../miscellaneous/color/FXColor";
-import { FXColorNode } from "./FXColorNode";
-export declare class FXColorOverLifeNode extends FXColorNode {
-    constructor(colors: FXColor[]);
-    destroy(): void;
-}

package/dist/nodes/color/FXColorOverLifeNode.js

@@ -1,44 +0,0 @@
-import { buildGradientTexture } from '../../miscellaneous/miscellaneous.js';
-import { checkSRGBSupport } from '../../miscellaneous/webglCapabilities.js';
-import { FXColorNode } from './FXColorNode.js';
-
-const INSTANCES = [];
-class FXColorOverLifeNode extends FXColorNode {
-    constructor(colors) {
-        if (colors.length === 0) {
-            throw new Error("FXColorOverLifeNode: colors array cannot be empty");
-        }
-        super();
-        INSTANCES.push(this);
-        const uniformName = `u_ColorOverLife_${INSTANCES.length - 1}`;
-        this._private_gradientTexture = buildGradientTexture(colors);
-        this.affectsDepth = true;
-        this.cacheKey = "color-over-life";
-        this.uniformDeclarations = [`uniform sampler2D ${uniformName};`];
-        this.uniforms = {
-            [uniformName]: { value: this._private_gradientTexture },
-        };
-        this.helperFunctions = `
-      vec4 sampleColorOverLife(sampler2D gradientTexture) {
-        // Normalized particle age [0, 1] maps to the gradient texture's x-axis
-        float lifetimeRatio = clamp(PARTICLE_AGE / PARTICLE_LIFETIME, 0.0, 1.0);
-        vec4 color = texture2D(gradientTexture, vec2(lifetimeRatio, 0.5));
-
-        // Apply gamma correction when sRGB textures are not natively supported
-        ${checkSRGBSupport() ? "" : "color = vec4(pow(color.rgb, vec3(2.2)), color.a);"}
-
-        return color;
-      }
-    `;
-        this.colorExpression = `sampleColorOverLife(${uniformName})`;
-    }
-    destroy() {
-        this._private_gradientTexture.dispose();
-        const index = INSTANCES.indexOf(this);
-        if (index !== -1) {
-            INSTANCES.splice(index, 1);
-        }
-    }
-}
-
-export { FXColorOverLifeNode };

package/dist/nodes/color/FXSphericalClipNode.d.ts

@@ -1,5 +0,0 @@
-import { FXColorNode } from "./FXColorNode";
-export declare class FXSphericalClipNode extends FXColorNode {
-    constructor(innerRadius?: number);
-    destroy(): void;
-}

package/dist/nodes/color/FXSphericalClipNode.js

@@ -1,30 +0,0 @@
-import { FXColorNode } from './FXColorNode.js';
-
-const INSTANCES = [];
-class FXSphericalClipNode extends FXColorNode {
-    constructor(innerRadius = 0.5) {
-        super();
-        INSTANCES.push(this);
-        const uniformName = `u_SphericalClip_${INSTANCES.length - 1}`;
-        this.cacheKey = "spherical-clip";
-        this.uniformDeclarations = [`uniform float ${uniformName};`];
-        this.uniforms = {
-            [uniformName]: { value: innerRadius },
-        };
-        this.helperFunctions = `
-      vec4 applySphericalClip(float innerRadius) {
-        float distanceToCenter = distance(p_uv, vec2(0.5, 0.5));
-        return vec4(1.0, 1.0, 1.0, 1.0 - smoothstep(innerRadius, 0.5, distanceToCenter));
-      }
-    `;
-        this.colorExpression = `applySphericalClip(${uniformName})`;
-    }
-    destroy() {
-        const index = INSTANCES.indexOf(this);
-        if (index !== -1) {
-            INSTANCES.splice(index, 1);
-        }
-    }
-}
-
-export { FXSphericalClipNode };

package/dist/nodes/normal/FXFlatNormalNode.d.ts

@@ -1,4 +0,0 @@
-import { FXNormalNode } from "./FXNormalNode";
-export declare class FXFlatNormalNode extends FXNormalNode {
-    constructor();
-}

package/dist/nodes/normal/FXFlatNormalNode.js

@@ -1,14 +0,0 @@
-import { FXNormalNode } from './FXNormalNode.js';
-
-class FXFlatNormalNode extends FXNormalNode {
-    constructor() {
-        super();
-        this.cacheKey = "flat";
-        this.uniformDeclarations = [];
-        this.uniforms = {};
-        this.helperFunctions = "";
-        this.normalExpression = "vec3(0.0, 0.0, 1.0)";
-    }
-}
-
-export { FXFlatNormalNode };

package/dist/nodes/normal/FXNormalNode.d.ts

@@ -1,3 +0,0 @@
-export declare abstract class FXNormalNode {
-    destroy?(): void;
-}

package/dist/nodes/normal/FXNormalNode.js

@@ -1,4 +0,0 @@
-class FXNormalNode {
-}
-
-export { FXNormalNode };

package/dist/nodes/normal/FXSphericalNormalNode.d.ts

@@ -1,4 +0,0 @@
-import { FXNormalNode } from "./FXNormalNode";
-export declare class FXSphericalNormalNode extends FXNormalNode {
-    constructor();
-}

package/dist/nodes/texture/FXAnimatedTextureNode.d.ts

@@ -1,12 +0,0 @@
-import type { Texture } from "three";
-import { FXTextureNode } from "./FXTextureNode";
-export interface FXAnimatedTextureNodeOptions {
-    texture: Texture;
-    columns: number;
-    rows: number;
-    interpolate?: boolean;
-}
-export declare class FXAnimatedTextureNode extends FXTextureNode {
-    constructor({ texture, columns, rows, interpolate }: FXAnimatedTextureNodeOptions);
-    destroy(): void;
-}

package/dist/nodes/texture/FXAnimatedTextureNode.js

@@ -1,88 +0,0 @@
-import { checkSRGBSupport } from '../../miscellaneous/webglCapabilities.js';
-import { FXTextureNode } from './FXTextureNode.js';
-
-const INSTANCES = [];
-class FXAnimatedTextureNode extends FXTextureNode {
-    constructor({ texture, columns, rows, interpolate = false }) {
-        super();
-        INSTANCES.push(this);
-        const idx = INSTANCES.length - 1;
-        const uniformTexture = `u_AnimatedTexture_${idx}`;
-        const uniformColumns = `u_AnimatedTextureColumns_${idx}`;
-        const uniformRows = `u_AnimatedTextureRows_${idx}`;
-        const gammaCorrection = checkSRGBSupport()
-            ? ""
-            : "color = vec4(pow(color.rgb, vec3(2.2)), color.a);";
-        this.affectsDepth = true;
-        this.cacheKey = interpolate ? "animated-interpolated" : "animated";
-        this.uniformDeclarations = [
-            `uniform sampler2D ${uniformTexture};`,
-            `uniform float ${uniformColumns};`,
-            `uniform float ${uniformRows};`,
-        ];
-        this.uniforms = {
-            [uniformTexture]: { value: texture },
-            [uniformColumns]: { value: columns },
-            [uniformRows]: { value: rows },
-        };
-        this.helperFunctions = interpolate
-            ? `
-        vec2 frameToUV(vec2 uv, float frame, float columns, float rows) {
-          float column = mod(frame, columns);
-          float row = floor(frame / columns);
-          return vec2((column + uv.x) / columns, 1.0 - (row + 1.0 - uv.y) / rows);
-        }
-
-        vec4 sampleAnimatedTexture(sampler2D spriteSheet, vec2 uv, float columns, float rows) {
-          float totalFrames = columns * rows;
-
-          // Fractional frame position drives both frame selection and blend weight
-          float exactFrame = PARTICLE_AGE / PARTICLE_LIFETIME * totalFrames;
-          float currentFrame = clamp(floor(exactFrame), 0.0, totalFrames - 1.0);
-          float nextFrame    = clamp(currentFrame + 1.0, 0.0, totalFrames - 1.0);
-          float blendWeight  = fract(exactFrame);
-
-          vec4 color = mix(
-            texture2D(spriteSheet, frameToUV(uv, currentFrame, columns, rows)),
-            texture2D(spriteSheet, frameToUV(uv, nextFrame,    columns, rows)),
-            blendWeight
-          );
-
-          // Apply gamma correction when sRGB textures are not natively supported
-          ${gammaCorrection}
-
-          return color;
-        }
-      `
-            : `
-        vec4 sampleAnimatedTexture(sampler2D spriteSheet, vec2 uv, float columns, float rows) {
-          // Determine which frame to display based on normalized particle age
-          float totalFrames = columns * rows;
-          float frame = floor(PARTICLE_AGE / PARTICLE_LIFETIME * totalFrames);
-          frame = clamp(frame, 0.0, totalFrames - 1.0);
-
-          // Locate the frame's column and row in the sprite sheet grid
-          float column = mod(frame, columns);
-          float row = floor(frame / columns);
-
-          // Remap UV to the frame's tile region within the sprite sheet
-          vec2 frameUV = vec2((column + uv.x) / columns, 1.0 - (row + 1.0 - uv.y) / rows);
-          vec4 color = texture2D(spriteSheet, frameUV);
-
-          // Apply gamma correction when sRGB textures are not natively supported
-          ${gammaCorrection}
-
-          return color;
-        }
-      `;
-        this.colorExpression = `sampleAnimatedTexture(${uniformTexture}, p_uv, ${uniformColumns}, ${uniformRows})`;
-    }
-    destroy() {
-        const index = INSTANCES.indexOf(this);
-        if (index !== -1) {
-            INSTANCES.splice(index, 1);
-        }
-    }
-}
-
-export { FXAnimatedTextureNode };

package/dist/nodes/texture/FXStaticTextureNode.d.ts

@@ -1,6 +0,0 @@
-import type { Texture } from "three";
-import { FXTextureNode } from "./FXTextureNode";
-export declare class FXStaticTextureNode extends FXTextureNode {
-    constructor(texture: Texture);
-    destroy(): void;
-}