@burojs/ui-shadcn 0.2.0

package/dist/theme/theme-css.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+// 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;
+}
+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");
+}
+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 };
+}
+
+exports.stripThemeCss = stripThemeCss;
+exports.validateThemeCss = validateThemeCss;
+//# sourceMappingURL=theme-css.cjs.map
+//# sourceMappingURL=theme-css.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/theme-css.ts"],"names":[],"mappings":"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","file":"theme-css.cjs","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"]}

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

@@ -0,0 +1,49 @@
+/**
+ * Pure functions for handling a pasted tweakcn theme.
+ *
+ * tweakcn's "Copy code" button emits six constructs. Only two of them mean
+ * anything once dropped into a browser at runtime (not build time, since
+ * there is no Tailwind build step for pasted CSS):
+ *
+ *   @import "tailwindcss";           -> 404s if kept (no such route at runtime)
+ *   @custom-variant dark (...);      -> meaningless outside a Tailwind build
+ *   :root  { ... }                   -> survives, sets light-mode custom properties
+ *   .dark  { ... }                   -> survives, sets dark-mode custom properties
+ *   @theme inline { ... }            -> meaningless outside a Tailwind build
+ *   @layer base { ...; @apply ...; } -> @apply is not real CSS, dead weight
+ *
+ * `stripThemeCss` throws away everything except the `:root` and `.dark`
+ * blocks. `validateThemeCss` catches the one failure mode that is otherwise
+ * invisible: a theme with no `.dark` block. `.dark` and `:root` share equal
+ * specificity, so injecting a `:root`-only theme *after* the app's own
+ * stylesheet makes its `:root` win over `html.dark`'s rules too — dark mode
+ * silently stops working, with no error anywhere.
+ */
+type ThemeRecord = {
+    id: string;
+    name: string;
+    css: string;
+};
+type ThemeValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Reduces a pasted tweakcn theme to just its `:root { ... }` and
+ * `.dark { ... }` blocks, in source order. Everything else (imports,
+ * `@custom-variant`, `@theme inline`, `@layer base`) is dropped. Idempotent:
+ * running it again on its own output is a no-op.
+ */
+declare function stripThemeCss(raw: string): string;
+/**
+ * Validates that a (normally already-stripped) theme is safe to inject.
+ * The load-bearing check is `.dark`: without it, a theme's `:root` values
+ * override the app's `.dark` rules at equal specificity, and dark mode
+ * breaks silently. Also rejects empty input and (defensively) a theme with
+ * no `:root` block at all.
+ */
+declare function validateThemeCss(css: string): ThemeValidationResult;
+
+export { type ThemeRecord, type ThemeValidationResult, stripThemeCss, validateThemeCss };

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

@@ -0,0 +1,49 @@
+/**
+ * Pure functions for handling a pasted tweakcn theme.
+ *
+ * tweakcn's "Copy code" button emits six constructs. Only two of them mean
+ * anything once dropped into a browser at runtime (not build time, since
+ * there is no Tailwind build step for pasted CSS):
+ *
+ *   @import "tailwindcss";           -> 404s if kept (no such route at runtime)
+ *   @custom-variant dark (...);      -> meaningless outside a Tailwind build
+ *   :root  { ... }                   -> survives, sets light-mode custom properties
+ *   .dark  { ... }                   -> survives, sets dark-mode custom properties
+ *   @theme inline { ... }            -> meaningless outside a Tailwind build
+ *   @layer base { ...; @apply ...; } -> @apply is not real CSS, dead weight
+ *
+ * `stripThemeCss` throws away everything except the `:root` and `.dark`
+ * blocks. `validateThemeCss` catches the one failure mode that is otherwise
+ * invisible: a theme with no `.dark` block. `.dark` and `:root` share equal
+ * specificity, so injecting a `:root`-only theme *after* the app's own
+ * stylesheet makes its `:root` win over `html.dark`'s rules too — dark mode
+ * silently stops working, with no error anywhere.
+ */
+type ThemeRecord = {
+    id: string;
+    name: string;
+    css: string;
+};
+type ThemeValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Reduces a pasted tweakcn theme to just its `:root { ... }` and
+ * `.dark { ... }` blocks, in source order. Everything else (imports,
+ * `@custom-variant`, `@theme inline`, `@layer base`) is dropped. Idempotent:
+ * running it again on its own output is a no-op.
+ */
+declare function stripThemeCss(raw: string): string;
+/**
+ * Validates that a (normally already-stripped) theme is safe to inject.
+ * The load-bearing check is `.dark`: without it, a theme's `:root` values
+ * override the app's `.dark` rules at equal specificity, and dark mode
+ * breaks silently. Also rejects empty input and (defensively) a theme with
+ * no `:root` block at all.
+ */
+declare function validateThemeCss(css: string): ThemeValidationResult;
+
+export { type ThemeRecord, type ThemeValidationResult, stripThemeCss, validateThemeCss };

package/dist/theme/theme-css.js

@@ -0,0 +1,102 @@
+// 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;
+}
+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");
+}
+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 };
+}
+
+export { stripThemeCss, validateThemeCss };
+//# sourceMappingURL=theme-css.js.map
+//# sourceMappingURL=theme-css.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/theme-css.ts"],"names":[],"mappings":";AA6DA,SAAS,oBAAoB,GAAA,EAA8B;AACzD,EAAA,MAAM,IAAI,GAAA,CAAI,MAAA;AACd,EAAA,MAAM,SAA0B,EAAC;AACjC,EAAA,IAAI,CAAA,GAAI,CAAA;AAER,EAAA,MAAM,WAAA,GAAc,CAAC,GAAA,KAAwB;AAC3C,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,OAAA,CAAQ,IAAA,EAAM,MAAM,CAAC,CAAA;AACrC,IAAA,OAAO,GAAA,KAAQ,EAAA,GAAK,CAAA,GAAI,GAAA,GAAM,CAAA;AAAA,EAChC,CAAA;AAEA,EAAA,MAAM,UAAA,GAAa,CAAC,GAAA,KAAwB;AAC1C,IAAA,MAAM,KAAA,GAAQ,IAAI,GAAG,CAAA;AACrB,IAAA,IAAI,IAAI,GAAA,GAAM,CAAA;AACd,IAAA,OAAO,CAAA,GAAI,CAAA,IAAK,GAAA,CAAI,CAAC,MAAM,KAAA,EAAO;AAChC,MAAA,IAAI,GAAA,CAAI,CAAC,CAAA,KAAM,IAAA,EAAM,CAAA,EAAA;AACrB,MAAA,CAAA,EAAA;AAAA,IACF;AACA,IAAA,OAAO,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA;AAAA,EACzB,CAAA;AAEA,EAAA,OAAO,IAAI,CAAA,EAAG;AAEZ,IAAA,OAAO,IAAI,CAAA,EAAG;AACZ,MAAA,MAAM,EAAA,GAAK,IAAI,CAAC,CAAA;AAChB,MAAA,IAAI,OAAO,GAAA,IAAO,EAAA,KAAO,OAAQ,EAAA,KAAO,IAAA,IAAQ,OAAO,IAAA,EAAM;AAC3D,QAAA,CAAA,EAAA;AACA,QAAA;AAAA,MACF;AACA,MAAA,IAAI,GAAA,CAAI,UAAA,CAAW,IAAA,EAAM,CAAC,CAAA,EAAG;AAC3B,QAAA,CAAA,GAAI,YAAY,CAAC,CAAA;AACjB,QAAA;AAAA,MACF;AACA,MAAA;AAAA,IACF;AACA,IAAA,IAAI,KAAK,CAAA,EAAG;AAEZ,IAAA,MAAM,cAAA,GAAiB,CAAA;AACvB,IAAA,IAAI,IAAA,GAAO,EAAA;AAGX,IAAA,OAAO,CAAA,GAAI,KAAK,GAAA,CAAI,CAAC,MAAM,GAAA,IAAO,GAAA,CAAI,CAAC,CAAA,KAAM,GAAA,EAAK;AAChD,MAAA,IAAI,GAAA,CAAI,UAAA,CAAW,IAAA,EAAM,CAAC,CAAA,EAAG;AAC3B,QAAA,CAAA,GAAI,YAAY,CAAC,CAAA;AACjB,QAAA;AAAA,MACF;AACA,MAAA,IAAI,IAAI,CAAC,CAAA,KAAM,OAAO,GAAA,CAAI,CAAC,MAAM,GAAA,EAAK;AACpC,QAAA,MAAM,QAAA,GAAW,CAAA;AACjB,QAAA,CAAA,GAAI,WAAW,CAAC,CAAA;AAChB,QAAA,IAAA,IAAQ,GAAA,CAAI,KAAA,CAAM,QAAA,EAAU,CAAC,CAAA;AAC7B,QAAA;AAAA,MACF;AACA,MAAA,IAAA,IAAQ,IAAI,CAAC,CAAA;AACb,MAAA,CAAA,EAAA;AAAA,IACF;AAOA,IAAA,IAAI,KAAK,CAAA,EAAG;AAEZ,IAAA,IAAI,GAAA,CAAI,CAAC,CAAA,KAAM,GAAA,EAAK;AAClB,MAAA,CAAA,EAAA;AACA,MAAA;AAAA,IACF;AAGA,IAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,IAAA,IAAI,IAAI,CAAA,GAAI,CAAA;AACZ,IAAA,OAAO,CAAA,GAAI,CAAA,IAAK,KAAA,GAAQ,CAAA,EAAG;AACzB,MAAA,IAAI,GAAA,CAAI,UAAA,CAAW,IAAA,EAAM,CAAC,CAAA,EAAG;AAC3B,QAAA,CAAA,GAAI,YAAY,CAAC,CAAA;AACjB,QAAA;AAAA,MACF;AACA,MAAA,IAAI,IAAI,CAAC,CAAA,KAAM,OAAO,GAAA,CAAI,CAAC,MAAM,GAAA,EAAK;AACpC,QAAA,CAAA,GAAI,WAAW,CAAC,CAAA;AAChB,QAAA;AAAA,MACF;AACA,MAAA,IAAI,GAAA,CAAI,CAAC,CAAA,KAAM,GAAA,EAAK,KAAA,EAAA;AAAA,WAAA,IACX,GAAA,CAAI,CAAC,CAAA,KAAM,GAAA,EAAK,KAAA,EAAA;AACzB,MAAA,CAAA,EAAA;AAAA,IACF;AAKA,IAAA,MAAA,CAAO,IAAA,CAAK,EAAE,QAAA,EAAU,IAAA,CAAK,IAAA,EAAK,EAAG,GAAA,EAAK,GAAA,CAAI,KAAA,CAAM,cAAA,EAAgB,CAAC,CAAA,EAAG,CAAA;AACxE,IAAA,CAAA,GAAI,CAAA;AAAA,EACN;AAEA,EAAA,OAAO,MAAA;AACT;AAQO,SAAS,cAAc,GAAA,EAAqB;AACjD,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,IAAI,CAAA;AAC5C,EAAA,MAAM,MAAA,GAAS,oBAAoB,UAAU,CAAA;AAC7C,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,QAAA,KAAa,OAAA,IAAW,CAAA,CAAE,QAAA,KAAa,OAAO,CAAA;AAClF,EAAA,OAAO,IAAA,CAAK,IAAI,CAAC,CAAA,KAAM,EAAE,GAAG,CAAA,CAAE,KAAK,MAAM,CAAA;AAC3C;AASO,SAAS,iBAAiB,GAAA,EAAoC;AACnE,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,IAAI,CAAA;AAC5C,EAAA,IAAI,UAAA,CAAW,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,EAAG;AAClC,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,qBAAA,EAAsB;AAAA,EACpD;AAEA,EAAA,MAAM,MAAA,GAAS,oBAAoB,UAAU,CAAA;AAC7C,EAAA,MAAM,UAAU,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,aAAa,OAAO,CAAA;AACzD,EAAA,MAAM,UAAU,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,aAAa,OAAO,CAAA;AAEzD,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,MAAA,EACE,CAAA,oKAAA;AAAA,KAGJ;AAAA,EACF;AAEA,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,kEAAA,EAA8D;AAAA,EAC5F;AAEA,EAAA,OAAO,EAAE,IAAI,IAAA,EAAK;AACpB","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"]}

package/dist/theme/theme-storage.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+// src/theme/theme-storage.ts
+var THEME_CSS_STORAGE_KEY = "buro-theme-css";
+var 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;
+  }
+}
+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 {
+  }
+}
+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);
+}
+
+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

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

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

@@ -0,0 +1,75 @@
+/**
+ * Persists and applies the active PALETTE theme's CSS — separate concern
+ * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),
+ * which holds light/dark/system. That key answers "which class goes on
+ * `<html>`"; this one answers "what custom-property values does `:root`/
+ * `.dark` carry". A theme picker calling `writeThemeCss` must never touch
+ * `THEME_STORAGE_KEY`, and the light/dark toggle must never touch this one —
+ * each write path only ever calls its own key's functions, so there is no
+ * shared code path where a bug could cross-contaminate them.
+ *
+ * The stored value is the theme's CSS **in full** (already reduced to just
+ * `:root`/`.dark` by `stripThemeCss`), not a theme id. That is what makes a
+ * pasted (tweakcn) theme and a built-in theme indistinguishable to this
+ * module and to the bootstrap script: neither has to know the built-in
+ * theme catalogue, ship it in the bundle, or fetch it over the network
+ * before paint. The cost is that this module does NOT validate — a caller
+ * that wants the ".dark block present" guarantee must run `validateThemeCss`
+ * itself before calling `writeThemeCss` (the theme picker does this; see its
+ * task). `applyThemeCss` and the bootstrap script just inject whatever
+ * string is there. That is deliberate, not an oversight: CSS parsing is
+ * forgiving by construction — unknown/malformed declarations are dropped
+ * rule-by-rule by the browser's own parser, not fatal — so blindly injecting
+ * a corrupt or half-written string degrades to "some rules don't apply", not
+ * a crash or a blank page. Re-validating on every read would also block
+ * first paint on running `parseTopLevelBlocks` over an arbitrarily large
+ * string, which is exactly the cost the bootstrap script exists to avoid.
+ *
+ * Deliberately its own module, no React import, same reasoning as
+ * `theme-storage-key.ts`: the ONE consumer that needs `THEME_CSS_STORAGE_KEY`
+ * and `applyThemeCss` outside a hook is the bootstrap `<script>` in the
+ * playground's root `app/layout.tsx`, a Server Component that cannot import
+ * anything carrying `'use client'`. This file has no hooks, so it can be
+ * imported there directly via the `@burojs/ui-shadcn/theme-storage` subpath.
+ */
+/**
+ * The localStorage key for the active theme's CSS text. Kept apart from
+ * `THEME_STORAGE_KEY` on purpose — see the module doc comment above.
+ */
+declare const THEME_CSS_STORAGE_KEY = "buro-theme-css";
+/** The id of the `<style>` element the bootstrap script and `applyThemeCss`
+ * both create/update. Exported so a test can assert on it without
+ * retyping the literal. */
+declare const THEME_CSS_STYLE_ELEMENT_ID = "buro-theme-css";
+/**
+ * Reads the persisted theme CSS, or `null` if nothing is stored, storage is
+ * unavailable (SSR, or a browser with it disabled — e.g. some private-mode
+ * configurations throw on access rather than just being empty), or the
+ * stored value is an empty string (treated the same as absent).
+ */
+declare function readThemeCss(): string | null;
+/**
+ * Persists (or, given `null`, clears) the theme CSS. Does not validate —
+ * callers that need the ".dark present" guarantee run `validateThemeCss`
+ * first (see module doc comment). Swallows storage errors (quota exceeded
+ * from an oversized paste, storage disabled, etc.): the in-memory
+ * application via `applyThemeCss` already happened by the time a caller
+ * persists, so a failed write loses the choice on next reload but does not
+ * throw or break the current page.
+ */
+declare function writeThemeCss(css: string | null): void;
+/**
+ * Creates, updates, or removes the `<style id="buro-theme-css">`
+ * element that carries the active theme's `:root`/`.dark` custom
+ * properties. Given `null` (or an empty string), removes the element
+ * entirely rather than leaving an empty tag behind.
+ *
+ * Order matters: this function always places the element at the END of
+ * `<head>`, including when updating a style created by a prepaint bootstrap.
+ * That lets an app call it after its own stylesheet has loaded so the theme's
+ * equal-specificity `:root`/`.dark` rules win the cascade without creating a
+ * duplicate element.
+ */
+declare function applyThemeCss(css: string | null): void;
+
+export { THEME_CSS_STORAGE_KEY, THEME_CSS_STYLE_ELEMENT_ID, applyThemeCss, readThemeCss, writeThemeCss };

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

@@ -0,0 +1,75 @@
+/**
+ * Persists and applies the active PALETTE theme's CSS — separate concern
+ * from `THEME_STORAGE_KEY` (`packages/ui-shadcn/src/layout/theme-storage-key.ts`),
+ * which holds light/dark/system. That key answers "which class goes on
+ * `<html>`"; this one answers "what custom-property values does `:root`/
+ * `.dark` carry". A theme picker calling `writeThemeCss` must never touch
+ * `THEME_STORAGE_KEY`, and the light/dark toggle must never touch this one —
+ * each write path only ever calls its own key's functions, so there is no
+ * shared code path where a bug could cross-contaminate them.
+ *
+ * The stored value is the theme's CSS **in full** (already reduced to just
+ * `:root`/`.dark` by `stripThemeCss`), not a theme id. That is what makes a
+ * pasted (tweakcn) theme and a built-in theme indistinguishable to this
+ * module and to the bootstrap script: neither has to know the built-in
+ * theme catalogue, ship it in the bundle, or fetch it over the network
+ * before paint. The cost is that this module does NOT validate — a caller
+ * that wants the ".dark block present" guarantee must run `validateThemeCss`
+ * itself before calling `writeThemeCss` (the theme picker does this; see its
+ * task). `applyThemeCss` and the bootstrap script just inject whatever
+ * string is there. That is deliberate, not an oversight: CSS parsing is
+ * forgiving by construction — unknown/malformed declarations are dropped
+ * rule-by-rule by the browser's own parser, not fatal — so blindly injecting
+ * a corrupt or half-written string degrades to "some rules don't apply", not
+ * a crash or a blank page. Re-validating on every read would also block
+ * first paint on running `parseTopLevelBlocks` over an arbitrarily large
+ * string, which is exactly the cost the bootstrap script exists to avoid.
+ *
+ * Deliberately its own module, no React import, same reasoning as
+ * `theme-storage-key.ts`: the ONE consumer that needs `THEME_CSS_STORAGE_KEY`
+ * and `applyThemeCss` outside a hook is the bootstrap `<script>` in the
+ * playground's root `app/layout.tsx`, a Server Component that cannot import
+ * anything carrying `'use client'`. This file has no hooks, so it can be
+ * imported there directly via the `@burojs/ui-shadcn/theme-storage` subpath.
+ */
+/**
+ * The localStorage key for the active theme's CSS text. Kept apart from
+ * `THEME_STORAGE_KEY` on purpose — see the module doc comment above.
+ */
+declare const THEME_CSS_STORAGE_KEY = "buro-theme-css";
+/** The id of the `<style>` element the bootstrap script and `applyThemeCss`
+ * both create/update. Exported so a test can assert on it without
+ * retyping the literal. */
+declare const THEME_CSS_STYLE_ELEMENT_ID = "buro-theme-css";
+/**
+ * Reads the persisted theme CSS, or `null` if nothing is stored, storage is
+ * unavailable (SSR, or a browser with it disabled — e.g. some private-mode
+ * configurations throw on access rather than just being empty), or the
+ * stored value is an empty string (treated the same as absent).
+ */
+declare function readThemeCss(): string | null;
+/**
+ * Persists (or, given `null`, clears) the theme CSS. Does not validate —
+ * callers that need the ".dark present" guarantee run `validateThemeCss`
+ * first (see module doc comment). Swallows storage errors (quota exceeded
+ * from an oversized paste, storage disabled, etc.): the in-memory
+ * application via `applyThemeCss` already happened by the time a caller
+ * persists, so a failed write loses the choice on next reload but does not
+ * throw or break the current page.
+ */
+declare function writeThemeCss(css: string | null): void;
+/**
+ * Creates, updates, or removes the `<style id="buro-theme-css">`
+ * element that carries the active theme's `:root`/`.dark` custom
+ * properties. Given `null` (or an empty string), removes the element
+ * entirely rather than leaving an empty tag behind.
+ *
+ * Order matters: this function always places the element at the END of
+ * `<head>`, including when updating a style created by a prepaint bootstrap.
+ * That lets an app call it after its own stylesheet has loaded so the theme's
+ * equal-specificity `:root`/`.dark` rules win the cascade without creating a
+ * duplicate element.
+ */
+declare function applyThemeCss(css: string | null): void;
+
+export { THEME_CSS_STORAGE_KEY, THEME_CSS_STYLE_ELEMENT_ID, applyThemeCss, readThemeCss, writeThemeCss };

package/dist/theme/theme-storage.js

@@ -0,0 +1,45 @@
+// src/theme/theme-storage.ts
+var THEME_CSS_STORAGE_KEY = "buro-theme-css";
+var 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;
+  }
+}
+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 {
+  }
+}
+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);
+}
+
+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

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