@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/services/ambient/EasterEggSystem.js

@@ -0,0 +1,339 @@
+/**
+ * Easter Egg System
+ *
+ * Adds delightful ambient details that reward attentive viewers:
+ * - Owl silhouettes perched in trees
+ * - Bat flocks that occasionally fly across
+ * - Moon glow effects
+ * - Shooting stars
+ * - Glowing eyes in darkness
+ */
+import { PerlinNoise } from "../noise/PerlinNoise.js";
+const DEFAULT_CONFIG = {
+    owlEnabled: true,
+    maxOwls: 2,
+    owlBlinkInterval: 4,
+    batEnabled: true,
+    batFlockSize: 8,
+    batSpawnChance: 0.01,
+    batSpeed: 150,
+    // Moon is now handled by shared MoonRenderer in ProceduralForestSystem
+    moonEnabled: false,
+    moonPhase: 0.75, // Waning gibbous (legacy, not used)
+    moonX: 0.15,
+    moonY: 0.12,
+    shootingStarsEnabled: true,
+    shootingStarChance: 0.02,
+    glowingEyesEnabled: true,
+    maxGlowingEyes: 3,
+};
+export class EasterEggSystem {
+    config;
+    noise;
+    width;
+    height;
+    // Easter egg instances
+    owls = [];
+    batFlocks = [];
+    moon;
+    shootingStars = [];
+    glowingEyes = [];
+    idCounter = 0;
+    time = 0;
+    constructor(width, height, config = {}, seed) {
+        this.width = width;
+        this.height = height;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.noise = new PerlinNoise(seed);
+        this.moon = this.createMoon();
+        this.initializeStaticElements();
+    }
+    initializeStaticElements() {
+        // Initialize owls at random tree positions (to be placed by composer)
+        this.owls = [];
+        // Initialize glowing eyes
+        this.glowingEyes = [];
+        if (this.config.glowingEyesEnabled) {
+            for (let i = 0; i < this.config.maxGlowingEyes; i++) {
+                this.glowingEyes.push(this.createGlowingEyes());
+            }
+        }
+    }
+    createMoon() {
+        const { moonX, moonY, moonPhase } = this.config;
+        const radius = Math.min(this.width, this.height) * 0.04;
+        return {
+            x: this.width * moonX,
+            y: this.height * moonY,
+            radius,
+            glowRadius: radius * 3,
+            phase: moonPhase,
+            visible: this.config.moonEnabled,
+        };
+    }
+    createGlowingEyes() {
+        const x = this.noise.noise2D(this.idCounter * 0.3, 0) * 0.5 + 0.5;
+        const y = this.noise.noise2D(this.idCounter * 0.3, 100) * 0.3 + 0.5;
+        return {
+            id: `eyes-${this.idCounter++}`,
+            x: x * this.width,
+            y: y * this.height,
+            separation: 8 + Math.random() * 8,
+            blinkPhase: Math.random() * Math.PI * 2,
+            intensity: 0.5 + Math.random() * 0.5,
+            color: Math.random() > 0.7 ? "#ff6600" : "#ffff44", // Orange or yellow
+        };
+    }
+    /**
+     * Add an owl at a specific position (called by composer when placing trees)
+     */
+    addOwl(x, y, scale = 1) {
+        if (!this.config.owlEnabled || this.owls.length >= this.config.maxOwls) {
+            return null;
+        }
+        const owl = {
+            id: `owl-${this.idCounter++}`,
+            x,
+            y,
+            scale,
+            facing: Math.random() > 0.5 ? "left" : "right",
+            blinking: false,
+            blinkTimer: Math.random() * this.config.owlBlinkInterval,
+            headTilt: (Math.random() - 0.5) * 0.3,
+            silhouettePoints: this.generateOwlSilhouette(scale),
+        };
+        this.owls.push(owl);
+        return owl;
+    }
+    generateOwlSilhouette(scale) {
+        const points = [];
+        const s = scale * 15;
+        // Owl body silhouette (stylized, recognizable)
+        // Start at bottom left
+        points.push({ x: -s * 0.4, y: s * 0.6 });
+        // Left side up
+        points.push({ x: -s * 0.5, y: s * 0.2 });
+        points.push({ x: -s * 0.6, y: -s * 0.1 });
+        // Left ear tuft
+        points.push({ x: -s * 0.5, y: -s * 0.4 });
+        points.push({ x: -s * 0.4, y: -s * 0.6 });
+        points.push({ x: -s * 0.25, y: -s * 0.45 });
+        // Top of head
+        points.push({ x: 0, y: -s * 0.35 });
+        // Right ear tuft
+        points.push({ x: s * 0.25, y: -s * 0.45 });
+        points.push({ x: s * 0.4, y: -s * 0.6 });
+        points.push({ x: s * 0.5, y: -s * 0.4 });
+        // Right side down
+        points.push({ x: s * 0.6, y: -s * 0.1 });
+        points.push({ x: s * 0.5, y: s * 0.2 });
+        points.push({ x: s * 0.4, y: s * 0.6 });
+        // Bottom
+        points.push({ x: 0, y: s * 0.7 });
+        return points;
+    }
+    /**
+     * Update all easter eggs
+     * @param deltaTime Seconds since last update
+     */
+    update(deltaTime) {
+        this.time += deltaTime;
+        this.updateOwls(deltaTime);
+        this.updateBatFlocks(deltaTime);
+        this.updateShootingStars(deltaTime);
+        this.updateGlowingEyes(deltaTime);
+        this.checkForNewEvents(deltaTime);
+    }
+    updateOwls(deltaTime) {
+        for (const owl of this.owls) {
+            owl.blinkTimer -= deltaTime;
+            if (owl.blinkTimer <= 0) {
+                owl.blinking = true;
+                // Reset after brief blink
+                setTimeout(() => {
+                    owl.blinking = false;
+                }, 150);
+                owl.blinkTimer = this.config.owlBlinkInterval * (0.7 + Math.random() * 0.6);
+            }
+            // Occasional head tilt
+            if (Math.random() < 0.002) {
+                owl.headTilt = (Math.random() - 0.5) * 0.4;
+            }
+        }
+    }
+    updateBatFlocks(deltaTime) {
+        for (const flock of this.batFlocks) {
+            if (!flock.active)
+                continue;
+            let allOffscreen = true;
+            for (const bat of flock.bats) {
+                // Update position
+                bat.x += bat.velocityX * deltaTime;
+                bat.y += bat.velocityY * deltaTime;
+                // Wing flap
+                bat.wingPhase += deltaTime * 15;
+                // Add some vertical wobble
+                bat.y += Math.sin(this.time * 3 + bat.wingPhase) * 20 * deltaTime;
+                // Check if still on screen
+                if (bat.x > -50 && bat.x < this.width + 50) {
+                    allOffscreen = false;
+                }
+            }
+            if (allOffscreen) {
+                flock.active = false;
+            }
+        }
+        // Clean up inactive flocks
+        this.batFlocks = this.batFlocks.filter((f) => f.active);
+    }
+    updateShootingStars(deltaTime) {
+        for (const star of this.shootingStars) {
+            if (!star.active)
+                continue;
+            star.progress += star.speed * deltaTime;
+            if (star.progress >= 1) {
+                star.active = false;
+            }
+        }
+        // Clean up inactive stars
+        this.shootingStars = this.shootingStars.filter((s) => s.active);
+    }
+    updateGlowingEyes(deltaTime) {
+        for (const eyes of this.glowingEyes) {
+            eyes.blinkPhase += deltaTime * 0.5;
+            // Occasional complete blink
+            if (Math.sin(eyes.blinkPhase * 2) < -0.95) {
+                eyes.intensity = 0;
+            }
+            else {
+                eyes.intensity = 0.5 + Math.sin(eyes.blinkPhase) * 0.3;
+            }
+        }
+    }
+    checkForNewEvents(deltaTime) {
+        // Spawn bat flock
+        if (this.config.batEnabled &&
+            Math.random() < this.config.batSpawnChance * deltaTime) {
+            this.spawnBatFlock();
+        }
+        // Spawn shooting star
+        if (this.config.shootingStarsEnabled &&
+            Math.random() < this.config.shootingStarChance * deltaTime) {
+            this.spawnShootingStar();
+        }
+    }
+    spawnBatFlock() {
+        const flock = {
+            id: `flock-${this.idCounter++}`,
+            bats: [],
+            active: true,
+            startTime: this.time,
+        };
+        // Start from left or right
+        const fromLeft = Math.random() > 0.5;
+        const startX = fromLeft ? -30 : this.width + 30;
+        const startY = this.height * (0.1 + Math.random() * 0.4);
+        const direction = fromLeft ? 1 : -1;
+        for (let i = 0; i < this.config.batFlockSize; i++) {
+            const offsetX = (Math.random() - 0.5) * 60;
+            const offsetY = (Math.random() - 0.5) * 40;
+            flock.bats.push({
+                id: `bat-${this.idCounter++}`,
+                x: startX + offsetX,
+                y: startY + offsetY,
+                velocityX: direction * this.config.batSpeed * (0.8 + Math.random() * 0.4),
+                velocityY: (Math.random() - 0.5) * 20,
+                wingPhase: Math.random() * Math.PI * 2,
+                scale: 0.8 + Math.random() * 0.4,
+            });
+        }
+        this.batFlocks.push(flock);
+    }
+    spawnShootingStar() {
+        // Start in upper portion of sky
+        const startX = Math.random() * this.width;
+        const startY = this.height * (0.05 + Math.random() * 0.2);
+        // Diagonal trajectory
+        const angle = Math.PI * 0.1 + Math.random() * Math.PI * 0.3;
+        const length = 100 + Math.random() * 150;
+        this.shootingStars.push({
+            id: `star-${this.idCounter++}`,
+            startX,
+            startY,
+            endX: startX + Math.cos(angle) * length,
+            endY: startY + Math.sin(angle) * length,
+            progress: 0,
+            speed: 0.5 + Math.random() * 0.5,
+            tailLength: 30 + Math.random() * 50,
+            active: true,
+        });
+    }
+    // Getters for rendering
+    getOwls() {
+        return this.owls;
+    }
+    getBatFlocks() {
+        return this.batFlocks.filter((f) => f.active);
+    }
+    getMoon() {
+        return this.moon;
+    }
+    getShootingStars() {
+        return this.shootingStars.filter((s) => s.active);
+    }
+    getGlowingEyes() {
+        return this.glowingEyes;
+    }
+    /**
+     * Get bat wing points for current wing phase
+     */
+    getBatWingPoints(bat) {
+        const s = bat.scale * 8;
+        const wingAngle = Math.sin(bat.wingPhase) * 0.6;
+        // Body (small oval)
+        const body = [
+            { x: -s * 0.3, y: 0 },
+            { x: 0, y: -s * 0.2 },
+            { x: s * 0.3, y: 0 },
+            { x: 0, y: s * 0.15 },
+        ];
+        // Wings (triangular, animated)
+        const wingExtend = Math.cos(bat.wingPhase) * s * 0.5;
+        const leftWing = [
+            { x: -s * 0.2, y: 0 },
+            { x: -s * 1.2, y: -s * 0.3 + wingExtend },
+            { x: -s * 0.8, y: s * 0.2 },
+        ];
+        const rightWing = [
+            { x: s * 0.2, y: 0 },
+            { x: s * 1.2, y: -s * 0.3 + wingExtend },
+            { x: s * 0.8, y: s * 0.2 },
+        ];
+        return { body, leftWing, rightWing };
+    }
+    /**
+     * Resize system
+     */
+    resize(width, height) {
+        this.width = width;
+        this.height = height;
+        this.moon = this.createMoon();
+    }
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+        this.moon = this.createMoon();
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getStats() {
+        return {
+            owls: this.owls.length,
+            activeBatFlocks: this.batFlocks.filter((f) => f.active).length,
+            totalBats: this.batFlocks.reduce((sum, f) => sum + f.bats.length, 0),
+            activeShootingStars: this.shootingStars.filter((s) => s.active).length,
+            glowingEyes: this.glowingEyes.length,
+        };
+    }
+}
+//# sourceMappingURL=EasterEggSystem.js.map

package/dist/backgrounds/firefly-forest/services/ambient/EasterEggSystem.js.map

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

package/dist/backgrounds/firefly-forest/services/animation/WindAnimator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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)
+ */
+export interface WindConfig {
+    enabled: boolean;
+    strength: number;
+    direction: number;
+    frequency: number;
+    secondaryStrength: number;
+    secondaryFrequency: number;
+    gustEnabled: boolean;
+    gustStrength: number;
+    gustFrequency: number;
+    gustDuration: number;
+    heightExponent: number;
+    trunkStiffness: number;
+    spatialVariation: number;
+    temporalVariation: number;
+}
+export interface WindState {
+    time: number;
+    currentStrength: number;
+    gustActive: boolean;
+    gustIntensity: number;
+    gustTimeRemaining: number;
+}
+export interface WindDisplacement {
+    x: number;
+    y: number;
+    rotation: number;
+}
+export declare class WindAnimator {
+    private config;
+    private noise;
+    private state;
+    constructor(config?: Partial<WindConfig>, seed?: number);
+    /**
+     * Update wind state
+     * @param deltaTime Time since last update in seconds
+     */
+    update(deltaTime: number): void;
+    private updateGusts;
+    /**
+     * 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: number, worldY: number, heightRatio: number, scale?: number): WindDisplacement;
+    /**
+     * Calculate displacement for grass blade
+     * Grass is more responsive to wind
+     */
+    getGrassDisplacement(worldX: number, heightRatio: number): WindDisplacement;
+    /**
+     * Get current wind state for UI display
+     */
+    getState(): WindState;
+    /**
+     * Get effective wind strength at current moment
+     */
+    getCurrentStrength(): number;
+    /**
+     * Check if a gust is currently active
+     */
+    isGustActive(): boolean;
+    /**
+     * Manually trigger a gust
+     */
+    triggerGust(): void;
+    /**
+     * Set wind configuration
+     */
+    setConfig(config: Partial<WindConfig>): void;
+    getConfig(): WindConfig;
+    /**
+     * Reset animation state
+     */
+    reset(): void;
+}
+/**
+ * Wind presets for different moods
+ */
+export declare const WIND_PRESETS: Record<string, Partial<WindConfig>>;
+//# sourceMappingURL=WindAnimator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WindAnimator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/services/animation/WindAnimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,UAAU;IAEzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAG3B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAGrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IAGvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmBD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAY;gBAEb,MAAM,GAAE,OAAO,CAAC,UAAU,CAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAY3D;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAgB/B,OAAO,CAAC,WAAW;IAwCnB;;;;;;OAMG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,MAAU,GAChB,gBAAgB;IAoDnB;;;OAGG;IACH,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,gBAAgB;IA0CnB;;OAEG;IACH,QAAQ,IAAI,SAAS;IAIrB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAI5C,SAAS,IAAI,UAAU;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;CASd;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAwC5D,CAAC"}