@csszyx/unplugin 0.13.0 → 0.14.1

package/dist/shared/{unplugin.Bf4fNbp7.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.4du3qMst.cjs');
+const transformCache = require('./unplugin.BKGCkMgM.cjs');
 const cssMangler = require('../css-mangler.cjs');
-const themeGroupsFile = require('./unplugin.X9a9SL_s.cjs');
+const themeGroupsFile = require('./unplugin.CkNQjA4G.cjs');
 const htmlEscape = require('./unplugin.BkRah5Ot.cjs');
 const node_zlib = require('node:zlib');
 const postcss = require('postcss');
@@ -1843,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) {
@@ -1864,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 };
 }
@@ -2034,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.Bf4fNbp7.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.Bf4fNbp7.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);
@@ -2151,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));
@@ -2179,7 +2214,15 @@ 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";
@@ -2315,6 +2358,22 @@ ${szvExportFiles.length} of them may export \`szv\` factories, so they stay out
 ${list}
 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));
   const cssDir = transformCache.normalizePathSeparators(path__namespace.dirname(cssId));
@@ -2390,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)) {
@@ -2972,6 +3045,13 @@ function createCsszyxPlugins(options = {}) {
   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(
@@ -3016,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}`);
     }
@@ -3051,6 +3136,7 @@ function createCsszyxPlugins(options = {}) {
     tailwindEntryScoped: false,
     contentScopeWarningEmitted: false,
     spreadWarnings: /* @__PURE__ */ new Set(),
+    suppressedAdvisories: 0,
     skippedSzFiles: /* @__PURE__ */ new Set(),
     skippedSzvExportFiles: /* @__PURE__ */ new Set(),
     skipWarningEmitted: false,
@@ -3112,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,
@@ -3125,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;
@@ -3150,6 +3255,7 @@ function createCsszyxPlugins(options = {}) {
     refreshCompileSourceDirs();
     const discovered = themeGroupsFile.discoverProjectTheme(rootDir, [...compileSourceDirs]);
     state.autoThemeCssFiles = discovered.files;
+    projectCssFiles = discovered.scanned;
     const sources = [state.scanCssTheme, discovered.theme].filter(
       (theme) => theme !== null
     );
@@ -3231,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 {
@@ -3783,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)
@@ -3851,7 +3953,8 @@ function createCsszyxPlugins(options = {}) {
       szPartArgsProvable: true,
       usesColorVar: false,
       usesSpacingVar: false,
-      usesUnitVar: false
+      usesUnitVar: false,
+      usesBoolClass: false
     };
   }
   function transformTailwindCssEntry(code, id) {
@@ -3878,13 +3981,13 @@ function createCsszyxPlugins(options = {}) {
       }
       emitMissingCssFallback(quiet, message, id, console.warn);
     }
-    if (quiet !== "off" || 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}`);
     }
@@ -3903,6 +4006,7 @@ function createCsszyxPlugins(options = {}) {
       usesColorVar: result.usesColorVar,
       usesSpacingVar: result.usesSpacingVar,
       usesUnitVar: result.usesUnitVar,
+      usesBoolClass: result.usesBoolClass,
       szClasses: result.classes
     };
   }
@@ -4160,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,
@@ -4284,10 +4390,22 @@ ${transformedCode}`;
           if (config.command === "serve") {
             manglingEnabled = false;
           }
+          if (manglingEnabled && config.build?.watch) {
+            manglingEnabled = false;
+            emitWarning(watchModeMangleMessage());
+          }
           evictTransformCacheOnce();
           prescanAndWriteClasses();
           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,
@@ -4441,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,
@@ -4469,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(
@@ -4489,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));
     }
@@ -4538,29 +4670,40 @@ ${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;
     if (options.build?.emitManifest === true) {
       emitAsset("csszyx-manifest.json", JSON.stringify(createBundleManifest(shouldMangle)));
@@ -4573,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);
   }
@@ -4596,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.
      *
@@ -4610,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();
+    }
+  }));
+  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 };
+  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);
@@ -4688,12 +4902,15 @@ exports.findRSCGraphViolation = findRSCGraphViolation;
 exports.hasInjectableTailwindCandidate = hasInjectableTailwindCandidate;
 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;
@@ -4701,6 +4918,7 @@ exports.missingTailwindEntryMessage = missingTailwindEntryMessage;
 exports.normalizeGlobalVarAliasesForCache = normalizeGlobalVarAliasesForCache;
 exports.planGlobalVarAliases = planGlobalVarAliases;
 exports.readGlobalVarScanCache = readGlobalVarScanCache;
+exports.realContentHashDisabledMessage = realContentHashDisabledMessage;
 exports.recordGlobalVarSourceFile = recordGlobalVarSourceFile;
 exports.resolveCompileSourceDirs = resolveCompileSourceDirs;
 exports.resolveGlobalVarScanCacheDir = resolveGlobalVarScanCacheDir;
@@ -4715,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;