@just-web/toolkits 1.0.0 → 2.1.0

package/dist/theme/prefers-color-scheme-theme/read-prefers-color-scheme-theme.mjs

@@ -0,0 +1,20 @@
+import { getPrefersColorScheme } from "../../color-scheme/get-prefers-color-scheme.mjs";
+import { themeEntry } from "../theme-entry.mjs";
+
+//#region src/theme/prefers-color-scheme-theme/read-prefers-color-scheme-theme.ts
+/**
+* Reads a theme entry from the system `prefers-color-scheme` media query.
+*
+* Themes must only include `light` and `dark` keys—this mirrors the system preference.
+*
+* @param themes - Record with `light` and `dark` keys mapping to theme values
+* @param options.defaultColorScheme - Fallback when matchMedia is unavailable (e.g. SSR, default: 'light')
+* @returns ThemeEntry for current system preference
+*/
+function readPrefersColorSchemeTheme(themes, options) {
+	return themeEntry(themes, getPrefersColorScheme(options?.defaultColorScheme ?? "light"));
+}
+
+//#endregion
+export { readPrefersColorSchemeTheme };
+//# sourceMappingURL=read-prefers-color-scheme-theme.mjs.map

package/dist/theme/prefers-color-scheme-theme/read-prefers-color-scheme-theme.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-prefers-color-scheme-theme.mjs","names":[],"sources":["../../../src/theme/prefers-color-scheme-theme/read-prefers-color-scheme-theme.ts"],"sourcesContent":["import { getPrefersColorScheme } from '../../color-scheme/get-prefers-color-scheme.ts'\nimport { themeEntry } from '../theme-entry.ts'\nimport type { ThemeEntry } from '../theme-entry.types.ts'\n\ntype PrefersColorSchemeThemes = {\n\tlight: string | readonly string[]\n\tdark: string | readonly string[]\n}\n\nexport interface ReadPrefersColorSchemeThemeOptions {\n\tdefaultColorScheme?: 'light' | 'dark' | undefined\n}\n\n/**\n * Reads a theme entry from the system `prefers-color-scheme` media query.\n *\n * Themes must only include `light` and `dark` keys—this mirrors the system preference.\n *\n * @param themes - Record with `light` and `dark` keys mapping to theme values\n * @param options.defaultColorScheme - Fallback when matchMedia is unavailable (e.g. SSR, default: 'light')\n * @returns ThemeEntry for current system preference\n */\nexport function readPrefersColorSchemeTheme<Themes extends PrefersColorSchemeThemes>(\n\tthemes: Themes,\n\toptions?: ReadPrefersColorSchemeThemeOptions | undefined\n): ThemeEntry<Themes> {\n\tconst defaultColorScheme = options?.defaultColorScheme ?? 'light'\n\tconst scheme = getPrefersColorScheme(defaultColorScheme)\n\treturn themeEntry(themes, scheme)\n}\n"],"mappings":";;;;;;;;;;;;;AAsBA,SAAgB,4BACf,QACA,SACqB;AAGrB,QAAO,WAAW,QADH,sBADY,SAAS,sBAAsB,QACF,CACvB"}

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.cjs

@@ -0,0 +1,20 @@
+const require_observe_prefers_color_scheme = require('../../color-scheme/observe-prefers-color-scheme.cjs');
+const require_theme_entry = require('../theme-entry.cjs');
+
+//#region src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts
+/**
+* Subscribes to system `prefers-color-scheme` changes and invokes the handler with theme entries.
+*
+* Themes must only include `light` and `dark` keys—this mirrors the system preference.
+*
+* @param themes - Record with `light` and `dark` keys mapping to theme values
+* @param handler - Callback invoked when the color scheme preference changes
+* @returns Unsubscribe function
+*/
+function subscribePrefersColorSchemeTheme(themes, handler) {
+	return require_observe_prefers_color_scheme.observePrefersColorScheme((scheme) => handler(require_theme_entry.themeEntry(themes, scheme)));
+}
+
+//#endregion
+exports.subscribePrefersColorSchemeTheme = subscribePrefersColorSchemeTheme;
+//# sourceMappingURL=subscribe-prefers-color-scheme-theme.cjs.map

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-prefers-color-scheme-theme.cjs","names":["observePrefersColorScheme","themeEntry"],"sources":["../../../src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts"],"sourcesContent":["import { observePrefersColorScheme } from '../../color-scheme/observe-prefers-color-scheme.ts'\nimport { themeEntry } from '../theme-entry.ts'\nimport type { ThemeEntry } from '../theme-entry.types.ts'\n\ntype PrefersColorSchemeThemes = {\n\tlight: string | readonly string[]\n\tdark: string | readonly string[]\n}\n\n/**\n * Subscribes to system `prefers-color-scheme` changes and invokes the handler with theme entries.\n *\n * Themes must only include `light` and `dark` keys—this mirrors the system preference.\n *\n * @param themes - Record with `light` and `dark` keys mapping to theme values\n * @param handler - Callback invoked when the color scheme preference changes\n * @returns Unsubscribe function\n */\nexport function subscribePrefersColorSchemeTheme<Themes extends PrefersColorSchemeThemes>(\n\tthemes: Themes,\n\thandler: (entry: ThemeEntry<Themes>) => void\n): () => void {\n\treturn observePrefersColorScheme((scheme) => handler(themeEntry(themes, scheme)))\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,SAAgB,iCACf,QACA,SACa;AACb,QAAOA,gEAA2B,WAAW,QAAQC,+BAAW,QAAQ,OAAO,CAAC,CAAC"}

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.d.cts

@@ -0,0 +1,20 @@
+import { ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.d.ts
+type PrefersColorSchemeThemes = {
+  light: string | readonly string[];
+  dark: string | readonly string[];
+};
+/**
+ * Subscribes to system `prefers-color-scheme` changes and invokes the handler with theme entries.
+ *
+ * Themes must only include `light` and `dark` keys—this mirrors the system preference.
+ *
+ * @param themes - Record with `light` and `dark` keys mapping to theme values
+ * @param handler - Callback invoked when the color scheme preference changes
+ * @returns Unsubscribe function
+ */
+declare function subscribePrefersColorSchemeTheme<Themes extends PrefersColorSchemeThemes>(themes: Themes, handler: (entry: ThemeEntry<Themes>) => void): () => void;
+//#endregion
+export { subscribePrefersColorSchemeTheme };
+//# sourceMappingURL=subscribe-prefers-color-scheme-theme.d.cts.map

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-prefers-color-scheme-theme.d.cts","names":[],"sources":["../../../src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts"],"sourcesContent":[],"mappings":";;;KAIK,wBAAA;;EAAA,IAAA,EAAA,MAAA,GAAA,SAAA,MAAwB,EAAA;AAc7B,CAAA;;;;;;;;;;iBAAgB,gDAAgD,kCACvD,yBACS,WAAW"}

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.d.mts

@@ -0,0 +1,20 @@
+import { ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.d.ts
+type PrefersColorSchemeThemes = {
+  light: string | readonly string[];
+  dark: string | readonly string[];
+};
+/**
+ * Subscribes to system `prefers-color-scheme` changes and invokes the handler with theme entries.
+ *
+ * Themes must only include `light` and `dark` keys—this mirrors the system preference.
+ *
+ * @param themes - Record with `light` and `dark` keys mapping to theme values
+ * @param handler - Callback invoked when the color scheme preference changes
+ * @returns Unsubscribe function
+ */
+declare function subscribePrefersColorSchemeTheme<Themes extends PrefersColorSchemeThemes>(themes: Themes, handler: (entry: ThemeEntry<Themes>) => void): () => void;
+//#endregion
+export { subscribePrefersColorSchemeTheme };
+//# sourceMappingURL=subscribe-prefers-color-scheme-theme.d.mts.map

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-prefers-color-scheme-theme.d.mts","names":[],"sources":["../../../src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts"],"sourcesContent":[],"mappings":";;;KAIK,wBAAA;;EAAA,IAAA,EAAA,MAAA,GAAA,SAAA,MAAwB,EAAA;AAc7B,CAAA;;;;;;;;;;iBAAgB,gDAAgD,kCACvD,yBACS,WAAW"}

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.mjs

@@ -0,0 +1,20 @@
+import { observePrefersColorScheme } from "../../color-scheme/observe-prefers-color-scheme.mjs";
+import { themeEntry } from "../theme-entry.mjs";
+
+//#region src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts
+/**
+* Subscribes to system `prefers-color-scheme` changes and invokes the handler with theme entries.
+*
+* Themes must only include `light` and `dark` keys—this mirrors the system preference.
+*
+* @param themes - Record with `light` and `dark` keys mapping to theme values
+* @param handler - Callback invoked when the color scheme preference changes
+* @returns Unsubscribe function
+*/
+function subscribePrefersColorSchemeTheme(themes, handler) {
+	return observePrefersColorScheme((scheme) => handler(themeEntry(themes, scheme)));
+}
+
+//#endregion
+export { subscribePrefersColorSchemeTheme };
+//# sourceMappingURL=subscribe-prefers-color-scheme-theme.mjs.map

package/dist/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-prefers-color-scheme-theme.mjs","names":[],"sources":["../../../src/theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts"],"sourcesContent":["import { observePrefersColorScheme } from '../../color-scheme/observe-prefers-color-scheme.ts'\nimport { themeEntry } from '../theme-entry.ts'\nimport type { ThemeEntry } from '../theme-entry.types.ts'\n\ntype PrefersColorSchemeThemes = {\n\tlight: string | readonly string[]\n\tdark: string | readonly string[]\n}\n\n/**\n * Subscribes to system `prefers-color-scheme` changes and invokes the handler with theme entries.\n *\n * Themes must only include `light` and `dark` keys—this mirrors the system preference.\n *\n * @param themes - Record with `light` and `dark` keys mapping to theme values\n * @param handler - Callback invoked when the color scheme preference changes\n * @returns Unsubscribe function\n */\nexport function subscribePrefersColorSchemeTheme<Themes extends PrefersColorSchemeThemes>(\n\tthemes: Themes,\n\thandler: (entry: ThemeEntry<Themes>) => void\n): () => void {\n\treturn observePrefersColorScheme((scheme) => handler(themeEntry(themes, scheme)))\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,SAAgB,iCACf,QACA,SACa;AACb,QAAO,2BAA2B,WAAW,QAAQ,WAAW,QAAQ,OAAO,CAAC,CAAC"}

package/dist/theme/session-storage/read-session-storage.cjs

@@ -0,0 +1,22 @@
+const require_read_web_storage = require('../web-storage/read-web-storage.cjs');
+
+//#region src/theme/session-storage/read-session-storage.ts
+/**
+* Reads a theme entry from sessionStorage.
+*
+* @param themes - Record mapping theme keys to values (for validation)
+* @param storageKey - sessionStorage key to read from
+* @param options.parse - Custom parser (default: parseStoredTheme)
+* @returns ThemeEntry if found, undefined otherwise. Returns undefined when sessionStorage is unavailable (e.g. SSR).
+*/
+function readSessionStorage(themes, storageKey, options) {
+	if (!window?.sessionStorage) return void 0;
+	return require_read_web_storage.readWebStorage(themes, storageKey, {
+		storage: window.sessionStorage,
+		parse: options?.parse
+	});
+}
+
+//#endregion
+exports.readSessionStorage = readSessionStorage;
+//# sourceMappingURL=read-session-storage.cjs.map

package/dist/theme/session-storage/read-session-storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-session-storage.cjs","names":["readWebStorage"],"sources":["../../../src/theme/session-storage/read-session-storage.ts"],"sourcesContent":["import type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { readWebStorage } from '../web-storage/read-web-storage.ts'\n\n/**\n * Reads a theme entry from sessionStorage.\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param storageKey - sessionStorage key to read from\n * @param options.parse - Custom parser (default: parseStoredTheme)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when sessionStorage is unavailable (e.g. SSR).\n */\nexport function readSessionStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\toptions?: { parse?: ParseStoredTheme<Themes> | undefined }\n): ThemeEntry<Themes> | undefined {\n\tif (!window?.sessionStorage) return undefined\n\treturn readWebStorage(themes, storageKey, {\n\t\tstorage: window.sessionStorage,\n\t\tparse: options?.parse\n\t})\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,mBACf,QACA,YACA,SACiC;AACjC,KAAI,CAAC,QAAQ,eAAgB,QAAO;AACpC,QAAOA,wCAAe,QAAQ,YAAY;EACzC,SAAS,OAAO;EAChB,OAAO,SAAS;EAChB,CAAC"}

package/dist/theme/session-storage/read-session-storage.d.cts

@@ -0,0 +1,19 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/session-storage/read-session-storage.d.ts
+
+/**
+ * Reads a theme entry from sessionStorage.
+ *
+ * @param themes - Record mapping theme keys to values (for validation)
+ * @param storageKey - sessionStorage key to read from
+ * @param options.parse - Custom parser (default: parseStoredTheme)
+ * @returns ThemeEntry if found, undefined otherwise. Returns undefined when sessionStorage is unavailable (e.g. SSR).
+ */
+declare function readSessionStorage<Themes extends ThemeMap>(themes: Themes, storageKey: string, options?: {
+  parse?: ParseStoredTheme<Themes> | undefined;
+}): ThemeEntry<Themes> | undefined;
+//#endregion
+export { readSessionStorage };
+//# sourceMappingURL=read-session-storage.d.cts.map

package/dist/theme/session-storage/read-session-storage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-session-storage.d.cts","names":[],"sources":["../../../src/theme/session-storage/read-session-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;;;;;;AAIG,iBAJa,kBAIb,CAAA,eAJ+C,QAI/C,CAAA,CAAA,MAAA,EAHM,MAGN,EAAA,UAAA,EAAA,MAAA,EAAA,QAAA,EAAA;EAAU,KAAA,CAAA,EADQ,gBACR,CADyB,MACzB,CAAA,GAAA,SAAA;IAAV,WAAW"}

package/dist/theme/session-storage/read-session-storage.d.mts

@@ -0,0 +1,19 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/session-storage/read-session-storage.d.ts
+
+/**
+ * Reads a theme entry from sessionStorage.
+ *
+ * @param themes - Record mapping theme keys to values (for validation)
+ * @param storageKey - sessionStorage key to read from
+ * @param options.parse - Custom parser (default: parseStoredTheme)
+ * @returns ThemeEntry if found, undefined otherwise. Returns undefined when sessionStorage is unavailable (e.g. SSR).
+ */
+declare function readSessionStorage<Themes extends ThemeMap>(themes: Themes, storageKey: string, options?: {
+  parse?: ParseStoredTheme<Themes> | undefined;
+}): ThemeEntry<Themes> | undefined;
+//#endregion
+export { readSessionStorage };
+//# sourceMappingURL=read-session-storage.d.mts.map

package/dist/theme/session-storage/read-session-storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-session-storage.d.mts","names":[],"sources":["../../../src/theme/session-storage/read-session-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;;;;;;AAIG,iBAJa,kBAIb,CAAA,eAJ+C,QAI/C,CAAA,CAAA,MAAA,EAHM,MAGN,EAAA,UAAA,EAAA,MAAA,EAAA,QAAA,EAAA;EAAU,KAAA,CAAA,EADQ,gBACR,CADyB,MACzB,CAAA,GAAA,SAAA;IAAV,WAAW"}

package/dist/theme/session-storage/read-session-storage.mjs

@@ -0,0 +1,22 @@
+import { readWebStorage } from "../web-storage/read-web-storage.mjs";
+
+//#region src/theme/session-storage/read-session-storage.ts
+/**
+* Reads a theme entry from sessionStorage.
+*
+* @param themes - Record mapping theme keys to values (for validation)
+* @param storageKey - sessionStorage key to read from
+* @param options.parse - Custom parser (default: parseStoredTheme)
+* @returns ThemeEntry if found, undefined otherwise. Returns undefined when sessionStorage is unavailable (e.g. SSR).
+*/
+function readSessionStorage(themes, storageKey, options) {
+	if (!window?.sessionStorage) return void 0;
+	return readWebStorage(themes, storageKey, {
+		storage: window.sessionStorage,
+		parse: options?.parse
+	});
+}
+
+//#endregion
+export { readSessionStorage };
+//# sourceMappingURL=read-session-storage.mjs.map

package/dist/theme/session-storage/read-session-storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-session-storage.mjs","names":[],"sources":["../../../src/theme/session-storage/read-session-storage.ts"],"sourcesContent":["import type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { readWebStorage } from '../web-storage/read-web-storage.ts'\n\n/**\n * Reads a theme entry from sessionStorage.\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param storageKey - sessionStorage key to read from\n * @param options.parse - Custom parser (default: parseStoredTheme)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when sessionStorage is unavailable (e.g. SSR).\n */\nexport function readSessionStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\toptions?: { parse?: ParseStoredTheme<Themes> | undefined }\n): ThemeEntry<Themes> | undefined {\n\tif (!window?.sessionStorage) return undefined\n\treturn readWebStorage(themes, storageKey, {\n\t\tstorage: window.sessionStorage,\n\t\tparse: options?.parse\n\t})\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,mBACf,QACA,YACA,SACiC;AACjC,KAAI,CAAC,QAAQ,eAAgB,QAAO;AACpC,QAAO,eAAe,QAAQ,YAAY;EACzC,SAAS,OAAO;EAChB,OAAO,SAAS;EAChB,CAAC"}

package/dist/theme/session-storage/write-session-storage.cjs

@@ -0,0 +1,26 @@
+const require_write_web_storage = require('../web-storage/write-web-storage.cjs');
+
+//#region src/theme/session-storage/write-session-storage.ts
+/**
+* Writes a theme entry to sessionStorage.
+*
+* Performs setItem/removeItem only. Does not notify subscribers; the store must call notify() after this.
+*
+* @param themes - Record mapping theme keys to values (used by stringify)
+* @param storageKey - sessionStorage key to write to
+* @param entry - Theme entry to write, or null/undefined to remove
+* @param options.stringify - Custom serializer (default: JSON.stringify)
+* @param options.onError - Optional callback invoked when storage write throws
+*/
+function writeSessionStorage(themes, storageKey, entry, options) {
+	if (!window?.sessionStorage) return;
+	require_write_web_storage.writeWebStorage(themes, storageKey, entry, {
+		storage: window.sessionStorage,
+		stringify: options?.stringify,
+		onError: options?.onError
+	});
+}
+
+//#endregion
+exports.writeSessionStorage = writeSessionStorage;
+//# sourceMappingURL=write-session-storage.cjs.map

package/dist/theme/session-storage/write-session-storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-session-storage.cjs","names":[],"sources":["../../../src/theme/session-storage/write-session-storage.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { writeWebStorage } from '../web-storage/write-web-storage.ts'\n\n/**\n * Writes a theme entry to sessionStorage.\n *\n * Performs setItem/removeItem only. Does not notify subscribers; the store must call notify() after this.\n *\n * @param themes - Record mapping theme keys to values (used by stringify)\n * @param storageKey - sessionStorage key to write to\n * @param entry - Theme entry to write, or null/undefined to remove\n * @param options.stringify - Custom serializer (default: JSON.stringify)\n * @param options.onError - Optional callback invoked when storage write throws\n */\nexport function writeSessionStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions?: {\n\t\tstringify?: StringifyStoredTheme<Themes> | undefined\n\t\tonError?: ((error: unknown) => void) | undefined\n\t}\n): void {\n\tif (!window?.sessionStorage) return\n\twriteWebStorage(themes, storageKey, entry, {\n\t\tstorage: window.sessionStorage,\n\t\tstringify: options?.stringify,\n\t\tonError: options?.onError\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,oBACf,QACA,YACA,OACA,SAIO;AACP,KAAI,CAAC,QAAQ,eAAgB;AAC7B,2CAAgB,QAAQ,YAAY,OAAO;EAC1C,SAAS,OAAO;EAChB,WAAW,SAAS;EACpB,SAAS,SAAS;EAClB,CAAC"}

package/dist/theme/session-storage/write-session-storage.d.cts

@@ -0,0 +1,23 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { StringifyStoredTheme, ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/session-storage/write-session-storage.d.ts
+
+/**
+ * Writes a theme entry to sessionStorage.
+ *
+ * Performs setItem/removeItem only. Does not notify subscribers; the store must call notify() after this.
+ *
+ * @param themes - Record mapping theme keys to values (used by stringify)
+ * @param storageKey - sessionStorage key to write to
+ * @param entry - Theme entry to write, or null/undefined to remove
+ * @param options.stringify - Custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when storage write throws
+ */
+declare function writeSessionStorage<Themes extends ThemeMap>(themes: Themes, storageKey: string, entry: ThemeEntry<Themes> | null | undefined, options?: {
+  stringify?: StringifyStoredTheme<Themes> | undefined;
+  onError?: ((error: unknown) => void) | undefined;
+}): void;
+//#endregion
+export { writeSessionStorage };
+//# sourceMappingURL=write-session-storage.d.cts.map

package/dist/theme/session-storage/write-session-storage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-session-storage.d.cts","names":[],"sources":["../../../src/theme/session-storage/write-session-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;;;iBAAgB,mCAAmC,kBAC1C,mCAED,WAAW;cAEL,qBAAqB"}

package/dist/theme/session-storage/write-session-storage.d.mts

@@ -0,0 +1,23 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { StringifyStoredTheme, ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/session-storage/write-session-storage.d.ts
+
+/**
+ * Writes a theme entry to sessionStorage.
+ *
+ * Performs setItem/removeItem only. Does not notify subscribers; the store must call notify() after this.
+ *
+ * @param themes - Record mapping theme keys to values (used by stringify)
+ * @param storageKey - sessionStorage key to write to
+ * @param entry - Theme entry to write, or null/undefined to remove
+ * @param options.stringify - Custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when storage write throws
+ */
+declare function writeSessionStorage<Themes extends ThemeMap>(themes: Themes, storageKey: string, entry: ThemeEntry<Themes> | null | undefined, options?: {
+  stringify?: StringifyStoredTheme<Themes> | undefined;
+  onError?: ((error: unknown) => void) | undefined;
+}): void;
+//#endregion
+export { writeSessionStorage };
+//# sourceMappingURL=write-session-storage.d.mts.map

package/dist/theme/session-storage/write-session-storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-session-storage.d.mts","names":[],"sources":["../../../src/theme/session-storage/write-session-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;;;iBAAgB,mCAAmC,kBAC1C,mCAED,WAAW;cAEL,qBAAqB"}

package/dist/theme/session-storage/write-session-storage.mjs

@@ -0,0 +1,26 @@
+import { writeWebStorage } from "../web-storage/write-web-storage.mjs";
+
+//#region src/theme/session-storage/write-session-storage.ts
+/**
+* Writes a theme entry to sessionStorage.
+*
+* Performs setItem/removeItem only. Does not notify subscribers; the store must call notify() after this.
+*
+* @param themes - Record mapping theme keys to values (used by stringify)
+* @param storageKey - sessionStorage key to write to
+* @param entry - Theme entry to write, or null/undefined to remove
+* @param options.stringify - Custom serializer (default: JSON.stringify)
+* @param options.onError - Optional callback invoked when storage write throws
+*/
+function writeSessionStorage(themes, storageKey, entry, options) {
+	if (!window?.sessionStorage) return;
+	writeWebStorage(themes, storageKey, entry, {
+		storage: window.sessionStorage,
+		stringify: options?.stringify,
+		onError: options?.onError
+	});
+}
+
+//#endregion
+export { writeSessionStorage };
+//# sourceMappingURL=write-session-storage.mjs.map

package/dist/theme/session-storage/write-session-storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-session-storage.mjs","names":[],"sources":["../../../src/theme/session-storage/write-session-storage.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { writeWebStorage } from '../web-storage/write-web-storage.ts'\n\n/**\n * Writes a theme entry to sessionStorage.\n *\n * Performs setItem/removeItem only. Does not notify subscribers; the store must call notify() after this.\n *\n * @param themes - Record mapping theme keys to values (used by stringify)\n * @param storageKey - sessionStorage key to write to\n * @param entry - Theme entry to write, or null/undefined to remove\n * @param options.stringify - Custom serializer (default: JSON.stringify)\n * @param options.onError - Optional callback invoked when storage write throws\n */\nexport function writeSessionStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions?: {\n\t\tstringify?: StringifyStoredTheme<Themes> | undefined\n\t\tonError?: ((error: unknown) => void) | undefined\n\t}\n): void {\n\tif (!window?.sessionStorage) return\n\twriteWebStorage(themes, storageKey, entry, {\n\t\tstorage: window.sessionStorage,\n\t\tstringify: options?.stringify,\n\t\tonError: options?.onError\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,oBACf,QACA,YACA,OACA,SAIO;AACP,KAAI,CAAC,QAAQ,eAAgB;AAC7B,iBAAgB,QAAQ,YAAY,OAAO;EAC1C,SAAS,OAAO;EAChB,WAAW,SAAS;EACpB,SAAS,SAAS;EAClB,CAAC"}

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

@@ -11,6 +11,18 @@ interface ThemeEntry<Themes extends ThemeMap = ThemeMap> {
   theme: keyof Themes;
   value: Themes[keyof Themes];
 }
+/**
+ * Function type for parsing stored string into ThemeEntry.
+ * Used as options.parse in persisting theme stores.
+ * Value accepts null (e.g. from getItem, getAttribute, cookie parsing).
+ */
+type ParseStoredTheme<Themes extends ThemeMap> = (themes: Themes, value: string | null | undefined) => ThemeEntry<Themes> | undefined;
+/**
+ * Function type for stringify ThemeEntry to a stored string.
+ * Used as options.stringify in persisting theme stores.
+ * Existing accepts null (e.g. from getAttribute, getItem); entry accepts null for remove/clear.
+ */
+type StringifyStoredTheme<Themes extends ThemeMap> = (themes: Themes, existing: string | null | undefined, entry: ThemeEntry<Themes> | null | undefined) => string;
 //#endregion
-export { ThemeEntry };
+export { ParseStoredTheme, StringifyStoredTheme, ThemeEntry };
 //# sourceMappingURL=theme-entry.types.d.cts.map

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

@@ -1 +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"}
+{"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;;AAQrB;;;;;AAGe,KAHH,gBAGG,CAAA,eAH6B,QAG7B,CAAA,GAAA,CAAA,MAAA,EAFN,MAEM,EAAA,KAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,GAAV,UAAU,CAAC,MAAD,CAAA,GAAA,SAAA;AAOf;;;;;AAGkB,KAHN,oBAGM,CAAA,eAH8B,QAG9B,CAAA,GAAA,CAAA,MAAA,EAFT,MAES,EAAA,QAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,KAAA,EAAV,UAAU,CAAC,MAAD,CAAA,GAAA,IAAA,GAAA,SAAA,EAAA,GAAA,MAAA"}

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

@@ -11,6 +11,18 @@ interface ThemeEntry<Themes extends ThemeMap = ThemeMap> {
   theme: keyof Themes;
   value: Themes[keyof Themes];
 }
+/**
+ * Function type for parsing stored string into ThemeEntry.
+ * Used as options.parse in persisting theme stores.
+ * Value accepts null (e.g. from getItem, getAttribute, cookie parsing).
+ */
+type ParseStoredTheme<Themes extends ThemeMap> = (themes: Themes, value: string | null | undefined) => ThemeEntry<Themes> | undefined;
+/**
+ * Function type for stringify ThemeEntry to a stored string.
+ * Used as options.stringify in persisting theme stores.
+ * Existing accepts null (e.g. from getAttribute, getItem); entry accepts null for remove/clear.
+ */
+type StringifyStoredTheme<Themes extends ThemeMap> = (themes: Themes, existing: string | null | undefined, entry: ThemeEntry<Themes> | null | undefined) => string;
 //#endregion
-export { ThemeEntry };
+export { ParseStoredTheme, StringifyStoredTheme, ThemeEntry };
 //# sourceMappingURL=theme-entry.types.d.mts.map

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

@@ -1 +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"}
+{"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;;AAQrB;;;;;AAGe,KAHH,gBAGG,CAAA,eAH6B,QAG7B,CAAA,GAAA,CAAA,MAAA,EAFN,MAEM,EAAA,KAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,GAAV,UAAU,CAAC,MAAD,CAAA,GAAA,SAAA;AAOf;;;;;AAGkB,KAHN,oBAGM,CAAA,eAH8B,QAG9B,CAAA,GAAA,CAAA,MAAA,EAFT,MAES,EAAA,QAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,KAAA,EAAV,UAAU,CAAC,MAAD,CAAA,GAAA,IAAA,GAAA,SAAA,EAAA,GAAA,MAAA"}

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

@@ -1,10 +1,18 @@
 //#region src/theme/theme-map.types.d.ts
+/**
+ * Polymorphic theme value: string, array, or object with themeValue.
+ * The object form allows storing extra user metadata in persistent stores (localStorage, etc.).
+ */
+type ThemeMapValue = string | readonly string[] | {
+  themeValue: string | readonly string[];
+};
 /**
  * Record mapping theme keys to their values.
- * Each value can be a single string or readonly string[] (e.g. multiple CSS classes).
+ * Each value can be a single string, readonly string[] (e.g. multiple CSS classes),
+ * or { themeValue: string | string[] } for polymorphic values with extra metadata.
  * Used by all ThemeStore factories via the themes option.
  */
-type ThemeMap<Theme extends string = string> = Record<Theme, string | readonly string[]>;
+type ThemeMap<Theme extends string = string> = Record<Theme, ThemeMapValue>;
 //#endregion
-export { ThemeMap };
+export { ThemeMap, ThemeMapValue };
 //# sourceMappingURL=theme-map.types.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme-map.types.d.cts","names":[],"sources":["../../src/theme/theme-map.types.ts"],"sourcesContent":[],"mappings":";;AAKA;;;;KAAY,0CAA0C,OAAO"}
+{"version":3,"file":"theme-map.types.d.cts","names":[],"sources":["../../src/theme/theme-map.types.ts"],"sourcesContent":[],"mappings":";;AAIA;AAQA;;AAAoE,KARxD,aAAA,GAQwD,MAAA,GAAA,SAAA,MAAA,EAAA,GAAA;EAAd,UAAA,EAAA,MAAA,GAAA,SAAA,MAAA,EAAA;CAAM;;;;;;;KAAhD,0CAA0C,OAAO,OAAO"}

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

@@ -1,10 +1,18 @@
 //#region src/theme/theme-map.types.d.ts
+/**
+ * Polymorphic theme value: string, array, or object with themeValue.
+ * The object form allows storing extra user metadata in persistent stores (localStorage, etc.).
+ */
+type ThemeMapValue = string | readonly string[] | {
+  themeValue: string | readonly string[];
+};
 /**
  * Record mapping theme keys to their values.
- * Each value can be a single string or readonly string[] (e.g. multiple CSS classes).
+ * Each value can be a single string, readonly string[] (e.g. multiple CSS classes),
+ * or { themeValue: string | string[] } for polymorphic values with extra metadata.
  * Used by all ThemeStore factories via the themes option.
  */
-type ThemeMap<Theme extends string = string> = Record<Theme, string | readonly string[]>;
+type ThemeMap<Theme extends string = string> = Record<Theme, ThemeMapValue>;
 //#endregion
-export { ThemeMap };
+export { ThemeMap, ThemeMapValue };
 //# sourceMappingURL=theme-map.types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme-map.types.d.mts","names":[],"sources":["../../src/theme/theme-map.types.ts"],"sourcesContent":[],"mappings":";;AAKA;;;;KAAY,0CAA0C,OAAO"}
+{"version":3,"file":"theme-map.types.d.mts","names":[],"sources":["../../src/theme/theme-map.types.ts"],"sourcesContent":[],"mappings":";;AAIA;AAQA;;AAAoE,KARxD,aAAA,GAQwD,MAAA,GAAA,SAAA,MAAA,EAAA,GAAA;EAAd,UAAA,EAAA,MAAA,GAAA,SAAA,MAAA,EAAA;CAAM;;;;;;;KAAhD,0CAA0C,OAAO,OAAO"}

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

@@ -18,7 +18,7 @@ import { ThemeEntry } from "../theme-entry.types.cjs";
 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;
+  subscribe?: ((handler: (entry: ThemeEntry<Themes> | undefined) => void) => () => void) | undefined;
 }
 //#endregion
 export { AsyncThemeStore };

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

@@ -1 +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"}
+{"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;EACjB,IAAA,CAAA,EAAA,CAAA,GAAA,GAHhC,UAGgC,CAHrB,MAGqB,CAAA,GAAA,SAAA,GAHC,OAGD,CAHS,UAGT,CAHoB,MAGpB,CAAA,GAAA,SAAA,CAAA,CAAA,GAAA,SAAA;EAAX,KAAA,CAAA,EAAA,CAAA,CAAA,KAAA,EADd,UACc,CADH,MACG,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,GAD4B,OAC5B,CAAA,IAAA,CAAA,CAAA,GAAA,SAAA;EAAU,SAAA,CAAA,EAAA,CAAA,CAAA,OAAA,EAAA,CAAA,KAAA,EAAV,UAAU,CAAC,MAAD,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,EAAA,GAAA,GAAA,GAAA,IAAA,CAAA,GAAA,SAAA"}

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

@@ -18,7 +18,7 @@ import { ThemeEntry } from "../theme-entry.types.mjs";
 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;
+  subscribe?: ((handler: (entry: ThemeEntry<Themes> | undefined) => void) => () => void) | undefined;
 }
 //#endregion
 export { AsyncThemeStore };

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

@@ -1 +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"}
+{"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;EACjB,IAAA,CAAA,EAAA,CAAA,GAAA,GAHhC,UAGgC,CAHrB,MAGqB,CAAA,GAAA,SAAA,GAHC,OAGD,CAHS,UAGT,CAHoB,MAGpB,CAAA,GAAA,SAAA,CAAA,CAAA,GAAA,SAAA;EAAX,KAAA,CAAA,EAAA,CAAA,CAAA,KAAA,EADd,UACc,CADH,MACG,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,GAD4B,OAC5B,CAAA,IAAA,CAAA,CAAA,GAAA,SAAA;EAAU,SAAA,CAAA,EAAA,CAAA,CAAA,OAAA,EAAA,CAAA,KAAA,EAAV,UAAU,CAAC,MAAD,CAAA,GAAA,SAAA,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

@@ -1,15 +1,18 @@
-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');
+const require_parse_class_name = require('../../class-name/parse-class-name.cjs');
+const require_read_class_name = require('../../class-name/read-class-name.cjs');
+const require_stringify_class_name = require('../../class-name/stringify-class-name.cjs');
+const require_subscribe_class_name = require('../../class-name/subscribe-class-name.cjs');
+const require_write_class_name = require('../../class-name/write-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)
+* @param options.element - Element to operate on (accepts null e.g. from refs). Defaults to document.documentElement.
+* @param options.parse - Custom parser (default: parseClassName)
+* @param options.stringify - Custom serializer (default: stringifyClassName)
 * @returns ThemeStore
 *
 * @example
@@ -24,26 +27,26 @@ const require_apply_theme_to_class_name = require('../../class-name/apply-theme-
 function classNameThemeStore(themes, options) {
 	const element = options?.element ?? document?.documentElement;
 	if (!element) return require_dummy_theme_store.dummyThemeStore;
+	const parse = options?.parse ?? require_parse_class_name.parseClassName;
+	const stringify = options?.stringify ?? require_stringify_class_name.stringifyClassName;
 	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);
+			return require_read_class_name.readClassName(themes, {
+				element,
+				parse
+			});
 		},
 		write(entry) {
-			require_apply_theme_to_class_name.applyThemeToClassName(themes, element, entry);
+			require_write_class_name.writeClassName(themes, entry, {
+				element,
+				stringify
+			});
 		},
 		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();
+			return require_subscribe_class_name.subscribeClassName(themes, handler, {
+				element,
+				parse
+			});
 		}
 	};
 }

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

@@ -1 +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"}
+{"version":3,"file":"class-name-theme-store.cjs","names":["dummyThemeStore","parseClassName","stringifyClassName","readClassName","subscribeClassName"],"sources":["../../../../src/theme/theme-store/class-name-theme-store/class-name-theme-store.ts"],"sourcesContent":["import type { Required } from 'type-plus'\nimport { dummyThemeStore } from '../../../testing/theme/dummy-theme-store.ts'\nimport { parseClassName } from '../../class-name/parse-class-name.ts'\nimport { readClassName } from '../../class-name/read-class-name.ts'\nimport { stringifyClassName } from '../../class-name/stringify-class-name.ts'\nimport { subscribeClassName } from '../../class-name/subscribe-class-name.ts'\nimport { writeClassName } from '../../class-name/write-class-name.ts'\nimport type { ParseStoredTheme, StringifyStoredTheme } from '../../theme-entry.types.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 (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseClassName)\n * @param options.stringify - Custom serializer (default: stringifyClassName)\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?: {\n\t\telement?: Element | null | undefined\n\t\tparse?: ParseStoredTheme<Themes> | undefined\n\t\tstringify?: StringifyStoredTheme<Themes> | undefined\n\t}\n): Required<ThemeStore<Themes>> {\n\tconst element = options?.element ?? document?.documentElement\n\n\tif (!element) return dummyThemeStore\n\n\tconst parse = options?.parse ?? parseClassName\n\tconst stringify = options?.stringify ?? stringifyClassName\n\n\treturn {\n\t\tread() {\n\t\t\treturn readClassName(themes, { element, parse })\n\t\t},\n\t\twrite(entry) {\n\t\t\twriteClassName(themes, entry, { element, stringify })\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\treturn subscribeClassName(themes, handler, { element, parse })\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,oBACf,QACA,SAK+B;CAC/B,MAAM,UAAU,SAAS,WAAW,UAAU;AAE9C,KAAI,CAAC,QAAS,QAAOA;CAErB,MAAM,QAAQ,SAAS,SAASC;CAChC,MAAM,YAAY,SAAS,aAAaC;AAExC,QAAO;EACN,OAAO;AACN,UAAOC,sCAAc,QAAQ;IAAE;IAAS;IAAO,CAAC;;EAEjD,MAAM,OAAO;AACZ,2CAAe,QAAQ,OAAO;IAAE;IAAS;IAAW,CAAC;;EAEtD,UAAU,SAAS;AAClB,UAAOC,gDAAmB,QAAQ,SAAS;IAAE;IAAS;IAAO,CAAC;;EAE/D"}