@csszyx/unplugin 0.11.11 → 0.13.0

package/dist/shared/{unplugin.B2RUVK6Z.mjs → unplugin.ymMe428s.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, 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 { 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, 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, c as collectSpecifierAliases, h as recordSzvRegistryFile, j as recordSzObjectRegistryFile, k as resolveCrossModuleStaticsFor, r as resolveTransformCacheDir, e as createTransformCacheKey, w as writeTransformCache, l as evictOldTransformCacheEntries, m as mayExportSzvFactories, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, f as readTransformCache, o as evictMemoryCacheToBudget, p as resolveProviderPath, g as babelFallbackReason, d as isReadableProviderFile } from './unplugin.BB0iWSds.mjs';
 import { mangleCSSSync } from '../css-mangler.mjs';
-import { i as importsRuntimeHelper, f as findRuntimeImportClause, a as insertAfterUseDirective } from './unplugin.Lhzkcj-A.mjs';
+import { c as createThemeGroupsModule, e as ensureThemeGroupsFile, R as RESOLVED_VIRTUAL_MODULE_ID, b as createMangleMapModule, d as RESOLVED_VIRTUAL_CHECKSUM_ID, f as createChecksumModule, g as RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID, j as createMangleRuntimeModule, k as RESOLVED_THEME_GROUPS_VIRTUAL_ID, l as isVirtualModule, r as resolveVirtualModule, p as parseThemeBlocks, m as mergeThemes, n as discoverProjectTheme, C as CHECKSUM_PLACEHOLDER, M as MANGLE_MAP_PLACEHOLDER, V as VAR_MANGLE_MAP_PLACEHOLDER, o as importsRuntimeHelper, q as findRuntimeImportClause, T as THEME_GROUPS_VIRTUAL_ID, u as THEME_GROUPS_FILE_MARKER, t as themeGroupsSpecifier, v as MANGLE_RUNTIME_VIRTUAL_ID, w as runtimeHelperGroupsFromUsage, a as insertAfterUseDirective } from './unplugin.5l4RHMQh.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';
 
@@ -291,7 +292,7 @@ function validateCandidates(candidates, definitions, reserved, aliasPrefix) {
         code: "registered-property",
         severity: "error",
         name,
-        message: `Registered custom property ${name} is not aliasable in Phase H v1.`,
+        message: `Registered custom property ${name} cannot be aliased: @property gives it a type and inheritance behaviour that an alias would not carry.`,
         location: registeredDefinition
       });
     }
@@ -1111,237 +1112,6 @@ function maskBlockComment(code, start) {
   return { end, value };
 }
 
-const EMPTY_THEME = {
-  colors: [],
-  spacings: [],
-  fonts: [],
-  textSizes: [],
-  fontWeights: [],
-  radii: [],
-  shadows: [],
-  breakpoints: []
-};
-function findMatchingBrace(source, openBrace) {
-  let depth = 0;
-  for (let index = openBrace; index < source.length; index++) {
-    if (source[index] === "{") {
-      depth++;
-    } else if (source[index] === "}") {
-      depth--;
-      if (depth === 0) {
-        return index;
-      }
-    }
-  }
-  return -1;
-}
-function stripLayerWrappers(css) {
-  let result = "";
-  let i = 0;
-  while (i < css.length) {
-    const layerIdx = css.indexOf("@layer", i);
-    if (layerIdx === -1) {
-      result += css.slice(i);
-      break;
-    }
-    result += css.slice(i, layerIdx);
-    const openBrace = css.indexOf("{", layerIdx);
-    if (openBrace === -1) {
-      result += css.slice(layerIdx);
-      break;
-    }
-    const closeBrace = findMatchingBrace(css, openBrace);
-    if (closeBrace === -1) {
-      result += css.slice(openBrace);
-      break;
-    }
-    result += css.slice(openBrace + 1, closeBrace);
-    i = closeBrace + 1;
-  }
-  return result;
-}
-function themePreludeStart(css, at) {
-  const cursor = at + "@theme".length;
-  const next = css[cursor];
-  const validBoundary = next === "{" || next === " " || next === "	" || next === "\n" || next === "\r";
-  return validBoundary ? cursor : null;
-}
-function readThemeBlock(css, start) {
-  for (let cursor = start; cursor < css.length; cursor++) {
-    const character = css[cursor];
-    if (character === "{") {
-      const close = findMatchingBrace(css, cursor);
-      return {
-        body: close === -1 ? null : css.slice(cursor + 1, close),
-        end: close === -1 ? cursor : close
-      };
-    }
-    if (character === ";" || character === "}" || character === "@") {
-      return { body: null, end: cursor };
-    }
-  }
-  return { body: null, end: css.length };
-}
-function extractThemeBlocks(css) {
-  const blocks = [];
-  let searchFrom = 0;
-  for (; ; ) {
-    const at = css.indexOf("@theme", searchFrom);
-    if (at === -1) {
-      break;
-    }
-    const preludeStart = themePreludeStart(css, at);
-    if (preludeStart === null) {
-      searchFrom = at + "@theme".length;
-      continue;
-    }
-    const match = readThemeBlock(css, preludeStart);
-    if (match.body !== null) blocks.push(match.body);
-    searchFrom = Math.max(match.end, at + "@theme".length);
-  }
-  return blocks;
-}
-function categorizeProperty(prop) {
-  const categoryMap = [
-    ["color-", "colors"],
-    ["spacing-", "spacings"],
-    // `font-weight-` MUST precede `font-`: startsWith would otherwise route
-    // `font-weight-chunky` into font FAMILIES as token "weight-chunky".
-    ["font-weight-", "fontWeights"],
-    ["font-", "fonts"],
-    // `--text-*` defines font-size utilities (text-huge) in Tailwind v4.
-    ["text-", "textSizes"],
-    ["radius-", "radii"],
-    ["shadow-", "shadows"],
-    ["breakpoint-", "breakpoints"]
-  ];
-  for (const [prefix, category] of categoryMap) {
-    if (prop.startsWith(prefix)) {
-      let token = prop.slice(prefix.length);
-      if (category !== "breakpoints") {
-        token = token.replace(/-\d+$/, "");
-      }
-      if (token) {
-        return { category, token };
-      }
-    }
-  }
-  return null;
-}
-function parseThemeBlocks(cssContent) {
-  const result = {
-    colors: /* @__PURE__ */ new Set(),
-    spacings: /* @__PURE__ */ new Set(),
-    fonts: /* @__PURE__ */ new Set(),
-    textSizes: /* @__PURE__ */ new Set(),
-    fontWeights: /* @__PURE__ */ new Set(),
-    radii: /* @__PURE__ */ new Set(),
-    shadows: /* @__PURE__ */ new Set(),
-    breakpoints: /* @__PURE__ */ new Set()
-  };
-  const stripped = stripLayerWrappers(cssContent);
-  const blocks = extractThemeBlocks(stripped);
-  for (const block of blocks) {
-    for (const name of scanCustomPropertyNames(block)) {
-      const categorized = categorizeProperty(name);
-      if (categorized) {
-        result[categorized.category].add(categorized.token);
-      }
-    }
-  }
-  return {
-    colors: sortStrings(result.colors),
-    spacings: sortStrings(result.spacings),
-    fonts: sortStrings(result.fonts),
-    textSizes: sortStrings(result.textSizes),
-    fontWeights: sortStrings(result.fontWeights),
-    radii: sortStrings(result.radii),
-    shadows: sortStrings(result.shadows),
-    breakpoints: sortStrings(result.breakpoints)
-  };
-}
-function mergeThemes(themes) {
-  if (themes.length === 0) {
-    return { ...EMPTY_THEME };
-  }
-  const merged = {
-    colors: /* @__PURE__ */ new Set(),
-    spacings: /* @__PURE__ */ new Set(),
-    fonts: /* @__PURE__ */ new Set(),
-    textSizes: /* @__PURE__ */ new Set(),
-    fontWeights: /* @__PURE__ */ new Set(),
-    radii: /* @__PURE__ */ new Set(),
-    shadows: /* @__PURE__ */ new Set(),
-    breakpoints: /* @__PURE__ */ new Set()
-  };
-  for (const theme of themes) {
-    for (const cat of Object.keys(merged)) {
-      for (const token of theme[cat]) {
-        merged[cat].add(token);
-      }
-    }
-  }
-  return {
-    colors: sortStrings(merged.colors),
-    spacings: sortStrings(merged.spacings),
-    fonts: sortStrings(merged.fonts),
-    textSizes: sortStrings(merged.textSizes),
-    fontWeights: sortStrings(merged.fontWeights),
-    radii: sortStrings(merged.radii),
-    shadows: sortStrings(merged.shadows),
-    breakpoints: sortStrings(merged.breakpoints)
-  };
-}
-function hasTokens(theme) {
-  return Object.values(theme).some((arr) => arr.length > 0);
-}
-function readCustomPropertyName(block, dashes) {
-  let end = dashes + 2;
-  if (end >= block.length || !/[a-z]/.test(block[end])) {
-    return null;
-  }
-  end++;
-  while (end < block.length && /[a-z0-9-]/.test(block[end])) {
-    end++;
-  }
-  return { name: block.slice(dashes + 2, end), end };
-}
-function findCustomPropertyDeclarationEnd(block, nameEnd) {
-  let cursor = nameEnd;
-  while (cursor < block.length && /\s/.test(block[cursor])) {
-    cursor++;
-  }
-  if (block[cursor] === ":") {
-    const valueStart = cursor + 1;
-    const semicolon = block.indexOf(";", valueStart);
-    return semicolon > valueStart ? semicolon + 1 : -1;
-  }
-  return block[nameEnd] === ";" ? nameEnd + 1 : -1;
-}
-function scanCustomPropertyNames(block) {
-  const names = [];
-  let i = 0;
-  while (i < block.length) {
-    const dashes = block.indexOf("--", i);
-    if (dashes === -1) {
-      break;
-    }
-    const property = readCustomPropertyName(block, dashes);
-    if (!property) {
-      i = dashes + 1;
-      continue;
-    }
-    const matchEnd = findCustomPropertyDeclarationEnd(block, property.end);
-    if (matchEnd === -1) {
-      i = dashes + 1;
-      continue;
-    }
-    names.push(property.name);
-    i = matchEnd;
-  }
-  return names;
-}
-
 const REGEX_PREFIXES = new Set("([{:,;=!?&|+-*%^~<>/");
 const REGEX_PREFIX_KEYWORDS = /* @__PURE__ */ new Set([
   "await",
@@ -1711,6 +1481,78 @@ function collectAuthoredClassNames(source) {
   return classes;
 }
 
+const KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
+  "include",
+  "exclude",
+  "compileSources",
+  "contentScopeCheck",
+  "quiet",
+  "mode",
+  "development",
+  "production",
+  "build",
+  "hydration"
+]);
+const RENAMED_KEYS = {
+  // Replaced by the path-based form: package NAMES could not express a
+  // sibling directory outside the project root, and resolving them meant
+  // guessing at workspace layout.
+  compilePackages: "compileSources"
+};
+function nearestKnownConfigKey(key) {
+  const lower = key.toLowerCase();
+  let best = null;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const candidate of KNOWN_TOP_LEVEL_KEYS) {
+    const distance = editDistance(lower, candidate.toLowerCase());
+    if (distance < bestDistance) {
+      bestDistance = distance;
+      best = candidate;
+    }
+  }
+  return best !== null && bestDistance <= Math.max(1, Math.floor(key.length / 4)) ? best : null;
+}
+function editDistance(a, b) {
+  let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+  for (let i = 1; i <= a.length; i += 1) {
+    const current = [i];
+    for (let j = 1; j <= b.length; j += 1) {
+      const substitution = previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1);
+      current.push(Math.min(substitution, previous[j] + 1, current[j - 1] + 1));
+    }
+    previous = current;
+  }
+  return previous[b.length];
+}
+function findUnknownConfigKeys(options) {
+  if (options === null || typeof options !== "object" || Array.isArray(options)) {
+    return [];
+  }
+  const unknown = [];
+  for (const key of Object.keys(options)) {
+    if (KNOWN_TOP_LEVEL_KEYS.has(key)) continue;
+    const renamedTo = RENAMED_KEYS[key];
+    if (renamedTo !== void 0) {
+      unknown.push({ key, renamedTo });
+      continue;
+    }
+    const suggestion = nearestKnownConfigKey(key);
+    unknown.push(suggestion === null ? { key } : { key, suggestion });
+  }
+  return unknown;
+}
+function unknownConfigKeysMessage(unknown) {
+  const lines = unknown.map((entry) => {
+    if (entry.renamedTo !== void 0) {
+      return `  - \`${entry.key}\` was replaced by \`${entry.renamedTo}\``;
+    }
+    return entry.suggestion === void 0 ? `  - \`${entry.key}\`` : `  - \`${entry.key}\` \u2014 did you mean \`${entry.suggestion}\`?`;
+  });
+  return `[csszyx] ${unknown.length} plugin option(s) are not recognized and have no effect:
+${lines.join("\n")}
+An unread option is silent, so whatever you configured it for is not happening.`;
+}
+
 const GLOB_MAGIC_RE = /[*?[\]{}]/;
 const DEFAULT_IGNORED_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".next", ".turbo", "dist", "build"]);
 function normalizeFileId(id) {
@@ -1863,17 +1705,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 +1822,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";
 }
@@ -2093,127 +1973,6 @@ function writeThemeDts(opts) {
   writeFileSync(opts.outputPath, content, "utf-8");
 }
 
-const VIRTUAL_MODULE_ID = "virtual:csszyx/mangle-map";
-const RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
-const THEME_GROUPS_VIRTUAL_ID = "virtual:csszyx/theme-groups";
-const RESOLVED_THEME_GROUPS_VIRTUAL_ID = `\0${THEME_GROUPS_VIRTUAL_ID}`;
-const VIRTUAL_CHECKSUM_ID = "virtual:csszyx/checksum";
-const RESOLVED_VIRTUAL_CHECKSUM_ID = `\0${VIRTUAL_CHECKSUM_ID}`;
-function createMangleMapModule(mangleMap, checksum, varMangleMap = {}, cssVarMetrics = null) {
-  return `/**
- * Auto-generated mangle map for csszyx.
- * This module is generated at build time and contains the mapping
- * from original class names and CSS variable names to mangled names.
- *
- * @generated
- */
-
-export const mangleMap = ${JSON.stringify(mangleMap, null, 2)};
-
-export const varMangleMap = ${JSON.stringify(varMangleMap, null, 2)};
-
-export const cssVarMetrics = ${JSON.stringify(cssVarMetrics, null, 2)};
-
-export const checksum = ${JSON.stringify(checksum)};
-
-export default {
-  mangleMap,
-  varMangleMap,
-  cssVarMetrics,
-  checksum,
-};
-`;
-}
-function createChecksumModule(checksum) {
-  return `/**
- * Auto-generated checksum for csszyx mangle map.
- *
- * @generated
- */
-
-export const checksum = ${JSON.stringify(checksum)};
-
-export default checksum;
-`;
-}
-function isVirtualModule(id) {
-  return id === VIRTUAL_MODULE_ID || id === VIRTUAL_CHECKSUM_ID || id === THEME_GROUPS_VIRTUAL_ID || id === MANGLE_RUNTIME_VIRTUAL_ID;
-}
-function resolveVirtualModule(id) {
-  if (id === VIRTUAL_MODULE_ID) {
-    return RESOLVED_VIRTUAL_MODULE_ID;
-  }
-  if (id === VIRTUAL_CHECKSUM_ID) {
-    return RESOLVED_VIRTUAL_CHECKSUM_ID;
-  }
-  if (id === THEME_GROUPS_VIRTUAL_ID) {
-    return RESOLVED_THEME_GROUPS_VIRTUAL_ID;
-  }
-  if (id === MANGLE_RUNTIME_VIRTUAL_ID) {
-    return RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID;
-  }
-  return void 0;
-}
-const MANGLE_RUNTIME_VIRTUAL_ID = "virtual:csszyx/mangle-runtime";
-const RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID = `\0${MANGLE_RUNTIME_VIRTUAL_ID}`;
-const MANGLE_MAP_PLACEHOLDER = "___CSSZYX_MANGLE_MAP___";
-const VAR_MANGLE_MAP_PLACEHOLDER = "___CSSZYX_VAR_MANGLE_MAP___";
-const CHECKSUM_PLACEHOLDER = "___CSSZYX_CHECKSUM___";
-function createMangleRuntimeModule(globalVarAliasPrefix) {
-  return `/**
- * Auto-generated by csszyx: installs the runtime mangle map from the bundle.
- *
- * @generated
- */
-
-const m = ${MANGLE_MAP_PLACEHOLDER};
-const vm = ${VAR_MANGLE_MAP_PLACEHOLDER};
-const gp = ${JSON.stringify(globalVarAliasPrefix)};
-const checksum = "${CHECKSUM_PLACEHOLDER}";
-
-if (typeof window !== 'undefined' && !window.__csszyx) {
-    const r = {};
-    const vr = {};
-    for (const k in m) r[m[k]] = k;
-    for (const vk in vm) {
-        const vv = vm[vk];
-        const vs = Array.isArray(vv) ? vv : [vv];
-        for (const v of vs) (vr[v] || (vr[v] = [])).push(vk);
-    }
-    window.__csszyx = {
-        mangleMap: m,
-        varMangleMap: vm,
-        checksum,
-        decode: (c) => r[c],
-        encode: (c) => m[c],
-        decodeVar: (v) => vr[v] || [],
-        encodeVar: (v) => vm[v],
-        decodeGlobalVar: (v) => {
-            const a = vr[v] || [];
-            return v.indexOf(gp) === 0 ? a[0] : undefined;
-        },
-        decodeAll: (el) => (el.className || '').split(' ').map((c) => r[c] || c),
-    };
-}
-
-export {};
-`;
-}
-function createThemeGroupsModule(tokens) {
-  const payload = JSON.stringify({
-    colors: tokens.colors,
-    textSizes: tokens.textSizes,
-    fontFamilies: tokens.fontFamilies,
-    fontWeights: tokens.fontWeights
-  });
-  return [
-    "// Auto-generated by csszyx from the @theme blocks in scanned CSS.",
-    "import { registerSzcnGroups } from '@csszyx/runtime';",
-    `registerSzcnGroups(${payload});`,
-    "export {};"
-  ].join("\n");
-}
-
 function registerWebpackAssetProcessor(compiler, processAssets) {
   compiler.hooks.compilation.tap("csszyx:post", (compilation) => {
     const stage = compiler.webpack?.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE_SIZE || compilation.constructor.PROCESS_ASSETS_STAGE_OPTIMIZE_SIZE;
@@ -2402,15 +2161,28 @@ function shouldWarnUnscopedMonorepo(sawTailwindEntry, tailwindEntryScoped, inMon
 function unscopedMonorepoMessage() {
   return '[csszyx] Tailwind content detection is UNSCOPED in a monorepo. Tailwind v4 climbs to the workspace root and scans sibling packages + docs (.md/.mdx/.txt are not ignored), which can generate phantom or broken url() classes and fail the build. Scope it in your Tailwind CSS entry:\n    @import "tailwindcss" source(none);\n    @source ".";   /* this package, relative to the CSS file */\ncsszyx auto-injects @source for its generated classes, so only your own templates need listing. Guide: https://csszyx.com/docs/monorepo-content-scope/\nSilence (if a broad scan is intentional): csszyx({ contentScopeCheck: false }).';
 }
+function resolveQuietMode(quiet) {
+  if (quiet === true || quiet === "all") return "all";
+  if (quiet === "nudges") return "nudges";
+  return "off";
+}
 function shouldEmitWarning(quiet, devOnly, isProduction) {
-  if (quiet) {
+  const mode = resolveQuietMode(quiet);
+  if (mode === "all") {
     return false;
   }
-  if (devOnly && isProduction) {
+  if (devOnly && (isProduction || mode === "nudges")) {
     return false;
   }
   return true;
 }
+function shouldEmitMissingCssFallback(quiet, message) {
+  return resolveQuietMode(quiet) !== "all" && 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;
@@ -2515,11 +2287,13 @@ function isPackagesSkippedSource(id, sourceDirs = []) {
   }
   return !isCompileSourceOptedIn(p, sourceDirs);
 }
-function skippedSzFilesMessage(files) {
+function skippedSzFilesMessage(files, szvExportFiles = []) {
   const list = files.map((file) => `  - ${file}`).join("\n");
-  return `[csszyx] ${files.length} file(s) under packages/ contain \`sz\` but were skipped by ignore rules:
+  const registryClause = szvExportFiles.length === 0 ? "" : `
+${szvExportFiles.length} of them may export \`szv\` factories, so they stay out of the cross-module registry and every importer falls back to the runtime path.`;
+  return `[csszyx] ${files.length} file(s) under packages/ use csszyx but were skipped by ignore rules:
 ${list}
-Add the package directory to \`compileSources\` (or move the file out of packages/) \u2014 otherwise their \`sz\` produces no CSS.`;
+Add the package directory to \`compileSources\` (or move the file out of packages/) \u2014 otherwise their classes never reach the safelist.` + registryClause;
 }
 function computeSafelistRelPath(rootDir, safelistFilename, cssId) {
   const safelistPath = normalizePathSeparators(path.join(rootDir, safelistFilename));
@@ -3160,20 +2934,33 @@ ${errors.join("\n")}`
   if (config?.enabled === true) {
     if (!config.tokens || config.tokens.length === 0) {
       throw new Error(
-        "[csszyx] production.mangleGlobalVars.enabled requires explicit tokens in Phase H v1."
+        "[csszyx] production.mangleGlobalVars.enabled requires explicit tokens. Aliasing a property csszyx was not told about would rename references it cannot see."
       );
     }
     if (config.autoPrefix !== void 0 && config.autoPrefix !== "") {
       throw new Error(
-        "[csszyx] production.mangleGlobalVars.autoPrefix requires CSS pre-scan support and is not enabled in Phase H v1."
+        "[csszyx] production.mangleGlobalVars.autoPrefix is not available: choosing tokens by prefix needs a CSS pre-scan that does not exist yet. List the tokens instead."
       );
     }
   }
 }
 function createCsszyxPlugins(options = {}) {
   assertGlobalVarMangleConfig(options);
-  let manglingEnabled = options.production?.mangle !== false;
+  let manglingEnabled = options.production?.mangle === true;
+  const importedStaticSzEnabled = options.build?.importedStaticSz ?? DEFAULT_IMPORTED_STATIC_SZ;
+  const szvCrossModuleRegistry = /* @__PURE__ */ new Map();
+  const szObjectProvidersExamined = /* @__PURE__ */ new Set();
+  let specifierAliases = [];
   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;
@@ -3195,7 +2982,11 @@ function createCsszyxPlugins(options = {}) {
     );
   }
   const compileSources = options.compileSources ?? [];
-  const quiet = options.quiet === true;
+  const quiet = resolveQuietMode(options.quiet);
+  const unknownConfigKeys = findUnknownConfigKeys(options);
+  if (unknownConfigKeys.length > 0) {
+    emitWarning(unknownConfigKeysMessage(unknownConfigKeys));
+  }
   function emitWarning(message, opts = {}) {
     if (shouldEmitWarning(quiet, opts.devOnly ?? false, process.env.NODE_ENV === "production")) {
       console.warn(message);
@@ -3232,6 +3023,7 @@ function createCsszyxPlugins(options = {}) {
   const state = {
     classes: /* @__PURE__ */ new Set(),
     parsedTheme: null,
+    scanCssTheme: null,
     autoThemeCssFiles: [],
     sawTailwindEntry: false,
     sawAnyCss: false,
@@ -3240,6 +3032,7 @@ function createCsszyxPlugins(options = {}) {
     contentScopeWarningEmitted: false,
     spreadWarnings: /* @__PURE__ */ new Set(),
     skippedSzFiles: /* @__PURE__ */ new Set(),
+    skippedSzvExportFiles: /* @__PURE__ */ new Set(),
     skipWarningEmitted: false,
     classesCapped: false,
     ownedClasses: /* @__PURE__ */ new Set(),
@@ -3334,56 +3127,14 @@ function createCsszyxPlugins(options = {}) {
     }
   }
   function runAutoThemeScan(rootDir) {
-    if (options.build?.scanCss) {
-      return;
-    }
     refreshCompileSourceDirs();
-    const cssFiles = [];
-    const walk = (dir) => {
-      let entries;
-      try {
-        entries = fs.readdirSync(dir, { withFileTypes: true });
-      } catch {
-        return;
-      }
-      for (const entry of entries) {
-        if (entry.isDirectory()) {
-          if (!IGNORE_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
-            walk(path.join(dir, entry.name));
-          }
-          continue;
-        }
-        if (entry.name.endsWith(".css")) {
-          cssFiles.push(path.join(dir, entry.name));
-        }
-      }
-    };
-    walk(rootDir);
-    const normRoot = normalizeForMatch(rootDir);
-    for (const sourceDir of compileSourceDirs) {
-      if (sourceDir === normRoot || sourceDir.startsWith(`${normRoot}/`)) {
-        continue;
-      }
-      walk(sourceDir);
-    }
-    const themes = [];
-    const themeFiles = [];
-    for (const file of cssFiles) {
-      let content;
-      try {
-        content = fs.readFileSync(file, "utf-8");
-      } catch {
-        continue;
-      }
-      if (!content.includes("@theme")) {
-        continue;
-      }
-      themes.push(parseThemeBlocks(content));
-      themeFiles.push(file);
-    }
-    state.autoThemeCssFiles = themeFiles;
-    if (themes.length > 0) {
-      state.parsedTheme = mergeThemes(themes);
+    const discovered = discoverProjectTheme(rootDir, [...compileSourceDirs]);
+    state.autoThemeCssFiles = discovered.files;
+    const sources = [state.scanCssTheme, discovered.theme].filter(
+      (theme) => theme !== null
+    );
+    if (sources.length > 0) {
+      state.parsedTheme = mergeThemes(sources);
     }
   }
   function isHardIgnored(id) {
@@ -3399,6 +3150,18 @@ function createCsszyxPlugins(options = {}) {
   function transformConfiguredSource(source, filename, astBudget) {
     const compilerOptions = createCompilerOptions(astBudget);
     const effectiveFilename = normalizeSourceFilename(filename);
+    const crossModuleStatics = resolveCrossModuleStaticsFor(
+      szvCrossModuleRegistry,
+      filename,
+      source,
+      specifierAliases
+    );
+    if (crossModuleStatics.szvConfigs !== void 0) {
+      compilerOptions.crossModuleStatics = crossModuleStatics.szvConfigs;
+    }
+    if (crossModuleStatics.szObjects !== void 0) {
+      compilerOptions.crossModuleSzObjects = crossModuleStatics.szObjects;
+    }
     const cacheRoot = resolveTransformCacheDir(state.rootDir, options.build?.cacheDir);
     if (cacheEnabled) {
       evictTransformCacheOnce();
@@ -3510,6 +3273,11 @@ 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),
+      crossModuleSzObjects: compilerOptions.crossModuleSzObjects === void 0 ? void 0 : JSON.stringify(compilerOptions.crossModuleSzObjects),
       filename: effectiveFilename,
       source
     };
@@ -3518,19 +3286,35 @@ function createCsszyxPlugins(options = {}) {
     if (parserMode !== "rust" || files.length <= 1) {
       return transformPrescanSourcesIndividually(files);
     }
+    const perFile = [];
+    const batchable = [];
+    for (const file of files) {
+      (hasCrossModuleStatics(file) ? perFile : batchable).push(file);
+    }
+    const individual = transformPrescanSourcesIndividually(perFile);
     const compilerOptions = createCompilerOptions(prescanAstBudget);
     const cacheRoot = resolveTransformCacheDir(state.rootDir, options.build?.cacheDir);
     const results = /* @__PURE__ */ new Map();
     if (cacheEnabled) evictTransformCacheOnce();
     ensureRustTransformAvailable();
-    const misses = collectRustPrescanMisses(files, compilerOptions, cacheRoot, results);
-    if (misses.length === 0) return orderPrescanResults(files, results);
-    try {
-      runRustPrescanBatch(misses, compilerOptions, cacheRoot, results);
-    } catch {
-      runRustPrescanFallback(misses, results);
+    const misses = collectRustPrescanMisses(batchable, compilerOptions, cacheRoot, results);
+    if (misses.length > 0) {
+      try {
+        runRustPrescanBatch(misses, compilerOptions, cacheRoot, results);
+      } catch {
+        runRustPrescanFallback(misses, results);
+      }
     }
-    return orderPrescanResults(files, results);
+    return [...individual, ...orderPrescanResults(batchable, results)];
+  }
+  function hasCrossModuleStatics(file) {
+    const resolved = resolveCrossModuleStaticsFor(
+      szvCrossModuleRegistry,
+      file.filePath,
+      file.content,
+      specifierAliases
+    );
+    return resolved.szvConfigs !== void 0 || resolved.szObjects !== void 0;
   }
   function collectRustPrescanMisses(files, compilerOptions, cacheRoot, results) {
     const misses = [];
@@ -3678,7 +3462,7 @@ function createCsszyxPlugins(options = {}) {
     }
   }
   function recordPackagesSkipIfSz(filePath) {
-    if (!isPackagesSkippedSource(filePath, compileSourceDirs)) {
+    if (state.skippedSzFiles.has(filePath) || !isPackagesSkippedSource(filePath, compileSourceDirs)) {
       return;
     }
     let content;
@@ -3687,8 +3471,12 @@ function createCsszyxPlugins(options = {}) {
     } catch {
       return;
     }
-    if (content.includes("sz=") || content.includes("szs=") || content.includes("sz:")) {
-      state.skippedSzFiles.add(filePath);
+    if (!fileMayContainSafelistableSz(content)) {
+      return;
+    }
+    state.skippedSzFiles.add(filePath);
+    if (mayExportSzvFactories(content)) {
+      state.skippedSzvExportFiles.add(filePath);
     }
   }
   function processPrescanTransform(filePath, content, result, discoveredClasses, rawDiscoveredClasses) {
@@ -3719,12 +3507,73 @@ function createCsszyxPlugins(options = {}) {
     }
     collectPrescanResult(result, filePath, discoveredClasses, rawDiscoveredClasses);
   }
+  function refreshSzvRegistryEntry(filePath, content) {
+    if (!shouldProcessSource(filePath)) return;
+    if (content === null) {
+      szvCrossModuleRegistry.delete(normalizePathSeparators(filePath));
+      return;
+    }
+    recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
+    if (importedStaticSzEnabled) {
+      recordSzObjectRegistryFile(szvCrossModuleRegistry, filePath, content);
+      szObjectProvidersExamined.add(normalizePathSeparators(filePath));
+      recordProvidersDemandedBy(filePath, content);
+    }
+  }
+  function recordProvidersDemandedBy(filePath, content) {
+    if (!fileMayContainSafelistableSz(content)) return;
+    const directory = path.dirname(filePath);
+    for (const specifier of importedSpecifiersIn(content)) {
+      for (const base of specifierBases(specifier, directory, specifierAliases)) {
+        const providerPath = resolveProviderPathWith(base, isReadableProviderFile);
+        if (providerPath === void 0) continue;
+        const key = normalizePathSeparators(providerPath);
+        if (!szObjectProvidersExamined.has(key)) {
+          szObjectProvidersExamined.add(key);
+          readAndRecordSzObjectProvider(providerPath);
+        }
+        break;
+      }
+    }
+  }
+  function readAndRecordSzObjectProvider(providerPath) {
+    let content;
+    try {
+      content = fs.readFileSync(providerPath, "utf-8");
+    } catch {
+      return;
+    }
+    recordSzObjectRegistryFile(szvCrossModuleRegistry, providerPath, content);
+  }
+  function recordDemandedSzObjectProviders(seenSourcePaths, demand) {
+    for (const base of demand) {
+      const providerPath = resolveProviderPath(seenSourcePaths, base);
+      if (providerPath === void 0) continue;
+      szObjectProvidersExamined.add(normalizePathSeparators(providerPath));
+      readAndRecordSzObjectProvider(providerPath);
+    }
+  }
+  function refreshSzvRegistryEntryFromDisk(filePath) {
+    if (!shouldProcessSource(filePath)) return;
+    let content;
+    try {
+      content = fs.readFileSync(filePath, "utf-8");
+    } catch {
+      refreshSzvRegistryEntry(filePath, null);
+      return;
+    }
+    refreshSzvRegistryEntry(filePath, content);
+  }
   function prescanAndWriteClasses() {
     refreshCompileSourceDirs();
+    szvCrossModuleRegistry.clear();
+    szObjectProvidersExamined.clear();
     const prescanStarted = performance.now();
     const discoveredClasses = /* @__PURE__ */ new Set();
     const rawDiscoveredClasses = /* @__PURE__ */ new Set();
     const prescanSources = [];
+    const seenSourcePaths = /* @__PURE__ */ new Set();
+    const szObjectDemand = /* @__PURE__ */ new Set();
     function collectPrescanSource(filePath) {
       if (!shouldProcessSource(filePath)) {
         recordPackagesSkipIfSz(filePath);
@@ -3737,10 +3586,25 @@ function createCsszyxPlugins(options = {}) {
         return;
       }
       recordAuthoredClasses(content);
+      recordSzvRegistryEntries(filePath, content);
+      seenSourcePaths.add(normalizePathSeparators(filePath));
       if (fileMayContainSafelistableSz(content)) {
         prescanSources.push({ filePath, content });
+        recordSzObjectDemand(filePath, content);
       }
     }
+    function recordSzObjectDemand(filePath, content) {
+      if (!importedStaticSzEnabled) return;
+      const directory = path.dirname(filePath);
+      for (const specifier of importedSpecifiersIn(content)) {
+        for (const base of specifierBases(specifier, directory, specifierAliases)) {
+          szObjectDemand.add(base);
+        }
+      }
+    }
+    function recordSzvRegistryEntries(filePath, content) {
+      recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
+    }
     function scanDir(dir) {
       let entries;
       try {
@@ -3768,6 +3632,7 @@ function createCsszyxPlugins(options = {}) {
       }
       scanDir(sourceDir);
     }
+    recordDemandedSzObjectProviders(seenSourcePaths, szObjectDemand);
     const prescanContentByPath = new Map(
       prescanSources.map((file) => [file.filePath, file.content])
     );
@@ -3961,6 +3826,9 @@ function createCsszyxPlugins(options = {}) {
       usesMerge: false,
       usesSzcn: false,
       usesSzPart: false,
+      usesSzvPick: false,
+      usesSzvPick1: false,
+      szPartArgsProvable: true,
       usesColorVar: false,
       usesSpacingVar: false,
       usesUnitVar: false
@@ -3981,16 +3849,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") {
+    if (quiet !== "off" || 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}
@@ -4005,6 +3877,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,
@@ -4047,36 +3922,58 @@ 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 themeGroupTokens() {
+    const theme = state.parsedTheme;
+    return {
+      colors: theme?.colors ?? [],
+      textSizes: theme?.textSizes ?? [],
+      fontFamilies: theme?.fonts ?? [],
+      fontWeights: theme?.fontWeights ?? []
+    };
   }
   function injectThemeGroups(code, transformedCode, id, usesSzcn) {
-    if (!usesSzcn && !/\bszcn\s*\(/.test(code) || transformedCode.includes(THEME_GROUPS_VIRTUAL_ID) || !shouldProcessSource(id)) {
+    if (!usesSzcn && !/\bszcn\s*\(/.test(code) || transformedCode.includes(THEME_GROUPS_VIRTUAL_ID) || transformedCode.includes(THEME_GROUPS_FILE_MARKER) || !shouldProcessSource(id)) {
       return null;
     }
+    if (activeFramework === "webpack") {
+      const groups = ensureThemeGroupsFile(
+        state.rootDir,
+        path.join(state.rootDir, ".csszyx")
+      );
+      if (groups.file === null) return null;
+      const [from] = id.split("?");
+      return `import '${themeGroupsSpecifier(from, groups.file)}';
+${transformedCode}`;
+    }
     return `import '${THEME_GROUPS_VIRTUAL_ID}';
 ${transformedCode}`;
   }
@@ -4086,7 +3983,7 @@ ${transformedCode}`;
     if (activeFramework !== "vite" && activeFramework !== "rollup") {
       return null;
     }
-    if (!manglingEnabled || !shouldProcessSource(id) || !MANGLE_RUNTIME_CONSUMER_RE.test(transformedCode) || transformedCode.includes(MANGLE_RUNTIME_VIRTUAL_ID)) {
+    if (!manglingEnabled || !deliverMapInBundle || !shouldProcessSource(id) || !MANGLE_RUNTIME_CONSUMER_RE.test(transformedCode) || transformedCode.includes(MANGLE_RUNTIME_VIRTUAL_ID)) {
       return null;
     }
     return insertRuntimeImport(transformedCode, `import '${MANGLE_RUNTIME_VIRTUAL_ID}';
@@ -4156,16 +4053,11 @@ ${transformedCode}`;
           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({
-            colors: theme?.colors ?? [],
-            textSizes: theme?.textSizes ?? [],
-            fontFamilies: theme?.fonts ?? [],
-            fontWeights: theme?.fontWeights ?? []
-          });
+          return createThemeGroupsModule(themeGroupTokens());
         }
         return null;
       },
@@ -4179,7 +4071,11 @@ ${transformedCode}`;
         if (shouldProcessCss(id)) {
           return true;
         }
-        return shouldProcessSource(id);
+        if (shouldProcessSource(id)) {
+          return true;
+        }
+        recordPackagesSkipIfSz(id);
+        return false;
       },
       /**
        * Core transform: detects sz prop, compiles to className, injects runtime, collects classes.
@@ -4203,7 +4099,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, []);
@@ -4261,9 +4162,13 @@ ${transformedCode}`;
         }
         if (!state.skipWarningEmitted && state.skippedSzFiles.size > 0) {
           state.skipWarningEmitted = true;
-          emitWarning(skippedSzFilesMessage(sortStrings$1(state.skippedSzFiles)), {
-            devOnly: true
-          });
+          emitWarning(
+            skippedSzFilesMessage(
+              sortStrings$1(state.skippedSzFiles),
+              sortStrings$1(state.skippedSzvExportFiles)
+            ),
+            { devOnly: state.skippedSzvExportFiles.size === 0 }
+          );
         }
         if (state.classesCapped) {
           emitWarning(
@@ -4285,7 +4190,10 @@ ${transformedCode}`;
           recordGlobalVarSourceFile(state, id, null);
           recordFileVarMangleEntries(state, id, []);
           recordFileCSSVariableMetrics(state, id, null);
+          refreshSzvRegistryEntry(id, null);
+          return;
         }
+        refreshSzvRegistryEntryFromDisk(id);
       },
       /**
        * Webpack hook: pre-scans source files before compilation for Tailwind class discovery.
@@ -4293,18 +4201,37 @@ ${transformedCode}`;
        */
       webpack(compiler) {
         activeFramework = "webpack";
+        compiler.hooks?.beforeCompile?.tap?.("csszyx:theme-groups", () => {
+          const root = compiler.context || process.cwd();
+          ensureThemeGroupsFile(root, path.join(root, ".csszyx"));
+        });
         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.`
+          );
+        }
         compiler.hooks.beforeCompile.tap("csszyx:prescan", () => {
           announceActiveParser();
           const root = compiler.context || process.cwd();
           state.rootDir = root;
+          specifierAliases = collectSpecifierAliases(
+            root,
+            compiler.options?.resolve?.alias
+          );
           evictTransformCacheOnce();
           if (state.classes.size === 0) {
             prescanAndWriteClasses();
           }
-          state.parsedTheme = runThemeScan(root, options.build?.scanCss) ?? state.parsedTheme;
+          for (const changed of compiler.modifiedFiles ?? []) {
+            refreshSzvRegistryEntryFromDisk(changed);
+          }
+          for (const removed of compiler.removedFiles ?? []) {
+            refreshSzvRegistryEntry(removed, null);
+          }
+          state.scanCssTheme = runThemeScan(root, options.build?.scanCss) ?? state.scanCssTheme;
           runAutoThemeScan(root);
         });
         if (options.build?.scanCss) {
@@ -4333,12 +4260,13 @@ ${transformedCode}`;
           announceActiveParser();
           const root = config.root || process.cwd();
           state.rootDir = root;
+          specifierAliases = collectSpecifierAliases(root, config.resolve?.alias);
           if (config.command === "serve") {
             manglingEnabled = false;
           }
           evictTransformCacheOnce();
           prescanAndWriteClasses();
-          state.parsedTheme = runThemeScan(root, options.build?.scanCss) ?? state.parsedTheme;
+          state.scanCssTheme = runThemeScan(root, options.build?.scanCss) ?? state.scanCssTheme;
           runAutoThemeScan(root);
         },
         /**
@@ -4357,15 +4285,17 @@ ${transformedCode}`;
               ctx.server.moduleGraph.invalidateModule(themeGroupsModule);
             }
           };
-          if (scanCss) {
+          if (ctx.file.endsWith(".css")) {
             const root = ctx.server.config.root || process.cwd();
-            if (matchesAnyPattern(ctx.file, scanCss, root)) {
-              state.parsedTheme = runThemeScan(root, scanCss) ?? state.parsedTheme;
-              reloadThemeGroupsModule();
+            const before = createThemeGroupsModule(themeGroupTokens());
+            if (scanCss && matchesAnyPattern(ctx.file, scanCss, root)) {
+              state.scanCssTheme = runThemeScan(root, scanCss) ?? state.scanCssTheme;
             }
-          } else if (ctx.file.endsWith(".css")) {
-            runAutoThemeScan(ctx.server.config.root || process.cwd());
+            runAutoThemeScan(root);
             reloadThemeGroupsModule();
+            if (createThemeGroupsModule(themeGroupTokens()) !== before) {
+              ctx.server.ws.send({ type: "full-reload" });
+            }
           }
           if (!shouldProcessSource(ctx.file)) {
             return;
@@ -4374,8 +4304,10 @@ ${transformedCode}`;
           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, []);
@@ -4436,8 +4368,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(
@@ -4486,7 +4422,7 @@ ${transformedCode}`;
     return manifest;
   }
   function rewriteOutputCss(source, file, shouldMangle, mangledSources, externalClasses) {
-    let css = rewriteCssWithValidatedGlobalVarPlan(
+    const css = rewriteCssWithValidatedGlobalVarPlan(
       source,
       file,
       state.globalVarValidationResult
@@ -4499,8 +4435,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;
@@ -4512,6 +4449,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")) {
@@ -4595,7 +4542,9 @@ ${transformedCode}`;
       collectRollupGlobalVarCssAssets(bundle)
     );
     const shouldMangle = manglingEnabled && Object.keys(state.mangleMap).length > 0;
-    emitAsset("csszyx-manifest.json", JSON.stringify(createBundleManifest(shouldMangle)));
+    if (options.build?.emitManifest === true) {
+      emitAsset("csszyx-manifest.json", JSON.stringify(createBundleManifest(shouldMangle)));
+    }
     if (shouldEmitGlobalVarMapAsset(globalVarMangleConfig)) {
       const globalVarMap = createGlobalVarMapAssetSource(
         state.varMangleMap,
@@ -4696,4 +4645,4 @@ const esbuildPlugin = (options = {}) => {
   };
 };
 
-export { validateGlobalVarAliasInputs as $, isMonorepoPackage as A, isPackagesSkippedSource as B, isRSCServerModule as C, isTailwindReservedGlobalVar as D, mangleCodeClassesSync as E, mangleEligibleClasses as F, mangleHybridHazardMessage as G, mergeThemes as H, missingTailwindEntryMessage as I, normalizeGlobalVarAliasesForCache as J, parseThemeBlocks as K, planGlobalVarAliases as L, readGlobalVarScanCache as M, recordGlobalVarSourceFile as N, resolveCompileSourceDirs as O, resolveGlobalVarScanCacheDir as P, resolveNativeCacheIdentity as Q, rewriteGlobalVarCssAliases as R, rollupPlugin as S, scanCustomPropertyNames as T, scanGlobalVarCss as U, shouldEmitWarning as V, shouldTrackGlobalVarSources as W, shouldWarnMissingTailwindEntry as X, shouldWarnUnscopedMonorepo as Y, skippedSzFilesMessage as Z, unscopedMonorepoMessage as _, allocateMangleTokens as a, vitePlugin as a0, webpackPlugin as a1, writeGlobalVarScanCache as a2, 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, esbuildPlugin as n, extractGlobalVarAliasesForManifest as o, fileMayContainSafelistableSz as p, findLocalImportSources as q, findRSCBoundaryViolation as r, findRSCGraphViolation as s, hasInjectableTailwindCandidate as t, unplugin as u, hasTokens as v, hasUseClientDirective as w, hasUseServerDirective as x, isCompileSourceOptedIn as y, isHardIgnoredPath as z };
+export { vitePlugin as $, isMonorepoPackage as A, isPackagesSkippedSource as B, isRSCServerModule as C, isTailwindReservedGlobalVar as D, mangleCodeClassesSync as E, mangleEligibleClasses as F, mangleHybridHazardMessage as G, missingTailwindEntryMessage as H, normalizeGlobalVarAliasesForCache as I, planGlobalVarAliases as J, readGlobalVarScanCache as K, recordGlobalVarSourceFile as L, resolveCompileSourceDirs as M, resolveGlobalVarScanCacheDir as N, resolveNativeCacheIdentity as O, resolveQuietMode as P, rewriteGlobalVarCssAliases as Q, rollupPlugin as R, scanGlobalVarCss as S, shouldEmitMissingCssFallback as T, shouldEmitWarning as U, shouldTrackGlobalVarSources as V, shouldWarnMissingTailwindEntry as W, shouldWarnUnscopedMonorepo as X, skippedSzFilesMessage as Y, unscopedMonorepoMessage as Z, validateGlobalVarAliasInputs as _, allocateMangleTokens as a, webpackPlugin as a0, writeGlobalVarScanCache as a1, 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, isCompileSourceOptedIn as y, isHardIgnoredPath as z };