@csszyx/unplugin 0.11.11 → 0.13.0

package/dist/shared/{unplugin.CJcFsJcf.cjs → unplugin.Bf4fNbp7.cjs}

@@ -13,10 +13,11 @@ const svelteAdapter = require('@csszyx/svelte-adapter');
 const types = require('@csszyx/types');
 const vueAdapter = require('@csszyx/vue-adapter');
 const unplugin$1 = require('unplugin');
-const transformCache = require('./unplugin.CKIOVNOg.cjs');
+const transformCache = require('./unplugin.4du3qMst.cjs');
 const cssMangler = require('../css-mangler.cjs');
-const runtimeImportScan = require('./unplugin.Cnxm1DcC.cjs');
+const themeGroupsFile = require('./unplugin.X9a9SL_s.cjs');
 const htmlEscape = require('./unplugin.BkRah5Ot.cjs');
+const node_zlib = require('node:zlib');
 const postcss = require('postcss');
 const valueParser = require('postcss-value-parser');
 
@@ -311,7 +312,7 @@ function validateCandidates(candidates, definitions, reserved, aliasPrefix) {
         code: "registered-property",
         severity: "error",
         name,
-        message: `Registered custom property ${name} is not aliasable in Phase H v1.`,
+        message: `Registered custom property ${name} cannot be aliased: @property gives it a type and inheritance behaviour that an alias would not carry.`,
         location: registeredDefinition
       });
     }
@@ -1131,237 +1132,6 @@ function maskBlockComment(code, start) {
   return { end, value };
 }
 
-const EMPTY_THEME = {
-  colors: [],
-  spacings: [],
-  fonts: [],
-  textSizes: [],
-  fontWeights: [],
-  radii: [],
-  shadows: [],
-  breakpoints: []
-};
-function findMatchingBrace(source, openBrace) {
-  let depth = 0;
-  for (let index = openBrace; index < source.length; index++) {
-    if (source[index] === "{") {
-      depth++;
-    } else if (source[index] === "}") {
-      depth--;
-      if (depth === 0) {
-        return index;
-      }
-    }
-  }
-  return -1;
-}
-function stripLayerWrappers(css) {
-  let result = "";
-  let i = 0;
-  while (i < css.length) {
-    const layerIdx = css.indexOf("@layer", i);
-    if (layerIdx === -1) {
-      result += css.slice(i);
-      break;
-    }
-    result += css.slice(i, layerIdx);
-    const openBrace = css.indexOf("{", layerIdx);
-    if (openBrace === -1) {
-      result += css.slice(layerIdx);
-      break;
-    }
-    const closeBrace = findMatchingBrace(css, openBrace);
-    if (closeBrace === -1) {
-      result += css.slice(openBrace);
-      break;
-    }
-    result += css.slice(openBrace + 1, closeBrace);
-    i = closeBrace + 1;
-  }
-  return result;
-}
-function themePreludeStart(css, at) {
-  const cursor = at + "@theme".length;
-  const next = css[cursor];
-  const validBoundary = next === "{" || next === " " || next === "	" || next === "\n" || next === "\r";
-  return validBoundary ? cursor : null;
-}
-function readThemeBlock(css, start) {
-  for (let cursor = start; cursor < css.length; cursor++) {
-    const character = css[cursor];
-    if (character === "{") {
-      const close = findMatchingBrace(css, cursor);
-      return {
-        body: close === -1 ? null : css.slice(cursor + 1, close),
-        end: close === -1 ? cursor : close
-      };
-    }
-    if (character === ";" || character === "}" || character === "@") {
-      return { body: null, end: cursor };
-    }
-  }
-  return { body: null, end: css.length };
-}
-function extractThemeBlocks(css) {
-  const blocks = [];
-  let searchFrom = 0;
-  for (; ; ) {
-    const at = css.indexOf("@theme", searchFrom);
-    if (at === -1) {
-      break;
-    }
-    const preludeStart = themePreludeStart(css, at);
-    if (preludeStart === null) {
-      searchFrom = at + "@theme".length;
-      continue;
-    }
-    const match = readThemeBlock(css, preludeStart);
-    if (match.body !== null) blocks.push(match.body);
-    searchFrom = Math.max(match.end, at + "@theme".length);
-  }
-  return blocks;
-}
-function categorizeProperty(prop) {
-  const categoryMap = [
-    ["color-", "colors"],
-    ["spacing-", "spacings"],
-    // `font-weight-` MUST precede `font-`: startsWith would otherwise route
-    // `font-weight-chunky` into font FAMILIES as token "weight-chunky".
-    ["font-weight-", "fontWeights"],
-    ["font-", "fonts"],
-    // `--text-*` defines font-size utilities (text-huge) in Tailwind v4.
-    ["text-", "textSizes"],
-    ["radius-", "radii"],
-    ["shadow-", "shadows"],
-    ["breakpoint-", "breakpoints"]
-  ];
-  for (const [prefix, category] of categoryMap) {
-    if (prop.startsWith(prefix)) {
-      let token = prop.slice(prefix.length);
-      if (category !== "breakpoints") {
-        token = token.replace(/-\d+$/, "");
-      }
-      if (token) {
-        return { category, token };
-      }
-    }
-  }
-  return null;
-}
-function parseThemeBlocks(cssContent) {
-  const result = {
-    colors: /* @__PURE__ */ new Set(),
-    spacings: /* @__PURE__ */ new Set(),
-    fonts: /* @__PURE__ */ new Set(),
-    textSizes: /* @__PURE__ */ new Set(),
-    fontWeights: /* @__PURE__ */ new Set(),
-    radii: /* @__PURE__ */ new Set(),
-    shadows: /* @__PURE__ */ new Set(),
-    breakpoints: /* @__PURE__ */ new Set()
-  };
-  const stripped = stripLayerWrappers(cssContent);
-  const blocks = extractThemeBlocks(stripped);
-  for (const block of blocks) {
-    for (const name of scanCustomPropertyNames(block)) {
-      const categorized = categorizeProperty(name);
-      if (categorized) {
-        result[categorized.category].add(categorized.token);
-      }
-    }
-  }
-  return {
-    colors: htmlEscape.sortStrings(result.colors),
-    spacings: htmlEscape.sortStrings(result.spacings),
-    fonts: htmlEscape.sortStrings(result.fonts),
-    textSizes: htmlEscape.sortStrings(result.textSizes),
-    fontWeights: htmlEscape.sortStrings(result.fontWeights),
-    radii: htmlEscape.sortStrings(result.radii),
-    shadows: htmlEscape.sortStrings(result.shadows),
-    breakpoints: htmlEscape.sortStrings(result.breakpoints)
-  };
-}
-function mergeThemes(themes) {
-  if (themes.length === 0) {
-    return { ...EMPTY_THEME };
-  }
-  const merged = {
-    colors: /* @__PURE__ */ new Set(),
-    spacings: /* @__PURE__ */ new Set(),
-    fonts: /* @__PURE__ */ new Set(),
-    textSizes: /* @__PURE__ */ new Set(),
-    fontWeights: /* @__PURE__ */ new Set(),
-    radii: /* @__PURE__ */ new Set(),
-    shadows: /* @__PURE__ */ new Set(),
-    breakpoints: /* @__PURE__ */ new Set()
-  };
-  for (const theme of themes) {
-    for (const cat of Object.keys(merged)) {
-      for (const token of theme[cat]) {
-        merged[cat].add(token);
-      }
-    }
-  }
-  return {
-    colors: htmlEscape.sortStrings(merged.colors),
-    spacings: htmlEscape.sortStrings(merged.spacings),
-    fonts: htmlEscape.sortStrings(merged.fonts),
-    textSizes: htmlEscape.sortStrings(merged.textSizes),
-    fontWeights: htmlEscape.sortStrings(merged.fontWeights),
-    radii: htmlEscape.sortStrings(merged.radii),
-    shadows: htmlEscape.sortStrings(merged.shadows),
-    breakpoints: htmlEscape.sortStrings(merged.breakpoints)
-  };
-}
-function hasTokens(theme) {
-  return Object.values(theme).some((arr) => arr.length > 0);
-}
-function readCustomPropertyName(block, dashes) {
-  let end = dashes + 2;
-  if (end >= block.length || !/[a-z]/.test(block[end])) {
-    return null;
-  }
-  end++;
-  while (end < block.length && /[a-z0-9-]/.test(block[end])) {
-    end++;
-  }
-  return { name: block.slice(dashes + 2, end), end };
-}
-function findCustomPropertyDeclarationEnd(block, nameEnd) {
-  let cursor = nameEnd;
-  while (cursor < block.length && /\s/.test(block[cursor])) {
-    cursor++;
-  }
-  if (block[cursor] === ":") {
-    const valueStart = cursor + 1;
-    const semicolon = block.indexOf(";", valueStart);
-    return semicolon > valueStart ? semicolon + 1 : -1;
-  }
-  return block[nameEnd] === ";" ? nameEnd + 1 : -1;
-}
-function scanCustomPropertyNames(block) {
-  const names = [];
-  let i = 0;
-  while (i < block.length) {
-    const dashes = block.indexOf("--", i);
-    if (dashes === -1) {
-      break;
-    }
-    const property = readCustomPropertyName(block, dashes);
-    if (!property) {
-      i = dashes + 1;
-      continue;
-    }
-    const matchEnd = findCustomPropertyDeclarationEnd(block, property.end);
-    if (matchEnd === -1) {
-      i = dashes + 1;
-      continue;
-    }
-    names.push(property.name);
-    i = matchEnd;
-  }
-  return names;
-}
-
 const REGEX_PREFIXES = new Set("([{:,;=!?&|+-*%^~<>/");
 const REGEX_PREFIX_KEYWORDS = /* @__PURE__ */ new Set([
   "await",
@@ -1731,6 +1501,78 @@ function collectAuthoredClassNames(source) {
   return classes;
 }
 
+const KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
+  "include",
+  "exclude",
+  "compileSources",
+  "contentScopeCheck",
+  "quiet",
+  "mode",
+  "development",
+  "production",
+  "build",
+  "hydration"
+]);
+const RENAMED_KEYS = {
+  // Replaced by the path-based form: package NAMES could not express a
+  // sibling directory outside the project root, and resolving them meant
+  // guessing at workspace layout.
+  compilePackages: "compileSources"
+};
+function nearestKnownConfigKey(key) {
+  const lower = key.toLowerCase();
+  let best = null;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const candidate of KNOWN_TOP_LEVEL_KEYS) {
+    const distance = editDistance(lower, candidate.toLowerCase());
+    if (distance < bestDistance) {
+      bestDistance = distance;
+      best = candidate;
+    }
+  }
+  return best !== null && bestDistance <= Math.max(1, Math.floor(key.length / 4)) ? best : null;
+}
+function editDistance(a, b) {
+  let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+  for (let i = 1; i <= a.length; i += 1) {
+    const current = [i];
+    for (let j = 1; j <= b.length; j += 1) {
+      const substitution = previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1);
+      current.push(Math.min(substitution, previous[j] + 1, current[j - 1] + 1));
+    }
+    previous = current;
+  }
+  return previous[b.length];
+}
+function findUnknownConfigKeys(options) {
+  if (options === null || typeof options !== "object" || Array.isArray(options)) {
+    return [];
+  }
+  const unknown = [];
+  for (const key of Object.keys(options)) {
+    if (KNOWN_TOP_LEVEL_KEYS.has(key)) continue;
+    const renamedTo = RENAMED_KEYS[key];
+    if (renamedTo !== void 0) {
+      unknown.push({ key, renamedTo });
+      continue;
+    }
+    const suggestion = nearestKnownConfigKey(key);
+    unknown.push(suggestion === null ? { key } : { key, suggestion });
+  }
+  return unknown;
+}
+function unknownConfigKeysMessage(unknown) {
+  const lines = unknown.map((entry) => {
+    if (entry.renamedTo !== void 0) {
+      return `  - \`${entry.key}\` was replaced by \`${entry.renamedTo}\``;
+    }
+    return entry.suggestion === void 0 ? `  - \`${entry.key}\`` : `  - \`${entry.key}\` \u2014 did you mean \`${entry.suggestion}\`?`;
+  });
+  return `[csszyx] ${unknown.length} plugin option(s) are not recognized and have no effect:
+${lines.join("\n")}
+An unread option is silent, so whatever you configured it for is not happening.`;
+}
+
 const GLOB_MAGIC_RE = /[*?[\]{}]/;
 const DEFAULT_IGNORED_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".next", ".turbo", "dist", "build"]);
 function normalizeFileId(id) {
@@ -1883,17 +1725,19 @@ function injectMangleMapScript(html, mangleMap, options = {}) {
   const {
     prettyPrint = false,
     varMangleMap = {},
-    globalVarAliasPrefix = types.CSSZYX_GLOBAL_ALIAS_PREFIX
+    globalVarAliasPrefix = types.CSSZYX_GLOBAL_ALIAS_PREFIX,
+    installRuntimeObject = true
   } = options;
   const checksumMap = createHydrationMangleMap(mangleMap, varMangleMap);
   const jsonContent = safeJsonForScriptTag(checksumMap, prettyPrint);
-  const classMapContent = safeJsonForScriptTag(mangleMap);
   const varMapContent = safeJsonForScriptTag(varMangleMap);
+  const reuseChecksumPayload = Object.keys(varMangleMap).length === 0;
+  const classMapExpr = reuseChecksumPayload ? '(function(){var e=document.getElementById("__CSSZYX_MANGLE_MAP__");return e?JSON.parse(e.textContent):{}})()' : safeJsonForScriptTag(mangleMap);
   const scriptTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json">${jsonContent}<\/script>`;
   const prefixContent = safeJsonForScriptTag(globalVarAliasPrefix);
-  const debugScript = `<script>(function(){var m=${classMapContent};var vm=${varMapContent};var gp=${prefixContent};var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}var cs=document.documentElement.getAttribute("data-sz-checksum")||"";window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:cs,decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()<\/script>`;
-  const combined = `${scriptTag}
-${debugScript}`;
+  const debugScript = `<script>(function(){var m=${classMapExpr};var vm=${varMapContent};var gp=${prefixContent};var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}var cs=document.documentElement.getAttribute("data-sz-checksum")||"";window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:cs,decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()<\/script>`;
+  const combined = installRuntimeObject ? `${scriptTag}
+${debugScript}` : scriptTag;
   if (html.includes("</head>")) {
     return html.replace("</head>", `${combined}
 </head>`);
@@ -1998,6 +1842,42 @@ function escapeForDoubleQuotedString(value) {
   return htmlEscape.escapeDoubleQuotedString(value);
 }
 
+function createMangleSizeAccount() {
+  return { cssGzBefore: 0, cssGzAfter: 0, channels: /* @__PURE__ */ new Set() };
+}
+function resetMangleSizeAccount(account) {
+  account.cssGzBefore = 0;
+  account.cssGzAfter = 0;
+  account.channels.clear();
+}
+function gzipBytes(text) {
+  if (text.length === 0) return 0;
+  return node_zlib.gzipSync(Buffer.from(text, "utf8")).length;
+}
+function recordCssPair(account, before, after) {
+  if (before === after) {
+    const bytes = gzipBytes(before);
+    account.cssGzBefore += bytes;
+    account.cssGzAfter += bytes;
+    return;
+  }
+  account.cssGzBefore += gzipBytes(before);
+  account.cssGzAfter += gzipBytes(after);
+}
+function computeMangleSizeVerdict(account, mapPayload) {
+  const channels = htmlEscape.sortStrings(account.channels);
+  const mapCost = gzipBytes(mapPayload) * channels.length;
+  const cssSaving = account.cssGzBefore - account.cssGzAfter;
+  return { mapCost, cssSaving, net: mapCost - cssSaving, channels };
+}
+function mangleSizeMessage(verdict) {
+  if (verdict.channels.length === 0) return null;
+  if (verdict.net <= 0) return null;
+  const cssPart = verdict.cssSaving >= 0 ? `the mangled CSS saves ${verdict.cssSaving} B` : `the mangled CSS COSTS ${-verdict.cssSaving} B (short tokens compress worse than the names they replaced)`;
+  const channelPart = verdict.channels.length > 1 ? `${verdict.channels.join(" + ")} (${verdict.channels.length} copies)` : verdict.channels[0];
+  return `[csszyx] production.mangle is making this build BIGGER: +${verdict.net} B gzipped. The runtime mangle map costs ${verdict.mapCost} B via ${channelPart}, while ${cssPart}. Mangling is a name-obfuscation feature; over a compressed response it does not reduce payload, because utility class names compress far better than the map they need. If you enabled it for size, set \`production.mangle: false\`. If you enabled it to hide class names, this is the expected price and you can ignore this. Narrowing \`production.mangleMapDelivery\` removes a map copy when only one channel is needed. (Measured on CSS and the map; class shortening inside JS chunks is not counted, so the real net is slightly better than this figure.)`;
+}
+
 function isParserMode(value) {
   return value === "rust" || value === "oxc" || value === "babel";
 }
@@ -2113,127 +1993,6 @@ function writeThemeDts(opts) {
   fs.writeFileSync(opts.outputPath, content, "utf-8");
 }
 
-const VIRTUAL_MODULE_ID = "virtual:csszyx/mangle-map";
-const RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
-const THEME_GROUPS_VIRTUAL_ID = "virtual:csszyx/theme-groups";
-const RESOLVED_THEME_GROUPS_VIRTUAL_ID = `\0${THEME_GROUPS_VIRTUAL_ID}`;
-const VIRTUAL_CHECKSUM_ID = "virtual:csszyx/checksum";
-const RESOLVED_VIRTUAL_CHECKSUM_ID = `\0${VIRTUAL_CHECKSUM_ID}`;
-function createMangleMapModule(mangleMap, checksum, varMangleMap = {}, cssVarMetrics = null) {
-  return `/**
- * Auto-generated mangle map for csszyx.
- * This module is generated at build time and contains the mapping
- * from original class names and CSS variable names to mangled names.
- *
- * @generated
- */
-
-export const mangleMap = ${JSON.stringify(mangleMap, null, 2)};
-
-export const varMangleMap = ${JSON.stringify(varMangleMap, null, 2)};
-
-export const cssVarMetrics = ${JSON.stringify(cssVarMetrics, null, 2)};
-
-export const checksum = ${JSON.stringify(checksum)};
-
-export default {
-  mangleMap,
-  varMangleMap,
-  cssVarMetrics,
-  checksum,
-};
-`;
-}
-function createChecksumModule(checksum) {
-  return `/**
- * Auto-generated checksum for csszyx mangle map.
- *
- * @generated
- */
-
-export const checksum = ${JSON.stringify(checksum)};
-
-export default checksum;
-`;
-}
-function isVirtualModule(id) {
-  return id === VIRTUAL_MODULE_ID || id === VIRTUAL_CHECKSUM_ID || id === THEME_GROUPS_VIRTUAL_ID || id === MANGLE_RUNTIME_VIRTUAL_ID;
-}
-function resolveVirtualModule(id) {
-  if (id === VIRTUAL_MODULE_ID) {
-    return RESOLVED_VIRTUAL_MODULE_ID;
-  }
-  if (id === VIRTUAL_CHECKSUM_ID) {
-    return RESOLVED_VIRTUAL_CHECKSUM_ID;
-  }
-  if (id === THEME_GROUPS_VIRTUAL_ID) {
-    return RESOLVED_THEME_GROUPS_VIRTUAL_ID;
-  }
-  if (id === MANGLE_RUNTIME_VIRTUAL_ID) {
-    return RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID;
-  }
-  return void 0;
-}
-const MANGLE_RUNTIME_VIRTUAL_ID = "virtual:csszyx/mangle-runtime";
-const RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID = `\0${MANGLE_RUNTIME_VIRTUAL_ID}`;
-const MANGLE_MAP_PLACEHOLDER = "___CSSZYX_MANGLE_MAP___";
-const VAR_MANGLE_MAP_PLACEHOLDER = "___CSSZYX_VAR_MANGLE_MAP___";
-const CHECKSUM_PLACEHOLDER = "___CSSZYX_CHECKSUM___";
-function createMangleRuntimeModule(globalVarAliasPrefix) {
-  return `/**
- * Auto-generated by csszyx: installs the runtime mangle map from the bundle.
- *
- * @generated
- */
-
-const m = ${MANGLE_MAP_PLACEHOLDER};
-const vm = ${VAR_MANGLE_MAP_PLACEHOLDER};
-const gp = ${JSON.stringify(globalVarAliasPrefix)};
-const checksum = "${CHECKSUM_PLACEHOLDER}";
-
-if (typeof window !== 'undefined' && !window.__csszyx) {
-    const r = {};
-    const vr = {};
-    for (const k in m) r[m[k]] = k;
-    for (const vk in vm) {
-        const vv = vm[vk];
-        const vs = Array.isArray(vv) ? vv : [vv];
-        for (const v of vs) (vr[v] || (vr[v] = [])).push(vk);
-    }
-    window.__csszyx = {
-        mangleMap: m,
-        varMangleMap: vm,
-        checksum,
-        decode: (c) => r[c],
-        encode: (c) => m[c],
-        decodeVar: (v) => vr[v] || [],
-        encodeVar: (v) => vm[v],
-        decodeGlobalVar: (v) => {
-            const a = vr[v] || [];
-            return v.indexOf(gp) === 0 ? a[0] : undefined;
-        },
-        decodeAll: (el) => (el.className || '').split(' ').map((c) => r[c] || c),
-    };
-}
-
-export {};
-`;
-}
-function createThemeGroupsModule(tokens) {
-  const payload = JSON.stringify({
-    colors: tokens.colors,
-    textSizes: tokens.textSizes,
-    fontFamilies: tokens.fontFamilies,
-    fontWeights: tokens.fontWeights
-  });
-  return [
-    "// Auto-generated by csszyx from the @theme blocks in scanned CSS.",
-    "import { registerSzcnGroups } from '@csszyx/runtime';",
-    `registerSzcnGroups(${payload});`,
-    "export {};"
-  ].join("\n");
-}
-
 function registerWebpackAssetProcessor(compiler, processAssets) {
   compiler.hooks.compilation.tap("csszyx:post", (compilation) => {
     const stage = compiler.webpack?.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE_SIZE || compilation.constructor.PROCESS_ASSETS_STAGE_OPTIMIZE_SIZE;
@@ -2276,9 +2035,9 @@ let _hasWarnedTransformCacheVersion = false;
 let _hasWarnedNativeFallback = false;
 const _loggedActiveParsers = /* @__PURE__ */ new Set();
 const _babelFallbackFiles = /* @__PURE__ */ new Set();
-const requireFromHere = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.CJcFsJcf.cjs', document.baseURI).href)));
+const requireFromHere = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.Bf4fNbp7.cjs', document.baseURI).href)));
 const PLUGIN_VERSION = findPackageVersionFromFile(
-  node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.CJcFsJcf.cjs', document.baseURI).href))),
+  node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.Bf4fNbp7.cjs', document.baseURI).href))),
   UNKNOWN_PACKAGE_VERSION
 );
 const COMPILER_VERSION = findPackageVersionFromModule("@csszyx/compiler", UNKNOWN_PACKAGE_VERSION);
@@ -2422,15 +2181,28 @@ function shouldWarnUnscopedMonorepo(sawTailwindEntry, tailwindEntryScoped, inMon
 function unscopedMonorepoMessage() {
   return '[csszyx] Tailwind content detection is UNSCOPED in a monorepo. Tailwind v4 climbs to the workspace root and scans sibling packages + docs (.md/.mdx/.txt are not ignored), which can generate phantom or broken url() classes and fail the build. Scope it in your Tailwind CSS entry:\n    @import "tailwindcss" source(none);\n    @source ".";   /* this package, relative to the CSS file */\ncsszyx auto-injects @source for its generated classes, so only your own templates need listing. Guide: https://csszyx.com/docs/monorepo-content-scope/\nSilence (if a broad scan is intentional): csszyx({ contentScopeCheck: false }).';
 }
+function resolveQuietMode(quiet) {
+  if (quiet === true || quiet === "all") return "all";
+  if (quiet === "nudges") return "nudges";
+  return "off";
+}
 function shouldEmitWarning(quiet, devOnly, isProduction) {
-  if (quiet) {
+  const mode = resolveQuietMode(quiet);
+  if (mode === "all") {
     return false;
   }
-  if (devOnly && isProduction) {
+  if (devOnly && (isProduction || mode === "nudges")) {
     return false;
   }
   return true;
 }
+function shouldEmitMissingCssFallback(quiet, message) {
+  return resolveQuietMode(quiet) !== "all" && compiler.szFallbackConsequenceOf(message) === "missing-css";
+}
+function emitMissingCssFallback(quiet, message, id, emit) {
+  if (shouldEmitMissingCssFallback(quiet, message)) emit(`[csszyx] ${id}
+  ${message}`);
+}
 function normalizeForMatch(p) {
   const n = transformCache.normalizePathSeparators(p);
   return n.length > 1 && n.endsWith("/") ? n.slice(0, -1) : n;
@@ -2535,11 +2307,13 @@ function isPackagesSkippedSource(id, sourceDirs = []) {
   }
   return !isCompileSourceOptedIn(p, sourceDirs);
 }
-function skippedSzFilesMessage(files) {
+function skippedSzFilesMessage(files, szvExportFiles = []) {
   const list = files.map((file) => `  - ${file}`).join("\n");
-  return `[csszyx] ${files.length} file(s) under packages/ contain \`sz\` but were skipped by ignore rules:
+  const registryClause = szvExportFiles.length === 0 ? "" : `
+${szvExportFiles.length} of them may export \`szv\` factories, so they stay out of the cross-module registry and every importer falls back to the runtime path.`;
+  return `[csszyx] ${files.length} file(s) under packages/ use csszyx but were skipped by ignore rules:
 ${list}
-Add the package directory to \`compileSources\` (or move the file out of packages/) \u2014 otherwise their \`sz\` produces no CSS.`;
+Add the package directory to \`compileSources\` (or move the file out of packages/) \u2014 otherwise their classes never reach the safelist.` + registryClause;
 }
 function computeSafelistRelPath(rootDir, safelistFilename, cssId) {
   const safelistPath = transformCache.normalizePathSeparators(path__namespace.join(rootDir, safelistFilename));
@@ -2863,12 +2637,12 @@ function runThemeScan(rootDir, scanCss) {
   }
   const themes = sourceFiles.map((f) => {
     try {
-      return parseThemeBlocks(readStableTextFileSnapshotSync(f).source);
+      return themeGroupsFile.parseThemeBlocks(readStableTextFileSnapshotSync(f).source);
     } catch {
       return null;
     }
   }).filter((t) => t !== null);
-  const merged = mergeThemes(themes);
+  const merged = themeGroupsFile.mergeThemes(themes);
   const outputPath = path__namespace.join(rootDir, ".csszyx", "theme.d.ts");
   writeThemeDts({ outputPath, theme: merged, sourceFiles });
   if (!_hasWarnedTsConfig) {
@@ -2936,7 +2710,7 @@ function matchesScriptExtension(id, extensions) {
   return extensions.some((ext) => id.endsWith(ext) || id.includes(`${ext}?`));
 }
 function insertRuntimeImport(code, importStmt) {
-  return runtimeImportScan.insertAfterUseDirective(code, importStmt);
+  return themeGroupsFile.insertAfterUseDirective(code, importStmt);
 }
 function scanClassExpression(source, from) {
   let depth = 0;
@@ -3180,20 +2954,33 @@ ${errors.join("\n")}`
   if (config?.enabled === true) {
     if (!config.tokens || config.tokens.length === 0) {
       throw new Error(
-        "[csszyx] production.mangleGlobalVars.enabled requires explicit tokens in Phase H v1."
+        "[csszyx] production.mangleGlobalVars.enabled requires explicit tokens. Aliasing a property csszyx was not told about would rename references it cannot see."
       );
     }
     if (config.autoPrefix !== void 0 && config.autoPrefix !== "") {
       throw new Error(
-        "[csszyx] production.mangleGlobalVars.autoPrefix requires CSS pre-scan support and is not enabled in Phase H v1."
+        "[csszyx] production.mangleGlobalVars.autoPrefix is not available: choosing tokens by prefix needs a CSS pre-scan that does not exist yet. List the tokens instead."
       );
     }
   }
 }
 function createCsszyxPlugins(options = {}) {
   assertGlobalVarMangleConfig(options);
-  let manglingEnabled = options.production?.mangle !== false;
+  let manglingEnabled = options.production?.mangle === true;
+  const importedStaticSzEnabled = options.build?.importedStaticSz ?? types.DEFAULT_IMPORTED_STATIC_SZ;
+  const szvCrossModuleRegistry = /* @__PURE__ */ new Map();
+  const szObjectProvidersExamined = /* @__PURE__ */ new Set();
+  let specifierAliases = [];
   const mangleReserved = new Set(options.production?.mangleExclude ?? []);
+  const mangleMapDelivery = options.production?.mangleMapDelivery ?? "both";
+  if (!["both", "html", "bundle"].includes(mangleMapDelivery)) {
+    throw new Error(
+      `[csszyx] production.mangleMapDelivery must be 'both', 'html' or 'bundle'; got ${JSON.stringify(mangleMapDelivery)}.`
+    );
+  }
+  const deliverMapInHtml = mangleMapDelivery !== "bundle";
+  const deliverMapInBundle = mangleMapDelivery !== "html";
+  const sizeAccount = createMangleSizeAccount();
   const astBudgetOverride = options.build?.astBudgetLimit;
   const prescanAstBudget = astBudgetOverride ?? 5e5;
   const cacheRequested = (options.build?.cache ?? types.DEFAULT_BUILD_CONFIG.cache) !== false;
@@ -3215,7 +3002,11 @@ function createCsszyxPlugins(options = {}) {
     );
   }
   const compileSources = options.compileSources ?? [];
-  const quiet = options.quiet === true;
+  const quiet = resolveQuietMode(options.quiet);
+  const unknownConfigKeys = findUnknownConfigKeys(options);
+  if (unknownConfigKeys.length > 0) {
+    emitWarning(unknownConfigKeysMessage(unknownConfigKeys));
+  }
   function emitWarning(message, opts = {}) {
     if (shouldEmitWarning(quiet, opts.devOnly ?? false, process.env.NODE_ENV === "production")) {
       console.warn(message);
@@ -3252,6 +3043,7 @@ function createCsszyxPlugins(options = {}) {
   const state = {
     classes: /* @__PURE__ */ new Set(),
     parsedTheme: null,
+    scanCssTheme: null,
     autoThemeCssFiles: [],
     sawTailwindEntry: false,
     sawAnyCss: false,
@@ -3260,6 +3052,7 @@ function createCsszyxPlugins(options = {}) {
     contentScopeWarningEmitted: false,
     spreadWarnings: /* @__PURE__ */ new Set(),
     skippedSzFiles: /* @__PURE__ */ new Set(),
+    skippedSzvExportFiles: /* @__PURE__ */ new Set(),
     skipWarningEmitted: false,
     classesCapped: false,
     ownedClasses: /* @__PURE__ */ new Set(),
@@ -3354,56 +3147,14 @@ function createCsszyxPlugins(options = {}) {
     }
   }
   function runAutoThemeScan(rootDir) {
-    if (options.build?.scanCss) {
-      return;
-    }
     refreshCompileSourceDirs();
-    const cssFiles = [];
-    const walk = (dir) => {
-      let entries;
-      try {
-        entries = fs__namespace.readdirSync(dir, { withFileTypes: true });
-      } catch {
-        return;
-      }
-      for (const entry of entries) {
-        if (entry.isDirectory()) {
-          if (!IGNORE_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
-            walk(path__namespace.join(dir, entry.name));
-          }
-          continue;
-        }
-        if (entry.name.endsWith(".css")) {
-          cssFiles.push(path__namespace.join(dir, entry.name));
-        }
-      }
-    };
-    walk(rootDir);
-    const normRoot = normalizeForMatch(rootDir);
-    for (const sourceDir of compileSourceDirs) {
-      if (sourceDir === normRoot || sourceDir.startsWith(`${normRoot}/`)) {
-        continue;
-      }
-      walk(sourceDir);
-    }
-    const themes = [];
-    const themeFiles = [];
-    for (const file of cssFiles) {
-      let content;
-      try {
-        content = fs__namespace.readFileSync(file, "utf-8");
-      } catch {
-        continue;
-      }
-      if (!content.includes("@theme")) {
-        continue;
-      }
-      themes.push(parseThemeBlocks(content));
-      themeFiles.push(file);
-    }
-    state.autoThemeCssFiles = themeFiles;
-    if (themes.length > 0) {
-      state.parsedTheme = mergeThemes(themes);
+    const discovered = themeGroupsFile.discoverProjectTheme(rootDir, [...compileSourceDirs]);
+    state.autoThemeCssFiles = discovered.files;
+    const sources = [state.scanCssTheme, discovered.theme].filter(
+      (theme) => theme !== null
+    );
+    if (sources.length > 0) {
+      state.parsedTheme = themeGroupsFile.mergeThemes(sources);
     }
   }
   function isHardIgnored(id) {
@@ -3419,6 +3170,18 @@ function createCsszyxPlugins(options = {}) {
   function transformConfiguredSource(source, filename, astBudget) {
     const compilerOptions = createCompilerOptions(astBudget);
     const effectiveFilename = normalizeSourceFilename(filename);
+    const crossModuleStatics = transformCache.resolveCrossModuleStaticsFor(
+      szvCrossModuleRegistry,
+      filename,
+      source,
+      specifierAliases
+    );
+    if (crossModuleStatics.szvConfigs !== void 0) {
+      compilerOptions.crossModuleStatics = crossModuleStatics.szvConfigs;
+    }
+    if (crossModuleStatics.szObjects !== void 0) {
+      compilerOptions.crossModuleSzObjects = crossModuleStatics.szObjects;
+    }
     const cacheRoot = transformCache.resolveTransformCacheDir(state.rootDir, options.build?.cacheDir);
     if (cacheEnabled) {
       evictTransformCacheOnce();
@@ -3530,6 +3293,11 @@ function createCsszyxPlugins(options = {}) {
       mangleVars: compilerOptions.mangleVars,
       mangleVarHoistMaxDepth: compilerOptions.mangleVarHoistMaxDepth,
       globalVarAliases: normalizeGlobalVarAliasesForCache(compilerOptions.globalVarAliases),
+      // The registry entries fed to this file are part of its identity:
+      // module A's config change must miss B's cached transform, or the
+      // cache serves a stale table.
+      crossModuleStatics: compilerOptions.crossModuleStatics === void 0 ? void 0 : JSON.stringify(compilerOptions.crossModuleStatics),
+      crossModuleSzObjects: compilerOptions.crossModuleSzObjects === void 0 ? void 0 : JSON.stringify(compilerOptions.crossModuleSzObjects),
       filename: effectiveFilename,
       source
     };
@@ -3538,19 +3306,35 @@ function createCsszyxPlugins(options = {}) {
     if (parserMode !== "rust" || files.length <= 1) {
       return transformPrescanSourcesIndividually(files);
     }
+    const perFile = [];
+    const batchable = [];
+    for (const file of files) {
+      (hasCrossModuleStatics(file) ? perFile : batchable).push(file);
+    }
+    const individual = transformPrescanSourcesIndividually(perFile);
     const compilerOptions = createCompilerOptions(prescanAstBudget);
     const cacheRoot = transformCache.resolveTransformCacheDir(state.rootDir, options.build?.cacheDir);
     const results = /* @__PURE__ */ new Map();
     if (cacheEnabled) evictTransformCacheOnce();
     compiler.ensureRustTransformAvailable();
-    const misses = collectRustPrescanMisses(files, compilerOptions, cacheRoot, results);
-    if (misses.length === 0) return orderPrescanResults(files, results);
-    try {
-      runRustPrescanBatch(misses, compilerOptions, cacheRoot, results);
-    } catch {
-      runRustPrescanFallback(misses, results);
+    const misses = collectRustPrescanMisses(batchable, compilerOptions, cacheRoot, results);
+    if (misses.length > 0) {
+      try {
+        runRustPrescanBatch(misses, compilerOptions, cacheRoot, results);
+      } catch {
+        runRustPrescanFallback(misses, results);
+      }
     }
-    return orderPrescanResults(files, results);
+    return [...individual, ...orderPrescanResults(batchable, results)];
+  }
+  function hasCrossModuleStatics(file) {
+    const resolved = transformCache.resolveCrossModuleStaticsFor(
+      szvCrossModuleRegistry,
+      file.filePath,
+      file.content,
+      specifierAliases
+    );
+    return resolved.szvConfigs !== void 0 || resolved.szObjects !== void 0;
   }
   function collectRustPrescanMisses(files, compilerOptions, cacheRoot, results) {
     const misses = [];
@@ -3698,7 +3482,7 @@ function createCsszyxPlugins(options = {}) {
     }
   }
   function recordPackagesSkipIfSz(filePath) {
-    if (!isPackagesSkippedSource(filePath, compileSourceDirs)) {
+    if (state.skippedSzFiles.has(filePath) || !isPackagesSkippedSource(filePath, compileSourceDirs)) {
       return;
     }
     let content;
@@ -3707,8 +3491,12 @@ function createCsszyxPlugins(options = {}) {
     } catch {
       return;
     }
-    if (content.includes("sz=") || content.includes("szs=") || content.includes("sz:")) {
-      state.skippedSzFiles.add(filePath);
+    if (!fileMayContainSafelistableSz(content)) {
+      return;
+    }
+    state.skippedSzFiles.add(filePath);
+    if (transformCache.mayExportSzvFactories(content)) {
+      state.skippedSzvExportFiles.add(filePath);
     }
   }
   function processPrescanTransform(filePath, content, result, discoveredClasses, rawDiscoveredClasses) {
@@ -3739,12 +3527,73 @@ function createCsszyxPlugins(options = {}) {
     }
     collectPrescanResult(result, filePath, discoveredClasses, rawDiscoveredClasses);
   }
+  function refreshSzvRegistryEntry(filePath, content) {
+    if (!shouldProcessSource(filePath)) return;
+    if (content === null) {
+      szvCrossModuleRegistry.delete(transformCache.normalizePathSeparators(filePath));
+      return;
+    }
+    transformCache.recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
+    if (importedStaticSzEnabled) {
+      transformCache.recordSzObjectRegistryFile(szvCrossModuleRegistry, filePath, content);
+      szObjectProvidersExamined.add(transformCache.normalizePathSeparators(filePath));
+      recordProvidersDemandedBy(filePath, content);
+    }
+  }
+  function recordProvidersDemandedBy(filePath, content) {
+    if (!fileMayContainSafelistableSz(content)) return;
+    const directory = path__namespace.dirname(filePath);
+    for (const specifier of transformCache.importedSpecifiersIn(content)) {
+      for (const base of transformCache.specifierBases(specifier, directory, specifierAliases)) {
+        const providerPath = transformCache.resolveProviderPathWith(base, transformCache.isReadableProviderFile);
+        if (providerPath === void 0) continue;
+        const key = transformCache.normalizePathSeparators(providerPath);
+        if (!szObjectProvidersExamined.has(key)) {
+          szObjectProvidersExamined.add(key);
+          readAndRecordSzObjectProvider(providerPath);
+        }
+        break;
+      }
+    }
+  }
+  function readAndRecordSzObjectProvider(providerPath) {
+    let content;
+    try {
+      content = fs__namespace.readFileSync(providerPath, "utf-8");
+    } catch {
+      return;
+    }
+    transformCache.recordSzObjectRegistryFile(szvCrossModuleRegistry, providerPath, content);
+  }
+  function recordDemandedSzObjectProviders(seenSourcePaths, demand) {
+    for (const base of demand) {
+      const providerPath = transformCache.resolveProviderPath(seenSourcePaths, base);
+      if (providerPath === void 0) continue;
+      szObjectProvidersExamined.add(transformCache.normalizePathSeparators(providerPath));
+      readAndRecordSzObjectProvider(providerPath);
+    }
+  }
+  function refreshSzvRegistryEntryFromDisk(filePath) {
+    if (!shouldProcessSource(filePath)) return;
+    let content;
+    try {
+      content = fs__namespace.readFileSync(filePath, "utf-8");
+    } catch {
+      refreshSzvRegistryEntry(filePath, null);
+      return;
+    }
+    refreshSzvRegistryEntry(filePath, content);
+  }
   function prescanAndWriteClasses() {
     refreshCompileSourceDirs();
+    szvCrossModuleRegistry.clear();
+    szObjectProvidersExamined.clear();
     const prescanStarted = node_perf_hooks.performance.now();
     const discoveredClasses = /* @__PURE__ */ new Set();
     const rawDiscoveredClasses = /* @__PURE__ */ new Set();
     const prescanSources = [];
+    const seenSourcePaths = /* @__PURE__ */ new Set();
+    const szObjectDemand = /* @__PURE__ */ new Set();
     function collectPrescanSource(filePath) {
       if (!shouldProcessSource(filePath)) {
         recordPackagesSkipIfSz(filePath);
@@ -3757,10 +3606,25 @@ function createCsszyxPlugins(options = {}) {
         return;
       }
       recordAuthoredClasses(content);
+      recordSzvRegistryEntries(filePath, content);
+      seenSourcePaths.add(transformCache.normalizePathSeparators(filePath));
       if (fileMayContainSafelistableSz(content)) {
         prescanSources.push({ filePath, content });
+        recordSzObjectDemand(filePath, content);
       }
     }
+    function recordSzObjectDemand(filePath, content) {
+      if (!importedStaticSzEnabled) return;
+      const directory = path__namespace.dirname(filePath);
+      for (const specifier of transformCache.importedSpecifiersIn(content)) {
+        for (const base of transformCache.specifierBases(specifier, directory, specifierAliases)) {
+          szObjectDemand.add(base);
+        }
+      }
+    }
+    function recordSzvRegistryEntries(filePath, content) {
+      transformCache.recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
+    }
     function scanDir(dir) {
       let entries;
       try {
@@ -3788,6 +3652,7 @@ function createCsszyxPlugins(options = {}) {
       }
       scanDir(sourceDir);
     }
+    recordDemandedSzObjectProviders(seenSourcePaths, szObjectDemand);
     const prescanContentByPath = new Map(
       prescanSources.map((file) => [file.filePath, file.content])
     );
@@ -3957,19 +3822,19 @@ function createCsszyxPlugins(options = {}) {
   }
   function replacePlaceholders(code) {
     let result = code;
-    if (result.includes(CHECKSUM_PLACEHOLDER)) {
-      result = result.split(CHECKSUM_PLACEHOLDER).join(state.checksum);
+    if (result.includes(themeGroupsFile.CHECKSUM_PLACEHOLDER)) {
+      result = result.split(themeGroupsFile.CHECKSUM_PLACEHOLDER).join(state.checksum);
     }
     const isEvalWrapped = result.includes("eval(") && result.includes("sourceURL=webpack");
-    if (result.includes(MANGLE_MAP_PLACEHOLDER)) {
+    if (result.includes(themeGroupsFile.MANGLE_MAP_PLACEHOLDER)) {
       const jsonMap = escapeJsonForInlineScript(JSON.stringify(state.mangleMap));
       const escapedMap = isEvalWrapped ? escapeForDoubleQuotedString(jsonMap) : jsonMap;
-      result = result.split(MANGLE_MAP_PLACEHOLDER).join(escapedMap);
+      result = result.split(themeGroupsFile.MANGLE_MAP_PLACEHOLDER).join(escapedMap);
     }
-    if (result.includes(VAR_MANGLE_MAP_PLACEHOLDER)) {
+    if (result.includes(themeGroupsFile.VAR_MANGLE_MAP_PLACEHOLDER)) {
       const jsonMap = escapeJsonForInlineScript(JSON.stringify(state.varMangleMap));
       const escapedMap = isEvalWrapped ? escapeForDoubleQuotedString(jsonMap) : jsonMap;
-      result = result.split(VAR_MANGLE_MAP_PLACEHOLDER).join(escapedMap);
+      result = result.split(themeGroupsFile.VAR_MANGLE_MAP_PLACEHOLDER).join(escapedMap);
     }
     return result;
   }
@@ -3981,6 +3846,9 @@ function createCsszyxPlugins(options = {}) {
       usesMerge: false,
       usesSzcn: false,
       usesSzPart: false,
+      usesSzvPick: false,
+      usesSzvPick1: false,
+      szPartArgsProvable: true,
       usesColorVar: false,
       usesSpacingVar: false,
       usesUnitVar: false
@@ -4001,16 +3869,20 @@ function createCsszyxPlugins(options = {}) {
       if (message.includes("unresolvable sz spread")) {
         state.spreadWarnings.add(`${id}
   ${message}`);
-      } else if (message.includes("AST budget exceeded")) {
+        continue;
+      }
+      if (message.includes("AST budget exceeded")) {
         console.warn(`[csszyx] ${id}
   ${message}`);
+        continue;
       }
+      emitMissingCssFallback(quiet, message, id, console.warn);
     }
-    if (quiet || result.diagnostics.length === 0 || process.env.NODE_ENV === "production") {
+    if (quiet !== "off" || result.diagnostics.length === 0 || process.env.NODE_ENV === "production") {
       return;
     }
     for (const message of result.diagnostics) {
-      if (message.includes("unresolvable sz spread") || message.includes("AST budget exceeded")) {
+      if (message.includes("unresolvable sz spread") || message.includes("AST budget exceeded") || compiler.szFallbackConsequenceOf(message) === "missing-css") {
         continue;
       }
       warn(`[csszyx] ${id}
@@ -4025,6 +3897,9 @@ function createCsszyxPlugins(options = {}) {
       usesMerge: result.usesMerge,
       usesSzcn: result.usesSzcn,
       usesSzPart: result.usesSzPart,
+      usesSzvPick: result.usesSzvPick,
+      usesSzvPick1: result.usesSzvPick1,
+      szPartArgsProvable: result.szPartArgsProvable,
       usesColorVar: result.usesColorVar,
       usesSpacingVar: result.usesSpacingVar,
       usesUnitVar: result.usesUnitVar,
@@ -4057,9 +3932,9 @@ function createCsszyxPlugins(options = {}) {
     const attrName = options.production?.minify ? "data-sz-cs" : "data-sz-checksum";
     const htmlTag = findOpeningTag(transformedCode, "html");
     if (htmlTag) {
-      transformedCode = `${transformedCode.slice(0, htmlTag.close)} ${attrName}="${CHECKSUM_PLACEHOLDER}"${transformedCode.slice(htmlTag.close)}`;
+      transformedCode = `${transformedCode.slice(0, htmlTag.close)} ${attrName}="${themeGroupsFile.CHECKSUM_PLACEHOLDER}"${transformedCode.slice(htmlTag.close)}`;
     }
-    const debugScript = `<script dangerouslySetInnerHTML={{__html: \`(function(){var m=${MANGLE_MAP_PLACEHOLDER};var vm=${VAR_MANGLE_MAP_PLACEHOLDER};var gp=decodeURIComponent(${escapeJsonForInlineScript(JSON.stringify(encodedGlobalVarAliasPrefix))});var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:"${CHECKSUM_PLACEHOLDER}",decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()\`}} />`;
+    const debugScript = `<script dangerouslySetInnerHTML={{__html: \`(function(){var m=${themeGroupsFile.MANGLE_MAP_PLACEHOLDER};var vm=${themeGroupsFile.VAR_MANGLE_MAP_PLACEHOLDER};var gp=decodeURIComponent(${escapeJsonForInlineScript(JSON.stringify(encodedGlobalVarAliasPrefix))});var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:"${themeGroupsFile.CHECKSUM_PLACEHOLDER}",decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()\`}} />`;
     const bodyTag = findOpeningTag(transformedCode, "body");
     if (bodyTag) {
       transformedCode = `${transformedCode.slice(0, bodyTag.close + 1)}${debugScript}${transformedCode.slice(bodyTag.close + 1)}`;
@@ -4067,37 +3942,59 @@ function createCsszyxPlugins(options = {}) {
     return transformedCode;
   }
   function requiredRuntimeHelpers(output) {
-    const helpers = [];
-    if (output.usesRuntime) helpers.push("_sz");
-    if (output.usesMerge) helpers.push("_szMerge");
-    if (output.usesSzcn) helpers.push("_szcn");
-    if (output.usesSzPart) helpers.push("_szPart");
-    if (output.usesColorVar) helpers.push("__szColorVar");
-    if (output.usesSpacingVar) helpers.push("__szSpacingVar");
-    if (output.usesUnitVar) helpers.push("__szUnitVar");
-    return helpers;
+    return themeGroupsFile.runtimeHelperGroupsFromUsage(output);
   }
   function injectRuntimeHelpers(code, output) {
-    const imports = requiredRuntimeHelpers(output);
-    const hasRuntimeImport = imports.length > 0 && code.includes("@csszyx/runtime");
-    const needed = hasRuntimeImport ? imports.filter((name) => !runtimeImportScan.importsRuntimeHelper(code, name)) : imports;
-    if (needed.length === 0) return null;
-    const existingImport = runtimeImportScan.findRuntimeImportClause(code);
+    const groups = requiredRuntimeHelpers(output);
+    let result = null;
+    let current = code;
+    if (groups.merge.length > 0 && !current.includes("@csszyx/runtime/merge")) {
+      current = insertRuntimeImport(
+        current,
+        `import { ${groups.merge.join(", ")} } from '@csszyx/runtime/merge';
+`
+      );
+      result = current;
+    }
+    const imports = groups.barrel;
+    const hasRuntimeImport = imports.length > 0 && current.includes("@csszyx/runtime");
+    const needed = hasRuntimeImport ? imports.filter((name) => !themeGroupsFile.importsRuntimeHelper(current, name)) : imports;
+    if (needed.length === 0) return result;
+    const existingImport = themeGroupsFile.findRuntimeImportClause(current);
     if (existingImport) {
-      return code.replace(
+      return current.replace(
         existingImport.statement,
         `${existingImport.prefixWithBody}, ${needed.join(", ")} } from '@csszyx/runtime'`
       );
     }
     const importStatement = `import { ${needed.join(", ")} } from '@csszyx/runtime';
 `;
-    return insertRuntimeImport(code, importStatement);
+    return insertRuntimeImport(current, importStatement);
+  }
+  function themeGroupTokens() {
+    const theme = state.parsedTheme;
+    return {
+      colors: theme?.colors ?? [],
+      textSizes: theme?.textSizes ?? [],
+      fontFamilies: theme?.fonts ?? [],
+      fontWeights: theme?.fontWeights ?? []
+    };
   }
   function injectThemeGroups(code, transformedCode, id, usesSzcn) {
-    if (!usesSzcn && !/\bszcn\s*\(/.test(code) || transformedCode.includes(THEME_GROUPS_VIRTUAL_ID) || !shouldProcessSource(id)) {
+    if (!usesSzcn && !/\bszcn\s*\(/.test(code) || transformedCode.includes(themeGroupsFile.THEME_GROUPS_VIRTUAL_ID) || transformedCode.includes(themeGroupsFile.THEME_GROUPS_FILE_MARKER) || !shouldProcessSource(id)) {
       return null;
     }
-    return `import '${THEME_GROUPS_VIRTUAL_ID}';
+    if (activeFramework === "webpack") {
+      const groups = themeGroupsFile.ensureThemeGroupsFile(
+        state.rootDir,
+        path__namespace.join(state.rootDir, ".csszyx")
+      );
+      if (groups.file === null) return null;
+      const [from] = id.split("?");
+      return `import '${themeGroupsFile.themeGroupsSpecifier(from, groups.file)}';
+${transformedCode}`;
+    }
+    return `import '${themeGroupsFile.THEME_GROUPS_VIRTUAL_ID}';
 ${transformedCode}`;
   }
   const MANGLE_RUNTIME_CONSUMER_RE = /from\s*['"](?:csszyx|@csszyx\/runtime)['"]/;
@@ -4106,10 +4003,10 @@ ${transformedCode}`;
     if (activeFramework !== "vite" && activeFramework !== "rollup") {
       return null;
     }
-    if (!manglingEnabled || !shouldProcessSource(id) || !MANGLE_RUNTIME_CONSUMER_RE.test(transformedCode) || transformedCode.includes(MANGLE_RUNTIME_VIRTUAL_ID)) {
+    if (!manglingEnabled || !deliverMapInBundle || !shouldProcessSource(id) || !MANGLE_RUNTIME_CONSUMER_RE.test(transformedCode) || transformedCode.includes(themeGroupsFile.MANGLE_RUNTIME_VIRTUAL_ID)) {
       return null;
     }
-    return insertRuntimeImport(transformedCode, `import '${MANGLE_RUNTIME_VIRTUAL_ID}';
+    return insertRuntimeImport(transformedCode, `import '${themeGroupsFile.MANGLE_RUNTIME_VIRTUAL_ID}';
 `);
   }
   function collectPreTransformClasses(output) {
@@ -4136,8 +4033,8 @@ ${transformedCode}`;
        * @returns resolved ID if virtual, null otherwise
        */
       resolveId(id) {
-        if (isVirtualModule(id)) {
-          return resolveVirtualModule(id);
+        if (themeGroupsFile.isVirtualModule(id)) {
+          return themeGroupsFile.resolveVirtualModule(id);
         }
         return null;
       },
@@ -4154,7 +4051,7 @@ ${transformedCode}`;
        * @returns true only for csszyx virtual modules
        */
       loadInclude(id) {
-        return id === RESOLVED_VIRTUAL_MODULE_ID || id === RESOLVED_VIRTUAL_CHECKSUM_ID || id === RESOLVED_THEME_GROUPS_VIRTUAL_ID || id === RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID;
+        return id === themeGroupsFile.RESOLVED_VIRTUAL_MODULE_ID || id === themeGroupsFile.RESOLVED_VIRTUAL_CHECKSUM_ID || id === themeGroupsFile.RESOLVED_THEME_GROUPS_VIRTUAL_ID || id === themeGroupsFile.RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID;
       },
       /**
        * Loads virtual module content — generates mangle map or checksum module code.
@@ -4162,30 +4059,25 @@ ${transformedCode}`;
        * @returns generated module source if virtual, null otherwise
        */
       load(id) {
-        if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+        if (id === themeGroupsFile.RESOLVED_VIRTUAL_MODULE_ID) {
           finalizeMangleMap();
-          return createMangleMapModule(
+          return themeGroupsFile.createMangleMapModule(
             state.mangleMap,
             state.checksum,
             state.varMangleMap,
             state.cssVarMetrics
           );
         }
-        if (id === RESOLVED_VIRTUAL_CHECKSUM_ID) {
+        if (id === themeGroupsFile.RESOLVED_VIRTUAL_CHECKSUM_ID) {
           finalizeMangleMap();
-          return createChecksumModule(state.checksum);
+          return themeGroupsFile.createChecksumModule(state.checksum);
         }
-        if (id === RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID) {
-          return createMangleRuntimeModule(globalVarAliasPrefix);
+        if (id === themeGroupsFile.RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID) {
+          sizeAccount.channels.add("bundle");
+          return themeGroupsFile.createMangleRuntimeModule(globalVarAliasPrefix);
         }
-        if (id === RESOLVED_THEME_GROUPS_VIRTUAL_ID) {
-          const theme = state.parsedTheme;
-          return createThemeGroupsModule({
-            colors: theme?.colors ?? [],
-            textSizes: theme?.textSizes ?? [],
-            fontFamilies: theme?.fonts ?? [],
-            fontWeights: theme?.fontWeights ?? []
-          });
+        if (id === themeGroupsFile.RESOLVED_THEME_GROUPS_VIRTUAL_ID) {
+          return themeGroupsFile.createThemeGroupsModule(themeGroupTokens());
         }
         return null;
       },
@@ -4199,7 +4091,11 @@ ${transformedCode}`;
         if (shouldProcessCss(id)) {
           return true;
         }
-        return shouldProcessSource(id);
+        if (shouldProcessSource(id)) {
+          return true;
+        }
+        recordPackagesSkipIfSz(id);
+        return false;
       },
       /**
        * Core transform: detects sz prop, compiles to className, injects runtime, collects classes.
@@ -4223,7 +4119,12 @@ ${transformedCode}`;
         if (matchesScriptExtension(id, [".css"])) {
           return transformTailwindCssEntry(code, id);
         }
-        const hasSzProp = code.includes("sz=") || code.includes("szs=") || /\bsz\s*:\s*["'{]/.test(code) || code.includes('sz: "');
+        const hasSzProp = code.includes("sz=") || code.includes("szs=") || /\bsz\s*:\s*["'{]/.test(code) || code.includes('sz: "') || // szr-only modules (no sz attribute) historically skipped the
+        // compiler entirely — which also skipped the szr import
+        // rewrite AND the szr fallback diagnostics. The substring is
+        // deliberately loose; a false positive only costs one file
+        // the compiler pass, which then changes nothing.
+        code.includes("szr(");
         const output = hasSzProp ? transformSzSource(code, id, (message) => this.warn(message)) : unchangedPreTransform(code);
         if (!hasSzProp && shouldProcessSource(id)) {
           recordFileVarMangleEntries(state, id, []);
@@ -4281,9 +4182,13 @@ ${transformedCode}`;
         }
         if (!state.skipWarningEmitted && state.skippedSzFiles.size > 0) {
           state.skipWarningEmitted = true;
-          emitWarning(skippedSzFilesMessage(compiler.sortStrings(state.skippedSzFiles)), {
-            devOnly: true
-          });
+          emitWarning(
+            skippedSzFilesMessage(
+              compiler.sortStrings(state.skippedSzFiles),
+              compiler.sortStrings(state.skippedSzvExportFiles)
+            ),
+            { devOnly: state.skippedSzvExportFiles.size === 0 }
+          );
         }
         if (state.classesCapped) {
           emitWarning(
@@ -4305,7 +4210,10 @@ ${transformedCode}`;
           recordGlobalVarSourceFile(state, id, null);
           recordFileVarMangleEntries(state, id, []);
           recordFileCSSVariableMetrics(state, id, null);
+          refreshSzvRegistryEntry(id, null);
+          return;
         }
+        refreshSzvRegistryEntryFromDisk(id);
       },
       /**
        * Webpack hook: pre-scans source files before compilation for Tailwind class discovery.
@@ -4313,18 +4221,37 @@ ${transformedCode}`;
        */
       webpack(compiler) {
         activeFramework = "webpack";
+        compiler.hooks?.beforeCompile?.tap?.("csszyx:theme-groups", () => {
+          const root = compiler.context || process.cwd();
+          themeGroupsFile.ensureThemeGroupsFile(root, path__namespace.join(root, ".csszyx"));
+        });
         if (compiler.options?.mode === "development") {
           manglingEnabled = false;
         }
+        if (manglingEnabled && mangleMapDelivery !== "both") {
+          console.warn(
+            `[csszyx] production.mangleMapDelivery: '${mangleMapDelivery}' has no effect on the webpack lane \u2014 map delivery only narrows on vite/rollup builds.`
+          );
+        }
         compiler.hooks.beforeCompile.tap("csszyx:prescan", () => {
           announceActiveParser();
           const root = compiler.context || process.cwd();
           state.rootDir = root;
+          specifierAliases = transformCache.collectSpecifierAliases(
+            root,
+            compiler.options?.resolve?.alias
+          );
           evictTransformCacheOnce();
           if (state.classes.size === 0) {
             prescanAndWriteClasses();
           }
-          state.parsedTheme = runThemeScan(root, options.build?.scanCss) ?? state.parsedTheme;
+          for (const changed of compiler.modifiedFiles ?? []) {
+            refreshSzvRegistryEntryFromDisk(changed);
+          }
+          for (const removed of compiler.removedFiles ?? []) {
+            refreshSzvRegistryEntry(removed, null);
+          }
+          state.scanCssTheme = runThemeScan(root, options.build?.scanCss) ?? state.scanCssTheme;
           runAutoThemeScan(root);
         });
         if (options.build?.scanCss) {
@@ -4353,12 +4280,13 @@ ${transformedCode}`;
           announceActiveParser();
           const root = config.root || process.cwd();
           state.rootDir = root;
+          specifierAliases = transformCache.collectSpecifierAliases(root, config.resolve?.alias);
           if (config.command === "serve") {
             manglingEnabled = false;
           }
           evictTransformCacheOnce();
           prescanAndWriteClasses();
-          state.parsedTheme = runThemeScan(root, options.build?.scanCss) ?? state.parsedTheme;
+          state.scanCssTheme = runThemeScan(root, options.build?.scanCss) ?? state.scanCssTheme;
           runAutoThemeScan(root);
         },
         /**
@@ -4371,21 +4299,23 @@ ${transformedCode}`;
           const scanCss = options.build?.scanCss;
           const reloadThemeGroupsModule = () => {
             const themeGroupsModule = ctx.server.moduleGraph.getModuleById(
-              RESOLVED_THEME_GROUPS_VIRTUAL_ID
+              themeGroupsFile.RESOLVED_THEME_GROUPS_VIRTUAL_ID
             );
             if (themeGroupsModule) {
               ctx.server.moduleGraph.invalidateModule(themeGroupsModule);
             }
           };
-          if (scanCss) {
+          if (ctx.file.endsWith(".css")) {
             const root = ctx.server.config.root || process.cwd();
-            if (matchesAnyPattern(ctx.file, scanCss, root)) {
-              state.parsedTheme = runThemeScan(root, scanCss) ?? state.parsedTheme;
-              reloadThemeGroupsModule();
+            const before = themeGroupsFile.createThemeGroupsModule(themeGroupTokens());
+            if (scanCss && matchesAnyPattern(ctx.file, scanCss, root)) {
+              state.scanCssTheme = runThemeScan(root, scanCss) ?? state.scanCssTheme;
             }
-          } else if (ctx.file.endsWith(".css")) {
-            runAutoThemeScan(ctx.server.config.root || process.cwd());
+            runAutoThemeScan(root);
             reloadThemeGroupsModule();
+            if (themeGroupsFile.createThemeGroupsModule(themeGroupTokens()) !== before) {
+              ctx.server.ws.send({ type: "full-reload" });
+            }
           }
           if (!shouldProcessSource(ctx.file)) {
             return;
@@ -4394,8 +4324,10 @@ ${transformedCode}`;
           try {
             fileContent = fs__namespace.readFileSync(ctx.file, "utf-8");
           } catch {
+            refreshSzvRegistryEntry(ctx.file, null);
             return;
           }
+          refreshSzvRegistryEntry(ctx.file, fileContent);
           if (!fileContent.includes("sz=") && !fileContent.includes("szs=") && !/\bsz\s*:\s*["'{]/.test(fileContent)) {
             trackGlobalVarSourceFile(ctx.file, fileContent);
             recordFileVarMangleEntries(state, ctx.file, []);
@@ -4456,8 +4388,12 @@ ${transformedCode}`;
               mode: "script",
               minify: process.env.NODE_ENV === "production",
               varMangleMap: state.varMangleMap,
-              globalVarAliasPrefix
+              globalVarAliasPrefix,
+              installRuntimeObject: deliverMapInHtml
             });
+            if (manglingEnabled) {
+              sizeAccount.channels.add("html");
+            }
             if (state.recoveryTokens.size > 0) {
               const isProduction = process.env.NODE_ENV === "production";
               const { manifest, strippedDevOnlyPaths } = buildRecoveryManifest(
@@ -4506,7 +4442,7 @@ ${transformedCode}`;
     return manifest;
   }
   function rewriteOutputCss(source, file, shouldMangle, mangledSources, externalClasses) {
-    let css = rewriteCssWithValidatedGlobalVarPlan(
+    const css = rewriteCssWithValidatedGlobalVarPlan(
       source,
       file,
       state.globalVarValidationResult
@@ -4519,8 +4455,9 @@ ${transformedCode}`;
       });
       for (const className of result.mangledClasses) mangledSources.add(className);
       for (const className of result.unmangledClasses) externalClasses.add(className);
-      if (result.transformedCount > 0) css = result.css;
-      return css;
+      const mangled = result.transformedCount > 0 ? result.css : css;
+      recordCssPair(sizeAccount, css, mangled);
+      return mangled;
     } catch (error) {
       if (isCssSyntaxError(error)) return css;
       throw error;
@@ -4532,6 +4469,16 @@ ${transformedCode}`;
       collectMangleHybridHazards(state.mangleMap, mangledSources, externalClasses)
     );
     if (message) console.warn(message);
+    reportMangleSize();
+  }
+  function reportMangleSize() {
+    const verdict = computeMangleSizeVerdict(
+      sizeAccount,
+      JSON.stringify(createHydrationMangleMap(state.mangleMap, state.varMangleMap))
+    );
+    const message = mangleSizeMessage(verdict);
+    if (message) console.warn(message);
+    resetMangleSizeAccount(sizeAccount);
   }
   function rewriteWebpackCodeAsset(file, source, shouldMangle, compilation, compiler) {
     if (shouldMangle && file.endsWith(".html")) {
@@ -4615,7 +4562,9 @@ ${transformedCode}`;
       collectRollupGlobalVarCssAssets(bundle)
     );
     const shouldMangle = manglingEnabled && Object.keys(state.mangleMap).length > 0;
-    emitAsset("csszyx-manifest.json", JSON.stringify(createBundleManifest(shouldMangle)));
+    if (options.build?.emitManifest === true) {
+      emitAsset("csszyx-manifest.json", JSON.stringify(createBundleManifest(shouldMangle)));
+    }
     if (shouldEmitGlobalVarMapAsset(globalVarMangleConfig)) {
       const globalVarMap = createGlobalVarMapAssetSource(
         state.varMangleMap,
@@ -4729,6 +4678,7 @@ exports.createRSCModuleRecord = createRSCModuleRecord;
 exports.cssHasContentScope = cssHasContentScope;
 exports.cssImportsTailwind = cssImportsTailwind;
 exports.deleteRSCModuleRecord = deleteRSCModuleRecord;
+exports.emitMissingCssFallback = emitMissingCssFallback;
 exports.esbuildPlugin = esbuildPlugin;
 exports.extractGlobalVarAliasesForManifest = extractGlobalVarAliasesForManifest;
 exports.fileMayContainSafelistableSz = fileMayContainSafelistableSz;
@@ -4736,7 +4686,6 @@ exports.findLocalImportSources = findLocalImportSources;
 exports.findRSCBoundaryViolation = findRSCBoundaryViolation;
 exports.findRSCGraphViolation = findRSCGraphViolation;
 exports.hasInjectableTailwindCandidate = hasInjectableTailwindCandidate;
-exports.hasTokens = hasTokens;
 exports.hasUseClientDirective = hasUseClientDirective;
 exports.hasUseServerDirective = hasUseServerDirective;
 exports.isCompileSourceOptedIn = isCompileSourceOptedIn;
@@ -4748,20 +4697,19 @@ exports.isTailwindReservedGlobalVar = isTailwindReservedGlobalVar;
 exports.mangleCodeClassesSync = mangleCodeClassesSync;
 exports.mangleEligibleClasses = mangleEligibleClasses;
 exports.mangleHybridHazardMessage = mangleHybridHazardMessage;
-exports.mergeThemes = mergeThemes;
 exports.missingTailwindEntryMessage = missingTailwindEntryMessage;
 exports.normalizeGlobalVarAliasesForCache = normalizeGlobalVarAliasesForCache;
-exports.parseThemeBlocks = parseThemeBlocks;
 exports.planGlobalVarAliases = planGlobalVarAliases;
 exports.readGlobalVarScanCache = readGlobalVarScanCache;
 exports.recordGlobalVarSourceFile = recordGlobalVarSourceFile;
 exports.resolveCompileSourceDirs = resolveCompileSourceDirs;
 exports.resolveGlobalVarScanCacheDir = resolveGlobalVarScanCacheDir;
 exports.resolveNativeCacheIdentity = resolveNativeCacheIdentity;
+exports.resolveQuietMode = resolveQuietMode;
 exports.rewriteGlobalVarCssAliases = rewriteGlobalVarCssAliases;
 exports.rollupPlugin = rollupPlugin;
-exports.scanCustomPropertyNames = scanCustomPropertyNames;
 exports.scanGlobalVarCss = scanGlobalVarCss;
+exports.shouldEmitMissingCssFallback = shouldEmitMissingCssFallback;
 exports.shouldEmitWarning = shouldEmitWarning;
 exports.shouldTrackGlobalVarSources = shouldTrackGlobalVarSources;
 exports.shouldWarnMissingTailwindEntry = shouldWarnMissingTailwindEntry;