sparcoon 0.5.0 → 0.6.0

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

package/dist/nodes/texture/FXStaticTextureNode.js

@@ -1,34 +0,0 @@
-import { checkSRGBSupport } from '../../miscellaneous/webglCapabilities.js';
-import { FXTextureNode } from './FXTextureNode.js';
-
-const INSTANCES = [];
-class FXStaticTextureNode extends FXTextureNode {
-    constructor(texture) {
-        super();
-        INSTANCES.push(this);
-        const uniformName = `u_StaticTexture_${INSTANCES.length - 1}`;
-        this.affectsDepth = true;
-        this.cacheKey = "static";
-        this.uniformDeclarations = [`uniform sampler2D ${uniformName};`];
-        this.uniforms = {
-            [uniformName]: { value: texture },
-        };
-        this.helperFunctions = `
-      vec4 sampleStaticTexture(sampler2D colorTexture, vec2 uv) {
-        vec4 color = texture2D(colorTexture, uv);
-        // 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 = `sampleStaticTexture(${uniformName}, p_uv)`;
-    }
-    destroy() {
-        const index = INSTANCES.indexOf(this);
-        if (index !== -1) {
-            INSTANCES.splice(index, 1);
-        }
-    }
-}
-
-export { FXStaticTextureNode };

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

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

package/dist/nodes/texture/FXTextureNode.js

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