@circadian/sol 0.2.9 → 0.2.12

package/dist/{solar-theme-provider-CSustvmw.js → solar-theme-provider-cxO4tmFT.js}

@@ -497,7 +497,7 @@ var require_tz = /* @__PURE__ */ __commonJS({ "node_modules/tz-lookup/tz.js": ((
 const RAD = Math.PI / 180;
 const DEG = 180 / Math.PI;
 /** Day of year (1–366) */
-function dayOfYear(date) {
+function dayOfYear$1(date) {
 	const start = new Date(date.getFullYear(), 0, 0);
 	const diff = date.getTime() - start.getTime();
 	return Math.floor(diff / 864e5);
@@ -548,7 +548,7 @@ function riseSetMinutes(latRad, declRad, altitudeDeg, longitudeDeg, utcOffsetMin
 * Compute full solar position for a given date + location
 */
 function computeSolarPosition(date, latitudeDeg, longitudeDeg, utcOffsetMinutes) {
-	const { eot, decl } = equationOfTimeAndDeclination(dayOfYear(date));
+	const { eot, decl } = equationOfTimeAndDeclination(dayOfYear$1(date));
 	const latRad = latitudeDeg * RAD;
 	const declRad = decl * RAD;
 	const localMinutes = date.getHours() * 60 + date.getMinutes() + date.getSeconds() / 60;
@@ -6818,6 +6818,207 @@ function injectWidgetCSS() {
 	injected = true;
 }
 
+//#endregion
+//#region src/lib/reverse-geocode.ts
+const BDC_ENDPOINT = "https://api.bigdatacloud.net/data/reverse-geocode-client";
+/**
+* Fetches the nearest locality/city name for the given coordinates.
+* Returns null on any error so callers can fall back gracefully.
+*
+* @param lat       Latitude (precise — from browser geolocation, not centroid)
+* @param lng       Longitude
+* @param signal    Optional AbortSignal to cancel in-flight requests on cleanup
+*/
+async function fetchReverseGeocode(lat, lng, signal) {
+	try {
+		const url = `${BDC_ENDPOINT}?latitude=${lat}&longitude=${lng}&localityLanguage=en`;
+		const res = await fetch(url, signal ? { signal } : void 0);
+		if (!res.ok) return null;
+		const data$1 = await res.json();
+		return data$1.locality?.trim() || data$1.city?.trim() || data$1.principalSubdivision?.trim() || null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Parse an instant (no-fetch) city name from an IANA timezone string.
+* Used as the initial value before geolocation resolves.
+*
+* "Europe/Copenhagen" → "Copenhagen"
+* "America/New_York"  → "New York"
+* "Asia/Ho_Chi_Minh"  → "Ho Chi Minh"
+*/
+function cityFromTimezone(tz) {
+	if (!tz) return null;
+	return (tz.split("/").pop() ?? "").replace(/_/g, " ").trim() || null;
+}
+
+//#endregion
+//#region src/lib/seasonal-blend.ts
+const IDENTITY_MODIFIER = {
+	saturationScale: 1,
+	lightnessShift: 0,
+	hueRotateDeg: 0,
+	tintStrength: 0
+};
+const UNIVERSAL_SEASON_MODIFIERS = {
+	spring: {
+		saturationScale: 1.1,
+		lightnessShift: .02,
+		hueRotateDeg: 8,
+		tintColor: "#a8d8a0",
+		tintStrength: .06
+	},
+	summer: {
+		saturationScale: 1.18,
+		lightnessShift: .03,
+		hueRotateDeg: 10,
+		tintColor: "#ffe066",
+		tintStrength: .07
+	},
+	autumn: {
+		saturationScale: .9,
+		lightnessShift: -.03,
+		hueRotateDeg: -18,
+		tintColor: "#c8692a",
+		tintStrength: .1
+	},
+	winter: {
+		saturationScale: .82,
+		lightnessShift: -.04,
+		hueRotateDeg: -25,
+		tintColor: "#8ab4d4",
+		tintStrength: .08
+	}
+};
+function hexToRgb$2(hex$1) {
+	const clean = hex$1.replace("#", "");
+	return [
+		Number.parseInt(clean.slice(0, 2), 16) / 255,
+		Number.parseInt(clean.slice(2, 4), 16) / 255,
+		Number.parseInt(clean.slice(4, 6), 16) / 255
+	];
+}
+function rgbToHsl(r, g, b) {
+	const max = Math.max(r, g, b);
+	const min = Math.min(r, g, b);
+	const l = (max + min) / 2;
+	let h = 0;
+	let s = 0;
+	if (max !== min) {
+		const d = max - min;
+		s = l > .5 ? d / (2 - max - min) : d / (max + min);
+		switch (max) {
+			case r:
+				h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+				break;
+			case g:
+				h = ((b - r) / d + 2) / 6;
+				break;
+			case b:
+				h = ((r - g) / d + 4) / 6;
+				break;
+		}
+	}
+	return [
+		h,
+		s,
+		l
+	];
+}
+function hslToRgb(h, s, l) {
+	if (s === 0) return [
+		l,
+		l,
+		l
+	];
+	const hue2rgb = (p$1, q$1, _t) => {
+		let t = _t;
+		if (t < 0) t += 1;
+		if (t > 1) t -= 1;
+		if (t < 1 / 6) return p$1 + (q$1 - p$1) * 6 * t;
+		if (t < 1 / 2) return q$1;
+		if (t < 2 / 3) return p$1 + (q$1 - p$1) * (2 / 3 - t) * 6;
+		return p$1;
+	};
+	const q = l < .5 ? l * (1 + s) : l + s - l * s;
+	const p = 2 * l - q;
+	return [
+		hue2rgb(p, q, h + 1 / 3),
+		hue2rgb(p, q, h),
+		hue2rgb(p, q, h - 1 / 3)
+	];
+}
+function rgbToHex(r, g, b) {
+	const toHex = (x) => Math.round(Math.max(0, Math.min(1, x)) * 255).toString(16).padStart(2, "0");
+	return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+function lerpNum$6(a, b, t) {
+	return a + (b - a) * t;
+}
+/**
+* Apply a SeasonalModifier to a single hex color.
+* Works in HSL space for hue rotation + saturation + lightness,
+* then blends toward tintColor if provided.
+*/
+function shiftColor(hex$1, mod) {
+	if (!hex$1 || hex$1.length < 7) return hex$1;
+	const [r, g, b] = hexToRgb$2(hex$1);
+	let [h, s, l] = rgbToHsl(r, g, b);
+	h = ((h + mod.hueRotateDeg / 360) % 1 + 1) % 1;
+	s = Math.max(0, Math.min(1, s * mod.saturationScale));
+	l = Math.max(0, Math.min(1, l + mod.lightnessShift));
+	const [sr$5, sg, sb] = hslToRgb(h, s, l);
+	let result = rgbToHex(sr$5, sg, sb);
+	if (mod.tintColor && mod.tintStrength > 0) {
+		const [tr, tg, tb] = hexToRgb$2(mod.tintColor);
+		const [fr, fg, fb] = hexToRgb$2(result);
+		result = rgbToHex(lerpNum$6(fr, tr, mod.tintStrength), lerpNum$6(fg, tg, mod.tintStrength), lerpNum$6(fb, tb, mod.tintStrength));
+	}
+	return result;
+}
+/**
+* Linearly interpolate between two SeasonalModifiers.
+* Used for smooth crossfades at solstice/equinox boundaries.
+*/
+function lerpModifier(a, b, t) {
+	return {
+		saturationScale: lerpNum$6(a.saturationScale, b.saturationScale, t),
+		lightnessShift: lerpNum$6(a.lightnessShift, b.lightnessShift, t),
+		hueRotateDeg: lerpNum$6(a.hueRotateDeg, b.hueRotateDeg, t),
+		tintStrength: lerpNum$6(a.tintStrength, b.tintStrength, t),
+		tintColor: t < .5 ? a.tintColor : b.tintColor
+	};
+}
+/**
+* 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.
+*/
+function applySeasonalModifier(palette, mod, strength = 1) {
+	if (strength <= 0) return palette;
+	const effective = strength < 1 ? lerpModifier(IDENTITY_MODIFIER, mod, strength) : mod;
+	return {
+		...palette,
+		colors: palette.colors.map((c) => shiftColor(c, effective)),
+		colorBack: shiftColor(palette.colorBack, effective),
+		vignette: shiftColor(palette.vignette, effective)
+	};
+}
+/**
+* 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)
+*/
+function resolveSeasonalModifier(blend, modifiers = UNIVERSAL_SEASON_MODIFIERS) {
+	return lerpModifier(modifiers[blend.season] ?? IDENTITY_MODIFIER, modifiers[blend.nextSeason] ?? IDENTITY_MODIFIER, blend.t);
+}
+
 //#endregion
 //#region src/lib/solar-lerp.ts
 /**
@@ -7316,6 +7517,96 @@ function getBrowserTimezone() {
 	}
 }
 
+//#endregion
+//#region src/lib/useSeason.ts
+/** Day-of-year for each northern hemisphere season start (approximate). */
+const SEASON_STARTS_NORTH = {
+	spring: 79,
+	summer: 172,
+	autumn: 265,
+	winter: 355
+};
+/** Days either side of a transition within which to apply crossfade. */
+const CROSSFADE_DAYS = 14;
+const SEASON_ORDER = [
+	"spring",
+	"summer",
+	"autumn",
+	"winter"
+];
+function dayOfYear(date) {
+	const start = new Date(date.getFullYear(), 0, 0);
+	const diff = date.getTime() - start.getTime();
+	return Math.floor(diff / 864e5);
+}
+function daysInYear(year) {
+	return new Date(year, 1, 29).getMonth() === 1 ? 366 : 365;
+}
+function computeSeasonalBlend(doy, isNorthern, totalDays) {
+	const adjustedDoy = isNorthern ? doy : (doy + 182) % totalDays || totalDays;
+	let currentSeason = "winter";
+	let currentIdx = 0;
+	for (let i$1 = SEASON_ORDER.length - 1; i$1 >= 0; i$1--) if (adjustedDoy >= SEASON_STARTS_NORTH[SEASON_ORDER[i$1]]) {
+		currentSeason = SEASON_ORDER[i$1];
+		currentIdx = i$1;
+		break;
+	}
+	const nextSeason = SEASON_ORDER[(currentIdx + 1) % SEASON_ORDER.length];
+	let daysToNext = SEASON_STARTS_NORTH[nextSeason] - adjustedDoy;
+	if (daysToNext < 0) daysToNext += totalDays;
+	let t = 0;
+	if (daysToNext <= CROSSFADE_DAYS) {
+		const raw = (CROSSFADE_DAYS - daysToNext) / CROSSFADE_DAYS;
+		const clamped = Math.max(0, Math.min(1, raw));
+		t = clamped * clamped * (3 - 2 * clamped);
+	}
+	return {
+		season: currentSeason,
+		nextSeason,
+		t
+	};
+}
+/**
+* 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
+*/
+function getSeasonalBlend(date = /* @__PURE__ */ new Date(), latitudeN = 0, override) {
+	if (override) return {
+		season: override,
+		nextSeason: SEASON_ORDER[(SEASON_ORDER.indexOf(override) + 1) % SEASON_ORDER.length],
+		t: 0
+	};
+	const isNorthern = latitudeN >= 0;
+	return computeSeasonalBlend(dayOfYear(date), isNorthern, daysInYear(date.getFullYear()));
+}
+/**
+* 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).
+*/
+function useSeason(latitudeN, override, simulatedDate) {
+	const [blend, setBlend] = useState(() => getSeasonalBlend(simulatedDate ?? /* @__PURE__ */ new Date(), latitudeN ?? 0, override));
+	useEffect(() => {
+		const recompute = () => {
+			setBlend(getSeasonalBlend(simulatedDate ?? /* @__PURE__ */ new Date(), latitudeN ?? 0, override));
+		};
+		recompute();
+		const id$2 = setInterval(recompute, 3600 * 1e3);
+		return () => clearInterval(id$2);
+	}, [
+		latitudeN,
+		override,
+		simulatedDate
+	]);
+	return blend;
+}
+
 //#endregion
 //#region node_modules/motion/dist/es/framer-motion/dist/es/context/LayoutGroupContext.mjs
 const LayoutGroupContext = createContext({});
@@ -54528,7 +54819,7 @@ function getAccentFg(accent) {
 *  - scopeId = undefined  →  writes to :root  (global / singleton mode)
 *  - scopeId = "sol-scope-3"  →  writes to #sol-scope-3  (isolated mode)
 *    The scoped vars override :root vars for all descendants of that wrapper div. */
-function writeCssVars(skin, phase, t = 0, nextPhase, scopeId) {
+function writeCssVars(skin, phase, t = 0, nextPhase, scopeId, seasonal) {
 	if (typeof document === "undefined") return;
 	const from = skin.phaseVars[phase];
 	const to = skin.phaseVars[nextPhase ?? phase];
@@ -54541,9 +54832,22 @@ function writeCssVars(skin, phase, t = 0, nextPhase, scopeId) {
 	const surface = lerp(from.surface, to.surface);
 	const shaderPalFrom = skin.shaderPalettes[phase];
 	const shaderPalTo = skin.shaderPalettes[nextPhase ?? phase];
-	const shaderVignette = t > 0 ? lerpHex(shaderPalFrom.vignette, shaderPalTo.vignette, t) : shaderPalFrom.vignette;
-	const shaderColorBack = t > 0 ? lerpHex(shaderPalFrom.colorBack, shaderPalTo.colorBack, t) : shaderPalFrom.colorBack;
+	let shaderVignette = t > 0 ? lerpHex(shaderPalFrom.vignette, shaderPalTo.vignette, t) : shaderPalFrom.vignette;
+	let shaderColorBack = t > 0 ? lerpHex(shaderPalFrom.colorBack, shaderPalTo.colorBack, t) : shaderPalFrom.colorBack;
 	const shaderFallback = shaderPalFrom.cssFallback;
+	if (seasonal && !seasonal.disabled) {
+		const mod = resolveSeasonalModifier(seasonal.blend, {
+			...UNIVERSAL_SEASON_MODIFIERS,
+			...skin.seasonalModifiers
+		});
+		const tempPalette = applySeasonalModifier({
+			...shaderPalFrom,
+			vignette: shaderVignette,
+			colorBack: shaderColorBack
+		}, mod);
+		shaderVignette = tempPalette.vignette;
+		shaderColorBack = tempPalette.colorBack;
+	}
 	if (!scopeId) {
 		const root = document.documentElement;
 		if (root.getAttribute("data-solar-skin") !== skin.id) root.setAttribute("data-solar-skin", skin.id);
@@ -54573,6 +54877,7 @@ const SolarThemeCtx = createContext({
 	latitude: null,
 	longitude: null,
 	coordsReady: false,
+	city: null,
 	setOverridePhase: noop,
 	blend: {
 		phase: SSR_PHASE,
@@ -54585,12 +54890,19 @@ const SolarThemeCtx = createContext({
 	simulatedDate: void 0,
 	setSimulatedDate: noop,
 	customPalettes: void 0,
-	setCustomPalettes: noop
+	setCustomPalettes: noop,
+	season: "spring",
+	seasonalBlend: {
+		season: "spring",
+		nextSeason: "spring",
+		t: 0
+	},
+	setSeasonOverride: noop
 });
 function useSolarTheme() {
 	return useContext(SolarThemeCtx);
 }
-function SolarThemeProvider({ children, initialDesign = "foundry", isolated = false }) {
+function SolarThemeProvider({ children, initialDesign = "foundry", isolated = false, seasonOverride: seasonOverrideProp, disableSeasonalBlend = false }) {
 	const geo = useCountryCodeFromGeolocation({ immediate: true });
 	const scopeId = useRef(isolated ? nextScopeId() : void 0).current;
 	const wrapperRef = useRef(null);
@@ -54598,6 +54910,7 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 	const [longitude, setLongitude] = useState(null);
 	const [timezone, setTimezone] = useState(null);
 	const [coordsReady, setCoordsReady] = useState(false);
+	const [city, setCity] = useState(null);
 	const [simulatedDate, setSimulatedDate] = useState(void 0);
 	const [customPalettes, setCustomPalettes] = useState(void 0);
 	const [design, setDesignState] = useState(initialDesign);
@@ -54619,6 +54932,7 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 	useLayoutEffect(() => {
 		const browserTZ = getBrowserTimezone();
 		setTimezone(browserTZ);
+		setCity(cityFromTimezone(browserTZ));
 		const coords = fallbackCoordsFromTZ(browserTZ);
 		if (coords) {
 			setLatitude(coords[0]);
@@ -54639,19 +54953,29 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 		}
 	}, [isolated]);
 	const activeSkin = SKINS[design];
+	const [seasonOverrideState, setSeasonOverrideState] = useState(seasonOverrideProp);
+	const seasonalBlend = useSeason(latitude, seasonOverrideProp ?? seasonOverrideState, simulatedDate);
+	const setSeasonOverride = useCallback((s) => setSeasonOverrideState(s ?? void 0), []);
 	const setOverridePhase = useCallback((phase) => {
 		setOverridePhaseState(phase);
 		if (!isolated) setSessionPhaseOverride(phase);
 	}, [isolated]);
 	useEffect(() => {
-		if (geo.position?.coords) {
-			const { latitude: lat, longitude: lon } = geo.position.coords;
-			setLatitude(lat);
-			setLongitude(lon);
-			const tz = coordsToTimezone(lat, lon);
-			if (tz) setTimezone(tz);
-			setCoordsReady(true);
-		}
+		if (!geo.position?.coords) return;
+		const { latitude: lat, longitude: lon } = geo.position.coords;
+		setLatitude(lat);
+		setLongitude(lon);
+		setCoordsReady(true);
+		const tz = coordsToTimezone(lat, lon);
+		if (tz) {
+			setTimezone(tz);
+			setCity(cityFromTimezone(tz));
+		}
+		const controller = new AbortController();
+		fetchReverseGeocode(lat, lon, controller.signal).then((name) => {
+			if (name) setCity(name);
+		});
+		return () => controller.abort();
 	}, [geo.position]);
 	useEffect(() => {
 		if (coordsReady) return;
@@ -54690,7 +55014,10 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 		isolated
 	]);
 	useLayoutEffect(() => {
-		writeCssVars(activeSkin, activeBlend.phase, activeBlend.t, activeBlend.nextPhase, scopeId);
+		writeCssVars(activeSkin, activeBlend.phase, activeBlend.t, activeBlend.nextPhase, scopeId, {
+			blend: seasonalBlend,
+			disabled: disableSeasonalBlend
+		});
 		if (!isolated && !document.documentElement.hasAttribute("data-solar-ready")) requestAnimationFrame(() => {
 			document.documentElement.setAttribute("data-solar-ready", "");
 		});
@@ -54698,7 +55025,9 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 		activeSkin,
 		activeBlend,
 		scopeId,
-		isolated
+		isolated,
+		seasonalBlend,
+		disableSeasonalBlend
 	]);
 	useEffect(() => {
 		if (!scopeId) return;
@@ -54719,6 +55048,7 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 		latitude,
 		longitude,
 		coordsReady,
+		city,
 		setOverridePhase,
 		blend: activeBlend,
 		design,
@@ -54727,7 +55057,10 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 		simulatedDate,
 		setSimulatedDate,
 		customPalettes,
-		setCustomPalettes
+		setCustomPalettes,
+		season: seasonalBlend.season,
+		seasonalBlend,
+		setSeasonOverride
 	};
 	if (isolated) return /* @__PURE__ */ jsx(SolarThemeCtx.Provider, {
 		value: theme,
@@ -54747,5 +55080,5 @@ function SolarThemeProvider({ children, initialDesign = "foundry", isolated = fa
 }
 
 //#endregion
-export { getSessionIsLive as a, setSessionTimeMinutes as c, clearSessionTimeMinutes as i, lerpColor as l, useSolarTheme as n, getSessionTimeMinutes as o, SKINS as r, setSessionLive as s, SolarThemeProvider as t, lerpHex as u };
-//# sourceMappingURL=solar-theme-provider-CSustvmw.js.map
+export { resolveSeasonalModifier as _, useSeason as a, getSessionTimeMinutes as c, lerpColor as d, lerpHex as f, lerpModifier as g, applySeasonalModifier as h, getSeasonalBlend as i, setSessionLive as l, UNIVERSAL_SEASON_MODIFIERS as m, useSolarTheme as n, clearSessionTimeMinutes as o, IDENTITY_MODIFIER as p, SKINS as r, getSessionIsLive as s, SolarThemeProvider as t, setSessionTimeMinutes as u };
+//# sourceMappingURL=solar-theme-provider-cxO4tmFT.js.map