tailwindcss-patch 9.4.1 → 9.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/README.md +69 -0
  2. package/dist/{cli-CBVPia5Z.js → cli-BztQHMRp.js} +63 -64
  3. package/dist/{cli-CgBdW1U5.mjs → cli-D0jXMGXf.mjs} +1 -1
  4. package/dist/cli.js +5 -6
  5. package/dist/cli.mjs +2 -2
  6. package/dist/commands/cli-runtime.d.mts +1 -1
  7. package/dist/commands/cli-runtime.d.ts +1 -1
  8. package/dist/commands/cli-runtime.js +6 -6
  9. package/dist/commands/cli-runtime.mjs +2 -2
  10. package/dist/{dist-B1VBpHtd.js → dist-DDcbvOwe.js} +2 -2
  11. package/dist/index.d.mts +105 -5
  12. package/dist/index.d.ts +105 -5
  13. package/dist/index.js +325 -62
  14. package/dist/index.mjs +253 -4
  15. package/dist/{migrate-config-DqknZpUe.mjs → validate-Bug_WYcU.mjs} +193 -93
  16. package/dist/{validate-CaJv2g5K.d.ts → validate-BuqRodYI.d.ts} +65 -16
  17. package/dist/{migrate-config-Dn9OTXpO.js → validate-DbuKewV-.js} +257 -100
  18. package/dist/{validate-Dr7IkGU8.d.mts → validate-oAkURzUC.d.mts} +65 -15
  19. package/package.json +9 -9
  20. package/src/extraction/candidate-extractor.ts +76 -12
  21. package/src/public-api.ts +54 -13
  22. package/src/style-candidates.ts +35 -0
  23. package/src/style-generator.ts +80 -0
  24. package/src/v3/index.ts +11 -0
  25. package/src/v3/style-generator.ts +384 -0
  26. package/src/v4/bare-arbitrary-values.ts +127 -2
  27. package/src/v4/engine.ts +5 -2
  28. package/src/v4/index.ts +20 -4
  29. package/src/v4/node-adapter.ts +1 -1
  30. package/src/v4/source-scan.ts +1 -1
  31. package/src/v4/style-generator.ts +44 -0
  32. package/src/v4/types.ts +23 -0
  33. package/dist/chunk-8l464Juk.js +0 -28
  34. /package/dist/{dist-BjUV1yEM.mjs → dist-CxmNpfyy.mjs} +0 -0
package/dist/index.d.mts CHANGED
@@ -1,8 +1,9 @@
1
- import { $ as TailwindV4DesignSystem, A as extractSourceCandidates, B as ExposeContextOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, Ct as CacheContextMetadata, D as extractProjectCandidatesWithPositions, E as ExtractSourceCandidate, Et as CacheReadResult, F as BareArbitraryValueOptions, G as TailwindCssOptions, H as ExtractOptions, I as normalizeOptions, J as TailwindV3Options, K as TailwindCssPatchOptions, L as ApplyOptions, M as extractValidCandidates, N as groupTokensByFile, O as extractRawCandidates, P as resolveProjectSourceFiles, Q as TailwindV4CssSource, R as CacheOptions, S as MIGRATION_REPORT_KIND, St as CacheContextDescriptor, T as TailwindcssPatcher, Tt as CacheReadMeta, U as NormalizedCacheOptions, V as ExtendLengthUnitsOptions, W as NormalizedTailwindCssPatchOptions, X as TailwindV4CandidateSource, Y as TailwindV4Options, Z as TailwindV4CompiledSourceRoot, _ as ConfigFileMigrationEntry, _t as TailwindcssClassCache, a as ValidateFailureSummary, at as TailwindV4SourcePattern, b as RestoreConfigFilesOptions, bt as CacheClearResult, c as TailwindcssPatchCliMountOptions, ct as PatchCheckStatus, d as TailwindcssPatchCommandContext, dt as PatchStatusReport, et as TailwindV4Engine, f as TailwindcssPatchCommandHandler, ft as TailwindPatchRuntime, g as tailwindcssPatchCommands, gt as TailwindTokenReport, h as TailwindcssPatchCommandOptions, ht as TailwindTokenLocation, i as ValidateFailureReason, it as TailwindV4SourceOptions, j as extractSourceCandidatesWithPositions, k as extractRawCandidatesWithPositions, l as TailwindcssPatchCliOptions, lt as PatchName, m as TailwindcssPatchCommandOptionDefinition, mt as TailwindTokenFileKey, n as VALIDATE_FAILURE_REASONS, nt as TailwindV4GenerateResult, o as ValidateJsonFailurePayload, ot as ExtractResult, p as TailwindcssPatchCommandHandlerMap, pt as TailwindTokenByFileMap, q as TailwindV2Options, r as ValidateCommandError, rt as TailwindV4ResolvedSource, s as ValidateJsonSuccessPayload, st as ILengthUnitsPatchOptions, t as VALIDATE_EXIT_CODES, tt as TailwindV4GenerateOptions, u as TailwindcssPatchCommand, ut as PatchStatusEntry, v as ConfigFileMigrationReport, vt as TailwindcssRuntimeContext, w as logger, wt as CacheIndexFileV2, x as RestoreConfigFilesResult, xt as CacheClearScope, y as MigrateConfigFilesOptions, yt as CacheClearOptions, z as CacheStrategy } from "./validate-Dr7IkGU8.mjs";
1
+ import { $ as TailwindV4Engine, A as extractSourceCandidates, At as CacheClearOptions, B as ExtendLengthUnitsOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, Ct as TailwindPatchRuntime, D as extractProjectCandidatesWithPositions, Dt as TailwindTokenReport, E as ExtractSourceCandidate, Et as TailwindTokenLocation, F as normalizeOptions, Ft as CacheIndexFileV2, G as TailwindCssPatchOptions, H as NormalizedCacheOptions, I as ApplyOptions, It as CacheReadMeta, J as TailwindV4Options, K as TailwindV2Options, L as CacheOptions, Lt as CacheReadResult, M as extractValidCandidates, Mt as CacheClearScope, N as groupTokensByFile, Nt as CacheContextDescriptor, O as extractRawCandidates, Ot as TailwindcssClassCache, P as resolveProjectSourceFiles, Pt as CacheContextMetadata, Q as TailwindV4DesignSystem, R as CacheStrategy, S as MIGRATION_REPORT_KIND, St as PatchStatusReport, T as TailwindcssPatcher, Tt as TailwindTokenFileKey, U as NormalizedTailwindCssPatchOptions, V as ExtractOptions, W as TailwindCssOptions, X as TailwindV4CompiledSourceRoot, Y as TailwindV4CandidateSource, Z as TailwindV4CssSource, _ as ConfigFileMigrationEntry, _t as ExtractResult, a as ValidateFailureSummary, at as TailwindV4StyleGenerateOptions, b as RestoreConfigFilesOptions, bt as PatchName, c as TailwindcssPatchCliMountOptions, ct as TailwindStyleCandidateOptions, d as TailwindcssPatchCommandContext, dt as BareArbitraryValueOptions, et as TailwindV4GenerateOptions, f as TailwindcssPatchCommandHandler, ft as escapeCssClassName, g as tailwindcssPatchCommands, gt as resolveBareArbitraryValueCandidate, h as TailwindcssPatchCommandOptions, ht as isBareArbitraryValuesEnabled, i as ValidateFailureReason, it as TailwindV4SourcePattern, j as extractSourceCandidatesWithPositions, jt as CacheClearResult, k as extractRawCandidatesWithPositions, kt as TailwindcssRuntimeContext, l as TailwindcssPatchCliOptions, lt as TailwindStyleSource, m as TailwindcssPatchCommandOptionDefinition, mt as extractBareArbitraryValueSourceCandidatesWithPositions, n as VALIDATE_FAILURE_REASONS, nt as TailwindV4ResolvedSource, o as ValidateJsonFailurePayload, ot as TailwindV4StyleGenerateResult, p as TailwindcssPatchCommandHandlerMap, pt as extractBareArbitraryValueSourceCandidates, q as TailwindV3Options, r as ValidateCommandError, rt as TailwindV4SourceOptions, s as ValidateJsonSuccessPayload, st as TailwindV4StyleSource, t as VALIDATE_EXIT_CODES, tt as TailwindV4GenerateResult, u as TailwindcssPatchCommand, ut as collectTailwindStyleCandidates, v as ConfigFileMigrationReport, vt as ILengthUnitsPatchOptions, w as logger, wt as TailwindTokenByFileMap, x as RestoreConfigFilesResult, xt as PatchStatusEntry, y as MigrateConfigFilesOptions, yt as PatchCheckStatus, z as ExposeContextOptions } from "./validate-oAkURzUC.mjs";
2
2
  import { PackageInfo } from "local-pkg";
3
3
  import postcss from "postcss";
4
4
  import { CAC } from "cac";
5
5
  import { SourceEntry } from "@tailwindcss/oxide";
6
+ import { Config } from "tailwindcss";
6
7
  import { TailwindcssMangleConfig } from "@tailwindcss-mangle/config";
7
8
 
8
9
  //#region src/cache/store.d.ts
@@ -83,10 +84,76 @@ interface PatchStatusContext {
83
84
  }
84
85
  declare function getPatchStatusReport(context: PatchStatusContext): PatchStatusReport;
85
86
  //#endregion
87
+ //#region src/v3/style-generator.d.ts
88
+ interface TailwindV3StyleGenerateOptions extends TailwindStyleCandidateOptions {
89
+ /**
90
+ * Tailwind v3 package name or alias. Defaults to `tailwindcss`.
91
+ */
92
+ packageName?: string;
93
+ /**
94
+ * `createRequire` base used to resolve the Tailwind v3 package.
95
+ */
96
+ cwd?: string;
97
+ /**
98
+ * Inline Tailwind v3 config. `content` is injected from collected candidates.
99
+ */
100
+ config?: Partial<Config>;
101
+ /**
102
+ * Generate all layers by default. Pass a subset to emit only selected layers.
103
+ */
104
+ layers?: TailwindV3StyleLayer[];
105
+ }
106
+ type TailwindV3StyleLayer = 'base' | 'components' | 'utilities' | 'variants';
107
+ interface TailwindV3RawStyleGenerateOptions extends TailwindStyleCandidateOptions {
108
+ /**
109
+ * Tailwind v3 package name or alias. Defaults to `tailwindcss`.
110
+ */
111
+ packageName?: string;
112
+ /**
113
+ * `createRequire` base used to resolve the Tailwind v3 package.
114
+ */
115
+ cwd?: string;
116
+ /**
117
+ * Tailwind v3 entry CSS. Defaults to `@tailwind utilities;`.
118
+ */
119
+ css?: string;
120
+ /**
121
+ * Inline Tailwind v3 config. Candidate content is injected automatically.
122
+ */
123
+ config?: Partial<Config>;
124
+ /**
125
+ * Directly append generated utility rules when the CSS is exactly `@tailwind utilities;`.
126
+ * This mirrors Tailwind v3's internal fast path and keeps output order aligned.
127
+ */
128
+ directUtilitiesOnly?: boolean | 'auto';
129
+ }
130
+ interface TailwindV3RawStyleGenerateResult {
131
+ version: 3;
132
+ css: string;
133
+ tokens: Set<string>;
134
+ classSet: Set<string>;
135
+ context: TailwindcssRuntimeContext;
136
+ dependencies: string[];
137
+ sources: TailwindStyleSource[];
138
+ config: Config;
139
+ }
140
+ interface TailwindV3StyleGenerateResult {
141
+ version: 3;
142
+ css: string;
143
+ tokens: Set<string>;
144
+ classSet: Set<string>;
145
+ sources: TailwindStyleSource[];
146
+ config: Config;
147
+ }
148
+ declare function generateTailwindV3Style(options?: TailwindV3StyleGenerateOptions): Promise<TailwindV3StyleGenerateResult>;
149
+ declare function generateTailwindV3RawStyle(options?: TailwindV3RawStyleGenerateOptions): Promise<TailwindV3RawStyleGenerateResult>;
150
+ //#endregion
86
151
  //#region src/v4/candidates.d.ts
87
152
  declare function resolveValidTailwindV4Candidates(designSystem: TailwindV4DesignSystem, candidates: Iterable<string>, options?: {
88
153
  bareArbitraryValues?: boolean | BareArbitraryValueOptions;
89
154
  }): Set<string>;
155
+ declare function replaceBareArbitraryValueSelectors(css: string, candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string;
156
+ declare function canonicalizeBareArbitraryValueCandidates(candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string[];
90
157
  //#endregion
91
158
  //#region src/v4/engine.d.ts
92
159
  declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): TailwindV4Engine;
@@ -94,6 +161,10 @@ declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): Tailw
94
161
  //#region src/v4/node-adapter.d.ts
95
162
  declare function loadTailwindV4DesignSystem(source: TailwindV4ResolvedSource): Promise<TailwindV4DesignSystem>;
96
163
  //#endregion
164
+ //#region src/v4/source.d.ts
165
+ declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
166
+ declare function resolveTailwindV4SourceFromPatchOptions(options: TailwindCssPatchOptions): Promise<TailwindV4ResolvedSource>;
167
+ //#endregion
97
168
  //#region src/v4/source-scan.d.ts
98
169
  declare const TAILWIND_V4_IGNORED_CONTENT_DIRS: string[];
99
170
  declare const TAILWIND_V4_IGNORED_EXTENSIONS: string[];
@@ -121,9 +192,38 @@ declare function expandTailwindV4SourceEntries(entries: TailwindV4SourcePattern[
121
192
  declare function mergeTailwindV4SourceEntries(...entries: Array<TailwindV4SourcePattern[] | undefined>): TailwindV4SourcePattern[];
122
193
  declare function resolveTailwindV4SourceBaseCandidates(projectRoot: string, base: string, baseFallbacks: string[]): string[];
123
194
  //#endregion
124
- //#region src/v4/source.d.ts
125
- declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
126
- declare function resolveTailwindV4SourceFromPatchOptions(options: TailwindCssPatchOptions): Promise<TailwindV4ResolvedSource>;
195
+ //#region src/v4/style-generator.d.ts
196
+ declare function collectTailwindV4StyleCandidates(options: Pick<TailwindV4StyleGenerateOptions, 'bareArbitraryValues' | 'candidates' | 'sources'>): Promise<Set<string>>;
197
+ declare function generateTailwindV4Style(options?: TailwindV4StyleGenerateOptions): Promise<TailwindV4StyleGenerateResult>;
198
+ //#endregion
199
+ //#region src/style-generator.d.ts
200
+ interface CustomTailwindStyleGenerateContext {
201
+ tokens: Set<string>;
202
+ classSet: Set<string>;
203
+ sources: TailwindStyleSource[];
204
+ }
205
+ interface CustomTailwindStyleGenerateOptions extends TailwindStyleCandidateOptions {
206
+ generate: (context: CustomTailwindStyleGenerateContext) => string | Promise<string>;
207
+ }
208
+ interface CustomTailwindStyleGenerateResult {
209
+ version: 'custom';
210
+ css: string;
211
+ tokens: Set<string>;
212
+ classSet: Set<string>;
213
+ sources: TailwindStyleSource[];
214
+ }
215
+ type TailwindStyleGenerateOptions = ({
216
+ version: 3;
217
+ } & TailwindV3StyleGenerateOptions) | ({
218
+ version: 4;
219
+ } & TailwindV4StyleGenerateOptions) | ({
220
+ version: 'custom';
221
+ } & CustomTailwindStyleGenerateOptions);
222
+ type TailwindStyleGenerateResult = TailwindV3StyleGenerateResult | (TailwindV4StyleGenerateResult & {
223
+ version: 4;
224
+ }) | CustomTailwindStyleGenerateResult;
225
+ declare function generateCustomStyle(options: CustomTailwindStyleGenerateOptions): Promise<CustomTailwindStyleGenerateResult>;
226
+ declare function generateTailwindStyle(options: TailwindStyleGenerateOptions): Promise<TailwindStyleGenerateResult>;
127
227
  //#endregion
128
228
  //#region src/public-api.d.ts
129
229
  declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
@@ -132,4 +232,4 @@ declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
132
232
  declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
133
233
  declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
134
234
  //#endregion
135
- export { ApplyOptions, CacheClearOptions, CacheClearResult, CacheClearScope, CacheContextMetadata, CacheOptions, CacheReadMeta, CacheStore, CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, ExposeContextOptions, ExtendLengthUnitsOptions, ExtractOptions, ExtractResult, type ExtractSourceCandidate, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN, TAILWIND_V4_IGNORED_CONTENT_DIRS, TAILWIND_V4_IGNORED_EXTENSIONS, TAILWIND_V4_IGNORED_FILES, TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, TailwindV2Options, TailwindV3Options, type TailwindV4CandidateSource, type TailwindV4CompiledSourceRoot, type TailwindV4CssSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, type TailwindV4SourcePattern, TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, TailwindcssPatcher, TailwindcssRuntimeContext, VALIDATE_EXIT_CODES, VALIDATE_FAILURE_REASONS, ValidateCommandError, type ValidateFailureReason, type ValidateFailureSummary, type ValidateJsonFailurePayload, type ValidateJsonSuccessPayload, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindV4CompiledSourceEntries, createTailwindV4DefaultIgnoreSources, createTailwindV4Engine, createTailwindV4RootSources, createTailwindV4SourceEntryMatcher, createTailwindV4SourceExclusionMatcher, createTailwindcssPatchCli, defineConfig, expandTailwindV4SourceEntries, expandTailwindV4SourceEntryBraces, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractSourceCandidates, extractSourceCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, isFileExcludedByTailwindV4SourceEntries, isFileMatchedByTailwindV4SourceEntries, isValidCandidateToken, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, mergeTailwindV4SourceEntries, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, normalizeTailwindV4ScannerSources, normalizeTailwindV4SourceEntries, resolveProjectSourceFiles, resolveSourceScanPath, resolveTailwindV4Source, resolveTailwindV4SourceBaseCandidates, resolveTailwindV4SourceEntry, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, splitCandidateTokens, tailwindcssPatchCommands, validateCandidateTokenRE };
235
+ export { type ApplyOptions, type CacheClearOptions, type CacheClearResult, type CacheClearScope, type CacheContextMetadata, type CacheOptions, type CacheReadMeta, CacheStore, type CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, type CustomTailwindStyleGenerateContext, type CustomTailwindStyleGenerateOptions, type CustomTailwindStyleGenerateResult, type ExposeContextOptions, type ExtendLengthUnitsOptions, type ExtractOptions, ExtractResult, type ExtractSourceCandidate, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, type NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN, TAILWIND_V4_IGNORED_CONTENT_DIRS, TAILWIND_V4_IGNORED_EXTENSIONS, TAILWIND_V4_IGNORED_FILES, type TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, type TailwindStyleCandidateOptions, type TailwindStyleGenerateOptions, type TailwindStyleGenerateResult, type TailwindStyleSource, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, type TailwindV2Options, type TailwindV3Options, type TailwindV3RawStyleGenerateOptions, type TailwindV3RawStyleGenerateResult, type TailwindV3StyleGenerateOptions, type TailwindV3StyleGenerateResult, type TailwindV3StyleLayer, type TailwindV4CandidateSource, type TailwindV4CompiledSourceRoot, type TailwindV4CssSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, type TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, type TailwindV4SourcePattern, type TailwindV4StyleGenerateOptions, type TailwindV4StyleGenerateResult, type TailwindV4StyleSource, TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, TailwindcssPatcher, TailwindcssRuntimeContext, VALIDATE_EXIT_CODES, VALIDATE_FAILURE_REASONS, ValidateCommandError, type ValidateFailureReason, type ValidateFailureSummary, type ValidateJsonFailurePayload, type ValidateJsonSuccessPayload, canonicalizeBareArbitraryValueCandidates, collectClassesFromContexts, collectClassesFromTailwindV4, collectTailwindStyleCandidates, collectTailwindV4StyleCandidates, createTailwindV4CompiledSourceEntries, createTailwindV4DefaultIgnoreSources, createTailwindV4Engine, createTailwindV4RootSources, createTailwindV4SourceEntryMatcher, createTailwindV4SourceExclusionMatcher, createTailwindcssPatchCli, defineConfig, escapeCssClassName, expandTailwindV4SourceEntries, expandTailwindV4SourceEntryBraces, extractBareArbitraryValueSourceCandidates, extractBareArbitraryValueSourceCandidatesWithPositions, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractSourceCandidates, extractSourceCandidatesWithPositions, extractValidCandidates, generateCustomStyle, generateTailwindStyle, generateTailwindV3RawStyle, generateTailwindV3Style, generateTailwindV4Style, getPatchStatusReport, groupTokensByFile, isBareArbitraryValuesEnabled, isFileExcludedByTailwindV4SourceEntries, isFileMatchedByTailwindV4SourceEntries, isValidCandidateToken, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, mergeTailwindV4SourceEntries, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, normalizeTailwindV4ScannerSources, normalizeTailwindV4SourceEntries, replaceBareArbitraryValueSelectors, resolveBareArbitraryValueCandidate, resolveProjectSourceFiles, resolveSourceScanPath, resolveTailwindV4Source, resolveTailwindV4SourceBaseCandidates, resolveTailwindV4SourceEntry, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, splitCandidateTokens, tailwindcssPatchCommands, validateCandidateTokenRE };
package/dist/index.d.ts CHANGED
@@ -1,8 +1,9 @@
1
- import { $ as TailwindV4DesignSystem, A as extractSourceCandidates, B as ExposeContextOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, Ct as CacheContextMetadata, D as extractProjectCandidatesWithPositions, E as ExtractSourceCandidate, Et as CacheReadResult, F as BareArbitraryValueOptions, G as TailwindCssOptions, H as ExtractOptions, I as normalizeOptions, J as TailwindV3Options, K as TailwindCssPatchOptions, L as ApplyOptions, M as extractValidCandidates, N as groupTokensByFile, O as extractRawCandidates, P as resolveProjectSourceFiles, Q as TailwindV4CssSource, R as CacheOptions, S as MIGRATION_REPORT_KIND, St as CacheContextDescriptor, T as TailwindcssPatcher, Tt as CacheReadMeta, U as NormalizedCacheOptions, V as ExtendLengthUnitsOptions, W as NormalizedTailwindCssPatchOptions, X as TailwindV4CandidateSource, Y as TailwindV4Options, Z as TailwindV4CompiledSourceRoot, _ as ConfigFileMigrationEntry, _t as TailwindcssClassCache, a as ValidateFailureSummary, at as TailwindV4SourcePattern, b as RestoreConfigFilesOptions, bt as CacheClearResult, c as TailwindcssPatchCliMountOptions, ct as PatchCheckStatus, d as TailwindcssPatchCommandContext, dt as PatchStatusReport, et as TailwindV4Engine, f as TailwindcssPatchCommandHandler, ft as TailwindPatchRuntime, g as tailwindcssPatchCommands, gt as TailwindTokenReport, h as TailwindcssPatchCommandOptions, ht as TailwindTokenLocation, i as ValidateFailureReason, it as TailwindV4SourceOptions, j as extractSourceCandidatesWithPositions, k as extractRawCandidatesWithPositions, l as TailwindcssPatchCliOptions, lt as PatchName, m as TailwindcssPatchCommandOptionDefinition, mt as TailwindTokenFileKey, n as VALIDATE_FAILURE_REASONS, nt as TailwindV4GenerateResult, o as ValidateJsonFailurePayload, ot as ExtractResult, p as TailwindcssPatchCommandHandlerMap, pt as TailwindTokenByFileMap, q as TailwindV2Options, r as ValidateCommandError, rt as TailwindV4ResolvedSource, s as ValidateJsonSuccessPayload, st as ILengthUnitsPatchOptions, t as VALIDATE_EXIT_CODES, tt as TailwindV4GenerateOptions, u as TailwindcssPatchCommand, ut as PatchStatusEntry, v as ConfigFileMigrationReport, vt as TailwindcssRuntimeContext, w as logger, wt as CacheIndexFileV2, x as RestoreConfigFilesResult, xt as CacheClearScope, y as MigrateConfigFilesOptions, yt as CacheClearOptions, z as CacheStrategy } from "./validate-CaJv2g5K.js";
1
+ import { $ as TailwindV4Engine, A as extractSourceCandidates, At as CacheClearOptions, B as ExtendLengthUnitsOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, Ct as TailwindPatchRuntime, D as extractProjectCandidatesWithPositions, Dt as TailwindTokenReport, E as ExtractSourceCandidate, Et as TailwindTokenLocation, F as normalizeOptions, Ft as CacheIndexFileV2, G as TailwindCssPatchOptions, H as NormalizedCacheOptions, I as ApplyOptions, It as CacheReadMeta, J as TailwindV4Options, K as TailwindV2Options, L as CacheOptions, Lt as CacheReadResult, M as extractValidCandidates, Mt as CacheClearScope, N as groupTokensByFile, Nt as CacheContextDescriptor, O as extractRawCandidates, Ot as TailwindcssClassCache, P as resolveProjectSourceFiles, Pt as CacheContextMetadata, Q as TailwindV4DesignSystem, R as CacheStrategy, S as MIGRATION_REPORT_KIND, St as PatchStatusReport, T as TailwindcssPatcher, Tt as TailwindTokenFileKey, U as NormalizedTailwindCssPatchOptions, V as ExtractOptions, W as TailwindCssOptions, X as TailwindV4CompiledSourceRoot, Y as TailwindV4CandidateSource, Z as TailwindV4CssSource, _ as ConfigFileMigrationEntry, _t as ExtractResult, a as ValidateFailureSummary, at as TailwindV4StyleGenerateOptions, b as RestoreConfigFilesOptions, bt as PatchName, c as TailwindcssPatchCliMountOptions, ct as TailwindStyleCandidateOptions, d as TailwindcssPatchCommandContext, dt as BareArbitraryValueOptions, et as TailwindV4GenerateOptions, f as TailwindcssPatchCommandHandler, ft as escapeCssClassName, g as tailwindcssPatchCommands, gt as resolveBareArbitraryValueCandidate, h as TailwindcssPatchCommandOptions, ht as isBareArbitraryValuesEnabled, i as ValidateFailureReason, it as TailwindV4SourcePattern, j as extractSourceCandidatesWithPositions, jt as CacheClearResult, k as extractRawCandidatesWithPositions, kt as TailwindcssRuntimeContext, l as TailwindcssPatchCliOptions, lt as TailwindStyleSource, m as TailwindcssPatchCommandOptionDefinition, mt as extractBareArbitraryValueSourceCandidatesWithPositions, n as VALIDATE_FAILURE_REASONS, nt as TailwindV4ResolvedSource, o as ValidateJsonFailurePayload, ot as TailwindV4StyleGenerateResult, p as TailwindcssPatchCommandHandlerMap, pt as extractBareArbitraryValueSourceCandidates, q as TailwindV3Options, r as ValidateCommandError, rt as TailwindV4SourceOptions, s as ValidateJsonSuccessPayload, st as TailwindV4StyleSource, t as VALIDATE_EXIT_CODES, tt as TailwindV4GenerateResult, u as TailwindcssPatchCommand, ut as collectTailwindStyleCandidates, v as ConfigFileMigrationReport, vt as ILengthUnitsPatchOptions, w as logger, wt as TailwindTokenByFileMap, x as RestoreConfigFilesResult, xt as PatchStatusEntry, y as MigrateConfigFilesOptions, yt as PatchCheckStatus, z as ExposeContextOptions } from "./validate-BuqRodYI.js";
2
2
  import { CAC } from "cac";
3
3
  import { PackageInfo } from "local-pkg";
4
4
  import { SourceEntry } from "@tailwindcss/oxide";
5
5
  import postcss from "postcss";
6
+ import { Config } from "tailwindcss";
6
7
  import { TailwindcssMangleConfig } from "@tailwindcss-mangle/config";
7
8
 
8
9
  //#region src/cache/store.d.ts
@@ -83,10 +84,76 @@ interface PatchStatusContext {
83
84
  }
84
85
  declare function getPatchStatusReport(context: PatchStatusContext): PatchStatusReport;
85
86
  //#endregion
87
+ //#region src/v3/style-generator.d.ts
88
+ interface TailwindV3StyleGenerateOptions extends TailwindStyleCandidateOptions {
89
+ /**
90
+ * Tailwind v3 package name or alias. Defaults to `tailwindcss`.
91
+ */
92
+ packageName?: string;
93
+ /**
94
+ * `createRequire` base used to resolve the Tailwind v3 package.
95
+ */
96
+ cwd?: string;
97
+ /**
98
+ * Inline Tailwind v3 config. `content` is injected from collected candidates.
99
+ */
100
+ config?: Partial<Config>;
101
+ /**
102
+ * Generate all layers by default. Pass a subset to emit only selected layers.
103
+ */
104
+ layers?: TailwindV3StyleLayer[];
105
+ }
106
+ type TailwindV3StyleLayer = 'base' | 'components' | 'utilities' | 'variants';
107
+ interface TailwindV3RawStyleGenerateOptions extends TailwindStyleCandidateOptions {
108
+ /**
109
+ * Tailwind v3 package name or alias. Defaults to `tailwindcss`.
110
+ */
111
+ packageName?: string;
112
+ /**
113
+ * `createRequire` base used to resolve the Tailwind v3 package.
114
+ */
115
+ cwd?: string;
116
+ /**
117
+ * Tailwind v3 entry CSS. Defaults to `@tailwind utilities;`.
118
+ */
119
+ css?: string;
120
+ /**
121
+ * Inline Tailwind v3 config. Candidate content is injected automatically.
122
+ */
123
+ config?: Partial<Config>;
124
+ /**
125
+ * Directly append generated utility rules when the CSS is exactly `@tailwind utilities;`.
126
+ * This mirrors Tailwind v3's internal fast path and keeps output order aligned.
127
+ */
128
+ directUtilitiesOnly?: boolean | 'auto';
129
+ }
130
+ interface TailwindV3RawStyleGenerateResult {
131
+ version: 3;
132
+ css: string;
133
+ tokens: Set<string>;
134
+ classSet: Set<string>;
135
+ context: TailwindcssRuntimeContext;
136
+ dependencies: string[];
137
+ sources: TailwindStyleSource[];
138
+ config: Config;
139
+ }
140
+ interface TailwindV3StyleGenerateResult {
141
+ version: 3;
142
+ css: string;
143
+ tokens: Set<string>;
144
+ classSet: Set<string>;
145
+ sources: TailwindStyleSource[];
146
+ config: Config;
147
+ }
148
+ declare function generateTailwindV3Style(options?: TailwindV3StyleGenerateOptions): Promise<TailwindV3StyleGenerateResult>;
149
+ declare function generateTailwindV3RawStyle(options?: TailwindV3RawStyleGenerateOptions): Promise<TailwindV3RawStyleGenerateResult>;
150
+ //#endregion
86
151
  //#region src/v4/candidates.d.ts
87
152
  declare function resolveValidTailwindV4Candidates(designSystem: TailwindV4DesignSystem, candidates: Iterable<string>, options?: {
88
153
  bareArbitraryValues?: boolean | BareArbitraryValueOptions;
89
154
  }): Set<string>;
155
+ declare function replaceBareArbitraryValueSelectors(css: string, candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string;
156
+ declare function canonicalizeBareArbitraryValueCandidates(candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string[];
90
157
  //#endregion
91
158
  //#region src/v4/engine.d.ts
92
159
  declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): TailwindV4Engine;
@@ -94,6 +161,10 @@ declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): Tailw
94
161
  //#region src/v4/node-adapter.d.ts
95
162
  declare function loadTailwindV4DesignSystem(source: TailwindV4ResolvedSource): Promise<TailwindV4DesignSystem>;
96
163
  //#endregion
164
+ //#region src/v4/source.d.ts
165
+ declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
166
+ declare function resolveTailwindV4SourceFromPatchOptions(options: TailwindCssPatchOptions): Promise<TailwindV4ResolvedSource>;
167
+ //#endregion
97
168
  //#region src/v4/source-scan.d.ts
98
169
  declare const TAILWIND_V4_IGNORED_CONTENT_DIRS: string[];
99
170
  declare const TAILWIND_V4_IGNORED_EXTENSIONS: string[];
@@ -121,9 +192,38 @@ declare function expandTailwindV4SourceEntries(entries: TailwindV4SourcePattern[
121
192
  declare function mergeTailwindV4SourceEntries(...entries: Array<TailwindV4SourcePattern[] | undefined>): TailwindV4SourcePattern[];
122
193
  declare function resolveTailwindV4SourceBaseCandidates(projectRoot: string, base: string, baseFallbacks: string[]): string[];
123
194
  //#endregion
124
- //#region src/v4/source.d.ts
125
- declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
126
- declare function resolveTailwindV4SourceFromPatchOptions(options: TailwindCssPatchOptions): Promise<TailwindV4ResolvedSource>;
195
+ //#region src/v4/style-generator.d.ts
196
+ declare function collectTailwindV4StyleCandidates(options: Pick<TailwindV4StyleGenerateOptions, 'bareArbitraryValues' | 'candidates' | 'sources'>): Promise<Set<string>>;
197
+ declare function generateTailwindV4Style(options?: TailwindV4StyleGenerateOptions): Promise<TailwindV4StyleGenerateResult>;
198
+ //#endregion
199
+ //#region src/style-generator.d.ts
200
+ interface CustomTailwindStyleGenerateContext {
201
+ tokens: Set<string>;
202
+ classSet: Set<string>;
203
+ sources: TailwindStyleSource[];
204
+ }
205
+ interface CustomTailwindStyleGenerateOptions extends TailwindStyleCandidateOptions {
206
+ generate: (context: CustomTailwindStyleGenerateContext) => string | Promise<string>;
207
+ }
208
+ interface CustomTailwindStyleGenerateResult {
209
+ version: 'custom';
210
+ css: string;
211
+ tokens: Set<string>;
212
+ classSet: Set<string>;
213
+ sources: TailwindStyleSource[];
214
+ }
215
+ type TailwindStyleGenerateOptions = ({
216
+ version: 3;
217
+ } & TailwindV3StyleGenerateOptions) | ({
218
+ version: 4;
219
+ } & TailwindV4StyleGenerateOptions) | ({
220
+ version: 'custom';
221
+ } & CustomTailwindStyleGenerateOptions);
222
+ type TailwindStyleGenerateResult = TailwindV3StyleGenerateResult | (TailwindV4StyleGenerateResult & {
223
+ version: 4;
224
+ }) | CustomTailwindStyleGenerateResult;
225
+ declare function generateCustomStyle(options: CustomTailwindStyleGenerateOptions): Promise<CustomTailwindStyleGenerateResult>;
226
+ declare function generateTailwindStyle(options: TailwindStyleGenerateOptions): Promise<TailwindStyleGenerateResult>;
127
227
  //#endregion
128
228
  //#region src/public-api.d.ts
129
229
  declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
@@ -132,4 +232,4 @@ declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
132
232
  declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
133
233
  declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
134
234
  //#endregion
135
- export { ApplyOptions, CacheClearOptions, CacheClearResult, CacheClearScope, CacheContextMetadata, CacheOptions, CacheReadMeta, CacheStore, CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, ExposeContextOptions, ExtendLengthUnitsOptions, ExtractOptions, ExtractResult, type ExtractSourceCandidate, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN, TAILWIND_V4_IGNORED_CONTENT_DIRS, TAILWIND_V4_IGNORED_EXTENSIONS, TAILWIND_V4_IGNORED_FILES, TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, TailwindV2Options, TailwindV3Options, type TailwindV4CandidateSource, type TailwindV4CompiledSourceRoot, type TailwindV4CssSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, type TailwindV4SourcePattern, TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, TailwindcssPatcher, TailwindcssRuntimeContext, VALIDATE_EXIT_CODES, VALIDATE_FAILURE_REASONS, ValidateCommandError, type ValidateFailureReason, type ValidateFailureSummary, type ValidateJsonFailurePayload, type ValidateJsonSuccessPayload, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindV4CompiledSourceEntries, createTailwindV4DefaultIgnoreSources, createTailwindV4Engine, createTailwindV4RootSources, createTailwindV4SourceEntryMatcher, createTailwindV4SourceExclusionMatcher, createTailwindcssPatchCli, defineConfig, expandTailwindV4SourceEntries, expandTailwindV4SourceEntryBraces, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractSourceCandidates, extractSourceCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, isFileExcludedByTailwindV4SourceEntries, isFileMatchedByTailwindV4SourceEntries, isValidCandidateToken, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, mergeTailwindV4SourceEntries, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, normalizeTailwindV4ScannerSources, normalizeTailwindV4SourceEntries, resolveProjectSourceFiles, resolveSourceScanPath, resolveTailwindV4Source, resolveTailwindV4SourceBaseCandidates, resolveTailwindV4SourceEntry, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, splitCandidateTokens, tailwindcssPatchCommands, validateCandidateTokenRE };
235
+ export { type ApplyOptions, type CacheClearOptions, type CacheClearResult, type CacheClearScope, type CacheContextMetadata, type CacheOptions, type CacheReadMeta, CacheStore, type CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, type CustomTailwindStyleGenerateContext, type CustomTailwindStyleGenerateOptions, type CustomTailwindStyleGenerateResult, type ExposeContextOptions, type ExtendLengthUnitsOptions, type ExtractOptions, ExtractResult, type ExtractSourceCandidate, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, type NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN, TAILWIND_V4_IGNORED_CONTENT_DIRS, TAILWIND_V4_IGNORED_EXTENSIONS, TAILWIND_V4_IGNORED_FILES, type TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, type TailwindStyleCandidateOptions, type TailwindStyleGenerateOptions, type TailwindStyleGenerateResult, type TailwindStyleSource, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, type TailwindV2Options, type TailwindV3Options, type TailwindV3RawStyleGenerateOptions, type TailwindV3RawStyleGenerateResult, type TailwindV3StyleGenerateOptions, type TailwindV3StyleGenerateResult, type TailwindV3StyleLayer, type TailwindV4CandidateSource, type TailwindV4CompiledSourceRoot, type TailwindV4CssSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, type TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, type TailwindV4SourcePattern, type TailwindV4StyleGenerateOptions, type TailwindV4StyleGenerateResult, type TailwindV4StyleSource, TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, TailwindcssPatcher, TailwindcssRuntimeContext, VALIDATE_EXIT_CODES, VALIDATE_FAILURE_REASONS, ValidateCommandError, type ValidateFailureReason, type ValidateFailureSummary, type ValidateJsonFailurePayload, type ValidateJsonSuccessPayload, canonicalizeBareArbitraryValueCandidates, collectClassesFromContexts, collectClassesFromTailwindV4, collectTailwindStyleCandidates, collectTailwindV4StyleCandidates, createTailwindV4CompiledSourceEntries, createTailwindV4DefaultIgnoreSources, createTailwindV4Engine, createTailwindV4RootSources, createTailwindV4SourceEntryMatcher, createTailwindV4SourceExclusionMatcher, createTailwindcssPatchCli, defineConfig, escapeCssClassName, expandTailwindV4SourceEntries, expandTailwindV4SourceEntryBraces, extractBareArbitraryValueSourceCandidates, extractBareArbitraryValueSourceCandidatesWithPositions, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractSourceCandidates, extractSourceCandidatesWithPositions, extractValidCandidates, generateCustomStyle, generateTailwindStyle, generateTailwindV3RawStyle, generateTailwindV3Style, generateTailwindV4Style, getPatchStatusReport, groupTokensByFile, isBareArbitraryValuesEnabled, isFileExcludedByTailwindV4SourceEntries, isFileMatchedByTailwindV4SourceEntries, isValidCandidateToken, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, mergeTailwindV4SourceEntries, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, normalizeTailwindV4ScannerSources, normalizeTailwindV4SourceEntries, replaceBareArbitraryValueSelectors, resolveBareArbitraryValueCandidate, resolveProjectSourceFiles, resolveSourceScanPath, resolveTailwindV4Source, resolveTailwindV4SourceBaseCandidates, resolveTailwindV4SourceEntry, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, splitCandidateTokens, tailwindcssPatchCommands, validateCandidateTokenRE };