@just-web/toolkits 1.0.0

package/dist/theme/_utils/parse-stored-theme.cjs

@@ -0,0 +1,22 @@
+const require_try_parse_json = require('../../_internal/utils/try-parse-json.cjs');
+
+//#region src/theme/_utils/parse-stored-theme.ts
+/**
+* Parses stored JSON theme and validates the theme key against theme map.
+*
+* Expects stored shape: { theme: string, value?: unknown }
+*
+* @param themes - Record of valid theme keys (optional; if omitted, any theme string is accepted)
+* @param value - Raw string from localStorage/sessionStorage
+* @returns Theme key if valid, otherwise undefined
+*/
+function parseStoredTheme(themes, value) {
+	const parsed = require_try_parse_json.tryParseJSON(value);
+	if (!parsed?.theme || typeof parsed.theme !== "string") return void 0;
+	if (themes && !(parsed.theme in themes)) return void 0;
+	return parsed.theme;
+}
+
+//#endregion
+exports.parseStoredTheme = parseStoredTheme;
+//# sourceMappingURL=parse-stored-theme.cjs.map

package/dist/theme/_utils/parse-stored-theme.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stored-theme.cjs","names":["tryParseJSON"],"sources":["../../../src/theme/_utils/parse-stored-theme.ts"],"sourcesContent":["import { tryParseJSON } from '../../_internal/utils/try-parse-json.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Parses stored JSON theme and validates the theme key against theme map.\n *\n * Expects stored shape: { theme: string, value?: unknown }\n *\n * @param themes - Record of valid theme keys (optional; if omitted, any theme string is accepted)\n * @param value - Raw string from localStorage/sessionStorage\n * @returns Theme key if valid, otherwise undefined\n */\nexport function parseStoredTheme<Theme extends string>(\n\tthemes: ThemeMap<Theme> | undefined,\n\tvalue: string | null | undefined\n): Theme | undefined {\n\tconst parsed = tryParseJSON<{ theme: string }>(value)\n\tif (!parsed?.theme || typeof parsed.theme !== 'string') return undefined\n\tif (themes && !(parsed.theme in themes)) return undefined\n\treturn parsed.theme as Theme\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,iBACf,QACA,OACoB;CACpB,MAAM,SAASA,oCAAgC,MAAM;AACrD,KAAI,CAAC,QAAQ,SAAS,OAAO,OAAO,UAAU,SAAU,QAAO;AAC/D,KAAI,UAAU,EAAE,OAAO,SAAS,QAAS,QAAO;AAChD,QAAO,OAAO"}

package/dist/theme/_utils/parse-stored-theme.mjs

@@ -0,0 +1,22 @@
+import { tryParseJSON } from "../../_internal/utils/try-parse-json.mjs";
+
+//#region src/theme/_utils/parse-stored-theme.ts
+/**
+* Parses stored JSON theme and validates the theme key against theme map.
+*
+* Expects stored shape: { theme: string, value?: unknown }
+*
+* @param themes - Record of valid theme keys (optional; if omitted, any theme string is accepted)
+* @param value - Raw string from localStorage/sessionStorage
+* @returns Theme key if valid, otherwise undefined
+*/
+function parseStoredTheme(themes, value) {
+	const parsed = tryParseJSON(value);
+	if (!parsed?.theme || typeof parsed.theme !== "string") return void 0;
+	if (themes && !(parsed.theme in themes)) return void 0;
+	return parsed.theme;
+}
+
+//#endregion
+export { parseStoredTheme };
+//# sourceMappingURL=parse-stored-theme.mjs.map

package/dist/theme/_utils/parse-stored-theme.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stored-theme.mjs","names":[],"sources":["../../../src/theme/_utils/parse-stored-theme.ts"],"sourcesContent":["import { tryParseJSON } from '../../_internal/utils/try-parse-json.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Parses stored JSON theme and validates the theme key against theme map.\n *\n * Expects stored shape: { theme: string, value?: unknown }\n *\n * @param themes - Record of valid theme keys (optional; if omitted, any theme string is accepted)\n * @param value - Raw string from localStorage/sessionStorage\n * @returns Theme key if valid, otherwise undefined\n */\nexport function parseStoredTheme<Theme extends string>(\n\tthemes: ThemeMap<Theme> | undefined,\n\tvalue: string | null | undefined\n): Theme | undefined {\n\tconst parsed = tryParseJSON<{ theme: string }>(value)\n\tif (!parsed?.theme || typeof parsed.theme !== 'string') return undefined\n\tif (themes && !(parsed.theme in themes)) return undefined\n\treturn parsed.theme as Theme\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,iBACf,QACA,OACoB;CACpB,MAAM,SAAS,aAAgC,MAAM;AACrD,KAAI,CAAC,QAAQ,SAAS,OAAO,OAAO,UAAU,SAAU,QAAO;AAC/D,KAAI,UAAU,EAAE,OAAO,SAAS,QAAS,QAAO;AAChD,QAAO,OAAO"}

package/dist/theme/_utils/set-theme-to-stores.cjs

@@ -0,0 +1,16 @@
+
+//#region src/theme/_utils/set-theme-to-stores.ts
+/**
+* Writes theme entry to all stores that have a write method.
+*
+* @param stores - Array of theme stores
+* @param entry - Theme entry to write, or undefined to clear
+*/
+async function setThemeToStores(stores, entry) {
+	const withWrite = stores.filter((s) => typeof s.write === "function");
+	await Promise.all(withWrite.map((store) => Promise.resolve(store.write(entry))));
+}
+
+//#endregion
+exports.setThemeToStores = setThemeToStores;
+//# sourceMappingURL=set-theme-to-stores.cjs.map

package/dist/theme/_utils/set-theme-to-stores.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-theme-to-stores.cjs","names":[],"sources":["../../../src/theme/_utils/set-theme-to-stores.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport type { AsyncThemeStore } from '../theme-store/async-theme-store.types.ts'\nimport type { ThemeStore } from '../theme-store/theme-store.types.ts'\n\ntype StoreWithWrite<Themes extends ThemeMap> = (ThemeStore<Themes> | AsyncThemeStore<Themes>) & {\n\twrite: (entry: ThemeEntry<Themes> | undefined) => void | Promise<void>\n}\n\n/**\n * Writes theme entry to all stores that have a write method.\n *\n * @param stores - Array of theme stores\n * @param entry - Theme entry to write, or undefined to clear\n */\nexport async function setThemeToStores<Themes extends ThemeMap>(\n\tstores: (ThemeStore<Themes> | AsyncThemeStore<Themes>)[],\n\tentry: ThemeEntry<Themes> | undefined\n): Promise<void> {\n\tconst withWrite = stores.filter((s): s is StoreWithWrite<Themes> => typeof s.write === 'function')\n\n\tawait Promise.all(withWrite.map((store) => Promise.resolve(store.write!(entry))))\n}\n"],"mappings":";;;;;;;;AAeA,eAAsB,iBACrB,QACA,OACgB;CAChB,MAAM,YAAY,OAAO,QAAQ,MAAmC,OAAO,EAAE,UAAU,WAAW;AAElG,OAAM,QAAQ,IAAI,UAAU,KAAK,UAAU,QAAQ,QAAQ,MAAM,MAAO,MAAM,CAAC,CAAC,CAAC"}

package/dist/theme/_utils/set-theme-to-stores.mjs

@@ -0,0 +1,15 @@
+//#region src/theme/_utils/set-theme-to-stores.ts
+/**
+* Writes theme entry to all stores that have a write method.
+*
+* @param stores - Array of theme stores
+* @param entry - Theme entry to write, or undefined to clear
+*/
+async function setThemeToStores(stores, entry) {
+	const withWrite = stores.filter((s) => typeof s.write === "function");
+	await Promise.all(withWrite.map((store) => Promise.resolve(store.write(entry))));
+}
+
+//#endregion
+export { setThemeToStores };
+//# sourceMappingURL=set-theme-to-stores.mjs.map

package/dist/theme/_utils/set-theme-to-stores.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-theme-to-stores.mjs","names":[],"sources":["../../../src/theme/_utils/set-theme-to-stores.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport type { AsyncThemeStore } from '../theme-store/async-theme-store.types.ts'\nimport type { ThemeStore } from '../theme-store/theme-store.types.ts'\n\ntype StoreWithWrite<Themes extends ThemeMap> = (ThemeStore<Themes> | AsyncThemeStore<Themes>) & {\n\twrite: (entry: ThemeEntry<Themes> | undefined) => void | Promise<void>\n}\n\n/**\n * Writes theme entry to all stores that have a write method.\n *\n * @param stores - Array of theme stores\n * @param entry - Theme entry to write, or undefined to clear\n */\nexport async function setThemeToStores<Themes extends ThemeMap>(\n\tstores: (ThemeStore<Themes> | AsyncThemeStore<Themes>)[],\n\tentry: ThemeEntry<Themes> | undefined\n): Promise<void> {\n\tconst withWrite = stores.filter((s): s is StoreWithWrite<Themes> => typeof s.write === 'function')\n\n\tawait Promise.all(withWrite.map((store) => Promise.resolve(store.write!(entry))))\n}\n"],"mappings":";;;;;;;AAeA,eAAsB,iBACrB,QACA,OACgB;CAChB,MAAM,YAAY,OAAO,QAAQ,MAAmC,OAAO,EAAE,UAAU,WAAW;AAElG,OAAM,QAAQ,IAAI,UAAU,KAAK,UAAU,QAAQ,QAAQ,MAAM,MAAO,MAAM,CAAC,CAAC,CAAC"}

package/dist/theme/class-name/apply-theme-to-class-name.cjs

@@ -0,0 +1,23 @@
+
+//#region src/theme/class-name/apply-theme-to-class-name.ts
+/**
+* Applies theme to element by updating its class attribute.
+*
+* Removes all theme classes from the element, then adds classes for the given entry.
+* When entry is undefined, removes all theme classes (themeMap needed for clear path).
+*
+* @param element - Target element
+* @param entry - Theme entry to apply, or undefined to clear
+* @param themes - Record mapping theme keys to class names (used for clear case)
+*/
+function applyThemeToClassName(themes, element, entry) {
+	const allThemeClasses = Object.values(themes).flatMap((v) => Array.isArray(v) ? [...v] : [v]);
+	const current = element.className.trim();
+	const withoutThemes = (current ? current.split(/\s+/) : []).filter((c) => !allThemeClasses.includes(c));
+	const activeClasses = entry !== void 0 ? Array.isArray(entry.value) ? [...entry.value] : [entry.value] : [];
+	element.className = [...withoutThemes, ...activeClasses].filter(Boolean).join(" ");
+}
+
+//#endregion
+exports.applyThemeToClassName = applyThemeToClassName;
+//# sourceMappingURL=apply-theme-to-class-name.cjs.map

package/dist/theme/class-name/apply-theme-to-class-name.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-theme-to-class-name.cjs","names":[],"sources":["../../../src/theme/class-name/apply-theme-to-class-name.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Applies theme to element by updating its class attribute.\n *\n * Removes all theme classes from the element, then adds classes for the given entry.\n * When entry is undefined, removes all theme classes (themeMap needed for clear path).\n *\n * @param element - Target element\n * @param entry - Theme entry to apply, or undefined to clear\n * @param themes - Record mapping theme keys to class names (used for clear case)\n */\nexport function applyThemeToClassName<Themes extends ThemeMap>(\n\tthemes: Themes,\n\telement: Element,\n\tentry: ThemeEntry<Themes> | undefined\n): void {\n\tconst allThemeClasses = Object.values(themes).flatMap((v) => (Array.isArray(v) ? [...v] : [v]))\n\tconst current = element.className.trim()\n\tconst currentClasses = current ? current.split(/\\s+/) : []\n\tconst withoutThemes = currentClasses.filter((c) => !allThemeClasses.includes(c))\n\tconst activeClasses =\n\t\tentry !== undefined ? (Array.isArray(entry.value) ? [...entry.value] : [entry.value]) : []\n\telement.className = [...withoutThemes, ...activeClasses].filter(Boolean).join(' ')\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,sBACf,QACA,SACA,OACO;CACP,MAAM,kBAAkB,OAAO,OAAO,OAAO,CAAC,SAAS,MAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAE;CAC/F,MAAM,UAAU,QAAQ,UAAU,MAAM;CAExC,MAAM,iBADiB,UAAU,QAAQ,MAAM,MAAM,GAAG,EAAE,EACrB,QAAQ,MAAM,CAAC,gBAAgB,SAAS,EAAE,CAAC;CAChF,MAAM,gBACL,UAAU,SAAa,MAAM,QAAQ,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,GAAI,EAAE;AAC3F,SAAQ,YAAY,CAAC,GAAG,eAAe,GAAG,cAAc,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI"}

package/dist/theme/class-name/apply-theme-to-class-name.mjs

@@ -0,0 +1,22 @@
+//#region src/theme/class-name/apply-theme-to-class-name.ts
+/**
+* Applies theme to element by updating its class attribute.
+*
+* Removes all theme classes from the element, then adds classes for the given entry.
+* When entry is undefined, removes all theme classes (themeMap needed for clear path).
+*
+* @param element - Target element
+* @param entry - Theme entry to apply, or undefined to clear
+* @param themes - Record mapping theme keys to class names (used for clear case)
+*/
+function applyThemeToClassName(themes, element, entry) {
+	const allThemeClasses = Object.values(themes).flatMap((v) => Array.isArray(v) ? [...v] : [v]);
+	const current = element.className.trim();
+	const withoutThemes = (current ? current.split(/\s+/) : []).filter((c) => !allThemeClasses.includes(c));
+	const activeClasses = entry !== void 0 ? Array.isArray(entry.value) ? [...entry.value] : [entry.value] : [];
+	element.className = [...withoutThemes, ...activeClasses].filter(Boolean).join(" ");
+}
+
+//#endregion
+export { applyThemeToClassName };
+//# sourceMappingURL=apply-theme-to-class-name.mjs.map

package/dist/theme/class-name/apply-theme-to-class-name.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-theme-to-class-name.mjs","names":[],"sources":["../../../src/theme/class-name/apply-theme-to-class-name.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Applies theme to element by updating its class attribute.\n *\n * Removes all theme classes from the element, then adds classes for the given entry.\n * When entry is undefined, removes all theme classes (themeMap needed for clear path).\n *\n * @param element - Target element\n * @param entry - Theme entry to apply, or undefined to clear\n * @param themes - Record mapping theme keys to class names (used for clear case)\n */\nexport function applyThemeToClassName<Themes extends ThemeMap>(\n\tthemes: Themes,\n\telement: Element,\n\tentry: ThemeEntry<Themes> | undefined\n): void {\n\tconst allThemeClasses = Object.values(themes).flatMap((v) => (Array.isArray(v) ? [...v] : [v]))\n\tconst current = element.className.trim()\n\tconst currentClasses = current ? current.split(/\\s+/) : []\n\tconst withoutThemes = currentClasses.filter((c) => !allThemeClasses.includes(c))\n\tconst activeClasses =\n\t\tentry !== undefined ? (Array.isArray(entry.value) ? [...entry.value] : [entry.value]) : []\n\telement.className = [...withoutThemes, ...activeClasses].filter(Boolean).join(' ')\n}\n"],"mappings":";;;;;;;;;;;AAaA,SAAgB,sBACf,QACA,SACA,OACO;CACP,MAAM,kBAAkB,OAAO,OAAO,OAAO,CAAC,SAAS,MAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAE;CAC/F,MAAM,UAAU,QAAQ,UAAU,MAAM;CAExC,MAAM,iBADiB,UAAU,QAAQ,MAAM,MAAM,GAAG,EAAE,EACrB,QAAQ,MAAM,CAAC,gBAAgB,SAAS,EAAE,CAAC;CAChF,MAAM,gBACL,UAAU,SAAa,MAAM,QAAQ,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,GAAI,EAAE;AAC3F,SAAQ,YAAY,CAAC,GAAG,eAAe,GAAG,cAAc,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI"}

package/dist/theme/class-name/resolve-theme-from-class-name.cjs

@@ -0,0 +1,23 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let type_plus = require("type-plus");
+
+//#region src/theme/class-name/resolve-theme-from-class-name.ts
+/**
+* Resolves theme key from class name string by matching against theme map.
+*
+* @param className - Element class attribute value
+* @param themes - Record mapping theme keys to class name(s); arrays use first value for matching
+* @returns Theme key if a match is found, otherwise undefined
+*/
+function resolveThemeFromClassName(themes, className) {
+	return (0, type_plus.findKey)(themes, (key) => {
+		const value = themes[key];
+		if (value === void 0) return false;
+		const v = Array.isArray(value) ? value[0] : value;
+		return !!v && className.includes(v);
+	});
+}
+
+//#endregion
+exports.resolveThemeFromClassName = resolveThemeFromClassName;
+//# sourceMappingURL=resolve-theme-from-class-name.cjs.map

package/dist/theme/class-name/resolve-theme-from-class-name.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-theme-from-class-name.cjs","names":[],"sources":["../../../src/theme/class-name/resolve-theme-from-class-name.ts"],"sourcesContent":["import { findKey } from 'type-plus'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Resolves theme key from class name string by matching against theme map.\n *\n * @param className - Element class attribute value\n * @param themes - Record mapping theme keys to class name(s); arrays use first value for matching\n * @returns Theme key if a match is found, otherwise undefined\n */\nexport function resolveThemeFromClassName<Theme extends string>(\n\tthemes: ThemeMap<Theme>,\n\tclassName: string\n): Theme | undefined {\n\tconst theme = findKey(themes, (key) => {\n\t\tconst value = themes[key]\n\t\tif (value === undefined) return false\n\t\tconst v = Array.isArray(value) ? value[0] : value\n\t\treturn !!v && className.includes(v)\n\t})\n\treturn theme as Theme | undefined\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,0BACf,QACA,WACoB;AAOpB,+BANsB,SAAS,QAAQ;EACtC,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,OAAW,QAAO;EAChC,MAAM,IAAI,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK;AAC5C,SAAO,CAAC,CAAC,KAAK,UAAU,SAAS,EAAE;GAClC"}

package/dist/theme/class-name/resolve-theme-from-class-name.mjs

@@ -0,0 +1,22 @@
+import { findKey } from "type-plus";
+
+//#region src/theme/class-name/resolve-theme-from-class-name.ts
+/**
+* Resolves theme key from class name string by matching against theme map.
+*
+* @param className - Element class attribute value
+* @param themes - Record mapping theme keys to class name(s); arrays use first value for matching
+* @returns Theme key if a match is found, otherwise undefined
+*/
+function resolveThemeFromClassName(themes, className) {
+	return findKey(themes, (key) => {
+		const value = themes[key];
+		if (value === void 0) return false;
+		const v = Array.isArray(value) ? value[0] : value;
+		return !!v && className.includes(v);
+	});
+}
+
+//#endregion
+export { resolveThemeFromClassName };
+//# sourceMappingURL=resolve-theme-from-class-name.mjs.map

package/dist/theme/class-name/resolve-theme-from-class-name.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-theme-from-class-name.mjs","names":[],"sources":["../../../src/theme/class-name/resolve-theme-from-class-name.ts"],"sourcesContent":["import { findKey } from 'type-plus'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Resolves theme key from class name string by matching against theme map.\n *\n * @param className - Element class attribute value\n * @param themes - Record mapping theme keys to class name(s); arrays use first value for matching\n * @returns Theme key if a match is found, otherwise undefined\n */\nexport function resolveThemeFromClassName<Theme extends string>(\n\tthemes: ThemeMap<Theme>,\n\tclassName: string\n): Theme | undefined {\n\tconst theme = findKey(themes, (key) => {\n\t\tconst value = themes[key]\n\t\tif (value === undefined) return false\n\t\tconst v = Array.isArray(value) ? value[0] : value\n\t\treturn !!v && className.includes(v)\n\t})\n\treturn theme as Theme | undefined\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,0BACf,QACA,WACoB;AAOpB,QANc,QAAQ,SAAS,QAAQ;EACtC,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,OAAW,QAAO;EAChC,MAAM,IAAI,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK;AAC5C,SAAO,CAAC,CAAC,KAAK,UAAU,SAAS,EAAE;GAClC"}

package/dist/theme/compose-theme-stores.cjs

@@ -0,0 +1,74 @@
+const require_set_theme_to_stores = require('./_utils/set-theme-to-stores.cjs');
+const require_theme_entry = require('./theme-entry.cjs');
+
+//#region src/theme/compose-theme-stores.ts
+/**
+* Composes multiple theme stores into a single store.
+*
+* Accepts concrete stores or store factory tuples `[factory]` or `[factory, options]`.
+* For factory tuples, calls `factory(themes)` or `factory(themes, options)` to create stores.
+*
+* - **read**: Returns first non-empty `ThemeEntry` from stores (waterfall). When all empty
+*   and `defaultTheme` is defined, returns `themeEntry(themes, defaultTheme)`.
+* - **write**: Delegates to `setThemeToStores` (writes to all stores with write).
+* - **subscribe**: Aggregates child store subscriptions. No initial notify—handler is only
+*   called when a child store emits.
+*
+* @param themes - ThemeMap for synthesizing fallback ThemeEntry
+* @param stores - Array of theme stores or factory configs [factory, options?]
+* @param options.defaultTheme - Fallback theme key when all stores return empty
+* @returns AsyncThemeStore
+*/
+function composeThemeStores(themes, stores, options) {
+	const { defaultTheme } = options ?? {};
+	const resolved = resolveStores(themes, stores);
+	const withRead = resolved.filter((s) => typeof s.read === "function");
+	async function readFromStores() {
+		for (const store of withRead) {
+			const result = await Promise.resolve(store.read());
+			if (result !== void 0) return result;
+		}
+		return defaultTheme !== void 0 ? require_theme_entry.themeEntry(themes, defaultTheme) : void 0;
+	}
+	const withSubscribe = resolved.filter((s) => typeof s.subscribe === "function");
+	function subscribe(handler) {
+		let scheduled = false;
+		let lastEmitted;
+		const scheduleNotify = () => {
+			if (scheduled) return;
+			scheduled = true;
+			queueMicrotask(async () => {
+				scheduled = false;
+				const entry = await readFromStores();
+				const key = entry?.theme ?? void 0;
+				if (key === lastEmitted) return;
+				lastEmitted = key;
+				handler(entry ?? void 0);
+			});
+		};
+		const unSubs = withSubscribe.map((s) => s.subscribe((_result) => scheduleNotify()));
+		return () => {
+			for (const unSub of unSubs) unSub();
+		};
+	}
+	return {
+		read: readFromStores,
+		write(entry) {
+			return require_set_theme_to_stores.setThemeToStores(resolved, entry);
+		},
+		subscribe: withSubscribe.length > 0 ? subscribe : () => () => {}
+	};
+}
+function resolveStores(themes, stores) {
+	return stores.map((item) => {
+		if (Array.isArray(item)) {
+			const [factory, options] = item;
+			return factory(themes, options);
+		}
+		return item;
+	});
+}
+
+//#endregion
+exports.composeThemeStores = composeThemeStores;
+//# sourceMappingURL=compose-theme-stores.cjs.map

package/dist/theme/compose-theme-stores.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-theme-stores.cjs","names":["themeEntry","lastEmitted: keyof Themes | undefined","setThemeToStores"],"sources":["../../src/theme/compose-theme-stores.ts"],"sourcesContent":["import type { Required, RequiredPick } from 'type-plus'\nimport { setThemeToStores } from './_utils/set-theme-to-stores.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 { AsyncThemeStore } from './theme-store/async-theme-store.types.ts'\nimport type { ThemeStore } from './theme-store/theme-store.types.ts'\nimport type { ThemeStoreFactory } from './theme-store/theme-store-factory.types.ts'\n\n/** Input item for one position: concrete store or factory config [factory, options?]. */\nexport type ComposeThemeStoreEntry<\n\tThemes extends ThemeMap,\n\tF extends ThemeStoreFactory<Themes> = never\n> = ThemeStore<Themes> | AsyncThemeStore<Themes> | readonly [F] | readonly [F, Parameters<F>[1]]\n\nexport type ComposeThemeStoresOptions<Themes extends ThemeMap> = {\n\tdefaultTheme?: keyof Themes | undefined\n}\n\n/**\n * Composes multiple theme stores into a single store.\n *\n * Accepts concrete stores or store factory tuples `[factory]` or `[factory, options]`.\n * For factory tuples, calls `factory(themes)` or `factory(themes, options)` to create stores.\n *\n * - **read**: Returns first non-empty `ThemeEntry` from stores (waterfall). When all empty\n *   and `defaultTheme` is defined, returns `themeEntry(themes, defaultTheme)`.\n * - **write**: Delegates to `setThemeToStores` (writes to all stores with write).\n * - **subscribe**: Aggregates child store subscriptions. No initial notify—handler is only\n *   called when a child store emits.\n *\n * @param themes - ThemeMap for synthesizing fallback ThemeEntry\n * @param stores - Array of theme stores or factory configs [factory, options?]\n * @param options.defaultTheme - Fallback theme key when all stores return empty\n * @returns AsyncThemeStore\n */\nexport function composeThemeStores<\n\tThemes extends ThemeMap,\n\tA extends ThemeStoreFactory<Themes> = never,\n\tB extends ThemeStoreFactory<Themes> = never,\n\tC extends ThemeStoreFactory<Themes> = never,\n\tD extends ThemeStoreFactory<Themes> = never,\n\tE extends ThemeStoreFactory<Themes> = never,\n\tF extends ThemeStoreFactory<Themes> = never,\n\tG extends ThemeStoreFactory<Themes> = never,\n\tH extends ThemeStoreFactory<Themes> = never\n>(\n\tthemes: Themes,\n\tstores: readonly [\n\t\tstore1: ComposeThemeStoreEntry<Themes, A>,\n\t\tstore2?: ComposeThemeStoreEntry<Themes, B>,\n\t\tstore3?: ComposeThemeStoreEntry<Themes, C>,\n\t\tstore4?: ComposeThemeStoreEntry<Themes, D>,\n\t\tstore5?: ComposeThemeStoreEntry<Themes, E>,\n\t\tstore6?: ComposeThemeStoreEntry<Themes, F>,\n\t\tstore7?: ComposeThemeStoreEntry<Themes, G>,\n\t\tstore8?: ComposeThemeStoreEntry<Themes, H>\n\t],\n\toptions?: ComposeThemeStoresOptions<Themes> | undefined\n): Required<AsyncThemeStore<Themes>> {\n\tconst { defaultTheme } = options ?? {}\n\tconst resolved = resolveStores(themes, stores)\n\tconst withRead = resolved.filter((s): s is StoreWithRead<Themes> => typeof s.read === 'function')\n\n\tasync function readFromStores(): Promise<ThemeEntry<Themes> | undefined> {\n\t\tfor (const store of withRead) {\n\t\t\tconst result = await Promise.resolve(store.read())\n\t\t\tif (result !== undefined) return result\n\t\t}\n\t\treturn defaultTheme !== undefined ? themeEntry(themes, defaultTheme) : undefined\n\t}\n\n\tconst withSubscribe = resolved.filter(\n\t\t(s): s is StoreWithSubscribe<Themes> => typeof s.subscribe === 'function'\n\t)\n\n\tfunction subscribe(handler: (theme: ThemeEntry<Themes> | undefined | null) => void): () => void {\n\t\tlet scheduled = false\n\t\tlet lastEmitted: keyof Themes | undefined\n\n\t\tconst scheduleNotify = () => {\n\t\t\tif (scheduled) return\n\t\t\tscheduled = true\n\t\t\tqueueMicrotask(async () => {\n\t\t\t\tscheduled = false\n\t\t\t\tconst entry = await readFromStores()\n\t\t\t\tconst key = entry?.theme ?? undefined\n\t\t\t\tif (key === lastEmitted) return\n\t\t\t\tlastEmitted = key\n\t\t\t\thandler(entry ?? undefined)\n\t\t\t})\n\t\t}\n\n\t\tconst unSubs = withSubscribe.map((s) => s.subscribe!((_result) => scheduleNotify()))\n\n\t\treturn () => {\n\t\t\tfor (const unSub of unSubs) {\n\t\t\t\tunSub()\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tread: readFromStores,\n\t\twrite(entry) {\n\t\t\treturn setThemeToStores(resolved, entry)\n\t\t},\n\t\tsubscribe: withSubscribe.length > 0 ? subscribe : () => () => {}\n\t}\n}\n\ntype StoreWithRead<Themes extends ThemeMap> = RequiredPick<AsyncThemeStore<Themes>, 'read'>\n\ntype StoreWithSubscribe<Themes extends ThemeMap> = RequiredPick<\n\tAsyncThemeStore<Themes>,\n\t'subscribe'\n>\n\nfunction resolveStores<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstores: readonly [\n\t\tstore1: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore2?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore3?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore4?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore5?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore6?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore7?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore8?: ComposeThemeStoreEntry<Themes, any>\n\t]\n): (ThemeStore<Themes> | AsyncThemeStore<Themes>)[] {\n\treturn stores.map((item) => {\n\t\tif (Array.isArray(item)) {\n\t\t\tconst [factory, options] = item\n\t\t\treturn (factory as (t: Themes, o?: unknown) => ThemeStore<Themes>)(themes, options)\n\t\t}\n\t\treturn item as ThemeStore<Themes> | AsyncThemeStore<Themes>\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,mBAWf,QACA,QAUA,SACoC;CACpC,MAAM,EAAE,iBAAiB,WAAW,EAAE;CACtC,MAAM,WAAW,cAAc,QAAQ,OAAO;CAC9C,MAAM,WAAW,SAAS,QAAQ,MAAkC,OAAO,EAAE,SAAS,WAAW;CAEjG,eAAe,iBAA0D;AACxE,OAAK,MAAM,SAAS,UAAU;GAC7B,MAAM,SAAS,MAAM,QAAQ,QAAQ,MAAM,MAAM,CAAC;AAClD,OAAI,WAAW,OAAW,QAAO;;AAElC,SAAO,iBAAiB,SAAYA,+BAAW,QAAQ,aAAa,GAAG;;CAGxE,MAAM,gBAAgB,SAAS,QAC7B,MAAuC,OAAO,EAAE,cAAc,WAC/D;CAED,SAAS,UAAU,SAA6E;EAC/F,IAAI,YAAY;EAChB,IAAIC;EAEJ,MAAM,uBAAuB;AAC5B,OAAI,UAAW;AACf,eAAY;AACZ,kBAAe,YAAY;AAC1B,gBAAY;IACZ,MAAM,QAAQ,MAAM,gBAAgB;IACpC,MAAM,MAAM,OAAO,SAAS;AAC5B,QAAI,QAAQ,YAAa;AACzB,kBAAc;AACd,YAAQ,SAAS,OAAU;KAC1B;;EAGH,MAAM,SAAS,cAAc,KAAK,MAAM,EAAE,WAAY,YAAY,gBAAgB,CAAC,CAAC;AAEpF,eAAa;AACZ,QAAK,MAAM,SAAS,OACnB,QAAO;;;AAKV,QAAO;EACN,MAAM;EACN,MAAM,OAAO;AACZ,UAAOC,6CAAiB,UAAU,MAAM;;EAEzC,WAAW,cAAc,SAAS,IAAI,wBAAwB;EAC9D;;AAUF,SAAS,cACR,QACA,QAUmD;AACnD,QAAO,OAAO,KAAK,SAAS;AAC3B,MAAI,MAAM,QAAQ,KAAK,EAAE;GACxB,MAAM,CAAC,SAAS,WAAW;AAC3B,UAAQ,QAA2D,QAAQ,QAAQ;;AAEpF,SAAO;GACN"}

package/dist/theme/compose-theme-stores.d.cts

@@ -0,0 +1,33 @@
+import { ThemeMap } from "./theme-map.types.cjs";
+import { AsyncThemeStore } from "./theme-store/async-theme-store.types.cjs";
+import { ThemeStore } from "./theme-store/theme-store.types.cjs";
+import { ThemeStoreFactory } from "./theme-store/theme-store-factory.types.cjs";
+import { Required } from "type-plus";
+
+//#region src/theme/compose-theme-stores.d.ts
+/** Input item for one position: concrete store or factory config [factory, options?]. */
+type ComposeThemeStoreEntry<Themes extends ThemeMap, F extends ThemeStoreFactory<Themes> = never> = ThemeStore<Themes> | AsyncThemeStore<Themes> | readonly [F] | readonly [F, Parameters<F>[1]];
+type ComposeThemeStoresOptions<Themes extends ThemeMap> = {
+  defaultTheme?: keyof Themes | undefined;
+};
+/**
+ * Composes multiple theme stores into a single store.
+ *
+ * Accepts concrete stores or store factory tuples `[factory]` or `[factory, options]`.
+ * For factory tuples, calls `factory(themes)` or `factory(themes, options)` to create stores.
+ *
+ * - **read**: Returns first non-empty `ThemeEntry` from stores (waterfall). When all empty
+ *   and `defaultTheme` is defined, returns `themeEntry(themes, defaultTheme)`.
+ * - **write**: Delegates to `setThemeToStores` (writes to all stores with write).
+ * - **subscribe**: Aggregates child store subscriptions. No initial notify—handler is only
+ *   called when a child store emits.
+ *
+ * @param themes - ThemeMap for synthesizing fallback ThemeEntry
+ * @param stores - Array of theme stores or factory configs [factory, options?]
+ * @param options.defaultTheme - Fallback theme key when all stores return empty
+ * @returns AsyncThemeStore
+ */
+declare function composeThemeStores<Themes extends ThemeMap, A extends ThemeStoreFactory<Themes> = never, B extends ThemeStoreFactory<Themes> = never, C extends ThemeStoreFactory<Themes> = never, D extends ThemeStoreFactory<Themes> = never, E extends ThemeStoreFactory<Themes> = never, F extends ThemeStoreFactory<Themes> = never, G extends ThemeStoreFactory<Themes> = never, H extends ThemeStoreFactory<Themes> = never>(themes: Themes, stores: readonly [store1: ComposeThemeStoreEntry<Themes, A>, store2?: ComposeThemeStoreEntry<Themes, B>, store3?: ComposeThemeStoreEntry<Themes, C>, store4?: ComposeThemeStoreEntry<Themes, D>, store5?: ComposeThemeStoreEntry<Themes, E>, store6?: ComposeThemeStoreEntry<Themes, F>, store7?: ComposeThemeStoreEntry<Themes, G>, store8?: ComposeThemeStoreEntry<Themes, H>], options?: ComposeThemeStoresOptions<Themes> | undefined): Required<AsyncThemeStore<Themes>>;
+//#endregion
+export { ComposeThemeStoreEntry, ComposeThemeStoresOptions, composeThemeStores };
+//# sourceMappingURL=compose-theme-stores.d.cts.map

package/dist/theme/compose-theme-stores.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-theme-stores.d.cts","names":[],"sources":["../../src/theme/compose-theme-stores.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAUY,sCACI,oBACL,kBAAkB,mBACzB,WAAW,UAAU,gBAAgB,oBAAoB,eAAe,GAAG,WAAW;AAH9E,KAKA,yBALsB,CAAA,eAKmB,QALnB,CAAA,GAAA;EAClB,YAAA,CAAA,EAAA,MAKM,MALN,GAAA,SAAA;CACa;;;;;;;;;;;AAG7B;AAqBA;;;;;;AAI6B,iBAJb,kBAIa,CAAA,eAHb,QAGa,EAAA,UAFlB,iBAEkB,CAFA,MAEA,CAAA,GAAA,KAAA,EAAA,UADlB,iBACkB,CADA,MACA,CAAA,GAAA,KAAA,EAAA,UAAlB,iBAAkB,CAAA,MAAA,CAAA,GAAA,KAAA,EAAA,UAClB,iBADkB,CACA,MADA,CAAA,GAAA,KAAA,EAAA,UAElB,iBAFkB,CAEA,MAFA,CAAA,GAAA,KAAA,EAAA,UAGlB,iBAHkB,CAGA,MAHA,CAAA,GAAA,KAAA,EAAA,UAIlB,iBAJkB,CAIA,MAJA,CAAA,GAAA,KAAA,EAAA,UAKlB,iBALkB,CAKA,MALA,CAAA,GAAA,KAAA,CAAA,CAAA,MAAA,EAOpB,MAPoB,EAAA,MAAA,EAAA,SAAA,CAAlB,MAAA,EASD,sBATC,CASsB,MATtB,EAS8B,CAT9B,CAAA,EACkB,MAAA,GASlB,sBATkB,CASK,MATL,EASa,CATb,CAAA,EAAlB,MAAA,GAUA,sBAVA,CAUuB,MAVvB,EAU+B,CAV/B,CAAA,EACkB,MAAA,GAUlB,sBAVkB,CAUK,MAVL,EAUa,CAVb,CAAA,EAAlB,MAAA,GAWA,sBAXA,CAWuB,MAXvB,EAW+B,CAX/B,CAAA,EACkB,MAAA,GAWlB,sBAXkB,CAWK,MAXL,EAWa,CAXb,CAAA,EAAlB,MAAA,GAYA,sBAZA,CAYuB,MAZvB,EAY+B,CAZ/B,CAAA,EACkB,MAAA,GAYlB,sBAZkB,CAYK,MAZL,EAYa,CAZb,CAAA,CAAlB,EAAA,OAAA,CAAA,EAcA,yBAdA,CAc0B,MAd1B,CAAA,GAAA,SAAA,CAAA,EAeR,QAfQ,CAeC,eAfD,CAeiB,MAfjB,CAAA,CAAA"}

package/dist/theme/compose-theme-stores.d.mts

@@ -0,0 +1,33 @@
+import { ThemeMap } from "./theme-map.types.mjs";
+import { AsyncThemeStore } from "./theme-store/async-theme-store.types.mjs";
+import { ThemeStore } from "./theme-store/theme-store.types.mjs";
+import { ThemeStoreFactory } from "./theme-store/theme-store-factory.types.mjs";
+import { Required } from "type-plus";
+
+//#region src/theme/compose-theme-stores.d.ts
+/** Input item for one position: concrete store or factory config [factory, options?]. */
+type ComposeThemeStoreEntry<Themes extends ThemeMap, F extends ThemeStoreFactory<Themes> = never> = ThemeStore<Themes> | AsyncThemeStore<Themes> | readonly [F] | readonly [F, Parameters<F>[1]];
+type ComposeThemeStoresOptions<Themes extends ThemeMap> = {
+  defaultTheme?: keyof Themes | undefined;
+};
+/**
+ * Composes multiple theme stores into a single store.
+ *
+ * Accepts concrete stores or store factory tuples `[factory]` or `[factory, options]`.
+ * For factory tuples, calls `factory(themes)` or `factory(themes, options)` to create stores.
+ *
+ * - **read**: Returns first non-empty `ThemeEntry` from stores (waterfall). When all empty
+ *   and `defaultTheme` is defined, returns `themeEntry(themes, defaultTheme)`.
+ * - **write**: Delegates to `setThemeToStores` (writes to all stores with write).
+ * - **subscribe**: Aggregates child store subscriptions. No initial notify—handler is only
+ *   called when a child store emits.
+ *
+ * @param themes - ThemeMap for synthesizing fallback ThemeEntry
+ * @param stores - Array of theme stores or factory configs [factory, options?]
+ * @param options.defaultTheme - Fallback theme key when all stores return empty
+ * @returns AsyncThemeStore
+ */
+declare function composeThemeStores<Themes extends ThemeMap, A extends ThemeStoreFactory<Themes> = never, B extends ThemeStoreFactory<Themes> = never, C extends ThemeStoreFactory<Themes> = never, D extends ThemeStoreFactory<Themes> = never, E extends ThemeStoreFactory<Themes> = never, F extends ThemeStoreFactory<Themes> = never, G extends ThemeStoreFactory<Themes> = never, H extends ThemeStoreFactory<Themes> = never>(themes: Themes, stores: readonly [store1: ComposeThemeStoreEntry<Themes, A>, store2?: ComposeThemeStoreEntry<Themes, B>, store3?: ComposeThemeStoreEntry<Themes, C>, store4?: ComposeThemeStoreEntry<Themes, D>, store5?: ComposeThemeStoreEntry<Themes, E>, store6?: ComposeThemeStoreEntry<Themes, F>, store7?: ComposeThemeStoreEntry<Themes, G>, store8?: ComposeThemeStoreEntry<Themes, H>], options?: ComposeThemeStoresOptions<Themes> | undefined): Required<AsyncThemeStore<Themes>>;
+//#endregion
+export { ComposeThemeStoreEntry, ComposeThemeStoresOptions, composeThemeStores };
+//# sourceMappingURL=compose-theme-stores.d.mts.map

package/dist/theme/compose-theme-stores.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-theme-stores.d.mts","names":[],"sources":["../../src/theme/compose-theme-stores.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAUY,sCACI,oBACL,kBAAkB,mBACzB,WAAW,UAAU,gBAAgB,oBAAoB,eAAe,GAAG,WAAW;AAH9E,KAKA,yBALsB,CAAA,eAKmB,QALnB,CAAA,GAAA;EAClB,YAAA,CAAA,EAAA,MAKM,MALN,GAAA,SAAA;CACa;;;;;;;;;;;AAG7B;AAqBA;;;;;;AAI6B,iBAJb,kBAIa,CAAA,eAHb,QAGa,EAAA,UAFlB,iBAEkB,CAFA,MAEA,CAAA,GAAA,KAAA,EAAA,UADlB,iBACkB,CADA,MACA,CAAA,GAAA,KAAA,EAAA,UAAlB,iBAAkB,CAAA,MAAA,CAAA,GAAA,KAAA,EAAA,UAClB,iBADkB,CACA,MADA,CAAA,GAAA,KAAA,EAAA,UAElB,iBAFkB,CAEA,MAFA,CAAA,GAAA,KAAA,EAAA,UAGlB,iBAHkB,CAGA,MAHA,CAAA,GAAA,KAAA,EAAA,UAIlB,iBAJkB,CAIA,MAJA,CAAA,GAAA,KAAA,EAAA,UAKlB,iBALkB,CAKA,MALA,CAAA,GAAA,KAAA,CAAA,CAAA,MAAA,EAOpB,MAPoB,EAAA,MAAA,EAAA,SAAA,CAAlB,MAAA,EASD,sBATC,CASsB,MATtB,EAS8B,CAT9B,CAAA,EACkB,MAAA,GASlB,sBATkB,CASK,MATL,EASa,CATb,CAAA,EAAlB,MAAA,GAUA,sBAVA,CAUuB,MAVvB,EAU+B,CAV/B,CAAA,EACkB,MAAA,GAUlB,sBAVkB,CAUK,MAVL,EAUa,CAVb,CAAA,EAAlB,MAAA,GAWA,sBAXA,CAWuB,MAXvB,EAW+B,CAX/B,CAAA,EACkB,MAAA,GAWlB,sBAXkB,CAWK,MAXL,EAWa,CAXb,CAAA,EAAlB,MAAA,GAYA,sBAZA,CAYuB,MAZvB,EAY+B,CAZ/B,CAAA,EACkB,MAAA,GAYlB,sBAZkB,CAYK,MAZL,EAYa,CAZb,CAAA,CAAlB,EAAA,OAAA,CAAA,EAcA,yBAdA,CAc0B,MAd1B,CAAA,GAAA,SAAA,CAAA,EAeR,QAfQ,CAeC,eAfD,CAeiB,MAfjB,CAAA,CAAA"}

package/dist/theme/compose-theme-stores.mjs

@@ -0,0 +1,74 @@
+import { setThemeToStores } from "./_utils/set-theme-to-stores.mjs";
+import { themeEntry } from "./theme-entry.mjs";
+
+//#region src/theme/compose-theme-stores.ts
+/**
+* Composes multiple theme stores into a single store.
+*
+* Accepts concrete stores or store factory tuples `[factory]` or `[factory, options]`.
+* For factory tuples, calls `factory(themes)` or `factory(themes, options)` to create stores.
+*
+* - **read**: Returns first non-empty `ThemeEntry` from stores (waterfall). When all empty
+*   and `defaultTheme` is defined, returns `themeEntry(themes, defaultTheme)`.
+* - **write**: Delegates to `setThemeToStores` (writes to all stores with write).
+* - **subscribe**: Aggregates child store subscriptions. No initial notify—handler is only
+*   called when a child store emits.
+*
+* @param themes - ThemeMap for synthesizing fallback ThemeEntry
+* @param stores - Array of theme stores or factory configs [factory, options?]
+* @param options.defaultTheme - Fallback theme key when all stores return empty
+* @returns AsyncThemeStore
+*/
+function composeThemeStores(themes, stores, options) {
+	const { defaultTheme } = options ?? {};
+	const resolved = resolveStores(themes, stores);
+	const withRead = resolved.filter((s) => typeof s.read === "function");
+	async function readFromStores() {
+		for (const store of withRead) {
+			const result = await Promise.resolve(store.read());
+			if (result !== void 0) return result;
+		}
+		return defaultTheme !== void 0 ? themeEntry(themes, defaultTheme) : void 0;
+	}
+	const withSubscribe = resolved.filter((s) => typeof s.subscribe === "function");
+	function subscribe(handler) {
+		let scheduled = false;
+		let lastEmitted;
+		const scheduleNotify = () => {
+			if (scheduled) return;
+			scheduled = true;
+			queueMicrotask(async () => {
+				scheduled = false;
+				const entry = await readFromStores();
+				const key = entry?.theme ?? void 0;
+				if (key === lastEmitted) return;
+				lastEmitted = key;
+				handler(entry ?? void 0);
+			});
+		};
+		const unSubs = withSubscribe.map((s) => s.subscribe((_result) => scheduleNotify()));
+		return () => {
+			for (const unSub of unSubs) unSub();
+		};
+	}
+	return {
+		read: readFromStores,
+		write(entry) {
+			return setThemeToStores(resolved, entry);
+		},
+		subscribe: withSubscribe.length > 0 ? subscribe : () => () => {}
+	};
+}
+function resolveStores(themes, stores) {
+	return stores.map((item) => {
+		if (Array.isArray(item)) {
+			const [factory, options] = item;
+			return factory(themes, options);
+		}
+		return item;
+	});
+}
+
+//#endregion
+export { composeThemeStores };
+//# sourceMappingURL=compose-theme-stores.mjs.map

package/dist/theme/compose-theme-stores.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-theme-stores.mjs","names":["lastEmitted: keyof Themes | undefined"],"sources":["../../src/theme/compose-theme-stores.ts"],"sourcesContent":["import type { Required, RequiredPick } from 'type-plus'\nimport { setThemeToStores } from './_utils/set-theme-to-stores.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 { AsyncThemeStore } from './theme-store/async-theme-store.types.ts'\nimport type { ThemeStore } from './theme-store/theme-store.types.ts'\nimport type { ThemeStoreFactory } from './theme-store/theme-store-factory.types.ts'\n\n/** Input item for one position: concrete store or factory config [factory, options?]. */\nexport type ComposeThemeStoreEntry<\n\tThemes extends ThemeMap,\n\tF extends ThemeStoreFactory<Themes> = never\n> = ThemeStore<Themes> | AsyncThemeStore<Themes> | readonly [F] | readonly [F, Parameters<F>[1]]\n\nexport type ComposeThemeStoresOptions<Themes extends ThemeMap> = {\n\tdefaultTheme?: keyof Themes | undefined\n}\n\n/**\n * Composes multiple theme stores into a single store.\n *\n * Accepts concrete stores or store factory tuples `[factory]` or `[factory, options]`.\n * For factory tuples, calls `factory(themes)` or `factory(themes, options)` to create stores.\n *\n * - **read**: Returns first non-empty `ThemeEntry` from stores (waterfall). When all empty\n *   and `defaultTheme` is defined, returns `themeEntry(themes, defaultTheme)`.\n * - **write**: Delegates to `setThemeToStores` (writes to all stores with write).\n * - **subscribe**: Aggregates child store subscriptions. No initial notify—handler is only\n *   called when a child store emits.\n *\n * @param themes - ThemeMap for synthesizing fallback ThemeEntry\n * @param stores - Array of theme stores or factory configs [factory, options?]\n * @param options.defaultTheme - Fallback theme key when all stores return empty\n * @returns AsyncThemeStore\n */\nexport function composeThemeStores<\n\tThemes extends ThemeMap,\n\tA extends ThemeStoreFactory<Themes> = never,\n\tB extends ThemeStoreFactory<Themes> = never,\n\tC extends ThemeStoreFactory<Themes> = never,\n\tD extends ThemeStoreFactory<Themes> = never,\n\tE extends ThemeStoreFactory<Themes> = never,\n\tF extends ThemeStoreFactory<Themes> = never,\n\tG extends ThemeStoreFactory<Themes> = never,\n\tH extends ThemeStoreFactory<Themes> = never\n>(\n\tthemes: Themes,\n\tstores: readonly [\n\t\tstore1: ComposeThemeStoreEntry<Themes, A>,\n\t\tstore2?: ComposeThemeStoreEntry<Themes, B>,\n\t\tstore3?: ComposeThemeStoreEntry<Themes, C>,\n\t\tstore4?: ComposeThemeStoreEntry<Themes, D>,\n\t\tstore5?: ComposeThemeStoreEntry<Themes, E>,\n\t\tstore6?: ComposeThemeStoreEntry<Themes, F>,\n\t\tstore7?: ComposeThemeStoreEntry<Themes, G>,\n\t\tstore8?: ComposeThemeStoreEntry<Themes, H>\n\t],\n\toptions?: ComposeThemeStoresOptions<Themes> | undefined\n): Required<AsyncThemeStore<Themes>> {\n\tconst { defaultTheme } = options ?? {}\n\tconst resolved = resolveStores(themes, stores)\n\tconst withRead = resolved.filter((s): s is StoreWithRead<Themes> => typeof s.read === 'function')\n\n\tasync function readFromStores(): Promise<ThemeEntry<Themes> | undefined> {\n\t\tfor (const store of withRead) {\n\t\t\tconst result = await Promise.resolve(store.read())\n\t\t\tif (result !== undefined) return result\n\t\t}\n\t\treturn defaultTheme !== undefined ? themeEntry(themes, defaultTheme) : undefined\n\t}\n\n\tconst withSubscribe = resolved.filter(\n\t\t(s): s is StoreWithSubscribe<Themes> => typeof s.subscribe === 'function'\n\t)\n\n\tfunction subscribe(handler: (theme: ThemeEntry<Themes> | undefined | null) => void): () => void {\n\t\tlet scheduled = false\n\t\tlet lastEmitted: keyof Themes | undefined\n\n\t\tconst scheduleNotify = () => {\n\t\t\tif (scheduled) return\n\t\t\tscheduled = true\n\t\t\tqueueMicrotask(async () => {\n\t\t\t\tscheduled = false\n\t\t\t\tconst entry = await readFromStores()\n\t\t\t\tconst key = entry?.theme ?? undefined\n\t\t\t\tif (key === lastEmitted) return\n\t\t\t\tlastEmitted = key\n\t\t\t\thandler(entry ?? undefined)\n\t\t\t})\n\t\t}\n\n\t\tconst unSubs = withSubscribe.map((s) => s.subscribe!((_result) => scheduleNotify()))\n\n\t\treturn () => {\n\t\t\tfor (const unSub of unSubs) {\n\t\t\t\tunSub()\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tread: readFromStores,\n\t\twrite(entry) {\n\t\t\treturn setThemeToStores(resolved, entry)\n\t\t},\n\t\tsubscribe: withSubscribe.length > 0 ? subscribe : () => () => {}\n\t}\n}\n\ntype StoreWithRead<Themes extends ThemeMap> = RequiredPick<AsyncThemeStore<Themes>, 'read'>\n\ntype StoreWithSubscribe<Themes extends ThemeMap> = RequiredPick<\n\tAsyncThemeStore<Themes>,\n\t'subscribe'\n>\n\nfunction resolveStores<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tstores: readonly [\n\t\tstore1: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore2?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore3?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore4?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore5?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore6?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore7?: ComposeThemeStoreEntry<Themes, any>,\n\t\tstore8?: ComposeThemeStoreEntry<Themes, any>\n\t]\n): (ThemeStore<Themes> | AsyncThemeStore<Themes>)[] {\n\treturn stores.map((item) => {\n\t\tif (Array.isArray(item)) {\n\t\t\tconst [factory, options] = item\n\t\t\treturn (factory as (t: Themes, o?: unknown) => ThemeStore<Themes>)(themes, options)\n\t\t}\n\t\treturn item as ThemeStore<Themes> | AsyncThemeStore<Themes>\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,mBAWf,QACA,QAUA,SACoC;CACpC,MAAM,EAAE,iBAAiB,WAAW,EAAE;CACtC,MAAM,WAAW,cAAc,QAAQ,OAAO;CAC9C,MAAM,WAAW,SAAS,QAAQ,MAAkC,OAAO,EAAE,SAAS,WAAW;CAEjG,eAAe,iBAA0D;AACxE,OAAK,MAAM,SAAS,UAAU;GAC7B,MAAM,SAAS,MAAM,QAAQ,QAAQ,MAAM,MAAM,CAAC;AAClD,OAAI,WAAW,OAAW,QAAO;;AAElC,SAAO,iBAAiB,SAAY,WAAW,QAAQ,aAAa,GAAG;;CAGxE,MAAM,gBAAgB,SAAS,QAC7B,MAAuC,OAAO,EAAE,cAAc,WAC/D;CAED,SAAS,UAAU,SAA6E;EAC/F,IAAI,YAAY;EAChB,IAAIA;EAEJ,MAAM,uBAAuB;AAC5B,OAAI,UAAW;AACf,eAAY;AACZ,kBAAe,YAAY;AAC1B,gBAAY;IACZ,MAAM,QAAQ,MAAM,gBAAgB;IACpC,MAAM,MAAM,OAAO,SAAS;AAC5B,QAAI,QAAQ,YAAa;AACzB,kBAAc;AACd,YAAQ,SAAS,OAAU;KAC1B;;EAGH,MAAM,SAAS,cAAc,KAAK,MAAM,EAAE,WAAY,YAAY,gBAAgB,CAAC,CAAC;AAEpF,eAAa;AACZ,QAAK,MAAM,SAAS,OACnB,QAAO;;;AAKV,QAAO;EACN,MAAM;EACN,MAAM,OAAO;AACZ,UAAO,iBAAiB,UAAU,MAAM;;EAEzC,WAAW,cAAc,SAAS,IAAI,wBAAwB;EAC9D;;AAUF,SAAS,cACR,QACA,QAUmD;AACnD,QAAO,OAAO,KAAK,SAAS;AAC3B,MAAI,MAAM,QAAQ,KAAK,EAAE;GACxB,MAAM,CAAC,SAAS,WAAW;AAC3B,UAAQ,QAA2D,QAAQ,QAAQ;;AAEpF,SAAO;GACN"}

package/dist/theme/data-attribute/apply-theme-to-data-attribute.cjs

@@ -0,0 +1,23 @@
+
+//#region src/theme/data-attribute/apply-theme-to-data-attribute.ts
+/**
+* Applies theme to element by setting or removing a data attribute.
+*
+* @param element - Target element
+* @param attributeName - Data attribute name (e.g. `data-theme`)
+* @param entry - Theme entry to apply, or undefined to remove attribute
+*/
+function applyThemeToDataAttribute(element, attributeName, entry) {
+	if (entry === void 0) {
+		element.removeAttribute(attributeName);
+		return;
+	}
+	const val = entry.value;
+	const attributeValue = Array.isArray(val) ? val[0] : val;
+	if (attributeValue !== void 0 && attributeValue !== "") element.setAttribute(attributeName, attributeValue);
+	else element.removeAttribute(attributeName);
+}
+
+//#endregion
+exports.applyThemeToDataAttribute = applyThemeToDataAttribute;
+//# sourceMappingURL=apply-theme-to-data-attribute.cjs.map

package/dist/theme/data-attribute/apply-theme-to-data-attribute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-theme-to-data-attribute.cjs","names":[],"sources":["../../../src/theme/data-attribute/apply-theme-to-data-attribute.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Applies theme to element by setting or removing a data attribute.\n *\n * @param element - Target element\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param entry - Theme entry to apply, or undefined to remove attribute\n */\nexport function applyThemeToDataAttribute<Themes extends ThemeMap>(\n\telement: Element,\n\tattributeName: `data-${string}`,\n\tentry: ThemeEntry<Themes> | undefined\n): void {\n\tif (entry === undefined) {\n\t\telement.removeAttribute(attributeName)\n\t\treturn\n\t}\n\tconst val = entry.value\n\tconst attributeValue = Array.isArray(val) ? val[0] : val\n\tif (attributeValue !== undefined && attributeValue !== '') {\n\t\telement.setAttribute(attributeName, attributeValue)\n\t} else {\n\t\telement.removeAttribute(attributeName)\n\t}\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,0BACf,SACA,eACA,OACO;AACP,KAAI,UAAU,QAAW;AACxB,UAAQ,gBAAgB,cAAc;AACtC;;CAED,MAAM,MAAM,MAAM;CAClB,MAAM,iBAAiB,MAAM,QAAQ,IAAI,GAAG,IAAI,KAAK;AACrD,KAAI,mBAAmB,UAAa,mBAAmB,GACtD,SAAQ,aAAa,eAAe,eAAe;KAEnD,SAAQ,gBAAgB,cAAc"}

package/dist/theme/data-attribute/apply-theme-to-data-attribute.mjs

@@ -0,0 +1,22 @@
+//#region src/theme/data-attribute/apply-theme-to-data-attribute.ts
+/**
+* Applies theme to element by setting or removing a data attribute.
+*
+* @param element - Target element
+* @param attributeName - Data attribute name (e.g. `data-theme`)
+* @param entry - Theme entry to apply, or undefined to remove attribute
+*/
+function applyThemeToDataAttribute(element, attributeName, entry) {
+	if (entry === void 0) {
+		element.removeAttribute(attributeName);
+		return;
+	}
+	const val = entry.value;
+	const attributeValue = Array.isArray(val) ? val[0] : val;
+	if (attributeValue !== void 0 && attributeValue !== "") element.setAttribute(attributeName, attributeValue);
+	else element.removeAttribute(attributeName);
+}
+
+//#endregion
+export { applyThemeToDataAttribute };
+//# sourceMappingURL=apply-theme-to-data-attribute.mjs.map

package/dist/theme/data-attribute/apply-theme-to-data-attribute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-theme-to-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/apply-theme-to-data-attribute.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Applies theme to element by setting or removing a data attribute.\n *\n * @param element - Target element\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param entry - Theme entry to apply, or undefined to remove attribute\n */\nexport function applyThemeToDataAttribute<Themes extends ThemeMap>(\n\telement: Element,\n\tattributeName: `data-${string}`,\n\tentry: ThemeEntry<Themes> | undefined\n): void {\n\tif (entry === undefined) {\n\t\telement.removeAttribute(attributeName)\n\t\treturn\n\t}\n\tconst val = entry.value\n\tconst attributeValue = Array.isArray(val) ? val[0] : val\n\tif (attributeValue !== undefined && attributeValue !== '') {\n\t\telement.setAttribute(attributeName, attributeValue)\n\t} else {\n\t\telement.removeAttribute(attributeName)\n\t}\n}\n"],"mappings":";;;;;;;;AAUA,SAAgB,0BACf,SACA,eACA,OACO;AACP,KAAI,UAAU,QAAW;AACxB,UAAQ,gBAAgB,cAAc;AACtC;;CAED,MAAM,MAAM,MAAM;CAClB,MAAM,iBAAiB,MAAM,QAAQ,IAAI,GAAG,IAAI,KAAK;AACrD,KAAI,mBAAmB,UAAa,mBAAmB,GACtD,SAAQ,aAAa,eAAe,eAAe;KAEnD,SAAQ,gBAAgB,cAAc"}

package/dist/theme/data-attribute/resolve-theme-from-data-attribute.cjs

@@ -0,0 +1,23 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let type_plus = require("type-plus");
+
+//#region src/theme/data-attribute/resolve-theme-from-data-attribute.ts
+/**
+* Resolves theme key from data attribute value by matching against theme map.
+*
+* @param attrValue - Data attribute value (e.g. from getAttribute)
+* @param themes - Record mapping theme keys to attribute values
+* @returns Theme key if a match is found, otherwise undefined
+*/
+function resolveThemeFromDataAttribute(themes, attrValue) {
+	if (attrValue === null || attrValue === "") return void 0;
+	return (0, type_plus.findKey)(themes, (key) => {
+		const value = themes[key];
+		if (value === void 0) return false;
+		return (Array.isArray(value) ? value[0] : value) === attrValue;
+	});
+}
+
+//#endregion
+exports.resolveThemeFromDataAttribute = resolveThemeFromDataAttribute;
+//# sourceMappingURL=resolve-theme-from-data-attribute.cjs.map

package/dist/theme/data-attribute/resolve-theme-from-data-attribute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-theme-from-data-attribute.cjs","names":[],"sources":["../../../src/theme/data-attribute/resolve-theme-from-data-attribute.ts"],"sourcesContent":["import { findKey } from 'type-plus'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Resolves theme key from data attribute value by matching against theme map.\n *\n * @param attrValue - Data attribute value (e.g. from getAttribute)\n * @param themes - Record mapping theme keys to attribute values\n * @returns Theme key if a match is found, otherwise undefined\n */\nexport function resolveThemeFromDataAttribute<Theme extends string>(\n\tthemes: ThemeMap<Theme>,\n\tattrValue: string | null\n): Theme | undefined {\n\tif (attrValue === null || attrValue === '') return undefined\n\tconst theme = findKey(themes, (key) => {\n\t\tconst value = themes[key]\n\t\tif (value === undefined) return false\n\t\tconst v = Array.isArray(value) ? value[0] : value\n\t\treturn v === attrValue\n\t})\n\treturn theme as Theme | undefined\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,8BACf,QACA,WACoB;AACpB,KAAI,cAAc,QAAQ,cAAc,GAAI,QAAO;AAOnD,+BANsB,SAAS,QAAQ;EACtC,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,OAAW,QAAO;AAEhC,UADU,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,WAC/B;GACZ"}

package/dist/theme/data-attribute/resolve-theme-from-data-attribute.mjs

@@ -0,0 +1,22 @@
+import { findKey } from "type-plus";
+
+//#region src/theme/data-attribute/resolve-theme-from-data-attribute.ts
+/**
+* Resolves theme key from data attribute value by matching against theme map.
+*
+* @param attrValue - Data attribute value (e.g. from getAttribute)
+* @param themes - Record mapping theme keys to attribute values
+* @returns Theme key if a match is found, otherwise undefined
+*/
+function resolveThemeFromDataAttribute(themes, attrValue) {
+	if (attrValue === null || attrValue === "") return void 0;
+	return findKey(themes, (key) => {
+		const value = themes[key];
+		if (value === void 0) return false;
+		return (Array.isArray(value) ? value[0] : value) === attrValue;
+	});
+}
+
+//#endregion
+export { resolveThemeFromDataAttribute };
+//# sourceMappingURL=resolve-theme-from-data-attribute.mjs.map

package/dist/theme/data-attribute/resolve-theme-from-data-attribute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-theme-from-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/resolve-theme-from-data-attribute.ts"],"sourcesContent":["import { findKey } from 'type-plus'\nimport type { ThemeMap } from '../theme-map.types.ts'\n\n/**\n * Resolves theme key from data attribute value by matching against theme map.\n *\n * @param attrValue - Data attribute value (e.g. from getAttribute)\n * @param themes - Record mapping theme keys to attribute values\n * @returns Theme key if a match is found, otherwise undefined\n */\nexport function resolveThemeFromDataAttribute<Theme extends string>(\n\tthemes: ThemeMap<Theme>,\n\tattrValue: string | null\n): Theme | undefined {\n\tif (attrValue === null || attrValue === '') return undefined\n\tconst theme = findKey(themes, (key) => {\n\t\tconst value = themes[key]\n\t\tif (value === undefined) return false\n\t\tconst v = Array.isArray(value) ? value[0] : value\n\t\treturn v === attrValue\n\t})\n\treturn theme as Theme | undefined\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,8BACf,QACA,WACoB;AACpB,KAAI,cAAc,QAAQ,cAAc,GAAI,QAAO;AAOnD,QANc,QAAQ,SAAS,QAAQ;EACtC,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,OAAW,QAAO;AAEhC,UADU,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,WAC/B;GACZ"}

package/dist/theme/theme-entry.cjs

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