@csszyx/unplugin 0.15.2 → 0.15.3

package/dist/shared/{unplugin.BT7PqYuK.d.cts → unplugin.CInSoHdQ.d.mts}

@@ -4,6 +4,7 @@ import { Plugin } from 'esbuild';
 import { InputPluginOption } from 'rollup';
 import { UnpluginInstance, WebpackPluginInstance } from 'unplugin';
 import { PluginOption } from 'vite';
+import { ClassAttributeSelector } from '../css-mangler.mjs';
 
 /** Source location for one CSS custom-property occurrence. */
 interface CssVarLocation {
@@ -655,6 +656,25 @@ interface MangleHybridHazards {
      * DOM class is rewritten to a token with no rule → the element loses styling.
      */
     orphans: string[];
+    /**
+     * Attribute selectors on `class` whose match depends on a name the map
+     * renamed. `[class*="bg-tag"]` matched `bg-tag-blue-bg` by text; after
+     * the rename the element carries `y4`, the rule stops applying, and
+     * nothing in the build says so — the CSS is intact and the page renders.
+     * Absent when the caller has no selector census.
+     */
+    selectorMatches?: MangleSelectorHazard[];
+}
+/** One attribute selector the mangle map breaks or newly satisfies. */
+interface MangleSelectorHazard {
+    /** The selector as written: `[class*="bg-tag"]`, with ` i` when case-insensitive. */
+    selector: string;
+    /** The attribute value the selector compares against, unescaped. */
+    value: string;
+    /** Map keys the selector was matching by name, sorted; renamed, so it no longer does. */
+    renamed: string[];
+    /** Tokens the selector would start matching that no class name did before, sorted. */
+    matchedTokens: string[];
 }
 /**
  * Detect hybrid-mangle hazards from the accumulated per-asset mangle results.
@@ -662,9 +682,10 @@ interface MangleHybridHazards {
  * @param mangleMap - the full original→token map injected into the runtime.
  * @param mangledSources - map keys that were actually found and renamed in some CSS asset.
  * @param externalClasses - class names found in CSS that are NOT in the mangle map (non-csszyx).
- * @returns the colliding tokens and orphan sources (each sorted, deduped).
+ * @param attributeSelectors - every `[class …]` selector the emitted CSS contains.
+ * @returns the colliding tokens, orphan sources and selector hazards (each sorted, deduped).
  */
-declare function collectMangleHybridHazards(mangleMap: Record<string, string>, mangledSources: ReadonlySet<string>, externalClasses: ReadonlySet<string>): MangleHybridHazards;
+declare function collectMangleHybridHazards(mangleMap: Record<string, string>, mangledSources: ReadonlySet<string>, externalClasses: ReadonlySet<string>, attributeSelectors?: readonly ClassAttributeSelector[]): MangleHybridHazards;
 /**
  * Build the hybrid-mangle hazard warning, or null when there is nothing to warn.
  *
@@ -1042,5 +1063,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { lateMangleCensusMessage as $, deleteRSCModuleRecord as A, emitMissingCssFallback as B, esbuildPlugin as D, extractGlobalVarAliasesForManifest as E, fileMayContainSafelistableSz as F, findLocalImportSources as H, findRSCBoundaryViolation as I, findRSCGraphViolation as J, hasInjectableTailwindCandidate as K, hasTokens as L, hasUseClientDirective as N, hasUseServerDirective as O, isAdvisoryDiagnostic as T, isCompileSourceOptedIn as U, isHardIgnoredPath as W, isMangleableCssId as X, isMonorepoPackage as Y, isPackagesSkippedSource as Z, isRSCServerModule as _, mangleCodeClassesSync as a0, mangleEligibleClasses as a1, mangleHybridHazardMessage as a2, mergeThemes as a3, missingTailwindEntryMessage as a4, normalizeGlobalVarAliasesForCache as a5, parseThemeBlocks as a6, parseUtilityBlocks as a7, realContentHashDisabledMessage as a8, recordGlobalVarSourceFile as a9, resolveCompileSourceDirs as aa, resolveNativeCacheIdentity as ab, resolveQuietMode as ac, rollupPlugin as ad, scanCustomPropertyNames as ae, shouldEmitMissingCssFallback as af, shouldEmitWarning as ag, shouldTrackGlobalVarSources as ah, shouldWarnMissingTailwindEntry as ai, shouldWarnUnscopedMonorepo as aj, skippedSzFilesMessage as ak, suppressedAdvisoryMessage as al, unscopedMonorepoMessage as am, vitePlugin as an, watchModeMangleMessage as ao, webpackPlugin as ap, allocateMangleTokens as s, assertNoRSCBoundaryViolation as t, assertNoRSCGraphViolation as u, collectMangleHybridHazards as v, createGlobalVarMapAssetSource as w, createRSCModuleRecord as x, cssHasContentScope as y, unplugin 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, ParsedTheme as o, ParsedUtilities as p, RSCBoundaryViolation as q, RSCModuleRecord as r };
+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 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 };

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

@@ -6,7 +6,7 @@ import * as path from 'node:path';
 import path__default, { dirname } from 'node:path';
 import { performance } from 'node:perf_hooks';
 import { fileURLToPath } from 'node:url';
-import { scanGlobalVarUsages, sortStrings as sortStrings$1, szFallbackConsequenceOf, ensureRustTransformAvailable, isWasmTransformAvailable, isRustTransformAvailable, transformRust, transformWasm, ASTBudgetExceededError, transformRustBatch, transform } from '@csszyx/compiler';
+import { scanGlobalVarUsages, sortStrings as sortStrings$1, szFallbackConsequenceOf, isWasmTransformAvailable, isRustTransformAvailable, ensureRustTransformAvailable, ASTBudgetExceededError, transformRustBatch, transformRust, transformWasm, transform } from '@csszyx/compiler';
 import { encode, compute_mangle_checksum } from '@csszyx/core';
 import { getNativePackageName } from '@csszyx/core/native';
 import { preprocess as preprocess$1 } from '@csszyx/svelte-adapter';
@@ -14,9 +14,9 @@ import { isTailwindReservedCustomProperty, CSSZYX_GLOBAL_ALIAS_PREFIX, isCsszyxG
 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 resolveCrossModuleStaticsFor, e as createTransformCacheKey, w as writeTransformCache, o as resolveProviderPath, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, g as readTransformCache, p as evictMemoryCacheToBudget, d as isReadableProviderFile } from './unplugin.Bk9o8_RZ.mjs';
-import { mangleCSSSync } from '../css-mangler.mjs';
-import { c as createMangleRuntimeModule, M as MANGLE_RUNTIME_VIRTUAL_ID, d as createThemeGroupsModule, e as ensureThemeGroupsFile, R as RESOLVED_VIRTUAL_MODULE_ID, f as createMangleMapModule, g as RESOLVED_VIRTUAL_CHECKSUM_ID, j as createChecksumModule, k as RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID, l as RESOLVED_THEME_GROUPS_VIRTUAL_ID, 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.DK0b4fr7.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 { 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 { gzipSync } from 'node:zlib';
 import postcss from 'postcss';
 import valueParser from 'postcss-value-parser';
@@ -1710,22 +1710,22 @@ function expandFilePatterns(rootDir, patterns) {
   return sortStrings(files);
 }
 
-const BACKSLASH = String.fromCodePoint(92);
+const BACKSLASH$1 = String.fromCodePoint(92);
 function unicodeEscape(hexadecimal) {
-  return `${BACKSLASH}u${hexadecimal}`;
+  return `${BACKSLASH$1}u${hexadecimal}`;
 }
 function replaceEveryLiteral(value, search, replacement) {
   return value.replaceAll(search, () => replacement);
 }
 function escapeSingleQuotedString(value) {
-  let escaped = replaceEveryLiteral(value, BACKSLASH, BACKSLASH.repeat(2));
-  escaped = replaceEveryLiteral(escaped, "'", `${BACKSLASH}'`);
-  escaped = replaceEveryLiteral(escaped, "\r", `${BACKSLASH}r`);
-  return replaceEveryLiteral(escaped, "\n", `${BACKSLASH}n`);
+  let escaped = replaceEveryLiteral(value, BACKSLASH$1, BACKSLASH$1.repeat(2));
+  escaped = replaceEveryLiteral(escaped, "'", `${BACKSLASH$1}'`);
+  escaped = replaceEveryLiteral(escaped, "\r", `${BACKSLASH$1}r`);
+  return replaceEveryLiteral(escaped, "\n", `${BACKSLASH$1}n`);
 }
 function escapeDoubleQuotedString(value) {
-  const escaped = replaceEveryLiteral(value, BACKSLASH, BACKSLASH.repeat(2));
-  return replaceEveryLiteral(escaped, '"', `${BACKSLASH}"`);
+  const escaped = replaceEveryLiteral(value, BACKSLASH$1, BACKSLASH$1.repeat(2));
+  return replaceEveryLiteral(escaped, '"', `${BACKSLASH$1}"`);
 }
 
 const LINE_SEPARATOR$1 = String.fromCodePoint(8232);
@@ -1914,6 +1914,60 @@ 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 compileManglePreserve(entries) {
+  const exact = /* @__PURE__ */ new Set();
+  const prefixes = [];
+  const list = entries ?? [];
+  list.forEach((entry, index) => {
+    if (typeof entry !== "string" || entry.length === 0) {
+      throw new TypeError(
+        `[csszyx] production.manglePreserve[${index}] must be a non-empty string (an exact class name, or a prefix ending in \`*\`); got ${describe(entry)}.`
+      );
+    }
+    if (entry === "*") {
+      throw new TypeError(
+        "[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));
+  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));
+        }
+        return !names.includes(entry);
+      });
+    }
+  };
+}
+function describe(value) {
+  if (typeof value === "string") return "an empty string";
+  if (value instanceof RegExp) return `a RegExp (${String(value)})`;
+  return `${typeof value} ${JSON.stringify(value) ?? String(value)}`;
+}
+function manglePreserveNoMatchMessage(entries) {
+  const sample = entries.slice(0, 8).join(", ");
+  const noun = entries.length === 1 ? "entry" : "entries";
+  return `[csszyx] production.manglePreserve: ${entries.length} ${noun} matched no csszyx class in this build (${sample}) \u2014 nothing was preserved for them. Check the spelling against the class census; an entry keeps a class only when its name is exact, or when it ends in \`*\` and the class starts with the rest.`;
+}
+const TOKEN_CHARACTERS = /^[0-9a-z]+$/i;
+function mangleExcludeNeverTokenEntries(entries) {
+  return [...entries].filter((entry) => !TOKEN_CHARACTERS.test(entry));
+}
+function mangleExcludeNeverTokenMessage(entries) {
+  const sample = entries.slice(0, 8).join(", ");
+  const noun = entries.length === 1 ? "name" : "names";
+  return `[csszyx] production.mangleExclude: ${entries.length} ${noun} can never be a mangle token (${sample}) \u2014 tokens are short base62 strings, so those entries do nothing. To keep a class from being renamed, list it in \`production.manglePreserve\` instead.`;
+}
+
 const MANGLE_RUNTIME_FILE = "mangle-runtime.mjs";
 function ensureMangleRuntimeFile(outputDir, globalVarAliasPrefix, exposeDebugGlobal) {
   const target = path__default.join(outputDir, MANGLE_RUNTIME_FILE);
@@ -2207,17 +2261,103 @@ function shouldWarnMissingTailwindEntry(ownedClassCount, sawTailwindEntry, sawAn
 function missingTailwindEntryMessage(ownedClassCount) {
   return `[csszyx] generated ${ownedClassCount} sz class(es) but found no CSS entry importing "tailwindcss" \u2014 those classes will produce no CSS. Import "tailwindcss" in a CSS file (csszyx auto-injects @source for the generated classes) so Tailwind emits their styles.`;
 }
-function collectMangleHybridHazards(mangleMap, mangledSources, externalClasses) {
+function asciiLower(text) {
+  return text.replace(/[A-Z]/g, (letter) => letter.toLowerCase());
+}
+function attributeSelectorPredicates(operator, value) {
+  const eq = (v) => (name) => name === v;
+  const startsWith = (v) => (name) => name.startsWith(v);
+  const endsWith = (v) => (name) => name.endsWith(v);
+  const includes = (v) => (name) => name.includes(v);
+  const dashPrefix = (v) => (name) => name === v || name.startsWith(`${v}-`);
+  const segments = value.split(/[\t\n\f\r ]+/);
+  if (segments.length === 1) {
+    switch (operator) {
+      case "=":
+      case "~=":
+        return [eq(value)];
+      case "|=":
+        return [dashPrefix(value)];
+      case "^=":
+        return [startsWith(value)];
+      case "$=":
+        return [endsWith(value)];
+      case "*=":
+        return [includes(value)];
+      default:
+        return [];
+    }
+  }
+  if (operator === "~=") return [];
+  const first = segments[0];
+  const last = segments[segments.length - 1];
+  const predicates = [];
+  if (first.length > 0) {
+    predicates.push(operator === "$=" || operator === "*=" ? endsWith(first) : eq(first));
+  }
+  for (const middle of segments.slice(1, -1)) predicates.push(eq(middle));
+  if (last.length > 0) {
+    if (operator === "^=" || operator === "*=") predicates.push(startsWith(last));
+    else if (operator === "|=") predicates.push(dashPrefix(last));
+    else predicates.push(eq(last));
+  }
+  return predicates;
+}
+function renderClassAttributeSelector(selector) {
+  const flag = selector.insensitive ? " i" : "";
+  return `[class${selector.operator}"${selector.value}"${flag}]`;
+}
+function selectorHazardFor(mangleMap, selector) {
+  const value = selector.insensitive ? asciiLower(selector.value) : selector.value;
+  const predicates = attributeSelectorPredicates(selector.operator, value);
+  if (predicates.length === 0) return null;
+  const fold = selector.insensitive ? asciiLower : (name) => name;
+  const matches = (name) => {
+    const folded = fold(name);
+    return predicates.some((predicate) => predicate(folded));
+  };
+  const renamed = sortStrings$1(Object.keys(mangleMap).filter(matches));
+  const matchedTokens = sortStrings$1(Object.values(mangleMap).filter(matches));
+  if (renamed.length === 0 && matchedTokens.length === 0) return null;
+  return {
+    selector: renderClassAttributeSelector(selector),
+    value: selector.value,
+    renamed,
+    matchedTokens
+  };
+}
+function collectMangleHybridHazards(mangleMap, mangledSources, externalClasses, attributeSelectors = []) {
   const tokenValues = new Set(Object.values(mangleMap));
   const collisions = sortStrings$1([...tokenValues].filter((token) => externalClasses.has(token)));
   const orphans = sortStrings$1(
     Object.keys(mangleMap).filter((source) => !mangledSources.has(source))
   );
-  return { collisions, orphans };
+  const hazards = /* @__PURE__ */ new Map();
+  for (const selector of attributeSelectors) {
+    const hazard = selectorHazardFor(mangleMap, selector);
+    if (hazard !== null) hazards.set(hazard.selector, hazard);
+  }
+  const selectorMatches = sortStrings$1([...hazards.keys()]).map(
+    (key) => hazards.get(key)
+  );
+  return { collisions, orphans, selectorMatches };
+}
+const BACKSLASH = String.fromCodePoint(92);
+const SINGLE_QUOTE = String.fromCodePoint(39);
+function quoteForConfig(entry) {
+  const escaped = entry.replaceAll(BACKSLASH, BACKSLASH + BACKSLASH).replaceAll(SINGLE_QUOTE, BACKSLASH + SINGLE_QUOTE);
+  return SINGLE_QUOTE + escaped + SINGLE_QUOTE;
+}
+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}*`)];
+  return hazard.renamed.map(quote);
 }
 function mangleHybridHazardMessage(hazards) {
-  const { collisions, orphans } = hazards;
-  if (collisions.length === 0 && orphans.length === 0) {
+  const { collisions, orphans, selectorMatches = [] } = hazards;
+  if (collisions.length === 0 && orphans.length === 0 && selectorMatches.length === 0) {
     return null;
   }
   const parts = ["[csszyx] production mangle found hybrid hazards:"];
@@ -2233,15 +2373,35 @@ function mangleHybridHazardMessage(hazards) {
       ` ${orphans.length} mangled class(es) have no emitted CSS rule (e.g. ${sample}) \u2014 those elements lose styling.`
     );
   }
+  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("; ");
+    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.`
+    );
+  }
+  if (newlyMatched.length > 0) {
+    const sample = newlyMatched.slice(0, 3).map((hazard) => `${hazard.selector} \u2192 ${hazard.matchedTokens.slice(0, 4).join(", ")}`).join("; ");
+    parts.push(
+      ` ${newlyMatched.length} attribute selector(s) would start matching mangled tokens instead (e.g. ${sample}).`
+    );
+  }
   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 {
+  } 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("");
 }
 const TAILWIND_IMPORT_SPECIFIER = /@import\s+["']tailwindcss(?:\/[^"']*)?["']/g;
@@ -3146,6 +3306,8 @@ function createCsszyxPlugins(options = {}) {
   const szObjectProvidersExamined = /* @__PURE__ */ new Set();
   let specifierAliases = [];
   const mangleReserved = new Set(options.production?.mangleExclude ?? []);
+  const manglePreserve = compileManglePreserve(options.production?.manglePreserve);
+  let manglePreserveNoMatchWarned = false;
   let mangleMapFrozen = false;
   let prescanSawServerModule = false;
   let skipRscRecords = false;
@@ -3156,6 +3318,7 @@ function createCsszyxPlugins(options = {}) {
   let projectCssFiles = [];
   const transformMangledSources = /* @__PURE__ */ new Set();
   const transformExternalClasses = /* @__PURE__ */ new Set();
+  const transformAttributeSelectors = /* @__PURE__ */ new Map();
   if (options.production?.mangleMapDelivery !== void 0) {
     console.warn(removedMangleMapDeliveryMessage());
   }
@@ -3185,6 +3348,10 @@ function createCsszyxPlugins(options = {}) {
   if (unknownConfigKeys.length > 0) {
     emitWarning(unknownConfigKeysMessage(unknownConfigKeys));
   }
+  const excludeNeverTokens = mangleExcludeNeverTokenEntries(mangleReserved);
+  if (excludeNeverTokens.length > 0) {
+    emitWarning(mangleExcludeNeverTokenMessage(excludeNeverTokens));
+  }
   function emitWarning(message, opts = {}) {
     if (shouldEmitWarning(quiet, opts.devOnly ?? false, process.env.NODE_ENV === "production")) {
       console.warn(message);
@@ -4045,10 +4212,15 @@ function createCsszyxPlugins(options = {}) {
       ...state.authoredClasses,
       ...state.ownedClasses
     ]);
-    return allocateMangleTokens(
-      mangleEligibleClasses(state.ownedClasses, state.authoredClasses),
-      forbiddenTokens
+    const eligible = mangleEligibleClasses(state.ownedClasses, state.authoredClasses).filter(
+      (className) => !manglePreserve.test(className)
     );
+    if (!manglePreserveNoMatchWarned && manglingEnabled && state.ownedClasses.size > 0) {
+      manglePreserveNoMatchWarned = true;
+      const unmatched = manglePreserve.unmatched(state.ownedClasses);
+      if (unmatched.length > 0) emitWarning(manglePreserveNoMatchMessage(unmatched));
+    }
+    return allocateMangleTokens(eligible, forbiddenTokens);
   }
   function freezeMangleMap() {
     state.mangleMap = computeMangleMap();
@@ -4201,6 +4373,38 @@ function createCsszyxPlugins(options = {}) {
     }
     return modules;
   }
+  function handleHotFile(pass, ctx) {
+    const { isClientPass } = pass;
+    if (isClientPass) {
+      prescanResultHandoff.clear();
+    }
+    const scanCss = options.build?.scanCss;
+    const reloadThemeGroupsModule = () => {
+      const themeGroupsModule = ctx.server.moduleGraph.getModuleById(
+        RESOLVED_THEME_GROUPS_VIRTUAL_ID
+      );
+      if (themeGroupsModule) {
+        ctx.server.moduleGraph.invalidateModule(themeGroupsModule);
+      }
+    };
+    if (isClientPass && ctx.file.endsWith(".css")) {
+      const root = state.rootDir;
+      const before = createThemeGroupsModule(themeGroupTokens());
+      if (scanCss && matchesAnyPattern(ctx.file, scanCss, root)) {
+        state.scanCssTheme = runThemeScan(root, scanCss) ?? state.scanCssTheme;
+      }
+      runAutoThemeScan(root);
+      reloadThemeGroupsModule();
+      if (createThemeGroupsModule(themeGroupTokens()) !== before) {
+        ctx.server.ws.send({ type: "full-reload" });
+      }
+    }
+    if (normalizePathSeparators(ctx.file) === normalizePathSeparators(path.join(state.rootDir, SAFELIST_FILENAME))) {
+      return tailwindEntryModules(pass.moduleGraph());
+    }
+    if (isClientPass) discoverHotFileClasses(ctx.file, ctx.server.watcher);
+    return void 0;
+  }
   function transformTailwindCssEntry(code, id) {
     state.sawAnyCss = true;
     const [cssFile] = id.split("?");
@@ -4702,38 +4906,39 @@ ${transformedCode}`;
          * which leaves Vite's own handling in place.
          */
         hotUpdate(ctx) {
-          const isClientPass = (this.environment?.name ?? "client") === "client";
-          if (isClientPass) {
-            prescanResultHandoff.clear();
-          }
-          const scanCss = options.build?.scanCss;
-          const reloadThemeGroupsModule = () => {
-            const themeGroupsModule = ctx.server.moduleGraph.getModuleById(
-              RESOLVED_THEME_GROUPS_VIRTUAL_ID
-            );
-            if (themeGroupsModule) {
-              ctx.server.moduleGraph.invalidateModule(themeGroupsModule);
-            }
-          };
-          if (isClientPass && ctx.file.endsWith(".css")) {
-            const root = ctx.server.config.root || process.cwd();
-            const before = createThemeGroupsModule(themeGroupTokens());
-            if (scanCss && matchesAnyPattern(ctx.file, scanCss, root)) {
-              state.scanCssTheme = runThemeScan(root, scanCss) ?? state.scanCssTheme;
-            }
-            runAutoThemeScan(root);
-            reloadThemeGroupsModule();
-            if (createThemeGroupsModule(themeGroupTokens()) !== before) {
-              ctx.server.ws.send({ type: "full-reload" });
-            }
-          }
-          if (normalizePathSeparators(ctx.file) === normalizePathSeparators(path.join(state.rootDir, SAFELIST_FILENAME))) {
-            return tailwindEntryModules(
-              this.environment?.moduleGraph ?? ctx.server.environments.client.moduleGraph
-            );
-          }
-          if (isClientPass) discoverHotFileClasses(ctx.file, ctx.server.watcher);
-          return void 0;
+          return handleHotFile(
+            {
+              isClientPass: (this.environment?.name ?? "client") === "client",
+              // `server.moduleGraph` holds the backward-compatible
+              // nodes Vite mapped back for the legacy hook only,
+              // so they are the wrong objects to hand this one —
+              // TypeScript says so too.
+              moduleGraph: () => this.environment?.moduleGraph ?? ctx.server.environments.client.moduleGraph
+            },
+            ctx
+          );
+        },
+        /**
+         * The hook Vite 5 calls. Vite 6 and later never run it while
+         * `hotUpdate` is declared, so declaring both costs nothing
+         * there and keeps a Vite 5 dev server compiling `sz` live.
+         *
+         * Vite 5 routes only a file CHANGE here, never a create, so a
+         * project with no `sz` at prescan still sees its first `sz`
+         * edit answered by `@tailwindcss/vite`'s full reload on that
+         * generation — the behaviour it always had there. The hook
+         * runs once, with no environment, so it is the client pass
+         * and answers from the server-wide graph.
+         *
+         * @param ctx - HMR context: the changed file and the dev server.
+         * @returns The modules a safelist write affects; undefined
+         * otherwise.
+         */
+        handleHotUpdate(ctx) {
+          return handleHotFile(
+            { isClientPass: true, moduleGraph: () => ctx.server.moduleGraph },
+            ctx
+          );
         },
         transformIndexHtml: {
           order: "pre",
@@ -4822,7 +5027,7 @@ ${transformedCode}`;
     recordCodePair(sizeAccount, before, after);
     return after;
   }
-  function rewriteOutputCss(source, file, shouldMangle, mangledSources, externalClasses) {
+  function rewriteOutputCss(source, file, shouldMangle, mangledSources, externalClasses, attributeSelectors) {
     const css = rewriteCssWithValidatedGlobalVarPlan(
       source,
       file,
@@ -4836,6 +5041,9 @@ ${transformedCode}`;
       });
       for (const className of result.mangledClasses) mangledSources.add(className);
       for (const className of result.unmangledClasses) externalClasses.add(className);
+      for (const selector of result.classAttributeSelectors) {
+        attributeSelectors.set(classAttributeSelectorKey(selector), selector);
+      }
       const mangled = result.transformedCount > 0 ? result.css : css;
       recordCssPair(sizeAccount, css, mangled);
       return mangled;
@@ -4844,10 +5052,12 @@ ${transformedCode}`;
       throw error;
     }
   }
-  function reportOutputMangleHazards(shouldMangle, mangledSources, externalClasses) {
+  function reportOutputMangleHazards(shouldMangle, mangledSources, externalClasses, attributeSelectors) {
     if (!shouldMangle) return;
     const message = mangleHybridHazardMessage(
-      collectMangleHybridHazards(state.mangleMap, mangledSources, externalClasses)
+      collectMangleHybridHazards(state.mangleMap, mangledSources, externalClasses, [
+        ...attributeSelectors.values()
+      ])
     );
     if (message) console.warn(message);
   }
@@ -4908,6 +5118,7 @@ ${transformedCode}`;
     }
     const mangledSources = /* @__PURE__ */ new Set();
     const externalClasses = /* @__PURE__ */ new Set();
+    const attributeSelectors = /* @__PURE__ */ new Map();
     for (const file in assets) {
       const source = assets[file].source().toString();
       if (file.endsWith(".css")) {
@@ -4916,7 +5127,8 @@ ${transformedCode}`;
           file,
           shouldMangle,
           mangledSources,
-          externalClasses
+          externalClasses,
+          attributeSelectors
         );
         if (css !== source) {
           compilation.updateAsset(file, new compiler.webpack.sources.RawSource(css));
@@ -4925,10 +5137,15 @@ ${transformedCode}`;
         rewriteWebpackCodeAsset(file, source, shouldMangle, compilation, compiler);
       }
     }
-    reportOutputMangleHazards(shouldMangle, mangledSources, externalClasses);
+    reportOutputMangleHazards(
+      shouldMangle,
+      mangledSources,
+      externalClasses,
+      attributeSelectors
+    );
     reportBuildSummary();
   }
-  function rewriteViteBundleEntry(chunk, file, shouldMangle, mangledSources, externalClasses) {
+  function rewriteViteBundleEntry(chunk, file, shouldMangle, mangledSources, externalClasses, attributeSelectors) {
     if (chunk.type !== "asset" || !chunk.fileName.endsWith(".css") || chunk.source === void 0) {
       return;
     }
@@ -4938,7 +5155,8 @@ ${transformedCode}`;
       file,
       shouldMangle,
       mangledSources,
-      externalClasses
+      externalClasses,
+      attributeSelectors
     );
     if (css !== originalCss) chunk.source = css;
   }
@@ -4949,7 +5167,8 @@ ${transformedCode}`;
       id,
       shouldMangle,
       transformMangledSources,
-      transformExternalClasses
+      transformExternalClasses,
+      transformAttributeSelectors
     );
     return css === code ? null : { code: css, map: null };
   }
@@ -4974,6 +5193,7 @@ ${transformedCode}`;
     }
     const mangledSources = new Set(transformMangledSources);
     const externalClasses = new Set(transformExternalClasses);
+    const attributeSelectors = new Map(transformAttributeSelectors);
     if (!cssRewrittenInTransform) {
       for (const file in bundle) {
         rewriteViteBundleEntry(
@@ -4981,11 +5201,17 @@ ${transformedCode}`;
           file,
           shouldMangle,
           mangledSources,
-          externalClasses
+          externalClasses,
+          attributeSelectors
         );
       }
     }
-    reportOutputMangleHazards(shouldMangle, mangledSources, externalClasses);
+    reportOutputMangleHazards(
+      shouldMangle,
+      mangledSources,
+      externalClasses,
+      attributeSelectors
+    );
   }
   const postPlugin = createUnplugin(() => ({
     name: "csszyx:post",

package/dist/shared/{unplugin.DK0b4fr7.mjs → unplugin.Ceq-N4jI.mjs}

@@ -587,4 +587,4 @@ function themeGroupsSpecifier(fromFile, themeGroupsFile) {
   return relative.startsWith("./") || relative.startsWith("../") ? relative : `./${relative}`;
 }
 
-export { CHECKSUM_PLACEHOLDER as C, MANGLE_RUNTIME_VIRTUAL_ID as M, RESOLVED_VIRTUAL_MODULE_ID as R, THEME_GROUPS_VIRTUAL_ID as T, VAR_MANGLE_MAP_PLACEHOLDER as V, parseUtilityBlocks as a, insertAfterUseDirective as b, createMangleRuntimeModule as c, createThemeGroupsModule as d, ensureThemeGroupsFile as e, createMangleMapModule as f, RESOLVED_VIRTUAL_CHECKSUM_ID as g, hasTokens as h, injectNextRuntimeImports as i, createChecksumModule as j, RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID as k, RESOLVED_THEME_GROUPS_VIRTUAL_ID as l, mergeThemes as m, isVirtualModule as n, discoverProjectTheme as o, parseThemeBlocks as p, CENSUS_PLACEHOLDER as q, resolveVirtualModule as r, scanCustomPropertyNames as s, themeGroupsSpecifier as t, importsRuntimeHelper as u, findRuntimeImportClause as v, THEME_GROUPS_FILE_MARKER as w, runtimeHelperGroupsFromUsage as x, MANGLE_MAP_PLACEHOLDER as y };
+export { CHECKSUM_PLACEHOLDER as C, MANGLE_RUNTIME_VIRTUAL_ID as M, RESOLVED_VIRTUAL_MODULE_ID as R, THEME_GROUPS_VIRTUAL_ID as T, VAR_MANGLE_MAP_PLACEHOLDER as V, parseUtilityBlocks as a, insertAfterUseDirective as b, createMangleRuntimeModule as c, createMangleMapModule as d, ensureThemeGroupsFile as e, RESOLVED_VIRTUAL_CHECKSUM_ID as f, createChecksumModule as g, hasTokens as h, injectNextRuntimeImports as i, RESOLVED_MANGLE_RUNTIME_VIRTUAL_ID as j, RESOLVED_THEME_GROUPS_VIRTUAL_ID as k, createThemeGroupsModule as l, mergeThemes as m, isVirtualModule as n, discoverProjectTheme as o, parseThemeBlocks as p, CENSUS_PLACEHOLDER as q, resolveVirtualModule as r, scanCustomPropertyNames as s, themeGroupsSpecifier as t, importsRuntimeHelper as u, findRuntimeImportClause as v, THEME_GROUPS_FILE_MARKER as w, runtimeHelperGroupsFromUsage as x, MANGLE_MAP_PLACEHOLDER as y };

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

@@ -2,7 +2,7 @@ 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.Bk9o8_RZ.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.C-oQU1jl.mjs';
 import { n as normalizePathSeparators, s as sortStrings } from './unplugin.DH_ij6cf.mjs';
 import { createHash } from 'node:crypto';