@just-web/toolkits 1.0.0 → 2.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"prefers-color-scheme-theme-store.cjs","names":["themeEntry","getPrefersColorScheme","observePrefersColorScheme"],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":["import type { RequiredPick } from 'type-plus'\nimport { getPrefersColorScheme } from '../../../color-scheme/get-prefers-color-scheme.ts'\nimport { observePrefersColorScheme } from '../../../color-scheme/observe-prefers-color-scheme.ts'\nimport { themeEntry } from '../../theme-entry.ts'\nimport type { ThemeStore } from '../theme-store.types.ts'\n\ntype PrefersColorSchemeThemes = {\n\tlight: string | readonly string[]\n\tdark: string | readonly string[]\n}\n\n/**\n * Creates a read-only theme store that reads from `prefers-color-scheme`.\n *\n * **Color-scheme specific:** Themes must only include `light` and `dark` keys—this store\n * mirrors the system preference which is always one of these.\n *\n * Returns `ThemeEntry` for `light` or `dark` based on system preference.\n * No write method—the value is controlled by the system.\n *\n * @param themes - Record with `light` and `dark` keys mapping to theme values\n * @returns ThemeStore with read and subscribe only\n *\n * @example\n * ```ts\n * const themes = { light: 'theme-light', dark: 'theme-dark' }\n * const store = prefersColorSchemeThemeStore(themes)\n * store.read() // ThemeEntry for current system preference\n * store.subscribe((entry) => {})\n * ```\n */\nexport function prefersColorSchemeThemeStore<Themes extends PrefersColorSchemeThemes>(\n\tthemes: Themes\n): RequiredPick<ThemeStore<Themes>, 'read' | 'subscribe'> {\n\treturn {\n\t\tread() {\n\t\t\treturn themeEntry(themes, getPrefersColorScheme())\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\treturn observePrefersColorScheme((scheme) => handler(themeEntry(themes, scheme)))\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,6BACf,QACyD;AACzD,QAAO;EACN,OAAO;AACN,UAAOA,+BAAW,QAAQC,wDAAuB,CAAC;;EAEnD,UAAU,SAAS;AAClB,UAAOC,gEAA2B,WAAW,QAAQF,+BAAW,QAAQ,OAAO,CAAC,CAAC;;EAElF"}
+{"version":3,"file":"prefers-color-scheme-theme-store.cjs","names":["readPrefersColorSchemeTheme","subscribePrefersColorSchemeTheme"],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":["import type { RequiredPick } from 'type-plus'\nimport { readPrefersColorSchemeTheme } from '../../prefers-color-scheme-theme/read-prefers-color-scheme-theme.ts'\nimport { subscribePrefersColorSchemeTheme } from '../../prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts'\nimport type { ThemeStore } from '../theme-store.types.ts'\n\ntype PrefersColorSchemeThemes = {\n\tlight: string | readonly string[]\n\tdark: string | readonly string[]\n}\n\n/**\n * Creates a read-only theme store that reads from `prefers-color-scheme`.\n *\n * **Color-scheme specific:** Themes must only include `light` and `dark` keys—this store\n * mirrors the system preference which is always one of these.\n *\n * Returns `ThemeEntry` for `light` or `dark` based on system preference.\n * No write method—the value is controlled by the system.\n *\n * @param themes - Record with `light` and `dark` keys mapping to theme values\n * @returns ThemeStore with read and subscribe only\n *\n * @example\n * ```ts\n * const themes = { light: 'theme-light', dark: 'theme-dark' }\n * const store = prefersColorSchemeThemeStore(themes)\n * store.read() // ThemeEntry for current system preference\n * store.subscribe((entry) => {})\n * ```\n */\nexport function prefersColorSchemeThemeStore<Themes extends PrefersColorSchemeThemes>(\n\tthemes: Themes\n): RequiredPick<ThemeStore<Themes>, 'read' | 'subscribe'> {\n\treturn {\n\t\tread() {\n\t\t\treturn readPrefersColorSchemeTheme(themes)\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\treturn subscribePrefersColorSchemeTheme(themes, handler)\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,6BACf,QACyD;AACzD,QAAO;EACN,OAAO;AACN,UAAOA,oEAA4B,OAAO;;EAE3C,UAAU,SAAS;AAClB,UAAOC,8EAAiC,QAAQ,QAAQ;;EAEzD"}

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

@@ -1 +1 @@
-{"version":3,"file":"prefers-color-scheme-theme-store.d.cts","names":[],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":[],"mappings":";;;;KAMK,wBAAA;;EAAA,IAAA,EAAA,MAAA,GAAA,SAAA,MAAwB,EAAA;AAyB7B,CAAA;;;;;;;;;;;;;;;;;;;;;iBAAgB,4CAA4C,kCACnD,SACN,aAAa,WAAW"}
+{"version":3,"file":"prefers-color-scheme-theme-store.d.cts","names":[],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":[],"mappings":";;;;KAKK,wBAAA;;EAAA,IAAA,EAAA,MAAA,GAAA,SAAA,MAAwB,EAAA;AAyB7B,CAAA;;;;;;;;;;;;;;;;;;;;;iBAAgB,4CAA4C,kCACnD,SACN,aAAa,WAAW"}

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

@@ -1 +1 @@
-{"version":3,"file":"prefers-color-scheme-theme-store.d.mts","names":[],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":[],"mappings":";;;;KAMK,wBAAA;;EAAA,IAAA,EAAA,MAAA,GAAA,SAAA,MAAwB,EAAA;AAyB7B,CAAA;;;;;;;;;;;;;;;;;;;;;iBAAgB,4CAA4C,kCACnD,SACN,aAAa,WAAW"}
+{"version":3,"file":"prefers-color-scheme-theme-store.d.mts","names":[],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":[],"mappings":";;;;KAKK,wBAAA;;EAAA,IAAA,EAAA,MAAA,GAAA,SAAA,MAAwB,EAAA;AAyB7B,CAAA;;;;;;;;;;;;;;;;;;;;;iBAAgB,4CAA4C,kCACnD,SACN,aAAa,WAAW"}

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

@@ -1,6 +1,5 @@
-import { getPrefersColorScheme } from "../../../color-scheme/get-prefers-color-scheme.mjs";
-import { observePrefersColorScheme } from "../../../color-scheme/observe-prefers-color-scheme.mjs";
-import { themeEntry } from "../../theme-entry.mjs";
+import { readPrefersColorSchemeTheme } from "../../prefers-color-scheme-theme/read-prefers-color-scheme-theme.mjs";
+import { subscribePrefersColorSchemeTheme } from "../../prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.mjs";
 
 //#region src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts
 /**
@@ -26,10 +25,10 @@ import { themeEntry } from "../../theme-entry.mjs";
 function prefersColorSchemeThemeStore(themes) {
 	return {
 		read() {
-			return themeEntry(themes, getPrefersColorScheme());
+			return readPrefersColorSchemeTheme(themes);
 		},
 		subscribe(handler) {
-			return observePrefersColorScheme((scheme) => handler(themeEntry(themes, scheme)));
+			return subscribePrefersColorSchemeTheme(themes, handler);
 		}
 	};
 }

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

@@ -1 +1 @@
-{"version":3,"file":"prefers-color-scheme-theme-store.mjs","names":[],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":["import type { RequiredPick } from 'type-plus'\nimport { getPrefersColorScheme } from '../../../color-scheme/get-prefers-color-scheme.ts'\nimport { observePrefersColorScheme } from '../../../color-scheme/observe-prefers-color-scheme.ts'\nimport { themeEntry } from '../../theme-entry.ts'\nimport type { ThemeStore } from '../theme-store.types.ts'\n\ntype PrefersColorSchemeThemes = {\n\tlight: string | readonly string[]\n\tdark: string | readonly string[]\n}\n\n/**\n * Creates a read-only theme store that reads from `prefers-color-scheme`.\n *\n * **Color-scheme specific:** Themes must only include `light` and `dark` keys—this store\n * mirrors the system preference which is always one of these.\n *\n * Returns `ThemeEntry` for `light` or `dark` based on system preference.\n * No write method—the value is controlled by the system.\n *\n * @param themes - Record with `light` and `dark` keys mapping to theme values\n * @returns ThemeStore with read and subscribe only\n *\n * @example\n * ```ts\n * const themes = { light: 'theme-light', dark: 'theme-dark' }\n * const store = prefersColorSchemeThemeStore(themes)\n * store.read() // ThemeEntry for current system preference\n * store.subscribe((entry) => {})\n * ```\n */\nexport function prefersColorSchemeThemeStore<Themes extends PrefersColorSchemeThemes>(\n\tthemes: Themes\n): RequiredPick<ThemeStore<Themes>, 'read' | 'subscribe'> {\n\treturn {\n\t\tread() {\n\t\t\treturn themeEntry(themes, getPrefersColorScheme())\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\treturn observePrefersColorScheme((scheme) => handler(themeEntry(themes, scheme)))\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,6BACf,QACyD;AACzD,QAAO;EACN,OAAO;AACN,UAAO,WAAW,QAAQ,uBAAuB,CAAC;;EAEnD,UAAU,SAAS;AAClB,UAAO,2BAA2B,WAAW,QAAQ,WAAW,QAAQ,OAAO,CAAC,CAAC;;EAElF"}
+{"version":3,"file":"prefers-color-scheme-theme-store.mjs","names":[],"sources":["../../../../src/theme/theme-store/prefers-color-scheme-theme-store/prefers-color-scheme-theme-store.ts"],"sourcesContent":["import type { RequiredPick } from 'type-plus'\nimport { readPrefersColorSchemeTheme } from '../../prefers-color-scheme-theme/read-prefers-color-scheme-theme.ts'\nimport { subscribePrefersColorSchemeTheme } from '../../prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts'\nimport type { ThemeStore } from '../theme-store.types.ts'\n\ntype PrefersColorSchemeThemes = {\n\tlight: string | readonly string[]\n\tdark: string | readonly string[]\n}\n\n/**\n * Creates a read-only theme store that reads from `prefers-color-scheme`.\n *\n * **Color-scheme specific:** Themes must only include `light` and `dark` keys—this store\n * mirrors the system preference which is always one of these.\n *\n * Returns `ThemeEntry` for `light` or `dark` based on system preference.\n * No write method—the value is controlled by the system.\n *\n * @param themes - Record with `light` and `dark` keys mapping to theme values\n * @returns ThemeStore with read and subscribe only\n *\n * @example\n * ```ts\n * const themes = { light: 'theme-light', dark: 'theme-dark' }\n * const store = prefersColorSchemeThemeStore(themes)\n * store.read() // ThemeEntry for current system preference\n * store.subscribe((entry) => {})\n * ```\n */\nexport function prefersColorSchemeThemeStore<Themes extends PrefersColorSchemeThemes>(\n\tthemes: Themes\n): RequiredPick<ThemeStore<Themes>, 'read' | 'subscribe'> {\n\treturn {\n\t\tread() {\n\t\t\treturn readPrefersColorSchemeTheme(themes)\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\treturn subscribePrefersColorSchemeTheme(themes, handler)\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,6BACf,QACyD;AACzD,QAAO;EACN,OAAO;AACN,UAAO,4BAA4B,OAAO;;EAE3C,UAAU,SAAS;AAClB,UAAO,iCAAiC,QAAQ,QAAQ;;EAEzD"}

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

@@ -1,6 +1,6 @@
-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');
+const require_read_session_storage = require('../../session-storage/read-session-storage.cjs');
+const require_write_session_storage = require('../../session-storage/write-session-storage.cjs');
 
 //#region src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts
 /**
@@ -11,6 +11,9 @@ const require_parse_stored_theme = require('../../_utils/parse-stored-theme.cjs'
 *
 * @param themes - Record mapping theme keys to values (for validation)
 * @param options.storageKey - sessionStorage key
+* @param options.parse - Optional custom parser for stored string (default: parseStoredTheme)
+* @param options.stringify - Optional custom serializer (default: JSON.stringify)
+* @param options.onError - Optional callback invoked when storage write throws
 * @returns ThemeStore
 *
 * @example
@@ -23,14 +26,12 @@ const require_parse_stored_theme = require('../../_utils/parse-stored-theme.cjs'
 * ```
 */
 function sessionStorageThemeStore(themes, options) {
-	const { storageKey } = options;
-	if (typeof window === "undefined" || !window.sessionStorage) return require_dummy_theme_store.dummyThemeStore;
+	const { storageKey, parse, stringify, onError } = options;
+	if (!window?.sessionStorage) 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, window.sessionStorage.getItem(storageKey));
-		if (theme === void 0) return void 0;
-		return require_theme_entry.themeEntry(themes, theme);
+		return require_read_session_storage.readSessionStorage(themes, storageKey, { parse });
 	}
 	function notify() {
 		const result = read();
@@ -42,11 +43,11 @@ function sessionStorageThemeStore(themes, options) {
 	return {
 		read,
 		write(entry) {
-			try {
-				if (entry === void 0) window.sessionStorage.removeItem(storageKey);
-				else window.sessionStorage.setItem(storageKey, JSON.stringify(entry));
-				notify();
-			} catch {}
+			require_write_session_storage.writeSessionStorage(themes, storageKey, entry, {
+				stringify,
+				onError
+			});
+			notify();
 		},
 		subscribe(handler) {
 			handlers.add(handler);

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

@@ -1 +1 @@
-{"version":3,"file":"session-storage-theme-store.cjs","names":["dummyThemeStore","lastNotifiedKey: keyof Themes | undefined","parseStoredTheme","themeEntry"],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":["import { 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\n/**\n * Creates a theme store backed by sessionStorage.\n *\n * Persists per tab; cross-tab sync via StorageEvent when available.\n * Same-tab writes trigger manual notify (StorageEvent does not fire for same tab).\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options.storageKey - sessionStorage key\n * @returns ThemeStore\n *\n * @example\n * ```ts\n * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }\n * const store = sessionStorageThemeStore(themes, { storageKey: 'theme' })\n * store.read() // returns themeResult from sessionStorage\n * store.write(themeEntry(themes, 'grayscale'))\n * store.subscribe((themeResult) => {})\n * ```\n */\nexport function sessionStorageThemeStore<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions: { storageKey: string }\n) {\n\tconst { storageKey } = options\n\n\tif (typeof window === 'undefined' || !window.sessionStorage) {\n\t\treturn dummyThemeStore satisfies ThemeStore<Themes>\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 = window.sessionStorage.getItem(storageKey)\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\twindow.sessionStorage.removeItem(storageKey)\n\t\t\t\t} else {\n\t\t\t\t\twindow.sessionStorage.setItem(storageKey, JSON.stringify(entry))\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\n\t\t\tconst onStorage = (e: StorageEvent) => {\n\t\t\t\tif (e.key === storageKey && e.storageArea === window.sessionStorage) notify()\n\t\t\t}\n\t\t\twindow.addEventListener('storage', onStorage)\n\n\t\t\treturn () => {\n\t\t\t\thandlers.delete(handler)\n\t\t\t\twindow.removeEventListener('storage', onStorage)\n\t\t\t}\n\t\t}\n\t} satisfies ThemeStore<Themes>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,yBACf,QACA,SACC;CACD,MAAM,EAAE,eAAe;AAEvB,KAAI,OAAO,WAAW,eAAe,CAAC,OAAO,eAC5C,QAAOA;CAGR,MAAM,2BAAW,IAAI,KAAsD;CAC3E,IAAIC,kBAA4C,MAAM,EAAE,SAAS;CAEjE,SAAS,OAAO;EAEf,MAAM,QAAQC,4CAAiB,QADhB,OAAO,eAAe,QAAQ,WAAW,CACV;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,QAAO,eAAe,WAAW,WAAW;QAE5C,QAAO,eAAe,QAAQ,YAAY,KAAK,UAAU,MAAM,CAAC;AAEjE,YAAQ;WACD;;EAIT,UAAU,SAAS;AAClB,YAAS,IAAI,QAAQ;GAErB,MAAM,aAAa,MAAoB;AACtC,QAAI,EAAE,QAAQ,cAAc,EAAE,gBAAgB,OAAO,eAAgB,SAAQ;;AAE9E,UAAO,iBAAiB,WAAW,UAAU;AAE7C,gBAAa;AACZ,aAAS,OAAO,QAAQ;AACxB,WAAO,oBAAoB,WAAW,UAAU;;;EAGlD"}
+{"version":3,"file":"session-storage-theme-store.cjs","names":["dummyThemeStore","lastNotifiedKey: keyof Themes | undefined","readSessionStorage"],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":["import { dummyThemeStore } from '../../../testing/theme/dummy-theme-store.ts'\nimport { readSessionStorage } from '../../session-storage/read-session-storage.ts'\nimport { writeSessionStorage } from '../../session-storage/write-session-storage.ts'\nimport type { ParseStoredTheme, StringifyStoredTheme, ThemeEntry } 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 backed by sessionStorage.\n *\n * Persists per tab; cross-tab sync via StorageEvent when available.\n * Same-tab writes trigger manual notify (StorageEvent does not fire for same tab).\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options.storageKey - sessionStorage key\n * @param options.parse - Optional custom parser for stored string (default: parseStoredTheme)\n * @param options.stringify - Optional custom serializer (default: JSON.stringify)\n * @param options.onError - Optional callback invoked when storage write throws\n * @returns ThemeStore\n *\n * @example\n * ```ts\n * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }\n * const store = sessionStorageThemeStore(themes, { storageKey: 'theme' })\n * store.read() // returns themeResult from sessionStorage\n * store.write(themeEntry(themes, 'grayscale'))\n * store.subscribe((themeResult) => {})\n * ```\n */\nexport function sessionStorageThemeStore<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions: {\n\t\tstorageKey: string\n\t\tparse?: ParseStoredTheme<Themes> | undefined\n\t\tstringify?: StringifyStoredTheme<Themes> | undefined\n\t\tonError?: ((error: unknown) => void) | undefined\n\t}\n) {\n\tconst { storageKey, parse, stringify, onError } = options\n\n\tif (!window?.sessionStorage) {\n\t\treturn dummyThemeStore satisfies ThemeStore<Themes>\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\treturn readSessionStorage(themes, storageKey, { parse })\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\twriteSessionStorage(themes, storageKey, entry, { stringify, onError })\n\t\t\tnotify()\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\thandlers.add(handler)\n\n\t\t\tconst onStorage = (e: StorageEvent) => {\n\t\t\t\tif (e.key === storageKey && e.storageArea === window.sessionStorage) notify()\n\t\t\t}\n\t\t\twindow.addEventListener('storage', onStorage)\n\n\t\t\treturn () => {\n\t\t\t\thandlers.delete(handler)\n\t\t\t\twindow.removeEventListener('storage', onStorage)\n\t\t\t}\n\t\t}\n\t} satisfies ThemeStore<Themes>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,yBACf,QACA,SAMC;CACD,MAAM,EAAE,YAAY,OAAO,WAAW,YAAY;AAElD,KAAI,CAAC,QAAQ,eACZ,QAAOA;CAGR,MAAM,2BAAW,IAAI,KAAsD;CAC3E,IAAIC,kBAA4C,MAAM,EAAE,SAAS;CAEjE,SAAS,OAAO;AACf,SAAOC,gDAAmB,QAAQ,YAAY,EAAE,OAAO,CAAC;;CAGzD,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,qDAAoB,QAAQ,YAAY,OAAO;IAAE;IAAW;IAAS,CAAC;AACtE,WAAQ;;EAET,UAAU,SAAS;AAClB,YAAS,IAAI,QAAQ;GAErB,MAAM,aAAa,MAAoB;AACtC,QAAI,EAAE,QAAQ,cAAc,EAAE,gBAAgB,OAAO,eAAgB,SAAQ;;AAE9E,UAAO,iBAAiB,WAAW,UAAU;AAE7C,gBAAa;AACZ,aAAS,OAAO,QAAQ;AACxB,WAAO,oBAAoB,WAAW,UAAU;;;EAGlD"}

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

@@ -1,5 +1,5 @@
 import { ThemeMap } from "../../theme-map.types.cjs";
-import { ThemeEntry } from "../../theme-entry.types.cjs";
+import { ParseStoredTheme, StringifyStoredTheme, ThemeEntry } from "../../theme-entry.types.cjs";
 
 //#region src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.d.ts
 
@@ -11,6 +11,9 @@ import { ThemeEntry } from "../../theme-entry.types.cjs";
  *
  * @param themes - Record mapping theme keys to values (for validation)
  * @param options.storageKey - sessionStorage key
+ * @param options.parse - Optional custom parser for stored string (default: parseStoredTheme)
+ * @param options.stringify - Optional custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when storage write throws
  * @returns ThemeStore
  *
  * @example
@@ -24,10 +27,13 @@ import { ThemeEntry } from "../../theme-entry.types.cjs";
  */
 declare function sessionStorageThemeStore<Themes extends ThemeMap>(themes: Themes, options: {
   storageKey: string;
+  parse?: ParseStoredTheme<Themes> | undefined;
+  stringify?: StringifyStoredTheme<Themes> | undefined;
+  onError?: ((error: unknown) => void) | undefined;
 }): {
   read: () => ThemeEntry<Themes> | undefined;
   write(entry: ThemeEntry<Themes> | undefined): void;
-  subscribe(handler: (theme: ThemeEntry<Themes> | null | undefined) => void): () => void;
+  subscribe(handler: (theme: ThemeEntry<Themes> | undefined) => void): () => void;
 };
 //#endregion
 export { sessionStorageThemeStore };

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

@@ -1 +1 @@
-{"version":3,"file":"session-storage-theme-store.d.cts","names":[],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0BA;;;;;;;;;;;;;;;;;iBAAgB,wCAAwC,kBAC/C"}
+{"version":3,"file":"session-storage-theme-store.d.cts","names":[],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6BA;;;;;;;;;;;;;;;;;;;;iBAAgB,wCAAwC,kBAC/C;;UAGC,iBAAiB;cACb,qBAAqB"}

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

@@ -1,5 +1,5 @@
 import { ThemeMap } from "../../theme-map.types.mjs";
-import { ThemeEntry } from "../../theme-entry.types.mjs";
+import { ParseStoredTheme, StringifyStoredTheme, ThemeEntry } from "../../theme-entry.types.mjs";
 
 //#region src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.d.ts
 
@@ -11,6 +11,9 @@ import { ThemeEntry } from "../../theme-entry.types.mjs";
  *
  * @param themes - Record mapping theme keys to values (for validation)
  * @param options.storageKey - sessionStorage key
+ * @param options.parse - Optional custom parser for stored string (default: parseStoredTheme)
+ * @param options.stringify - Optional custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when storage write throws
  * @returns ThemeStore
  *
  * @example
@@ -24,10 +27,13 @@ import { ThemeEntry } from "../../theme-entry.types.mjs";
  */
 declare function sessionStorageThemeStore<Themes extends ThemeMap>(themes: Themes, options: {
   storageKey: string;
+  parse?: ParseStoredTheme<Themes> | undefined;
+  stringify?: StringifyStoredTheme<Themes> | undefined;
+  onError?: ((error: unknown) => void) | undefined;
 }): {
   read: () => ThemeEntry<Themes> | undefined;
   write(entry: ThemeEntry<Themes> | undefined): void;
-  subscribe(handler: (theme: ThemeEntry<Themes> | null | undefined) => void): () => void;
+  subscribe(handler: (theme: ThemeEntry<Themes> | undefined) => void): () => void;
 };
 //#endregion
 export { sessionStorageThemeStore };

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

@@ -1 +1 @@
-{"version":3,"file":"session-storage-theme-store.d.mts","names":[],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0BA;;;;;;;;;;;;;;;;;iBAAgB,wCAAwC,kBAC/C"}
+{"version":3,"file":"session-storage-theme-store.d.mts","names":[],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6BA;;;;;;;;;;;;;;;;;;;;iBAAgB,wCAAwC,kBAC/C;;UAGC,iBAAiB;cACb,qBAAqB"}

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

@@ -1,6 +1,6 @@
-import { themeEntry } from "../../theme-entry.mjs";
 import { dummyThemeStore } from "../../../testing/theme/dummy-theme-store.mjs";
-import { parseStoredTheme } from "../../_utils/parse-stored-theme.mjs";
+import { readSessionStorage } from "../../session-storage/read-session-storage.mjs";
+import { writeSessionStorage } from "../../session-storage/write-session-storage.mjs";
 
 //#region src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts
 /**
@@ -11,6 +11,9 @@ import { parseStoredTheme } from "../../_utils/parse-stored-theme.mjs";
 *
 * @param themes - Record mapping theme keys to values (for validation)
 * @param options.storageKey - sessionStorage key
+* @param options.parse - Optional custom parser for stored string (default: parseStoredTheme)
+* @param options.stringify - Optional custom serializer (default: JSON.stringify)
+* @param options.onError - Optional callback invoked when storage write throws
 * @returns ThemeStore
 *
 * @example
@@ -23,14 +26,12 @@ import { parseStoredTheme } from "../../_utils/parse-stored-theme.mjs";
 * ```
 */
 function sessionStorageThemeStore(themes, options) {
-	const { storageKey } = options;
-	if (typeof window === "undefined" || !window.sessionStorage) return dummyThemeStore;
+	const { storageKey, parse, stringify, onError } = options;
+	if (!window?.sessionStorage) return dummyThemeStore;
 	const handlers = /* @__PURE__ */ new Set();
 	let lastNotifiedKey = read()?.theme ?? void 0;
 	function read() {
-		const theme = parseStoredTheme(themes, window.sessionStorage.getItem(storageKey));
-		if (theme === void 0) return void 0;
-		return themeEntry(themes, theme);
+		return readSessionStorage(themes, storageKey, { parse });
 	}
 	function notify() {
 		const result = read();
@@ -42,11 +43,11 @@ function sessionStorageThemeStore(themes, options) {
 	return {
 		read,
 		write(entry) {
-			try {
-				if (entry === void 0) window.sessionStorage.removeItem(storageKey);
-				else window.sessionStorage.setItem(storageKey, JSON.stringify(entry));
-				notify();
-			} catch {}
+			writeSessionStorage(themes, storageKey, entry, {
+				stringify,
+				onError
+			});
+			notify();
 		},
 		subscribe(handler) {
 			handlers.add(handler);

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

@@ -1 +1 @@
-{"version":3,"file":"session-storage-theme-store.mjs","names":["lastNotifiedKey: keyof Themes | undefined"],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":["import { 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\n/**\n * Creates a theme store backed by sessionStorage.\n *\n * Persists per tab; cross-tab sync via StorageEvent when available.\n * Same-tab writes trigger manual notify (StorageEvent does not fire for same tab).\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options.storageKey - sessionStorage key\n * @returns ThemeStore\n *\n * @example\n * ```ts\n * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }\n * const store = sessionStorageThemeStore(themes, { storageKey: 'theme' })\n * store.read() // returns themeResult from sessionStorage\n * store.write(themeEntry(themes, 'grayscale'))\n * store.subscribe((themeResult) => {})\n * ```\n */\nexport function sessionStorageThemeStore<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions: { storageKey: string }\n) {\n\tconst { storageKey } = options\n\n\tif (typeof window === 'undefined' || !window.sessionStorage) {\n\t\treturn dummyThemeStore satisfies ThemeStore<Themes>\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 = window.sessionStorage.getItem(storageKey)\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\twindow.sessionStorage.removeItem(storageKey)\n\t\t\t\t} else {\n\t\t\t\t\twindow.sessionStorage.setItem(storageKey, JSON.stringify(entry))\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\n\t\t\tconst onStorage = (e: StorageEvent) => {\n\t\t\t\tif (e.key === storageKey && e.storageArea === window.sessionStorage) notify()\n\t\t\t}\n\t\t\twindow.addEventListener('storage', onStorage)\n\n\t\t\treturn () => {\n\t\t\t\thandlers.delete(handler)\n\t\t\t\twindow.removeEventListener('storage', onStorage)\n\t\t\t}\n\t\t}\n\t} satisfies ThemeStore<Themes>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,yBACf,QACA,SACC;CACD,MAAM,EAAE,eAAe;AAEvB,KAAI,OAAO,WAAW,eAAe,CAAC,OAAO,eAC5C,QAAO;CAGR,MAAM,2BAAW,IAAI,KAAsD;CAC3E,IAAIA,kBAA4C,MAAM,EAAE,SAAS;CAEjE,SAAS,OAAO;EAEf,MAAM,QAAQ,iBAAiB,QADhB,OAAO,eAAe,QAAQ,WAAW,CACV;AAC9C,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,WAAW,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,QAAO,eAAe,WAAW,WAAW;QAE5C,QAAO,eAAe,QAAQ,YAAY,KAAK,UAAU,MAAM,CAAC;AAEjE,YAAQ;WACD;;EAIT,UAAU,SAAS;AAClB,YAAS,IAAI,QAAQ;GAErB,MAAM,aAAa,MAAoB;AACtC,QAAI,EAAE,QAAQ,cAAc,EAAE,gBAAgB,OAAO,eAAgB,SAAQ;;AAE9E,UAAO,iBAAiB,WAAW,UAAU;AAE7C,gBAAa;AACZ,aAAS,OAAO,QAAQ;AACxB,WAAO,oBAAoB,WAAW,UAAU;;;EAGlD"}
+{"version":3,"file":"session-storage-theme-store.mjs","names":["lastNotifiedKey: keyof Themes | undefined"],"sources":["../../../../src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts"],"sourcesContent":["import { dummyThemeStore } from '../../../testing/theme/dummy-theme-store.ts'\nimport { readSessionStorage } from '../../session-storage/read-session-storage.ts'\nimport { writeSessionStorage } from '../../session-storage/write-session-storage.ts'\nimport type { ParseStoredTheme, StringifyStoredTheme, ThemeEntry } 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 backed by sessionStorage.\n *\n * Persists per tab; cross-tab sync via StorageEvent when available.\n * Same-tab writes trigger manual notify (StorageEvent does not fire for same tab).\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options.storageKey - sessionStorage key\n * @param options.parse - Optional custom parser for stored string (default: parseStoredTheme)\n * @param options.stringify - Optional custom serializer (default: JSON.stringify)\n * @param options.onError - Optional callback invoked when storage write throws\n * @returns ThemeStore\n *\n * @example\n * ```ts\n * const themes = { current: 'theme-current', grayscale: 'theme-grayscale' }\n * const store = sessionStorageThemeStore(themes, { storageKey: 'theme' })\n * store.read() // returns themeResult from sessionStorage\n * store.write(themeEntry(themes, 'grayscale'))\n * store.subscribe((themeResult) => {})\n * ```\n */\nexport function sessionStorageThemeStore<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions: {\n\t\tstorageKey: string\n\t\tparse?: ParseStoredTheme<Themes> | undefined\n\t\tstringify?: StringifyStoredTheme<Themes> | undefined\n\t\tonError?: ((error: unknown) => void) | undefined\n\t}\n) {\n\tconst { storageKey, parse, stringify, onError } = options\n\n\tif (!window?.sessionStorage) {\n\t\treturn dummyThemeStore satisfies ThemeStore<Themes>\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\treturn readSessionStorage(themes, storageKey, { parse })\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\twriteSessionStorage(themes, storageKey, entry, { stringify, onError })\n\t\t\tnotify()\n\t\t},\n\t\tsubscribe(handler) {\n\t\t\thandlers.add(handler)\n\n\t\t\tconst onStorage = (e: StorageEvent) => {\n\t\t\t\tif (e.key === storageKey && e.storageArea === window.sessionStorage) notify()\n\t\t\t}\n\t\t\twindow.addEventListener('storage', onStorage)\n\n\t\t\treturn () => {\n\t\t\t\thandlers.delete(handler)\n\t\t\t\twindow.removeEventListener('storage', onStorage)\n\t\t\t}\n\t\t}\n\t} satisfies ThemeStore<Themes>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,yBACf,QACA,SAMC;CACD,MAAM,EAAE,YAAY,OAAO,WAAW,YAAY;AAElD,KAAI,CAAC,QAAQ,eACZ,QAAO;CAGR,MAAM,2BAAW,IAAI,KAAsD;CAC3E,IAAIA,kBAA4C,MAAM,EAAE,SAAS;CAEjE,SAAS,OAAO;AACf,SAAO,mBAAmB,QAAQ,YAAY,EAAE,OAAO,CAAC;;CAGzD,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,uBAAoB,QAAQ,YAAY,OAAO;IAAE;IAAW;IAAS,CAAC;AACtE,WAAQ;;EAET,UAAU,SAAS;AAClB,YAAS,IAAI,QAAQ;GAErB,MAAM,aAAa,MAAoB;AACtC,QAAI,EAAE,QAAQ,cAAc,EAAE,gBAAgB,OAAO,eAAgB,SAAQ;;AAE9E,UAAO,iBAAiB,WAAW,UAAU;AAE7C,gBAAa;AACZ,aAAS,OAAO,QAAQ;AACxB,WAAO,oBAAoB,WAAW,UAAU;;;EAGlD"}

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

@@ -26,7 +26,7 @@ import { ThemeEntry } from "../theme-entry.types.cjs";
 interface ThemeStore<Themes extends ThemeMap = ThemeMap> {
   read?: (() => ThemeEntry<Themes> | undefined) | undefined;
   write?: ((entry: ThemeEntry<Themes> | undefined) => void) | undefined;
-  subscribe?: ((handler: (theme: ThemeEntry<Themes> | undefined | null) => void) => () => void) | undefined;
+  subscribe?: ((handler: (theme: ThemeEntry<Themes> | undefined) => void) => () => void) | undefined;
 }
 //#endregion
 export { ThemeStore };

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

@@ -1 +1 @@
-{"version":3,"file":"theme-store.types.d.cts","names":[],"sources":["../../../src/theme/theme-store/theme-store.types.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuBA;;;;;;;;;;;;;;;;;;UAAiB,0BAA0B,WAAW;gBACvC,WAAW;mBACR,WAAW;iCAEN,WAAW"}
+{"version":3,"file":"theme-store.types.d.cts","names":[],"sources":["../../../src/theme/theme-store/theme-store.types.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuBA;;;;;;;;;;;;;;;;;;UAAiB,0BAA0B,WAAW;gBACvC,WAAW;mBACR,WAAW;iCACG,WAAW"}

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

@@ -26,7 +26,7 @@ import { ThemeEntry } from "../theme-entry.types.mjs";
 interface ThemeStore<Themes extends ThemeMap = ThemeMap> {
   read?: (() => ThemeEntry<Themes> | undefined) | undefined;
   write?: ((entry: ThemeEntry<Themes> | undefined) => void) | undefined;
-  subscribe?: ((handler: (theme: ThemeEntry<Themes> | undefined | null) => void) => () => void) | undefined;
+  subscribe?: ((handler: (theme: ThemeEntry<Themes> | undefined) => void) => () => void) | undefined;
 }
 //#endregion
 export { ThemeStore };

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

@@ -1 +1 @@
-{"version":3,"file":"theme-store.types.d.mts","names":[],"sources":["../../../src/theme/theme-store/theme-store.types.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuBA;;;;;;;;;;;;;;;;;;UAAiB,0BAA0B,WAAW;gBACvC,WAAW;mBACR,WAAW;iCAEN,WAAW"}
+{"version":3,"file":"theme-store.types.d.mts","names":[],"sources":["../../../src/theme/theme-store/theme-store.types.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuBA;;;;;;;;;;;;;;;;;;UAAiB,0BAA0B,WAAW;gBACvC,WAAW;mBACR,WAAW;iCACG,WAAW"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-web-storage.cjs","names":["parseStoredTheme"],"sources":["../../../src/theme/web-storage/read-web-storage.ts"],"sourcesContent":["import { parseStoredTheme } from '../_utils/parse-stored-theme.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Reads a theme entry from a web storage (localStorage or sessionStorage).\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param storageKey - Storage key to read from\n * @param options.storage - Storage object (localStorage or sessionStorage)\n * @param options.parse - Custom parser (default: parseStoredTheme)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when storage is unavailable (e.g. SSR).\n */\nexport function readWebStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\toptions: { storage: Storage; parse?: ParseStoredTheme<Themes> | undefined }\n): ThemeEntry<Themes> | undefined {\n\tconst { storage, parse = parseStoredTheme } = options\n\tconst stored = storage.getItem(storageKey)\n\treturn parse(themes, stored ?? undefined)\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,eACf,QACA,YACA,SACiC;CACjC,MAAM,EAAE,SAAS,QAAQA,gDAAqB;AAE9C,QAAO,MAAM,QADE,QAAQ,QAAQ,WAAW,IACX,OAAU"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-web-storage.d.cts","names":[],"sources":["../../../src/theme/web-storage/read-web-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAaA;;;;;;;AAIG,iBAJa,cAIb,CAAA,eAJ2C,QAI3C,CAAA,CAAA,MAAA,EAHM,MAGN,EAAA,UAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAU,OAAA,EADQ,OACR;UADyB,iBAAiB;IACpD,WAAW"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-web-storage.d.mts","names":[],"sources":["../../../src/theme/web-storage/read-web-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAaA;;;;;;;AAIG,iBAJa,cAIb,CAAA,eAJ2C,QAI3C,CAAA,CAAA,MAAA,EAHM,MAGN,EAAA,UAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAU,OAAA,EADQ,OACR;UADyB,iBAAiB;IACpD,WAAW"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-web-storage.mjs","names":[],"sources":["../../../src/theme/web-storage/read-web-storage.ts"],"sourcesContent":["import { parseStoredTheme } from '../_utils/parse-stored-theme.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Reads a theme entry from a web storage (localStorage or sessionStorage).\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param storageKey - Storage key to read from\n * @param options.storage - Storage object (localStorage or sessionStorage)\n * @param options.parse - Custom parser (default: parseStoredTheme)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when storage is unavailable (e.g. SSR).\n */\nexport function readWebStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\toptions: { storage: Storage; parse?: ParseStoredTheme<Themes> | undefined }\n): ThemeEntry<Themes> | undefined {\n\tconst { storage, parse = parseStoredTheme } = options\n\tconst stored = storage.getItem(storageKey)\n\treturn parse(themes, stored ?? undefined)\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,eACf,QACA,YACA,SACiC;CACjC,MAAM,EAAE,SAAS,QAAQ,qBAAqB;AAE9C,QAAO,MAAM,QADE,QAAQ,QAAQ,WAAW,IACX,OAAU"}

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

@@ -0,0 +1,33 @@
+
+//#region src/theme/web-storage/write-web-storage.ts
+function defaultStringify(_themes, _existing, entry) {
+	return entry == null ? "" : JSON.stringify(entry);
+}
+/**
+* Writes a theme entry to a web storage (localStorage or 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 - Storage key to write to
+* @param entry - Theme entry to write, or null/undefined to remove
+* @param options.storage - Storage object (localStorage or sessionStorage)
+* @param options.stringify - Custom serializer (default: JSON.stringify)
+* @param options.onError - Optional callback invoked when setItem/removeItem throws
+*/
+function writeWebStorage(themes, storageKey, entry, options) {
+	const { storage, stringify = defaultStringify, onError } = options;
+	try {
+		if (entry == null) storage.removeItem(storageKey);
+		else {
+			const value = stringify(themes, storage.getItem(storageKey) ?? void 0, entry);
+			storage.setItem(storageKey, value);
+		}
+	} catch (error) {
+		onError?.(error);
+	}
+}
+
+//#endregion
+exports.writeWebStorage = writeWebStorage;
+//# sourceMappingURL=write-web-storage.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-web-storage.cjs","names":[],"sources":["../../../src/theme/web-storage/write-web-storage.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\nfunction defaultStringify<Themes extends ThemeMap>(\n\t_themes: Themes,\n\t_existing: string | undefined,\n\tentry: ThemeEntry<Themes> | null | undefined\n): string {\n\treturn entry == null ? '' : JSON.stringify(entry)\n}\n\n/**\n * Writes a theme entry to a web storage (localStorage or 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 - Storage key to write to\n * @param entry - Theme entry to write, or null/undefined to remove\n * @param options.storage - Storage object (localStorage or sessionStorage)\n * @param options.stringify - Custom serializer (default: JSON.stringify)\n * @param options.onError - Optional callback invoked when setItem/removeItem throws\n */\nexport function writeWebStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions: {\n\t\tstorage: Storage\n\t\tstringify?: StringifyStoredTheme<Themes> | undefined\n\t\tonError?: ((error: unknown) => void) | undefined\n\t}\n): void {\n\tconst { storage, stringify = defaultStringify, onError } = options\n\ttry {\n\t\tif (entry == null) {\n\t\t\tstorage.removeItem(storageKey)\n\t\t} else {\n\t\t\tconst existing = storage.getItem(storageKey) ?? undefined\n\t\t\tconst value = stringify(themes, existing, entry)\n\t\t\tstorage.setItem(storageKey, value)\n\t\t}\n\t} catch (error) {\n\t\tonError?.(error)\n\t}\n}\n"],"mappings":";;AAGA,SAAS,iBACR,SACA,WACA,OACS;AACT,QAAO,SAAS,OAAO,KAAK,KAAK,UAAU,MAAM;;;;;;;;;;;;;;AAelD,SAAgB,gBACf,QACA,YACA,OACA,SAKO;CACP,MAAM,EAAE,SAAS,YAAY,kBAAkB,YAAY;AAC3D,KAAI;AACH,MAAI,SAAS,KACZ,SAAQ,WAAW,WAAW;OACxB;GAEN,MAAM,QAAQ,UAAU,QADP,QAAQ,QAAQ,WAAW,IAAI,QACN,MAAM;AAChD,WAAQ,QAAQ,YAAY,MAAM;;UAE3B,OAAO;AACf,YAAU,MAAM"}

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

@@ -0,0 +1,25 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { StringifyStoredTheme, ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/web-storage/write-web-storage.d.ts
+
+/**
+ * Writes a theme entry to a web storage (localStorage or 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 - Storage key to write to
+ * @param entry - Theme entry to write, or null/undefined to remove
+ * @param options.storage - Storage object (localStorage or sessionStorage)
+ * @param options.stringify - Custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when setItem/removeItem throws
+ */
+declare function writeWebStorage<Themes extends ThemeMap>(themes: Themes, storageKey: string, entry: ThemeEntry<Themes> | null | undefined, options: {
+  storage: Storage;
+  stringify?: StringifyStoredTheme<Themes> | undefined;
+  onError?: ((error: unknown) => void) | undefined;
+}): void;
+//#endregion
+export { writeWebStorage };
+//# sourceMappingURL=write-web-storage.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-web-storage.d.cts","names":[],"sources":["../../../src/theme/web-storage/write-web-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuBA;;;;;;;;;;iBAAgB,+BAA+B,kBACtC,mCAED,WAAW;WAER;cACG,qBAAqB"}

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

@@ -0,0 +1,25 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { StringifyStoredTheme, ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/web-storage/write-web-storage.d.ts
+
+/**
+ * Writes a theme entry to a web storage (localStorage or 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 - Storage key to write to
+ * @param entry - Theme entry to write, or null/undefined to remove
+ * @param options.storage - Storage object (localStorage or sessionStorage)
+ * @param options.stringify - Custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when setItem/removeItem throws
+ */
+declare function writeWebStorage<Themes extends ThemeMap>(themes: Themes, storageKey: string, entry: ThemeEntry<Themes> | null | undefined, options: {
+  storage: Storage;
+  stringify?: StringifyStoredTheme<Themes> | undefined;
+  onError?: ((error: unknown) => void) | undefined;
+}): void;
+//#endregion
+export { writeWebStorage };
+//# sourceMappingURL=write-web-storage.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-web-storage.d.mts","names":[],"sources":["../../../src/theme/web-storage/write-web-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuBA;;;;;;;;;;iBAAgB,+BAA+B,kBACtC,mCAED,WAAW;WAER;cACG,qBAAqB"}

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

@@ -0,0 +1,32 @@
+//#region src/theme/web-storage/write-web-storage.ts
+function defaultStringify(_themes, _existing, entry) {
+	return entry == null ? "" : JSON.stringify(entry);
+}
+/**
+* Writes a theme entry to a web storage (localStorage or 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 - Storage key to write to
+* @param entry - Theme entry to write, or null/undefined to remove
+* @param options.storage - Storage object (localStorage or sessionStorage)
+* @param options.stringify - Custom serializer (default: JSON.stringify)
+* @param options.onError - Optional callback invoked when setItem/removeItem throws
+*/
+function writeWebStorage(themes, storageKey, entry, options) {
+	const { storage, stringify = defaultStringify, onError } = options;
+	try {
+		if (entry == null) storage.removeItem(storageKey);
+		else {
+			const value = stringify(themes, storage.getItem(storageKey) ?? void 0, entry);
+			storage.setItem(storageKey, value);
+		}
+	} catch (error) {
+		onError?.(error);
+	}
+}
+
+//#endregion
+export { writeWebStorage };
+//# sourceMappingURL=write-web-storage.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-web-storage.mjs","names":[],"sources":["../../../src/theme/web-storage/write-web-storage.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\nfunction defaultStringify<Themes extends ThemeMap>(\n\t_themes: Themes,\n\t_existing: string | undefined,\n\tentry: ThemeEntry<Themes> | null | undefined\n): string {\n\treturn entry == null ? '' : JSON.stringify(entry)\n}\n\n/**\n * Writes a theme entry to a web storage (localStorage or 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 - Storage key to write to\n * @param entry - Theme entry to write, or null/undefined to remove\n * @param options.storage - Storage object (localStorage or sessionStorage)\n * @param options.stringify - Custom serializer (default: JSON.stringify)\n * @param options.onError - Optional callback invoked when setItem/removeItem throws\n */\nexport function writeWebStorage<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstorageKey: string,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions: {\n\t\tstorage: Storage\n\t\tstringify?: StringifyStoredTheme<Themes> | undefined\n\t\tonError?: ((error: unknown) => void) | undefined\n\t}\n): void {\n\tconst { storage, stringify = defaultStringify, onError } = options\n\ttry {\n\t\tif (entry == null) {\n\t\t\tstorage.removeItem(storageKey)\n\t\t} else {\n\t\t\tconst existing = storage.getItem(storageKey) ?? undefined\n\t\t\tconst value = stringify(themes, existing, entry)\n\t\t\tstorage.setItem(storageKey, value)\n\t\t}\n\t} catch (error) {\n\t\tonError?.(error)\n\t}\n}\n"],"mappings":";AAGA,SAAS,iBACR,SACA,WACA,OACS;AACT,QAAO,SAAS,OAAO,KAAK,KAAK,UAAU,MAAM;;;;;;;;;;;;;;AAelD,SAAgB,gBACf,QACA,YACA,OACA,SAKO;CACP,MAAM,EAAE,SAAS,YAAY,kBAAkB,YAAY;AAC3D,KAAI;AACH,MAAI,SAAS,KACZ,SAAQ,WAAW,WAAW;OACxB;GAEN,MAAM,QAAQ,UAAU,QADP,QAAQ,QAAQ,WAAW,IAAI,QACN,MAAM;AAChD,WAAQ,QAAQ,YAAY,MAAM;;UAE3B,OAAO;AACf,YAAU,MAAM"}