@just-web/toolkits 1.0.0

package/dist/theme/theme-entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-entry.cjs","names":[],"sources":["../../src/theme/theme-entry.ts"],"sourcesContent":["import type { ThemeEntry } from './theme-entry.types.ts'\nimport type { ThemeMap } from './theme-map.types.ts'\n\n/** Creates ThemeEntry from theme map and theme key. */\nexport function themeEntry<Themes extends ThemeMap>(\n\tthemes: Themes,\n\ttheme: keyof Themes\n): ThemeEntry<Themes> {\n\treturn { theme, value: themes[theme] }\n}\n"],"mappings":";;;AAIA,SAAgB,WACf,QACA,OACqB;AACrB,QAAO;EAAE;EAAO,OAAO,OAAO;EAAQ"}

package/dist/theme/theme-entry.d.cts

@@ -0,0 +1,9 @@
+import { ThemeMap } from "./theme-map.types.cjs";
+import { ThemeEntry } from "./theme-entry.types.cjs";
+
+//#region src/theme/theme-entry.d.ts
+/** Creates ThemeEntry from theme map and theme key. */
+declare function themeEntry<Themes extends ThemeMap>(themes: Themes, theme: keyof Themes): ThemeEntry<Themes>;
+//#endregion
+export { themeEntry };
+//# sourceMappingURL=theme-entry.d.cts.map

package/dist/theme/theme-entry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-entry.d.cts","names":[],"sources":["../../src/theme/theme-entry.ts"],"sourcesContent":[],"mappings":";;;;;iBAIgB,0BAA0B,kBACjC,qBACK,SACX,WAAW"}

package/dist/theme/theme-entry.d.mts

@@ -0,0 +1,9 @@
+import { ThemeMap } from "./theme-map.types.mjs";
+import { ThemeEntry } from "./theme-entry.types.mjs";
+
+//#region src/theme/theme-entry.d.ts
+/** Creates ThemeEntry from theme map and theme key. */
+declare function themeEntry<Themes extends ThemeMap>(themes: Themes, theme: keyof Themes): ThemeEntry<Themes>;
+//#endregion
+export { themeEntry };
+//# sourceMappingURL=theme-entry.d.mts.map

package/dist/theme/theme-entry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-entry.d.mts","names":[],"sources":["../../src/theme/theme-entry.ts"],"sourcesContent":[],"mappings":";;;;;iBAIgB,0BAA0B,kBACjC,qBACK,SACX,WAAW"}

package/dist/theme/theme-entry.mjs

@@ -0,0 +1,12 @@
+//#region src/theme/theme-entry.ts
+/** Creates ThemeEntry from theme map and theme key. */
+function themeEntry(themes, theme) {
+	return {
+		theme,
+		value: themes[theme]
+	};
+}
+
+//#endregion
+export { themeEntry };
+//# sourceMappingURL=theme-entry.mjs.map

package/dist/theme/theme-entry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-entry.mjs","names":[],"sources":["../../src/theme/theme-entry.ts"],"sourcesContent":["import type { ThemeEntry } from './theme-entry.types.ts'\nimport type { ThemeMap } from './theme-map.types.ts'\n\n/** Creates ThemeEntry from theme map and theme key. */\nexport function themeEntry<Themes extends ThemeMap>(\n\tthemes: Themes,\n\ttheme: keyof Themes\n): ThemeEntry<Themes> {\n\treturn { theme, value: themes[theme] }\n}\n"],"mappings":";;AAIA,SAAgB,WACf,QACA,OACqB;AACrB,QAAO;EAAE;EAAO,OAAO,OAAO;EAAQ"}

package/dist/theme/theme-entry.types.d.cts

@@ -0,0 +1,16 @@
+import { ThemeMap } from "./theme-map.types.cjs";
+
+//#region src/theme/theme-entry.types.d.ts
+
+/**
+ * Theme entry is a pair of theme key and theme value.
+ *
+ * It is the basic value persisted by the theme stores.
+ */
+interface ThemeEntry<Themes extends ThemeMap = ThemeMap> {
+  theme: keyof Themes;
+  value: Themes[keyof Themes];
+}
+//#endregion
+export { ThemeEntry };
+//# sourceMappingURL=theme-entry.types.d.cts.map

package/dist/theme/theme-entry.types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-entry.types.d.cts","names":[],"sources":["../../src/theme/theme-entry.types.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;;;AACc,UADG,UACH,CAAA,eAD6B,QAC7B,GADwC,QACxC,CAAA,CAAA;EACN,KAAA,EAAA,MADM,MACN;EAAa,KAAA,EAAb,MAAa,CAAA,MAAA,MAAA,CAAA"}

package/dist/theme/theme-entry.types.d.mts

@@ -0,0 +1,16 @@
+import { ThemeMap } from "./theme-map.types.mjs";
+
+//#region src/theme/theme-entry.types.d.ts
+
+/**
+ * Theme entry is a pair of theme key and theme value.
+ *
+ * It is the basic value persisted by the theme stores.
+ */
+interface ThemeEntry<Themes extends ThemeMap = ThemeMap> {
+  theme: keyof Themes;
+  value: Themes[keyof Themes];
+}
+//#endregion
+export { ThemeEntry };
+//# sourceMappingURL=theme-entry.types.d.mts.map

package/dist/theme/theme-entry.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-entry.types.d.mts","names":[],"sources":["../../src/theme/theme-entry.types.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;;;AACc,UADG,UACH,CAAA,eAD6B,QAC7B,GADwC,QACxC,CAAA,CAAA;EACN,KAAA,EAAA,MADM,MACN;EAAa,KAAA,EAAb,MAAa,CAAA,MAAA,MAAA,CAAA"}

package/dist/theme/theme-map.types.d.cts

@@ -0,0 +1,10 @@
+//#region src/theme/theme-map.types.d.ts
+/**
+ * Record mapping theme keys to their values.
+ * Each value can be a single string or readonly string[] (e.g. multiple CSS classes).
+ * Used by all ThemeStore factories via the themes option.
+ */
+type ThemeMap<Theme extends string = string> = Record<Theme, string | readonly string[]>;
+//#endregion
+export { ThemeMap };
+//# sourceMappingURL=theme-map.types.d.cts.map

package/dist/theme/theme-map.types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-map.types.d.cts","names":[],"sources":["../../src/theme/theme-map.types.ts"],"sourcesContent":[],"mappings":";;AAKA;;;;KAAY,0CAA0C,OAAO"}

package/dist/theme/theme-map.types.d.mts

@@ -0,0 +1,10 @@
+//#region src/theme/theme-map.types.d.ts
+/**
+ * Record mapping theme keys to their values.
+ * Each value can be a single string or readonly string[] (e.g. multiple CSS classes).
+ * Used by all ThemeStore factories via the themes option.
+ */
+type ThemeMap<Theme extends string = string> = Record<Theme, string | readonly string[]>;
+//#endregion
+export { ThemeMap };
+//# sourceMappingURL=theme-map.types.d.mts.map

package/dist/theme/theme-map.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-map.types.d.mts","names":[],"sources":["../../src/theme/theme-map.types.ts"],"sourcesContent":[],"mappings":";;AAKA;;;;KAAY,0CAA0C,OAAO"}

package/dist/theme/theme-store/async-theme-store.types.d.cts

@@ -0,0 +1,25 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/theme-store/async-theme-store.types.d.ts
+
+/**
+ * Async variant of `ThemeStore` where read and write may return promises.
+ * Use for remote persistence, polling, or WebSocket-based sync.
+ *
+ * Same optional methods as `ThemeStore`:
+ *
+ * - **read** – Can return `Promise<ThemeEntry | undefined>` for async sources
+ * - **write** – Can return `Promise<void>` for async persistence
+ * - **subscribe** – Same signature as sync; observes external changes
+ *
+ * @typeParam Themes - Map of theme keys to their value types (string or readonly string[])
+ */
+interface AsyncThemeStore<Themes extends ThemeMap = ThemeMap> {
+  read?: (() => ThemeEntry<Themes> | undefined | Promise<ThemeEntry<Themes> | undefined>) | undefined;
+  write?: ((entry: ThemeEntry<Themes> | undefined) => void | Promise<void>) | undefined;
+  subscribe?: ((handler: (entry: ThemeEntry<Themes> | undefined | null) => void) => () => void) | undefined;
+}
+//#endregion
+export { AsyncThemeStore };
+//# sourceMappingURL=async-theme-store.types.d.cts.map

package/dist/theme/theme-store/async-theme-store.types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-theme-store.types.d.cts","names":[],"sources":["../../../src/theme/theme-store/async-theme-store.types.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;;;;AAI4D,UAJ3C,eAI2C,CAAA,eAJZ,QAIY,GAJD,QAIC,CAAA,CAAA;EAE1B,IAAA,CAAA,EAAA,CAAA,GAAA,GAJvB,UAIuB,CAJZ,MAIY,CAAA,GAAA,SAAA,GAJU,OAIV,CAJkB,UAIlB,CAJ6B,MAI7B,CAAA,GAAA,SAAA,CAAA,CAAA,GAAA,SAAA;EAAX,KAAA,CAAA,EAAA,CAAA,CAAA,KAAA,EAFL,UAEK,CAFM,MAEN,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,GAFqC,OAErC,CAAA,IAAA,CAAA,CAAA,GAAA,SAAA;EAAU,SAAA,CAAA,EAAA,CAAA,CAAA,OAAA,EAAA,CAAA,KAAA,EAAV,UAAU,CAAC,MAAD,CAAA,GAAA,SAAA,GAAA,IAAA,EAAA,GAAA,IAAA,EAAA,GAAA,GAAA,GAAA,IAAA,CAAA,GAAA,SAAA"}

package/dist/theme/theme-store/async-theme-store.types.d.mts

@@ -0,0 +1,25 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/theme-store/async-theme-store.types.d.ts
+
+/**
+ * Async variant of `ThemeStore` where read and write may return promises.
+ * Use for remote persistence, polling, or WebSocket-based sync.
+ *
+ * Same optional methods as `ThemeStore`:
+ *
+ * - **read** – Can return `Promise<ThemeEntry | undefined>` for async sources
+ * - **write** – Can return `Promise<void>` for async persistence
+ * - **subscribe** – Same signature as sync; observes external changes
+ *
+ * @typeParam Themes - Map of theme keys to their value types (string or readonly string[])
+ */
+interface AsyncThemeStore<Themes extends ThemeMap = ThemeMap> {
+  read?: (() => ThemeEntry<Themes> | undefined | Promise<ThemeEntry<Themes> | undefined>) | undefined;
+  write?: ((entry: ThemeEntry<Themes> | undefined) => void | Promise<void>) | undefined;
+  subscribe?: ((handler: (entry: ThemeEntry<Themes> | undefined | null) => void) => () => void) | undefined;
+}
+//#endregion
+export { AsyncThemeStore };
+//# sourceMappingURL=async-theme-store.types.d.mts.map

package/dist/theme/theme-store/async-theme-store.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-theme-store.types.d.mts","names":[],"sources":["../../../src/theme/theme-store/async-theme-store.types.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;;;;AAI4D,UAJ3C,eAI2C,CAAA,eAJZ,QAIY,GAJD,QAIC,CAAA,CAAA;EAE1B,IAAA,CAAA,EAAA,CAAA,GAAA,GAJvB,UAIuB,CAJZ,MAIY,CAAA,GAAA,SAAA,GAJU,OAIV,CAJkB,UAIlB,CAJ6B,MAI7B,CAAA,GAAA,SAAA,CAAA,CAAA,GAAA,SAAA;EAAX,KAAA,CAAA,EAAA,CAAA,CAAA,KAAA,EAFL,UAEK,CAFM,MAEN,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,GAFqC,OAErC,CAAA,IAAA,CAAA,CAAA,GAAA,SAAA;EAAU,SAAA,CAAA,EAAA,CAAA,CAAA,OAAA,EAAA,CAAA,KAAA,EAAV,UAAU,CAAC,MAAD,CAAA,GAAA,SAAA,GAAA,IAAA,EAAA,GAAA,IAAA,EAAA,GAAA,GAAA,GAAA,IAAA,CAAA,GAAA,SAAA"}

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.cjs

@@ -0,0 +1,53 @@
+const require_observe_attribute = require('../../../attributes/observe-attribute.cjs');
+const require_resolve_theme_from_class_name = require('../../class-name/resolve-theme-from-class-name.cjs');
+const require_theme_entry = require('../../theme-entry.cjs');
+const require_dummy_theme_store = require('../../../testing/theme/dummy-theme-store.cjs');
+const require_apply_theme_to_class_name = require('../../class-name/apply-theme-to-class-name.cjs');
+
+//#region src/theme/theme-store/class-name-theme-store/class-name-theme-store.ts
+/**
+* Creates a theme store that reads and writes via element class names.
+*
+* @param themes - Record mapping theme keys to class name(s)
+* @param options.element - Element to operate on (defaults to document.documentElement)
+* @returns ThemeStore
+*
+* @example
+* ```ts
+* const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }
+* const store = classNameThemeStore(themes)
+* store.read() // returns themeResult from element.className
+* store.write(themeEntry(themes, 'grayscale'))
+* store.subscribe((themeResult) => {})
+* ```
+*/
+function classNameThemeStore(themes, options) {
+	const element = options?.element ?? document?.documentElement;
+	if (!element) return require_dummy_theme_store.dummyThemeStore;
+	return {
+		read() {
+			const theme = require_resolve_theme_from_class_name.resolveThemeFromClassName(themes, element.className);
+			if (theme === void 0) return void 0;
+			return require_theme_entry.themeEntry(themes, theme);
+		},
+		write(entry) {
+			require_apply_theme_to_class_name.applyThemeToClassName(themes, element, entry);
+		},
+		subscribe(handler) {
+			let lastEmitted = null;
+			const observer = require_observe_attribute.observeAttributes({ class: (value) => {
+				const theme = value ? require_resolve_theme_from_class_name.resolveThemeFromClassName(themes, value) : void 0;
+				const entry = theme ? require_theme_entry.themeEntry(themes, theme) : void 0;
+				const key = theme ?? void 0;
+				if (lastEmitted === key) return;
+				lastEmitted = key;
+				handler(entry);
+			} }, element);
+			return () => observer.disconnect();
+		}
+	};
+}
+
+//#endregion
+exports.classNameThemeStore = classNameThemeStore;
+//# sourceMappingURL=class-name-theme-store.cjs.map

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name-theme-store.cjs","names":["dummyThemeStore","resolveThemeFromClassName","themeEntry","lastEmitted: keyof Themes | undefined | null","observeAttributes"],"sources":["../../../../src/theme/theme-store/class-name-theme-store/class-name-theme-store.ts"],"sourcesContent":["import type { Required } from 'type-plus'\nimport { observeAttributes } from '../../../attributes/observe-attribute.ts'\nimport { dummyThemeStore } from '../../../testing/theme/dummy-theme-store.ts'\nimport { applyThemeToClassName } from '../../class-name/apply-theme-to-class-name.ts'\nimport { resolveThemeFromClassName } from '../../class-name/resolve-theme-from-class-name.ts'\nimport { themeEntry } from '../../theme-entry.ts'\nimport type { ThemeMap } from '../../theme-map.types.ts'\nimport type { ThemeStore } from '../theme-store.types.ts'\n\n/**\n * Creates a theme store that reads and writes via element class names.\n *\n * @param themes - Record mapping theme keys to class name(s)\n * @param options.element - Element to operate on (defaults to document.documentElement)\n * @returns ThemeStore\n *\n * @example\n * ```ts\n * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }\n * const store = classNameThemeStore(themes)\n * store.read() // returns themeResult from element.className\n * store.write(themeEntry(themes, 'grayscale'))\n * store.subscribe((themeResult) => {})\n * ```\n */\nexport function classNameThemeStore<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions?: { element?: Element | undefined }\n): Required<ThemeStore<Themes>> {\n\tconst element = options?.element ?? document?.documentElement\n\n\tif (!element) return dummyThemeStore\n\n\treturn {\n\t\tread() {\n\t\t\tconst theme = resolveThemeFromClassName(themes, element.className)\n\t\t\tif (theme === undefined) return undefined\n\t\t\treturn themeEntry(themes, theme)\n\t\t},\n\t\twrite(entry) {\n\t\t\tapplyThemeToClassName(themes, element, entry)\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\tlet lastEmitted: keyof Themes | undefined | null = null\n\t\t\tconst observer = observeAttributes(\n\t\t\t\t{\n\t\t\t\t\tclass: (value) => {\n\t\t\t\t\t\tconst theme = value ? resolveThemeFromClassName(themes, value) : undefined\n\t\t\t\t\t\tconst entry = theme ? themeEntry(themes, theme) : undefined\n\t\t\t\t\t\tconst key = theme ?? undefined\n\n\t\t\t\t\t\tif (lastEmitted === key) return\n\t\t\t\t\t\tlastEmitted = key\n\t\t\t\t\t\thandler(entry)\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\telement\n\t\t\t)\n\t\t\treturn () => observer.disconnect()\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,oBACf,QACA,SAC+B;CAC/B,MAAM,UAAU,SAAS,WAAW,UAAU;AAE9C,KAAI,CAAC,QAAS,QAAOA;AAErB,QAAO;EACN,OAAO;GACN,MAAM,QAAQC,gEAA0B,QAAQ,QAAQ,UAAU;AAClE,OAAI,UAAU,OAAW,QAAO;AAChC,UAAOC,+BAAW,QAAQ,MAAM;;EAEjC,MAAM,OAAO;AACZ,2DAAsB,QAAQ,SAAS,MAAM;;EAE9C,UAAU,SAAS;GAClB,IAAIC,cAA+C;GACnD,MAAM,WAAWC,4CAChB,EACC,QAAQ,UAAU;IACjB,MAAM,QAAQ,QAAQH,gEAA0B,QAAQ,MAAM,GAAG;IACjE,MAAM,QAAQ,QAAQC,+BAAW,QAAQ,MAAM,GAAG;IAClD,MAAM,MAAM,SAAS;AAErB,QAAI,gBAAgB,IAAK;AACzB,kBAAc;AACd,YAAQ,MAAM;MAEf,EACD,QACA;AACD,gBAAa,SAAS,YAAY;;EAEnC"}

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.d.cts

@@ -0,0 +1,28 @@
+import { ThemeMap } from "../../theme-map.types.cjs";
+import { ThemeStore } from "../theme-store.types.cjs";
+import { Required } from "type-plus";
+
+//#region src/theme/theme-store/class-name-theme-store/class-name-theme-store.d.ts
+
+/**
+ * Creates a theme store that reads and writes via element class names.
+ *
+ * @param themes - Record mapping theme keys to class name(s)
+ * @param options.element - Element to operate on (defaults to document.documentElement)
+ * @returns ThemeStore
+ *
+ * @example
+ * ```ts
+ * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }
+ * const store = classNameThemeStore(themes)
+ * store.read() // returns themeResult from element.className
+ * store.write(themeEntry(themes, 'grayscale'))
+ * store.subscribe((themeResult) => {})
+ * ```
+ */
+declare function classNameThemeStore<Themes extends ThemeMap>(themes: Themes, options?: {
+  element?: Element | undefined;
+}): Required<ThemeStore<Themes>>;
+//#endregion
+export { classNameThemeStore };
+//# sourceMappingURL=class-name-theme-store.d.cts.map

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name-theme-store.d.cts","names":[],"sources":["../../../../src/theme/theme-store/class-name-theme-store/class-name-theme-store.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAyBA;;;;;;;;;;;;;;iBAAgB,mCAAmC,kBAC1C;YACc;IACpB,SAAS,WAAW"}

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.d.mts

@@ -0,0 +1,28 @@
+import { ThemeMap } from "../../theme-map.types.mjs";
+import { ThemeStore } from "../theme-store.types.mjs";
+import { Required } from "type-plus";
+
+//#region src/theme/theme-store/class-name-theme-store/class-name-theme-store.d.ts
+
+/**
+ * Creates a theme store that reads and writes via element class names.
+ *
+ * @param themes - Record mapping theme keys to class name(s)
+ * @param options.element - Element to operate on (defaults to document.documentElement)
+ * @returns ThemeStore
+ *
+ * @example
+ * ```ts
+ * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }
+ * const store = classNameThemeStore(themes)
+ * store.read() // returns themeResult from element.className
+ * store.write(themeEntry(themes, 'grayscale'))
+ * store.subscribe((themeResult) => {})
+ * ```
+ */
+declare function classNameThemeStore<Themes extends ThemeMap>(themes: Themes, options?: {
+  element?: Element | undefined;
+}): Required<ThemeStore<Themes>>;
+//#endregion
+export { classNameThemeStore };
+//# sourceMappingURL=class-name-theme-store.d.mts.map

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name-theme-store.d.mts","names":[],"sources":["../../../../src/theme/theme-store/class-name-theme-store/class-name-theme-store.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAyBA;;;;;;;;;;;;;;iBAAgB,mCAAmC,kBAC1C;YACc;IACpB,SAAS,WAAW"}

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.mjs

@@ -0,0 +1,53 @@
+import { observeAttributes } from "../../../attributes/observe-attribute.mjs";
+import { resolveThemeFromClassName } from "../../class-name/resolve-theme-from-class-name.mjs";
+import { themeEntry } from "../../theme-entry.mjs";
+import { dummyThemeStore } from "../../../testing/theme/dummy-theme-store.mjs";
+import { applyThemeToClassName } from "../../class-name/apply-theme-to-class-name.mjs";
+
+//#region src/theme/theme-store/class-name-theme-store/class-name-theme-store.ts
+/**
+* Creates a theme store that reads and writes via element class names.
+*
+* @param themes - Record mapping theme keys to class name(s)
+* @param options.element - Element to operate on (defaults to document.documentElement)
+* @returns ThemeStore
+*
+* @example
+* ```ts
+* const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }
+* const store = classNameThemeStore(themes)
+* store.read() // returns themeResult from element.className
+* store.write(themeEntry(themes, 'grayscale'))
+* store.subscribe((themeResult) => {})
+* ```
+*/
+function classNameThemeStore(themes, options) {
+	const element = options?.element ?? document?.documentElement;
+	if (!element) return dummyThemeStore;
+	return {
+		read() {
+			const theme = resolveThemeFromClassName(themes, element.className);
+			if (theme === void 0) return void 0;
+			return themeEntry(themes, theme);
+		},
+		write(entry) {
+			applyThemeToClassName(themes, element, entry);
+		},
+		subscribe(handler) {
+			let lastEmitted = null;
+			const observer = observeAttributes({ class: (value) => {
+				const theme = value ? resolveThemeFromClassName(themes, value) : void 0;
+				const entry = theme ? themeEntry(themes, theme) : void 0;
+				const key = theme ?? void 0;
+				if (lastEmitted === key) return;
+				lastEmitted = key;
+				handler(entry);
+			} }, element);
+			return () => observer.disconnect();
+		}
+	};
+}
+
+//#endregion
+export { classNameThemeStore };
+//# sourceMappingURL=class-name-theme-store.mjs.map

package/dist/theme/theme-store/class-name-theme-store/class-name-theme-store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name-theme-store.mjs","names":["lastEmitted: keyof Themes | undefined | null"],"sources":["../../../../src/theme/theme-store/class-name-theme-store/class-name-theme-store.ts"],"sourcesContent":["import type { Required } from 'type-plus'\nimport { observeAttributes } from '../../../attributes/observe-attribute.ts'\nimport { dummyThemeStore } from '../../../testing/theme/dummy-theme-store.ts'\nimport { applyThemeToClassName } from '../../class-name/apply-theme-to-class-name.ts'\nimport { resolveThemeFromClassName } from '../../class-name/resolve-theme-from-class-name.ts'\nimport { themeEntry } from '../../theme-entry.ts'\nimport type { ThemeMap } from '../../theme-map.types.ts'\nimport type { ThemeStore } from '../theme-store.types.ts'\n\n/**\n * Creates a theme store that reads and writes via element class names.\n *\n * @param themes - Record mapping theme keys to class name(s)\n * @param options.element - Element to operate on (defaults to document.documentElement)\n * @returns ThemeStore\n *\n * @example\n * ```ts\n * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }\n * const store = classNameThemeStore(themes)\n * store.read() // returns themeResult from element.className\n * store.write(themeEntry(themes, 'grayscale'))\n * store.subscribe((themeResult) => {})\n * ```\n */\nexport function classNameThemeStore<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions?: { element?: Element | undefined }\n): Required<ThemeStore<Themes>> {\n\tconst element = options?.element ?? document?.documentElement\n\n\tif (!element) return dummyThemeStore\n\n\treturn {\n\t\tread() {\n\t\t\tconst theme = resolveThemeFromClassName(themes, element.className)\n\t\t\tif (theme === undefined) return undefined\n\t\t\treturn themeEntry(themes, theme)\n\t\t},\n\t\twrite(entry) {\n\t\t\tapplyThemeToClassName(themes, element, entry)\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\tlet lastEmitted: keyof Themes | undefined | null = null\n\t\t\tconst observer = observeAttributes(\n\t\t\t\t{\n\t\t\t\t\tclass: (value) => {\n\t\t\t\t\t\tconst theme = value ? resolveThemeFromClassName(themes, value) : undefined\n\t\t\t\t\t\tconst entry = theme ? themeEntry(themes, theme) : undefined\n\t\t\t\t\t\tconst key = theme ?? undefined\n\n\t\t\t\t\t\tif (lastEmitted === key) return\n\t\t\t\t\t\tlastEmitted = key\n\t\t\t\t\t\thandler(entry)\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\telement\n\t\t\t)\n\t\t\treturn () => observer.disconnect()\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,oBACf,QACA,SAC+B;CAC/B,MAAM,UAAU,SAAS,WAAW,UAAU;AAE9C,KAAI,CAAC,QAAS,QAAO;AAErB,QAAO;EACN,OAAO;GACN,MAAM,QAAQ,0BAA0B,QAAQ,QAAQ,UAAU;AAClE,OAAI,UAAU,OAAW,QAAO;AAChC,UAAO,WAAW,QAAQ,MAAM;;EAEjC,MAAM,OAAO;AACZ,yBAAsB,QAAQ,SAAS,MAAM;;EAE9C,UAAU,SAAS;GAClB,IAAIA,cAA+C;GACnD,MAAM,WAAW,kBAChB,EACC,QAAQ,UAAU;IACjB,MAAM,QAAQ,QAAQ,0BAA0B,QAAQ,MAAM,GAAG;IACjE,MAAM,QAAQ,QAAQ,WAAW,QAAQ,MAAM,GAAG;IAClD,MAAM,MAAM,SAAS;AAErB,QAAI,gBAAgB,IAAK;AACzB,kBAAc;AACd,YAAQ,MAAM;MAEf,EACD,QACA;AACD,gBAAa,SAAS,YAAY;;EAEnC"}

package/dist/theme/theme-store/cookie-theme-store/cookie-theme-store.cjs

@@ -0,0 +1,121 @@
+const require_theme_entry = require('../../theme-entry.cjs');
+const require_dummy_theme_store = require('../../../testing/theme/dummy-theme-store.cjs');
+const require_parse_stored_theme = require('../../_utils/parse-stored-theme.cjs');
+
+//#region src/theme/theme-store/cookie-theme-store/cookie-theme-store.ts
+function getCookieValue(name) {
+	if (typeof document === "undefined" || !document.cookie) return null;
+	const value = document.cookie.match(/* @__PURE__ */ new RegExp(`(?:^|;\\s*)${name}=([^;]*)`))?.[1];
+	return value !== void 0 ? decodeURIComponent(value) : null;
+}
+function setCookie(name, value, options) {
+	const parts = [`${name}=${encodeURIComponent(value)}`];
+	parts.push(`path=${options.path ?? "/"}`);
+	if (options.maxAge !== void 0) parts.push(`max-age=${options.maxAge}`);
+	if (options.sameSite !== void 0) parts.push(`samesite=${options.sameSite}`);
+	if (options.secure) parts.push("secure");
+	document.cookie = parts.join("; ");
+}
+function deleteCookie(name, path = "/") {
+	document.cookie = `${name}=; path=${path}; max-age=0`;
+}
+/**
+* Creates a theme store backed by cookies.
+*
+* Persists across sessions. Cookies are sent with every request, so the server can
+* read the theme during SSR to avoid flash of wrong theme. Cross-tab sync is not
+* supported (cookies have no StorageEvent).
+*
+* @param themes - Record mapping theme keys to values (for validation)
+* @param options.cookieName - Cookie name for theme storage
+* @param options.path - Cookie path (default: '/')
+* @param options.maxAge - Cookie max-age in seconds
+* @param options.sameSite - Cookie sameSite attribute
+* @param options.secure - Cookie secure attribute
+* @returns ThemeStore
+*
+* @example
+* ```ts
+* const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }
+* const store = cookieThemeStore(themes, { cookieName: 'theme' })
+* store.read()
+* store.write(themeEntry(themes, 'grayscale'))
+* store.subscribe((themeResult) => {})
+* ```
+*/
+function cookieThemeStore(themes, options) {
+	const { cookieName, path = "/", maxAge, sameSite, secure } = options;
+	if (document.cookie === void 0) return require_dummy_theme_store.dummyThemeStore;
+	const handlers = /* @__PURE__ */ new Set();
+	let lastNotifiedKey = read()?.theme ?? void 0;
+	function read() {
+		const theme = require_parse_stored_theme.parseStoredTheme(themes, getCookieValue(cookieName));
+		if (theme === void 0) return void 0;
+		return require_theme_entry.themeEntry(themes, theme);
+	}
+	function notify() {
+		const result = read();
+		const key = result?.theme ?? void 0;
+		if (key === lastNotifiedKey) return;
+		lastNotifiedKey = key;
+		for (const h of handlers) h(result);
+	}
+	return {
+		read,
+		write(entry) {
+			try {
+				if (entry === void 0) deleteCookie(cookieName, path);
+				else {
+					const opts = { path };
+					if (maxAge !== void 0) opts.maxAge = maxAge;
+					if (sameSite !== void 0) opts.sameSite = sameSite;
+					if (secure) opts.secure = true;
+					setCookie(cookieName, JSON.stringify(entry), opts);
+				}
+				notify();
+			} catch {}
+		},
+		subscribe(handler) {
+			handlers.add(handler);
+			return () => {
+				handlers.delete(handler);
+			};
+		}
+	};
+}
+function getCookieFromHeader(cookieHeader, name) {
+	const value = cookieHeader.match(/* @__PURE__ */ new RegExp(`(?:^|;\\s*)${name}=([^;]*)`))?.[1];
+	return value !== void 0 ? decodeURIComponent(value.trim()) : null;
+}
+/**
+* Reads the theme from cookies during SSR. Use with the request's Cookie header or
+* a framework's cookie API (e.g. Next.js cookies()).
+*
+* @param cookieSource - Raw Cookie header string, or a getter (name) => value for framework APIs
+* @param themes - Record mapping theme keys to values (for validation)
+* @param options - Optional cookie name (default: 'theme')
+* @returns ThemeEntry if valid cookie found, otherwise undefined
+*
+* @example
+* ```ts
+* // With raw Cookie header (Express, Remix, etc.)
+* const theme = getThemeFromCookie(request.headers.get('Cookie') ?? '', themes)
+*
+* // With Next.js cookies()
+* const theme = getThemeFromCookie(
+*   (name) => cookies().get(name)?.value ?? undefined,
+*   themes
+* )
+* ```
+*/
+function getThemeFromCookie(cookieSource, themes, options = {}) {
+	const cookieName = options.cookieName ?? "theme";
+	const theme = require_parse_stored_theme.parseStoredTheme(themes, typeof cookieSource === "function" ? cookieSource(cookieName) ?? null : cookieSource ? getCookieFromHeader(cookieSource, cookieName) : null);
+	if (theme === void 0) return void 0;
+	return require_theme_entry.themeEntry(themes, theme);
+}
+
+//#endregion
+exports.cookieThemeStore = cookieThemeStore;
+exports.getThemeFromCookie = getThemeFromCookie;
+//# sourceMappingURL=cookie-theme-store.cjs.map

package/dist/theme/theme-store/cookie-theme-store/cookie-theme-store.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-theme-store.cjs","names":["dummyThemeStore","lastNotifiedKey: keyof Themes | undefined","parseStoredTheme","themeEntry","opts: {\n\t\t\t\t\t\tpath: string\n\t\t\t\t\t\tmaxAge?: number\n\t\t\t\t\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\t\t\t\t\tsecure?: boolean\n\t\t\t\t\t}"],"sources":["../../../../src/theme/theme-store/cookie-theme-store/cookie-theme-store.ts"],"sourcesContent":["import type { Required } from 'type-plus'\nimport { dummyThemeStore } from '../../../testing/theme/dummy-theme-store.ts'\nimport { parseStoredTheme } from '../../_utils/parse-stored-theme.ts'\nimport { themeEntry } from '../../theme-entry.ts'\nimport type { ThemeEntry } from '../../theme-entry.types.ts'\nimport type { ThemeMap } from '../../theme-map.types.ts'\nimport type { ThemeStore } from '../theme-store.types.ts'\n\nexport interface CookieThemeStoreOptions {\n\tcookieName: string\n\tpath?: string | undefined\n\tmaxAge?: number | undefined\n\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\tsecure?: boolean | undefined\n}\n\nfunction getCookieValue(name: string): string | null {\n\tif (typeof document === 'undefined' || !document.cookie) return null\n\tconst match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`))\n\tconst value = match?.[1]\n\treturn value !== undefined ? decodeURIComponent(value) : null\n}\n\nfunction setCookie(\n\tname: string,\n\tvalue: string,\n\toptions: {\n\t\tpath?: string | undefined\n\t\tmaxAge?: number | undefined\n\t\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\t\tsecure?: boolean | undefined\n\t}\n) {\n\tconst parts = [`${name}=${encodeURIComponent(value)}`]\n\tparts.push(`path=${options.path ?? '/'}`)\n\tif (options.maxAge !== undefined) parts.push(`max-age=${options.maxAge}`)\n\tif (options.sameSite !== undefined) parts.push(`samesite=${options.sameSite}`)\n\tif (options.secure) parts.push('secure')\n\t// biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API has limited support; document.cookie is standard for theme persistence\n\tdocument.cookie = parts.join('; ')\n}\n\nfunction deleteCookie(name: string, path = '/') {\n\t// biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API has limited support; document.cookie is standard for theme persistence\n\tdocument.cookie = `${name}=; path=${path}; max-age=0`\n}\n\n/**\n * Creates a theme store backed by cookies.\n *\n * Persists across sessions. Cookies are sent with every request, so the server can\n * read the theme during SSR to avoid flash of wrong theme. Cross-tab sync is not\n * supported (cookies have no StorageEvent).\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options.cookieName - Cookie name for theme storage\n * @param options.path - Cookie path (default: '/')\n * @param options.maxAge - Cookie max-age in seconds\n * @param options.sameSite - Cookie sameSite attribute\n * @param options.secure - Cookie secure attribute\n * @returns ThemeStore\n *\n * @example\n * ```ts\n * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }\n * const store = cookieThemeStore(themes, { cookieName: 'theme' })\n * store.read()\n * store.write(themeEntry(themes, 'grayscale'))\n * store.subscribe((themeResult) => {})\n * ```\n */\nexport function cookieThemeStore<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions: CookieThemeStoreOptions\n): Required<ThemeStore<Themes>> {\n\tconst { cookieName, path = '/', maxAge, sameSite, secure } = options\n\n\tif (document.cookie === undefined) {\n\t\treturn dummyThemeStore\n\t}\n\n\tconst handlers = new Set<(theme: ThemeEntry<Themes> | undefined) => void>()\n\tlet lastNotifiedKey: keyof Themes | undefined = read()?.theme ?? undefined\n\n\tfunction read() {\n\t\tconst stored = getCookieValue(cookieName)\n\t\tconst theme = parseStoredTheme(themes, stored)\n\t\tif (theme === undefined) return undefined\n\t\treturn themeEntry(themes, theme)\n\t}\n\n\tfunction notify() {\n\t\tconst result = read()\n\t\tconst key = result?.theme ?? undefined\n\t\tif (key === lastNotifiedKey) return\n\t\tlastNotifiedKey = key\n\t\tfor (const h of handlers) h(result)\n\t}\n\n\treturn {\n\t\tread,\n\t\twrite(entry) {\n\t\t\ttry {\n\t\t\t\tif (entry === undefined) {\n\t\t\t\t\tdeleteCookie(cookieName, path)\n\t\t\t\t} else {\n\t\t\t\t\tconst opts: {\n\t\t\t\t\t\tpath: string\n\t\t\t\t\t\tmaxAge?: number\n\t\t\t\t\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\t\t\t\t\tsecure?: boolean\n\t\t\t\t\t} = { path }\n\t\t\t\t\tif (maxAge !== undefined) opts.maxAge = maxAge\n\t\t\t\t\tif (sameSite !== undefined) opts.sameSite = sameSite\n\t\t\t\t\tif (secure) opts.secure = true\n\t\t\t\t\tsetCookie(cookieName, JSON.stringify(entry), opts)\n\t\t\t\t}\n\t\t\t\tnotify()\n\t\t\t} catch {\n\t\t\t\t// Ignore quota or other errors\n\t\t\t}\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\thandlers.add(handler)\n\t\t\treturn () => {\n\t\t\t\thandlers.delete(handler)\n\t\t\t}\n\t\t}\n\t} satisfies ThemeStore<Themes>\n}\n\nfunction getCookieFromHeader(cookieHeader: string, name: string): string | null {\n\tconst match = cookieHeader.match(new RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`))\n\tconst value = match?.[1]\n\treturn value !== undefined ? decodeURIComponent(value.trim()) : null\n}\n\n/**\n * Reads the theme from cookies during SSR. Use with the request's Cookie header or\n * a framework's cookie API (e.g. Next.js cookies()).\n *\n * @param cookieSource - Raw Cookie header string, or a getter (name) => value for framework APIs\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options - Optional cookie name (default: 'theme')\n * @returns ThemeEntry if valid cookie found, otherwise undefined\n *\n * @example\n * ```ts\n * // With raw Cookie header (Express, Remix, etc.)\n * const theme = getThemeFromCookie(request.headers.get('Cookie') ?? '', themes)\n *\n * // With Next.js cookies()\n * const theme = getThemeFromCookie(\n *   (name) => cookies().get(name)?.value ?? undefined,\n *   themes\n * )\n * ```\n */\nexport function getThemeFromCookie<Themes extends ThemeMap>(\n\tcookieSource: string | null | undefined | ((name: string) => string | null | undefined),\n\tthemes: Themes,\n\toptions: { cookieName?: string | undefined } = {}\n): ThemeEntry<Themes> | undefined {\n\tconst cookieName = options.cookieName ?? 'theme'\n\tconst stored =\n\t\ttypeof cookieSource === 'function'\n\t\t\t? (cookieSource(cookieName) ?? null)\n\t\t\t: cookieSource\n\t\t\t\t? getCookieFromHeader(cookieSource, cookieName)\n\t\t\t\t: null\n\tconst theme = parseStoredTheme(themes, stored)\n\tif (theme === undefined) return undefined\n\treturn themeEntry(themes, theme)\n}\n"],"mappings":";;;;;AAgBA,SAAS,eAAe,MAA6B;AACpD,KAAI,OAAO,aAAa,eAAe,CAAC,SAAS,OAAQ,QAAO;CAEhE,MAAM,QADQ,SAAS,OAAO,sBAAM,IAAI,OAAO,cAAc,KAAK,UAAU,CAAC,GACvD;AACtB,QAAO,UAAU,SAAY,mBAAmB,MAAM,GAAG;;AAG1D,SAAS,UACR,MACA,OACA,SAMC;CACD,MAAM,QAAQ,CAAC,GAAG,KAAK,GAAG,mBAAmB,MAAM,GAAG;AACtD,OAAM,KAAK,QAAQ,QAAQ,QAAQ,MAAM;AACzC,KAAI,QAAQ,WAAW,OAAW,OAAM,KAAK,WAAW,QAAQ,SAAS;AACzE,KAAI,QAAQ,aAAa,OAAW,OAAM,KAAK,YAAY,QAAQ,WAAW;AAC9E,KAAI,QAAQ,OAAQ,OAAM,KAAK,SAAS;AAExC,UAAS,SAAS,MAAM,KAAK,KAAK;;AAGnC,SAAS,aAAa,MAAc,OAAO,KAAK;AAE/C,UAAS,SAAS,GAAG,KAAK,UAAU,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;AA2B1C,SAAgB,iBACf,QACA,SAC+B;CAC/B,MAAM,EAAE,YAAY,OAAO,KAAK,QAAQ,UAAU,WAAW;AAE7D,KAAI,SAAS,WAAW,OACvB,QAAOA;CAGR,MAAM,2BAAW,IAAI,KAAsD;CAC3E,IAAIC,kBAA4C,MAAM,EAAE,SAAS;CAEjE,SAAS,OAAO;EAEf,MAAM,QAAQC,4CAAiB,QADhB,eAAe,WAAW,CACK;AAC9C,MAAI,UAAU,OAAW,QAAO;AAChC,SAAOC,+BAAW,QAAQ,MAAM;;CAGjC,SAAS,SAAS;EACjB,MAAM,SAAS,MAAM;EACrB,MAAM,MAAM,QAAQ,SAAS;AAC7B,MAAI,QAAQ,gBAAiB;AAC7B,oBAAkB;AAClB,OAAK,MAAM,KAAK,SAAU,GAAE,OAAO;;AAGpC,QAAO;EACN;EACA,MAAM,OAAO;AACZ,OAAI;AACH,QAAI,UAAU,OACb,cAAa,YAAY,KAAK;SACxB;KACN,MAAMC,OAKF,EAAE,MAAM;AACZ,SAAI,WAAW,OAAW,MAAK,SAAS;AACxC,SAAI,aAAa,OAAW,MAAK,WAAW;AAC5C,SAAI,OAAQ,MAAK,SAAS;AAC1B,eAAU,YAAY,KAAK,UAAU,MAAM,EAAE,KAAK;;AAEnD,YAAQ;WACD;;EAIT,UAAU,SAAS;AAClB,YAAS,IAAI,QAAQ;AACrB,gBAAa;AACZ,aAAS,OAAO,QAAQ;;;EAG1B;;AAGF,SAAS,oBAAoB,cAAsB,MAA6B;CAE/E,MAAM,QADQ,aAAa,sBAAM,IAAI,OAAO,cAAc,KAAK,UAAU,CAAC,GACpD;AACtB,QAAO,UAAU,SAAY,mBAAmB,MAAM,MAAM,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;AAwBjE,SAAgB,mBACf,cACA,QACA,UAA+C,EAAE,EAChB;CACjC,MAAM,aAAa,QAAQ,cAAc;CAOzC,MAAM,QAAQF,4CAAiB,QAL9B,OAAO,iBAAiB,aACpB,aAAa,WAAW,IAAI,OAC7B,eACC,oBAAoB,cAAc,WAAW,GAC7C,KACyC;AAC9C,KAAI,UAAU,OAAW,QAAO;AAChC,QAAOC,+BAAW,QAAQ,MAAM"}

package/dist/theme/theme-store/cookie-theme-store/cookie-theme-store.d.cts

@@ -0,0 +1,65 @@
+import { ThemeMap } from "../../theme-map.types.cjs";
+import { ThemeEntry } from "../../theme-entry.types.cjs";
+import { ThemeStore } from "../theme-store.types.cjs";
+import { Required } from "type-plus";
+
+//#region src/theme/theme-store/cookie-theme-store/cookie-theme-store.d.ts
+interface CookieThemeStoreOptions {
+  cookieName: string;
+  path?: string | undefined;
+  maxAge?: number | undefined;
+  sameSite?: 'lax' | 'strict' | 'none' | undefined;
+  secure?: boolean | undefined;
+}
+/**
+ * Creates a theme store backed by cookies.
+ *
+ * Persists across sessions. Cookies are sent with every request, so the server can
+ * read the theme during SSR to avoid flash of wrong theme. Cross-tab sync is not
+ * supported (cookies have no StorageEvent).
+ *
+ * @param themes - Record mapping theme keys to values (for validation)
+ * @param options.cookieName - Cookie name for theme storage
+ * @param options.path - Cookie path (default: '/')
+ * @param options.maxAge - Cookie max-age in seconds
+ * @param options.sameSite - Cookie sameSite attribute
+ * @param options.secure - Cookie secure attribute
+ * @returns ThemeStore
+ *
+ * @example
+ * ```ts
+ * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }
+ * const store = cookieThemeStore(themes, { cookieName: 'theme' })
+ * store.read()
+ * store.write(themeEntry(themes, 'grayscale'))
+ * store.subscribe((themeResult) => {})
+ * ```
+ */
+declare function cookieThemeStore<Themes extends ThemeMap>(themes: Themes, options: CookieThemeStoreOptions): Required<ThemeStore<Themes>>;
+/**
+ * Reads the theme from cookies during SSR. Use with the request's Cookie header or
+ * a framework's cookie API (e.g. Next.js cookies()).
+ *
+ * @param cookieSource - Raw Cookie header string, or a getter (name) => value for framework APIs
+ * @param themes - Record mapping theme keys to values (for validation)
+ * @param options - Optional cookie name (default: 'theme')
+ * @returns ThemeEntry if valid cookie found, otherwise undefined
+ *
+ * @example
+ * ```ts
+ * // With raw Cookie header (Express, Remix, etc.)
+ * const theme = getThemeFromCookie(request.headers.get('Cookie') ?? '', themes)
+ *
+ * // With Next.js cookies()
+ * const theme = getThemeFromCookie(
+ *   (name) => cookies().get(name)?.value ?? undefined,
+ *   themes
+ * )
+ * ```
+ */
+declare function getThemeFromCookie<Themes extends ThemeMap>(cookieSource: string | null | undefined | ((name: string) => string | null | undefined), themes: Themes, options?: {
+  cookieName?: string | undefined;
+}): ThemeEntry<Themes> | undefined;
+//#endregion
+export { CookieThemeStoreOptions, cookieThemeStore, getThemeFromCookie };
+//# sourceMappingURL=cookie-theme-store.d.cts.map

package/dist/theme/theme-store/cookie-theme-store/cookie-theme-store.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-theme-store.d.cts","names":[],"sources":["../../../../src/theme/theme-store/cookie-theme-store/cookie-theme-store.ts"],"sourcesContent":[],"mappings":";;;;;;UAQiB,uBAAA;;EAAA,IAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EA+DD,MAAA,CAAA,EAAA,MAAA,GAAA,SAAgB;EAAgB,QAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,MAAA,GAAA,SAAA;EACvC,MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;;;;;AAsFT;;;;;;;;;;;;;;;;;;;;iBAvFgB,gCAAgC,kBACvC,iBACC,0BACP,SAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;iBAoFP,kCAAkC,2GAEzC;;IAEN,WAAW"}