tailwindcss-patch 9.0.0 → 9.0.1

package/dist/validate-CIMnzW8O.d.mts

@@ -0,0 +1,685 @@
+import { PackageInfo, PackageResolvingOptions } from "local-pkg";
+import * as _$consola from "consola";
+import { Node, Rule } from "postcss";
+import { CAC, Command } from "cac";
+import { SourceEntry } from "@tailwindcss/oxide";
+import { Config } from "tailwindcss";
+//#region src/cache/types.d.ts
+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;
+}
+//#endregion
+//#region src/types.d.ts
+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[];
+}
+//#endregion
+//#region src/options/types.d.ts
+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;
+}
+//#endregion
+//#region src/patching/operations/export-context/index.d.ts
+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;
+//#endregion
+//#region src/patching/operations/extend-length-units.d.ts
+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[];
+};
+//#endregion
+//#region src/patching/patch-runner.d.ts
+interface PatchRunnerResult {
+  exposeContext?: ReturnType<typeof applyExposeContextPatch>;
+  extendLengthUnits?: ReturnType<typeof applyExtendLengthUnitsPatchV3> | ReturnType<typeof applyExtendLengthUnitsPatchV4>;
+}
+//#endregion
+//#region src/options/normalize.d.ts
+declare function normalizeOptions(options?: TailwindCssPatchOptions): NormalizedTailwindCssPatchOptions;
+//#endregion
+//#region src/config/workspace.d.ts
+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']>>;
+//#endregion
+//#region src/runtime/collector.d.ts
+type TailwindMajorVersion = 2 | 3 | 4;
+//#endregion
+//#region src/extraction/candidate-extractor.d.ts
+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;
+//#endregion
+//#region src/api/tailwindcss-patcher.d.ts
+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>;
+}
+//#endregion
+//#region src/logger.d.ts
+declare const logger: _$consola.ConsolaInstance;
+//#endregion
+//#region src/commands/migration-report.d.ts
+declare const MIGRATION_REPORT_KIND = "tw-patch-migrate-report";
+declare const MIGRATION_REPORT_SCHEMA_VERSION = 1;
+//#endregion
+//#region src/commands/migration-types.d.ts
+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[];
+}
+//#endregion
+//#region src/commands/token-output.d.ts
+type TokenOutputFormat = 'json' | 'lines' | 'grouped-json';
+type TokenGroupKey = 'relative' | 'absolute';
+//#endregion
+//#region src/commands/types.d.ts
+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;
+}
+//#endregion
+//#region src/commands/validate.d.ts
+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);
+}
+//#endregion
+export { TailwindTokenFileKey as $, groupTokensByFile as A, TailwindCssOptions as B, MIGRATION_REPORT_SCHEMA_VERSION as C, extractRawCandidates as D, extractProjectCandidatesWithPositions as E, ExposeContextOptions as F, ExtractResult as G, TailwindV2Options as H, ExtendLengthUnitsOptions as I, PatchName as J, ILengthUnitsPatchOptions as K, ExtractOptions as L, ApplyOptions as M, CacheOptions as N, extractRawCandidatesWithPositions as O, CacheStrategy as P, TailwindTokenByFileMap as Q, NormalizedCacheOptions as R, MIGRATION_REPORT_KIND as S, TailwindcssPatcher as T, TailwindV3Options as U, TailwindCssPatchOptions as V, TailwindV4Options as W, PatchStatusReport as X, PatchStatusEntry as Y, TailwindPatchRuntime as Z, ConfigFileMigrationEntry as _, ValidateFailureSummary as a, CacheClearResult as at, RestoreConfigFilesOptions as b, TailwindcssPatchCliMountOptions as c, CacheContextMetadata as ct, TailwindcssPatchCommandContext as d, CacheReadResult as dt, TailwindTokenLocation as et, TailwindcssPatchCommandHandler as f, tailwindcssPatchCommands as g, TailwindcssPatchCommandOptions as h, ValidateFailureReason as i, CacheClearOptions as it, normalizeOptions as j, extractValidCandidates as k, TailwindcssPatchCliOptions as l, CacheIndexFileV2 as lt, TailwindcssPatchCommandOptionDefinition as m, VALIDATE_FAILURE_REASONS as n, TailwindcssClassCache as nt, ValidateJsonFailurePayload as o, CacheClearScope as ot, TailwindcssPatchCommandHandlerMap as p, PatchCheckStatus as q, ValidateCommandError as r, TailwindcssRuntimeContext as rt, ValidateJsonSuccessPayload as s, CacheContextDescriptor as st, VALIDATE_EXIT_CODES as t, TailwindTokenReport as tt, TailwindcssPatchCommand as u, CacheReadMeta as ut, ConfigFileMigrationReport as v, logger as w, RestoreConfigFilesResult as x, MigrateConfigFilesOptions as y, NormalizedTailwindCssPatchOptions as z };