@csszyx/unplugin 0.15.3 → 0.17.0

package/dist/shared/{unplugin.DH_ij6cf.mjs → unplugin.Ba3O1r8M.mjs}

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { n as normalizePathSeparators } from './unplugin.wMeicb6E.mjs';
 
 function sortStrings(values) {
   return [...values].sort((a, b) => {
@@ -10,11 +11,6 @@ function sortStrings(values) {
   });
 }
 
-const WINDOWS_PATH_SEPARATOR = String.fromCodePoint(92);
-function normalizePathSeparators(value) {
-  return value.split(WINDOWS_PATH_SEPARATOR).join("/");
-}
-
 const DEFAULT_RENAME_RETRIES = 5;
 const DEFAULT_RENAME_RETRY_DELAY_MS = 10;
 function isRetryableRenameError(error) {
@@ -255,4 +251,4 @@ function cssImportsTailwind(code) {
   return TAILWIND_IMPORT.test(stripCssBlockComments(code));
 }
 
-export { SAFELIST_FILE as S, appendTailwindSourceDirective as a, cssImportsTailwind as b, computeSafelistRelPath as c, atomicWriteFileSync as d, removeLegacySafelists as e, findPostcssConfigWithoutCsszyx as f, assertNoLegacySourceStylesheet as g, stripCssBlockComments as h, findLegacySourceDirective as i, legacySourceMessage as l, missingPostcssPluginMessage as m, normalizePathSeparators as n, renderSafelistFile as r, sortStrings as s };
+export { SAFELIST_FILE as S, appendTailwindSourceDirective as a, cssImportsTailwind as b, computeSafelistRelPath as c, atomicWriteFileSync as d, removeLegacySafelists as e, findPostcssConfigWithoutCsszyx as f, assertNoLegacySourceStylesheet as g, stripCssBlockComments as h, findLegacySourceDirective as i, legacySourceMessage as l, missingPostcssPluginMessage as m, renderSafelistFile as r, sortStrings as s };

package/dist/shared/unplugin.BqKLlo1h.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+const WINDOWS_PATH_SEPARATOR = String.fromCodePoint(92);
+function normalizePathSeparators(value) {
+  return value.split(WINDOWS_PATH_SEPARATOR).join("/");
+}
+
+exports.normalizePathSeparators = normalizePathSeparators;

package/dist/shared/{unplugin.Vn9x8SBP.mjs → unplugin.C3bgc29e.mjs}

@@ -2,9 +2,10 @@ import { readFileSync } from 'node:fs';
 import * as path from 'node:path';
 import { extractCrossModuleForwards, extractCrossModuleRegistryEntries, ensureRustTransformAvailable, transformRust, transformWasm, transform } from '@csszyx/compiler';
 import { DEFAULT_IMPORTED_STATIC_SZ } from '@csszyx/types';
-import { c as collectSpecifierAliases, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, b as recordResolvedEntry, f as forwardVisitKey, M as MAX_FORWARD_HOPS, d as isReadableProviderFile, e as createTransformCacheKey, g as readTransformCache, w as writeTransformCache } from './unplugin.C-oQU1jl.mjs';
-import { n as normalizePathSeparators, s as sortStrings } from './unplugin.DH_ij6cf.mjs';
+import { c as collectSpecifierAliases, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, b as recordResolvedEntry, f as forwardVisitKey, M as MAX_FORWARD_HOPS, d as isReadableProviderFile, e as createTransformCacheKey, g as readTransformCache, w as writeTransformCache } from './unplugin.2uf-U76p.mjs';
+import { n as normalizePathSeparators } from './unplugin.wMeicb6E.mjs';
 import { createHash } from 'node:crypto';
+import { s as sortStrings } from './unplugin.Ba3O1r8M.mjs';
 
 function resolveImportedStaticSz(value) {
   return value ?? DEFAULT_IMPORTED_STATIC_SZ;

package/dist/shared/{unplugin.CPo2xrEy.mjs → unplugin.Cs4H9z9v.mjs}

@@ -13,10 +13,12 @@ import { preprocess as preprocess$1 } from '@csszyx/svelte-adapter';
 import { isTailwindReservedCustomProperty, CSSZYX_GLOBAL_ALIAS_PREFIX, isCsszyxGlobalAliasCustomProperty, DEFAULT_IMPORTED_STATIC_SZ, DEFAULT_BUILD_CONFIG, validateGlobalVarMangleConfig } from '@csszyx/types';
 import { preprocess } from '@csszyx/vue-adapter';
 import { createUnplugin } from 'unplugin';
-import { s as sortStrings, n as normalizePathSeparators, h as stripCssBlockComments, S as SAFELIST_FILE, i as findLegacySourceDirective, l as legacySourceMessage, b as cssImportsTailwind, c as computeSafelistRelPath, a as appendTailwindSourceDirective, r as renderSafelistFile, d as atomicWriteFileSync, e as removeLegacySafelists } from './unplugin.DH_ij6cf.mjs';
-import { c as collectSpecifierAliases, r as resolveTransformCacheDir, h as evictOldTransformCacheEntries, j as recordSzvRegistryFile, k as recordCrossModuleForwards, l as recordSzObjectRegistryFile, m as mayExportSzvFactories, n as resolveProviderPath, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, o as resolveCrossModuleStaticsFor, e as createTransformCacheKey, w as writeTransformCache, g as readTransformCache, p as evictMemoryCacheToBudget, d as isReadableProviderFile } from './unplugin.C-oQU1jl.mjs';
+import { s as sortStrings, h as stripCssBlockComments, S as SAFELIST_FILE, i as findLegacySourceDirective, l as legacySourceMessage, b as cssImportsTailwind, c as computeSafelistRelPath, a as appendTailwindSourceDirective, r as renderSafelistFile, d as atomicWriteFileSync, e as removeLegacySafelists } from './unplugin.Ba3O1r8M.mjs';
+import { c as collectSpecifierAliases, r as resolveTransformCacheDir, h as evictOldTransformCacheEntries, j as recordSzvRegistryFile, k as recordCrossModuleForwards, l as recordSzObjectRegistryFile, m as mayExportSzvFactories, n as resolveProviderPath, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, o as resolveCrossModuleStaticsFor, e as createTransformCacheKey, w as writeTransformCache, g as readTransformCache, p as evictMemoryCacheToBudget, d as isReadableProviderFile } from './unplugin.2uf-U76p.mjs';
 import { mangleCSSSync, classAttributeSelectorKey } from '../css-mangler.mjs';
-import { c as createMangleRuntimeModule, M as MANGLE_RUNTIME_VIRTUAL_ID, e as ensureThemeGroupsFile, R as RESOLVED_VIRTUAL_MODULE_ID, d as createMangleMapModule, f as RESOLVED_VIRTUAL_CHECKSUM_ID, g as createChecksumModule, j as RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID, k as RESOLVED_THEME_GROUPS_VIRTUAL_ID, l as createThemeGroupsModule, n as isVirtualModule, r as resolveVirtualModule, p as parseThemeBlocks, m as mergeThemes, o as discoverProjectTheme, C as CHECKSUM_PLACEHOLDER, q as CENSUS_PLACEHOLDER, u as importsRuntimeHelper, v as findRuntimeImportClause, T as THEME_GROUPS_VIRTUAL_ID, w as THEME_GROUPS_FILE_MARKER, t as themeGroupsSpecifier, a as parseUtilityBlocks, x as runtimeHelperGroupsFromUsage, b as insertAfterUseDirective, y as MANGLE_MAP_PLACEHOLDER, V as VAR_MANGLE_MAP_PLACEHOLDER } from './unplugin.Ceq-N4jI.mjs';
+import { b as importsRuntimeHelper, f as findRuntimeImportClause, r as runtimeHelperGroupsFromUsage, a as insertAfterUseDirective } from './unplugin.DcXM9sq5.mjs';
+import { n as normalizePathSeparators } from './unplugin.wMeicb6E.mjs';
+import { c as createMangleRuntimeModule, M as MANGLE_RUNTIME_VIRTUAL_ID, 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, i as RESOLVED_THEME_GROUPS_VIRTUAL_ID, j as createThemeGroupsModule, k as isVirtualModule, r as resolveVirtualModule, p as parseThemeBlocks, m as mergeThemes, l as discoverProjectTheme, C as CHECKSUM_PLACEHOLDER, n as CENSUS_PLACEHOLDER, T as THEME_GROUPS_VIRTUAL_ID, o as THEME_GROUPS_FILE_MARKER, t as themeGroupsSpecifier, a as parseUtilityBlocks, q as MANGLE_MAP_PLACEHOLDER, V as VAR_MANGLE_MAP_PLACEHOLDER } from './unplugin.995yC_cN.mjs';
 import { gzipSync } from 'node:zlib';
 import postcss from 'postcss';
 import valueParser from 'postcss-value-parser';
@@ -1779,24 +1781,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);
@@ -1910,13 +1898,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) {
@@ -1929,22 +1929,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]);
     }
   };
 }
@@ -2351,8 +2363,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) {
@@ -2360,49 +2373,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\(/;
@@ -2445,13 +2449,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") || szFallbackConsequenceOf(message) === "missing-css");
+  return 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";
@@ -2468,9 +2474,19 @@ function shouldEmitWarning(quiet, devOnly, isProduction) {
   }
   return true;
 }
+function emitKeyValueDiagnostic(quiet, message, id, emit) {
+  if (resolveQuietMode(quiet) === "all" || szFallbackConsequenceOf(message) !== void 0 || isAdvisoryDiagnostic(message)) {
+    return;
+  }
+  emit(`[csszyx] ${id}
+  ${message}`);
+}
 function shouldEmitMissingCssFallback(quiet, message) {
   return resolveQuietMode(quiet) !== "all" && 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}`);
@@ -3300,6 +3316,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 ?? DEFAULT_IMPORTED_STATIC_SZ;
   const szvCrossModuleRegistry = /* @__PURE__ */ new Map();
   const szvCrossModuleForwards = /* @__PURE__ */ new Map();
@@ -3322,6 +3341,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;
@@ -3416,6 +3438,7 @@ function createCsszyxPlugins(options = {}) {
     skipWarningEmitted: false,
     classesCapped: false,
     ownedClasses: /* @__PURE__ */ new Set(),
+    mangleEligible: [],
     authoredClasses: /* @__PURE__ */ new Set(),
     mangleMap: {},
     varMangleEntriesByFile: varMangleEntries,
@@ -4220,6 +4243,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() {
@@ -4437,10 +4462,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;
     }
@@ -4496,7 +4522,7 @@ function createCsszyxPlugins(options = {}) {
     }
     let transformedCode = `${code.slice(0, htmlTag.close)} ${attrName}="${CHECKSUM_PLACEHOLDER}"${code.slice(htmlTag.close)}`;
     const censusTag = `<script id="__CSSZYX_MANGLE_MAP__" type="application/json" dangerouslySetInnerHTML={{__html: \`${CENSUS_PLACEHOLDER}\`}} />`;
-    const bodyTag = findOpeningTag(transformedCode, "body");
+    const bodyTag = censusRequested && censusHasContent() ? findOpeningTag(transformedCode, "body") : null;
     if (bodyTag) {
       transformedCode = `${transformedCode.slice(0, bodyTag.close + 1)}${censusTag}${transformedCode.slice(bodyTag.close + 1)}`;
     }
@@ -4859,6 +4885,7 @@ ${transformedCode}`;
           specifierAliases = collectSpecifierAliases(root, config.resolve?.alias);
           if (config.command === "serve") {
             manglingEnabled = false;
+            serving = true;
           }
           if (manglingEnabled && config.build?.watch) {
             manglingEnabled = false;
@@ -4952,9 +4979,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
             });
@@ -4999,7 +5024,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;
@@ -5361,4 +5386,4 @@ const esbuildPlugin = (options = {}) => {
   };
 };
 
-export { unscopedMonorepoMessage as $, isPackagesSkippedSource as A, isRSCServerModule as B, isTailwindReservedGlobalVar as C, lateMangleCensusMessage as D, mangleCodeClassesSync as E, mangleEligibleClasses as F, mangleHybridHazardMessage as G, missingTailwindEntryMessage as H, normalizeGlobalVarAliasesForCache as I, planGlobalVarAliases as J, readGlobalVarScanCache as K, realContentHashDisabledMessage as L, recordGlobalVarSourceFile as M, resolveCompileSourceDirs as N, resolveGlobalVarScanCacheDir as O, resolveNativeCacheIdentity as P, resolveQuietMode as Q, rewriteGlobalVarCssAliases as R, rollupPlugin as S, scanGlobalVarCss as T, shouldEmitMissingCssFallback as U, shouldEmitWarning as V, shouldTrackGlobalVarSources as W, shouldWarnMissingTailwindEntry as X, shouldWarnUnscopedMonorepo as Y, skippedSzFilesMessage as Z, suppressedAdvisoryMessage as _, allocateMangleTokens as a, validateGlobalVarAliasInputs as a0, vitePlugin as a1, watchModeMangleMessage as a2, webpackPlugin as a3, writeGlobalVarScanCache as a4, assertNoRSCBoundaryViolation as b, assertNoRSCGraphViolation as c, collectMangleHybridHazards as d, createGlobalVarAliasValidationOptions as e, createGlobalVarMapAssetSource as f, createGlobalVarScanCacheKey as g, createRSCModuleRecord as h, cssHasContentScope as i, deleteRSCModuleRecord as j, emitMissingCssFallback as k, esbuildPlugin as l, extractGlobalVarAliasesForManifest as m, fileMayContainSafelistableSz as n, findLocalImportSources as o, findRSCBoundaryViolation as p, findRSCGraphViolation as q, hasInjectableTailwindCandidate as r, hasUseClientDirective as s, hasUseServerDirective as t, unplugin as u, isAdvisoryDiagnostic as v, isCompileSourceOptedIn as w, isHardIgnoredPath as x, isMangleableCssId as y, isMonorepoPackage as z };
+export { skippedSzFilesMessage as $, isMonorepoPackage as A, isPackagesSkippedSource as B, isRSCServerModule as C, isTailwindReservedGlobalVar as D, lateMangleCensusMessage as E, mangleCodeClassesSync as F, mangleEligibleClasses as G, mangleHybridHazardMessage as H, missingTailwindEntryMessage as I, normalizeGlobalVarAliasesForCache as J, planGlobalVarAliases as K, readGlobalVarScanCache as L, realContentHashDisabledMessage as M, recordGlobalVarSourceFile as N, resolveCompileSourceDirs as O, resolveGlobalVarScanCacheDir as P, resolveNativeCacheIdentity as Q, resolveQuietMode as R, rewriteGlobalVarCssAliases as S, rollupPlugin as T, scanGlobalVarCss as U, shouldEmitMissingCssFallback as V, shouldEmitWarning as W, shouldHoldAdvisories as X, shouldTrackGlobalVarSources as Y, shouldWarnMissingTailwindEntry as Z, shouldWarnUnscopedMonorepo as _, allocateMangleTokens as a, suppressedAdvisoryMessage as a0, unscopedMonorepoMessage as a1, validateGlobalVarAliasInputs as a2, vitePlugin as a3, watchModeMangleMessage as a4, webpackPlugin as a5, writeGlobalVarScanCache as a6, assertNoRSCBoundaryViolation as b, assertNoRSCGraphViolation as c, collectMangleHybridHazards as d, createGlobalVarAliasValidationOptions as e, createGlobalVarMapAssetSource as f, createGlobalVarScanCacheKey as g, createRSCModuleRecord as h, cssHasContentScope as i, deleteRSCModuleRecord as j, emitKeyValueDiagnostic as k, emitMissingCssFallback as l, esbuildPlugin as m, extractGlobalVarAliasesForManifest as n, fileMayContainSafelistableSz as o, findLocalImportSources as p, findRSCBoundaryViolation as q, findRSCGraphViolation as r, hasInjectableTailwindCandidate as s, hasUseClientDirective as t, unplugin as u, hasUseServerDirective as v, isAdvisoryDiagnostic as w, isCompileSourceOptedIn as x, isHardIgnoredPath as y, isMangleableCssId as z };

package/dist/shared/{unplugin.BLptVbUe.mjs → unplugin.DPSQP5XG.mjs}

@@ -1,6 +1,6 @@
 import * as path from 'node:path';
 import * as fs from 'node:fs';
-import { S as SAFELIST_FILE, d as atomicWriteFileSync, s as sortStrings, r as renderSafelistFile, e as removeLegacySafelists, g as assertNoLegacySourceStylesheet } from './unplugin.DH_ij6cf.mjs';
+import { S as SAFELIST_FILE, d as atomicWriteFileSync, s as sortStrings, r as renderSafelistFile, e as removeLegacySafelists, g as assertNoLegacySourceStylesheet } from './unplugin.Ba3O1r8M.mjs';
 import { createHash, randomUUID } from 'node:crypto';
 import { hostname } from 'node:os';
 import lockfile from 'proper-lockfile';

package/dist/shared/{unplugin.DDSWQJYX.cjs → unplugin.DS6CFjim.cjs}

@@ -3,6 +3,7 @@
 const node_crypto = require('node:crypto');
 const fs = require('node:fs');
 const path = require('node:path');
+const pathNormalization = require('./unplugin.BqKLlo1h.cjs');
 
 function _interopNamespaceCompat(e) {
     if (e && typeof e === 'object' && 'default' in e) return e;
@@ -27,11 +28,6 @@ function sortStrings(values) {
   });
 }
 
-const WINDOWS_PATH_SEPARATOR = String.fromCodePoint(92);
-function normalizePathSeparators(value) {
-  return value.split(WINDOWS_PATH_SEPARATOR).join("/");
-}
-
 const DEFAULT_RENAME_RETRIES = 5;
 const DEFAULT_RENAME_RETRY_DELAY_MS = 10;
 function isRetryableRenameError(error) {
@@ -229,8 +225,8 @@ function legacySourceMessage(cssFile, target) {
 const TAILWIND_SPECIFIER = String.raw`["']tailwindcss(?:\/[^"']*)?["']`;
 const TAILWIND_IMPORT = new RegExp(String.raw`@import\s+${TAILWIND_SPECIFIER}`);
 function computeSafelistRelPath(rootDir, safelistFilename, cssId) {
-  const safelistPath = normalizePathSeparators(path__namespace.join(rootDir, safelistFilename));
-  const cssDir = normalizePathSeparators(path__namespace.dirname(cssId));
+  const safelistPath = pathNormalization.normalizePathSeparators(path__namespace.join(rootDir, safelistFilename));
+  const cssDir = pathNormalization.normalizePathSeparators(path__namespace.dirname(cssId));
   let relPath = path__namespace.posix.relative(cssDir, safelistPath);
   if (!relPath.startsWith("./") && !relPath.startsWith("../")) {
     relPath = `./${relPath}`;
@@ -282,7 +278,6 @@ exports.findLegacySourceDirective = findLegacySourceDirective;
 exports.findPostcssConfigWithoutCsszyx = findPostcssConfigWithoutCsszyx;
 exports.legacySourceMessage = legacySourceMessage;
 exports.missingPostcssPluginMessage = missingPostcssPluginMessage;
-exports.normalizePathSeparators = normalizePathSeparators;
 exports.removeLegacySafelists = removeLegacySafelists;
 exports.renderSafelistFile = renderSafelistFile;
 exports.sortStrings = sortStrings;

package/dist/shared/{unplugin.gksolKh2.cjs → unplugin.DXzIP7lP.cjs}

@@ -4,9 +4,10 @@ const fs = require('node:fs');
 const path = require('node:path');
 const compiler = require('@csszyx/compiler');
 const types = require('@csszyx/types');
-const transformCache = require('./unplugin.BzF0V2kw.cjs');
-const safelistSource = require('./unplugin.DDSWQJYX.cjs');
+const transformCache = require('./unplugin.YcnV3Izb.cjs');
+const pathNormalization = require('./unplugin.BqKLlo1h.cjs');
 const node_crypto = require('node:crypto');
+const safelistSource = require('./unplugin.DS6CFjim.cjs');
 
 function _interopNamespaceCompat(e) {
     if (e && typeof e === 'object' && 'default' in e) return e;
@@ -124,7 +125,7 @@ function configWithImportedStaticSz(config, importedStaticSz) {
   };
 }
 function normalizeProviderPaths(providers) {
-  return [...new Set(providers.map(safelistSource.normalizePathSeparators))];
+  return [...new Set(providers.map(pathNormalization.normalizePathSeparators))];
 }
 
 function readPackageVersion(relativePackageJson, fromUrl) {
@@ -283,7 +284,7 @@ function createNextSourceTransformCacheInput(input, filename, producer) {
   };
 }
 function normalizeSourceFilename(filename) {
-  return safelistSource.normalizePathSeparators(filename);
+  return pathNormalization.normalizePathSeparators(filename);
 }
 function normalizeGlobalVarAliasesForCache(aliases) {
   if (!aliases) {

package/dist/shared/unplugin.DcXM9sq5.mjs

@@ -0,0 +1,109 @@
+const LEADING_WHITESPACE_RE = /^\s+/;
+const LINE_COMMENT_RE = /^\/\/[^\n]*(?:\n|$)/;
+const BLOCK_COMMENT_RE = /^\/\*[\s\S]*?\*\//;
+const USE_DIRECTIVE_RE = /^['"]use (?:client|server)['"];?\s*/;
+function insertAfterUseDirective(code, insertion) {
+  let offset = 0;
+  while (offset < code.length) {
+    const triviaLength = leadingTriviaLength(code.slice(offset));
+    if (triviaLength === 0) break;
+    offset += triviaLength;
+  }
+  const directive = USE_DIRECTIVE_RE.exec(code.slice(offset));
+  if (!directive) return `${insertion}${code}`;
+  const insertionOffset = offset + directive[0].length;
+  return `${code.slice(0, insertionOffset)}${insertion}${code.slice(insertionOffset)}`;
+}
+function leadingTriviaLength(source) {
+  return LEADING_WHITESPACE_RE.exec(source)?.[0].length ?? LINE_COMMENT_RE.exec(source)?.[0].length ?? BLOCK_COMMENT_RE.exec(source)?.[0].length ?? 0;
+}
+
+const RUNTIME_IMPORT_CLAUSE_RE = /(?:import|export)\s+\{([^{}]*)\}\s*from\s*['"]@csszyx\/runtime['"]/g;
+function clauseNames(clauseBody) {
+  const names = [];
+  for (const part of clauseBody.split(",")) {
+    const trimmed = part.trim();
+    if (!trimmed) {
+      continue;
+    }
+    const spaceAt = trimmed.search(/\s/);
+    names.push(spaceAt === -1 ? trimmed : trimmed.slice(0, spaceAt));
+  }
+  return names;
+}
+function importsRuntimeHelper(code, helper) {
+  RUNTIME_IMPORT_CLAUSE_RE.lastIndex = 0;
+  for (let match = RUNTIME_IMPORT_CLAUSE_RE.exec(code); match; match = RUNTIME_IMPORT_CLAUSE_RE.exec(code)) {
+    if (clauseNames(match[1]).includes(helper)) {
+      return true;
+    }
+  }
+  return false;
+}
+const RUNTIME_IMPORT_APPEND_RE = /(import\s+\{[^{}]*)\}\s*from\s*['"]@csszyx\/runtime['"]/;
+function findRuntimeImportClause(code) {
+  const match = RUNTIME_IMPORT_APPEND_RE.exec(code);
+  return match ? { statement: match[0], prefixWithBody: match[1] } : null;
+}
+
+function runtimeHelperGroupsFromUsage(usage) {
+  const slim = usage.usesSzPart === true && usage.szPartArgsProvable === true && usage.usesRuntime !== true && usage.usesMerge !== true;
+  const groups = { all: [], barrel: [], merge: [] };
+  const append = (helper, toMerge = false) => {
+    groups.all.push(helper);
+    (toMerge ? groups.merge : groups.barrel).push(helper);
+  };
+  if (usage.usesRuntime) append("_sz");
+  if (usage.usesMerge) append("_szMerge");
+  if (usage.usesSzcn) append("_szcn", slim);
+  if (usage.usesSzPart) append("_szPart", slim);
+  if (usage.usesSzvPick) append("__szvPick");
+  if (usage.usesSzvPick1) append("__szvPick1");
+  if (usage.usesColorVar) append("__szColorVar");
+  if (usage.usesSpacingVar) append("__szSpacingVar");
+  if (usage.usesUnitVar) append("__szUnitVar");
+  if (usage.usesBoolClass) append("__szBoolClass");
+  return groups;
+}
+function injectNextRuntimeImports(code, usage) {
+  const groups = runtimeHelperGroupsFromUsage(usage);
+  const helpers = groups.all;
+  if (helpers.length === 0) {
+    return { code, injected: [] };
+  }
+  const hasRuntimeImport = code.includes("@csszyx/runtime");
+  const missing = hasRuntimeImport ? helpers.filter((helper) => !importsRuntimeHelper(code, helper)) : helpers;
+  if (missing.length === 0) {
+    return { code, injected: [] };
+  }
+  if (groups.merge.length > 0) {
+    const mergeHelpers = missing.filter((helper) => groups.merge.includes(helper));
+    const barrelHelpers = missing.filter((helper) => groups.barrel.includes(helper));
+    let next = insertRuntimeImport(
+      code,
+      `import { ${mergeHelpers.join(", ")} } from '@csszyx/runtime/merge';
+`
+    );
+    if (barrelHelpers.length > 0) {
+      next = insertRuntimeImport(
+        next,
+        `import { ${barrelHelpers.join(", ")} } from '@csszyx/runtime';
+`
+      );
+    }
+    return { code: next, injected: missing };
+  }
+  return {
+    code: insertRuntimeImport(
+      code,
+      `import { ${missing.join(", ")} } from '@csszyx/runtime';
+`
+    ),
+    injected: missing
+  };
+}
+function insertRuntimeImport(code, importStmt) {
+  return insertAfterUseDirective(code, importStmt);
+}
+
+export { insertAfterUseDirective as a, importsRuntimeHelper as b, findRuntimeImportClause as f, injectNextRuntimeImports as i, runtimeHelperGroupsFromUsage as r };