@csszyx/unplugin 0.15.3 → 0.17.0

package/dist/shared/{unplugin.ZqxgHk5F.cjs → unplugin.9zs6T4Gf.cjs}

@@ -13,10 +13,12 @@ const svelteAdapter = require('@csszyx/svelte-adapter');
 const types = require('@csszyx/types');
 const vueAdapter = require('@csszyx/vue-adapter');
 const unplugin$1 = require('unplugin');
-const safelistSource = require('./unplugin.DDSWQJYX.cjs');
-const transformCache = require('./unplugin.BzF0V2kw.cjs');
+const safelistSource = require('./unplugin.DS6CFjim.cjs');
+const transformCache = require('./unplugin.YcnV3Izb.cjs');
 const cssMangler = require('../css-mangler.cjs');
-const themeGroupsFile = require('./unplugin.J6ue_lRJ.cjs');
+const nextRuntimeInjection = require('./unplugin.Defu9wGh.cjs');
+const pathNormalization = require('./unplugin.BqKLlo1h.cjs');
+const themeGroupsFile = require('./unplugin.2qOISpzl.cjs');
 const node_zlib = require('node:zlib');
 const postcss = require('postcss');
 const valueParser = require('postcss-value-parser');
@@ -543,8 +545,8 @@ function createRSCModuleRecord(code, id) {
 }
 function deleteRSCModuleRecord(records, id) {
   const normalized = normalizeModuleId(id);
-  const clean = safelistSource.normalizePathSeparators(id.split("?")[0] ?? id);
-  const resolved = safelistSource.normalizePathSeparators(path__namespace.resolve(clean));
+  const clean = pathNormalization.normalizePathSeparators(id.split("?")[0] ?? id);
+  const resolved = pathNormalization.normalizePathSeparators(path__namespace.resolve(clean));
   pruneRSCModulePathCaches(/* @__PURE__ */ new Set([normalized, resolved, clean]));
   let deleted = records.delete(normalized);
   if (resolved !== normalized) {
@@ -590,7 +592,7 @@ const APP_ROUTER_ENTRIES = /* @__PURE__ */ new Set([
   "route"
 ]);
 function isNextAppRouterEntry(id) {
-  const clean = safelistSource.normalizePathSeparators(id.split("?")[0] ?? id);
+  const clean = pathNormalization.normalizePathSeparators(id.split("?")[0] ?? id);
   if (!clean.includes("/app/") && !clean.startsWith("app/")) return false;
   const basename = clean.split("/").pop() ?? "";
   const dotIdx = basename.indexOf(".");
@@ -945,9 +947,9 @@ function normalizeModuleId(id) {
   }
   let normalized;
   try {
-    normalized = safelistSource.normalizePathSeparators(fs__namespace.realpathSync.native(clean));
+    normalized = pathNormalization.normalizePathSeparators(fs__namespace.realpathSync.native(clean));
   } catch {
-    normalized = safelistSource.normalizePathSeparators(path__namespace.resolve(clean));
+    normalized = pathNormalization.normalizePathSeparators(path__namespace.resolve(clean));
   }
   normalizedModuleIdCache.set(clean, normalized);
   return normalized;
@@ -993,7 +995,7 @@ function resolveLocalModule(importer, source) {
 }
 function pruneRSCModulePathCaches(moduleIds) {
   for (const [key, value] of normalizedModuleIdCache) {
-    const normalizedKey = safelistSource.normalizePathSeparators(key);
+    const normalizedKey = pathNormalization.normalizePathSeparators(key);
     if (moduleIds.has(value) || moduleIds.has(normalizedKey)) {
       normalizedModuleIdCache.delete(key);
     }
@@ -1621,10 +1623,10 @@ 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) {
-  return safelistSource.normalizePathSeparators(id.split(/[?#]/, 1)[0]);
+  return pathNormalization.normalizePathSeparators(id.split(/[?#]/, 1)[0]);
 }
 function normalizeRoot(rootDir) {
-  return safelistSource.normalizePathSeparators(path__namespace.resolve(rootDir));
+  return pathNormalization.normalizePathSeparators(path__namespace.resolve(rootDir));
 }
 function hasGlobMagic(pattern) {
   return GLOB_MAGIC_RE.test(pattern);
@@ -1633,7 +1635,7 @@ function escapeRegExp(ch) {
   return /[|\\{}()[\]^$+?.]/.test(ch) ? `\\${ch}` : ch;
 }
 function globToRegExp(pattern) {
-  const normalized = safelistSource.normalizePathSeparators(pattern);
+  const normalized = pathNormalization.normalizePathSeparators(pattern);
   let out = "^";
   for (let i = 0; i < normalized.length; i++) {
     const ch = normalized[i];
@@ -1656,7 +1658,7 @@ function globToRegExp(pattern) {
 function relativeToRoot(file, rootDir) {
   const root = normalizeRoot(rootDir);
   const normalizedFile = normalizeFileId(file);
-  return safelistSource.normalizePathSeparators(path__namespace.posix.relative(root, normalizedFile));
+  return pathNormalization.normalizePathSeparators(path__namespace.posix.relative(root, normalizedFile));
 }
 function matchesPattern(id, pattern, rootDir) {
   const file = normalizeFileId(id);
@@ -1665,7 +1667,7 @@ function matchesPattern(id, pattern, rootDir) {
     pattern.lastIndex = 0;
     return pattern.test(file) || pattern.test(relative);
   }
-  const normalizedPattern = safelistSource.normalizePathSeparators(pattern);
+  const normalizedPattern = pathNormalization.normalizePathSeparators(pattern);
   if (hasGlobMagic(normalizedPattern)) {
     const re = globToRegExp(normalizedPattern);
     return re.test(file) || re.test(relative);
@@ -1801,24 +1803,10 @@ function injectMangleMapScript(html, mangleMap, options = {}) {
   const scriptTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json">${safeJsonForScriptTag(checksumMap, prettyPrint)}<\/script>`;
   return withScriptTag(html, scriptTag);
 }
-function injectMangleMapAttribute(html, mangleMap, minify = false, varMangleMap = {}) {
-  const attrName = minify ? "data-sz-m" : "data-sz-map";
-  const jsonContent = JSON.stringify(createHydrationMangleMap(mangleMap, varMangleMap));
-  return injectHtmlOpeningAttr(html, ` ${attrName}='${jsonContent}'`);
-}
 function injectHydrationData(html, mangleMap, checksum, options = {}) {
-  const { mode = "script", minify = false } = options;
-  let result = html;
-  result = injectChecksum(result, checksum, minify);
-  if (mode === "inline") {
-    result = injectMangleMapAttribute(result, mangleMap, minify, options.varMangleMap);
-  } else if (mode === "script") {
-    result = injectMangleMapScript(result, mangleMap, options);
-  } else if (mode === "both") {
-    result = injectMangleMapAttribute(result, mangleMap, minify, options.varMangleMap);
-    result = injectMangleMapScript(result, mangleMap, options);
-  }
-  return result;
+  const { minify = false, census = true } = options;
+  const result = injectChecksum(html, checksum, minify);
+  return census ? injectMangleMapScript(result, mangleMap, options) : result;
 }
 function transformIndexHtml(html, mangleMap, checksum, options = {}) {
   return injectHydrationData(html, mangleMap, checksum, options);
@@ -1932,13 +1920,25 @@ function needsRuntimeMangleRegistration(manglingEnabled, mangleMap) {
   if (!manglingEnabled) return false;
   return Object.keys(mangleMap).length > 0;
 }
+function removedInjectChecksumMessage() {
+  return "[csszyx] production.injectChecksum has been removed and was never read. The hydration checksum and the inert census ship on every production build, and no option turned them off \u2014 a build that set this to false still carried both. Delete the option. The census carries no class entries when production.mangle is off, and both tags are data, not script: see https://csszyx.com/docs/security/";
+}
 function removedMangleMapDeliveryMessage() {
   return "[csszyx] production.mangleMapDelivery has been removed and is ignored. The runtime mangle map is always registered from inside the JS bundle now, on every lane, so the built HTML never carries an executable inline <script> and a strict script-src 'self' policy needs no exception. Delete the option. (`window.__csszyx` is now opt-in through `production.mangleDebugGlobal`.)";
 }
 
+function utilityStart(className) {
+  let depth = 0;
+  let start = 0;
+  for (let index = 0; index < className.length; index += 1) {
+    const char = className[index];
+    if (char === "[") depth += 1;
+    else if (char === "]") depth = Math.max(0, depth - 1);
+    else if (char === ":" && depth === 0) start = index + 1;
+  }
+  return start;
+}
 function compileManglePreserve(entries) {
-  const exact = /* @__PURE__ */ new Set();
-  const prefixes = [];
   const list = entries ?? [];
   list.forEach((entry, index) => {
     if (typeof entry !== "string" || entry.length === 0) {
@@ -1951,22 +1951,34 @@ function compileManglePreserve(entries) {
         "[csszyx] production.manglePreserve must not contain a lone `*`: it would keep every class and silently turn `production.mangle` into a no-op. Name a prefix (`bg-tag-*`) or set `production.mangle: false`."
       );
     }
-    if (entry.endsWith("*")) prefixes.push(entry.slice(0, -1));
-    else exact.add(entry);
   });
-  const test = (className) => exact.has(className) || prefixes.some((prefix) => className.startsWith(prefix));
+  const compiled = list.map((value) => ({
+    value,
+    prefix: value.endsWith("*") ? value.slice(0, -1) : void 0
+  }));
+  const keeps = (entry, className, utilityStartIndex) => entry.prefix === void 0 ? className === entry.value || className.length - utilityStartIndex === entry.value.length && className.startsWith(entry.value, utilityStartIndex) : className.startsWith(entry.prefix) || className.startsWith(entry.prefix, utilityStartIndex);
+  const test = (className) => {
+    if (list.length === 0) return false;
+    const start = utilityStart(className);
+    return compiled.some((entry) => keeps(entry, className, start));
+  };
   return {
     entries: list,
     test,
     unmatched(census) {
-      const names = [...census];
-      return list.filter((entry) => {
-        if (entry.endsWith("*")) {
-          const prefix = entry.slice(0, -1);
-          return !names.some((name) => name.startsWith(prefix));
+      if (list.length === 0) return [];
+      const matched = list.map(() => false);
+      let remaining = list.length;
+      for (const className of census) {
+        const start = utilityStart(className);
+        for (let index = 0; index < list.length; index += 1) {
+          if (matched[index] || !keeps(compiled[index], className, start)) continue;
+          matched[index] = true;
+          remaining -= 1;
         }
-        return !names.includes(entry);
-      });
+        if (remaining === 0) break;
+      }
+      return list.filter((_, index) => !matched[index]);
     }
   };
 }
@@ -2239,9 +2251,9 @@ let _hasWarnedTsConfig = false;
 let _hasWarnedTransformCacheVersion = false;
 let _hasWarnedNativeFallback = false;
 const _loggedActiveParsers = /* @__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.ZqxgHk5F.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.9zs6T4Gf.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.ZqxgHk5F.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.9zs6T4Gf.cjs', document.baseURI).href))),
   UNKNOWN_PACKAGE_VERSION
 );
 const COMPILER_VERSION = findPackageVersionFromModule("@csszyx/compiler", UNKNOWN_PACKAGE_VERSION);
@@ -2373,8 +2385,9 @@ function quoteForConfig(entry) {
 function preserveEntriesFor(hazard) {
   const quote = quoteForConfig;
   const { value } = hazard;
-  if (hazard.renamed.every((name) => name === value)) return [quote(value)];
-  if (hazard.renamed.every((name) => name.startsWith(value))) return [quote(`${value}*`)];
+  const utilities = hazard.renamed.map((name) => name.slice(utilityStart(name)));
+  if (utilities.every((name) => name === value)) return [quote(value)];
+  if (utilities.every((name) => name.startsWith(value))) return [quote(`${value}*`)];
   return hazard.renamed.map(quote);
 }
 function mangleHybridHazardMessage(hazards) {
@@ -2382,49 +2395,40 @@ function mangleHybridHazardMessage(hazards) {
   if (collisions.length === 0 && orphans.length === 0 && selectorMatches.length === 0) {
     return null;
   }
+  const broken = selectorMatches.filter((hazard) => hazard.renamed.length > 0);
+  const newlyMatched = selectorMatches.filter((hazard) => hazard.matchedTokens.length > 0);
   const parts = ["[csszyx] production mangle found hybrid hazards:"];
   if (collisions.length > 0) {
     const sample = collisions.slice(0, 8).join(", ");
     parts.push(
-      ` ${collisions.length} mangled token(s) collide with class names in non-csszyx CSS (e.g. ${sample}) \u2014 those tokens will cross-contaminate external ".${collisions[0]}" elements.`
+      `${collisions.length} mangled token(s) collide with class names in non-csszyx CSS (e.g. ${sample}) \u2014 those tokens will cross-contaminate external ".${collisions[0]}" elements.`,
+      "HOTFIX: pass `production: { mangle: false }` to the csszyx plugin to ship now. THEN fix it: if these short names are in your OWN CSS, rename them to something specific (e.g. `.x` \u2192 `.resize-handle-x`) \u2014 short/common names also clash on specificity with other libraries. Only for names in a third-party stylesheet you cannot edit, list them in `production.mangleExclude` instead. Run `npx @csszyx/cli scan-collisions` to find every offending name."
     );
   }
   if (orphans.length > 0) {
     const sample = orphans.slice(0, 8).join(", ");
     parts.push(
-      ` ${orphans.length} mangled class(es) have no emitted CSS rule (e.g. ${sample}) \u2014 those elements lose styling.`
+      `${orphans.length} mangled class(es) have no emitted CSS rule (e.g. ${sample}) \u2014 those elements lose styling.`,
+      "Those classes are csszyx-owned but no CSS was emitted for them (e.g. a separate Tailwind plugin owns the utility CSS, or the class is not a real utility). Ensure that CSS is generated, or pass `production: { mangle: false }` to the csszyx plugin until the pipelines are reconciled."
     );
   }
-  const broken = selectorMatches.filter((hazard) => hazard.renamed.length > 0);
-  const newlyMatched = selectorMatches.filter((hazard) => hazard.matchedTokens.length > 0);
   if (broken.length > 0) {
     const sample = broken.slice(0, 3).map((hazard) => `${hazard.selector} \u2192 ${hazard.renamed.slice(0, 4).join(", ")}`).join("; ");
+    const entries = [...new Set(broken.flatMap(preserveEntriesFor))].join(", ");
     parts.push(
-      ` ${broken.length} attribute selector(s) match class names by text (e.g. ${sample}) \u2014 those rules stop matching once the classes are renamed, so the elements lose those styles.`
+      `${broken.length} attribute selector(s) match class names by text (e.g. ${sample}) \u2014 those rules stop matching once the classes are renamed, so the elements lose those styles.`,
+      `Keep those classes readable with production.manglePreserve: [${entries}] (paste-ready), or key the rule off a data attribute, which mangling never touches. production.mangleExclude cannot help here: it reserves token names and does not keep a class from being renamed.`
     );
   }
   if (newlyMatched.length > 0) {
     const sample = newlyMatched.slice(0, 3).map((hazard) => `${hazard.selector} \u2192 ${hazard.matchedTokens.slice(0, 4).join(", ")}`).join("; ");
+    const tokens = [...new Set(newlyMatched.flatMap((hazard) => hazard.matchedTokens))].map(quoteForConfig).join(", ");
     parts.push(
-      ` ${newlyMatched.length} attribute selector(s) would start matching mangled tokens instead (e.g. ${sample}).`
+      `${newlyMatched.length} attribute selector(s) would start matching mangled tokens instead (e.g. ${sample}).`,
+      `Reserve those token names with production.mangleExclude: [${tokens}] (paste-ready) so no class is renamed to one of them, or key the rule off a data attribute, which mangling never touches; a prefix or substring selector goes on matching other tokens, so the data attribute is the durable fix.`
     );
   }
-  if (collisions.length > 0) {
-    parts.push(
-      " HOTFIX: pass `production: { mangle: false }` to the csszyx plugin to ship now. THEN fix it: if these short names are in your OWN CSS, rename them to something specific (e.g. `.x` \u2192 `.resize-handle-x`) \u2014 short/common names also clash on specificity with other libraries. Only for names in a third-party stylesheet you cannot edit, list them in `production.mangleExclude` instead. Run `npx @csszyx/cli scan-collisions` to find every offending name."
-    );
-  } else if (orphans.length > 0) {
-    parts.push(
-      " Those classes are csszyx-owned but no CSS was emitted for them (e.g. a separate Tailwind plugin owns the utility CSS, or the class is not a real utility). Ensure that CSS is generated, or pass `production: { mangle: false }` to the csszyx plugin until the pipelines are reconciled."
-    );
-  }
-  if (broken.length > 0) {
-    const entries = [...new Set(broken.flatMap(preserveEntriesFor))].join(", ");
-    parts.push(
-      ` Keep those classes readable with production.manglePreserve: [${entries}] (paste-ready), or key the rule off a data attribute, which mangling never touches. production.mangleExclude cannot help here: it reserves token names and does not keep a class from being renamed.`
-    );
-  }
-  return parts.join("");
+  return parts.join("\n");
 }
 const TAILWIND_IMPORT_SPECIFIER = /@import\s+["']tailwindcss(?:\/[^"']*)?["']/g;
 const SOURCE_MODIFIER = /\bsource\(/;
@@ -2467,13 +2471,15 @@ function shouldWarnUnscopedMonorepo(sawTailwindEntry, tailwindEntryScoped, inMon
 function unscopedMonorepoMessage() {
   return '[csszyx] Tailwind content detection is UNSCOPED in a monorepo. Tailwind v4 scans every file under its detection base \u2014 .md/.mdx/.txt included \u2014 so a doc or fixture holding class-shaped strings becomes CSS, which can generate phantom or broken url() classes and fail the build. That base is as wide as the build makes it: a Vite build roots it at the Vite root, other setups at the workspace root. Scope it in your Tailwind CSS entry:\n    @import "tailwindcss" source(none);\n    @source ".";\nThat @source is your package, relative to the CSS file; csszyx auto-injects one for the classes it generates, so only your own templates need listing. Guide: https://csszyx.com/docs/monorepo-content-scope/\nSilence (if a broad scan is intentional): csszyx({ contentScopeCheck: false }).';
 }
+const CLASS_NAME_PRECEDENCE_MARKER = 'takes precedence over the runtime "className"';
+const MANGLE_VARS_HOIST_SKIP_MARKER = "mangleVars skipped component CSS variable hoist";
 function isAdvisoryDiagnostic(message) {
-  return !(message.includes("unresolvable sz spread") || message.includes("AST budget exceeded") || compiler.szFallbackConsequenceOf(message) === "missing-css");
+  return compiler.szFallbackConsequenceOf(message) === "nudge" || message.includes(CLASS_NAME_PRECEDENCE_MARKER) || message.includes(MANGLE_VARS_HOIST_SKIP_MARKER);
 }
 function suppressedAdvisoryMessage(count) {
   if (count <= 0) return null;
-  const held = count === 1 ? "1 advisory sz fallback" : `${count} advisory sz fallbacks`;
-  return `[csszyx] ${held} not listed above. At an sz prop a fallback is advisory \u2014 the runtime path works and the classes are collected \u2014 so a production build keeps the list short. A development build prints each one with its file and position.`;
+  const held = count === 1 ? "1 advisory note" : `${count} advisory notes`;
+  return `[csszyx] ${held} not listed above. An advisory reports something csszyx handled \u2014 a fallback at an sz prop, a className whose precedence over sz is unstated, or a variable hoist the planner declined \u2014 so the styles are there and a production build keeps the list short. A development build prints each one with its file and position.`;
 }
 function resolveQuietMode(quiet) {
   if (quiet === true || quiet === "all") return "all";
@@ -2490,15 +2496,25 @@ function shouldEmitWarning(quiet, devOnly, isProduction) {
   }
   return true;
 }
+function emitKeyValueDiagnostic(quiet, message, id, emit) {
+  if (resolveQuietMode(quiet) === "all" || compiler.szFallbackConsequenceOf(message) !== void 0 || isAdvisoryDiagnostic(message)) {
+    return;
+  }
+  emit(`[csszyx] ${id}
+  ${message}`);
+}
 function shouldEmitMissingCssFallback(quiet, message) {
   return resolveQuietMode(quiet) !== "all" && compiler.szFallbackConsequenceOf(message) === "missing-css";
 }
+function shouldHoldAdvisories(quiet, serving, nodeEnv) {
+  return quiet !== "off" || !serving && nodeEnv === "production";
+}
 function emitMissingCssFallback(quiet, message, id, emit) {
   if (shouldEmitMissingCssFallback(quiet, message)) emit(`[csszyx] ${id}
   ${message}`);
 }
 function normalizeForMatch(p) {
-  const n = safelistSource.normalizePathSeparators(p);
+  const n = pathNormalization.normalizePathSeparators(p);
   return n.length > 1 && n.endsWith("/") ? n.slice(0, -1) : n;
 }
 function findJsxExpressionEnd(code, bodyStart) {
@@ -3039,7 +3055,7 @@ function findPackageVersionFromFile(file, fallback) {
   }
 }
 function normalizeSourceFilename(filename) {
-  return safelistSource.normalizePathSeparators(filename);
+  return pathNormalization.normalizePathSeparators(filename);
 }
 const SCRIPT_ID_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx"];
 const STYLESHEET_FILE_EXTENSIONS = [
@@ -3058,7 +3074,7 @@ function matchesScriptExtension(id, extensions) {
   return extensions.some((ext) => id.endsWith(ext) || id.includes(`${ext}?`));
 }
 function insertRuntimeImport(code, importStmt) {
-  return themeGroupsFile.insertAfterUseDirective(code, importStmt);
+  return nextRuntimeInjection.insertAfterUseDirective(code, importStmt);
 }
 function scanClassExpression(source, from) {
   let depth = 0;
@@ -3322,6 +3338,9 @@ ${errors.join("\n")}`
 function createCsszyxPlugins(options = {}) {
   assertGlobalVarMangleConfig(options);
   let manglingEnabled = options.production?.mangle === true;
+  const censusRequested = options.production?.hydrationCensus !== false;
+  const censusHasContent = () => manglingEnabled && Object.keys(state.mangleMap).length > 0 || Object.keys(state.varMangleMap).length > 0;
+  let serving = false;
   const importedStaticSzEnabled = options.build?.importedStaticSz ?? types.DEFAULT_IMPORTED_STATIC_SZ;
   const szvCrossModuleRegistry = /* @__PURE__ */ new Map();
   const szvCrossModuleForwards = /* @__PURE__ */ new Map();
@@ -3344,6 +3363,9 @@ function createCsszyxPlugins(options = {}) {
   if (options.production?.mangleMapDelivery !== void 0) {
     console.warn(removedMangleMapDeliveryMessage());
   }
+  if (options.production?.injectChecksum !== void 0) {
+    console.warn(removedInjectChecksumMessage());
+  }
   const sizeAccount = createMangleSizeAccount();
   const astBudgetOverride = options.build?.astBudgetLimit;
   const prescanAstBudget = astBudgetOverride ?? 5e5;
@@ -3438,6 +3460,7 @@ function createCsszyxPlugins(options = {}) {
     skipWarningEmitted: false,
     classesCapped: false,
     ownedClasses: /* @__PURE__ */ new Set(),
+    mangleEligible: [],
     authoredClasses: /* @__PURE__ */ new Set(),
     mangleMap: {},
     varMangleEntriesByFile: varMangleEntries,
@@ -3917,15 +3940,15 @@ function createCsszyxPlugins(options = {}) {
   function refreshSzvRegistryEntry(filePath, content) {
     if (!shouldProcessSource(filePath)) return;
     if (content === null) {
-      szvCrossModuleRegistry.delete(safelistSource.normalizePathSeparators(filePath));
-      szvCrossModuleForwards.delete(safelistSource.normalizePathSeparators(filePath));
+      szvCrossModuleRegistry.delete(pathNormalization.normalizePathSeparators(filePath));
+      szvCrossModuleForwards.delete(pathNormalization.normalizePathSeparators(filePath));
       return;
     }
     transformCache.recordSzvRegistryFile(szvCrossModuleRegistry, filePath, content);
     transformCache.recordCrossModuleForwards(szvCrossModuleForwards, filePath, content);
     if (importedStaticSzEnabled) {
       transformCache.recordSzObjectRegistryFile(szvCrossModuleRegistry, filePath, content);
-      szObjectProvidersExamined.add(safelistSource.normalizePathSeparators(filePath));
+      szObjectProvidersExamined.add(pathNormalization.normalizePathSeparators(filePath));
       recordProvidersDemandedBy(filePath, content);
     }
   }
@@ -3948,7 +3971,7 @@ function createCsszyxPlugins(options = {}) {
     for (const specifier of queue) {
       const providerPath = transformCache.resolveProviderPathWith(specifier, transformCache.isReadableProviderFile);
       if (providerPath === void 0) continue;
-      const key = safelistSource.normalizePathSeparators(providerPath);
+      const key = pathNormalization.normalizePathSeparators(providerPath);
       if (!szObjectProvidersExamined.has(key)) {
         szObjectProvidersExamined.add(key);
         readAndRecordSzObjectProvider(providerPath);
@@ -3972,14 +3995,14 @@ function createCsszyxPlugins(options = {}) {
     for (const specifier of queue) {
       const providerPath = transformCache.resolveProviderPath(seenSourcePaths, specifier);
       if (providerPath === void 0) continue;
-      szObjectProvidersExamined.add(safelistSource.normalizePathSeparators(providerPath));
+      szObjectProvidersExamined.add(pathNormalization.normalizePathSeparators(providerPath));
       readAndRecordSzObjectProvider(providerPath);
       enqueueForwardedProviders(providerPath, queue, queued);
     }
   }
   function enqueueForwardedProviders(providerPath, queue, queued) {
     const directory = path__namespace.dirname(providerPath);
-    for (const forward of szvCrossModuleForwards.get(safelistSource.normalizePathSeparators(providerPath)) ?? []) {
+    for (const forward of szvCrossModuleForwards.get(pathNormalization.normalizePathSeparators(providerPath)) ?? []) {
       for (const base of transformCache.specifierBases(forward.specifier, directory, specifierAliases)) {
         if (queued.has(base)) continue;
         queued.add(base);
@@ -4027,7 +4050,7 @@ function createCsszyxPlugins(options = {}) {
       }
       recordSzvRegistryEntries(filePath, content);
       transformCache.recordCrossModuleForwards(szvCrossModuleForwards, filePath, content);
-      seenSourcePaths.add(safelistSource.normalizePathSeparators(filePath));
+      seenSourcePaths.add(pathNormalization.normalizePathSeparators(filePath));
       if (fileMayContainSafelistableSz(content)) {
         prescanSources.push({ filePath, content });
         recordSzObjectDemand(filePath, content);
@@ -4242,6 +4265,8 @@ function createCsszyxPlugins(options = {}) {
       const unmatched = manglePreserve.unmatched(state.ownedClasses);
       if (unmatched.length > 0) emitWarning(manglePreserveNoMatchMessage(unmatched));
     }
+    state.mangleEligible = eligible;
+    if (!manglingEnabled) return {};
     return allocateMangleTokens(eligible, forbiddenTokens);
   }
   function freezeMangleMap() {
@@ -4421,7 +4446,7 @@ function createCsszyxPlugins(options = {}) {
         ctx.server.ws.send({ type: "full-reload" });
       }
     }
-    if (safelistSource.normalizePathSeparators(ctx.file) === safelistSource.normalizePathSeparators(path__namespace.join(state.rootDir, SAFELIST_FILENAME))) {
+    if (pathNormalization.normalizePathSeparators(ctx.file) === pathNormalization.normalizePathSeparators(path__namespace.join(state.rootDir, SAFELIST_FILENAME))) {
       return tailwindEntryModules(pass.moduleGraph());
     }
     if (isClientPass) discoverHotFileClasses(ctx.file, ctx.server.watcher);
@@ -4459,10 +4484,11 @@ function createCsszyxPlugins(options = {}) {
         continue;
       }
       emitMissingCssFallback(quiet, message, id, console.warn);
+      emitKeyValueDiagnostic(quiet, message, id, console.warn);
     }
     const advisories = result.diagnostics.filter(isAdvisoryDiagnostic);
     if (advisories.length === 0) return;
-    if (quiet !== "off" || process.env.NODE_ENV === "production") {
+    if (shouldHoldAdvisories(quiet, serving, process.env.NODE_ENV)) {
       state.suppressedAdvisories += advisories.length;
       return;
     }
@@ -4518,14 +4544,14 @@ function createCsszyxPlugins(options = {}) {
     }
     let transformedCode = `${code.slice(0, htmlTag.close)} ${attrName}="${themeGroupsFile.CHECKSUM_PLACEHOLDER}"${code.slice(htmlTag.close)}`;
     const censusTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json" dangerouslySetInnerHTML={{__html: \`${themeGroupsFile.CENSUS_PLACEHOLDER}\`}} />`;
-    const bodyTag = findOpeningTag(transformedCode, "body");
+    const bodyTag = censusRequested && censusHasContent() ? findOpeningTag(transformedCode, "body") : null;
     if (bodyTag) {
       transformedCode = `${transformedCode.slice(0, bodyTag.close + 1)}${censusTag}${transformedCode.slice(bodyTag.close + 1)}`;
     }
     return transformedCode;
   }
   function requiredRuntimeHelpers(output) {
-    return themeGroupsFile.runtimeHelperGroupsFromUsage(output);
+    return nextRuntimeInjection.runtimeHelperGroupsFromUsage(output);
   }
   function injectRuntimeHelpers(code, output) {
     const groups = requiredRuntimeHelpers(output);
@@ -4541,9 +4567,9 @@ function createCsszyxPlugins(options = {}) {
     }
     const imports = groups.barrel;
     const hasRuntimeImport = imports.length > 0 && current.includes("@csszyx/runtime");
-    const needed = hasRuntimeImport ? imports.filter((name) => !themeGroupsFile.importsRuntimeHelper(current, name)) : imports;
+    const needed = hasRuntimeImport ? imports.filter((name) => !nextRuntimeInjection.importsRuntimeHelper(current, name)) : imports;
     if (needed.length === 0) return result;
-    const existingImport = themeGroupsFile.findRuntimeImportClause(current);
+    const existingImport = nextRuntimeInjection.findRuntimeImportClause(current);
     if (existingImport) {
       return current.replace(
         existingImport.statement,
@@ -4881,6 +4907,7 @@ ${transformedCode}`;
           specifierAliases = transformCache.collectSpecifierAliases(root, config.resolve?.alias);
           if (config.command === "serve") {
             manglingEnabled = false;
+            serving = true;
           }
           if (manglingEnabled && config.build?.watch) {
             manglingEnabled = false;
@@ -4974,9 +5001,7 @@ ${transformedCode}`;
             finalizeMangleMap();
             const injectedMangleMap = manglingEnabled ? state.mangleMap : {};
             let result = transformIndexHtml(html, injectedMangleMap, state.checksum, {
-              // Always 'script' — the inert JSON census; the
-              // checksum attribute is injected regardless.
-              mode: "script",
+              census: censusRequested && censusHasContent(),
               minify: process.env.NODE_ENV === "production",
               varMangleMap: state.varMangleMap
             });
@@ -5021,7 +5046,7 @@ ${transformedCode}`;
     const manifest = {
       version: "0.4.0",
       buildId: state.checksum,
-      classes: Object.keys(state.mangleMap)
+      classes: [...state.mangleEligible]
     };
     if (includeMangleMap && Object.keys(state.mangleMap).length > 0) {
       manifest.mangleMap = state.mangleMap;
@@ -5393,6 +5418,7 @@ exports.createGlobalVarScanCacheKey = createGlobalVarScanCacheKey;
 exports.createRSCModuleRecord = createRSCModuleRecord;
 exports.cssHasContentScope = cssHasContentScope;
 exports.deleteRSCModuleRecord = deleteRSCModuleRecord;
+exports.emitKeyValueDiagnostic = emitKeyValueDiagnostic;
 exports.emitMissingCssFallback = emitMissingCssFallback;
 exports.esbuildPlugin = esbuildPlugin;
 exports.extractGlobalVarAliasesForManifest = extractGlobalVarAliasesForManifest;
@@ -5430,6 +5456,7 @@ exports.rollupPlugin = rollupPlugin;
 exports.scanGlobalVarCss = scanGlobalVarCss;
 exports.shouldEmitMissingCssFallback = shouldEmitMissingCssFallback;
 exports.shouldEmitWarning = shouldEmitWarning;
+exports.shouldHoldAdvisories = shouldHoldAdvisories;
 exports.shouldTrackGlobalVarSources = shouldTrackGlobalVarSources;
 exports.shouldWarnMissingTailwindEntry = shouldWarnMissingTailwindEntry;
 exports.shouldWarnUnscopedMonorepo = shouldWarnUnscopedMonorepo;

package/dist/shared/{unplugin.nvme_dSL.d.cts → unplugin.BO2_hyS3.d.cts}

@@ -523,6 +523,14 @@ interface PluginState {
      * by a raw selector consumer.
      */
     ownedClasses: Set<string>;
+    /**
+     * Owned classes that a mangle map WOULD carry: `ownedClasses` minus the
+     * authored ones and minus `manglePreserve`. Recorded whether or not
+     * mangling runs, because the bundle manifest lists them either way and used
+     * to read them off the map's keys — which is why the map had to be
+     * allocated on a build that never mangles.
+     */
+    mangleEligible: string[];
     /**
      * Classes written through author-facing class/className attributes. Any
      * overlap with ownedClasses must keep its original name because bundled
@@ -751,9 +759,18 @@ declare function unscopedMonorepoMessage(): string;
 /**
  * Whether a diagnostic is an advisory one — the class a build may hold back.
  *
- * Spread warnings, budget bails and `missing-css` fallbacks all describe absent
- * output and print regardless. What is left says the runtime path was taken
- * where a compiled one was possible: real, worth acting on, and not a failure.
+ * Advisory means one thing: the styles are THERE, and the note is about how
+ * they got there. An `sz`-site nudge fallback took the runtime path where a
+ * compiled one was possible; the precedence advisory says which of two sources
+ * won. Everything else describes output that is absent or dead, and a
+ * production build has to print it.
+ *
+ * Asked positively on purpose. The predicate used to be "not one of three known
+ * kinds", which quietly made every key and value diagnostic advisory: a
+ * production build of a file with five typo'd keys printed nothing but a census
+ * calling them fallbacks, while `csszyx check` on the same tree named all six.
+ * A classifier written by exclusion cannot stay right as diagnostics are added,
+ * because a new one joins the silent side by default.
  *
  * @param message - One raw diagnostic line as an engine emitted it.
  * @returns True when the diagnostic is advisory rather than a build result.
@@ -772,7 +789,7 @@ declare function isAdvisoryDiagnostic(message: string): boolean;
  * Suppression is the right default; implying zero is not. One line costs
  * nothing and keeps the difference visible.
  *
- * @param count - Advisory fallbacks the build declined to list.
+ * @param count - Advisory notes the build declined to list.
  * @returns The disclosure, or null when nothing was held back.
  */
 declare function suppressedAdvisoryMessage(count: number): string | null;
@@ -807,6 +824,22 @@ declare function resolveQuietMode(quiet: boolean | 'nudges' | QuietMode | undefi
  * @returns true when the warning should be printed.
  */
 declare function shouldEmitWarning(quiet: QuietMode, devOnly: boolean, isProduction: boolean): boolean;
+/**
+ * Emit one key or value diagnostic — the family that says a class is dead.
+ *
+ * Its own channel because the two that existed both answer a different
+ * question: `emitMissingCssFallback` handles fallback sites, and the advisory
+ * channel handles notes about styles that ARE present. A typo'd key matched
+ * neither, so a production build dropped it on the floor while `csszyx check`
+ * on the same tree exited 1 and named it. Muted only by `quiet: true`, on the
+ * same reasoning as the missing-css channel: wrong output is not a usage nudge.
+ *
+ * @param quiet - Resolved quiet mode.
+ * @param message - Compiler diagnostic to classify and emit.
+ * @param id - Bundler module identifier included in the warning.
+ * @param emit - Warning output channel.
+ */
+declare function emitKeyValueDiagnostic(quiet: QuietMode, message: string, id: string, emit: (message: string) => void): void;
 /**
  * Whether a transform diagnostic describes missing CSS and may be printed.
  *
@@ -820,6 +853,22 @@ declare function shouldEmitWarning(quiet: QuietMode, devOnly: boolean, isProduct
  * @returns True when the diagnostic is an unsilenced missing-CSS failure.
  */
 declare function shouldEmitMissingCssFallback(quiet: QuietMode, message: string): boolean;
+/**
+ * Whether this run holds the advisory fallback list back and counts it instead.
+ *
+ * A build prints the count once the bundle closes, so holding the list back
+ * still leaves a reader a number to act on. A dev server never closes a bundle:
+ * anything held back there is held back for good, which is why serving lists
+ * its fallbacks whatever the environment says. `NODE_ENV` alone was the whole
+ * test, and a monorepo script that exports it while running a dev server turned
+ * every advisory into a number nothing would print.
+ *
+ * @param quiet - Resolved quiet mode.
+ * @param serving - Whether this is a dev server rather than a build.
+ * @param nodeEnv - `process.env.NODE_ENV` as the process sees it.
+ * @returns True when the list is withheld in favour of a count.
+ */
+declare function shouldHoldAdvisories(quiet: QuietMode, serving: boolean, nodeEnv: string | undefined): boolean;
 /**
  * Emit one missing-CSS fallback through the caller's output channel.
  *
@@ -1063,5 +1112,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { isRSCServerModule as $, unplugin as A, deleteRSCModuleRecord as B, emitMissingCssFallback as D, esbuildPlugin as E, extractGlobalVarAliasesForManifest as F, fileMayContainSafelistableSz as H, findLocalImportSources as I, findRSCBoundaryViolation as J, findRSCGraphViolation as K, hasInjectableTailwindCandidate as L, hasTokens as N, hasUseClientDirective as O, hasUseServerDirective as T, isAdvisoryDiagnostic as U, isCompileSourceOptedIn as W, isHardIgnoredPath as X, isMangleableCssId as Y, isMonorepoPackage as Z, isPackagesSkippedSource as _, lateMangleCensusMessage as a0, mangleCodeClassesSync as a1, mangleEligibleClasses as a2, mangleHybridHazardMessage as a3, mergeThemes as a4, missingTailwindEntryMessage as a5, normalizeGlobalVarAliasesForCache as a6, parseThemeBlocks as a7, parseUtilityBlocks as a8, realContentHashDisabledMessage as a9, recordGlobalVarSourceFile as aa, resolveCompileSourceDirs as ab, resolveNativeCacheIdentity as ac, resolveQuietMode as ad, rollupPlugin as ae, scanCustomPropertyNames as af, shouldEmitMissingCssFallback as ag, shouldEmitWarning as ah, shouldTrackGlobalVarSources as ai, shouldWarnMissingTailwindEntry as aj, shouldWarnUnscopedMonorepo as ak, skippedSzFilesMessage as al, suppressedAdvisoryMessage as am, unscopedMonorepoMessage as an, vitePlugin as ao, watchModeMangleMessage as ap, webpackPlugin as aq, allocateMangleTokens as t, assertNoRSCBoundaryViolation as u, assertNoRSCGraphViolation as v, collectMangleHybridHazards as w, createGlobalVarMapAssetSource as x, createRSCModuleRecord as y, cssHasContentScope as z };
+export { isPackagesSkippedSource as $, unplugin as A, deleteRSCModuleRecord as B, emitKeyValueDiagnostic as D, emitMissingCssFallback as E, esbuildPlugin as F, extractGlobalVarAliasesForManifest as H, fileMayContainSafelistableSz as I, findLocalImportSources as J, findRSCBoundaryViolation as K, findRSCGraphViolation as L, hasInjectableTailwindCandidate as N, hasTokens as O, hasUseClientDirective as T, hasUseServerDirective as U, isAdvisoryDiagnostic as W, isCompileSourceOptedIn as X, isHardIgnoredPath as Y, isMangleableCssId as Z, isMonorepoPackage as _, isRSCServerModule as a0, lateMangleCensusMessage as a1, mangleCodeClassesSync as a2, mangleEligibleClasses as a3, mangleHybridHazardMessage as a4, mergeThemes as a5, missingTailwindEntryMessage as a6, normalizeGlobalVarAliasesForCache as a7, parseThemeBlocks as a8, parseUtilityBlocks as a9, realContentHashDisabledMessage as aa, recordGlobalVarSourceFile as ab, resolveCompileSourceDirs as ac, resolveNativeCacheIdentity as ad, resolveQuietMode as ae, rollupPlugin as af, scanCustomPropertyNames as ag, shouldEmitMissingCssFallback as ah, shouldEmitWarning as ai, shouldHoldAdvisories as aj, shouldTrackGlobalVarSources as ak, shouldWarnMissingTailwindEntry as al, shouldWarnUnscopedMonorepo as am, skippedSzFilesMessage as an, suppressedAdvisoryMessage as ao, unscopedMonorepoMessage as ap, vitePlugin as aq, watchModeMangleMessage as ar, webpackPlugin as as, allocateMangleTokens as t, assertNoRSCBoundaryViolation as u, assertNoRSCGraphViolation as v, collectMangleHybridHazards as w, createGlobalVarMapAssetSource as x, createRSCModuleRecord as y, cssHasContentScope as z };
 export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, MangleHybridHazards as M, PlanGlobalVarAliasesInput as P, QuietMode as Q, RewriteGlobalVarCssAliasesOptions as R, ScanGlobalVarCssOptions as S, ValidateGlobalVarAliasInputsOptions as V, GlobalVarAliasPlan as a, GlobalVarCssAliasRewriteResult as b, CreateGlobalVarAliasValidationOptionsInput as c, GlobalVarAliasValidationResult as d, CssVarDefinition as e, CssVarLocation as f, CssVarReference as g, GlobalVarAliasDiagnostic as h, GlobalVarAliasDiagnosticSeverity as i, GlobalVarAliasEntry as j, GlobalVarCodeSource as k, GlobalVarCssAssetSource as l, GlobalVarCssSource as m, GlobalVarScanCacheEntry as n, MangleSelectorHazard as o, ParsedTheme as p, ParsedUtilities as q, RSCBoundaryViolation as r, RSCModuleRecord as s };