@circadian/sol 0.2.8 → 0.2.10

package/README.md

@@ -45,6 +45,8 @@ Sol is the flagship package from [Circadian](https://circadian.dev) — a platfo
 bun add @circadian/sol
 # or
 npm install @circadian/sol
+# or (Deno / Fresh)
+deno add npm:@circadian/sol
 ```
 
 `@circadian/sol` gives you a full `SolarWidget`, a `CompactWidget`, 10 skins, 9 solar phases, optional live weather, optional flag display, and a dev-only timeline scrubber via `SolarDevTools`. Solar position is computed locally from latitude, longitude, timezone, and current time — no solar API required.
@@ -56,10 +58,11 @@ npm install @circadian/sol
 - **2 widget variants** — `SolarWidget` (full card) and `CompactWidget` (slim pill/bar)
 - **10 skins** — `foundry`, `paper`, `signal`, `meridian`, `mineral`, `aurora`, `tide`, `void`, `sundial`, `parchment`
 - **9 solar phases** — `midnight`, `night`, `dawn`, `sunrise`, `morning`, `solar-noon`, `afternoon`, `sunset`, `dusk`
+- **4 seasons** — automatic seasonal palette blending computed from date + hemisphere, with smooth crossfades at solstice/equinox boundaries
 - **Built-in fallback strategy** — geolocation → browser timezone → timezone centroid
 - **Optional live weather** — powered by Open-Meteo (no API key required)
 - **Dev preview tooling** — `SolarDevTools` lets you scrub through the day and preview phase colors
-- **SSR-safe** — works in Next.js, Remix, TanStack Start, Blade, and Vite
+- **SSR-safe** — works in Next.js, Remix, TanStack Start, Blade, Fresh, and Vite
 
 ---
 
@@ -285,6 +288,80 @@ export default function Page() {
 
 ---
 
+### Fresh (v2)
+
+Fresh uses Preact, so Sol works via `preact/compat`. Add the React compatibility aliases to your `vite.config.ts` and `deno.json`, then create an [island](https://fresh.deno.dev/docs/concepts/islands) for the widget.
+
+**1. Install**
+
+```bash
+deno add npm:@circadian/sol
+```
+
+**2. Configure Vite aliases** — add `resolve.alias` to `vite.config.ts`:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { fresh } from "@fresh/plugin-vite";
+
+export default defineConfig({
+  plugins: [fresh()],
+  resolve: {
+    alias: {
+      "react": "preact/compat",
+      "react-dom": "preact/compat",
+      "react/jsx-runtime": "preact/jsx-runtime",
+      "react/jsx-dev-runtime": "preact/jsx-runtime",
+      "react-dom/client": "preact/compat/client",
+    },
+  },
+});
+```
+
+**3. Add import map entries** — add to the `"imports"` in `deno.json`:
+
+```jsonc
+// deno.json (imports section)
+{
+  "imports": {
+    "react": "npm:preact@^10.27.2/compat",
+    "react-dom": "npm:preact@^10.27.2/compat",
+    "react/jsx-runtime": "npm:preact@^10.27.2/jsx-runtime",
+    "react-dom/client": "npm:preact@^10.27.2/compat/client"
+  }
+}
+```
+
+**4. Create an island** — islands are client-hydrated in Fresh, which is what Sol needs:
+
+```tsx
+// islands/SolWidget.tsx
+import { SolarThemeProvider, SolarWidget } from '@circadian/sol';
+
+export default function SolWidget() {
+  return (
+    <SolarThemeProvider initialDesign="foundry">
+      <SolarWidget showWeather showFlag />
+    </SolarThemeProvider>
+  );
+}
+```
+
+**5. Use it in a route:**
+
+```tsx
+// routes/index.tsx
+import { define } from "../utils.ts";
+import SolWidget from "../islands/SolWidget.tsx";
+
+export default define.page(function Home() {
+  return <SolWidget />;
+});
+```
+
+---
+
 ## Provider Props
 
 `SolarThemeProvider` is the shared runtime for solar phase computation, timezone, coordinates, and skin selection.
@@ -461,6 +538,105 @@ Each `bg` is a 3-stop gradient: `[top, middle, bottom]`. Only the phases you spe
 
 ---
 
+## Seasonal Blending
+
+Sol automatically adjusts every skin's palette based on the current astronomical season. Spring shifts greener and brighter, summer pushes warm and saturated, autumn mutes toward amber, winter desaturates toward icy blue. The effect is subtle by design — visible but never harsh.
+
+Season is computed from the current date and the user's latitude (southern hemisphere seasons are flipped). Near each solstice and equinox, a smooth 14-day crossfade blends between adjacent seasons.
+
+**Zero config — it just works:**
+
+```tsx
+<SolarThemeProvider initialDesign="foundry">
+  <SolarWidget showWeather showFlag />
+</SolarThemeProvider>
+```
+
+**Force a season:**
+
+```tsx
+<SolarThemeProvider initialDesign="foundry" seasonOverride="autumn">
+  <SolarWidget showWeather showFlag />
+</SolarThemeProvider>
+```
+
+**Disable seasonal blending entirely:**
+
+```tsx
+<SolarThemeProvider initialDesign="foundry" disableSeasonalBlend>
+  <SolarWidget showWeather showFlag />
+</SolarThemeProvider>
+```
+
+**Read the current season in your own components:**
+
+```tsx
+import { useSolarTheme } from '@circadian/sol';
+
+function SeasonBadge() {
+  const { season } = useSolarTheme();
+  return <span>{season}</span>; // 'spring' | 'summer' | 'autumn' | 'winter'
+}
+```
+
+### How it works
+
+Rather than defining 36 full palettes (9 phases × 4 seasons), each skin only needs 4 small seasonal modifier objects that describe _deltas_ — saturation scale, lightness shift, hue rotation, and an optional tint wash. The final palette is computed as:
+
+```
+rawPalette   = lerp(phasePalette, nextPhasePalette, phaseT)
+seasonalMod  = lerp(seasonModifier, nextSeasonModifier, seasonT)
+finalPalette = applySeasonalModifier(rawPalette, seasonalMod)
+```
+
+### Custom skin seasonal modifiers
+
+Skins can define their own per-season modifiers. Any season not defined falls back to the built-in universal defaults.
+
+```ts
+import type { SkinDefinition } from '@circadian/sol';
+
+const mySkin: SkinDefinition = {
+  // ... existing skin definition ...
+  seasonalModifiers: {
+    autumn: {
+      saturationScale: 0.85,   // slightly muted
+      lightnessShift:  -0.05,  // darker
+      hueRotateDeg:    -22,    // shift toward amber
+      tintColor:       '#b85c1a',
+      tintStrength:    0.12,
+    },
+    winter: {
+      saturationScale: 0.78,
+      lightnessShift:  -0.06,
+      hueRotateDeg:    -30,
+      tintColor:       '#6a9fc0',
+      tintStrength:    0.09,
+    },
+    // spring and summer use UNIVERSAL_SEASON_MODIFIERS automatically
+  },
+};
+```
+
+### SeasonalModifier shape
+
+| Field | Type | Description |
+|---|---|---|
+| `saturationScale` | `number` | Multiply saturation. `1.0` = unchanged, `1.2` = +20% |
+| `lightnessShift` | `number` | Add to lightness. `-0.05` = slightly darker |
+| `hueRotateDeg` | `number` | Rotate hue in degrees. `+15` = warmer, `-15` = cooler |
+| `tintColor` | `string?` | Optional hex color to blend toward |
+| `tintStrength` | `number` | `0–1`. How strongly to apply tintColor |
+
+### Provider props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `seasonOverride` | `Season` | — | Force a specific season (`'spring'` \| `'summer'` \| `'autumn'` \| `'winter'`) |
+| `disableSeasonalBlend` | `boolean` | `false` | Opt out of seasonal palette blending entirely |
+
+---
+
 ## SolarDevTools
 
 When your interface depends on live solar time, manual testing breaks down fast — you can't wait until sunset to test sunset. `SolarDevTools` lets you scrub through the full day in seconds, preview every one of the **9 phases**, test every skin against every time of day, and catch phase-specific visual bugs before your users do.
@@ -536,6 +712,9 @@ function DebugPanel() {
 | `activeSkin` | `SkinDefinition` | Full skin definition object |
 | `setOverridePhase` | `(phase \| null) => void` | Set/clear phase override |
 | `setDesign` | `(skin: DesignMode) => void` | Change active skin |
+| `season` | `Season` | Current dominant season |
+| `seasonalBlend` | `SeasonalBlend` | Season blend state (season, nextSeason, t) |
+| `setSeasonOverride` | `(season \| null) => void` | Set/clear season override |
 
 ---
 
@@ -568,6 +747,9 @@ import type {
   WidgetPalette,
   CustomPalettes,
   SolarTheme,
+  Season,
+  SeasonalBlend,
+  SeasonalModifier,
 } from '@circadian/sol';
 ```
 
@@ -579,13 +761,14 @@ import type {
 |---|---|
 | ✅ | Full widget + compact widget |
 | ✅ | 10 skins with full + compact variants |
+| ✅ | Automatic seasonal palette blending (4 seasons) |
 | ✅ | Solar math (NOAA equations, no external API) |
 | ✅ | Timezone fallback logic |
 | ✅ | Optional live weather (Open-Meteo) |
 | ✅ | Skin-aware country flags |
 | ✅ | Dev timeline scrubber |
 | ✅ | Self-contained CSS (no Tailwind required in host app) |
-| ✅ | SSR-safe (Next.js, Remix, TanStack Start, Blade, Vite) |
+| ✅ | SSR-safe (Next.js, Remix, TanStack Start, Blade, Fresh, Vite) |
 | ❌ | No solar API key needed |
 | ❌ | No weather API key needed |
 | ❌ | No Tailwind needed in your app |
@@ -597,7 +780,6 @@ import type {
 
 Sol is actively being developed. Things in progress:
 
-- **Seasonal theme system** — 4 seasons (Summer, Autumn, Winter, Spring) that blend automatically with the existing 9-phase system, computed from date and location with no configuration required
 - More skins
 - Vue and Svelte adapters
 - Deep token override system

package/dist/devtools/index.js

@@ -1,4 +1,4 @@
-import { a as getSessionIsLive, c as setSessionTimeMinutes, i as clearSessionTimeMinutes, n as useSolarTheme, o as getSessionTimeMinutes, s as setSessionLive } from "../solar-theme-provider-6-EJ4jGB.js";
+import { c as getSessionTimeMinutes, l as setSessionLive, n as useSolarTheme, o as clearSessionTimeMinutes, s as getSessionIsLive, u as setSessionTimeMinutes } from "../solar-theme-provider-BcP2n4b7.js";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { createPortal } from "react-dom";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime4 from "react/jsx-runtime";
 
 //#region src/hooks/useSolarPosition.d.ts
 
@@ -48,6 +48,85 @@ interface SolarBlend {
   t: number;
 }
 //#endregion
+//#region src/lib/useSeason.d.ts
+type Season = 'spring' | 'summer' | 'autumn' | 'winter';
+interface SeasonalBlend {
+  /** The current dominant season. */
+  season: Season;
+  /** The season being crossfaded toward (equals season outside transition windows). */
+  nextSeason: Season;
+  /**
+   * 0–1 interpolation between season → nextSeason.
+   * 0.0 = fully current season, 1.0 = fully next season.
+   * Non-zero only within the final CROSSFADE_DAYS before a solstice/equinox.
+   */
+  t: number;
+}
+/**
+ * Pure function — compute the SeasonalBlend for a given date and latitude.
+ *
+ * @param date       The date to evaluate (default: now)
+ * @param latitudeN  Decimal degrees, positive = north (default: 0)
+ * @param override   Force a fixed season, bypassing computation
+ */
+declare function getSeasonalBlend(date?: Date, latitudeN?: number, override?: Season): SeasonalBlend;
+/**
+ * Hook — returns the current SeasonalBlend, re-evaluated once per hour.
+ *
+ * @param latitudeN     Decimal degrees, positive = north.
+ *                      Pass null while coordinates are still loading.
+ * @param override      Force a specific season (for dev previews / user settings).
+ * @param simulatedDate Use a specific date instead of now (for SolarDevTools).
+ */
+declare function useSeason(latitudeN: number | null, override?: Season, simulatedDate?: Date): SeasonalBlend;
+//#endregion
+//#region src/lib/seasonal-blend.d.ts
+/**
+ * Describes how a season shifts the phase palette.
+ * All fields are deltas/scales applied on top of the base palette.
+ * Using HSL math under the hood — no full palette replacement needed.
+ */
+interface SeasonalModifier {
+  /** Multiply saturation. 1.0 = unchanged, 1.2 = +20%, 0.8 = −20%. */
+  saturationScale: number;
+  /** Add to lightness (−1.0 to +1.0). −0.05 = slightly darker. */
+  lightnessShift: number;
+  /** Rotate hue by degrees. 0 = unchanged, +15 = warmer, −15 = cooler. */
+  hueRotateDeg: number;
+  /**
+   * Optional hex color to tint toward. Applied at tintStrength opacity
+   * over the entire palette. Useful for strong seasonal washes
+   * (e.g., amber-gold for autumn) that go beyond simple HSL shifts.
+   */
+  tintColor?: string;
+  /** 0–1. How strongly to apply tintColor. 0 = no tint. */
+  tintStrength: number;
+}
+declare const IDENTITY_MODIFIER: SeasonalModifier;
+declare const UNIVERSAL_SEASON_MODIFIERS: Record<Season, SeasonalModifier>;
+/**
+ * Linearly interpolate between two SeasonalModifiers.
+ * Used for smooth crossfades at solstice/equinox boundaries.
+ */
+declare function lerpModifier(a: SeasonalModifier, b: SeasonalModifier, t: number): SeasonalModifier;
+/**
+ * Apply a SeasonalModifier to every color in a ShaderPalette.
+ * Returns a new palette — the original is not mutated.
+ *
+ * The modifier shifts hue, saturation, and lightness then applies a tint wash.
+ * The result is blended back toward the original at `strength` 0→1:
+ *   0 = identity, 1 = fully modified.
+ */
+declare function applySeasonalModifier(palette: ShaderPalette, mod: SeasonalModifier, strength?: number): ShaderPalette;
+/**
+ * Given a SeasonalBlend and a modifier map, return the interpolated modifier
+ * ready to pass to applySeasonalModifier.
+ *
+ * @param blend      The SeasonalBlend from useSeason()
+ * @param modifiers  Per-season modifier map (skin's or universal default)
+ */
+declare function resolveSeasonalModifier(blend: SeasonalBlend, modifiers?: Record<Season, SeasonalModifier>): SeasonalModifier;
+//#endregion
 //#region src/widgets/solar-widget.shell.d.ts
 type ExpandDirection = 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
 type WidgetSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
@@ -82,7 +161,7 @@ declare function SolarWidget({
   weatherCategoryOverride,
   simulatedDate: simulatedDateProp,
   forceExpanded
-}: SolarWidgetProps): react_jsx_runtime0.JSX.Element;
+}: SolarWidgetProps): react_jsx_runtime4.JSX.Element;
 //#endregion
 //#region src/widgets/compact-widget.shell.d.ts
 type WeatherCategory$1 = 'clear' | 'partly-cloudy' | 'overcast' | 'fog' | 'drizzle' | 'rain' | 'heavy-rain' | 'snow' | 'heavy-snow' | 'thunder';
@@ -149,7 +228,7 @@ declare function CompactWidget({
   customPalettes,
   simulatedDate: simulatedDateProp,
   className
-}: CompactWidgetProps): react_jsx_runtime0.JSX.Element;
+}: CompactWidgetProps): react_jsx_runtime4.JSX.Element;
 //#endregion
 //#region src/skins/types/widget-skin.types.d.ts
 interface ShaderImage {
@@ -284,6 +363,12 @@ interface SkinDefinition {
    *   }
    */
   defaultImage?: ShaderImage;
+  /**
+   * Optional per-season palette modifiers.
+   * If omitted, UNIVERSAL_SEASON_MODIFIERS is used automatically.
+   * Define only the seasons you want to customise — the rest fall back.
+   */
+  seasonalModifiers?: Partial<Record<Season, SeasonalModifier>>;
   /**
    * The React component that renders the actual widget pill + expanded card.
    * Receives WidgetSkinProps and is fully responsible for its own visual output.
@@ -347,6 +432,12 @@ interface SolarTheme {
   /** Custom palette overrides registered by the nearest widget. */
   customPalettes: CustomPalettes | undefined;
   setCustomPalettes: (palettes: CustomPalettes | undefined) => void;
+  /** Current dominant season. */
+  season: Season;
+  /** Full seasonal blend state (season, nextSeason, crossfade t). */
+  seasonalBlend: SeasonalBlend;
+  /** Override the auto-detected season, or pass null to restore auto-detection. */
+  setSeasonOverride: (season: Season | null) => void;
 }
 declare function useSolarTheme(): SolarTheme;
 interface Props {
@@ -359,12 +450,44 @@ interface Props {
    * (e.g. a skin showcase / test page). Defaults to false.
    */
   isolated?: boolean;
+  /**
+   * Force a specific season, bypassing astronomical computation.
+   * Useful for testing, user preferences, or themed marketing pages.
+   */
+  seasonOverride?: Season;
+  /**
+   * Opt out of seasonal palette blending entirely.
+   * When true, palettes are exactly as defined in the skin. Default: false.
+   */
+  disableSeasonalBlend?: boolean;
 }
 declare function SolarThemeProvider({
   children,
   initialDesign,
-  isolated
-}: Props): react_jsx_runtime0.JSX.Element;
+  isolated,
+  seasonOverride: seasonOverrideProp,
+  disableSeasonalBlend
+}: Props): react_jsx_runtime4.JSX.Element;
+//#endregion
+//#region src/shared/solar-shader-bg.d.ts
+type ShaderVariant = 'showcase' | 'dashboard' | 'editorial';
+interface SolarShaderBgProps {
+  skinOverride?: SkinDefinition;
+  blendOverride?: SolarBlend;
+  opacityOverride?: number;
+  variant?: ShaderVariant;
+  className?: string;
+  style?: React.CSSProperties;
+}
+declare function SolarShaderBg({
+  skinOverride,
+  blendOverride,
+  opacityOverride,
+  variant: variantProp,
+  className,
+  style
+}?: SolarShaderBgProps): react_jsx_runtime4.JSX.Element;
+declare function SolarShaderBgFull(props?: SolarShaderBgProps): react_jsx_runtime4.JSX.Element;
 //#endregion
-export { type CompactSize, CompactWidget, type DesignMode, type ExpandDirection, type SkinDefinition, type SolarBlend, type SolarPhase, type SolarTheme, SolarThemeProvider, SolarWidget, type WeatherCategory, type WidgetPalette, type WidgetSize, useSolarTheme };
+export { type CompactSize, CompactWidget, type DesignMode, type ExpandDirection, IDENTITY_MODIFIER, type Season, type SeasonalBlend, type SeasonalModifier, type SkinDefinition, type SolarBlend, type SolarPhase, SolarShaderBg, SolarShaderBgFull, type SolarTheme, SolarThemeProvider, SolarWidget, UNIVERSAL_SEASON_MODIFIERS, type WeatherCategory, type WidgetPalette, type WidgetSize, applySeasonalModifier, getSeasonalBlend, lerpModifier, resolveSeasonalModifier, useSeason, useSolarTheme };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/hooks/useSolarPosition.tsx","../src/widgets/solar-widget.shell.tsx","../src/widgets/compact-widget.shell.tsx","../src/skins/types/widget-skin.types.ts","../src/provider/solar-theme-provider.tsx"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/hooks/useSolarPosition.tsx","../src/lib/useSeason.ts","../src/lib/seasonal-blend.ts","../src/widgets/solar-widget.shell.tsx","../src/widgets/compact-widget.shell.tsx","../src/skins/types/widget-skin.types.ts","../src/provider/solar-theme-provider.tsx","../src/shared/solar-shader-bg.tsx"],"sourcesContent":[],"mappings":"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"}