@csszyx/unplugin 0.16.0 → 0.17.0

package/dist/shared/{unplugin.Dx0ngYWw.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,6 +1898,9 @@ 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`.)";
 }
@@ -2372,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) {
@@ -2387,34 +2379,34 @@ function mangleHybridHazardMessage(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.`,
-      " 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."
+      `${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.`,
-      " 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."
+      `${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."
     );
   }
   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.`,
-      ` 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.`
+      `${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}).`,
-      ` 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.`
+      `${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.`
     );
   }
-  return parts.join("");
+  return parts.join("\n");
 }
 const TAILWIND_IMPORT_SPECIFIER = /@import\s+["']tailwindcss(?:\/[^"']*)?["']/g;
 const SOURCE_MODIFIER = /\bsource\(/;
@@ -2457,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";
@@ -2480,6 +2474,13 @@ 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";
 }
@@ -3315,6 +3316,8 @@ ${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();
@@ -3338,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;
@@ -3432,6 +3438,7 @@ function createCsszyxPlugins(options = {}) {
     skipWarningEmitted: false,
     classesCapped: false,
     ownedClasses: /* @__PURE__ */ new Set(),
+    mangleEligible: [],
     authoredClasses: /* @__PURE__ */ new Set(),
     mangleMap: {},
     varMangleEntriesByFile: varMangleEntries,
@@ -4236,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() {
@@ -4453,6 +4462,7 @@ 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;
@@ -4512,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)}`;
     }
@@ -4969,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
             });
@@ -5016,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;
@@ -5378,4 +5386,4 @@ const esbuildPlugin = (options = {}) => {
   };
 };
 
-export { suppressedAdvisoryMessage 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, shouldHoldAdvisories as W, shouldTrackGlobalVarSources as X, shouldWarnMissingTailwindEntry as Y, shouldWarnUnscopedMonorepo as Z, skippedSzFilesMessage as _, allocateMangleTokens as a, unscopedMonorepoMessage as a0, validateGlobalVarAliasInputs as a1, vitePlugin as a2, watchModeMangleMessage as a3, webpackPlugin as a4, writeGlobalVarScanCache as a5, 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 };

package/dist/shared/unplugin.Defu9wGh.cjs

@@ -0,0 +1,115 @@
+'use strict';
+
+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);
+}
+
+exports.findRuntimeImportClause = findRuntimeImportClause;
+exports.importsRuntimeHelper = importsRuntimeHelper;
+exports.injectNextRuntimeImports = injectNextRuntimeImports;
+exports.insertAfterUseDirective = insertAfterUseDirective;
+exports.runtimeHelperGroupsFromUsage = runtimeHelperGroupsFromUsage;

package/dist/shared/{unplugin.Bu2rzRtv.d.mts → unplugin.DptK3pl4.d.mts}

@@ -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.
  *
@@ -1079,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, shouldHoldAdvisories as ai, shouldTrackGlobalVarSources as aj, shouldWarnMissingTailwindEntry as ak, shouldWarnUnscopedMonorepo as al, skippedSzFilesMessage as am, suppressedAdvisoryMessage as an, unscopedMonorepoMessage as ao, vitePlugin as ap, watchModeMangleMessage as aq, webpackPlugin as ar, 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 };