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

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { TailwindcssMangleConfig } from '@tailwindcss-mangle/config';
 import { SourceEntry } from '@tailwindcss/oxide';
 import postcss, { Rule, Node } from 'postcss';
 import { Config } from 'tailwindcss';
@@ -10,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. */
@@ -30,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. */
@@ -45,32 +46,29 @@ interface TailwindExtractionUserOptions {
 /**
  * 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;
+    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. */
@@ -78,10 +76,20 @@ interface TailwindRuntimeConfigUserOptions {
     /** 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 TailwindV4RuntimeUserOptions {
+interface TailwindV4Options {
     /** Base directory used when resolving v4 content sources and configs. */
     base?: string;
     /** Raw CSS passed directly to the v4 design system. */
@@ -94,7 +102,7 @@ interface TailwindV4RuntimeUserOptions {
 /**
  * High-level Tailwind patch configuration shared across versions.
  */
-interface TailwindcssUserOptions extends TailwindRuntimeConfigUserOptions {
+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. */
@@ -102,31 +110,31 @@ interface TailwindcssUserOptions extends TailwindRuntimeConfigUserOptions {
     /** 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;
+    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;
+    cache?: boolean | CacheOptions;
 }
 /**
  * Stable shape for output configuration after normalization.
@@ -171,12 +179,12 @@ interface NormalizedTailwindV4Options {
 /**
  * Tailwind configuration ready for consumption by the runtime after normalization.
  */
-interface NormalizedTailwindConfigOptions extends TailwindRuntimeConfigUserOptions {
+interface NormalizedTailwindConfigOptions extends TailwindRuntimeOptionsBase {
     packageName: string;
     versionHint?: 2 | 3 | 4;
     resolve?: PackageResolvingOptions;
-    v2?: TailwindRuntimeConfigUserOptions;
-    v3?: TailwindRuntimeConfigUserOptions;
+    v2?: TailwindV2Options;
+    v3?: TailwindV3Options;
     v4?: NormalizedTailwindV4Options;
 }
 /** Grouped normalized feature flags. */
@@ -185,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;
@@ -322,7 +330,7 @@ interface TailwindTokenReport {
 }
 type TailwindTokenByFileMap = Record<string, TailwindTokenLocation[]>;
 interface TailwindPatchRuntime {
-    options: NormalizedTailwindcssPatchOptions;
+    options: NormalizedTailwindCssPatchOptions;
     majorVersion: 2 | 3 | 4;
 }
 
@@ -388,7 +396,7 @@ interface PatchRunnerResult {
     extendLengthUnits?: ReturnType<typeof applyExtendLengthUnitsPatchV3> | ReturnType<typeof applyExtendLengthUnitsPatchV4>;
 }
 
-declare function normalizeOptions(options?: TailwindcssPatchOptions): NormalizedTailwindcssPatchOptions;
+declare function normalizeOptions(options?: TailwindCssPatchOptions): NormalizedTailwindCssPatchOptions;
 
 interface TailwindcssConfigModule {
     CONFIG_NAME: string;
@@ -429,14 +437,14 @@ declare function groupTokensByFile(report: TailwindTokenReport, options?: {
 type TailwindMajorVersion = 2 | 3 | 4;
 
 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;
-    constructor(options?: TailwindcssPatchOptions);
+    constructor(options?: TailwindCssPatchOptions);
     patch(): Promise<PatchRunnerResult>;
     getPatchStatus(): Promise<PatchStatusReport>;
     getContexts(): TailwindcssRuntimeContext[];
@@ -666,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<{
@@ -720,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[];
 
@@ -734,11 +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;
 
-declare function defineConfig<T>(config: T): T;
+declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
 
-export { type CacheClearOptions, type CacheClearResult, type CacheClearScope, type CacheContextMetadata, type CacheReadMeta, CacheStore, type CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, 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 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, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };
+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 };

package/dist/index.js

@@ -23,7 +23,7 @@
 
 
 
-var _chunkZ6OMJZTUjs = require('./chunk-Z6OMJZTU.js');
+var _chunkTOAZIPHJjs = require('./chunk-TOAZIPHJ.js');
 require('./chunk-5CWNAWKP.js');
 
 // src/index.ts
@@ -56,4 +56,4 @@ function defineConfig(config) {
 
 
 
-exports.CacheStore = _chunkZ6OMJZTUjs.CacheStore; exports.MIGRATION_REPORT_KIND = _chunkZ6OMJZTUjs.MIGRATION_REPORT_KIND; exports.MIGRATION_REPORT_SCHEMA_VERSION = _chunkZ6OMJZTUjs.MIGRATION_REPORT_SCHEMA_VERSION; exports.TailwindcssPatcher = _chunkZ6OMJZTUjs.TailwindcssPatcher; exports.VALIDATE_EXIT_CODES = _chunkZ6OMJZTUjs.VALIDATE_EXIT_CODES; exports.VALIDATE_FAILURE_REASONS = _chunkZ6OMJZTUjs.VALIDATE_FAILURE_REASONS; exports.ValidateCommandError = _chunkZ6OMJZTUjs.ValidateCommandError; exports.collectClassesFromContexts = _chunkZ6OMJZTUjs.collectClassesFromContexts; exports.collectClassesFromTailwindV4 = _chunkZ6OMJZTUjs.collectClassesFromTailwindV4; exports.createTailwindcssPatchCli = _chunkZ6OMJZTUjs.createTailwindcssPatchCli; exports.defineConfig = defineConfig; exports.extractProjectCandidatesWithPositions = _chunkZ6OMJZTUjs.extractProjectCandidatesWithPositions; exports.extractRawCandidates = _chunkZ6OMJZTUjs.extractRawCandidates; exports.extractRawCandidatesWithPositions = _chunkZ6OMJZTUjs.extractRawCandidatesWithPositions; exports.extractValidCandidates = _chunkZ6OMJZTUjs.extractValidCandidates; exports.getPatchStatusReport = _chunkZ6OMJZTUjs.getPatchStatusReport; exports.groupTokensByFile = _chunkZ6OMJZTUjs.groupTokensByFile; exports.loadRuntimeContexts = _chunkZ6OMJZTUjs.loadRuntimeContexts; exports.logger = _chunkZ6OMJZTUjs.logger_default; exports.migrateConfigFiles = _chunkZ6OMJZTUjs.migrateConfigFiles; exports.mountTailwindcssPatchCommands = _chunkZ6OMJZTUjs.mountTailwindcssPatchCommands; exports.normalizeOptions = _chunkZ6OMJZTUjs.normalizeOptions; exports.restoreConfigFiles = _chunkZ6OMJZTUjs.restoreConfigFiles; exports.runTailwindBuild = _chunkZ6OMJZTUjs.runTailwindBuild; exports.tailwindcssPatchCommands = _chunkZ6OMJZTUjs.tailwindcssPatchCommands;
+exports.CacheStore = _chunkTOAZIPHJjs.CacheStore; exports.MIGRATION_REPORT_KIND = _chunkTOAZIPHJjs.MIGRATION_REPORT_KIND; exports.MIGRATION_REPORT_SCHEMA_VERSION = _chunkTOAZIPHJjs.MIGRATION_REPORT_SCHEMA_VERSION; exports.TailwindcssPatcher = _chunkTOAZIPHJjs.TailwindcssPatcher; exports.VALIDATE_EXIT_CODES = _chunkTOAZIPHJjs.VALIDATE_EXIT_CODES; exports.VALIDATE_FAILURE_REASONS = _chunkTOAZIPHJjs.VALIDATE_FAILURE_REASONS; exports.ValidateCommandError = _chunkTOAZIPHJjs.ValidateCommandError; exports.collectClassesFromContexts = _chunkTOAZIPHJjs.collectClassesFromContexts; exports.collectClassesFromTailwindV4 = _chunkTOAZIPHJjs.collectClassesFromTailwindV4; exports.createTailwindcssPatchCli = _chunkTOAZIPHJjs.createTailwindcssPatchCli; exports.defineConfig = defineConfig; exports.extractProjectCandidatesWithPositions = _chunkTOAZIPHJjs.extractProjectCandidatesWithPositions; exports.extractRawCandidates = _chunkTOAZIPHJjs.extractRawCandidates; exports.extractRawCandidatesWithPositions = _chunkTOAZIPHJjs.extractRawCandidatesWithPositions; exports.extractValidCandidates = _chunkTOAZIPHJjs.extractValidCandidates; exports.getPatchStatusReport = _chunkTOAZIPHJjs.getPatchStatusReport; exports.groupTokensByFile = _chunkTOAZIPHJjs.groupTokensByFile; exports.loadRuntimeContexts = _chunkTOAZIPHJjs.loadRuntimeContexts; exports.logger = _chunkTOAZIPHJjs.logger_default; exports.migrateConfigFiles = _chunkTOAZIPHJjs.migrateConfigFiles; exports.mountTailwindcssPatchCommands = _chunkTOAZIPHJjs.mountTailwindcssPatchCommands; exports.normalizeOptions = _chunkTOAZIPHJjs.normalizeOptions; exports.restoreConfigFiles = _chunkTOAZIPHJjs.restoreConfigFiles; exports.runTailwindBuild = _chunkTOAZIPHJjs.runTailwindBuild; exports.tailwindcssPatchCommands = _chunkTOAZIPHJjs.tailwindcssPatchCommands;

package/dist/index.mjs

@@ -23,7 +23,7 @@ import {
   restoreConfigFiles,
   runTailwindBuild,
   tailwindcssPatchCommands
-} from "./chunk-SWLOK2S6.mjs";
+} from "./chunk-VDWTCQ74.mjs";
 import "./chunk-A67ABH3M.mjs";
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tailwindcss-patch",
-  "version": "9.0.0-alpha.1",
+  "version": "9.0.0-alpha.2",
   "description": "patch tailwindcss for exposing context and extract classes",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -39,8 +39,12 @@
   "files": [
     "bin",
     "dist",
-    "schema"
+    "schema",
+    "src"
   ],
+  "tsd": {
+    "directory": "test-d"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -67,7 +71,7 @@
     "postcss": "^8.5.8",
     "semver": "^7.7.4",
     "tailwindcss-config": "^1.1.4",
-    "@tailwindcss-mangle/config": "7.0.0-alpha.1"
+    "@tailwindcss-mangle/config": "7.0.0-alpha.2"
   },
   "devDependencies": {
     "@tailwindcss/oxide": "^4.2.1",
@@ -81,6 +85,7 @@
     "dev": "tsup --watch --sourcemap",
     "build": "tsup",
     "test": "vitest run",
+    "test:types": "pnpm build && tsd --typings dist/index.d.mts --files test-d/**/*.test-d.ts",
     "test:dev": "vitest",
     "bench:cold-start": "node --import tsx bench/cold-start.ts",
     "patch": "tsx dev/bin.ts install",