@autumnsgrove/groveengine 0.8.0 → 0.8.6

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

@@ -65,32 +65,67 @@ export declare const natural: {
     readonly birchWhite: "#f5f5f0";
 };
 /**
- * Spring colors - fresh growth and renewal
- * Bright yellow-greens of new leaves, soft pastels of early blooms.
- * Organized dark-to-light for depth layering (darker = far, brighter = near).
- * Spring feels lighter and more pastel than the saturated summer greens.
+ * 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 spring: {
+export declare const springFoliage: {
     readonly sprout: "#65a30d";
     readonly newLeaf: "#84cc16";
     readonly freshGreen: "#a3e635";
     readonly budding: "#bef264";
     readonly tender: "#d9f99d";
-    readonly clearSky: "#7dd3fc";
-    readonly softSky: "#bae6fd";
+};
+/**
+ * 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 lilac: "#c4b5fd";
+    readonly violet: "#8b5cf6";
+    readonly purple: "#a855f7";
+    readonly lavender: "#c4b5fd";
     readonly tulipPink: "#f9a8d4";
     readonly tulipRed: "#fb7185";
-    readonly hillDeep: "#166534";
-    readonly hillMid: "#22c55e";
-    readonly hillNear: "#86efac";
-    readonly hillFront: "#bbf7d0";
+    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 colors
+ * 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.
@@ -104,18 +139,6 @@ export declare const autumn: {
     readonly honey: "#facc15";
     readonly straw: "#fde047";
 };
-/**
- * Cherry blossom pinks (spring/summer)
- * Used for cherry trees during spring bloom.
- * In autumn, cherry trees switch to autumnReds to mimic real cherry leaf color change.
- */
-export declare const pinks: {
-    readonly deepPink: "#db2777";
-    readonly pink: "#ec4899";
-    readonly rose: "#f472b6";
-    readonly blush: "#f9a8d4";
-    readonly palePink: "#fbcfe8";
-};
 /**
  * Autumn reds for cherry/maple foliage
  * Cherry trees don't just lose pink - they turn red/crimson in fall.
@@ -153,7 +176,7 @@ export declare const winter: {
 };
 /**
  * Accent colors for specific components
- * Each category gets 1-2 unique colors that don't fit the main palettes.
+ * 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: {
@@ -165,11 +188,20 @@ export declare const accents: {
         readonly spots: "#fefefe";
         readonly gill: "#fde8e8";
     };
-    /** Wildflower accents - purple/violet break from green monotony */
+    /**
+     * @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: "#fbbf24";
+        readonly yellow: "#facc15";
         readonly white: "#fefefe";
         readonly lavender: "#c4b5fd";
     };
@@ -220,6 +252,19 @@ export declare const accents: {
         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';
 /**
@@ -228,7 +273,7 @@ export type Season = 'spring' | 'summer' | 'autumn' | 'winter';
  * 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 palette greens
+ * @example getSeasonalGreens('spring') // returns spring foliage mapped to greens structure
  * @example getSeasonalGreens('autumn') // returns autumn palette
  */
 export declare function getSeasonalGreens(season?: Season): {
@@ -264,28 +309,16 @@ export declare function getSeasonalGreens(season?: Season): {
     mint: "#4a6355";
     pale: "#4a6355";
 };
-/**
- * Spring cherry blossom colors - extra vibrant for peak bloom
- * Spring is when cherry blossoms are at their most beautiful.
- * Slightly brighter and more saturated than the standard pinks.
- */
-export declare const springBlossoms: {
-    readonly deepPink: "#ec4899";
-    readonly pink: "#f472b6";
-    readonly rose: "#f9a8d4";
-    readonly blush: "#fbcfe8";
-    readonly palePink: "#fce7f3";
-};
 /**
  * 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 springBlossoms (vibrant)
+ * @example getCherryColors('spring') // returns cherryBlossomsPeak (vibrant)
  * @example getCherryColors('autumn') // returns autumnReds palette
  */
-export declare function getCherryColors(season?: Season): typeof pinks | typeof autumnReds | typeof springBlossoms | null;
+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.
@@ -304,17 +337,50 @@ export declare function pickRandom<T extends Record<string, string>>(palette: T)
  */
 export declare function pickFrom<T extends Record<string, string>>(palette: T, keys: (keyof T)[]): string;
 /**
- * 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.
+ * @deprecated Use `cherryBlossoms` instead. Will be removed in v1.0.
+ * Alias for backward compatibility with components using 'pinks'.
  */
-export declare const midnightBloom: {
-    readonly deepPlum: "#581c87";
-    readonly purple: "#7c3aed";
-    readonly violet: "#8b5cf6";
-    readonly amber: "#f59e0b";
-    readonly warmCream: "#fef3c7";
-    readonly softGold: "#fcd34d";
+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: {
@@ -348,31 +414,41 @@ export declare const naturePalette: {
         readonly mushroom: "#d4c8be";
         readonly birchWhite: "#f5f5f0";
     };
-    readonly spring: {
+    readonly springFoliage: {
         readonly sprout: "#65a30d";
         readonly newLeaf: "#84cc16";
         readonly freshGreen: "#a3e635";
         readonly budding: "#bef264";
         readonly tender: "#d9f99d";
-        readonly clearSky: "#7dd3fc";
-        readonly softSky: "#bae6fd";
+    };
+    readonly springSky: {
+        readonly clear: "#7dd3fc";
+        readonly soft: "#bae6fd";
+    };
+    readonly wildflowers: {
         readonly buttercup: "#facc15";
         readonly daffodil: "#fde047";
         readonly crocus: "#a78bfa";
-        readonly lilac: "#c4b5fd";
+        readonly violet: "#8b5cf6";
+        readonly purple: "#a855f7";
+        readonly lavender: "#c4b5fd";
         readonly tulipPink: "#f9a8d4";
         readonly tulipRed: "#fb7185";
-        readonly hillDeep: "#166534";
-        readonly hillMid: "#22c55e";
-        readonly hillNear: "#86efac";
-        readonly hillFront: "#bbf7d0";
+        readonly white: "#fefefe";
     };
-    readonly springBlossoms: {
-        readonly deepPink: "#ec4899";
-        readonly pink: "#f472b6";
-        readonly rose: "#f9a8d4";
-        readonly blush: "#fbcfe8";
-        readonly palePink: "#fce7f3";
+    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";
@@ -383,13 +459,6 @@ export declare const naturePalette: {
         readonly honey: "#facc15";
         readonly straw: "#fde047";
     };
-    readonly pinks: {
-        readonly deepPink: "#db2777";
-        readonly pink: "#ec4899";
-        readonly rose: "#f472b6";
-        readonly blush: "#f9a8d4";
-        readonly palePink: "#fbcfe8";
-    };
     readonly autumnReds: {
         readonly crimson: "#be123c";
         readonly scarlet: "#e11d48";
@@ -424,11 +493,20 @@ export declare const naturePalette: {
             readonly spots: "#fefefe";
             readonly gill: "#fde8e8";
         };
-        /** Wildflower accents - purple/violet break from green monotony */
+        /**
+         * @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: "#fbbf24";
+            readonly yellow: "#facc15";
             readonly white: "#fefefe";
             readonly lavender: "#c4b5fd";
         };
@@ -487,5 +565,38 @@ export declare const naturePalette: {
         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;