@csszyx/unplugin 0.9.10 → 0.10.1

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.BT-U5kd1.cjs');
+const unplugin = require('./shared/unplugin.Dk6ddrZX.cjs');
 const types = require('@csszyx/types');
 require('postcss');
 require('postcss-selector-parser');
@@ -18,6 +18,7 @@ require('@csszyx/core/native');
 require('@csszyx/svelte-adapter');
 require('@csszyx/vue-adapter');
 require('unplugin');
+require('./shared/unplugin.DoBHTRra.cjs');
 require('node:crypto');
 require('./shared/unplugin.pmTknYLy.cjs');
 require('postcss-value-parser');
@@ -29,25 +30,35 @@ exports.escapeCSSClassName = cssMangler.escapeCSSClassName;
 exports.mangleCSS = cssMangler.mangleCSS;
 exports.mangleCSSSync = cssMangler.mangleCSSSync;
 exports.unescapeTailwindClass = cssMangler.unescapeTailwindClass;
+exports.appendTailwindSourceDirective = unplugin.appendTailwindSourceDirective;
 exports.assertNoRSCBoundaryViolation = unplugin.assertNoRSCBoundaryViolation;
 exports.assertNoRSCGraphViolation = unplugin.assertNoRSCGraphViolation;
+exports.computeSafelistRelPath = unplugin.computeSafelistRelPath;
 exports.createGlobalVarAliasValidationOptions = unplugin.createGlobalVarAliasValidationOptions;
 exports.createGlobalVarMapAssetSource = unplugin.createGlobalVarMapAssetSource;
 exports.createGlobalVarScanCacheKey = unplugin.createGlobalVarScanCacheKey;
 exports.createRSCModuleRecord = unplugin.createRSCModuleRecord;
+exports.cssHasContentScope = unplugin.cssHasContentScope;
+exports.cssImportsTailwind = unplugin.cssImportsTailwind;
 exports.default = unplugin.unplugin;
 exports.deleteRSCModuleRecord = unplugin.deleteRSCModuleRecord;
 exports.esbuildPlugin = unplugin.esbuildPlugin;
 exports.extractGlobalVarAliasesForManifest = unplugin.extractGlobalVarAliasesForManifest;
 exports.findRSCBoundaryViolation = unplugin.findRSCBoundaryViolation;
 exports.findRSCGraphViolation = unplugin.findRSCGraphViolation;
+exports.hasInjectableTailwindCandidate = unplugin.hasInjectableTailwindCandidate;
 exports.hasTokens = unplugin.hasTokens;
 exports.hasUseClientDirective = unplugin.hasUseClientDirective;
 exports.hasUseServerDirective = unplugin.hasUseServerDirective;
+exports.isCompilePackageOptedIn = unplugin.isCompilePackageOptedIn;
+exports.isHardIgnoredPath = unplugin.isHardIgnoredPath;
+exports.isMonorepoPackage = unplugin.isMonorepoPackage;
+exports.isPackagesSkippedSource = unplugin.isPackagesSkippedSource;
 exports.isRSCServerModule = unplugin.isRSCServerModule;
 exports.isTailwindReservedGlobalVar = unplugin.isTailwindReservedGlobalVar;
 exports.mangleCodeClassesSync = unplugin.mangleCodeClassesSync;
 exports.mergeThemes = unplugin.mergeThemes;
+exports.missingTailwindEntryMessage = unplugin.missingTailwindEntryMessage;
 exports.normalizeGlobalVarAliasesForCache = unplugin.normalizeGlobalVarAliasesForCache;
 exports.parseThemeBlocks = unplugin.parseThemeBlocks;
 exports.planGlobalVarAliases = unplugin.planGlobalVarAliases;
@@ -57,7 +68,11 @@ exports.resolveNativeCacheIdentity = unplugin.resolveNativeCacheIdentity;
 exports.rewriteGlobalVarCssAliases = unplugin.rewriteGlobalVarCssAliases;
 exports.rollupPlugin = unplugin.rollupPlugin;
 exports.scanGlobalVarCss = unplugin.scanGlobalVarCss;
+exports.shouldWarnMissingTailwindEntry = unplugin.shouldWarnMissingTailwindEntry;
+exports.shouldWarnUnscopedMonorepo = unplugin.shouldWarnUnscopedMonorepo;
+exports.skippedSzFilesMessage = unplugin.skippedSzFilesMessage;
 exports.unplugin = unplugin.unplugin;
+exports.unscopedMonorepoMessage = unplugin.unscopedMonorepoMessage;
 exports.validateGlobalVarAliasInputs = unplugin.validateGlobalVarAliasInputs;
 exports.vitePlugin = unplugin.vitePlugin;
 exports.webpackPlugin = unplugin.webpackPlugin;

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.CMNZChGZ.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.BqLCtc84.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 createGlobalVarMapAssetSource, p as esbuildPlugin, q as extractGlobalVarAliasesForManifest, r as mangleCodeClassesSync, s as normalizeGlobalVarAliasesForCache, t as resolveNativeCacheIdentity, v as rollupPlugin, u as unplugin, w as vitePlugin, x as webpackPlugin } from './shared/unplugin.CMNZChGZ.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 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';
 import 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';
@@ -225,6 +225,8 @@ interface ParsedTheme {
     radii: string[];
     /** Custom shadows (from --shadow-*): e.g. ['card'] */
     shadows: string[];
+    /** Custom responsive breakpoints (from --breakpoint-*): e.g. ['tablet', '3xl'] */
+    breakpoints: string[];
 }
 /**
  * Parse all @theme blocks in a CSS file and extract design tokens.

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.CMNZChGZ.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 createGlobalVarMapAssetSource, u as default, p as esbuildPlugin, q as extractGlobalVarAliasesForManifest, r as mangleCodeClassesSync, s as normalizeGlobalVarAliasesForCache, t as resolveNativeCacheIdentity, v as rollupPlugin, u as unplugin, w as vitePlugin, x as webpackPlugin } from './shared/unplugin.CMNZChGZ.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.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 'postcss';
 import '@csszyx/compiler';
 import 'esbuild';
@@ -223,6 +223,8 @@ interface ParsedTheme {
     radii: string[];
     /** Custom shadows (from --shadow-*): e.g. ['card'] */
     shadows: string[];
+    /** Custom responsive breakpoints (from --breakpoint-*): e.g. ['tablet', '3xl'] */
+    breakpoints: string[];
 }
 /**
  * Parse all @theme blocks in a CSS file and extract design tokens.

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
-export { a as assertNoRSCBoundaryViolation, b as assertNoRSCGraphViolation, c as createGlobalVarAliasValidationOptions, d as createGlobalVarMapAssetSource, e as createGlobalVarScanCacheKey, f as createRSCModuleRecord, u as default, g as deleteRSCModuleRecord, h as esbuildPlugin, i as extractGlobalVarAliasesForManifest, j as findRSCBoundaryViolation, k as findRSCGraphViolation, l as hasTokens, m as hasUseClientDirective, n as hasUseServerDirective, o as isRSCServerModule, p as isTailwindReservedGlobalVar, q as mangleCodeClassesSync, r as mergeThemes, s as normalizeGlobalVarAliasesForCache, t as parseThemeBlocks, v as planGlobalVarAliases, w as readGlobalVarScanCache, x as resolveGlobalVarScanCacheDir, y as resolveNativeCacheIdentity, z as rewriteGlobalVarCssAliases, A as rollupPlugin, B as scanGlobalVarCss, u as unplugin, C as validateGlobalVarAliasInputs, D as vitePlugin, E as webpackPlugin, F as writeGlobalVarScanCache } from './shared/unplugin.jEasXLFM.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 { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
 import 'postcss';
 import 'postcss-selector-parser';
@@ -14,6 +14,7 @@ import '@csszyx/core/native';
 import '@csszyx/svelte-adapter';
 import '@csszyx/vue-adapter';
 import 'unplugin';
+import './shared/unplugin.3UumZ5gn.mjs';
 import 'node:crypto';
 import './shared/unplugin.BpWUtI9U.mjs';
 import 'postcss-value-parser';

package/dist/next-prebuild.cjs

@@ -4,11 +4,12 @@ const node_crypto = require('node:crypto');
 const fs = require('node:fs');
 const path = require('node:path');
 const nextTransformMetadata = require('./shared/unplugin.DWtXPCGo.cjs');
-const nextWatcherCycle = require('./shared/unplugin.Bo6Kx-T6.cjs');
+const nextWatcherCycle = require('./shared/unplugin.Cwe-dz1f.cjs');
 const transformCache = require('./shared/unplugin.pmTknYLy.cjs');
 require('@csszyx/compiler');
 require('node:os');
 require('proper-lockfile');
+require('./shared/unplugin.DoBHTRra.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopNamespaceCompat(e) {

package/dist/next-prebuild.mjs

@@ -2,11 +2,12 @@ import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
 import * as path from 'node:path';
 import { r as readPackageVersion, t as transformNextSource, c as collectNextTransformMetadata, a as createNextSafelistShardFromMetadata } from './shared/unplugin.C1N5i6Eg.mjs';
-import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle } from './shared/unplugin.VAel6lI0.mjs';
+import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle } from './shared/unplugin.CLjhn81z.mjs';
 import { r as resolveTransformCacheDir } from './shared/unplugin.BpWUtI9U.mjs';
 import '@csszyx/compiler';
 import 'node:os';
 import 'proper-lockfile';
+import './shared/unplugin.3UumZ5gn.mjs';
 
 function runNextPrebuild(options) {
   assertProductionManglingBoundary(options);

package/dist/next-turbo-loader.cjs

@@ -4,12 +4,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 const node_crypto = require('node:crypto');
 const path = require('node:path');
-const nextWatcherCycle = require('./shared/unplugin.Bo6Kx-T6.cjs');
+const nextWatcherCycle = require('./shared/unplugin.Cwe-dz1f.cjs');
 const nextTransformMetadata = require('./shared/unplugin.DWtXPCGo.cjs');
 const transformCache = require('./shared/unplugin.pmTknYLy.cjs');
 require('node:fs');
 require('node:os');
 require('proper-lockfile');
+require('./shared/unplugin.DoBHTRra.cjs');
 require('@csszyx/compiler');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;

package/dist/next-turbo-loader.mjs

@@ -1,11 +1,12 @@
 import { createHash } from 'node:crypto';
 import * as path from 'node:path';
-import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle, v as validateNextGenerationManifest, a as readNextGenerationManifest } from './shared/unplugin.VAel6lI0.mjs';
+import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle, v as validateNextGenerationManifest, a as readNextGenerationManifest } from './shared/unplugin.CLjhn81z.mjs';
 import { r as readPackageVersion, t as transformNextSource, c as collectNextTransformMetadata, a as createNextSafelistShardFromMetadata } from './shared/unplugin.C1N5i6Eg.mjs';
 import { r as resolveTransformCacheDir } from './shared/unplugin.BpWUtI9U.mjs';
 import 'node:fs';
 import 'node:os';
 import 'proper-lockfile';
+import './shared/unplugin.3UumZ5gn.mjs';
 import '@csszyx/compiler';
 
 const DIRECTIVE_PROLOGUE_PREFIX_RE = /^((?:\s|\/\/[^\n]*\n|\/\*(?:[^*]|\*(?!\/))*\*\/)*)(['"]use (?:client|server)['"];?\s*)/;

package/dist/next-watcher.cjs

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

package/dist/next-watcher.mjs

@@ -1,9 +1,10 @@
 import * as path from 'node:path';
-import { r as runNextWatcherCycle } from './shared/unplugin.VAel6lI0.mjs';
+import { r as runNextWatcherCycle } from './shared/unplugin.CLjhn81z.mjs';
 import 'node:fs';
 import 'node:crypto';
 import 'node:os';
 import 'proper-lockfile';
+import './shared/unplugin.3UumZ5gn.mjs';
 
 class NextWatcherLoop {
   context;

package/dist/shared/unplugin.3UumZ5gn.mjs

@@ -0,0 +1,5 @@
+function escapeHtmlAttribute(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+export { escapeHtmlAttribute as e };

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

@@ -220,6 +220,168 @@ interface GlobalVarCssAliasRewriteResult {
  * @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
+ * starting with a letter, which excludes pure mangled symbols.
+ *
+ * @param classes - the discovered class set.
+ * @returns true if any class is an injectable candidate.
+ */
+declare function hasInjectableTailwindCandidate(classes: Iterable<string>): boolean;
+/**
+ * Whether to warn that csszyx generated classes Tailwind will not emit CSS for.
+ * Fires only when csszyx owns at least one generated class AND no processed CSS
+ * imported tailwindcss — i.e. nothing makes Tailwind scan the generated classes.
+ *
+ * @param ownedClassCount - number of csszyx-generated classes this build produced.
+ * @param sawTailwindEntry - whether any processed CSS imported tailwindcss.
+ * @returns true when the missing-entry warning should fire.
+ */
+declare function shouldWarnMissingTailwindEntry(ownedClassCount: number, sawTailwindEntry: boolean): boolean;
+/**
+ * Build the missing-Tailwind-entry warning message.
+ * @param ownedClassCount - number of csszyx-generated classes this build produced.
+ * @returns the warning string.
+ */
+declare function missingTailwindEntryMessage(ownedClassCount: number): string;
+/**
+ * Whether a CSS module scopes Tailwind's content detection — `source(none)` or
+ * `source("…")` on the `@import "tailwindcss"`, or any `@source not` exclusion.
+ * A plain additive `@source "…"` does NOT count: it only adds a path, it does
+ * not stop the automatic climb-to-the-workspace-root scan. Block comments are
+ * stripped first so a commented-out directive does not count.
+ *
+ * @param code - CSS module source.
+ * @returns true when the entry scopes (or excludes from) content detection.
+ */
+declare function cssHasContentScope(code: string): boolean;
+/**
+ * Whether `root` is a package INSIDE a monorepo — an ancestor directory is a
+ * workspace root (`pnpm-workspace.yaml`, a `package.json` with a `workspaces`
+ * field, or an nx/lerna marker). In that case Tailwind v4 automatic content
+ * detection would otherwise climb to the workspace root. Synchronous and cheap
+ * (a handful of stat calls up the tree); intended to be memoized per build.
+ * Mirrors `isInsideWorkspace` in the CLI's `init` command.
+ *
+ * @param root - the project/package root directory.
+ * @returns true when an ancestor is a workspace root.
+ */
+declare function isMonorepoPackage(root: string): boolean;
+/**
+ * Whether to warn that Tailwind content detection is unscoped in a monorepo.
+ * Fires only when a Tailwind entry exists, it is NOT scoped, and this package
+ * sits inside a workspace — the exact condition that makes Tailwind scan the
+ * whole repo and emit phantom/broken classes.
+ *
+ * @param sawTailwindEntry - whether any processed CSS imported tailwindcss.
+ * @param tailwindEntryScoped - whether a Tailwind entry scoped its detection.
+ * @param inMonorepo - whether this package sits inside a workspace.
+ * @returns true when the unscoped-monorepo warning should fire.
+ */
+declare function shouldWarnUnscopedMonorepo(sawTailwindEntry: boolean, tailwindEntryScoped: boolean, inMonorepo: boolean): boolean;
+/**
+ * Build the unscoped-monorepo warning message: what is wrong, why it matters,
+ * the exact two-line fix, the guide link, and how to silence it.
+ * @returns the warning string.
+ */
+declare function unscopedMonorepoMessage(): string;
+/**
+ * Whether a `/packages/` file was opted into compilation via `compilePackages`.
+ * Matches the package directory name as a path segment (`/packages/<name>/`).
+ * `node_modules` is never opted in — real dependencies must not be compiled even
+ * if a dependency happens to share a name with a listed workspace package.
+ *
+ * @param id - bundler file id or filesystem path (Windows backslashes accepted).
+ * @param compilePackages - workspace package directory names to compile.
+ * @returns true when the file belongs to a listed workspace package.
+ */
+declare function isCompilePackageOptedIn(id: string, compilePackages: readonly string[]): boolean;
+/**
+ * Whether a file lives in a built-in directory csszyx never transforms.
+ *
+ * `node_modules` and `.next` (non-static) are always ignored. `/packages/` is
+ * ignored by default — published libraries ship pre-extracted CSS — but is
+ * relaxed for packages listed in `compilePackages`, so a monorepo can author
+ * `sz` in workspace source. Pulled out as a pure function so the precedence
+ * (node_modules/.next stay hard regardless of `compilePackages`) is unit-tested.
+ *
+ * @param id - bundler file id or filesystem path.
+ * @param compilePackages - workspace package directory names to compile.
+ * @returns true when the file should be skipped regardless of user filters.
+ */
+declare function isHardIgnoredPath(id: string, compilePackages?: readonly string[]): boolean;
+/**
+ * Whether a file is workspace-package source that csszyx skipped only because it
+ * lives under `/packages/` and was not opted into `compilePackages`. Used to
+ * surface the silent no-op (skipped `sz` produces no CSS). `node_modules` and
+ * `.next` are excluded — those are never workspace source the developer authors,
+ * and scanning `node_modules` for `sz` would be slow and false-positive-prone.
+ *
+ * @param id - filesystem path of the skipped file.
+ * @param compilePackages - workspace package directory names already opted in.
+ * @returns true when the skip is a workspace-package `sz` skip worth warning on.
+ */
+declare function isPackagesSkippedSource(id: string, compilePackages?: readonly string[]): boolean;
+/**
+ * Build the workspace-package skip warning. Lists the skipped files that contain
+ * `sz` so the developer can opt the package into `compilePackages` instead of
+ * silently shipping no CSS for them.
+ *
+ * @param files - skipped `/packages/` file paths that contain `sz`.
+ * @returns the warning string.
+ */
+declare function skippedSzFilesMessage(files: 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
+ * `./`- 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;
 /**
  * Extracts Phase H global custom-property aliases for manifest/debug tooling.
  *
@@ -258,7 +420,7 @@ declare function normalizeGlobalVarAliasesForCache(aliases: TransformSourceCodeO
  * Pass 1:   Direct `className="..."` / `class="..."` static strings
  * Pass 1.5: Template literal quasi (static) segments in `className:\`...\``
  * Pass 2:   `className:EXPR` patterns with ternary operators containing quoted strings
- * Pass 3:   Quoted string arguments to csszyx runtime helpers (_szMerge, _szIf, etc.)
+ * Pass 3:   Quoted string arguments to csszyx runtime helpers (_szMerge, _sz, etc.)
  *
  * @param code     bundled source code
  * @param mangleMap class-name → mangled-token mapping
@@ -291,5 +453,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { createGlobalVarMapAssetSource as o, esbuildPlugin as p, extractGlobalVarAliasesForManifest as q, mangleCodeClassesSync as r, normalizeGlobalVarAliasesForCache as s, resolveNativeCacheIdentity as t, unplugin as u, rollupPlugin as v, vitePlugin as w, webpackPlugin as x };
+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 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.CMNZChGZ.d.mts → unplugin.BqLCtc84.d.mts}

@@ -220,6 +220,168 @@ interface GlobalVarCssAliasRewriteResult {
  * @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
+ * starting with a letter, which excludes pure mangled symbols.
+ *
+ * @param classes - the discovered class set.
+ * @returns true if any class is an injectable candidate.
+ */
+declare function hasInjectableTailwindCandidate(classes: Iterable<string>): boolean;
+/**
+ * Whether to warn that csszyx generated classes Tailwind will not emit CSS for.
+ * Fires only when csszyx owns at least one generated class AND no processed CSS
+ * imported tailwindcss — i.e. nothing makes Tailwind scan the generated classes.
+ *
+ * @param ownedClassCount - number of csszyx-generated classes this build produced.
+ * @param sawTailwindEntry - whether any processed CSS imported tailwindcss.
+ * @returns true when the missing-entry warning should fire.
+ */
+declare function shouldWarnMissingTailwindEntry(ownedClassCount: number, sawTailwindEntry: boolean): boolean;
+/**
+ * Build the missing-Tailwind-entry warning message.
+ * @param ownedClassCount - number of csszyx-generated classes this build produced.
+ * @returns the warning string.
+ */
+declare function missingTailwindEntryMessage(ownedClassCount: number): string;
+/**
+ * Whether a CSS module scopes Tailwind's content detection — `source(none)` or
+ * `source("…")` on the `@import "tailwindcss"`, or any `@source not` exclusion.
+ * A plain additive `@source "…"` does NOT count: it only adds a path, it does
+ * not stop the automatic climb-to-the-workspace-root scan. Block comments are
+ * stripped first so a commented-out directive does not count.
+ *
+ * @param code - CSS module source.
+ * @returns true when the entry scopes (or excludes from) content detection.
+ */
+declare function cssHasContentScope(code: string): boolean;
+/**
+ * Whether `root` is a package INSIDE a monorepo — an ancestor directory is a
+ * workspace root (`pnpm-workspace.yaml`, a `package.json` with a `workspaces`
+ * field, or an nx/lerna marker). In that case Tailwind v4 automatic content
+ * detection would otherwise climb to the workspace root. Synchronous and cheap
+ * (a handful of stat calls up the tree); intended to be memoized per build.
+ * Mirrors `isInsideWorkspace` in the CLI's `init` command.
+ *
+ * @param root - the project/package root directory.
+ * @returns true when an ancestor is a workspace root.
+ */
+declare function isMonorepoPackage(root: string): boolean;
+/**
+ * Whether to warn that Tailwind content detection is unscoped in a monorepo.
+ * Fires only when a Tailwind entry exists, it is NOT scoped, and this package
+ * sits inside a workspace — the exact condition that makes Tailwind scan the
+ * whole repo and emit phantom/broken classes.
+ *
+ * @param sawTailwindEntry - whether any processed CSS imported tailwindcss.
+ * @param tailwindEntryScoped - whether a Tailwind entry scoped its detection.
+ * @param inMonorepo - whether this package sits inside a workspace.
+ * @returns true when the unscoped-monorepo warning should fire.
+ */
+declare function shouldWarnUnscopedMonorepo(sawTailwindEntry: boolean, tailwindEntryScoped: boolean, inMonorepo: boolean): boolean;
+/**
+ * Build the unscoped-monorepo warning message: what is wrong, why it matters,
+ * the exact two-line fix, the guide link, and how to silence it.
+ * @returns the warning string.
+ */
+declare function unscopedMonorepoMessage(): string;
+/**
+ * Whether a `/packages/` file was opted into compilation via `compilePackages`.
+ * Matches the package directory name as a path segment (`/packages/<name>/`).
+ * `node_modules` is never opted in — real dependencies must not be compiled even
+ * if a dependency happens to share a name with a listed workspace package.
+ *
+ * @param id - bundler file id or filesystem path (Windows backslashes accepted).
+ * @param compilePackages - workspace package directory names to compile.
+ * @returns true when the file belongs to a listed workspace package.
+ */
+declare function isCompilePackageOptedIn(id: string, compilePackages: readonly string[]): boolean;
+/**
+ * Whether a file lives in a built-in directory csszyx never transforms.
+ *
+ * `node_modules` and `.next` (non-static) are always ignored. `/packages/` is
+ * ignored by default — published libraries ship pre-extracted CSS — but is
+ * relaxed for packages listed in `compilePackages`, so a monorepo can author
+ * `sz` in workspace source. Pulled out as a pure function so the precedence
+ * (node_modules/.next stay hard regardless of `compilePackages`) is unit-tested.
+ *
+ * @param id - bundler file id or filesystem path.
+ * @param compilePackages - workspace package directory names to compile.
+ * @returns true when the file should be skipped regardless of user filters.
+ */
+declare function isHardIgnoredPath(id: string, compilePackages?: readonly string[]): boolean;
+/**
+ * Whether a file is workspace-package source that csszyx skipped only because it
+ * lives under `/packages/` and was not opted into `compilePackages`. Used to
+ * surface the silent no-op (skipped `sz` produces no CSS). `node_modules` and
+ * `.next` are excluded — those are never workspace source the developer authors,
+ * and scanning `node_modules` for `sz` would be slow and false-positive-prone.
+ *
+ * @param id - filesystem path of the skipped file.
+ * @param compilePackages - workspace package directory names already opted in.
+ * @returns true when the skip is a workspace-package `sz` skip worth warning on.
+ */
+declare function isPackagesSkippedSource(id: string, compilePackages?: readonly string[]): boolean;
+/**
+ * Build the workspace-package skip warning. Lists the skipped files that contain
+ * `sz` so the developer can opt the package into `compilePackages` instead of
+ * silently shipping no CSS for them.
+ *
+ * @param files - skipped `/packages/` file paths that contain `sz`.
+ * @returns the warning string.
+ */
+declare function skippedSzFilesMessage(files: 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
+ * `./`- 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;
 /**
  * Extracts Phase H global custom-property aliases for manifest/debug tooling.
  *
@@ -258,7 +420,7 @@ declare function normalizeGlobalVarAliasesForCache(aliases: TransformSourceCodeO
  * Pass 1:   Direct `className="..."` / `class="..."` static strings
  * Pass 1.5: Template literal quasi (static) segments in `className:\`...\``
  * Pass 2:   `className:EXPR` patterns with ternary operators containing quoted strings
- * Pass 3:   Quoted string arguments to csszyx runtime helpers (_szMerge, _szIf, etc.)
+ * Pass 3:   Quoted string arguments to csszyx runtime helpers (_szMerge, _sz, etc.)
  *
  * @param code     bundled source code
  * @param mangleMap class-name → mangled-token mapping
@@ -291,5 +453,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { createGlobalVarMapAssetSource as o, esbuildPlugin as p, extractGlobalVarAliasesForManifest as q, mangleCodeClassesSync as r, normalizeGlobalVarAliasesForCache as s, resolveNativeCacheIdentity as t, unplugin as u, rollupPlugin as v, vitePlugin as w, webpackPlugin as x };
+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 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 };