@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/services/composition/ParallaxForestComposer.js

@@ -0,0 +1,299 @@
+/**
+ * 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 { PerlinNoise } from "../noise/PerlinNoise.js";
+import { SpaceColonizationTree, } from "../trees/SpaceColonizationTree.js";
+import { StochasticConiferTree, } from "../trees/StochasticConiferTree.js";
+import { BareTree } from "../trees/BareTree.js";
+const DEFAULT_CONFIG = {
+    width: 1920,
+    height: 1080,
+    layerCount: 5,
+    treesPerLayer: [8, 10, 12, 14, 10],
+    layerDepths: [0, 0.25, 0.5, 0.75, 1],
+    treeSpacing: 80,
+    heightVariation: 30,
+    groundLineY: 0.9,
+    coniferRatio: 0.4,
+    deciduousRatio: 0.45,
+    bareRatio: 0.15,
+    parallaxRange: 100,
+    parallaxSmoothing: 0.15,
+    fogNearColor: "#1a2a35",
+    fogFarColor: "#0d1a24",
+    fogDensity: 0.7,
+    nearScale: 1.2,
+    farScale: 0.3,
+};
+export class ParallaxForestComposer {
+    config;
+    noise;
+    layers = [];
+    treeIdCounter = 0;
+    // Cached generators
+    deciduousGenerator;
+    coniferGenerators = new Map();
+    bareGenerators = new Map();
+    constructor(config = {}, seed) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.noise = new PerlinNoise(seed);
+        // Initialize generators
+        this.deciduousGenerator = new SpaceColonizationTree({}, seed);
+        const coniferTypes = ["pine", "fir", "spruce", "cedar"];
+        coniferTypes.forEach((type, i) => {
+            this.coniferGenerators.set(type, new StochasticConiferTree({ type }, (seed ?? 0) + i * 100));
+        });
+        const bareTypes = ["dead", "winter-oak", "birch", "willow"];
+        bareTypes.forEach((type, i) => {
+            this.bareGenerators.set(type, new BareTree({ type }, (seed ?? 0) + i * 200));
+        });
+    }
+    /**
+     * Generate all forest layers and trees
+     */
+    generate() {
+        this.layers = [];
+        this.treeIdCounter = 0;
+        const { layerCount, treesPerLayer, layerDepths } = this.config;
+        for (let i = 0; i < layerCount; i++) {
+            const depth = layerDepths[i] ?? i / (layerCount - 1);
+            const treeCount = treesPerLayer[i] ?? Math.floor(8 + i * 2);
+            const layer = this.generateLayer(i, depth, treeCount);
+            this.layers.push(layer);
+        }
+        return this.layers;
+    }
+    generateLayer(index, depth, treeCount) {
+        const { width, height, groundLineY, nearScale, farScale, fogNearColor, fogFarColor, fogDensity } = this.config;
+        // Calculate layer properties based on depth
+        const scale = farScale + (nearScale - farScale) * depth;
+        const opacity = 0.3 + depth * 0.7; // Far layers more transparent
+        const parallaxFactor = 0.2 + depth * 0.8; // Far layers move slower
+        const yOffset = groundLineY * height + (1 - depth) * 50; // Far layers slightly higher
+        // Fog properties
+        const fogOpacity = fogDensity * (1 - depth);
+        const layer = {
+            index,
+            depth,
+            treeCount,
+            trees: [],
+            parallaxFactor,
+            scale,
+            opacity,
+            yOffset,
+            fogColor: this.lerpColor(fogFarColor, fogNearColor, depth),
+            fogOpacity,
+        };
+        // Generate trees for this layer
+        layer.trees = this.generateTreesForLayer(layer, treeCount);
+        return layer;
+    }
+    generateTreesForLayer(layer, count) {
+        const trees = [];
+        const { width, treeSpacing, heightVariation, coniferRatio, deciduousRatio } = this.config;
+        // Calculate horizontal positions with noise-based distribution
+        const positions = this.distributeTreePositions(count, width, treeSpacing, layer.index);
+        for (let i = 0; i < count; i++) {
+            const x = positions[i];
+            const heightOffset = this.noise.noise2D(x * 0.01 + layer.index * 10, i) * heightVariation * layer.scale;
+            // Determine tree type based on ratios
+            const typeRoll = this.noise.noise2D(x * 0.05, i * 0.5 + layer.index * 100);
+            const normalizedRoll = (typeRoll + 1) / 2;
+            let treeType;
+            let subType;
+            if (normalizedRoll < coniferRatio) {
+                treeType = "conifer";
+                const types = ["pine", "fir", "spruce", "cedar"];
+                subType = types[Math.floor(Math.abs(this.noise.noise2D(x, i) * types.length)) % types.length];
+            }
+            else if (normalizedRoll < coniferRatio + deciduousRatio) {
+                treeType = "deciduous";
+                subType = "oak"; // Space colonization is naturally oak-like
+            }
+            else {
+                treeType = "bare";
+                const types = ["dead", "winter-oak", "birch", "willow"];
+                subType = types[Math.floor(Math.abs(this.noise.noise2D(x * 2, i) * types.length)) % types.length];
+            }
+            // Generate the tree
+            const tree = this.generateTree(this.treeIdCounter++, x, layer.yOffset + heightOffset, layer.scale * (0.8 + Math.random() * 0.4), layer.depth, layer.index, treeType, subType);
+            trees.push(tree);
+        }
+        // Sort by y position for proper overlap
+        trees.sort((a, b) => a.baseY - b.baseY);
+        return trees;
+    }
+    generateTree(id, x, baseY, scale, depth, layerIndex, treeType, subType) {
+        let generatedData;
+        // Generate based on type
+        switch (treeType) {
+            case "deciduous":
+                generatedData = this.deciduousGenerator.generate(0, 0);
+                break;
+            case "conifer":
+                const coniferGen = this.coniferGenerators.get(subType);
+                generatedData = coniferGen
+                    ? coniferGen.generate(0, 0)
+                    : this.coniferGenerators.get("pine").generate(0, 0);
+                break;
+            case "bare":
+                const bareGen = this.bareGenerators.get(subType);
+                generatedData = bareGen ? bareGen.generate(0, 0) : this.bareGenerators.get("dead").generate(0, 0);
+                break;
+        }
+        return {
+            id: `tree-${id}`,
+            x,
+            baseY,
+            scale,
+            depth,
+            layerIndex,
+            treeType,
+            subType,
+            generatedData,
+            opacity: 0.5 + depth * 0.5,
+            parallaxOffset: 0,
+        };
+    }
+    distributeTreePositions(count, width, minSpacing, layerSeed) {
+        const positions = [];
+        const attemptLimit = count * 10;
+        let attempts = 0;
+        // Add some trees off-screen for parallax scrolling
+        const extendedWidth = width * 1.4;
+        const offsetX = -width * 0.2;
+        while (positions.length < count && attempts < attemptLimit) {
+            // Noise-based position with some randomness
+            const baseX = (this.noise.noise2D(attempts * 0.3 + layerSeed, positions.length) + 1) /
+                2 *
+                extendedWidth +
+                offsetX;
+            // Check spacing from existing positions
+            const tooClose = positions.some((px) => Math.abs(px - baseX) < minSpacing);
+            if (!tooClose) {
+                positions.push(baseX);
+            }
+            attempts++;
+        }
+        // Fill remaining with evenly distributed positions
+        while (positions.length < count) {
+            positions.push(offsetX + (positions.length / count) * extendedWidth);
+        }
+        return positions.sort((a, b) => a - b);
+    }
+    /**
+     * Update parallax positions based on input value
+     * @param parallaxValue -1 to 1, typically from mouse/tilt
+     */
+    updateParallax(parallaxValue) {
+        const { parallaxRange, parallaxSmoothing } = this.config;
+        for (const layer of this.layers) {
+            const targetOffset = parallaxValue * parallaxRange * layer.parallaxFactor;
+            for (const tree of layer.trees) {
+                // Smooth interpolation
+                tree.parallaxOffset += (targetOffset - tree.parallaxOffset) * parallaxSmoothing;
+            }
+        }
+    }
+    /**
+     * Get all layers in order (far to near)
+     */
+    getLayers() {
+        return [...this.layers].sort((a, b) => a.depth - b.depth);
+    }
+    /**
+     * Get all trees across all layers, sorted for rendering
+     */
+    getAllTreesSorted() {
+        const allTrees = [];
+        for (const layer of this.layers) {
+            allTrees.push(...layer.trees);
+        }
+        // Sort by depth (far first), then by Y position
+        return allTrees.sort((a, b) => {
+            if (a.depth !== b.depth)
+                return a.depth - b.depth;
+            return a.baseY - b.baseY;
+        });
+    }
+    /**
+     * Regenerate trees in a specific layer
+     */
+    regenerateLayer(layerIndex) {
+        const layer = this.layers[layerIndex];
+        if (layer) {
+            layer.trees = this.generateTreesForLayer(layer, layer.treeCount);
+        }
+    }
+    /**
+     * Update canvas dimensions and regenerate
+     */
+    resize(width, height) {
+        this.config.width = width;
+        this.config.height = height;
+        this.generate();
+    }
+    /**
+     * Get fog properties for a specific depth
+     */
+    getFogAtDepth(depth) {
+        const { fogNearColor, fogFarColor, fogDensity } = this.config;
+        return {
+            color: this.lerpColor(fogFarColor, fogNearColor, depth),
+            opacity: fogDensity * (1 - depth),
+        };
+    }
+    lerpColor(color1, color2, t) {
+        // Parse hex colors
+        const c1 = this.hexToRgb(color1);
+        const c2 = this.hexToRgb(color2);
+        if (!c1 || !c2)
+            return color1;
+        const r = Math.round(c1.r + (c2.r - c1.r) * t);
+        const g = Math.round(c1.g + (c2.g - c1.g) * t);
+        const b = Math.round(c1.b + (c2.b - c1.b) * t);
+        return `rgb(${r}, ${g}, ${b})`;
+    }
+    hexToRgb(hex) {
+        const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+        if (!result || !result[1] || !result[2] || !result[3])
+            return null;
+        return {
+            r: parseInt(result[1], 16),
+            g: parseInt(result[2], 16),
+            b: parseInt(result[3], 16),
+        };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getStats() {
+        let totalTrees = 0;
+        const treesByType = {
+            deciduous: 0,
+            conifer: 0,
+            bare: 0,
+        };
+        for (const layer of this.layers) {
+            totalTrees += layer.trees.length;
+            for (const tree of layer.trees) {
+                treesByType[tree.treeType]++;
+            }
+        }
+        return {
+            layerCount: this.layers.length,
+            totalTrees,
+            treesByType,
+        };
+    }
+}
+//# sourceMappingURL=ParallaxForestComposer.js.map

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

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

package/dist/backgrounds/firefly-forest/services/ground/GroundLayerSystem.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 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.
+ */
+export type GroundElementType = "bush" | "grass" | "fern" | "rock" | "stump";
+export interface GroundElement {
+    id: string;
+    type: GroundElementType;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    depth: number;
+    silhouettePoints: Array<{
+        x: number;
+        y: number;
+    }>;
+    opacity: number;
+}
+export interface GrassBlade {
+    baseX: number;
+    baseY: number;
+    tipX: number;
+    tipY: number;
+    controlX: number;
+    controlY: number;
+    thickness: number;
+}
+export interface GrassTuft {
+    id: string;
+    x: number;
+    y: number;
+    depth: number;
+    blades: GrassBlade[];
+    width: number;
+    height: number;
+}
+export interface GroundLayerConfig {
+    width: number;
+    height: number;
+    groundLineY: number;
+    bushCount: number;
+    bushMinSize: number;
+    bushMaxSize: number;
+    bushNoiseScale: number;
+    bushNoiseAmplitude: number;
+    grassTuftCount: number;
+    bladesPerTuft: number;
+    grassMinHeight: number;
+    grassMaxHeight: number;
+    grassCurvature: number;
+    fernCount: number;
+    fernMinSize: number;
+    fernMaxSize: number;
+    frondCount: number;
+    clusteringStrength: number;
+    depthLayers: number;
+}
+export declare class GroundLayerSystem {
+    private config;
+    private noise;
+    private elements;
+    private grassTufts;
+    private idCounter;
+    constructor(config?: Partial<GroundLayerConfig>, seed?: number);
+    /**
+     * Generate all ground elements
+     */
+    generate(): void;
+    private generateLayerElements;
+    private generateBush;
+    private generateBushSilhouette;
+    private generateGrassTuft;
+    private generateFern;
+    private generateFernSilhouette;
+    /**
+     * Get all ground elements for rendering
+     */
+    getElements(): GroundElement[];
+    /**
+     * Get all grass tufts for rendering
+     */
+    getGrassTufts(): GrassTuft[];
+    /**
+     * Get elements by type
+     */
+    getElementsByType(type: GroundElementType): GroundElement[];
+    /**
+     * Get elements at a specific depth layer
+     */
+    getElementsAtDepth(depth: number, tolerance?: number): GroundElement[];
+    /**
+     * Resize and regenerate
+     */
+    resize(width: number, height: number): void;
+    getConfig(): GroundLayerConfig;
+    getStats(): {
+        totalElements: number;
+        bushes: number;
+        grassTufts: number;
+        ferns: number;
+        totalBlades: number;
+    };
+}
+//# sourceMappingURL=GroundLayerSystem.d.ts.map

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

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