@csszyx/unplugin 0.12.0 → 0.14.0

package/dist/shared/{unplugin.BK3XVHe8.cjs → unplugin.ZMa9YE1H.cjs}

@@ -13,9 +13,9 @@ 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.DbZ7tCfN.cjs');
+const transformCache = require('./unplugin.BKGCkMgM.cjs');
 const cssMangler = require('../css-mangler.cjs');
-const nextRuntimeInjection = require('./unplugin.C2lHQFii.cjs');
+const themeGroupsFile = require('./unplugin.CkNQjA4G.cjs');
 const htmlEscape = require('./unplugin.BkRah5Ot.cjs');
 const node_zlib = require('node:zlib');
 const postcss = require('postcss');
@@ -312,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
       });
     }
@@ -1132,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",
@@ -1732,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) {
@@ -2002,11 +1843,13 @@ function escapeForDoubleQuotedString(value) {
 }
 
 function createMangleSizeAccount() {
-  return { cssGzBefore: 0, cssGzAfter: 0, channels: /* @__PURE__ */ new Set() };
+  return { cssGzBefore: 0, cssGzAfter: 0, codeGzBefore: 0, codeGzAfter: 0, channels: /* @__PURE__ */ new Set() };
 }
 function resetMangleSizeAccount(account) {
   account.cssGzBefore = 0;
   account.cssGzAfter = 0;
+  account.codeGzBefore = 0;
+  account.codeGzAfter = 0;
   account.channels.clear();
 }
 function gzipBytes(text) {
@@ -2023,30 +1866,53 @@ function recordCssPair(account, before, after) {
   account.cssGzBefore += gzipBytes(before);
   account.cssGzAfter += gzipBytes(after);
 }
+function recordCodePair(account, before, after) {
+  if (before === after) {
+    const bytes = gzipBytes(before);
+    account.codeGzBefore += bytes;
+    account.codeGzAfter += bytes;
+    return;
+  }
+  account.codeGzBefore += gzipBytes(before);
+  account.codeGzAfter += 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 };
+  const codeSaving = account.codeGzBefore - account.codeGzAfter;
+  return { mapCost, cssSaving, codeSaving, net: mapCost - cssSaving - codeSaving, 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 codePart = verdict.codeSaving >= 0 ? `the shortened classes in code save ${verdict.codeSaving} B` : `the shortened classes in code COST ${-verdict.codeSaving} B`;
   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.)`;
+  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} and ${codePart}. 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.`;
 }
 
 function isParserMode(value) {
-  return value === "rust" || value === "oxc" || value === "babel";
+  return value === "rust" || value === "wasm";
 }
 function resolveParserMode(input) {
   const { configParser, envParser, defaultParser, isRustAvailable } = input;
   const envValid = isParserMode(envParser);
-  const explicit = envValid || configParser != null;
-  const parser = envValid ? envParser : configParser ?? defaultParser;
+  const configValid = isParserMode(configParser);
+  const explicit = envValid || configValid;
+  let parser;
+  if (envValid) {
+    parser = envParser;
+  } else if (configValid) {
+    parser = configParser;
+  } else {
+    parser = defaultParser;
+  }
   if (parser === "rust" && !explicit && !isRustAvailable()) {
-    return { parser: "oxc", degraded: true, explicit: false };
+    if (input.isWasmAvailable()) {
+      return { parser: "wasm", degraded: true, explicit: false };
+    }
+    return { parser: "rust", degraded: false, explicit: false };
   }
   return { parser, degraded: false, explicit };
 }
@@ -2081,41 +1947,6 @@ function isSameFileVersion(before, after) {
   return before.dev === after.dev && before.ino === after.ino && before.size === after.size && before.mtimeNs === after.mtimeNs && before.ctimeNs === after.ctimeNs;
 }
 
-function recordSzvRegistryFile(registry, filePath, content) {
-  const key = transformCache.normalizePathSeparators(filePath);
-  const qualifies = content.includes("szv(") && content.includes("export");
-  const entries = qualifies ? compiler.extractSzvRegistryEntries(content, filePath) : [];
-  if (entries.length === 0) {
-    registry.delete(key);
-    return;
-  }
-  const byName = {};
-  for (const entry of entries) {
-    byName[entry.exportName] = entry.config;
-  }
-  registry.set(key, byName);
-}
-const SPECIFIER_PROBES = ["", ".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx"];
-function resolveCrossModuleStaticsFor(registry, filename, source) {
-  if (registry.size === 0 || !source.includes("from")) return void 0;
-  const directory = path__namespace.dirname(filename);
-  let resolved;
-  for (const match of source.matchAll(/from\s*['"](\.[^'"]*)['"]/g)) {
-    const specifier = match[1];
-    if (resolved?.[specifier] !== void 0) continue;
-    const base = transformCache.normalizePathSeparators(path__namespace.resolve(directory, specifier));
-    for (const probe of SPECIFIER_PROBES) {
-      const entries = registry.get(`${base}${probe}`);
-      if (entries !== void 0) {
-        resolved ??= {};
-        resolved[specifier] = entries;
-        break;
-      }
-    }
-  }
-  return resolved;
-}
-
 function generateThemeDts(opts) {
   const { theme, sourceFiles } = opts;
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
@@ -2187,127 +2018,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;
@@ -2349,10 +2059,9 @@ let _hasWarnedTsConfig = false;
 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.BK3XVHe8.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.ZMa9YE1H.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.BK3XVHe8.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.ZMa9YE1H.cjs', document.baseURI).href))),
   UNKNOWN_PACKAGE_VERSION
 );
 const COMPILER_VERSION = findPackageVersionFromModule("@csszyx/compiler", UNKNOWN_PACKAGE_VERSION);
@@ -2466,9 +2175,20 @@ function mangleHybridHazardMessage(hazards) {
   }
   return parts.join("");
 }
+const TAILWIND_IMPORT_SPECIFIER = /@import\s+["']tailwindcss(?:\/[^"']*)?["']/g;
+const SOURCE_MODIFIER = /\bsource\(/;
+function tailwindImportScopesContent(css) {
+  for (const match of css.matchAll(TAILWIND_IMPORT_SPECIFIER)) {
+    const modifiersStart = match.index + match[0].length;
+    const terminator = css.indexOf(";", modifiersStart);
+    const modifiers = terminator === -1 ? css.slice(modifiersStart) : css.slice(modifiersStart, terminator);
+    if (SOURCE_MODIFIER.test(modifiers)) return true;
+  }
+  return false;
+}
 function cssHasContentScope(code) {
   const s = stripCssBlockComments(code);
-  return /@import\s+["']tailwindcss(?:\/[^"']*)?["']\s+source\(/.test(s) || /@source\s+not\b/.test(s);
+  return tailwindImportScopesContent(s) || /@source\s+not\b/.test(s);
 }
 function isMonorepoPackage(root) {
   let dir = path__namespace.dirname(path__namespace.resolve(root));
@@ -2494,19 +2214,33 @@ function shouldWarnUnscopedMonorepo(sawTailwindEntry, tailwindEntryScoped, inMon
   return sawTailwindEntry && !tailwindEntryScoped && inMonorepo;
 }
 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 }).';
+  return '[csszyx] Tailwind content detection is UNSCOPED in a monorepo. Tailwind v4 scans every file under its detection base \u2014 .md/.mdx/.txt included \u2014 so a doc or fixture holding class-shaped strings becomes CSS, which can generate phantom or broken url() classes and fail the build. That base is as wide as the build makes it: a Vite build roots it at the Vite root, other setups at the workspace root. Scope it in your Tailwind CSS entry:\n    @import "tailwindcss" source(none);\n    @source ".";\nThat @source is your package, relative to the CSS file; csszyx auto-injects one for the classes it generates, 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 isAdvisoryDiagnostic(message) {
+  return !(message.includes("unresolvable sz spread") || message.includes("AST budget exceeded") || compiler.szFallbackConsequenceOf(message) === "missing-css");
+}
+function suppressedAdvisoryMessage(count) {
+  if (count <= 0) return null;
+  const held = count === 1 ? "1 advisory sz fallback" : `${count} advisory sz fallbacks`;
+  return `[csszyx] ${held} not listed above. At an sz prop a fallback is advisory \u2014 the runtime path works and the classes are collected \u2014 so a production build keeps the list short. A development build prints each one with its file and position.`;
+}
+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 !quiet && compiler.szFallbackConsequenceOf(message) === "missing-css";
+  return resolveQuietMode(quiet) !== "all" && compiler.szFallbackConsequenceOf(message) === "missing-css";
 }
 function emitMissingCssFallback(quiet, message, id, emit) {
   if (shouldEmitMissingCssFallback(quiet, message)) emit(`[csszyx] ${id}
@@ -2616,11 +2350,29 @@ 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 lateMangleCensusMessage(lateOwned, lateAuthored) {
+  const sections = [
+    lateOwned.length > 0 ? `csszyx-owned classes: ${lateOwned.join(", ")}` : "",
+    lateAuthored.length > 0 ? `author classes: ${lateAuthored.join(", ")}` : ""
+  ].filter(Boolean);
+  const found = sections.length > 0 ? sections.join("\n") : "the class census changed";
+  return `[csszyx] production.mangle: classes appeared after the mangle map was frozen, so the emitted CSS was hashed against a different map:
+${found}
+The prescan walks the project root and every \`compileSources\` directory. Move the file that owns these classes under one of them, or turn off \`production.mangle\` for this build.`;
+}
+function watchModeMangleMessage() {
+  return "[csszyx] production.mangle is disabled for this watch build. Mangling needs the whole-project prescan that only runs once per process, and a watch rebuild cannot repeat it \u2014 the map would go stale against the files you edit. Run a one-shot build to get mangled output.";
+}
+function realContentHashDisabledMessage() {
+  return "[csszyx] optimization.realContentHash is off while production.mangle is on. csszyx mangles assets after webpack computes their content hashes, and realContentHash is what recomputes those hashes from the final bytes. Without it, two builds that differ only by mangling emit the same filenames with different contents and caches keep serving the old file.";
 }
 function computeSafelistRelPath(rootDir, safelistFilename, cssId) {
   const safelistPath = transformCache.normalizePathSeparators(path__namespace.join(rootDir, safelistFilename));
@@ -2697,6 +2449,20 @@ function collectConfiguredGlobalVarCssSources(rootDir, scanCss) {
     }
   });
 }
+const MANGLEABLE_CSS_ID_RE = /\.(?:css|less|sass|scss|styl|stylus|pcss|postcss|sss)(?:$|\?)/;
+const NON_STYLESHEET_CSS_QUERY_RE = /[?&](?:worker|sharedworker|raw|url)(?:&|=|$)/;
+const COMMONJS_PROXY_RE = /\?commonjs-proxy/;
+function isMangleableCssId(id) {
+  return MANGLEABLE_CSS_ID_RE.test(id) && !NON_STYLESHEET_CSS_QUERY_RE.test(id) && !COMMONJS_PROXY_RE.test(id);
+}
+function dedupeCssAssetsByName(assets) {
+  const seen = /* @__PURE__ */ new Set();
+  return assets.filter((asset) => {
+    if (seen.has(asset.fileName)) return false;
+    seen.add(asset.fileName);
+    return true;
+  });
+}
 function collectWebpackGlobalVarCssAssets(assets) {
   return Object.entries(assets).flatMap(([fileName, asset]) => {
     if (!/\.css(?:$|\?)/.test(fileName)) {
@@ -2944,12 +2710,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) {
@@ -3017,7 +2783,7 @@ function matchesScriptExtension(id, extensions) {
   return extensions.some((ext) => id.endsWith(ext) || id.includes(`${ext}?`));
 }
 function insertRuntimeImport(code, importStmt) {
-  return nextRuntimeInjection.insertAfterUseDirective(code, importStmt);
+  return themeGroupsFile.insertAfterUseDirective(code, importStmt);
 }
 function scanClassExpression(source, from) {
   let depth = 0;
@@ -3261,12 +3027,12 @@ ${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."
       );
     }
   }
@@ -3274,9 +3040,18 @@ ${errors.join("\n")}`
 function createCsszyxPlugins(options = {}) {
   assertGlobalVarMangleConfig(options);
   let manglingEnabled = options.production?.mangle === true;
-  let crossModuleRegistryEnabled = process.env.NODE_ENV !== "development";
+  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 ?? []);
+  let mangleMapFrozen = false;
+  let frozenOwnedClasses = /* @__PURE__ */ new Set();
+  let frozenAuthoredClasses = /* @__PURE__ */ new Set();
+  let cssRewrittenInTransform = false;
+  let projectCssFiles = [];
+  const transformMangledSources = /* @__PURE__ */ new Set();
+  const transformExternalClasses = /* @__PURE__ */ new Set();
   const mangleMapDelivery = options.production?.mangleMapDelivery ?? "both";
   if (!["both", "html", "bundle"].includes(mangleMapDelivery)) {
     throw new Error(
@@ -3307,7 +3082,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);
@@ -3317,22 +3096,27 @@ function createCsszyxPlugins(options = {}) {
     configParser: options.build?.parser,
     envParser: process.env.CSSZYX_PARSER,
     defaultParser: types.DEFAULT_BUILD_CONFIG.parser ?? "rust",
-    isRustAvailable: compiler.isRustTransformAvailable
+    isRustAvailable: compiler.isRustTransformAvailable,
+    isWasmAvailable: compiler.isWasmTransformAvailable
   });
   function announceActiveParser() {
     if (parserDegraded && !_hasWarnedNativeFallback) {
       _hasWarnedNativeFallback = true;
-      console.warn(
-        "[csszyx] No prebuilt native binary (@csszyx/core-*) is available for this platform, so the default `rust` parser fell back to `oxc`. Output classes are identical (parity-tested); only parse speed differs. To use the native engine, install the matching @csszyx/core-<platform> package (or do not omit optional dependencies). Set `build.parser` explicitly to silence this."
-      );
+      if (parserMode === "wasm") {
+        console.warn(
+          "[csszyx] No prebuilt native binary (@csszyx/core-*) is available for this platform, so the default `rust` parser fell back to its wasm build. Same engine, same output; only parse speed differs. To use the native engine, install the matching @csszyx/core-<platform> package (or do not omit optional dependencies). Set `build.parser` explicitly to silence this."
+        );
+      }
     }
     if (!_loggedActiveParsers.has(parserMode)) {
       _loggedActiveParsers.add(parserMode);
       let detail = parserMode;
       if (parserDegraded) {
-        detail = "oxc (degraded from default `rust`: no native binary for this platform)";
+        detail = "wasm (degraded from default `rust`: same engine, wasm build)";
       } else if (parserMode === "rust") {
         detail = "rust (native engine)";
+      } else if (parserMode === "wasm") {
+        detail = "wasm (wasm build of the native engine)";
       }
       console.warn(`[csszyx] active parser: ${detail}`);
     }
@@ -3344,6 +3128,7 @@ function createCsszyxPlugins(options = {}) {
   const state = {
     classes: /* @__PURE__ */ new Set(),
     parsedTheme: null,
+    scanCssTheme: null,
     autoThemeCssFiles: [],
     sawTailwindEntry: false,
     sawAnyCss: false,
@@ -3351,7 +3136,9 @@ function createCsszyxPlugins(options = {}) {
     tailwindEntryScoped: false,
     contentScopeWarningEmitted: false,
     spreadWarnings: /* @__PURE__ */ new Set(),
+    suppressedAdvisories: 0,
     skippedSzFiles: /* @__PURE__ */ new Set(),
+    skippedSzvExportFiles: /* @__PURE__ */ new Set(),
     skipWarningEmitted: false,
     classesCapped: false,
     ownedClasses: /* @__PURE__ */ new Set(),
@@ -3411,7 +3198,7 @@ function createCsszyxPlugins(options = {}) {
     const result = validateGlobalVarAliasInputs(
       createGlobalVarAliasValidationOptions({
         rootDir: state.rootDir,
-        cssAssets: [...configuredCssAssets, ...cssAssets],
+        cssAssets: dedupeCssAssetsByName([...configuredCssAssets, ...cssAssets]),
         sourceFiles: buildGlobalVarSourceFiles(state),
         tokens: globalVarMangleConfig.tokens,
         autoPrefix: globalVarMangleConfig.autoPrefix,
@@ -3424,6 +3211,25 @@ function createCsszyxPlugins(options = {}) {
     assertGlobalVarPlanMatchesEarlyAliases(result, earlyGlobalVarAliasEntries);
     return result;
   }
+  function revalidateFrozenGlobalVarPlan() {
+    if (!cssRewrittenInTransform) return;
+    validateGlobalVarBundleInputs(collectProjectGlobalVarCssSources());
+  }
+  function collectProjectGlobalVarCssSources() {
+    const sources = [];
+    for (const file of compiler.sortStrings(projectCssFiles)) {
+      try {
+        const snapshot = readStableTextFileSnapshotSync(file);
+        sources.push({
+          fileName: file,
+          source: snapshot.source,
+          mtimeMs: snapshot.mtimeMs
+        });
+      } catch {
+      }
+    }
+    return sources;
+  }
   function trackGlobalVarSourceFile(filename, code) {
     if (!globalVarSourceTrackingEnabled) {
       return;
@@ -3446,56 +3252,15 @@ 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;
+    projectCssFiles = discovered.scanned;
+    const sources = [state.scanCssTheme, discovered.theme].filter(
+      (theme) => theme !== null
+    );
+    if (sources.length > 0) {
+      state.parsedTheme = themeGroupsFile.mergeThemes(sources);
     }
   }
   function isHardIgnored(id) {
@@ -3511,13 +3276,17 @@ function createCsszyxPlugins(options = {}) {
   function transformConfiguredSource(source, filename, astBudget) {
     const compilerOptions = createCompilerOptions(astBudget);
     const effectiveFilename = normalizeSourceFilename(filename);
-    const crossModuleStatics = resolveCrossModuleStaticsFor(
+    const crossModuleStatics = transformCache.resolveCrossModuleStaticsFor(
       szvCrossModuleRegistry,
       filename,
-      source
+      source,
+      specifierAliases
     );
-    if (crossModuleStatics !== void 0) {
-      compilerOptions.crossModuleStatics = crossModuleStatics;
+    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) {
@@ -3568,43 +3337,16 @@ function createCsszyxPlugins(options = {}) {
     return handoff.inputSha256 === cacheKey.inputSha256 ? handoff.result : null;
   }
   function runConfiguredParser(source, effectiveFilename, compilerOptions) {
-    if (parserMode === "babel") {
-      return {
-        result: compiler.transformSourceCode(source, effectiveFilename, compilerOptions),
-        cacheable: true
-      };
-    }
     if (parserMode === "rust") {
       return {
         result: compiler.transformRust(source, effectiveFilename, compilerOptions),
         cacheable: true
       };
     }
-    try {
-      return {
-        result: compiler.transformOxc(source, effectiveFilename, compilerOptions),
-        cacheable: true
-      };
-    } catch (error) {
-      return {
-        result: runBabelFallback(source, effectiveFilename, compilerOptions, error),
-        cacheable: false
-      };
-    }
-  }
-  function runBabelFallback(source, effectiveFilename, compilerOptions, error) {
-    const result = compiler.transformSourceCode(source, effectiveFilename, compilerOptions);
-    const reason = transformCache.babelFallbackReason(error);
-    result.diagnostics.push(
-      `[csszyx] oxc parser fell back to Babel for ${effectiveFilename}: ${reason}`
-    );
-    if (!_babelFallbackFiles.has(effectiveFilename)) {
-      _babelFallbackFiles.add(effectiveFilename);
-      console.warn(
-        `[csszyx] oxc parser fell back to Babel for ${effectiveFilename}: ${reason} (${_babelFallbackFiles.size} file(s) so far). Output is still correct; this usually means the file uses a syntax the oxc lane does not yet handle.`
-      );
-    }
-    return result;
+    return {
+      result: compiler.transformWasm(source, effectiveFilename, compilerOptions),
+      cacheable: true
+    };
   }
   function createCompilerOptions(astBudget = astBudgetOverride) {
     return {
@@ -3634,6 +3376,7 @@ function createCsszyxPlugins(options = {}) {
       // 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
     };
@@ -3642,19 +3385,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 = [];
@@ -3802,7 +3561,7 @@ function createCsszyxPlugins(options = {}) {
     }
   }
   function recordPackagesSkipIfSz(filePath) {
-    if (!isPackagesSkippedSource(filePath, compileSourceDirs)) {
+    if (state.skippedSzFiles.has(filePath) || !isPackagesSkippedSource(filePath, compileSourceDirs)) {
       return;
     }
     let content;
@@ -3811,8 +3570,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) {
@@ -3843,13 +3606,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);
@@ -3863,13 +3686,23 @@ function createCsszyxPlugins(options = {}) {
       }
       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) {
-      if (!crossModuleRegistryEnabled) return;
-      recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
+      transformCache.recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
     }
     function scanDir(dir) {
       let entries;
@@ -3898,6 +3731,7 @@ function createCsszyxPlugins(options = {}) {
       }
       scanDir(sourceDir);
     }
+    recordDemandedSzObjectProviders(seenSourcePaths, szObjectDemand);
     const prescanContentByPath = new Map(
       prescanSources.map((file) => [file.filePath, file.content])
     );
@@ -4028,16 +3862,39 @@ function createCsszyxPlugins(options = {}) {
       state.authoredClasses.add(className);
     }
   }
-  function finalizeMangleMap() {
+  function computeMangleMap() {
     const forbiddenTokens = /* @__PURE__ */ new Set([
       ...mangleReserved,
       ...state.authoredClasses,
       ...state.ownedClasses
     ]);
-    state.mangleMap = allocateMangleTokens(
+    return allocateMangleTokens(
       mangleEligibleClasses(state.ownedClasses, state.authoredClasses),
       forbiddenTokens
     );
+  }
+  function freezeMangleMap() {
+    state.mangleMap = computeMangleMap();
+    frozenOwnedClasses = new Set(state.ownedClasses);
+    frozenAuthoredClasses = new Set(state.authoredClasses);
+    mangleMapFrozen = true;
+  }
+  function assertMangleCensusUnchanged() {
+    if (!mangleMapFrozen) return;
+    const current = computeMangleMap();
+    if (JSON.stringify(current) === JSON.stringify(state.mangleMap)) return;
+    const lateOwned = compiler.sortStrings(
+      [...state.ownedClasses].filter((className) => !frozenOwnedClasses.has(className))
+    );
+    const lateAuthored = compiler.sortStrings(
+      [...state.authoredClasses].filter((className) => !frozenAuthoredClasses.has(className))
+    );
+    throw new Error(lateMangleCensusMessage(lateOwned, lateAuthored));
+  }
+  function finalizeMangleMap() {
+    if (!mangleMapFrozen) {
+      state.mangleMap = computeMangleMap();
+    }
     assertVarMangleMapSize(state.varMangleMap, varMangleMapMaxBytes);
     state.checksum = core.compute_mangle_checksum(
       createHydrationMangleMap(state.mangleMap, state.varMangleMap)
@@ -4067,19 +3924,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;
   }
@@ -4096,7 +3953,8 @@ function createCsszyxPlugins(options = {}) {
       szPartArgsProvable: true,
       usesColorVar: false,
       usesSpacingVar: false,
-      usesUnitVar: false
+      usesUnitVar: false,
+      usesBoolClass: false
     };
   }
   function transformTailwindCssEntry(code, id) {
@@ -4123,13 +3981,13 @@ function createCsszyxPlugins(options = {}) {
       }
       emitMissingCssFallback(quiet, message, id, console.warn);
     }
-    if (quiet || result.diagnostics.length === 0 || process.env.NODE_ENV === "production") {
+    const advisories = result.diagnostics.filter(isAdvisoryDiagnostic);
+    if (advisories.length === 0) return;
+    if (quiet !== "off" || process.env.NODE_ENV === "production") {
+      state.suppressedAdvisories += advisories.length;
       return;
     }
-    for (const message of result.diagnostics) {
-      if (message.includes("unresolvable sz spread") || message.includes("AST budget exceeded") || compiler.szFallbackConsequenceOf(message) === "missing-css") {
-        continue;
-      }
+    for (const message of advisories) {
       warn(`[csszyx] ${id}
   ${message}`);
     }
@@ -4148,6 +4006,7 @@ function createCsszyxPlugins(options = {}) {
       usesColorVar: result.usesColorVar,
       usesSpacingVar: result.usesSpacingVar,
       usesUnitVar: result.usesUnitVar,
+      usesBoolClass: result.usesBoolClass,
       szClasses: result.classes
     };
   }
@@ -4177,9 +4036,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)}`;
@@ -4187,7 +4046,7 @@ function createCsszyxPlugins(options = {}) {
     return transformedCode;
   }
   function requiredRuntimeHelpers(output) {
-    return nextRuntimeInjection.runtimeHelperGroupsFromUsage(output);
+    return themeGroupsFile.runtimeHelperGroupsFromUsage(output);
   }
   function injectRuntimeHelpers(code, output) {
     const groups = requiredRuntimeHelpers(output);
@@ -4203,9 +4062,9 @@ function createCsszyxPlugins(options = {}) {
     }
     const imports = groups.barrel;
     const hasRuntimeImport = imports.length > 0 && current.includes("@csszyx/runtime");
-    const needed = hasRuntimeImport ? imports.filter((name) => !nextRuntimeInjection.importsRuntimeHelper(current, name)) : imports;
+    const needed = hasRuntimeImport ? imports.filter((name) => !themeGroupsFile.importsRuntimeHelper(current, name)) : imports;
     if (needed.length === 0) return result;
-    const existingImport = nextRuntimeInjection.findRuntimeImportClause(current);
+    const existingImport = themeGroupsFile.findRuntimeImportClause(current);
     if (existingImport) {
       return current.replace(
         existingImport.statement,
@@ -4216,11 +4075,30 @@ function createCsszyxPlugins(options = {}) {
 `;
     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)['"]/;
@@ -4229,10 +4107,10 @@ ${transformedCode}`;
     if (activeFramework !== "vite" && activeFramework !== "rollup") {
       return null;
     }
-    if (!manglingEnabled || !deliverMapInBundle || !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) {
@@ -4259,8 +4137,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;
       },
@@ -4277,7 +4155,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.
@@ -4285,31 +4163,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) {
+        if (id === themeGroupsFile.RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID) {
           sizeAccount.channels.add("bundle");
-          return createMangleRuntimeModule(globalVarAliasPrefix);
+          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;
       },
@@ -4323,7 +4195,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.
@@ -4388,6 +4264,8 @@ ${transformedCode}`;
       /** Finalizes the mangle map after all source modules have been processed. */
       buildEnd() {
         finalizeMangleMap();
+        assertMangleCensusUnchanged();
+        revalidateFrozenGlobalVarPlan();
         assertNoRSCGraphViolation(state.rscModules);
         if (!state.tailwindWarningEmitted && shouldWarnMissingTailwindEntry(
           state.ownedClasses.size,
@@ -4410,9 +4288,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(
@@ -4434,7 +4316,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.
@@ -4442,12 +4327,13 @@ ${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 (compiler.watchMode === true || compiler.options?.watch === true) {
-          crossModuleRegistryEnabled = 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.`
@@ -4457,11 +4343,21 @@ ${transformedCode}`;
           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) {
@@ -4477,10 +4373,6 @@ ${transformedCode}`;
         /** Records the rollup lane for the mangle-runtime gate. */
         buildStart() {
           activeFramework = "rollup";
-          const meta = this.meta;
-          if (meta?.watchMode) {
-            crossModuleRegistryEnabled = false;
-          }
         }
       },
       vite: {
@@ -4494,17 +4386,26 @@ ${transformedCode}`;
           announceActiveParser();
           const root = config.root || process.cwd();
           state.rootDir = root;
+          specifierAliases = transformCache.collectSpecifierAliases(root, config.resolve?.alias);
           if (config.command === "serve") {
             manglingEnabled = false;
-            crossModuleRegistryEnabled = false;
           }
-          if (config.build?.watch) {
-            crossModuleRegistryEnabled = false;
+          if (manglingEnabled && config.build?.watch) {
+            manglingEnabled = false;
+            emitWarning(watchModeMangleMessage());
           }
           evictTransformCacheOnce();
           prescanAndWriteClasses();
-          state.parsedTheme = runThemeScan(root, options.build?.scanCss) ?? state.parsedTheme;
+          state.scanCssTheme = runThemeScan(root, options.build?.scanCss) ?? state.scanCssTheme;
           runAutoThemeScan(root);
+          if (config.command === "build") {
+            state.globalVarValidationResult = validateGlobalVarBundleInputs(
+              collectProjectGlobalVarCssSources()
+            );
+          }
+          if (manglingEnabled && config.command === "build") {
+            freezeMangleMap();
+          }
         },
         /**
          * Vite HMR hook: re-runs theme scan when a watched CSS file changes,
@@ -4516,21 +4417,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;
@@ -4539,8 +4442,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, []);
@@ -4654,6 +4559,13 @@ ${transformedCode}`;
     }
     return manifest;
   }
+  function rewriteCodeAsset(source, shouldMangle) {
+    if (!shouldMangle) return replacePlaceholders(source);
+    const before = replacePlaceholders(source);
+    const after = replacePlaceholders(mangleCodeClasses(source));
+    recordCodePair(sizeAccount, before, after);
+    return after;
+  }
   function rewriteOutputCss(source, file, shouldMangle, mangledSources, externalClasses) {
     const css = rewriteCssWithValidatedGlobalVarPlan(
       source,
@@ -4682,7 +4594,14 @@ ${transformedCode}`;
       collectMangleHybridHazards(state.mangleMap, mangledSources, externalClasses)
     );
     if (message) console.warn(message);
+  }
+  function reportBuildSummary() {
     reportMangleSize();
+    if (resolveQuietMode(quiet) !== "all") {
+      const message = suppressedAdvisoryMessage(state.suppressedAdvisories);
+      if (message) console.warn(message);
+    }
+    state.suppressedAdvisories = 0;
   }
   function reportMangleSize() {
     const verdict = computeMangleSizeVerdict(
@@ -4702,7 +4621,7 @@ ${transformedCode}`;
       return;
     }
     if (!file.endsWith(".js")) return;
-    const rewritten = shouldMangle ? replacePlaceholders(mangleCodeClasses(source)) : replacePlaceholders(source);
+    const rewritten = rewriteCodeAsset(source, shouldMangle);
     if (rewritten !== source) {
       compilation.updateAsset(file, new compiler.webpack.sources.RawSource(rewritten));
     }
@@ -4751,31 +4670,44 @@ ${transformedCode}`;
       }
     }
     reportOutputMangleHazards(shouldMangle, mangledSources, externalClasses);
+    reportBuildSummary();
   }
   function rewriteViteBundleEntry(chunk, file, shouldMangle, mangledSources, externalClasses) {
-    if (chunk.type === "asset" && chunk.fileName.endsWith(".css") && chunk.source !== void 0) {
-      const originalCss = chunk.source.toString();
-      const css = rewriteOutputCss(
-        originalCss,
-        file,
-        shouldMangle,
-        mangledSources,
-        externalClasses
-      );
-      if (css !== originalCss) chunk.source = css;
+    if (chunk.type !== "asset" || !chunk.fileName.endsWith(".css") || chunk.source === void 0) {
       return;
     }
-    if (chunk.type !== "chunk" || chunk.code === void 0) return;
-    const rewritten = shouldMangle ? replacePlaceholders(mangleCodeClasses(chunk.code)) : replacePlaceholders(chunk.code);
-    if (rewritten !== chunk.code) chunk.code = rewritten;
+    const originalCss = chunk.source.toString();
+    const css = rewriteOutputCss(
+      originalCss,
+      file,
+      shouldMangle,
+      mangledSources,
+      externalClasses
+    );
+    if (css !== originalCss) chunk.source = css;
+  }
+  function mangleCssModule(code, id) {
+    const shouldMangle = manglingEnabled && mangleMapFrozen && Object.keys(state.mangleMap).length > 0;
+    const css = rewriteOutputCss(
+      code,
+      id,
+      shouldMangle,
+      transformMangledSources,
+      transformExternalClasses
+    );
+    return css === code ? null : { code: css, map: null };
   }
   function processRollupBundle(bundle, emitAsset) {
     finalizeMangleMap();
-    state.globalVarValidationResult = validateGlobalVarBundleInputs(
-      collectRollupGlobalVarCssAssets(bundle)
-    );
+    if (!cssRewrittenInTransform) {
+      state.globalVarValidationResult = validateGlobalVarBundleInputs(
+        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,
@@ -4784,16 +4716,18 @@ ${transformedCode}`;
       );
       if (globalVarMap) emitAsset(".csszyx/global-var-map.json", globalVarMap);
     }
-    const mangledSources = /* @__PURE__ */ new Set();
-    const externalClasses = /* @__PURE__ */ new Set();
-    for (const file in bundle) {
-      rewriteViteBundleEntry(
-        bundle[file],
-        file,
-        shouldMangle,
-        mangledSources,
-        externalClasses
-      );
+    const mangledSources = new Set(transformMangledSources);
+    const externalClasses = new Set(transformExternalClasses);
+    if (!cssRewrittenInTransform) {
+      for (const file in bundle) {
+        rewriteViteBundleEntry(
+          bundle[file],
+          file,
+          shouldMangle,
+          mangledSources,
+          externalClasses
+        );
+      }
     }
     reportOutputMangleHazards(shouldMangle, mangledSources, externalClasses);
   }
@@ -4807,8 +4741,38 @@ ${transformedCode}`;
      * @param compiler - the Webpack compiler instance
      */
     webpack(compiler) {
+      if (manglingEnabled && compiler.options?.optimization?.realContentHash === false) {
+        emitWarning(realContentHashDisabledMessage());
+      }
       registerWebpackAssetProcessor(compiler, processWebpackAssets);
     },
+    /**
+     * Settle the map once, before the first chunk is rendered.
+     *
+     * `renderChunk` is where the class rewrite has to happen, and Rollup
+     * offers no ordering guarantee among chunks — so the map is completed
+     * here rather than from whichever chunk arrives first.
+     */
+    renderStart() {
+      finalizeMangleMap();
+    },
+    /**
+     * Rewrite a JS chunk while its bytes still decide its filename hash.
+     *
+     * Rollup renders every chunk, hashes the result, substitutes the
+     * filename placeholders and only then calls `generateBundle` — so the
+     * rewrite this used to do there produced a file whose name described
+     * the un-mangled bytes. The map is complete by `buildEnd`, which is
+     * before the render phase, so nothing forces the later hook.
+     *
+     * @param code Rendered chunk source.
+     * @returns Rewritten chunk, or null when nothing changed.
+     */
+    renderChunk(code) {
+      const shouldMangle = manglingEnabled && Object.keys(state.mangleMap).length > 0;
+      const rewritten = rewriteCodeAsset(code, shouldMangle);
+      return rewritten === code ? null : { code: rewritten, map: null };
+    },
     /**
      * Rollup-compatible hook used by both pure Rollup and Vite adapters.
      *
@@ -4821,15 +4785,54 @@ ${transformedCode}`;
       processRollupBundle(bundle, (fileName, source) => {
         this.emitFile({ type: "asset", fileName, source });
       });
+    },
+    /**
+     * Report what mangling cost, after the bundler has printed its assets.
+     *
+     * Vite's reporter prints the asset table from `writeBundle`, which runs
+     * before this hook — so the size verdict lands where a reader is
+     * already looking at sizes, instead of scrolling past mid-build among
+     * the other diagnostics.
+     */
+    closeBundle() {
+      reportBuildSummary();
     }
   }));
-  return { prePlugin, postPlugin };
+  const cssPlugin = unplugin$1.createUnplugin(() => ({
+    name: "csszyx:css-mangle",
+    transformInclude(id) {
+      return cssRewrittenInTransform && isMangleableCssId(id);
+    },
+    transform(code, id) {
+      return mangleCssModule(code, id);
+    },
+    vite: {
+      /**
+       * Claim the CSS rewrite for the transform phase on this lane.
+       *
+       * A dev server never reaches an output hook, and mangling is off
+       * there anyway; claiming it only for `build` keeps `vite serve`
+       * exactly as it was.
+       *
+       * @param config - the resolved Vite configuration object
+       * @param config.command - `'build'` or `'serve'`
+       */
+      configResolved(config) {
+        cssRewrittenInTransform = config.command === "build";
+      }
+    }
+  }));
+  return { prePlugin, postPlugin, cssPlugin };
 }
 const defaultInstance = createCsszyxPlugins();
 const unplugin = defaultInstance.prePlugin;
 const vitePlugin = (options = {}) => {
-  const { prePlugin, postPlugin } = createCsszyxPlugins(options);
-  return [prePlugin.vite(options), postPlugin.vite(options)];
+  const { prePlugin, postPlugin, cssPlugin } = createCsszyxPlugins(options);
+  return [
+    prePlugin.vite(options),
+    cssPlugin.vite(options),
+    postPlugin.vite(options)
+  ];
 };
 const webpackPlugin = (options = {}) => {
   const { prePlugin, postPlugin } = createCsszyxPlugins(options);
@@ -4897,31 +4900,32 @@ exports.findLocalImportSources = findLocalImportSources;
 exports.findRSCBoundaryViolation = findRSCBoundaryViolation;
 exports.findRSCGraphViolation = findRSCGraphViolation;
 exports.hasInjectableTailwindCandidate = hasInjectableTailwindCandidate;
-exports.hasTokens = hasTokens;
 exports.hasUseClientDirective = hasUseClientDirective;
 exports.hasUseServerDirective = hasUseServerDirective;
+exports.isAdvisoryDiagnostic = isAdvisoryDiagnostic;
 exports.isCompileSourceOptedIn = isCompileSourceOptedIn;
 exports.isHardIgnoredPath = isHardIgnoredPath;
+exports.isMangleableCssId = isMangleableCssId;
 exports.isMonorepoPackage = isMonorepoPackage;
 exports.isPackagesSkippedSource = isPackagesSkippedSource;
 exports.isRSCServerModule = isRSCServerModule;
 exports.isTailwindReservedGlobalVar = isTailwindReservedGlobalVar;
+exports.lateMangleCensusMessage = lateMangleCensusMessage;
 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.realContentHashDisabledMessage = realContentHashDisabledMessage;
 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;
@@ -4929,9 +4933,11 @@ exports.shouldTrackGlobalVarSources = shouldTrackGlobalVarSources;
 exports.shouldWarnMissingTailwindEntry = shouldWarnMissingTailwindEntry;
 exports.shouldWarnUnscopedMonorepo = shouldWarnUnscopedMonorepo;
 exports.skippedSzFilesMessage = skippedSzFilesMessage;
+exports.suppressedAdvisoryMessage = suppressedAdvisoryMessage;
 exports.unplugin = unplugin;
 exports.unscopedMonorepoMessage = unscopedMonorepoMessage;
 exports.validateGlobalVarAliasInputs = validateGlobalVarAliasInputs;
 exports.vitePlugin = vitePlugin;
+exports.watchModeMangleMessage = watchModeMangleMessage;
 exports.webpackPlugin = webpackPlugin;
 exports.writeGlobalVarScanCache = writeGlobalVarScanCache;