@csszyx/unplugin 0.11.10 → 0.12.0

package/dist/shared/{unplugin.CVMbUfH5.mjs → unplugin.B9vpjOhD.mjs}

@@ -6,17 +6,18 @@ import * as path from 'node:path';
 import { dirname } from 'node:path';
 import { performance } from 'node:perf_hooks';
 import { fileURLToPath } from 'node:url';
-import { scanGlobalVarUsages, sortStrings as sortStrings$1, ensureRustTransformAvailable, transformSourceCode, transformRust, transformOxc, ASTBudgetExceededError, transformRustBatch, transform, isRustTransformAvailable } from '@csszyx/compiler';
+import { scanGlobalVarUsages, extractSzvRegistryEntries, sortStrings as sortStrings$1, szFallbackConsequenceOf, ensureRustTransformAvailable, transformSourceCode, transformRust, transformOxc, ASTBudgetExceededError, transformRustBatch, transform, isRustTransformAvailable } from '@csszyx/compiler';
 import { encode, compute_mangle_checksum } from '@csszyx/core';
 import { getNativePackageName } from '@csszyx/core/native';
 import { preprocess as preprocess$1 } from '@csszyx/svelte-adapter';
 import { isTailwindReservedCustomProperty, CSSZYX_GLOBAL_ALIAS_PREFIX, isCsszyxGlobalAliasCustomProperty, DEFAULT_BUILD_CONFIG, validateGlobalVarMangleConfig } from '@csszyx/types';
 import { preprocess } from '@csszyx/vue-adapter';
 import { createUnplugin } from 'unplugin';
-import { n as normalizePathSeparators, r as resolveTransformCacheDir, c as createTransformCacheKey, w as writeTransformCache, e as evictOldTransformCacheEntries, a as readTransformCache, d as evictMemoryCacheToBudget, b as babelFallbackReason } from './unplugin.fOnGXWgS.mjs';
+import { n as normalizePathSeparators, r as resolveTransformCacheDir, c as createTransformCacheKey, w as writeTransformCache, e as evictOldTransformCacheEntries, a as readTransformCache, d as evictMemoryCacheToBudget, b as babelFallbackReason } from './unplugin.CDqY7kmk.mjs';
 import { mangleCSSSync } from '../css-mangler.mjs';
-import { i as importsRuntimeHelper, f as findRuntimeImportClause, a as insertAfterUseDirective } from './unplugin.Lhzkcj-A.mjs';
+import { a as importsRuntimeHelper, f as findRuntimeImportClause, r as runtimeHelperGroupsFromUsage, b as insertAfterUseDirective } from './unplugin.CBMJufQ8.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 { gzipSync } from 'node:zlib';
 import postcss from 'postcss';
 import valueParser from 'postcss-value-parser';
 
@@ -1863,17 +1864,19 @@ function injectMangleMapScript(html, mangleMap, options = {}) {
   const {
     prettyPrint = false,
     varMangleMap = {},
-    globalVarAliasPrefix = CSSZYX_GLOBAL_ALIAS_PREFIX
+    globalVarAliasPrefix = CSSZYX_GLOBAL_ALIAS_PREFIX,
+    installRuntimeObject = true
   } = options;
   const checksumMap = createHydrationMangleMap(mangleMap, varMangleMap);
   const jsonContent = safeJsonForScriptTag(checksumMap, prettyPrint);
-  const classMapContent = safeJsonForScriptTag(mangleMap);
   const varMapContent = safeJsonForScriptTag(varMangleMap);
+  const reuseChecksumPayload = Object.keys(varMangleMap).length === 0;
+  const classMapExpr = reuseChecksumPayload ? '(function(){var e=document.getElementById("__CSSZYX_MANGLE_MAP__");return e?JSON.parse(e.textContent):{}})()' : safeJsonForScriptTag(mangleMap);
   const scriptTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json">${jsonContent}<\/script>`;
   const prefixContent = safeJsonForScriptTag(globalVarAliasPrefix);
-  const debugScript = `<script>(function(){var m=${classMapContent};var vm=${varMapContent};var gp=${prefixContent};var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}var cs=document.documentElement.getAttribute("data-sz-checksum")||"";window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:cs,decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()<\/script>`;
-  const combined = `${scriptTag}
-${debugScript}`;
+  const debugScript = `<script>(function(){var m=${classMapExpr};var vm=${varMapContent};var gp=${prefixContent};var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}var cs=document.documentElement.getAttribute("data-sz-checksum")||"";window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:cs,decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()<\/script>`;
+  const combined = installRuntimeObject ? `${scriptTag}
+${debugScript}` : scriptTag;
   if (html.includes("</head>")) {
     return html.replace("</head>", `${combined}
 </head>`);
@@ -1978,6 +1981,42 @@ function escapeForDoubleQuotedString(value) {
   return escapeDoubleQuotedString(value);
 }
 
+function createMangleSizeAccount() {
+  return { cssGzBefore: 0, cssGzAfter: 0, channels: /* @__PURE__ */ new Set() };
+}
+function resetMangleSizeAccount(account) {
+  account.cssGzBefore = 0;
+  account.cssGzAfter = 0;
+  account.channels.clear();
+}
+function gzipBytes(text) {
+  if (text.length === 0) return 0;
+  return gzipSync(Buffer.from(text, "utf8")).length;
+}
+function recordCssPair(account, before, after) {
+  if (before === after) {
+    const bytes = gzipBytes(before);
+    account.cssGzBefore += bytes;
+    account.cssGzAfter += bytes;
+    return;
+  }
+  account.cssGzBefore += gzipBytes(before);
+  account.cssGzAfter += gzipBytes(after);
+}
+function computeMangleSizeVerdict(account, mapPayload) {
+  const channels = sortStrings(account.channels);
+  const mapCost = gzipBytes(mapPayload) * channels.length;
+  const cssSaving = account.cssGzBefore - account.cssGzAfter;
+  return { mapCost, cssSaving, net: mapCost - cssSaving, channels };
+}
+function mangleSizeMessage(verdict) {
+  if (verdict.channels.length === 0) return null;
+  if (verdict.net <= 0) return null;
+  const cssPart = verdict.cssSaving >= 0 ? `the mangled CSS saves ${verdict.cssSaving} B` : `the mangled CSS COSTS ${-verdict.cssSaving} B (short tokens compress worse than the names they replaced)`;
+  const channelPart = verdict.channels.length > 1 ? `${verdict.channels.join(" + ")} (${verdict.channels.length} copies)` : verdict.channels[0];
+  return `[csszyx] production.mangle is making this build BIGGER: +${verdict.net} B gzipped. The runtime mangle map costs ${verdict.mapCost} B via ${channelPart}, while ${cssPart}. Mangling is a name-obfuscation feature; over a compressed response it does not reduce payload, because utility class names compress far better than the map they need. If you enabled it for size, set \`production.mangle: false\`. If you enabled it to hide class names, this is the expected price and you can ignore this. Narrowing \`production.mangleMapDelivery\` removes a map copy when only one channel is needed. (Measured on CSS and the map; class shortening inside JS chunks is not counted, so the real net is slightly better than this figure.)`;
+}
+
 function isParserMode(value) {
   return value === "rust" || value === "oxc" || value === "babel";
 }
@@ -2022,6 +2061,41 @@ 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 = normalizePathSeparators(filePath);
+  const qualifies = content.includes("szv(") && content.includes("export");
+  const entries = qualifies ? 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.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 = normalizePathSeparators(path.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();
@@ -2137,7 +2211,7 @@ export default checksum;
 `;
 }
 function isVirtualModule(id) {
-  return id === VIRTUAL_MODULE_ID || id === VIRTUAL_CHECKSUM_ID || id === THEME_GROUPS_VIRTUAL_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) {
@@ -2149,8 +2223,56 @@ function resolveVirtualModule(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,
@@ -2175,9 +2297,6 @@ function registerWebpackAssetProcessor(compiler, processAssets) {
     );
   });
 }
-const CHECKSUM_PLACEHOLDER = "___CSSZYX_CHECKSUM___";
-const MANGLE_MAP_PLACEHOLDER = "___CSSZYX_MANGLE_MAP___";
-const VAR_MANGLE_MAP_PLACEHOLDER = "___CSSZYX_VAR_MANGLE_MAP___";
 const UNKNOWN_PACKAGE_VERSION = "0.0.0";
 const TRANSFORM_CACHE_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1e3;
 const TRANSFORM_CACHE_MAX_ENTRIES = 1e4;
@@ -2366,6 +2485,13 @@ function shouldEmitWarning(quiet, devOnly, isProduction) {
   }
   return true;
 }
+function shouldEmitMissingCssFallback(quiet, message) {
+  return !quiet && szFallbackConsequenceOf(message) === "missing-css";
+}
+function emitMissingCssFallback(quiet, message, id, emit) {
+  if (shouldEmitMissingCssFallback(quiet, message)) emit(`[csszyx] ${id}
+  ${message}`);
+}
 function normalizeForMatch(p) {
   const n = normalizePathSeparators(p);
   return n.length > 1 && n.endsWith("/") ? n.slice(0, -1) : n;
@@ -2433,6 +2559,30 @@ function fileMayContainSafelistableSz(content) {
 function mangleEligibleClasses(ownedClasses, authoredClasses) {
   return sortStrings$1([...ownedClasses].filter((className) => !authoredClasses.has(className)));
 }
+const tokenByIndex = [];
+function tokenAt(index) {
+  const cached = tokenByIndex[index];
+  if (cached !== void 0) {
+    return cached;
+  }
+  const fresh = encode(index);
+  tokenByIndex[index] = fresh;
+  return fresh;
+}
+function allocateMangleTokens(eligibleClasses, forbiddenTokens) {
+  const map = {};
+  let tokenIndex = 0;
+  for (const className of eligibleClasses) {
+    let token = tokenAt(tokenIndex);
+    while (forbiddenTokens.has(token)) {
+      tokenIndex++;
+      token = tokenAt(tokenIndex);
+    }
+    map[className] = token;
+    tokenIndex++;
+  }
+  return map;
+}
 function isPackagesSkippedSource(id, sourceDirs = []) {
   const p = normalizeForMatch(id);
   if (p.includes("node_modules")) {
@@ -3103,8 +3253,19 @@ ${errors.join("\n")}`
 }
 function createCsszyxPlugins(options = {}) {
   assertGlobalVarMangleConfig(options);
-  let manglingEnabled = options.production?.mangle !== false;
+  let manglingEnabled = options.production?.mangle === true;
+  let crossModuleRegistryEnabled = process.env.NODE_ENV !== "development";
+  const szvCrossModuleRegistry = /* @__PURE__ */ new Map();
   const mangleReserved = new Set(options.production?.mangleExclude ?? []);
+  const mangleMapDelivery = options.production?.mangleMapDelivery ?? "both";
+  if (!["both", "html", "bundle"].includes(mangleMapDelivery)) {
+    throw new Error(
+      `[csszyx] production.mangleMapDelivery must be 'both', 'html' or 'bundle'; got ${JSON.stringify(mangleMapDelivery)}.`
+    );
+  }
+  const deliverMapInHtml = mangleMapDelivery !== "bundle";
+  const deliverMapInBundle = mangleMapDelivery !== "html";
+  const sizeAccount = createMangleSizeAccount();
   const astBudgetOverride = options.build?.astBudgetLimit;
   const prescanAstBudget = astBudgetOverride ?? 5e5;
   const cacheRequested = (options.build?.cache ?? DEFAULT_BUILD_CONFIG.cache) !== false;
@@ -3330,6 +3491,14 @@ function createCsszyxPlugins(options = {}) {
   function transformConfiguredSource(source, filename, astBudget) {
     const compilerOptions = createCompilerOptions(astBudget);
     const effectiveFilename = normalizeSourceFilename(filename);
+    const crossModuleStatics = resolveCrossModuleStaticsFor(
+      szvCrossModuleRegistry,
+      filename,
+      source
+    );
+    if (crossModuleStatics !== void 0) {
+      compilerOptions.crossModuleStatics = crossModuleStatics;
+    }
     const cacheRoot = resolveTransformCacheDir(state.rootDir, options.build?.cacheDir);
     if (cacheEnabled) {
       evictTransformCacheOnce();
@@ -3441,6 +3610,10 @@ function createCsszyxPlugins(options = {}) {
       mangleVars: compilerOptions.mangleVars,
       mangleVarHoistMaxDepth: compilerOptions.mangleVarHoistMaxDepth,
       globalVarAliases: normalizeGlobalVarAliasesForCache(compilerOptions.globalVarAliases),
+      // The registry entries fed to this file are part of its identity:
+      // module A's config change must miss B's cached transform, or the
+      // cache serves a stale table.
+      crossModuleStatics: compilerOptions.crossModuleStatics === void 0 ? void 0 : JSON.stringify(compilerOptions.crossModuleStatics),
       filename: effectiveFilename,
       source
     };
@@ -3652,6 +3825,7 @@ function createCsszyxPlugins(options = {}) {
   }
   function prescanAndWriteClasses() {
     refreshCompileSourceDirs();
+    szvCrossModuleRegistry.clear();
     const prescanStarted = performance.now();
     const discoveredClasses = /* @__PURE__ */ new Set();
     const rawDiscoveredClasses = /* @__PURE__ */ new Set();
@@ -3668,10 +3842,15 @@ function createCsszyxPlugins(options = {}) {
         return;
       }
       recordAuthoredClasses(content);
+      recordSzvRegistryEntries(filePath, content);
       if (fileMayContainSafelistableSz(content)) {
         prescanSources.push({ filePath, content });
       }
     }
+    function recordSzvRegistryEntries(filePath, content) {
+      if (!crossModuleRegistryEnabled) return;
+      recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
+    }
     function scanDir(dir) {
       let entries;
       try {
@@ -3830,18 +4009,15 @@ function createCsszyxPlugins(options = {}) {
     }
   }
   function finalizeMangleMap() {
-    const newMap = {};
-    let tokenIndex = 0;
-    for (const className of mangleEligibleClasses(state.ownedClasses, state.authoredClasses)) {
-      let token = encode(tokenIndex);
-      while (mangleReserved.has(token) || state.authoredClasses.has(token)) {
-        tokenIndex++;
-        token = encode(tokenIndex);
-      }
-      newMap[className] = token;
-      tokenIndex++;
-    }
-    state.mangleMap = newMap;
+    const forbiddenTokens = /* @__PURE__ */ new Set([
+      ...mangleReserved,
+      ...state.authoredClasses,
+      ...state.ownedClasses
+    ]);
+    state.mangleMap = allocateMangleTokens(
+      mangleEligibleClasses(state.ownedClasses, state.authoredClasses),
+      forbiddenTokens
+    );
     assertVarMangleMapSize(state.varMangleMap, varMangleMapMaxBytes);
     state.checksum = compute_mangle_checksum(
       createHydrationMangleMap(state.mangleMap, state.varMangleMap)
@@ -3874,14 +4050,15 @@ function createCsszyxPlugins(options = {}) {
     if (result.includes(CHECKSUM_PLACEHOLDER)) {
       result = result.split(CHECKSUM_PLACEHOLDER).join(state.checksum);
     }
+    const isEvalWrapped = result.includes("eval(") && result.includes("sourceURL=webpack");
     if (result.includes(MANGLE_MAP_PLACEHOLDER)) {
       const jsonMap = escapeJsonForInlineScript(JSON.stringify(state.mangleMap));
-      const escapedMap = result.includes("eval(") ? escapeForDoubleQuotedString(jsonMap) : jsonMap;
+      const escapedMap = isEvalWrapped ? escapeForDoubleQuotedString(jsonMap) : jsonMap;
       result = result.split(MANGLE_MAP_PLACEHOLDER).join(escapedMap);
     }
     if (result.includes(VAR_MANGLE_MAP_PLACEHOLDER)) {
       const jsonMap = escapeJsonForInlineScript(JSON.stringify(state.varMangleMap));
-      const escapedMap = result.includes("eval(") ? escapeForDoubleQuotedString(jsonMap) : jsonMap;
+      const escapedMap = isEvalWrapped ? escapeForDoubleQuotedString(jsonMap) : jsonMap;
       result = result.split(VAR_MANGLE_MAP_PLACEHOLDER).join(escapedMap);
     }
     return result;
@@ -3894,6 +4071,9 @@ function createCsszyxPlugins(options = {}) {
       usesMerge: false,
       usesSzcn: false,
       usesSzPart: false,
+      usesSzvPick: false,
+      usesSzvPick1: false,
+      szPartArgsProvable: true,
       usesColorVar: false,
       usesSpacingVar: false,
       usesUnitVar: false
@@ -3914,16 +4094,20 @@ function createCsszyxPlugins(options = {}) {
       if (message.includes("unresolvable sz spread")) {
         state.spreadWarnings.add(`${id}
   ${message}`);
-      } else if (message.includes("AST budget exceeded")) {
+        continue;
+      }
+      if (message.includes("AST budget exceeded")) {
         console.warn(`[csszyx] ${id}
   ${message}`);
+        continue;
       }
+      emitMissingCssFallback(quiet, message, id, console.warn);
     }
     if (quiet || result.diagnostics.length === 0 || process.env.NODE_ENV === "production") {
       return;
     }
     for (const message of result.diagnostics) {
-      if (message.includes("unresolvable sz spread") || message.includes("AST budget exceeded")) {
+      if (message.includes("unresolvable sz spread") || message.includes("AST budget exceeded") || szFallbackConsequenceOf(message) === "missing-css") {
         continue;
       }
       warn(`[csszyx] ${id}
@@ -3938,6 +4122,9 @@ function createCsszyxPlugins(options = {}) {
       usesMerge: result.usesMerge,
       usesSzcn: result.usesSzcn,
       usesSzPart: result.usesSzPart,
+      usesSzvPick: result.usesSzvPick,
+      usesSzvPick1: result.usesSzvPick1,
+      szPartArgsProvable: result.szPartArgsProvable,
       usesColorVar: result.usesColorVar,
       usesSpacingVar: result.usesSpacingVar,
       usesUnitVar: result.usesUnitVar,
@@ -3980,31 +4167,34 @@ function createCsszyxPlugins(options = {}) {
     return transformedCode;
   }
   function requiredRuntimeHelpers(output) {
-    const helpers = [];
-    if (output.usesRuntime) helpers.push("_sz");
-    if (output.usesMerge) helpers.push("_szMerge");
-    if (output.usesSzcn) helpers.push("_szcn");
-    if (output.usesSzPart) helpers.push("_szPart");
-    if (output.usesColorVar) helpers.push("__szColorVar");
-    if (output.usesSpacingVar) helpers.push("__szSpacingVar");
-    if (output.usesUnitVar) helpers.push("__szUnitVar");
-    return helpers;
+    return runtimeHelperGroupsFromUsage(output);
   }
   function injectRuntimeHelpers(code, output) {
-    const imports = requiredRuntimeHelpers(output);
-    const hasRuntimeImport = imports.length > 0 && code.includes("@csszyx/runtime");
-    const needed = hasRuntimeImport ? imports.filter((name) => !importsRuntimeHelper(code, name)) : imports;
-    if (needed.length === 0) return null;
-    const existingImport = findRuntimeImportClause(code);
+    const groups = requiredRuntimeHelpers(output);
+    let result = null;
+    let current = code;
+    if (groups.merge.length > 0 && !current.includes("@csszyx/runtime/merge")) {
+      current = insertRuntimeImport(
+        current,
+        `import { ${groups.merge.join(", ")} } from '@csszyx/runtime/merge';
+`
+      );
+      result = current;
+    }
+    const imports = groups.barrel;
+    const hasRuntimeImport = imports.length > 0 && current.includes("@csszyx/runtime");
+    const needed = hasRuntimeImport ? imports.filter((name) => !importsRuntimeHelper(current, name)) : imports;
+    if (needed.length === 0) return result;
+    const existingImport = findRuntimeImportClause(current);
     if (existingImport) {
-      return code.replace(
+      return current.replace(
         existingImport.statement,
         `${existingImport.prefixWithBody}, ${needed.join(", ")} } from '@csszyx/runtime'`
       );
     }
     const importStatement = `import { ${needed.join(", ")} } from '@csszyx/runtime';
 `;
-    return insertRuntimeImport(code, importStatement);
+    return insertRuntimeImport(current, importStatement);
   }
   function injectThemeGroups(code, transformedCode, id, usesSzcn) {
     if (!usesSzcn && !/\bszcn\s*\(/.test(code) || transformedCode.includes(THEME_GROUPS_VIRTUAL_ID) || !shouldProcessSource(id)) {
@@ -4012,6 +4202,18 @@ function createCsszyxPlugins(options = {}) {
     }
     return `import '${THEME_GROUPS_VIRTUAL_ID}';
 ${transformedCode}`;
+  }
+  const MANGLE_RUNTIME_CONSUMER_RE = /from\s*['"](?:csszyx|@csszyx\/runtime)['"]/;
+  let activeFramework;
+  function injectMangleRuntime(transformedCode, id) {
+    if (activeFramework !== "vite" && activeFramework !== "rollup") {
+      return null;
+    }
+    if (!manglingEnabled || !deliverMapInBundle || !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 collectPreTransformClasses(output) {
     if (!output.transformed && !output.code.includes("class=") && !output.code.includes("className=")) {
@@ -4055,7 +4257,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;
+        return id === RESOLVED_VIRTUAL_MODULE_ID || id === RESOLVED_VIRTUAL_CHECKSUM_ID || id === RESOLVED_THEME_GROUPS_VIRTUAL_ID || id === RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID;
       },
       /**
        * Loads virtual module content — generates mangle map or checksum module code.
@@ -4076,6 +4278,10 @@ ${transformedCode}`;
           finalizeMangleMap();
           return createChecksumModule(state.checksum);
         }
+        if (id === RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID) {
+          sizeAccount.channels.add("bundle");
+          return createMangleRuntimeModule(globalVarAliasPrefix);
+        }
         if (id === RESOLVED_THEME_GROUPS_VIRTUAL_ID) {
           const theme = state.parsedTheme;
           return createThemeGroupsModule({
@@ -4121,7 +4327,12 @@ ${transformedCode}`;
         if (matchesScriptExtension(id, [".css"])) {
           return transformTailwindCssEntry(code, id);
         }
-        const hasSzProp = code.includes("sz=") || code.includes("szs=") || /\bsz\s*:\s*["'{]/.test(code) || code.includes('sz: "');
+        const hasSzProp = code.includes("sz=") || code.includes("szs=") || /\bsz\s*:\s*["'{]/.test(code) || code.includes('sz: "') || // szr-only modules (no sz attribute) historically skipped the
+        // compiler entirely — which also skipped the szr import
+        // rewrite AND the szr fallback diagnostics. The substring is
+        // deliberately loose; a false positive only costs one file
+        // the compiler pass, which then changes nothing.
+        code.includes("szr(");
         const output = hasSzProp ? transformSzSource(code, id, (message) => this.warn(message)) : unchangedPreTransform(code);
         if (!hasSzProp && shouldProcessSource(id)) {
           recordFileVarMangleEntries(state, id, []);
@@ -4142,6 +4353,11 @@ ${transformedCode}`;
           output.code = themedCode;
           output.transformed = true;
         }
+        const mangleRuntimeCode = injectMangleRuntime(output.code, id);
+        if (mangleRuntimeCode !== null) {
+          output.code = mangleRuntimeCode;
+          output.transformed = true;
+        }
         if (matchesScriptExtension(id, SCRIPT_ID_EXTENSIONS)) {
           assertNoRSCBoundaryViolation(output.code, id);
           const record = createRSCModuleRecord(output.code, id);
@@ -4205,6 +4421,18 @@ ${transformedCode}`;
        * @param compiler - the Webpack compiler instance
        */
       webpack(compiler) {
+        activeFramework = "webpack";
+        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.`
+          );
+        }
         compiler.hooks.beforeCompile.tap("csszyx:prescan", () => {
           announceActiveParser();
           const root = compiler.context || process.cwd();
@@ -4225,6 +4453,16 @@ ${transformedCode}`;
           });
         }
       },
+      rollup: {
+        /** Records the rollup lane for the mangle-runtime gate. */
+        buildStart() {
+          activeFramework = "rollup";
+          const meta = this.meta;
+          if (meta?.watchMode) {
+            crossModuleRegistryEnabled = false;
+          }
+        }
+      },
       vite: {
         /**
          * Vite hook: pre-scans source files when config is resolved.
@@ -4232,11 +4470,16 @@ ${transformedCode}`;
          * @param config - the resolved Vite configuration object
          */
         configResolved(config) {
+          activeFramework = "vite";
           announceActiveParser();
           const root = config.root || process.cwd();
           state.rootDir = root;
           if (config.command === "serve") {
             manglingEnabled = false;
+            crossModuleRegistryEnabled = false;
+          }
+          if (config.build?.watch) {
+            crossModuleRegistryEnabled = false;
           }
           evictTransformCacheOnce();
           prescanAndWriteClasses();
@@ -4338,8 +4581,12 @@ ${transformedCode}`;
               mode: "script",
               minify: process.env.NODE_ENV === "production",
               varMangleMap: state.varMangleMap,
-              globalVarAliasPrefix
+              globalVarAliasPrefix,
+              installRuntimeObject: deliverMapInHtml
             });
+            if (manglingEnabled) {
+              sizeAccount.channels.add("html");
+            }
             if (state.recoveryTokens.size > 0) {
               const isProduction = process.env.NODE_ENV === "production";
               const { manifest, strippedDevOnlyPaths } = buildRecoveryManifest(
@@ -4388,7 +4635,7 @@ ${transformedCode}`;
     return manifest;
   }
   function rewriteOutputCss(source, file, shouldMangle, mangledSources, externalClasses) {
-    let css = rewriteCssWithValidatedGlobalVarPlan(
+    const css = rewriteCssWithValidatedGlobalVarPlan(
       source,
       file,
       state.globalVarValidationResult
@@ -4401,8 +4648,9 @@ ${transformedCode}`;
       });
       for (const className of result.mangledClasses) mangledSources.add(className);
       for (const className of result.unmangledClasses) externalClasses.add(className);
-      if (result.transformedCount > 0) css = result.css;
-      return css;
+      const mangled = result.transformedCount > 0 ? result.css : css;
+      recordCssPair(sizeAccount, css, mangled);
+      return mangled;
     } catch (error) {
       if (isCssSyntaxError(error)) return css;
       throw error;
@@ -4414,6 +4662,16 @@ ${transformedCode}`;
       collectMangleHybridHazards(state.mangleMap, mangledSources, externalClasses)
     );
     if (message) console.warn(message);
+    reportMangleSize();
+  }
+  function reportMangleSize() {
+    const verdict = computeMangleSizeVerdict(
+      sizeAccount,
+      JSON.stringify(createHydrationMangleMap(state.mangleMap, state.varMangleMap))
+    );
+    const message = mangleSizeMessage(verdict);
+    if (message) console.warn(message);
+    resetMangleSizeAccount(sizeAccount);
   }
   function rewriteWebpackCodeAsset(file, source, shouldMangle, compilation, compiler) {
     if (shouldMangle && file.endsWith(".html")) {
@@ -4598,4 +4856,4 @@ const esbuildPlugin = (options = {}) => {
   };
 };
 
-export { vitePlugin as $, isPackagesSkippedSource as A, isRSCServerModule as B, isTailwindReservedGlobalVar as C, mangleCodeClassesSync as D, mangleEligibleClasses as E, mangleHybridHazardMessage as F, mergeThemes as G, missingTailwindEntryMessage as H, normalizeGlobalVarAliasesForCache as I, parseThemeBlocks as J, planGlobalVarAliases as K, readGlobalVarScanCache as L, recordGlobalVarSourceFile as M, resolveCompileSourceDirs as N, resolveGlobalVarScanCacheDir as O, resolveNativeCacheIdentity as P, rewriteGlobalVarCssAliases as Q, rollupPlugin as R, scanCustomPropertyNames as S, scanGlobalVarCss as T, shouldEmitWarning as U, shouldTrackGlobalVarSources as V, shouldWarnMissingTailwindEntry as W, shouldWarnUnscopedMonorepo as X, skippedSzFilesMessage as Y, unscopedMonorepoMessage as Z, validateGlobalVarAliasInputs as _, appendTailwindSourceDirective as a, webpackPlugin as a0, writeGlobalVarScanCache as a1, assertNoRSCBoundaryViolation as b, assertNoRSCGraphViolation as c, collectMangleHybridHazards as d, computeSafelistRelPath as e, createGlobalVarAliasValidationOptions as f, createGlobalVarMapAssetSource as g, createGlobalVarScanCacheKey as h, createRSCModuleRecord as i, cssHasContentScope as j, cssImportsTailwind as k, deleteRSCModuleRecord as l, esbuildPlugin as m, extractGlobalVarAliasesForManifest as n, fileMayContainSafelistableSz as o, findLocalImportSources as p, findRSCBoundaryViolation as q, findRSCGraphViolation as r, hasInjectableTailwindCandidate as s, hasTokens as t, unplugin as u, hasUseClientDirective as v, hasUseServerDirective as w, isCompileSourceOptedIn as x, isHardIgnoredPath as y, isMonorepoPackage as z };
+export { skippedSzFilesMessage as $, isHardIgnoredPath as A, isMonorepoPackage as B, isPackagesSkippedSource as C, isRSCServerModule as D, isTailwindReservedGlobalVar as E, mangleCodeClassesSync as F, mangleEligibleClasses as G, mangleHybridHazardMessage as H, mergeThemes as I, missingTailwindEntryMessage as J, normalizeGlobalVarAliasesForCache as K, parseThemeBlocks as L, planGlobalVarAliases as M, readGlobalVarScanCache as N, recordGlobalVarSourceFile as O, resolveCompileSourceDirs as P, resolveGlobalVarScanCacheDir as Q, resolveNativeCacheIdentity as R, rewriteGlobalVarCssAliases as S, rollupPlugin as T, scanCustomPropertyNames as U, scanGlobalVarCss as V, shouldEmitMissingCssFallback as W, shouldEmitWarning as X, shouldTrackGlobalVarSources as Y, shouldWarnMissingTailwindEntry as Z, shouldWarnUnscopedMonorepo as _, allocateMangleTokens as a, unscopedMonorepoMessage as a0, validateGlobalVarAliasInputs as a1, vitePlugin as a2, webpackPlugin as a3, writeGlobalVarScanCache as a4, 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, hasTokens as w, hasUseClientDirective as x, hasUseServerDirective as y, isCompileSourceOptedIn as z };