@csszyx/unplugin 0.14.4 → 0.15.0

package/dist/shared/{unplugin.BnRf0Tvd.mjs → unplugin.BGufkSFT.mjs}

@@ -1,9 +1,9 @@
 import { createHash } from 'node:crypto';
 import * as fs from 'node:fs';
-import { mkdirSync, writeFileSync } from 'node:fs';
+import fs__default, { mkdirSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import * as path from 'node:path';
-import { dirname } from 'node:path';
+import path__default, { dirname } from 'node:path';
 import { performance } from 'node:perf_hooks';
 import { fileURLToPath } from 'node:url';
 import { scanGlobalVarUsages, sortStrings as sortStrings$1, szFallbackConsequenceOf, isWasmTransformAvailable, isRustTransformAvailable, ensureRustTransformAvailable, transformRust, transformWasm, ASTBudgetExceededError, transformRustBatch, transform } from '@csszyx/compiler';
@@ -13,10 +13,10 @@ import { preprocess as preprocess$1 } from '@csszyx/svelte-adapter';
 import { isTailwindReservedCustomProperty, CSSZYX_GLOBAL_ALIAS_PREFIX, isCsszyxGlobalAliasCustomProperty, DEFAULT_IMPORTED_STATIC_SZ, DEFAULT_BUILD_CONFIG, validateGlobalVarMangleConfig } from '@csszyx/types';
 import { preprocess } from '@csszyx/vue-adapter';
 import { createUnplugin } from 'unplugin';
-import { n as normalizePathSeparators, c as collectSpecifierAliases, h as recordSzvRegistryFile, j as recordCrossModuleForwards, k as recordSzObjectRegistryFile, l as resolveCrossModuleStaticsFor, r as resolveTransformCacheDir, e as createTransformCacheKey, w as writeTransformCache, m as evictOldTransformCacheEntries, o as mayExportSzvFactories, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, g as readTransformCache, p as evictMemoryCacheToBudget, q as resolveProviderPath, d as isReadableProviderFile } from './unplugin.NlPvn5P4.mjs';
+import { c as collectSpecifierAliases, r as resolveTransformCacheDir, h as evictOldTransformCacheEntries, j as recordSzvRegistryFile, k as recordCrossModuleForwards, l as recordSzObjectRegistryFile, m as mayExportSzvFactories, n as resolveCrossModuleStaticsFor, e as createTransformCacheKey, w as writeTransformCache, o as resolveProviderPath, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, g as readTransformCache, p as evictMemoryCacheToBudget, d as isReadableProviderFile } from './unplugin.AGR7mihU.mjs';
 import { mangleCSSSync } from '../css-mangler.mjs';
-import { c as createThemeGroupsModule, e as ensureThemeGroupsFile, R as RESOLVED_VIRTUAL_MODULE_ID, d as createMangleMapModule, f as RESOLVED_VIRTUAL_CHECKSUM_ID, g as createChecksumModule, j as RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID, k as createMangleRuntimeModule, l as RESOLVED_THEME_GROUPS_VIRTUAL_ID, n as isVirtualModule, r as resolveVirtualModule, p as parseThemeBlocks, m as mergeThemes, o as discoverProjectTheme, C as CHECKSUM_PLACEHOLDER, M as MANGLE_MAP_PLACEHOLDER, V as VAR_MANGLE_MAP_PLACEHOLDER, q as importsRuntimeHelper, u as findRuntimeImportClause, T as THEME_GROUPS_VIRTUAL_ID, v as THEME_GROUPS_FILE_MARKER, t as themeGroupsSpecifier, w as MANGLE_RUNTIME_VIRTUAL_ID, a as parseUtilityBlocks, x as runtimeHelperGroupsFromUsage, b as insertAfterUseDirective } from './unplugin.BZPdvVcj.mjs';
-import { s as sortStrings, a as replaceEveryLiteral, u as unicodeEscape, b as escapeDoubleQuotedString, c as escapeSingleQuotedString, e as escapeHtmlAttribute, r as renderTailwindScannerCandidates } from './unplugin.B3XoSRB8.mjs';
+import { c as createMangleRuntimeModule, M as MANGLE_RUNTIME_VIRTUAL_ID, d as createThemeGroupsModule, e as ensureThemeGroupsFile, R as RESOLVED_VIRTUAL_MODULE_ID, f as createMangleMapModule, g as RESOLVED_VIRTUAL_CHECKSUM_ID, j as createChecksumModule, k as RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID, l as RESOLVED_THEME_GROUPS_VIRTUAL_ID, n as isVirtualModule, r as resolveVirtualModule, p as parseThemeBlocks, m as mergeThemes, o as discoverProjectTheme, C as CHECKSUM_PLACEHOLDER, q as CENSUS_PLACEHOLDER, u as importsRuntimeHelper, v as findRuntimeImportClause, T as THEME_GROUPS_VIRTUAL_ID, w as THEME_GROUPS_FILE_MARKER, t as themeGroupsSpecifier, a as parseUtilityBlocks, x as runtimeHelperGroupsFromUsage, b as insertAfterUseDirective, y as MANGLE_MAP_PLACEHOLDER, V as VAR_MANGLE_MAP_PLACEHOLDER } from './unplugin.BourSpnZ.mjs';
+import { s as sortStrings, n as normalizePathSeparators, g as stripCssBlockComments, S as SAFELIST_FILE, h as findLegacySourceDirective, l as legacySourceMessage, b as cssImportsTailwind, c as computeSafelistRelPath, a as appendTailwindSourceDirective, r as renderSafelistFile, d as removeLegacySafelists } from './unplugin.CqJS0BbD.mjs';
 import { gzipSync } from 'node:zlib';
 import postcss from 'postcss';
 import valueParser from 'postcss-value-parser';
@@ -1710,6 +1710,24 @@ function expandFilePatterns(rootDir, patterns) {
   return sortStrings(files);
 }
 
+const BACKSLASH = String.fromCodePoint(92);
+function unicodeEscape(hexadecimal) {
+  return `${BACKSLASH}u${hexadecimal}`;
+}
+function replaceEveryLiteral(value, search, replacement) {
+  return value.replaceAll(search, () => replacement);
+}
+function escapeSingleQuotedString(value) {
+  let escaped = replaceEveryLiteral(value, BACKSLASH, BACKSLASH.repeat(2));
+  escaped = replaceEveryLiteral(escaped, "'", `${BACKSLASH}'`);
+  escaped = replaceEveryLiteral(escaped, "\r", `${BACKSLASH}r`);
+  return replaceEveryLiteral(escaped, "\n", `${BACKSLASH}n`);
+}
+function escapeDoubleQuotedString(value) {
+  const escaped = replaceEveryLiteral(value, BACKSLASH, BACKSLASH.repeat(2));
+  return replaceEveryLiteral(escaped, '"', `${BACKSLASH}"`);
+}
+
 const LINE_SEPARATOR$1 = String.fromCodePoint(8232);
 const PARAGRAPH_SEPARATOR$1 = String.fromCodePoint(8233);
 function safeJsonForScriptTag(value, prettyPrint = false) {
@@ -1744,31 +1762,22 @@ function injectChecksum(html, checksum, minify = false) {
   const attrName = minify ? "data-sz-cs" : "data-sz-checksum";
   return injectHtmlOpeningAttr(html, ` ${attrName}="${checksum}"`);
 }
-function injectMangleMapScript(html, mangleMap, options = {}) {
-  const {
-    prettyPrint = false,
-    varMangleMap = {},
-    globalVarAliasPrefix = CSSZYX_GLOBAL_ALIAS_PREFIX,
-    installRuntimeObject = true
-  } = options;
-  const checksumMap = createHydrationMangleMap(mangleMap, varMangleMap);
-  const jsonContent = safeJsonForScriptTag(checksumMap, prettyPrint);
-  const varMapContent = safeJsonForScriptTag(varMangleMap);
-  const reuseChecksumPayload = Object.keys(varMangleMap).length === 0;
-  const classMapExpr = reuseChecksumPayload ? '(function(){var e=document.getElementById("__CSSZYX_MANGLE_MAP__");return e?JSON.parse(e.textContent):{}})()' : safeJsonForScriptTag(mangleMap);
-  const scriptTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json">${jsonContent}<\/script>`;
-  const prefixContent = safeJsonForScriptTag(globalVarAliasPrefix);
-  const debugScript = `<script>(function(){var m=${classMapExpr};var vm=${varMapContent};var gp=${prefixContent};var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}var cs=document.documentElement.getAttribute("data-sz-checksum")||"";window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:cs,decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()<\/script>`;
-  const combined = installRuntimeObject ? `${scriptTag}
-${debugScript}` : scriptTag;
+function withScriptTag(html, scriptTag) {
   if (html.includes("</head>")) {
-    return html.replace("</head>", `${combined}
+    return html.replace("</head>", `${scriptTag}
 </head>`);
-  } else if (html.includes("</html>")) {
-    return html.replace("</html>", `${combined}
+  }
+  if (html.includes("</html>")) {
+    return html.replace("</html>", `${scriptTag}
 </html>`);
   }
-  return html + combined;
+  return html + scriptTag;
+}
+function injectMangleMapScript(html, mangleMap, options = {}) {
+  const { prettyPrint = false, varMangleMap = {} } = options;
+  const checksumMap = createHydrationMangleMap(mangleMap, varMangleMap);
+  const scriptTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json">${safeJsonForScriptTag(checksumMap, prettyPrint)}<\/script>`;
+  return withScriptTag(html, scriptTag);
 }
 function injectMangleMapAttribute(html, mangleMap, minify = false, varMangleMap = {}) {
   const attrName = minify ? "data-sz-m" : "data-sz-map";
@@ -1842,14 +1851,7 @@ function injectRecoveryManifest(html, manifest) {
   }
   const json = JSON.stringify(manifest);
   const scriptTag = `<script id="__SZ_RECOVERY_MANIFEST__" type="application/json">${json}<\/script>`;
-  if (html.includes("</head>")) {
-    return html.replace("</head>", `${scriptTag}
-</head>`);
-  } else if (html.includes("</html>")) {
-    return html.replace("</html>", `${scriptTag}
-</html>`);
-  }
-  return html + scriptTag;
+  return withScriptTag(html, scriptTag);
 }
 
 const LINE_SEPARATOR = String.fromCodePoint(8232);
@@ -1861,10 +1863,87 @@ function escapeJsonForInlineScript(json) {
   escaped = replaceEveryLiteral(escaped, LINE_SEPARATOR, unicodeEscape("2028"));
   return replaceEveryLiteral(escaped, PARAGRAPH_SEPARATOR, unicodeEscape("2029"));
 }
+function escapeJsonForStringLiteral(json) {
+  let escaped = replaceEveryLiteral(json, "\\", unicodeEscape("005c"));
+  for (const [character, code] of [
+    ['"', "0022"],
+    ["'", "0027"],
+    ["`", "0060"],
+    ["$", "0024"],
+    ["<", "003c"],
+    [">", "003e"],
+    [LINE_SEPARATOR, "2028"],
+    [PARAGRAPH_SEPARATOR, "2029"]
+  ]) {
+    escaped = replaceEveryLiteral(escaped, character, unicodeEscape(code));
+  }
+  return escaped;
+}
 function escapeForDoubleQuotedString(value) {
   return escapeDoubleQuotedString(value);
 }
 
+function createLazyAggregate(build, initial) {
+  const entries = /* @__PURE__ */ new Map();
+  let current = initial;
+  let dirty = false;
+  return {
+    entries,
+    set(key, entry) {
+      entries.set(key, entry);
+      dirty = true;
+    },
+    delete(key) {
+      if (entries.delete(key)) dirty = true;
+    },
+    get() {
+      if (dirty) {
+        current = build(entries);
+        dirty = false;
+      }
+      return current;
+    }
+  };
+}
+
+function needsRuntimeMangleRegistration(manglingEnabled, mangleMap) {
+  if (!manglingEnabled) return false;
+  return Object.keys(mangleMap).length > 0;
+}
+function removedMangleMapDeliveryMessage() {
+  return "[csszyx] production.mangleMapDelivery has been removed and is ignored. The runtime mangle map is always registered from inside the JS bundle now, on every lane, so the built HTML never carries an executable inline <script> and a strict script-src 'self' policy needs no exception. Delete the option. (`window.__csszyx` is now opt-in through `production.mangleDebugGlobal`.)";
+}
+
+const MANGLE_RUNTIME_FILE = "mangle-runtime.mjs";
+function ensureMangleRuntimeFile(outputDir, globalVarAliasPrefix, exposeDebugGlobal) {
+  const target = path__default.join(outputDir, MANGLE_RUNTIME_FILE);
+  const staging = `${target}.${process.pid}.tmp`;
+  try {
+    fs__default.mkdirSync(outputDir, { recursive: true });
+    fs__default.writeFileSync(
+      staging,
+      createMangleRuntimeModule(globalVarAliasPrefix, exposeDebugGlobal),
+      "utf8"
+    );
+    fs__default.renameSync(staging, target);
+    return target;
+  } catch {
+    try {
+      fs__default.rmSync(staging, { force: true });
+    } catch {
+    }
+    return null;
+  }
+}
+function applyMangleRuntimeEntry(compiler, context, file, onRegistered) {
+  const EntryPlugin = compiler.webpack?.EntryPlugin;
+  if (EntryPlugin === void 0) {
+    return;
+  }
+  new EntryPlugin(context, file, { name: void 0 }).apply(compiler);
+  onRegistered();
+}
+
 function createMangleSizeAccount() {
   return { cssGzBefore: 0, cssGzAfter: 0, codeGzBefore: 0, codeGzAfter: 0, channels: /* @__PURE__ */ new Set() };
 }
@@ -1912,7 +1991,7 @@ function mangleSizeMessage(verdict) {
   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} 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.`;
+  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. Two copies is not a misconfiguration: the bundle carries the map the runtime reads, and the HTML carries the same census for the hydration checksum.`;
 }
 
 function isParserMode(value) {
@@ -2113,41 +2192,6 @@ function resolveNativeCacheIdentity() {
 }
 const BENCH_TRACE_ENABLED = process.env.CSSZYX_BENCH_TRACE === "1";
 const BENCH_TRACE_FILE = process.env.CSSZYX_BENCH_TRACE_FILE;
-function appendTailwindSourceDirective(code, relPath) {
-  const directive = `@source "${relPath}";`;
-  if (code.includes(directive)) {
-    return null;
-  }
-  const separator = code.length === 0 || code.endsWith("\n") ? "" : "\n";
-  return `${code}${separator}${directive}
-`;
-}
-function stripCssBlockComments(code) {
-  const SLASH = 47;
-  const STAR = 42;
-  let out = "";
-  let last = 0;
-  let i = 0;
-  const n = code.length;
-  while (i < n) {
-    if (code.codePointAt(i) === SLASH && code.codePointAt(i + 1) === STAR) {
-      out += code.slice(last, i);
-      i += 2;
-      while (i < n && !(code.codePointAt(i) === STAR && code.codePointAt(i + 1) === SLASH)) {
-        i++;
-      }
-      i += 2;
-      last = i;
-    } else {
-      i++;
-    }
-  }
-  return out + code.slice(last);
-}
-function cssImportsTailwind(code) {
-  const withoutBlockComments = stripCssBlockComments(code);
-  return /@import\s+["']tailwindcss(?:\/[^"']*)?["']/.test(withoutBlockComments);
-}
 function hasInjectableTailwindCandidate(classes) {
   for (const c of classes) {
     if (c.length >= 2 && /^[a-z]/.test(c)) {
@@ -2398,15 +2442,6 @@ function watchModeMangleMessage() {
 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 = normalizePathSeparators(path.join(rootDir, safelistFilename));
-  const cssDir = normalizePathSeparators(path.dirname(cssId));
-  let relPath = path.posix.relative(cssDir, safelistPath);
-  if (!relPath.startsWith(".")) {
-    relPath = `./${relPath}`;
-  }
-  return relPath;
-}
 function cssVariableEntries(result) {
   const entries = [];
   for (const [original, value] of result.cssVariableMap ?? []) {
@@ -2427,7 +2462,6 @@ function recordFileVarMangleEntries(state, filename, entries) {
   } else {
     state.varMangleEntriesByFile.set(normalizedFilename, entries);
   }
-  state.varMangleMap = buildVarMangleMap(state.varMangleEntriesByFile);
 }
 function shouldTrackGlobalVarSources(config) {
   return config?.enabled === true;
@@ -2662,7 +2696,6 @@ function recordFileCSSVariableMetrics(state, filename, code) {
       state.cssVarMetricsByFile.delete(normalizedFilename);
     }
   }
-  state.cssVarMetrics = buildCSSVariableMetrics(state.cssVarMetricsByFile);
 }
 function collectCSSVariableMetrics(code) {
   const componentUses = /* @__PURE__ */ new Map();
@@ -3095,20 +3128,18 @@ function createCsszyxPlugins(options = {}) {
   let specifierAliases = [];
   const mangleReserved = new Set(options.production?.mangleExclude ?? []);
   let mangleMapFrozen = false;
+  let prescanSawServerModule = false;
+  let skipRscRecords = false;
+  let lastPrescanCacheMisses = 0;
   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(
-      `[csszyx] production.mangleMapDelivery must be 'both', 'html' or 'bundle'; got ${JSON.stringify(mangleMapDelivery)}.`
-    );
+  if (options.production?.mangleMapDelivery !== void 0) {
+    console.warn(removedMangleMapDeliveryMessage());
   }
-  const deliverMapInHtml = mangleMapDelivery !== "bundle";
-  const deliverMapInBundle = mangleMapDelivery !== "html";
   const sizeAccount = createMangleSizeAccount();
   const astBudgetOverride = options.build?.astBudgetLimit;
   const prescanAstBudget = astBudgetOverride ?? 5e5;
@@ -3119,7 +3150,6 @@ function createCsszyxPlugins(options = {}) {
   const globalVarMangleConfig = options.production?.mangleGlobalVars;
   const globalVarSourceTrackingEnabled = shouldTrackGlobalVarSources(globalVarMangleConfig);
   const globalVarAliasPrefix = globalVarMangleConfig?.aliasPrefix ?? CSSZYX_GLOBAL_ALIAS_PREFIX;
-  const encodedGlobalVarAliasPrefix = encodeURIComponent(globalVarAliasPrefix);
   const earlyGlobalVarAliasEntries = createEarlyGlobalVarAliasEntries(
     globalVarMangleConfig,
     globalVarAliasPrefix
@@ -3174,12 +3204,21 @@ function createCsszyxPlugins(options = {}) {
   const transformMemoryCache = /* @__PURE__ */ new Map();
   let transformMemoryCacheCodeChars = 0;
   const prescanResultHandoff = /* @__PURE__ */ new Map();
+  const varMangleEntries = createLazyAggregate(
+    buildVarMangleMap,
+    Object.fromEntries(earlyGlobalVarAliasEntries)
+  );
+  const cssVarMetricTotals = createLazyAggregate(
+    buildCSSVariableMetrics,
+    emptyCSSVariableMetrics()
+  );
   const state = {
     classes: /* @__PURE__ */ new Set(),
     parsedTheme: null,
     scanCssTheme: null,
     autoThemeCssFiles: [],
     sawTailwindEntry: false,
+    tailwindEntryFiles: /* @__PURE__ */ new Set(),
     sawAnyCss: false,
     tailwindWarningEmitted: false,
     tailwindEntryScoped: false,
@@ -3193,10 +3232,14 @@ function createCsszyxPlugins(options = {}) {
     ownedClasses: /* @__PURE__ */ new Set(),
     authoredClasses: /* @__PURE__ */ new Set(),
     mangleMap: {},
-    varMangleEntriesByFile: /* @__PURE__ */ new Map(),
-    varMangleMap: Object.fromEntries(earlyGlobalVarAliasEntries),
-    cssVarMetricsByFile: /* @__PURE__ */ new Map(),
-    cssVarMetrics: emptyCSSVariableMetrics(),
+    varMangleEntriesByFile: varMangleEntries,
+    get varMangleMap() {
+      return varMangleEntries.get();
+    },
+    cssVarMetricsByFile: cssVarMetricTotals,
+    get cssVarMetrics() {
+      return cssVarMetricTotals.get();
+    },
     checksum: "",
     finalized: false,
     rootDir: process.cwd(),
@@ -3208,7 +3251,7 @@ function createCsszyxPlugins(options = {}) {
   if (earlyGlobalVarAliasEntries.length > 0) {
     state.varMangleEntriesByFile.set(GLOBAL_VAR_ALIAS_MAP_OWNER, earlyGlobalVarAliasEntries);
   }
-  const SAFELIST_FILENAME = "csszyx-classes.html";
+  const SAFELIST_FILENAME = SAFELIST_FILE;
   const SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
     ".tsx",
     ".jsx",
@@ -3361,6 +3404,7 @@ function createCsszyxPlugins(options = {}) {
       );
       if (cached) return cached;
     }
+    lastPrescanCacheMisses++;
     const execution = runConfiguredParser(source, effectiveFilename, compilerOptions);
     if (cacheEnabled && cacheKey && execution.cacheable) {
       writeTransformCache(cacheRoot, cacheInput, execution.result, cacheKey);
@@ -3447,6 +3491,7 @@ function createCsszyxPlugins(options = {}) {
     if (cacheEnabled) evictTransformCacheOnce();
     ensureRustTransformAvailable();
     const misses = collectRustPrescanMisses(batchable, compilerOptions, cacheRoot, results);
+    lastPrescanCacheMisses += misses.length;
     if (misses.length > 0) {
       try {
         runRustPrescanBatch(misses, compilerOptions, cacheRoot, results);
@@ -3590,12 +3635,7 @@ function createCsszyxPlugins(options = {}) {
       return;
     }
     const safelistPath = path.join(state.rootDir, SAFELIST_FILENAME);
-    const classNames = Array.from(classes);
-    const classList = escapeHtmlAttribute(classNames.join(" "));
-    const content = `<!-- Auto-generated by csszyx \u2014 DO NOT EDIT -->
-<!-- Tailwind CSS scans this file for class name detection -->
-<div class="${classList}"><div class="${classList}">x</div><div class="${classList}">x</div></div>
-` + renderTailwindScannerCandidates(classNames);
+    const content = renderSafelistFile(Array.from(classes));
     try {
       let existing = "";
       try {
@@ -3606,7 +3646,9 @@ function createCsszyxPlugins(options = {}) {
         }
       }
       if (existing !== content) {
+        fs.mkdirSync(path.dirname(safelistPath), { recursive: true });
         fs.writeFileSync(safelistPath, content);
+        removeLegacySafelists(state.rootDir, console.warn);
       }
     } catch {
     }
@@ -3746,6 +3788,7 @@ function createCsszyxPlugins(options = {}) {
     szvCrossModuleRegistry.clear();
     szvCrossModuleForwards.clear();
     szObjectProvidersExamined.clear();
+    prescanSawServerModule = false;
     const prescanStarted = performance.now();
     const discoveredClasses = /* @__PURE__ */ new Set();
     const rawDiscoveredClasses = /* @__PURE__ */ new Set();
@@ -3764,6 +3807,9 @@ function createCsszyxPlugins(options = {}) {
         return;
       }
       recordAuthoredClasses(content);
+      if (!prescanSawServerModule && isRSCServerModule(content, filePath)) {
+        prescanSawServerModule = true;
+      }
       recordSzvRegistryEntries(filePath, content);
       recordCrossModuleForwards(szvCrossModuleForwards, filePath, content);
       seenSourcePaths.add(normalizePathSeparators(filePath));
@@ -3803,6 +3849,7 @@ function createCsszyxPlugins(options = {}) {
         }
       }
     }
+    const walkStarted = performance.now();
     scanDir(state.rootDir);
     const normRoot = normalizeForMatch(state.rootDir);
     for (const sourceDir of compileSourceDirs) {
@@ -3811,7 +3858,20 @@ function createCsszyxPlugins(options = {}) {
       }
       scanDir(sourceDir);
     }
+    traceBenchTiming(
+      `prescan:walk files=${seenSourcePaths.size} sz=${prescanSources.length}`,
+      state.rootDir,
+      performance.now() - walkStarted
+    );
+    const demandStarted = performance.now();
     recordDemandedSzObjectProviders(seenSourcePaths, szObjectDemand);
+    traceBenchTiming(
+      `prescan:demand providers=${szObjectProvidersExamined.size}`,
+      state.rootDir,
+      performance.now() - demandStarted
+    );
+    const batchStarted = performance.now();
+    lastPrescanCacheMisses = 0;
     const prescanContentByPath = new Map(
       prescanSources.map((file) => [file.filePath, file.content])
     );
@@ -3824,12 +3884,23 @@ function createCsszyxPlugins(options = {}) {
         rawDiscoveredClasses
       );
     }
+    traceBenchTiming(
+      `prescan:batch files=${prescanSources.length} misses=${lastPrescanCacheMisses}`,
+      state.rootDir,
+      performance.now() - batchStarted
+    );
     for (const cls of discoveredClasses) {
       addSafelistClass(cls);
       state.ownedClasses.add(cls);
     }
     const safelistClasses = /* @__PURE__ */ new Set([...discoveredClasses, ...rawDiscoveredClasses]);
+    const safelistStarted = performance.now();
     writeSafelistFile(safelistClasses);
+    traceBenchTiming(
+      `prescan:safelist classes=${safelistClasses.size}`,
+      state.rootDir,
+      performance.now() - safelistStarted
+    );
     traceBenchTiming("prescan", state.rootDir, performance.now() - prescanStarted);
   }
   function collectPrescanResult(result, filePath, discoveredClasses, rawDiscoveredClasses) {
@@ -4008,6 +4079,12 @@ function createCsszyxPlugins(options = {}) {
       result = result.split(CHECKSUM_PLACEHOLDER).join(state.checksum);
     }
     const isEvalWrapped = result.includes("eval(") && result.includes("sourceURL=webpack");
+    if (result.includes(CENSUS_PLACEHOLDER)) {
+      const census = safeJsonForScriptTag(
+        createHydrationMangleMap(state.mangleMap, state.varMangleMap)
+      );
+      result = result.split(CENSUS_PLACEHOLDER).join(escapeJsonForStringLiteral(census));
+    }
     if (result.includes(MANGLE_MAP_PLACEHOLDER)) {
       const jsonMap = escapeJsonForInlineScript(JSON.stringify(state.mangleMap));
       const escapedMap = isEvalWrapped ? escapeForDoubleQuotedString(jsonMap) : jsonMap;
@@ -4037,10 +4114,78 @@ function createCsszyxPlugins(options = {}) {
       usesBoolClass: false
     };
   }
+  function recordUntransformedHotFile(file, content) {
+    trackGlobalVarSourceFile(file, content);
+    recordFileVarMangleEntries(state, file, []);
+    recordFileCSSVariableMetrics(state, file, null);
+  }
+  function discoverHotFileClasses(file, watcher) {
+    if (!shouldProcessSource(file)) {
+      return;
+    }
+    let fileContent, result;
+    try {
+      fileContent = fs.readFileSync(file, "utf-8");
+    } catch {
+      refreshSzvRegistryEntry(file, null);
+      return;
+    }
+    refreshSzvRegistryEntry(file, fileContent);
+    if (!fileContent.includes("sz=") && !fileContent.includes("szs=") && !/\bsz\s*:\s*["'{]/.test(fileContent)) {
+      recordUntransformedHotFile(file, fileContent);
+      return;
+    }
+    try {
+      const hmrTransformStarted = performance.now();
+      result = transformConfiguredSource(fileContent, file);
+      traceBenchTiming("handle-hot-update", file, performance.now() - hmrTransformStarted);
+    } catch {
+      recordUntransformedHotFile(file, fileContent);
+      return;
+    }
+    if (!result.transformed) {
+      recordUntransformedHotFile(file, fileContent);
+      return;
+    }
+    recordHotTransformResult(file, fileContent, result, watcher);
+  }
+  function recordHotTransformResult(file, fileContent, result, watcher) {
+    const sizeBefore = state.classes.size;
+    trackGlobalVarSourceFile(file, fileContent);
+    for (const cls of result.classes) {
+      addSafelistClass(cls);
+      state.ownedClasses.add(cls);
+    }
+    recordFileVarMangleEntries(state, file, cssVariableEntries(result));
+    recordFileCSSVariableMetrics(state, file, result.code);
+    for (const [token, data] of result.recoveryTokens) {
+      state.recoveryTokens.set(token, data);
+    }
+    if (state.classes.size > sizeBefore) {
+      writeSafelistFile(state.classes);
+      const safelistPath = path.join(state.rootDir, SAFELIST_FILENAME);
+      watcher.emit("change", safelistPath);
+    }
+  }
+  function tailwindEntryModules(moduleGraph) {
+    const modules = [];
+    for (const file of state.tailwindEntryFiles) {
+      const found = moduleGraph.getModulesByFile(file);
+      if (found) modules.push(...found);
+    }
+    return modules;
+  }
   function transformTailwindCssEntry(code, id) {
     state.sawAnyCss = true;
+    const [cssFile] = id.split("?");
+    const legacy = findLegacySourceDirective(code, cssFile);
+    if (legacy !== null) {
+      throw new Error(legacySourceMessage(cssFile, legacy.target));
+    }
     if (!cssImportsTailwind(code)) return null;
     state.sawTailwindEntry = true;
+    const [entryFile] = id.split("?");
+    state.tailwindEntryFiles.add(entryFile);
     if (cssHasContentScope(code)) state.tailwindEntryScoped = true;
     if (!hasInjectableTailwindCandidate(state.classes)) return null;
     const relPath = computeSafelistRelPath(state.rootDir, SAFELIST_FILENAME, id);
@@ -4112,16 +4257,16 @@ function createCsszyxPlugins(options = {}) {
     if (!code.includes("<html") || !/(?:layout|Root|Document|app)\.tsx?$/i.test(id)) {
       return null;
     }
-    let transformedCode = code;
     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)}`;
+    const htmlTag = findOpeningTag(code, "html");
+    if (!htmlTag) {
+      return code;
     }
-    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})}}})()\`}} />`;
+    let transformedCode = `${code.slice(0, htmlTag.close)} ${attrName}="${CHECKSUM_PLACEHOLDER}"${code.slice(htmlTag.close)}`;
+    const censusTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json" dangerouslySetInnerHTML={{__html: \`${CENSUS_PLACEHOLDER}\`}} />`;
     const bodyTag = findOpeningTag(transformedCode, "body");
     if (bodyTag) {
-      transformedCode = `${transformedCode.slice(0, bodyTag.close + 1)}${debugScript}${transformedCode.slice(bodyTag.close + 1)}`;
+      transformedCode = `${transformedCode.slice(0, bodyTag.close + 1)}${censusTag}${transformedCode.slice(bodyTag.close + 1)}`;
     }
     return transformedCode;
   }
@@ -4187,12 +4332,22 @@ ${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 || !shouldProcessSource(id) || !MANGLE_RUNTIME_CONSUMER_RE.test(transformedCode) || transformedCode.includes(MANGLE_RUNTIME_VIRTUAL_ID)) {
       return null;
     }
     return insertRuntimeImport(transformedCode, `import '${MANGLE_RUNTIME_VIRTUAL_ID}';
 `);
   }
+  function applyWebpackMangleRuntimeEntry(compiler) {
+    const root = compiler.context;
+    const file = ensureMangleRuntimeFile(
+      path.join(root, ".csszyx"),
+      globalVarAliasPrefix,
+      options.production?.mangleDebugGlobal === true
+    );
+    if (file === null) return;
+    applyMangleRuntimeEntry(compiler, root, file, () => sizeAccount.channels.add("bundle"));
+  }
   function collectPreTransformClasses(output) {
     if (!output.transformed && !output.code.includes("class=") && !output.code.includes("className=")) {
       return null;
@@ -4258,7 +4413,10 @@ ${transformedCode}`;
         }
         if (id === RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID) {
           sizeAccount.channels.add("bundle");
-          return createMangleRuntimeModule(globalVarAliasPrefix);
+          return createMangleRuntimeModule(
+            globalVarAliasPrefix,
+            options.production?.mangleDebugGlobal === true
+          );
         }
         if (id === RESOLVED_THEME_GROUPS_VIRTUAL_ID) {
           return createThemeGroupsModule(themeGroupTokens());
@@ -4336,8 +4494,10 @@ ${transformedCode}`;
         }
         if (matchesScriptExtension(id, SCRIPT_ID_EXTENSIONS)) {
           assertNoRSCBoundaryViolation(output.code, id);
-          const record = createRSCModuleRecord(output.code, id);
-          state.rscModules.set(record.id, record);
+          if (!skipRscRecords) {
+            const record = createRSCModuleRecord(output.code, id);
+            state.rscModules.set(record.id, record);
+          }
         }
         return collectPreTransformClasses(output);
       },
@@ -4414,10 +4574,8 @@ ${transformedCode}`;
         if (compiler.options?.mode === "development") {
           manglingEnabled = false;
         }
-        if (manglingEnabled && mangleMapDelivery !== "both") {
-          console.warn(
-            `[csszyx] production.mangleMapDelivery: '${mangleMapDelivery}' has no effect on the webpack lane \u2014 map delivery only narrows on vite/rollup builds.`
-          );
+        if (manglingEnabled) {
+          applyWebpackMangleRuntimeEntry(compiler);
         }
         compiler.hooks.beforeCompile.tap("csszyx:prescan", () => {
           announceActiveParser();
@@ -4476,6 +4634,7 @@ ${transformedCode}`;
           }
           evictTransformCacheOnce();
           prescanAndWriteClasses();
+          skipRscRecords = config.command === "build" && !config.build?.watch && !prescanSawServerModule;
           state.scanCssTheme = runThemeScan(root, options.build?.scanCss) ?? state.scanCssTheme;
           runAutoThemeScan(root);
           if (config.command === "build") {
@@ -4489,8 +4648,11 @@ ${transformedCode}`;
         },
         /**
          * Vite HMR hook: re-runs theme scan when a watched CSS file changes,
-         * and incrementally updates csszyx-classes.html when a source file gains new sz classes.
+         * and incrementally updates the safelist when a source file gains new sz classes.
          * @param ctx - HMR context containing the changed file
+         * @returns The modules a safelist write affects, so Vite hot-updates
+         * the stylesheet instead of reloading the page; undefined otherwise,
+         * which leaves Vite's own handling in place.
          */
         handleHotUpdate(ctx) {
           prescanResultHandoff.clear();
@@ -4515,59 +4677,11 @@ ${transformedCode}`;
               ctx.server.ws.send({ type: "full-reload" });
             }
           }
-          if (!shouldProcessSource(ctx.file)) {
-            return;
-          }
-          let fileContent, result;
-          try {
-            fileContent = fs.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, []);
-            recordFileCSSVariableMetrics(state, ctx.file, null);
-            return;
-          }
-          try {
-            const hmrTransformStarted = performance.now();
-            result = transformConfiguredSource(fileContent, ctx.file);
-            traceBenchTiming(
-              "handle-hot-update",
-              ctx.file,
-              performance.now() - hmrTransformStarted
-            );
-          } catch {
-            trackGlobalVarSourceFile(ctx.file, fileContent);
-            recordFileVarMangleEntries(state, ctx.file, []);
-            recordFileCSSVariableMetrics(state, ctx.file, null);
-            return;
-          }
-          if (!result.transformed) {
-            trackGlobalVarSourceFile(ctx.file, fileContent);
-            recordFileVarMangleEntries(state, ctx.file, []);
-            recordFileCSSVariableMetrics(state, ctx.file, null);
-            return;
-          }
-          const sizeBefore = state.classes.size;
-          trackGlobalVarSourceFile(ctx.file, fileContent);
-          for (const cls of result.classes) {
-            addSafelistClass(cls);
-            state.ownedClasses.add(cls);
-          }
-          recordFileVarMangleEntries(state, ctx.file, cssVariableEntries(result));
-          recordFileCSSVariableMetrics(state, ctx.file, result.code);
-          for (const [token, data] of result.recoveryTokens) {
-            state.recoveryTokens.set(token, data);
-          }
-          if (state.classes.size > sizeBefore) {
-            writeSafelistFile(state.classes);
-            const safelistPath = path.join(state.rootDir, SAFELIST_FILENAME);
-            ctx.server.watcher.emit("change", safelistPath);
+          if (normalizePathSeparators(ctx.file) === normalizePathSeparators(path.join(state.rootDir, SAFELIST_FILENAME))) {
+            return tailwindEntryModules(ctx.server.moduleGraph);
           }
+          discoverHotFileClasses(ctx.file, ctx.server.watcher);
+          return void 0;
         },
         transformIndexHtml: {
           order: "pre",
@@ -4581,13 +4695,11 @@ ${transformedCode}`;
             finalizeMangleMap();
             const injectedMangleMap = manglingEnabled ? state.mangleMap : {};
             let result = transformIndexHtml(html, injectedMangleMap, state.checksum, {
-              // Always 'script'; the checksum itself is injected by
-              // injectHydrationData regardless of this mode.
+              // Always 'script' — the inert JSON census; the
+              // checksum attribute is injected regardless.
               mode: "script",
               minify: process.env.NODE_ENV === "production",
-              varMangleMap: state.varMangleMap,
-              globalVarAliasPrefix,
-              installRuntimeObject: deliverMapInHtml
+              varMangleMap: state.varMangleMap
             });
             if (manglingEnabled) {
               sizeAccount.channels.add("html");
@@ -4608,6 +4720,18 @@ ${transformedCode}`;
               }
               result = injectRecoveryManifest(result, manifest);
             }
+            if (needsRuntimeMangleRegistration(manglingEnabled, injectedMangleMap)) {
+              return {
+                html: result,
+                tags: [
+                  {
+                    tag: "script",
+                    attrs: { type: "module", src: MANGLE_RUNTIME_VIRTUAL_ID },
+                    injectTo: "head-prepend"
+                  }
+                ]
+              };
+            }
             return result;
           }
         }
@@ -4959,4 +5083,4 @@ const esbuildPlugin = (options = {}) => {
   };
 };
 
-export { shouldWarnUnscopedMonorepo as $, isHardIgnoredPath as A, isMangleableCssId as B, isMonorepoPackage as C, isPackagesSkippedSource as D, isRSCServerModule as E, isTailwindReservedGlobalVar as F, lateMangleCensusMessage as G, mangleCodeClassesSync as H, mangleEligibleClasses as I, mangleHybridHazardMessage as J, missingTailwindEntryMessage as K, normalizeGlobalVarAliasesForCache as L, planGlobalVarAliases as M, readGlobalVarScanCache as N, realContentHashDisabledMessage as O, recordGlobalVarSourceFile as P, resolveCompileSourceDirs as Q, resolveGlobalVarScanCacheDir as R, resolveNativeCacheIdentity as S, resolveQuietMode as T, rewriteGlobalVarCssAliases as U, rollupPlugin as V, scanGlobalVarCss as W, shouldEmitMissingCssFallback as X, shouldEmitWarning as Y, shouldTrackGlobalVarSources as Z, shouldWarnMissingTailwindEntry as _, allocateMangleTokens as a, skippedSzFilesMessage as a0, suppressedAdvisoryMessage as a1, unscopedMonorepoMessage as a2, validateGlobalVarAliasInputs as a3, vitePlugin as a4, watchModeMangleMessage as a5, webpackPlugin as a6, writeGlobalVarScanCache as a7, appendTailwindSourceDirective as b, assertNoRSCBoundaryViolation as c, assertNoRSCGraphViolation as d, collectMangleHybridHazards as e, computeSafelistRelPath as f, createGlobalVarAliasValidationOptions as g, createGlobalVarMapAssetSource as h, createGlobalVarScanCacheKey as i, createRSCModuleRecord as j, cssHasContentScope as k, cssImportsTailwind as l, deleteRSCModuleRecord as m, emitMissingCssFallback as n, esbuildPlugin as o, extractGlobalVarAliasesForManifest as p, fileMayContainSafelistableSz as q, findLocalImportSources as r, findRSCBoundaryViolation as s, findRSCGraphViolation as t, unplugin as u, hasInjectableTailwindCandidate as v, hasUseClientDirective as w, hasUseServerDirective as x, isAdvisoryDiagnostic as y, isCompileSourceOptedIn as z };
+export { unscopedMonorepoMessage as $, isPackagesSkippedSource as A, isRSCServerModule as B, isTailwindReservedGlobalVar as C, lateMangleCensusMessage as D, mangleCodeClassesSync as E, mangleEligibleClasses as F, mangleHybridHazardMessage as G, missingTailwindEntryMessage as H, normalizeGlobalVarAliasesForCache as I, planGlobalVarAliases as J, readGlobalVarScanCache as K, realContentHashDisabledMessage as L, recordGlobalVarSourceFile as M, resolveCompileSourceDirs as N, resolveGlobalVarScanCacheDir as O, resolveNativeCacheIdentity as P, resolveQuietMode as Q, rewriteGlobalVarCssAliases as R, rollupPlugin as S, scanGlobalVarCss as T, shouldEmitMissingCssFallback as U, shouldEmitWarning as V, shouldTrackGlobalVarSources as W, shouldWarnMissingTailwindEntry as X, shouldWarnUnscopedMonorepo as Y, skippedSzFilesMessage as Z, suppressedAdvisoryMessage as _, allocateMangleTokens as a, validateGlobalVarAliasInputs as a0, vitePlugin as a1, watchModeMangleMessage as a2, webpackPlugin as a3, writeGlobalVarScanCache as a4, assertNoRSCBoundaryViolation as b, assertNoRSCGraphViolation as c, collectMangleHybridHazards as d, createGlobalVarAliasValidationOptions as e, createGlobalVarMapAssetSource as f, createGlobalVarScanCacheKey as g, createRSCModuleRecord as h, cssHasContentScope as i, deleteRSCModuleRecord as j, emitMissingCssFallback as k, esbuildPlugin as l, extractGlobalVarAliasesForManifest as m, fileMayContainSafelistableSz as n, findLocalImportSources as o, findRSCBoundaryViolation as p, findRSCGraphViolation as q, hasInjectableTailwindCandidate as r, hasUseClientDirective as s, hasUseServerDirective as t, unplugin as u, isAdvisoryDiagnostic as v, isCompileSourceOptedIn as w, isHardIgnoredPath as x, isMangleableCssId as y, isMonorepoPackage as z };