@just-web/toolkits 1.0.0 → 2.1.0

package/src/theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts

@@ -1,7 +1,7 @@
 import { dummyThemeStore } from '../../../testing/theme/dummy-theme-store.ts'
-import { parseStoredTheme } from '../../_utils/parse-stored-theme.ts'
-import { themeEntry } from '../../theme-entry.ts'
-import type { ThemeEntry } from '../../theme-entry.types.ts'
+import { readSessionStorage } from '../../session-storage/read-session-storage.ts'
+import { writeSessionStorage } from '../../session-storage/write-session-storage.ts'
+import type { ParseStoredTheme, StringifyStoredTheme, ThemeEntry } from '../../theme-entry.types.ts'
 import type { ThemeMap } from '../../theme-map.types.ts'
 import type { ThemeStore } from '../theme-store.types.ts'
 
@@ -13,6 +13,9 @@ import type { ThemeStore } from '../theme-store.types.ts'
  *
  * @param themes - Record mapping theme keys to values (for validation)
  * @param options.storageKey - sessionStorage key
+ * @param options.parse - Optional custom parser for stored string (default: parseStoredTheme)
+ * @param options.stringify - Optional custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when storage write throws
  * @returns ThemeStore
  *
  * @example
@@ -26,11 +29,16 @@ import type { ThemeStore } from '../theme-store.types.ts'
  */
 export function sessionStorageThemeStore<Themes extends ThemeMap>(
 	themes: Themes,
-	options: { storageKey: string }
+	options: {
+		storageKey: string
+		parse?: ParseStoredTheme<Themes> | undefined
+		stringify?: StringifyStoredTheme<Themes> | undefined
+		onError?: ((error: unknown) => void) | undefined
+	}
 ) {
-	const { storageKey } = options
+	const { storageKey, parse, stringify, onError } = options
 
-	if (typeof window === 'undefined' || !window.sessionStorage) {
+	if (!window?.sessionStorage) {
 		return dummyThemeStore satisfies ThemeStore<Themes>
 	}
 
@@ -38,10 +46,7 @@ export function sessionStorageThemeStore<Themes extends ThemeMap>(
 	let lastNotifiedKey: keyof Themes | undefined = read()?.theme ?? undefined
 
 	function read() {
-		const stored = window.sessionStorage.getItem(storageKey)
-		const theme = parseStoredTheme(themes, stored)
-		if (theme === undefined) return undefined
-		return themeEntry(themes, theme)
+		return readSessionStorage(themes, storageKey, { parse })
 	}
 
 	function notify() {
@@ -55,16 +60,8 @@ export function sessionStorageThemeStore<Themes extends ThemeMap>(
 	return {
 		read,
 		write(entry) {
-			try {
-				if (entry === undefined) {
-					window.sessionStorage.removeItem(storageKey)
-				} else {
-					window.sessionStorage.setItem(storageKey, JSON.stringify(entry))
-				}
-				notify()
-			} catch {
-				// Ignore quota or other errors
-			}
+			writeSessionStorage(themes, storageKey, entry, { stringify, onError })
+			notify()
 		},
 		subscribe(handler) {
 			handlers.add(handler)

package/src/theme/theme-store/theme-store.types.ts

@@ -24,7 +24,5 @@ import type { ThemeMap } from '../theme-map.types.ts'
 export interface ThemeStore<Themes extends ThemeMap = ThemeMap> {
 	read?: (() => ThemeEntry<Themes> | undefined) | undefined
 	write?: ((entry: ThemeEntry<Themes> | undefined) => void) | undefined
-	subscribe?:
-		| ((handler: (theme: ThemeEntry<Themes> | undefined | null) => void) => () => void)
-		| undefined
+	subscribe?: ((handler: (theme: ThemeEntry<Themes> | undefined) => void) => () => void) | undefined
 }

package/src/theme/web-storage/read-web-storage.ts

@@ -0,0 +1,22 @@
+import { parseStoredTheme } from '../_utils/parse-stored-theme.ts'
+import type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'
+import type { ThemeMap } from '../theme-map.types.ts'
+
+/**
+ * Reads a theme entry from a web storage (localStorage or sessionStorage).
+ *
+ * @param themes - Record mapping theme keys to values (for validation)
+ * @param storageKey - Storage key to read from
+ * @param options.storage - Storage object (localStorage or sessionStorage)
+ * @param options.parse - Custom parser (default: parseStoredTheme)
+ * @returns ThemeEntry if found, undefined otherwise. Returns undefined when storage is unavailable (e.g. SSR).
+ */
+export function readWebStorage<Themes extends ThemeMap>(
+	themes: Themes,
+	storageKey: string,
+	options: { storage: Storage; parse?: ParseStoredTheme<Themes> | undefined }
+): ThemeEntry<Themes> | undefined {
+	const { storage, parse = parseStoredTheme } = options
+	const stored = storage.getItem(storageKey)
+	return parse(themes, stored ?? undefined)
+}

package/src/theme/web-storage/write-web-storage.ts

@@ -0,0 +1,46 @@
+import type { StringifyStoredTheme, ThemeEntry } from '../theme-entry.types.ts'
+import type { ThemeMap } from '../theme-map.types.ts'
+
+function defaultStringify<Themes extends ThemeMap>(
+	_themes: Themes,
+	_existing: string | undefined,
+	entry: ThemeEntry<Themes> | null | undefined
+): string {
+	return entry == null ? '' : JSON.stringify(entry)
+}
+
+/**
+ * Writes a theme entry to a web storage (localStorage or sessionStorage).
+ *
+ * Performs setItem/removeItem only. Does not notify subscribers; the store must call notify() after this.
+ *
+ * @param themes - Record mapping theme keys to values (used by stringify)
+ * @param storageKey - Storage key to write to
+ * @param entry - Theme entry to write, or null/undefined to remove
+ * @param options.storage - Storage object (localStorage or sessionStorage)
+ * @param options.stringify - Custom serializer (default: JSON.stringify)
+ * @param options.onError - Optional callback invoked when setItem/removeItem throws
+ */
+export function writeWebStorage<Themes extends ThemeMap>(
+	themes: Themes,
+	storageKey: string,
+	entry: ThemeEntry<Themes> | null | undefined,
+	options: {
+		storage: Storage
+		stringify?: StringifyStoredTheme<Themes> | undefined
+		onError?: ((error: unknown) => void) | undefined
+	}
+): void {
+	const { storage, stringify = defaultStringify, onError } = options
+	try {
+		if (entry == null) {
+			storage.removeItem(storageKey)
+		} else {
+			const existing = storage.getItem(storageKey) ?? undefined
+			const value = stringify(themes, existing, entry)
+			storage.setItem(storageKey, value)
+		}
+	} catch (error) {
+		onError?.(error)
+	}
+}

package/src/theme.ts

@@ -1,4 +1,22 @@
+export * from './theme/class-name/parse-class-name.ts'
+export * from './theme/class-name/read-class-name.ts'
+export * from './theme/class-name/stringify-class-name.ts'
+export * from './theme/class-name/subscribe-class-name.ts'
+export * from './theme/class-name/write-class-name.ts'
 export * from './theme/compose-theme-stores.ts'
+export * from './theme/cookie/read-cookie-theme.ts'
+export * from './theme/cookie/write-cookie-theme.ts'
+export * from './theme/data-attribute/parse-data-attribute.ts'
+export * from './theme/data-attribute/read-data-attribute.ts'
+export * from './theme/data-attribute/stringify-data-attribute.ts'
+export * from './theme/data-attribute/subscribe-data-attribute.ts'
+export * from './theme/data-attribute/write-data-attribute.ts'
+export * from './theme/local-storage/read-local-storage.ts'
+export * from './theme/local-storage/write-local-storage.ts'
+export * from './theme/prefers-color-scheme-theme/read-prefers-color-scheme-theme.ts'
+export * from './theme/prefers-color-scheme-theme/subscribe-prefers-color-scheme-theme.ts'
+export * from './theme/session-storage/read-session-storage.ts'
+export * from './theme/session-storage/write-session-storage.ts'
 export * from './theme/theme-entry.ts'
 export type * from './theme/theme-entry.types.ts'
 export type * from './theme/theme-map.types.ts'
@@ -12,3 +30,5 @@ export * from './theme/theme-store/prefers-color-scheme-theme-store/prefers-colo
 export * from './theme/theme-store/session-storage-theme-store/session-storage-theme-store.ts'
 export type * from './theme/theme-store/theme-store.types.ts'
 export type * from './theme/theme-store/theme-store-factory.types.ts'
+export * from './theme/web-storage/read-web-storage.ts'
+export * from './theme/web-storage/write-web-storage.ts'

package/src/utils/append-id.ts

@@ -1,10 +1,10 @@
 /**
  * Appends a suffix to an ID if the ID is defined.
  *
- * @param id - The ID to append the suffix to.
+ * @param id - The ID to append the suffix to (accepts null e.g. from getAttribute).
  * @param suffix - The suffix to append to the ID.
- * @returns The ID with the suffix appended, or undefined if the ID is undefined.
+ * @returns The ID with the suffix appended, or undefined if the ID is null/undefined.
  */
-export function appendId(id: string | undefined, suffix: string): string | undefined {
+export function appendId(id: string | null | undefined, suffix: string): string | undefined {
 	return id ? `${id}-${suffix}` : undefined
 }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/src/theme/class-name/apply-theme-to-class-name.ts

@@ -1,26 +0,0 @@
-import type { ThemeEntry } from '../theme-entry.types.ts'
-import type { ThemeMap } from '../theme-map.types.ts'
-
-/**
- * Applies theme to element by updating its class attribute.
- *
- * Removes all theme classes from the element, then adds classes for the given entry.
- * When entry is undefined, removes all theme classes (themeMap needed for clear path).
- *
- * @param element - Target element
- * @param entry - Theme entry to apply, or undefined to clear
- * @param themes - Record mapping theme keys to class names (used for clear case)
- */
-export function applyThemeToClassName<Themes extends ThemeMap>(
-	themes: Themes,
-	element: Element,
-	entry: ThemeEntry<Themes> | undefined
-): void {
-	const allThemeClasses = Object.values(themes).flatMap((v) => (Array.isArray(v) ? [...v] : [v]))
-	const current = element.className.trim()
-	const currentClasses = current ? current.split(/\s+/) : []
-	const withoutThemes = currentClasses.filter((c) => !allThemeClasses.includes(c))
-	const activeClasses =
-		entry !== undefined ? (Array.isArray(entry.value) ? [...entry.value] : [entry.value]) : []
-	element.className = [...withoutThemes, ...activeClasses].filter(Boolean).join(' ')
-}

package/src/theme/class-name/resolve-theme-from-class-name.ts

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

package/src/theme/data-attribute/apply-theme-to-data-attribute.ts

@@ -1,27 +0,0 @@
-import type { ThemeEntry } from '../theme-entry.types.ts'
-import type { ThemeMap } from '../theme-map.types.ts'
-
-/**
- * Applies theme to element by setting or removing a data attribute.
- *
- * @param element - Target element
- * @param attributeName - Data attribute name (e.g. `data-theme`)
- * @param entry - Theme entry to apply, or undefined to remove attribute
- */
-export function applyThemeToDataAttribute<Themes extends ThemeMap>(
-	element: Element,
-	attributeName: `data-${string}`,
-	entry: ThemeEntry<Themes> | undefined
-): void {
-	if (entry === undefined) {
-		element.removeAttribute(attributeName)
-		return
-	}
-	const val = entry.value
-	const attributeValue = Array.isArray(val) ? val[0] : val
-	if (attributeValue !== undefined && attributeValue !== '') {
-		element.setAttribute(attributeName, attributeValue)
-	} else {
-		element.removeAttribute(attributeName)
-	}
-}

package/src/theme/data-attribute/resolve-theme-from-data-attribute.ts

@@ -1,23 +0,0 @@
-import { findKey } from 'type-plus'
-import type { ThemeMap } from '../theme-map.types.ts'
-
-/**
- * Resolves theme key from data attribute value by matching against theme map.
- *
- * @param attrValue - Data attribute value (e.g. from getAttribute)
- * @param themes - Record mapping theme keys to attribute values
- * @returns Theme key if a match is found, otherwise undefined
- */
-export function resolveThemeFromDataAttribute<Theme extends string>(
-	themes: ThemeMap<Theme>,
-	attrValue: string | null
-): Theme | undefined {
-	if (attrValue === null || attrValue === '') return undefined
-	const theme = findKey(themes, (key) => {
-		const value = themes[key]
-		if (value === undefined) return false
-		const v = Array.isArray(value) ? value[0] : value
-		return v === attrValue
-	})
-	return theme as Theme | undefined
-}