@burojs/ui-shadcn 0.3.0 → 0.5.0

package/dist/theme/theme-css.d.ts

@@ -1,3 +1,4 @@
+//#region src/theme/theme-css.d.ts
 /**
  * Pure functions for handling a pasted tweakcn theme.
  *
@@ -20,15 +21,15 @@
  * silently stops working, with no error anywhere.
  */
 type ThemeRecord = {
-    id: string;
-    name: string;
-    css: string;
+  id: string;
+  name: string;
+  css: string;
 };
 type ThemeValidationResult = {
-    ok: true;
+  ok: true;
 } | {
-    ok: false;
-    reason: string;
+  ok: false;
+  reason: string;
 };
 /**
  * Reduces a pasted tweakcn theme to just its `:root { ... }` and
@@ -45,5 +46,6 @@ declare function stripThemeCss(raw: string): string;
  * no `:root` block at all.
  */
 declare function validateThemeCss(css: string): ThemeValidationResult;
-
-export { type ThemeRecord, type ThemeValidationResult, stripThemeCss, validateThemeCss };
+//#endregion
+export { ThemeRecord, ThemeValidationResult, stripThemeCss, validateThemeCss };
+//# sourceMappingURL=theme-css.d.ts.map

package/dist/theme/theme-css.js

@@ -1,102 +1,102 @@
-// src/theme/theme-css.ts
+//#region src/theme/theme-css.ts
 function parseTopLevelBlocks(src) {
-  const n = src.length;
-  const blocks = [];
-  let i = 0;
-  const skipComment = (pos) => {
-    const end = src.indexOf("*/", pos + 2);
-    return end === -1 ? n : end + 2;
-  };
-  const skipString = (pos) => {
-    const quote = src[pos];
-    let j = pos + 1;
-    while (j < n && src[j] !== quote) {
-      if (src[j] === "\\") j++;
-      j++;
-    }
-    return j < n ? j + 1 : n;
-  };
-  while (i < n) {
-    while (i < n) {
-      const ch = src[i];
-      if (ch === " " || ch === "	" || ch === "\n" || ch === "\r") {
-        i++;
-        continue;
-      }
-      if (src.startsWith("/*", i)) {
-        i = skipComment(i);
-        continue;
-      }
-      break;
-    }
-    if (i >= n) break;
-    const statementStart = i;
-    let head = "";
-    while (i < n && src[i] !== "{" && src[i] !== ";") {
-      if (src.startsWith("/*", i)) {
-        i = skipComment(i);
-        continue;
-      }
-      if (src[i] === '"' || src[i] === "'") {
-        const strStart = i;
-        i = skipString(i);
-        head += src.slice(strStart, i);
-        continue;
-      }
-      head += src[i];
-      i++;
-    }
-    if (i >= n) break;
-    if (src[i] === ";") {
-      i++;
-      continue;
-    }
-    let depth = 1;
-    let j = i + 1;
-    while (j < n && depth > 0) {
-      if (src.startsWith("/*", j)) {
-        j = skipComment(j);
-        continue;
-      }
-      if (src[j] === '"' || src[j] === "'") {
-        j = skipString(j);
-        continue;
-      }
-      if (src[j] === "{") depth++;
-      else if (src[j] === "}") depth--;
-      j++;
-    }
-    blocks.push({ selector: head.trim(), raw: src.slice(statementStart, j) });
-    i = j;
-  }
-  return blocks;
+	const n = src.length;
+	const blocks = [];
+	let i = 0;
+	const skipComment = (pos) => {
+		const end = src.indexOf("*/", pos + 2);
+		return end === -1 ? n : end + 2;
+	};
+	const skipString = (pos) => {
+		const quote = src[pos];
+		let j = pos + 1;
+		while (j < n && src[j] !== quote) {
+			if (src[j] === "\\") j++;
+			j++;
+		}
+		return j < n ? j + 1 : n;
+	};
+	while (i < n) {
+		while (i < n) {
+			const ch = src[i];
+			if (ch === " " || ch === "	" || ch === "\n" || ch === "\r") {
+				i++;
+				continue;
+			}
+			if (src.startsWith("/*", i)) {
+				i = skipComment(i);
+				continue;
+			}
+			break;
+		}
+		if (i >= n) break;
+		const statementStart = i;
+		let head = "";
+		while (i < n && src[i] !== "{" && src[i] !== ";") {
+			if (src.startsWith("/*", i)) {
+				i = skipComment(i);
+				continue;
+			}
+			if (src[i] === "\"" || src[i] === "'") {
+				const strStart = i;
+				i = skipString(i);
+				head += src.slice(strStart, i);
+				continue;
+			}
+			head += src[i];
+			i++;
+		}
+		if (i >= n) break;
+		if (src[i] === ";") {
+			i++;
+			continue;
+		}
+		let depth = 1;
+		let j = i + 1;
+		while (j < n && depth > 0) {
+			if (src.startsWith("/*", j)) {
+				j = skipComment(j);
+				continue;
+			}
+			if (src[j] === "\"" || src[j] === "'") {
+				j = skipString(j);
+				continue;
+			}
+			if (src[j] === "{") depth++;
+			else if (src[j] === "}") depth--;
+			j++;
+		}
+		blocks.push({
+			selector: head.trim(),
+			raw: src.slice(statementStart, j)
+		});
+		i = j;
+	}
+	return blocks;
 }
 function stripThemeCss(raw) {
-  const normalized = raw.replace(/\r\n/g, "\n");
-  const blocks = parseTopLevelBlocks(normalized);
-  const kept = blocks.filter((b) => b.selector === ":root" || b.selector === ".dark");
-  return kept.map((b) => b.raw).join("\n\n");
+	return parseTopLevelBlocks(raw.replace(/\r\n/g, "\n")).filter((b) => b.selector === ":root" || b.selector === ".dark").map((b) => b.raw).join("\n\n");
 }
 function validateThemeCss(css) {
-  const normalized = css.replace(/\r\n/g, "\n");
-  if (normalized.trim().length === 0) {
-    return { ok: false, reason: "Theme CSS is empty." };
-  }
-  const blocks = parseTopLevelBlocks(normalized);
-  const hasDark = blocks.some((b) => b.selector === ".dark");
-  const hasRoot = blocks.some((b) => b.selector === ":root");
-  if (!hasDark) {
-    return {
-      ok: false,
-      reason: `Theme has no ".dark" block. Without it, the theme's ":root" values override the app's ".dark" styles at equal CSS specificity, and dark mode silently stops working.`
-    };
-  }
-  if (!hasRoot) {
-    return { ok: false, reason: 'Theme has no ":root" block \u2014 light-mode values are missing.' };
-  }
-  return { ok: true };
+	const normalized = css.replace(/\r\n/g, "\n");
+	if (normalized.trim().length === 0) return {
+		ok: false,
+		reason: "Theme CSS is empty."
+	};
+	const blocks = parseTopLevelBlocks(normalized);
+	const hasDark = blocks.some((b) => b.selector === ".dark");
+	const hasRoot = blocks.some((b) => b.selector === ":root");
+	if (!hasDark) return {
+		ok: false,
+		reason: "Theme has no \".dark\" block. Without it, the theme's \":root\" values override the app's \".dark\" styles at equal CSS specificity, and dark mode silently stops working."
+	};
+	if (!hasRoot) return {
+		ok: false,
+		reason: "Theme has no \":root\" block — light-mode values are missing."
+	};
+	return { ok: true };
 }
-
+//#endregion
 export { stripThemeCss, validateThemeCss };
-//# sourceMappingURL=theme-css.js.map
+
 //# sourceMappingURL=theme-css.js.map

package/dist/theme/theme-css.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/theme-css.ts"],"names":[],"mappings":"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","file":"theme-css.js","sourcesContent":["/**\n * Pure functions for handling a pasted tweakcn theme.\n *\n * tweakcn's \"Copy code\" button emits six constructs. Only two of them mean\n * anything once dropped into a browser at runtime (not build time, since\n * there is no Tailwind build step for pasted CSS):\n *\n *   @import \"tailwindcss\";           -> 404s if kept (no such route at runtime)\n *   @custom-variant dark (...);      -> meaningless outside a Tailwind build\n *   :root  { ... }                   -> survives, sets light-mode custom properties\n *   .dark  { ... }                   -> survives, sets dark-mode custom properties\n *   @theme inline { ... }            -> meaningless outside a Tailwind build\n *   @layer base { ...; @apply ...; } -> @apply is not real CSS, dead weight\n *\n * `stripThemeCss` throws away everything except the `:root` and `.dark`\n * blocks. `validateThemeCss` catches the one failure mode that is otherwise\n * invisible: a theme with no `.dark` block. `.dark` and `:root` share equal\n * specificity, so injecting a `:root`-only theme *after* the app's own\n * stylesheet makes its `:root` win over `html.dark`'s rules too — dark mode\n * silently stops working, with no error anywhere.\n */\n\nexport type ThemeRecord = { id: string; name: string; css: string };\n\nexport type ThemeValidationResult = { ok: true } | { ok: false; reason: string };\n\ninterface TopLevelBlock {\n  /** The selector/at-rule head, trimmed (e.g. \":root\", \".dark\", \"@theme inline\"). */\n  selector: string;\n  /** The full source slice for this block, selector through closing brace. */\n  raw: string;\n}\n\n/**\n * Walks the source once, splitting it into top-level statements. Any\n * statement terminated by `;` (e.g. `@import \"tailwindcss\";`,\n * `@custom-variant dark (&:is(.dark *));`) is dropped outright — it never\n * produces a block. Any statement with a `{ ... }` body is returned as a\n * block, with brace depth tracked through the body so a nested block (e.g.\n * `@layer base { * { ... } body { ... } }`) is consumed as a single unit\n * instead of stopping at its first inner `}`.\n *\n * Comments and quoted strings are skipped transparently everywhere braces\n * are counted, so a brace inside `/* ... *\\/` or inside a string value never\n * perturbs the depth count.\n *\n * Unclosed input (an opened `{`, `/*`, or quote that never finds its\n * closer) is NOT dropped: the depth/comment/string scan simply runs off\n * the end of the string, and the block gets pushed with its `raw` spanning\n * from the opening selector all the way to EOF — swallowing whatever\n * well-formed blocks would otherwise have followed it. Concretely: an\n * unclosed `:root {` earlier in the source will absorb a perfectly valid\n * `.dark { ... }` that comes after it, so `.dark` never becomes its own\n * top-level block. This is a deliberately-left gap, not a bug: the\n * consequence is caught downstream by `validateThemeCss`'s \"no .dark\"\n * check, so truncated/corrupt input fails closed rather than corrupting\n * silently. The one sharp edge is the *reason string* it fails with — a\n * clipboard read that came back truncated will be reported as \"no .dark\n * block\", not \"your paste was cut off\", which is worth remembering when\n * debugging a fetch step that feeds this function.\n */\nfunction parseTopLevelBlocks(src: string): TopLevelBlock[] {\n  const n = src.length;\n  const blocks: TopLevelBlock[] = [];\n  let i = 0;\n\n  const skipComment = (pos: number): number => {\n    const end = src.indexOf('*/', pos + 2);\n    return end === -1 ? n : end + 2;\n  };\n\n  const skipString = (pos: number): number => {\n    const quote = src[pos];\n    let j = pos + 1;\n    while (j < n && src[j] !== quote) {\n      if (src[j] === '\\\\') j++;\n      j++;\n    }\n    return j < n ? j + 1 : n;\n  };\n\n  while (i < n) {\n    // Skip whitespace and comments between statements.\n    while (i < n) {\n      const ch = src[i];\n      if (ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r') {\n        i++;\n        continue;\n      }\n      if (src.startsWith('/*', i)) {\n        i = skipComment(i);\n        continue;\n      }\n      break;\n    }\n    if (i >= n) break;\n\n    const statementStart = i;\n    let head = '';\n\n    // Scan the head (selector / at-rule prelude) up to a top-level `{` or `;`.\n    while (i < n && src[i] !== '{' && src[i] !== ';') {\n      if (src.startsWith('/*', i)) {\n        i = skipComment(i);\n        continue;\n      }\n      if (src[i] === '\"' || src[i] === \"'\") {\n        const strStart = i;\n        i = skipString(i);\n        head += src.slice(strStart, i);\n        continue;\n      }\n      head += src[i];\n      i++;\n    }\n\n    // Ran off the end while scanning the head itself (no `{` or `;` ever\n    // showed up) — this fragment genuinely IS dropped, since there is no\n    // `{` to even start a block from. Contrast with an opened-but-unclosed\n    // `{ ... }` body below, which is NOT dropped — see the block comment\n    // on this function.\n    if (i >= n) break;\n\n    if (src[i] === ';') {\n      i++; // e.g. `@import \"tailwindcss\";` — drop, no block produced.\n      continue;\n    }\n\n    // src[i] === '{' — consume the whole block, tracking nested brace depth.\n    let depth = 1;\n    let j = i + 1;\n    while (j < n && depth > 0) {\n      if (src.startsWith('/*', j)) {\n        j = skipComment(j);\n        continue;\n      }\n      if (src[j] === '\"' || src[j] === \"'\") {\n        j = skipString(j);\n        continue;\n      }\n      if (src[j] === '{') depth++;\n      else if (src[j] === '}') depth--;\n      j++;\n    }\n\n    // Pushed unconditionally — if `depth` never reached 0 the loop above\n    // only stopped because `j` hit `n` (EOF). That's intentional: see the\n    // \"Unclosed input\" paragraph on this function's doc comment.\n    blocks.push({ selector: head.trim(), raw: src.slice(statementStart, j) });\n    i = j;\n  }\n\n  return blocks;\n}\n\n/**\n * Reduces a pasted tweakcn theme to just its `:root { ... }` and\n * `.dark { ... }` blocks, in source order. Everything else (imports,\n * `@custom-variant`, `@theme inline`, `@layer base`) is dropped. Idempotent:\n * running it again on its own output is a no-op.\n */\nexport function stripThemeCss(raw: string): string {\n  const normalized = raw.replace(/\\r\\n/g, '\\n');\n  const blocks = parseTopLevelBlocks(normalized);\n  const kept = blocks.filter((b) => b.selector === ':root' || b.selector === '.dark');\n  return kept.map((b) => b.raw).join('\\n\\n');\n}\n\n/**\n * Validates that a (normally already-stripped) theme is safe to inject.\n * The load-bearing check is `.dark`: without it, a theme's `:root` values\n * override the app's `.dark` rules at equal specificity, and dark mode\n * breaks silently. Also rejects empty input and (defensively) a theme with\n * no `:root` block at all.\n */\nexport function validateThemeCss(css: string): ThemeValidationResult {\n  const normalized = css.replace(/\\r\\n/g, '\\n');\n  if (normalized.trim().length === 0) {\n    return { ok: false, reason: 'Theme CSS is empty.' };\n  }\n\n  const blocks = parseTopLevelBlocks(normalized);\n  const hasDark = blocks.some((b) => b.selector === '.dark');\n  const hasRoot = blocks.some((b) => b.selector === ':root');\n\n  if (!hasDark) {\n    return {\n      ok: false,\n      reason:\n        'Theme has no \".dark\" block. Without it, the theme\\'s \":root\" values ' +\n        'override the app\\'s \".dark\" styles at equal CSS specificity, and dark ' +\n        'mode silently stops working.',\n    };\n  }\n\n  if (!hasRoot) {\n    return { ok: false, reason: 'Theme has no \":root\" block — light-mode values are missing.' };\n  }\n\n  return { ok: true };\n}\n"]}
+{"version":3,"file":"theme-css.js","names":[],"sources":["../../src/theme/theme-css.ts"],"sourcesContent":["/**\n * Pure functions for handling a pasted tweakcn theme.\n *\n * tweakcn's \"Copy code\" button emits six constructs. Only two of them mean\n * anything once dropped into a browser at runtime (not build time, since\n * there is no Tailwind build step for pasted CSS):\n *\n *   @import \"tailwindcss\";           -> 404s if kept (no such route at runtime)\n *   @custom-variant dark (...);      -> meaningless outside a Tailwind build\n *   :root  { ... }                   -> survives, sets light-mode custom properties\n *   .dark  { ... }                   -> survives, sets dark-mode custom properties\n *   @theme inline { ... }            -> meaningless outside a Tailwind build\n *   @layer base { ...; @apply ...; } -> @apply is not real CSS, dead weight\n *\n * `stripThemeCss` throws away everything except the `:root` and `.dark`\n * blocks. `validateThemeCss` catches the one failure mode that is otherwise\n * invisible: a theme with no `.dark` block. `.dark` and `:root` share equal\n * specificity, so injecting a `:root`-only theme *after* the app's own\n * stylesheet makes its `:root` win over `html.dark`'s rules too — dark mode\n * silently stops working, with no error anywhere.\n */\n\nexport type ThemeRecord = { id: string; name: string; css: string };\n\nexport type ThemeValidationResult = { ok: true } | { ok: false; reason: string };\n\ninterface TopLevelBlock {\n  /** The selector/at-rule head, trimmed (e.g. \":root\", \".dark\", \"@theme inline\"). */\n  selector: string;\n  /** The full source slice for this block, selector through closing brace. */\n  raw: string;\n}\n\n/**\n * Walks the source once, splitting it into top-level statements. Any\n * statement terminated by `;` (e.g. `@import \"tailwindcss\";`,\n * `@custom-variant dark (&:is(.dark *));`) is dropped outright — it never\n * produces a block. Any statement with a `{ ... }` body is returned as a\n * block, with brace depth tracked through the body so a nested block (e.g.\n * `@layer base { * { ... } body { ... } }`) is consumed as a single unit\n * instead of stopping at its first inner `}`.\n *\n * Comments and quoted strings are skipped transparently everywhere braces\n * are counted, so a brace inside `/* ... *\\/` or inside a string value never\n * perturbs the depth count.\n *\n * Unclosed input (an opened `{`, `/*`, or quote that never finds its\n * closer) is NOT dropped: the depth/comment/string scan simply runs off\n * the end of the string, and the block gets pushed with its `raw` spanning\n * from the opening selector all the way to EOF — swallowing whatever\n * well-formed blocks would otherwise have followed it. Concretely: an\n * unclosed `:root {` earlier in the source will absorb a perfectly valid\n * `.dark { ... }` that comes after it, so `.dark` never becomes its own\n * top-level block. This is a deliberately-left gap, not a bug: the\n * consequence is caught downstream by `validateThemeCss`'s \"no .dark\"\n * check, so truncated/corrupt input fails closed rather than corrupting\n * silently. The one sharp edge is the *reason string* it fails with — a\n * clipboard read that came back truncated will be reported as \"no .dark\n * block\", not \"your paste was cut off\", which is worth remembering when\n * debugging a fetch step that feeds this function.\n */\nfunction parseTopLevelBlocks(src: string): TopLevelBlock[] {\n  const n = src.length;\n  const blocks: TopLevelBlock[] = [];\n  let i = 0;\n\n  const skipComment = (pos: number): number => {\n    const end = src.indexOf('*/', pos + 2);\n    return end === -1 ? n : end + 2;\n  };\n\n  const skipString = (pos: number): number => {\n    const quote = src[pos];\n    let j = pos + 1;\n    while (j < n && src[j] !== quote) {\n      if (src[j] === '\\\\') j++;\n      j++;\n    }\n    return j < n ? j + 1 : n;\n  };\n\n  while (i < n) {\n    // Skip whitespace and comments between statements.\n    while (i < n) {\n      const ch = src[i];\n      if (ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r') {\n        i++;\n        continue;\n      }\n      if (src.startsWith('/*', i)) {\n        i = skipComment(i);\n        continue;\n      }\n      break;\n    }\n    if (i >= n) break;\n\n    const statementStart = i;\n    let head = '';\n\n    // Scan the head (selector / at-rule prelude) up to a top-level `{` or `;`.\n    while (i < n && src[i] !== '{' && src[i] !== ';') {\n      if (src.startsWith('/*', i)) {\n        i = skipComment(i);\n        continue;\n      }\n      if (src[i] === '\"' || src[i] === \"'\") {\n        const strStart = i;\n        i = skipString(i);\n        head += src.slice(strStart, i);\n        continue;\n      }\n      head += src[i];\n      i++;\n    }\n\n    // Ran off the end while scanning the head itself (no `{` or `;` ever\n    // showed up) — this fragment genuinely IS dropped, since there is no\n    // `{` to even start a block from. Contrast with an opened-but-unclosed\n    // `{ ... }` body below, which is NOT dropped — see the block comment\n    // on this function.\n    if (i >= n) break;\n\n    if (src[i] === ';') {\n      i++; // e.g. `@import \"tailwindcss\";` — drop, no block produced.\n      continue;\n    }\n\n    // src[i] === '{' — consume the whole block, tracking nested brace depth.\n    let depth = 1;\n    let j = i + 1;\n    while (j < n && depth > 0) {\n      if (src.startsWith('/*', j)) {\n        j = skipComment(j);\n        continue;\n      }\n      if (src[j] === '\"' || src[j] === \"'\") {\n        j = skipString(j);\n        continue;\n      }\n      if (src[j] === '{') depth++;\n      else if (src[j] === '}') depth--;\n      j++;\n    }\n\n    // Pushed unconditionally — if `depth` never reached 0 the loop above\n    // only stopped because `j` hit `n` (EOF). That's intentional: see the\n    // \"Unclosed input\" paragraph on this function's doc comment.\n    blocks.push({ selector: head.trim(), raw: src.slice(statementStart, j) });\n    i = j;\n  }\n\n  return blocks;\n}\n\n/**\n * Reduces a pasted tweakcn theme to just its `:root { ... }` and\n * `.dark { ... }` blocks, in source order. Everything else (imports,\n * `@custom-variant`, `@theme inline`, `@layer base`) is dropped. Idempotent:\n * running it again on its own output is a no-op.\n */\nexport function stripThemeCss(raw: string): string {\n  const normalized = raw.replace(/\\r\\n/g, '\\n');\n  const blocks = parseTopLevelBlocks(normalized);\n  const kept = blocks.filter((b) => b.selector === ':root' || b.selector === '.dark');\n  return kept.map((b) => b.raw).join('\\n\\n');\n}\n\n/**\n * Validates that a (normally already-stripped) theme is safe to inject.\n * The load-bearing check is `.dark`: without it, a theme's `:root` values\n * override the app's `.dark` rules at equal specificity, and dark mode\n * breaks silently. Also rejects empty input and (defensively) a theme with\n * no `:root` block at all.\n */\nexport function validateThemeCss(css: string): ThemeValidationResult {\n  const normalized = css.replace(/\\r\\n/g, '\\n');\n  if (normalized.trim().length === 0) {\n    return { ok: false, reason: 'Theme CSS is empty.' };\n  }\n\n  const blocks = parseTopLevelBlocks(normalized);\n  const hasDark = blocks.some((b) => b.selector === '.dark');\n  const hasRoot = blocks.some((b) => b.selector === ':root');\n\n  if (!hasDark) {\n    return {\n      ok: false,\n      reason:\n        'Theme has no \".dark\" block. Without it, the theme\\'s \":root\" values ' +\n        'override the app\\'s \".dark\" styles at equal CSS specificity, and dark ' +\n        'mode silently stops working.',\n    };\n  }\n\n  if (!hasRoot) {\n    return { ok: false, reason: 'Theme has no \":root\" block — light-mode values are missing.' };\n  }\n\n  return { ok: true };\n}\n"],"mappings":";AA6DA,SAAS,oBAAoB,KAA8B;CACzD,MAAM,IAAI,IAAI;CACd,MAAM,SAA0B,CAAC;CACjC,IAAI,IAAI;CAER,MAAM,eAAe,QAAwB;EAC3C,MAAM,MAAM,IAAI,QAAQ,MAAM,MAAM,CAAC;EACrC,OAAO,QAAQ,KAAK,IAAI,MAAM;CAChC;CAEA,MAAM,cAAc,QAAwB;EAC1C,MAAM,QAAQ,IAAI;EAClB,IAAI,IAAI,MAAM;EACd,OAAO,IAAI,KAAK,IAAI,OAAO,OAAO;GAChC,IAAI,IAAI,OAAO,MAAM;GACrB;EACF;EACA,OAAO,IAAI,IAAI,IAAI,IAAI;CACzB;CAEA,OAAO,IAAI,GAAG;EAEZ,OAAO,IAAI,GAAG;GACZ,MAAM,KAAK,IAAI;GACf,IAAI,OAAO,OAAO,OAAO,OAAQ,OAAO,QAAQ,OAAO,MAAM;IAC3D;IACA;GACF;GACA,IAAI,IAAI,WAAW,MAAM,CAAC,GAAG;IAC3B,IAAI,YAAY,CAAC;IACjB;GACF;GACA;EACF;EACA,IAAI,KAAK,GAAG;EAEZ,MAAM,iBAAiB;EACvB,IAAI,OAAO;EAGX,OAAO,IAAI,KAAK,IAAI,OAAO,OAAO,IAAI,OAAO,KAAK;GAChD,IAAI,IAAI,WAAW,MAAM,CAAC,GAAG;IAC3B,IAAI,YAAY,CAAC;IACjB;GACF;GACA,IAAI,IAAI,OAAO,QAAO,IAAI,OAAO,KAAK;IACpC,MAAM,WAAW;IACjB,IAAI,WAAW,CAAC;IAChB,QAAQ,IAAI,MAAM,UAAU,CAAC;IAC7B;GACF;GACA,QAAQ,IAAI;GACZ;EACF;EAOA,IAAI,KAAK,GAAG;EAEZ,IAAI,IAAI,OAAO,KAAK;GAClB;GACA;EACF;EAGA,IAAI,QAAQ;EACZ,IAAI,IAAI,IAAI;EACZ,OAAO,IAAI,KAAK,QAAQ,GAAG;GACzB,IAAI,IAAI,WAAW,MAAM,CAAC,GAAG;IAC3B,IAAI,YAAY,CAAC;IACjB;GACF;GACA,IAAI,IAAI,OAAO,QAAO,IAAI,OAAO,KAAK;IACpC,IAAI,WAAW,CAAC;IAChB;GACF;GACA,IAAI,IAAI,OAAO,KAAK;QACf,IAAI,IAAI,OAAO,KAAK;GACzB;EACF;EAKA,OAAO,KAAK;GAAE,UAAU,KAAK,KAAK;GAAG,KAAK,IAAI,MAAM,gBAAgB,CAAC;EAAE,CAAC;EACxE,IAAI;CACN;CAEA,OAAO;AACT;AAQA,SAAgB,cAAc,KAAqB;CAIjD,OAFe,oBADI,IAAI,QAAQ,SAAS,IACI,CAC1B,CAAC,CAAC,QAAQ,MAAM,EAAE,aAAa,WAAW,EAAE,aAAa,OACjE,CAAC,CAAC,KAAK,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,MAAM;AAC3C;AASA,SAAgB,iBAAiB,KAAoC;CACnE,MAAM,aAAa,IAAI,QAAQ,SAAS,IAAI;CAC5C,IAAI,WAAW,KAAK,CAAC,CAAC,WAAW,GAC/B,OAAO;EAAE,IAAI;EAAO,QAAQ;CAAsB;CAGpD,MAAM,SAAS,oBAAoB,UAAU;CAC7C,MAAM,UAAU,OAAO,MAAM,MAAM,EAAE,aAAa,OAAO;CACzD,MAAM,UAAU,OAAO,MAAM,MAAM,EAAE,aAAa,OAAO;CAEzD,IAAI,CAAC,SACH,OAAO;EACL,IAAI;EACJ,QACE;CAGJ;CAGF,IAAI,CAAC,SACH,OAAO;EAAE,IAAI;EAAO,QAAQ;CAA8D;CAG5F,OAAO,EAAE,IAAI,KAAK;AACpB"}

package/dist/theme/theme-storage.cjs

@@ -1,51 +1,46 @@
-'use strict';
-
-// src/theme/theme-storage.ts
-var THEME_CSS_STORAGE_KEY = "buro-theme-css";
-var THEME_CSS_STYLE_ELEMENT_ID = "buro-theme-css";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/theme/theme-storage.ts
+const THEME_CSS_STORAGE_KEY = "buro-theme-css";
+const THEME_CSS_STYLE_ELEMENT_ID = "buro-theme-css";
 function readThemeCss() {
-  if (typeof window === "undefined") return null;
-  try {
-    const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);
-    return css && css.length > 0 ? css : null;
-  } catch {
-    return null;
-  }
+	if (typeof window === "undefined") return null;
+	try {
+		const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);
+		return css && css.length > 0 ? css : null;
+	} catch {
+		return null;
+	}
 }
 function writeThemeCss(css) {
-  if (typeof window === "undefined") return;
-  try {
-    if (css === null || css.length === 0) {
-      window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);
-    } else {
-      window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);
-    }
-  } catch {
-  }
+	if (typeof window === "undefined") return;
+	try {
+		if (css === null || css.length === 0) window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);
+		else window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);
+	} catch {}
 }
 function applyThemeCss(css) {
-  if (typeof document === "undefined") return;
-  const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);
-  if (css === null || css.length === 0) {
-    existing?.remove();
-    return;
-  }
-  if (existing instanceof HTMLStyleElement) {
-    existing.textContent = css;
-    document.head.appendChild(existing);
-    return;
-  }
-  existing?.remove();
-  const style = document.createElement("style");
-  style.id = THEME_CSS_STYLE_ELEMENT_ID;
-  style.textContent = css;
-  document.head.appendChild(style);
+	if (typeof document === "undefined") return;
+	const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);
+	if (css === null || css.length === 0) {
+		existing?.remove();
+		return;
+	}
+	if (existing instanceof HTMLStyleElement) {
+		existing.textContent = css;
+		document.head.appendChild(existing);
+		return;
+	}
+	existing?.remove();
+	const style = document.createElement("style");
+	style.id = THEME_CSS_STYLE_ELEMENT_ID;
+	style.textContent = css;
+	document.head.appendChild(style);
 }
-
+//#endregion
 exports.THEME_CSS_STORAGE_KEY = THEME_CSS_STORAGE_KEY;
 exports.THEME_CSS_STYLE_ELEMENT_ID = THEME_CSS_STYLE_ELEMENT_ID;
 exports.applyThemeCss = applyThemeCss;
 exports.readThemeCss = readThemeCss;
 exports.writeThemeCss = writeThemeCss;
-//# sourceMappingURL=theme-storage.cjs.map
+
 //# sourceMappingURL=theme-storage.cjs.map

package/dist/theme/theme-storage.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/theme-storage.ts"],"names":[],"mappings":";;;AAuCO,IAAM,qBAAA,GAAwB;AAK9B,IAAM,0BAAA,GAA6B;AAQnC,SAAS,YAAA,GAA8B;AAC5C,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,IAAA;AAC1C,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,qBAAqB,CAAA;AAC7D,IAAA,OAAO,GAAA,IAAO,GAAA,CAAI,MAAA,GAAS,CAAA,GAAI,GAAA,GAAM,IAAA;AAAA,EACvC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAWO,SAAS,cAAc,GAAA,EAA0B;AACtD,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACnC,EAAA,IAAI;AACF,IAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,GAAA,CAAI,MAAA,KAAW,CAAA,EAAG;AACpC,MAAA,MAAA,CAAO,YAAA,CAAa,WAAW,qBAAqB,CAAA;AAAA,IACtD,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,qBAAA,EAAuB,GAAG,CAAA;AAAA,IACxD;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAGR;AACF;AAcO,SAAS,cAAc,GAAA,EAA0B;AACtD,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACrC,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,cAAA,CAAe,0BAA0B,CAAA;AAEnE,EAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,GAAA,CAAI,MAAA,KAAW,CAAA,EAAG;AACpC,IAAA,QAAA,EAAU,MAAA,EAAO;AACjB,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,oBAAoB,gBAAA,EAAkB;AACxC,IAAA,QAAA,CAAS,WAAA,GAAc,GAAA;AACvB,IAAA,QAAA,CAAS,IAAA,CAAK,YAAY,QAAQ,CAAA;AAClC,IAAA;AAAA,EACF;AACA,EAAA,QAAA,EAAU,MAAA,EAAO;AAEjB,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,aAAA,CAAc,OAAO,CAAA;AAC5C,EAAA,KAAA,CAAM,EAAA,GAAK,0BAAA;AACX,EAAA,KAAA,CAAM,WAAA,GAAc,GAAA;AACpB,EAAA,QAAA,CAAS,IAAA,CAAK,YAAY,KAAK,CAAA;AACjC","file":"theme-storage.cjs","sourcesContent":["/**\n * Persists and applies the active PALETTE theme's CSS — separate concern\n * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),\n * which holds light/dark/system. That key answers \"which class goes on\n * `<html>`\"; this one answers \"what custom-property values does `:root`/\n * `.dark` carry\". A theme picker calling `writeThemeCss` must never touch\n * `THEME_STORAGE_KEY`, and the light/dark toggle must never touch this one —\n * each write path only ever calls its own key's functions, so there is no\n * shared code path where a bug could cross-contaminate them.\n *\n * The stored value is the theme's CSS **in full** (already reduced to just\n * `:root`/`.dark` by `stripThemeCss`), not a theme id. That is what makes a\n * pasted (tweakcn) theme and a built-in theme indistinguishable to this\n * module and to the bootstrap script: neither has to know the built-in\n * theme catalogue, ship it in the bundle, or fetch it over the network\n * before paint. The cost is that this module does NOT validate — a caller\n * that wants the \".dark block present\" guarantee must run `validateThemeCss`\n * itself before calling `writeThemeCss` (the theme picker does this; see its\n * task). `applyThemeCss` and the bootstrap script just inject whatever\n * string is there. That is deliberate, not an oversight: CSS parsing is\n * forgiving by construction — unknown/malformed declarations are dropped\n * rule-by-rule by the browser's own parser, not fatal — so blindly injecting\n * a corrupt or half-written string degrades to \"some rules don't apply\", not\n * a crash or a blank page. Re-validating on every read would also block\n * first paint on running `parseTopLevelBlocks` over an arbitrarily large\n * string, which is exactly the cost the bootstrap script exists to avoid.\n *\n * Deliberately its own module, no React import, same reasoning as\n * `theme-storage-key.ts`: the ONE consumer that needs `THEME_CSS_STORAGE_KEY`\n * and `applyThemeCss` outside a hook is the bootstrap `<script>` in the\n * playground's root `app/layout.tsx`, a Server Component that cannot import\n * anything carrying `'use client'`. This file has no hooks, so it can be\n * imported there directly via the `@burojs/ui-shadcn/theme-storage` subpath.\n */\n\n/**\n * The localStorage key for the active theme's CSS text. Kept apart from\n * `THEME_STORAGE_KEY` on purpose — see the module doc comment above.\n */\nexport const THEME_CSS_STORAGE_KEY = 'buro-theme-css';\n\n/** The id of the `<style>` element the bootstrap script and `applyThemeCss`\n * both create/update. Exported so a test can assert on it without\n * retyping the literal. */\nexport const THEME_CSS_STYLE_ELEMENT_ID = 'buro-theme-css';\n\n/**\n * Reads the persisted theme CSS, or `null` if nothing is stored, storage is\n * unavailable (SSR, or a browser with it disabled — e.g. some private-mode\n * configurations throw on access rather than just being empty), or the\n * stored value is an empty string (treated the same as absent).\n */\nexport function readThemeCss(): string | null {\n  if (typeof window === 'undefined') return null;\n  try {\n    const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);\n    return css && css.length > 0 ? css : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Persists (or, given `null`, clears) the theme CSS. Does not validate —\n * callers that need the \".dark present\" guarantee run `validateThemeCss`\n * first (see module doc comment). Swallows storage errors (quota exceeded\n * from an oversized paste, storage disabled, etc.): the in-memory\n * application via `applyThemeCss` already happened by the time a caller\n * persists, so a failed write loses the choice on next reload but does not\n * throw or break the current page.\n */\nexport function writeThemeCss(css: string | null): void {\n  if (typeof window === 'undefined') return;\n  try {\n    if (css === null || css.length === 0) {\n      window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);\n    } else {\n      window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);\n    }\n  } catch {\n    // Quota exceeded, storage disabled, or a similar DOMException — nothing\n    // persisted. The caller's in-memory `applyThemeCss` call still stands.\n  }\n}\n\n/**\n * Creates, updates, or removes the `<style id=\"buro-theme-css\">`\n * element that carries the active theme's `:root`/`.dark` custom\n * properties. Given `null` (or an empty string), removes the element\n * entirely rather than leaving an empty tag behind.\n *\n * Order matters: this function always places the element at the END of\n * `<head>`, including when updating a style created by a prepaint bootstrap.\n * That lets an app call it after its own stylesheet has loaded so the theme's\n * equal-specificity `:root`/`.dark` rules win the cascade without creating a\n * duplicate element.\n */\nexport function applyThemeCss(css: string | null): void {\n  if (typeof document === 'undefined') return;\n  const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);\n\n  if (css === null || css.length === 0) {\n    existing?.remove();\n    return;\n  }\n\n  if (existing instanceof HTMLStyleElement) {\n    existing.textContent = css;\n    document.head.appendChild(existing);\n    return;\n  }\n  existing?.remove(); // defensive: same id but somehow not a <style>\n\n  const style = document.createElement('style');\n  style.id = THEME_CSS_STYLE_ELEMENT_ID;\n  style.textContent = css;\n  document.head.appendChild(style);\n}\n"]}
+{"version":3,"file":"theme-storage.cjs","names":[],"sources":["../../src/theme/theme-storage.ts"],"sourcesContent":["/**\n * Persists and applies the active PALETTE theme's CSS — separate concern\n * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),\n * which holds light/dark/system. That key answers \"which class goes on\n * `<html>`\"; this one answers \"what custom-property values does `:root`/\n * `.dark` carry\". A theme picker calling `writeThemeCss` must never touch\n * `THEME_STORAGE_KEY`, and the light/dark toggle must never touch this one —\n * each write path only ever calls its own key's functions, so there is no\n * shared code path where a bug could cross-contaminate them.\n *\n * The stored value is the theme's CSS **in full** (already reduced to just\n * `:root`/`.dark` by `stripThemeCss`), not a theme id. That is what makes a\n * pasted (tweakcn) theme and a built-in theme indistinguishable to this\n * module and to the bootstrap script: neither has to know the built-in\n * theme catalogue, ship it in the bundle, or fetch it over the network\n * before paint. The cost is that this module does NOT validate — a caller\n * that wants the \".dark block present\" guarantee must run `validateThemeCss`\n * itself before calling `writeThemeCss` (the theme picker does this; see its\n * task). `applyThemeCss` and the bootstrap script just inject whatever\n * string is there. That is deliberate, not an oversight: CSS parsing is\n * forgiving by construction — unknown/malformed declarations are dropped\n * rule-by-rule by the browser's own parser, not fatal — so blindly injecting\n * a corrupt or half-written string degrades to \"some rules don't apply\", not\n * a crash or a blank page. Re-validating on every read would also block\n * first paint on running `parseTopLevelBlocks` over an arbitrarily large\n * string, which is exactly the cost the bootstrap script exists to avoid.\n *\n * Deliberately its own module, no React import, same reasoning as\n * `theme-storage-key.ts`: the ONE consumer that needs `THEME_CSS_STORAGE_KEY`\n * and `applyThemeCss` outside a hook is the bootstrap `<script>` in the\n * playground's root `app/layout.tsx`, a Server Component that cannot import\n * anything carrying `'use client'`. This file has no hooks, so it can be\n * imported there directly via the `@burojs/ui-shadcn/theme-storage` subpath.\n */\n\n/**\n * The localStorage key for the active theme's CSS text. Kept apart from\n * `THEME_STORAGE_KEY` on purpose — see the module doc comment above.\n */\nexport const THEME_CSS_STORAGE_KEY = 'buro-theme-css';\n\n/** The id of the `<style>` element the bootstrap script and `applyThemeCss`\n * both create/update. Exported so a test can assert on it without\n * retyping the literal. */\nexport const THEME_CSS_STYLE_ELEMENT_ID = 'buro-theme-css';\n\n/**\n * Reads the persisted theme CSS, or `null` if nothing is stored, storage is\n * unavailable (SSR, or a browser with it disabled — e.g. some private-mode\n * configurations throw on access rather than just being empty), or the\n * stored value is an empty string (treated the same as absent).\n */\nexport function readThemeCss(): string | null {\n  if (typeof window === 'undefined') return null;\n  try {\n    const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);\n    return css && css.length > 0 ? css : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Persists (or, given `null`, clears) the theme CSS. Does not validate —\n * callers that need the \".dark present\" guarantee run `validateThemeCss`\n * first (see module doc comment). Swallows storage errors (quota exceeded\n * from an oversized paste, storage disabled, etc.): the in-memory\n * application via `applyThemeCss` already happened by the time a caller\n * persists, so a failed write loses the choice on next reload but does not\n * throw or break the current page.\n */\nexport function writeThemeCss(css: string | null): void {\n  if (typeof window === 'undefined') return;\n  try {\n    if (css === null || css.length === 0) {\n      window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);\n    } else {\n      window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);\n    }\n  } catch {\n    // Quota exceeded, storage disabled, or a similar DOMException — nothing\n    // persisted. The caller's in-memory `applyThemeCss` call still stands.\n  }\n}\n\n/**\n * Creates, updates, or removes the `<style id=\"buro-theme-css\">`\n * element that carries the active theme's `:root`/`.dark` custom\n * properties. Given `null` (or an empty string), removes the element\n * entirely rather than leaving an empty tag behind.\n *\n * Order matters: this function always places the element at the END of\n * `<head>`, including when updating a style created by a prepaint bootstrap.\n * That lets an app call it after its own stylesheet has loaded so the theme's\n * equal-specificity `:root`/`.dark` rules win the cascade without creating a\n * duplicate element.\n */\nexport function applyThemeCss(css: string | null): void {\n  if (typeof document === 'undefined') return;\n  const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);\n\n  if (css === null || css.length === 0) {\n    existing?.remove();\n    return;\n  }\n\n  if (existing instanceof HTMLStyleElement) {\n    existing.textContent = css;\n    document.head.appendChild(existing);\n    return;\n  }\n  existing?.remove(); // defensive: same id but somehow not a <style>\n\n  const style = document.createElement('style');\n  style.id = THEME_CSS_STYLE_ELEMENT_ID;\n  style.textContent = css;\n  document.head.appendChild(style);\n}\n"],"mappings":";;AAuCA,MAAa,wBAAwB;AAKrC,MAAa,6BAA6B;AAQ1C,SAAgB,eAA8B;CAC5C,IAAI,OAAO,WAAW,aAAa,OAAO;CAC1C,IAAI;EACF,MAAM,MAAM,OAAO,aAAa,QAAQ,qBAAqB;EAC7D,OAAO,OAAO,IAAI,SAAS,IAAI,MAAM;CACvC,QAAQ;EACN,OAAO;CACT;AACF;AAWA,SAAgB,cAAc,KAA0B;CACtD,IAAI,OAAO,WAAW,aAAa;CACnC,IAAI;EACF,IAAI,QAAQ,QAAQ,IAAI,WAAW,GACjC,OAAO,aAAa,WAAW,qBAAqB;OAEpD,OAAO,aAAa,QAAQ,uBAAuB,GAAG;CAE1D,QAAQ,CAGR;AACF;AAcA,SAAgB,cAAc,KAA0B;CACtD,IAAI,OAAO,aAAa,aAAa;CACrC,MAAM,WAAW,SAAS,eAAe,0BAA0B;CAEnE,IAAI,QAAQ,QAAQ,IAAI,WAAW,GAAG;EACpC,UAAU,OAAO;EACjB;CACF;CAEA,IAAI,oBAAoB,kBAAkB;EACxC,SAAS,cAAc;EACvB,SAAS,KAAK,YAAY,QAAQ;EAClC;CACF;CACA,UAAU,OAAO;CAEjB,MAAM,QAAQ,SAAS,cAAc,OAAO;CAC5C,MAAM,KAAK;CACX,MAAM,cAAc;CACpB,SAAS,KAAK,YAAY,KAAK;AACjC"}

package/dist/theme/theme-storage.d.cts

@@ -1,3 +1,4 @@
+//#region src/theme/theme-storage.d.ts
 /**
  * Persists and applies the active PALETTE theme's CSS — separate concern
  * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),
@@ -71,5 +72,6 @@ declare function writeThemeCss(css: string | null): void;
  * duplicate element.
  */
 declare function applyThemeCss(css: string | null): void;
-
+//#endregion
 export { THEME_CSS_STORAGE_KEY, THEME_CSS_STYLE_ELEMENT_ID, applyThemeCss, readThemeCss, writeThemeCss };
+//# sourceMappingURL=theme-storage.d.cts.map

package/dist/theme/theme-storage.d.ts

@@ -1,3 +1,4 @@
+//#region src/theme/theme-storage.d.ts
 /**
  * Persists and applies the active PALETTE theme's CSS — separate concern
  * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),
@@ -71,5 +72,6 @@ declare function writeThemeCss(css: string | null): void;
  * duplicate element.
  */
 declare function applyThemeCss(css: string | null): void;
-
+//#endregion
 export { THEME_CSS_STORAGE_KEY, THEME_CSS_STYLE_ELEMENT_ID, applyThemeCss, readThemeCss, writeThemeCss };
+//# sourceMappingURL=theme-storage.d.ts.map

package/dist/theme/theme-storage.js

@@ -1,45 +1,41 @@
-// src/theme/theme-storage.ts
-var THEME_CSS_STORAGE_KEY = "buro-theme-css";
-var THEME_CSS_STYLE_ELEMENT_ID = "buro-theme-css";
+//#region src/theme/theme-storage.ts
+const THEME_CSS_STORAGE_KEY = "buro-theme-css";
+const THEME_CSS_STYLE_ELEMENT_ID = "buro-theme-css";
 function readThemeCss() {
-  if (typeof window === "undefined") return null;
-  try {
-    const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);
-    return css && css.length > 0 ? css : null;
-  } catch {
-    return null;
-  }
+	if (typeof window === "undefined") return null;
+	try {
+		const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);
+		return css && css.length > 0 ? css : null;
+	} catch {
+		return null;
+	}
 }
 function writeThemeCss(css) {
-  if (typeof window === "undefined") return;
-  try {
-    if (css === null || css.length === 0) {
-      window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);
-    } else {
-      window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);
-    }
-  } catch {
-  }
+	if (typeof window === "undefined") return;
+	try {
+		if (css === null || css.length === 0) window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);
+		else window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);
+	} catch {}
 }
 function applyThemeCss(css) {
-  if (typeof document === "undefined") return;
-  const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);
-  if (css === null || css.length === 0) {
-    existing?.remove();
-    return;
-  }
-  if (existing instanceof HTMLStyleElement) {
-    existing.textContent = css;
-    document.head.appendChild(existing);
-    return;
-  }
-  existing?.remove();
-  const style = document.createElement("style");
-  style.id = THEME_CSS_STYLE_ELEMENT_ID;
-  style.textContent = css;
-  document.head.appendChild(style);
+	if (typeof document === "undefined") return;
+	const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);
+	if (css === null || css.length === 0) {
+		existing?.remove();
+		return;
+	}
+	if (existing instanceof HTMLStyleElement) {
+		existing.textContent = css;
+		document.head.appendChild(existing);
+		return;
+	}
+	existing?.remove();
+	const style = document.createElement("style");
+	style.id = THEME_CSS_STYLE_ELEMENT_ID;
+	style.textContent = css;
+	document.head.appendChild(style);
 }
-
+//#endregion
 export { THEME_CSS_STORAGE_KEY, THEME_CSS_STYLE_ELEMENT_ID, applyThemeCss, readThemeCss, writeThemeCss };
-//# sourceMappingURL=theme-storage.js.map
+
 //# sourceMappingURL=theme-storage.js.map

package/dist/theme/theme-storage.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/theme-storage.ts"],"names":[],"mappings":";AAuCO,IAAM,qBAAA,GAAwB;AAK9B,IAAM,0BAAA,GAA6B;AAQnC,SAAS,YAAA,GAA8B;AAC5C,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,IAAA;AAC1C,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,qBAAqB,CAAA;AAC7D,IAAA,OAAO,GAAA,IAAO,GAAA,CAAI,MAAA,GAAS,CAAA,GAAI,GAAA,GAAM,IAAA;AAAA,EACvC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAWO,SAAS,cAAc,GAAA,EAA0B;AACtD,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACnC,EAAA,IAAI;AACF,IAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,GAAA,CAAI,MAAA,KAAW,CAAA,EAAG;AACpC,MAAA,MAAA,CAAO,YAAA,CAAa,WAAW,qBAAqB,CAAA;AAAA,IACtD,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,qBAAA,EAAuB,GAAG,CAAA;AAAA,IACxD;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAGR;AACF;AAcO,SAAS,cAAc,GAAA,EAA0B;AACtD,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACrC,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,cAAA,CAAe,0BAA0B,CAAA;AAEnE,EAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,GAAA,CAAI,MAAA,KAAW,CAAA,EAAG;AACpC,IAAA,QAAA,EAAU,MAAA,EAAO;AACjB,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,oBAAoB,gBAAA,EAAkB;AACxC,IAAA,QAAA,CAAS,WAAA,GAAc,GAAA;AACvB,IAAA,QAAA,CAAS,IAAA,CAAK,YAAY,QAAQ,CAAA;AAClC,IAAA;AAAA,EACF;AACA,EAAA,QAAA,EAAU,MAAA,EAAO;AAEjB,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,aAAA,CAAc,OAAO,CAAA;AAC5C,EAAA,KAAA,CAAM,EAAA,GAAK,0BAAA;AACX,EAAA,KAAA,CAAM,WAAA,GAAc,GAAA;AACpB,EAAA,QAAA,CAAS,IAAA,CAAK,YAAY,KAAK,CAAA;AACjC","file":"theme-storage.js","sourcesContent":["/**\n * Persists and applies the active PALETTE theme's CSS — separate concern\n * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),\n * which holds light/dark/system. That key answers \"which class goes on\n * `<html>`\"; this one answers \"what custom-property values does `:root`/\n * `.dark` carry\". A theme picker calling `writeThemeCss` must never touch\n * `THEME_STORAGE_KEY`, and the light/dark toggle must never touch this one —\n * each write path only ever calls its own key's functions, so there is no\n * shared code path where a bug could cross-contaminate them.\n *\n * The stored value is the theme's CSS **in full** (already reduced to just\n * `:root`/`.dark` by `stripThemeCss`), not a theme id. That is what makes a\n * pasted (tweakcn) theme and a built-in theme indistinguishable to this\n * module and to the bootstrap script: neither has to know the built-in\n * theme catalogue, ship it in the bundle, or fetch it over the network\n * before paint. The cost is that this module does NOT validate — a caller\n * that wants the \".dark block present\" guarantee must run `validateThemeCss`\n * itself before calling `writeThemeCss` (the theme picker does this; see its\n * task). `applyThemeCss` and the bootstrap script just inject whatever\n * string is there. That is deliberate, not an oversight: CSS parsing is\n * forgiving by construction — unknown/malformed declarations are dropped\n * rule-by-rule by the browser's own parser, not fatal — so blindly injecting\n * a corrupt or half-written string degrades to \"some rules don't apply\", not\n * a crash or a blank page. Re-validating on every read would also block\n * first paint on running `parseTopLevelBlocks` over an arbitrarily large\n * string, which is exactly the cost the bootstrap script exists to avoid.\n *\n * Deliberately its own module, no React import, same reasoning as\n * `theme-storage-key.ts`: the ONE consumer that needs `THEME_CSS_STORAGE_KEY`\n * and `applyThemeCss` outside a hook is the bootstrap `<script>` in the\n * playground's root `app/layout.tsx`, a Server Component that cannot import\n * anything carrying `'use client'`. This file has no hooks, so it can be\n * imported there directly via the `@burojs/ui-shadcn/theme-storage` subpath.\n */\n\n/**\n * The localStorage key for the active theme's CSS text. Kept apart from\n * `THEME_STORAGE_KEY` on purpose — see the module doc comment above.\n */\nexport const THEME_CSS_STORAGE_KEY = 'buro-theme-css';\n\n/** The id of the `<style>` element the bootstrap script and `applyThemeCss`\n * both create/update. Exported so a test can assert on it without\n * retyping the literal. */\nexport const THEME_CSS_STYLE_ELEMENT_ID = 'buro-theme-css';\n\n/**\n * Reads the persisted theme CSS, or `null` if nothing is stored, storage is\n * unavailable (SSR, or a browser with it disabled — e.g. some private-mode\n * configurations throw on access rather than just being empty), or the\n * stored value is an empty string (treated the same as absent).\n */\nexport function readThemeCss(): string | null {\n  if (typeof window === 'undefined') return null;\n  try {\n    const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);\n    return css && css.length > 0 ? css : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Persists (or, given `null`, clears) the theme CSS. Does not validate —\n * callers that need the \".dark present\" guarantee run `validateThemeCss`\n * first (see module doc comment). Swallows storage errors (quota exceeded\n * from an oversized paste, storage disabled, etc.): the in-memory\n * application via `applyThemeCss` already happened by the time a caller\n * persists, so a failed write loses the choice on next reload but does not\n * throw or break the current page.\n */\nexport function writeThemeCss(css: string | null): void {\n  if (typeof window === 'undefined') return;\n  try {\n    if (css === null || css.length === 0) {\n      window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);\n    } else {\n      window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);\n    }\n  } catch {\n    // Quota exceeded, storage disabled, or a similar DOMException — nothing\n    // persisted. The caller's in-memory `applyThemeCss` call still stands.\n  }\n}\n\n/**\n * Creates, updates, or removes the `<style id=\"buro-theme-css\">`\n * element that carries the active theme's `:root`/`.dark` custom\n * properties. Given `null` (or an empty string), removes the element\n * entirely rather than leaving an empty tag behind.\n *\n * Order matters: this function always places the element at the END of\n * `<head>`, including when updating a style created by a prepaint bootstrap.\n * That lets an app call it after its own stylesheet has loaded so the theme's\n * equal-specificity `:root`/`.dark` rules win the cascade without creating a\n * duplicate element.\n */\nexport function applyThemeCss(css: string | null): void {\n  if (typeof document === 'undefined') return;\n  const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);\n\n  if (css === null || css.length === 0) {\n    existing?.remove();\n    return;\n  }\n\n  if (existing instanceof HTMLStyleElement) {\n    existing.textContent = css;\n    document.head.appendChild(existing);\n    return;\n  }\n  existing?.remove(); // defensive: same id but somehow not a <style>\n\n  const style = document.createElement('style');\n  style.id = THEME_CSS_STYLE_ELEMENT_ID;\n  style.textContent = css;\n  document.head.appendChild(style);\n}\n"]}
+{"version":3,"file":"theme-storage.js","names":[],"sources":["../../src/theme/theme-storage.ts"],"sourcesContent":["/**\n * Persists and applies the active PALETTE theme's CSS — separate concern\n * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),\n * which holds light/dark/system. That key answers \"which class goes on\n * `<html>`\"; this one answers \"what custom-property values does `:root`/\n * `.dark` carry\". A theme picker calling `writeThemeCss` must never touch\n * `THEME_STORAGE_KEY`, and the light/dark toggle must never touch this one —\n * each write path only ever calls its own key's functions, so there is no\n * shared code path where a bug could cross-contaminate them.\n *\n * The stored value is the theme's CSS **in full** (already reduced to just\n * `:root`/`.dark` by `stripThemeCss`), not a theme id. That is what makes a\n * pasted (tweakcn) theme and a built-in theme indistinguishable to this\n * module and to the bootstrap script: neither has to know the built-in\n * theme catalogue, ship it in the bundle, or fetch it over the network\n * before paint. The cost is that this module does NOT validate — a caller\n * that wants the \".dark block present\" guarantee must run `validateThemeCss`\n * itself before calling `writeThemeCss` (the theme picker does this; see its\n * task). `applyThemeCss` and the bootstrap script just inject whatever\n * string is there. That is deliberate, not an oversight: CSS parsing is\n * forgiving by construction — unknown/malformed declarations are dropped\n * rule-by-rule by the browser's own parser, not fatal — so blindly injecting\n * a corrupt or half-written string degrades to \"some rules don't apply\", not\n * a crash or a blank page. Re-validating on every read would also block\n * first paint on running `parseTopLevelBlocks` over an arbitrarily large\n * string, which is exactly the cost the bootstrap script exists to avoid.\n *\n * Deliberately its own module, no React import, same reasoning as\n * `theme-storage-key.ts`: the ONE consumer that needs `THEME_CSS_STORAGE_KEY`\n * and `applyThemeCss` outside a hook is the bootstrap `<script>` in the\n * playground's root `app/layout.tsx`, a Server Component that cannot import\n * anything carrying `'use client'`. This file has no hooks, so it can be\n * imported there directly via the `@burojs/ui-shadcn/theme-storage` subpath.\n */\n\n/**\n * The localStorage key for the active theme's CSS text. Kept apart from\n * `THEME_STORAGE_KEY` on purpose — see the module doc comment above.\n */\nexport const THEME_CSS_STORAGE_KEY = 'buro-theme-css';\n\n/** The id of the `<style>` element the bootstrap script and `applyThemeCss`\n * both create/update. Exported so a test can assert on it without\n * retyping the literal. */\nexport const THEME_CSS_STYLE_ELEMENT_ID = 'buro-theme-css';\n\n/**\n * Reads the persisted theme CSS, or `null` if nothing is stored, storage is\n * unavailable (SSR, or a browser with it disabled — e.g. some private-mode\n * configurations throw on access rather than just being empty), or the\n * stored value is an empty string (treated the same as absent).\n */\nexport function readThemeCss(): string | null {\n  if (typeof window === 'undefined') return null;\n  try {\n    const css = window.localStorage.getItem(THEME_CSS_STORAGE_KEY);\n    return css && css.length > 0 ? css : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Persists (or, given `null`, clears) the theme CSS. Does not validate —\n * callers that need the \".dark present\" guarantee run `validateThemeCss`\n * first (see module doc comment). Swallows storage errors (quota exceeded\n * from an oversized paste, storage disabled, etc.): the in-memory\n * application via `applyThemeCss` already happened by the time a caller\n * persists, so a failed write loses the choice on next reload but does not\n * throw or break the current page.\n */\nexport function writeThemeCss(css: string | null): void {\n  if (typeof window === 'undefined') return;\n  try {\n    if (css === null || css.length === 0) {\n      window.localStorage.removeItem(THEME_CSS_STORAGE_KEY);\n    } else {\n      window.localStorage.setItem(THEME_CSS_STORAGE_KEY, css);\n    }\n  } catch {\n    // Quota exceeded, storage disabled, or a similar DOMException — nothing\n    // persisted. The caller's in-memory `applyThemeCss` call still stands.\n  }\n}\n\n/**\n * Creates, updates, or removes the `<style id=\"buro-theme-css\">`\n * element that carries the active theme's `:root`/`.dark` custom\n * properties. Given `null` (or an empty string), removes the element\n * entirely rather than leaving an empty tag behind.\n *\n * Order matters: this function always places the element at the END of\n * `<head>`, including when updating a style created by a prepaint bootstrap.\n * That lets an app call it after its own stylesheet has loaded so the theme's\n * equal-specificity `:root`/`.dark` rules win the cascade without creating a\n * duplicate element.\n */\nexport function applyThemeCss(css: string | null): void {\n  if (typeof document === 'undefined') return;\n  const existing = document.getElementById(THEME_CSS_STYLE_ELEMENT_ID);\n\n  if (css === null || css.length === 0) {\n    existing?.remove();\n    return;\n  }\n\n  if (existing instanceof HTMLStyleElement) {\n    existing.textContent = css;\n    document.head.appendChild(existing);\n    return;\n  }\n  existing?.remove(); // defensive: same id but somehow not a <style>\n\n  const style = document.createElement('style');\n  style.id = THEME_CSS_STYLE_ELEMENT_ID;\n  style.textContent = css;\n  document.head.appendChild(style);\n}\n"],"mappings":";AAuCA,MAAa,wBAAwB;AAKrC,MAAa,6BAA6B;AAQ1C,SAAgB,eAA8B;CAC5C,IAAI,OAAO,WAAW,aAAa,OAAO;CAC1C,IAAI;EACF,MAAM,MAAM,OAAO,aAAa,QAAQ,qBAAqB;EAC7D,OAAO,OAAO,IAAI,SAAS,IAAI,MAAM;CACvC,QAAQ;EACN,OAAO;CACT;AACF;AAWA,SAAgB,cAAc,KAA0B;CACtD,IAAI,OAAO,WAAW,aAAa;CACnC,IAAI;EACF,IAAI,QAAQ,QAAQ,IAAI,WAAW,GACjC,OAAO,aAAa,WAAW,qBAAqB;OAEpD,OAAO,aAAa,QAAQ,uBAAuB,GAAG;CAE1D,QAAQ,CAGR;AACF;AAcA,SAAgB,cAAc,KAA0B;CACtD,IAAI,OAAO,aAAa,aAAa;CACrC,MAAM,WAAW,SAAS,eAAe,0BAA0B;CAEnE,IAAI,QAAQ,QAAQ,IAAI,WAAW,GAAG;EACpC,UAAU,OAAO;EACjB;CACF;CAEA,IAAI,oBAAoB,kBAAkB;EACxC,SAAS,cAAc;EACvB,SAAS,KAAK,YAAY,QAAQ;EAClC;CACF;CACA,UAAU,OAAO;CAEjB,MAAM,QAAQ,SAAS,cAAc,OAAO;CAC5C,MAAM,KAAK;CACX,MAAM,cAAc;CACpB,SAAS,KAAK,YAAY,KAAK;AACjC"}

package/dist/theme-storage-key-pYlp4aDS.d.cts

@@ -0,0 +1,31 @@
+//#region src/layout/theme-storage-key.d.ts
+/**
+ * The ONE localStorage key every theme-aware place in the app must agree on.
+ * Exported so nothing re-types the string — two files agreeing on a literal
+ * is how they drift.
+ *
+ * Deliberately its own module: no `'use client'`, no React import, nothing
+ * that would pull in `use-theme.ts`'s hook (or the rest of the kit's client
+ * component tree). That matters because the consumer that needs this
+ * constant outside a hook is a pre-paint bootstrap `<script>` in a Next root
+ * `app/layout.tsx` — a Server Component, which cannot itself carry
+ * `'use client'`. `examples/next/app/layout.tsx` is that consumer, and after
+ * SP9 deleted `apps/playground` it is the only one; a plain-HTML host has the
+ * same need but no module graph to satisfy it from, which is why
+ * `examples/marketplace-ops/index.html` spells the key as a literal and pins
+ * it against this constant in a test instead.
+ * Importing from the package's main entry (`@burojs/ui-shadcn`)
+ * there fails Next's server/client boundary check, because that entry
+ * bundles the whole kit — including many components that call hooks —
+ * into one file without a top-level `'use client'` directive (the bundler
+ * drops it when merging multiple client modules together — true of tsdown,
+ * as it was of tsup). Importing this file
+ * directly via the `@burojs/ui-shadcn/theme-storage-key` subpath sidesteps
+ * that: it has no hooks, so a Server Component can import the real string
+ * value at build/SSR time. `use-theme.ts` re-exports the same constant for
+ * everyone else, so there is exactly one literal in the whole codebase.
+ */
+declare const THEME_STORAGE_KEY = "buro-theme";
+//#endregion
+export { THEME_STORAGE_KEY as t };
+//# sourceMappingURL=theme-storage-key-pYlp4aDS.d.cts.map

package/dist/theme-storage-key-pYlp4aDS.d.ts

@@ -0,0 +1,31 @@
+//#region src/layout/theme-storage-key.d.ts
+/**
+ * The ONE localStorage key every theme-aware place in the app must agree on.
+ * Exported so nothing re-types the string — two files agreeing on a literal
+ * is how they drift.
+ *
+ * Deliberately its own module: no `'use client'`, no React import, nothing
+ * that would pull in `use-theme.ts`'s hook (or the rest of the kit's client
+ * component tree). That matters because the consumer that needs this
+ * constant outside a hook is a pre-paint bootstrap `<script>` in a Next root
+ * `app/layout.tsx` — a Server Component, which cannot itself carry
+ * `'use client'`. `examples/next/app/layout.tsx` is that consumer, and after
+ * SP9 deleted `apps/playground` it is the only one; a plain-HTML host has the
+ * same need but no module graph to satisfy it from, which is why
+ * `examples/marketplace-ops/index.html` spells the key as a literal and pins
+ * it against this constant in a test instead.
+ * Importing from the package's main entry (`@burojs/ui-shadcn`)
+ * there fails Next's server/client boundary check, because that entry
+ * bundles the whole kit — including many components that call hooks —
+ * into one file without a top-level `'use client'` directive (the bundler
+ * drops it when merging multiple client modules together — true of tsdown,
+ * as it was of tsup). Importing this file
+ * directly via the `@burojs/ui-shadcn/theme-storage-key` subpath sidesteps
+ * that: it has no hooks, so a Server Component can import the real string
+ * value at build/SSR time. `use-theme.ts` re-exports the same constant for
+ * everyone else, so there is exactly one literal in the whole codebase.
+ */
+declare const THEME_STORAGE_KEY = "buro-theme";
+//#endregion
+export { THEME_STORAGE_KEY as t };
+//# sourceMappingURL=theme-storage-key-pYlp4aDS.d.ts.map