@csszyx/unplugin 0.16.0 → 0.17.0

package/README.md

@@ -69,7 +69,7 @@ module.exports = {
 - **sz prop transform** -- Compiles `sz={{ }}` objects into `className` strings with ONE engine that ships as two artifacts: the **native Rust addon** (default, through the optional `@csszyx/core-*` platform package) and the same engine compiled to **WebAssembly** (shipped inside `@csszyx/core`, the automatic fallback when the native binary is absent — pin it with `build.parser: "wasm"`).
 - **HTML injection** -- Injects mangle maps and checksums for SSR hydration
 - **HMR support** -- Updates styles instantly during development
-- **CSS mangling** -- Compresses owned class names (e.g., `text-center` -> `z`) while retaining names shared with source-visible `class`/`className` strings and template quasis
+- **CSS mangling** (opt-in) -- Renames owned class names to short tokens (e.g., `text-center` -> `z`) to hide the utility vocabulary, not to shrink the payload, 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

package/dist/index.cjs

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const cssMangler = require('./css-mangler.cjs');
-const unplugin = require('./shared/unplugin.D3yBoTHP.cjs');
-const themeGroupsFile = require('./shared/unplugin.J6ue_lRJ.cjs');
+const unplugin = require('./shared/unplugin.9zs6T4Gf.cjs');
+const themeGroupsFile = require('./shared/unplugin.2qOISpzl.cjs');
 const types = require('@csszyx/types');
-const safelistSource = require('./shared/unplugin.DDSWQJYX.cjs');
+const safelistSource = require('./shared/unplugin.DS6CFjim.cjs');
 require('postcss');
 require('postcss-selector-parser');
 require('node:crypto');
@@ -21,7 +21,9 @@ require('@csszyx/core/native');
 require('@csszyx/svelte-adapter');
 require('@csszyx/vue-adapter');
 require('unplugin');
-require('./shared/unplugin.BzF0V2kw.cjs');
+require('./shared/unplugin.YcnV3Izb.cjs');
+require('./shared/unplugin.BqKLlo1h.cjs');
+require('./shared/unplugin.Defu9wGh.cjs');
 require('node:zlib');
 require('postcss-value-parser');
 
@@ -44,6 +46,7 @@ exports.createRSCModuleRecord = unplugin.createRSCModuleRecord;
 exports.cssHasContentScope = unplugin.cssHasContentScope;
 exports.default = unplugin.unplugin;
 exports.deleteRSCModuleRecord = unplugin.deleteRSCModuleRecord;
+exports.emitKeyValueDiagnostic = unplugin.emitKeyValueDiagnostic;
 exports.emitMissingCssFallback = unplugin.emitMissingCssFallback;
 exports.esbuildPlugin = unplugin.esbuildPlugin;
 exports.extractGlobalVarAliasesForManifest = unplugin.extractGlobalVarAliasesForManifest;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 export { CSSManglerOptions, CSSManglerResult, ClassAttributeSelector, MangleMap, classAttributeSelectorKey, 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.PKo7wFzu.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.BO2_hyS3.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 MangleSelectorHazard, p as ParsedTheme, q as ParsedUtilities, Q as QuietMode, r as RSCBoundaryViolation, s as RSCModuleRecord, t as allocateMangleTokens, u as assertNoRSCBoundaryViolation, v as assertNoRSCGraphViolation, w as collectMangleHybridHazards, x as createGlobalVarMapAssetSource, y as createRSCModuleRecord, z as cssHasContentScope, B as deleteRSCModuleRecord, D as emitMissingCssFallback, E as esbuildPlugin, F as extractGlobalVarAliasesForManifest, H as fileMayContainSafelistableSz, I as findLocalImportSources, J as findRSCBoundaryViolation, K as findRSCGraphViolation, L as hasInjectableTailwindCandidate, N as hasTokens, O as hasUseClientDirective, T as hasUseServerDirective, U as isAdvisoryDiagnostic, W as isCompileSourceOptedIn, X as isHardIgnoredPath, Y as isMangleableCssId, Z as isMonorepoPackage, _ as isPackagesSkippedSource, $ as isRSCServerModule, a0 as lateMangleCensusMessage, a1 as mangleCodeClassesSync, a2 as mangleEligibleClasses, a3 as mangleHybridHazardMessage, a4 as mergeThemes, a5 as missingTailwindEntryMessage, a6 as normalizeGlobalVarAliasesForCache, a7 as parseThemeBlocks, a8 as parseUtilityBlocks, a9 as realContentHashDisabledMessage, aa as recordGlobalVarSourceFile, ab as resolveCompileSourceDirs, ac as resolveNativeCacheIdentity, ad as resolveQuietMode, ae as rollupPlugin, af as scanCustomPropertyNames, ag as shouldEmitMissingCssFallback, ah as shouldEmitWarning, ai as shouldHoldAdvisories, aj as shouldTrackGlobalVarSources, ak as shouldWarnMissingTailwindEntry, al as shouldWarnUnscopedMonorepo, am as skippedSzFilesMessage, an as suppressedAdvisoryMessage, A as unplugin, ao as unscopedMonorepoMessage, ap as vitePlugin, aq as watchModeMangleMessage, ar as webpackPlugin } from './shared/unplugin.PKo7wFzu.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 MangleSelectorHazard, p as ParsedTheme, q as ParsedUtilities, Q as QuietMode, r as RSCBoundaryViolation, s as RSCModuleRecord, t as allocateMangleTokens, u as assertNoRSCBoundaryViolation, v as assertNoRSCGraphViolation, w as collectMangleHybridHazards, x as createGlobalVarMapAssetSource, y as createRSCModuleRecord, z as cssHasContentScope, B as deleteRSCModuleRecord, D as emitKeyValueDiagnostic, E as emitMissingCssFallback, F as esbuildPlugin, H as extractGlobalVarAliasesForManifest, I as fileMayContainSafelistableSz, J as findLocalImportSources, K as findRSCBoundaryViolation, L as findRSCGraphViolation, N as hasInjectableTailwindCandidate, O as hasTokens, T as hasUseClientDirective, U as hasUseServerDirective, W as isAdvisoryDiagnostic, X as isCompileSourceOptedIn, Y as isHardIgnoredPath, Z as isMangleableCssId, _ as isMonorepoPackage, $ as isPackagesSkippedSource, a0 as isRSCServerModule, a1 as lateMangleCensusMessage, a2 as mangleCodeClassesSync, a3 as mangleEligibleClasses, a4 as mangleHybridHazardMessage, a5 as mergeThemes, a6 as missingTailwindEntryMessage, a7 as normalizeGlobalVarAliasesForCache, a8 as parseThemeBlocks, a9 as parseUtilityBlocks, aa as realContentHashDisabledMessage, ab as recordGlobalVarSourceFile, ac as resolveCompileSourceDirs, ad as resolveNativeCacheIdentity, ae as resolveQuietMode, af as rollupPlugin, ag as scanCustomPropertyNames, ah as shouldEmitMissingCssFallback, ai as shouldEmitWarning, aj as shouldHoldAdvisories, ak as shouldTrackGlobalVarSources, al as shouldWarnMissingTailwindEntry, am as shouldWarnUnscopedMonorepo, an as skippedSzFilesMessage, ao as suppressedAdvisoryMessage, A as unplugin, ap as unscopedMonorepoMessage, aq as vitePlugin, ar as watchModeMangleMessage, as as webpackPlugin } from './shared/unplugin.BO2_hyS3.cjs';
 import 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 export { CSSManglerOptions, CSSManglerResult, ClassAttributeSelector, MangleMap, classAttributeSelectorKey, 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.Bu2rzRtv.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 MangleSelectorHazard, p as ParsedTheme, q as ParsedUtilities, Q as QuietMode, r as RSCBoundaryViolation, s as RSCModuleRecord, t as allocateMangleTokens, u as assertNoRSCBoundaryViolation, v as assertNoRSCGraphViolation, w as collectMangleHybridHazards, x as createGlobalVarMapAssetSource, y as createRSCModuleRecord, z as cssHasContentScope, A as default, B as deleteRSCModuleRecord, D as emitMissingCssFallback, E as esbuildPlugin, F as extractGlobalVarAliasesForManifest, H as fileMayContainSafelistableSz, I as findLocalImportSources, J as findRSCBoundaryViolation, K as findRSCGraphViolation, L as hasInjectableTailwindCandidate, N as hasTokens, O as hasUseClientDirective, T as hasUseServerDirective, U as isAdvisoryDiagnostic, W as isCompileSourceOptedIn, X as isHardIgnoredPath, Y as isMangleableCssId, Z as isMonorepoPackage, _ as isPackagesSkippedSource, $ as isRSCServerModule, a0 as lateMangleCensusMessage, a1 as mangleCodeClassesSync, a2 as mangleEligibleClasses, a3 as mangleHybridHazardMessage, a4 as mergeThemes, a5 as missingTailwindEntryMessage, a6 as normalizeGlobalVarAliasesForCache, a7 as parseThemeBlocks, a8 as parseUtilityBlocks, a9 as realContentHashDisabledMessage, aa as recordGlobalVarSourceFile, ab as resolveCompileSourceDirs, ac as resolveNativeCacheIdentity, ad as resolveQuietMode, ae as rollupPlugin, af as scanCustomPropertyNames, ag as shouldEmitMissingCssFallback, ah as shouldEmitWarning, ai as shouldHoldAdvisories, aj as shouldTrackGlobalVarSources, ak as shouldWarnMissingTailwindEntry, al as shouldWarnUnscopedMonorepo, am as skippedSzFilesMessage, an as suppressedAdvisoryMessage, A as unplugin, ao as unscopedMonorepoMessage, ap as vitePlugin, aq as watchModeMangleMessage, ar as webpackPlugin } from './shared/unplugin.Bu2rzRtv.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.DptK3pl4.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 MangleSelectorHazard, p as ParsedTheme, q as ParsedUtilities, Q as QuietMode, r as RSCBoundaryViolation, s as RSCModuleRecord, t as allocateMangleTokens, u as assertNoRSCBoundaryViolation, v as assertNoRSCGraphViolation, w as collectMangleHybridHazards, x as createGlobalVarMapAssetSource, y as createRSCModuleRecord, z as cssHasContentScope, A as default, B as deleteRSCModuleRecord, D as emitKeyValueDiagnostic, E as emitMissingCssFallback, F as esbuildPlugin, H as extractGlobalVarAliasesForManifest, I as fileMayContainSafelistableSz, J as findLocalImportSources, K as findRSCBoundaryViolation, L as findRSCGraphViolation, N as hasInjectableTailwindCandidate, O as hasTokens, T as hasUseClientDirective, U as hasUseServerDirective, W as isAdvisoryDiagnostic, X as isCompileSourceOptedIn, Y as isHardIgnoredPath, Z as isMangleableCssId, _ as isMonorepoPackage, $ as isPackagesSkippedSource, a0 as isRSCServerModule, a1 as lateMangleCensusMessage, a2 as mangleCodeClassesSync, a3 as mangleEligibleClasses, a4 as mangleHybridHazardMessage, a5 as mergeThemes, a6 as missingTailwindEntryMessage, a7 as normalizeGlobalVarAliasesForCache, a8 as parseThemeBlocks, a9 as parseUtilityBlocks, aa as realContentHashDisabledMessage, ab as recordGlobalVarSourceFile, ac as resolveCompileSourceDirs, ad as resolveNativeCacheIdentity, ae as resolveQuietMode, af as rollupPlugin, ag as scanCustomPropertyNames, ah as shouldEmitMissingCssFallback, ai as shouldEmitWarning, aj as shouldHoldAdvisories, ak as shouldTrackGlobalVarSources, al as shouldWarnMissingTailwindEntry, am as shouldWarnUnscopedMonorepo, an as skippedSzFilesMessage, ao as suppressedAdvisoryMessage, A as unplugin, ap as unscopedMonorepoMessage, aq as vitePlugin, ar as watchModeMangleMessage, as as webpackPlugin } from './shared/unplugin.DptK3pl4.mjs';
 import 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';

package/dist/index.mjs

@@ -1,8 +1,8 @@
 export { classAttributeSelectorKey, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
-export { a as allocateMangleTokens, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as collectMangleHybridHazards, e as createGlobalVarAliasValidationOptions, f as createGlobalVarMapAssetSource, g as createGlobalVarScanCacheKey, h as createRSCModuleRecord, i as cssHasContentScope, u as default, j as deleteRSCModuleRecord, k as emitMissingCssFallback, l as esbuildPlugin, m as extractGlobalVarAliasesForManifest, n as fileMayContainSafelistableSz, o as findLocalImportSources, p as findRSCBoundaryViolation, q as findRSCGraphViolation, r as hasInjectableTailwindCandidate, s as hasUseClientDirective, t as hasUseServerDirective, v as isAdvisoryDiagnostic, w as isCompileSourceOptedIn, x as isHardIgnoredPath, y as isMangleableCssId, z as isMonorepoPackage, A as isPackagesSkippedSource, B as isRSCServerModule, C as isTailwindReservedGlobalVar, D as lateMangleCensusMessage, E as mangleCodeClassesSync, F as mangleEligibleClasses, G as mangleHybridHazardMessage, H as missingTailwindEntryMessage, I as normalizeGlobalVarAliasesForCache, J as planGlobalVarAliases, K as readGlobalVarScanCache, L as realContentHashDisabledMessage, M as recordGlobalVarSourceFile, N as resolveCompileSourceDirs, O as resolveGlobalVarScanCacheDir, P as resolveNativeCacheIdentity, Q as resolveQuietMode, R as rewriteGlobalVarCssAliases, S as rollupPlugin, T as scanGlobalVarCss, U as shouldEmitMissingCssFallback, V as shouldEmitWarning, W as shouldHoldAdvisories, X as shouldTrackGlobalVarSources, Y as shouldWarnMissingTailwindEntry, Z as shouldWarnUnscopedMonorepo, _ as skippedSzFilesMessage, $ as suppressedAdvisoryMessage, u as unplugin, a0 as unscopedMonorepoMessage, a1 as validateGlobalVarAliasInputs, a2 as vitePlugin, a3 as watchModeMangleMessage, a4 as webpackPlugin, a5 as writeGlobalVarScanCache } from './shared/unplugin.Dx0ngYWw.mjs';
-export { h as hasTokens, m as mergeThemes, p as parseThemeBlocks, a as parseUtilityBlocks, s as scanCustomPropertyNames } from './shared/unplugin.Ceq-N4jI.mjs';
+export { a as allocateMangleTokens, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as collectMangleHybridHazards, e as createGlobalVarAliasValidationOptions, f as createGlobalVarMapAssetSource, g as createGlobalVarScanCacheKey, h as createRSCModuleRecord, i as cssHasContentScope, u as default, j as deleteRSCModuleRecord, k as emitKeyValueDiagnostic, l as emitMissingCssFallback, m as esbuildPlugin, n as extractGlobalVarAliasesForManifest, o as fileMayContainSafelistableSz, p as findLocalImportSources, q as findRSCBoundaryViolation, r as findRSCGraphViolation, s as hasInjectableTailwindCandidate, t as hasUseClientDirective, v as hasUseServerDirective, w as isAdvisoryDiagnostic, x as isCompileSourceOptedIn, y as isHardIgnoredPath, z as isMangleableCssId, A as isMonorepoPackage, B as isPackagesSkippedSource, C as isRSCServerModule, D as isTailwindReservedGlobalVar, E as lateMangleCensusMessage, F as mangleCodeClassesSync, G as mangleEligibleClasses, H as mangleHybridHazardMessage, I as missingTailwindEntryMessage, J as normalizeGlobalVarAliasesForCache, K as planGlobalVarAliases, L as readGlobalVarScanCache, M as realContentHashDisabledMessage, N as recordGlobalVarSourceFile, O as resolveCompileSourceDirs, P as resolveGlobalVarScanCacheDir, Q as resolveNativeCacheIdentity, R as resolveQuietMode, S as rewriteGlobalVarCssAliases, T as rollupPlugin, U as scanGlobalVarCss, V as shouldEmitMissingCssFallback, W as shouldEmitWarning, X as shouldHoldAdvisories, Y as shouldTrackGlobalVarSources, Z as shouldWarnMissingTailwindEntry, _ as shouldWarnUnscopedMonorepo, $ as skippedSzFilesMessage, a0 as suppressedAdvisoryMessage, u as unplugin, a1 as unscopedMonorepoMessage, a2 as validateGlobalVarAliasInputs, a3 as vitePlugin, a4 as watchModeMangleMessage, a5 as webpackPlugin, a6 as writeGlobalVarScanCache } from './shared/unplugin.Cs4H9z9v.mjs';
+export { h as hasTokens, m as mergeThemes, p as parseThemeBlocks, a as parseUtilityBlocks, s as scanCustomPropertyNames } from './shared/unplugin.995yC_cN.mjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
-export { S as SAFELIST_FILE, a as appendTailwindSourceDirective, c as computeSafelistRelPath, b as cssImportsTailwind } from './shared/unplugin.DH_ij6cf.mjs';
+export { S as SAFELIST_FILE, a as appendTailwindSourceDirective, c as computeSafelistRelPath, b as cssImportsTailwind } from './shared/unplugin.Ba3O1r8M.mjs';
 import 'postcss';
 import 'postcss-selector-parser';
 import 'node:crypto';
@@ -17,6 +17,8 @@ import '@csszyx/core/native';
 import '@csszyx/svelte-adapter';
 import '@csszyx/vue-adapter';
 import 'unplugin';
-import './shared/unplugin.C-oQU1jl.mjs';
+import './shared/unplugin.2uf-U76p.mjs';
+import './shared/unplugin.wMeicb6E.mjs';
+import './shared/unplugin.DcXM9sq5.mjs';
 import 'node:zlib';
 import 'postcss-value-parser';

package/dist/jest-transform.cjs

@@ -0,0 +1,186 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const node_crypto = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+const compiler = require('@csszyx/compiler');
+const nextRuntimeInjection = require('./shared/unplugin.Defu9wGh.cjs');
+const pathNormalization = require('./shared/unplugin.BqKLlo1h.cjs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+const path__default = /*#__PURE__*/_interopDefaultCompat(path);
+
+const SETTLE_MS = 2e3;
+function mtimeOf(dir) {
+  try {
+    return fs__default.statSync(dir).mtimeMs;
+  } catch {
+    return -1;
+  }
+}
+function settled(mtime) {
+  return Date.now() - mtime < SETTLE_MS ? -1 : mtime;
+}
+function writtenAt(entry) {
+  return typeof entry.timestamp === "string" ? entry.timestamp : "";
+}
+class TransformCacheIndex {
+  /** Directories seen, with the modification time they were last read at. */
+  dirs = /* @__PURE__ */ new Map();
+  seen = /* @__PURE__ */ new Set();
+  byFilename = /* @__PURE__ */ new Map();
+  /**
+   * @param root - The transform cache directory.
+   */
+  constructor(root) {
+    this.dirs.set(root, -1);
+  }
+  /**
+   * Read every entry file written since the last refresh.
+   */
+  refresh() {
+    const moved = [];
+    for (const [dir, readAt] of this.dirs) {
+      const mtime = mtimeOf(dir);
+      if (mtime !== readAt) moved.push(dir);
+    }
+    for (const dir of moved) {
+      this.dirs.set(dir, settled(mtimeOf(dir)));
+      this.readDir(dir);
+    }
+  }
+  /**
+   * Parse the entry files in one directory the index has not read yet.
+   *
+   * @param dir - The directory.
+   */
+  readDir(dir) {
+    let names;
+    try {
+      names = fs__default.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of names) {
+      const full = path__default.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!this.dirs.has(full)) {
+          this.dirs.set(full, settled(mtimeOf(full)));
+          this.readDir(full);
+        }
+        continue;
+      }
+      if (!entry.name.endsWith(".json") || this.seen.has(full)) continue;
+      this.seen.add(full);
+      this.add(full);
+    }
+  }
+  /**
+   * Parse one entry file into the index.
+   *
+   * @param file - The entry file.
+   */
+  add(file) {
+    let entry;
+    try {
+      entry = JSON.parse(fs__default.readFileSync(file, "utf8"));
+    } catch {
+      return;
+    }
+    if (typeof entry.filename !== "string") return;
+    const list = this.byFilename.get(entry.filename) ?? [];
+    list.push(entry);
+    this.byFilename.set(entry.filename, list);
+  }
+  /**
+   * The build output for one file, when the build saw exactly these contents.
+   *
+   * @param filename - Path of the file under test, as the plugin records it.
+   * @param source - Its current contents.
+   * @returns The matching entry's result, or null.
+   */
+  find(filename, source) {
+    const wanted = node_crypto.createHash("sha256").update(source).digest("hex");
+    const hit = this.pick(filename, wanted);
+    if (hit !== null) return hit;
+    this.refresh();
+    return this.pick(filename, wanted);
+  }
+  /**
+   * The best entry among those recorded for one file and hash.
+   *
+   * The plugin keys its cache on more than the source — the compiler that
+   * wrote the entry, whether variables were mangled, the cross-module
+   * registry — so one file and hash can have several entries. A test wants
+   * the output this compiler produces with readable variable names, and of
+   * those the newest.
+   *
+   * @param filename - Path as the plugin records it.
+   * @param sha256 - Hash of the current contents.
+   * @returns The chosen entry's result, or null when none qualifies.
+   */
+  pick(filename, sha256) {
+    let best = null;
+    for (const entry of this.byFilename.get(filename) ?? []) {
+      if (entry.inputSha256 !== sha256) continue;
+      if (entry.compilerVersion !== compiler.VERSION || entry.mangleVars === true) continue;
+      if (typeof entry.result?.code !== "string") continue;
+      if (best === null || writtenAt(entry) > writtenAt(best)) {
+        best = entry;
+      }
+    }
+    return best?.result ?? null;
+  }
+}
+function findCachedTransform(cacheRoot, filename, source) {
+  const index = new TransformCacheIndex(cacheRoot);
+  index.refresh();
+  const code = index.find(pathNormalization.normalizePathSeparators(filename), source)?.code;
+  return typeof code === "string" ? code : null;
+}
+const DEFAULT_EXTENSIONS = [".tsx", ".jsx", ".ts", ".js", ".mts", ".mjs"];
+function reportDeadClasses(sourcePath, diagnostics) {
+  if (!Array.isArray(diagnostics)) return;
+  for (const message of diagnostics) {
+    if (typeof message !== "string" || compiler.szFallbackConsequenceOf(message) === "nudge") continue;
+    console.warn(`[csszyx] ${sourcePath}
+  ${message}`);
+  }
+}
+function finish(code, usage) {
+  return nextRuntimeInjection.injectNextRuntimeImports(code, usage).code;
+}
+function createTransformer(options = {}) {
+  const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+  const cacheRoot = options.cacheRoot ?? path__default.resolve(process.cwd(), ".csszyx/cache", "transform");
+  const index = new TransformCacheIndex(cacheRoot);
+  index.refresh();
+  const compiles = (sourcePath) => extensions.some((extension) => sourcePath.endsWith(extension));
+  const cached = (sourceText, sourcePath) => index.find(pathNormalization.normalizePathSeparators(sourcePath), sourceText);
+  return {
+    process(sourceText, sourcePath) {
+      if (!compiles(sourcePath)) return { code: sourceText };
+      const built = cached(sourceText, sourcePath);
+      if (built !== null && typeof built.code === "string") {
+        reportDeadClasses(sourcePath, built.diagnostics);
+        return { code: finish(built.code, built) };
+      }
+      const result = compiler.transformSource(sourceText, sourcePath);
+      reportDeadClasses(sourcePath, result.diagnostics);
+      return { code: result.transformed ? finish(result.code, result) : sourceText };
+    },
+    getCacheKey(sourceText, sourcePath, cacheKeyOptions) {
+      const built = compiles(sourcePath) ? cached(sourceText, sourcePath) : null;
+      return node_crypto.createHash("sha256").update(sourceText).update("\0").update(sourcePath).update("\0").update(typeof built?.code === "string" ? built.code : "").update("\0").update(cacheKeyOptions?.configString ?? "").update("\0").update(compiler.VERSION).digest("hex");
+    }
+  };
+}
+const transformerModule = { createTransformer };
+
+exports.createTransformer = createTransformer;
+exports.default = transformerModule;
+exports.findCachedTransform = findCachedTransform;

package/dist/jest-transform.d.cts

@@ -0,0 +1,112 @@
+/**
+ * A jest transformer that gives a test suite the classes the browser gets.
+ *
+ * Under jest the bundler plugin never runs, so a rendered component carries
+ * `sz` as a live prop and no `className`. Every styling assertion then reads
+ * the object the author typed rather than the compiled output, and the defect
+ * class "this `sz` compiled to nothing" is invisible to the suite, to `tsc`
+ * and to CI. Vitest needs none of this — the plugin in `vite.config` already
+ * transforms the modules a test imports — so this exists for the runners that
+ * cannot host a bundler plugin.
+ *
+ * Two sources answer, in order.
+ *
+ * The build's own transform cache is read first. It holds the output the
+ * bundler produced, which is the only output that resolves an `sz` object or
+ * an `szv` factory imported from another module: those come from the plugin's
+ * project-wide prescan, and a compiler handed one file cannot see them. An
+ * entry is matched on the file's path and the hash of its current contents, so
+ * an edit since the last build is a miss rather than a wrong answer; among the
+ * entries that match, only one this compiler wrote without variable mangling
+ * is taken, newest first.
+ *
+ * The per-file compiler answers otherwise. That is the right answer for an
+ * inline `sz` and for one built from a `const` in the same file; a shape it
+ * cannot resolve keeps the runtime path, exactly as the plugin would.
+ *
+ * Both answers are finished the way the plugin finishes them: the runtime
+ * helpers the compiled code calls are imported, and the diagnostics that say a
+ * class is dead are printed. jest applies one transformer per file, so this
+ * one hands back TSX; a project's own transformer chains it in front of the
+ * one that compiles TSX (see the testing guide).
+ *
+ * @module jest-transform
+ */
+/**
+ * The build output for one file, when the build saw exactly these contents.
+ *
+ * One-shot form of the index, for a caller outside a transformer.
+ *
+ * @param cacheRoot - The transform cache directory, `.csszyx/cache/transform`.
+ * @param filename - Path of the file under test.
+ * @param source - Its current contents.
+ * @returns The compiled code, or null when the build has no matching entry.
+ */
+declare function findCachedTransform(cacheRoot: string, filename: string, source: string): string | null;
+/** How the transformer finds the build output and what it compiles. */
+interface JestTransformOptions {
+    /**
+     * The transform cache directory. Defaults to `.csszyx/cache/transform`
+     * under the current working directory, which is where the plugin writes
+     * it and where jest runs from.
+     */
+    cacheRoot?: string;
+    /** Extensions this lane compiles; anything else is returned unchanged. */
+    extensions?: readonly string[];
+}
+/** The options jest hands `getCacheKey`; only the field this lane folds in. */
+interface JestCacheKeyOptions {
+    /** jest's serialised config, which its default key includes. */
+    configString?: string;
+}
+/** The slice of jest's transformer interface this implements. */
+interface JestTransformer {
+    /**
+     * Compile one file.
+     *
+     * @param sourceText - File contents.
+     * @param sourcePath - Absolute path of the file.
+     * @returns The code jest executes.
+     */
+    process(sourceText: string, sourcePath: string): {
+        code: string;
+    };
+    /**
+     * The key jest caches the output under.
+     *
+     * jest's own key covers the file and its config, and this lane's answer
+     * also depends on what the last build wrote for the file: a rebuild after
+     * a change in another module changes this file's output without changing
+     * this file. The build's answer is part of the key so that jest asks again.
+     *
+     * @param sourceText - File contents.
+     * @param sourcePath - Absolute path of the file.
+     * @param options - jest's cache-key options.
+     * @returns A hex digest.
+     */
+    getCacheKey(sourceText: string, sourcePath: string, options?: JestCacheKeyOptions): string;
+}
+/**
+ * Build the transformer jest calls for every file it loads.
+ *
+ * @param options - Cache location and which extensions to compile.
+ * @returns A transformer with jest's synchronous hooks.
+ */
+declare function createTransformer(options?: JestTransformOptions): JestTransformer;
+/** The module shape jest resolves a transformer by. */
+interface JestTransformerFactory {
+    /**
+     * Build the transformer.
+     *
+     * @param options - Cache location and which extensions to compile.
+     * @returns The transformer.
+     */
+    createTransformer: (options?: JestTransformOptions) => JestTransformer;
+}
+/** jest resolves a transformer module by its default export. */
+declare const transformerModule: JestTransformerFactory;
+
+// @ts-ignore
+export = transformerModule;
+export { createTransformer, findCachedTransform };
+export type { JestCacheKeyOptions, JestTransformOptions, JestTransformer };

package/dist/jest-transform.d.mts

@@ -0,0 +1,110 @@
+/**
+ * A jest transformer that gives a test suite the classes the browser gets.
+ *
+ * Under jest the bundler plugin never runs, so a rendered component carries
+ * `sz` as a live prop and no `className`. Every styling assertion then reads
+ * the object the author typed rather than the compiled output, and the defect
+ * class "this `sz` compiled to nothing" is invisible to the suite, to `tsc`
+ * and to CI. Vitest needs none of this — the plugin in `vite.config` already
+ * transforms the modules a test imports — so this exists for the runners that
+ * cannot host a bundler plugin.
+ *
+ * Two sources answer, in order.
+ *
+ * The build's own transform cache is read first. It holds the output the
+ * bundler produced, which is the only output that resolves an `sz` object or
+ * an `szv` factory imported from another module: those come from the plugin's
+ * project-wide prescan, and a compiler handed one file cannot see them. An
+ * entry is matched on the file's path and the hash of its current contents, so
+ * an edit since the last build is a miss rather than a wrong answer; among the
+ * entries that match, only one this compiler wrote without variable mangling
+ * is taken, newest first.
+ *
+ * The per-file compiler answers otherwise. That is the right answer for an
+ * inline `sz` and for one built from a `const` in the same file; a shape it
+ * cannot resolve keeps the runtime path, exactly as the plugin would.
+ *
+ * Both answers are finished the way the plugin finishes them: the runtime
+ * helpers the compiled code calls are imported, and the diagnostics that say a
+ * class is dead are printed. jest applies one transformer per file, so this
+ * one hands back TSX; a project's own transformer chains it in front of the
+ * one that compiles TSX (see the testing guide).
+ *
+ * @module jest-transform
+ */
+/**
+ * The build output for one file, when the build saw exactly these contents.
+ *
+ * One-shot form of the index, for a caller outside a transformer.
+ *
+ * @param cacheRoot - The transform cache directory, `.csszyx/cache/transform`.
+ * @param filename - Path of the file under test.
+ * @param source - Its current contents.
+ * @returns The compiled code, or null when the build has no matching entry.
+ */
+declare function findCachedTransform(cacheRoot: string, filename: string, source: string): string | null;
+/** How the transformer finds the build output and what it compiles. */
+interface JestTransformOptions {
+    /**
+     * The transform cache directory. Defaults to `.csszyx/cache/transform`
+     * under the current working directory, which is where the plugin writes
+     * it and where jest runs from.
+     */
+    cacheRoot?: string;
+    /** Extensions this lane compiles; anything else is returned unchanged. */
+    extensions?: readonly string[];
+}
+/** The options jest hands `getCacheKey`; only the field this lane folds in. */
+interface JestCacheKeyOptions {
+    /** jest's serialised config, which its default key includes. */
+    configString?: string;
+}
+/** The slice of jest's transformer interface this implements. */
+interface JestTransformer {
+    /**
+     * Compile one file.
+     *
+     * @param sourceText - File contents.
+     * @param sourcePath - Absolute path of the file.
+     * @returns The code jest executes.
+     */
+    process(sourceText: string, sourcePath: string): {
+        code: string;
+    };
+    /**
+     * The key jest caches the output under.
+     *
+     * jest's own key covers the file and its config, and this lane's answer
+     * also depends on what the last build wrote for the file: a rebuild after
+     * a change in another module changes this file's output without changing
+     * this file. The build's answer is part of the key so that jest asks again.
+     *
+     * @param sourceText - File contents.
+     * @param sourcePath - Absolute path of the file.
+     * @param options - jest's cache-key options.
+     * @returns A hex digest.
+     */
+    getCacheKey(sourceText: string, sourcePath: string, options?: JestCacheKeyOptions): string;
+}
+/**
+ * Build the transformer jest calls for every file it loads.
+ *
+ * @param options - Cache location and which extensions to compile.
+ * @returns A transformer with jest's synchronous hooks.
+ */
+declare function createTransformer(options?: JestTransformOptions): JestTransformer;
+/** The module shape jest resolves a transformer by. */
+interface JestTransformerFactory {
+    /**
+     * Build the transformer.
+     *
+     * @param options - Cache location and which extensions to compile.
+     * @returns The transformer.
+     */
+    createTransformer: (options?: JestTransformOptions) => JestTransformer;
+}
+/** jest resolves a transformer module by its default export. */
+declare const transformerModule: JestTransformerFactory;
+
+export { createTransformer, transformerModule as default, findCachedTransform };
+export type { JestCacheKeyOptions, JestTransformOptions, JestTransformer };