@csszyx/unplugin 0.10.0 → 0.10.2

package/dist/index.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const cssMangler = require('./css-mangler.cjs');
-const unplugin = require('./shared/unplugin.Dk6ddrZX.cjs');
+const unplugin = require('./shared/unplugin.B6W7JChH.cjs');
 const types = require('@csszyx/types');
 require('postcss');
 require('postcss-selector-parser');
@@ -63,11 +63,13 @@ exports.normalizeGlobalVarAliasesForCache = unplugin.normalizeGlobalVarAliasesFo
 exports.parseThemeBlocks = unplugin.parseThemeBlocks;
 exports.planGlobalVarAliases = unplugin.planGlobalVarAliases;
 exports.readGlobalVarScanCache = unplugin.readGlobalVarScanCache;
+exports.resolveCompilePackageDirs = unplugin.resolveCompilePackageDirs;
 exports.resolveGlobalVarScanCacheDir = unplugin.resolveGlobalVarScanCacheDir;
 exports.resolveNativeCacheIdentity = unplugin.resolveNativeCacheIdentity;
 exports.rewriteGlobalVarCssAliases = unplugin.rewriteGlobalVarCssAliases;
 exports.rollupPlugin = unplugin.rollupPlugin;
 exports.scanGlobalVarCss = unplugin.scanGlobalVarCss;
+exports.shouldEmitWarning = unplugin.shouldEmitWarning;
 exports.shouldWarnMissingTailwindEntry = unplugin.shouldWarnMissingTailwindEntry;
 exports.shouldWarnUnscopedMonorepo = unplugin.shouldWarnUnscopedMonorepo;
 exports.skippedSzFilesMessage = unplugin.skippedSzFilesMessage;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.cjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
-import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.BqLCtc84.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.C369_QDw.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, o as appendTailwindSourceDirective, p as computeSafelistRelPath, q as createGlobalVarMapAssetSource, r as cssHasContentScope, s as cssImportsTailwind, t as esbuildPlugin, v as extractGlobalVarAliasesForManifest, w as hasInjectableTailwindCandidate, x as isCompilePackageOptedIn, y as isHardIgnoredPath, z as isMonorepoPackage, A as isPackagesSkippedSource, B as mangleCodeClassesSync, D as missingTailwindEntryMessage, E as normalizeGlobalVarAliasesForCache, F as resolveNativeCacheIdentity, H as rollupPlugin, I as shouldWarnMissingTailwindEntry, J as shouldWarnUnscopedMonorepo, K as skippedSzFilesMessage, u as unplugin, L as unscopedMonorepoMessage, M as vitePlugin, N as webpackPlugin } from './shared/unplugin.BqLCtc84.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, o as appendTailwindSourceDirective, p as computeSafelistRelPath, q as createGlobalVarMapAssetSource, r as cssHasContentScope, s as cssImportsTailwind, t as esbuildPlugin, v as extractGlobalVarAliasesForManifest, w as hasInjectableTailwindCandidate, x as isCompilePackageOptedIn, y as isHardIgnoredPath, z as isMonorepoPackage, A as isPackagesSkippedSource, B as mangleCodeClassesSync, D as missingTailwindEntryMessage, E as normalizeGlobalVarAliasesForCache, F as resolveCompilePackageDirs, H as resolveNativeCacheIdentity, I as rollupPlugin, J as shouldEmitWarning, K as shouldWarnMissingTailwindEntry, L as shouldWarnUnscopedMonorepo, M as skippedSzFilesMessage, u as unplugin, N as unscopedMonorepoMessage, O as vitePlugin, Q as webpackPlugin } from './shared/unplugin.C369_QDw.cjs';
 import 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
-import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.BqLCtc84.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, o as appendTailwindSourceDirective, p as computeSafelistRelPath, q as createGlobalVarMapAssetSource, r as cssHasContentScope, s as cssImportsTailwind, u as default, t as esbuildPlugin, v as extractGlobalVarAliasesForManifest, w as hasInjectableTailwindCandidate, x as isCompilePackageOptedIn, y as isHardIgnoredPath, z as isMonorepoPackage, A as isPackagesSkippedSource, B as mangleCodeClassesSync, D as missingTailwindEntryMessage, E as normalizeGlobalVarAliasesForCache, F as resolveNativeCacheIdentity, H as rollupPlugin, I as shouldWarnMissingTailwindEntry, J as shouldWarnUnscopedMonorepo, K as skippedSzFilesMessage, u as unplugin, L as unscopedMonorepoMessage, M as vitePlugin, N as webpackPlugin } from './shared/unplugin.BqLCtc84.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.C369_QDw.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, o as appendTailwindSourceDirective, p as computeSafelistRelPath, q as createGlobalVarMapAssetSource, r as cssHasContentScope, s as cssImportsTailwind, u as default, t as esbuildPlugin, v as extractGlobalVarAliasesForManifest, w as hasInjectableTailwindCandidate, x as isCompilePackageOptedIn, y as isHardIgnoredPath, z as isMonorepoPackage, A as isPackagesSkippedSource, B as mangleCodeClassesSync, D as missingTailwindEntryMessage, E as normalizeGlobalVarAliasesForCache, F as resolveCompilePackageDirs, H as resolveNativeCacheIdentity, I as rollupPlugin, J as shouldEmitWarning, K as shouldWarnMissingTailwindEntry, L as shouldWarnUnscopedMonorepo, M as skippedSzFilesMessage, u as unplugin, N as unscopedMonorepoMessage, O as vitePlugin, Q as webpackPlugin } from './shared/unplugin.C369_QDw.mjs';
 import 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
-export { a as appendTailwindSourceDirective, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as computeSafelistRelPath, e as createGlobalVarAliasValidationOptions, f as createGlobalVarMapAssetSource, g as createGlobalVarScanCacheKey, h as createRSCModuleRecord, i as cssHasContentScope, j as cssImportsTailwind, u as default, k as deleteRSCModuleRecord, l as esbuildPlugin, m as extractGlobalVarAliasesForManifest, n as findRSCBoundaryViolation, o as findRSCGraphViolation, p as hasInjectableTailwindCandidate, q as hasTokens, r as hasUseClientDirective, s as hasUseServerDirective, t as isCompilePackageOptedIn, v as isHardIgnoredPath, w as isMonorepoPackage, x as isPackagesSkippedSource, y as isRSCServerModule, z as isTailwindReservedGlobalVar, A as mangleCodeClassesSync, B as mergeThemes, C as missingTailwindEntryMessage, D as normalizeGlobalVarAliasesForCache, E as parseThemeBlocks, F as planGlobalVarAliases, G as readGlobalVarScanCache, H as resolveGlobalVarScanCacheDir, I as resolveNativeCacheIdentity, J as rewriteGlobalVarCssAliases, K as rollupPlugin, L as scanGlobalVarCss, M as shouldWarnMissingTailwindEntry, N as shouldWarnUnscopedMonorepo, O as skippedSzFilesMessage, u as unplugin, P as unscopedMonorepoMessage, Q as validateGlobalVarAliasInputs, R as vitePlugin, S as webpackPlugin, T as writeGlobalVarScanCache } from './shared/unplugin.CLXpKBe4.mjs';
+export { a as appendTailwindSourceDirective, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as computeSafelistRelPath, e as createGlobalVarAliasValidationOptions, f as createGlobalVarMapAssetSource, g as createGlobalVarScanCacheKey, h as createRSCModuleRecord, i as cssHasContentScope, j as cssImportsTailwind, u as default, k as deleteRSCModuleRecord, l as esbuildPlugin, m as extractGlobalVarAliasesForManifest, n as findRSCBoundaryViolation, o as findRSCGraphViolation, p as hasInjectableTailwindCandidate, q as hasTokens, r as hasUseClientDirective, s as hasUseServerDirective, t as isCompilePackageOptedIn, v as isHardIgnoredPath, w as isMonorepoPackage, x as isPackagesSkippedSource, y as isRSCServerModule, z as isTailwindReservedGlobalVar, A as mangleCodeClassesSync, B as mergeThemes, C as missingTailwindEntryMessage, D as normalizeGlobalVarAliasesForCache, E as parseThemeBlocks, F as planGlobalVarAliases, G as readGlobalVarScanCache, H as resolveCompilePackageDirs, I as resolveGlobalVarScanCacheDir, J as resolveNativeCacheIdentity, K as rewriteGlobalVarCssAliases, L as rollupPlugin, M as scanGlobalVarCss, N as shouldEmitWarning, O as shouldWarnMissingTailwindEntry, P as shouldWarnUnscopedMonorepo, Q as skippedSzFilesMessage, u as unplugin, R as unscopedMonorepoMessage, S as validateGlobalVarAliasInputs, T as vitePlugin, U as webpackPlugin, V as writeGlobalVarScanCache } from './shared/unplugin.ZUVKukQo.mjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
 import 'postcss';
 import 'postcss-selector-parser';

package/dist/shared/{unplugin.Dk6ddrZX.cjs → unplugin.B6W7JChH.cjs}

@@ -1594,9 +1594,9 @@ const RUNTIME_HELPER_IMPORT_RE = {
 };
 let _hasWarnedTsConfig = false;
 let _hasWarnedTransformCacheVersion = false;
-const requireFromHere = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.Dk6ddrZX.cjs', document.baseURI).href)));
+const requireFromHere = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.B6W7JChH.cjs', document.baseURI).href)));
 const PLUGIN_VERSION = findPackageVersionFromFile(
-  node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.Dk6ddrZX.cjs', document.baseURI).href))),
+  node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/unplugin.B6W7JChH.cjs', document.baseURI).href))),
   UNKNOWN_PACKAGE_VERSION
 );
 const COMPILER_VERSION = findPackageVersionFromModule("@csszyx/compiler", UNKNOWN_PACKAGE_VERSION);
@@ -1703,6 +1703,15 @@ function shouldWarnUnscopedMonorepo(sawTailwindEntry, tailwindEntryScoped, inMon
 function unscopedMonorepoMessage() {
   return '[csszyx] Tailwind content detection is UNSCOPED in a monorepo. Tailwind v4 climbs to the workspace root and scans sibling packages + docs (.md/.mdx/.txt are not ignored), which can generate phantom or broken url() classes and fail the build. Scope it in your Tailwind CSS entry:\n    @import "tailwindcss" source(none);\n    @source ".";   /* this package, relative to the CSS file */\ncsszyx auto-injects @source for its generated classes, so only your own templates need listing. Guide: https://csszyx.com/docs/monorepo-content-scope/\nSilence (if a broad scan is intentional): csszyx({ contentScopeCheck: false }).';
 }
+function shouldEmitWarning(quiet, devOnly, isProduction) {
+  if (quiet) {
+    return false;
+  }
+  if (devOnly && isProduction) {
+    return false;
+  }
+  return true;
+}
 function isCompilePackageOptedIn(id, compilePackages) {
   const path2 = id.replace(/\\/g, "/");
   if (path2.includes("node_modules")) {
@@ -1710,6 +1719,41 @@ function isCompilePackageOptedIn(id, compilePackages) {
   }
   return compilePackages.some((name) => path2.includes(`/packages/${name}/`));
 }
+function resolveCompilePackageDirs(rootDir, compilePackages, dirExists = (dir) => {
+  try {
+    return fs__namespace.statSync(dir).isDirectory();
+  } catch {
+    return false;
+  }
+}) {
+  if (compilePackages.length === 0) {
+    return [];
+  }
+  const root = path__namespace.resolve(rootDir);
+  const normalizedRoot = root.replace(/\\/g, "/");
+  const found = [];
+  const pending = new Set(compilePackages);
+  let dir = root;
+  while (pending.size > 0) {
+    for (const name of [...pending]) {
+      const candidate = path__namespace.join(dir, "packages", name);
+      const key = candidate.replace(/\\/g, "/");
+      if (key === normalizedRoot || key.startsWith(`${normalizedRoot}/`)) {
+        continue;
+      }
+      if (dirExists(candidate)) {
+        found.push(candidate);
+        pending.delete(name);
+      }
+    }
+    const parent = path__namespace.dirname(dir);
+    if (parent === dir) {
+      break;
+    }
+    dir = parent;
+  }
+  return found;
+}
 function isHardIgnoredPath(id, compilePackages = []) {
   const path2 = id.replace(/\\/g, "/");
   if (path2.includes("node_modules")) {
@@ -2375,6 +2419,12 @@ function createCsszyxPlugins(options = {}) {
     );
   }
   const compilePackages = options.compilePackages ?? [];
+  const quiet = options.quiet === true;
+  function emitWarning(message, opts = {}) {
+    if (shouldEmitWarning(quiet, opts.devOnly ?? false, process.env.NODE_ENV === "production")) {
+      console.warn(message);
+    }
+  }
   const parserOverride = process.env.CSSZYX_PARSER;
   const defaultParser = types.DEFAULT_BUILD_CONFIG.parser ?? "rust";
   const parserMode = parserOverride === "babel" || parserOverride === "oxc" || parserOverride === "rust" ? parserOverride : options.build?.parser ?? defaultParser;
@@ -2740,6 +2790,9 @@ function createCsszyxPlugins(options = {}) {
       }
     }
     scanDir(state.rootDir);
+    for (const pkgDir of resolveCompilePackageDirs(state.rootDir, compilePackages)) {
+      scanDir(pkgDir);
+    }
     for (const { filePath, result } of transformPrescanSources(prescanSources)) {
       if (!result.transformed) {
         continue;
@@ -3038,7 +3091,7 @@ function createCsszyxPlugins(options = {}) {
   ${msg}`);
               }
             }
-            if (result.diagnostics.length > 0 && process.env.NODE_ENV !== "production") {
+            if (!quiet && result.diagnostics.length > 0 && process.env.NODE_ENV !== "production") {
               for (const msg of result.diagnostics) {
                 if (msg.includes("unresolvable sz spread")) continue;
                 this.warn(`[csszyx] ${id}
@@ -3124,7 +3177,7 @@ function createCsszyxPlugins(options = {}) {
         assertNoRSCGraphViolation(state.rscModules);
         if (!state.tailwindWarningEmitted && shouldWarnMissingTailwindEntry(state.ownedClasses.size, state.sawTailwindEntry)) {
           state.tailwindWarningEmitted = true;
-          console.warn(missingTailwindEntryMessage(state.ownedClasses.size));
+          emitWarning(missingTailwindEntryMessage(state.ownedClasses.size));
         }
         if (!state.contentScopeWarningEmitted && options.contentScopeCheck !== false && state.sawTailwindEntry && !state.tailwindEntryScoped) {
           if (state.inMonorepo === void 0) {
@@ -3136,20 +3189,22 @@ function createCsszyxPlugins(options = {}) {
             state.inMonorepo
           )) {
             state.contentScopeWarningEmitted = true;
-            console.warn(unscopedMonorepoMessage());
+            emitWarning(unscopedMonorepoMessage());
           }
         }
         if (!state.skipWarningEmitted && state.skippedSzFiles.size > 0) {
           state.skipWarningEmitted = true;
-          console.warn(skippedSzFilesMessage([...state.skippedSzFiles].sort()));
+          emitWarning(skippedSzFilesMessage([...state.skippedSzFiles].sort()), {
+            devOnly: true
+          });
         }
         if (state.classesCapped) {
-          console.warn(
+          emitWarning(
             `[csszyx] safelist exceeded ${MAX_SAFELIST_CLASSES} classes; additional classes were dropped. This usually means an unbounded set of arbitrary values reached an sz prop.`
           );
         }
         for (const warning of state.spreadWarnings) {
-          console.warn(`[csszyx] ${warning}`);
+          emitWarning(`[csszyx] ${warning}`);
         }
         state.spreadWarnings.clear();
         if (manglingEnabled && Object.keys(state.mangleMap).length > 0) {
@@ -3623,11 +3678,13 @@ exports.normalizeGlobalVarAliasesForCache = normalizeGlobalVarAliasesForCache;
 exports.parseThemeBlocks = parseThemeBlocks;
 exports.planGlobalVarAliases = planGlobalVarAliases;
 exports.readGlobalVarScanCache = readGlobalVarScanCache;
+exports.resolveCompilePackageDirs = resolveCompilePackageDirs;
 exports.resolveGlobalVarScanCacheDir = resolveGlobalVarScanCacheDir;
 exports.resolveNativeCacheIdentity = resolveNativeCacheIdentity;
 exports.rewriteGlobalVarCssAliases = rewriteGlobalVarCssAliases;
 exports.rollupPlugin = rollupPlugin;
 exports.scanGlobalVarCss = scanGlobalVarCss;
+exports.shouldEmitWarning = shouldEmitWarning;
 exports.shouldWarnMissingTailwindEntry = shouldWarnMissingTailwindEntry;
 exports.shouldWarnUnscopedMonorepo = shouldWarnUnscopedMonorepo;
 exports.skippedSzFilesMessage = skippedSzFilesMessage;

package/dist/shared/{unplugin.BqLCtc84.d.cts → unplugin.C369_QDw.d.cts}

@@ -321,6 +321,18 @@ declare function shouldWarnUnscopedMonorepo(sawTailwindEntry: boolean, tailwindE
  * @returns the warning string.
  */
 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.
+ *
+ * @param quiet - The `quiet` option: mute every warning.
+ * @param devOnly - This warning is a dev-only 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;
 /**
  * Whether a `/packages/` file was opted into compilation via `compilePackages`.
  * Matches the package directory name as a path segment (`/packages/<name>/`).
@@ -332,6 +344,24 @@ declare function unscopedMonorepoMessage(): string;
  * @returns true when the file belongs to a listed workspace package.
  */
 declare function isCompilePackageOptedIn(id: string, compilePackages: readonly string[]): boolean;
+/**
+ * Resolve each `compilePackages` name to its absolute `packages/<name>` directory
+ * so the prescan can walk it. The prescan otherwise only walks `rootDir` (the
+ * build cwd, e.g. `apps/web`), so a sibling design-system package's `sz` / `szv`
+ * is never scanned and its classes never reach the safelist — the per-module
+ * transform compiles those files when imported but runs after the safelist is
+ * written. Walk up from `rootDir` looking for an ancestor that has
+ * `packages/<name>`; that mirrors the `/packages/<name>/` segment the opt-in
+ * matches. A directory already inside `rootDir` is skipped — the rootDir walk
+ * already covers it. Returns only existing directories; unresolved names are
+ * silently ignored (a typo surfaces as the usual skipped-`sz` warning).
+ *
+ * @param rootDir - the prescan root (build cwd).
+ * @param compilePackages - workspace package directory names to compile.
+ * @param dirExists - injectable existence check (defaults to a real fs stat).
+ * @returns absolute, deduplicated package directories outside `rootDir`.
+ */
+declare function resolveCompilePackageDirs(rootDir: string, compilePackages: readonly string[], dirExists?: (dir: string) => boolean): string[];
 /**
  * Whether a file lives in a built-in directory csszyx never transforms.
  *
@@ -453,5 +483,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { isPackagesSkippedSource as A, mangleCodeClassesSync as B, missingTailwindEntryMessage as D, normalizeGlobalVarAliasesForCache as E, resolveNativeCacheIdentity as F, rollupPlugin as H, shouldWarnMissingTailwindEntry as I, shouldWarnUnscopedMonorepo as J, skippedSzFilesMessage as K, unscopedMonorepoMessage as L, vitePlugin as M, webpackPlugin as N, appendTailwindSourceDirective as o, computeSafelistRelPath as p, createGlobalVarMapAssetSource as q, cssHasContentScope as r, cssImportsTailwind as s, esbuildPlugin as t, unplugin as u, extractGlobalVarAliasesForManifest as v, hasInjectableTailwindCandidate as w, isCompilePackageOptedIn as x, isHardIgnoredPath as y, isMonorepoPackage as z };
+export { isPackagesSkippedSource as A, mangleCodeClassesSync as B, missingTailwindEntryMessage as D, normalizeGlobalVarAliasesForCache as E, resolveCompilePackageDirs as F, resolveNativeCacheIdentity as H, rollupPlugin as I, shouldEmitWarning as J, shouldWarnMissingTailwindEntry as K, shouldWarnUnscopedMonorepo as L, skippedSzFilesMessage as M, unscopedMonorepoMessage as N, vitePlugin as O, webpackPlugin as Q, appendTailwindSourceDirective as o, computeSafelistRelPath as p, createGlobalVarMapAssetSource as q, cssHasContentScope as r, cssImportsTailwind as s, esbuildPlugin as t, unplugin as u, extractGlobalVarAliasesForManifest as v, hasInjectableTailwindCandidate as w, isCompilePackageOptedIn as x, isHardIgnoredPath as y, isMonorepoPackage as z };
 export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, 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 };

package/dist/shared/{unplugin.BqLCtc84.d.mts → unplugin.C369_QDw.d.mts}

@@ -321,6 +321,18 @@ declare function shouldWarnUnscopedMonorepo(sawTailwindEntry: boolean, tailwindE
  * @returns the warning string.
  */
 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.
+ *
+ * @param quiet - The `quiet` option: mute every warning.
+ * @param devOnly - This warning is a dev-only 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;
 /**
  * Whether a `/packages/` file was opted into compilation via `compilePackages`.
  * Matches the package directory name as a path segment (`/packages/<name>/`).
@@ -332,6 +344,24 @@ declare function unscopedMonorepoMessage(): string;
  * @returns true when the file belongs to a listed workspace package.
  */
 declare function isCompilePackageOptedIn(id: string, compilePackages: readonly string[]): boolean;
+/**
+ * Resolve each `compilePackages` name to its absolute `packages/<name>` directory
+ * so the prescan can walk it. The prescan otherwise only walks `rootDir` (the
+ * build cwd, e.g. `apps/web`), so a sibling design-system package's `sz` / `szv`
+ * is never scanned and its classes never reach the safelist — the per-module
+ * transform compiles those files when imported but runs after the safelist is
+ * written. Walk up from `rootDir` looking for an ancestor that has
+ * `packages/<name>`; that mirrors the `/packages/<name>/` segment the opt-in
+ * matches. A directory already inside `rootDir` is skipped — the rootDir walk
+ * already covers it. Returns only existing directories; unresolved names are
+ * silently ignored (a typo surfaces as the usual skipped-`sz` warning).
+ *
+ * @param rootDir - the prescan root (build cwd).
+ * @param compilePackages - workspace package directory names to compile.
+ * @param dirExists - injectable existence check (defaults to a real fs stat).
+ * @returns absolute, deduplicated package directories outside `rootDir`.
+ */
+declare function resolveCompilePackageDirs(rootDir: string, compilePackages: readonly string[], dirExists?: (dir: string) => boolean): string[];
 /**
  * Whether a file lives in a built-in directory csszyx never transforms.
  *
@@ -453,5 +483,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { isPackagesSkippedSource as A, mangleCodeClassesSync as B, missingTailwindEntryMessage as D, normalizeGlobalVarAliasesForCache as E, resolveNativeCacheIdentity as F, rollupPlugin as H, shouldWarnMissingTailwindEntry as I, shouldWarnUnscopedMonorepo as J, skippedSzFilesMessage as K, unscopedMonorepoMessage as L, vitePlugin as M, webpackPlugin as N, appendTailwindSourceDirective as o, computeSafelistRelPath as p, createGlobalVarMapAssetSource as q, cssHasContentScope as r, cssImportsTailwind as s, esbuildPlugin as t, unplugin as u, extractGlobalVarAliasesForManifest as v, hasInjectableTailwindCandidate as w, isCompilePackageOptedIn as x, isHardIgnoredPath as y, isMonorepoPackage as z };
+export { isPackagesSkippedSource as A, mangleCodeClassesSync as B, missingTailwindEntryMessage as D, normalizeGlobalVarAliasesForCache as E, resolveCompilePackageDirs as F, resolveNativeCacheIdentity as H, rollupPlugin as I, shouldEmitWarning as J, shouldWarnMissingTailwindEntry as K, shouldWarnUnscopedMonorepo as L, skippedSzFilesMessage as M, unscopedMonorepoMessage as N, vitePlugin as O, webpackPlugin as Q, appendTailwindSourceDirective as o, computeSafelistRelPath as p, createGlobalVarMapAssetSource as q, cssHasContentScope as r, cssImportsTailwind as s, esbuildPlugin as t, unplugin as u, extractGlobalVarAliasesForManifest as v, hasInjectableTailwindCandidate as w, isCompilePackageOptedIn as x, isHardIgnoredPath as y, isMonorepoPackage as z };
 export type { CssVarScanResult as C, GlobalVarScanCacheKeyInput as G, 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 };

package/dist/shared/{unplugin.CLXpKBe4.mjs → unplugin.ZUVKukQo.mjs}

@@ -1683,6 +1683,15 @@ function shouldWarnUnscopedMonorepo(sawTailwindEntry, tailwindEntryScoped, inMon
 function unscopedMonorepoMessage() {
   return '[csszyx] Tailwind content detection is UNSCOPED in a monorepo. Tailwind v4 climbs to the workspace root and scans sibling packages + docs (.md/.mdx/.txt are not ignored), which can generate phantom or broken url() classes and fail the build. Scope it in your Tailwind CSS entry:\n    @import "tailwindcss" source(none);\n    @source ".";   /* this package, relative to the CSS file */\ncsszyx auto-injects @source for its generated classes, so only your own templates need listing. Guide: https://csszyx.com/docs/monorepo-content-scope/\nSilence (if a broad scan is intentional): csszyx({ contentScopeCheck: false }).';
 }
+function shouldEmitWarning(quiet, devOnly, isProduction) {
+  if (quiet) {
+    return false;
+  }
+  if (devOnly && isProduction) {
+    return false;
+  }
+  return true;
+}
 function isCompilePackageOptedIn(id, compilePackages) {
   const path2 = id.replace(/\\/g, "/");
   if (path2.includes("node_modules")) {
@@ -1690,6 +1699,41 @@ function isCompilePackageOptedIn(id, compilePackages) {
   }
   return compilePackages.some((name) => path2.includes(`/packages/${name}/`));
 }
+function resolveCompilePackageDirs(rootDir, compilePackages, dirExists = (dir) => {
+  try {
+    return fs.statSync(dir).isDirectory();
+  } catch {
+    return false;
+  }
+}) {
+  if (compilePackages.length === 0) {
+    return [];
+  }
+  const root = path.resolve(rootDir);
+  const normalizedRoot = root.replace(/\\/g, "/");
+  const found = [];
+  const pending = new Set(compilePackages);
+  let dir = root;
+  while (pending.size > 0) {
+    for (const name of [...pending]) {
+      const candidate = path.join(dir, "packages", name);
+      const key = candidate.replace(/\\/g, "/");
+      if (key === normalizedRoot || key.startsWith(`${normalizedRoot}/`)) {
+        continue;
+      }
+      if (dirExists(candidate)) {
+        found.push(candidate);
+        pending.delete(name);
+      }
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) {
+      break;
+    }
+    dir = parent;
+  }
+  return found;
+}
 function isHardIgnoredPath(id, compilePackages = []) {
   const path2 = id.replace(/\\/g, "/");
   if (path2.includes("node_modules")) {
@@ -2355,6 +2399,12 @@ function createCsszyxPlugins(options = {}) {
     );
   }
   const compilePackages = options.compilePackages ?? [];
+  const quiet = options.quiet === true;
+  function emitWarning(message, opts = {}) {
+    if (shouldEmitWarning(quiet, opts.devOnly ?? false, process.env.NODE_ENV === "production")) {
+      console.warn(message);
+    }
+  }
   const parserOverride = process.env.CSSZYX_PARSER;
   const defaultParser = DEFAULT_BUILD_CONFIG.parser ?? "rust";
   const parserMode = parserOverride === "babel" || parserOverride === "oxc" || parserOverride === "rust" ? parserOverride : options.build?.parser ?? defaultParser;
@@ -2720,6 +2770,9 @@ function createCsszyxPlugins(options = {}) {
       }
     }
     scanDir(state.rootDir);
+    for (const pkgDir of resolveCompilePackageDirs(state.rootDir, compilePackages)) {
+      scanDir(pkgDir);
+    }
     for (const { filePath, result } of transformPrescanSources(prescanSources)) {
       if (!result.transformed) {
         continue;
@@ -3018,7 +3071,7 @@ function createCsszyxPlugins(options = {}) {
   ${msg}`);
               }
             }
-            if (result.diagnostics.length > 0 && process.env.NODE_ENV !== "production") {
+            if (!quiet && result.diagnostics.length > 0 && process.env.NODE_ENV !== "production") {
               for (const msg of result.diagnostics) {
                 if (msg.includes("unresolvable sz spread")) continue;
                 this.warn(`[csszyx] ${id}
@@ -3104,7 +3157,7 @@ function createCsszyxPlugins(options = {}) {
         assertNoRSCGraphViolation(state.rscModules);
         if (!state.tailwindWarningEmitted && shouldWarnMissingTailwindEntry(state.ownedClasses.size, state.sawTailwindEntry)) {
           state.tailwindWarningEmitted = true;
-          console.warn(missingTailwindEntryMessage(state.ownedClasses.size));
+          emitWarning(missingTailwindEntryMessage(state.ownedClasses.size));
         }
         if (!state.contentScopeWarningEmitted && options.contentScopeCheck !== false && state.sawTailwindEntry && !state.tailwindEntryScoped) {
           if (state.inMonorepo === void 0) {
@@ -3116,20 +3169,22 @@ function createCsszyxPlugins(options = {}) {
             state.inMonorepo
           )) {
             state.contentScopeWarningEmitted = true;
-            console.warn(unscopedMonorepoMessage());
+            emitWarning(unscopedMonorepoMessage());
           }
         }
         if (!state.skipWarningEmitted && state.skippedSzFiles.size > 0) {
           state.skipWarningEmitted = true;
-          console.warn(skippedSzFilesMessage([...state.skippedSzFiles].sort()));
+          emitWarning(skippedSzFilesMessage([...state.skippedSzFiles].sort()), {
+            devOnly: true
+          });
         }
         if (state.classesCapped) {
-          console.warn(
+          emitWarning(
             `[csszyx] safelist exceeded ${MAX_SAFELIST_CLASSES} classes; additional classes were dropped. This usually means an unbounded set of arbitrary values reached an sz prop.`
           );
         }
         for (const warning of state.spreadWarnings) {
-          console.warn(`[csszyx] ${warning}`);
+          emitWarning(`[csszyx] ${warning}`);
         }
         state.spreadWarnings.clear();
         if (manglingEnabled && Object.keys(state.mangleMap).length > 0) {
@@ -3571,4 +3626,4 @@ const esbuildPlugin = (options = {}) => {
   };
 };
 
-export { mangleCodeClassesSync as A, mergeThemes as B, missingTailwindEntryMessage as C, normalizeGlobalVarAliasesForCache as D, parseThemeBlocks as E, planGlobalVarAliases as F, readGlobalVarScanCache as G, resolveGlobalVarScanCacheDir as H, resolveNativeCacheIdentity as I, rewriteGlobalVarCssAliases as J, rollupPlugin as K, scanGlobalVarCss as L, shouldWarnMissingTailwindEntry as M, shouldWarnUnscopedMonorepo as N, skippedSzFilesMessage as O, unscopedMonorepoMessage as P, validateGlobalVarAliasInputs as Q, vitePlugin as R, webpackPlugin as S, writeGlobalVarScanCache as T, appendTailwindSourceDirective as a, assertNoRSCBoundaryViolation as b, assertNoRSCGraphViolation as c, computeSafelistRelPath as d, createGlobalVarAliasValidationOptions as e, createGlobalVarMapAssetSource as f, createGlobalVarScanCacheKey as g, createRSCModuleRecord as h, cssHasContentScope as i, cssImportsTailwind as j, deleteRSCModuleRecord as k, esbuildPlugin as l, extractGlobalVarAliasesForManifest as m, findRSCBoundaryViolation as n, findRSCGraphViolation as o, hasInjectableTailwindCandidate as p, hasTokens as q, hasUseClientDirective as r, hasUseServerDirective as s, isCompilePackageOptedIn as t, unplugin as u, isHardIgnoredPath as v, isMonorepoPackage as w, isPackagesSkippedSource as x, isRSCServerModule as y, isTailwindReservedGlobalVar as z };
+export { mangleCodeClassesSync as A, mergeThemes as B, missingTailwindEntryMessage as C, normalizeGlobalVarAliasesForCache as D, parseThemeBlocks as E, planGlobalVarAliases as F, readGlobalVarScanCache as G, resolveCompilePackageDirs as H, resolveGlobalVarScanCacheDir as I, resolveNativeCacheIdentity as J, rewriteGlobalVarCssAliases as K, rollupPlugin as L, scanGlobalVarCss as M, shouldEmitWarning as N, shouldWarnMissingTailwindEntry as O, shouldWarnUnscopedMonorepo as P, skippedSzFilesMessage as Q, unscopedMonorepoMessage as R, validateGlobalVarAliasInputs as S, vitePlugin as T, webpackPlugin as U, writeGlobalVarScanCache as V, appendTailwindSourceDirective as a, assertNoRSCBoundaryViolation as b, assertNoRSCGraphViolation as c, computeSafelistRelPath as d, createGlobalVarAliasValidationOptions as e, createGlobalVarMapAssetSource as f, createGlobalVarScanCacheKey as g, createRSCModuleRecord as h, cssHasContentScope as i, cssImportsTailwind as j, deleteRSCModuleRecord as k, esbuildPlugin as l, extractGlobalVarAliasesForManifest as m, findRSCBoundaryViolation as n, findRSCGraphViolation as o, hasInjectableTailwindCandidate as p, hasTokens as q, hasUseClientDirective as r, hasUseServerDirective as s, isCompilePackageOptedIn as t, unplugin as u, isHardIgnoredPath as v, isMonorepoPackage as w, isPackagesSkippedSource as x, isRSCServerModule as y, isTailwindReservedGlobalVar as z };

package/dist/vite.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-const unplugin = require('./shared/unplugin.Dk6ddrZX.cjs');
+const unplugin = require('./shared/unplugin.B6W7JChH.cjs');
 require('node:fs');
 require('node:module');
 require('node:path');

package/dist/vite.d.cts

@@ -1,4 +1,4 @@
-import { M as vitePlugin } from './shared/unplugin.BqLCtc84.cjs';
+import { O as vitePlugin } from './shared/unplugin.C369_QDw.cjs';
 import '@csszyx/compiler';
 import '@csszyx/types';
 import 'esbuild';

package/dist/vite.d.mts

@@ -1,4 +1,4 @@
-import { M as vitePlugin } from './shared/unplugin.BqLCtc84.mjs';
+import { O as vitePlugin } from './shared/unplugin.C369_QDw.mjs';
 import '@csszyx/compiler';
 import '@csszyx/types';
 import 'esbuild';

package/dist/vite.mjs

@@ -1,4 +1,4 @@
-import { R as vitePlugin } from './shared/unplugin.CLXpKBe4.mjs';
+import { T as vitePlugin } from './shared/unplugin.ZUVKukQo.mjs';
 import 'node:fs';
 import 'node:module';
 import 'node:path';

package/dist/webpack.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-const unplugin = require('./shared/unplugin.Dk6ddrZX.cjs');
+const unplugin = require('./shared/unplugin.B6W7JChH.cjs');
 require('node:fs');
 require('node:module');
 require('node:path');

package/dist/webpack.d.cts

@@ -1,4 +1,4 @@
-import { N as webpackPlugin } from './shared/unplugin.BqLCtc84.cjs';
+import { Q as webpackPlugin } from './shared/unplugin.C369_QDw.cjs';
 import '@csszyx/compiler';
 import '@csszyx/types';
 import 'esbuild';

package/dist/webpack.d.mts

@@ -1,4 +1,4 @@
-import { N as webpackPlugin } from './shared/unplugin.BqLCtc84.mjs';
+import { Q as webpackPlugin } from './shared/unplugin.C369_QDw.mjs';
 import '@csszyx/compiler';
 import '@csszyx/types';
 import 'esbuild';

package/dist/webpack.mjs

@@ -1,4 +1,4 @@
-import { S as webpackPlugin } from './shared/unplugin.CLXpKBe4.mjs';
+import { U as webpackPlugin } from './shared/unplugin.ZUVKukQo.mjs';
 import 'node:fs';
 import 'node:module';
 import 'node:path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/unplugin",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Vite and Webpack integration for csszyx",
   "keywords": [
     "csszyx",
@@ -117,14 +117,14 @@
     "postcss-value-parser": "^4.2.0",
     "proper-lockfile": "^4.1.2",
     "unplugin": "^1.10.1",
-    "@csszyx/compiler": "0.10.0",
-    "@csszyx/svelte-adapter": "0.10.0",
-    "@csszyx/core": "0.10.0",
-    "@csszyx/types": "0.10.0",
-    "@csszyx/vue-adapter": "0.10.0"
+    "@csszyx/compiler": "0.10.2",
+    "@csszyx/core": "0.10.2",
+    "@csszyx/svelte-adapter": "0.10.2",
+    "@csszyx/vue-adapter": "0.10.2",
+    "@csszyx/types": "0.10.2"
   },
   "peerDependencies": {
-    "@csszyx/runtime": "^0.10.0"
+    "@csszyx/runtime": "^0.10.2"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",