@fiestaboard/ui 1.6.3

package/dist/lib/board-metrics.js

@@ -0,0 +1,22 @@
+//#region src/lib/board-metrics.ts
+var e = {
+	sm: "w-[14px] h-[18px]",
+	md: "w-[14px] h-[20px] sm:w-[20px] sm:h-[28px] md:w-[24px] md:h-[34px] lg:w-[28px] lg:h-[40px]",
+	lg: "w-[18px] h-[26px] sm:w-[24px] sm:h-[34px] md:w-[28px] md:h-[40px] lg:w-[32px] lg:h-[46px]"
+}, t = {
+	sm: "text-[7px]",
+	md: "text-[7px] sm:text-[10px] md:text-[13px] lg:text-[16px]",
+	lg: "text-[10px] sm:text-[13px] md:text-[16px] lg:text-[20px]"
+}, n = {
+	sm: "px-3 py-4",
+	md: "px-2 py-3 sm:px-4 sm:py-6 md:px-5 md:py-8 lg:px-6 lg:py-10",
+	lg: "px-3 py-4 sm:px-5 sm:py-7 md:px-6 md:py-9 lg:px-8 lg:py-12"
+}, r = {
+	sm: "gap-[3px]",
+	md: "gap-[2px] sm:gap-[4px] md:gap-[5px]",
+	lg: "gap-[3px] sm:gap-[5px] md:gap-[6px] lg:gap-[7px]"
+};
+//#endregion
+export { r as gapClasses, n as paddingClasses, e as sizeClasses, t as textSizeClasses };
+
+//# sourceMappingURL=board-metrics.js.map

package/dist/lib/board-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-metrics.js","names":[],"sources":["../../src/lib/board-metrics.ts"],"mappings":";AAiBA,IAAa,IAAyC;CACpD,IAAI;CACJ,IAAI;CACJ,IAAI;AACN,GAEa,IAA6C;CACxD,IAAI;CACJ,IAAI;CACJ,IAAI;AACN,GAEa,IAA4C;CACvD,IAAI;CACJ,IAAI;CACJ,IAAI;AACN,GAEa,IAAwC;CACnD,IAAI;CACJ,IAAI;CACJ,IAAI;AACN"}

package/dist/lib/seasons-drafts.d.ts

@@ -0,0 +1,26 @@
+import { type Season } from "./seasons";
+/**
+ * Design drafts: fully styled seasons that are NOT live — they appear in
+ * the Storybook Season selector (marked as drafts) but getActiveSeason()
+ * never consults them, so consuming apps ship only SEASONS. Promote a
+ * finished design by moving its entry into SEASONS in seasons.tsx.
+ *
+ * This module is deliberately NOT re-exported from the package barrel:
+ * the draft objects are Storybook-only data, and keeping them out of
+ * src/index.ts keeps them tree-shakeable out of every production bundle.
+ * Storybook (and anyone previewing drafts) imports it directly via the
+ * `./*` subpath export: `@fiestaboard/ui/lib/seasons-drafts`.
+ *
+ * Each draft's CSS lives in src/styles/seasons/<id>.css and ships to
+ * dist/seasons/<id>.css. It is NOT imported by theme.css (only the live
+ * pride season is) — a consumer promoting a draft opts in with
+ * `@import "@fiestaboard/ui/seasons/<id>.css"`. Storybook imports every
+ * draft in storybook.css so the Season toolbar previews them.
+ *
+ * `colors` MUST mirror the season CSS's --icon-g1..6 ramp: the CSS is the
+ * design intent, and the aurora/confetti render alongside the CSS-tinted
+ * chrome, so a diverging palette reads as two different seasons at once.
+ */
+export declare const DRAFT_SEASONS: Season[];
+/** Every season, live and draft — for previews (Storybook selector). */
+export declare const ALL_SEASONS: Season[];

package/dist/lib/seasons-drafts.js

@@ -0,0 +1,106 @@
+import { SEASONS as e } from "./seasons.js";
+//#region src/lib/seasons-drafts.ts
+var t = [
+	{
+		id: "halloween",
+		label: "Halloween",
+		months: [9],
+		htmlClass: "halloween-season",
+		colors: [
+			"#ff7518",
+			"#ff9838",
+			"#39d353",
+			"#a855f7",
+			"#7c3aed",
+			"#6a0dad"
+		]
+	},
+	{
+		id: "thanksgiving",
+		label: "Thanksgiving",
+		months: [10],
+		htmlClass: "thanksgiving-season",
+		colors: [
+			"#a0522d",
+			"#c9682a",
+			"#e0a030",
+			"#eec659",
+			"#b5651d",
+			"#8c3b1b"
+		]
+	},
+	{
+		id: "christmas",
+		label: "Christmas",
+		months: [11],
+		htmlClass: "christmas-season",
+		colors: [
+			"#c8102e",
+			"#d94a3d",
+			"#ffd700",
+			"#2aa457",
+			"#0f8a3d",
+			"#0b6b30"
+		]
+	},
+	{
+		id: "new-year",
+		label: "New Year",
+		months: [0],
+		htmlClass: "new-year-season",
+		colors: [
+			"#ffd700",
+			"#f5da6e",
+			"#d8dde8",
+			"#a9b6d0",
+			"#5b6fd4",
+			"#2c3e8c"
+		]
+	},
+	{
+		id: "easter",
+		label: "Easter",
+		months: [3],
+		htmlClass: "easter-season",
+		colors: [
+			"#e8879e",
+			"#d9a520",
+			"#5cbf8a",
+			"#6fb3e0",
+			"#a98ed9",
+			"#e8879e"
+		]
+	},
+	{
+		id: "mothers-day",
+		label: "Mother's Day",
+		months: [4],
+		htmlClass: "mothers-day-season",
+		colors: [
+			"#b03060",
+			"#d1608a",
+			"#e79ab0",
+			"#d8b98a",
+			"#c76a94",
+			"#b03060"
+		]
+	},
+	{
+		id: "fathers-day",
+		label: "Father's Day",
+		months: [5],
+		htmlClass: "fathers-day-season",
+		colors: [
+			"#2f5d8a",
+			"#4a7ba6",
+			"#5f9ea0",
+			"#6d7f93",
+			"#3f6e7e",
+			"#2f5d8a"
+		]
+	}
+], n = [...e, ...t];
+//#endregion
+export { n as ALL_SEASONS, t as DRAFT_SEASONS };
+
+//# sourceMappingURL=seasons-drafts.js.map

package/dist/lib/seasons-drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seasons-drafts.js","names":[],"sources":["../../src/lib/seasons-drafts.ts"],"mappings":";;AAwBA,IAAa,IAA0B;CACrC;EACE,IAAI;EACJ,OAAO;EACP,QAAQ,CAAC,CAAC;EACV,WAAW;EACX,QAAQ;GAAC;GAAW;GAAW;GAAW;GAAW;GAAW;EAAS;CAC3E;CACA;EACE,IAAI;EACJ,OAAO;EACP,QAAQ,CAAC,EAAE;EACX,WAAW;EACX,QAAQ;GAAC;GAAW;GAAW;GAAW;GAAW;GAAW;EAAS;CAC3E;CACA;EACE,IAAI;EACJ,OAAO;EACP,QAAQ,CAAC,EAAE;EACX,WAAW;EACX,QAAQ;GAAC;GAAW;GAAW;GAAW;GAAW;GAAW;EAAS;CAC3E;CACA;EACE,IAAI;EACJ,OAAO;EACP,QAAQ,CAAC,CAAC;EACV,WAAW;EACX,QAAQ;GAAC;GAAW;GAAW;GAAW;GAAW;GAAW;EAAS;CAC3E;CACA;EACE,IAAI;EACJ,OAAO;EACP,QAAQ,CAAC,CAAC;EACV,WAAW;EACX,QAAQ;GAAC;GAAW;GAAW;GAAW;GAAW;GAAW;EAAS;CAC3E;CACA;EACE,IAAI;EACJ,OAAO;EACP,QAAQ,CAAC,CAAC;EACV,WAAW;EACX,QAAQ;GAAC;GAAW;GAAW;GAAW;GAAW;GAAW;EAAS;CAC3E;CACA;EAKE,IAAI;EACJ,OAAO;EACP,QAAQ,CAAC,CAAC;EACV,WAAW;EACX,QAAQ;GAAC;GAAW;GAAW;GAAW;GAAW;GAAW;EAAS;CAC3E;AACF,GAGa,IAAwB,CAAC,GAAG,GAAS,GAAG,CAAa"}

package/dist/lib/seasons.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Seasonal theming — festive treatments that activate on the calendar.
+ *
+ * Each season declares when it runs, the class the app shell stamps on
+ * <html> (which theme.css styles), and its color palette (used by the
+ * sidebar auroras and the confetti burst). Pride is the first season;
+ * add more by extending SEASONS and shipping a matching CSS block.
+ *
+ * The opt-out cookie (set by the consuming app — FiestaBoard: Settings →
+ * Advanced → Festive Months) disables all seasons at once.
+ */
+export interface Season {
+    id: string;
+    /** English display name — apps localize by id if needed. */
+    label: string;
+    /** Active months, 0-indexed like Date.getMonth(). */
+    months: number[];
+    /** Class the app shell applies to <html>; theme.css styles it. */
+    htmlClass: string;
+    /** Palette for auroras and the celebration burst. */
+    colors: string[];
+}
+export declare const PRIDE_SEASON: Season;
+/** All registered seasons, in priority order (first match wins). */
+export declare const SEASONS: Season[];
+export declare const HIDE_FESTIVE_COOKIE = "hide_festive_months";
+export declare function readCookieString(): string;
+/** The season active for `now`, or null (calendar + opt-out cookie). */
+export declare function getActiveSeason(now?: Date, cookieString?: string): Season | null;
+/**
+ * Returns the active season, or null. Returns null on the first render to
+ * avoid hydration mismatch, then resolves in an effect.
+ */
+export declare function useActiveSeason(): Season | null;
+/**
+ * Spawns the seasonal confetti burst at the click position. Particles use
+ * the `.pride-burst-particle` class from theme.css and clean themselves up
+ * on animation end. Pure DOM — callers layer their own toast on top.
+ *
+ * All 48 particles are built off-tree and appended to a single container in
+ * one DOM mutation; a single delegated `animationend` listener on the
+ * container removes the whole subtree once the last particle finishes. No
+ * burst plays when the user prefers reduced motion.
+ */
+export declare function fireSeasonBurst(e: {
+    clientX: number;
+    clientY: number;
+}, colors?: string[]): void;
+/** @deprecated Use getActiveSeason() — pride is now a registered season. */
+export declare function shouldShowPride(now?: Date, cookieString?: string): boolean;
+/** @deprecated Use useActiveSeason(). */
+export declare function usePrideActive(): boolean;

package/dist/lib/seasons.js

@@ -0,0 +1,59 @@
+"use client";
+import { useEffect as e, useState as t } from "react";
+//#region src/lib/seasons.tsx
+var n = {
+	id: "pride",
+	label: "Pride",
+	months: [5],
+	htmlClass: "pride-month",
+	colors: [
+		"#e40303",
+		"#ff8c00",
+		"#ffed00",
+		"#008026",
+		"#004dff",
+		"#750787"
+	]
+}, r = [n], i = "hide_festive_months";
+function a() {
+	return typeof document < "u" ? document.cookie : "";
+}
+function o(e) {
+	return e.split("; ").some((e) => e === `${i}=true`);
+}
+var s = -1, c = null, l = null;
+function u(e = /* @__PURE__ */ new Date(), t = "") {
+	let n = e.getMonth();
+	return (n !== s || t !== c) && (s = n, c = t, l = o(t) ? null : r.find((e) => e.months.includes(n)) ?? null), l;
+}
+function d() {
+	let [n, r] = t(null);
+	return e(() => {
+		r(u(/* @__PURE__ */ new Date(), a()));
+	}, []), n;
+}
+function f(e, t = n.colors) {
+	if (typeof window < "u" && window.matchMedia("(prefers-reduced-motion: reduce)").matches) return;
+	let r = document.createElement("div");
+	r.className = "pride-burst";
+	for (let n = 0; n < 48; n++) {
+		let i = document.createElement("div");
+		i.className = "pride-burst-particle";
+		let a = n / 48 * Math.PI * 2 + (Math.random() - .5) * .5, o = 80 + Math.random() * 160;
+		i.style.setProperty("--tx", `${Math.cos(a) * o}px`), i.style.setProperty("--ty", `${Math.sin(a) * o}px`), i.style.setProperty("--rot", `${Math.random() * 720 - 360}deg`), i.style.setProperty("--dur", `${.5 + Math.random() * .5}s`), i.style.background = t[n % t.length], i.style.left = `${e.clientX - 3.5}px`, i.style.top = `${e.clientY - 3.5}px`, r.appendChild(i);
+	}
+	let i = 48;
+	r.addEventListener("animationend", () => {
+		--i === 0 && r.remove();
+	}), setTimeout(() => r.remove(), 1500), document.body.appendChild(r);
+}
+function p(e = /* @__PURE__ */ new Date(), t = "") {
+	return u(e, t)?.id === "pride";
+}
+function m() {
+	return d()?.id === "pride";
+}
+//#endregion
+export { i as HIDE_FESTIVE_COOKIE, n as PRIDE_SEASON, r as SEASONS, f as fireSeasonBurst, u as getActiveSeason, a as readCookieString, p as shouldShowPride, d as useActiveSeason, m as usePrideActive };
+
+//# sourceMappingURL=seasons.js.map

package/dist/lib/seasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seasons.js","names":[],"sources":["../../src/lib/seasons.tsx"],"mappings":";;;AA4BA,IAAa,IAAuB;CAClC,IAAI;CACJ,OAAO;CACP,QAAQ,CAAC,CAAC;CACV,WAAW;CACX,QAAQ;EAAC;EAAW;EAAW;EAAW;EAAW;EAAW;CAAS;AAC3E,GAGa,IAAoB,CAAC,CAAY,GAOjC,IAAsB;AAEnC,SAAgB,IAA2B;CACzC,OAAO,OAAO,WAAa,MAAc,SAAS,SAAS;AAC7D;AAEA,SAAS,EAAgB,GAA+B;CACtD,OAAO,EAAa,MAAM,IAAI,CAAC,CAAC,MAAM,MAAM,MAAM,GAAG,EAAoB,MAAM;AACjF;AAMA,IAAI,IAAc,IACd,IAA8B,MAC9B,IAA8B;AAGlC,SAAgB,EAAgB,oBAAY,IAAI,KAAK,GAAG,IAAe,IAAmB;CACxF,IAAM,IAAQ,EAAI,SAAS;CAU3B,QATI,MAAU,KAAe,MAAiB,OAC5C,IAAc,GACd,IAAe,GACf,AAGE,IAHE,EAAgB,CAAY,IACf,OAEA,EAAQ,MAAM,MAAM,EAAE,OAAO,SAAS,CAAK,CAAC,KAAK,OAG7D;AACT;AAMA,SAAgB,IAAiC;CAC/C,IAAM,CAAC,GAAQ,KAAa,EAAwB,IAAI;CAMxD,OAJA,QAAgB;EACd,EAAU,kBAAgB,IAAI,KAAK,GAAG,EAAiB,CAAC,CAAC;CAC3D,GAAG,CAAC,CAAC,GAEE;AACT;AAYA,SAAgB,EAAgB,GAAyC,IAAmB,EAAa,QAAQ;CAC/G,IAAI,OAAO,SAAW,OAAe,OAAO,WAAW,kCAAkC,CAAC,CAAC,SAAS;CAEpG,IACM,IAAY,SAAS,cAAc,KAAK;CAC9C,EAAU,YAAY;CACtB,KAAK,IAAI,IAAI,GAAG,IAAI,IAAO,KAAK;EAC9B,IAAM,IAAI,SAAS,cAAc,KAAK;EACtC,EAAE,YAAY;EACd,IAAM,IAAS,IAAI,KAAS,KAAK,KAAK,KAAK,KAAK,OAAO,IAAI,MAAO,IAC5D,IAAO,KAAK,KAAK,OAAO,IAAI;EAQlC,AAPA,EAAE,MAAM,YAAY,QAAQ,GAAG,KAAK,IAAI,CAAK,IAAI,EAAK,GAAG,GACzD,EAAE,MAAM,YAAY,QAAQ,GAAG,KAAK,IAAI,CAAK,IAAI,EAAK,GAAG,GACzD,EAAE,MAAM,YAAY,SAAS,GAAG,KAAK,OAAO,IAAI,MAAM,IAAI,IAAI,GAC9D,EAAE,MAAM,YAAY,SAAS,GAAG,KAAM,KAAK,OAAO,IAAI,GAAI,EAAE,GAC5D,EAAE,MAAM,aAAa,EAAO,IAAI,EAAO,SACvC,EAAE,MAAM,OAAO,GAAG,EAAE,UAAU,IAAI,KAClC,EAAE,MAAM,MAAM,GAAG,EAAE,UAAU,IAAI,KACjC,EAAU,YAAY,CAAC;CACzB;CAEA,IAAI,IAAY;CAShB,AARA,EAAU,iBAAiB,sBAAsB;EAC/C,AAAI,EAAE,MAAc,KAAG,EAAU,OAAO;CAC1C,CAAC,GAKD,iBAAiB,EAAU,OAAO,GAAG,IAAI,GACzC,SAAS,KAAK,YAAY,CAAS;AACrC;AAKA,SAAgB,EAAgB,oBAAY,IAAI,KAAK,GAAG,IAAe,IAAa;CAClF,OAAO,EAAgB,GAAK,CAAY,CAAC,EAAE,OAAO;AACpD;AAGA,SAAgB,IAA0B;CAExC,OADe,EACR,CAAA,EAAQ,OAAO;AACxB"}

package/dist/lib/select-items.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Content-key stabilization for the items collected from Select children
+ * (issue #62). `children` is a freshly-built element tree on every parent
+ * render, so memoizing on its identity never holds; these helpers derive a
+ * structural signature instead, letting `Select` reuse the previous items
+ * array whenever the logical option set is unchanged.
+ *
+ * Deliberately React-free (labels are treated as plain element-shaped
+ * objects) so it can be unit-tested under `node --test`.
+ */
+export type SelectItemRecord = {
+    value: unknown;
+    label: unknown;
+};
+export type StableSelectItems<T extends SelectItemRecord = SelectItemRecord> = {
+    key: string;
+    items: T[];
+};
+/**
+ * Derive a stable string signature for a collected item list: two
+ * structurally-equal option sets yield the same key even when every array,
+ * object, and label element has a fresh identity.
+ */
+export declare function selectItemsContentKey(items: ReadonlyArray<SelectItemRecord>): string;
+/**
+ * Return `prev` unchanged when `next` has the same content key — preserving
+ * the previous items array reference — otherwise a new state adopting `next`.
+ */
+export declare function stabilizeSelectItems<T extends SelectItemRecord>(prev: StableSelectItems<T> | null, next: T[]): StableSelectItems<T>;

package/dist/lib/select-items.js

@@ -0,0 +1,35 @@
+function e(t, n) {
+	if (t != null && typeof t != "boolean") {
+		if (typeof t == "string" || typeof t == "number" || typeof t == "bigint") {
+			n.push(String(t));
+			return;
+		}
+		if (Array.isArray(t)) {
+			for (let r of t) e(r, n);
+			return;
+		}
+		if (typeof t == "object") {
+			let r = t, i = r.type;
+			n.push(typeof i == "string" ? i : typeof i == "function" ? `fn:${i.name}` : "#"), n.push(""), e(r.props?.children, n);
+		}
+	}
+}
+function t(t) {
+	let n = [];
+	for (let r of t) {
+		let t = [];
+		e(r.label, t), n.push(`${String(r.value)}
${t.join("")}`);
+	}
+	return n.join("\0");
+}
+function n(e, n) {
+	let r = t(n);
+	return e !== null && e.key === r ? e : {
+		key: r,
+		items: n
+	};
+}
+//#endregion
+export { t as selectItemsContentKey, n as stabilizeSelectItems };
+
+//# sourceMappingURL=select-items.js.map

package/dist/lib/select-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-items.js","names":[],"sources":["../../src/lib/select-items.ts"],"mappings":"AAsBA,SAAS,EAAc,GAAe,GAAqB;CACrD,SAAQ,QAAQ,OAAO,KAAS,WACpC;MAAI,OAAO,KAAS,YAAY,OAAO,KAAS,YAAY,OAAO,KAAS,UAAU;GACpF,EAAI,KAAK,OAAO,CAAI,CAAC;GACrB;EACF;EACA,IAAI,MAAM,QAAQ,CAAI,GAAG;GACvB,KAAK,IAAM,KAAS,GAAM,EAAc,GAAO,CAAG;GAClD;EACF;EACA,IAAI,OAAO,KAAS,UAAU;GAG5B,IAAM,IAAK,GACL,IAAO,EAAG;GAGhB,AAFA,EAAI,KAAK,OAAO,KAAS,WAAW,IAAO,OAAO,KAAS,aAAa,MAAM,EAAK,SAAS,GAAG,GAC/F,EAAI,KAAK,GAAQ,GACjB,EAAc,EAAG,OAAO,UAAU,CAAG;EACvC;CAbA;AAcF;AAOA,SAAgB,EAAsB,GAAgD;CACpF,IAAM,IAAkB,CAAC;CACzB,KAAK,IAAM,KAAQ,GAAO;EACxB,IAAM,IAAuB,CAAC;EAE9B,AADA,EAAc,EAAK,OAAO,CAAU,GACpC,EAAM,KAAK,GAAG,OAAO,EAAK,KAAK,KAAgB,EAAW,KAAK,EAAE,GAAG;CACtE;CACA,OAAO,EAAM,KAAK,IAAQ;AAC5B;AAMA,SAAgB,EACd,GACA,GACsB;CACtB,IAAM,IAAM,EAAsB,CAAI;CAEtC,OADI,MAAS,QAAQ,EAAK,QAAQ,IAAY,IACvC;EAAE;EAAK,OAAO;CAAK;AAC5B"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/lib/utils.js

@@ -0,0 +1,11 @@
+import { clsx as e } from "clsx";
+import { extendTailwindMerge as t } from "tailwind-merge";
+//#region src/lib/utils.ts
+var n = t({ cacheSize: 8e3 });
+function r(...t) {
+	return n(e(t));
+}
+//#endregion
+export { r as cn };
+
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/lib/utils.ts"],"mappings":";;;AAWA,IAAM,IAAU,EAAoB,EAAE,WAAW,IAAK,CAAC;AAEvD,SAAgB,EAAG,GAAG,GAAsB;CAC1C,OAAO,EAAQ,EAAK,CAAM,CAAC;AAC7B"}

package/dist/seasons/christmas.css

@@ -0,0 +1,64 @@
+/* christmas — draft seasonal theme. Styles activate only when the
+   .christmas-season class is stamped on <html> (Storybook Season selector).
+   Not consulted by getActiveSeason() until promoted to SEASONS.
+
+   Design intent: classic and tasteful — cranberry red and evergreen joined
+   by a ribbon of gold, over a deep pine-night base so the aurora drifts
+   like lights on a tree. Rich, not garish. */
+
+/* Logo: deep cranberry → bright gold ribbon → deep evergreen. Stops are
+   split deep/bright on purpose: the light sidebar animates all three stops
+   under the wordmark, so every stop holds ≥1.5:1 against all of them
+   (lowest: #0b6b30 at 1.57:1) while the golds keep the sparkle on the
+   dark pine-night base. */
+.christmas-season .logo-fiesta-text {
+  background: linear-gradient(90deg, #a8102a, #ffd700, #ffe066, #0b6b30, #07481f);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+/* Page-icon gradient: red through gold into deepening evergreen */
+.christmas-season {
+  --icon-g1: #c8102e;
+  --icon-g2: #d94a3d;
+  --icon-g3: #ffd700;
+  --icon-g4: #2aa457;
+  --icon-g5: #0f8a3d;
+  --icon-g6: #0b6b30;
+}
+
+/* Dark mode sidebar: flat deep pine-night green — the WebGL aurora
+   (red/green/gold/snow palette) plays the part of the tree lights. */
+.dark.christmas-season .sidebar-gradient,
+.dark.christmas-season .sidebar-gradient-horizontal {
+  background: #0d1811;
+  animation: none;
+  color: oklch(1 0 0);
+  --sidebar-foreground: oklch(1 0 0);
+  --sidebar-accent: oklch(1 0 0 / 14%);
+  --sidebar-accent-foreground: oklch(1 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --foreground: oklch(1 0 0);
+  --muted-foreground: oklch(1 0 0 / 75%);
+}
+
+/* Light mode sidebar: retint the flowing gradient stops to soft holly red,
+   antique gold, and wreath green (black text stays ≥4.5:1 on these). */
+.christmas-season:not(.dark) .sidebar-gradient,
+.christmas-season:not(.dark) .sidebar-gradient-horizontal {
+  --sidebar-fiesta-red: #bd5f5f;
+  --sidebar-fiesta-orange: #c4a34e;
+  --sidebar-fiesta-purple: #5e9670;
+}
+
+/* Reduced motion: authored here rather than inherited — these selectors
+   out-specific the base .sidebar-gradient rules in theme.css, so a future
+   edit that re-declares animation above would silently escape the base
+   @media block. Keeping the guard in-file makes that impossible. */
+@media (prefers-reduced-motion: reduce) {
+  .christmas-season .sidebar-gradient,
+  .christmas-season .sidebar-gradient-horizontal {
+    animation: none;
+  }
+}

package/dist/seasons/easter.css

@@ -0,0 +1,62 @@
+/* easter — draft seasonal theme. Styles activate only when the
+   .easter-season class is stamped on <html> (Storybook Season selector).
+   Not consulted by getActiveSeason() until promoted to SEASONS.
+
+   Design intent: springtime pastels — blush pink, baby blue, butter
+   yellow, mint, and lilac. Logo/icon gradients use slightly deepened
+   pastels so they hold contrast on white; the dark sidebar is a muted
+   dusk-lavender so white text and the pastel aurora both read. */
+
+/* Page-icon SVG gradient stops */
+.easter-season {
+  --icon-g1: #e8879e; /* blush */
+  --icon-g2: #d9a520; /* butter gold */
+  --icon-g3: #5cbf8a; /* spring mint */
+  --icon-g4: #6fb3e0; /* baby blue */
+  --icon-g5: #a98ed9; /* lilac */
+  --icon-g6: #e8879e; /* blush (loop) */
+}
+
+/* "Fiesta" logo word — the same spring sequence one shade deeper than the
+   icon ramp: the light sidebar animates pastel egg-shell stops under the
+   wordmark, so every logo stop holds ≥1.5:1 against all of them (lowest:
+   #b8860b at 1.64:1) where the raw pastels would wash out. */
+.easter-season .logo-fiesta-text {
+  background: linear-gradient(90deg, #d4677f, #b8860b, #2f9e68, #3f8dc4, #8a6cc9);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+/* Light mode sidebar: pastel egg-shell gradient stops (mechanics unchanged) */
+.easter-season:not(.dark) .sidebar-gradient,
+.easter-season:not(.dark) .sidebar-gradient-horizontal {
+  --sidebar-fiesta-red: #e3a8b8; /* blush pink */
+  --sidebar-fiesta-orange: #e0d193; /* butter yellow */
+  --sidebar-fiesta-purple: #a8c9e6; /* baby blue */
+}
+
+/* Dark mode sidebar: muted dusk-lavender base; aurora provides the color */
+.dark.easter-season .sidebar-gradient,
+.dark.easter-season .sidebar-gradient-horizontal {
+  background: #16131f;
+  animation: none;
+  color: oklch(1 0 0);
+  --sidebar-foreground: oklch(1 0 0);
+  --sidebar-accent: oklch(1 0 0 / 14%);
+  --sidebar-accent-foreground: oklch(1 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --foreground: oklch(1 0 0);
+  --muted-foreground: oklch(1 0 0 / 75%);
+}
+
+/* Reduced motion: authored here rather than inherited — these selectors
+   out-specific the base .sidebar-gradient rules in theme.css, so a future
+   edit that re-declares animation above would silently escape the base
+   @media block. Keeping the guard in-file makes that impossible. */
+@media (prefers-reduced-motion: reduce) {
+  .easter-season .sidebar-gradient,
+  .easter-season .sidebar-gradient-horizontal {
+    animation: none;
+  }
+}

package/dist/seasons/fathers-day.css

@@ -0,0 +1,62 @@
+/* fathers-day — draft seasonal theme. Styles activate only when the
+   .fathers-day-season class is stamped on <html> (Storybook Season selector).
+   Not consulted by getActiveSeason() until promoted to SEASONS.
+
+   Design intent: grounded and calm — steel blue, slate, and sea-glass
+   teal, like worn denim and a quiet coastline. Dark sidebar is a deep
+   harbor slate so white text and the cool aurora read cleanly. */
+
+/* Page-icon SVG gradient stops */
+.fathers-day-season {
+  --icon-g1: #2f5d8a; /* steel blue */
+  --icon-g2: #4a7ba6; /* harbor blue */
+  --icon-g3: #5f9ea0; /* sea-glass teal */
+  --icon-g4: #6d7f93; /* slate */
+  --icon-g5: #3f6e7e; /* deep teal */
+  --icon-g6: #2f5d8a; /* steel blue (loop) */
+}
+
+/* "Fiesta" logo word — steel-to-sea-glass gradient, inked one shade
+   deeper than the icon ramp: the light sidebar animates coastal-slate
+   stops under the wordmark, so every logo stop holds ≥1.5:1 against all
+   of them (lowest: #35707a at 1.67:1) where the mid-tone ramp would sink
+   into the slate. */
+.fathers-day-season .logo-fiesta-text {
+  background: linear-gradient(90deg, #2f5d8a, #3d6b96, #35707a, #55677a, #2f5d8a);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+/* Light mode sidebar: coastal slate gradient stops (mechanics unchanged) */
+.fathers-day-season:not(.dark) .sidebar-gradient,
+.fathers-day-season:not(.dark) .sidebar-gradient-horizontal {
+  --sidebar-fiesta-red: #8aa7c4; /* steel blue */
+  --sidebar-fiesta-orange: #9bc0ba; /* sea glass */
+  --sidebar-fiesta-purple: #7d8ea3; /* slate */
+}
+
+/* Dark mode sidebar: deep harbor-slate base; aurora provides the color */
+.dark.fathers-day-season .sidebar-gradient,
+.dark.fathers-day-season .sidebar-gradient-horizontal {
+  background: #0d141c;
+  animation: none;
+  color: oklch(1 0 0);
+  --sidebar-foreground: oklch(1 0 0);
+  --sidebar-accent: oklch(1 0 0 / 14%);
+  --sidebar-accent-foreground: oklch(1 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --foreground: oklch(1 0 0);
+  --muted-foreground: oklch(1 0 0 / 75%);
+}
+
+/* Reduced motion: authored here rather than inherited — these selectors
+   out-specific the base .sidebar-gradient rules in theme.css, so a future
+   edit that re-declares animation above would silently escape the base
+   @media block. Keeping the guard in-file makes that impossible. */
+@media (prefers-reduced-motion: reduce) {
+  .fathers-day-season .sidebar-gradient,
+  .fathers-day-season .sidebar-gradient-horizontal {
+    animation: none;
+  }
+}

package/dist/seasons/halloween.css

@@ -0,0 +1,69 @@
+/* halloween — draft seasonal theme. Styles activate only when the
+   .halloween-season class is stamped on <html> (Storybook Season selector).
+   Not consulted by getActiveSeason() until promoted to SEASONS.
+
+   Design intent: jack-o'-lantern glow in a haunted night — pumpkin orange
+   burning into witch purple with a flicker of eerie green, all set against
+   a near-black purple-tinged dark base so the aurora reads like fog. */
+
+/* Logo: deep ember igniting into candle glow, a toxic-green flicker, then
+   dying into witch purple. Stops are split deep/bright on purpose: the
+   light sidebar animates all three stops under the wordmark, so every stop
+   holds ≥1.5:1 against all of them (lowest: #7c3aed at 1.57:1) while the
+   bright stops keep the glow on the dark base. */
+.halloween-season .logo-fiesta-text {
+  background: linear-gradient(90deg, #a33b00, #ffc274, #7de394, #7c3aed, #56189e);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+/* Page-icon gradient: ember orange through toxic green into deep purple —
+   the vivid ramp (mirrored by colors[] for the aurora/confetti); the logo
+   uses deep/bright variants of the same hues for sidebar legibility. */
+.halloween-season {
+  --icon-g1: #ff7518;
+  --icon-g2: #ff9838;
+  --icon-g3: #39d353;
+  --icon-g4: #a855f7;
+  --icon-g5: #7c3aed;
+  --icon-g6: #6a0dad;
+}
+
+/* Dark mode sidebar: flat near-black with a purple cast — the WebGL aurora
+   (pumpkin/purple/green palette) supplies the movement. */
+.dark.halloween-season .sidebar-gradient,
+.dark.halloween-season .sidebar-gradient-horizontal {
+  background: #140b1c;
+  animation: none;
+  color: oklch(1 0 0);
+  --sidebar-foreground: oklch(1 0 0);
+  --sidebar-accent: oklch(1 0 0 / 14%);
+  --sidebar-accent-foreground: oklch(1 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --foreground: oklch(1 0 0);
+  --muted-foreground: oklch(1 0 0 / 75%);
+}
+
+/* Light mode sidebar: retint the flowing gradient stops to vivid pumpkin,
+   bright marigold, and lavender-purple — orange-into-purple is the
+   Halloween signature, and dropping the earlier khaki-amber middle keeps
+   it distinct from Thanksgiving's harvest sidebar. Black text verified
+   ≥4.5:1 on all three stops; the lowest is #9d76c2 at 5.80:1. */
+.halloween-season:not(.dark) .sidebar-gradient,
+.halloween-season:not(.dark) .sidebar-gradient-horizontal {
+  --sidebar-fiesta-red: #cd7435;
+  --sidebar-fiesta-orange: #dd9040;
+  --sidebar-fiesta-purple: #9d76c2;
+}
+
+/* Reduced motion: authored here rather than inherited — these selectors
+   out-specific the base .sidebar-gradient rules in theme.css, so a future
+   edit that re-declares animation above would silently escape the base
+   @media block. Keeping the guard in-file makes that impossible. */
+@media (prefers-reduced-motion: reduce) {
+  .halloween-season .sidebar-gradient,
+  .halloween-season .sidebar-gradient-horizontal {
+    animation: none;
+  }
+}