@csszyx/unplugin 0.10.10 → 0.10.12

package/dist/shared/{unplugin.CK6U5gAP.d.mts → unplugin.D3qsS8Pe.d.cts}

@@ -1,4 +1,4 @@
-import { GlobalVarUsageDiagnostic, CssVariableMangleValue, TransformSourceCodeOptions } from '@csszyx/compiler';
+import { GlobalVarUsageDiagnostic, CssVariableMangleValue, TransformSourceCodeOptions, TokenData } from '@csszyx/compiler';
 import { PartialCsszyxConfig } from '@csszyx/types';
 import { Plugin } from 'esbuild';
 import { InputPluginOption } from 'rollup';
@@ -207,6 +207,250 @@ interface GlobalVarCssAliasRewriteResult {
     diagnostics: GlobalVarAliasDiagnostic[];
 }
 
+/**
+ * Direct RSC boundary violation found in a transformed module.
+ */
+interface RSCBoundaryViolation {
+    /** Forbidden runtime helper that crossed into an RSC server module. */
+    symbol: string;
+    /** Server module path where the import was found. */
+    path: string;
+    /** Import chain used in the fatal build error. */
+    importChain: string[];
+}
+/**
+ * RSC module metadata collected during the transform phase.
+ */
+interface RSCModuleRecord {
+    /** Normalized absolute module ID. */
+    id: string;
+    /** True when this module is an RSC server module entry or has `'use server'`. */
+    isServer: boolean;
+    /** True when this module declares the client boundary. */
+    isClient: boolean;
+    /** Local modules imported by this file after path resolution. */
+    imports: string[];
+    /** Forbidden runtime imports found directly in this module. */
+    runtimeImports: Array<{
+        source: string;
+        symbols: string[];
+    }>;
+}
+/**
+ * Returns true when a module starts with the top-level `'use server'`
+ * directive. Comments and blank lines before the directive are allowed, but
+ * detection stops at the first real statement.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use server'` directive
+ */
+declare function hasUseServerDirective(code: string): boolean;
+/**
+ * Returns true when a module starts with the top-level `'use client'`
+ * directive.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use client'` directive
+ */
+declare function hasUseClientDirective(code: string): boolean;
+/**
+ * Detects modules that should be treated as RSC server modules by csszyx.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns true when the module is server-side for RSC boundary purposes
+ */
+declare function isRSCServerModule(code: string, id: string): boolean;
+/**
+ * Finds the first direct forbidden runtime helper import in an RSC server
+ * module.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns violation details, or null when the module is allowed
+ */
+declare function findRSCBoundaryViolation(code: string, id: string): RSCBoundaryViolation | null;
+/**
+ * Builds module metadata for the RSC graph walker.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns graph metadata for the module
+ */
+declare function createRSCModuleRecord(code: string, id: string): RSCModuleRecord;
+/**
+ * Removes a module record after the bundler watcher reports that the file was
+ * deleted.
+ *
+ * @param records module graph records keyed by normalized module ID
+ * @param id module ID/path from the watcher event
+ * @returns true when a stale record was removed
+ */
+declare function deleteRSCModuleRecord(records: Map<string, RSCModuleRecord>, id: string): boolean;
+/**
+ * Finds forbidden runtime helper imports reachable from an RSC server module.
+ * Traversal stops at `'use client'` modules because they define a separate
+ * client module graph.
+ *
+ * @param records module graph records keyed by normalized module ID
+ * @returns first graph violation, or null when the graph is allowed
+ */
+declare function findRSCGraphViolation(records: Map<string, RSCModuleRecord>): RSCBoundaryViolation | null;
+/**
+ * Throws the spec-format fatal RSC boundary error for graph-level violations.
+ *
+ * @param records module graph records keyed by normalized module ID
+ */
+declare function assertNoRSCGraphViolation(records: Map<string, RSCModuleRecord>): void;
+/**
+ * Throws the spec-format fatal RSC boundary error when a server module imports
+ * a forbidden csszyx runtime helper.
+ *
+ * @param code module source
+ * @param id module ID/path
+ */
+declare function assertNoRSCBoundaryViolation(code: string, id: string): void;
+
+/**
+ * Theme Scanner — parses Tailwind v4 @theme blocks from CSS files.
+ *
+ * Extracts custom design tokens and categorizes them by type so the
+ * type writer can generate accurate TypeScript augmentation.
+ *
+ * Supports:
+ *   - Multiple @theme blocks per file
+ *   - @theme inline { } syntax (inline keyword ignored)
+ *   - @theme inside @layer (two-pass strip)
+ *   - --color-brand-50 shade suffixes (deduped to 'brand')
+ *   - Multi-file merge via mergeThemes()
+ */
+/** Extracted and categorized custom tokens from @theme blocks. */
+interface ParsedTheme {
+    /** Custom color names (from --color-*): e.g. ['brand', 'brand-dark'] */
+    colors: string[];
+    /** Custom spacing tokens (from --spacing-*): e.g. ['xl', '2xs'] */
+    spacings: string[];
+    /** Custom font families (from --font-*): e.g. ['display', 'body'] */
+    fonts: string[];
+    /** Custom font sizes (from --text-*): e.g. ['huge'] */
+    textSizes: string[];
+    /** Custom font weights (from --font-weight-*): e.g. ['chunky'] */
+    fontWeights: string[];
+    /** Custom border radii (from --radius-*): e.g. ['button'] */
+    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.
+ *
+ * @param cssContent - Raw CSS file content
+ * @returns Categorized design tokens
+ */
+declare function parseThemeBlocks(cssContent: string): ParsedTheme;
+/**
+ * Merge multiple ParsedTheme objects into one, deduplicating tokens.
+ *
+ * @param themes - Array of parsed themes to merge
+ * @returns Merged theme with unique tokens per category
+ */
+declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
+/**
+ * Check if a ParsedTheme has any tokens.
+ *
+ * @param theme - Parsed theme to check
+ * @returns True if at least one category has tokens
+ */
+declare function hasTokens(theme: ParsedTheme): boolean;
+
+/**
+ * Plugin state for mangle map management.
+ */
+interface PluginState {
+    /**
+     * Every class csszyx wants Tailwind to generate CSS for — sz-generated
+     * classes plus raw author `className` values seen during the fallback scan.
+     * Drives the `@source` safelist; NOT the mangle map.
+     */
+    classes: Set<string>;
+    /** Merged @theme scan result — feeds the theme-groups virtual module. */
+    parsedTheme: ParsedTheme | null;
+    /**
+     * True once any processed CSS file was seen importing `tailwindcss`. Used to
+     * warn at build end when csszyx generated classes but nothing makes Tailwind
+     * emit their CSS (no entry → the classes resolve to no styles, silently).
+     */
+    sawTailwindEntry: boolean;
+    /**
+     * True once ANY CSS file passed through the transform hook. The missing-entry
+     * warning only fires when csszyx actually observed the CSS pipeline but found
+     * no `tailwindcss` entry — otherwise it false-positives in setups where CSS is
+     * handled outside this hook or not yet processed at build end (`astro check`,
+     * an early Astro build phase), where the build in fact emits valid CSS.
+     */
+    sawAnyCss: boolean;
+    /** Guards the missing-Tailwind-entry warning so it fires at most once. */
+    tailwindWarningEmitted: boolean;
+    /** Whether a Tailwind entry scoped content detection (source()/@source not). */
+    tailwindEntryScoped: boolean;
+    /** Guards the unscoped-monorepo warning so it fires at most once. */
+    contentScopeWarningEmitted: boolean;
+    /** Memoized `isMonorepoPackage(rootDir)` result; `undefined` until computed. */
+    inMonorepo?: boolean;
+    /**
+     * Classes csszyx generated by lowering `sz` props — the ONLY classes the
+     * mangle map may rename. Author-written `className` values are deliberately
+     * excluded: renaming them would break selectors an external stylesheet (or
+     * JS that references classes by name) owns.
+     */
+    ownedClasses: Set<string>;
+    /** Unresolvable-spread warnings surfaced to the build log in every mode. */
+    spreadWarnings: Set<string>;
+    /**
+     * Workspace-package files under `/packages/` that contain `sz` 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>;
+    /** Guards the skipped-sz-files warning so it fires at most once. */
+    skipWarningEmitted: boolean;
+    /**
+     * Set once the safelist class set hits {@link MAX_SAFELIST_CLASSES} and extra
+     * classes are dropped — bounds memory/output growth from pathological input.
+     */
+    classesCapped: boolean;
+    mangleMap: Record<string, string>;
+    varMangleEntriesByFile: Map<string, Array<[string, string]>>;
+    varMangleMap: Record<string, CssVariableMangleValue>;
+    cssVarMetricsByFile: Map<string, CSSVariableMetrics>;
+    cssVarMetrics: CSSVariableMetrics;
+    checksum: string;
+    finalized: boolean;
+    rootDir: string;
+    /**
+     * Recovery tokens collected from szRecover JSX attributes across all
+     * transformed files. Aggregated by the `transform` hook (compiler emits
+     * the data-sz-recovery-token attribute and returns the per-file map),
+     * then serialised into the manifest script tag injected into SSR HTML.
+     */
+    recoveryTokens: Map<string, TokenData>;
+    /** RSC graph records collected from transformed TS/JS modules. */
+    rscModules: Map<string, RSCModuleRecord>;
+    /** Source files observed by the transform hook for global-var diagnostics. */
+    globalVarSourceFilesByFile: Map<string, string>;
+    /** Last validated global-var alias result for the current output hook. */
+    globalVarValidationResult: GlobalVarAliasValidationResult | null;
+}
+/** CSS variable mangling and hoisting metrics emitted for debugging. */
+interface CSSVariableMetrics {
+    componentClassUses: number;
+    componentStyleDeclarations: number;
+    estimatedHoistedDeclarationsSaved: number;
+    scopedClassUses: number;
+    scopedStyleDeclarations: number;
+}
 /**
  * Identity of the installed native engine binary for transform-cache keys.
  *
@@ -469,6 +713,28 @@ declare function skippedSzFilesMessage(files: readonly string[]): string;
  * @returns the posix relative path from the CSS file to the safelist file.
  */
 declare function computeSafelistRelPath(rootDir: string, safelistFilename: string, cssId: string): string;
+/**
+ * Whether transformed source text must be retained for global-var alias
+ * validation. Retention is only consumed when `production.mangleGlobalVars`
+ * is explicitly enabled; recording without that consumer keeps the full text
+ * of every transformed JS/TS module alive for the plugin lifetime.
+ *
+ * @param config The `production.mangleGlobalVars` option value.
+ * @param config.enabled Whether global-var mangling is turned on.
+ * @returns True only when the feature is explicitly enabled.
+ */
+declare function shouldTrackGlobalVarSources(config?: {
+    enabled?: boolean;
+}): boolean;
+/**
+ * Records source text available before bundling/minification for Phase H
+ * global-var diagnostics.
+ *
+ * @param state Plugin state to update.
+ * @param filename Source filename that owns the text.
+ * @param code Source text, or null to clear this file.
+ */
+declare function recordGlobalVarSourceFile(state: Pick<PluginState, 'globalVarSourceFilesByFile'>, filename: string, code: string | null): void;
 /**
  * Extracts Phase H global custom-property aliases for manifest/debug tooling.
  *
@@ -540,5 +806,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { isHardIgnoredPath as A, isMonorepoPackage as B, isPackagesSkippedSource as D, mangleCodeClassesSync as E, mangleHybridHazardMessage as F, missingTailwindEntryMessage as H, normalizeGlobalVarAliasesForCache as I, resolveCompileSourceDirs as J, resolveNativeCacheIdentity as K, rollupPlugin as L, shouldEmitWarning as N, shouldWarnMissingTailwindEntry as O, shouldWarnUnscopedMonorepo as Q, skippedSzFilesMessage as T, unscopedMonorepoMessage as U, vitePlugin as W, webpackPlugin as X, appendTailwindSourceDirective as o, collectMangleHybridHazards as p, computeSafelistRelPath as q, createGlobalVarMapAssetSource as r, cssHasContentScope as s, cssImportsTailwind as t, unplugin as u, esbuildPlugin as v, extractGlobalVarAliasesForManifest as w, fileMayContainSafelistableSz as x, hasInjectableTailwindCandidate as y, isCompileSourceOptedIn 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 };
+export { normalizeGlobalVarAliasesForCache as $, unplugin as A, deleteRSCModuleRecord as B, esbuildPlugin as D, extractGlobalVarAliasesForManifest as E, fileMayContainSafelistableSz as F, findRSCBoundaryViolation as H, findRSCGraphViolation as I, hasInjectableTailwindCandidate as J, hasTokens as K, hasUseClientDirective as L, hasUseServerDirective as N, isCompileSourceOptedIn as O, isHardIgnoredPath as Q, isMonorepoPackage as T, isPackagesSkippedSource as U, isRSCServerModule as W, mangleCodeClassesSync as X, mangleHybridHazardMessage as Y, mergeThemes as Z, missingTailwindEntryMessage as _, parseThemeBlocks as a0, recordGlobalVarSourceFile as a1, resolveCompileSourceDirs as a2, resolveNativeCacheIdentity as a3, rollupPlugin as a4, shouldEmitWarning as a5, shouldTrackGlobalVarSources as a6, shouldWarnMissingTailwindEntry as a7, shouldWarnUnscopedMonorepo as a8, skippedSzFilesMessage as a9, unscopedMonorepoMessage as aa, vitePlugin as ab, webpackPlugin as ac, appendTailwindSourceDirective as r, assertNoRSCBoundaryViolation as s, assertNoRSCGraphViolation as t, collectMangleHybridHazards as u, computeSafelistRelPath as v, createGlobalVarMapAssetSource as w, createRSCModuleRecord as x, cssHasContentScope as y, cssImportsTailwind 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 };

package/dist/shared/{unplugin.CK6U5gAP.d.cts → unplugin.D3qsS8Pe.d.mts}

@@ -1,4 +1,4 @@
-import { GlobalVarUsageDiagnostic, CssVariableMangleValue, TransformSourceCodeOptions } from '@csszyx/compiler';
+import { GlobalVarUsageDiagnostic, CssVariableMangleValue, TransformSourceCodeOptions, TokenData } from '@csszyx/compiler';
 import { PartialCsszyxConfig } from '@csszyx/types';
 import { Plugin } from 'esbuild';
 import { InputPluginOption } from 'rollup';
@@ -207,6 +207,250 @@ interface GlobalVarCssAliasRewriteResult {
     diagnostics: GlobalVarAliasDiagnostic[];
 }
 
+/**
+ * Direct RSC boundary violation found in a transformed module.
+ */
+interface RSCBoundaryViolation {
+    /** Forbidden runtime helper that crossed into an RSC server module. */
+    symbol: string;
+    /** Server module path where the import was found. */
+    path: string;
+    /** Import chain used in the fatal build error. */
+    importChain: string[];
+}
+/**
+ * RSC module metadata collected during the transform phase.
+ */
+interface RSCModuleRecord {
+    /** Normalized absolute module ID. */
+    id: string;
+    /** True when this module is an RSC server module entry or has `'use server'`. */
+    isServer: boolean;
+    /** True when this module declares the client boundary. */
+    isClient: boolean;
+    /** Local modules imported by this file after path resolution. */
+    imports: string[];
+    /** Forbidden runtime imports found directly in this module. */
+    runtimeImports: Array<{
+        source: string;
+        symbols: string[];
+    }>;
+}
+/**
+ * Returns true when a module starts with the top-level `'use server'`
+ * directive. Comments and blank lines before the directive are allowed, but
+ * detection stops at the first real statement.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use server'` directive
+ */
+declare function hasUseServerDirective(code: string): boolean;
+/**
+ * Returns true when a module starts with the top-level `'use client'`
+ * directive.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use client'` directive
+ */
+declare function hasUseClientDirective(code: string): boolean;
+/**
+ * Detects modules that should be treated as RSC server modules by csszyx.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns true when the module is server-side for RSC boundary purposes
+ */
+declare function isRSCServerModule(code: string, id: string): boolean;
+/**
+ * Finds the first direct forbidden runtime helper import in an RSC server
+ * module.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns violation details, or null when the module is allowed
+ */
+declare function findRSCBoundaryViolation(code: string, id: string): RSCBoundaryViolation | null;
+/**
+ * Builds module metadata for the RSC graph walker.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns graph metadata for the module
+ */
+declare function createRSCModuleRecord(code: string, id: string): RSCModuleRecord;
+/**
+ * Removes a module record after the bundler watcher reports that the file was
+ * deleted.
+ *
+ * @param records module graph records keyed by normalized module ID
+ * @param id module ID/path from the watcher event
+ * @returns true when a stale record was removed
+ */
+declare function deleteRSCModuleRecord(records: Map<string, RSCModuleRecord>, id: string): boolean;
+/**
+ * Finds forbidden runtime helper imports reachable from an RSC server module.
+ * Traversal stops at `'use client'` modules because they define a separate
+ * client module graph.
+ *
+ * @param records module graph records keyed by normalized module ID
+ * @returns first graph violation, or null when the graph is allowed
+ */
+declare function findRSCGraphViolation(records: Map<string, RSCModuleRecord>): RSCBoundaryViolation | null;
+/**
+ * Throws the spec-format fatal RSC boundary error for graph-level violations.
+ *
+ * @param records module graph records keyed by normalized module ID
+ */
+declare function assertNoRSCGraphViolation(records: Map<string, RSCModuleRecord>): void;
+/**
+ * Throws the spec-format fatal RSC boundary error when a server module imports
+ * a forbidden csszyx runtime helper.
+ *
+ * @param code module source
+ * @param id module ID/path
+ */
+declare function assertNoRSCBoundaryViolation(code: string, id: string): void;
+
+/**
+ * Theme Scanner — parses Tailwind v4 @theme blocks from CSS files.
+ *
+ * Extracts custom design tokens and categorizes them by type so the
+ * type writer can generate accurate TypeScript augmentation.
+ *
+ * Supports:
+ *   - Multiple @theme blocks per file
+ *   - @theme inline { } syntax (inline keyword ignored)
+ *   - @theme inside @layer (two-pass strip)
+ *   - --color-brand-50 shade suffixes (deduped to 'brand')
+ *   - Multi-file merge via mergeThemes()
+ */
+/** Extracted and categorized custom tokens from @theme blocks. */
+interface ParsedTheme {
+    /** Custom color names (from --color-*): e.g. ['brand', 'brand-dark'] */
+    colors: string[];
+    /** Custom spacing tokens (from --spacing-*): e.g. ['xl', '2xs'] */
+    spacings: string[];
+    /** Custom font families (from --font-*): e.g. ['display', 'body'] */
+    fonts: string[];
+    /** Custom font sizes (from --text-*): e.g. ['huge'] */
+    textSizes: string[];
+    /** Custom font weights (from --font-weight-*): e.g. ['chunky'] */
+    fontWeights: string[];
+    /** Custom border radii (from --radius-*): e.g. ['button'] */
+    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.
+ *
+ * @param cssContent - Raw CSS file content
+ * @returns Categorized design tokens
+ */
+declare function parseThemeBlocks(cssContent: string): ParsedTheme;
+/**
+ * Merge multiple ParsedTheme objects into one, deduplicating tokens.
+ *
+ * @param themes - Array of parsed themes to merge
+ * @returns Merged theme with unique tokens per category
+ */
+declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
+/**
+ * Check if a ParsedTheme has any tokens.
+ *
+ * @param theme - Parsed theme to check
+ * @returns True if at least one category has tokens
+ */
+declare function hasTokens(theme: ParsedTheme): boolean;
+
+/**
+ * Plugin state for mangle map management.
+ */
+interface PluginState {
+    /**
+     * Every class csszyx wants Tailwind to generate CSS for — sz-generated
+     * classes plus raw author `className` values seen during the fallback scan.
+     * Drives the `@source` safelist; NOT the mangle map.
+     */
+    classes: Set<string>;
+    /** Merged @theme scan result — feeds the theme-groups virtual module. */
+    parsedTheme: ParsedTheme | null;
+    /**
+     * True once any processed CSS file was seen importing `tailwindcss`. Used to
+     * warn at build end when csszyx generated classes but nothing makes Tailwind
+     * emit their CSS (no entry → the classes resolve to no styles, silently).
+     */
+    sawTailwindEntry: boolean;
+    /**
+     * True once ANY CSS file passed through the transform hook. The missing-entry
+     * warning only fires when csszyx actually observed the CSS pipeline but found
+     * no `tailwindcss` entry — otherwise it false-positives in setups where CSS is
+     * handled outside this hook or not yet processed at build end (`astro check`,
+     * an early Astro build phase), where the build in fact emits valid CSS.
+     */
+    sawAnyCss: boolean;
+    /** Guards the missing-Tailwind-entry warning so it fires at most once. */
+    tailwindWarningEmitted: boolean;
+    /** Whether a Tailwind entry scoped content detection (source()/@source not). */
+    tailwindEntryScoped: boolean;
+    /** Guards the unscoped-monorepo warning so it fires at most once. */
+    contentScopeWarningEmitted: boolean;
+    /** Memoized `isMonorepoPackage(rootDir)` result; `undefined` until computed. */
+    inMonorepo?: boolean;
+    /**
+     * Classes csszyx generated by lowering `sz` props — the ONLY classes the
+     * mangle map may rename. Author-written `className` values are deliberately
+     * excluded: renaming them would break selectors an external stylesheet (or
+     * JS that references classes by name) owns.
+     */
+    ownedClasses: Set<string>;
+    /** Unresolvable-spread warnings surfaced to the build log in every mode. */
+    spreadWarnings: Set<string>;
+    /**
+     * Workspace-package files under `/packages/` that contain `sz` 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>;
+    /** Guards the skipped-sz-files warning so it fires at most once. */
+    skipWarningEmitted: boolean;
+    /**
+     * Set once the safelist class set hits {@link MAX_SAFELIST_CLASSES} and extra
+     * classes are dropped — bounds memory/output growth from pathological input.
+     */
+    classesCapped: boolean;
+    mangleMap: Record<string, string>;
+    varMangleEntriesByFile: Map<string, Array<[string, string]>>;
+    varMangleMap: Record<string, CssVariableMangleValue>;
+    cssVarMetricsByFile: Map<string, CSSVariableMetrics>;
+    cssVarMetrics: CSSVariableMetrics;
+    checksum: string;
+    finalized: boolean;
+    rootDir: string;
+    /**
+     * Recovery tokens collected from szRecover JSX attributes across all
+     * transformed files. Aggregated by the `transform` hook (compiler emits
+     * the data-sz-recovery-token attribute and returns the per-file map),
+     * then serialised into the manifest script tag injected into SSR HTML.
+     */
+    recoveryTokens: Map<string, TokenData>;
+    /** RSC graph records collected from transformed TS/JS modules. */
+    rscModules: Map<string, RSCModuleRecord>;
+    /** Source files observed by the transform hook for global-var diagnostics. */
+    globalVarSourceFilesByFile: Map<string, string>;
+    /** Last validated global-var alias result for the current output hook. */
+    globalVarValidationResult: GlobalVarAliasValidationResult | null;
+}
+/** CSS variable mangling and hoisting metrics emitted for debugging. */
+interface CSSVariableMetrics {
+    componentClassUses: number;
+    componentStyleDeclarations: number;
+    estimatedHoistedDeclarationsSaved: number;
+    scopedClassUses: number;
+    scopedStyleDeclarations: number;
+}
 /**
  * Identity of the installed native engine binary for transform-cache keys.
  *
@@ -469,6 +713,28 @@ declare function skippedSzFilesMessage(files: readonly string[]): string;
  * @returns the posix relative path from the CSS file to the safelist file.
  */
 declare function computeSafelistRelPath(rootDir: string, safelistFilename: string, cssId: string): string;
+/**
+ * Whether transformed source text must be retained for global-var alias
+ * validation. Retention is only consumed when `production.mangleGlobalVars`
+ * is explicitly enabled; recording without that consumer keeps the full text
+ * of every transformed JS/TS module alive for the plugin lifetime.
+ *
+ * @param config The `production.mangleGlobalVars` option value.
+ * @param config.enabled Whether global-var mangling is turned on.
+ * @returns True only when the feature is explicitly enabled.
+ */
+declare function shouldTrackGlobalVarSources(config?: {
+    enabled?: boolean;
+}): boolean;
+/**
+ * Records source text available before bundling/minification for Phase H
+ * global-var diagnostics.
+ *
+ * @param state Plugin state to update.
+ * @param filename Source filename that owns the text.
+ * @param code Source text, or null to clear this file.
+ */
+declare function recordGlobalVarSourceFile(state: Pick<PluginState, 'globalVarSourceFilesByFile'>, filename: string, code: string | null): void;
 /**
  * Extracts Phase H global custom-property aliases for manifest/debug tooling.
  *
@@ -540,5 +806,5 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { isHardIgnoredPath as A, isMonorepoPackage as B, isPackagesSkippedSource as D, mangleCodeClassesSync as E, mangleHybridHazardMessage as F, missingTailwindEntryMessage as H, normalizeGlobalVarAliasesForCache as I, resolveCompileSourceDirs as J, resolveNativeCacheIdentity as K, rollupPlugin as L, shouldEmitWarning as N, shouldWarnMissingTailwindEntry as O, shouldWarnUnscopedMonorepo as Q, skippedSzFilesMessage as T, unscopedMonorepoMessage as U, vitePlugin as W, webpackPlugin as X, appendTailwindSourceDirective as o, collectMangleHybridHazards as p, computeSafelistRelPath as q, createGlobalVarMapAssetSource as r, cssHasContentScope as s, cssImportsTailwind as t, unplugin as u, esbuildPlugin as v, extractGlobalVarAliasesForManifest as w, fileMayContainSafelistableSz as x, hasInjectableTailwindCandidate as y, isCompileSourceOptedIn 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 };
+export { normalizeGlobalVarAliasesForCache as $, unplugin as A, deleteRSCModuleRecord as B, esbuildPlugin as D, extractGlobalVarAliasesForManifest as E, fileMayContainSafelistableSz as F, findRSCBoundaryViolation as H, findRSCGraphViolation as I, hasInjectableTailwindCandidate as J, hasTokens as K, hasUseClientDirective as L, hasUseServerDirective as N, isCompileSourceOptedIn as O, isHardIgnoredPath as Q, isMonorepoPackage as T, isPackagesSkippedSource as U, isRSCServerModule as W, mangleCodeClassesSync as X, mangleHybridHazardMessage as Y, mergeThemes as Z, missingTailwindEntryMessage as _, parseThemeBlocks as a0, recordGlobalVarSourceFile as a1, resolveCompileSourceDirs as a2, resolveNativeCacheIdentity as a3, rollupPlugin as a4, shouldEmitWarning as a5, shouldTrackGlobalVarSources as a6, shouldWarnMissingTailwindEntry as a7, shouldWarnUnscopedMonorepo as a8, skippedSzFilesMessage as a9, unscopedMonorepoMessage as aa, vitePlugin as ab, webpackPlugin as ac, appendTailwindSourceDirective as r, assertNoRSCBoundaryViolation as s, assertNoRSCGraphViolation as t, collectMangleHybridHazards as u, computeSafelistRelPath as v, createGlobalVarMapAssetSource as w, createRSCModuleRecord as x, cssHasContentScope as y, cssImportsTailwind 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 };