@just-web/toolkits 2.0.0 → 3.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"write-class-name.cjs","names":["stringifyClassName"],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { stringifyClassName } from './stringify-class-name.ts'\n\n/**\n * Writes a theme entry to the class attribute on an element.\n *\n * @param themes - Record mapping theme keys to class name(s)\n * @param entry - Theme entry to write, or undefined to remove the theme\n * @param options.element - Element to write to (defaults to document.documentElement)\n * @param options.stringify - Custom serializer (default: stringifyClassName)\n */\nexport function writeClassName<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tentry: ThemeEntry<Themes> | undefined,\n\toptions?:\n\t\t| { element?: Element | undefined; stringify?: StringifyStoredTheme<Themes> | undefined }\n\t\t| undefined\n): void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return\n\tconst stringify = options?.stringify ?? stringifyClassName\n\telement.className = stringify(themes, element.className ?? undefined, entry)\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,eACf,QACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;AAEd,SAAQ,aADU,SAAS,aAAaA,iDACV,QAAQ,QAAQ,aAAa,QAAW,MAAM"}
+{"version":3,"file":"write-class-name.cjs","names":["stringifyClassName"],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { stringifyClassName } from './stringify-class-name.ts'\n\n/**\n * Writes a theme entry to the class attribute on an element.\n *\n * @param themes - Record mapping theme keys to class name(s)\n * @param entry - Theme entry to write, or null/undefined to remove the theme\n * @param options.element - Element to write to (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.stringify - Custom serializer (default: stringifyClassName)\n */\nexport function writeClassName<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions?:\n\t\t| { element?: Element | null | undefined; stringify?: StringifyStoredTheme<Themes> | undefined }\n\t\t| undefined\n): void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return\n\tconst stringify = options?.stringify ?? stringifyClassName\n\telement.className = stringify(themes, element.className ?? undefined, entry)\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,eACf,QACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;AAEd,SAAQ,aADU,SAAS,aAAaA,iDACV,QAAQ,QAAQ,aAAa,QAAW,MAAM"}

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

@@ -7,12 +7,12 @@ import { StringifyStoredTheme, ThemeEntry } from "../theme-entry.types.cjs";
  * Writes a theme entry to the class attribute on an element.
  *
  * @param themes - Record mapping theme keys to class name(s)
- * @param entry - Theme entry to write, or undefined to remove the theme
- * @param options.element - Element to write to (defaults to document.documentElement)
+ * @param entry - Theme entry to write, or null/undefined to remove the theme
+ * @param options.element - Element to write to (accepts null e.g. from refs). Defaults to document.documentElement.
  * @param options.stringify - Custom serializer (default: stringifyClassName)
  */
-declare function writeClassName<Themes extends ThemeMap>(themes: Themes, entry: ThemeEntry<Themes> | undefined, options?: {
-  element?: Element | undefined;
+declare function writeClassName<Themes extends ThemeMap>(themes: Themes, entry: ThemeEntry<Themes> | null | undefined, options?: {
+  element?: Element | null | undefined;
   stringify?: StringifyStoredTheme<Themes> | undefined;
 } | undefined): void;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"write-class-name.d.cts","names":[],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;;;;;;AAIsE,iBAJtD,cAIsD,CAAA,eAJxB,QAIwB,CAAA,CAAA,MAAA,EAH7D,MAG6D,EAAA,KAAA,EAF9D,UAE8D,CAFnD,MAEmD,CAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAArB,OAAA,CAAA,EAAjC,OAAiC,GAAA,SAAA;EAAoB,SAAA,CAAA,EAApB,oBAAoB,CAAC,MAAD,CAAA,GAAA,SAAA"}
+{"version":3,"file":"write-class-name.d.cts","names":[],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;;;;;;AAI6E,iBAJ7D,cAI6D,CAAA,eAJ/B,QAI+B,CAAA,CAAA,MAAA,EAHpE,MAGoE,EAAA,KAAA,EAFrE,UAEqE,CAF1D,MAE0D,CAAA,GAAA,IAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAArB,OAAA,CAAA,EAAxC,OAAwC,GAAA,IAAA,GAAA,SAAA;EAAoB,SAAA,CAAA,EAApB,oBAAoB,CAAC,MAAD,CAAA,GAAA,SAAA"}

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

@@ -7,12 +7,12 @@ import { StringifyStoredTheme, ThemeEntry } from "../theme-entry.types.mjs";
  * Writes a theme entry to the class attribute on an element.
  *
  * @param themes - Record mapping theme keys to class name(s)
- * @param entry - Theme entry to write, or undefined to remove the theme
- * @param options.element - Element to write to (defaults to document.documentElement)
+ * @param entry - Theme entry to write, or null/undefined to remove the theme
+ * @param options.element - Element to write to (accepts null e.g. from refs). Defaults to document.documentElement.
  * @param options.stringify - Custom serializer (default: stringifyClassName)
  */
-declare function writeClassName<Themes extends ThemeMap>(themes: Themes, entry: ThemeEntry<Themes> | undefined, options?: {
-  element?: Element | undefined;
+declare function writeClassName<Themes extends ThemeMap>(themes: Themes, entry: ThemeEntry<Themes> | null | undefined, options?: {
+  element?: Element | null | undefined;
   stringify?: StringifyStoredTheme<Themes> | undefined;
 } | undefined): void;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"write-class-name.d.mts","names":[],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;;;;;;AAIsE,iBAJtD,cAIsD,CAAA,eAJxB,QAIwB,CAAA,CAAA,MAAA,EAH7D,MAG6D,EAAA,KAAA,EAF9D,UAE8D,CAFnD,MAEmD,CAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAArB,OAAA,CAAA,EAAjC,OAAiC,GAAA,SAAA;EAAoB,SAAA,CAAA,EAApB,oBAAoB,CAAC,MAAD,CAAA,GAAA,SAAA"}
+{"version":3,"file":"write-class-name.d.mts","names":[],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;;;;;;AAI6E,iBAJ7D,cAI6D,CAAA,eAJ/B,QAI+B,CAAA,CAAA,MAAA,EAHpE,MAGoE,EAAA,KAAA,EAFrE,UAEqE,CAF1D,MAE0D,CAAA,GAAA,IAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAArB,OAAA,CAAA,EAAxC,OAAwC,GAAA,IAAA,GAAA,SAAA;EAAoB,SAAA,CAAA,EAApB,oBAAoB,CAAC,MAAD,CAAA,GAAA,SAAA"}

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

@@ -5,8 +5,8 @@ import { stringifyClassName } from "./stringify-class-name.mjs";
 * Writes a theme entry to the class attribute on an element.
 *
 * @param themes - Record mapping theme keys to class name(s)
-* @param entry - Theme entry to write, or undefined to remove the theme
-* @param options.element - Element to write to (defaults to document.documentElement)
+* @param entry - Theme entry to write, or null/undefined to remove the theme
+* @param options.element - Element to write to (accepts null e.g. from refs). Defaults to document.documentElement.
 * @param options.stringify - Custom serializer (default: stringifyClassName)
 */
 function writeClassName(themes, entry, options) {

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

@@ -1 +1 @@
-{"version":3,"file":"write-class-name.mjs","names":[],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { stringifyClassName } from './stringify-class-name.ts'\n\n/**\n * Writes a theme entry to the class attribute on an element.\n *\n * @param themes - Record mapping theme keys to class name(s)\n * @param entry - Theme entry to write, or undefined to remove the theme\n * @param options.element - Element to write to (defaults to document.documentElement)\n * @param options.stringify - Custom serializer (default: stringifyClassName)\n */\nexport function writeClassName<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tentry: ThemeEntry<Themes> | undefined,\n\toptions?:\n\t\t| { element?: Element | undefined; stringify?: StringifyStoredTheme<Themes> | undefined }\n\t\t| undefined\n): void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return\n\tconst stringify = options?.stringify ?? stringifyClassName\n\telement.className = stringify(themes, element.className ?? undefined, entry)\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,eACf,QACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;AAEd,SAAQ,aADU,SAAS,aAAa,oBACV,QAAQ,QAAQ,aAAa,QAAW,MAAM"}
+{"version":3,"file":"write-class-name.mjs","names":[],"sources":["../../../src/theme/class-name/write-class-name.ts"],"sourcesContent":["import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { stringifyClassName } from './stringify-class-name.ts'\n\n/**\n * Writes a theme entry to the class attribute on an element.\n *\n * @param themes - Record mapping theme keys to class name(s)\n * @param entry - Theme entry to write, or null/undefined to remove the theme\n * @param options.element - Element to write to (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.stringify - Custom serializer (default: stringifyClassName)\n */\nexport function writeClassName<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions?:\n\t\t| { element?: Element | null | undefined; stringify?: StringifyStoredTheme<Themes> | undefined }\n\t\t| undefined\n): void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return\n\tconst stringify = options?.stringify ?? stringifyClassName\n\telement.className = stringify(themes, element.className ?? undefined, entry)\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,eACf,QACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;AAEd,SAAQ,aADU,SAAS,aAAa,oBACV,QAAQ,QAAQ,aAAa,QAAW,MAAM"}

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

@@ -1 +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"}
+{"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) => 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,SAAsE;EACxF,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.mjs.map

@@ -1 +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"}
+{"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) => 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,SAAsE;EACxF,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/cookie/write-cookie-theme.cjs

@@ -7,13 +7,13 @@ const require__cookie_utils = require('./_cookie-utils.cjs');
 * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.
 *
 * @param themes - Record mapping theme keys to values (used for type validation)
-* @param entry - Theme entry to write, or undefined to remove
+* @param entry - Theme entry to write, or null/undefined to remove
 * @param options - Cookie options
 */
 function writeCookieTheme(_themes, entry, options) {
 	const { cookieName, path = "/", maxAge, sameSite, secure } = options;
 	if (typeof document === "undefined" || document.cookie === void 0) return;
-	if (entry === void 0) {
+	if (entry == null) {
 		require__cookie_utils.deleteCookie(cookieName, path);
 		return;
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"write-cookie-theme.cjs","names":["opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t}"],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { deleteCookie, setCookie } from './_cookie-utils.ts'\n\nexport interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {\n\tcookieName: string\n\tpath?: string | undefined\n\tmaxAge?: number | undefined\n\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\tsecure?: boolean | undefined\n}\n\n/**\n * Writes a theme entry to a cookie.\n *\n * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.\n *\n * @param themes - Record mapping theme keys to values (used for type validation)\n * @param entry - Theme entry to write, or undefined to remove\n * @param options - Cookie options\n */\nexport function writeCookieTheme<Themes extends ThemeMap>(\n\t_themes: Themes,\n\tentry: ThemeEntry<Themes> | undefined,\n\toptions: WriteCookieThemeOptions<Themes>\n): void {\n\tconst { cookieName, path = '/', maxAge, sameSite, secure } = options\n\n\tif (typeof document === 'undefined' || document.cookie === undefined) {\n\t\treturn\n\t}\n\n\tif (entry === undefined) {\n\t\tdeleteCookie(cookieName, path)\n\t\treturn\n\t}\n\n\tconst opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t} = { path }\n\tif (maxAge !== undefined) opts.maxAge = maxAge\n\tif (sameSite !== undefined) opts.sameSite = sameSite\n\tif (secure) opts.secure = true\n\tsetCookie(cookieName, JSON.stringify(entry), opts)\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,SAAgB,iBACf,SACA,OACA,SACO;CACP,MAAM,EAAE,YAAY,OAAO,KAAK,QAAQ,UAAU,WAAW;AAE7D,KAAI,OAAO,aAAa,eAAe,SAAS,WAAW,OAC1D;AAGD,KAAI,UAAU,QAAW;AACxB,qCAAa,YAAY,KAAK;AAC9B;;CAGD,MAAMA,OAKF,EAAE,MAAM;AACZ,KAAI,WAAW,OAAW,MAAK,SAAS;AACxC,KAAI,aAAa,OAAW,MAAK,WAAW;AAC5C,KAAI,OAAQ,MAAK,SAAS;AAC1B,iCAAU,YAAY,KAAK,UAAU,MAAM,EAAE,KAAK"}
+{"version":3,"file":"write-cookie-theme.cjs","names":["opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t}"],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { deleteCookie, setCookie } from './_cookie-utils.ts'\n\nexport interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {\n\tcookieName: string\n\tpath?: string | undefined\n\tmaxAge?: number | undefined\n\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\tsecure?: boolean | undefined\n}\n\n/**\n * Writes a theme entry to a cookie.\n *\n * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.\n *\n * @param themes - Record mapping theme keys to values (used for type validation)\n * @param entry - Theme entry to write, or null/undefined to remove\n * @param options - Cookie options\n */\nexport function writeCookieTheme<Themes extends ThemeMap>(\n\t_themes: Themes,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions: WriteCookieThemeOptions<Themes>\n): void {\n\tconst { cookieName, path = '/', maxAge, sameSite, secure } = options\n\n\tif (typeof document === 'undefined' || document.cookie === undefined) {\n\t\treturn\n\t}\n\n\tif (entry == null) {\n\t\tdeleteCookie(cookieName, path)\n\t\treturn\n\t}\n\n\tconst opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t} = { path }\n\tif (maxAge !== undefined) opts.maxAge = maxAge\n\tif (sameSite !== undefined) opts.sameSite = sameSite\n\tif (secure) opts.secure = true\n\tsetCookie(cookieName, JSON.stringify(entry), opts)\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,SAAgB,iBACf,SACA,OACA,SACO;CACP,MAAM,EAAE,YAAY,OAAO,KAAK,QAAQ,UAAU,WAAW;AAE7D,KAAI,OAAO,aAAa,eAAe,SAAS,WAAW,OAC1D;AAGD,KAAI,SAAS,MAAM;AAClB,qCAAa,YAAY,KAAK;AAC9B;;CAGD,MAAMA,OAKF,EAAE,MAAM;AACZ,KAAI,WAAW,OAAW,MAAK,SAAS;AACxC,KAAI,aAAa,OAAW,MAAK,WAAW;AAC5C,KAAI,OAAQ,MAAK,SAAS;AAC1B,iCAAU,YAAY,KAAK,UAAU,MAAM,EAAE,KAAK"}

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

@@ -15,10 +15,10 @@ interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {
  * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.
  *
  * @param themes - Record mapping theme keys to values (used for type validation)
- * @param entry - Theme entry to write, or undefined to remove
+ * @param entry - Theme entry to write, or null/undefined to remove
  * @param options - Cookie options
  */
-declare function writeCookieTheme<Themes extends ThemeMap>(_themes: Themes, entry: ThemeEntry<Themes> | undefined, options: WriteCookieThemeOptions<Themes>): void;
+declare function writeCookieTheme<Themes extends ThemeMap>(_themes: Themes, entry: ThemeEntry<Themes> | null | undefined, options: WriteCookieThemeOptions<Themes>): void;
 //#endregion
 export { WriteCookieThemeOptions, writeCookieTheme };
 //# sourceMappingURL=write-cookie-theme.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"write-cookie-theme.d.cts","names":[],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":[],"mappings":";;;;UAIiB,wCAAwC,WAAW;;EAAnD,IAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAiBD,MAAA,CAAA,EAAA,MAAA,GAAA,SAAgB;EAAgB,QAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,MAAA,GAAA,SAAA;EACtC,MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;;;;;;;;;;iBADM,gCAAgC,mBACtC,eACF,WAAW,8BACT,wBAAwB"}
+{"version":3,"file":"write-cookie-theme.d.cts","names":[],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":[],"mappings":";;;;UAIiB,wCAAwC,WAAW;;EAAnD,IAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAiBD,MAAA,CAAA,EAAA,MAAA,GAAA,SAAgB;EAAgB,QAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,MAAA,GAAA,SAAA;EACtC,MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;;;;;;;;;;iBADM,gCAAgC,mBACtC,eACF,WAAW,qCACT,wBAAwB"}

package/dist/theme/cookie/write-cookie-theme.d.mts

@@ -15,10 +15,10 @@ interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {
  * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.
  *
  * @param themes - Record mapping theme keys to values (used for type validation)
- * @param entry - Theme entry to write, or undefined to remove
+ * @param entry - Theme entry to write, or null/undefined to remove
  * @param options - Cookie options
  */
-declare function writeCookieTheme<Themes extends ThemeMap>(_themes: Themes, entry: ThemeEntry<Themes> | undefined, options: WriteCookieThemeOptions<Themes>): void;
+declare function writeCookieTheme<Themes extends ThemeMap>(_themes: Themes, entry: ThemeEntry<Themes> | null | undefined, options: WriteCookieThemeOptions<Themes>): void;
 //#endregion
 export { WriteCookieThemeOptions, writeCookieTheme };
 //# sourceMappingURL=write-cookie-theme.d.mts.map

package/dist/theme/cookie/write-cookie-theme.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"write-cookie-theme.d.mts","names":[],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":[],"mappings":";;;;UAIiB,wCAAwC,WAAW;;EAAnD,IAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAiBD,MAAA,CAAA,EAAA,MAAA,GAAA,SAAgB;EAAgB,QAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,MAAA,GAAA,SAAA;EACtC,MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;;;;;;;;;;iBADM,gCAAgC,mBACtC,eACF,WAAW,8BACT,wBAAwB"}
+{"version":3,"file":"write-cookie-theme.d.mts","names":[],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":[],"mappings":";;;;UAIiB,wCAAwC,WAAW;;EAAnD,IAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAiBD,MAAA,CAAA,EAAA,MAAA,GAAA,SAAgB;EAAgB,QAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,MAAA,GAAA,SAAA;EACtC,MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;;;;;;;;;;iBADM,gCAAgC,mBACtC,eACF,WAAW,qCACT,wBAAwB"}

package/dist/theme/cookie/write-cookie-theme.mjs

@@ -7,13 +7,13 @@ import { deleteCookie, setCookie } from "./_cookie-utils.mjs";
 * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.
 *
 * @param themes - Record mapping theme keys to values (used for type validation)
-* @param entry - Theme entry to write, or undefined to remove
+* @param entry - Theme entry to write, or null/undefined to remove
 * @param options - Cookie options
 */
 function writeCookieTheme(_themes, entry, options) {
 	const { cookieName, path = "/", maxAge, sameSite, secure } = options;
 	if (typeof document === "undefined" || document.cookie === void 0) return;
-	if (entry === void 0) {
+	if (entry == null) {
 		deleteCookie(cookieName, path);
 		return;
 	}

package/dist/theme/cookie/write-cookie-theme.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"write-cookie-theme.mjs","names":["opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t}"],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { deleteCookie, setCookie } from './_cookie-utils.ts'\n\nexport interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {\n\tcookieName: string\n\tpath?: string | undefined\n\tmaxAge?: number | undefined\n\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\tsecure?: boolean | undefined\n}\n\n/**\n * Writes a theme entry to a cookie.\n *\n * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.\n *\n * @param themes - Record mapping theme keys to values (used for type validation)\n * @param entry - Theme entry to write, or undefined to remove\n * @param options - Cookie options\n */\nexport function writeCookieTheme<Themes extends ThemeMap>(\n\t_themes: Themes,\n\tentry: ThemeEntry<Themes> | undefined,\n\toptions: WriteCookieThemeOptions<Themes>\n): void {\n\tconst { cookieName, path = '/', maxAge, sameSite, secure } = options\n\n\tif (typeof document === 'undefined' || document.cookie === undefined) {\n\t\treturn\n\t}\n\n\tif (entry === undefined) {\n\t\tdeleteCookie(cookieName, path)\n\t\treturn\n\t}\n\n\tconst opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t} = { path }\n\tif (maxAge !== undefined) opts.maxAge = maxAge\n\tif (sameSite !== undefined) opts.sameSite = sameSite\n\tif (secure) opts.secure = true\n\tsetCookie(cookieName, JSON.stringify(entry), opts)\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,SAAgB,iBACf,SACA,OACA,SACO;CACP,MAAM,EAAE,YAAY,OAAO,KAAK,QAAQ,UAAU,WAAW;AAE7D,KAAI,OAAO,aAAa,eAAe,SAAS,WAAW,OAC1D;AAGD,KAAI,UAAU,QAAW;AACxB,eAAa,YAAY,KAAK;AAC9B;;CAGD,MAAMA,OAKF,EAAE,MAAM;AACZ,KAAI,WAAW,OAAW,MAAK,SAAS;AACxC,KAAI,aAAa,OAAW,MAAK,WAAW;AAC5C,KAAI,OAAQ,MAAK,SAAS;AAC1B,WAAU,YAAY,KAAK,UAAU,MAAM,EAAE,KAAK"}
+{"version":3,"file":"write-cookie-theme.mjs","names":["opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t}"],"sources":["../../../src/theme/cookie/write-cookie-theme.ts"],"sourcesContent":["import type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { deleteCookie, setCookie } from './_cookie-utils.ts'\n\nexport interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {\n\tcookieName: string\n\tpath?: string | undefined\n\tmaxAge?: number | undefined\n\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\tsecure?: boolean | undefined\n}\n\n/**\n * Writes a theme entry to a cookie.\n *\n * Performs cookie set/delete only. Does not notify subscribers; the store must call notify() after this.\n *\n * @param themes - Record mapping theme keys to values (used for type validation)\n * @param entry - Theme entry to write, or null/undefined to remove\n * @param options - Cookie options\n */\nexport function writeCookieTheme<Themes extends ThemeMap>(\n\t_themes: Themes,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions: WriteCookieThemeOptions<Themes>\n): void {\n\tconst { cookieName, path = '/', maxAge, sameSite, secure } = options\n\n\tif (typeof document === 'undefined' || document.cookie === undefined) {\n\t\treturn\n\t}\n\n\tif (entry == null) {\n\t\tdeleteCookie(cookieName, path)\n\t\treturn\n\t}\n\n\tconst opts: {\n\t\tpath: string\n\t\tmaxAge?: number\n\t\tsameSite?: 'lax' | 'strict' | 'none'\n\t\tsecure?: boolean\n\t} = { path }\n\tif (maxAge !== undefined) opts.maxAge = maxAge\n\tif (sameSite !== undefined) opts.sameSite = sameSite\n\tif (secure) opts.secure = true\n\tsetCookie(cookieName, JSON.stringify(entry), opts)\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,SAAgB,iBACf,SACA,OACA,SACO;CACP,MAAM,EAAE,YAAY,OAAO,KAAK,QAAQ,UAAU,WAAW;AAE7D,KAAI,OAAO,aAAa,eAAe,SAAS,WAAW,OAC1D;AAGD,KAAI,SAAS,MAAM;AAClB,eAAa,YAAY,KAAK;AAC9B;;CAGD,MAAMA,OAKF,EAAE,MAAM;AACZ,KAAI,WAAW,OAAW,MAAK,SAAS;AACxC,KAAI,aAAa,OAAW,MAAK,WAAW;AAC5C,KAAI,OAAQ,MAAK,SAAS;AAC1B,WAAU,YAAY,KAAK,UAAU,MAAM,EAAE,KAAK"}

package/dist/theme/data-attribute/parse-data-attribute.cjs

@@ -9,7 +9,7 @@ const require_match_attribute_value_to_theme = require('../_utils/match-attribut
 * Pure function: no DOM access. Uses first token when separator is defined.
 *
 * @param themes - Record mapping theme keys to attribute values
-* @param value - Raw attribute value string (e.g. from getAttribute)
+* @param value - Raw attribute value string (e.g. from getAttribute; accepts null)
 * @param options.separator - When defined, split by separator and use first token (default: space)
 * @returns ThemeEntry if a match is found, otherwise undefined
 */

package/dist/theme/data-attribute/parse-data-attribute.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-data-attribute.cjs","names":["SEPARATOR_SPACE","matchAttributeValueToTheme","themeEntry"],"sources":["../../../src/theme/data-attribute/parse-data-attribute.ts"],"sourcesContent":["import { matchAttributeValueToTheme } from '../_utils/match-attribute-value-to-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 { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Parses a data attribute value string into a ThemeEntry.\n *\n * Pure function: no DOM access. Uses first token when separator is defined.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param value - Raw attribute value string (e.g. from getAttribute)\n * @param options.separator - When defined, split by separator and use first token (default: space)\n * @returns ThemeEntry if a match is found, otherwise undefined\n */\nexport function parseDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tvalue: string | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): ThemeEntry<Themes> | undefined {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst theme = matchAttributeValueToTheme(themes, value ?? null, { separator })\n\treturn theme !== undefined ? themeEntry(themes, theme) : undefined\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,mBACf,QACA,OACA,SACiC;CACjC,MAAM,YAAY,SAAS,aAAaA;CACxC,MAAM,QAAQC,kEAA2B,QAAQ,SAAS,MAAM,EAAE,WAAW,CAAC;AAC9E,QAAO,UAAU,SAAYC,+BAAW,QAAQ,MAAM,GAAG"}
+{"version":3,"file":"parse-data-attribute.cjs","names":["SEPARATOR_SPACE","matchAttributeValueToTheme","themeEntry"],"sources":["../../../src/theme/data-attribute/parse-data-attribute.ts"],"sourcesContent":["import { matchAttributeValueToTheme } from '../_utils/match-attribute-value-to-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 { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Parses a data attribute value string into a ThemeEntry.\n *\n * Pure function: no DOM access. Uses first token when separator is defined.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param value - Raw attribute value string (e.g. from getAttribute; accepts null)\n * @param options.separator - When defined, split by separator and use first token (default: space)\n * @returns ThemeEntry if a match is found, otherwise undefined\n */\nexport function parseDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tvalue: string | null | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): ThemeEntry<Themes> | undefined {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst theme = matchAttributeValueToTheme(themes, value ?? null, { separator })\n\treturn theme !== undefined ? themeEntry(themes, theme) : undefined\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,mBACf,QACA,OACA,SACiC;CACjC,MAAM,YAAY,SAAS,aAAaA;CACxC,MAAM,QAAQC,kEAA2B,QAAQ,SAAS,MAAM,EAAE,WAAW,CAAC;AAC9E,QAAO,UAAU,SAAYC,+BAAW,QAAQ,MAAM,GAAG"}

package/dist/theme/data-attribute/parse-data-attribute.d.cts

@@ -9,11 +9,11 @@ import { ThemeEntry } from "../theme-entry.types.cjs";
  * Pure function: no DOM access. Uses first token when separator is defined.
  *
  * @param themes - Record mapping theme keys to attribute values
- * @param value - Raw attribute value string (e.g. from getAttribute)
+ * @param value - Raw attribute value string (e.g. from getAttribute; accepts null)
  * @param options.separator - When defined, split by separator and use first token (default: space)
  * @returns ThemeEntry if a match is found, otherwise undefined
  */
-declare function parseDataAttribute<Themes extends ThemeMap>(themes: Themes, value: string | undefined, options?: {
+declare function parseDataAttribute<Themes extends ThemeMap>(themes: Themes, value: string | null | undefined, options?: {
   separator?: string | undefined;
 } | undefined): ThemeEntry<Themes> | undefined;
 //#endregion

package/dist/theme/data-attribute/parse-data-attribute.d.mts

@@ -9,11 +9,11 @@ import { ThemeEntry } from "../theme-entry.types.mjs";
  * Pure function: no DOM access. Uses first token when separator is defined.
  *
  * @param themes - Record mapping theme keys to attribute values
- * @param value - Raw attribute value string (e.g. from getAttribute)
+ * @param value - Raw attribute value string (e.g. from getAttribute; accepts null)
  * @param options.separator - When defined, split by separator and use first token (default: space)
  * @returns ThemeEntry if a match is found, otherwise undefined
  */
-declare function parseDataAttribute<Themes extends ThemeMap>(themes: Themes, value: string | undefined, options?: {
+declare function parseDataAttribute<Themes extends ThemeMap>(themes: Themes, value: string | null | undefined, options?: {
   separator?: string | undefined;
 } | undefined): ThemeEntry<Themes> | undefined;
 //#endregion

package/dist/theme/data-attribute/parse-data-attribute.mjs

@@ -9,7 +9,7 @@ import { matchAttributeValueToTheme } from "../_utils/match-attribute-value-to-t
 * Pure function: no DOM access. Uses first token when separator is defined.
 *
 * @param themes - Record mapping theme keys to attribute values
-* @param value - Raw attribute value string (e.g. from getAttribute)
+* @param value - Raw attribute value string (e.g. from getAttribute; accepts null)
 * @param options.separator - When defined, split by separator and use first token (default: space)
 * @returns ThemeEntry if a match is found, otherwise undefined
 */

package/dist/theme/data-attribute/parse-data-attribute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/parse-data-attribute.ts"],"sourcesContent":["import { matchAttributeValueToTheme } from '../_utils/match-attribute-value-to-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 { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Parses a data attribute value string into a ThemeEntry.\n *\n * Pure function: no DOM access. Uses first token when separator is defined.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param value - Raw attribute value string (e.g. from getAttribute)\n * @param options.separator - When defined, split by separator and use first token (default: space)\n * @returns ThemeEntry if a match is found, otherwise undefined\n */\nexport function parseDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tvalue: string | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): ThemeEntry<Themes> | undefined {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst theme = matchAttributeValueToTheme(themes, value ?? null, { separator })\n\treturn theme !== undefined ? themeEntry(themes, theme) : undefined\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,mBACf,QACA,OACA,SACiC;CACjC,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,QAAQ,2BAA2B,QAAQ,SAAS,MAAM,EAAE,WAAW,CAAC;AAC9E,QAAO,UAAU,SAAY,WAAW,QAAQ,MAAM,GAAG"}
+{"version":3,"file":"parse-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/parse-data-attribute.ts"],"sourcesContent":["import { matchAttributeValueToTheme } from '../_utils/match-attribute-value-to-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 { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Parses a data attribute value string into a ThemeEntry.\n *\n * Pure function: no DOM access. Uses first token when separator is defined.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param value - Raw attribute value string (e.g. from getAttribute; accepts null)\n * @param options.separator - When defined, split by separator and use first token (default: space)\n * @returns ThemeEntry if a match is found, otherwise undefined\n */\nexport function parseDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tvalue: string | null | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): ThemeEntry<Themes> | undefined {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst theme = matchAttributeValueToTheme(themes, value ?? null, { separator })\n\treturn theme !== undefined ? themeEntry(themes, theme) : undefined\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,mBACf,QACA,OACA,SACiC;CACjC,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,QAAQ,2BAA2B,QAAQ,SAAS,MAAM,EAAE,WAAW,CAAC;AAC9E,QAAO,UAAU,SAAY,WAAW,QAAQ,MAAM,GAAG"}

package/dist/theme/data-attribute/read-data-attribute.cjs

@@ -8,7 +8,7 @@ const require_parse_data_attribute = require('./parse-data-attribute.cjs');
 *
 * @param themes - Record mapping theme keys to attribute values
 * @param attributeName - Data attribute name (e.g. `data-theme`)
-* @param options.element - Element to read from (defaults to document.documentElement)
+* @param options.element - Element to read from (accepts null e.g. from refs). Defaults to document.documentElement.
 * @param options.parse - Custom parser (default: parseDataAttribute with space separator)
 * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).
 */

package/dist/theme/data-attribute/read-data-attribute.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"read-data-attribute.cjs","names":["parseDataAttribute","SEPARATOR_SPACE","getDataAttribute"],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Reads a theme entry from a data attribute on an element.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param options.element - Element to read from (defaults to document.documentElement)\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).\n */\nexport function readDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\toptions?:\n\t\t| { element?: Element | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): ThemeEntry<Themes> | undefined {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return undefined\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst raw = getDataAttribute(attributeName, element) ?? undefined\n\treturn parse(themes, raw)\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,kBACf,QACA,eACA,SAGiC;CACjC,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,QAAO;AAIrB,SAFC,SAAS,WAAW,GAAG,MAAMA,gDAAmB,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC,GAEzE,QADDC,4CAAiB,eAAe,QAAQ,IAAI,OAC/B"}
+{"version":3,"file":"read-data-attribute.cjs","names":["parseDataAttribute","SEPARATOR_SPACE","getDataAttribute"],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Reads a theme entry from a data attribute on an element.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param options.element - Element to read from (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).\n */\nexport function readDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): ThemeEntry<Themes> | undefined {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return undefined\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst raw = getDataAttribute(attributeName, element) ?? undefined\n\treturn parse(themes, raw)\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,kBACf,QACA,eACA,SAGiC;CACjC,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,QAAO;AAIrB,SAFC,SAAS,WAAW,GAAG,MAAMA,gDAAmB,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC,GAEzE,QADDC,4CAAiB,eAAe,QAAQ,IAAI,OAC/B"}

package/dist/theme/data-attribute/read-data-attribute.d.cts

@@ -8,12 +8,12 @@ import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.cjs";
  *
  * @param themes - Record mapping theme keys to attribute values
  * @param attributeName - Data attribute name (e.g. `data-theme`)
- * @param options.element - Element to read from (defaults to document.documentElement)
+ * @param options.element - Element to read from (accepts null e.g. from refs). Defaults to document.documentElement.
  * @param options.parse - Custom parser (default: parseDataAttribute with space separator)
  * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).
  */
 declare function readDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, options?: {
-  element?: Element | undefined;
+  element?: Element | null | undefined;
   parse?: ParseStoredTheme<Themes> | undefined;
 } | undefined): ThemeEntry<Themes> | undefined;
 //#endregion

package/dist/theme/data-attribute/read-data-attribute.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"read-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAMG,iBANa,iBAMb,CAAA,eAN8C,QAM9C,CAAA,CAAA,MAAA,EALM,MAKN,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,QAAA,EAAA;EAAU,OAAA,CAAA,EAFG,OAEH,GAAA,SAAA;UAFgC,iBAAiB;gBAE3D,WAAW"}
+{"version":3,"file":"read-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAMG,iBANa,iBAMb,CAAA,eAN8C,QAM9C,CAAA,CAAA,MAAA,EALM,MAKN,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,QAAA,EAAA;EAAU,OAAA,CAAA,EAFG,OAEH,GAAA,IAAA,GAAA,SAAA;UAFuC,iBAAiB;gBAElE,WAAW"}

package/dist/theme/data-attribute/read-data-attribute.d.mts

@@ -8,12 +8,12 @@ import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.mjs";
  *
  * @param themes - Record mapping theme keys to attribute values
  * @param attributeName - Data attribute name (e.g. `data-theme`)
- * @param options.element - Element to read from (defaults to document.documentElement)
+ * @param options.element - Element to read from (accepts null e.g. from refs). Defaults to document.documentElement.
  * @param options.parse - Custom parser (default: parseDataAttribute with space separator)
  * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).
  */
 declare function readDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, options?: {
-  element?: Element | undefined;
+  element?: Element | null | undefined;
   parse?: ParseStoredTheme<Themes> | undefined;
 } | undefined): ThemeEntry<Themes> | undefined;
 //#endregion

package/dist/theme/data-attribute/read-data-attribute.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"read-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAMG,iBANa,iBAMb,CAAA,eAN8C,QAM9C,CAAA,CAAA,MAAA,EALM,MAKN,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,QAAA,EAAA;EAAU,OAAA,CAAA,EAFG,OAEH,GAAA,SAAA;UAFgC,iBAAiB;gBAE3D,WAAW"}
+{"version":3,"file":"read-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAMG,iBANa,iBAMb,CAAA,eAN8C,QAM9C,CAAA,CAAA,MAAA,EALM,MAKN,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,QAAA,EAAA;EAAU,OAAA,CAAA,EAFG,OAEH,GAAA,IAAA,GAAA,SAAA;UAFuC,iBAAiB;gBAElE,WAAW"}

package/dist/theme/data-attribute/read-data-attribute.mjs

@@ -8,7 +8,7 @@ import { parseDataAttribute } from "./parse-data-attribute.mjs";
 *
 * @param themes - Record mapping theme keys to attribute values
 * @param attributeName - Data attribute name (e.g. `data-theme`)
-* @param options.element - Element to read from (defaults to document.documentElement)
+* @param options.element - Element to read from (accepts null e.g. from refs). Defaults to document.documentElement.
 * @param options.parse - Custom parser (default: parseDataAttribute with space separator)
 * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).
 */

package/dist/theme/data-attribute/read-data-attribute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"read-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Reads a theme entry from a data attribute on an element.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param options.element - Element to read from (defaults to document.documentElement)\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).\n */\nexport function readDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\toptions?:\n\t\t| { element?: Element | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): ThemeEntry<Themes> | undefined {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return undefined\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst raw = getDataAttribute(attributeName, element) ?? undefined\n\treturn parse(themes, raw)\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,kBACf,QACA,eACA,SAGiC;CACjC,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,QAAO;AAIrB,SAFC,SAAS,WAAW,GAAG,MAAM,mBAAmB,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC,GAEzE,QADD,iBAAiB,eAAe,QAAQ,IAAI,OAC/B"}
+{"version":3,"file":"read-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/read-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Reads a theme entry from a data attribute on an element.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param options.element - Element to read from (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).\n */\nexport function readDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): ThemeEntry<Themes> | undefined {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return undefined\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst raw = getDataAttribute(attributeName, element) ?? undefined\n\treturn parse(themes, raw)\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,kBACf,QACA,eACA,SAGiC;CACjC,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,QAAO;AAIrB,SAFC,SAAS,WAAW,GAAG,MAAM,mBAAmB,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC,GAEzE,QADD,iBAAiB,eAAe,QAAQ,IAAI,OAC/B"}

package/dist/theme/data-attribute/stringify-data-attribute.cjs

@@ -9,8 +9,8 @@ const require__constant = require('./_constant.cjs');
 * Aligns with stringifyClassName logic.
 *
 * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)
-* @param existing - Current attribute value string
-* @param entry - Theme entry to stringify, or undefined to clear theme (keeps non-theme tokens)
+* @param existing - Current attribute value string (accepts null e.g. from getAttribute)
+* @param entry - Theme entry to stringify, or null/undefined to clear theme (keeps non-theme tokens)
 * @param options.separator - Token separator (default: space)
 * @returns Attribute value string
 */
@@ -20,8 +20,8 @@ function stringifyDataAttribute(themes, existing, entry, options) {
 		const resolved = require_resolve_theme_map_value.resolveThemeMapValue(v);
 		return Array.isArray(resolved) ? [...resolved] : [resolved];
 	});
-	const withoutThemeValues = (existing?.trim() ? existing.trim().split(separator) : []).filter((t) => !allThemeValues.includes(t.trim()));
-	const newTokens = entry !== void 0 ? (() => {
+	const withoutThemeValues = ((existing ?? "")?.trim() ? (existing ?? "").trim().split(separator) : []).filter((t) => !allThemeValues.includes(t.trim()));
+	const newTokens = entry != null ? (() => {
 		const resolved = require_resolve_theme_map_value.resolveThemeMapValue(entry.value);
 		return Array.isArray(resolved) ? [resolved[0]] : [resolved];
 	})() : [];

package/dist/theme/data-attribute/stringify-data-attribute.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"stringify-data-attribute.cjs","names":["SEPARATOR_SPACE","resolveThemeMapValue"],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":["import { resolveThemeMapValue } from '../_utils/resolve-theme-map-value.ts'\nimport type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Stringifies a ThemeEntry for a data attribute value.\n *\n * Pure function: no DOM access. Removes all theme values from existing, then adds entry's value(s).\n * Aligns with stringifyClassName logic.\n *\n * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)\n * @param existing - Current attribute value string\n * @param entry - Theme entry to stringify, or undefined to clear theme (keeps non-theme tokens)\n * @param options.separator - Token separator (default: space)\n * @returns Attribute value string\n */\nexport function stringifyDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\texisting: string | undefined,\n\tentry: ThemeEntry<Themes> | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): string {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst allThemeValues = Object.values(themes).flatMap((v) => {\n\t\tconst resolved = resolveThemeMapValue(v)\n\t\treturn Array.isArray(resolved) ? [...resolved] : [resolved]\n\t})\n\tconst existingTokens = existing?.trim() ? existing.trim().split(separator) : []\n\tconst withoutThemeValues = existingTokens.filter((t) => !allThemeValues.includes(t.trim()))\n\tconst newTokens =\n\t\tentry !== undefined\n\t\t\t? (() => {\n\t\t\t\t\tconst resolved = resolveThemeMapValue(entry.value)\n\t\t\t\t\treturn Array.isArray(resolved) ? [resolved[0]] : [resolved]\n\t\t\t\t})()\n\t\t\t: []\n\treturn [...withoutThemeValues, ...newTokens].filter(Boolean).join(separator)\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,uBACf,QACA,UACA,OACA,SACS;CACT,MAAM,YAAY,SAAS,aAAaA;CACxC,MAAM,iBAAiB,OAAO,OAAO,OAAO,CAAC,SAAS,MAAM;EAC3D,MAAM,WAAWC,qDAAqB,EAAE;AACxC,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,SAAS;GAC1D;CAEF,MAAM,sBADiB,UAAU,MAAM,GAAG,SAAS,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,EACrC,QAAQ,MAAM,CAAC,eAAe,SAAS,EAAE,MAAM,CAAC,CAAC;CAC3F,MAAM,YACL,UAAU,gBACA;EACP,MAAM,WAAWA,qDAAqB,MAAM,MAAM;AAClD,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS;KACxD,GACH,EAAE;AACN,QAAO,CAAC,GAAG,oBAAoB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,KAAK,UAAU"}
+{"version":3,"file":"stringify-data-attribute.cjs","names":["SEPARATOR_SPACE","resolveThemeMapValue"],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":["import { resolveThemeMapValue } from '../_utils/resolve-theme-map-value.ts'\nimport type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Stringifies a ThemeEntry for a data attribute value.\n *\n * Pure function: no DOM access. Removes all theme values from existing, then adds entry's value(s).\n * Aligns with stringifyClassName logic.\n *\n * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)\n * @param existing - Current attribute value string (accepts null e.g. from getAttribute)\n * @param entry - Theme entry to stringify, or null/undefined to clear theme (keeps non-theme tokens)\n * @param options.separator - Token separator (default: space)\n * @returns Attribute value string\n */\nexport function stringifyDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\texisting: string | null | undefined,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): string {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst allThemeValues = Object.values(themes).flatMap((v) => {\n\t\tconst resolved = resolveThemeMapValue(v)\n\t\treturn Array.isArray(resolved) ? [...resolved] : [resolved]\n\t})\n\tconst existingTokens = (existing ?? '')?.trim() ? (existing ?? '').trim().split(separator) : []\n\tconst withoutThemeValues = existingTokens.filter((t) => !allThemeValues.includes(t.trim()))\n\tconst newTokens =\n\t\tentry != null\n\t\t\t? (() => {\n\t\t\t\t\tconst resolved = resolveThemeMapValue(entry.value)\n\t\t\t\t\treturn Array.isArray(resolved) ? [resolved[0]] : [resolved]\n\t\t\t\t})()\n\t\t\t: []\n\treturn [...withoutThemeValues, ...newTokens].filter(Boolean).join(separator)\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,uBACf,QACA,UACA,OACA,SACS;CACT,MAAM,YAAY,SAAS,aAAaA;CACxC,MAAM,iBAAiB,OAAO,OAAO,OAAO,CAAC,SAAS,MAAM;EAC3D,MAAM,WAAWC,qDAAqB,EAAE;AACxC,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,SAAS;GAC1D;CAEF,MAAM,uBADkB,YAAY,KAAK,MAAM,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,EACrD,QAAQ,MAAM,CAAC,eAAe,SAAS,EAAE,MAAM,CAAC,CAAC;CAC3F,MAAM,YACL,SAAS,cACC;EACP,MAAM,WAAWA,qDAAqB,MAAM,MAAM;AAClD,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS;KACxD,GACH,EAAE;AACN,QAAO,CAAC,GAAG,oBAAoB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,KAAK,UAAU"}

package/dist/theme/data-attribute/stringify-data-attribute.d.cts

@@ -10,12 +10,12 @@ import { ThemeEntry } from "../theme-entry.types.cjs";
  * Aligns with stringifyClassName logic.
  *
  * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)
- * @param existing - Current attribute value string
- * @param entry - Theme entry to stringify, or undefined to clear theme (keeps non-theme tokens)
+ * @param existing - Current attribute value string (accepts null e.g. from getAttribute)
+ * @param entry - Theme entry to stringify, or null/undefined to clear theme (keeps non-theme tokens)
  * @param options.separator - Token separator (default: space)
  * @returns Attribute value string
  */
-declare function stringifyDataAttribute<Themes extends ThemeMap>(themes: Themes, existing: string | undefined, entry: ThemeEntry<Themes> | undefined, options?: {
+declare function stringifyDataAttribute<Themes extends ThemeMap>(themes: Themes, existing: string | null | undefined, entry: ThemeEntry<Themes> | null | undefined, options?: {
   separator?: string | undefined;
 } | undefined): string;
 //#endregion

package/dist/theme/data-attribute/stringify-data-attribute.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"stringify-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAiBA;;;;;;;;;;iBAAgB,sCAAsC,kBAC7C,6CAED,WAAW"}
+{"version":3,"file":"stringify-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAiBA;;;;;;;;;;iBAAgB,sCAAsC,kBAC7C,oDAED,WAAW"}

package/dist/theme/data-attribute/stringify-data-attribute.d.mts

@@ -10,12 +10,12 @@ import { ThemeEntry } from "../theme-entry.types.mjs";
  * Aligns with stringifyClassName logic.
  *
  * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)
- * @param existing - Current attribute value string
- * @param entry - Theme entry to stringify, or undefined to clear theme (keeps non-theme tokens)
+ * @param existing - Current attribute value string (accepts null e.g. from getAttribute)
+ * @param entry - Theme entry to stringify, or null/undefined to clear theme (keeps non-theme tokens)
  * @param options.separator - Token separator (default: space)
  * @returns Attribute value string
  */
-declare function stringifyDataAttribute<Themes extends ThemeMap>(themes: Themes, existing: string | undefined, entry: ThemeEntry<Themes> | undefined, options?: {
+declare function stringifyDataAttribute<Themes extends ThemeMap>(themes: Themes, existing: string | null | undefined, entry: ThemeEntry<Themes> | null | undefined, options?: {
   separator?: string | undefined;
 } | undefined): string;
 //#endregion

package/dist/theme/data-attribute/stringify-data-attribute.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"stringify-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAiBA;;;;;;;;;;iBAAgB,sCAAsC,kBAC7C,6CAED,WAAW"}
+{"version":3,"file":"stringify-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAiBA;;;;;;;;;;iBAAgB,sCAAsC,kBAC7C,oDAED,WAAW"}

package/dist/theme/data-attribute/stringify-data-attribute.mjs

@@ -9,8 +9,8 @@ import { SEPARATOR_SPACE } from "./_constant.mjs";
 * Aligns with stringifyClassName logic.
 *
 * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)
-* @param existing - Current attribute value string
-* @param entry - Theme entry to stringify, or undefined to clear theme (keeps non-theme tokens)
+* @param existing - Current attribute value string (accepts null e.g. from getAttribute)
+* @param entry - Theme entry to stringify, or null/undefined to clear theme (keeps non-theme tokens)
 * @param options.separator - Token separator (default: space)
 * @returns Attribute value string
 */
@@ -20,8 +20,8 @@ function stringifyDataAttribute(themes, existing, entry, options) {
 		const resolved = resolveThemeMapValue(v);
 		return Array.isArray(resolved) ? [...resolved] : [resolved];
 	});
-	const withoutThemeValues = (existing?.trim() ? existing.trim().split(separator) : []).filter((t) => !allThemeValues.includes(t.trim()));
-	const newTokens = entry !== void 0 ? (() => {
+	const withoutThemeValues = ((existing ?? "")?.trim() ? (existing ?? "").trim().split(separator) : []).filter((t) => !allThemeValues.includes(t.trim()));
+	const newTokens = entry != null ? (() => {
 		const resolved = resolveThemeMapValue(entry.value);
 		return Array.isArray(resolved) ? [resolved[0]] : [resolved];
 	})() : [];

package/dist/theme/data-attribute/stringify-data-attribute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stringify-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":["import { resolveThemeMapValue } from '../_utils/resolve-theme-map-value.ts'\nimport type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Stringifies a ThemeEntry for a data attribute value.\n *\n * Pure function: no DOM access. Removes all theme values from existing, then adds entry's value(s).\n * Aligns with stringifyClassName logic.\n *\n * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)\n * @param existing - Current attribute value string\n * @param entry - Theme entry to stringify, or undefined to clear theme (keeps non-theme tokens)\n * @param options.separator - Token separator (default: space)\n * @returns Attribute value string\n */\nexport function stringifyDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\texisting: string | undefined,\n\tentry: ThemeEntry<Themes> | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): string {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst allThemeValues = Object.values(themes).flatMap((v) => {\n\t\tconst resolved = resolveThemeMapValue(v)\n\t\treturn Array.isArray(resolved) ? [...resolved] : [resolved]\n\t})\n\tconst existingTokens = existing?.trim() ? existing.trim().split(separator) : []\n\tconst withoutThemeValues = existingTokens.filter((t) => !allThemeValues.includes(t.trim()))\n\tconst newTokens =\n\t\tentry !== undefined\n\t\t\t? (() => {\n\t\t\t\t\tconst resolved = resolveThemeMapValue(entry.value)\n\t\t\t\t\treturn Array.isArray(resolved) ? [resolved[0]] : [resolved]\n\t\t\t\t})()\n\t\t\t: []\n\treturn [...withoutThemeValues, ...newTokens].filter(Boolean).join(separator)\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,uBACf,QACA,UACA,OACA,SACS;CACT,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,iBAAiB,OAAO,OAAO,OAAO,CAAC,SAAS,MAAM;EAC3D,MAAM,WAAW,qBAAqB,EAAE;AACxC,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,SAAS;GAC1D;CAEF,MAAM,sBADiB,UAAU,MAAM,GAAG,SAAS,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,EACrC,QAAQ,MAAM,CAAC,eAAe,SAAS,EAAE,MAAM,CAAC,CAAC;CAC3F,MAAM,YACL,UAAU,gBACA;EACP,MAAM,WAAW,qBAAqB,MAAM,MAAM;AAClD,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS;KACxD,GACH,EAAE;AACN,QAAO,CAAC,GAAG,oBAAoB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,KAAK,UAAU"}
+{"version":3,"file":"stringify-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/stringify-data-attribute.ts"],"sourcesContent":["import { resolveThemeMapValue } from '../_utils/resolve-theme-map-value.ts'\nimport type { ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\n\n/**\n * Stringifies a ThemeEntry for a data attribute value.\n *\n * Pure function: no DOM access. Removes all theme values from existing, then adds entry's value(s).\n * Aligns with stringifyClassName logic.\n *\n * @param themes - Record mapping theme keys to attribute values (used to identify theme tokens)\n * @param existing - Current attribute value string (accepts null e.g. from getAttribute)\n * @param entry - Theme entry to stringify, or null/undefined to clear theme (keeps non-theme tokens)\n * @param options.separator - Token separator (default: space)\n * @returns Attribute value string\n */\nexport function stringifyDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\texisting: string | null | undefined,\n\tentry: ThemeEntry<Themes> | null | undefined,\n\toptions?: { separator?: string | undefined } | undefined\n): string {\n\tconst separator = options?.separator ?? SEPARATOR_SPACE\n\tconst allThemeValues = Object.values(themes).flatMap((v) => {\n\t\tconst resolved = resolveThemeMapValue(v)\n\t\treturn Array.isArray(resolved) ? [...resolved] : [resolved]\n\t})\n\tconst existingTokens = (existing ?? '')?.trim() ? (existing ?? '').trim().split(separator) : []\n\tconst withoutThemeValues = existingTokens.filter((t) => !allThemeValues.includes(t.trim()))\n\tconst newTokens =\n\t\tentry != null\n\t\t\t? (() => {\n\t\t\t\t\tconst resolved = resolveThemeMapValue(entry.value)\n\t\t\t\t\treturn Array.isArray(resolved) ? [resolved[0]] : [resolved]\n\t\t\t\t})()\n\t\t\t: []\n\treturn [...withoutThemeValues, ...newTokens].filter(Boolean).join(separator)\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,uBACf,QACA,UACA,OACA,SACS;CACT,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,iBAAiB,OAAO,OAAO,OAAO,CAAC,SAAS,MAAM;EAC3D,MAAM,WAAW,qBAAqB,EAAE;AACxC,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,SAAS;GAC1D;CAEF,MAAM,uBADkB,YAAY,KAAK,MAAM,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,EACrD,QAAQ,MAAM,CAAC,eAAe,SAAS,EAAE,MAAM,CAAC,CAAC;CAC3F,MAAM,YACL,SAAS,cACC;EACP,MAAM,WAAW,qBAAqB,MAAM,MAAM;AAClD,SAAO,MAAM,QAAQ,SAAS,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS;KACxD,GACH,EAAE;AACN,QAAO,CAAC,GAAG,oBAAoB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,KAAK,UAAU"}

package/dist/theme/data-attribute/subscribe-data-attribute.cjs

@@ -9,7 +9,7 @@ const require_parse_data_attribute = require('./parse-data-attribute.cjs');
 * @param themes - Record mapping theme keys to attribute values
 * @param attributeName - Data attribute name (e.g. `data-theme`)
 * @param handler - Callback invoked when the attribute changes
-* @param options.element - Element to observe (defaults to document.documentElement)
+* @param options.element - Element to observe (accepts null e.g. from refs). Defaults to document.documentElement.
 * @param options.parse - Custom parser (default: parseDataAttribute with space separator)
 * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).
 */
@@ -17,10 +17,9 @@ function subscribeDataAttribute(themes, attributeName, handler, options) {
 	const element = options?.element ?? document?.documentElement;
 	if (!element) return () => {};
 	const parse = options?.parse ?? ((t, v) => require_parse_data_attribute.parseDataAttribute(t, v, { separator: require__constant.SEPARATOR_SPACE }));
-	const observer = require_observe_data_attribute.observeDataAttributes({ [attributeName]: (value) => {
+	return require_observe_data_attribute.observeDataAttributes({ [attributeName]: (value) => {
 		handler(parse(themes, value ?? void 0));
 	} }, element);
-	return () => observer.disconnect();
 }
 
 //#endregion