@csszyx/unplugin 0.9.0 → 0.9.1

package/dist/shared/unplugin.CPEWNSA0.d.cts

@@ -0,0 +1,77 @@
+/** JSON-compatible value used for cache identity material. */
+type JsonLike = null | boolean | number | string | readonly JsonLike[] | {
+    readonly [key: string]: JsonLike | undefined;
+};
+/** Stable identity hashes used by manifests and transform cache keys. */
+interface NextCacheIdentity {
+    configHash: string;
+    envHash: string;
+    generation: string;
+}
+
+/** Files used by the Next Turbopack safelist state machine. */
+interface NextSafelistStatePaths {
+    cacheDir: string;
+    shardsDir: string;
+    snapshotPath: string;
+    outputPath: string;
+}
+/** Result returned after materializing shard records. */
+interface NextSafelistMaterializeResult {
+    classCount: number;
+    sourceCount: number;
+    tombstonedSourceCount: number;
+    shardCount: number;
+}
+/** Options for atomic file writes that need to survive Windows file scanners. */
+interface AtomicWriteOptions {
+    maxRetries?: number;
+    retryDelayMs?: number;
+    renameSync?: (from: string, to: string) => void;
+}
+/** Options used when acquiring a state lock. */
+interface NextSafelistStateLockOptions {
+    pid?: number;
+    root?: string;
+    mode?: 'development' | 'production';
+    command?: string;
+    now?: number;
+    staleAfterMs?: number;
+    isProcessAlive?: (pid: number) => boolean;
+    hostname?: string;
+    token?: string;
+}
+
+/** Mode represented by a Next Turbopack generation manifest. */
+type NextGenerationMode = 'development' | 'production';
+/** Inputs expected by a loader/watcher before trusting a manifest. */
+interface NextGenerationManifestExpectation {
+    root: string;
+    configHash: string;
+    envHash: string;
+    nextVersion: string;
+    csszyxVersion: string;
+    nativeVersion: string;
+    mode: NextGenerationMode;
+}
+
+/** Source used to resolve a Next app root. */
+type NextAppRootSource = 'explicit' | 'loader-root-context' | 'loader-context' | 'cwd';
+/** Resolved Next app root plus the source that won. */
+interface NextAppRootResolution {
+    root: string;
+    source: NextAppRootSource;
+}
+
+/** Shared state context consumed by future watcher, prebuild, and loader code. */
+interface NextStateContext {
+    root: string;
+    rootSource: NextAppRootResolution['source'];
+    cacheDir: string;
+    safelist: NextSafelistStatePaths;
+    manifestPath: string;
+    identity: NextCacheIdentity;
+    manifestExpectation: NextGenerationManifestExpectation;
+}
+
+export type { AtomicWriteOptions as A, JsonLike as J, NextStateContext as N, NextSafelistMaterializeResult as a, NextSafelistStateLockOptions as b };

package/dist/shared/unplugin.CPEWNSA0.d.mts

@@ -0,0 +1,77 @@
+/** JSON-compatible value used for cache identity material. */
+type JsonLike = null | boolean | number | string | readonly JsonLike[] | {
+    readonly [key: string]: JsonLike | undefined;
+};
+/** Stable identity hashes used by manifests and transform cache keys. */
+interface NextCacheIdentity {
+    configHash: string;
+    envHash: string;
+    generation: string;
+}
+
+/** Files used by the Next Turbopack safelist state machine. */
+interface NextSafelistStatePaths {
+    cacheDir: string;
+    shardsDir: string;
+    snapshotPath: string;
+    outputPath: string;
+}
+/** Result returned after materializing shard records. */
+interface NextSafelistMaterializeResult {
+    classCount: number;
+    sourceCount: number;
+    tombstonedSourceCount: number;
+    shardCount: number;
+}
+/** Options for atomic file writes that need to survive Windows file scanners. */
+interface AtomicWriteOptions {
+    maxRetries?: number;
+    retryDelayMs?: number;
+    renameSync?: (from: string, to: string) => void;
+}
+/** Options used when acquiring a state lock. */
+interface NextSafelistStateLockOptions {
+    pid?: number;
+    root?: string;
+    mode?: 'development' | 'production';
+    command?: string;
+    now?: number;
+    staleAfterMs?: number;
+    isProcessAlive?: (pid: number) => boolean;
+    hostname?: string;
+    token?: string;
+}
+
+/** Mode represented by a Next Turbopack generation manifest. */
+type NextGenerationMode = 'development' | 'production';
+/** Inputs expected by a loader/watcher before trusting a manifest. */
+interface NextGenerationManifestExpectation {
+    root: string;
+    configHash: string;
+    envHash: string;
+    nextVersion: string;
+    csszyxVersion: string;
+    nativeVersion: string;
+    mode: NextGenerationMode;
+}
+
+/** Source used to resolve a Next app root. */
+type NextAppRootSource = 'explicit' | 'loader-root-context' | 'loader-context' | 'cwd';
+/** Resolved Next app root plus the source that won. */
+interface NextAppRootResolution {
+    root: string;
+    source: NextAppRootSource;
+}
+
+/** Shared state context consumed by future watcher, prebuild, and loader code. */
+interface NextStateContext {
+    root: string;
+    rootSource: NextAppRootResolution['source'];
+    cacheDir: string;
+    safelist: NextSafelistStatePaths;
+    manifestPath: string;
+    identity: NextCacheIdentity;
+    manifestExpectation: NextGenerationManifestExpectation;
+}
+
+export type { AtomicWriteOptions as A, JsonLike as J, NextStateContext as N, NextSafelistMaterializeResult as a, NextSafelistStateLockOptions as b };

package/dist/shared/unplugin.CScQRdTp.d.cts

@@ -0,0 +1,15 @@
+import { SourceTransformResult } from '@csszyx/compiler';
+
+/** Parser implementation that produced a cache entry. */
+type TransformCacheProducer = 'babel' | 'babel-fallback' | 'oxc' | 'rust';
+
+/** Parser mode supported by the Next Turbopack source transformer. */
+type NextSourceParserMode = 'babel' | 'oxc' | 'rust';
+/** Result of one source transform plus cache metadata for loader diagnostics. */
+interface NextSourceTransformOutput {
+    result: SourceTransformResult;
+    cacheStatus: 'disabled' | 'hit' | 'miss' | 'write';
+    producer: TransformCacheProducer;
+}
+
+export type { NextSourceParserMode as N, NextSourceTransformOutput as a };

package/dist/shared/unplugin.CScQRdTp.d.mts

@@ -0,0 +1,15 @@
+import { SourceTransformResult } from '@csszyx/compiler';
+
+/** Parser implementation that produced a cache entry. */
+type TransformCacheProducer = 'babel' | 'babel-fallback' | 'oxc' | 'rust';
+
+/** Parser mode supported by the Next Turbopack source transformer. */
+type NextSourceParserMode = 'babel' | 'oxc' | 'rust';
+/** Result of one source transform plus cache metadata for loader diagnostics. */
+interface NextSourceTransformOutput {
+    result: SourceTransformResult;
+    cacheStatus: 'disabled' | 'hit' | 'miss' | 'write';
+    producer: TransformCacheProducer;
+}
+
+export type { NextSourceParserMode as N, NextSourceTransformOutput as a };

package/dist/shared/unplugin.CdZxp0x-.d.mts

@@ -0,0 +1,16 @@
+import { a as NextSafelistMaterializeResult, b as NextSafelistStateLockOptions, A as AtomicWriteOptions } from './unplugin.CPEWNSA0.mjs';
+
+/** Options for one synchronous watcher materialization cycle. */
+interface NextWatcherCycleOptions {
+    lockOptions?: NextSafelistStateLockOptions;
+    writeOptions?: AtomicWriteOptions;
+    createdAt?: string;
+}
+/** Result returned by one watcher materialization cycle. */
+interface NextWatcherCycleResult {
+    materialize: NextSafelistMaterializeResult;
+    manifestPath: string;
+    lockPath: string;
+}
+
+export type { NextWatcherCycleResult as N, NextWatcherCycleOptions as a };

package/dist/shared/unplugin.DLrBgECN.d.cts

@@ -0,0 +1,282 @@
+import { GlobalVarUsageDiagnostic, CssVariableMangleValue, TransformSourceCodeOptions } from '@csszyx/compiler';
+import { PartialCsszyxConfig } from '@csszyx/types';
+import { Plugin } from 'esbuild';
+import { InputPluginOption } from 'rollup';
+import { UnpluginInstance, WebpackPluginInstance } from 'unplugin';
+import { PluginOption } from 'vite';
+
+/** Source location for one CSS custom-property occurrence. */
+interface CssVarLocation {
+    /** Source file path, when known. */
+    filePath: string;
+    /** 1-based source line. */
+    line: number;
+    /** 1-based source column. */
+    column: number;
+}
+/** One CSS custom-property definition. */
+interface CssVarDefinition extends CssVarLocation {
+    /** Custom-property name including the leading `--`. */
+    name: string;
+    /** Stable declaration scope key built from ancestor at-rules and selectors. */
+    scopeId: string;
+    /** Whether the definition lives inside a Tailwind v4 @theme block. */
+    tailwindOwned: boolean;
+    /** Whether this name is registered by an @property at-rule. */
+    registered: boolean;
+}
+/** One var(--token) reference. */
+interface CssVarReference extends CssVarLocation {
+    /** Custom-property name including the leading `--`. */
+    name: string;
+    /** Stable reference scope key built from ancestor at-rules and selectors. */
+    scopeId: string;
+    /** Declaration property or at-rule params where the reference appears. */
+    owner: string;
+    /** Whether the reference lives inside a Tailwind v4 @theme block. */
+    tailwindOwned: boolean;
+}
+/** CSS custom-property scan output for one CSS source. */
+interface CssVarScanResult {
+    /** Source file path, when known. */
+    filePath: string;
+    /** Custom-property declarations. */
+    definitions: CssVarDefinition[];
+    /** var(--token) references. */
+    references: CssVarReference[];
+    /** @property registered custom-property names. */
+    registered: string[];
+    /** Whether the file path appears to be third-party CSS. */
+    thirdParty: boolean;
+}
+/** Cache entry for one CSS variable scan result. */
+interface GlobalVarScanCacheEntry {
+    /** Cache key derived from file path, mtime, and content hash. */
+    key: string;
+    /** Cached scan result. */
+    result: CssVarScanResult;
+}
+/** Inputs used to derive a scan cache key. */
+interface GlobalVarScanCacheKeyInput {
+    /** Source file path. */
+    filePath: string;
+    /** CSS source text. */
+    css: string;
+    /** Source file mtime in milliseconds. */
+    mtimeMs: number;
+}
+/** CSS source supplied to the Phase H validation orchestrator. */
+interface GlobalVarCssSource {
+    /** Source file path. */
+    filePath: string;
+    /** CSS source text. */
+    css: string;
+    /** Source file mtime in milliseconds, used when cacheDir is set. */
+    mtimeMs?: number;
+}
+/** JS/TS/JSX/TSX source supplied to the Phase H validation orchestrator. */
+interface GlobalVarCodeSource {
+    /** Source file path. */
+    filePath: string;
+    /** JS/TS/JSX/TSX source text. */
+    code: string;
+}
+/** CSS asset supplied by a bundler output hook. */
+interface GlobalVarCssAssetSource {
+    /** CSS asset file name, relative to the build output or absolute. */
+    fileName: string;
+    /** CSS asset source contents. */
+    source: string | Uint8Array;
+    /** Source file mtime in milliseconds, used when cacheDir is set. */
+    mtimeMs?: number;
+}
+/** Options for scanning one CSS source. */
+interface ScanGlobalVarCssOptions {
+    /** File path used for diagnostics. */
+    filePath?: string;
+}
+/** Planner diagnostic severity. */
+type GlobalVarAliasDiagnosticSeverity = 'error';
+/** Planner diagnostic. */
+interface GlobalVarAliasDiagnostic {
+    /** Machine-readable diagnostic code. */
+    code: 'missing-definition' | 'tailwind-reserved' | 'tailwind-owned' | 'registered-property' | 'alias-collision';
+    /** Diagnostic severity. Phase H M2 is fail-closed. */
+    severity: GlobalVarAliasDiagnosticSeverity;
+    /** Related custom-property name. */
+    name: string;
+    /** Human-readable message. */
+    message: string;
+    /** Source location when available. */
+    location?: CssVarLocation;
+}
+/** One planned alias mapping. */
+interface GlobalVarAliasEntry {
+    /** Original app-owned custom-property name. */
+    original: string;
+    /** Deterministic short alias name. */
+    alias: string;
+    /** Declaration scopes where aliases must be emitted. */
+    scopes: string[];
+}
+/** Input to the pure global variable alias planner. */
+interface PlanGlobalVarAliasesInput {
+    /** CSS scan results. */
+    scans: CssVarScanResult[];
+    /** Explicit app-owned custom-property names. */
+    tokens?: string[];
+    /** Optional app-owned prefix discovery. Empty string disables discovery. */
+    autoPrefix?: string;
+    /** Prefix for generated aliases. Defaults to `---g`. */
+    aliasPrefix?: string;
+    /** Additional reserved names or prefixes. Prefixes may end with `*`. */
+    reserved?: string[];
+}
+/** Output from the pure global variable alias planner. */
+interface GlobalVarAliasPlan {
+    /** Deterministic alias entries. Empty when diagnostics contain errors. */
+    entries: GlobalVarAliasEntry[];
+    /** Original-to-alias lookup. Empty when diagnostics contain errors. */
+    aliases: Map<string, string>;
+    /** Planner diagnostics. */
+    diagnostics: GlobalVarAliasDiagnostic[];
+}
+/** Input for Phase H scanner/planner/diagnostics integration. */
+interface ValidateGlobalVarAliasInputsOptions {
+    /** CSS sources that define or reference custom properties. */
+    cssFiles: GlobalVarCssSource[];
+    /** JS/TS/JSX/TSX sources to scan for out-of-band usage. */
+    sourceFiles?: GlobalVarCodeSource[];
+    /** Explicit app-owned custom-property names. */
+    tokens?: string[];
+    /** Optional app-owned prefix discovery. Empty string disables discovery. */
+    autoPrefix?: string;
+    /** Prefix for generated aliases. Defaults to `---g`. */
+    aliasPrefix?: string;
+    /** Additional reserved names or prefixes. Prefixes may end with `*`. */
+    reserved?: string[];
+    /** Optional global-var scan cache directory. */
+    cacheDir?: string;
+}
+/** Input for building validation options from bundler output state. */
+interface CreateGlobalVarAliasValidationOptionsInput {
+    /** Project root used to normalize relative asset names. */
+    rootDir: string;
+    /** CSS assets emitted by the bundler. Non-CSS assets are ignored. */
+    cssAssets: GlobalVarCssAssetSource[];
+    /** Source files transformed or observed before bundling. */
+    sourceFiles?: GlobalVarCodeSource[];
+    /** Explicit app-owned custom-property names. */
+    tokens?: string[];
+    /** Optional app-owned prefix discovery. Empty string disables discovery. */
+    autoPrefix?: string;
+    /** Prefix for generated aliases. Defaults to `---g`. */
+    aliasPrefix?: string;
+    /** Additional reserved names or prefixes. Prefixes may end with `*`. */
+    reserved?: string[];
+    /** Optional global-var scan cache directory. */
+    cacheDir?: string;
+}
+/** Output from Phase H scanner/planner/diagnostics integration. */
+interface GlobalVarAliasValidationResult {
+    /** CSS scan results. */
+    scans: CssVarScanResult[];
+    /** Deterministic alias plan. */
+    plan: GlobalVarAliasPlan;
+    /** JS/JSX out-of-band usage diagnostics for planned candidates. */
+    usageDiagnostics: GlobalVarUsageDiagnostic[];
+}
+/** Options for rewriting CSS with a validated global variable alias plan. */
+interface RewriteGlobalVarCssAliasesOptions {
+    /** CSS source text. */
+    css: string;
+    /** Validated alias plan. Diagnostics keep the rewrite as a no-op. */
+    plan: GlobalVarAliasPlan;
+    /** Source file path used by PostCSS diagnostics/source maps. */
+    filePath?: string;
+}
+/** Result of a pure global variable CSS alias rewrite. */
+interface GlobalVarCssAliasRewriteResult {
+    /** Rewritten CSS source. */
+    css: string;
+    /** Number of alias declarations inserted. */
+    aliasDeclarations: number;
+    /** Number of `var(--token)` references rewritten. */
+    rewrittenReferences: number;
+    /** Planner diagnostics that prevented rewriting, when any. */
+    diagnostics: GlobalVarAliasDiagnostic[];
+}
+
+/**
+ * Extracts Phase H global custom-property aliases for manifest/debug tooling.
+ *
+ * The legacy `varMangleMap` also carries dynamic s/c-tier CSS variables. This
+ * helper keeps manifest consumers from guessing tiers by exposing only aliases
+ * that use the active generated prefix.
+ *
+ * @param varMangleMap CSS variable mangle metadata.
+ * @param aliasPrefix Active generated alias prefix.
+ * @param validationResult Validated CSS alias plan to include CSS-only aliases.
+ * @returns Original global variable names mapped to their generated aliases.
+ */
+declare function extractGlobalVarAliasesForManifest(varMangleMap: Record<string, CssVariableMangleValue>, aliasPrefix?: string, validationResult?: GlobalVarAliasValidationResult | null): Record<string, string>;
+/**
+ * Serializes the standalone global-var map asset when g-tier aliases exist.
+ *
+ * @param varMangleMap CSS variable mangle metadata.
+ * @param aliasPrefix Active generated alias prefix.
+ * @param validationResult Validated CSS alias plan to include CSS-only aliases.
+ * @returns JSON asset contents, or null when there are no global aliases.
+ */
+declare function createGlobalVarMapAssetSource(varMangleMap: Record<string, CssVariableMangleValue>, aliasPrefix?: string, validationResult?: GlobalVarAliasValidationResult | null): string | null;
+/**
+ * Normalizes compiler global-var aliases for transform-cache identity.
+ *
+ * @param aliases Compiler option value.
+ * @returns Stable original-to-alias entries.
+ */
+declare function normalizeGlobalVarAliasesForCache(aliases: TransformSourceCodeOptions['globalVarAliases']): Array<[string, string]>;
+/**
+ * Mangles class strings in bundled code (JS/HTML assets) using the given mangle map.
+ *
+ * Exported for unit testing; the plugin calls this via the thin private wrapper that
+ * supplies state.mangleMap.
+ *
+ * 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.)
+ *
+ * @param code     bundled source code
+ * @param mangleMap class-name → mangled-token mapping
+ * @returns code with mangled class names
+ */
+declare function mangleCodeClassesSync(code: string, mangleMap: Record<string, string>): string;
+declare const unplugin: UnpluginInstance<PartialCsszyxConfig, boolean>;
+/**
+ * Creates a Vite plugin array with both pre-transform and post-mangle plugins.
+ * @param options - csszyx configuration options
+ * @returns array of Vite plugins for pre-transform and post-mangle phases
+ */
+declare const vitePlugin: (options?: PartialCsszyxConfig) => PluginOption[];
+/**
+ * Creates a combined Webpack plugin that applies both pre-transform and post-mangle phases.
+ * @param options - csszyx configuration options
+ * @returns a Webpack plugin instance combining both phases
+ */
+declare const webpackPlugin: (options?: PartialCsszyxConfig) => WebpackPluginInstance;
+/**
+ * Creates a Rollup plugin array with both pre-transform and post-mangle plugins.
+ * @param options - csszyx configuration options
+ * @returns array of Rollup plugins for pre-transform and post-mangle phases
+ */
+declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption[];
+/**
+ * Creates an esbuild plugin that delegates setup to both pre-transform and post-mangle plugins.
+ * @param options - csszyx configuration options
+ * @returns an esbuild plugin combining both pre-transform and post-mangle phases
+ */
+declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
+
+export { createGlobalVarMapAssetSource as o, esbuildPlugin as p, extractGlobalVarAliasesForManifest as q, mangleCodeClassesSync as r, normalizeGlobalVarAliasesForCache as s, rollupPlugin as t, unplugin as u, vitePlugin as v, webpackPlugin as w };
+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 };