@csszyx/unplugin 0.11.10 → 0.12.0

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

@@ -13,10 +13,11 @@ const svelteAdapter = require('@csszyx/svelte-adapter');
 const types = require('@csszyx/types');
 const vueAdapter = require('@csszyx/vue-adapter');
 const unplugin$1 = require('unplugin');
-const transformCache = require('./unplugin.CKIOVNOg.cjs');
+const transformCache = require('./unplugin.DbZ7tCfN.cjs');
 const cssMangler = require('../css-mangler.cjs');
-const runtimeImportScan = require('./unplugin.Cnxm1DcC.cjs');
+const nextRuntimeInjection = require('./unplugin.C2lHQFii.cjs');
 const htmlEscape = require('./unplugin.BkRah5Ot.cjs');
+const node_zlib = require('node:zlib');
 const postcss = require('postcss');
 const valueParser = require('postcss-value-parser');
 
@@ -1883,17 +1884,19 @@ function injectMangleMapScript(html, mangleMap, options = {}) {
   const {
     prettyPrint = false,
     varMangleMap = {},
-    globalVarAliasPrefix = types.CSSZYX_GLOBAL_ALIAS_PREFIX
+    globalVarAliasPrefix = types.CSSZYX_GLOBAL_ALIAS_PREFIX,
+    installRuntimeObject = true
   } = options;
   const checksumMap = createHydrationMangleMap(mangleMap, varMangleMap);
   const jsonContent = safeJsonForScriptTag(checksumMap, prettyPrint);
-  const classMapContent = safeJsonForScriptTag(mangleMap);
   const varMapContent = safeJsonForScriptTag(varMangleMap);
+  const reuseChecksumPayload = Object.keys(varMangleMap).length === 0;
+  const classMapExpr = reuseChecksumPayload ? '(function(){var e=document.getElementById("__CSSZYX_MANGLE_MAP__");return e?JSON.parse(e.textContent):{}})()' : safeJsonForScriptTag(mangleMap);
   const scriptTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json">${jsonContent}<\/script>`;
   const prefixContent = safeJsonForScriptTag(globalVarAliasPrefix);
-  const debugScript = `<script>(function(){var m=${classMapContent};var vm=${varMapContent};var gp=${prefixContent};var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}var cs=document.documentElement.getAttribute("data-sz-checksum")||"";window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:cs,decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()<\/script>`;
-  const combined = `${scriptTag}
-${debugScript}`;
+  const debugScript = `<script>(function(){var m=${classMapExpr};var vm=${varMapContent};var gp=${prefixContent};var r={};var vr={};for(var k in m)r[m[k]]=k;for(var vk in vm){var vv=vm[vk];var vs=Array.isArray(vv)?vv:[vv];for(var vi=0;vi<vs.length;vi++)(vr[vs[vi]]||(vr[vs[vi]]=[])).push(vk)}var cs=document.documentElement.getAttribute("data-sz-checksum")||"";window.__csszyx={mangleMap:m,varMangleMap:vm,checksum:cs,decode:function(c){return r[c]},encode:function(c){return m[c]},decodeVar:function(v){return vr[v]||[]},encodeVar:function(v){return vm[v]},decodeGlobalVar:function(v){var a=vr[v]||[];return v.indexOf(gp)===0?a[0]:void 0},decodeAll:function(el){return(el.className||"").split(" ").map(function(c){return r[c]||c})}}})()<\/script>`;
+  const combined = installRuntimeObject ? `${scriptTag}
+${debugScript}` : scriptTag;
   if (html.includes("</head>")) {
     return html.replace("</head>", `${combined}
 </head>`);
@@ -1998,6 +2001,42 @@ function escapeForDoubleQuotedString(value) {
   return htmlEscape.escapeDoubleQuotedString(value);
 }
 
+function createMangleSizeAccount() {
+  return { cssGzBefore: 0, cssGzAfter: 0, channels: /* @__PURE__ */ new Set() };
+}
+function resetMangleSizeAccount(account) {
+  account.cssGzBefore = 0;
+  account.cssGzAfter = 0;
+  account.channels.clear();
+}
+function gzipBytes(text) {
+  if (text.length === 0) return 0;
+  return node_zlib.gzipSync(Buffer.from(text, "utf8")).length;
+}
+function recordCssPair(account, before, after) {
+  if (before === after) {
+    const bytes = gzipBytes(before);
+    account.cssGzBefore += bytes;
+    account.cssGzAfter += bytes;
+    return;
+  }
+  account.cssGzBefore += gzipBytes(before);
+  account.cssGzAfter += gzipBytes(after);
+}
+function computeMangleSizeVerdict(account, mapPayload) {
+  const channels = htmlEscape.sortStrings(account.channels);
+  const mapCost = gzipBytes(mapPayload) * channels.length;
+  const cssSaving = account.cssGzBefore - account.cssGzAfter;
+  return { mapCost, cssSaving, net: mapCost - cssSaving, channels };
+}
+function mangleSizeMessage(verdict) {
+  if (verdict.channels.length === 0) return null;
+  if (verdict.net <= 0) return null;
+  const cssPart = verdict.cssSaving >= 0 ? `the mangled CSS saves ${verdict.cssSaving} B` : `the mangled CSS COSTS ${-verdict.cssSaving} B (short tokens compress worse than the names they replaced)`;
+  const channelPart = verdict.channels.length > 1 ? `${verdict.channels.join(" + ")} (${verdict.channels.length} copies)` : verdict.channels[0];
+  return `[csszyx] production.mangle is making this build BIGGER: +${verdict.net} B gzipped. The runtime mangle map costs ${verdict.mapCost} B via ${channelPart}, while ${cssPart}. Mangling is a name-obfuscation feature; over a compressed response it does not reduce payload, because utility class names compress far better than the map they need. If you enabled it for size, set \`production.mangle: false\`. If you enabled it to hide class names, this is the expected price and you can ignore this. Narrowing \`production.mangleMapDelivery\` removes a map copy when only one channel is needed. (Measured on CSS and the map; class shortening inside JS chunks is not counted, so the real net is slightly better than this figure.)`;
+}
+
 function isParserMode(value) {
   return value === "rust" || value === "oxc" || value === "babel";
 }
@@ -2042,6 +2081,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 = transformCache.normalizePathSeparators(filePath);
+  const qualifies = content.includes("szv(") && content.includes("export");
+  const entries = qualifies ? compiler.extractSzvRegistryEntries(content, filePath) : [];
+  if (entries.length === 0) {
+    registry.delete(key);
+    return;
+  }
+  const byName = {};
+  for (const entry of entries) {
+    byName[entry.exportName] = entry.config;
+  }
+  registry.set(key, byName);
+}
+const SPECIFIER_PROBES = ["", ".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx"];
+function resolveCrossModuleStaticsFor(registry, filename, source) {
+  if (registry.size === 0 || !source.includes("from")) return void 0;
+  const directory = path__namespace.dirname(filename);
+  let resolved;
+  for (const match of source.matchAll(/from\s*['"](\.[^'"]*)['"]/g)) {
+    const specifier = match[1];
+    if (resolved?.[specifier] !== void 0) continue;
+    const base = transformCache.normalizePathSeparators(path__namespace.resolve(directory, specifier));
+    for (const probe of SPECIFIER_PROBES) {
+      const entries = registry.get(`${base}${probe}`);
+      if (entries !== void 0) {
+        resolved ??= {};
+        resolved[specifier] = entries;
+        break;
+      }
+    }
+  }
+  return resolved;
+}
+
 function generateThemeDts(opts) {
   const { theme, sourceFiles } = opts;
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
@@ -2157,7 +2231,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) {
@@ -2169,8 +2243,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,
@@ -2195,9 +2317,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;
@@ -2231,9 +2350,9 @@ let _hasWarnedTransformCacheVersion = false;
 let _hasWarnedNativeFallback = false;
 const _loggedActiveParsers = /* @__PURE__ */ new Set();
 const _babelFallbackFiles = /* @__PURE__ */ new Set();
-const requireFromHere = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.CRuVOB4Q.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.BK3XVHe8.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.CRuVOB4Q.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.BK3XVHe8.cjs', document.baseURI).href))),
   UNKNOWN_PACKAGE_VERSION
 );
 const COMPILER_VERSION = findPackageVersionFromModule("@csszyx/compiler", UNKNOWN_PACKAGE_VERSION);
@@ -2386,6 +2505,13 @@ function shouldEmitWarning(quiet, devOnly, isProduction) {
   }
   return true;
 }
+function shouldEmitMissingCssFallback(quiet, message) {
+  return !quiet && compiler.szFallbackConsequenceOf(message) === "missing-css";
+}
+function emitMissingCssFallback(quiet, message, id, emit) {
+  if (shouldEmitMissingCssFallback(quiet, message)) emit(`[csszyx] ${id}
+  ${message}`);
+}
 function normalizeForMatch(p) {
   const n = transformCache.normalizePathSeparators(p);
   return n.length > 1 && n.endsWith("/") ? n.slice(0, -1) : n;
@@ -2453,6 +2579,30 @@ function fileMayContainSafelistableSz(content) {
 function mangleEligibleClasses(ownedClasses, authoredClasses) {
   return compiler.sortStrings([...ownedClasses].filter((className) => !authoredClasses.has(className)));
 }
+const tokenByIndex = [];
+function tokenAt(index) {
+  const cached = tokenByIndex[index];
+  if (cached !== void 0) {
+    return cached;
+  }
+  const fresh = core.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")) {
@@ -2867,7 +3017,7 @@ function matchesScriptExtension(id, extensions) {
   return extensions.some((ext) => id.endsWith(ext) || id.includes(`${ext}?`));
 }
 function insertRuntimeImport(code, importStmt) {
-  return runtimeImportScan.insertAfterUseDirective(code, importStmt);
+  return nextRuntimeInjection.insertAfterUseDirective(code, importStmt);
 }
 function scanClassExpression(source, from) {
   let depth = 0;
@@ -3123,8 +3273,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 ?? types.DEFAULT_BUILD_CONFIG.cache) !== false;
@@ -3350,6 +3511,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 = transformCache.resolveTransformCacheDir(state.rootDir, options.build?.cacheDir);
     if (cacheEnabled) {
       evictTransformCacheOnce();
@@ -3461,6 +3630,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
     };
@@ -3672,6 +3845,7 @@ function createCsszyxPlugins(options = {}) {
   }
   function prescanAndWriteClasses() {
     refreshCompileSourceDirs();
+    szvCrossModuleRegistry.clear();
     const prescanStarted = node_perf_hooks.performance.now();
     const discoveredClasses = /* @__PURE__ */ new Set();
     const rawDiscoveredClasses = /* @__PURE__ */ new Set();
@@ -3688,10 +3862,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 {
@@ -3850,18 +4029,15 @@ function createCsszyxPlugins(options = {}) {
     }
   }
   function finalizeMangleMap() {
-    const newMap = {};
-    let tokenIndex = 0;
-    for (const className of mangleEligibleClasses(state.ownedClasses, state.authoredClasses)) {
-      let token = core.encode(tokenIndex);
-      while (mangleReserved.has(token) || state.authoredClasses.has(token)) {
-        tokenIndex++;
-        token = core.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 = core.compute_mangle_checksum(
       createHydrationMangleMap(state.mangleMap, state.varMangleMap)
@@ -3894,14 +4070,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;
@@ -3914,6 +4091,9 @@ function createCsszyxPlugins(options = {}) {
       usesMerge: false,
       usesSzcn: false,
       usesSzPart: false,
+      usesSzvPick: false,
+      usesSzvPick1: false,
+      szPartArgsProvable: true,
       usesColorVar: false,
       usesSpacingVar: false,
       usesUnitVar: false
@@ -3934,16 +4114,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") || compiler.szFallbackConsequenceOf(message) === "missing-css") {
         continue;
       }
       warn(`[csszyx] ${id}
@@ -3958,6 +4142,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,
@@ -4000,31 +4187,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 nextRuntimeInjection.runtimeHelperGroupsFromUsage(output);
   }
   function injectRuntimeHelpers(code, output) {
-    const imports = requiredRuntimeHelpers(output);
-    const hasRuntimeImport = imports.length > 0 && code.includes("@csszyx/runtime");
-    const needed = hasRuntimeImport ? imports.filter((name) => !runtimeImportScan.importsRuntimeHelper(code, name)) : imports;
-    if (needed.length === 0) return null;
-    const existingImport = runtimeImportScan.findRuntimeImportClause(code);
+    const groups = requiredRuntimeHelpers(output);
+    let result = null;
+    let current = code;
+    if (groups.merge.length > 0 && !current.includes("@csszyx/runtime/merge")) {
+      current = insertRuntimeImport(
+        current,
+        `import { ${groups.merge.join(", ")} } from '@csszyx/runtime/merge';
+`
+      );
+      result = current;
+    }
+    const imports = groups.barrel;
+    const hasRuntimeImport = imports.length > 0 && current.includes("@csszyx/runtime");
+    const needed = hasRuntimeImport ? imports.filter((name) => !nextRuntimeInjection.importsRuntimeHelper(current, name)) : imports;
+    if (needed.length === 0) return result;
+    const existingImport = nextRuntimeInjection.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)) {
@@ -4032,6 +4222,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=")) {
@@ -4075,7 +4277,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.
@@ -4096,6 +4298,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({
@@ -4141,7 +4347,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, []);
@@ -4162,6 +4373,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);
@@ -4225,6 +4441,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();
@@ -4245,6 +4473,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.
@@ -4252,11 +4490,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();
@@ -4358,8 +4601,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(
@@ -4408,7 +4655,7 @@ ${transformedCode}`;
     return manifest;
   }
   function rewriteOutputCss(source, file, shouldMangle, mangledSources, externalClasses) {
-    let css = rewriteCssWithValidatedGlobalVarPlan(
+    const css = rewriteCssWithValidatedGlobalVarPlan(
       source,
       file,
       state.globalVarValidationResult
@@ -4421,8 +4668,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;
@@ -4434,6 +4682,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")) {
@@ -4618,6 +4876,7 @@ const esbuildPlugin = (options = {}) => {
   };
 };
 
+exports.allocateMangleTokens = allocateMangleTokens;
 exports.appendTailwindSourceDirective = appendTailwindSourceDirective;
 exports.assertNoRSCBoundaryViolation = assertNoRSCBoundaryViolation;
 exports.assertNoRSCGraphViolation = assertNoRSCGraphViolation;
@@ -4630,6 +4889,7 @@ exports.createRSCModuleRecord = createRSCModuleRecord;
 exports.cssHasContentScope = cssHasContentScope;
 exports.cssImportsTailwind = cssImportsTailwind;
 exports.deleteRSCModuleRecord = deleteRSCModuleRecord;
+exports.emitMissingCssFallback = emitMissingCssFallback;
 exports.esbuildPlugin = esbuildPlugin;
 exports.extractGlobalVarAliasesForManifest = extractGlobalVarAliasesForManifest;
 exports.fileMayContainSafelistableSz = fileMayContainSafelistableSz;
@@ -4663,6 +4923,7 @@ exports.rewriteGlobalVarCssAliases = rewriteGlobalVarCssAliases;
 exports.rollupPlugin = rollupPlugin;
 exports.scanCustomPropertyNames = scanCustomPropertyNames;
 exports.scanGlobalVarCss = scanGlobalVarCss;
+exports.shouldEmitMissingCssFallback = shouldEmitMissingCssFallback;
 exports.shouldEmitWarning = shouldEmitWarning;
 exports.shouldTrackGlobalVarSources = shouldTrackGlobalVarSources;
 exports.shouldWarnMissingTailwindEntry = shouldWarnMissingTailwindEntry;

package/dist/shared/{unplugin.BZq6FKn2.cjs → unplugin.Bb5TeU9B.cjs}

@@ -2,7 +2,7 @@
 
 const fs = require('node:fs');
 const compiler = require('@csszyx/compiler');
-const transformCache = require('./unplugin.CKIOVNOg.cjs');
+const transformCache = require('./unplugin.DbZ7tCfN.cjs');
 const node_crypto = require('node:crypto');
 const htmlEscape = require('./unplugin.BkRah5Ot.cjs');