@csszyx/unplugin 0.11.6 → 0.11.8

package/README.md

@@ -69,9 +69,14 @@ module.exports = {
 - **sz prop transform** -- Compiles `sz={{ }}` objects into `className` strings. Defaults to the **native Rust engine** through the optional `@csszyx/core-*` platform package; opt back into the previous oxc-parser JavaScript path with `build.parser: "oxc"`, or fall through to Babel with `build.parser: "babel"`.
 - **HTML injection** -- Injects mangle maps and checksums for SSR hydration
 - **HMR support** -- Updates styles instantly during development
-- **CSS mangling** -- Compresses class names (e.g., `text-center` -> `z`) in production builds
+- **CSS mangling** -- Compresses owned class names (e.g., `text-center` -> `z`) while retaining names shared with source-visible `class`/`className` strings and template quasis
 - **File filters** -- Top-level `include` / `exclude` (glob or RegExp) skip large generated files before the AST budget guard fires; see [Config Overview](https://csszyx.com/config/overview#file-filters)
 
+Class mangling runs in Vite, Webpack, and Rollup final-output hooks. The esbuild
+adapter supports source transforms and safelist generation but disables class
+mangling because esbuild does not expose a mutable final-output hook when writing
+directly to disk; explicit `production.mangle: true` emits a warning.
+
 ## Parser selection
 
 The default parser is `rust`, which runs through the native engine in the

package/dist/css-mangler.cjs

@@ -8,65 +8,68 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 const postcss__default = /*#__PURE__*/_interopDefaultCompat(postcss);
 const selectorParser__default = /*#__PURE__*/_interopDefaultCompat(selectorParser);
 
+const BACKSLASH = String.fromCodePoint(92);
 function unescapeTailwindClass(escapedName) {
   let result = "";
   let i = 0;
   while (i < escapedName.length) {
-    if (escapedName[i] === "\\") {
-      i++;
-      if (i >= escapedName.length) {
-        break;
-      }
-      const char = escapedName[i];
-      if (/[0-9a-f]/i.test(char)) {
-        let hexStr = "";
-        while (i < escapedName.length && /[0-9a-f]/i.test(escapedName[i]) && hexStr.length < 6) {
-          hexStr += escapedName[i];
-          i++;
-        }
-        if (i < escapedName.length && escapedName[i] === " ") {
-          i++;
-        }
-        const codePoint = parseInt(hexStr, 16);
-        if (codePoint > 0) {
-          result += String.fromCodePoint(codePoint);
-        }
-        continue;
-      }
-      result += char;
-      i++;
-    } else {
+    if (escapedName[i] !== BACKSLASH) {
       result += escapedName[i];
       i++;
+      continue;
     }
+    const decoded = readCssEscape(escapedName, i + 1);
+    if (!decoded) break;
+    result += decoded.value;
+    i = decoded.next;
   }
   return result;
 }
+function readCssEscape(source, start) {
+  if (start >= source.length) return null;
+  if (!/[0-9a-f]/i.test(source[start])) return { value: source[start], next: start + 1 };
+  let next = start;
+  let hex = "";
+  while (next < source.length && /[0-9a-f]/i.test(source[next]) && hex.length < 6) {
+    hex += source[next];
+    next++;
+  }
+  if (source[next] === " ") next++;
+  const codePoint = Number.parseInt(hex, 16);
+  return { value: codePoint > 0 ? String.fromCodePoint(codePoint) : "", next };
+}
+function escapeLeadingClassCharacter(className, char) {
+  if (/\d/.test(char)) {
+    return `${BACKSLASH}3${char} `;
+  }
+  if (char === "-" && className.length > 1) {
+    const next = className[1];
+    if (/\d/.test(next) || next === "-") {
+      return `${BACKSLASH}-`;
+    }
+  }
+  return null;
+}
+function escapeClassCharacter(char) {
+  const codePoint = char.codePointAt(0) ?? 0;
+  const requiresEscape = codePoint >= 33 && codePoint <= 47 && codePoint !== 45 || codePoint >= 58 && codePoint <= 64 || codePoint >= 91 && codePoint <= 94 || codePoint === 96 || codePoint >= 123 && codePoint <= 126;
+  if (requiresEscape) {
+    return `${BACKSLASH}${char}`;
+  }
+  return char;
+}
 function escapeCSSClassName(className) {
   let result = "";
   for (let i = 0; i < className.length; i++) {
     const char = className[i];
-    const code = char.charCodeAt(0);
     if (i === 0) {
-      if (/\d/.test(char)) {
-        result += `\\3${char} `;
+      const escapedLeading = escapeLeadingClassCharacter(className, char);
+      if (escapedLeading !== null) {
+        result += escapedLeading;
         continue;
       }
-      if (char === "-" && i + 1 < className.length) {
-        const next = className[i + 1];
-        if (/\d/.test(next) || next === "-") {
-          result += "\\-";
-          continue;
-        }
-      }
-    }
-    if (/[!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~]/.test(char)) {
-      result += `\\${char}`;
-    } else if (code >= 128) {
-      result += char;
-    } else {
-      result += char;
     }
+    result += escapeClassCharacter(char);
   }
   return result;
 }

package/dist/css-mangler.mjs

@@ -1,65 +1,68 @@
 import postcss from 'postcss';
 import selectorParser from 'postcss-selector-parser';
 
+const BACKSLASH = String.fromCodePoint(92);
 function unescapeTailwindClass(escapedName) {
   let result = "";
   let i = 0;
   while (i < escapedName.length) {
-    if (escapedName[i] === "\\") {
-      i++;
-      if (i >= escapedName.length) {
-        break;
-      }
-      const char = escapedName[i];
-      if (/[0-9a-f]/i.test(char)) {
-        let hexStr = "";
-        while (i < escapedName.length && /[0-9a-f]/i.test(escapedName[i]) && hexStr.length < 6) {
-          hexStr += escapedName[i];
-          i++;
-        }
-        if (i < escapedName.length && escapedName[i] === " ") {
-          i++;
-        }
-        const codePoint = parseInt(hexStr, 16);
-        if (codePoint > 0) {
-          result += String.fromCodePoint(codePoint);
-        }
-        continue;
-      }
-      result += char;
-      i++;
-    } else {
+    if (escapedName[i] !== BACKSLASH) {
       result += escapedName[i];
       i++;
+      continue;
     }
+    const decoded = readCssEscape(escapedName, i + 1);
+    if (!decoded) break;
+    result += decoded.value;
+    i = decoded.next;
   }
   return result;
 }
+function readCssEscape(source, start) {
+  if (start >= source.length) return null;
+  if (!/[0-9a-f]/i.test(source[start])) return { value: source[start], next: start + 1 };
+  let next = start;
+  let hex = "";
+  while (next < source.length && /[0-9a-f]/i.test(source[next]) && hex.length < 6) {
+    hex += source[next];
+    next++;
+  }
+  if (source[next] === " ") next++;
+  const codePoint = Number.parseInt(hex, 16);
+  return { value: codePoint > 0 ? String.fromCodePoint(codePoint) : "", next };
+}
+function escapeLeadingClassCharacter(className, char) {
+  if (/\d/.test(char)) {
+    return `${BACKSLASH}3${char} `;
+  }
+  if (char === "-" && className.length > 1) {
+    const next = className[1];
+    if (/\d/.test(next) || next === "-") {
+      return `${BACKSLASH}-`;
+    }
+  }
+  return null;
+}
+function escapeClassCharacter(char) {
+  const codePoint = char.codePointAt(0) ?? 0;
+  const requiresEscape = codePoint >= 33 && codePoint <= 47 && codePoint !== 45 || codePoint >= 58 && codePoint <= 64 || codePoint >= 91 && codePoint <= 94 || codePoint === 96 || codePoint >= 123 && codePoint <= 126;
+  if (requiresEscape) {
+    return `${BACKSLASH}${char}`;
+  }
+  return char;
+}
 function escapeCSSClassName(className) {
   let result = "";
   for (let i = 0; i < className.length; i++) {
     const char = className[i];
-    const code = char.charCodeAt(0);
     if (i === 0) {
-      if (/\d/.test(char)) {
-        result += `\\3${char} `;
+      const escapedLeading = escapeLeadingClassCharacter(className, char);
+      if (escapedLeading !== null) {
+        result += escapedLeading;
         continue;
       }
-      if (char === "-" && i + 1 < className.length) {
-        const next = className[i + 1];
-        if (/\d/.test(next) || next === "-") {
-          result += "\\-";
-          continue;
-        }
-      }
-    }
-    if (/[!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~]/.test(char)) {
-      result += `\\${char}`;
-    } else if (code >= 128) {
-      result += char;
-    } else {
-      result += char;
     }
+    result += escapeClassCharacter(char);
   }
   return result;
 }

package/dist/index.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const cssMangler = require('./css-mangler.cjs');
-const unplugin = require('./shared/unplugin.CP2cz9bA.cjs');
+const unplugin = require('./shared/unplugin.DtPQz8Kg.cjs');
 const types = require('@csszyx/types');
 require('postcss');
 require('postcss-selector-parser');
@@ -19,9 +19,9 @@ require('@csszyx/core/native');
 require('@csszyx/svelte-adapter');
 require('@csszyx/vue-adapter');
 require('unplugin');
-require('./shared/unplugin.BCwRIUs_.cjs');
-require('./shared/unplugin.Rov-j_Wm.cjs');
-require('./shared/unplugin.D0N9bprz.cjs');
+require('./shared/unplugin.DmuOKVS4.cjs');
+require('./shared/unplugin.DVCQC5wq.cjs');
+require('./shared/unplugin.CcA7jP1r.cjs');
 require('postcss-value-parser');
 
 
@@ -61,6 +61,7 @@ exports.isPackagesSkippedSource = unplugin.isPackagesSkippedSource;
 exports.isRSCServerModule = unplugin.isRSCServerModule;
 exports.isTailwindReservedGlobalVar = unplugin.isTailwindReservedGlobalVar;
 exports.mangleCodeClassesSync = unplugin.mangleCodeClassesSync;
+exports.mangleEligibleClasses = unplugin.mangleEligibleClasses;
 exports.mangleHybridHazardMessage = unplugin.mangleHybridHazardMessage;
 exports.mergeThemes = unplugin.mergeThemes;
 exports.missingTailwindEntryMessage = unplugin.missingTailwindEntryMessage;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.cjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
-import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.PhOFTQpB.cjs';
+import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.CNwV3RrQ.cjs';
 // @ts-ignore
 export = undefined;
-export { e as CssVarDefinition, f as CssVarLocation, g as CssVarReference, h as GlobalVarAliasDiagnostic, i as GlobalVarAliasDiagnosticSeverity, j as GlobalVarAliasEntry, k as GlobalVarCodeSource, l as GlobalVarCssAssetSource, m as GlobalVarCssSource, n as GlobalVarScanCacheEntry, M as MangleHybridHazards, o as ParsedTheme, p as RSCBoundaryViolation, q as RSCModuleRecord, r as appendTailwindSourceDirective, s as assertNoRSCBoundaryViolation, t as assertNoRSCGraphViolation, u as collectMangleHybridHazards, v as computeSafelistRelPath, w as createGlobalVarMapAssetSource, x as createRSCModuleRecord, y as cssHasContentScope, z as cssImportsTailwind, B as deleteRSCModuleRecord, D as esbuildPlugin, E as extractGlobalVarAliasesForManifest, F as fileMayContainSafelistableSz, H as findLocalImportSources, I as findRSCBoundaryViolation, J as findRSCGraphViolation, K as hasInjectableTailwindCandidate, L as hasTokens, N as hasUseClientDirective, O as hasUseServerDirective, Q as isCompileSourceOptedIn, T as isHardIgnoredPath, U as isMonorepoPackage, W as isPackagesSkippedSource, X as isRSCServerModule, Y as mangleCodeClassesSync, Z as mangleHybridHazardMessage, _ as mergeThemes, $ as missingTailwindEntryMessage, a0 as normalizeGlobalVarAliasesForCache, a1 as parseThemeBlocks, a2 as recordGlobalVarSourceFile, a3 as resolveCompileSourceDirs, a4 as resolveNativeCacheIdentity, a5 as rollupPlugin, a6 as scanCustomPropertyNames, a7 as shouldEmitWarning, a8 as shouldTrackGlobalVarSources, a9 as shouldWarnMissingTailwindEntry, aa as shouldWarnUnscopedMonorepo, ab as skippedSzFilesMessage, A as unplugin, ac as unscopedMonorepoMessage, ad as vitePlugin, ae as webpackPlugin } from './shared/unplugin.PhOFTQpB.cjs';
+export { e as CssVarDefinition, f as CssVarLocation, g as CssVarReference, h as GlobalVarAliasDiagnostic, i as GlobalVarAliasDiagnosticSeverity, j as GlobalVarAliasEntry, k as GlobalVarCodeSource, l as GlobalVarCssAssetSource, m as GlobalVarCssSource, n as GlobalVarScanCacheEntry, M as MangleHybridHazards, o as ParsedTheme, p as RSCBoundaryViolation, q as RSCModuleRecord, r as appendTailwindSourceDirective, s as assertNoRSCBoundaryViolation, t as assertNoRSCGraphViolation, u as collectMangleHybridHazards, v as computeSafelistRelPath, w as createGlobalVarMapAssetSource, x as createRSCModuleRecord, y as cssHasContentScope, z as cssImportsTailwind, B as deleteRSCModuleRecord, D as esbuildPlugin, E as extractGlobalVarAliasesForManifest, F as fileMayContainSafelistableSz, H as findLocalImportSources, I as findRSCBoundaryViolation, J as findRSCGraphViolation, K as hasInjectableTailwindCandidate, L as hasTokens, N as hasUseClientDirective, O as hasUseServerDirective, Q as isCompileSourceOptedIn, T as isHardIgnoredPath, U as isMonorepoPackage, W as isPackagesSkippedSource, X as isRSCServerModule, Y as mangleCodeClassesSync, Z as mangleEligibleClasses, _ as mangleHybridHazardMessage, $ as mergeThemes, a0 as missingTailwindEntryMessage, a1 as normalizeGlobalVarAliasesForCache, a2 as parseThemeBlocks, a3 as recordGlobalVarSourceFile, a4 as resolveCompileSourceDirs, a5 as resolveNativeCacheIdentity, a6 as rollupPlugin, a7 as scanCustomPropertyNames, a8 as shouldEmitWarning, a9 as shouldTrackGlobalVarSources, aa as shouldWarnMissingTailwindEntry, ab as shouldWarnUnscopedMonorepo, ac as skippedSzFilesMessage, A as unplugin, ad as unscopedMonorepoMessage, ae as vitePlugin, af as webpackPlugin } from './shared/unplugin.CNwV3RrQ.cjs';
 import 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
-import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.PhOFTQpB.mjs';
-export { e as CssVarDefinition, f as CssVarLocation, g as CssVarReference, h as GlobalVarAliasDiagnostic, i as GlobalVarAliasDiagnosticSeverity, j as GlobalVarAliasEntry, k as GlobalVarCodeSource, l as GlobalVarCssAssetSource, m as GlobalVarCssSource, n as GlobalVarScanCacheEntry, M as MangleHybridHazards, o as ParsedTheme, p as RSCBoundaryViolation, q as RSCModuleRecord, r as appendTailwindSourceDirective, s as assertNoRSCBoundaryViolation, t as assertNoRSCGraphViolation, u as collectMangleHybridHazards, v as computeSafelistRelPath, w as createGlobalVarMapAssetSource, x as createRSCModuleRecord, y as cssHasContentScope, z as cssImportsTailwind, A as default, B as deleteRSCModuleRecord, D as esbuildPlugin, E as extractGlobalVarAliasesForManifest, F as fileMayContainSafelistableSz, H as findLocalImportSources, I as findRSCBoundaryViolation, J as findRSCGraphViolation, K as hasInjectableTailwindCandidate, L as hasTokens, N as hasUseClientDirective, O as hasUseServerDirective, Q as isCompileSourceOptedIn, T as isHardIgnoredPath, U as isMonorepoPackage, W as isPackagesSkippedSource, X as isRSCServerModule, Y as mangleCodeClassesSync, Z as mangleHybridHazardMessage, _ as mergeThemes, $ as missingTailwindEntryMessage, a0 as normalizeGlobalVarAliasesForCache, a1 as parseThemeBlocks, a2 as recordGlobalVarSourceFile, a3 as resolveCompileSourceDirs, a4 as resolveNativeCacheIdentity, a5 as rollupPlugin, a6 as scanCustomPropertyNames, a7 as shouldEmitWarning, a8 as shouldTrackGlobalVarSources, a9 as shouldWarnMissingTailwindEntry, aa as shouldWarnUnscopedMonorepo, ab as skippedSzFilesMessage, A as unplugin, ac as unscopedMonorepoMessage, ad as vitePlugin, ae as webpackPlugin } from './shared/unplugin.PhOFTQpB.mjs';
+import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.CNwV3RrQ.mjs';
+export { e as CssVarDefinition, f as CssVarLocation, g as CssVarReference, h as GlobalVarAliasDiagnostic, i as GlobalVarAliasDiagnosticSeverity, j as GlobalVarAliasEntry, k as GlobalVarCodeSource, l as GlobalVarCssAssetSource, m as GlobalVarCssSource, n as GlobalVarScanCacheEntry, M as MangleHybridHazards, o as ParsedTheme, p as RSCBoundaryViolation, q as RSCModuleRecord, r as appendTailwindSourceDirective, s as assertNoRSCBoundaryViolation, t as assertNoRSCGraphViolation, u as collectMangleHybridHazards, v as computeSafelistRelPath, w as createGlobalVarMapAssetSource, x as createRSCModuleRecord, y as cssHasContentScope, z as cssImportsTailwind, A as default, B as deleteRSCModuleRecord, D as esbuildPlugin, E as extractGlobalVarAliasesForManifest, F as fileMayContainSafelistableSz, H as findLocalImportSources, I as findRSCBoundaryViolation, J as findRSCGraphViolation, K as hasInjectableTailwindCandidate, L as hasTokens, N as hasUseClientDirective, O as hasUseServerDirective, Q as isCompileSourceOptedIn, T as isHardIgnoredPath, U as isMonorepoPackage, W as isPackagesSkippedSource, X as isRSCServerModule, Y as mangleCodeClassesSync, Z as mangleEligibleClasses, _ as mangleHybridHazardMessage, $ as mergeThemes, a0 as missingTailwindEntryMessage, a1 as normalizeGlobalVarAliasesForCache, a2 as parseThemeBlocks, a3 as recordGlobalVarSourceFile, a4 as resolveCompileSourceDirs, a5 as resolveNativeCacheIdentity, a6 as rollupPlugin, a7 as scanCustomPropertyNames, a8 as shouldEmitWarning, a9 as shouldTrackGlobalVarSources, aa as shouldWarnMissingTailwindEntry, ab as shouldWarnUnscopedMonorepo, ac as skippedSzFilesMessage, A as unplugin, ad as unscopedMonorepoMessage, ae as vitePlugin, af as webpackPlugin } from './shared/unplugin.CNwV3RrQ.mjs';
 import 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
-export { a as appendTailwindSourceDirective, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as collectMangleHybridHazards, e as computeSafelistRelPath, f as createGlobalVarAliasValidationOptions, g as createGlobalVarMapAssetSource, h as createGlobalVarScanCacheKey, i as createRSCModuleRecord, j as cssHasContentScope, k as cssImportsTailwind, u as default, l as deleteRSCModuleRecord, m as esbuildPlugin, n as extractGlobalVarAliasesForManifest, o as fileMayContainSafelistableSz, p as findLocalImportSources, q as findRSCBoundaryViolation, r as findRSCGraphViolation, s as hasInjectableTailwindCandidate, t as hasTokens, v as hasUseClientDirective, w as hasUseServerDirective, x as isCompileSourceOptedIn, y as isHardIgnoredPath, z as isMonorepoPackage, A as isPackagesSkippedSource, B as isRSCServerModule, C as isTailwindReservedGlobalVar, D as mangleCodeClassesSync, E as mangleHybridHazardMessage, F as mergeThemes, G as missingTailwindEntryMessage, H as normalizeGlobalVarAliasesForCache, I as parseThemeBlocks, J as planGlobalVarAliases, K as readGlobalVarScanCache, L as recordGlobalVarSourceFile, M as resolveCompileSourceDirs, N as resolveGlobalVarScanCacheDir, O as resolveNativeCacheIdentity, P as rewriteGlobalVarCssAliases, Q as rollupPlugin, R as scanCustomPropertyNames, S as scanGlobalVarCss, T as shouldEmitWarning, U as shouldTrackGlobalVarSources, V as shouldWarnMissingTailwindEntry, W as shouldWarnUnscopedMonorepo, X as skippedSzFilesMessage, u as unplugin, Y as unscopedMonorepoMessage, Z as validateGlobalVarAliasInputs, _ as vitePlugin, $ as webpackPlugin, a0 as writeGlobalVarScanCache } from './shared/unplugin.BS60onPk.mjs';
+export { a as appendTailwindSourceDirective, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as collectMangleHybridHazards, e as computeSafelistRelPath, f as createGlobalVarAliasValidationOptions, g as createGlobalVarMapAssetSource, h as createGlobalVarScanCacheKey, i as createRSCModuleRecord, j as cssHasContentScope, k as cssImportsTailwind, u as default, l as deleteRSCModuleRecord, m as esbuildPlugin, n as extractGlobalVarAliasesForManifest, o as fileMayContainSafelistableSz, p as findLocalImportSources, q as findRSCBoundaryViolation, r as findRSCGraphViolation, s as hasInjectableTailwindCandidate, t as hasTokens, v as hasUseClientDirective, w as hasUseServerDirective, x as isCompileSourceOptedIn, y as isHardIgnoredPath, z as isMonorepoPackage, A as isPackagesSkippedSource, B as isRSCServerModule, C as isTailwindReservedGlobalVar, D as mangleCodeClassesSync, E as mangleEligibleClasses, F as mangleHybridHazardMessage, G as mergeThemes, H as missingTailwindEntryMessage, I as normalizeGlobalVarAliasesForCache, J as parseThemeBlocks, K as planGlobalVarAliases, L as readGlobalVarScanCache, M as recordGlobalVarSourceFile, N as resolveCompileSourceDirs, O as resolveGlobalVarScanCacheDir, P as resolveNativeCacheIdentity, Q as rewriteGlobalVarCssAliases, R as rollupPlugin, S as scanCustomPropertyNames, T as scanGlobalVarCss, U as shouldEmitWarning, V as shouldTrackGlobalVarSources, W as shouldWarnMissingTailwindEntry, X as shouldWarnUnscopedMonorepo, Y as skippedSzFilesMessage, u as unplugin, Z as unscopedMonorepoMessage, _ as validateGlobalVarAliasInputs, $ as vitePlugin, a0 as webpackPlugin, a1 as writeGlobalVarScanCache } from './shared/unplugin.DtYxS8M8.mjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
 import 'postcss';
 import 'postcss-selector-parser';
@@ -15,7 +15,7 @@ import '@csszyx/core/native';
 import '@csszyx/svelte-adapter';
 import '@csszyx/vue-adapter';
 import 'unplugin';
-import './shared/unplugin.B1mblcm-.mjs';
-import './shared/unplugin.B3RHYokB.mjs';
-import './shared/unplugin.ByzV6iZE.mjs';
+import './shared/unplugin.nnsa7OVW.mjs';
+import './shared/unplugin.D-K57LNR.mjs';
+import './shared/unplugin.TtmP77BS.mjs';
 import 'postcss-value-parser';

package/dist/next-config.cjs

@@ -10,7 +10,7 @@ function csszyxTurbopack(existing = {}, options = {}) {
   return {
     ...existing,
     rules: {
-      ...existing.rules ?? {},
+      ...existing.rules,
       [glob]: {
         loaders: [
           {

package/dist/next-config.mjs

@@ -8,7 +8,7 @@ function csszyxTurbopack(existing = {}, options = {}) {
   return {
     ...existing,
     rules: {
-      ...existing.rules ?? {},
+      ...existing.rules,
       [glob]: {
         loaders: [
           {

package/dist/next-prebuild.cjs

@@ -3,11 +3,11 @@
 const node_crypto = require('node:crypto');
 const fs = require('node:fs');
 const path = require('node:path');
-const nextTransformMetadata = require('./shared/unplugin.CBKZoxQ1.cjs');
-const nextWatcherCycle = require('./shared/unplugin.BFN_Ueyx.cjs');
-const transformCache = require('./shared/unplugin.D0N9bprz.cjs');
+const nextTransformMetadata = require('./shared/unplugin.DdtOZANG.cjs');
+const nextWatcherCycle = require('./shared/unplugin.C9dMG7ye.cjs');
+const transformCache = require('./shared/unplugin.DVCQC5wq.cjs');
 require('@csszyx/compiler');
-require('./shared/unplugin.BCwRIUs_.cjs');
+require('./shared/unplugin.CcA7jP1r.cjs');
 require('node:os');
 require('proper-lockfile');
 
@@ -143,7 +143,7 @@ function uniqueFiles(files) {
   return result;
 }
 function createShardCacheKey(context, metadata) {
-  return node_crypto.createHash("sha256").update(context.identity.generation).update("\0").update(path__namespace.relative(context.root, metadata.sourcePath).replace(/\\/g, "/")).digest("hex");
+  return node_crypto.createHash("sha256").update(context.identity.generation).update("\0").update(transformCache.normalizePathSeparators(path__namespace.relative(context.root, metadata.sourcePath))).digest("hex");
 }
 
 exports.runNextPrebuild = runNextPrebuild;

package/dist/next-prebuild.mjs

@@ -1,11 +1,11 @@
 import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
 import * as path from 'node:path';
-import { r as readPackageVersion, t as transformNextSource, c as collectNextTransformMetadata, a as createNextSafelistShardFromMetadata } from './shared/unplugin.B3cvNxnk.mjs';
-import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle } from './shared/unplugin.ChwZMl_w.mjs';
-import { r as resolveTransformCacheDir } from './shared/unplugin.ByzV6iZE.mjs';
+import { r as readPackageVersion, t as transformNextSource, c as collectNextTransformMetadata, a as createNextSafelistShardFromMetadata } from './shared/unplugin.Rl8sIkHi.mjs';
+import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle } from './shared/unplugin.Dg1tGPSd.mjs';
+import { r as resolveTransformCacheDir, n as normalizePathSeparators } from './shared/unplugin.D-K57LNR.mjs';
 import '@csszyx/compiler';
-import './shared/unplugin.B1mblcm-.mjs';
+import './shared/unplugin.TtmP77BS.mjs';
 import 'node:os';
 import 'proper-lockfile';
 
@@ -126,7 +126,7 @@ function uniqueFiles(files) {
   return result;
 }
 function createShardCacheKey(context, metadata) {
-  return createHash("sha256").update(context.identity.generation).update("\0").update(path.relative(context.root, metadata.sourcePath).replace(/\\/g, "/")).digest("hex");
+  return createHash("sha256").update(context.identity.generation).update("\0").update(normalizePathSeparators(path.relative(context.root, metadata.sourcePath))).digest("hex");
 }
 
 export { runNextPrebuild };

package/dist/next-turbo-loader.cjs

@@ -4,14 +4,14 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 const node_crypto = require('node:crypto');
 const path = require('node:path');
-const nextWatcherCycle = require('./shared/unplugin.BFN_Ueyx.cjs');
-const nextTransformMetadata = require('./shared/unplugin.CBKZoxQ1.cjs');
-const runtimeImportScan = require('./shared/unplugin.Rov-j_Wm.cjs');
-const transformCache = require('./shared/unplugin.D0N9bprz.cjs');
+const nextWatcherCycle = require('./shared/unplugin.C9dMG7ye.cjs');
+const nextTransformMetadata = require('./shared/unplugin.DdtOZANG.cjs');
+const runtimeImportScan = require('./shared/unplugin.DmuOKVS4.cjs');
+const transformCache = require('./shared/unplugin.DVCQC5wq.cjs');
 require('node:fs');
 require('node:os');
 require('proper-lockfile');
-require('./shared/unplugin.BCwRIUs_.cjs');
+require('./shared/unplugin.CcA7jP1r.cjs');
 require('@csszyx/compiler');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -29,7 +29,6 @@ function _interopNamespaceCompat(e) {
 
 const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
 
-const DIRECTIVE_PROLOGUE_PREFIX_RE = /^((?:\s|\/\/[^\n]*\n|\/\*(?:[^*]|\*(?!\/))*\*\/)*)(['"]use (?:client|server)['"];?\s*)/;
 function injectNextRuntimeImports(code, usage) {
   const helpers = runtimeHelpersFromUsage(usage);
   if (helpers.length === 0) {
@@ -66,14 +65,16 @@ function runtimeHelpersFromUsage(usage) {
   if (usage.usesColorVar) {
     helpers.push("__szColorVar");
   }
+  if (usage.usesSpacingVar) {
+    helpers.push("__szSpacingVar");
+  }
+  if (usage.usesUnitVar) {
+    helpers.push("__szUnitVar");
+  }
   return helpers;
 }
 function insertRuntimeImport(code, importStmt) {
-  const directiveMatch = code.match(DIRECTIVE_PROLOGUE_PREFIX_RE);
-  if (!directiveMatch) {
-    return `${importStmt}${code}`;
-  }
-  return code.replace(directiveMatch[0], `${directiveMatch[1]}${directiveMatch[2]}${importStmt}`);
+  return runtimeImportScan.insertAfterUseDirective(code, importStmt);
 }
 
 function runNextTurboLoader(source, loaderContext, explicitOptions = {}) {
@@ -217,7 +218,7 @@ function hasEnabledMangleVars(config) {
   return config.mangleVars === true;
 }
 function createShardCacheKey(context, metadata) {
-  return node_crypto.createHash("sha256").update(context.identity.generation).update("\0").update(path__namespace.relative(context.root, metadata.sourcePath).replace(/\\/g, "/")).digest("hex");
+  return node_crypto.createHash("sha256").update(context.identity.generation).update("\0").update(transformCache.normalizePathSeparators(path__namespace.relative(context.root, metadata.sourcePath))).digest("hex");
 }
 
 exports.default = nextTurboLoader;

package/dist/next-turbo-loader.mjs

@@ -1,16 +1,15 @@
 import { createHash } from 'node:crypto';
 import * as path from 'node:path';
-import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle, v as validateNextGenerationManifest, a as readNextGenerationManifest } from './shared/unplugin.ChwZMl_w.mjs';
-import { r as readPackageVersion, t as transformNextSource, c as collectNextTransformMetadata, a as createNextSafelistShardFromMetadata } from './shared/unplugin.B3cvNxnk.mjs';
-import { i as importsRuntimeHelper } from './shared/unplugin.B3RHYokB.mjs';
-import { r as resolveTransformCacheDir } from './shared/unplugin.ByzV6iZE.mjs';
+import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle, v as validateNextGenerationManifest, a as readNextGenerationManifest } from './shared/unplugin.Dg1tGPSd.mjs';
+import { r as readPackageVersion, t as transformNextSource, c as collectNextTransformMetadata, a as createNextSafelistShardFromMetadata } from './shared/unplugin.Rl8sIkHi.mjs';
+import { i as importsRuntimeHelper, a as insertAfterUseDirective } from './shared/unplugin.nnsa7OVW.mjs';
+import { r as resolveTransformCacheDir, n as normalizePathSeparators } from './shared/unplugin.D-K57LNR.mjs';
 import 'node:fs';
 import 'node:os';
 import 'proper-lockfile';
-import './shared/unplugin.B1mblcm-.mjs';
+import './shared/unplugin.TtmP77BS.mjs';
 import '@csszyx/compiler';
 
-const DIRECTIVE_PROLOGUE_PREFIX_RE = /^((?:\s|\/\/[^\n]*\n|\/\*(?:[^*]|\*(?!\/))*\*\/)*)(['"]use (?:client|server)['"];?\s*)/;
 function injectNextRuntimeImports(code, usage) {
   const helpers = runtimeHelpersFromUsage(usage);
   if (helpers.length === 0) {
@@ -47,14 +46,16 @@ function runtimeHelpersFromUsage(usage) {
   if (usage.usesColorVar) {
     helpers.push("__szColorVar");
   }
+  if (usage.usesSpacingVar) {
+    helpers.push("__szSpacingVar");
+  }
+  if (usage.usesUnitVar) {
+    helpers.push("__szUnitVar");
+  }
   return helpers;
 }
 function insertRuntimeImport(code, importStmt) {
-  const directiveMatch = code.match(DIRECTIVE_PROLOGUE_PREFIX_RE);
-  if (!directiveMatch) {
-    return `${importStmt}${code}`;
-  }
-  return code.replace(directiveMatch[0], `${directiveMatch[1]}${directiveMatch[2]}${importStmt}`);
+  return insertAfterUseDirective(code, importStmt);
 }
 
 function runNextTurboLoader(source, loaderContext, explicitOptions = {}) {
@@ -198,7 +199,7 @@ function hasEnabledMangleVars(config) {
   return config.mangleVars === true;
 }
 function createShardCacheKey(context, metadata) {
-  return createHash("sha256").update(context.identity.generation).update("\0").update(path.relative(context.root, metadata.sourcePath).replace(/\\/g, "/")).digest("hex");
+  return createHash("sha256").update(context.identity.generation).update("\0").update(normalizePathSeparators(path.relative(context.root, metadata.sourcePath))).digest("hex");
 }
 
 export { nextTurboLoader as default, runNextTurboLoader };

package/dist/next-watcher.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
 const path = require('node:path');
-const nextWatcherCycle = require('./shared/unplugin.BFN_Ueyx.cjs');
+const nextWatcherCycle = require('./shared/unplugin.C9dMG7ye.cjs');
 require('node:fs');
 require('node:crypto');
 require('node:os');
 require('proper-lockfile');
-require('./shared/unplugin.BCwRIUs_.cjs');
+require('./shared/unplugin.CcA7jP1r.cjs');
 
 function _interopNamespaceCompat(e) {
     if (e && typeof e === 'object' && 'default' in e) return e;

package/dist/next-watcher.mjs

@@ -1,10 +1,10 @@
 import * as path from 'node:path';
-import { r as runNextWatcherCycle } from './shared/unplugin.ChwZMl_w.mjs';
+import { r as runNextWatcherCycle } from './shared/unplugin.Dg1tGPSd.mjs';
 import 'node:fs';
 import 'node:crypto';
 import 'node:os';
 import 'proper-lockfile';
-import './shared/unplugin.B1mblcm-.mjs';
+import './shared/unplugin.TtmP77BS.mjs';
 
 class NextWatcherLoop {
   context;

package/dist/shared/{unplugin.BFN_Ueyx.cjs → unplugin.C9dMG7ye.cjs}

@@ -5,7 +5,7 @@ const fs = require('node:fs');
 const node_crypto = require('node:crypto');
 const node_os = require('node:os');
 const lockfile = require('proper-lockfile');
-const htmlEscape = require('./unplugin.BCwRIUs_.cjs');
+const htmlEscape = require('./unplugin.CcA7jP1r.cjs');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
@@ -152,7 +152,7 @@ function atomicWriteFileSync(file, content, options = {}) {
   const dir = path__namespace.dirname(file);
   const tmp = path__namespace.join(
     dir,
-    `.tmp-${path__namespace.basename(file)}-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`
+    `.tmp-${path__namespace.basename(file)}-${process.pid}-${Date.now()}-${node_crypto.randomUUID()}`
   );
   fs__namespace.mkdirSync(dir, { recursive: true });
   fs__namespace.writeFileSync(tmp, content, "utf8");
@@ -253,8 +253,10 @@ function renderTailwindSourceHtml(classNames) {
   if (classNames.length === 0) {
     return "<!-- csszyx Next safelist: empty -->\n";
   }
-  return `${classNames.map((className) => `<div class="${htmlEscape.escapeHtmlAttribute(className)}"></div>`).join("\n")}
-`;
+  const structuralHtml = classNames.map((className) => `<div class="${htmlEscape.escapeHtmlAttribute(className)}"></div>`).join("\n");
+  const scannerCandidates = htmlEscape.renderTailwindScannerCandidates(classNames);
+  return `${structuralHtml}
+${scannerCandidates}`;
 }
 function createLockMetadata(options) {
   const now = new Date(options.now ?? Date.now()).toISOString();
@@ -262,7 +264,7 @@ function createLockMetadata(options) {
   return {
     version: 1,
     pid,
-    token: options.token ?? node_crypto.createHash("sha256").update(`${pid}\0${now}\0${Math.random().toString(36)}`).digest("hex"),
+    token: options.token ?? node_crypto.randomUUID(),
     hostname: node_os.hostname(),
     root: path__namespace.resolve(options.root ?? process.cwd()),
     mode: options.mode ?? "development",

package/dist/shared/{unplugin.PhOFTQpB.d.cts → unplugin.CNwV3RrQ.d.cts}

@@ -430,12 +430,17 @@ interface PluginState {
     /** Memoized `isMonorepoPackage(rootDir)` result; `undefined` until computed. */
     inMonorepo?: boolean;
     /**
-     * Classes csszyx generated by lowering `sz` props — the ONLY classes the
-     * mangle map may rename. Author-written `className` values are deliberately
-     * excluded: renaming them would break selectors an external stylesheet (or
-     * JS that references classes by name) owns.
+     * Classes csszyx generated by lowering `sz` props. Final map eligibility
+     * subtracts authoredClasses because a class can be both generated and used
+     * by a raw selector consumer.
      */
     ownedClasses: Set<string>;
+    /**
+     * Classes written through author-facing class/className attributes. Any
+     * overlap with ownedClasses must keep its original name because bundled
+     * helper calls may not preserve enough context for safe string rewriting.
+     */
+    authoredClasses: Set<string>;
     /** Unresolvable-spread warnings surfaced to the build log in every mode. */
     spreadWarnings: Set<string>;
     /**
@@ -706,6 +711,14 @@ declare function isHardIgnoredPath(id: string, sourceDirs?: readonly string[]):
  * @returns true when the file should be prescanned for safelist extraction.
  */
 declare function fileMayContainSafelistableSz(content: string): boolean;
+/**
+ * Return csszyx-owned classes that are safe to rename.
+ *
+ * @param ownedClasses Classes emitted from sz transforms.
+ * @param authoredClasses Classes also written in class/className source positions.
+ * @returns Owned classes with hybrid raw consumers removed.
+ */
+declare function mangleEligibleClasses(ownedClasses: ReadonlySet<string>, authoredClasses: ReadonlySet<string>): string[];
 /**
  * Whether a file is workspace-package source that csszyx skipped only because it
  * lives under `/packages/` and is not under any opted-in `compileSources`
@@ -836,5 +849,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { missingTailwindEntryMessage as $, unplugin as A, deleteRSCModuleRecord 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, isCompileSourceOptedIn as Q, isHardIgnoredPath as T, isMonorepoPackage as U, isPackagesSkippedSource as W, isRSCServerModule as X, mangleCodeClassesSync as Y, mangleHybridHazardMessage as Z, mergeThemes as _, normalizeGlobalVarAliasesForCache as a0, parseThemeBlocks as a1, recordGlobalVarSourceFile as a2, resolveCompileSourceDirs as a3, resolveNativeCacheIdentity as a4, rollupPlugin as a5, scanCustomPropertyNames as a6, shouldEmitWarning as a7, shouldTrackGlobalVarSources as a8, shouldWarnMissingTailwindEntry as a9, shouldWarnUnscopedMonorepo as aa, skippedSzFilesMessage as ab, unscopedMonorepoMessage as ac, vitePlugin as ad, webpackPlugin as ae, appendTailwindSourceDirective as r, assertNoRSCBoundaryViolation as s, assertNoRSCGraphViolation as t, collectMangleHybridHazards as u, computeSafelistRelPath as v, createGlobalVarMapAssetSource as w, createRSCModuleRecord as x, cssHasContentScope as y, cssImportsTailwind as z };
+export { mergeThemes as $, unplugin as A, deleteRSCModuleRecord 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, isCompileSourceOptedIn as Q, isHardIgnoredPath as T, isMonorepoPackage as U, isPackagesSkippedSource as W, isRSCServerModule as X, mangleCodeClassesSync as Y, mangleEligibleClasses as Z, mangleHybridHazardMessage as _, missingTailwindEntryMessage as a0, normalizeGlobalVarAliasesForCache as a1, parseThemeBlocks as a2, recordGlobalVarSourceFile as a3, resolveCompileSourceDirs as a4, resolveNativeCacheIdentity as a5, rollupPlugin as a6, scanCustomPropertyNames as a7, shouldEmitWarning as a8, shouldTrackGlobalVarSources as a9, shouldWarnMissingTailwindEntry as aa, shouldWarnUnscopedMonorepo as ab, skippedSzFilesMessage as ac, unscopedMonorepoMessage as ad, vitePlugin as ae, webpackPlugin as af, appendTailwindSourceDirective as r, assertNoRSCBoundaryViolation as s, assertNoRSCGraphViolation as t, collectMangleHybridHazards as u, computeSafelistRelPath as v, createGlobalVarMapAssetSource as w, createRSCModuleRecord as x, cssHasContentScope as y, cssImportsTailwind as z };
 export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, MangleHybridHazards as M, PlanGlobalVarAliasesInput as P, 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, RSCBoundaryViolation as p, RSCModuleRecord as q };