@austencloud/backgrounds 0.1.0

package/dist/backgrounds/firefly-forest/domain/constants/firefly-constants.js

@@ -0,0 +1,140 @@
+export const FIREFLY_COUNTS = {
+    high: 22, // +20% from 18
+    medium: 14, // +20% from 12
+    low: 10, // +20% from 8
+    minimal: 6, // +20% from 5
+    "ultra-minimal": 3,
+};
+export const FIREFLY_PHYSICS = {
+    // Wandering movement
+    WANDER_SPEED_BASE: 0.12,
+    WANDER_SPEED_RANGE: 0.18,
+    WANDER_ANGLE_CHANGE: 0.02,
+    WANDER_ANGLE_RANGE: 0.05,
+    // Vertical zone constraints (percentage of canvas height)
+    // Expanded to allow fireflies throughout the scene
+    ZONE_TOP: 0.08,
+    ZONE_BOTTOM: 0.92,
+    // Glow properties - subtle, not attention-grabbing
+    GLOW_MULTIPLIER: 5,
+    GLOW_FADE_SPEED: 0.008,
+    // Blinking behavior - gentle, lingering glows
+    BLINK_CYCLE_MIN: 300, // frames (~5 seconds at 60fps)
+    BLINK_CYCLE_RANGE: 420, // up to ~12 seconds total
+    BLINK_ON_DURATION: 0.35, // 35% of cycle is lit (longer glow)
+};
+export const FIREFLY_SIZE = {
+    MIN: 2,
+    RANGE: 2, // 2-4px (smaller, less prominent)
+};
+export const FIREFLY_OPACITY = {
+    MIN: 0.5,
+    RANGE: 0.3, // 0.5-0.8 (more subtle)
+    CORE_MULTIPLIER: 1.2,
+};
+export const FIREFLY_COLORS = {
+    // 50% probability: Yellow-green (classic firefly)
+    YELLOW_GREEN: {
+        r: 190,
+        gMin: 230,
+        gMax: 255,
+        bMin: 80,
+        bMax: 120,
+        probability: 0.5,
+    },
+    // 30% probability: Bright green
+    BRIGHT_GREEN: {
+        r: 163,
+        gMin: 220,
+        gMax: 255,
+        bMin: 50,
+        bMax: 90,
+        probability: 0.8,
+    },
+    // 20% probability: Warm gold
+    WARM_GOLD: {
+        rMin: 250,
+        rMax: 255,
+        gMin: 210,
+        gMax: 240,
+        bMin: 60,
+        bMax: 100,
+    },
+};
+export const FIREFLY_BACKGROUND_GRADIENT = [
+    // Night sky extending down toward horizon (horizon at 78%)
+    // Sky stays dark blue-black until near the horizon, then transitions to green for meadow
+    { position: 0, color: "#0a0e18" }, // Deep night sky (dark blue)
+    { position: 0.35, color: "#0a1018" }, // Sky continues
+    { position: 0.55, color: "#0a1118" }, // Still mostly sky
+    { position: 0.70, color: "#0c1416" }, // Transition begins near horizon
+    { position: 0.78, color: "#0e1814" }, // At horizon - slight green tint
+    { position: 0.90, color: "#101a14" }, // Below horizon (ground color blends)
+    { position: 1, color: "#0c1610" }, // Bottom edge
+];
+// Stars in the upper sky area
+export const STAR_CONFIG = {
+    COUNT: {
+        high: 40,
+        medium: 25,
+        low: 15,
+        minimal: 8,
+        "ultra-minimal": 4,
+    },
+    ZONE_BOTTOM: 0.4, // Stars only in top 40% of screen
+    SIZE_MIN: 0.5,
+    SIZE_RANGE: 1.5,
+    OPACITY_MIN: 0.3,
+    OPACITY_RANGE: 0.5,
+    COLOR: "#c8d4e8", // Soft blue-white
+};
+export const RESPAWN_BUFFER = 50;
+// Depth layers for fireflies (0 = far, 1 = near)
+// Far fireflies are smaller, dimmer, slower - create atmospheric depth
+// Near fireflies are the classic prominent ones
+export const FIREFLY_DEPTH = {
+    // How many depth "bands" to divide fireflies into (0 to NUM_DEPTH_LAYERS-1)
+    NUM_LAYERS: 4,
+    // Distribution: what fraction of fireflies go to each depth band
+    // Index 0 = farthest, last = nearest
+    // More fireflies far away for atmospheric effect
+    LAYER_DISTRIBUTION: [0.35, 0.25, 0.25, 0.15], // 35% far, 25% mid-far, 25% mid-near, 15% near
+    // Size multiplier per depth (far = tiny, near = normal)
+    SIZE_SCALE: [0.4, 0.6, 0.8, 1.0],
+    // Opacity multiplier per depth (far = dim, near = bright)
+    OPACITY_SCALE: [0.4, 0.6, 0.8, 1.0],
+    // Speed multiplier per depth (far = slow, near = normal)
+    SPEED_SCALE: [0.5, 0.65, 0.8, 1.0],
+    // Glow radius multiplier (far = smaller glow)
+    GLOW_SCALE: [0.5, 0.7, 0.85, 1.0],
+    // Vertical zone constraints per layer (as fraction of canvas)
+    // Far fireflies stay higher (behind trees), near fireflies lower (in front)
+    ZONE_TOP: [0.08, 0.15, 0.25, 0.35],
+    ZONE_BOTTOM: [0.55, 0.70, 0.85, 0.92],
+    // Color warmth shift - far fireflies appear slightly cooler (atmospheric)
+    COLOR_SHIFT: [
+        { r: -20, g: -10, b: 10 }, // Far: cooler, bluer
+        { r: -10, g: -5, b: 5 }, // Mid-far: slightly cooler
+        { r: 0, g: 0, b: 0 }, // Mid-near: normal
+        { r: 10, g: 5, b: -5 }, // Near: slightly warmer
+    ],
+};
+// Easter egg: Rare special firefly (1% chance)
+export const SPECIAL_FIREFLY = {
+    CHANCE: 0.01, // 1% chance per firefly
+    COLOR: { r: 255, g: 150, b: 220 }, // Rose/magenta glow
+    SIZE_MULTIPLIER: 1.4, // Slightly larger
+    GLOW_MULTIPLIER: 7, // More prominent glow
+};
+// Easter egg: Shooting star
+export const SHOOTING_STAR = {
+    CHANCE_PER_FRAME: 0.00005, // ~1% per minute at 60fps
+    MIN_INTERVAL_FRAMES: 1800, // At least 30 seconds between stars
+    SPEED: 8, // Pixels per frame
+    LENGTH: 80, // Trail length
+    HEAD_SIZE: 2,
+    DURATION_FRAMES: 60, // How long the animation lasts
+    ZONE_TOP: 0.05, // Only in top portion of sky
+    ZONE_BOTTOM: 0.25,
+};
+//# sourceMappingURL=firefly-constants.js.map

package/dist/backgrounds/firefly-forest/domain/constants/firefly-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firefly-constants.js","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/domain/constants/firefly-constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,IAAI,EAAE,EAAE,EAAE,eAAe;IACzB,MAAM,EAAE,EAAE,EAAE,eAAe;IAC3B,GAAG,EAAE,EAAE,EAAE,cAAc;IACvB,OAAO,EAAE,CAAC,EAAE,cAAc;IAC1B,eAAe,EAAE,CAAC;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,qBAAqB;IACrB,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,IAAI;IACxB,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,IAAI;IAExB,0DAA0D;IAC1D,mDAAmD;IACnD,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,IAAI;IAEjB,mDAAmD;IACnD,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,KAAK;IAEtB,8CAA8C;IAC9C,eAAe,EAAE,GAAG,EAAE,+BAA+B;IACrD,iBAAiB,EAAE,GAAG,EAAE,0BAA0B;IAClD,iBAAiB,EAAE,IAAI,EAAE,oCAAoC;CACrD,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC,EAAE,kCAAkC;CACpC,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,GAAG;IACR,KAAK,EAAE,GAAG,EAAE,wBAAwB;IACpC,eAAe,EAAE,GAAG;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,kDAAkD;IAClD,YAAY,EAAE;QACZ,CAAC,EAAE,GAAG;QACN,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,GAAG;KACjB;IACD,gCAAgC;IAChC,YAAY,EAAE;QACZ,CAAC,EAAE,GAAG;QACN,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,GAAG;KACjB;IACD,6BAA6B;IAC7B,SAAS,EAAE;QACT,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,GAAG;KACV;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,2DAA2D;IAC3D,yFAAyF;IACzF,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAK,6BAA6B;IACnE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,gBAAgB;IACtD,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,mBAAmB;IACzD,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,iCAAiC;IACvE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,iCAAiC;IACvE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,sCAAsC;IAC5E,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAK,cAAc;CAC5C,CAAC;AAEX,8BAA8B;AAC9B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE;QACL,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,EAAE;QACP,OAAO,EAAE,CAAC;QACV,eAAe,EAAE,CAAC;KACa;IACjC,WAAW,EAAE,GAAG,EAAE,kCAAkC;IACpD,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,WAAW,EAAE,GAAG;IAChB,aAAa,EAAE,GAAG;IAClB,KAAK,EAAE,SAAS,EAAE,kBAAkB;CAC5B,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,iDAAiD;AACjD,uEAAuE;AACvE,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,4EAA4E;IAC5E,UAAU,EAAE,CAAC;IAEb,iEAAiE;IACjE,qCAAqC;IACrC,iDAAiD;IACjD,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,+CAA+C;IAE7F,wDAAwD;IACxD,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAEhC,0DAA0D;IAC1D,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAEnC,yDAAyD;IACzD,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;IAElC,8CAA8C;IAC9C,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC;IAEjC,8DAA8D;IAC9D,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IAClC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IAErC,0EAA0E;IAC1E,WAAW,EAAE;QACX,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAG,qBAAqB;QACjD,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAI,2BAA2B;QACtD,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAQ,mBAAmB;QAC/C,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAM,wBAAwB;KACrD;CACO,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,IAAI,EAAE,wBAAwB;IACtC,KAAK,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,oBAAoB;IACvD,eAAe,EAAE,GAAG,EAAE,kBAAkB;IACxC,eAAe,EAAE,CAAC,EAAE,sBAAsB;CAClC,CAAC;AAEX,4BAA4B;AAC5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB,EAAE,OAAO,EAAE,0BAA0B;IACrD,mBAAmB,EAAE,IAAI,EAAE,oCAAoC;IAC/D,KAAK,EAAE,CAAC,EAAE,mBAAmB;IAC7B,MAAM,EAAE,EAAE,EAAE,eAAe;IAC3B,SAAS,EAAE,CAAC;IACZ,eAAe,EAAE,EAAE,EAAE,+BAA+B;IACpD,QAAQ,EAAE,IAAI,EAAE,6BAA6B;IAC7C,WAAW,EAAE,IAAI;CACT,CAAC"}

package/dist/backgrounds/firefly-forest/domain/constants/tree-silhouette-constants.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tree Silhouette System Constants
+ *
+ * Configuration constants for tree silhouette rendering.
+ */
+import type { LayerConfig, TreeType, TreeTypeScale, EcologicalPattern, PlacementConfig, RGB } from "../models/tree-silhouette-models.js";
+export declare const NUM_LAYERS = 7;
+export declare const NUM_COLUMNS = 10;
+/**
+ * 10-column grid, each layer uses different columns.
+ * Heights are curated to create pleasing silhouette with variety.
+ * 7 layers for smooth depth gradation (far to near).
+ */
+export declare const LAYER_CONFIGS: LayerConfig[];
+/**
+ * Species-specific scale factors based on natural growth characteristics.
+ */
+export declare const TREE_TYPE_SCALES: Record<TreeType, TreeTypeScale>;
+/**
+ * Default placement config - balanced between natural and composed.
+ */
+export declare const DEFAULT_PLACEMENT: PlacementConfig;
+/**
+ * Night silhouette color palette - pure darkness with subtle atmospheric fade.
+ * Most trees stay dark; only the very farthest get a subtle haze lift.
+ */
+export declare const FAR_SILHOUETTE: RGB;
+export declare const NEAR_SILHOUETTE: RGB;
+/** Rim light color - subtle moonlight edge glow */
+export declare const RIM_LIGHT: RGB;
+/**
+ * Preset ecological patterns based on real-world forest biomes.
+ *
+ * VISUAL DISTINCTIVENESS GUIDE:
+ * - Conifers (pine/fir/spruce): Triangular, pointed tops
+ * - Oak/Maple: Wide, rounded crowns
+ * - Poplar: VERY tall and narrow (columnar) - most distinctive!
+ * - Willow: Wide, droopy branches
+ * - Dead: Sparse, skeletal
+ *
+ * Patterns are designed to create VISIBLE differences through shape variety.
+ */
+export declare const ECOLOGICAL_PATTERNS: EcologicalPattern[];
+//# sourceMappingURL=tree-silhouette-constants.d.ts.map

package/dist/backgrounds/firefly-forest/domain/constants/tree-silhouette-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-silhouette-constants.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/domain/constants/tree-silhouette-constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,GAAG,EACJ,MAAM,qCAAqC,CAAC;AAM7C,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EA2CtC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAwB5D,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAK/B,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,GAA6B,CAAC;AAC3D,eAAO,MAAM,eAAe,EAAE,GAA0B,CAAC;AAEzD,mDAAmD;AACnD,eAAO,MAAM,SAAS,EAAE,GAA6B,CAAC;AAMtD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EA4KlD,CAAC"}

package/dist/backgrounds/firefly-forest/domain/constants/tree-silhouette-constants.js

@@ -0,0 +1,295 @@
+/**
+ * Tree Silhouette System Constants
+ *
+ * Configuration constants for tree silhouette rendering.
+ */
+// ===================
+// LAYER CONFIGURATION
+// ===================
+export const NUM_LAYERS = 7;
+export const NUM_COLUMNS = 10;
+/**
+ * 10-column grid, each layer uses different columns.
+ * Heights are curated to create pleasing silhouette with variety.
+ * 7 layers for smooth depth gradation (far to near).
+ */
+export const LAYER_CONFIGS = [
+    // Layer 0: Farthest (tiny, hazy trees on horizon)
+    {
+        columns: [0.5, 2, 4, 6, 8, 9.5],
+        heightPresets: [0.12, 0.14, 0.11, 0.13, 0.15, 0.12],
+        widthRange: [0.03, 0.045],
+    },
+    // Layer 1: Very far
+    {
+        columns: [1, 3, 5, 7, 9],
+        heightPresets: [0.17, 0.19, 0.16, 0.18, 0.2],
+        widthRange: [0.04, 0.055],
+    },
+    // Layer 2: Far
+    {
+        columns: [0, 1.5, 3.5, 5.5, 7.5, 9],
+        heightPresets: [0.22, 0.25, 0.21, 0.24, 0.23, 0.22],
+        widthRange: [0.05, 0.07],
+    },
+    // Layer 3: Mid-far
+    {
+        columns: [0.5, 2.5, 4.5, 6.5, 8.5],
+        heightPresets: [0.29, 0.32, 0.28, 0.31, 0.3],
+        widthRange: [0.065, 0.085],
+    },
+    // Layer 4: Mid
+    {
+        columns: [1, 3, 5, 7, 9.5],
+        heightPresets: [0.36, 0.4, 0.34, 0.38, 0.37],
+        widthRange: [0.08, 0.1],
+    },
+    // Layer 5: Mid-near
+    {
+        columns: [0, 2.5, 5, 7.5, 10],
+        heightPresets: [0.44, 0.48, 0.42, 0.46, 0.45],
+        widthRange: [0.1, 0.13],
+    },
+    // Layer 6: Nearest (large silhouettes)
+    {
+        columns: [1, 4, 7, 9.5],
+        heightPresets: [0.54, 0.6, 0.52, 0.56],
+        widthRange: [0.13, 0.17],
+    },
+];
+// ===================
+// SPECIES SCALING
+// ===================
+/**
+ * Species-specific scale factors based on natural growth characteristics.
+ */
+export const TREE_TYPE_SCALES = {
+    // Oak: Massive, wide spreading crown, moderate height
+    oak: { heightMin: 0.85, heightMax: 1.05, widthMin: 1.3, widthMax: 1.6 },
+    // Pine: Tall with visible trunk, medium spread
+    pine: { heightMin: 1.0, heightMax: 1.2, widthMin: 0.85, widthMax: 1.1 },
+    // Fir: Very tall, narrow conical shape (Douglas fir, etc.)
+    fir: { heightMin: 1.1, heightMax: 1.35, widthMin: 0.65, widthMax: 0.85 },
+    // Spruce: Tall, conical, slightly wider than fir
+    spruce: { heightMin: 1.05, heightMax: 1.25, widthMin: 0.7, widthMax: 0.9 },
+    // Maple: Medium height broadleaf, rounded crown
+    maple: { heightMin: 0.8, heightMax: 1.0, widthMin: 1.0, widthMax: 1.25 },
+    // Poplar: Very tall and narrow, columnar shape (Lombardy poplar)
+    poplar: { heightMin: 1.2, heightMax: 1.45, widthMin: 0.45, widthMax: 0.65 },
+    // Willow: Medium height, very wide drooping crown
+    willow: { heightMin: 0.75, heightMax: 0.95, widthMin: 1.25, widthMax: 1.55 },
+    // Dead: Variable, typically shorter and narrower than living trees
+    dead: { heightMin: 0.65, heightMax: 0.95, widthMin: 0.6, widthMax: 0.9 },
+};
+// ===================
+// PLACEMENT DEFAULTS
+// ===================
+/**
+ * Default placement config - balanced between natural and composed.
+ */
+export const DEFAULT_PLACEMENT = {
+    minSpacing: 0.04,
+    crossLayerThreshold: 0.03,
+    jitter: 0.3,
+    heroStrength: 0.5,
+};
+// ===================
+// COLOR CONSTANTS
+// ===================
+/**
+ * Night silhouette color palette - pure darkness with subtle atmospheric fade.
+ * Most trees stay dark; only the very farthest get a subtle haze lift.
+ */
+export const FAR_SILHOUETTE = { r: 18, g: 22, b: 28 }; // Subtle distant haze
+export const NEAR_SILHOUETTE = { r: 0, g: 0, b: 0 }; // Pure black silhouette
+/** Rim light color - subtle moonlight edge glow */
+export const RIM_LIGHT = { r: 35, g: 45, b: 55 };
+// ===================
+// ECOLOGICAL PATTERNS
+// ===================
+/**
+ * Preset ecological patterns based on real-world forest biomes.
+ *
+ * VISUAL DISTINCTIVENESS GUIDE:
+ * - Conifers (pine/fir/spruce): Triangular, pointed tops
+ * - Oak/Maple: Wide, rounded crowns
+ * - Poplar: VERY tall and narrow (columnar) - most distinctive!
+ * - Willow: Wide, droopy branches
+ * - Dead: Sparse, skeletal
+ *
+ * Patterns are designed to create VISIBLE differences through shape variety.
+ */
+export const ECOLOGICAL_PATTERNS = [
+    {
+        id: "random",
+        name: "Random Mix",
+        description: "Uniform random distribution of all tree types",
+        zones: [
+            {
+                startX: 0,
+                endX: 1,
+                weights: {
+                    pine: 1,
+                    fir: 1,
+                    spruce: 1,
+                    oak: 1,
+                    maple: 1,
+                    poplar: 1,
+                    willow: 1,
+                    dead: 1,
+                },
+            },
+        ],
+    },
+    // === SINGLE-TYPE PATTERNS (for testing/dramatic effect) ===
+    {
+        id: "conifers-only",
+        name: "Conifer Forest",
+        description: "100% conifers - triangular silhouettes only",
+        zones: [
+            {
+                startX: 0,
+                endX: 1,
+                weights: { pine: 3, fir: 3, spruce: 3 },
+            },
+        ],
+    },
+    {
+        id: "deciduous-only",
+        name: "Deciduous Grove",
+        description: "100% broadleaf - wide rounded crowns",
+        zones: [
+            {
+                startX: 0,
+                endX: 1,
+                weights: { oak: 4, maple: 4, willow: 2 },
+            },
+        ],
+    },
+    {
+        id: "poplar-avenue",
+        name: "Poplar Avenue",
+        description: "Tall narrow poplars - dramatic columnar silhouettes",
+        zones: [
+            {
+                startX: 0,
+                endX: 1,
+                weights: { poplar: 10, dead: 1 },
+            },
+        ],
+    },
+    {
+        id: "willow-wetland",
+        name: "Willow Wetland",
+        description: "Drooping willows with scattered dead trees",
+        zones: [
+            {
+                startX: 0,
+                endX: 1,
+                weights: { willow: 10, dead: 2 },
+            },
+        ],
+    },
+    {
+        id: "haunted-forest",
+        name: "Haunted Forest",
+        description: "Mostly dead trees with sparse survivors",
+        zones: [
+            {
+                startX: 0,
+                endX: 1,
+                weights: { dead: 8, oak: 1, pine: 1 },
+            },
+        ],
+    },
+    // === MIXED PATTERNS (realistic biomes) ===
+    {
+        id: "conifer-ridge",
+        name: "Conifer Ridge",
+        description: "Triangular conifers on left, rounded deciduous on right",
+        zones: [
+            {
+                startX: 0,
+                endX: 0.4,
+                weights: { pine: 5, fir: 5, spruce: 5 },
+            },
+            {
+                startX: 0.4,
+                endX: 0.6,
+                weights: { pine: 2, oak: 3, maple: 3, dead: 1 },
+            },
+            {
+                startX: 0.6,
+                endX: 1,
+                weights: { oak: 5, maple: 4, willow: 2 },
+            },
+        ],
+    },
+    {
+        id: "riparian",
+        name: "Riparian Corridor",
+        description: "Tall poplars and droopy willows in center stream",
+        zones: [
+            {
+                startX: 0,
+                endX: 0.25,
+                weights: { oak: 5, maple: 4 },
+            },
+            {
+                startX: 0.25,
+                endX: 0.75,
+                weights: { willow: 6, poplar: 6, dead: 1 },
+            },
+            {
+                startX: 0.75,
+                endX: 1,
+                weights: { oak: 5, maple: 4 },
+            },
+        ],
+    },
+    {
+        id: "edge-habitat",
+        name: "Poplar Windbreak",
+        description: "Tall narrow poplars at edges, mixed forest center",
+        zones: [
+            {
+                startX: 0,
+                endX: 0.15,
+                weights: { poplar: 10 },
+            },
+            {
+                startX: 0.15,
+                endX: 0.85,
+                weights: { oak: 3, maple: 3, pine: 2, fir: 2, dead: 1 },
+            },
+            {
+                startX: 0.85,
+                endX: 1,
+                weights: { poplar: 10 },
+            },
+        ],
+    },
+    {
+        id: "alpine-transition",
+        name: "Alpine Treeline",
+        description: "Dense conifers thin to dead trees at treeline",
+        zones: [
+            {
+                startX: 0,
+                endX: 0.4,
+                weights: { pine: 4, fir: 4, spruce: 4 },
+            },
+            {
+                startX: 0.4,
+                endX: 0.7,
+                weights: { pine: 2, spruce: 2, dead: 3 },
+            },
+            {
+                startX: 0.7,
+                endX: 1,
+                weights: { dead: 10, pine: 1 },
+            },
+        ],
+    },
+];
+//# sourceMappingURL=tree-silhouette-constants.js.map

package/dist/backgrounds/firefly-forest/domain/constants/tree-silhouette-constants.js.map

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

package/dist/backgrounds/firefly-forest/domain/models/firefly-models.d.ts

@@ -0,0 +1,22 @@
+export interface Firefly {
+    x: number;
+    y: number;
+    size: number;
+    vx: number;
+    vy: number;
+    glowRadius: number;
+    glowIntensity: number;
+    blinkPhase: number;
+    blinkCycleLength: number;
+    color: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    wanderAngle: number;
+    wanderSpeed: number;
+    baseOpacity: number;
+    isSpecial: boolean;
+    depth: number;
+}
+//# sourceMappingURL=firefly-models.d.ts.map

package/dist/backgrounds/firefly-forest/domain/models/firefly-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firefly-models.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/domain/models/firefly-models.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/backgrounds/firefly-forest/domain/models/firefly-models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=firefly-models.js.map

package/dist/backgrounds/firefly-forest/domain/models/firefly-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firefly-models.js","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/domain/models/firefly-models.ts"],"names":[],"mappings":""}

package/dist/backgrounds/firefly-forest/domain/models/tree-silhouette-models.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Tree Silhouette System Models
+ *
+ * Type definitions for tree silhouette rendering system.
+ */
+export type TreeType = "pine" | "fir" | "spruce" | "oak" | "maple" | "poplar" | "willow" | "dead";
+export interface TreeTypeVisibility {
+    pine: boolean;
+    fir: boolean;
+    spruce: boolean;
+    oak: boolean;
+    maple: boolean;
+    poplar: boolean;
+    willow: boolean;
+    dead: boolean;
+}
+export interface RenderedTree {
+    id: string;
+    x: number;
+    height: number;
+    width: number;
+    type: TreeType;
+    layer: number;
+    seed: number;
+    imageFilename?: string;
+}
+/**
+ * Grid-based placement configuration.
+ * Each layer uses specific columns to avoid overlap within a layer.
+ * Layers use offset columns so trees naturally interleave.
+ */
+export interface LayerConfig {
+    columns: number[];
+    heightPresets: number[];
+    widthRange: [number, number];
+}
+/**
+ * Species-specific scale factors for realistic proportions.
+ * Based on natural growth characteristics of each tree type.
+ */
+export interface TreeTypeScale {
+    heightMin: number;
+    heightMax: number;
+    widthMin: number;
+    widthMax: number;
+}
+/**
+ * Configurable placement parameters.
+ * Exposed for Lab UI sliders.
+ */
+export interface PlacementConfig {
+    /** Minimum spacing for same-layer trees (0-0.15, higher = more spread out) */
+    minSpacing: number;
+    /** Cross-layer collision threshold (0-0.15, higher = more separation between layers) */
+    crossLayerThreshold: number;
+    /** Position jitter amount (0-0.5, higher = more random placement) */
+    jitter: number;
+    /** Hero anchor strength (0-1, 0 = disabled, 1 = always snap to thirds) */
+    heroStrength: number;
+}
+/**
+ * Internal placement constants derived from PlacementConfig.
+ */
+export interface PlacementConstants {
+    HERO_ANCHORS: number[];
+    MIN_SPACING: {
+        far: number;
+        mid: number;
+        near: number;
+    };
+    CROSS_LAYER_THRESHOLD: number;
+    NUDGE_STEP: number;
+    MAX_NUDGE: number;
+    EDGE_MARGIN: number;
+    HERO_HEIGHT_BOOST: number;
+    HERO_SNAP_DISTANCE: number;
+    JITTER: number;
+}
+/**
+ * A placed tree for collision detection.
+ */
+export interface PlacedTree {
+    x: number;
+    layer: number;
+}
+/**
+ * Ecological zone defines which tree types are weighted in a region of the canvas.
+ * x positions are normalized 0-1 across the canvas width.
+ */
+export interface EcologicalZone {
+    startX: number;
+    endX: number;
+    weights: Partial<Record<TreeType, number>>;
+}
+/**
+ * An ecological pattern defines how tree types are distributed across the scene.
+ */
+export interface EcologicalPattern {
+    id: string;
+    name: string;
+    description: string;
+    zones: EcologicalZone[];
+}
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Colors for rendering a tree at a given depth.
+ */
+export interface TreeColors {
+    silhouette: RGB;
+}
+//# sourceMappingURL=tree-silhouette-models.d.ts.map

package/dist/backgrounds/firefly-forest/domain/models/tree-silhouette-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-silhouette-models.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/domain/models/tree-silhouette-models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,KAAK,GACL,QAAQ,GACR,KAAK,GACL,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAMD,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,GAAG,CAAC;CACjB"}

package/dist/backgrounds/firefly-forest/domain/models/tree-silhouette-models.js

@@ -0,0 +1,7 @@
+/**
+ * Tree Silhouette System Models
+ *
+ * Type definitions for tree silhouette rendering system.
+ */
+export {};
+//# sourceMappingURL=tree-silhouette-models.js.map

package/dist/backgrounds/firefly-forest/domain/models/tree-silhouette-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-silhouette-models.js","sourceRoot":"","sources":["../../../../../src/backgrounds/firefly-forest/domain/models/tree-silhouette-models.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}