@csszyx/unplugin 0.14.5 → 0.15.1

package/dist/shared/{unplugin.CPEWNSA0.d.cts → unplugin.BGog1Bib.d.cts}

@@ -9,8 +9,17 @@ interface NextCacheIdentity {
     generation: string;
 }
 
+/** Options for atomic file writes that need to survive Windows file scanners. */
+interface AtomicWriteOptions {
+    maxRetries?: number;
+    retryDelayMs?: number;
+    renameSync?: (from: string, to: string) => void;
+}
+
 /** Files used by the Next Turbopack safelist state machine. */
 interface NextSafelistStatePaths {
+    /** Project root the safelist and cache live under. */
+    rootDir: string;
     cacheDir: string;
     shardsDir: string;
     snapshotPath: string;
@@ -23,12 +32,6 @@ interface NextSafelistMaterializeResult {
     tombstonedSourceCount: number;
     shardCount: number;
 }
-/** Options for atomic file writes that need to survive Windows file scanners. */
-interface AtomicWriteOptions {
-    maxRetries?: number;
-    retryDelayMs?: number;
-    renameSync?: (from: string, to: string) => void;
-}
 /** Options used when acquiring a state lock. */
 interface NextSafelistStateLockOptions {
     pid?: number;

package/dist/shared/{unplugin.CPEWNSA0.d.mts → unplugin.BGog1Bib.d.mts}

@@ -9,8 +9,17 @@ interface NextCacheIdentity {
     generation: string;
 }
 
+/** Options for atomic file writes that need to survive Windows file scanners. */
+interface AtomicWriteOptions {
+    maxRetries?: number;
+    retryDelayMs?: number;
+    renameSync?: (from: string, to: string) => void;
+}
+
 /** Files used by the Next Turbopack safelist state machine. */
 interface NextSafelistStatePaths {
+    /** Project root the safelist and cache live under. */
+    rootDir: string;
     cacheDir: string;
     shardsDir: string;
     snapshotPath: string;
@@ -23,12 +32,6 @@ interface NextSafelistMaterializeResult {
     tombstonedSourceCount: number;
     shardCount: number;
 }
-/** Options for atomic file writes that need to survive Windows file scanners. */
-interface AtomicWriteOptions {
-    maxRetries?: number;
-    retryDelayMs?: number;
-    renameSync?: (from: string, to: string) => void;
-}
 /** Options used when acquiring a state lock. */
 interface NextSafelistStateLockOptions {
     pid?: number;

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

@@ -1,17 +1,16 @@
 import * as path from 'node:path';
 import * as fs from 'node:fs';
+import { S as SAFELIST_FILE, d as atomicWriteFileSync, s as sortStrings, r as renderSafelistFile, e as removeLegacySafelists, g as assertNoLegacySourceStylesheet } from './unplugin.DH_ij6cf.mjs';
 import { createHash, randomUUID } from 'node:crypto';
 import { hostname } from 'node:os';
 import lockfile from 'proper-lockfile';
-import { s as sortStrings, e as escapeHtmlAttribute, r as renderTailwindScannerCandidates } from './unplugin.B3XoSRB8.mjs';
 
-const DEFAULT_RENAME_RETRIES = 5;
-const DEFAULT_RENAME_RETRY_DELAY_MS = 10;
 const DEFAULT_STALE_LOCK_MS = 3e4;
 const STALE_RECOVERY_DISABLED_MS = 2147483647;
-function resolveNextSafelistStatePaths(rootDir, cacheDir = ".csszyx/cache", outputFile = "csszyx-classes.html") {
+function resolveNextSafelistStatePaths(rootDir, cacheDir = ".csszyx/cache", outputFile = SAFELIST_FILE) {
   const resolvedCacheDir = path.resolve(rootDir, cacheDir);
   return {
+    rootDir: path.resolve(rootDir),
     cacheDir: resolvedCacheDir,
     shardsDir: path.join(resolvedCacheDir, "safelist-shards"),
     snapshotPath: path.join(resolvedCacheDir, "safelist.snapshot.json"),
@@ -48,7 +47,8 @@ function materializeNextSafelist(paths, options = {}) {
     version: 1,
     sources: sortedSources.map(([sourcePath, classSet]) => [sourcePath, classSet])
   };
-  atomicWriteFileSync(paths.outputPath, renderTailwindSourceHtml(classNames), options);
+  atomicWriteFileSync(paths.outputPath, renderSafelistFile(classNames), options);
+  removeLegacySafelists(paths.rootDir, console.warn);
   atomicWriteFileSync(paths.snapshotPath, `${JSON.stringify(snapshot, null, 2)}
 `, options);
   return {
@@ -80,14 +80,14 @@ function acquireNextSafelistStateLock(lockPath, pidOrOptions = {}) {
   } catch (error) {
     const existing2 = readLockMetadata(lockPath);
     if (existing2) {
-      throw new Error(formatLiveLockError(existing2));
+      throw new NextSafelistStateLockedError(existing2);
     }
     throw error;
   }
   const existing = readLockMetadata(lockPath);
   if (existing && isLockLive(existing, options)) {
     releaseAdvisory();
-    throw new Error(formatLiveLockError(existing));
+    throw new NextSafelistStateLockedError(existing);
   }
   try {
     atomicWriteFileSync(lockPath, `${JSON.stringify(metadata, null, 2)}
@@ -128,40 +128,6 @@ function acquireNextSafelistStateLock(lockPath, pidOrOptions = {}) {
     }
   };
 }
-function atomicWriteFileSync(file, content, options = {}) {
-  const dir = path.dirname(file);
-  const tmp = path.join(
-    dir,
-    `.tmp-${path.basename(file)}-${process.pid}-${Date.now()}-${randomUUID()}`
-  );
-  fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(tmp, content, "utf8");
-  try {
-    atomicRenameWithRetry(tmp, file, options);
-  } catch (error) {
-    try {
-      fs.rmSync(tmp, { force: true });
-    } catch {
-    }
-    throw error;
-  }
-}
-function atomicRenameWithRetry(from, to, options = {}) {
-  const maxRetries = options.maxRetries ?? DEFAULT_RENAME_RETRIES;
-  const retryDelayMs = options.retryDelayMs ?? DEFAULT_RENAME_RETRY_DELAY_MS;
-  const renameSync = options.renameSync ?? fs.renameSync;
-  for (let attempt = 0; ; attempt++) {
-    try {
-      renameSync(from, to);
-      return;
-    } catch (error) {
-      if (!isRetryableRenameError(error) || attempt >= maxRetries) {
-        throw error;
-      }
-      sleepSync(retryDelayMs);
-    }
-  }
-}
 function isExistingShardEquivalent(filePath, shard) {
   try {
     const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
@@ -232,15 +198,6 @@ function normalizeShardRecord(filePath, data) {
     })
   };
 }
-function renderTailwindSourceHtml(classNames) {
-  if (classNames.length === 0) {
-    return "<!-- csszyx Next safelist: empty -->\n";
-  }
-  const structuralHtml = classNames.map((className) => `<div class="${escapeHtmlAttribute(className)}"></div>`).join("\n");
-  const scannerCandidates = renderTailwindScannerCandidates(classNames);
-  return `${structuralHtml}
-${scannerCandidates}`;
-}
 function createLockMetadata(options) {
   const now = new Date(options.now ?? Date.now()).toISOString();
   const pid = options.pid ?? process.pid;
@@ -337,6 +294,18 @@ function isProcessAlive(pid) {
     return false;
   }
 }
+class NextSafelistStateLockedError extends Error {
+  holder;
+  /**
+   * @param holder - metadata read from the lock file.
+   */
+  constructor(holder) {
+    super(formatLiveLockError(holder));
+    this.name = "NextSafelistStateLockedError";
+    this.holder = holder;
+  }
+}
+const NEXT_WATCH_LOCK_COMMAND = "csszyx next watch";
 function formatLiveLockError(metadata) {
   return [
     `csszyx Next safelist state is already locked by process ${metadata.pid}.`,
@@ -346,15 +315,6 @@ function formatLiveLockError(metadata) {
     `updatedAt=${metadata.updatedAt}`
   ].join(" ");
 }
-function isRetryableRenameError(error) {
-  return typeof error === "object" && error !== null && "code" in error && (error.code === "EBUSY" || error.code === "EPERM" || error.code === "EACCES");
-}
-function sleepSync(ms) {
-  if (ms <= 0) {
-    return;
-  }
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
 
 function createNextCacheIdentity(input) {
   const configHash = hashString(stableStringify(input.config));
@@ -515,6 +475,7 @@ function isNestedPackageRoot(parentRoot, candidateRoot) {
 
 function createNextStateContext(input) {
   const rootResolution = resolveNextAppRoot(input);
+  assertNoLegacySourceStylesheet(rootResolution.root);
   const cacheDir = resolveNextAppCacheDir(rootResolution.root, input.cacheDir);
   const identity = createNextCacheIdentity({
     root: rootResolution.root,
@@ -578,7 +539,7 @@ function runNextWatcherCycle(context, options = {}) {
   const lock = acquireNextSafelistStateLock(lockPath, {
     root: context.root,
     mode: context.manifestExpectation.mode,
-    command: "csszyx next watch",
+    command: NEXT_WATCH_LOCK_COMMAND,
     ...options.lockOptions
   });
   try {
@@ -612,4 +573,4 @@ function runNextWatcherCycle(context, options = {}) {
   }
 }
 
-export { readNextGenerationManifest as a, createNextStateContext as c, runNextWatcherCycle as r, validateNextGenerationManifest as v, writeNextSafelistShard as w };
+export { NextSafelistStateLockedError as N, NEXT_WATCH_LOCK_COMMAND as a, readNextGenerationManifest as b, createNextStateContext as c, runNextWatcherCycle as r, validateNextGenerationManifest as v, writeNextSafelistShard as w };

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

@@ -421,6 +421,45 @@ declare function hasTokens(theme: ParsedTheme): boolean;
  */
 declare function scanCustomPropertyNames(block: string): string[];
 
+/**
+ * A per-key store whose merged view is built when read, not when written.
+ *
+ * The plugin keeps two aggregates over "what each file contributed": the CSS
+ * variable mangle map and the variable hoisting metrics. Both were rebuilt in
+ * full — a sort over every file, then a merge — on EVERY write, and a write
+ * happens once per module in the prescan and again in the transform hook. That
+ * made recording a module cost as much as every module before it: 18 000
+ * files with `mangleVars` on spent 77 s here, a 12× build-time regression that
+ * the flag's own benchmarks never showed because their fixtures emitted no
+ * variables.
+ *
+ * Readers (`buildEnd`, the virtual map module, the manifest) run after the
+ * writes, so building on read costs one merge per build instead of one per
+ * file, and a write followed by a read still sees the write.
+ *
+ * @module
+ */
+/** A per-key store with a lazily rebuilt merged view. */
+interface LazyAggregate<Entry, Aggregate> {
+    /** Contributions by key, in insertion order. */
+    readonly entries: ReadonlyMap<string, Entry>;
+    /**
+     * Record one key's contribution, replacing what it held before.
+     *
+     * @param key Contribution owner (a normalized filename).
+     * @param entry What the owner contributes.
+     */
+    set(key: string, entry: Entry): void;
+    /**
+     * Drop one key's contribution.
+     *
+     * @param key Contribution owner.
+     */
+    delete(key: string): void;
+    /** @returns The merged view, rebuilt only if a write happened since the last read. */
+    get(): Aggregate;
+}
+
 /**
  * Plugin state for mangle map management.
  */
@@ -454,6 +493,13 @@ interface PluginState {
      * emit their CSS (no entry → the classes resolve to no styles, silently).
      */
     sawTailwindEntry: boolean;
+    /**
+     * Absolute paths of every CSS file seen importing `tailwindcss`, without
+     * their query. These are the modules whose generated CSS changes when the
+     * safelist does, which is what lets a dev server hot-update instead of
+     * reloading — see the `hotUpdate` safelist branch.
+     */
+    tailwindEntryFiles: Set<string>;
     /**
      * True once ANY CSS file passed through the transform hook. The missing-entry
      * warning only fires when csszyx actually observed the CSS pipeline but found
@@ -516,10 +562,12 @@ interface PluginState {
      */
     classesCapped: boolean;
     mangleMap: Record<string, string>;
-    varMangleEntriesByFile: Map<string, Array<[string, string]>>;
-    varMangleMap: Record<string, CssVariableMangleValue>;
-    cssVarMetricsByFile: Map<string, CSSVariableMetrics>;
-    cssVarMetrics: CSSVariableMetrics;
+    /** CSS variable mangle entries per file; `varMangleMap` is merged from them on read. */
+    varMangleEntriesByFile: LazyAggregate<Array<[string, string]>, Record<string, CssVariableMangleValue>>;
+    readonly varMangleMap: Record<string, CssVariableMangleValue>;
+    /** CSS variable hoisting metrics per file; `cssVarMetrics` is totalled from them on read. */
+    cssVarMetricsByFile: LazyAggregate<CSSVariableMetrics, CSSVariableMetrics>;
+    readonly cssVarMetrics: CSSVariableMetrics;
     checksum: string;
     finalized: boolean;
     rootDir: string;
@@ -558,41 +606,6 @@ interface CSSVariableMetrics {
  * @returns A stable identity string, or a sentinel when unresolvable.
  */
 declare function resolveNativeCacheIdentity(): string;
-/**
- * Appends an `@source "<relPath>";` directive to a CSS module so Tailwind v4
- * scans the csszyx-generated safelist file.
- *
- * `@source` is position-independent in Tailwind v4 — it can appear anywhere in
- * the compiled CSS — so the directive is **appended as its own statement**
- * rather than spliced next to the `@import "tailwindcss…"` line. Matching the
- * import syntax is the source of a real defect: the split / manual Tailwind v4
- * setup (`@import "tailwindcss/utilities.css" layer(…)` or `… source(…)`, or an
- * import without a trailing `;`) does not match an import-anchored regex, so the
- * injection silently no-ops and every csszyx-only class (e.g. the static
- * `bg-primary/50` produced by `sz={{ bg: { color, op } }}`) gets no CSS while a
- * raw `className` still works. Appending is correct for every import form.
- *
- * @param code - CSS module source already known to import tailwindcss.
- * @param relPath - safelist path relative to this CSS file (posix, `./`-prefixed).
- * @returns the code with the directive appended, or `null` if it is already
- *   present (idempotent — re-running the transform must not stack directives).
- */
-declare function appendTailwindSourceDirective(code: string, relPath: string): string | null;
-/**
- * Whether a CSS module actually imports the `tailwindcss` package, so the
- * `@source` directive should be appended.
- *
- * Tighter than a substring check on purpose: block comments are stripped first
- * (a commented-out `@import` must not trigger injection), and the package name
- * must end at a quote or a `/` subpath so a different package whose name merely
- * starts with `tailwindcss` (e.g. `tailwindcss-animate`) does not match. Import
- * options after the closing quote (`layer(…)`, `source(…)`) are irrelevant — the
- * match ends at the quote — so every real Tailwind v4 import form is covered.
- *
- * @param code - CSS module source.
- * @returns true if the module imports tailwindcss (exact or a subpath).
- */
-declare function cssImportsTailwind(code: string): boolean;
 /**
  * Whether the discovered class set contains at least one real Tailwind
  * candidate worth injecting an `@source` for — at least two characters and
@@ -929,21 +942,6 @@ declare function watchModeMangleMessage(): string;
  * @returns the warning text.
  */
 declare function realContentHashDisabledMessage(): string;
-/**
- * Computes the `@source` target path for a CSS module: the location of the
- * generated safelist file relative to the CSS file, in posix form and always
- * `./`- or `../`-prefixed so Tailwind treats it as a relative path.
- *
- * This is the real-world failure surface — a wrong relative path makes Tailwind
- * silently scan nothing (no error, no CSS), the same symptom as a missing
- * directive — so it is extracted and unit-tested rather than left inline.
- *
- * @param rootDir - project root where the safelist file is written.
- * @param safelistFilename - the safelist file name (e.g. `csszyx-classes.html`).
- * @param cssId - absolute path of the CSS module receiving the directive.
- * @returns the posix relative path from the CSS file to the safelist file.
- */
-declare function computeSafelistRelPath(rootDir: string, safelistFilename: string, cssId: string): string;
 /**
  * Whether transformed source text must be retained for global-var alias
  * validation. Retention is only consumed when `production.mangleGlobalVars`
@@ -1044,5 +1042,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { isMonorepoPackage as $, cssHasContentScope as A, cssImportsTailwind as B, unplugin as D, deleteRSCModuleRecord as E, emitMissingCssFallback as F, esbuildPlugin as H, extractGlobalVarAliasesForManifest as I, fileMayContainSafelistableSz as J, findLocalImportSources as K, findRSCBoundaryViolation as L, findRSCGraphViolation as N, hasInjectableTailwindCandidate as O, hasTokens as T, hasUseClientDirective as U, hasUseServerDirective as W, isAdvisoryDiagnostic as X, isCompileSourceOptedIn as Y, isHardIgnoredPath as Z, isMangleableCssId as _, isPackagesSkippedSource as a0, isRSCServerModule as a1, lateMangleCensusMessage as a2, mangleCodeClassesSync as a3, mangleEligibleClasses as a4, mangleHybridHazardMessage as a5, mergeThemes as a6, missingTailwindEntryMessage as a7, normalizeGlobalVarAliasesForCache as a8, parseThemeBlocks as a9, parseUtilityBlocks as aa, realContentHashDisabledMessage as ab, recordGlobalVarSourceFile as ac, resolveCompileSourceDirs as ad, resolveNativeCacheIdentity as ae, resolveQuietMode as af, rollupPlugin as ag, scanCustomPropertyNames as ah, shouldEmitMissingCssFallback as ai, shouldEmitWarning as aj, shouldTrackGlobalVarSources as ak, shouldWarnMissingTailwindEntry as al, shouldWarnUnscopedMonorepo as am, skippedSzFilesMessage as an, suppressedAdvisoryMessage as ao, unscopedMonorepoMessage as ap, vitePlugin as aq, watchModeMangleMessage as ar, webpackPlugin as as, allocateMangleTokens as s, appendTailwindSourceDirective as t, assertNoRSCBoundaryViolation as u, assertNoRSCGraphViolation as v, collectMangleHybridHazards as w, computeSafelistRelPath as x, createGlobalVarMapAssetSource as y, createRSCModuleRecord as z };
+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 };

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

@@ -421,6 +421,45 @@ declare function hasTokens(theme: ParsedTheme): boolean;
  */
 declare function scanCustomPropertyNames(block: string): string[];
 
+/**
+ * A per-key store whose merged view is built when read, not when written.
+ *
+ * The plugin keeps two aggregates over "what each file contributed": the CSS
+ * variable mangle map and the variable hoisting metrics. Both were rebuilt in
+ * full — a sort over every file, then a merge — on EVERY write, and a write
+ * happens once per module in the prescan and again in the transform hook. That
+ * made recording a module cost as much as every module before it: 18 000
+ * files with `mangleVars` on spent 77 s here, a 12× build-time regression that
+ * the flag's own benchmarks never showed because their fixtures emitted no
+ * variables.
+ *
+ * Readers (`buildEnd`, the virtual map module, the manifest) run after the
+ * writes, so building on read costs one merge per build instead of one per
+ * file, and a write followed by a read still sees the write.
+ *
+ * @module
+ */
+/** A per-key store with a lazily rebuilt merged view. */
+interface LazyAggregate<Entry, Aggregate> {
+    /** Contributions by key, in insertion order. */
+    readonly entries: ReadonlyMap<string, Entry>;
+    /**
+     * Record one key's contribution, replacing what it held before.
+     *
+     * @param key Contribution owner (a normalized filename).
+     * @param entry What the owner contributes.
+     */
+    set(key: string, entry: Entry): void;
+    /**
+     * Drop one key's contribution.
+     *
+     * @param key Contribution owner.
+     */
+    delete(key: string): void;
+    /** @returns The merged view, rebuilt only if a write happened since the last read. */
+    get(): Aggregate;
+}
+
 /**
  * Plugin state for mangle map management.
  */
@@ -454,6 +493,13 @@ interface PluginState {
      * emit their CSS (no entry → the classes resolve to no styles, silently).
      */
     sawTailwindEntry: boolean;
+    /**
+     * Absolute paths of every CSS file seen importing `tailwindcss`, without
+     * their query. These are the modules whose generated CSS changes when the
+     * safelist does, which is what lets a dev server hot-update instead of
+     * reloading — see the `hotUpdate` safelist branch.
+     */
+    tailwindEntryFiles: Set<string>;
     /**
      * True once ANY CSS file passed through the transform hook. The missing-entry
      * warning only fires when csszyx actually observed the CSS pipeline but found
@@ -516,10 +562,12 @@ interface PluginState {
      */
     classesCapped: boolean;
     mangleMap: Record<string, string>;
-    varMangleEntriesByFile: Map<string, Array<[string, string]>>;
-    varMangleMap: Record<string, CssVariableMangleValue>;
-    cssVarMetricsByFile: Map<string, CSSVariableMetrics>;
-    cssVarMetrics: CSSVariableMetrics;
+    /** CSS variable mangle entries per file; `varMangleMap` is merged from them on read. */
+    varMangleEntriesByFile: LazyAggregate<Array<[string, string]>, Record<string, CssVariableMangleValue>>;
+    readonly varMangleMap: Record<string, CssVariableMangleValue>;
+    /** CSS variable hoisting metrics per file; `cssVarMetrics` is totalled from them on read. */
+    cssVarMetricsByFile: LazyAggregate<CSSVariableMetrics, CSSVariableMetrics>;
+    readonly cssVarMetrics: CSSVariableMetrics;
     checksum: string;
     finalized: boolean;
     rootDir: string;
@@ -558,41 +606,6 @@ interface CSSVariableMetrics {
  * @returns A stable identity string, or a sentinel when unresolvable.
  */
 declare function resolveNativeCacheIdentity(): string;
-/**
- * Appends an `@source "<relPath>";` directive to a CSS module so Tailwind v4
- * scans the csszyx-generated safelist file.
- *
- * `@source` is position-independent in Tailwind v4 — it can appear anywhere in
- * the compiled CSS — so the directive is **appended as its own statement**
- * rather than spliced next to the `@import "tailwindcss…"` line. Matching the
- * import syntax is the source of a real defect: the split / manual Tailwind v4
- * setup (`@import "tailwindcss/utilities.css" layer(…)` or `… source(…)`, or an
- * import without a trailing `;`) does not match an import-anchored regex, so the
- * injection silently no-ops and every csszyx-only class (e.g. the static
- * `bg-primary/50` produced by `sz={{ bg: { color, op } }}`) gets no CSS while a
- * raw `className` still works. Appending is correct for every import form.
- *
- * @param code - CSS module source already known to import tailwindcss.
- * @param relPath - safelist path relative to this CSS file (posix, `./`-prefixed).
- * @returns the code with the directive appended, or `null` if it is already
- *   present (idempotent — re-running the transform must not stack directives).
- */
-declare function appendTailwindSourceDirective(code: string, relPath: string): string | null;
-/**
- * Whether a CSS module actually imports the `tailwindcss` package, so the
- * `@source` directive should be appended.
- *
- * Tighter than a substring check on purpose: block comments are stripped first
- * (a commented-out `@import` must not trigger injection), and the package name
- * must end at a quote or a `/` subpath so a different package whose name merely
- * starts with `tailwindcss` (e.g. `tailwindcss-animate`) does not match. Import
- * options after the closing quote (`layer(…)`, `source(…)`) are irrelevant — the
- * match ends at the quote — so every real Tailwind v4 import form is covered.
- *
- * @param code - CSS module source.
- * @returns true if the module imports tailwindcss (exact or a subpath).
- */
-declare function cssImportsTailwind(code: string): boolean;
 /**
  * Whether the discovered class set contains at least one real Tailwind
  * candidate worth injecting an `@source` for — at least two characters and
@@ -929,21 +942,6 @@ declare function watchModeMangleMessage(): string;
  * @returns the warning text.
  */
 declare function realContentHashDisabledMessage(): string;
-/**
- * Computes the `@source` target path for a CSS module: the location of the
- * generated safelist file relative to the CSS file, in posix form and always
- * `./`- or `../`-prefixed so Tailwind treats it as a relative path.
- *
- * This is the real-world failure surface — a wrong relative path makes Tailwind
- * silently scan nothing (no error, no CSS), the same symptom as a missing
- * directive — so it is extracted and unit-tested rather than left inline.
- *
- * @param rootDir - project root where the safelist file is written.
- * @param safelistFilename - the safelist file name (e.g. `csszyx-classes.html`).
- * @param cssId - absolute path of the CSS module receiving the directive.
- * @returns the posix relative path from the CSS file to the safelist file.
- */
-declare function computeSafelistRelPath(rootDir: string, safelistFilename: string, cssId: string): string;
 /**
  * Whether transformed source text must be retained for global-var alias
  * validation. Retention is only consumed when `production.mangleGlobalVars`
@@ -1044,5 +1042,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { isMonorepoPackage as $, cssHasContentScope as A, cssImportsTailwind as B, unplugin as D, deleteRSCModuleRecord as E, emitMissingCssFallback as F, esbuildPlugin as H, extractGlobalVarAliasesForManifest as I, fileMayContainSafelistableSz as J, findLocalImportSources as K, findRSCBoundaryViolation as L, findRSCGraphViolation as N, hasInjectableTailwindCandidate as O, hasTokens as T, hasUseClientDirective as U, hasUseServerDirective as W, isAdvisoryDiagnostic as X, isCompileSourceOptedIn as Y, isHardIgnoredPath as Z, isMangleableCssId as _, isPackagesSkippedSource as a0, isRSCServerModule as a1, lateMangleCensusMessage as a2, mangleCodeClassesSync as a3, mangleEligibleClasses as a4, mangleHybridHazardMessage as a5, mergeThemes as a6, missingTailwindEntryMessage as a7, normalizeGlobalVarAliasesForCache as a8, parseThemeBlocks as a9, parseUtilityBlocks as aa, realContentHashDisabledMessage as ab, recordGlobalVarSourceFile as ac, resolveCompileSourceDirs as ad, resolveNativeCacheIdentity as ae, resolveQuietMode as af, rollupPlugin as ag, scanCustomPropertyNames as ah, shouldEmitMissingCssFallback as ai, shouldEmitWarning as aj, shouldTrackGlobalVarSources as ak, shouldWarnMissingTailwindEntry as al, shouldWarnUnscopedMonorepo as am, skippedSzFilesMessage as an, suppressedAdvisoryMessage as ao, unscopedMonorepoMessage as ap, vitePlugin as aq, watchModeMangleMessage as ar, webpackPlugin as as, allocateMangleTokens as s, appendTailwindSourceDirective as t, assertNoRSCBoundaryViolation as u, assertNoRSCGraphViolation as v, collectMangleHybridHazards as w, computeSafelistRelPath as x, createGlobalVarMapAssetSource as y, createRSCModuleRecord as z };
+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 };