tailwindcss-patch 9.0.0-alpha.2 → 9.0.0-alpha.4

package/dist/index.d.mts

@@ -1,479 +1,15 @@
 import { TailwindcssMangleConfig } from '@tailwindcss-mangle/config';
-import { SourceEntry } from '@tailwindcss/oxide';
-import postcss, { Rule, Node } from 'postcss';
-import { Config } from 'tailwindcss';
-import { PackageResolvingOptions, PackageInfo } from 'local-pkg';
-import { Command, CAC } from 'cac';
-import * as consola from 'consola';
-
-type CacheStrategy = 'merge' | 'overwrite';
-type CacheDriver = 'file' | 'memory' | 'noop';
-/**
- * Configures how the Tailwind class cache is stored and where it lives on disk.
- */
-interface CacheOptions {
-    /** Whether caching is enabled. */
-    enabled?: boolean;
-    /** Working directory used when resolving cache paths. */
-    cwd?: string;
-    /** Directory where cache files are written. */
-    dir?: string;
-    /**
-     * Cache filename. Defaults to `class-cache.json` inside the derived cache folder
-     * when omitted.
-     */
-    file?: string;
-    /** Strategy used when merging new class lists with an existing cache. */
-    strategy?: CacheStrategy;
-    /** Backend used to persist the cache (`file`, `memory`, or `noop`). Defaults to `file`. */
-    driver?: CacheDriver;
-}
-/**
- * Preferred options for extraction output behavior.
- */
-interface ExtractOptions {
-    /** Whether to produce an output file. */
-    write?: boolean;
-    /** Optional absolute or relative path to the output file. */
-    file?: string;
-    /** Output format, defaults to JSON when omitted. */
-    format?: 'json' | 'lines';
-    /** Pretty-print spacing (truthy value enables indentation). */
-    pretty?: number | boolean;
-    /** Whether to strip the universal selector (`*`) from the final list. */
-    removeUniversalSelector?: boolean;
-}
-/**
- * Options controlling how Tailwind contexts are exposed during runtime patching.
- */
-interface ExposeContextOptions {
-    /** Name of the property used to reference an exposed context. */
-    refProperty?: string;
-}
-/**
- * Extends the built-in length-unit patch with custom defaults.
- */
-interface ExtendLengthUnitsOptions extends Partial<ILengthUnitsPatchOptions> {
-    /** Enables or disables the length-unit patch. */
-    enabled?: boolean;
-}
-/**
- * Preferred options for runtime patch behavior.
- */
-interface ApplyOptions {
-    /** Whether patched files can be overwritten on disk. */
-    overwrite?: boolean;
-    /** Whether to expose runtime Tailwind contexts (or configure how they are exposed). */
-    exposeContext?: boolean | ExposeContextOptions;
-    /** Extends the length-unit patch or disables it entirely. */
-    extendLengthUnits?: false | ExtendLengthUnitsOptions;
-}
-interface TailwindRuntimeOptionsBase {
-    /** Path to a Tailwind config file when auto-detection is insufficient. */
-    config?: string;
-    /** Custom working directory used when resolving config-relative paths. */
-    cwd?: string;
-    /** Optional PostCSS plugin name to use instead of the default. */
-    postcssPlugin?: string;
-}
-/**
- * Configuration specific to Tailwind CSS v2 patching flows.
- */
-interface TailwindV2Options extends TailwindRuntimeOptionsBase {
-}
-/**
- * Configuration specific to Tailwind CSS v3 patching flows.
- */
-interface TailwindV3Options extends TailwindRuntimeOptionsBase {
-}
-/**
- * Additional configuration specific to Tailwind CSS v4 extraction.
- */
-interface TailwindV4Options {
-    /** Base directory used when resolving v4 content sources and configs. */
-    base?: string;
-    /** Raw CSS passed directly to the v4 design system. */
-    css?: string;
-    /** Set of CSS entry files that should be scanned for `@config` directives. */
-    cssEntries?: string[];
-    /** Overrides the content sources scanned by the oxide scanner. */
-    sources?: SourceEntry[];
-}
-/**
- * High-level Tailwind patch configuration shared across versions.
- */
-interface TailwindCssOptions extends TailwindRuntimeOptionsBase {
-    /** Explicit Tailwind CSS major version used by the current project. When omitted, the installed package version is inferred. */
-    version?: 2 | 3 | 4;
-    /** Tailwind package name if the project uses a fork. */
-    packageName?: string;
-    /** Package resolution options forwarded to `local-pkg`. */
-    resolve?: PackageResolvingOptions;
-    /** Overrides applied when patching Tailwind CSS v2. */
-    v2?: TailwindV2Options;
-    /** Overrides applied when patching Tailwind CSS v3. */
-    v3?: TailwindV3Options;
-    /** Options specific to Tailwind CSS v4 patching. */
-    v4?: TailwindV4Options;
-}
-/**
- * Root configuration consumed by the Tailwind CSS patch runner.
- */
-interface TailwindCssPatchOptions {
-    /**
-     * Base directory used when resolving Tailwind resources.
-     * Defaults to `process.cwd()`.
-     */
-    projectRoot?: string;
-    /** Preferred Tailwind runtime configuration. */
-    tailwindcss?: TailwindCssOptions;
-    /** Preferred patch toggles. */
-    apply?: ApplyOptions;
-    /** Preferred extraction output settings. */
-    extract?: ExtractOptions;
-    /** Optional function that filters final class names. */
-    filter?: (className: string) => boolean;
-    /** Cache configuration or boolean to enable/disable quickly. */
-    cache?: boolean | CacheOptions;
-}
-/**
- * Stable shape for output configuration after normalization.
- */
-interface NormalizedOutputOptions {
-    enabled: boolean;
-    file?: string;
-    format: 'json' | 'lines';
-    pretty: number | false;
-    removeUniversalSelector: boolean;
-}
-/**
- * Stable cache configuration used internally after defaults are applied.
- */
-interface NormalizedCacheOptions {
-    enabled: boolean;
-    cwd: string;
-    dir: string;
-    file: string;
-    path: string;
-    strategy: CacheStrategy;
-    driver: CacheDriver;
-}
-/** Tracks whether runtime contexts should be exposed and via which property. */
-interface NormalizedExposeContextOptions {
-    enabled: boolean;
-    refProperty: string;
-}
-/** Normalized representation of the extend-length-units feature flag. */
-interface NormalizedExtendLengthUnitsOptions extends ILengthUnitsPatchOptions {
-    enabled: boolean;
-}
-/** Normalized Tailwind v4 configuration consumed by runtime helpers. */
-interface NormalizedTailwindV4Options {
-    base: string;
-    configuredBase?: string;
-    css?: string;
-    cssEntries: string[];
-    sources: SourceEntry[];
-    hasUserDefinedSources: boolean;
-}
-/**
- * Tailwind configuration ready for consumption by the runtime after normalization.
- */
-interface NormalizedTailwindConfigOptions extends TailwindRuntimeOptionsBase {
-    packageName: string;
-    versionHint?: 2 | 3 | 4;
-    resolve?: PackageResolvingOptions;
-    v2?: TailwindV2Options;
-    v3?: TailwindV3Options;
-    v4?: NormalizedTailwindV4Options;
-}
-/** Grouped normalized feature flags. */
-interface NormalizedFeatureOptions {
-    exposeContext: NormalizedExposeContextOptions;
-    extendLengthUnits: NormalizedExtendLengthUnitsOptions | null;
-}
-/** Final normalized shape consumed throughout the patch runtime. */
-interface NormalizedTailwindCssPatchOptions {
-    projectRoot: string;
-    overwrite: boolean;
-    tailwind: NormalizedTailwindConfigOptions;
-    features: NormalizedFeatureOptions;
-    output: NormalizedOutputOptions;
-    cache: NormalizedCacheOptions;
-    filter: (className: string) => boolean;
-}
-
-declare const CACHE_SCHEMA_VERSION = 2;
-declare const CACHE_FINGERPRINT_VERSION = 1;
-type CacheSchemaVersion = typeof CACHE_SCHEMA_VERSION;
-type CacheFingerprintVersion = typeof CACHE_FINGERPRINT_VERSION;
-type CacheClearScope = 'current' | 'all';
-interface CacheContextMetadata {
-    fingerprintVersion: CacheFingerprintVersion;
-    projectRootRealpath: string;
-    processCwdRealpath: string;
-    cacheCwdRealpath: string;
-    tailwindConfigPath?: string;
-    tailwindConfigMtimeMs?: number;
-    tailwindPackageRootRealpath: string;
-    tailwindPackageVersion: string;
-    patcherVersion: string;
-    majorVersion: 2 | 3 | 4;
-    optionsHash: string;
-}
-interface CacheContextDescriptor {
-    fingerprint: string;
-    metadata: CacheContextMetadata;
-}
-interface CacheIndexEntry {
-    context: CacheContextMetadata;
-    values: string[];
-    updatedAt: string;
-}
-interface CacheIndexFileV2 {
-    schemaVersion: CacheSchemaVersion;
-    updatedAt: string;
-    contexts: Record<string, CacheIndexEntry>;
-}
-type CacheReadReason = 'hit' | 'cache-disabled' | 'noop-driver' | 'file-missing' | 'context-not-found' | 'context-mismatch' | 'legacy-schema' | 'invalid-schema';
-interface CacheReadMeta {
-    hit: boolean;
-    reason: CacheReadReason;
-    fingerprint?: string;
-    schemaVersion?: number;
-    details: string[];
-}
-interface CacheReadResult {
-    data: Set<string>;
-    meta: CacheReadMeta;
-}
-interface CacheClearOptions {
-    scope?: CacheClearScope;
-}
-interface CacheClearResult {
-    scope: CacheClearScope;
-    filesRemoved: number;
-    entriesRemoved: number;
-    contextsRemoved: number;
-}
-
-type TailwindcssClassCacheEntry = Rule | {
-    layer: string;
-    options: Record<string, any>;
-    sort: Record<string, any>;
-};
-type TailwindcssClassCache = Map<string, TailwindcssClassCacheEntry[]>;
-interface TailwindcssRuntimeContext {
-    applyClassCache: Map<any, any>;
-    candidateRuleCache: Map<string, Set<[
-        {
-            arbitrary: any;
-            index: any;
-            layer: string;
-            options: any[];
-            parallelIndex: any;
-            parentLayer: string;
-            variants: any;
-        },
-        Node
-    ]>>;
-    candidateRuleMap: Map<string | string, [object, Node][]>;
-    changedContent: any[];
-    classCache: TailwindcssClassCache;
-    disposables: any[];
-    getClassList: (...args: any[]) => any;
-    getClassOrder: (...args: any[]) => any;
-    getVariants: (...args: any[]) => any;
-    markInvalidUtilityCandidate: (...args: any[]) => any;
-    markInvalidUtilityNode: (...args: any[]) => any;
-    notClassCache: Set<string>;
-    offsets: {
-        layerPositions: object;
-        offsets: object;
-        reservedVariantBits: any;
-        variantOffsets: Map<string, any>;
-    };
-    postCssNodeCache: Map<object, [Node]>;
-    ruleCache: Set<[object, Node]>;
-    stylesheetCache: Record<string, Set<any>>;
-    tailwindConfig: Config;
-    userConfigPath: string | null;
-    variantMap: Map<string, [[object, (...args: any[]) => unknown]]>;
-    variantOptions: Map<string, object>;
-}
-interface ExtractResult {
-    classList: string[];
-    classSet: Set<string>;
-    filename?: string;
-}
-interface TailwindTokenLocation {
-    rawCandidate: string;
-    file: string;
-    relativeFile: string;
-    extension: string;
-    start: number;
-    end: number;
-    length: number;
-    line: number;
-    column: number;
-    lineText: string;
-}
-type TailwindTokenFileKey = 'relative' | 'absolute';
-interface TailwindTokenReport {
-    entries: TailwindTokenLocation[];
-    filesScanned: number;
-    sources: SourceEntry[];
-    skippedFiles: {
-        file: string;
-        reason: string;
-    }[];
-}
-type TailwindTokenByFileMap = Record<string, TailwindTokenLocation[]>;
-interface TailwindPatchRuntime {
-    options: NormalizedTailwindCssPatchOptions;
-    majorVersion: 2 | 3 | 4;
-}
-
-interface ILengthUnitsPatchOptions {
-    units: string[];
-    lengthUnitsFilePath?: string;
-    variableName?: string;
-    overwrite?: boolean;
-    destPath?: string;
-}
-type PatchCheckStatus = 'applied' | 'not-applied' | 'skipped' | 'unsupported';
-type PatchName = 'exposeContext' | 'extendLengthUnits';
-interface PatchStatusEntry {
-    name: PatchName;
-    status: PatchCheckStatus;
-    reason?: string;
-    files: string[];
-}
-interface PatchStatusReport {
-    package: {
-        name?: string;
-        version?: string;
-        root: string;
-    };
-    majorVersion: 2 | 3 | 4;
-    entries: PatchStatusEntry[];
-}
-
-interface ExposeContextPatchParams {
-    rootDir: string;
-    refProperty: string;
-    overwrite: boolean;
-    majorVersion: 2 | 3;
-}
-interface ExposeContextPatchResult {
-    applied: boolean;
-    files: Record<string, string>;
-}
-declare function applyExposeContextPatch(params: ExposeContextPatchParams): ExposeContextPatchResult;
-
-declare function applyExtendLengthUnitsPatchV3(rootDir: string, options: NormalizedExtendLengthUnitsOptions): {
-    changed: boolean;
-    code: undefined;
-} | {
-    changed: boolean;
-    code: string;
-};
-interface V4FilePatch {
-    file: string;
-    code: string;
-    hasPatched: boolean;
-}
-interface V4Candidate extends V4FilePatch {
-    match: RegExpExecArray;
-}
-declare function applyExtendLengthUnitsPatchV4(rootDir: string, options: NormalizedExtendLengthUnitsOptions): {
-    changed: boolean;
-    files: V4Candidate[];
-};
-
-interface PatchRunnerResult {
-    exposeContext?: ReturnType<typeof applyExposeContextPatch>;
-    extendLengthUnits?: ReturnType<typeof applyExtendLengthUnitsPatchV3> | ReturnType<typeof applyExtendLengthUnitsPatchV4>;
-}
+import { CAC } from 'cac';
+import { n as TailwindCssPatchOptions, N as NormalizedTailwindCssPatchOptions, o as NormalizedCacheOptions, C as CacheContextDescriptor, p as CacheReadResult, q as CacheReadMeta, r as CacheClearOptions, s as CacheClearResult, u as CacheIndexFileV2, M as MigrateConfigFilesOptions, v as ConfigFileMigrationReport, R as RestoreConfigFilesOptions, w as RestoreConfigFilesResult, x as TailwindcssRuntimeContext, P as PatchStatusReport, T as TailwindcssPatchCliOptions, a as TailwindcssPatchCliMountOptions } from './validate-nbmOI2w8.mjs';
+export { A as ApplyOptions, y as CacheClearScope, z as CacheContextMetadata, B as CacheOptions, D as CacheStrategy, E as ConfigFileMigrationEntry, F as ExposeContextOptions, G as ExtendLengthUnitsOptions, H as ExtractOptions, I as ExtractResult, J as ILengthUnitsPatchOptions, K as MIGRATION_REPORT_KIND, L as MIGRATION_REPORT_SCHEMA_VERSION, O as PatchCheckStatus, Q as PatchName, S as PatchStatusEntry, U as TailwindCssOptions, W as TailwindPatchRuntime, X as TailwindTokenByFileMap, Y as TailwindTokenFileKey, Z as TailwindTokenLocation, _ as TailwindTokenReport, $ as TailwindV2Options, a0 as TailwindV3Options, a1 as TailwindV4Options, a2 as TailwindcssClassCache, b as TailwindcssPatchCommand, c as TailwindcssPatchCommandContext, d as TailwindcssPatchCommandHandler, e as TailwindcssPatchCommandHandlerMap, f as TailwindcssPatchCommandOptionDefinition, g as TailwindcssPatchCommandOptions, a3 as TailwindcssPatcher, V as VALIDATE_EXIT_CODES, h as VALIDATE_FAILURE_REASONS, i as ValidateCommandError, j as ValidateFailureReason, k as ValidateFailureSummary, l as ValidateJsonFailurePayload, m as ValidateJsonSuccessPayload, a4 as extractProjectCandidatesWithPositions, a5 as extractRawCandidates, a6 as extractRawCandidatesWithPositions, a7 as extractValidCandidates, a8 as groupTokensByFile, a9 as logger, t as tailwindcssPatchCommands } from './validate-nbmOI2w8.mjs';
+import { PackageInfo } from 'local-pkg';
+import postcss from 'postcss';
+import '@tailwindcss/oxide';
+import 'tailwindcss';
+import 'consola';
 
 declare function normalizeOptions(options?: TailwindCssPatchOptions): NormalizedTailwindCssPatchOptions;
 
-interface TailwindcssConfigModule {
-    CONFIG_NAME: string;
-    getConfig: (cwd?: string) => Promise<{
-        config?: {
-            registry?: unknown;
-            patch?: unknown;
-        };
-    }>;
-    initConfig: (cwd: string) => Promise<unknown>;
-}
-type TailwindcssConfigResult = Awaited<ReturnType<TailwindcssConfigModule['getConfig']>>;
-
-interface ExtractValidCandidatesOption {
-    sources?: SourceEntry[];
-    base?: string;
-    baseFallbacks?: string[];
-    css?: string;
-    cwd?: string;
-}
-declare function extractRawCandidatesWithPositions(content: string, extension?: string): Promise<{
-    rawCandidate: string;
-    start: number;
-    end: number;
-}[]>;
-declare function extractRawCandidates(sources?: SourceEntry[]): Promise<string[]>;
-declare function extractValidCandidates(options?: ExtractValidCandidatesOption): Promise<string[]>;
-interface ExtractProjectCandidatesOptions {
-    cwd?: string;
-    sources?: SourceEntry[];
-}
-declare function extractProjectCandidatesWithPositions(options?: ExtractProjectCandidatesOptions): Promise<TailwindTokenReport>;
-declare function groupTokensByFile(report: TailwindTokenReport, options?: {
-    key?: TailwindTokenFileKey;
-    stripAbsolutePaths?: boolean;
-}): TailwindTokenByFileMap;
-
-type TailwindMajorVersion = 2 | 3 | 4;
-
-declare class TailwindcssPatcher {
-    readonly options: NormalizedTailwindCssPatchOptions;
-    readonly packageInfo: PackageInfo;
-    readonly majorVersion: TailwindMajorVersion;
-    private readonly cacheContext;
-    private readonly cacheStore;
-    private readonly collector;
-    private patchMemo;
-    constructor(options?: TailwindCssPatchOptions);
-    patch(): Promise<PatchRunnerResult>;
-    getPatchStatus(): Promise<PatchStatusReport>;
-    getContexts(): TailwindcssRuntimeContext[];
-    private createPatchSnapshot;
-    private collectClassSet;
-    private runTailwindBuildIfNeeded;
-    private debugCacheRead;
-    private mergeWithCache;
-    private mergeWithCacheSync;
-    private areSetsEqual;
-    getClassSet(): Promise<Set<string>>;
-    getClassSetSync(): Set<string> | undefined;
-    extract(options?: {
-        write?: boolean;
-    }): Promise<ExtractResult>;
-    clearCache(options?: CacheClearOptions): Promise<CacheClearResult>;
-    extractValidCandidates: typeof extractValidCandidates;
-    collectContentTokens(options?: {
-        cwd?: string;
-        sources?: SourceEntry[];
-    }): Promise<TailwindTokenReport>;
-    collectContentTokensByFile(options?: {
-        cwd?: string;
-        sources?: SourceEntry[];
-        key?: TailwindTokenFileKey;
-        stripAbsolutePaths?: boolean;
-    }): Promise<TailwindTokenByFileMap>;
-}
-
 declare class CacheStore {
     private readonly options;
     private readonly context?;
@@ -518,212 +54,6 @@ declare class CacheStore {
     readIndexSnapshot(): CacheIndexFileV2 | undefined;
 }
 
-declare const logger: consola.ConsolaInstance;
-
-declare const MIGRATION_REPORT_KIND = "tw-patch-migrate-report";
-declare const MIGRATION_REPORT_SCHEMA_VERSION = 1;
-
-interface ConfigFileMigrationEntry {
-    file: string;
-    changed: boolean;
-    written: boolean;
-    rolledBack: boolean;
-    backupFile?: string;
-    changes: string[];
-}
-interface ConfigFileMigrationReport {
-    reportKind: typeof MIGRATION_REPORT_KIND;
-    schemaVersion: typeof MIGRATION_REPORT_SCHEMA_VERSION;
-    generatedAt: string;
-    tool: {
-        name: string;
-        version: string;
-    };
-    cwd: string;
-    dryRun: boolean;
-    rollbackOnError: boolean;
-    backupDirectory?: string;
-    scannedFiles: number;
-    changedFiles: number;
-    writtenFiles: number;
-    backupsWritten: number;
-    unchangedFiles: number;
-    missingFiles: number;
-    entries: ConfigFileMigrationEntry[];
-}
-interface MigrateConfigFilesOptions {
-    cwd: string;
-    files?: string[];
-    dryRun?: boolean;
-    workspace?: boolean;
-    maxDepth?: number;
-    rollbackOnError?: boolean;
-    backupDir?: string;
-    include?: string[];
-    exclude?: string[];
-}
-interface RestoreConfigFilesOptions {
-    cwd: string;
-    reportFile: string;
-    dryRun?: boolean;
-    strict?: boolean;
-}
-interface RestoreConfigFilesResult {
-    cwd: string;
-    reportFile: string;
-    reportKind?: string;
-    reportSchemaVersion?: number;
-    dryRun: boolean;
-    strict: boolean;
-    scannedEntries: number;
-    restorableEntries: number;
-    restoredFiles: number;
-    missingBackups: number;
-    skippedEntries: number;
-    restored: string[];
-}
-
-type TokenOutputFormat = 'json' | 'lines' | 'grouped-json';
-type TokenGroupKey = 'relative' | 'absolute';
-
-type TailwindcssPatchCommand = 'install' | 'extract' | 'tokens' | 'init' | 'migrate' | 'restore' | 'validate' | 'status';
-declare const tailwindcssPatchCommands: TailwindcssPatchCommand[];
-type CacOptionConfig = Parameters<Command['option']>[2];
-interface TailwindcssPatchCommandOptionDefinition {
-    flags: string;
-    description?: string;
-    config?: CacOptionConfig;
-}
-interface TailwindcssPatchCommandOptions {
-    name?: string;
-    aliases?: string[];
-    description?: string;
-    optionDefs?: TailwindcssPatchCommandOptionDefinition[];
-    appendDefaultOptions?: boolean;
-}
-interface BaseCommandArgs {
-    cwd: string;
-}
-interface InstallCommandArgs extends BaseCommandArgs {
-}
-interface ExtractCommandArgs extends BaseCommandArgs {
-    output?: string;
-    format?: 'json' | 'lines';
-    css?: string;
-    write?: boolean;
-}
-interface TokensCommandArgs extends BaseCommandArgs {
-    output?: string;
-    format?: TokenOutputFormat;
-    groupKey?: TokenGroupKey;
-    write?: boolean;
-}
-interface InitCommandArgs extends BaseCommandArgs {
-}
-interface MigrateCommandArgs extends BaseCommandArgs {
-    config?: string;
-    dryRun?: boolean;
-    workspace?: boolean;
-    maxDepth?: string | number;
-    include?: string | string[];
-    exclude?: string | string[];
-    reportFile?: string;
-    backupDir?: string;
-    check?: boolean;
-    json?: boolean;
-}
-interface RestoreCommandArgs extends BaseCommandArgs {
-    reportFile?: string;
-    dryRun?: boolean;
-    strict?: boolean;
-    json?: boolean;
-}
-interface ValidateCommandArgs extends BaseCommandArgs {
-    reportFile?: string;
-    strict?: boolean;
-    json?: boolean;
-}
-interface StatusCommandArgs extends BaseCommandArgs {
-    json?: boolean;
-}
-interface TailwindcssPatchCommandArgMap {
-    install: InstallCommandArgs;
-    extract: ExtractCommandArgs;
-    tokens: TokensCommandArgs;
-    init: InitCommandArgs;
-    migrate: MigrateCommandArgs;
-    restore: RestoreCommandArgs;
-    validate: ValidateCommandArgs;
-    status: StatusCommandArgs;
-}
-interface TailwindcssPatchCommandResultMap {
-    install: void;
-    extract: ExtractResult;
-    tokens: TailwindTokenReport;
-    init: void;
-    migrate: ConfigFileMigrationReport;
-    restore: RestoreConfigFilesResult;
-    validate: RestoreConfigFilesResult;
-    status: PatchStatusReport;
-}
-interface TailwindcssPatchCommandContext<TCommand extends TailwindcssPatchCommand> {
-    cli: CAC;
-    command: Command;
-    commandName: TCommand;
-    args: TailwindcssPatchCommandArgMap[TCommand];
-    cwd: string;
-    logger: typeof logger;
-    loadConfig: () => Promise<TailwindcssConfigResult>;
-    loadPatchOptions: (overrides?: TailwindCssPatchOptions) => Promise<TailwindCssPatchOptions>;
-    createPatcher: (overrides?: TailwindCssPatchOptions) => Promise<TailwindcssPatcher>;
-}
-type TailwindcssPatchCommandHandler<TCommand extends TailwindcssPatchCommand> = (context: TailwindcssPatchCommandContext<TCommand>, next: () => Promise<TailwindcssPatchCommandResultMap[TCommand]>) => Promise<TailwindcssPatchCommandResultMap[TCommand]> | TailwindcssPatchCommandResultMap[TCommand];
-type TailwindcssPatchCommandHandlerMap = Partial<{
-    [K in TailwindcssPatchCommand]: TailwindcssPatchCommandHandler<K>;
-}>;
-interface TailwindcssPatchCliMountOptions {
-    commandPrefix?: string;
-    commands?: TailwindcssPatchCommand[];
-    commandOptions?: Partial<Record<TailwindcssPatchCommand, TailwindcssPatchCommandOptions>>;
-    commandHandlers?: TailwindcssPatchCommandHandlerMap;
-}
-interface TailwindcssPatchCliOptions {
-    name?: string;
-    mountOptions?: TailwindcssPatchCliMountOptions;
-}
-
-declare const VALIDATE_EXIT_CODES: {
-    readonly OK: 0;
-    readonly REPORT_INCOMPATIBLE: 21;
-    readonly MISSING_BACKUPS: 22;
-    readonly IO_ERROR: 23;
-    readonly UNKNOWN_ERROR: 24;
-};
-declare const VALIDATE_FAILURE_REASONS: readonly ["report-incompatible", "missing-backups", "io-error", "unknown-error"];
-type ValidateFailureReason = (typeof VALIDATE_FAILURE_REASONS)[number];
-interface ValidateFailureSummary {
-    reason: ValidateFailureReason;
-    exitCode: number;
-    message: string;
-}
-interface ValidateJsonSuccessPayload extends RestoreConfigFilesResult {
-    ok: true;
-}
-interface ValidateJsonFailurePayload {
-    ok: false;
-    reason: ValidateFailureReason;
-    exitCode: number;
-    message: string;
-}
-declare class ValidateCommandError extends Error {
-    reason: ValidateFailureReason;
-    exitCode: number;
-    constructor(summary: ValidateFailureSummary, options?: ErrorOptions);
-}
-
-declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
-declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
-
 declare function migrateConfigFiles(options: MigrateConfigFilesOptions): Promise<ConfigFileMigrationReport>;
 declare function restoreConfigFiles(options: RestoreConfigFilesOptions): Promise<RestoreConfigFilesResult>;
 
@@ -747,6 +77,8 @@ interface PatchStatusContext {
 }
 declare function getPatchStatusReport(context: PatchStatusContext): PatchStatusReport;
 
+declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
+declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
 declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
 
-export { type ApplyOptions, type CacheClearOptions, type CacheClearResult, type CacheClearScope, type CacheContextMetadata, type CacheOptions, type CacheReadMeta, CacheStore, type CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, type ExposeContextOptions, type ExtendLengthUnitsOptions, type ExtractOptions, type ExtractResult, type ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, type NormalizedTailwindCssPatchOptions, type PatchCheckStatus, type PatchName, type PatchStatusEntry, type PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, type TailwindCssOptions, type TailwindCssPatchOptions, type TailwindPatchRuntime, type TailwindTokenByFileMap, type TailwindTokenFileKey, type TailwindTokenLocation, type TailwindTokenReport, type TailwindV2Options, type TailwindV3Options, type TailwindV4Options, type TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, TailwindcssPatcher, type TailwindcssRuntimeContext, VALIDATE_EXIT_CODES, VALIDATE_FAILURE_REASONS, ValidateCommandError, type ValidateFailureReason, type ValidateFailureSummary, type ValidateJsonFailurePayload, type ValidateJsonSuccessPayload, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };
+export { CacheClearOptions, CacheClearResult, CacheReadMeta, CacheStore, ConfigFileMigrationReport, MigrateConfigFilesOptions, NormalizedTailwindCssPatchOptions, PatchStatusReport, RestoreConfigFilesOptions, RestoreConfigFilesResult, TailwindCssPatchOptions, TailwindcssPatchCliMountOptions, TailwindcssPatchCliOptions, TailwindcssRuntimeContext, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindcssPatchCli, defineConfig, getPatchStatusReport, loadRuntimeContexts, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, restoreConfigFiles, runTailwindBuild };