@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/services/atmosphere/AtmosphericFogSystem.js

@@ -0,0 +1,286 @@
+/**
+ * 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
+ */
+import { PerlinNoise } from "../noise/PerlinNoise.js";
+const DEFAULT_CONFIG = {
+    enabled: true,
+    density: 0.5,
+    distanceFog: {
+        enabled: true,
+        nearColor: "rgba(20, 30, 40, 0)",
+        farColor: "rgba(15, 25, 35, 0.8)",
+        startDistance: 0,
+        endDistance: 1,
+    },
+    groundFog: {
+        enabled: true,
+        color: "rgba(180, 200, 210, 0.3)",
+        maxHeight: 0.15,
+        density: 0.6,
+        waviness: 0.5,
+        animationSpeed: 0.001,
+    },
+    wispyFog: {
+        enabled: true,
+        color: "rgba(150, 180, 200, 0.15)",
+        patchCount: 8,
+        opacity: 0.4,
+        scale: 1,
+        drift: 0.5,
+    },
+    mistLayers: {
+        enabled: true,
+        layerCount: 3,
+        color: "rgba(100, 130, 160, 0.1)",
+        minOpacity: 0.05,
+        maxOpacity: 0.15,
+    },
+};
+export class AtmosphericFogSystem {
+    config;
+    noise;
+    time = 0;
+    wispyPatches = [];
+    mistLayers = [];
+    width;
+    height;
+    constructor(width, height, config = {}, seed) {
+        this.width = width;
+        this.height = height;
+        this.config = this.mergeConfig(DEFAULT_CONFIG, config);
+        this.noise = new PerlinNoise(seed);
+        this.initializeWispyPatches();
+        this.initializeMistLayers();
+    }
+    mergeConfig(defaults, overrides) {
+        return {
+            ...defaults,
+            ...overrides,
+            distanceFog: { ...defaults.distanceFog, ...overrides.distanceFog },
+            groundFog: { ...defaults.groundFog, ...overrides.groundFog },
+            wispyFog: { ...defaults.wispyFog, ...overrides.wispyFog },
+            mistLayers: { ...defaults.mistLayers, ...overrides.mistLayers },
+        };
+    }
+    initializeWispyPatches() {
+        const { patchCount, scale } = this.config.wispyFog;
+        this.wispyPatches = [];
+        for (let i = 0; i < patchCount; i++) {
+            const baseWidth = (100 + Math.random() * 200) * scale;
+            const baseHeight = (60 + Math.random() * 100) * scale;
+            this.wispyPatches.push({
+                x: Math.random() * this.width,
+                y: this.height * (0.3 + Math.random() * 0.5), // Middle-lower portion
+                width: baseWidth,
+                height: baseHeight,
+                opacity: 0.2 + Math.random() * 0.3,
+                phase: Math.random() * Math.PI * 2,
+            });
+        }
+    }
+    initializeMistLayers() {
+        const { layerCount, minOpacity, maxOpacity } = this.config.mistLayers;
+        this.mistLayers = [];
+        for (let i = 0; i < layerCount; i++) {
+            const t = i / (layerCount - 1 || 1);
+            this.mistLayers.push({
+                y: this.height * (0.4 + t * 0.4), // Distribute in lower half
+                height: 20 + Math.random() * 40,
+                opacity: minOpacity + (maxOpacity - minOpacity) * Math.random(),
+                color: this.config.mistLayers.color,
+            });
+        }
+    }
+    /**
+     * Update fog animation state
+     * @param deltaTime Time since last update in milliseconds
+     */
+    update(deltaTime) {
+        this.time += deltaTime;
+        // Update wispy patches
+        if (this.config.wispyFog.enabled) {
+            this.updateWispyPatches(deltaTime);
+        }
+    }
+    updateWispyPatches(deltaTime) {
+        const { drift } = this.config.wispyFog;
+        for (const patch of this.wispyPatches) {
+            // Drift slowly
+            patch.x += Math.sin(this.time * 0.0001 + patch.phase) * drift * 0.1;
+            // Subtle vertical bob
+            patch.y +=
+                Math.cos(this.time * 0.00015 + patch.phase * 2) * drift * 0.05;
+            // Wrap around
+            if (patch.x > this.width + patch.width) {
+                patch.x = -patch.width;
+            }
+            else if (patch.x < -patch.width) {
+                patch.x = this.width + patch.width;
+            }
+        }
+    }
+    /**
+     * Get distance fog opacity for a given depth value
+     * @param depth 0-1, 0 = near, 1 = far
+     */
+    getDistanceFogOpacity(depth) {
+        if (!this.config.distanceFog.enabled)
+            return 0;
+        const { startDistance, endDistance } = this.config.distanceFog;
+        const { density } = this.config;
+        if (depth <= startDistance)
+            return 0;
+        if (depth >= endDistance)
+            return density;
+        const t = (depth - startDistance) / (endDistance - startDistance);
+        return t * density;
+    }
+    /**
+     * Get fog color at a specific depth (for blending with tree colors)
+     * @param depth 0-1
+     */
+    getDistanceFogColor(depth) {
+        const { nearColor, farColor } = this.config.distanceFog;
+        return this.lerpColorString(nearColor, farColor, depth);
+    }
+    /**
+     * Generate ground fog edge points for current time
+     */
+    generateGroundFog() {
+        if (!this.config.groundFog.enabled)
+            return null;
+        const { maxHeight, waviness, animationSpeed, color, density } = this.config.groundFog;
+        const fogTop = this.height - this.height * maxHeight;
+        const points = [];
+        // Generate wavy top edge
+        const pointCount = Math.ceil(this.width / 30);
+        for (let i = 0; i <= pointCount; i++) {
+            const x = (i / pointCount) * this.width;
+            // Multi-octave noise for organic edge
+            const noiseVal = this.noise.fbm(x * 0.005 + this.time * animationSpeed, this.time * animationSpeed * 0.5, 4) *
+                waviness *
+                50;
+            // Secondary faster wave
+            const fastWave = Math.sin(x * 0.02 + this.time * animationSpeed * 3) * waviness * 15;
+            points.push({
+                x,
+                y: fogTop + noiseVal + fastWave,
+            });
+        }
+        // Close the polygon
+        points.push({ x: this.width, y: this.height });
+        points.push({ x: 0, y: this.height });
+        return {
+            points,
+            color,
+            opacity: density * this.config.density,
+        };
+    }
+    /**
+     * Get current wispy fog patches
+     */
+    getWispyPatches() {
+        if (!this.config.wispyFog.enabled)
+            return [];
+        return this.wispyPatches.map((patch) => ({
+            ...patch,
+            opacity: patch.opacity * this.config.wispyFog.opacity * this.config.density,
+        }));
+    }
+    /**
+     * Get mist layer data for rendering
+     */
+    getMistLayers() {
+        if (!this.config.mistLayers.enabled)
+            return [];
+        return this.mistLayers.map((layer) => ({
+            ...layer,
+            opacity: layer.opacity * this.config.density,
+        }));
+    }
+    /**
+     * Get all fog layers sorted by depth for proper rendering
+     */
+    getAllFogLayers() {
+        const layers = [];
+        // Ground fog (rendered near the bottom)
+        const groundFog = this.generateGroundFog();
+        if (groundFog) {
+            layers.push({
+                type: "ground",
+                depth: 0.9,
+                opacity: groundFog.opacity,
+                data: groundFog,
+            });
+        }
+        // Mist layers
+        for (const mist of this.getMistLayers()) {
+            layers.push({
+                type: "mist",
+                depth: 0.5 + (mist.y / this.height) * 0.3,
+                opacity: mist.opacity,
+                data: mist,
+            });
+        }
+        // Wispy patches
+        for (const patch of this.getWispyPatches()) {
+            layers.push({
+                type: "wispy",
+                depth: 0.4 + Math.random() * 0.3,
+                opacity: patch.opacity,
+                data: patch,
+            });
+        }
+        return layers.sort((a, b) => a.depth - b.depth);
+    }
+    /**
+     * Apply fog color/opacity to a tree color based on its depth
+     */
+    applyDistanceFog(treeColor, depth) {
+        const fogOpacity = this.getDistanceFogOpacity(depth);
+        const fogColor = this.getDistanceFogColor(depth);
+        // For silhouettes, we typically just adjust opacity
+        // The fog color can be blended in the rendering pass
+        return {
+            color: treeColor,
+            opacity: 1 - fogOpacity * 0.7, // Reduce tree opacity in fog
+        };
+    }
+    /**
+     * Resize fog system to new dimensions
+     */
+    resize(width, height) {
+        this.width = width;
+        this.height = height;
+        this.initializeWispyPatches();
+        this.initializeMistLayers();
+    }
+    /**
+     * Set fog configuration at runtime
+     */
+    setConfig(config) {
+        this.config = this.mergeConfig(this.config, config);
+        if (config.wispyFog?.patchCount !== undefined) {
+            this.initializeWispyPatches();
+        }
+        if (config.mistLayers?.layerCount !== undefined) {
+            this.initializeMistLayers();
+        }
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    lerpColorString(color1, color2, t) {
+        // This is a simplified version - proper implementation would parse and blend
+        // For now, just return the appropriate color based on threshold
+        return t < 0.5 ? color1 : color2;
+    }
+}
+//# sourceMappingURL=AtmosphericFogSystem.js.map

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

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

package/dist/backgrounds/firefly-forest/services/composition/ParallaxForestComposer.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Parallax Forest Composer
+ *
+ * Orchestrates multiple depth layers of trees with parallax scrolling,
+ * atmospheric fog, and natural tree distribution.
+ *
+ * Creates immersive depth through:
+ * - 4-6 depth layers from far to near
+ * - Size/opacity scaling with depth
+ * - Parallax movement rates
+ * - Atmospheric fog integration
+ */
+import { type GeneratedTree } from "../trees/SpaceColonizationTree.js";
+import { type GeneratedConifer } from "../trees/StochasticConiferTree.js";
+import { type GeneratedBareTree } from "../trees/BareTree.js";
+export type TreeType = "deciduous" | "conifer" | "bare";
+export interface ForestTreeInstance {
+    id: string;
+    x: number;
+    baseY: number;
+    scale: number;
+    depth: number;
+    layerIndex: number;
+    treeType: TreeType;
+    subType: string;
+    generatedData: GeneratedTree | GeneratedConifer | GeneratedBareTree;
+    opacity: number;
+    parallaxOffset: number;
+}
+export interface ForestLayer {
+    index: number;
+    depth: number;
+    treeCount: number;
+    trees: ForestTreeInstance[];
+    parallaxFactor: number;
+    scale: number;
+    opacity: number;
+    yOffset: number;
+    fogColor: string;
+    fogOpacity: number;
+}
+export interface ParallaxForestConfig {
+    width: number;
+    height: number;
+    layerCount: number;
+    treesPerLayer: number[];
+    layerDepths: number[];
+    treeSpacing: number;
+    heightVariation: number;
+    groundLineY: number;
+    coniferRatio: number;
+    deciduousRatio: number;
+    bareRatio: number;
+    parallaxRange: number;
+    parallaxSmoothing: number;
+    fogNearColor: string;
+    fogFarColor: string;
+    fogDensity: number;
+    nearScale: number;
+    farScale: number;
+}
+export declare class ParallaxForestComposer {
+    private config;
+    private noise;
+    private layers;
+    private treeIdCounter;
+    private deciduousGenerator;
+    private coniferGenerators;
+    private bareGenerators;
+    constructor(config?: Partial<ParallaxForestConfig>, seed?: number);
+    /**
+     * Generate all forest layers and trees
+     */
+    generate(): ForestLayer[];
+    private generateLayer;
+    private generateTreesForLayer;
+    private generateTree;
+    private distributeTreePositions;
+    /**
+     * Update parallax positions based on input value
+     * @param parallaxValue -1 to 1, typically from mouse/tilt
+     */
+    updateParallax(parallaxValue: number): void;
+    /**
+     * Get all layers in order (far to near)
+     */
+    getLayers(): ForestLayer[];
+    /**
+     * Get all trees across all layers, sorted for rendering
+     */
+    getAllTreesSorted(): ForestTreeInstance[];
+    /**
+     * Regenerate trees in a specific layer
+     */
+    regenerateLayer(layerIndex: number): void;
+    /**
+     * Update canvas dimensions and regenerate
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Get fog properties for a specific depth
+     */
+    getFogAtDepth(depth: number): {
+        color: string;
+        opacity: number;
+    };
+    private lerpColor;
+    private hexToRgb;
+    getConfig(): ParallaxForestConfig;
+    getStats(): {
+        layerCount: number;
+        totalTrees: number;
+        treesByType: Record<TreeType, number>;
+    };
+}
+//# sourceMappingURL=ParallaxForestComposer.d.ts.map

package/dist/backgrounds/firefly-forest/services/composition/ParallaxForestComposer.d.ts.map

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