@autumnsgrove/groveengine 0.7.0 → 0.8.5

package/dist/ui/components/nature/palette.d.ts

@@ -0,0 +1,602 @@
+/**
+ * Shared Nature Palette
+ *
+ * A unified color system for all forest/nature components.
+ * All components should import from here to maintain visual cohesion.
+ *
+ * Design Philosophy:
+ * - Colors are drawn from real forest environments (Pacific Northwest inspiration)
+ * - Organized by depth: darker = further away, lighter = closer (atmospheric perspective)
+ * - Seasonal variants allow trees to change with autumn toggle
+ * - Accents are intentionally limited to 1-2 unique colors per component type
+ */
+/**
+ * Green foliage colors - from dark forest depths to pale spring leaves
+ * Organized dark-to-light for depth layering in forest scenes.
+ * darkForest/deepGreen: background trees (atmospheric distance)
+ * grove/meadow: mid-ground trees (Grove brand green at grove)
+ * spring/mint/pale: foreground foliage, new growth
+ */
+export declare const greens: {
+    readonly darkForest: "#0d4a1c";
+    readonly deepGreen: "#166534";
+    readonly grove: "#16a34a";
+    readonly meadow: "#22c55e";
+    readonly spring: "#4ade80";
+    readonly mint: "#86efac";
+    readonly pale: "#bbf7d0";
+};
+/**
+ * Bark and wood tones
+ * Used for tree trunks, branches, fences, and structural elements.
+ * Warmer browns complement the green foliage.
+ */
+export declare const bark: {
+    readonly darkBark: "#3d2817";
+    readonly bark: "#5d4037";
+    readonly warmBark: "#6B4423";
+    readonly lightBark: "#8b6914";
+};
+/**
+ * Earth and soil tones
+ * Ground elements, rocks, paths. Neutral grays for stone
+ * to contrast with warm browns of wood.
+ */
+export declare const earth: {
+    readonly soil: "#3e2723";
+    readonly mud: "#5d4037";
+    readonly clay: "#8d6e63";
+    readonly sand: "#d7ccc8";
+    readonly stone: "#78716c";
+    readonly pebble: "#a8a29e";
+    readonly slate: "#57534e";
+};
+/**
+ * Cream and natural off-whites
+ * Special bark colors (aspen, birch) and neutral backgrounds.
+ * Birch has pure white bark with slight warmth.
+ * Aspen bark is cream/pale green undertone.
+ */
+export declare const natural: {
+    readonly cream: "#fef9ef";
+    readonly aspenBark: "#e8e4d9";
+    readonly bone: "#e8e4dc";
+    readonly mushroom: "#d4c8be";
+    readonly birchWhite: "#f5f5f0";
+};
+/**
+ * Spring foliage - fresh yellow-green growth
+ * The distinctive bright yellow-green of new spring leaves.
+ * Organized dark-to-light for depth layering.
+ */
+export declare const springFoliage: {
+    readonly sprout: "#65a30d";
+    readonly newLeaf: "#84cc16";
+    readonly freshGreen: "#a3e635";
+    readonly budding: "#bef264";
+    readonly tender: "#d9f99d";
+};
+/**
+ * Spring sky colors
+ * Clear, bright spring atmosphere.
+ */
+export declare const springSky: {
+    readonly clear: "#7dd3fc";
+    readonly soft: "#bae6fd";
+};
+/**
+ * Wildflowers - spring and general meadow flowers
+ * Unified wildflower palette for all seasons.
+ * Used for spring wildflowers and general meadow accents.
+ */
+export declare const wildflowers: {
+    readonly buttercup: "#facc15";
+    readonly daffodil: "#fde047";
+    readonly crocus: "#a78bfa";
+    readonly violet: "#8b5cf6";
+    readonly purple: "#a855f7";
+    readonly lavender: "#c4b5fd";
+    readonly tulipPink: "#f9a8d4";
+    readonly tulipRed: "#fb7185";
+    readonly white: "#fefefe";
+};
+/**
+ * Cherry blossoms - standard summer/default
+ * Used for cherry trees during summer.
+ * Pink blooms from dense to pale.
+ */
+export declare const cherryBlossoms: {
+    readonly deep: "#db2777";
+    readonly standard: "#ec4899";
+    readonly light: "#f472b6";
+    readonly pale: "#f9a8d4";
+    readonly falling: "#fbcfe8";
+};
+/**
+ * Cherry blossoms peak bloom - vibrant spring version
+ * Extra saturated for spring when cherry blossoms are at their most beautiful.
+ * One shade brighter than standard cherryBlossoms.
+ */
+export declare const cherryBlossomsPeak: {
+    readonly deep: "#ec4899";
+    readonly standard: "#f472b6";
+    readonly light: "#f9a8d4";
+    readonly pale: "#fbcfe8";
+    readonly falling: "#fce7f3";
+};
+/**
+ * Autumn/Fall foliage colors
+ * Replaces greens for deciduous trees during autumn season.
+ * Organized warm-to-bright for depth layering (dark rust = far, bright gold = near).
+ * Aspen and birch use gold/honey for their signature golden fall color.
+ */
+export declare const autumn: {
+    readonly rust: "#9a3412";
+    readonly ember: "#c2410c";
+    readonly pumpkin: "#ea580c";
+    readonly amber: "#d97706";
+    readonly gold: "#eab308";
+    readonly honey: "#facc15";
+    readonly straw: "#fde047";
+};
+/**
+ * Autumn reds for cherry/maple foliage
+ * Cherry trees don't just lose pink - they turn red/crimson in fall.
+ * Also used for Japanese maple trees and other red autumn foliage.
+ */
+export declare const autumnReds: {
+    readonly crimson: "#be123c";
+    readonly scarlet: "#e11d48";
+    readonly rose: "#f43f5e";
+    readonly coral: "#fb7185";
+};
+/**
+ * Winter colors - frost, snow, and ice
+ * Used for winter mode: snow-dusted evergreens, frozen landscape.
+ * Deciduous trees go bare, showing only branches.
+ */
+export declare const winter: {
+    readonly snow: "#f8fafc";
+    readonly frost: "#e2e8f0";
+    readonly ice: "#cbd5e1";
+    readonly glacier: "#94a3b8";
+    readonly frostedPine: "#2d4a3e";
+    readonly winterGreen: "#3d5a4a";
+    readonly coldSpruce: "#4a6355";
+    readonly winterSky: "#e0f2fe";
+    readonly twilight: "#bfdbfe";
+    readonly overcast: "#cbd5e1";
+    readonly bareBranch: "#78716c";
+    readonly frostedBark: "#a8a29e";
+    readonly coldWood: "#57534e";
+    readonly hillDeep: "#475569";
+    readonly hillMid: "#7c8ca3";
+    readonly hillNear: "#c7d2e0";
+    readonly hillFront: "#f1f5f9";
+};
+/**
+ * Accent colors for specific components
+ * Each category gets unique colors that don't fit the main palettes.
+ * These add visual interest without breaking the natural cohesion.
+ */
+export declare const accents: {
+    /** Mushroom caps and details - fairy tale forest pops of color */
+    readonly mushroom: {
+        readonly redCap: "#dc2626";
+        readonly orangeCap: "#ea580c";
+        readonly brownCap: "#78350f";
+        readonly spots: "#fefefe";
+        readonly gill: "#fde8e8";
+    };
+    /**
+     * @deprecated Use the top-level `wildflowers` export instead. Will be removed in v1.0.
+     *
+     * Historical context: Flower colors were originally split between two places:
+     * - `spring` palette had wildflower accents (crocus, lilac, tulips, buttercup, daffodil)
+     * - `accents.flower` had generic flower colors (purple, violet, yellow, white, lavender)
+     *
+     * This caused confusion and duplicate values. Now unified in the top-level `wildflowers`
+     * palette which contains all meadow flower colors in one place.
+     */
+    readonly flower: {
+        readonly purple: "#a855f7";
+        readonly violet: "#8b5cf6";
+        readonly yellow: "#facc15";
+        readonly white: "#fefefe";
+        readonly lavender: "#c4b5fd";
+    };
+    /** Firefly bioluminescence - warm yellow-green glow */
+    readonly firefly: {
+        readonly glow: "#fef08a";
+        readonly warmGlow: "#fde047";
+        readonly body: "#365314";
+    };
+    /** Berry colors - rich and saturated */
+    readonly berry: {
+        readonly ripe: "#7c2d12";
+        readonly elderberry: "#581c87";
+        readonly red: "#b91c1c";
+    };
+    /** Water and pond colors - cool blue spectrum */
+    readonly water: {
+        readonly surface: "#7dd3fc";
+        readonly deep: "#0284c7";
+        readonly shallow: "#bae6fd";
+        readonly lily: "#bbf7d0";
+    };
+    /** Sky elements - time of day variations */
+    readonly sky: {
+        readonly dayLight: "#e0f2fe";
+        readonly dayMid: "#7dd3fc";
+        readonly sunset: "#fed7aa";
+        readonly night: "#1e293b";
+        readonly star: "#fefce8";
+    };
+    /** Bird colors - winter, spring, and year-round species */
+    readonly bird: {
+        readonly cardinalRed: "#dc2626";
+        readonly cardinalMask: "#1a1a1a";
+        readonly cardinalBeak: "#f97316";
+        readonly chickadeeCap: "#1a1a1a";
+        readonly chickadeeCheek: "#fafafa";
+        readonly chickadeeBody: "#6b7280";
+        readonly chickadeeBelly: "#fef3c7";
+        readonly robinBody: "#4a4a4a";
+        readonly robinWing: "#3a3a3a";
+        readonly robinWingDark: "#2a2a2a";
+        readonly robinBreast: "#c2410c";
+        readonly robinBreastLight: "#dc5015";
+        readonly robinBeak: "#f59e0b";
+        readonly bluebirdBody: "#3b82f6";
+        readonly bluebirdWing: "#2563eb";
+        readonly bluebirdBreast: "#ea580c";
+    };
+};
+/**
+ * Midnight Bloom - the far vision
+ * A late-night tea café palette: deep plums, warm amber, soft golds.
+ * Used for the Midnight Bloom section of the roadmap and future theming.
+ */
+export declare const midnightBloom: {
+    readonly deepPlum: "#581c87";
+    readonly purple: "#7c3aed";
+    readonly violet: "#8b5cf6";
+    readonly amber: "#f59e0b";
+    readonly warmCream: "#fef3c7";
+    readonly softGold: "#fcd34d";
+};
+/** Supported seasons for seasonal color switching */
+export type Season = 'spring' | 'summer' | 'autumn' | 'winter';
+/**
+ * Get appropriate foliage colors based on season
+ * Used by deciduous trees to switch from greens to seasonal palette.
+ * Spring uses bright yellow-greens of new growth.
+ * Autumn uses warm oranges and golds.
+ * In winter, returns frosted evergreen colors (for pines that keep needles).
+ * @example getSeasonalGreens('spring') // returns spring foliage mapped to greens structure
+ * @example getSeasonalGreens('autumn') // returns autumn palette
+ */
+export declare function getSeasonalGreens(season?: Season): {
+    readonly darkForest: "#0d4a1c";
+    readonly deepGreen: "#166534";
+    readonly grove: "#16a34a";
+    readonly meadow: "#22c55e";
+    readonly spring: "#4ade80";
+    readonly mint: "#86efac";
+    readonly pale: "#bbf7d0";
+} | {
+    readonly rust: "#9a3412";
+    readonly ember: "#c2410c";
+    readonly pumpkin: "#ea580c";
+    readonly amber: "#d97706";
+    readonly gold: "#eab308";
+    readonly honey: "#facc15";
+    readonly straw: "#fde047";
+} | {
+    darkForest: "#65a30d";
+    deepGreen: "#65a30d";
+    grove: "#84cc16";
+    meadow: "#a3e635";
+    spring: "#bef264";
+    mint: "#bef264";
+    pale: "#d9f99d";
+} | {
+    darkForest: "#2d4a3e";
+    deepGreen: "#2d4a3e";
+    grove: "#3d5a4a";
+    meadow: "#3d5a4a";
+    spring: "#4a6355";
+    mint: "#4a6355";
+    pale: "#4a6355";
+};
+/**
+ * Get cherry tree colors based on season
+ * Spring: Extra vibrant pink blossoms (peak bloom!)
+ * Summer: Standard pink blossoms
+ * Autumn: Turn red/crimson like real cherry leaves
+ * Winter: Bare (no blossoms)
+ * @example getCherryColors('spring') // returns cherryBlossomsPeak (vibrant)
+ * @example getCherryColors('autumn') // returns autumnReds palette
+ */
+export declare function getCherryColors(season?: Season): typeof cherryBlossoms | typeof autumnReds | typeof cherryBlossomsPeak | null;
+/**
+ * Check if a tree should be bare (no foliage) based on season
+ * Deciduous trees lose leaves in winter.
+ */
+export declare function isTreeBare(treeType: string, season: Season): boolean;
+/**
+ * Pick a random color from a palette object
+ * Useful for adding natural variation to forests.
+ * @example pickRandom(greens) // returns random green like '#16a34a'
+ */
+export declare function pickRandom<T extends Record<string, string>>(palette: T): string;
+/**
+ * Pick a random color from a subset of palette keys
+ * More controlled randomization when you want specific options.
+ * @example pickFrom(greens, ['grove', 'meadow']) // only picks from those two
+ */
+export declare function pickFrom<T extends Record<string, string>>(palette: T, keys: (keyof T)[]): string;
+/**
+ * @deprecated Use `cherryBlossoms` instead. Will be removed in v1.0.
+ * Alias for backward compatibility with components using 'pinks'.
+ */
+export declare const pinks: {
+    readonly deepPink: "#db2777";
+    readonly pink: "#ec4899";
+    readonly rose: "#f472b6";
+    readonly blush: "#f9a8d4";
+    readonly palePink: "#fbcfe8";
+};
+/**
+ * @deprecated Use `cherryBlossomsPeak` instead. Will be removed in v1.0.
+ * Alias for backward compatibility with components using 'springBlossoms'.
+ */
+export declare const springBlossoms: {
+    readonly deepPink: "#ec4899";
+    readonly pink: "#f472b6";
+    readonly rose: "#f9a8d4";
+    readonly blush: "#fbcfe8";
+    readonly palePink: "#fce7f3";
+};
+/**
+ * @deprecated Use `springFoliage`, `wildflowers`, `springSky` instead. Will be removed in v1.0.
+ * Combined spring palette for backward compatibility.
+ * New code should import the specific palettes directly.
+ */
+export declare const spring: {
+    readonly sprout: "#65a30d";
+    readonly newLeaf: "#84cc16";
+    readonly freshGreen: "#a3e635";
+    readonly budding: "#bef264";
+    readonly tender: "#d9f99d";
+    readonly clearSky: "#7dd3fc";
+    readonly softSky: "#bae6fd";
+    readonly buttercup: "#facc15";
+    readonly daffodil: "#fde047";
+    readonly crocus: "#a78bfa";
+    readonly lilac: "#c4b5fd";
+    readonly tulipPink: "#f9a8d4";
+    readonly tulipRed: "#fb7185";
+    readonly hillDeep: "#166534";
+    readonly hillMid: "#22c55e";
+    readonly hillNear: "#86efac";
+    readonly hillFront: "#bbf7d0";
+};
+export declare const naturePalette: {
+    readonly greens: {
+        readonly darkForest: "#0d4a1c";
+        readonly deepGreen: "#166534";
+        readonly grove: "#16a34a";
+        readonly meadow: "#22c55e";
+        readonly spring: "#4ade80";
+        readonly mint: "#86efac";
+        readonly pale: "#bbf7d0";
+    };
+    readonly bark: {
+        readonly darkBark: "#3d2817";
+        readonly bark: "#5d4037";
+        readonly warmBark: "#6B4423";
+        readonly lightBark: "#8b6914";
+    };
+    readonly earth: {
+        readonly soil: "#3e2723";
+        readonly mud: "#5d4037";
+        readonly clay: "#8d6e63";
+        readonly sand: "#d7ccc8";
+        readonly stone: "#78716c";
+        readonly pebble: "#a8a29e";
+        readonly slate: "#57534e";
+    };
+    readonly natural: {
+        readonly cream: "#fef9ef";
+        readonly aspenBark: "#e8e4d9";
+        readonly bone: "#e8e4dc";
+        readonly mushroom: "#d4c8be";
+        readonly birchWhite: "#f5f5f0";
+    };
+    readonly springFoliage: {
+        readonly sprout: "#65a30d";
+        readonly newLeaf: "#84cc16";
+        readonly freshGreen: "#a3e635";
+        readonly budding: "#bef264";
+        readonly tender: "#d9f99d";
+    };
+    readonly springSky: {
+        readonly clear: "#7dd3fc";
+        readonly soft: "#bae6fd";
+    };
+    readonly wildflowers: {
+        readonly buttercup: "#facc15";
+        readonly daffodil: "#fde047";
+        readonly crocus: "#a78bfa";
+        readonly violet: "#8b5cf6";
+        readonly purple: "#a855f7";
+        readonly lavender: "#c4b5fd";
+        readonly tulipPink: "#f9a8d4";
+        readonly tulipRed: "#fb7185";
+        readonly white: "#fefefe";
+    };
+    readonly cherryBlossoms: {
+        readonly deep: "#db2777";
+        readonly standard: "#ec4899";
+        readonly light: "#f472b6";
+        readonly pale: "#f9a8d4";
+        readonly falling: "#fbcfe8";
+    };
+    readonly cherryBlossomsPeak: {
+        readonly deep: "#ec4899";
+        readonly standard: "#f472b6";
+        readonly light: "#f9a8d4";
+        readonly pale: "#fbcfe8";
+        readonly falling: "#fce7f3";
+    };
+    readonly autumn: {
+        readonly rust: "#9a3412";
+        readonly ember: "#c2410c";
+        readonly pumpkin: "#ea580c";
+        readonly amber: "#d97706";
+        readonly gold: "#eab308";
+        readonly honey: "#facc15";
+        readonly straw: "#fde047";
+    };
+    readonly autumnReds: {
+        readonly crimson: "#be123c";
+        readonly scarlet: "#e11d48";
+        readonly rose: "#f43f5e";
+        readonly coral: "#fb7185";
+    };
+    readonly winter: {
+        readonly snow: "#f8fafc";
+        readonly frost: "#e2e8f0";
+        readonly ice: "#cbd5e1";
+        readonly glacier: "#94a3b8";
+        readonly frostedPine: "#2d4a3e";
+        readonly winterGreen: "#3d5a4a";
+        readonly coldSpruce: "#4a6355";
+        readonly winterSky: "#e0f2fe";
+        readonly twilight: "#bfdbfe";
+        readonly overcast: "#cbd5e1";
+        readonly bareBranch: "#78716c";
+        readonly frostedBark: "#a8a29e";
+        readonly coldWood: "#57534e";
+        readonly hillDeep: "#475569";
+        readonly hillMid: "#7c8ca3";
+        readonly hillNear: "#c7d2e0";
+        readonly hillFront: "#f1f5f9";
+    };
+    readonly accents: {
+        /** Mushroom caps and details - fairy tale forest pops of color */
+        readonly mushroom: {
+            readonly redCap: "#dc2626";
+            readonly orangeCap: "#ea580c";
+            readonly brownCap: "#78350f";
+            readonly spots: "#fefefe";
+            readonly gill: "#fde8e8";
+        };
+        /**
+         * @deprecated Use the top-level `wildflowers` export instead. Will be removed in v1.0.
+         *
+         * Historical context: Flower colors were originally split between two places:
+         * - `spring` palette had wildflower accents (crocus, lilac, tulips, buttercup, daffodil)
+         * - `accents.flower` had generic flower colors (purple, violet, yellow, white, lavender)
+         *
+         * This caused confusion and duplicate values. Now unified in the top-level `wildflowers`
+         * palette which contains all meadow flower colors in one place.
+         */
+        readonly flower: {
+            readonly purple: "#a855f7";
+            readonly violet: "#8b5cf6";
+            readonly yellow: "#facc15";
+            readonly white: "#fefefe";
+            readonly lavender: "#c4b5fd";
+        };
+        /** Firefly bioluminescence - warm yellow-green glow */
+        readonly firefly: {
+            readonly glow: "#fef08a";
+            readonly warmGlow: "#fde047";
+            readonly body: "#365314";
+        };
+        /** Berry colors - rich and saturated */
+        readonly berry: {
+            readonly ripe: "#7c2d12";
+            readonly elderberry: "#581c87";
+            readonly red: "#b91c1c";
+        };
+        /** Water and pond colors - cool blue spectrum */
+        readonly water: {
+            readonly surface: "#7dd3fc";
+            readonly deep: "#0284c7";
+            readonly shallow: "#bae6fd";
+            readonly lily: "#bbf7d0";
+        };
+        /** Sky elements - time of day variations */
+        readonly sky: {
+            readonly dayLight: "#e0f2fe";
+            readonly dayMid: "#7dd3fc";
+            readonly sunset: "#fed7aa";
+            readonly night: "#1e293b";
+            readonly star: "#fefce8";
+        };
+        /** Bird colors - winter, spring, and year-round species */
+        readonly bird: {
+            readonly cardinalRed: "#dc2626";
+            readonly cardinalMask: "#1a1a1a";
+            readonly cardinalBeak: "#f97316";
+            readonly chickadeeCap: "#1a1a1a";
+            readonly chickadeeCheek: "#fafafa";
+            readonly chickadeeBody: "#6b7280";
+            readonly chickadeeBelly: "#fef3c7";
+            readonly robinBody: "#4a4a4a";
+            readonly robinWing: "#3a3a3a";
+            readonly robinWingDark: "#2a2a2a";
+            readonly robinBreast: "#c2410c";
+            readonly robinBreastLight: "#dc5015";
+            readonly robinBeak: "#f59e0b";
+            readonly bluebirdBody: "#3b82f6";
+            readonly bluebirdWing: "#2563eb";
+            readonly bluebirdBreast: "#ea580c";
+        };
+    };
+    readonly midnightBloom: {
+        readonly deepPlum: "#581c87";
+        readonly purple: "#7c3aed";
+        readonly violet: "#8b5cf6";
+        readonly amber: "#f59e0b";
+        readonly warmCream: "#fef3c7";
+        readonly softGold: "#fcd34d";
+    };
+    readonly spring: {
+        readonly sprout: "#65a30d";
+        readonly newLeaf: "#84cc16";
+        readonly freshGreen: "#a3e635";
+        readonly budding: "#bef264";
+        readonly tender: "#d9f99d";
+        readonly clearSky: "#7dd3fc";
+        readonly softSky: "#bae6fd";
+        readonly buttercup: "#facc15";
+        readonly daffodil: "#fde047";
+        readonly crocus: "#a78bfa";
+        readonly lilac: "#c4b5fd";
+        readonly tulipPink: "#f9a8d4";
+        readonly tulipRed: "#fb7185";
+        readonly hillDeep: "#166534";
+        readonly hillMid: "#22c55e";
+        readonly hillNear: "#86efac";
+        readonly hillFront: "#bbf7d0";
+    };
+    readonly pinks: {
+        readonly deepPink: "#db2777";
+        readonly pink: "#ec4899";
+        readonly rose: "#f472b6";
+        readonly blush: "#f9a8d4";
+        readonly palePink: "#fbcfe8";
+    };
+    readonly springBlossoms: {
+        readonly deepPink: "#ec4899";
+        readonly pink: "#f472b6";
+        readonly rose: "#f9a8d4";
+        readonly blush: "#fbcfe8";
+        readonly palePink: "#fce7f3";
+    };
+};
+export default naturePalette;