@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/services/animation/WindAnimator.js

@@ -0,0 +1,263 @@
+/**
+ * Wind Animator
+ *
+ * Animates trees, grass, and ground vegetation with realistic wind effects.
+ * Uses layered sine waves and noise for organic movement:
+ * - Primary sway (slow, large motion)
+ * - Secondary sway (faster, smaller)
+ * - Gusts (occasional stronger bursts)
+ * - Height-based scaling (trunk still, tips move most)
+ */
+import { PerlinNoise } from "../noise/PerlinNoise.js";
+const DEFAULT_CONFIG = {
+    enabled: true,
+    strength: 0.3,
+    direction: Math.PI * 0.1, // Slight right lean
+    frequency: 0.5,
+    secondaryStrength: 0.3,
+    secondaryFrequency: 1.5,
+    gustEnabled: true,
+    gustStrength: 2.0,
+    gustFrequency: 0.05, // ~5% chance per second
+    gustDuration: 2.0,
+    heightExponent: 2.0,
+    trunkStiffness: 0.8,
+    spatialVariation: 0.3,
+    temporalVariation: 0.2,
+};
+export class WindAnimator {
+    config;
+    noise;
+    state;
+    constructor(config = {}, seed) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.noise = new PerlinNoise(seed);
+        this.state = {
+            time: 0,
+            currentStrength: this.config.strength,
+            gustActive: false,
+            gustIntensity: 0,
+            gustTimeRemaining: 0,
+        };
+    }
+    /**
+     * Update wind state
+     * @param deltaTime Time since last update in seconds
+     */
+    update(deltaTime) {
+        if (!this.config.enabled)
+            return;
+        this.state.time += deltaTime;
+        // Update gust state
+        this.updateGusts(deltaTime);
+        // Calculate current effective strength
+        const baseStrength = this.config.strength;
+        const temporalNoise = this.noise.noise2D(this.state.time * 0.1, 0) * this.config.temporalVariation;
+        this.state.currentStrength =
+            baseStrength * (1 + temporalNoise) * (1 + this.state.gustIntensity);
+    }
+    updateGusts(deltaTime) {
+        if (!this.config.gustEnabled) {
+            this.state.gustActive = false;
+            this.state.gustIntensity = 0;
+            return;
+        }
+        if (this.state.gustActive) {
+            // Gust in progress
+            this.state.gustTimeRemaining -= deltaTime;
+            if (this.state.gustTimeRemaining <= 0) {
+                // Gust ending
+                this.state.gustActive = false;
+                this.state.gustIntensity = 0;
+            }
+            else {
+                // Gust envelope (attack-sustain-release)
+                const progress = 1 - this.state.gustTimeRemaining / this.config.gustDuration;
+                if (progress < 0.2) {
+                    // Attack
+                    this.state.gustIntensity = (progress / 0.2) * this.config.gustStrength;
+                }
+                else if (progress < 0.7) {
+                    // Sustain
+                    this.state.gustIntensity =
+                        this.config.gustStrength * (0.8 + Math.random() * 0.2);
+                }
+                else {
+                    // Release
+                    this.state.gustIntensity =
+                        this.config.gustStrength * ((1 - progress) / 0.3);
+                }
+            }
+        }
+        else {
+            // Check for new gust
+            if (Math.random() < this.config.gustFrequency * deltaTime) {
+                this.state.gustActive = true;
+                this.state.gustTimeRemaining = this.config.gustDuration;
+            }
+        }
+    }
+    /**
+     * Calculate displacement for a point at given position and height
+     * @param worldX World X position
+     * @param worldY World Y position
+     * @param heightRatio 0-1, 0 = ground, 1 = top of element
+     * @param scale Size multiplier for the element
+     */
+    getDisplacement(worldX, worldY, heightRatio, scale = 1) {
+        if (!this.config.enabled) {
+            return { x: 0, y: 0, rotation: 0 };
+        }
+        const { direction, frequency, secondaryStrength, secondaryFrequency, heightExponent, trunkStiffness, spatialVariation, } = this.config;
+        // Height response - bottom moves less than top
+        const adjustedHeight = Math.max(0, heightRatio - trunkStiffness * (1 - heightRatio));
+        const heightFactor = Math.pow(adjustedHeight, heightExponent);
+        // Spatial variation noise
+        const spatialNoise = this.noise.noise2D(worldX * 0.003, worldY * 0.003) * spatialVariation;
+        const localStrength = this.state.currentStrength * (1 + spatialNoise);
+        // Primary sway
+        const primaryPhase = this.state.time * frequency +
+            worldX * 0.001 +
+            this.noise.noise2D(worldX * 0.01, 0) * 2;
+        const primarySway = Math.sin(primaryPhase) * localStrength;
+        // Secondary sway (faster, smaller)
+        const secondaryPhase = this.state.time * secondaryFrequency +
+            worldX * 0.002 +
+            this.noise.noise2D(worldX * 0.02, worldY * 0.01) * 3;
+        const secondarySway = Math.sin(secondaryPhase) * localStrength * secondaryStrength;
+        // Combine sways
+        const totalSway = (primarySway + secondarySway) * heightFactor * scale * 20;
+        // Calculate displacement in wind direction
+        const dx = Math.cos(direction) * totalSway;
+        const dy = Math.sin(direction) * totalSway * 0.3; // Less vertical motion
+        // Rotation based on sway
+        const rotation = totalSway * 0.01 * heightFactor;
+        return { x: dx, y: dy, rotation };
+    }
+    /**
+     * Calculate displacement for grass blade
+     * Grass is more responsive to wind
+     */
+    getGrassDisplacement(worldX, heightRatio) {
+        if (!this.config.enabled) {
+            return { x: 0, y: 0, rotation: 0 };
+        }
+        const { direction, frequency, secondaryFrequency, spatialVariation } = this.config;
+        // Grass is very responsive
+        const heightFactor = Math.pow(heightRatio, 1.5);
+        const grassMultiplier = 2.0;
+        // Spatial variation
+        const spatialNoise = this.noise.noise2D(worldX * 0.01, 0) * spatialVariation;
+        const localStrength = this.state.currentStrength * (1 + spatialNoise) * grassMultiplier;
+        // Fast, responsive sway
+        const primaryPhase = this.state.time * frequency * 1.5 +
+            worldX * 0.005 +
+            this.noise.noise2D(worldX * 0.05, this.state.time * 0.5) * 2;
+        const primarySway = Math.sin(primaryPhase);
+        // Faster secondary
+        const secondaryPhase = this.state.time * secondaryFrequency * 2 +
+            worldX * 0.008;
+        const secondarySway = Math.sin(secondaryPhase) * 0.4;
+        // Tertiary flutter
+        const flutterPhase = this.state.time * 5 + worldX * 0.02;
+        const flutter = Math.sin(flutterPhase) * 0.15;
+        const totalSway = (primarySway + secondarySway + flutter) * localStrength * heightFactor;
+        const dx = Math.cos(direction) * totalSway * 15;
+        const dy = Math.sin(direction) * totalSway * 5;
+        const rotation = totalSway * 0.3;
+        return { x: dx, y: dy, rotation };
+    }
+    /**
+     * Get current wind state for UI display
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get effective wind strength at current moment
+     */
+    getCurrentStrength() {
+        return this.state.currentStrength;
+    }
+    /**
+     * Check if a gust is currently active
+     */
+    isGustActive() {
+        return this.state.gustActive;
+    }
+    /**
+     * Manually trigger a gust
+     */
+    triggerGust() {
+        if (!this.config.gustEnabled)
+            return;
+        this.state.gustActive = true;
+        this.state.gustTimeRemaining = this.config.gustDuration;
+    }
+    /**
+     * Set wind configuration
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Reset animation state
+     */
+    reset() {
+        this.state = {
+            time: 0,
+            currentStrength: this.config.strength,
+            gustActive: false,
+            gustIntensity: 0,
+            gustTimeRemaining: 0,
+        };
+    }
+}
+/**
+ * Wind presets for different moods
+ */
+export const WIND_PRESETS = {
+    calm: {
+        strength: 0.1,
+        frequency: 0.3,
+        secondaryStrength: 0.2,
+        gustEnabled: false,
+    },
+    gentle: {
+        strength: 0.25,
+        frequency: 0.5,
+        secondaryStrength: 0.3,
+        gustEnabled: true,
+        gustFrequency: 0.02,
+        gustStrength: 1.5,
+    },
+    moderate: {
+        strength: 0.4,
+        frequency: 0.6,
+        secondaryStrength: 0.35,
+        gustEnabled: true,
+        gustFrequency: 0.05,
+        gustStrength: 2.0,
+    },
+    strong: {
+        strength: 0.6,
+        frequency: 0.8,
+        secondaryStrength: 0.4,
+        gustEnabled: true,
+        gustFrequency: 0.1,
+        gustStrength: 2.5,
+    },
+    stormy: {
+        strength: 0.8,
+        frequency: 1.0,
+        secondaryStrength: 0.5,
+        gustEnabled: true,
+        gustFrequency: 0.15,
+        gustStrength: 3.0,
+        gustDuration: 3.0,
+    },
+};
+//# sourceMappingURL=WindAnimator.js.map

package/dist/backgrounds/firefly-forest/services/animation/WindAnimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindAnimator.js","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/services/animation/WindAnimator.ts"],"names":[],"mappings":"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"}

package/dist/backgrounds/firefly-forest/services/atmosphere/AtmosphericFogSystem.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Atmospheric Fog System
+ *
+ * Creates layered fog effects for depth perception in the forest.
+ * Combines multiple fog techniques:
+ * - Distance-based color attenuation
+ * - Ground fog with density gradient
+ * - Wispy fog patches
+ * - Mist layers between trees
+ */
+export interface FogConfig {
+    enabled: boolean;
+    density: number;
+    distanceFog: {
+        enabled: boolean;
+        nearColor: string;
+        farColor: string;
+        startDistance: number;
+        endDistance: number;
+    };
+    groundFog: {
+        enabled: boolean;
+        color: string;
+        maxHeight: number;
+        density: number;
+        waviness: number;
+        animationSpeed: number;
+    };
+    wispyFog: {
+        enabled: boolean;
+        color: string;
+        patchCount: number;
+        opacity: number;
+        scale: number;
+        drift: number;
+    };
+    mistLayers: {
+        enabled: boolean;
+        layerCount: number;
+        color: string;
+        minOpacity: number;
+        maxOpacity: number;
+    };
+}
+export interface FogLayer {
+    type: "distance" | "ground" | "wispy" | "mist";
+    depth: number;
+    opacity: number;
+    data: FogPatch | GroundFogData | MistLayerData | null;
+}
+export interface FogPatch {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    opacity: number;
+    phase: number;
+}
+export interface GroundFogData {
+    points: Array<{
+        x: number;
+        y: number;
+    }>;
+    color: string;
+    opacity: number;
+}
+export interface MistLayerData {
+    y: number;
+    height: number;
+    opacity: number;
+    color: string;
+}
+export declare class AtmosphericFogSystem {
+    private config;
+    private noise;
+    private time;
+    private wispyPatches;
+    private mistLayers;
+    private width;
+    private height;
+    constructor(width: number, height: number, config?: Partial<FogConfig>, seed?: number);
+    private mergeConfig;
+    private initializeWispyPatches;
+    private initializeMistLayers;
+    /**
+     * Update fog animation state
+     * @param deltaTime Time since last update in milliseconds
+     */
+    update(deltaTime: number): void;
+    private updateWispyPatches;
+    /**
+     * Get distance fog opacity for a given depth value
+     * @param depth 0-1, 0 = near, 1 = far
+     */
+    getDistanceFogOpacity(depth: number): number;
+    /**
+     * Get fog color at a specific depth (for blending with tree colors)
+     * @param depth 0-1
+     */
+    getDistanceFogColor(depth: number): string;
+    /**
+     * Generate ground fog edge points for current time
+     */
+    generateGroundFog(): GroundFogData | null;
+    /**
+     * Get current wispy fog patches
+     */
+    getWispyPatches(): FogPatch[];
+    /**
+     * Get mist layer data for rendering
+     */
+    getMistLayers(): MistLayerData[];
+    /**
+     * Get all fog layers sorted by depth for proper rendering
+     */
+    getAllFogLayers(): FogLayer[];
+    /**
+     * Apply fog color/opacity to a tree color based on its depth
+     */
+    applyDistanceFog(treeColor: string, depth: number): {
+        color: string;
+        opacity: number;
+    };
+    /**
+     * Resize fog system to new dimensions
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Set fog configuration at runtime
+     */
+    setConfig(config: Partial<FogConfig>): void;
+    getConfig(): FogConfig;
+    private lerpColorString;
+}
+//# sourceMappingURL=AtmosphericFogSystem.d.ts.map

package/dist/backgrounds/firefly-forest/services/atmosphere/AtmosphericFogSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AtmosphericFogSystem.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/services/atmosphere/AtmosphericFogSystem.ts"],"names":[],"mappings":"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"}