@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/services/ProceduralForestSystem.js

@@ -0,0 +1,486 @@
+/**
+ * Procedural Forest System
+ *
+ * Master orchestrator for the A+++ procedural forest background.
+ * Coordinates all subsystems to create an immersive, layered forest scene:
+ *
+ * - ParallaxForestComposer: Multi-layer tree distribution with parallax
+ * - AtmosphericFogSystem: Distance fog, ground mist, wispy patches
+ * - GroundLayerSystem: Bushes, grass, ferns
+ * - WindAnimator: Organic sway animation for vegetation
+ * - EasterEggSystem: Owls, bats, moon, shooting stars
+ *
+ * Provides unified API for initialization, updates, and rendering data.
+ */
+import { ParallaxForestComposer, } from "./composition/ParallaxForestComposer.js";
+import { AtmosphericFogSystem, } from "./atmosphere/AtmosphericFogSystem.js";
+import { GroundLayerSystem, } from "./ground/GroundLayerSystem.js";
+import { WindAnimator, WIND_PRESETS, } from "./animation/WindAnimator.js";
+import { EasterEggSystem, } from "./ambient/EasterEggSystem.js";
+import { MoonRenderer, } from "../../../core/services/MoonRenderer.js";
+const DEFAULT_CONFIG = {
+    width: 1920,
+    height: 1080,
+    seed: undefined,
+    enabled: true,
+    parallaxEnabled: true,
+    windEnabled: true,
+    fogEnabled: true,
+    groundEnabled: true,
+    easterEggsEnabled: true,
+    moonEnabled: true,
+};
+export class ProceduralForestSystem {
+    config;
+    // Subsystems
+    forestComposer;
+    fogSystem;
+    groundSystem;
+    windAnimator;
+    easterEggSystem;
+    moonRenderer;
+    // State
+    initialized = false;
+    time = 0;
+    lastUpdateTime = 0;
+    quality = "high";
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        const { width, height, seed } = this.config;
+        // Initialize subsystems
+        this.forestComposer = new ParallaxForestComposer({
+            width,
+            height,
+            ...this.config.forest,
+        }, seed);
+        this.fogSystem = new AtmosphericFogSystem(width, height, this.config.fog, seed ? seed + 1000 : undefined);
+        this.groundSystem = new GroundLayerSystem({
+            width,
+            height,
+            ...this.config.ground,
+        }, seed ? seed + 2000 : undefined);
+        this.windAnimator = new WindAnimator(this.config.wind, seed ? seed + 3000 : undefined);
+        this.easterEggSystem = new EasterEggSystem(width, height, this.config.easterEggs, seed ? seed + 4000 : undefined);
+        // Initialize moon renderer with real lunar phase
+        this.moonRenderer = new MoonRenderer(width, height, {
+            useRealPhase: true,
+            x: 0.15,
+            y: 0.12,
+            radiusFraction: 0.04,
+            maxRadius: 60,
+            ...this.config.moon,
+        });
+    }
+    /**
+     * Initialize the system - generates all content
+     * Call this once at startup
+     */
+    initialize() {
+        this.generate();
+        this.lastUpdateTime = 0;
+    }
+    /**
+     * Generate all procedural content
+     * Call this once at startup or when regenerating the scene
+     */
+    generate() {
+        // Generate trees across all layers
+        this.forestComposer.generate();
+        // Generate ground vegetation
+        this.groundSystem.generate();
+        // Place owls on some trees
+        this.placeOwlsOnTrees();
+        this.initialized = true;
+    }
+    /**
+     * Place owls on suitable trees
+     */
+    placeOwlsOnTrees() {
+        const layers = this.forestComposer.getLayers();
+        // Only place owls on near/mid layers (depth > 0.4)
+        for (const layer of layers) {
+            if (layer.depth < 0.4)
+                continue;
+            for (const tree of layer.trees) {
+                // ~10% chance per tree, prefer conifers and bare trees
+                const chance = tree.treeType === "conifer" ? 0.15 : tree.treeType === "bare" ? 0.12 : 0.08;
+                if (Math.random() < chance) {
+                    // Place owl near top of tree
+                    const owl = this.easterEggSystem.addOwl(tree.x, tree.baseY - 80 * tree.scale, tree.scale * 0.8);
+                    if (!owl)
+                        break; // Max owls reached
+                }
+            }
+        }
+    }
+    /**
+     * Update all animated systems
+     * @param currentTime Current timestamp in milliseconds (from requestAnimationFrame)
+     */
+    update(currentTime) {
+        if (!this.config.enabled)
+            return;
+        // Calculate deltaTime in seconds
+        const deltaTime = this.lastUpdateTime > 0 ? (currentTime - this.lastUpdateTime) / 1000 : 0.016;
+        this.lastUpdateTime = currentTime;
+        this.time += deltaTime;
+        // Update wind
+        if (this.config.windEnabled) {
+            this.windAnimator.update(deltaTime);
+        }
+        // Update fog animations
+        if (this.config.fogEnabled) {
+            this.fogSystem.update(deltaTime * 1000); // Fog uses milliseconds
+        }
+        // Update easter eggs (bats, shooting stars, etc.)
+        if (this.config.easterEggsEnabled) {
+            this.easterEggSystem.update(deltaTime);
+        }
+    }
+    /**
+     * Update parallax based on input (mouse position, device tilt, etc.)
+     * @param value -1 to 1
+     */
+    updateParallax(value) {
+        if (this.config.parallaxEnabled) {
+            this.forestComposer.updateParallax(value);
+        }
+    }
+    // ============================================
+    // GETTERS FOR RENDERING
+    // ============================================
+    /**
+     * Get all forest layers (far to near)
+     */
+    getLayers() {
+        return this.forestComposer.getLayers();
+    }
+    /**
+     * Get all trees sorted for rendering
+     */
+    getAllTrees() {
+        return this.forestComposer.getAllTreesSorted();
+    }
+    /**
+     * Get wind displacement for a point
+     */
+    getWindDisplacement(worldX, worldY, heightRatio, scale) {
+        if (!this.config.windEnabled) {
+            return { x: 0, y: 0, rotation: 0 };
+        }
+        return this.windAnimator.getDisplacement(worldX, worldY, heightRatio, scale);
+    }
+    /**
+     * Get wind displacement for grass
+     */
+    getGrassWindDisplacement(worldX, heightRatio) {
+        if (!this.config.windEnabled) {
+            return { x: 0, y: 0, rotation: 0 };
+        }
+        return this.windAnimator.getGrassDisplacement(worldX, heightRatio);
+    }
+    /**
+     * Get distance fog opacity for a depth
+     */
+    getFogOpacity(depth) {
+        if (!this.config.fogEnabled)
+            return 0;
+        return this.fogSystem.getDistanceFogOpacity(depth);
+    }
+    /**
+     * Alias for getFogOpacity - used by renderer
+     */
+    getDistanceFogOpacity(depth) {
+        return this.getFogOpacity(depth);
+    }
+    /**
+     * Get ground fog data
+     */
+    getGroundFog() {
+        if (!this.config.fogEnabled)
+            return null;
+        return this.fogSystem.generateGroundFog();
+    }
+    /**
+     * Get wispy fog patches
+     */
+    getWispyPatches() {
+        if (!this.config.fogEnabled)
+            return [];
+        return this.fogSystem.getWispyPatches();
+    }
+    /**
+     * Get mist layers
+     */
+    getMistLayers() {
+        if (!this.config.fogEnabled)
+            return [];
+        return this.fogSystem.getMistLayers();
+    }
+    /**
+     * Get all fog layers for rendering
+     */
+    getAllFogLayers() {
+        if (!this.config.fogEnabled)
+            return [];
+        return this.fogSystem.getAllFogLayers();
+    }
+    /**
+     * Get ground elements (bushes, ferns)
+     */
+    getGroundElements() {
+        if (!this.config.groundEnabled)
+            return [];
+        return this.groundSystem.getElements();
+    }
+    /**
+     * Get grass tufts
+     */
+    getGrassTufts() {
+        if (!this.config.groundEnabled)
+            return [];
+        return this.groundSystem.getGrassTufts();
+    }
+    /**
+     * Get owl silhouettes
+     */
+    getOwls() {
+        if (!this.config.easterEggsEnabled)
+            return [];
+        return this.easterEggSystem.getOwls();
+    }
+    /**
+     * Get active bat flocks
+     */
+    getBatFlocks() {
+        if (!this.config.easterEggsEnabled)
+            return [];
+        return this.easterEggSystem.getBatFlocks();
+    }
+    /**
+     * Get moon renderer for direct rendering
+     */
+    getMoonRenderer() {
+        if (!this.config.moonEnabled)
+            return null;
+        return this.moonRenderer;
+    }
+    /**
+     * Get moon state data
+     */
+    getMoonState() {
+        if (!this.config.moonEnabled)
+            return null;
+        return this.moonRenderer.getState();
+    }
+    /**
+     * Get active shooting stars
+     */
+    getShootingStars() {
+        if (!this.config.easterEggsEnabled)
+            return [];
+        return this.easterEggSystem.getShootingStars();
+    }
+    /**
+     * Get glowing eyes
+     */
+    getGlowingEyes() {
+        if (!this.config.easterEggsEnabled)
+            return [];
+        return this.easterEggSystem.getGlowingEyes();
+    }
+    /**
+     * Get bat wing geometry for rendering
+     */
+    getBatWingPoints(bat) {
+        return this.easterEggSystem.getBatWingPoints(bat);
+    }
+    /**
+     * Get access to the easter egg system for rendering
+     */
+    getEasterEggSystem() {
+        return this.easterEggSystem;
+    }
+    /**
+     * Get all render data in one call - used by ForestCanvasRenderer
+     */
+    getRenderData() {
+        return {
+            trees: this.getAllTrees(),
+            groundElements: this.getGroundElements(),
+            grassTufts: this.getGrassTufts(),
+            moonRenderer: this.getMoonRenderer(),
+            shootingStars: this.getShootingStars(),
+            batFlocks: this.getBatFlocks(),
+            owls: this.getOwls(),
+            glowingEyes: this.getGlowingEyes(),
+            fogLayers: this.getAllFogLayers(),
+            windStrength: this.getWindStrength(),
+            gustActive: this.isGustActive(),
+        };
+    }
+    // ============================================
+    // CONTROLS
+    // ============================================
+    /**
+     * Trigger a wind gust
+     */
+    triggerGust() {
+        this.windAnimator.triggerGust();
+    }
+    /**
+     * Check if a gust is currently active
+     */
+    isGustActive() {
+        return this.windAnimator.isGustActive();
+    }
+    /**
+     * Get current wind strength
+     */
+    getWindStrength() {
+        return this.windAnimator.getCurrentStrength();
+    }
+    /**
+     * Set wind preset
+     */
+    setWindPreset(preset) {
+        const presetConfig = WIND_PRESETS[preset];
+        if (presetConfig) {
+            this.windAnimator.setConfig(presetConfig);
+        }
+    }
+    /**
+     * Regenerate everything with a new seed
+     */
+    regenerate(seed) {
+        // Create new instances with new seed
+        const { width, height } = this.config;
+        this.forestComposer = new ParallaxForestComposer({ width, height, ...this.config.forest }, seed);
+        this.groundSystem = new GroundLayerSystem({ width, height, ...this.config.ground }, seed ? seed + 2000 : undefined);
+        this.easterEggSystem = new EasterEggSystem(width, height, this.config.easterEggs, seed ? seed + 4000 : undefined);
+        // Moon renderer doesn't need regeneration, just refresh phase
+        this.moonRenderer.refreshPhase();
+        this.generate();
+    }
+    /**
+     * Resize all systems
+     */
+    resize(width, height) {
+        this.config.width = width;
+        this.config.height = height;
+        this.forestComposer.resize(width, height);
+        this.fogSystem.resize(width, height);
+        this.groundSystem.resize(width, height);
+        this.easterEggSystem.resize(width, height);
+        this.moonRenderer.resize(width, height);
+        // Regenerate content for new size
+        this.generate();
+    }
+    // ============================================
+    // CONFIGURATION
+    // ============================================
+    setEnabled(enabled) {
+        this.config.enabled = enabled;
+    }
+    setParallaxEnabled(enabled) {
+        this.config.parallaxEnabled = enabled;
+    }
+    setWindEnabled(enabled) {
+        this.config.windEnabled = enabled;
+    }
+    setFogEnabled(enabled) {
+        this.config.fogEnabled = enabled;
+    }
+    setGroundEnabled(enabled) {
+        this.config.groundEnabled = enabled;
+    }
+    setEasterEggsEnabled(enabled) {
+        this.config.easterEggsEnabled = enabled;
+    }
+    setMoonEnabled(enabled) {
+        this.config.moonEnabled = enabled;
+        this.moonRenderer.setVisible(enabled);
+    }
+    setMoonConfig(config) {
+        this.moonRenderer.setConfig(config);
+    }
+    setWindConfig(config) {
+        this.windAnimator.setConfig(config);
+    }
+    setFogConfig(config) {
+        this.fogSystem.setConfig(config);
+    }
+    setEasterEggConfig(config) {
+        this.easterEggSystem.setConfig(config);
+    }
+    /**
+     * Set quality level - adjusts detail and particle counts
+     */
+    setQuality(quality) {
+        this.quality = quality;
+        // Quality multipliers for different detail levels
+        const qualityMultipliers = {
+            low: 0.5,
+            medium: 0.75,
+            high: 1.0,
+            ultra: 1.5,
+        };
+        const multiplier = qualityMultipliers[quality];
+        // Adjust ground layer counts
+        this.groundSystem = new GroundLayerSystem({
+            width: this.config.width,
+            height: this.config.height,
+            bushCount: Math.floor(15 * multiplier),
+            grassTuftCount: Math.floor(40 * multiplier),
+            fernCount: Math.floor(10 * multiplier),
+            ...this.config.ground,
+        }, this.config.seed ? this.config.seed + 2000 : undefined);
+        this.groundSystem.generate();
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get comprehensive stats for debug display
+     */
+    getStats() {
+        const forestStats = this.forestComposer.getStats();
+        const groundStats = this.groundSystem.getStats();
+        const easterEggStats = this.easterEggSystem.getStats();
+        return {
+            trees: {
+                total: forestStats.totalTrees,
+                deciduous: forestStats.treesByType.deciduous,
+                conifer: forestStats.treesByType.conifer,
+                bare: forestStats.treesByType.bare,
+            },
+            ground: {
+                bushes: groundStats.bushes,
+                grassTufts: groundStats.grassTufts,
+                ferns: groundStats.ferns,
+            },
+            wind: {
+                strength: this.windAnimator.getCurrentStrength(),
+                gustActive: this.windAnimator.isGustActive(),
+            },
+            easterEggs: {
+                owls: easterEggStats.owls,
+                batFlocks: easterEggStats.activeBatFlocks,
+                shootingStars: easterEggStats.activeShootingStars,
+                glowingEyes: easterEggStats.glowingEyes,
+            },
+            layers: forestStats.layerCount,
+        };
+    }
+    /**
+     * Check if system has been initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+}
+// Re-export wind presets for convenience
+export { WIND_PRESETS };
+// Re-export MoonRenderer for direct usage
+export { MoonRenderer };
+//# sourceMappingURL=ProceduralForestSystem.js.map

package/dist/backgrounds/firefly-forest/services/ProceduralForestSystem.js.map

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

package/dist/backgrounds/firefly-forest/services/TreeSilhouetteImageLoader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tree Silhouette Image Loader
+ *
+ * Loads and caches AI-generated tree silhouette images for the Firefly Forest.
+ * Pre-renders images to offscreen canvases for optimal drawing performance.
+ */
+export type TreeCategory = 'pine' | 'fir' | 'spruce' | 'oak' | 'maple' | 'poplar' | 'willow' | 'dead';
+interface TreeImage {
+    category: TreeCategory;
+    filename: string;
+    canvas: OffscreenCanvas | HTMLCanvasElement;
+    width: number;
+    height: number;
+    aspectRatio: number;
+}
+/**
+ * Creates a tree silhouette image loader
+ */
+export declare function createTreeSilhouetteImageLoader(): {
+    preload: () => Promise<void>;
+    getRandomFromCategory: (category: TreeCategory, seed?: number) => TreeImage | null;
+    getUniqueFromCategory: (category: TreeCategory, usedImages: Set<string>, seed?: number) => TreeImage | null;
+    getCategory: (category: TreeCategory) => TreeImage[];
+    getImage: (category: TreeCategory, index: number) => TreeImage | null;
+    isReady: () => boolean;
+    getLoadedCount: () => number;
+    getCategoryCounts: () => Record<TreeCategory, number>;
+};
+export type TreeSilhouetteImageLoader = ReturnType<typeof createTreeSilhouetteImageLoader>;
+export {};
+//# sourceMappingURL=TreeSilhouetteImageLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSilhouetteImageLoader.d.ts","sourceRoot":"","sources":["../../../../src/backgrounds/firefly-forest/services/TreeSilhouetteImageLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtG,UAAU,SAAS;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAgBD;;GAEG;AACH,wBAAgB,+BAA+B;mBAyEnB,OAAO,CAAC,IAAI,CAAC;sCAyCE,YAAY,SAAS,MAAM,KAAG,SAAS,GAAG,IAAI;sCAgB3E,YAAY,cACV,GAAG,CAAC,MAAM,CAAC,SAChB,MAAM,KACZ,SAAS,GAAG,IAAI;4BAoBY,YAAY,KAAG,SAAS,EAAE;yBAO7B,YAAY,SAAS,MAAM,KAAG,SAAS,GAAG,IAAI;mBAQtD,OAAO;0BAOA,MAAM;6BAOH,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC;EAkB3D;AAED,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC"}