tailwindcss-patch 8.7.4-alpha.0 → 9.0.0-alpha.2

package/dist/cli.js

@@ -2,23 +2,23 @@
 
 
 
-var _chunkZXW4S356js = require('./chunk-ZXW4S356.js');
+var _chunkTOAZIPHJjs = require('./chunk-TOAZIPHJ.js');
 require('./chunk-5CWNAWKP.js');
 
 // src/cli.ts
 var _process = require('process'); var _process2 = _interopRequireDefault(_process);
 async function main() {
-  const cli = _chunkZXW4S356js.createTailwindcssPatchCli.call(void 0, );
+  const cli = _chunkTOAZIPHJjs.createTailwindcssPatchCli.call(void 0, );
   cli.help();
   cli.parse(_process2.default.argv, { run: false });
   await cli.runMatchedCommand();
 }
 main().catch((error) => {
-  if (error instanceof _chunkZXW4S356js.ValidateCommandError) {
+  if (error instanceof _chunkTOAZIPHJjs.ValidateCommandError) {
     _process2.default.exitCode = error.exitCode;
     return;
   }
   const message = error instanceof Error ? error.message : String(error);
-  _chunkZXW4S356js.logger_default.error(message);
+  _chunkTOAZIPHJjs.logger_default.error(message);
   _process2.default.exitCode = 1;
 });

package/dist/cli.mjs

@@ -2,7 +2,7 @@ import {
   ValidateCommandError,
   createTailwindcssPatchCli,
   logger_default
-} from "./chunk-6ZDYMYHE.mjs";
+} from "./chunk-VDWTCQ74.mjs";
 import "./chunk-A67ABH3M.mjs";
 
 // src/cli.ts

package/dist/index.d.mts

@@ -1,9 +1,8 @@
+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 { TailwindLocatorOptions, TailwindNextOptions } from '@tailwindcss-mangle/config';
-export { defineConfig } from '@tailwindcss-mangle/config';
 import { Command, CAC } from 'cac';
 import * as consola from 'consola';
 
@@ -12,7 +11,7 @@ type CacheDriver = 'file' | 'memory' | 'noop';
 /**
  * Configures how the Tailwind class cache is stored and where it lives on disk.
  */
-interface CacheUserOptions {
+interface CacheOptions {
     /** Whether caching is enabled. */
     enabled?: boolean;
     /** Working directory used when resolving cache paths. */
@@ -32,7 +31,7 @@ interface CacheUserOptions {
 /**
  * Preferred options for extraction output behavior.
  */
-interface TailwindExtractionUserOptions {
+interface ExtractOptions {
     /** Whether to produce an output file. */
     write?: boolean;
     /** Optional absolute or relative path to the output file. */
@@ -44,61 +43,32 @@ interface TailwindExtractionUserOptions {
     /** Whether to strip the universal selector (`*`) from the final list. */
     removeUniversalSelector?: boolean;
 }
-/**
- * @deprecated Use `TailwindExtractionUserOptions`.
- * Legacy output options kept for backward compatibility and will be removed in the next major version.
- */
-interface OutputUserOptions {
-    /** @deprecated Use `extract.write` instead. */
-    enabled?: boolean;
-    /** @deprecated Use `extract.file` instead. */
-    file?: string;
-    /** @deprecated Use `extract.format` instead. */
-    format?: 'json' | 'lines';
-    /** @deprecated Use `extract.pretty` instead. */
-    pretty?: number | boolean;
-    /** @deprecated Use `extract.removeUniversalSelector` instead. */
-    removeUniversalSelector?: boolean;
-}
 /**
  * Options controlling how Tailwind contexts are exposed during runtime patching.
  */
-interface ExposeContextUserOptions {
+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 ExtendLengthUnitsUserOptions extends Partial<ILengthUnitsPatchOptions> {
+interface ExtendLengthUnitsOptions extends Partial<ILengthUnitsPatchOptions> {
     /** Enables or disables the length-unit patch. */
     enabled?: boolean;
 }
 /**
  * Preferred options for runtime patch behavior.
  */
-interface PatchApplyUserOptions {
+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 | ExposeContextUserOptions;
+    exposeContext?: boolean | ExposeContextOptions;
     /** Extends the length-unit patch or disables it entirely. */
-    extendLengthUnits?: false | ExtendLengthUnitsUserOptions;
-}
-/**
- * @deprecated Use `PatchApplyUserOptions`.
- * Legacy nested feature options kept for backward compatibility and will be removed in the next major version.
- */
-interface FeatureUserOptions {
-    /** @deprecated Use `apply.exposeContext` instead. */
-    exposeContext?: boolean | ExposeContextUserOptions;
-    /** @deprecated Use `apply.extendLengthUnits` instead. */
-    extendLengthUnits?: false | ExtendLengthUnitsUserOptions;
+    extendLengthUnits?: false | ExtendLengthUnitsOptions;
 }
-/**
- * Shared configuration used for Tailwind v2/v3 patching flows.
- */
-interface TailwindRuntimeConfigUserOptions {
+interface TailwindRuntimeOptionsBase {
     /** Path to a Tailwind config file when auto-detection is insufficient. */
     config?: string;
     /** Custom working directory used when resolving config-relative paths. */
@@ -107,15 +77,19 @@ interface TailwindRuntimeConfigUserOptions {
     postcssPlugin?: string;
 }
 /**
- * @deprecated Use `TailwindRuntimeConfigUserOptions`.
- * Legacy naming kept for backward compatibility and will be removed in the next major version.
+ * Configuration specific to Tailwind CSS v2 patching flows.
  */
-interface TailwindConfigUserOptions extends TailwindRuntimeConfigUserOptions {
+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 TailwindV4RuntimeUserOptions {
+interface TailwindV4Options {
     /** Base directory used when resolving v4 content sources and configs. */
     base?: string;
     /** Raw CSS passed directly to the v4 design system. */
@@ -128,65 +102,39 @@ interface TailwindV4RuntimeUserOptions {
 /**
  * High-level Tailwind patch configuration shared across versions.
  */
-interface TailwindcssUserOptions extends TailwindRuntimeConfigUserOptions {
-    /**
-     * Optional hint for picking the patch strategy.
-     * When omitted we infer from the installed Tailwind CSS package version.
-     */
+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?: TailwindRuntimeConfigUserOptions;
+    v2?: TailwindV2Options;
     /** Overrides applied when patching Tailwind CSS v3. */
-    v3?: TailwindRuntimeConfigUserOptions;
+    v3?: TailwindV3Options;
     /** Options specific to Tailwind CSS v4 patching. */
-    v4?: TailwindV4RuntimeUserOptions;
-}
-/**
- * @deprecated Use `TailwindcssUserOptions`.
- * Legacy naming kept for backward compatibility and will be removed in the next major version.
- */
-interface TailwindUserOptions extends TailwindcssUserOptions {
+    v4?: TailwindV4Options;
 }
 /**
  * Root configuration consumed by the Tailwind CSS patch runner.
  */
-interface TailwindcssPatchOptions {
+interface TailwindCssPatchOptions {
     /**
      * Base directory used when resolving Tailwind resources.
      * Defaults to `process.cwd()`.
      */
     projectRoot?: string;
     /** Preferred Tailwind runtime configuration. */
-    tailwindcss?: TailwindcssUserOptions;
+    tailwindcss?: TailwindCssOptions;
     /** Preferred patch toggles. */
-    apply?: PatchApplyUserOptions;
+    apply?: ApplyOptions;
     /** Preferred extraction output settings. */
-    extract?: TailwindExtractionUserOptions;
+    extract?: ExtractOptions;
     /** Optional function that filters final class names. */
     filter?: (className: string) => boolean;
     /** Cache configuration or boolean to enable/disable quickly. */
-    cache?: boolean | CacheUserOptions;
-    /**
-     * Base directory used when resolving Tailwind resources.
-     * Defaults to `process.cwd()`.
-     * @deprecated Use `projectRoot` instead.
-     */
-    cwd?: string;
-    /**
-     * Whether to overwrite generated artifacts (e.g., caches, outputs).
-     * @deprecated Use `apply.overwrite` instead.
-     */
-    overwrite?: boolean;
-    /** @deprecated Use `tailwindcss` instead. */
-    tailwind?: TailwindUserOptions;
-    /** @deprecated Use `apply` instead. */
-    features?: FeatureUserOptions;
-    /** @deprecated Use `extract` instead. */
-    output?: OutputUserOptions;
+    cache?: boolean | CacheOptions;
 }
 /**
  * Stable shape for output configuration after normalization.
@@ -231,12 +179,12 @@ interface NormalizedTailwindV4Options {
 /**
  * Tailwind configuration ready for consumption by the runtime after normalization.
  */
-interface NormalizedTailwindConfigOptions extends TailwindConfigUserOptions {
+interface NormalizedTailwindConfigOptions extends TailwindRuntimeOptionsBase {
     packageName: string;
     versionHint?: 2 | 3 | 4;
     resolve?: PackageResolvingOptions;
-    v2?: TailwindConfigUserOptions;
-    v3?: TailwindConfigUserOptions;
+    v2?: TailwindV2Options;
+    v3?: TailwindV3Options;
     v4?: NormalizedTailwindV4Options;
 }
 /** Grouped normalized feature flags. */
@@ -245,7 +193,7 @@ interface NormalizedFeatureOptions {
     extendLengthUnits: NormalizedExtendLengthUnitsOptions | null;
 }
 /** Final normalized shape consumed throughout the patch runtime. */
-interface NormalizedTailwindcssPatchOptions {
+interface NormalizedTailwindCssPatchOptions {
     projectRoot: string;
     overwrite: boolean;
     tailwind: NormalizedTailwindConfigOptions;
@@ -382,7 +330,7 @@ interface TailwindTokenReport {
 }
 type TailwindTokenByFileMap = Record<string, TailwindTokenLocation[]>;
 interface TailwindPatchRuntime {
-    options: NormalizedTailwindcssPatchOptions;
+    options: NormalizedTailwindCssPatchOptions;
     majorVersion: 2 | 3 | 4;
 }
 
@@ -448,52 +396,14 @@ interface PatchRunnerResult {
     extendLengthUnits?: ReturnType<typeof applyExtendLengthUnitsPatchV3> | ReturnType<typeof applyExtendLengthUnitsPatchV4>;
 }
 
-interface LegacyCacheOptions {
-    dir?: string;
-    cwd?: string;
-    file?: string;
-    strategy?: 'merge' | 'overwrite';
-    enabled?: boolean;
-}
-interface LegacyOutputOptions {
-    filename?: string;
-    loose?: boolean;
-    removeUniversalSelector?: boolean;
-}
-interface LegacyTailwindcssOptions {
-    version?: 2 | 3 | 4;
-    v2?: TailwindLocatorOptions;
-    v3?: TailwindLocatorOptions;
-    v4?: TailwindNextOptions;
-    config?: string;
-    cwd?: string;
-}
-interface LegacyPatchOptions {
-    packageName?: string;
-    output?: LegacyOutputOptions;
-    tailwindcss?: LegacyTailwindcssOptions;
-    overwrite?: boolean;
-    applyPatches?: {
-        exportContext?: boolean;
-        extendLengthUnits?: boolean | ILengthUnitsPatchOptions;
-    };
-    filter?: (className: string) => boolean;
-    cwd?: string;
-    resolve?: PackageResolvingOptions;
-}
-interface LegacyTailwindcssPatcherOptions {
-    cache?: LegacyCacheOptions | boolean;
-    patch?: LegacyPatchOptions;
-}
-
-declare function normalizeOptions(options?: TailwindcssPatchOptions): NormalizedTailwindcssPatchOptions;
+declare function normalizeOptions(options?: TailwindCssPatchOptions): NormalizedTailwindCssPatchOptions;
 
 interface TailwindcssConfigModule {
     CONFIG_NAME: string;
     getConfig: (cwd?: string) => Promise<{
         config?: {
             registry?: unknown;
-            patch?: LegacyTailwindcssPatcherOptions['patch'];
+            patch?: unknown;
         };
     }>;
     initConfig: (cwd: string) => Promise<unknown>;
@@ -525,22 +435,22 @@ declare function groupTokensByFile(report: TailwindTokenReport, options?: {
 }): TailwindTokenByFileMap;
 
 type TailwindMajorVersion = 2 | 3 | 4;
-type TailwindcssPatcherInitOptions = TailwindcssPatchOptions | LegacyTailwindcssPatcherOptions;
+
 declare class TailwindcssPatcher {
-    readonly options: NormalizedTailwindcssPatchOptions;
+    readonly options: NormalizedTailwindCssPatchOptions;
     readonly packageInfo: PackageInfo;
     readonly majorVersion: TailwindMajorVersion;
     private readonly cacheContext;
     private readonly cacheStore;
+    private readonly collector;
     private patchMemo;
-    private inFlightBuild;
-    constructor(options?: TailwindcssPatcherInitOptions);
+    constructor(options?: TailwindCssPatchOptions);
     patch(): Promise<PatchRunnerResult>;
     getPatchStatus(): Promise<PatchStatusReport>;
     getContexts(): TailwindcssRuntimeContext[];
-    private runTailwindBuildIfNeeded;
     private createPatchSnapshot;
     private collectClassSet;
+    private runTailwindBuildIfNeeded;
     private debugCacheRead;
     private mergeWithCache;
     private mergeWithCacheSync;
@@ -764,8 +674,8 @@ interface TailwindcssPatchCommandContext<TCommand extends TailwindcssPatchComman
     cwd: string;
     logger: typeof logger;
     loadConfig: () => Promise<TailwindcssConfigResult>;
-    loadPatchOptions: (overrides?: TailwindcssPatchOptions) => Promise<TailwindcssPatchOptions>;
-    createPatcher: (overrides?: TailwindcssPatchOptions) => Promise<TailwindcssPatcher>;
+    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<{
@@ -818,7 +728,7 @@ declare function migrateConfigFiles(options: MigrateConfigFilesOptions): Promise
 declare function restoreConfigFiles(options: RestoreConfigFilesOptions): Promise<RestoreConfigFilesResult>;
 
 declare function collectClassesFromContexts(contexts: TailwindcssRuntimeContext[], filter: (className: string) => boolean): Set<string>;
-declare function collectClassesFromTailwindV4(options: NormalizedTailwindcssPatchOptions): Promise<Set<string>>;
+declare function collectClassesFromTailwindV4(options: NormalizedTailwindCssPatchOptions): Promise<Set<string>>;
 
 declare function loadRuntimeContexts(packageInfo: PackageInfo, majorVersion: 2 | 3 | 4, refProperty: string): TailwindcssRuntimeContext[];
 
@@ -832,9 +742,11 @@ declare function runTailwindBuild(options: TailwindBuildOptions): Promise<postcs
 
 interface PatchStatusContext {
     packageInfo: PackageInfo;
-    options: NormalizedTailwindcssPatchOptions;
+    options: NormalizedTailwindCssPatchOptions;
     majorVersion: 2 | 3 | 4;
 }
 declare function getPatchStatusReport(context: PatchStatusContext): PatchStatusReport;
 
-export { type CacheClearOptions, type CacheClearResult, type CacheClearScope, type CacheContextMetadata, type CacheReadMeta, CacheStore, type CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, type ExtractResult, type ILengthUnitsPatchOptions, type LegacyTailwindcssPatcherOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, type NormalizedTailwindcssPatchOptions, type PatchCheckStatus, type PatchName, type PatchStatusEntry, type PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, type TailwindPatchRuntime, type TailwindTokenByFileMap, type TailwindTokenFileKey, type TailwindTokenLocation, type TailwindTokenReport, type TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, type TailwindcssPatchOptions, TailwindcssPatcher, type TailwindcssRuntimeContext, VALIDATE_EXIT_CODES, VALIDATE_FAILURE_REASONS, ValidateCommandError, type ValidateFailureReason, type ValidateFailureSummary, type ValidateJsonFailurePayload, type ValidateJsonSuccessPayload, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindcssPatchCli, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };
+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 };