@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/services/trees/BareTree.js

@@ -0,0 +1,215 @@
+/**
+ * Bare Tree Generator
+ *
+ * Generates dead/winter tree silhouettes with exposed branch structure.
+ * No foliage - just the skeletal framework of branches.
+ *
+ * Uses recursive branching with decreasing probability and thickness,
+ * combined with noise-based variation for organic appearance.
+ */
+import { PerlinNoise } from "../noise/PerlinNoise.js";
+const TYPE_PRESETS = {
+    dead: {
+        maxDepth: 5,
+        branchProbability: 0.7,
+        branchAngleRange: Math.PI * 0.4,
+        branchLengthRatio: 0.7,
+        branchThicknessRatio: 0.65,
+        gnarliness: 0.5,
+        asymmetry: 0.4,
+        droop: 0.1,
+        brokenBranches: 0.3,
+        leanAngle: 0.15,
+        crookedness: 0.4,
+    },
+    "winter-oak": {
+        maxDepth: 6,
+        branchProbability: 0.85,
+        branchAngleRange: Math.PI * 0.35,
+        branchLengthRatio: 0.65,
+        branchThicknessRatio: 0.7,
+        gnarliness: 0.35,
+        asymmetry: 0.25,
+        droop: 0.05,
+        brokenBranches: 0.05,
+        leanAngle: 0.05,
+        crookedness: 0.2,
+    },
+    birch: {
+        maxDepth: 7,
+        branchProbability: 0.75,
+        branchAngleRange: Math.PI * 0.25,
+        branchLengthRatio: 0.75,
+        branchThicknessRatio: 0.55,
+        gnarliness: 0.15,
+        asymmetry: 0.15,
+        droop: 0.15,
+        brokenBranches: 0.02,
+        leanAngle: 0.08,
+        crookedness: 0.1,
+    },
+    willow: {
+        maxDepth: 6,
+        branchProbability: 0.8,
+        branchAngleRange: Math.PI * 0.3,
+        branchLengthRatio: 0.7,
+        branchThicknessRatio: 0.6,
+        gnarliness: 0.25,
+        asymmetry: 0.3,
+        droop: 0.5, // Willows droop significantly
+        brokenBranches: 0.02,
+        leanAngle: 0.1,
+        crookedness: 0.15,
+    },
+};
+const DEFAULT_CONFIG = {
+    type: "dead",
+    height: 120,
+    trunkThickness: 10,
+    maxDepth: 5,
+    branchProbability: 0.75,
+    branchAngleRange: Math.PI * 0.35,
+    branchLengthRatio: 0.7,
+    branchThicknessRatio: 0.65,
+    gnarliness: 0.3,
+    asymmetry: 0.3,
+    droop: 0.1,
+    brokenBranches: 0.15,
+    leanAngle: 0.1,
+    crookedness: 0.25,
+};
+export class BareTree {
+    config;
+    noise;
+    branches = [];
+    noiseOffset;
+    constructor(config = {}, seed) {
+        const typePreset = config.type ? TYPE_PRESETS[config.type] : {};
+        this.config = { ...DEFAULT_CONFIG, ...typePreset, ...config };
+        this.noise = new PerlinNoise(seed);
+        this.noiseOffset = (seed ?? Math.random() * 1000) * 0.01;
+    }
+    generate(baseX, baseY) {
+        this.branches = [];
+        // Generate the tree recursively starting from trunk
+        this.generateBranch(baseX, baseY, -Math.PI / 2 + this.config.leanAngle, // Base angle (up, with lean)
+        this.config.height, this.config.trunkThickness, 0 // Depth 0 = trunk
+        );
+        // Calculate bounds
+        const bounds = this.calculateBounds();
+        return {
+            branches: [...this.branches],
+            bounds,
+            trunkBase: { x: baseX, y: baseY },
+            type: this.config.type,
+        };
+    }
+    generateBranch(startX, startY, angle, length, thickness, depth) {
+        const { maxDepth, branchProbability, branchAngleRange, branchLengthRatio, branchThicknessRatio, gnarliness, asymmetry, droop, brokenBranches, crookedness, } = this.config;
+        // Stop if too deep or too thin
+        if (depth > maxDepth || thickness < 0.5 || length < 3) {
+            return;
+        }
+        // Check for broken branch (more likely at higher depths)
+        if (depth > 1 && Math.random() < brokenBranches * (depth / maxDepth)) {
+            // Truncate this branch - make it shorter and stop
+            length *= 0.3 + Math.random() * 0.3;
+        }
+        // Apply crookedness to angle (more for trunk)
+        const crookNoise = this.noise.noise2D(startY * 0.05 + this.noiseOffset, depth) *
+            crookedness *
+            0.3 *
+            (1 - depth / maxDepth);
+        angle += crookNoise;
+        // Calculate segments for this branch (more segments for thicker branches)
+        const segments = Math.max(2, Math.ceil(thickness * 0.8));
+        const segmentLength = length / segments;
+        let currentX = startX;
+        let currentY = startY;
+        let currentAngle = angle;
+        let currentThickness = thickness;
+        // Draw segments of this branch
+        for (let seg = 0; seg < segments; seg++) {
+            // Apply gnarliness variation to angle per segment
+            const segmentNoise = this.noise.noise2D(currentX * 0.02 + this.noiseOffset, currentY * 0.02 + seg * 0.5) *
+                gnarliness *
+                0.4;
+            currentAngle += segmentNoise;
+            // Apply droop (accumulates along branch)
+            currentAngle += (droop * 0.1 * (seg + 1)) / segments;
+            // Calculate end point
+            const endX = currentX + Math.cos(currentAngle) * segmentLength;
+            const endY = currentY + Math.sin(currentAngle) * segmentLength;
+            // Taper thickness
+            const segmentThickness = currentThickness * (1 - (seg / segments) * 0.3);
+            this.branches.push({
+                startX: currentX,
+                startY: currentY,
+                endX,
+                endY,
+                thickness: segmentThickness,
+                depth,
+            });
+            // Possibly spawn sub-branches from this segment
+            if (depth < maxDepth && seg > 0) {
+                // Adjusted probability based on position and randomness
+                const spawnProbability = branchProbability * (0.5 + (seg / segments) * 0.5);
+                // Left branch
+                if (Math.random() < spawnProbability * (0.8 + asymmetry * 0.4)) {
+                    const branchAngle = currentAngle -
+                        branchAngleRange * (0.3 + Math.random() * 0.7) +
+                        this.noise.noise2D(currentX * 0.1, currentY * 0.1) * asymmetry * 0.5;
+                    this.generateBranch(currentX, currentY, branchAngle, length * branchLengthRatio * (0.7 + Math.random() * 0.3), segmentThickness * branchThicknessRatio, depth + 1);
+                }
+                // Right branch (with asymmetry making one side more likely)
+                if (Math.random() < spawnProbability * (0.8 - asymmetry * 0.3)) {
+                    const branchAngle = currentAngle +
+                        branchAngleRange * (0.3 + Math.random() * 0.7) +
+                        this.noise.noise2D(currentX * 0.1 + 50, currentY * 0.1) *
+                            asymmetry *
+                            0.5;
+                    this.generateBranch(currentX, currentY, branchAngle, length * branchLengthRatio * (0.7 + Math.random() * 0.3), segmentThickness * branchThicknessRatio, depth + 1);
+                }
+            }
+            currentX = endX;
+            currentY = endY;
+        }
+    }
+    calculateBounds() {
+        if (this.branches.length === 0) {
+            return { minX: 0, maxX: 0, minY: 0, maxY: 0 };
+        }
+        let minX = Infinity;
+        let maxX = -Infinity;
+        let minY = Infinity;
+        let maxY = -Infinity;
+        for (const branch of this.branches) {
+            const halfThick = branch.thickness / 2;
+            minX = Math.min(minX, branch.startX - halfThick, branch.endX - halfThick);
+            maxX = Math.max(maxX, branch.startX + halfThick, branch.endX + halfThick);
+            minY = Math.min(minY, branch.startY - halfThick, branch.endY - halfThick);
+            maxY = Math.max(maxY, branch.startY + halfThick, branch.endY + halfThick);
+        }
+        return { minX, maxX, minY, maxY };
+    }
+}
+/**
+ * Create a randomized bare tree configuration
+ */
+export function createRandomBareTreeConfig(type, scale = 1, seed) {
+    const noise = new PerlinNoise(seed);
+    const r = (base, variance) => base + noise.noise2D(base * 0.1, seed ?? 0) * variance;
+    const preset = TYPE_PRESETS[type];
+    return {
+        type,
+        height: r(100, 50) * scale,
+        trunkThickness: r(8, 4) * scale,
+        gnarliness: r(preset.gnarliness ?? 0.3, 0.2),
+        asymmetry: r(preset.asymmetry ?? 0.3, 0.2),
+        droop: r(preset.droop ?? 0.1, 0.1),
+        brokenBranches: r(preset.brokenBranches ?? 0.15, 0.1),
+        leanAngle: r(preset.leanAngle ?? 0.1, 0.1),
+        crookedness: r(preset.crookedness ?? 0.25, 0.15),
+    };
+}
+//# sourceMappingURL=BareTree.js.map

package/dist/backgrounds/firefly-forest/services/trees/BareTree.js.map

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

package/dist/backgrounds/firefly-forest/services/trees/EcologicalPatternProvider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Ecological Pattern Provider
+ *
+ * Manages ecological patterns and zone-based tree type selection.
+ * Patterns define how tree types are distributed across the scene
+ * based on real-world forest biomes.
+ */
+import type { TreeType, EcologicalPattern, EcologicalZone } from "../../domain/models/tree-silhouette-models.js";
+export interface IEcologicalPatternProvider {
+    /** Get the current pattern */
+    getCurrentPattern(): EcologicalPattern;
+    /** Set the ecological pattern by ID */
+    setEcologicalPattern(patternId: string): void;
+    /** Get the current ecological pattern ID */
+    getEcologicalPatternId(): string;
+    /** Get the current ecological pattern details */
+    getEcologicalPattern(): EcologicalPattern;
+    /** Get all available ecological patterns */
+    getAvailablePatterns(): EcologicalPattern[];
+    /** Set a random ecological pattern (excluding "random" itself) */
+    setRandomEcologicalPattern(): string;
+    /** Find which zone a position falls into for the current pattern */
+    getZoneForPosition(normalizedX: number): EcologicalZone | null;
+    /**
+     * Pick a tree type based on position and current ecological pattern.
+     * Respects visibility settings and zone weights.
+     * @param normalizedX - Position as 0-1 normalized x coordinate
+     * @param enabledTypes - List of currently visible/enabled tree types
+     * @param random - Random function to use (for seeded randomness)
+     */
+    pickTypeForPosition(normalizedX: number, enabledTypes: TreeType[], random: () => number): TreeType;
+}
+export declare function createEcologicalPatternProvider(): IEcologicalPatternProvider;
+//# sourceMappingURL=EcologicalPatternProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EcologicalPatternProvider.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/services/trees/EcologicalPatternProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACf,MAAM,+CAA+C,CAAC;AAGvD,MAAM,WAAW,0BAA0B;IACzC,8BAA8B;IAC9B,iBAAiB,IAAI,iBAAiB,CAAC;IAEvC,uCAAuC;IACvC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9C,4CAA4C;IAC5C,sBAAsB,IAAI,MAAM,CAAC;IAEjC,iDAAiD;IACjD,oBAAoB,IAAI,iBAAiB,CAAC;IAE1C,4CAA4C;IAC5C,oBAAoB,IAAI,iBAAiB,EAAE,CAAC;IAE5C,kEAAkE;IAClE,0BAA0B,IAAI,MAAM,CAAC;IAErC,oEAAoE;IACpE,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAE/D;;;;;;OAMG;IACH,mBAAmB,CACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,QAAQ,EAAE,EACxB,MAAM,EAAE,MAAM,MAAM,GACnB,QAAQ,CAAC;CACb;AAED,wBAAgB,+BAA+B,IAAI,0BAA0B,CAuG5E"}

package/dist/backgrounds/firefly-forest/services/trees/EcologicalPatternProvider.js

@@ -0,0 +1,89 @@
+/**
+ * Ecological Pattern Provider
+ *
+ * Manages ecological patterns and zone-based tree type selection.
+ * Patterns define how tree types are distributed across the scene
+ * based on real-world forest biomes.
+ */
+import { ECOLOGICAL_PATTERNS } from "../../domain/constants/tree-silhouette-constants.js";
+export function createEcologicalPatternProvider() {
+    let currentPatternId = "random"; // Default to random distribution
+    function getCurrentPattern() {
+        return (ECOLOGICAL_PATTERNS.find((p) => p.id === currentPatternId) ||
+            ECOLOGICAL_PATTERNS[0]);
+    }
+    function setEcologicalPattern(patternId) {
+        const pattern = ECOLOGICAL_PATTERNS.find((p) => p.id === patternId);
+        if (pattern) {
+            currentPatternId = patternId;
+        }
+    }
+    function getEcologicalPatternId() {
+        return currentPatternId;
+    }
+    function getEcologicalPattern() {
+        return getCurrentPattern();
+    }
+    function getAvailablePatterns() {
+        return [...ECOLOGICAL_PATTERNS];
+    }
+    function setRandomEcologicalPattern() {
+        const nonRandomPatterns = ECOLOGICAL_PATTERNS.filter((p) => p.id !== "random");
+        const randomPattern = nonRandomPatterns[Math.floor(Math.random() * nonRandomPatterns.length)];
+        currentPatternId = randomPattern.id;
+        return randomPattern.id;
+    }
+    function getZoneForPosition(normalizedX) {
+        const pattern = getCurrentPattern();
+        for (const zone of pattern.zones) {
+            if (normalizedX >= zone.startX && normalizedX < zone.endX) {
+                return zone;
+            }
+        }
+        // Fallback to last zone if at exact end
+        return pattern.zones[pattern.zones.length - 1] || null;
+    }
+    function pickTypeForPosition(normalizedX, enabledTypes, random) {
+        const zone = getZoneForPosition(normalizedX);
+        if (!zone) {
+            // Fallback to uniform random from enabled types
+            return enabledTypes[Math.floor(random() * enabledTypes.length)];
+        }
+        // Build weighted list of enabled types only
+        const weightedOptions = [];
+        let totalWeight = 0;
+        for (const type of enabledTypes) {
+            const weight = zone.weights[type] ?? 0;
+            if (weight > 0) {
+                weightedOptions.push({ type, weight });
+                totalWeight += weight;
+            }
+        }
+        // If no weighted options available, fall back to uniform random
+        if (weightedOptions.length === 0 || totalWeight === 0) {
+            return enabledTypes[Math.floor(random() * enabledTypes.length)];
+        }
+        // Weighted random selection
+        const roll = random() * totalWeight;
+        let cumulative = 0;
+        for (const option of weightedOptions) {
+            cumulative += option.weight;
+            if (roll < cumulative) {
+                return option.type;
+            }
+        }
+        // Fallback (shouldn't reach here)
+        return weightedOptions[weightedOptions.length - 1].type;
+    }
+    return {
+        getCurrentPattern,
+        setEcologicalPattern,
+        getEcologicalPatternId,
+        getEcologicalPattern,
+        getAvailablePatterns,
+        setRandomEcologicalPattern,
+        getZoneForPosition,
+        pickTypeForPosition,
+    };
+}
+//# sourceMappingURL=EcologicalPatternProvider.js.map

package/dist/backgrounds/firefly-forest/services/trees/EcologicalPatternProvider.js.map

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

package/dist/backgrounds/firefly-forest/services/trees/FoliageNoiseGenerator.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Foliage Noise Generator
+ *
+ * Generates organic, noise-based foliage edges for tree silhouettes.
+ * Creates the "fluffy" look of tree canopies and foliage clusters
+ * using multiple octaves of noise for natural variation.
+ */
+export interface FoliageEdgeConfig {
+    noiseScale: number;
+    noiseAmplitude: number;
+    octaves: number;
+    bumpiness: number;
+    irregularity: number;
+    density: number;
+    clumpiness: number;
+    leafScale: number;
+}
+export interface FoliageCluster {
+    x: number;
+    y: number;
+    radius: number;
+    edgePoints: Array<{
+        x: number;
+        y: number;
+    }>;
+    density: number;
+}
+export declare class FoliageNoiseGenerator {
+    private config;
+    private noise;
+    private noiseOffset;
+    constructor(config?: Partial<FoliageEdgeConfig>, seed?: number);
+    /**
+     * Generate edge points around a circular foliage cluster
+     */
+    generateCircularFoliage(centerX: number, centerY: number, baseRadius: number, pointCount?: number): FoliageCluster;
+    /**
+     * Generate edge points around an elliptical foliage area
+     */
+    generateEllipticalFoliage(centerX: number, centerY: number, radiusX: number, radiusY: number, pointCount?: number): FoliageCluster;
+    /**
+     * Generate a tree crown silhouette with typical crown shape
+     * (wider at bottom, narrower at top for deciduous trees)
+     */
+    generateCrownSilhouette(centerX: number, baseY: number, width: number, height: number, crownShape?: "round" | "conical" | "spreading" | "columnar", pointCount?: number): Array<{
+        x: number;
+        y: number;
+    }>;
+    /**
+     * Generate multiple small foliage clusters for sparse canopy
+     */
+    generateFoliageClusters(centerX: number, centerY: number, spreadX: number, spreadY: number, clusterCount: number, minRadius: number, maxRadius: number): FoliageCluster[];
+    /**
+     * Sample a single noise value for edge displacement
+     * Useful for applying to pre-existing geometry
+     */
+    sampleEdgeNoise(x: number, y: number): number;
+    /**
+     * Apply foliage noise to an existing set of points
+     * Useful for adding organic edges to simple shapes
+     */
+    applyNoiseToPoints(points: Array<{
+        x: number;
+        y: number;
+    }>, centerX: number, centerY: number): Array<{
+        x: number;
+        y: number;
+    }>;
+}
+/**
+ * Create foliage configs for different tree types
+ */
+export declare const FOLIAGE_PRESETS: Record<string, Partial<FoliageEdgeConfig>>;
+//# sourceMappingURL=FoliageNoiseGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FoliageNoiseGenerator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/services/trees/FoliageNoiseGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,iBAAiB;IAEhC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAGhB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAMlE;;OAEG;IACH,uBAAuB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAW,GACtB,cAAc;IAmEjB;;OAEG;IACH,yBAAyB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAW,GACtB,cAAc;IA8DjB;;;OAGG;IACH,uBAAuB,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,UAAoB,EACpE,UAAU,GAAE,MAAW,GACtB,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqFlC;;OAEG;IACH,uBAAuB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,cAAc,EAAE;IAuBnB;;;OAGG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAU7C;;;OAGG;IACH,kBAAkB,CAChB,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAcnC;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAyCtE,CAAC"}