@just-web/toolkits 2.0.0 → 2.1.0

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).
 */

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

@@ -1 +1 @@
-{"version":3,"file":"subscribe-data-attribute.cjs","names":["parseDataAttribute","SEPARATOR_SPACE","observeDataAttributes"],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-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 * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (defaults to document.documentElement)\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst observer = observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n\treturn () => observer.disconnect()\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAMA,gDAAmB,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC;CACtF,MAAM,WAAWC,qDAChB,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA;AACD,cAAa,SAAS,YAAY"}
+{"version":3,"file":"subscribe-data-attribute.cjs","names":["parseDataAttribute","SEPARATOR_SPACE","observeDataAttributes"],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-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 * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst observer = observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n\treturn () => observer.disconnect()\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAMA,gDAAmB,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC;CACtF,MAAM,WAAWC,qDAChB,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA;AACD,cAAa,SAAS,YAAY"}

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

@@ -9,12 +9,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 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).
  */
 declare function subscribeDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, handler: (entry: ThemeEntry<Themes> | undefined) => void, options?: {
-  element?: Element | undefined;
+  element?: Element | null | undefined;
   parse?: ParseStoredTheme<Themes> | undefined;
 } | undefined): () => void;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"subscribe-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgBA;;;;;;;;AAK6D,iBAL7C,sBAK6C,CAAA,eALP,QAKO,CAAA,CAAA,MAAA,EAJpD,MAIoD,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,OAAA,EAAA,CAAA,KAAA,EAF3C,UAE2C,CAFhC,MAEgC,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,EAAA,QAAA,EAAA;YAA7C;UAA6B,iBAAiB"}
+{"version":3,"file":"subscribe-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgBA;;;;;;;;AAKoE,iBALpD,sBAKoD,CAAA,eALd,QAKc,CAAA,CAAA,MAAA,EAJ3D,MAI2D,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,OAAA,EAAA,CAAA,KAAA,EAFlD,UAEkD,CAFvC,MAEuC,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,EAAA,QAAA,EAAA;YAApD;UAAoC,iBAAiB"}

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

@@ -9,12 +9,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 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).
  */
 declare function subscribeDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, handler: (entry: ThemeEntry<Themes> | undefined) => void, options?: {
-  element?: Element | undefined;
+  element?: Element | null | undefined;
   parse?: ParseStoredTheme<Themes> | undefined;
 } | undefined): () => void;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"subscribe-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgBA;;;;;;;;AAK6D,iBAL7C,sBAK6C,CAAA,eALP,QAKO,CAAA,CAAA,MAAA,EAJpD,MAIoD,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,OAAA,EAAA,CAAA,KAAA,EAF3C,UAE2C,CAFhC,MAEgC,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,EAAA,QAAA,EAAA;YAA7C;UAA6B,iBAAiB"}
+{"version":3,"file":"subscribe-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgBA;;;;;;;;AAKoE,iBALpD,sBAKoD,CAAA,eALd,QAKc,CAAA,CAAA,MAAA,EAJ3D,MAI2D,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,OAAA,EAAA,CAAA,KAAA,EAFlD,UAEkD,CAFvC,MAEuC,CAAA,GAAA,SAAA,EAAA,GAAA,IAAA,EAAA,QAAA,EAAA;YAApD;UAAoC,iBAAiB"}

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

@@ -9,7 +9,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 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).
 */

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

@@ -1 +1 @@
-{"version":3,"file":"subscribe-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-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 * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (defaults to document.documentElement)\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst observer = observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n\treturn () => observer.disconnect()\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAM,mBAAmB,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC;CACtF,MAAM,WAAW,sBAChB,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA;AACD,cAAa,SAAS,YAAY"}
+{"version":3,"file":"subscribe-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-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 * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst observer = observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n\treturn () => observer.disconnect()\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAM,mBAAmB,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC;CACtF,MAAM,WAAW,sBAChB,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA;AACD,cAAa,SAAS,YAAY"}

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

@@ -8,15 +8,15 @@ const require_stringify_data_attribute = require('./stringify-data-attribute.cjs
 *
 * @param themes - Record mapping theme keys to attribute values
 * @param attributeName - Data attribute name (e.g. `data-theme`)
-* @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: stringifyDataAttribute with space separator)
 */
 function writeDataAttribute(themes, attributeName, entry, options) {
 	const element = options?.element ?? document?.documentElement;
 	if (!element) return;
 	const stringify = options?.stringify ?? ((t, x, e) => require_stringify_data_attribute.stringifyDataAttribute(t, x, e, { separator: require__constant.SEPARATOR_SPACE }));
-	if (entry === void 0) {
+	if (entry == null) {
 		element.removeAttribute(attributeName);
 		return;
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"write-data-attribute.cjs","names":["stringifyDataAttribute","SEPARATOR_SPACE","getDataAttribute"],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { stringifyDataAttribute } from './stringify-data-attribute.ts'\n\n/**\n * Writes a theme entry to 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 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: stringifyDataAttribute with space separator)\n */\nexport function writeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\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 =\n\t\toptions?.stringify ??\n\t\t((t, x, e) => stringifyDataAttribute(t, x, e, { separator: SEPARATOR_SPACE }))\n\tif (entry === undefined) {\n\t\telement.removeAttribute(attributeName)\n\t\treturn\n\t}\n\tconst existing = getDataAttribute(attributeName, element) ?? undefined\n\tconst result = stringify(themes, existing, entry)\n\tif (result === '') {\n\t\telement.removeAttribute(attributeName)\n\t} else {\n\t\telement.setAttribute(attributeName, result)\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,mBACf,QACA,eACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;CACd,MAAM,YACL,SAAS,eACP,GAAG,GAAG,MAAMA,wDAAuB,GAAG,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC;AAC9E,KAAI,UAAU,QAAW;AACxB,UAAQ,gBAAgB,cAAc;AACtC;;CAGD,MAAM,SAAS,UAAU,QADRC,4CAAiB,eAAe,QAAQ,IAAI,QAClB,MAAM;AACjD,KAAI,WAAW,GACd,SAAQ,gBAAgB,cAAc;KAEtC,SAAQ,aAAa,eAAe,OAAO"}
+{"version":3,"file":"write-data-attribute.cjs","names":["stringifyDataAttribute","SEPARATOR_SPACE","getDataAttribute"],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { stringifyDataAttribute } from './stringify-data-attribute.ts'\n\n/**\n * Writes a theme entry to 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 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: stringifyDataAttribute with space separator)\n */\nexport function writeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\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 =\n\t\toptions?.stringify ??\n\t\t((t, x, e) => stringifyDataAttribute(t, x, e, { separator: SEPARATOR_SPACE }))\n\tif (entry == null) {\n\t\telement.removeAttribute(attributeName)\n\t\treturn\n\t}\n\tconst existing = getDataAttribute(attributeName, element) ?? undefined\n\tconst result = stringify(themes, existing, entry)\n\tif (result === '') {\n\t\telement.removeAttribute(attributeName)\n\t} else {\n\t\telement.setAttribute(attributeName, result)\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,mBACf,QACA,eACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;CACd,MAAM,YACL,SAAS,eACP,GAAG,GAAG,MAAMA,wDAAuB,GAAG,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC;AAC9E,KAAI,SAAS,MAAM;AAClB,UAAQ,gBAAgB,cAAc;AACtC;;CAGD,MAAM,SAAS,UAAU,QADRC,4CAAiB,eAAe,QAAQ,IAAI,QAClB,MAAM;AACjD,KAAI,WAAW,GACd,SAAQ,gBAAgB,cAAc;KAEtC,SAAQ,aAAa,eAAe,OAAO"}

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

@@ -8,12 +8,12 @@ import { StringifyStoredTheme, 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 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: stringifyDataAttribute with space separator)
  */
-declare function writeDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, entry: ThemeEntry<Themes> | undefined, options?: {
-  element?: Element | undefined;
+declare function writeDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, entry: ThemeEntry<Themes> | null | undefined, options?: {
+  element?: Element | null | undefined;
   stringify?: StringifyStoredTheme<Themes> | undefined;
 } | undefined): void;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"write-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAKiD,iBALjC,kBAKiC,CAAA,eALC,QAKD,CAAA,CAAA,MAAA,EAJxC,MAIwC,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,KAAA,EAFzC,UAEyC,CAF9B,MAE8B,CAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAAoB,OAAA,CAAA,EAArD,OAAqD,GAAA,SAAA;cAApB,qBAAqB"}
+{"version":3,"file":"write-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAKwD,iBALxC,kBAKwC,CAAA,eALN,QAKM,CAAA,CAAA,MAAA,EAJ/C,MAI+C,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,KAAA,EAFhD,UAEgD,CAFrC,MAEqC,CAAA,GAAA,IAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAAoB,OAAA,CAAA,EAA5D,OAA4D,GAAA,IAAA,GAAA,SAAA;cAApB,qBAAqB"}

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

@@ -8,12 +8,12 @@ import { StringifyStoredTheme, 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 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: stringifyDataAttribute with space separator)
  */
-declare function writeDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, entry: ThemeEntry<Themes> | undefined, options?: {
-  element?: Element | undefined;
+declare function writeDataAttribute<Themes extends ThemeMap>(themes: Themes, attributeName: `data-${string}`, entry: ThemeEntry<Themes> | null | undefined, options?: {
+  element?: Element | null | undefined;
   stringify?: StringifyStoredTheme<Themes> | undefined;
 } | undefined): void;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"write-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAKiD,iBALjC,kBAKiC,CAAA,eALC,QAKD,CAAA,CAAA,MAAA,EAJxC,MAIwC,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,KAAA,EAFzC,UAEyC,CAF9B,MAE8B,CAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAAoB,OAAA,CAAA,EAArD,OAAqD,GAAA,SAAA;cAApB,qBAAqB"}
+{"version":3,"file":"write-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;;;AAKwD,iBALxC,kBAKwC,CAAA,eALN,QAKM,CAAA,CAAA,MAAA,EAJ/C,MAI+C,EAAA,aAAA,EAAA,QAAA,MAAA,EAAA,EAAA,KAAA,EAFhD,UAEgD,CAFrC,MAEqC,CAAA,GAAA,IAAA,GAAA,SAAA,EAAA,QAAA,EAAA;EAAoB,OAAA,CAAA,EAA5D,OAA4D,GAAA,IAAA,GAAA,SAAA;cAApB,qBAAqB"}

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

@@ -8,15 +8,15 @@ import { stringifyDataAttribute } from "./stringify-data-attribute.mjs";
 *
 * @param themes - Record mapping theme keys to attribute values
 * @param attributeName - Data attribute name (e.g. `data-theme`)
-* @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: stringifyDataAttribute with space separator)
 */
 function writeDataAttribute(themes, attributeName, entry, options) {
 	const element = options?.element ?? document?.documentElement;
 	if (!element) return;
 	const stringify = options?.stringify ?? ((t, x, e) => stringifyDataAttribute(t, x, e, { separator: SEPARATOR_SPACE }));
-	if (entry === void 0) {
+	if (entry == null) {
 		element.removeAttribute(attributeName);
 		return;
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"write-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { stringifyDataAttribute } from './stringify-data-attribute.ts'\n\n/**\n * Writes a theme entry to 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 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: stringifyDataAttribute with space separator)\n */\nexport function writeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\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 =\n\t\toptions?.stringify ??\n\t\t((t, x, e) => stringifyDataAttribute(t, x, e, { separator: SEPARATOR_SPACE }))\n\tif (entry === undefined) {\n\t\telement.removeAttribute(attributeName)\n\t\treturn\n\t}\n\tconst existing = getDataAttribute(attributeName, element) ?? undefined\n\tconst result = stringify(themes, existing, entry)\n\tif (result === '') {\n\t\telement.removeAttribute(attributeName)\n\t} else {\n\t\telement.setAttribute(attributeName, result)\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,mBACf,QACA,eACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;CACd,MAAM,YACL,SAAS,eACP,GAAG,GAAG,MAAM,uBAAuB,GAAG,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC;AAC9E,KAAI,UAAU,QAAW;AACxB,UAAQ,gBAAgB,cAAc;AACtC;;CAGD,MAAM,SAAS,UAAU,QADR,iBAAiB,eAAe,QAAQ,IAAI,QAClB,MAAM;AACjD,KAAI,WAAW,GACd,SAAQ,gBAAgB,cAAc;KAEtC,SAAQ,aAAa,eAAe,OAAO"}
+{"version":3,"file":"write-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/write-data-attribute.ts"],"sourcesContent":["import { getDataAttribute } from '../../attributes/get-data-attribute.ts'\nimport type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { stringifyDataAttribute } from './stringify-data-attribute.ts'\n\n/**\n * Writes a theme entry to 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 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: stringifyDataAttribute with space separator)\n */\nexport function writeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\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 =\n\t\toptions?.stringify ??\n\t\t((t, x, e) => stringifyDataAttribute(t, x, e, { separator: SEPARATOR_SPACE }))\n\tif (entry == null) {\n\t\telement.removeAttribute(attributeName)\n\t\treturn\n\t}\n\tconst existing = getDataAttribute(attributeName, element) ?? undefined\n\tconst result = stringify(themes, existing, entry)\n\tif (result === '') {\n\t\telement.removeAttribute(attributeName)\n\t} else {\n\t\telement.setAttribute(attributeName, result)\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,mBACf,QACA,eACA,OACA,SAGO;CACP,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS;CACd,MAAM,YACL,SAAS,eACP,GAAG,GAAG,MAAM,uBAAuB,GAAG,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC;AAC9E,KAAI,SAAS,MAAM;AAClB,UAAQ,gBAAgB,cAAc;AACtC;;CAGD,MAAM,SAAS,UAAU,QADR,iBAAiB,eAAe,QAAQ,IAAI,QAClB,MAAM;AACjD,KAAI,WAAW,GACd,SAAQ,gBAAgB,cAAc;KAEtC,SAAQ,aAAa,eAAe,OAAO"}

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

@@ -8,7 +8,7 @@ const require_write_web_storage = require('../web-storage/write-web-storage.cjs'
 *
 * @param themes - Record mapping theme keys to values (used by stringify)
 * @param storageKey - localStorage key to write to
-* @param entry - Theme entry to write, or undefined to remove
+* @param entry - Theme entry to write, or null/undefined to remove
 * @param options.stringify - Custom serializer (default: JSON.stringify)
 * @param options.onError - Optional callback invoked when storage write throws
 */