@just-web/toolkits 1.0.0 → 2.0.0

package/dist/theme/cookie/_cookie-utils.cjs

@@ -0,0 +1,37 @@
+
+//#region src/theme/cookie/_cookie-utils.ts
+/**
+* Internal cookie utilities for theme cookie storage.
+* Cookie Store API has limited support; document.cookie is standard for theme persistence.
+*/
+function getCookieValue(name) {
+	if (typeof document === "undefined" || !document.cookie) return null;
+	const value = document.cookie.match(/* @__PURE__ */ new RegExp(`(?:^|;\\s*)${name}=([^;]*)`))?.[1];
+	return value !== void 0 ? decodeURIComponent(value) : null;
+}
+function setCookie(name, value, options) {
+	const parts = [`${name}=${encodeURIComponent(value)}`];
+	parts.push(`path=${options.path ?? "/"}`);
+	if (options.maxAge !== void 0) parts.push(`max-age=${options.maxAge}`);
+	if (options.sameSite !== void 0) parts.push(`samesite=${options.sameSite}`);
+	if (options.secure) parts.push("secure");
+	document.cookie = parts.join("; ");
+}
+function deleteCookie(name, path = "/") {
+	document.cookie = `${name}=; path=${path}; max-age=0`;
+}
+/**
+* Parses a cookie value from a raw Cookie header string.
+* Used for SSR when reading from request headers or framework cookie APIs.
+*/
+function getCookieFromHeader(cookieHeader, name) {
+	const value = cookieHeader.match(/* @__PURE__ */ new RegExp(`(?:^|;\\s*)${name}=([^;]*)`))?.[1];
+	return value !== void 0 ? decodeURIComponent(value.trim()) : null;
+}
+
+//#endregion
+exports.deleteCookie = deleteCookie;
+exports.getCookieFromHeader = getCookieFromHeader;
+exports.getCookieValue = getCookieValue;
+exports.setCookie = setCookie;
+//# sourceMappingURL=_cookie-utils.cjs.map

package/dist/theme/cookie/_cookie-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_cookie-utils.cjs","names":[],"sources":["../../../src/theme/cookie/_cookie-utils.ts"],"sourcesContent":["/**\n * Internal cookie utilities for theme cookie storage.\n * Cookie Store API has limited support; document.cookie is standard for theme persistence.\n */\n\nexport function getCookieValue(name: string): string | null {\n\tif (typeof document === 'undefined' || !document.cookie) return null\n\tconst match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`))\n\tconst value = match?.[1]\n\treturn value !== undefined ? decodeURIComponent(value) : null\n}\n\nexport function setCookie(\n\tname: string,\n\tvalue: string,\n\toptions: {\n\t\tpath?: string | undefined\n\t\tmaxAge?: number | undefined\n\t\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\t\tsecure?: boolean | undefined\n\t}\n) {\n\tconst parts = [`${name}=${encodeURIComponent(value)}`]\n\tparts.push(`path=${options.path ?? '/'}`)\n\tif (options.maxAge !== undefined) parts.push(`max-age=${options.maxAge}`)\n\tif (options.sameSite !== undefined) parts.push(`samesite=${options.sameSite}`)\n\tif (options.secure) parts.push('secure')\n\t// biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API has limited support; document.cookie is standard for theme persistence\n\tdocument.cookie = parts.join('; ')\n}\n\nexport function deleteCookie(name: string, path = '/') {\n\t// biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API has limited support; document.cookie is standard for theme persistence\n\tdocument.cookie = `${name}=; path=${path}; max-age=0`\n}\n\n/**\n * Parses a cookie value from a raw Cookie header string.\n * Used for SSR when reading from request headers or framework cookie APIs.\n */\nexport function getCookieFromHeader(cookieHeader: string, name: string): string | null {\n\tconst match = cookieHeader.match(new RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`))\n\tconst value = match?.[1]\n\treturn value !== undefined ? decodeURIComponent(value.trim()) : null\n}\n"],"mappings":";;;;;;AAKA,SAAgB,eAAe,MAA6B;AAC3D,KAAI,OAAO,aAAa,eAAe,CAAC,SAAS,OAAQ,QAAO;CAEhE,MAAM,QADQ,SAAS,OAAO,sBAAM,IAAI,OAAO,cAAc,KAAK,UAAU,CAAC,GACvD;AACtB,QAAO,UAAU,SAAY,mBAAmB,MAAM,GAAG;;AAG1D,SAAgB,UACf,MACA,OACA,SAMC;CACD,MAAM,QAAQ,CAAC,GAAG,KAAK,GAAG,mBAAmB,MAAM,GAAG;AACtD,OAAM,KAAK,QAAQ,QAAQ,QAAQ,MAAM;AACzC,KAAI,QAAQ,WAAW,OAAW,OAAM,KAAK,WAAW,QAAQ,SAAS;AACzE,KAAI,QAAQ,aAAa,OAAW,OAAM,KAAK,YAAY,QAAQ,WAAW;AAC9E,KAAI,QAAQ,OAAQ,OAAM,KAAK,SAAS;AAExC,UAAS,SAAS,MAAM,KAAK,KAAK;;AAGnC,SAAgB,aAAa,MAAc,OAAO,KAAK;AAEtD,UAAS,SAAS,GAAG,KAAK,UAAU,KAAK;;;;;;AAO1C,SAAgB,oBAAoB,cAAsB,MAA6B;CAEtF,MAAM,QADQ,aAAa,sBAAM,IAAI,OAAO,cAAc,KAAK,UAAU,CAAC,GACpD;AACtB,QAAO,UAAU,SAAY,mBAAmB,MAAM,MAAM,CAAC,GAAG"}

package/dist/theme/cookie/_cookie-utils.mjs

@@ -0,0 +1,33 @@
+//#region src/theme/cookie/_cookie-utils.ts
+/**
+* Internal cookie utilities for theme cookie storage.
+* Cookie Store API has limited support; document.cookie is standard for theme persistence.
+*/
+function getCookieValue(name) {
+	if (typeof document === "undefined" || !document.cookie) return null;
+	const value = document.cookie.match(/* @__PURE__ */ new RegExp(`(?:^|;\\s*)${name}=([^;]*)`))?.[1];
+	return value !== void 0 ? decodeURIComponent(value) : null;
+}
+function setCookie(name, value, options) {
+	const parts = [`${name}=${encodeURIComponent(value)}`];
+	parts.push(`path=${options.path ?? "/"}`);
+	if (options.maxAge !== void 0) parts.push(`max-age=${options.maxAge}`);
+	if (options.sameSite !== void 0) parts.push(`samesite=${options.sameSite}`);
+	if (options.secure) parts.push("secure");
+	document.cookie = parts.join("; ");
+}
+function deleteCookie(name, path = "/") {
+	document.cookie = `${name}=; path=${path}; max-age=0`;
+}
+/**
+* Parses a cookie value from a raw Cookie header string.
+* Used for SSR when reading from request headers or framework cookie APIs.
+*/
+function getCookieFromHeader(cookieHeader, name) {
+	const value = cookieHeader.match(/* @__PURE__ */ new RegExp(`(?:^|;\\s*)${name}=([^;]*)`))?.[1];
+	return value !== void 0 ? decodeURIComponent(value.trim()) : null;
+}
+
+//#endregion
+export { deleteCookie, getCookieFromHeader, getCookieValue, setCookie };
+//# sourceMappingURL=_cookie-utils.mjs.map

package/dist/theme/cookie/_cookie-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_cookie-utils.mjs","names":[],"sources":["../../../src/theme/cookie/_cookie-utils.ts"],"sourcesContent":["/**\n * Internal cookie utilities for theme cookie storage.\n * Cookie Store API has limited support; document.cookie is standard for theme persistence.\n */\n\nexport function getCookieValue(name: string): string | null {\n\tif (typeof document === 'undefined' || !document.cookie) return null\n\tconst match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`))\n\tconst value = match?.[1]\n\treturn value !== undefined ? decodeURIComponent(value) : null\n}\n\nexport function setCookie(\n\tname: string,\n\tvalue: string,\n\toptions: {\n\t\tpath?: string | undefined\n\t\tmaxAge?: number | undefined\n\t\tsameSite?: 'lax' | 'strict' | 'none' | undefined\n\t\tsecure?: boolean | undefined\n\t}\n) {\n\tconst parts = [`${name}=${encodeURIComponent(value)}`]\n\tparts.push(`path=${options.path ?? '/'}`)\n\tif (options.maxAge !== undefined) parts.push(`max-age=${options.maxAge}`)\n\tif (options.sameSite !== undefined) parts.push(`samesite=${options.sameSite}`)\n\tif (options.secure) parts.push('secure')\n\t// biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API has limited support; document.cookie is standard for theme persistence\n\tdocument.cookie = parts.join('; ')\n}\n\nexport function deleteCookie(name: string, path = '/') {\n\t// biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API has limited support; document.cookie is standard for theme persistence\n\tdocument.cookie = `${name}=; path=${path}; max-age=0`\n}\n\n/**\n * Parses a cookie value from a raw Cookie header string.\n * Used for SSR when reading from request headers or framework cookie APIs.\n */\nexport function getCookieFromHeader(cookieHeader: string, name: string): string | null {\n\tconst match = cookieHeader.match(new RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`))\n\tconst value = match?.[1]\n\treturn value !== undefined ? decodeURIComponent(value.trim()) : null\n}\n"],"mappings":";;;;;AAKA,SAAgB,eAAe,MAA6B;AAC3D,KAAI,OAAO,aAAa,eAAe,CAAC,SAAS,OAAQ,QAAO;CAEhE,MAAM,QADQ,SAAS,OAAO,sBAAM,IAAI,OAAO,cAAc,KAAK,UAAU,CAAC,GACvD;AACtB,QAAO,UAAU,SAAY,mBAAmB,MAAM,GAAG;;AAG1D,SAAgB,UACf,MACA,OACA,SAMC;CACD,MAAM,QAAQ,CAAC,GAAG,KAAK,GAAG,mBAAmB,MAAM,GAAG;AACtD,OAAM,KAAK,QAAQ,QAAQ,QAAQ,MAAM;AACzC,KAAI,QAAQ,WAAW,OAAW,OAAM,KAAK,WAAW,QAAQ,SAAS;AACzE,KAAI,QAAQ,aAAa,OAAW,OAAM,KAAK,YAAY,QAAQ,WAAW;AAC9E,KAAI,QAAQ,OAAQ,OAAM,KAAK,SAAS;AAExC,UAAS,SAAS,MAAM,KAAK,KAAK;;AAGnC,SAAgB,aAAa,MAAc,OAAO,KAAK;AAEtD,UAAS,SAAS,GAAG,KAAK,UAAU,KAAK;;;;;;AAO1C,SAAgB,oBAAoB,cAAsB,MAA6B;CAEtF,MAAM,QADQ,aAAa,sBAAM,IAAI,OAAO,cAAc,KAAK,UAAU,CAAC,GACpD;AACtB,QAAO,UAAU,SAAY,mBAAmB,MAAM,MAAM,CAAC,GAAG"}

package/dist/theme/cookie/read-cookie-theme.cjs

@@ -0,0 +1,22 @@
+const require_parse_stored_theme = require('../_utils/parse-stored-theme.cjs');
+const require__cookie_utils = require('./_cookie-utils.cjs');
+
+//#region src/theme/cookie/read-cookie-theme.ts
+/**
+* Reads a theme entry from a cookie.
+*
+* @param themes - Record mapping theme keys to values (for validation)
+* @param options.cookieName - Cookie name to read from
+* @param options.path - Cookie path (default: '/')
+* @param options.parse - Custom parser (default: parseStoredTheme)
+* @returns ThemeEntry if found, undefined otherwise. Returns undefined when document.cookie is unavailable (e.g. SSR).
+*/
+function readCookieTheme(themes, options) {
+	const { cookieName, parse = require_parse_stored_theme.parseStoredTheme } = options;
+	if (typeof document === "undefined" || document.cookie === void 0) return;
+	return parse(themes, require__cookie_utils.getCookieValue(cookieName) ?? void 0);
+}
+
+//#endregion
+exports.readCookieTheme = readCookieTheme;
+//# sourceMappingURL=read-cookie-theme.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-cookie-theme.cjs","names":["parseStoredTheme","getCookieValue"],"sources":["../../../src/theme/cookie/read-cookie-theme.ts"],"sourcesContent":["import { parseStoredTheme } from '../_utils/parse-stored-theme.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { getCookieValue } from './_cookie-utils.ts'\n\nexport interface ReadCookieThemeOptions<Themes extends ThemeMap = ThemeMap> {\n\tcookieName: string\n\tpath?: string | undefined\n\tparse?: ParseStoredTheme<Themes> | undefined\n}\n\n/**\n * Reads a theme entry from a cookie.\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options.cookieName - Cookie name to read from\n * @param options.path - Cookie path (default: '/')\n * @param options.parse - Custom parser (default: parseStoredTheme)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when document.cookie is unavailable (e.g. SSR).\n */\nexport function readCookieTheme<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions: ReadCookieThemeOptions<Themes>\n): ThemeEntry<Themes> | undefined {\n\tconst { cookieName, parse = parseStoredTheme } = options\n\n\tif (typeof document === 'undefined' || document.cookie === undefined) {\n\t\treturn undefined\n\t}\n\n\tconst stored = getCookieValue(cookieName)\n\treturn parse(themes, stored ?? undefined)\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgB,gBACf,QACA,SACiC;CACjC,MAAM,EAAE,YAAY,QAAQA,gDAAqB;AAEjD,KAAI,OAAO,aAAa,eAAe,SAAS,WAAW,OAC1D;AAID,QAAO,MAAM,QADEC,qCAAe,WAAW,IACV,OAAU"}

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

@@ -0,0 +1,22 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/cookie/read-cookie-theme.d.ts
+interface ReadCookieThemeOptions<Themes extends ThemeMap = ThemeMap> {
+  cookieName: string;
+  path?: string | undefined;
+  parse?: ParseStoredTheme<Themes> | undefined;
+}
+/**
+ * Reads a theme entry from a cookie.
+ *
+ * @param themes - Record mapping theme keys to values (for validation)
+ * @param options.cookieName - Cookie name to read from
+ * @param options.path - Cookie path (default: '/')
+ * @param options.parse - Custom parser (default: parseStoredTheme)
+ * @returns ThemeEntry if found, undefined otherwise. Returns undefined when document.cookie is unavailable (e.g. SSR).
+ */
+declare function readCookieTheme<Themes extends ThemeMap>(themes: Themes, options: ReadCookieThemeOptions<Themes>): ThemeEntry<Themes> | undefined;
+//#endregion
+export { ReadCookieThemeOptions, readCookieTheme };
+//# sourceMappingURL=read-cookie-theme.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-cookie-theme.d.cts","names":[],"sources":["../../../src/theme/cookie/read-cookie-theme.ts"],"sourcesContent":[],"mappings":";;;;UAKiB,sCAAsC,WAAW;;EAAjD,IAAA,CAAA,EAAA,MAAA,GAAA,SAAsB;EAAgB,KAAA,CAAA,EAG9C,gBAH8C,CAG7B,MAH6B,CAAA,GAAA,SAAA;;;;;AAevD;;;;;;AAGG,iBAHa,eAGb,CAAA,eAH4C,QAG5C,CAAA,CAAA,MAAA,EAFM,MAEN,EAAA,OAAA,EADO,sBACP,CAD8B,MAC9B,CAAA,CAAA,EAAA,UAAA,CAAW,MAAX,CAAA,GAAA,SAAA"}

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

@@ -0,0 +1,22 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/cookie/read-cookie-theme.d.ts
+interface ReadCookieThemeOptions<Themes extends ThemeMap = ThemeMap> {
+  cookieName: string;
+  path?: string | undefined;
+  parse?: ParseStoredTheme<Themes> | undefined;
+}
+/**
+ * Reads a theme entry from a cookie.
+ *
+ * @param themes - Record mapping theme keys to values (for validation)
+ * @param options.cookieName - Cookie name to read from
+ * @param options.path - Cookie path (default: '/')
+ * @param options.parse - Custom parser (default: parseStoredTheme)
+ * @returns ThemeEntry if found, undefined otherwise. Returns undefined when document.cookie is unavailable (e.g. SSR).
+ */
+declare function readCookieTheme<Themes extends ThemeMap>(themes: Themes, options: ReadCookieThemeOptions<Themes>): ThemeEntry<Themes> | undefined;
+//#endregion
+export { ReadCookieThemeOptions, readCookieTheme };
+//# sourceMappingURL=read-cookie-theme.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-cookie-theme.d.mts","names":[],"sources":["../../../src/theme/cookie/read-cookie-theme.ts"],"sourcesContent":[],"mappings":";;;;UAKiB,sCAAsC,WAAW;;EAAjD,IAAA,CAAA,EAAA,MAAA,GAAA,SAAsB;EAAgB,KAAA,CAAA,EAG9C,gBAH8C,CAG7B,MAH6B,CAAA,GAAA,SAAA;;;;;AAevD;;;;;;AAGG,iBAHa,eAGb,CAAA,eAH4C,QAG5C,CAAA,CAAA,MAAA,EAFM,MAEN,EAAA,OAAA,EADO,sBACP,CAD8B,MAC9B,CAAA,CAAA,EAAA,UAAA,CAAW,MAAX,CAAA,GAAA,SAAA"}

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

@@ -0,0 +1,22 @@
+import { parseStoredTheme } from "../_utils/parse-stored-theme.mjs";
+import { getCookieValue } from "./_cookie-utils.mjs";
+
+//#region src/theme/cookie/read-cookie-theme.ts
+/**
+* Reads a theme entry from a cookie.
+*
+* @param themes - Record mapping theme keys to values (for validation)
+* @param options.cookieName - Cookie name to read from
+* @param options.path - Cookie path (default: '/')
+* @param options.parse - Custom parser (default: parseStoredTheme)
+* @returns ThemeEntry if found, undefined otherwise. Returns undefined when document.cookie is unavailable (e.g. SSR).
+*/
+function readCookieTheme(themes, options) {
+	const { cookieName, parse = parseStoredTheme } = options;
+	if (typeof document === "undefined" || document.cookie === void 0) return;
+	return parse(themes, getCookieValue(cookieName) ?? void 0);
+}
+
+//#endregion
+export { readCookieTheme };
+//# sourceMappingURL=read-cookie-theme.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-cookie-theme.mjs","names":[],"sources":["../../../src/theme/cookie/read-cookie-theme.ts"],"sourcesContent":["import { parseStoredTheme } from '../_utils/parse-stored-theme.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { getCookieValue } from './_cookie-utils.ts'\n\nexport interface ReadCookieThemeOptions<Themes extends ThemeMap = ThemeMap> {\n\tcookieName: string\n\tpath?: string | undefined\n\tparse?: ParseStoredTheme<Themes> | undefined\n}\n\n/**\n * Reads a theme entry from a cookie.\n *\n * @param themes - Record mapping theme keys to values (for validation)\n * @param options.cookieName - Cookie name to read from\n * @param options.path - Cookie path (default: '/')\n * @param options.parse - Custom parser (default: parseStoredTheme)\n * @returns ThemeEntry if found, undefined otherwise. Returns undefined when document.cookie is unavailable (e.g. SSR).\n */\nexport function readCookieTheme<Themes extends ThemeMap>(\n\tthemes: Themes,\n\toptions: ReadCookieThemeOptions<Themes>\n): ThemeEntry<Themes> | undefined {\n\tconst { cookieName, parse = parseStoredTheme } = options\n\n\tif (typeof document === 'undefined' || document.cookie === undefined) {\n\t\treturn undefined\n\t}\n\n\tconst stored = getCookieValue(cookieName)\n\treturn parse(themes, stored ?? undefined)\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgB,gBACf,QACA,SACiC;CACjC,MAAM,EAAE,YAAY,QAAQ,qBAAqB;AAEjD,KAAI,OAAO,aAAa,eAAe,SAAS,WAAW,OAC1D;AAID,QAAO,MAAM,QADE,eAAe,WAAW,IACV,OAAU"}

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

@@ -0,0 +1,29 @@
+const require__cookie_utils = require('./_cookie-utils.cjs');
+
+//#region src/theme/cookie/write-cookie-theme.ts
+/**
+* Writes a theme entry to a cookie.
+*
+* 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 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) {
+		require__cookie_utils.deleteCookie(cookieName, path);
+		return;
+	}
+	const opts = { path };
+	if (maxAge !== void 0) opts.maxAge = maxAge;
+	if (sameSite !== void 0) opts.sameSite = sameSite;
+	if (secure) opts.secure = true;
+	require__cookie_utils.setCookie(cookieName, JSON.stringify(entry), opts);
+}
+
+//#endregion
+exports.writeCookieTheme = writeCookieTheme;
+//# sourceMappingURL=write-cookie-theme.cjs.map

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

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

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

@@ -0,0 +1,24 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/cookie/write-cookie-theme.d.ts
+interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {
+  cookieName: string;
+  path?: string | undefined;
+  maxAge?: number | undefined;
+  sameSite?: 'lax' | 'strict' | 'none' | undefined;
+  secure?: boolean | undefined;
+}
+/**
+ * Writes a theme entry to a cookie.
+ *
+ * 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 options - Cookie options
+ */
+declare function writeCookieTheme<Themes extends ThemeMap>(_themes: Themes, entry: ThemeEntry<Themes> | undefined, options: WriteCookieThemeOptions<Themes>): void;
+//#endregion
+export { WriteCookieThemeOptions, writeCookieTheme };
+//# sourceMappingURL=write-cookie-theme.d.cts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,24 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/cookie/write-cookie-theme.d.ts
+interface WriteCookieThemeOptions<_Themes extends ThemeMap = ThemeMap> {
+  cookieName: string;
+  path?: string | undefined;
+  maxAge?: number | undefined;
+  sameSite?: 'lax' | 'strict' | 'none' | undefined;
+  secure?: boolean | undefined;
+}
+/**
+ * Writes a theme entry to a cookie.
+ *
+ * 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 options - Cookie options
+ */
+declare function writeCookieTheme<Themes extends ThemeMap>(_themes: Themes, entry: ThemeEntry<Themes> | 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

@@ -0,0 +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"}

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

@@ -0,0 +1,29 @@
+import { deleteCookie, setCookie } from "./_cookie-utils.mjs";
+
+//#region src/theme/cookie/write-cookie-theme.ts
+/**
+* Writes a theme entry to a cookie.
+*
+* 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 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) {
+		deleteCookie(cookieName, path);
+		return;
+	}
+	const opts = { path };
+	if (maxAge !== void 0) opts.maxAge = maxAge;
+	if (sameSite !== void 0) opts.sameSite = sameSite;
+	if (secure) opts.secure = true;
+	setCookie(cookieName, JSON.stringify(entry), opts);
+}
+
+//#endregion
+export { writeCookieTheme };
+//# sourceMappingURL=write-cookie-theme.mjs.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,7 @@
+
+//#region src/theme/data-attribute/_constant.ts
+const SEPARATOR_SPACE = " ";
+
+//#endregion
+exports.SEPARATOR_SPACE = SEPARATOR_SPACE;
+//# sourceMappingURL=_constant.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_constant.cjs","names":[],"sources":["../../../src/theme/data-attribute/_constant.ts"],"sourcesContent":["export const SEPARATOR_SPACE = ' '\n"],"mappings":";;AAAA,MAAa,kBAAkB"}

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

@@ -0,0 +1,6 @@
+//#region src/theme/data-attribute/_constant.ts
+const SEPARATOR_SPACE = " ";
+
+//#endregion
+export { SEPARATOR_SPACE };
+//# sourceMappingURL=_constant.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_constant.mjs","names":[],"sources":["../../../src/theme/data-attribute/_constant.ts"],"sourcesContent":["export const SEPARATOR_SPACE = ' '\n"],"mappings":";AAAA,MAAa,kBAAkB"}

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

@@ -0,0 +1,24 @@
+const require_theme_entry = require('../theme-entry.cjs');
+const require__constant = require('./_constant.cjs');
+const require_match_attribute_value_to_theme = require('../_utils/match-attribute-value-to-theme.cjs');
+
+//#region src/theme/data-attribute/parse-data-attribute.ts
+/**
+* Parses a data attribute value string into a ThemeEntry.
+*
+* 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 options.separator - When defined, split by separator and use first token (default: space)
+* @returns ThemeEntry if a match is found, otherwise undefined
+*/
+function parseDataAttribute(themes, value, options) {
+	const separator = options?.separator ?? require__constant.SEPARATOR_SPACE;
+	const theme = require_match_attribute_value_to_theme.matchAttributeValueToTheme(themes, value ?? null, { separator });
+	return theme !== void 0 ? require_theme_entry.themeEntry(themes, theme) : void 0;
+}
+
+//#endregion
+exports.parseDataAttribute = parseDataAttribute;
+//# sourceMappingURL=parse-data-attribute.cjs.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,21 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/data-attribute/parse-data-attribute.d.ts
+
+/**
+ * Parses a data attribute value string into a ThemeEntry.
+ *
+ * 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 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?: {
+  separator?: string | undefined;
+} | undefined): ThemeEntry<Themes> | undefined;
+//#endregion
+export { parseDataAttribute };
+//# sourceMappingURL=parse-data-attribute.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-data-attribute.d.cts","names":[],"sources":["../../../src/theme/data-attribute/parse-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgBA;;;;;;;;iBAAgB,kCAAkC,kBACzC;;gBAGN,WAAW"}

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

@@ -0,0 +1,21 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/data-attribute/parse-data-attribute.d.ts
+
+/**
+ * Parses a data attribute value string into a ThemeEntry.
+ *
+ * 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 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?: {
+  separator?: string | undefined;
+} | undefined): ThemeEntry<Themes> | undefined;
+//#endregion
+export { parseDataAttribute };
+//# sourceMappingURL=parse-data-attribute.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-data-attribute.d.mts","names":[],"sources":["../../../src/theme/data-attribute/parse-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgBA;;;;;;;;iBAAgB,kCAAkC,kBACzC;;gBAGN,WAAW"}

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

@@ -0,0 +1,24 @@
+import { themeEntry } from "../theme-entry.mjs";
+import { SEPARATOR_SPACE } from "./_constant.mjs";
+import { matchAttributeValueToTheme } from "../_utils/match-attribute-value-to-theme.mjs";
+
+//#region src/theme/data-attribute/parse-data-attribute.ts
+/**
+* Parses a data attribute value string into a ThemeEntry.
+*
+* 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 options.separator - When defined, split by separator and use first token (default: space)
+* @returns ThemeEntry if a match is found, otherwise undefined
+*/
+function parseDataAttribute(themes, value, options) {
+	const separator = options?.separator ?? SEPARATOR_SPACE;
+	const theme = matchAttributeValueToTheme(themes, value ?? null, { separator });
+	return theme !== void 0 ? themeEntry(themes, theme) : void 0;
+}
+
+//#endregion
+export { parseDataAttribute };
+//# sourceMappingURL=parse-data-attribute.mjs.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+const require_get_data_attribute = require('../../attributes/get-data-attribute.cjs');
+const require__constant = require('./_constant.cjs');
+const require_parse_data_attribute = require('./parse-data-attribute.cjs');
+
+//#region src/theme/data-attribute/read-data-attribute.ts
+/**
+* Reads a theme entry from a data attribute on an element.
+*
+* @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.parse - Custom parser (default: parseDataAttribute with space separator)
+* @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).
+*/
+function readDataAttribute(themes, attributeName, options) {
+	const element = options?.element ?? document?.documentElement;
+	if (!element) return void 0;
+	return (options?.parse ?? ((t, v) => require_parse_data_attribute.parseDataAttribute(t, v, { separator: require__constant.SEPARATOR_SPACE })))(themes, require_get_data_attribute.getDataAttribute(attributeName, element) ?? void 0);
+}
+
+//#endregion
+exports.readDataAttribute = readDataAttribute;
+//# sourceMappingURL=read-data-attribute.cjs.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,21 @@
+import { ThemeMap } from "../theme-map.types.cjs";
+import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.cjs";
+
+//#region src/theme/data-attribute/read-data-attribute.d.ts
+
+/**
+ * Reads a theme entry from a data attribute on an element.
+ *
+ * @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.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;
+  parse?: ParseStoredTheme<Themes> | undefined;
+} | undefined): ThemeEntry<Themes> | undefined;
+//#endregion
+export { readDataAttribute };
+//# sourceMappingURL=read-data-attribute.d.cts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,21 @@
+import { ThemeMap } from "../theme-map.types.mjs";
+import { ParseStoredTheme, ThemeEntry } from "../theme-entry.types.mjs";
+
+//#region src/theme/data-attribute/read-data-attribute.d.ts
+
+/**
+ * Reads a theme entry from a data attribute on an element.
+ *
+ * @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.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;
+  parse?: ParseStoredTheme<Themes> | undefined;
+} | undefined): ThemeEntry<Themes> | undefined;
+//#endregion
+export { readDataAttribute };
+//# sourceMappingURL=read-data-attribute.d.mts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+import { getDataAttribute } from "../../attributes/get-data-attribute.mjs";
+import { SEPARATOR_SPACE } from "./_constant.mjs";
+import { parseDataAttribute } from "./parse-data-attribute.mjs";
+
+//#region src/theme/data-attribute/read-data-attribute.ts
+/**
+* Reads a theme entry from a data attribute on an element.
+*
+* @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.parse - Custom parser (default: parseDataAttribute with space separator)
+* @returns ThemeEntry if found, undefined otherwise. Returns undefined when element is not available (e.g. SSR).
+*/
+function readDataAttribute(themes, attributeName, options) {
+	const element = options?.element ?? document?.documentElement;
+	if (!element) return void 0;
+	return (options?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE })))(themes, getDataAttribute(attributeName, element) ?? void 0);
+}
+
+//#endregion
+export { readDataAttribute };
+//# sourceMappingURL=read-data-attribute.mjs.map

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

@@ -0,0 +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"}