@austencloud/backgrounds 0.1.0

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

@@ -0,0 +1,191 @@
+/**
+ * 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.
+ */
+// Tree image counts per category (from our curated collection)
+const TREE_COUNTS = {
+    pine: 12,
+    fir: 5,
+    spruce: 4,
+    oak: 12,
+    maple: 12,
+    poplar: 6,
+    willow: 13,
+    dead: 18,
+};
+const BASE_PATH = '/images/trees/curated';
+/**
+ * Creates a tree silhouette image loader
+ */
+export function createTreeSilhouetteImageLoader() {
+    const imageCache = new Map();
+    const categoryImages = new Map();
+    let ready = false;
+    let loadPromise = null;
+    /**
+     * Generate the path for a tree image
+     */
+    function getImagePath(category, index) {
+        const paddedIndex = String(index).padStart(2, '0');
+        return `${BASE_PATH}/${category}_${paddedIndex}.png`;
+    }
+    /**
+     * Load a single image and create a pre-rendered canvas
+     */
+    async function loadImage(category, index) {
+        const path = getImagePath(category, index);
+        const cacheKey = `${category}_${index}`;
+        // Check cache first
+        if (imageCache.has(cacheKey)) {
+            return imageCache.get(cacheKey);
+        }
+        return new Promise((resolve) => {
+            const img = new Image();
+            img.onload = () => {
+                // Create offscreen canvas for fast drawing
+                let canvas;
+                let ctx;
+                if (typeof OffscreenCanvas !== 'undefined') {
+                    canvas = new OffscreenCanvas(img.naturalWidth, img.naturalHeight);
+                    ctx = canvas.getContext('2d');
+                }
+                else {
+                    canvas = document.createElement('canvas');
+                    canvas.width = img.naturalWidth;
+                    canvas.height = img.naturalHeight;
+                    ctx = canvas.getContext('2d');
+                }
+                if (ctx) {
+                    ctx.drawImage(img, 0, 0);
+                }
+                const treeImage = {
+                    category,
+                    filename: `${category}_${String(index).padStart(2, '0')}.png`,
+                    canvas,
+                    width: img.naturalWidth,
+                    height: img.naturalHeight,
+                    aspectRatio: img.naturalWidth / img.naturalHeight,
+                };
+                imageCache.set(cacheKey, treeImage);
+                resolve(treeImage);
+            };
+            img.onerror = () => {
+                // Silently skip missing images
+                resolve(null);
+            };
+            img.src = path;
+        });
+    }
+    /**
+     * Preload all tree images
+     */
+    async function preload() {
+        if (ready)
+            return;
+        if (loadPromise)
+            return loadPromise;
+        loadPromise = (async () => {
+            if (typeof window === 'undefined')
+                return;
+            const loadPromises = [];
+            // Load all images for each category
+            for (const [category, count] of Object.entries(TREE_COUNTS)) {
+                for (let i = 1; i <= count; i++) {
+                    loadPromises.push(loadImage(category, i));
+                }
+            }
+            const results = await Promise.all(loadPromises);
+            // Organize by category
+            for (const category of Object.keys(TREE_COUNTS)) {
+                categoryImages.set(category, []);
+            }
+            for (const result of results) {
+                if (result) {
+                    const list = categoryImages.get(result.category);
+                    if (list) {
+                        list.push(result);
+                    }
+                }
+            }
+            ready = true;
+        })();
+        return loadPromise;
+    }
+    /**
+     * Get a random tree image from a category
+     */
+    function getRandomFromCategory(category, seed) {
+        const images = categoryImages.get(category);
+        if (!images || images.length === 0)
+            return null;
+        const index = seed !== undefined
+            ? Math.floor(Math.abs(seed * 10000) % images.length)
+            : Math.floor(Math.random() * images.length);
+        return images[index] || null;
+    }
+    /**
+     * Get a unique tree image from a category (not already used)
+     * Falls back to allowing duplicates if all images exhausted
+     */
+    function getUniqueFromCategory(category, usedImages, seed) {
+        const images = categoryImages.get(category);
+        if (!images || images.length === 0)
+            return null;
+        // Filter to unused images
+        const availableImages = images.filter(img => !usedImages.has(img.filename));
+        // If all used, allow duplicates (fall back to full list)
+        const pool = availableImages.length > 0 ? availableImages : images;
+        const index = seed !== undefined
+            ? Math.floor(Math.abs(seed * 10000) % pool.length)
+            : Math.floor(Math.random() * pool.length);
+        return pool[index] || null;
+    }
+    /**
+     * Get all images from a category
+     */
+    function getCategory(category) {
+        return categoryImages.get(category) || [];
+    }
+    /**
+     * Get a specific tree image
+     */
+    function getImage(category, index) {
+        const cacheKey = `${category}_${index}`;
+        return imageCache.get(cacheKey) || null;
+    }
+    /**
+     * Check if images are loaded and ready
+     */
+    function isReady() {
+        return ready;
+    }
+    /**
+     * Get total loaded image count
+     */
+    function getLoadedCount() {
+        return imageCache.size;
+    }
+    /**
+     * Get count per category
+     */
+    function getCategoryCounts() {
+        const counts = {};
+        for (const [category, images] of categoryImages.entries()) {
+            counts[category] = images.length;
+        }
+        return counts;
+    }
+    return {
+        preload,
+        getRandomFromCategory,
+        getUniqueFromCategory,
+        getCategory,
+        getImage,
+        isReady,
+        getLoadedCount,
+        getCategoryCounts,
+    };
+}
+//# sourceMappingURL=TreeSilhouetteImageLoader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSilhouetteImageLoader.js","sourceRoot":"","sources":["../../../../src/backgrounds/firefly-forest/services/TreeSilhouetteImageLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,+DAA+D;AAC/D,MAAM,WAAW,GAAiC;IAChD,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,+BAA+B;IAC7C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC5D,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,WAAW,GAAyB,IAAI,CAAC;IAE7C;;OAEG;IACH,SAAS,YAAY,CAAC,QAAsB,EAAE,KAAa;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,OAAO,GAAG,SAAS,IAAI,QAAQ,IAAI,WAAW,MAAM,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,UAAU,SAAS,CAAC,QAAsB,EAAE,KAAa;QAC5D,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;QAExC,oBAAoB;QACpB,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;YAExB,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;gBAChB,2CAA2C;gBAC3C,IAAI,MAA2C,CAAC;gBAChD,IAAI,GAAwE,CAAC;gBAE7E,IAAI,OAAO,eAAe,KAAK,WAAW,EAAE,CAAC;oBAC3C,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;oBAClE,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAC1C,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC;oBAChC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC;oBAClC,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC;gBAED,IAAI,GAAG,EAAE,CAAC;oBACR,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3B,CAAC;gBAED,MAAM,SAAS,GAAc;oBAC3B,QAAQ;oBACR,QAAQ,EAAE,GAAG,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM;oBAC7D,MAAM;oBACN,KAAK,EAAE,GAAG,CAAC,YAAY;oBACvB,MAAM,EAAE,GAAG,CAAC,aAAa;oBACzB,WAAW,EAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,aAAa;iBAClD,CAAC;gBAEF,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;gBACpC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC,CAAC;YAEF,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE;gBACjB,+BAA+B;gBAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC;YAEF,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,UAAU,OAAO;QACpB,IAAI,KAAK;YAAE,OAAO;QAClB,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QAEpC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,OAAO,MAAM,KAAK,WAAW;gBAAE,OAAO;YAE1C,MAAM,YAAY,GAAgC,EAAE,CAAC;YAErD,oCAAoC;YACpC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;oBAChC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,QAAwB,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAEhD,uBAAuB;YACvB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAmB,EAAE,CAAC;gBAClE,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACnC,CAAC;YAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACjD,IAAI,IAAI,EAAE,CAAC;wBACT,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,KAAK,GAAG,IAAI,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS,qBAAqB,CAAC,QAAsB,EAAE,IAAa;QAClE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEhD,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS;YAC9B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACpD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAE9C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,SAAS,qBAAqB,CAC5B,QAAsB,EACtB,UAAuB,EACvB,IAAa;QAEb,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEhD,0BAA0B;QAC1B,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE5E,yDAAyD;QACzD,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC;QAEnE,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS;YAC9B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,SAAS,WAAW,CAAC,QAAsB;QACzC,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,SAAS,QAAQ,CAAC,QAAsB,EAAE,KAAa;QACrD,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,SAAS,OAAO;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,SAAS,cAAc;QACrB,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,SAAS,iBAAiB;QACxB,MAAM,MAAM,GAA0C,EAAE,CAAC;QACzD,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACnC,CAAC;QACD,OAAO,MAAsC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,OAAO;QACP,qBAAqB;QACrB,qBAAqB;QACrB,WAAW;QACX,QAAQ;QACR,OAAO;QACP,cAAc;QACd,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Tree Silhouette System
+ *
+ * Orchestrates tree silhouette rendering by composing specialized services:
+ * - TreePlacementResolver: Grid-based placement with collision detection
+ * - EcologicalPatternProvider: Zone-based tree type distribution
+ * - TreeSilhouetteRenderer: Image-based rendering with depth tinting
+ * - TreeGenerator: Creates tree instances with proper positioning
+ *
+ * This system manages layer-based canvas caching and coordinates the render pipeline.
+ */
+import type { Dimensions } from "../../../core/domain/types.js";
+import type { TreeType, TreeTypeVisibility, RenderedTree, PlacementConfig, EcologicalPattern } from "../domain/models/tree-silhouette-models.js";
+import { NUM_LAYERS, ECOLOGICAL_PATTERNS } from "../domain/constants/tree-silhouette-constants.js";
+export type { TreeType, TreeTypeVisibility, RenderedTree, PlacementConfig, EcologicalPattern, };
+export { NUM_LAYERS, ECOLOGICAL_PATTERNS };
+/**
+ * Creates forest silhouettes rising from the bottom of the screen.
+ * Trees are dark shapes against the sky - no ground layers needed.
+ */
+export declare function createTreeSilhouetteSystem(): {
+    initialize: (dimensions: Dimensions) => void;
+    preloadImages: () => Promise<void>;
+    draw: (ctx: CanvasRenderingContext2D, dimensions: Dimensions) => void;
+    drawLayer: (ctx: CanvasRenderingContext2D, dimensions: Dimensions, layer: number) => void;
+    handleResize: (_oldDimensions: Dimensions, newDimensions: Dimensions) => void;
+    regenerate: (dimensions: Dimensions) => void;
+    cleanup: () => void;
+    setTreeVisibility: (visibility: Partial<TreeTypeVisibility>) => void;
+    getTreeVisibility: () => TreeTypeVisibility;
+    setPlacementConfig: (config: Partial<PlacementConfig>) => void;
+    getPlacementConfig: () => PlacementConfig;
+    resetPlacementConfig: () => void;
+    setEcologicalPattern: (patternId: string) => void;
+    getEcologicalPatternId: () => string;
+    getEcologicalPattern: () => EcologicalPattern;
+    getAvailablePatterns: () => EcologicalPattern[];
+    setRandomEcologicalPattern: () => string;
+    getRenderedTrees: () => RenderedTree[];
+    removeTree: (treeId: string) => boolean;
+    removeTreesByImage: (imageFilename: string) => number;
+    getTreeCounts: () => {
+        total: number;
+        byLayer: number[];
+    };
+};
+//# sourceMappingURL=TreeSilhouetteSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSilhouetteSystem.d.ts","sourceRoot":"","sources":["../../../../src/backgrounds/firefly-forest/services/TreeSilhouetteSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EACV,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,iBAAiB,EAClB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAuBnG,YAAY,EACV,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,CAAC;AACF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AAI3C;;;GAGG;AACH,wBAAgB,0BAA0B;6BA0BR,UAAU,KAAG,IAAI;yBAajB,OAAO,CAAC,IAAI,CAAC;gBAmH1B,wBAAwB,cAAc,UAAU,KAAG,IAAI;qBAmBnE,wBAAwB,cACjB,UAAU,SACf,MAAM,KACZ,IAAI;mCAiBW,UAAU,iBACX,UAAU,KACxB,IAAI;6BAQyB,UAAU,KAAG,IAAI;mBAI7B,IAAI;oCA8DU,OAAO,CAAC,kBAAkB,CAAC;;iCAK9B,OAAO,CAAC,eAAe,CAAC;;;sCAMnB,MAAM;;;;;4BAhEb,YAAY,EAAE;yBAIf,MAAM,KAAG,OAAO;wCAcD,MAAM,KAAG,MAAM;yBAYhC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;EA+C/D"}

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

@@ -0,0 +1,241 @@
+/**
+ * Tree Silhouette System
+ *
+ * Orchestrates tree silhouette rendering by composing specialized services:
+ * - TreePlacementResolver: Grid-based placement with collision detection
+ * - EcologicalPatternProvider: Zone-based tree type distribution
+ * - TreeSilhouetteRenderer: Image-based rendering with depth tinting
+ * - TreeGenerator: Creates tree instances with proper positioning
+ *
+ * This system manages layer-based canvas caching and coordinates the render pipeline.
+ */
+import { NUM_LAYERS, ECOLOGICAL_PATTERNS } from "../domain/constants/tree-silhouette-constants.js";
+import { createTreeSilhouetteImageLoader, } from "./TreeSilhouetteImageLoader.js";
+import { createTreePlacementResolver, } from "./trees/TreePlacementResolver.js";
+import { createEcologicalPatternProvider, } from "./trees/EcologicalPatternProvider.js";
+import { createTreeSilhouetteRenderer, } from "./trees/TreeSilhouetteRenderer.js";
+import { createTreeGenerator, } from "./trees/TreeGenerator.js";
+export { NUM_LAYERS, ECOLOGICAL_PATTERNS };
+/**
+ * Creates forest silhouettes rising from the bottom of the screen.
+ * Trees are dark shapes against the sky - no ground layers needed.
+ */
+export function createTreeSilhouetteSystem() {
+    // ===================
+    // COMPOSED SERVICES
+    // ===================
+    const imageLoader = createTreeSilhouetteImageLoader();
+    const placementResolver = createTreePlacementResolver();
+    const patternProvider = createEcologicalPatternProvider();
+    const renderer = createTreeSilhouetteRenderer(imageLoader);
+    const generator = createTreeGenerator(placementResolver, patternProvider);
+    // ===================
+    // CACHE STATE
+    // ===================
+    // One cached canvas per layer for interleaved rendering with grass
+    let layerCanvases = Array(NUM_LAYERS).fill(null);
+    let cachedDimensions = null;
+    // Store current trees for inspection and deletion
+    let currentTrees = [];
+    // ===================
+    // INITIALIZATION
+    // ===================
+    function initialize(dimensions) {
+        // Start image preloading in the background
+        if (!renderer.areImagesLoaded()) {
+            renderer.preloadImages().then(() => {
+                // Re-render with images now that they're loaded
+                if (cachedDimensions) {
+                    renderToCache(cachedDimensions);
+                }
+            });
+        }
+        renderToCache(dimensions);
+    }
+    async function preloadImages() {
+        await renderer.preloadImages();
+    }
+    // ===================
+    // CACHE RENDERING
+    // ===================
+    function renderToCache(dimensions) {
+        cachedDimensions = dimensions;
+        // Clear used images tracker for fresh scene
+        renderer.clearUsedImages();
+        const trees = generator.createTrees(dimensions);
+        // Store trees for external access
+        currentTrees = trees;
+        // Create separate canvas for each layer
+        for (let layer = 0; layer < NUM_LAYERS; layer++) {
+            const canvas = new OffscreenCanvas(dimensions.width, dimensions.height);
+            const ctx = canvas.getContext("2d");
+            if (!ctx)
+                continue;
+            ctx.clearRect(0, 0, dimensions.width, dimensions.height);
+            // Get the ground line for this layer (far = higher up, near = below viewport)
+            const layerBaseY = renderer.getLayerBaseY(layer, dimensions.height);
+            // Draw only trees in this layer
+            const layerTrees = trees.filter((t) => t.layer === layer);
+            for (const tree of layerTrees) {
+                // Draw tree using pre-loaded silhouette image
+                const imageFilename = renderer.drawTreeImage(ctx, tree.x, layerBaseY, tree.width, tree.height, tree.type, tree.layer, tree.seed);
+                // Track which image was used for this tree
+                if (imageFilename) {
+                    tree.imageFilename = imageFilename;
+                }
+            }
+            layerCanvases[layer] = canvas;
+        }
+    }
+    /**
+     * Re-render the cache using the current trees (without regenerating).
+     * Used after removing trees to update the display.
+     */
+    function rerenderCurrentTrees(dimensions) {
+        cachedDimensions = dimensions;
+        // Clear used images tracker
+        renderer.clearUsedImages();
+        // Create separate canvas for each layer
+        for (let layer = 0; layer < NUM_LAYERS; layer++) {
+            const canvas = new OffscreenCanvas(dimensions.width, dimensions.height);
+            const ctx = canvas.getContext("2d");
+            if (!ctx)
+                continue;
+            ctx.clearRect(0, 0, dimensions.width, dimensions.height);
+            // Get the ground line for this layer
+            const layerBaseY = renderer.getLayerBaseY(layer, dimensions.height);
+            // Draw only trees in this layer that still exist
+            const layerTrees = currentTrees.filter((t) => t.layer === layer);
+            for (const tree of layerTrees) {
+                const imageFilename = renderer.drawTreeImage(ctx, tree.x, layerBaseY, tree.width, tree.height, tree.type, tree.layer, tree.seed);
+                if (imageFilename) {
+                    tree.imageFilename = imageFilename;
+                }
+            }
+            layerCanvases[layer] = canvas;
+        }
+    }
+    // ===================
+    // DRAWING
+    // ===================
+    /**
+     * Check if dimensions have changed (prevents unnecessary regeneration).
+     */
+    function dimensionsChanged(dimensions) {
+        if (!cachedDimensions)
+            return true;
+        return (cachedDimensions.width !== dimensions.width ||
+            cachedDimensions.height !== dimensions.height);
+    }
+    /**
+     * Draw all tree layers at once (backwards compatibility).
+     */
+    function draw(ctx, dimensions) {
+        // Only initialize if cache doesn't exist OR dimensions changed
+        if (!layerCanvases[0] || dimensionsChanged(dimensions)) {
+            initialize(dimensions);
+        }
+        // Draw all layers in order
+        for (const canvas of layerCanvases) {
+            if (canvas) {
+                ctx.drawImage(canvas, 0, 0);
+            }
+        }
+    }
+    /**
+     * Draw a specific tree layer (for interleaving with grass).
+     * @param layer 0 = far, 6 = near
+     */
+    function drawLayer(ctx, dimensions, layer) {
+        // Only initialize if cache doesn't exist OR dimensions changed
+        if (!layerCanvases[0] || dimensionsChanged(dimensions)) {
+            initialize(dimensions);
+        }
+        const canvas = layerCanvases[layer];
+        if (canvas) {
+            ctx.drawImage(canvas, 0, 0);
+        }
+    }
+    // ===================
+    // EVENT HANDLERS
+    // ===================
+    function handleResize(_oldDimensions, newDimensions) {
+        // Skip if dimensions haven't actually changed
+        if (!dimensionsChanged(newDimensions)) {
+            return;
+        }
+        initialize(newDimensions);
+    }
+    function regenerate(dimensions) {
+        renderToCache(dimensions);
+    }
+    function cleanup() {
+        layerCanvases = Array(NUM_LAYERS).fill(null);
+        cachedDimensions = null;
+    }
+    // ===================
+    // TREE MANAGEMENT API
+    // ===================
+    function getRenderedTrees() {
+        return currentTrees.map((t) => ({ ...t }));
+    }
+    function removeTree(treeId) {
+        const index = currentTrees.findIndex((t) => t.id === treeId);
+        if (index === -1)
+            return false;
+        currentTrees.splice(index, 1);
+        // Re-render with remaining trees
+        if (cachedDimensions) {
+            rerenderCurrentTrees(cachedDimensions);
+        }
+        return true;
+    }
+    function removeTreesByImage(imageFilename) {
+        const initialCount = currentTrees.length;
+        currentTrees = currentTrees.filter((t) => t.imageFilename !== imageFilename);
+        const removedCount = initialCount - currentTrees.length;
+        if (removedCount > 0 && cachedDimensions) {
+            rerenderCurrentTrees(cachedDimensions);
+        }
+        return removedCount;
+    }
+    function getTreeCounts() {
+        const byLayer = Array(NUM_LAYERS).fill(0);
+        for (const tree of currentTrees) {
+            byLayer[tree.layer]++;
+        }
+        return { total: currentTrees.length, byLayer };
+    }
+    // ===================
+    // DELEGATED APIs
+    // ===================
+    return {
+        // Lifecycle
+        initialize,
+        preloadImages,
+        draw,
+        drawLayer,
+        handleResize,
+        regenerate,
+        cleanup,
+        // Visibility (delegated to generator)
+        setTreeVisibility: (visibility) => generator.setTreeVisibility(visibility),
+        getTreeVisibility: () => generator.getTreeVisibility(),
+        // Placement config (delegated to placement resolver)
+        setPlacementConfig: (config) => placementResolver.setPlacementConfig(config),
+        getPlacementConfig: () => placementResolver.getPlacementConfig(),
+        resetPlacementConfig: () => placementResolver.resetPlacementConfig(),
+        // Ecological pattern API (delegated to pattern provider)
+        setEcologicalPattern: (patternId) => patternProvider.setEcologicalPattern(patternId),
+        getEcologicalPatternId: () => patternProvider.getEcologicalPatternId(),
+        getEcologicalPattern: () => patternProvider.getEcologicalPattern(),
+        getAvailablePatterns: () => patternProvider.getAvailablePatterns(),
+        setRandomEcologicalPattern: () => patternProvider.setRandomEcologicalPattern(),
+        // Tree management API
+        getRenderedTrees,
+        removeTree,
+        removeTreesByImage,
+        getTreeCounts,
+    };
+}
+//# sourceMappingURL=TreeSilhouetteSystem.js.map

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

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

package/dist/backgrounds/firefly-forest/services/ambient/EasterEggSystem.d.ts

@@ -0,0 +1,155 @@
+/**
+ * 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
+ */
+export type EasterEggType = "owl" | "bat" | "moon" | "shootingStar" | "glowingEyes";
+export interface OwlSilhouette {
+    id: string;
+    x: number;
+    y: number;
+    scale: number;
+    facing: "left" | "right";
+    blinking: boolean;
+    blinkTimer: number;
+    headTilt: number;
+    silhouettePoints: Array<{
+        x: number;
+        y: number;
+    }>;
+}
+export interface Bat {
+    id: string;
+    x: number;
+    y: number;
+    velocityX: number;
+    velocityY: number;
+    wingPhase: number;
+    scale: number;
+}
+export interface BatFlock {
+    id: string;
+    bats: Bat[];
+    active: boolean;
+    startTime: number;
+}
+export interface MoonGlow {
+    x: number;
+    y: number;
+    radius: number;
+    glowRadius: number;
+    phase: number;
+    visible: boolean;
+}
+export interface ShootingStar {
+    id: string;
+    startX: number;
+    startY: number;
+    endX: number;
+    endY: number;
+    progress: number;
+    speed: number;
+    tailLength: number;
+    active: boolean;
+}
+export interface GlowingEyes {
+    id: string;
+    x: number;
+    y: number;
+    separation: number;
+    blinkPhase: number;
+    intensity: number;
+    color: string;
+}
+export interface EasterEggConfig {
+    owlEnabled: boolean;
+    maxOwls: number;
+    owlBlinkInterval: number;
+    batEnabled: boolean;
+    batFlockSize: number;
+    batSpawnChance: number;
+    batSpeed: number;
+    moonEnabled: boolean;
+    moonPhase: number;
+    moonX: number;
+    moonY: number;
+    shootingStarsEnabled: boolean;
+    shootingStarChance: number;
+    glowingEyesEnabled: boolean;
+    maxGlowingEyes: number;
+}
+export declare class EasterEggSystem {
+    private config;
+    private noise;
+    private width;
+    private height;
+    private owls;
+    private batFlocks;
+    private moon;
+    private shootingStars;
+    private glowingEyes;
+    private idCounter;
+    private time;
+    constructor(width: number, height: number, config?: Partial<EasterEggConfig>, seed?: number);
+    private initializeStaticElements;
+    private createMoon;
+    private createGlowingEyes;
+    /**
+     * Add an owl at a specific position (called by composer when placing trees)
+     */
+    addOwl(x: number, y: number, scale?: number): OwlSilhouette | null;
+    private generateOwlSilhouette;
+    /**
+     * Update all easter eggs
+     * @param deltaTime Seconds since last update
+     */
+    update(deltaTime: number): void;
+    private updateOwls;
+    private updateBatFlocks;
+    private updateShootingStars;
+    private updateGlowingEyes;
+    private checkForNewEvents;
+    private spawnBatFlock;
+    private spawnShootingStar;
+    getOwls(): OwlSilhouette[];
+    getBatFlocks(): BatFlock[];
+    getMoon(): MoonGlow;
+    getShootingStars(): ShootingStar[];
+    getGlowingEyes(): GlowingEyes[];
+    /**
+     * Get bat wing points for current wing phase
+     */
+    getBatWingPoints(bat: Bat): {
+        body: Array<{
+            x: number;
+            y: number;
+        }>;
+        leftWing: Array<{
+            x: number;
+            y: number;
+        }>;
+        rightWing: Array<{
+            x: number;
+            y: number;
+        }>;
+    };
+    /**
+     * Resize system
+     */
+    resize(width: number, height: number): void;
+    setConfig(config: Partial<EasterEggConfig>): void;
+    getConfig(): EasterEggConfig;
+    getStats(): {
+        owls: number;
+        activeBatFlocks: number;
+        totalBats: number;
+        activeShootingStars: number;
+        glowingEyes: number;
+    };
+}
+//# sourceMappingURL=EasterEggSystem.d.ts.map

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

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