@autumnsgrove/groveengine 0.6.5 → 0.8.0

package/dist/ui/components/nature/palette.js

@@ -0,0 +1,384 @@
+/**
+ * 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
+ */
+// =============================================================================
+// CORE PALETTES
+// =============================================================================
+/**
+ * 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 const greens = {
+    darkForest: '#0d4a1c',
+    deepGreen: '#166534',
+    grove: '#16a34a', // Grove brand primary green
+    meadow: '#22c55e',
+    spring: '#4ade80',
+    mint: '#86efac',
+    pale: '#bbf7d0'
+};
+/**
+ * Bark and wood tones
+ * Used for tree trunks, branches, fences, and structural elements.
+ * Warmer browns complement the green foliage.
+ */
+export const bark = {
+    darkBark: '#3d2817', // Oak, older trees
+    bark: '#5d4037', // Standard trunk color
+    warmBark: '#6B4423', // Pine, cedar tones
+    lightBark: '#8b6914' // Young trees, sun-exposed wood
+};
+/**
+ * Earth and soil tones
+ * Ground elements, rocks, paths. Neutral grays for stone
+ * to contrast with warm browns of wood.
+ */
+export const earth = {
+    soil: '#3e2723', // Rich forest floor
+    mud: '#5d4037', // Wet earth
+    clay: '#8d6e63', // Exposed clay
+    sand: '#d7ccc8', // Paths, dry ground
+    stone: '#78716c', // Neutral gray rocks
+    pebble: '#a8a29e', // Lighter stones
+    slate: '#57534e' // Dark stone accents
+};
+/**
+ * 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 const natural = {
+    cream: '#fef9ef', // Warm white, backgrounds
+    aspenBark: '#e8e4d9', // Aspen tree distinctive pale bark
+    bone: '#e8e4dc', // Weathered wood, antlers
+    mushroom: '#d4c8be', // Mushroom stems, pale fungi
+    birchWhite: '#f5f5f0' // Birch tree distinctive white bark
+};
+// =============================================================================
+// SEASONAL PALETTES
+// =============================================================================
+/**
+ * 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.
+ */
+export const spring = {
+    // Fresh growth greens (yellow-green tint of new leaves)
+    sprout: '#65a30d', // Dark spring green - distant new growth
+    newLeaf: '#84cc16', // Classic spring lime - mid-ground
+    freshGreen: '#a3e635', // Bright yellow-green - foreground
+    budding: '#bef264', // Pale new leaf
+    tender: '#d9f99d', // Very pale spring green
+    // Sky and atmosphere
+    clearSky: '#7dd3fc', // Clear spring morning sky
+    softSky: '#bae6fd', // Pale spring sky
+    // Wildflower accents
+    buttercup: '#facc15', // Bright yellow wildflower
+    daffodil: '#fde047', // Pale yellow daffodil
+    crocus: '#a78bfa', // Early spring crocus purple
+    lilac: '#c4b5fd', // Soft lilac blooms
+    tulipPink: '#f9a8d4', // Soft tulip pink
+    tulipRed: '#fb7185', // Bright tulip red
+    // Hills and ground
+    hillDeep: '#166534', // Far spring hills - rich green
+    hillMid: '#22c55e', // Mid hills - meadow green
+    hillNear: '#86efac', // Near hills - fresh mint
+    hillFront: '#bbf7d0' // Front hills - pale spring green
+};
+/**
+ * Autumn/Fall 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 const autumn = {
+    rust: '#9a3412', // Deep background foliage
+    ember: '#c2410c', // Oak-like autumn
+    pumpkin: '#ea580c', // Maple mid-tones
+    amber: '#d97706', // Classic fall amber
+    gold: '#eab308', // Aspen/birch golden yellow
+    honey: '#facc15', // Bright foreground leaves
+    straw: '#fde047' // Pale dying leaves
+};
+/**
+ * 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 const pinks = {
+    deepPink: '#db2777', // Dense bloom centers
+    pink: '#ec4899', // Standard blossom
+    rose: '#f472b6', // Light petals
+    blush: '#f9a8d4', // Pale blossoms
+    palePink: '#fbcfe8' // Falling petals, distant blooms
+};
+/**
+ * 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 const autumnReds = {
+    crimson: '#be123c', // Deep maple red
+    scarlet: '#e11d48', // Bright cherry leaves
+    rose: '#f43f5e', // Light autumn cherry
+    coral: '#fb7185' // Pale autumn accent
+};
+// =============================================================================
+// WINTER PALETTE
+// =============================================================================
+/**
+ * Winter colors - frost, snow, and ice
+ * Used for winter mode: snow-dusted evergreens, frozen landscape.
+ * Deciduous trees go bare, showing only branches.
+ */
+export const winter = {
+    // Snow and ice
+    snow: '#f8fafc', // Pure fresh snow
+    frost: '#e2e8f0', // Frosted surfaces
+    ice: '#cbd5e1', // Ice blue-gray
+    glacier: '#94a3b8', // Deep ice shadows
+    // Frosted evergreen greens (muted, cool tones)
+    frostedPine: '#2d4a3e', // Snow-dusted dark pine
+    winterGreen: '#3d5a4a', // Muted forest green
+    coldSpruce: '#4a6355', // Cool spruce color
+    // Winter sky
+    winterSky: '#e0f2fe', // Pale winter sky
+    twilight: '#bfdbfe', // Evening winter sky
+    overcast: '#cbd5e1', // Gray overcast
+    // Bare branch colors
+    bareBranch: '#78716c', // Gray-brown bare wood
+    frostedBark: '#a8a29e', // Frost-touched bark
+    coldWood: '#57534e', // Dark winter wood
+    // Winter hills (snowy ground, back to front)
+    hillDeep: '#475569', // Far hills - cool slate
+    hillMid: '#7c8ca3', // Mid hills - gray-blue
+    hillNear: '#c7d2e0', // Near hills - pale snow
+    hillFront: '#f1f5f9' // Front hills - fresh snow
+};
+// =============================================================================
+// COMPONENT-SPECIFIC ACCENTS
+// =============================================================================
+/**
+ * Accent colors for specific components
+ * Each category gets 1-2 unique colors that don't fit the main palettes.
+ * These add visual interest without breaking the natural cohesion.
+ */
+export const accents = {
+    /** Mushroom caps and details - fairy tale forest pops of color */
+    mushroom: {
+        redCap: '#dc2626', // Amanita-style red (toxic but iconic)
+        orangeCap: '#ea580c', // Chanterelle-inspired
+        brownCap: '#78350f', // Porcini/common mushroom
+        spots: '#fefefe', // White spots on caps
+        gill: '#fde8e8' // Pale pink gills underneath
+    },
+    /** Wildflower accents - purple/violet break from green monotony */
+    flower: {
+        purple: '#a855f7', // Lupine, thistle
+        violet: '#8b5cf6', // Wild violets
+        yellow: '#fbbf24', // Buttercup, dandelion
+        white: '#fefefe', // Daisies, trillium
+        lavender: '#c4b5fd' // Distant flower masses
+    },
+    /** Firefly bioluminescence - warm yellow-green glow */
+    firefly: {
+        glow: '#fef08a', // Primary glow (pale yellow)
+        warmGlow: '#fde047', // Brighter intensity
+        body: '#365314' // Dark green body
+    },
+    /** Berry colors - rich and saturated */
+    berry: {
+        ripe: '#7c2d12', // Blackberry/dark berry
+        elderberry: '#581c87', // Deep purple elderberry
+        red: '#b91c1c' // Holly berries, winterberry
+    },
+    /** Water and pond colors - cool blue spectrum */
+    water: {
+        surface: '#7dd3fc', // Reflecting sky
+        deep: '#0284c7', // Deeper water
+        shallow: '#bae6fd', // Shallow edges
+        lily: '#bbf7d0' // Lily pad green (ties to greens)
+    },
+    /** Sky elements - time of day variations */
+    sky: {
+        dayLight: '#e0f2fe', // Pale daytime sky
+        dayMid: '#7dd3fc', // Blue sky
+        sunset: '#fed7aa', // Golden hour
+        night: '#1e293b', // Night sky
+        star: '#fefce8' // Star/twinkle color
+    },
+    /** Bird colors - winter, spring, and year-round species */
+    bird: {
+        // Cardinal (winter)
+        cardinalRed: '#dc2626', // Northern Cardinal vivid red
+        cardinalMask: '#1a1a1a', // Cardinal black mask
+        cardinalBeak: '#f97316', // Orange-red cone beak
+        // Chickadee (year-round)
+        chickadeeCap: '#1a1a1a', // Black-capped Chickadee cap/bib
+        chickadeeCheek: '#fafafa', // White cheek patch
+        chickadeeBody: '#6b7280', // Gray back feathers
+        chickadeeBelly: '#fef3c7', // Buff/cream underside
+        // Robin (spring herald!)
+        robinBody: '#4a4a4a', // American Robin dark gray-brown
+        robinWing: '#3a3a3a', // Slightly darker wing
+        robinWingDark: '#2a2a2a', // Wing shadow detail
+        robinBreast: '#c2410c', // American Robin orange-red breast
+        robinBreastLight: '#dc5015', // Breast highlight
+        robinBeak: '#f59e0b', // Yellow-orange beak
+        // Bluebird (spring/summer)
+        bluebirdBody: '#3b82f6', // Eastern Bluebird vivid blue
+        bluebirdWing: '#2563eb', // Slightly darker blue wings
+        bluebirdBreast: '#ea580c' // Rusty orange breast
+    }
+};
+/**
+ * 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 palette greens
+ * @example getSeasonalGreens('autumn') // returns autumn palette
+ */
+export function getSeasonalGreens(season = 'summer') {
+    if (season === 'spring') {
+        // Fresh yellow-green spring foliage - mapped to match greens structure
+        return {
+            darkForest: spring.sprout,
+            deepGreen: spring.sprout,
+            grove: spring.newLeaf,
+            meadow: spring.freshGreen,
+            spring: spring.budding,
+            mint: spring.budding,
+            pale: spring.tender
+        };
+    }
+    if (season === 'autumn') {
+        return autumn;
+    }
+    if (season === 'winter') {
+        // Frosted evergreen colors for pines/conifers
+        return {
+            darkForest: winter.frostedPine,
+            deepGreen: winter.frostedPine,
+            grove: winter.winterGreen,
+            meadow: winter.winterGreen,
+            spring: winter.coldSpruce,
+            mint: winter.coldSpruce,
+            pale: winter.coldSpruce
+        };
+    }
+    return greens;
+}
+/**
+ * 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 const springBlossoms = {
+    deepPink: '#ec4899', // Vibrant deep pink
+    pink: '#f472b6', // Bright cherry blossom
+    rose: '#f9a8d4', // Soft rose petals
+    blush: '#fbcfe8', // Pale blush
+    palePink: '#fce7f3' // Very pale falling petals
+};
+/**
+ * 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('autumn') // returns autumnReds palette
+ */
+export function getCherryColors(season = 'spring') {
+    if (season === 'spring') {
+        // Peak bloom - extra vibrant pinks!
+        return springBlossoms;
+    }
+    if (season === 'autumn') {
+        return autumnReds;
+    }
+    if (season === 'winter') {
+        // Return null to indicate bare tree (no foliage to render)
+        return null;
+    }
+    return pinks;
+}
+/**
+ * Check if a tree should be bare (no foliage) based on season
+ * Deciduous trees lose leaves in winter.
+ */
+export function isTreeBare(treeType, season) {
+    if (season !== 'winter')
+        return false;
+    // Evergreen types keep their needles
+    const evergreens = ['pine', 'spruce', 'fir', 'cedar'];
+    return !evergreens.includes(treeType.toLowerCase());
+}
+/**
+ * Pick a random color from a palette object
+ * Useful for adding natural variation to forests.
+ * @example pickRandom(greens) // returns random green like '#16a34a'
+ */
+export function pickRandom(palette) {
+    const values = Object.values(palette);
+    return values[Math.floor(Math.random() * values.length)];
+}
+/**
+ * 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 function pickFrom(palette, keys) {
+    const key = keys[Math.floor(Math.random() * keys.length)];
+    return palette[key];
+}
+// =============================================================================
+// MIDNIGHT BLOOM PALETTE
+// =============================================================================
+/**
+ * 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 const midnightBloom = {
+    deepPlum: '#581c87', // Night sky depth
+    purple: '#7c3aed', // Soft purple glow
+    violet: '#8b5cf6', // Lighter accent
+    amber: '#f59e0b', // Lantern warmth
+    warmCream: '#fef3c7', // Tea steam, page glow
+    softGold: '#fcd34d' // Fairy lights
+};
+// =============================================================================
+// FULL PALETTE EXPORT
+// =============================================================================
+export const naturePalette = {
+    greens,
+    bark,
+    earth,
+    natural,
+    spring,
+    springBlossoms,
+    autumn,
+    pinks,
+    autumnReds,
+    winter,
+    accents,
+    midnightBloom
+};
+export default naturePalette;

package/dist/ui/components/nature/sky/Cloud.svelte

@@ -0,0 +1,122 @@
+<!--
+  Grove — A place to Be
+  Copyright (c) 2025 Autumn Brown
+  Licensed under AGPL-3.0
+-->
+<script lang="ts">
+	interface Props {
+		class?: string;
+		color?: string;
+		animate?: boolean;
+		speed?: 'slow' | 'normal' | 'fast';
+		variant?: 'fluffy' | 'wispy' | 'puffy' | 'scattered';
+		direction?: 'left' | 'right';
+	}
+
+	let {
+		class: className = 'w-16 h-8',
+		color = 'white',
+		animate = true,
+		speed = 'normal',
+		variant = 'fluffy',
+		direction = 'right'
+	}: Props = $props();
+
+	const duration = $derived(
+		{
+			slow: '120s',
+			normal: '80s',
+			fast: '50s'
+		}[speed]
+	);
+
+	const animClass = $derived(animate ? `drift-${direction}` : '');
+</script>
+
+{#if variant === 'fluffy'}
+	<!-- Classic fluffy cumulus cloud -->
+	<svg
+		class="{className} {animClass}"
+		xmlns="http://www.w3.org/2000/svg"
+		viewBox="0 0 100 50"
+		style="--drift-duration: {duration}"
+	>
+		<g opacity="0.9">
+			<ellipse fill={color} cx="50" cy="35" rx="35" ry="15" />
+			<ellipse fill={color} cx="30" cy="30" rx="22" ry="18" />
+			<ellipse fill={color} cx="70" cy="30" rx="22" ry="18" />
+			<ellipse fill={color} cx="50" cy="22" rx="25" ry="16" />
+			<ellipse fill={color} cx="35" cy="18" rx="18" ry="14" />
+			<ellipse fill={color} cx="65" cy="18" rx="18" ry="14" />
+		</g>
+	</svg>
+{:else if variant === 'wispy'}
+	<!-- Thin wispy cirrus cloud -->
+	<svg
+		class="{className} {animClass}"
+		xmlns="http://www.w3.org/2000/svg"
+		viewBox="0 0 120 40"
+		style="--drift-duration: {duration}"
+	>
+		<g opacity="0.7">
+			<ellipse fill={color} cx="30" cy="20" rx="25" ry="8" />
+			<ellipse fill={color} cx="60" cy="22" rx="30" ry="10" />
+			<ellipse fill={color} cx="90" cy="18" rx="22" ry="7" />
+			<ellipse fill={color} cx="45" cy="15" rx="18" ry="6" />
+			<ellipse fill={color} cx="75" cy="25" rx="20" ry="8" />
+		</g>
+	</svg>
+{:else if variant === 'puffy'}
+	<!-- Rounded puffy cloud -->
+	<svg
+		class="{className} {animClass}"
+		xmlns="http://www.w3.org/2000/svg"
+		viewBox="0 0 110 55"
+		style="--drift-duration: {duration}"
+	>
+		<g opacity="0.85">
+			<circle fill={color} cx="25" cy="35" r="20" />
+			<circle fill={color} cx="45" cy="28" r="24" />
+			<circle fill={color} cx="55" cy="35" r="22" />
+			<circle fill={color} cx="75" cy="30" r="20" />
+			<circle fill={color} cx="90" cy="38" r="18" />
+			<ellipse fill={color} cx="55" cy="40" rx="40" ry="15" />
+		</g>
+	</svg>
+{:else if variant === 'scattered'}
+	<!-- Scattered small cloudlets -->
+	<svg
+		class="{className} {animClass}"
+		xmlns="http://www.w3.org/2000/svg"
+		viewBox="0 0 100 45"
+		style="--drift-duration: {duration}"
+	>
+		<g opacity="0.75">
+			<ellipse fill={color} cx="20" cy="25" rx="18" ry="12" />
+			<ellipse fill={color} cx="30" cy="18" rx="12" ry="10" />
+			<ellipse fill={color} cx="55" cy="30" rx="20" ry="14" />
+			<ellipse fill={color} cx="65" cy="22" rx="14" ry="11" />
+			<ellipse fill={color} cx="80" cy="28" rx="16" ry="13" />
+		</g>
+	</svg>
+{/if}
+
+<style>
+	@keyframes drift-right {
+		0% { transform: translateX(-10vw); }
+		100% { transform: translateX(110vw); }
+	}
+
+	@keyframes drift-left {
+		0% { transform: translateX(110vw); }
+		100% { transform: translateX(-10vw); }
+	}
+
+	.drift-right {
+		animation: drift-right var(--drift-duration, 80s) linear infinite;
+	}
+
+	.drift-left {
+		animation: drift-left var(--drift-duration, 80s) linear infinite;
+	}
+</style>

package/dist/ui/components/nature/sky/Cloud.svelte.d.ts

@@ -0,0 +1,11 @@
+interface Props {
+    class?: string;
+    color?: string;
+    animate?: boolean;
+    speed?: 'slow' | 'normal' | 'fast';
+    variant?: 'fluffy' | 'wispy' | 'puffy' | 'scattered';
+    direction?: 'left' | 'right';
+}
+declare const Cloud: import("svelte").Component<Props, {}, "">;
+type Cloud = ReturnType<typeof Cloud>;
+export default Cloud;

package/dist/ui/components/nature/sky/CloudWispy.svelte

@@ -0,0 +1,79 @@
+<!--
+  Grove — A place to Be
+  Copyright (c) 2025 Autumn Brown
+  Licensed under AGPL-3.0
+-->
+<script lang="ts">
+	interface Props {
+		class?: string;
+		color?: string;
+		animate?: boolean;
+		speed?: 'slow' | 'normal' | 'fast';
+	}
+
+	let {
+		class: className = 'w-20 h-6',
+		color = 'white',
+		animate = true,
+		speed = 'slow'
+	}: Props = $props();
+
+	const duration = $derived(
+		{
+			slow: '80s',
+			normal: '50s',
+			fast: '30s'
+		}[speed]
+	);
+</script>
+
+<!-- Thin wispy cirrus cloud -->
+<svg
+	class="{className} {animate ? 'drift' : ''}"
+	xmlns="http://www.w3.org/2000/svg"
+	viewBox="0 0 120 30"
+	style="--drift-duration: {duration}"
+>
+	<!-- Main wispy cloud body - soft feathery shapes -->
+	<g opacity="0.5">
+		<!-- Central wisp strand with soft cloud-like bulges -->
+		<ellipse fill={color} cx="60" cy="15" rx="50" ry="4" opacity="0.4" />
+
+		<!-- Feathery tendrils extending from main body -->
+		<ellipse fill={color} cx="25" cy="13" rx="18" ry="5" opacity="0.5" />
+		<ellipse fill={color} cx="50" cy="11" rx="15" ry="4" opacity="0.45" />
+		<ellipse fill={color} cx="75" cy="14" rx="20" ry="5" opacity="0.5" />
+		<ellipse fill={color} cx="100" cy="12" rx="15" ry="4" opacity="0.4" />
+
+		<!-- Upper wisps -->
+		<ellipse fill={color} cx="35" cy="8" rx="12" ry="3" opacity="0.35" />
+		<ellipse fill={color} cx="65" cy="7" rx="10" ry="3" opacity="0.3" />
+		<ellipse fill={color} cx="90" cy="9" rx="14" ry="3" opacity="0.35" />
+
+		<!-- Lower tendrils for depth -->
+		<ellipse fill={color} cx="40" cy="18" rx="10" ry="2.5" opacity="0.3" />
+		<ellipse fill={color} cx="70" cy="19" rx="12" ry="3" opacity="0.35" />
+		<ellipse fill={color} cx="95" cy="17" rx="8" ry="2" opacity="0.25" />
+
+		<!-- Fine wispy edges -->
+		<ellipse fill={color} cx="15" cy="14" rx="8" ry="2" opacity="0.25" />
+		<ellipse fill={color} cx="110" cy="13" rx="8" ry="2" opacity="0.25" />
+	</g>
+
+	<!-- Secondary wisp layer for more depth -->
+	<g opacity="0.35">
+		<ellipse fill={color} cx="45" cy="20" rx="25" ry="3" opacity="0.4" />
+		<ellipse fill={color} cx="80" cy="6" rx="20" ry="2.5" opacity="0.35" />
+	</g>
+</svg>
+
+<style>
+	@keyframes drift {
+		0% { transform: translateX(0); }
+		100% { transform: translateX(20px); }
+	}
+
+	.drift {
+		animation: drift var(--drift-duration, 80s) ease-in-out infinite alternate;
+	}
+</style>

package/dist/ui/components/nature/sky/CloudWispy.svelte.d.ts

@@ -0,0 +1,9 @@
+interface Props {
+    class?: string;
+    color?: string;
+    animate?: boolean;
+    speed?: 'slow' | 'normal' | 'fast';
+}
+declare const CloudWispy: import("svelte").Component<Props, {}, "">;
+type CloudWispy = ReturnType<typeof CloudWispy>;
+export default CloudWispy;

package/dist/ui/components/nature/sky/Moon.svelte

@@ -0,0 +1,60 @@
+<!--
+  Grove — A place to Be
+  Copyright (c) 2025 Autumn Brown
+  Licensed under AGPL-3.0
+-->
+<script lang="ts">
+	interface Props {
+		class?: string;
+		color?: string;
+		phase?: 'full' | 'waning' | 'crescent' | 'new';
+		animate?: boolean;
+	}
+
+	let {
+		class: className = 'w-10 h-10',
+		color = '#fef9c3',
+		phase = 'crescent',
+		animate = true
+	}: Props = $props();
+
+	const glowColor = '#fef9c3';
+</script>
+
+<!-- Moon with phase options -->
+<svg class="{className} {animate ? 'glow' : ''}" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 50 50">
+	<!-- Outer glow -->
+	<circle fill={glowColor} cx="25" cy="25" r="24" opacity="0.15" />
+
+	{#if phase === 'full'}
+		<!-- Full moon -->
+		<circle fill={color} cx="25" cy="25" r="20" />
+		<!-- Craters -->
+		<circle fill="#e5e5dc" cx="18" cy="20" r="4" opacity="0.3" />
+		<circle fill="#e5e5dc" cx="30" cy="28" r="5" opacity="0.25" />
+		<circle fill="#e5e5dc" cx="22" cy="32" r="3" opacity="0.2" />
+	{:else if phase === 'waning'}
+		<!-- Waning gibbous -->
+		<circle fill={color} cx="25" cy="25" r="20" />
+		<circle fill="#1e293b" cx="35" cy="25" r="15" />
+	{:else if phase === 'crescent'}
+		<!-- Crescent moon -->
+		<circle fill={color} cx="25" cy="25" r="20" />
+		<circle fill="#1e293b" cx="32" cy="25" r="17" />
+	{:else}
+		<!-- New moon (barely visible) -->
+		<circle fill={color} cx="25" cy="25" r="20" opacity="0.1" />
+		<circle fill={color} cx="22" cy="25" r="18" opacity="0.05" />
+	{/if}
+</svg>
+
+<style>
+	@keyframes glow {
+		0%, 100% { filter: brightness(1) drop-shadow(0 0 5px rgba(254, 249, 195, 0.3)); }
+		50% { filter: brightness(1.1) drop-shadow(0 0 10px rgba(254, 249, 195, 0.5)); }
+	}
+
+	.glow {
+		animation: glow 4s ease-in-out infinite;
+	}
+</style>

package/dist/ui/components/nature/sky/Moon.svelte.d.ts

@@ -0,0 +1,9 @@
+interface Props {
+    class?: string;
+    color?: string;
+    phase?: 'full' | 'waning' | 'crescent' | 'new';
+    animate?: boolean;
+}
+declare const Moon: import("svelte").Component<Props, {}, "">;
+type Moon = ReturnType<typeof Moon>;
+export default Moon;