@csszyx/unplugin 0.11.11 → 0.13.0

package/dist/shared/{unplugin.BZq6FKn2.cjs → unplugin.CUTa6bY9.cjs}

@@ -1,11 +1,89 @@
 'use strict';
 
 const fs = require('node:fs');
+const path = require('node:path');
 const compiler = require('@csszyx/compiler');
-const transformCache = require('./unplugin.CKIOVNOg.cjs');
+const types = require('@csszyx/types');
+const transformCache = require('./unplugin.4du3qMst.cjs');
 const node_crypto = require('node:crypto');
 const htmlEscape = require('./unplugin.BkRah5Ot.cjs');
 
+function _interopNamespaceCompat(e) {
+    if (e && typeof e === 'object' && 'default' in e) return e;
+    const n = Object.create(null);
+    if (e) {
+        for (const k in e) {
+            n[k] = e[k];
+        }
+    }
+    n.default = e;
+    return n;
+}
+
+const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
+
+function resolveImportedStaticSz(value) {
+  return value ?? types.DEFAULT_IMPORTED_STATIC_SZ;
+}
+const aliasesByRoot = /* @__PURE__ */ new Map();
+function resolveNextCrossModule(input) {
+  const empty = { statics: {}, providers: [] };
+  if (!input.source.includes("from")) return empty;
+  let aliases = aliasesByRoot.get(input.root);
+  if (aliases === void 0) {
+    aliases = transformCache.collectSpecifierAliases(input.root);
+    aliasesByRoot.set(input.root, aliases);
+  }
+  const directory = path__namespace.dirname(input.filename);
+  const statics = {};
+  const providers = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const specifier of transformCache.importedSpecifiersIn(input.source)) {
+    if (seen.has(specifier)) continue;
+    seen.add(specifier);
+    for (const base of transformCache.specifierBases(specifier, directory, aliases)) {
+      const provider = transformCache.resolveProviderPathWith(base, transformCache.isReadableProviderFile);
+      if (provider === void 0) continue;
+      providers.push(provider);
+      recordEntries(statics, specifier, readProviderEntries(provider), input);
+      break;
+    }
+  }
+  return { statics, providers };
+}
+function readProviderEntries(provider) {
+  try {
+    return compiler.extractCrossModuleRegistryEntries(fs.readFileSync(provider, "utf8"), provider);
+  } catch {
+    return [];
+  }
+}
+function recordEntries(statics, specifier, entries, input) {
+  for (const entry of entries) {
+    if (entry.kind === "sz-object" && !resolveImportedStaticSz(input.importedStaticSz)) {
+      continue;
+    }
+    transformCache.recordResolvedEntry(statics, entry.kind, specifier, entry.exportName, entry.value);
+  }
+}
+function withCrossModuleStatics(options, statics) {
+  if (statics.szvConfigs === void 0 && statics.szObjects === void 0) return options;
+  return {
+    ...options,
+    ...statics.szvConfigs === void 0 ? {} : { crossModuleStatics: statics.szvConfigs },
+    ...statics.szObjects === void 0 ? {} : { crossModuleSzObjects: statics.szObjects }
+  };
+}
+function configWithImportedStaticSz(config, importedStaticSz) {
+  return {
+    ...config,
+    importedStaticSz: resolveImportedStaticSz(importedStaticSz)
+  };
+}
+function normalizeProviderPaths(providers) {
+  return [...new Set(providers.map(transformCache.normalizePathSeparators))];
+}
+
 function readPackageVersion(relativePackageJson, fromUrl) {
   try {
     const packageJson = JSON.parse(
@@ -169,6 +247,12 @@ function createNextSourceTransformCacheInput(input, filename, producer) {
     globalVarAliases: normalizeGlobalVarAliasesForCache(
       input.compilerOptions?.globalVarAliases
     ),
+    // The registry slice this file was compiled against is part of its
+    // identity. Without it an edited provider serves its importers the
+    // cached output built from the value it used to have — the one failure
+    // this lane refused to risk before it resolved anything at all.
+    crossModuleStatics: input.compilerOptions?.crossModuleStatics === void 0 ? void 0 : JSON.stringify(input.compilerOptions.crossModuleStatics),
+    crossModuleSzObjects: input.compilerOptions?.crossModuleSzObjects === void 0 ? void 0 : JSON.stringify(input.compilerOptions.crossModuleSzObjects),
     filename,
     source: input.source
   };
@@ -278,6 +362,10 @@ function collectTransformClasses(result, discoveredClasses) {
 }
 
 exports.collectNextTransformMetadata = collectNextTransformMetadata;
+exports.configWithImportedStaticSz = configWithImportedStaticSz;
 exports.createNextSafelistShardFromMetadata = createNextSafelistShardFromMetadata;
+exports.normalizeProviderPaths = normalizeProviderPaths;
 exports.readPackageVersion = readPackageVersion;
+exports.resolveNextCrossModule = resolveNextCrossModule;
 exports.transformNextSource = transformNextSource;
+exports.withCrossModuleStatics = withCrossModuleStatics;

package/dist/shared/{unplugin.DblMogcN.cjs → unplugin.Cji6O5jv.cjs}

@@ -185,11 +185,14 @@ function atomicRenameWithRetry(from, to, options = {}) {
 function isExistingShardEquivalent(filePath, shard) {
   try {
     const parsed = JSON.parse(fs__namespace.readFileSync(filePath, "utf8"));
-    return parsed.version === 1 && parsed.sourcePath === shard.sourcePath && parsed.sourceHash === shard.sourceHash;
+    return parsed.version === 1 && parsed.sourcePath === shard.sourcePath && parsed.sourceHash === shard.sourceHash && sameClasses(parsed.classes, shard.classes);
   } catch {
     return false;
   }
 }
+function sameClasses(left, right) {
+  return Array.isArray(left) && left.length === right.length && left.every((value, index) => value === right[index]);
+}
 function normalizeShardInput(input) {
   const sourcePath = path__namespace.resolve(input.sourcePath);
   const classes = htmlEscape.sortStrings(

package/dist/shared/{unplugin.-yLpX1Ck.mjs → unplugin.CogPHmDs.mjs}

@@ -1,9 +1,73 @@
 import { readFileSync } from 'node:fs';
-import { ensureRustTransformAvailable, transformSourceCode, transformRust, transformOxc, transform } from '@csszyx/compiler';
-import { c as createTransformCacheKey, a as readTransformCache, w as writeTransformCache, n as normalizePathSeparators, b as babelFallbackReason } from './unplugin.fOnGXWgS.mjs';
+import * as path from 'node:path';
+import { extractCrossModuleRegistryEntries, ensureRustTransformAvailable, transformSourceCode, transformRust, transformOxc, transform } from '@csszyx/compiler';
+import { DEFAULT_IMPORTED_STATIC_SZ } from '@csszyx/types';
+import { c as collectSpecifierAliases, i as importedSpecifiersIn, s as specifierBases, a as resolveProviderPathWith, n as normalizePathSeparators, b as recordResolvedEntry, d as isReadableProviderFile, e as createTransformCacheKey, f as readTransformCache, w as writeTransformCache, g as babelFallbackReason } from './unplugin.BB0iWSds.mjs';
 import { createHash } from 'node:crypto';
 import { s as sortStrings } from './unplugin.B3XoSRB8.mjs';
 
+function resolveImportedStaticSz(value) {
+  return value ?? DEFAULT_IMPORTED_STATIC_SZ;
+}
+const aliasesByRoot = /* @__PURE__ */ new Map();
+function resolveNextCrossModule(input) {
+  const empty = { statics: {}, providers: [] };
+  if (!input.source.includes("from")) return empty;
+  let aliases = aliasesByRoot.get(input.root);
+  if (aliases === void 0) {
+    aliases = collectSpecifierAliases(input.root);
+    aliasesByRoot.set(input.root, aliases);
+  }
+  const directory = path.dirname(input.filename);
+  const statics = {};
+  const providers = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const specifier of importedSpecifiersIn(input.source)) {
+    if (seen.has(specifier)) continue;
+    seen.add(specifier);
+    for (const base of specifierBases(specifier, directory, aliases)) {
+      const provider = resolveProviderPathWith(base, isReadableProviderFile);
+      if (provider === void 0) continue;
+      providers.push(provider);
+      recordEntries(statics, specifier, readProviderEntries(provider), input);
+      break;
+    }
+  }
+  return { statics, providers };
+}
+function readProviderEntries(provider) {
+  try {
+    return extractCrossModuleRegistryEntries(readFileSync(provider, "utf8"), provider);
+  } catch {
+    return [];
+  }
+}
+function recordEntries(statics, specifier, entries, input) {
+  for (const entry of entries) {
+    if (entry.kind === "sz-object" && !resolveImportedStaticSz(input.importedStaticSz)) {
+      continue;
+    }
+    recordResolvedEntry(statics, entry.kind, specifier, entry.exportName, entry.value);
+  }
+}
+function withCrossModuleStatics(options, statics) {
+  if (statics.szvConfigs === void 0 && statics.szObjects === void 0) return options;
+  return {
+    ...options,
+    ...statics.szvConfigs === void 0 ? {} : { crossModuleStatics: statics.szvConfigs },
+    ...statics.szObjects === void 0 ? {} : { crossModuleSzObjects: statics.szObjects }
+  };
+}
+function configWithImportedStaticSz(config, importedStaticSz) {
+  return {
+    ...config,
+    importedStaticSz: resolveImportedStaticSz(importedStaticSz)
+  };
+}
+function normalizeProviderPaths(providers) {
+  return [...new Set(providers.map(normalizePathSeparators))];
+}
+
 function readPackageVersion(relativePackageJson, fromUrl) {
   try {
     const packageJson = JSON.parse(
@@ -167,6 +231,12 @@ function createNextSourceTransformCacheInput(input, filename, producer) {
     globalVarAliases: normalizeGlobalVarAliasesForCache(
       input.compilerOptions?.globalVarAliases
     ),
+    // The registry slice this file was compiled against is part of its
+    // identity. Without it an edited provider serves its importers the
+    // cached output built from the value it used to have — the one failure
+    // this lane refused to risk before it resolved anything at all.
+    crossModuleStatics: input.compilerOptions?.crossModuleStatics === void 0 ? void 0 : JSON.stringify(input.compilerOptions.crossModuleStatics),
+    crossModuleSzObjects: input.compilerOptions?.crossModuleSzObjects === void 0 ? void 0 : JSON.stringify(input.compilerOptions.crossModuleSzObjects),
     filename,
     source: input.source
   };
@@ -275,4 +345,4 @@ function collectTransformClasses(result, discoveredClasses) {
   }
 }
 
-export { createNextSafelistShardFromMetadata as a, collectNextTransformMetadata as c, readPackageVersion as r, transformNextSource as t };
+export { resolveNextCrossModule as a, collectNextTransformMetadata as b, configWithImportedStaticSz as c, createNextSafelistShardFromMetadata as d, normalizeProviderPaths as n, readPackageVersion as r, transformNextSource as t, withCrossModuleStatics as w };

package/dist/shared/{unplugin.BK7BIeBn.d.cts → unplugin.DCT7DDG6.d.cts}

@@ -65,7 +65,7 @@ interface GlobalVarScanCacheKeyInput {
     /** Source file mtime in milliseconds. */
     mtimeMs: number;
 }
-/** CSS source supplied to the Phase H validation orchestrator. */
+/** CSS source supplied to the global-variable validation orchestrator. */
 interface GlobalVarCssSource {
     /** Source file path. */
     filePath: string;
@@ -74,7 +74,7 @@ interface GlobalVarCssSource {
     /** Source file mtime in milliseconds, used when cacheDir is set. */
     mtimeMs?: number;
 }
-/** JS/TS/JSX/TSX source supplied to the Phase H validation orchestrator. */
+/** JS/TS/JSX/TSX source supplied to the global-variable validation orchestrator. */
 interface GlobalVarCodeSource {
     /** Source file path. */
     filePath: string;
@@ -101,7 +101,7 @@ type GlobalVarAliasDiagnosticSeverity = 'error';
 interface GlobalVarAliasDiagnostic {
     /** Machine-readable diagnostic code. */
     code: 'missing-definition' | 'tailwind-reserved' | 'tailwind-owned' | 'registered-property' | 'alias-collision';
-    /** Diagnostic severity. Phase H M2 is fail-closed. */
+    /** Diagnostic severity. Every finding fails the build. */
     severity: GlobalVarAliasDiagnosticSeverity;
     /** Related custom-property name. */
     name: string;
@@ -141,7 +141,7 @@ interface GlobalVarAliasPlan {
     /** Planner diagnostics. */
     diagnostics: GlobalVarAliasDiagnostic[];
 }
-/** Input for Phase H scanner/planner/diagnostics integration. */
+/** Input for the global-variable scanner/planner/diagnostics integration. */
 interface ValidateGlobalVarAliasInputsOptions {
     /** CSS sources that define or reference custom properties. */
     cssFiles: GlobalVarCssSource[];
@@ -177,7 +177,7 @@ interface CreateGlobalVarAliasValidationOptionsInput {
     /** Optional global-var scan cache directory. */
     cacheDir?: string;
 }
-/** Output from Phase H scanner/planner/diagnostics integration. */
+/** Output from the global-variable scanner/planner/diagnostics integration. */
 interface GlobalVarAliasValidationResult {
     /** CSS scan results. */
     scans: CssVarScanResult[];
@@ -405,12 +405,21 @@ interface PluginState {
      * Drives the `@source` safelist; NOT the mangle map.
      */
     classes: Set<string>;
-    /** Merged @theme scan result — feeds the theme-groups virtual module. */
+    /**
+     * Merged @theme scan result — the ONLY consumer is the theme-groups virtual
+     * module, so this is a merge-correctness input, not a typing one.
+     */
     parsedTheme: ParsedTheme | null;
     /**
-     * CSS files the zero-config @theme auto-scan found tokens in (only when
-     * `build.scanCss` is unset). Dev HMR re-scans when one of these — or any
-     * other .css file — changes, mirroring the explicit scanCss reload path.
+     * Tokens from the files `build.scanCss` lists, kept apart from the
+     * project-wide discovery so a token deleted from either source disappears
+     * from the merged result instead of lingering across a re-scan.
+     */
+    scanCssTheme: ParsedTheme | null;
+    /**
+     * CSS files the project-wide @theme scan found tokens in. Dev HMR re-scans
+     * when one of these — or any other .css file — changes, mirroring the
+     * explicit scanCss reload path.
      */
     autoThemeCssFiles: string[];
     /**
@@ -450,11 +459,21 @@ interface PluginState {
     /** Unresolvable-spread warnings surfaced to the build log in every mode. */
     spreadWarnings: Set<string>;
     /**
-     * Workspace-package files under `/packages/` that contain `sz` but were
+     * Workspace-package files under `/packages/` that use csszyx but were
      * skipped by the hard-ignore (not under any `compileSources` dir). Surfaced at
      * build end so the silent no-op (skipped `sz` → no CSS) becomes visible.
      */
     skippedSzFiles: Set<string>;
+    /**
+     * The subset of {@link skippedSzFiles} that may export szv factories.
+     *
+     * Skipping one of these does more than lose a file's own CSS: it keeps the
+     * module out of the cross-module registry, so every importer — compiled or
+     * not — silently falls back to the runtime path. That is dropped csszyx
+     * output rather than a usage nudge, so its presence promotes the warning
+     * out of dev-only.
+     */
+    skippedSzvExportFiles: Set<string>;
     /** Guards the skipped-sz-files warning so it fires at most once. */
     skipWarningEmitted: boolean;
     /**
@@ -648,17 +667,58 @@ declare function shouldWarnUnscopedMonorepo(sawTailwindEntry: boolean, tailwindE
  */
 declare function unscopedMonorepoMessage(): string;
 /**
- * Whether a csszyx build warning should be emitted. `quiet` mutes all of them;
- * `devOnly` additionally suppresses the warning in a production build (for usage
- * nudges that must not noise a host app's prod output). Pure so the gating policy
- * is unit-tested without the worker-based buildEnd wiring.
+ * The `quiet` option, normalized.
+ *
+ * `'all'` is the blunt setting a plain `true` selects; `'nudges'` keeps every
+ * report that the build produced less output than it was asked for.
+ */
+type QuietMode = 'off' | 'nudges' | 'all';
+/**
+ * Normalize the authored `quiet` value. Idempotent, so a already-normalized
+ * mode passes through unchanged.
+ *
+ * @param quiet - Authored option value, or an already-resolved mode.
+ * @returns The mode the gates read.
+ */
+declare function resolveQuietMode(quiet: boolean | 'nudges' | QuietMode | undefined): QuietMode;
+/**
+ * Whether a csszyx build warning should be emitted.
+ *
+ * `devOnly` is already this plugin's marker for "usage nudge": it suppresses
+ * the warning in a production build so it cannot noise a host app's output.
+ * `'nudges'` mutes exactly that same set, which keeps one axis instead of
+ * inventing a second classification for the same distinction. `true` mutes
+ * everything. Pure so the gating policy is unit-tested without the
+ * worker-based buildEnd wiring.
  *
- * @param quiet - The `quiet` option: mute every warning.
- * @param devOnly - This warning is a dev-only usage nudge.
+ * @param quiet - Resolved quiet mode.
+ * @param devOnly - This warning is a usage nudge.
  * @param isProduction - Whether this is a production build.
  * @returns true when the warning should be printed.
  */
-declare function shouldEmitWarning(quiet: boolean, devOnly: boolean, isProduction: boolean): boolean;
+declare function shouldEmitWarning(quiet: QuietMode, devOnly: boolean, isProduction: boolean): boolean;
+/**
+ * Whether a transform diagnostic describes missing CSS and may be printed.
+ *
+ * Only the blunt mode hides these. A missing-CSS diagnostic says classes never
+ * reached the safelist, so the styles are absent from the output — a build
+ * result, not a style opinion, and `'nudges'` exists so a calmer log does not
+ * have to cost it.
+ *
+ * @param quiet - Resolved quiet mode.
+ * @param message - Compiler diagnostic to classify.
+ * @returns True when the diagnostic is an unsilenced missing-CSS failure.
+ */
+declare function shouldEmitMissingCssFallback(quiet: QuietMode, message: string): boolean;
+/**
+ * Emit one missing-CSS fallback through the caller's output channel.
+ *
+ * @param quiet - Resolved quiet mode.
+ * @param message - Compiler diagnostic to classify and emit.
+ * @param id - Bundler module identifier included in the warning.
+ * @param emit - Warning output channel.
+ */
+declare function emitMissingCssFallback(quiet: QuietMode, message: string, id: string, emit: (message: string) => void): void;
 /**
  * Resolve `compileSources` entries to absolute, realpath-resolved directories.
  * Each entry resolves like a Vite config path: relative to the project `root`
@@ -753,14 +813,16 @@ declare function allocateMangleTokens(eligibleClasses: readonly string[], forbid
  */
 declare function isPackagesSkippedSource(id: string, sourceDirs?: readonly string[]): boolean;
 /**
- * Build the workspace-package skip warning. Lists the skipped files that contain
- * `sz` so the developer can add the package directory to `compileSources`
+ * Build the workspace-package skip warning. Lists the skipped files that use
+ * csszyx so the developer can add the package directory to `compileSources`
  * instead of silently shipping no CSS for them.
  *
- * @param files - skipped `/packages/` file paths that contain `sz`.
+ * @param files - skipped `/packages/` file paths that use csszyx.
+ * @param szvExportFiles - the subset that may export `szv` factories, whose
+ *   skip also costs every importer its cross-module precompile.
  * @returns the warning string.
  */
-declare function skippedSzFilesMessage(files: readonly string[]): string;
+declare function skippedSzFilesMessage(files: readonly string[], szvExportFiles?: readonly string[]): 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
@@ -790,8 +852,8 @@ declare function shouldTrackGlobalVarSources(config?: {
     enabled?: boolean;
 }): boolean;
 /**
- * Records source text available before bundling/minification for Phase H
- * global-var diagnostics.
+ * Records source text available before bundling/minification for global-var
+ * diagnostics.
  *
  * @param state Plugin state to update.
  * @param filename Source filename that owns the text.
@@ -799,7 +861,7 @@ declare function shouldTrackGlobalVarSources(config?: {
  */
 declare function recordGlobalVarSourceFile(state: Pick<PluginState, 'globalVarSourceFilesByFile'>, filename: string, code: string | null): void;
 /**
- * Extracts Phase H global custom-property aliases for manifest/debug tooling.
+ * Extracts global custom-property aliases for manifest/debug tooling.
  *
  * The legacy `varMangleMap` also carries dynamic s/c-tier CSS variables. This
  * helper keeps manifest consumers from guessing tiers by exposing only aliases
@@ -869,5 +931,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { mangleHybridHazardMessage as $, cssImportsTailwind as A, unplugin as B, deleteRSCModuleRecord as D, esbuildPlugin as E, extractGlobalVarAliasesForManifest as F, fileMayContainSafelistableSz as H, findLocalImportSources as I, findRSCBoundaryViolation as J, findRSCGraphViolation as K, hasInjectableTailwindCandidate as L, hasTokens as N, hasUseClientDirective as O, hasUseServerDirective as Q, isCompileSourceOptedIn as T, isHardIgnoredPath as U, isMonorepoPackage as W, isPackagesSkippedSource as X, isRSCServerModule as Y, mangleCodeClassesSync as Z, mangleEligibleClasses as _, mergeThemes as a0, missingTailwindEntryMessage as a1, normalizeGlobalVarAliasesForCache as a2, parseThemeBlocks as a3, recordGlobalVarSourceFile as a4, resolveCompileSourceDirs as a5, resolveNativeCacheIdentity as a6, rollupPlugin as a7, scanCustomPropertyNames as a8, shouldEmitWarning as a9, shouldTrackGlobalVarSources as aa, shouldWarnMissingTailwindEntry as ab, shouldWarnUnscopedMonorepo as ac, skippedSzFilesMessage as ad, unscopedMonorepoMessage as ae, vitePlugin as af, webpackPlugin as ag, allocateMangleTokens as r, appendTailwindSourceDirective as s, assertNoRSCBoundaryViolation as t, assertNoRSCGraphViolation as u, collectMangleHybridHazards as v, computeSafelistRelPath as w, createGlobalVarMapAssetSource as x, createRSCModuleRecord as y, cssHasContentScope as z };
-export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, MangleHybridHazards as M, PlanGlobalVarAliasesInput as P, 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 };
+export { mangleCodeClassesSync as $, cssImportsTailwind as A, unplugin as B, deleteRSCModuleRecord as D, emitMissingCssFallback as E, esbuildPlugin as F, extractGlobalVarAliasesForManifest as H, fileMayContainSafelistableSz as I, findLocalImportSources as J, findRSCBoundaryViolation as K, findRSCGraphViolation as L, hasInjectableTailwindCandidate as N, hasTokens as O, hasUseClientDirective as T, hasUseServerDirective as U, isCompileSourceOptedIn as W, isHardIgnoredPath as X, isMonorepoPackage as Y, isPackagesSkippedSource as Z, isRSCServerModule as _, mangleEligibleClasses as a0, mangleHybridHazardMessage as a1, mergeThemes as a2, missingTailwindEntryMessage as a3, normalizeGlobalVarAliasesForCache as a4, parseThemeBlocks as a5, recordGlobalVarSourceFile as a6, resolveCompileSourceDirs as a7, resolveNativeCacheIdentity as a8, resolveQuietMode as a9, rollupPlugin as aa, scanCustomPropertyNames as ab, shouldEmitMissingCssFallback as ac, shouldEmitWarning as ad, shouldTrackGlobalVarSources as ae, shouldWarnMissingTailwindEntry as af, shouldWarnUnscopedMonorepo as ag, skippedSzFilesMessage as ah, unscopedMonorepoMessage as ai, vitePlugin as aj, webpackPlugin as ak, allocateMangleTokens as r, appendTailwindSourceDirective as s, assertNoRSCBoundaryViolation as t, assertNoRSCGraphViolation as u, collectMangleHybridHazards as v, computeSafelistRelPath as w, createGlobalVarMapAssetSource as x, createRSCModuleRecord as y, cssHasContentScope as z };
+export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, MangleHybridHazards as M, PlanGlobalVarAliasesInput as P, QuietMode as Q, RewriteGlobalVarCssAliasesOptions as R, ScanGlobalVarCssOptions as S, ValidateGlobalVarAliasInputsOptions as V, GlobalVarAliasPlan as a, GlobalVarCssAliasRewriteResult as b, CreateGlobalVarAliasValidationOptionsInput as c, GlobalVarAliasValidationResult as d, CssVarDefinition as e, CssVarLocation as f, CssVarReference as g, GlobalVarAliasDiagnostic as h, GlobalVarAliasDiagnosticSeverity as i, GlobalVarAliasEntry as j, GlobalVarCodeSource as k, GlobalVarCssAssetSource as l, GlobalVarCssSource as m, GlobalVarScanCacheEntry as n, ParsedTheme as o, RSCBoundaryViolation as p, RSCModuleRecord as q };

package/dist/shared/{unplugin.BK7BIeBn.d.mts → unplugin.DCT7DDG6.d.mts}

@@ -65,7 +65,7 @@ interface GlobalVarScanCacheKeyInput {
     /** Source file mtime in milliseconds. */
     mtimeMs: number;
 }
-/** CSS source supplied to the Phase H validation orchestrator. */
+/** CSS source supplied to the global-variable validation orchestrator. */
 interface GlobalVarCssSource {
     /** Source file path. */
     filePath: string;
@@ -74,7 +74,7 @@ interface GlobalVarCssSource {
     /** Source file mtime in milliseconds, used when cacheDir is set. */
     mtimeMs?: number;
 }
-/** JS/TS/JSX/TSX source supplied to the Phase H validation orchestrator. */
+/** JS/TS/JSX/TSX source supplied to the global-variable validation orchestrator. */
 interface GlobalVarCodeSource {
     /** Source file path. */
     filePath: string;
@@ -101,7 +101,7 @@ type GlobalVarAliasDiagnosticSeverity = 'error';
 interface GlobalVarAliasDiagnostic {
     /** Machine-readable diagnostic code. */
     code: 'missing-definition' | 'tailwind-reserved' | 'tailwind-owned' | 'registered-property' | 'alias-collision';
-    /** Diagnostic severity. Phase H M2 is fail-closed. */
+    /** Diagnostic severity. Every finding fails the build. */
     severity: GlobalVarAliasDiagnosticSeverity;
     /** Related custom-property name. */
     name: string;
@@ -141,7 +141,7 @@ interface GlobalVarAliasPlan {
     /** Planner diagnostics. */
     diagnostics: GlobalVarAliasDiagnostic[];
 }
-/** Input for Phase H scanner/planner/diagnostics integration. */
+/** Input for the global-variable scanner/planner/diagnostics integration. */
 interface ValidateGlobalVarAliasInputsOptions {
     /** CSS sources that define or reference custom properties. */
     cssFiles: GlobalVarCssSource[];
@@ -177,7 +177,7 @@ interface CreateGlobalVarAliasValidationOptionsInput {
     /** Optional global-var scan cache directory. */
     cacheDir?: string;
 }
-/** Output from Phase H scanner/planner/diagnostics integration. */
+/** Output from the global-variable scanner/planner/diagnostics integration. */
 interface GlobalVarAliasValidationResult {
     /** CSS scan results. */
     scans: CssVarScanResult[];
@@ -405,12 +405,21 @@ interface PluginState {
      * Drives the `@source` safelist; NOT the mangle map.
      */
     classes: Set<string>;
-    /** Merged @theme scan result — feeds the theme-groups virtual module. */
+    /**
+     * Merged @theme scan result — the ONLY consumer is the theme-groups virtual
+     * module, so this is a merge-correctness input, not a typing one.
+     */
     parsedTheme: ParsedTheme | null;
     /**
-     * CSS files the zero-config @theme auto-scan found tokens in (only when
-     * `build.scanCss` is unset). Dev HMR re-scans when one of these — or any
-     * other .css file — changes, mirroring the explicit scanCss reload path.
+     * Tokens from the files `build.scanCss` lists, kept apart from the
+     * project-wide discovery so a token deleted from either source disappears
+     * from the merged result instead of lingering across a re-scan.
+     */
+    scanCssTheme: ParsedTheme | null;
+    /**
+     * CSS files the project-wide @theme scan found tokens in. Dev HMR re-scans
+     * when one of these — or any other .css file — changes, mirroring the
+     * explicit scanCss reload path.
      */
     autoThemeCssFiles: string[];
     /**
@@ -450,11 +459,21 @@ interface PluginState {
     /** Unresolvable-spread warnings surfaced to the build log in every mode. */
     spreadWarnings: Set<string>;
     /**
-     * Workspace-package files under `/packages/` that contain `sz` but were
+     * Workspace-package files under `/packages/` that use csszyx but were
      * skipped by the hard-ignore (not under any `compileSources` dir). Surfaced at
      * build end so the silent no-op (skipped `sz` → no CSS) becomes visible.
      */
     skippedSzFiles: Set<string>;
+    /**
+     * The subset of {@link skippedSzFiles} that may export szv factories.
+     *
+     * Skipping one of these does more than lose a file's own CSS: it keeps the
+     * module out of the cross-module registry, so every importer — compiled or
+     * not — silently falls back to the runtime path. That is dropped csszyx
+     * output rather than a usage nudge, so its presence promotes the warning
+     * out of dev-only.
+     */
+    skippedSzvExportFiles: Set<string>;
     /** Guards the skipped-sz-files warning so it fires at most once. */
     skipWarningEmitted: boolean;
     /**
@@ -648,17 +667,58 @@ declare function shouldWarnUnscopedMonorepo(sawTailwindEntry: boolean, tailwindE
  */
 declare function unscopedMonorepoMessage(): string;
 /**
- * Whether a csszyx build warning should be emitted. `quiet` mutes all of them;
- * `devOnly` additionally suppresses the warning in a production build (for usage
- * nudges that must not noise a host app's prod output). Pure so the gating policy
- * is unit-tested without the worker-based buildEnd wiring.
+ * The `quiet` option, normalized.
+ *
+ * `'all'` is the blunt setting a plain `true` selects; `'nudges'` keeps every
+ * report that the build produced less output than it was asked for.
+ */
+type QuietMode = 'off' | 'nudges' | 'all';
+/**
+ * Normalize the authored `quiet` value. Idempotent, so a already-normalized
+ * mode passes through unchanged.
+ *
+ * @param quiet - Authored option value, or an already-resolved mode.
+ * @returns The mode the gates read.
+ */
+declare function resolveQuietMode(quiet: boolean | 'nudges' | QuietMode | undefined): QuietMode;
+/**
+ * Whether a csszyx build warning should be emitted.
+ *
+ * `devOnly` is already this plugin's marker for "usage nudge": it suppresses
+ * the warning in a production build so it cannot noise a host app's output.
+ * `'nudges'` mutes exactly that same set, which keeps one axis instead of
+ * inventing a second classification for the same distinction. `true` mutes
+ * everything. Pure so the gating policy is unit-tested without the
+ * worker-based buildEnd wiring.
  *
- * @param quiet - The `quiet` option: mute every warning.
- * @param devOnly - This warning is a dev-only usage nudge.
+ * @param quiet - Resolved quiet mode.
+ * @param devOnly - This warning is a usage nudge.
  * @param isProduction - Whether this is a production build.
  * @returns true when the warning should be printed.
  */
-declare function shouldEmitWarning(quiet: boolean, devOnly: boolean, isProduction: boolean): boolean;
+declare function shouldEmitWarning(quiet: QuietMode, devOnly: boolean, isProduction: boolean): boolean;
+/**
+ * Whether a transform diagnostic describes missing CSS and may be printed.
+ *
+ * Only the blunt mode hides these. A missing-CSS diagnostic says classes never
+ * reached the safelist, so the styles are absent from the output — a build
+ * result, not a style opinion, and `'nudges'` exists so a calmer log does not
+ * have to cost it.
+ *
+ * @param quiet - Resolved quiet mode.
+ * @param message - Compiler diagnostic to classify.
+ * @returns True when the diagnostic is an unsilenced missing-CSS failure.
+ */
+declare function shouldEmitMissingCssFallback(quiet: QuietMode, message: string): boolean;
+/**
+ * Emit one missing-CSS fallback through the caller's output channel.
+ *
+ * @param quiet - Resolved quiet mode.
+ * @param message - Compiler diagnostic to classify and emit.
+ * @param id - Bundler module identifier included in the warning.
+ * @param emit - Warning output channel.
+ */
+declare function emitMissingCssFallback(quiet: QuietMode, message: string, id: string, emit: (message: string) => void): void;
 /**
  * Resolve `compileSources` entries to absolute, realpath-resolved directories.
  * Each entry resolves like a Vite config path: relative to the project `root`
@@ -753,14 +813,16 @@ declare function allocateMangleTokens(eligibleClasses: readonly string[], forbid
  */
 declare function isPackagesSkippedSource(id: string, sourceDirs?: readonly string[]): boolean;
 /**
- * Build the workspace-package skip warning. Lists the skipped files that contain
- * `sz` so the developer can add the package directory to `compileSources`
+ * Build the workspace-package skip warning. Lists the skipped files that use
+ * csszyx so the developer can add the package directory to `compileSources`
  * instead of silently shipping no CSS for them.
  *
- * @param files - skipped `/packages/` file paths that contain `sz`.
+ * @param files - skipped `/packages/` file paths that use csszyx.
+ * @param szvExportFiles - the subset that may export `szv` factories, whose
+ *   skip also costs every importer its cross-module precompile.
  * @returns the warning string.
  */
-declare function skippedSzFilesMessage(files: readonly string[]): string;
+declare function skippedSzFilesMessage(files: readonly string[], szvExportFiles?: readonly string[]): 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
@@ -790,8 +852,8 @@ declare function shouldTrackGlobalVarSources(config?: {
     enabled?: boolean;
 }): boolean;
 /**
- * Records source text available before bundling/minification for Phase H
- * global-var diagnostics.
+ * Records source text available before bundling/minification for global-var
+ * diagnostics.
  *
  * @param state Plugin state to update.
  * @param filename Source filename that owns the text.
@@ -799,7 +861,7 @@ declare function shouldTrackGlobalVarSources(config?: {
  */
 declare function recordGlobalVarSourceFile(state: Pick<PluginState, 'globalVarSourceFilesByFile'>, filename: string, code: string | null): void;
 /**
- * Extracts Phase H global custom-property aliases for manifest/debug tooling.
+ * Extracts global custom-property aliases for manifest/debug tooling.
  *
  * The legacy `varMangleMap` also carries dynamic s/c-tier CSS variables. This
  * helper keeps manifest consumers from guessing tiers by exposing only aliases
@@ -869,5 +931,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { mangleHybridHazardMessage as $, cssImportsTailwind as A, unplugin as B, deleteRSCModuleRecord as D, esbuildPlugin as E, extractGlobalVarAliasesForManifest as F, fileMayContainSafelistableSz as H, findLocalImportSources as I, findRSCBoundaryViolation as J, findRSCGraphViolation as K, hasInjectableTailwindCandidate as L, hasTokens as N, hasUseClientDirective as O, hasUseServerDirective as Q, isCompileSourceOptedIn as T, isHardIgnoredPath as U, isMonorepoPackage as W, isPackagesSkippedSource as X, isRSCServerModule as Y, mangleCodeClassesSync as Z, mangleEligibleClasses as _, mergeThemes as a0, missingTailwindEntryMessage as a1, normalizeGlobalVarAliasesForCache as a2, parseThemeBlocks as a3, recordGlobalVarSourceFile as a4, resolveCompileSourceDirs as a5, resolveNativeCacheIdentity as a6, rollupPlugin as a7, scanCustomPropertyNames as a8, shouldEmitWarning as a9, shouldTrackGlobalVarSources as aa, shouldWarnMissingTailwindEntry as ab, shouldWarnUnscopedMonorepo as ac, skippedSzFilesMessage as ad, unscopedMonorepoMessage as ae, vitePlugin as af, webpackPlugin as ag, allocateMangleTokens as r, appendTailwindSourceDirective as s, assertNoRSCBoundaryViolation as t, assertNoRSCGraphViolation as u, collectMangleHybridHazards as v, computeSafelistRelPath as w, createGlobalVarMapAssetSource as x, createRSCModuleRecord as y, cssHasContentScope as z };
-export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, MangleHybridHazards as M, PlanGlobalVarAliasesInput as P, 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 };
+export { mangleCodeClassesSync as $, cssImportsTailwind as A, unplugin as B, deleteRSCModuleRecord as D, emitMissingCssFallback as E, esbuildPlugin as F, extractGlobalVarAliasesForManifest as H, fileMayContainSafelistableSz as I, findLocalImportSources as J, findRSCBoundaryViolation as K, findRSCGraphViolation as L, hasInjectableTailwindCandidate as N, hasTokens as O, hasUseClientDirective as T, hasUseServerDirective as U, isCompileSourceOptedIn as W, isHardIgnoredPath as X, isMonorepoPackage as Y, isPackagesSkippedSource as Z, isRSCServerModule as _, mangleEligibleClasses as a0, mangleHybridHazardMessage as a1, mergeThemes as a2, missingTailwindEntryMessage as a3, normalizeGlobalVarAliasesForCache as a4, parseThemeBlocks as a5, recordGlobalVarSourceFile as a6, resolveCompileSourceDirs as a7, resolveNativeCacheIdentity as a8, resolveQuietMode as a9, rollupPlugin as aa, scanCustomPropertyNames as ab, shouldEmitMissingCssFallback as ac, shouldEmitWarning as ad, shouldTrackGlobalVarSources as ae, shouldWarnMissingTailwindEntry as af, shouldWarnUnscopedMonorepo as ag, skippedSzFilesMessage as ah, unscopedMonorepoMessage as ai, vitePlugin as aj, webpackPlugin as ak, allocateMangleTokens as r, appendTailwindSourceDirective as s, assertNoRSCBoundaryViolation as t, assertNoRSCGraphViolation as u, collectMangleHybridHazards as v, computeSafelistRelPath as w, createGlobalVarMapAssetSource as x, createRSCModuleRecord as y, cssHasContentScope as z };
+export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, MangleHybridHazards as M, PlanGlobalVarAliasesInput as P, QuietMode as Q, RewriteGlobalVarCssAliasesOptions as R, ScanGlobalVarCssOptions as S, ValidateGlobalVarAliasInputsOptions as V, GlobalVarAliasPlan as a, GlobalVarCssAliasRewriteResult as b, CreateGlobalVarAliasValidationOptionsInput as c, GlobalVarAliasValidationResult as d, CssVarDefinition as e, CssVarLocation as f, CssVarReference as g, GlobalVarAliasDiagnostic as h, GlobalVarAliasDiagnosticSeverity as i, GlobalVarAliasEntry as j, GlobalVarCodeSource as k, GlobalVarCssAssetSource as l, GlobalVarCssSource as m, GlobalVarScanCacheEntry as n, ParsedTheme as o, RSCBoundaryViolation as p, RSCModuleRecord as q };