@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/services/ground/GroundLayerSystem.js

@@ -0,0 +1,303 @@
+/**
+ * Ground Layer System
+ *
+ * Generates procedural ground vegetation:
+ * - Bushes and shrubs
+ * - Grass tufts
+ * - Ferns and undergrowth
+ * - Ground texture variation
+ *
+ * Creates the forest floor that grounds the tree silhouettes.
+ */
+import { PerlinNoise } from "../noise/PerlinNoise.js";
+const DEFAULT_CONFIG = {
+    width: 1920,
+    height: 1080,
+    groundLineY: 0.9,
+    bushCount: 15,
+    bushMinSize: 30,
+    bushMaxSize: 80,
+    bushNoiseScale: 0.08,
+    bushNoiseAmplitude: 12,
+    grassTuftCount: 40,
+    bladesPerTuft: 8,
+    grassMinHeight: 15,
+    grassMaxHeight: 40,
+    grassCurvature: 0.4,
+    fernCount: 10,
+    fernMinSize: 20,
+    fernMaxSize: 50,
+    frondCount: 6,
+    clusteringStrength: 0.5,
+    depthLayers: 3,
+};
+export class GroundLayerSystem {
+    config;
+    noise;
+    elements = [];
+    grassTufts = [];
+    idCounter = 0;
+    constructor(config = {}, seed) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.noise = new PerlinNoise(seed);
+    }
+    /**
+     * Generate all ground elements
+     */
+    generate() {
+        this.elements = [];
+        this.grassTufts = [];
+        this.idCounter = 0;
+        // Generate in layers from far to near
+        for (let layer = 0; layer < this.config.depthLayers; layer++) {
+            const depth = layer / (this.config.depthLayers - 1 || 1);
+            this.generateLayerElements(depth, layer);
+        }
+        // Sort by depth and y position
+        this.elements.sort((a, b) => {
+            if (a.depth !== b.depth)
+                return a.depth - b.depth;
+            return a.y - b.y;
+        });
+        this.grassTufts.sort((a, b) => {
+            if (a.depth !== b.depth)
+                return a.depth - b.depth;
+            return a.y - b.y;
+        });
+    }
+    generateLayerElements(depth, layerIndex) {
+        const { bushCount, grassTuftCount, fernCount, depthLayers } = this.config;
+        // Scale counts by layer (more elements in near layers)
+        const layerMultiplier = 0.5 + depth * 0.5;
+        // Generate bushes
+        const bushesForLayer = Math.ceil((bushCount / depthLayers) * layerMultiplier);
+        for (let i = 0; i < bushesForLayer; i++) {
+            this.generateBush(depth, layerIndex, i);
+        }
+        // Generate grass tufts
+        const grassForLayer = Math.ceil((grassTuftCount / depthLayers) * layerMultiplier);
+        for (let i = 0; i < grassForLayer; i++) {
+            this.generateGrassTuft(depth, layerIndex, i);
+        }
+        // Generate ferns
+        const fernsForLayer = Math.ceil((fernCount / depthLayers) * layerMultiplier);
+        for (let i = 0; i < fernsForLayer; i++) {
+            this.generateFern(depth, layerIndex, i);
+        }
+    }
+    generateBush(depth, layerIndex, index) {
+        const { width, height, groundLineY, bushMinSize, bushMaxSize, bushNoiseScale, bushNoiseAmplitude, clusteringStrength, } = this.config;
+        const groundY = height * groundLineY;
+        // Position with clustering
+        const noiseX = this.noise.noise2D(index * 0.5 + layerIndex * 100, depth * 10);
+        const clusterX = this.noise.noise2D(index * 0.1, layerIndex) * width * clusteringStrength;
+        const x = (noiseX * 0.5 + 0.5) * width * (1 - clusteringStrength) + clusterX;
+        // Y position near ground with variation
+        const yVariation = this.noise.noise2D(x * 0.01, layerIndex * 50) * 20;
+        const y = groundY + yVariation - (1 - depth) * 30; // Far bushes higher
+        // Size
+        const sizeNoise = (this.noise.noise2D(x * 0.02, y * 0.02) + 1) / 2;
+        const bushWidth = bushMinSize + sizeNoise * (bushMaxSize - bushMinSize);
+        const bushHeight = bushWidth * (0.6 + Math.random() * 0.4);
+        // Generate silhouette points
+        const silhouettePoints = this.generateBushSilhouette(x, y, bushWidth, bushHeight, bushNoiseScale, bushNoiseAmplitude);
+        this.elements.push({
+            id: `bush-${this.idCounter++}`,
+            type: "bush",
+            x,
+            y,
+            width: bushWidth,
+            height: bushHeight,
+            depth,
+            silhouettePoints,
+            opacity: 0.6 + depth * 0.4,
+        });
+    }
+    generateBushSilhouette(centerX, baseY, width, height, noiseScale, noiseAmplitude) {
+        const points = [];
+        const pointCount = 24;
+        // Generate bumpy dome shape
+        for (let i = 0; i <= pointCount; i++) {
+            const t = i / pointCount;
+            const angle = Math.PI * t; // Half circle (dome)
+            // Base dome position
+            const baseX = centerX + Math.cos(angle) * (width / 2);
+            const baseYPos = baseY - Math.sin(angle) * height;
+            // Add noise for organic edge
+            const noiseVal = this.noise.fbm(baseX * noiseScale, baseYPos * noiseScale, 4) * noiseAmplitude;
+            // Additional bumps
+            const bumpNoise = this.noise.noise2D(baseX * noiseScale * 3, baseYPos * noiseScale * 3) * 5;
+            const dx = baseX - centerX;
+            const dy = baseYPos - baseY;
+            const dist = Math.sqrt(dx * dx + dy * dy) || 1;
+            points.push({
+                x: baseX + (dx / dist) * (noiseVal + bumpNoise),
+                y: baseYPos + (dy / dist) * (noiseVal + bumpNoise) * 0.5,
+            });
+        }
+        // Close at ground level
+        points.push({ x: centerX + width / 2 + 5, y: baseY });
+        points.push({ x: centerX - width / 2 - 5, y: baseY });
+        return points;
+    }
+    generateGrassTuft(depth, layerIndex, index) {
+        const { width, height, groundLineY, bladesPerTuft, grassMinHeight, grassMaxHeight, grassCurvature, } = this.config;
+        const groundY = height * groundLineY;
+        // Position
+        const x = this.noise.noise2D(index * 0.7 + layerIndex * 200, depth * 20);
+        const tuftX = (x * 0.5 + 0.5) * width;
+        const yVariation = this.noise.noise2D(tuftX * 0.01, layerIndex * 30) * 15;
+        const tuftY = groundY + yVariation - (1 - depth) * 20;
+        // Generate blades
+        const blades = [];
+        const tuftWidth = 20 + Math.random() * 30;
+        let maxHeight = 0;
+        for (let b = 0; b < bladesPerTuft; b++) {
+            const bladeT = b / (bladesPerTuft - 1 || 1);
+            const bladeX = tuftX - tuftWidth / 2 + bladeT * tuftWidth;
+            // Height variation
+            const heightNoise = (this.noise.noise2D(bladeX * 0.1, b) + 1) / 2;
+            const bladeHeight = grassMinHeight + heightNoise * (grassMaxHeight - grassMinHeight);
+            maxHeight = Math.max(maxHeight, bladeHeight);
+            // Curvature - lean outward from center
+            const leanDirection = (bladeT - 0.5) * 2; // -1 to 1
+            const curvatureAmount = grassCurvature * leanDirection * bladeHeight * 0.5;
+            // Control point for bezier
+            const controlX = bladeX + curvatureAmount;
+            const controlY = tuftY - bladeHeight * 0.6;
+            blades.push({
+                baseX: bladeX,
+                baseY: tuftY,
+                tipX: bladeX + curvatureAmount * 1.2,
+                tipY: tuftY - bladeHeight,
+                controlX,
+                controlY,
+                thickness: 1 + Math.random() * 1.5,
+            });
+        }
+        this.grassTufts.push({
+            id: `grass-${this.idCounter++}`,
+            x: tuftX,
+            y: tuftY,
+            depth,
+            blades,
+            width: tuftWidth,
+            height: maxHeight,
+        });
+    }
+    generateFern(depth, layerIndex, index) {
+        const { width, height, groundLineY, fernMinSize, fernMaxSize, frondCount } = this.config;
+        const groundY = height * groundLineY;
+        // Position
+        const noiseX = this.noise.noise2D(index * 0.6 + layerIndex * 150, depth * 15);
+        const x = (noiseX * 0.5 + 0.5) * width;
+        const yVariation = this.noise.noise2D(x * 0.01, layerIndex * 40) * 15;
+        const y = groundY + yVariation - (1 - depth) * 25;
+        // Size
+        const sizeNoise = (this.noise.noise2D(x * 0.02, y * 0.02) + 1) / 2;
+        const fernSize = fernMinSize + sizeNoise * (fernMaxSize - fernMinSize);
+        // Generate fern silhouette
+        const silhouettePoints = this.generateFernSilhouette(x, y, fernSize, frondCount);
+        this.elements.push({
+            id: `fern-${this.idCounter++}`,
+            type: "fern",
+            x,
+            y,
+            width: fernSize * 1.5,
+            height: fernSize,
+            depth,
+            silhouettePoints,
+            opacity: 0.5 + depth * 0.5,
+        });
+    }
+    generateFernSilhouette(centerX, baseY, size, frondCount) {
+        const points = [];
+        // Start at base center
+        points.push({ x: centerX, y: baseY });
+        // Generate fronds radiating outward
+        for (let f = 0; f < frondCount; f++) {
+            const t = f / (frondCount - 1 || 1);
+            const angle = -Math.PI * 0.2 + t * Math.PI * 0.4 - Math.PI / 2; // Upward spread
+            const frondLength = size * (0.7 + Math.random() * 0.3);
+            const midX = centerX + Math.cos(angle) * frondLength * 0.5;
+            const midY = baseY + Math.sin(angle) * frondLength * 0.5;
+            const tipX = centerX + Math.cos(angle) * frondLength;
+            const tipY = baseY + Math.sin(angle) * frondLength;
+            // Add leaflets along frond
+            const leafletCount = 5;
+            for (let l = 0; l < leafletCount; l++) {
+                const lt = l / leafletCount;
+                const leafX = centerX + (tipX - centerX) * lt;
+                const leafY = baseY + (tipY - baseY) * lt;
+                const leafSize = (size * 0.15) * (1 - lt * 0.5);
+                // Left leaflet
+                const leftAngle = angle - Math.PI * 0.35;
+                points.push({
+                    x: leafX + Math.cos(leftAngle) * leafSize,
+                    y: leafY + Math.sin(leftAngle) * leafSize,
+                });
+                // Frond center
+                points.push({ x: leafX, y: leafY });
+                // Right leaflet
+                const rightAngle = angle + Math.PI * 0.35;
+                points.push({
+                    x: leafX + Math.cos(rightAngle) * leafSize,
+                    y: leafY + Math.sin(rightAngle) * leafSize,
+                });
+            }
+            // Frond tip
+            points.push({ x: tipX, y: tipY });
+        }
+        // Return to base
+        points.push({ x: centerX, y: baseY });
+        return points;
+    }
+    /**
+     * Get all ground elements for rendering
+     */
+    getElements() {
+        return this.elements;
+    }
+    /**
+     * Get all grass tufts for rendering
+     */
+    getGrassTufts() {
+        return this.grassTufts;
+    }
+    /**
+     * Get elements by type
+     */
+    getElementsByType(type) {
+        return this.elements.filter((e) => e.type === type);
+    }
+    /**
+     * Get elements at a specific depth layer
+     */
+    getElementsAtDepth(depth, tolerance = 0.1) {
+        return this.elements.filter((e) => Math.abs(e.depth - depth) < tolerance);
+    }
+    /**
+     * Resize and regenerate
+     */
+    resize(width, height) {
+        this.config.width = width;
+        this.config.height = height;
+        this.generate();
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getStats() {
+        const bushes = this.elements.filter((e) => e.type === "bush").length;
+        const ferns = this.elements.filter((e) => e.type === "fern").length;
+        const totalBlades = this.grassTufts.reduce((sum, tuft) => sum + tuft.blades.length, 0);
+        return {
+            totalElements: this.elements.length + this.grassTufts.length,
+            bushes,
+            grassTufts: this.grassTufts.length,
+            ferns,
+            totalBlades,
+        };
+    }
+}
+//# sourceMappingURL=GroundLayerSystem.js.map

package/dist/backgrounds/firefly-forest/services/ground/GroundLayerSystem.js.map

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

package/dist/backgrounds/firefly-forest/services/noise/PerlinNoise.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Perlin Noise Implementation
+ *
+ * Classic Perlin noise for organic texture generation.
+ * Used for foliage edges, terrain variation, and natural randomness.
+ *
+ * Based on Ken Perlin's improved noise algorithm.
+ */
+export declare class PerlinNoise {
+    private readonly permutation;
+    private readonly p;
+    constructor(seed?: number);
+    private generatePermutation;
+    private fade;
+    private lerp;
+    private grad;
+    /**
+     * 2D Perlin noise
+     * @returns Value between -1 and 1
+     */
+    noise2D(x: number, y: number): number;
+    /**
+     * Fractal Brownian Motion (fBm) - stacked octaves of noise
+     * Creates more natural, detailed textures
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param octaves - Number of noise layers (more = more detail)
+     * @param persistence - How much each octave contributes (0.5 typical)
+     * @param lacunarity - Frequency multiplier per octave (2.0 typical)
+     * @returns Value roughly between -1 and 1
+     */
+    fbm(x: number, y: number, octaves?: number, persistence?: number, lacunarity?: number): number;
+    /**
+     * Ridge noise - creates sharp ridges, good for mountain silhouettes
+     */
+    ridgeNoise(x: number, y: number, octaves?: number, persistence?: number, lacunarity?: number): number;
+    /**
+     * Turbulence - absolute value noise, always positive, good for clouds/foliage
+     */
+    turbulence(x: number, y: number, octaves?: number, persistence?: number, lacunarity?: number): number;
+}
+export declare function getPerlinNoise(seed?: number): PerlinNoise;
+//# sourceMappingURL=PerlinNoise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PerlinNoise.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/services/noise/PerlinNoise.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAW;gBAEjB,IAAI,CAAC,EAAE,MAAM;IAOzB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,IAAI;IAQZ;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IA0BrC;;;;;;;;;;OAUG;IACH,GAAG,CACD,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,MAAU,EACnB,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAY,GACvB,MAAM;IAgBT;;OAEG;IACH,UAAU,CACR,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,MAAU,EACnB,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAY,GACvB,MAAM;IAkBT;;OAEG;IACH,UAAU,CACR,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,MAAU,EACnB,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAY,GACvB,MAAM;CAeV;AAKD,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAQzD"}

package/dist/backgrounds/firefly-forest/services/noise/PerlinNoise.js

@@ -0,0 +1,143 @@
+/**
+ * Perlin Noise Implementation
+ *
+ * Classic Perlin noise for organic texture generation.
+ * Used for foliage edges, terrain variation, and natural randomness.
+ *
+ * Based on Ken Perlin's improved noise algorithm.
+ */
+export class PerlinNoise {
+    permutation;
+    p;
+    constructor(seed) {
+        // Generate permutation table
+        this.permutation = this.generatePermutation(seed);
+        // Double it to avoid overflow
+        this.p = [...this.permutation, ...this.permutation];
+    }
+    generatePermutation(seed) {
+        const perm = Array.from({ length: 256 }, (_, i) => i);
+        // Seeded shuffle using simple LCG
+        let s = seed ?? Math.floor(Math.random() * 2147483647);
+        const random = () => {
+            s = (s * 1103515245 + 12345) & 0x7fffffff;
+            return s / 0x7fffffff;
+        };
+        // Fisher-Yates shuffle
+        for (let i = 255; i > 0; i--) {
+            const j = Math.floor(random() * (i + 1));
+            const temp = perm[i];
+            perm[i] = perm[j];
+            perm[j] = temp;
+        }
+        return perm;
+    }
+    fade(t) {
+        // 6t^5 - 15t^4 + 10t^3 (improved smoothstep)
+        return t * t * t * (t * (t * 6 - 15) + 10);
+    }
+    lerp(a, b, t) {
+        return a + t * (b - a);
+    }
+    grad(hash, x, y) {
+        // Convert low 4 bits of hash into gradient direction
+        const h = hash & 15;
+        const u = h < 8 ? x : y;
+        const v = h < 4 ? y : h === 12 || h === 14 ? x : 0;
+        return ((h & 1) === 0 ? u : -u) + ((h & 2) === 0 ? v : -v);
+    }
+    /**
+     * 2D Perlin noise
+     * @returns Value between -1 and 1
+     */
+    noise2D(x, y) {
+        // Find unit grid cell
+        const X = Math.floor(x) & 255;
+        const Y = Math.floor(y) & 255;
+        // Get relative position in cell
+        const xf = x - Math.floor(x);
+        const yf = y - Math.floor(y);
+        // Compute fade curves
+        const u = this.fade(xf);
+        const v = this.fade(yf);
+        // Hash coordinates of cube corners
+        const aa = this.p[this.p[X] + Y];
+        const ab = this.p[this.p[X] + Y + 1];
+        const ba = this.p[this.p[X + 1] + Y];
+        const bb = this.p[this.p[X + 1] + Y + 1];
+        // Blend results from corners
+        const x1 = this.lerp(this.grad(aa, xf, yf), this.grad(ba, xf - 1, yf), u);
+        const x2 = this.lerp(this.grad(ab, xf, yf - 1), this.grad(bb, xf - 1, yf - 1), u);
+        return this.lerp(x1, x2, v);
+    }
+    /**
+     * Fractal Brownian Motion (fBm) - stacked octaves of noise
+     * Creates more natural, detailed textures
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param octaves - Number of noise layers (more = more detail)
+     * @param persistence - How much each octave contributes (0.5 typical)
+     * @param lacunarity - Frequency multiplier per octave (2.0 typical)
+     * @returns Value roughly between -1 and 1
+     */
+    fbm(x, y, octaves = 4, persistence = 0.5, lacunarity = 2.0) {
+        let total = 0;
+        let amplitude = 1;
+        let frequency = 1;
+        let maxValue = 0;
+        for (let i = 0; i < octaves; i++) {
+            total += this.noise2D(x * frequency, y * frequency) * amplitude;
+            maxValue += amplitude;
+            amplitude *= persistence;
+            frequency *= lacunarity;
+        }
+        return total / maxValue;
+    }
+    /**
+     * Ridge noise - creates sharp ridges, good for mountain silhouettes
+     */
+    ridgeNoise(x, y, octaves = 4, persistence = 0.5, lacunarity = 2.0) {
+        let total = 0;
+        let amplitude = 1;
+        let frequency = 1;
+        let maxValue = 0;
+        for (let i = 0; i < octaves; i++) {
+            // Take absolute value and invert to create ridges
+            const n = 1 - Math.abs(this.noise2D(x * frequency, y * frequency));
+            total += n * n * amplitude; // Square for sharper ridges
+            maxValue += amplitude;
+            amplitude *= persistence;
+            frequency *= lacunarity;
+        }
+        return total / maxValue;
+    }
+    /**
+     * Turbulence - absolute value noise, always positive, good for clouds/foliage
+     */
+    turbulence(x, y, octaves = 4, persistence = 0.5, lacunarity = 2.0) {
+        let total = 0;
+        let amplitude = 1;
+        let frequency = 1;
+        let maxValue = 0;
+        for (let i = 0; i < octaves; i++) {
+            total += Math.abs(this.noise2D(x * frequency, y * frequency)) * amplitude;
+            maxValue += amplitude;
+            amplitude *= persistence;
+            frequency *= lacunarity;
+        }
+        return total / maxValue;
+    }
+}
+// Singleton instance with default seed for consistent results
+let defaultInstance = null;
+export function getPerlinNoise(seed) {
+    if (seed !== undefined) {
+        return new PerlinNoise(seed);
+    }
+    if (!defaultInstance) {
+        defaultInstance = new PerlinNoise(42);
+    }
+    return defaultInstance;
+}
+//# sourceMappingURL=PerlinNoise.js.map

package/dist/backgrounds/firefly-forest/services/noise/PerlinNoise.js.map

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

package/dist/backgrounds/firefly-forest/services/rendering/ForestCanvasRenderer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Forest Canvas Renderer
+ *
+ * Renders the procedural forest to a 2D canvas context.
+ * Handles all visual elements:
+ * - Tree silhouettes (deciduous, conifer, bare)
+ * - Ground vegetation (bushes, grass, ferns)
+ * - Atmospheric effects (fog, mist)
+ * - Easter eggs (moon, bats, owls, shooting stars)
+ * - Wind animation transforms
+ */
+import type { ProceduralForestSystem } from "../ProceduralForestSystem.js";
+export interface ForestRendererConfig {
+    treeSilhouetteColor: string;
+    nearTreeColor: string;
+    farTreeColor: string;
+    groundColor: string;
+    grassColor: string;
+    renderShadows: boolean;
+    renderGlow: boolean;
+    glowIntensity: number;
+    debugMode: boolean;
+    showBounds: boolean;
+}
+export declare class ForestCanvasRenderer {
+    private config;
+    private cachedTreePaths;
+    constructor(config?: Partial<ForestRendererConfig>);
+    /**
+     * Render the entire forest scene
+     */
+    render(ctx: CanvasRenderingContext2D, forest: ProceduralForestSystem, width: number, height: number): void;
+    private renderMoon;
+    private renderShootingStars;
+    private renderTreesAndFog;
+    private renderTreeSilhouette;
+    private renderDeciduousTree;
+    private renderConiferTree;
+    private renderBareTree;
+    private renderGroundElements;
+    private renderGrass;
+    private renderGroundFog;
+    private renderBats;
+    private renderOwls;
+    private getTreeColor;
+    private renderDebugInfo;
+    setConfig(config: Partial<ForestRendererConfig>): void;
+    getConfig(): ForestRendererConfig;
+}
+//# sourceMappingURL=ForestCanvasRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ForestCanvasRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/services/rendering/ForestCanvasRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,8BAA8B,CAAC;AAUtC,MAAM,WAAW,oBAAoB;IAEnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IAGnB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IAGtB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAeD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,eAAe,CAAkC;gBAE7C,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAItD;;OAEG;IACH,MAAM,CACJ,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI;IAsBP,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,mBAAmB;IAsC3B,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;IAwD3B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,oBAAoB;IAoC5B,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,eAAe;IAsDvB,OAAO,CAAC,UAAU;IA0DlB,OAAO,CAAC,UAAU;IA0ClB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,eAAe;IA2BvB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAItD,SAAS,IAAI,oBAAoB;CAGlC"}