sparcoon 0.7.2 → 0.9.0

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

@@ -1,21 +0,0 @@
-import { FXNodeColor } from "./FXNodeColor";
-/**
- * Color node that clips a particle to a circle with a configurable soft edge
- *
- * @remarks
- * Fades alpha from fully opaque at `innerRadius` to fully transparent at the billboard edge
- * (UV radius `0.5`). An `innerRadius` of `0.5` produces a hard circular clip with no gradient.
- */
-export declare class FXNodeSphericalClip extends FXNodeColor {
-    private uniformName;
-    private innerRadiusInternal;
-    private isPrepared;
-    /**
-     * @param innerRadius - UV radius where the fade begins; must be non-negative. Defaults to `0.5`
-     */
-    constructor(innerRadius?: number);
-    /** UV radius of the fully opaque inner area */
-    get innerRadius(): number;
-    set innerRadius(value: number);
-    prepare(index: number): void;
-}

package/dist/nodes/color/FXNodeSphericalClip.js

@@ -1,54 +0,0 @@
-import { assertValidNonNegativeNumber } from '../../miscellaneous/asserts.js';
-import { CURRENT_EXPRESSION_VALUE_PLACEHOLDER } from '../FXNode.js';
-import { FXNodeColor } from './FXNodeColor.js';
-
-/**
- * Color node that clips a particle to a circle with a configurable soft edge
- *
- * @remarks
- * Fades alpha from fully opaque at `innerRadius` to fully transparent at the billboard edge
- * (UV radius `0.5`). An `innerRadius` of `0.5` produces a hard circular clip with no gradient.
- */
-class FXNodeSphericalClip extends FXNodeColor {
-    /**
-     * @param innerRadius - UV radius where the fade begins; must be non-negative. Defaults to `0.5`
-     */
-    constructor(innerRadius = 0.5) {
-        super();
-        /** @internal */
-        this.affectsDepth = true;
-        /** @internal */
-        this.cacheKey = "spherical-clip";
-        this._private_isPrepared = false;
-        assertValidNonNegativeNumber(innerRadius, "FXNodeSphericalClip.constructor.innerRadius");
-        this._private_innerRadiusInternal = innerRadius;
-    }
-    /** UV radius of the fully opaque inner area */
-    get innerRadius() {
-        return this._private_innerRadiusInternal;
-    }
-    set innerRadius(value) {
-        assertValidNonNegativeNumber(value, "FXNodeSphericalClip.innerRadius");
-        this._private_innerRadiusInternal = value;
-        if (this._private_isPrepared) {
-            this.uniforms[this._private_uniformName].value = value;
-        }
-    }
-    prepare(index) {
-        this._private_uniformName = `u_SphericalClipInnerRadius_${index}`;
-        this.uniformDeclarations = [`uniform float ${this._private_uniformName};`];
-        this.uniforms = {
-            [this._private_uniformName]: { value: this._private_innerRadiusInternal },
-        };
-        this.helperFunctions = `
-      vec4 fxApplySphericalClip(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 = `${CURRENT_EXPRESSION_VALUE_PLACEHOLDER} * fxApplySphericalClip(${this._private_uniformName})`;
-        this._private_isPrepared = true;
-    }
-}
-
-export { FXNodeSphericalClip };

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

@@ -1,6 +0,0 @@
-import { FXNodeNormal } from "./FXNodeNormal";
-/**
- * Normal node that outputs a constant face-aligned normal pointing toward the camera
- */
-export declare class FXNodeFlatNormal extends FXNodeNormal {
-}

package/dist/nodes/normal/FXNodeFlatNormal.js

@@ -1,17 +0,0 @@
-import { CURRENT_EXPRESSION_VALUE_PLACEHOLDER } from '../FXNode.js';
-import { FXNodeNormal } from './FXNodeNormal.js';
-
-/**
- * Normal node that outputs a constant face-aligned normal pointing toward the camera
- */
-class FXNodeFlatNormal extends FXNodeNormal {
-    constructor() {
-        super(...arguments);
-        /** @internal */
-        this.cacheKey = "flat-normal";
-        /** @internal */
-        this.normalExpression = `${CURRENT_EXPRESSION_VALUE_PLACEHOLDER} * vec3(0.0, 0.0, 1.0)`;
-    }
-}
-
-export { FXNodeFlatNormal };

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

@@ -1,6 +0,0 @@
-import { FXNode } from "../FXNode";
-/**
- * Abstract base class for particle normal nodes
- */
-export declare abstract class FXNodeNormal extends FXNode {
-}

package/dist/nodes/normal/FXNodeNormal.js

@@ -1,9 +0,0 @@
-import { FXNode } from '../FXNode.js';
-
-/**
- * Abstract base class for particle normal nodes
- */
-class FXNodeNormal extends FXNode {
-}
-
-export { FXNodeNormal };

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

@@ -1,6 +0,0 @@
-import { FXNodeNormal } from "./FXNodeNormal";
-/**
- * Normal node that makes flat billboard particles appear as spheres under directional lighting
- */
-export declare class FXNodeSphericalNormal extends FXNodeNormal {
-}

package/dist/nodes/normal/FXNodeSphericalNormal.js

@@ -1,24 +0,0 @@
-import { CURRENT_EXPRESSION_VALUE_PLACEHOLDER } from '../FXNode.js';
-import { FXNodeNormal } from './FXNodeNormal.js';
-
-/**
- * Normal node that makes flat billboard particles appear as spheres under directional lighting
- */
-class FXNodeSphericalNormal extends FXNodeNormal {
-    constructor() {
-        super(...arguments);
-        /** @internal */
-        this.cacheKey = "spherical-normal";
-        /** @internal */
-        this.helperFunctions = `
-    vec3 fxComputeSphericalNormal(vec2 uv) {
-      vec2 centeredUV = uv * 2.0 - 1.0;
-      return normalize(vec3(centeredUV, sqrt(max(0.0, 1.0 - dot(centeredUV, centeredUV)))));
-    }
-  `;
-        /** @internal */
-        this.normalExpression = `${CURRENT_EXPRESSION_VALUE_PLACEHOLDER} * fxComputeSphericalNormal(p_uv)`;
-    }
-}
-
-export { FXNodeSphericalNormal };

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

@@ -1,52 +0,0 @@
-import { FXTextureView } from "../../miscellaneous/texture/FXTextureView";
-import type { FXTextureConfig } from "../../miscellaneous/texture/FXTextureView.Internal";
-import { FXNodeTexture } from "./FXNodeTexture";
-/**
- * Options for {@link FXNodeAnimatedTexture}
- */
-export interface FXNodeAnimatedTextureOptions {
-    /** Texture or atlas configuration containing all animation frames */
-    texture: FXTextureConfig;
-    /** Number of frame columns in the sprite sheet */
-    columns: number;
-    /** Number of frame rows in the sprite sheet */
-    rows: number;
-    /**
-     * If true, blends between adjacent frames for smoother animation
-     *
-     * @defaultValue `false`
-     */
-    interpolate?: boolean;
-}
-/**
- * Texture node that animates through sprite sheet frames over a particle's lifetime
- *
- * @remarks
- * Frames advance from the first to the last as the particle ages. The total frame count
- * is `columns * rows`. Both `columns` and `rows` must be positive integers.
- */
-export declare class FXNodeAnimatedTexture extends FXNodeTexture {
-    private uniformTexture;
-    private uniformUVTransform;
-    private uniformColumns;
-    private uniformRows;
-    private readonly textureInternal;
-    private readonly isInterpolate;
-    private columnsInternal;
-    private rowsInternal;
-    private isPrepared;
-    /**
-     * @param options - Sprite sheet configuration
-     */
-    constructor({ texture, columns, rows, interpolate }: FXNodeAnimatedTextureOptions);
-    /** View describing the texture and its atlas region */
-    get texture(): FXTextureView;
-    /** Number of frame columns in the sprite sheet */
-    get columns(): number;
-    /** Number of frame rows in the sprite sheet */
-    get rows(): number;
-    set texture(config: FXTextureConfig);
-    set columns(value: number);
-    set rows(value: number);
-    prepare(index: number): void;
-}

package/dist/nodes/texture/FXNodeAnimatedTexture.js

@@ -1,151 +0,0 @@
-import { assertValidPositiveNumber } from '../../miscellaneous/asserts.js';
-import { FXTextureView } from '../../miscellaneous/texture/FXTextureView.js';
-import { checkSRGBSupport } from '../../miscellaneous/webglCapabilities.js';
-import { CURRENT_EXPRESSION_VALUE_PLACEHOLDER } from '../FXNode.js';
-import { FXNodeTexture } from './FXNodeTexture.js';
-
-/**
- * Texture node that animates through sprite sheet frames over a particle's lifetime
- *
- * @remarks
- * Frames advance from the first to the last as the particle ages. The total frame count
- * is `columns * rows`. Both `columns` and `rows` must be positive integers.
- */
-class FXNodeAnimatedTexture extends FXNodeTexture {
-    /**
-     * @param options - Sprite sheet configuration
-     */
-    constructor({ texture, columns, rows, interpolate = false }) {
-        super();
-        /** @internal */
-        this.affectsDepth = true;
-        this._private_isPrepared = false;
-        assertValidPositiveNumber(columns, "FXNodeAnimatedTexture.constructor.columns");
-        assertValidPositiveNumber(rows, "FXNodeAnimatedTexture.constructor.rows");
-        this._private_columnsInternal = columns;
-        this._private_rowsInternal = rows;
-        this._private_textureInternal = new FXTextureView(texture);
-        this._private_isInterpolate = interpolate;
-    }
-    /** View describing the texture and its atlas region */
-    get texture() {
-        return this._private_textureInternal;
-    }
-    /** Number of frame columns in the sprite sheet */
-    get columns() {
-        return this._private_columnsInternal;
-    }
-    /** Number of frame rows in the sprite sheet */
-    get rows() {
-        return this._private_rowsInternal;
-    }
-    set texture(config) {
-        this._private_textureInternal.set(config);
-        if (this._private_isPrepared) {
-            if (this._private_textureInternal.textureDirty) {
-                this.uniforms[this._private_uniformTexture].value = this._private_textureInternal.texture;
-                this._private_textureInternal.setTextureDirtyFalse();
-            }
-            if (this._private_textureInternal.uvTransformDirty) {
-                this._private_textureInternal.calculateUVTransform(this.uniforms[this._private_uniformUVTransform].value);
-                this._private_textureInternal.setUVTransformDirtyFalse();
-            }
-        }
-    }
-    set columns(value) {
-        assertValidPositiveNumber(value, "FXNodeAnimatedTexture.columns");
-        this._private_columnsInternal = value;
-        if (this._private_isPrepared) {
-            this.uniforms[this._private_uniformColumns].value = value;
-        }
-    }
-    set rows(value) {
-        assertValidPositiveNumber(value, "FXNodeAnimatedTexture.rows");
-        this._private_rowsInternal = value;
-        if (this._private_isPrepared) {
-            this.uniforms[this._private_uniformRows].value = value;
-        }
-    }
-    prepare(index) {
-        this._private_uniformTexture = `u_AnimatedTexture_${index}`;
-        this._private_uniformUVTransform = `u_AnimatedTextureUVTransform_${index}`;
-        this._private_uniformColumns = `u_AnimatedTextureColumns_${index}`;
-        this._private_uniformRows = `u_AnimatedTextureRows_${index}`;
-        const uvTransform = this._private_textureInternal.calculateUVTransform();
-        this._private_textureInternal.setTextureDirtyFalse();
-        this._private_textureInternal.setUVTransformDirtyFalse();
-        const gammaCorrection = checkSRGBSupport()
-            ? ""
-            : "color = vec4(pow(color.rgb, vec3(2.2)), color.a);";
-        this.cacheKey = this._private_isInterpolate ? "animated-texture-interpolated" : "animated-texture";
-        this.uniformDeclarations = [
-            `uniform sampler2D ${this._private_uniformTexture};`,
-            `uniform mat3 ${this._private_uniformUVTransform};`,
-            `uniform float ${this._private_uniformColumns};`,
-            `uniform float ${this._private_uniformRows};`,
-        ];
-        this.uniforms = {
-            [this._private_uniformTexture]: { value: this._private_textureInternal.texture },
-            [this._private_uniformUVTransform]: { value: uvTransform },
-            [this._private_uniformColumns]: { value: this._private_columnsInternal },
-            [this._private_uniformRows]: { value: this._private_rowsInternal },
-        };
-        this.helperFunctions = this._private_isInterpolate ? `
-        vec2 fxFrameToUV(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 fxSampleAnimatedTexture(sampler2D spriteSheet, mat3 uvTransform, 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);
-
-          vec2 currentUV = (uvTransform * vec3(fxFrameToUV(uv, currentFrame, columns, rows), 1.0)).xy;
-          vec2 nextUV    = (uvTransform * vec3(fxFrameToUV(uv, nextFrame,    columns, rows), 1.0)).xy;
-
-          vec4 color = mix(
-            texture2D(spriteSheet, currentUV),
-            texture2D(spriteSheet, nextUV),
-            blendWeight
-          );
-
-          // Apply gamma correction when sRGB textures are not natively supported
-          ${gammaCorrection}
-
-          return color;
-        }
-      `
-            : `
-        vec4 fxSampleAnimatedTexture(sampler2D spriteSheet, mat3 uvTransform, 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, then apply atlas transform
-          vec2 frameUV = vec2((column + uv.x) / columns, 1.0 - (row + 1.0 - uv.y) / rows);
-          vec2 atlasUV = (uvTransform * vec3(frameUV, 1.0)).xy;
-          vec4 color = texture2D(spriteSheet, atlasUV);
-
-          // Apply gamma correction when sRGB textures are not natively supported
-          ${gammaCorrection}
-
-          return color;
-        }
-      `;
-        this.colorExpression = `${CURRENT_EXPRESSION_VALUE_PLACEHOLDER} * fxSampleAnimatedTexture(${this._private_uniformTexture}, ${this._private_uniformUVTransform}, p_uv, ${this._private_uniformColumns}, ${this._private_uniformRows})`;
-        this._private_isPrepared = true;
-    }
-}
-
-export { FXNodeAnimatedTexture };

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

@@ -1,20 +0,0 @@
-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 uniformTexture;
-    private uniformUVTransform;
-    private readonly textureInternal;
-    private isPrepared;
-    /**
-     * @param config - Texture or atlas configuration applied to every particle
-     */
-    constructor(config: FXTextureConfig);
-    /** View describing the texture and its atlas region */
-    get texture(): FXTextureView;
-    set texture(config: FXTextureConfig);
-    prepare(index: number): void;
-}

package/dist/nodes/texture/FXNodeStaticTexture.js

@@ -1,67 +0,0 @@
-import { FXTextureView } from '../../miscellaneous/texture/FXTextureView.js';
-import { checkSRGBSupport } from '../../miscellaneous/webglCapabilities.js';
-import { CURRENT_EXPRESSION_VALUE_PLACEHOLDER } from '../FXNode.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();
-        /** @internal */
-        this.affectsDepth = true;
-        /** @internal */
-        this.cacheKey = "static-texture";
-        this._private_isPrepared = false;
-        this._private_textureInternal = new FXTextureView(config);
-    }
-    /** View describing the texture and its atlas region */
-    get texture() {
-        return this._private_textureInternal;
-    }
-    set texture(config) {
-        this._private_textureInternal.set(config);
-        if (this._private_isPrepared) {
-            if (this._private_textureInternal.textureDirty) {
-                this.uniforms[this._private_uniformTexture].value = this._private_textureInternal.texture;
-                this._private_textureInternal.setTextureDirtyFalse();
-            }
-            if (this._private_textureInternal.uvTransformDirty) {
-                this._private_textureInternal.calculateUVTransform(this.uniforms[this._private_uniformUVTransform].value);
-                this._private_textureInternal.setUVTransformDirtyFalse();
-            }
-        }
-    }
-    prepare(index) {
-        this._private_uniformTexture = `u_StaticTexture_${index}`;
-        this._private_uniformUVTransform = `u_StaticTextureUVTransform_${index}`;
-        const uvTransform = this._private_textureInternal.calculateUVTransform();
-        this._private_textureInternal.setTextureDirtyFalse();
-        this._private_textureInternal.setUVTransformDirtyFalse();
-        this.uniformDeclarations = [
-            `uniform sampler2D ${this._private_uniformTexture};`,
-            `uniform mat3 ${this._private_uniformUVTransform};`,
-        ];
-        this.uniforms = {
-            [this._private_uniformTexture]: { value: this._private_textureInternal.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 = `${CURRENT_EXPRESSION_VALUE_PLACEHOLDER} * fxSampleStaticTexture(${this._private_uniformTexture}, ${this._private_uniformUVTransform}, p_uv)`;
-        this._private_isPrepared = true;
-    }
-}
-
-export { FXNodeStaticTexture };

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

@@ -1,6 +0,0 @@
-import { FXNode } from "../FXNode";
-/**
- * Abstract base class for particle texture nodes
- */
-export declare abstract class FXNodeTexture extends FXNode {
-}

package/dist/nodes/texture/FXNodeTexture.js

@@ -1,9 +0,0 @@
-import { FXNode } from '../FXNode.js';
-
-/**
- * Abstract base class for particle texture nodes
- */
-class FXNodeTexture extends FXNode {
-}
-
-export { FXNodeTexture };