tailwindcss-patch 9.3.2 → 9.3.3

package/dist/cli.js

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-8l464Juk.js");
-const require_validate = require("./validate-CF0M_7KH.js");
-const require_index_bundle = require("./index.bundle-CcVIAfDb.js");
+const require_validate = require("./validate-DABvQ44V.js");
+const require_index_bundle = require("./index.bundle-BdxyJef9.js");
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
 //#region src/cli.bundle.ts

package/dist/cli.mjs

@@ -1,5 +1,5 @@
-import { j as logger, r as ValidateCommandError } from "./validate-Sq_yuh3r.mjs";
-import { t as createTailwindcssPatchCli } from "./index.bundle-DjS24i5r.mjs";
+import { j as logger, r as ValidateCommandError } from "./validate-cMWKFUKS.mjs";
+import { t as createTailwindcssPatchCli } from "./index.bundle-C39laqrA.mjs";
 import process from "node:process";
 //#region src/cli.bundle.ts
 async function main() {

package/dist/commands/cli-runtime.d.mts

@@ -1,4 +1,4 @@
-import { a as ValidateFailureSummary, c as TailwindcssPatchCliMountOptions, d as TailwindcssPatchCommandContext, f as TailwindcssPatchCommandHandler, g as tailwindcssPatchCommands, h as TailwindcssPatchCommandOptions, i as ValidateFailureReason, l as TailwindcssPatchCliOptions, m as TailwindcssPatchCommandOptionDefinition, n as VALIDATE_FAILURE_REASONS, o as ValidateJsonFailurePayload, p as TailwindcssPatchCommandHandlerMap, r as ValidateCommandError, s as ValidateJsonSuccessPayload, t as VALIDATE_EXIT_CODES, u as TailwindcssPatchCommand } from "../validate-C8-qsOWo.mjs";
+import { a as ValidateFailureSummary, c as TailwindcssPatchCliMountOptions, d as TailwindcssPatchCommandContext, f as TailwindcssPatchCommandHandler, g as tailwindcssPatchCommands, h as TailwindcssPatchCommandOptions, i as ValidateFailureReason, l as TailwindcssPatchCliOptions, m as TailwindcssPatchCommandOptionDefinition, n as VALIDATE_FAILURE_REASONS, o as ValidateJsonFailurePayload, p as TailwindcssPatchCommandHandlerMap, r as ValidateCommandError, s as ValidateJsonSuccessPayload, t as VALIDATE_EXIT_CODES, u as TailwindcssPatchCommand } from "../validate-DDJnolx2.mjs";
 import { CAC } from "cac";
 
 //#region src/commands/cli.d.ts

package/dist/commands/cli-runtime.d.ts

@@ -1,4 +1,4 @@
-import { a as ValidateFailureSummary, c as TailwindcssPatchCliMountOptions, d as TailwindcssPatchCommandContext, f as TailwindcssPatchCommandHandler, g as tailwindcssPatchCommands, h as TailwindcssPatchCommandOptions, i as ValidateFailureReason, l as TailwindcssPatchCliOptions, m as TailwindcssPatchCommandOptionDefinition, n as VALIDATE_FAILURE_REASONS, o as ValidateJsonFailurePayload, p as TailwindcssPatchCommandHandlerMap, r as ValidateCommandError, s as ValidateJsonSuccessPayload, t as VALIDATE_EXIT_CODES, u as TailwindcssPatchCommand } from "../validate-Bqych-z9.js";
+import { a as ValidateFailureSummary, c as TailwindcssPatchCliMountOptions, d as TailwindcssPatchCommandContext, f as TailwindcssPatchCommandHandler, g as tailwindcssPatchCommands, h as TailwindcssPatchCommandOptions, i as ValidateFailureReason, l as TailwindcssPatchCliOptions, m as TailwindcssPatchCommandOptionDefinition, n as VALIDATE_FAILURE_REASONS, o as ValidateJsonFailurePayload, p as TailwindcssPatchCommandHandlerMap, r as ValidateCommandError, s as ValidateJsonSuccessPayload, t as VALIDATE_EXIT_CODES, u as TailwindcssPatchCommand } from "../validate-rPPCy1cl.js";
 import { CAC } from "cac";
 
 //#region src/commands/cli.d.ts

package/dist/commands/cli-runtime.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../chunk-8l464Juk.js");
-const require_validate = require("../validate-CF0M_7KH.js");
+const require_validate = require("../validate-DABvQ44V.js");
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
 let fs_extra = require("fs-extra");

package/dist/commands/cli-runtime.mjs

@@ -1,4 +1,4 @@
-import { D as loadPatchOptionsForWorkspace, O as loadWorkspaceConfigModule, a as tailwindcssPatchCommands, b as groupTokensByFile, i as classifyValidateError, j as logger, n as VALIDATE_FAILURE_REASONS, o as migrateConfigFiles, r as ValidateCommandError, s as restoreConfigFiles, t as VALIDATE_EXIT_CODES, u as TailwindcssPatcher } from "../validate-Sq_yuh3r.mjs";
+import { D as loadPatchOptionsForWorkspace, O as loadWorkspaceConfigModule, a as tailwindcssPatchCommands, b as groupTokensByFile, i as classifyValidateError, j as logger, n as VALIDATE_FAILURE_REASONS, o as migrateConfigFiles, r as ValidateCommandError, s as restoreConfigFiles, t as VALIDATE_EXIT_CODES, u as TailwindcssPatcher } from "../validate-cMWKFUKS.mjs";
 import process from "node:process";
 import fs from "fs-extra";
 import path from "pathe";

package/dist/{index.bundle-CcVIAfDb.js → index.bundle-BdxyJef9.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-8l464Juk.js");
-const require_validate = require("./validate-CF0M_7KH.js");
+const require_validate = require("./validate-DABvQ44V.js");
 let node_module = require("node:module");
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
@@ -109,6 +109,22 @@ async function resolveCssEntries(entries, projectRoot, base) {
 		dependencies
 	};
 }
+function resolveCssSources(sources, projectRoot, base) {
+	const resolvedSources = sources.map((source) => ({
+		...source,
+		base: source.base === void 0 ? void 0 : resolveBase(source.base, projectRoot),
+		file: source.file === void 0 ? void 0 : pathe.default.isAbsolute(source.file) ? pathe.default.resolve(source.file) : pathe.default.resolve(projectRoot, source.file),
+		dependencies: source.dependencies?.map((dependency) => pathe.default.isAbsolute(dependency) ? pathe.default.resolve(dependency) : pathe.default.resolve(projectRoot, dependency)) ?? []
+	}));
+	const firstSource = resolvedSources[0];
+	const resolvedBase = base ?? firstSource?.base ?? (firstSource?.file ? pathe.default.dirname(firstSource.file) : projectRoot);
+	const dependencies = resolvedSources.flatMap((source) => [source.file, ...source.dependencies]).filter((dependency) => Boolean(dependency));
+	return {
+		base: resolvedBase,
+		css: resolvedSources.map((source) => source.css).join("\n"),
+		dependencies
+	};
+}
 function normalizeResolvedSource(source) {
 	const baseFallbacks = uniquePaths([
 		...source.baseFallbacks,
@@ -136,15 +152,17 @@ async function resolveTailwindV4Source(options = {}) {
 		css: options.css,
 		dependencies: []
 	});
-	if (options.cssEntries?.length) {
-		const entries = await resolveCssEntries(options.cssEntries, projectRoot, configuredBase);
+	if (options.cssEntries?.length || options.cssSources?.length) {
+		const entries = options.cssEntries?.length ? await resolveCssEntries(options.cssEntries, projectRoot, configuredBase) : void 0;
+		const sources = options.cssSources?.length ? resolveCssSources(options.cssSources, projectRoot, configuredBase) : void 0;
+		const css = [entries?.css, sources?.css].filter(Boolean).join("\n");
 		return normalizeResolvedSource({
 			projectRoot,
 			cwd,
-			base: entries.base,
+			base: configuredBase ?? entries?.base ?? sources?.base ?? cwd,
 			baseFallbacks,
-			css: entries.css,
-			dependencies: entries.dependencies
+			css,
+			dependencies: [...entries?.dependencies ?? [], ...sources?.dependencies ?? []]
 		});
 	}
 	return normalizeResolvedSource({
@@ -176,6 +194,7 @@ function createSourceOptionsFromNormalizedPatchOptions(options) {
 		...v4?.configuredBase === void 0 ? {} : { base: v4.configuredBase },
 		baseFallbacks,
 		...v4?.css === void 0 ? {} : { css: v4.css },
+		...v4?.cssSources === void 0 ? {} : { cssSources: v4.cssSources },
 		...v4?.cssEntries === void 0 ? {} : { cssEntries: v4.cssEntries },
 		packageName: options.tailwind.packageName
 	};

package/dist/{index.bundle-DjS24i5r.mjs → index.bundle-C39laqrA.mjs}

@@ -1,4 +1,4 @@
-import { C as canonicalizeBareArbitraryValueCandidates, E as resolveValidTailwindV4Candidates, S as loadTailwindV4DesignSystem, T as replaceBareArbitraryValueSelectors, _ as extractRawCandidates, k as normalizeOptions, v as extractRawCandidatesWithPositions, w as extractTailwindV4InlineSourceCandidates, x as compileTailwindV4Source } from "./validate-Sq_yuh3r.mjs";
+import { C as canonicalizeBareArbitraryValueCandidates, E as resolveValidTailwindV4Candidates, S as loadTailwindV4DesignSystem, T as replaceBareArbitraryValueSelectors, _ as extractRawCandidates, k as normalizeOptions, v as extractRawCandidatesWithPositions, w as extractTailwindV4InlineSourceCandidates, x as compileTailwindV4Source } from "./validate-cMWKFUKS.mjs";
 import { createRequire } from "node:module";
 import process from "node:process";
 import path from "pathe";
@@ -106,6 +106,22 @@ async function resolveCssEntries(entries, projectRoot, base) {
 		dependencies
 	};
 }
+function resolveCssSources(sources, projectRoot, base) {
+	const resolvedSources = sources.map((source) => ({
+		...source,
+		base: source.base === void 0 ? void 0 : resolveBase(source.base, projectRoot),
+		file: source.file === void 0 ? void 0 : path.isAbsolute(source.file) ? path.resolve(source.file) : path.resolve(projectRoot, source.file),
+		dependencies: source.dependencies?.map((dependency) => path.isAbsolute(dependency) ? path.resolve(dependency) : path.resolve(projectRoot, dependency)) ?? []
+	}));
+	const firstSource = resolvedSources[0];
+	const resolvedBase = base ?? firstSource?.base ?? (firstSource?.file ? path.dirname(firstSource.file) : projectRoot);
+	const dependencies = resolvedSources.flatMap((source) => [source.file, ...source.dependencies]).filter((dependency) => Boolean(dependency));
+	return {
+		base: resolvedBase,
+		css: resolvedSources.map((source) => source.css).join("\n"),
+		dependencies
+	};
+}
 function normalizeResolvedSource(source) {
 	const baseFallbacks = uniquePaths([
 		...source.baseFallbacks,
@@ -133,15 +149,17 @@ async function resolveTailwindV4Source(options = {}) {
 		css: options.css,
 		dependencies: []
 	});
-	if (options.cssEntries?.length) {
-		const entries = await resolveCssEntries(options.cssEntries, projectRoot, configuredBase);
+	if (options.cssEntries?.length || options.cssSources?.length) {
+		const entries = options.cssEntries?.length ? await resolveCssEntries(options.cssEntries, projectRoot, configuredBase) : void 0;
+		const sources = options.cssSources?.length ? resolveCssSources(options.cssSources, projectRoot, configuredBase) : void 0;
+		const css = [entries?.css, sources?.css].filter(Boolean).join("\n");
 		return normalizeResolvedSource({
 			projectRoot,
 			cwd,
-			base: entries.base,
+			base: configuredBase ?? entries?.base ?? sources?.base ?? cwd,
 			baseFallbacks,
-			css: entries.css,
-			dependencies: entries.dependencies
+			css,
+			dependencies: [...entries?.dependencies ?? [], ...sources?.dependencies ?? []]
 		});
 	}
 	return normalizeResolvedSource({
@@ -173,6 +191,7 @@ function createSourceOptionsFromNormalizedPatchOptions(options) {
 		...v4?.configuredBase === void 0 ? {} : { base: v4.configuredBase },
 		baseFallbacks,
 		...v4?.css === void 0 ? {} : { css: v4.css },
+		...v4?.cssSources === void 0 ? {} : { cssSources: v4.cssSources },
 		...v4?.cssEntries === void 0 ? {} : { cssEntries: v4.cssEntries },
 		packageName: options.tailwind.packageName
 	};

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as TailwindTokenByFileMap, A as groupTokensByFile, B as NormalizedTailwindCssPatchOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, D as extractRawCandidates, E as extractProjectCandidatesWithPositions, F as CacheStrategy, G as TailwindV4Options, H as TailwindCssPatchOptions, I as ExposeContextOptions, J as PatchCheckStatus, K as ExtractResult, L as ExtendLengthUnitsOptions, M as normalizeOptions, N as ApplyOptions, O as extractRawCandidatesWithPositions, P as CacheOptions, Q as TailwindPatchRuntime, R as ExtractOptions, S as MIGRATION_REPORT_KIND, T as TailwindcssPatcher, U as TailwindV2Options, V as TailwindCssOptions, W as TailwindV3Options, X as PatchStatusEntry, Y as PatchName, Z as PatchStatusReport, _ as ConfigFileMigrationEntry, a as ValidateFailureSummary, at as CacheClearOptions, b as RestoreConfigFilesOptions, c as TailwindcssPatchCliMountOptions, ct as CacheContextDescriptor, d as TailwindcssPatchCommandContext, dt as CacheReadMeta, et as TailwindTokenFileKey, f as TailwindcssPatchCommandHandler, ft as CacheReadResult, g as tailwindcssPatchCommands, h as TailwindcssPatchCommandOptions, i as ValidateFailureReason, it as TailwindcssRuntimeContext, j as BareArbitraryValueOptions, k as extractValidCandidates, l as TailwindcssPatchCliOptions, lt as CacheContextMetadata, m as TailwindcssPatchCommandOptionDefinition, n as VALIDATE_FAILURE_REASONS, nt as TailwindTokenReport, o as ValidateJsonFailurePayload, ot as CacheClearResult, p as TailwindcssPatchCommandHandlerMap, q as ILengthUnitsPatchOptions, r as ValidateCommandError, rt as TailwindcssClassCache, s as ValidateJsonSuccessPayload, st as CacheClearScope, t as VALIDATE_EXIT_CODES, tt as TailwindTokenLocation, u as TailwindcssPatchCommand, ut as CacheIndexFileV2, v as ConfigFileMigrationReport, w as logger, x as RestoreConfigFilesResult, y as MigrateConfigFilesOptions, z as NormalizedCacheOptions } from "./validate-C8-qsOWo.mjs";
+import { $ as TailwindV4SourceOptions, A as groupTokensByFile, B as NormalizedTailwindCssPatchOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, D as extractRawCandidates, E as extractProjectCandidatesWithPositions, F as CacheStrategy, G as TailwindV4Options, H as TailwindCssPatchOptions, I as ExposeContextOptions, J as TailwindV4DesignSystem, K as TailwindV4CandidateSource, L as ExtendLengthUnitsOptions, M as normalizeOptions, N as ApplyOptions, O as extractRawCandidatesWithPositions, P as CacheOptions, Q as TailwindV4ResolvedSource, R as ExtractOptions, S as MIGRATION_REPORT_KIND, T as TailwindcssPatcher, U as TailwindV2Options, V as TailwindCssOptions, W as TailwindV3Options, X as TailwindV4GenerateOptions, Y as TailwindV4Engine, Z as TailwindV4GenerateResult, _ as ConfigFileMigrationEntry, _t as CacheContextMetadata, a as ValidateFailureSummary, at as PatchStatusReport, b as RestoreConfigFilesOptions, bt as CacheReadResult, c as TailwindcssPatchCliMountOptions, ct as TailwindTokenFileKey, d as TailwindcssPatchCommandContext, dt as TailwindcssClassCache, et as ExtractResult, f as TailwindcssPatchCommandHandler, ft as TailwindcssRuntimeContext, g as tailwindcssPatchCommands, gt as CacheContextDescriptor, h as TailwindcssPatchCommandOptions, ht as CacheClearScope, i as ValidateFailureReason, it as PatchStatusEntry, j as BareArbitraryValueOptions, k as extractValidCandidates, l as TailwindcssPatchCliOptions, lt as TailwindTokenLocation, m as TailwindcssPatchCommandOptionDefinition, mt as CacheClearResult, n as VALIDATE_FAILURE_REASONS, nt as PatchCheckStatus, o as ValidateJsonFailurePayload, ot as TailwindPatchRuntime, p as TailwindcssPatchCommandHandlerMap, pt as CacheClearOptions, q as TailwindV4CssSource, r as ValidateCommandError, rt as PatchName, s as ValidateJsonSuccessPayload, st as TailwindTokenByFileMap, t as VALIDATE_EXIT_CODES, tt as ILengthUnitsPatchOptions, u as TailwindcssPatchCommand, ut as TailwindTokenReport, v as ConfigFileMigrationReport, vt as CacheIndexFileV2, w as logger, x as RestoreConfigFilesResult, y as MigrateConfigFilesOptions, yt as CacheReadMeta, z as NormalizedCacheOptions } from "./validate-DDJnolx2.mjs";
 import { PackageInfo } from "local-pkg";
 import postcss from "postcss";
 import { CAC } from "cac";
@@ -77,71 +77,6 @@ interface PatchStatusContext {
 }
 declare function getPatchStatusReport(context: PatchStatusContext): PatchStatusReport;
 //#endregion
-//#region src/v4/types.d.ts
-interface TailwindV4SourceOptions {
-  projectRoot?: string;
-  cwd?: string;
-  base?: string;
-  baseFallbacks?: string[];
-  css?: string;
-  cssEntries?: string[];
-  packageName?: string;
-}
-interface TailwindV4ResolvedSource {
-  projectRoot: string;
-  base: string;
-  baseFallbacks: string[];
-  css: string;
-  dependencies: string[];
-}
-interface TailwindV4CandidateSource {
-  content: string;
-  extension?: string;
-}
-interface TailwindV4GenerateOptions {
-  candidates?: Iterable<string>;
-  sources?: TailwindV4CandidateSource[];
-  /**
-   * Enables UnoCSS-style bare arbitrary values such as `p-10%` and `p-2.5px`.
-   */
-  bareArbitraryValues?: boolean | {
-    units?: string[];
-  };
-  /**
-   * 扫描文件系统 source entries 中的候选类名。
-   *
-   * - `true`：使用 Tailwind v4 编译入口解析出的 `@source` 列表。
-   * - `TailwindV4SourcePattern[]`：使用调用方显式传入的 source 列表。
-   */
-  scanSources?: boolean | TailwindV4SourcePattern[];
-}
-interface TailwindV4SourcePattern {
-  base: string;
-  pattern: string;
-  negated: boolean;
-}
-interface TailwindV4GenerateResult {
-  css: string;
-  classSet: Set<string>;
-  rawCandidates: Set<string>;
-  dependencies: string[];
-  sources: TailwindV4SourcePattern[];
-  root: null | 'none' | {
-    base: string;
-    pattern: string;
-  };
-}
-interface TailwindV4DesignSystem {
-  parseCandidate: (candidate: string) => unknown[];
-  candidatesToCss: (candidates: string[]) => Array<string | null | undefined>;
-}
-interface TailwindV4Engine {
-  source: TailwindV4ResolvedSource;
-  loadDesignSystem: () => Promise<TailwindV4DesignSystem>;
-  validateCandidates: (candidates: Iterable<string>) => Promise<Set<string>>;
-  generate: (options?: TailwindV4GenerateOptions) => Promise<TailwindV4GenerateResult>;
-}
-//#endregion
 //#region src/v4/candidates.d.ts
 declare function resolveValidTailwindV4Candidates(designSystem: TailwindV4DesignSystem, candidates: Iterable<string>, options?: {
   bareArbitraryValues?: boolean | BareArbitraryValueOptions;
@@ -162,4 +97,4 @@ declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPa
 declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
 declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
 //#endregion
-export { ApplyOptions, CacheClearOptions, CacheClearResult, CacheClearScope, CacheContextMetadata, CacheOptions, CacheReadMeta, CacheStore, CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, ExposeContextOptions, ExtendLengthUnitsOptions, ExtractOptions, ExtractResult, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, TailwindV2Options, TailwindV3Options, type TailwindV4CandidateSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, 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, createTailwindV4Engine, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, resolveTailwindV4Source, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };
+export { ApplyOptions, CacheClearOptions, CacheClearResult, CacheClearScope, CacheContextMetadata, CacheOptions, CacheReadMeta, CacheStore, CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, ExposeContextOptions, ExtendLengthUnitsOptions, ExtractOptions, ExtractResult, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, TailwindV2Options, TailwindV3Options, type TailwindV4CandidateSource, type TailwindV4CssSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, 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, createTailwindV4Engine, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, resolveTailwindV4Source, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as TailwindTokenByFileMap, A as groupTokensByFile, B as NormalizedTailwindCssPatchOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, D as extractRawCandidates, E as extractProjectCandidatesWithPositions, F as CacheStrategy, G as TailwindV4Options, H as TailwindCssPatchOptions, I as ExposeContextOptions, J as PatchCheckStatus, K as ExtractResult, L as ExtendLengthUnitsOptions, M as normalizeOptions, N as ApplyOptions, O as extractRawCandidatesWithPositions, P as CacheOptions, Q as TailwindPatchRuntime, R as ExtractOptions, S as MIGRATION_REPORT_KIND, T as TailwindcssPatcher, U as TailwindV2Options, V as TailwindCssOptions, W as TailwindV3Options, X as PatchStatusEntry, Y as PatchName, Z as PatchStatusReport, _ as ConfigFileMigrationEntry, a as ValidateFailureSummary, at as CacheClearOptions, b as RestoreConfigFilesOptions, c as TailwindcssPatchCliMountOptions, ct as CacheContextDescriptor, d as TailwindcssPatchCommandContext, dt as CacheReadMeta, et as TailwindTokenFileKey, f as TailwindcssPatchCommandHandler, ft as CacheReadResult, g as tailwindcssPatchCommands, h as TailwindcssPatchCommandOptions, i as ValidateFailureReason, it as TailwindcssRuntimeContext, j as BareArbitraryValueOptions, k as extractValidCandidates, l as TailwindcssPatchCliOptions, lt as CacheContextMetadata, m as TailwindcssPatchCommandOptionDefinition, n as VALIDATE_FAILURE_REASONS, nt as TailwindTokenReport, o as ValidateJsonFailurePayload, ot as CacheClearResult, p as TailwindcssPatchCommandHandlerMap, q as ILengthUnitsPatchOptions, r as ValidateCommandError, rt as TailwindcssClassCache, s as ValidateJsonSuccessPayload, st as CacheClearScope, t as VALIDATE_EXIT_CODES, tt as TailwindTokenLocation, u as TailwindcssPatchCommand, ut as CacheIndexFileV2, v as ConfigFileMigrationReport, w as logger, x as RestoreConfigFilesResult, y as MigrateConfigFilesOptions, z as NormalizedCacheOptions } from "./validate-Bqych-z9.js";
+import { $ as TailwindV4SourceOptions, A as groupTokensByFile, B as NormalizedTailwindCssPatchOptions, C as MIGRATION_REPORT_SCHEMA_VERSION, D as extractRawCandidates, E as extractProjectCandidatesWithPositions, F as CacheStrategy, G as TailwindV4Options, H as TailwindCssPatchOptions, I as ExposeContextOptions, J as TailwindV4DesignSystem, K as TailwindV4CandidateSource, L as ExtendLengthUnitsOptions, M as normalizeOptions, N as ApplyOptions, O as extractRawCandidatesWithPositions, P as CacheOptions, Q as TailwindV4ResolvedSource, R as ExtractOptions, S as MIGRATION_REPORT_KIND, T as TailwindcssPatcher, U as TailwindV2Options, V as TailwindCssOptions, W as TailwindV3Options, X as TailwindV4GenerateOptions, Y as TailwindV4Engine, Z as TailwindV4GenerateResult, _ as ConfigFileMigrationEntry, _t as CacheContextMetadata, a as ValidateFailureSummary, at as PatchStatusReport, b as RestoreConfigFilesOptions, bt as CacheReadResult, c as TailwindcssPatchCliMountOptions, ct as TailwindTokenFileKey, d as TailwindcssPatchCommandContext, dt as TailwindcssClassCache, et as ExtractResult, f as TailwindcssPatchCommandHandler, ft as TailwindcssRuntimeContext, g as tailwindcssPatchCommands, gt as CacheContextDescriptor, h as TailwindcssPatchCommandOptions, ht as CacheClearScope, i as ValidateFailureReason, it as PatchStatusEntry, j as BareArbitraryValueOptions, k as extractValidCandidates, l as TailwindcssPatchCliOptions, lt as TailwindTokenLocation, m as TailwindcssPatchCommandOptionDefinition, mt as CacheClearResult, n as VALIDATE_FAILURE_REASONS, nt as PatchCheckStatus, o as ValidateJsonFailurePayload, ot as TailwindPatchRuntime, p as TailwindcssPatchCommandHandlerMap, pt as CacheClearOptions, q as TailwindV4CssSource, r as ValidateCommandError, rt as PatchName, s as ValidateJsonSuccessPayload, st as TailwindTokenByFileMap, t as VALIDATE_EXIT_CODES, tt as ILengthUnitsPatchOptions, u as TailwindcssPatchCommand, ut as TailwindTokenReport, v as ConfigFileMigrationReport, vt as CacheIndexFileV2, w as logger, x as RestoreConfigFilesResult, y as MigrateConfigFilesOptions, yt as CacheReadMeta, z as NormalizedCacheOptions } from "./validate-rPPCy1cl.js";
 import { CAC } from "cac";
 import { PackageInfo } from "local-pkg";
 import postcss from "postcss";
@@ -77,71 +77,6 @@ interface PatchStatusContext {
 }
 declare function getPatchStatusReport(context: PatchStatusContext): PatchStatusReport;
 //#endregion
-//#region src/v4/types.d.ts
-interface TailwindV4SourceOptions {
-  projectRoot?: string;
-  cwd?: string;
-  base?: string;
-  baseFallbacks?: string[];
-  css?: string;
-  cssEntries?: string[];
-  packageName?: string;
-}
-interface TailwindV4ResolvedSource {
-  projectRoot: string;
-  base: string;
-  baseFallbacks: string[];
-  css: string;
-  dependencies: string[];
-}
-interface TailwindV4CandidateSource {
-  content: string;
-  extension?: string;
-}
-interface TailwindV4GenerateOptions {
-  candidates?: Iterable<string>;
-  sources?: TailwindV4CandidateSource[];
-  /**
-   * Enables UnoCSS-style bare arbitrary values such as `p-10%` and `p-2.5px`.
-   */
-  bareArbitraryValues?: boolean | {
-    units?: string[];
-  };
-  /**
-   * 扫描文件系统 source entries 中的候选类名。
-   *
-   * - `true`：使用 Tailwind v4 编译入口解析出的 `@source` 列表。
-   * - `TailwindV4SourcePattern[]`：使用调用方显式传入的 source 列表。
-   */
-  scanSources?: boolean | TailwindV4SourcePattern[];
-}
-interface TailwindV4SourcePattern {
-  base: string;
-  pattern: string;
-  negated: boolean;
-}
-interface TailwindV4GenerateResult {
-  css: string;
-  classSet: Set<string>;
-  rawCandidates: Set<string>;
-  dependencies: string[];
-  sources: TailwindV4SourcePattern[];
-  root: null | 'none' | {
-    base: string;
-    pattern: string;
-  };
-}
-interface TailwindV4DesignSystem {
-  parseCandidate: (candidate: string) => unknown[];
-  candidatesToCss: (candidates: string[]) => Array<string | null | undefined>;
-}
-interface TailwindV4Engine {
-  source: TailwindV4ResolvedSource;
-  loadDesignSystem: () => Promise<TailwindV4DesignSystem>;
-  validateCandidates: (candidates: Iterable<string>) => Promise<Set<string>>;
-  generate: (options?: TailwindV4GenerateOptions) => Promise<TailwindV4GenerateResult>;
-}
-//#endregion
 //#region src/v4/candidates.d.ts
 declare function resolveValidTailwindV4Candidates(designSystem: TailwindV4DesignSystem, candidates: Iterable<string>, options?: {
   bareArbitraryValues?: boolean | BareArbitraryValueOptions;
@@ -162,4 +97,4 @@ declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPa
 declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
 declare function defineConfig<T extends TailwindcssMangleConfig>(config: T): T;
 //#endregion
-export { ApplyOptions, CacheClearOptions, CacheClearResult, CacheClearScope, CacheContextMetadata, CacheOptions, CacheReadMeta, CacheStore, CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, ExposeContextOptions, ExtendLengthUnitsOptions, ExtractOptions, ExtractResult, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, TailwindV2Options, TailwindV3Options, type TailwindV4CandidateSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, 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, createTailwindV4Engine, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, resolveTailwindV4Source, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };
+export { ApplyOptions, CacheClearOptions, CacheClearResult, CacheClearScope, CacheContextMetadata, CacheOptions, CacheReadMeta, CacheStore, CacheStrategy, type ConfigFileMigrationEntry, type ConfigFileMigrationReport, ExposeContextOptions, ExtendLengthUnitsOptions, ExtractOptions, ExtractResult, ILengthUnitsPatchOptions, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, type MigrateConfigFilesOptions, NormalizedTailwindCssPatchOptions, PatchCheckStatus, PatchName, PatchStatusEntry, PatchStatusReport, type RestoreConfigFilesOptions, type RestoreConfigFilesResult, TailwindCssOptions, type TailwindCssPatchOptions, TailwindPatchRuntime, TailwindTokenByFileMap, TailwindTokenFileKey, TailwindTokenLocation, TailwindTokenReport, TailwindV2Options, TailwindV3Options, type TailwindV4CandidateSource, type TailwindV4CssSource, type TailwindV4DesignSystem, type TailwindV4Engine, type TailwindV4GenerateOptions, type TailwindV4GenerateResult, TailwindV4Options, type TailwindV4ResolvedSource, type TailwindV4SourceOptions, 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, createTailwindV4Engine, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, resolveTailwindV4Source, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_validate = require("./validate-CF0M_7KH.js");
-const require_index_bundle = require("./index.bundle-CcVIAfDb.js");
+const require_validate = require("./validate-DABvQ44V.js");
+const require_index_bundle = require("./index.bundle-BdxyJef9.js");
 exports.CacheStore = require_validate.CacheStore;
 exports.MIGRATION_REPORT_KIND = require_validate.MIGRATION_REPORT_KIND;
 exports.MIGRATION_REPORT_SCHEMA_VERSION = require_validate.MIGRATION_REPORT_SCHEMA_VERSION;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { A as CacheStore, E as resolveValidTailwindV4Candidates, S as loadTailwindV4DesignSystem, _ as extractRawCandidates, a as tailwindcssPatchCommands, b as groupTokensByFile, c as MIGRATION_REPORT_KIND, d as getPatchStatusReport, f as runTailwindBuild, g as extractProjectCandidatesWithPositions, h as collectClassesFromTailwindV4, j as logger, k as normalizeOptions, l as MIGRATION_REPORT_SCHEMA_VERSION, m as collectClassesFromContexts, n as VALIDATE_FAILURE_REASONS, o as migrateConfigFiles, p as loadRuntimeContexts, r as ValidateCommandError, s as restoreConfigFiles, t as VALIDATE_EXIT_CODES, u as TailwindcssPatcher, v as extractRawCandidatesWithPositions, y as extractValidCandidates } from "./validate-Sq_yuh3r.mjs";
-import { a as resolveTailwindV4SourceFromPatchOptions, i as resolveTailwindV4Source, n as defineConfig, o as createTailwindV4Engine, r as mountTailwindcssPatchCommands, t as createTailwindcssPatchCli } from "./index.bundle-DjS24i5r.mjs";
+import { A as CacheStore, E as resolveValidTailwindV4Candidates, S as loadTailwindV4DesignSystem, _ as extractRawCandidates, a as tailwindcssPatchCommands, b as groupTokensByFile, c as MIGRATION_REPORT_KIND, d as getPatchStatusReport, f as runTailwindBuild, g as extractProjectCandidatesWithPositions, h as collectClassesFromTailwindV4, j as logger, k as normalizeOptions, l as MIGRATION_REPORT_SCHEMA_VERSION, m as collectClassesFromContexts, n as VALIDATE_FAILURE_REASONS, o as migrateConfigFiles, p as loadRuntimeContexts, r as ValidateCommandError, s as restoreConfigFiles, t as VALIDATE_EXIT_CODES, u as TailwindcssPatcher, v as extractRawCandidatesWithPositions, y as extractValidCandidates } from "./validate-cMWKFUKS.mjs";
+import { a as resolveTailwindV4SourceFromPatchOptions, i as resolveTailwindV4Source, n as defineConfig, o as createTailwindV4Engine, r as mountTailwindcssPatchCommands, t as createTailwindcssPatchCli } from "./index.bundle-C39laqrA.mjs";
 export { CacheStore, MIGRATION_REPORT_KIND, MIGRATION_REPORT_SCHEMA_VERSION, TailwindcssPatcher, VALIDATE_EXIT_CODES, VALIDATE_FAILURE_REASONS, ValidateCommandError, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindV4Engine, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, loadTailwindV4DesignSystem, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, resolveTailwindV4Source, resolveTailwindV4SourceFromPatchOptions, resolveValidTailwindV4Candidates, restoreConfigFiles, runTailwindBuild, tailwindcssPatchCommands };

package/dist/{validate-CF0M_7KH.js → validate-DABvQ44V.js}

@@ -23,7 +23,7 @@ _babel_traverse = require_chunk.__toESM(_babel_traverse);
 let _babel_parser = require("@babel/parser");
 let tailwindcss_config = require("tailwindcss-config");
 //#region package.json
-var version = "9.3.2";
+var version = "9.3.3";
 //#endregion
 //#region src/constants.ts
 const pkgName = "tailwindcss-patch";
@@ -1330,6 +1330,13 @@ function normalizeExtendLengthUnitsOptions(extend) {
 function normalizeTailwindV4Options(v4, fallbackBase) {
 	const configuredBase = v4?.base ? pathe.default.resolve(v4.base) : void 0;
 	const base = configuredBase ?? fallbackBase;
+	const resolveV4Path = (value) => pathe.default.isAbsolute(value) ? pathe.default.resolve(value) : pathe.default.resolve(fallbackBase, value);
+	const cssSources = Array.isArray(v4?.cssSources) ? v4.cssSources.filter((source) => typeof source?.css === "string").map((source) => ({
+		css: source.css,
+		...source.base === void 0 ? {} : { base: resolveV4Path(source.base) },
+		...source.file === void 0 ? {} : { file: resolveV4Path(source.file) },
+		...source.dependencies === void 0 ? {} : { dependencies: source.dependencies.filter(Boolean).map(resolveV4Path) }
+	})) : [];
 	const cssEntries = Array.isArray(v4?.cssEntries) ? v4.cssEntries.filter((entry) => Boolean(entry)).map((entry) => pathe.default.resolve(entry)) : [];
 	const userSources = v4?.sources;
 	const hasUserDefinedSources = Boolean(userSources?.length);
@@ -1342,6 +1349,7 @@ function normalizeTailwindV4Options(v4, fallbackBase) {
 		base,
 		...configuredBase === void 0 ? {} : { configuredBase },
 		...v4?.css === void 0 ? {} : { css: v4.css },
+		cssSources,
 		cssEntries,
 		sources,
 		hasUserDefinedSources,
@@ -2317,6 +2325,25 @@ async function collectClassesFromTailwindV4(options) {
 			negated: source.negated
 		}));
 	};
+	const addCandidates = async (extractOptions) => {
+		const candidates = await extractValidCandidates(extractOptions);
+		for (const candidate of candidates) if (options.filter(candidate)) set.add(candidate);
+	};
+	if (v4Options.cssSources.length > 0) for (const source of v4Options.cssSources) {
+		const sourceFile = toAbsolute(source.file);
+		const sourceBase = toAbsolute(source.base) ?? (sourceFile ? pathe.default.dirname(sourceFile) : resolvedDefaultBase);
+		const designSystemBases = resolvedConfiguredBase && resolvedConfiguredBase !== sourceBase ? [sourceBase, resolvedConfiguredBase] : [sourceBase];
+		const sources = resolveSources(sourceBase);
+		const firstBase = designSystemBases[0] ?? sourceBase;
+		await addCandidates({
+			cwd: options.projectRoot,
+			base: firstBase,
+			baseFallbacks: designSystemBases.slice(1),
+			css: source.css,
+			...v4Options.bareArbitraryValues === void 0 ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues },
+			...sources === void 0 ? {} : { sources }
+		});
+	}
 	if (v4Options.cssEntries.length > 0) for (const entry of v4Options.cssEntries) {
 		const filePath = pathe.default.isAbsolute(entry) ? entry : pathe.default.resolve(options.projectRoot, entry);
 		if (!await fs_extra.default.pathExists(filePath)) continue;
@@ -2325,7 +2352,7 @@ async function collectClassesFromTailwindV4(options) {
 		const designSystemBases = resolvedConfiguredBase && resolvedConfiguredBase !== entryDir ? [entryDir, resolvedConfiguredBase] : [entryDir];
 		const sources = resolveSources(resolvedConfiguredBase ?? entryDir);
 		const firstBase = designSystemBases[0] ?? entryDir;
-		const candidates = await extractValidCandidates({
+		await addCandidates({
 			cwd: options.projectRoot,
 			base: firstBase,
 			baseFallbacks: designSystemBases.slice(1),
@@ -2333,19 +2360,17 @@ async function collectClassesFromTailwindV4(options) {
 			...v4Options.bareArbitraryValues === void 0 ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues },
 			...sources === void 0 ? {} : { sources }
 		});
-		for (const candidate of candidates) if (options.filter(candidate)) set.add(candidate);
 	}
-	else {
+	else if (v4Options.cssSources.length === 0) {
 		const baseForCss = resolvedConfiguredBase ?? resolvedDefaultBase;
 		const sources = resolveSources(baseForCss);
-		const candidates = await extractValidCandidates({
+		await addCandidates({
 			cwd: options.projectRoot,
 			base: baseForCss,
 			...v4Options.bareArbitraryValues === void 0 ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues },
 			...v4Options.css === void 0 ? {} : { css: v4Options.css },
 			...sources === void 0 ? {} : { sources }
 		});
-		for (const candidate of candidates) if (options.filter(candidate)) set.add(candidate);
 	}
 	return set;
 }

package/dist/{validate-Bqych-z9.d.ts → validate-DDJnolx2.d.mts}

@@ -1,10 +1,9 @@
-import { CAC, Command } from "cac";
 import { PackageInfo, PackageResolvingOptions } from "local-pkg";
-import { SourceEntry } from "@tailwindcss/oxide";
+import * as _$consola from "consola";
 import { Node, Rule } from "postcss";
+import { CAC, Command } from "cac";
+import { SourceEntry } from "@tailwindcss/oxide";
 import { Config } from "tailwindcss";
-import * as _$consola from "consola";
-
 //#region src/cache/types.d.ts
 declare const CACHE_SCHEMA_VERSION = 2;
 declare const CACHE_FINGERPRINT_VERSION = 1;
@@ -159,6 +158,78 @@ interface PatchStatusReport {
   entries: PatchStatusEntry[];
 }
 //#endregion
+//#region src/v4/types.d.ts
+interface TailwindV4SourceOptions {
+  projectRoot?: string;
+  cwd?: string;
+  base?: string;
+  baseFallbacks?: string[];
+  css?: string;
+  cssSources?: TailwindV4CssSource[];
+  cssEntries?: string[];
+  packageName?: string;
+}
+interface TailwindV4CssSource {
+  css: string;
+  base?: string;
+  file?: string;
+  dependencies?: string[];
+}
+interface TailwindV4ResolvedSource {
+  projectRoot: string;
+  base: string;
+  baseFallbacks: string[];
+  css: string;
+  dependencies: string[];
+}
+interface TailwindV4CandidateSource {
+  content: string;
+  extension?: string;
+}
+interface TailwindV4GenerateOptions {
+  candidates?: Iterable<string>;
+  sources?: TailwindV4CandidateSource[];
+  /**
+   * Enables UnoCSS-style bare arbitrary values such as `p-10%` and `p-2.5px`.
+   */
+  bareArbitraryValues?: boolean | {
+    units?: string[];
+  };
+  /**
+   * 扫描文件系统 source entries 中的候选类名。
+   *
+   * - `true`：使用 Tailwind v4 编译入口解析出的 `@source` 列表。
+   * - `TailwindV4SourcePattern[]`：使用调用方显式传入的 source 列表。
+   */
+  scanSources?: boolean | TailwindV4SourcePattern[];
+}
+interface TailwindV4SourcePattern {
+  base: string;
+  pattern: string;
+  negated: boolean;
+}
+interface TailwindV4GenerateResult {
+  css: string;
+  classSet: Set<string>;
+  rawCandidates: Set<string>;
+  dependencies: string[];
+  sources: TailwindV4SourcePattern[];
+  root: null | 'none' | {
+    base: string;
+    pattern: string;
+  };
+}
+interface TailwindV4DesignSystem {
+  parseCandidate: (candidate: string) => unknown[];
+  candidatesToCss: (candidates: string[]) => Array<string | null | undefined>;
+}
+interface TailwindV4Engine {
+  source: TailwindV4ResolvedSource;
+  loadDesignSystem: () => Promise<TailwindV4DesignSystem>;
+  validateCandidates: (candidates: Iterable<string>) => Promise<Set<string>>;
+  generate: (options?: TailwindV4GenerateOptions) => Promise<TailwindV4GenerateResult>;
+}
+//#endregion
 //#region src/options/types.d.ts
 type CacheStrategy = 'merge' | 'overwrite';
 type CacheDriver = 'file' | 'memory' | 'noop';
@@ -246,6 +317,8 @@ interface TailwindV4Options {
   base?: string;
   /** Raw CSS passed directly to the v4 design system. */
   css?: string;
+  /** 构建器在 CSS 落盘前捕获的内存 CSS 入口。 */
+  cssSources?: TailwindV4CssSource[];
   /** Set of CSS entry files that should be scanned for `@config` directives. */
   cssEntries?: string[];
   /** Overrides the content sources scanned by the oxide scanner. */
@@ -328,6 +401,7 @@ interface NormalizedTailwindV4Options {
   base: string;
   configuredBase?: string;
   css?: string;
+  cssSources: TailwindV4CssSource[];
   cssEntries: string[];
   sources: SourceEntry[];
   hasUserDefinedSources: boolean;
@@ -699,4 +773,4 @@ declare class ValidateCommandError extends Error {
   constructor(summary: ValidateFailureSummary, options?: ErrorOptions);
 }
 //#endregion
-export { TailwindTokenByFileMap as $, groupTokensByFile as A, NormalizedTailwindCssPatchOptions as B, MIGRATION_REPORT_SCHEMA_VERSION as C, extractRawCandidates as D, extractProjectCandidatesWithPositions as E, CacheStrategy as F, TailwindV4Options as G, TailwindCssPatchOptions as H, ExposeContextOptions as I, PatchCheckStatus as J, ExtractResult as K, ExtendLengthUnitsOptions as L, normalizeOptions as M, ApplyOptions as N, extractRawCandidatesWithPositions as O, CacheOptions as P, TailwindPatchRuntime as Q, ExtractOptions as R, MIGRATION_REPORT_KIND as S, TailwindcssPatcher as T, TailwindV2Options as U, TailwindCssOptions as V, TailwindV3Options as W, PatchStatusEntry as X, PatchName as Y, PatchStatusReport as Z, ConfigFileMigrationEntry as _, ValidateFailureSummary as a, CacheClearOptions as at, RestoreConfigFilesOptions as b, TailwindcssPatchCliMountOptions as c, CacheContextDescriptor as ct, TailwindcssPatchCommandContext as d, CacheReadMeta as dt, TailwindTokenFileKey as et, TailwindcssPatchCommandHandler as f, CacheReadResult as ft, tailwindcssPatchCommands as g, TailwindcssPatchCommandOptions as h, ValidateFailureReason as i, TailwindcssRuntimeContext as it, BareArbitraryValueOptions as j, extractValidCandidates as k, TailwindcssPatchCliOptions as l, CacheContextMetadata as lt, TailwindcssPatchCommandOptionDefinition as m, VALIDATE_FAILURE_REASONS as n, TailwindTokenReport as nt, ValidateJsonFailurePayload as o, CacheClearResult as ot, TailwindcssPatchCommandHandlerMap as p, ILengthUnitsPatchOptions as q, ValidateCommandError as r, TailwindcssClassCache as rt, ValidateJsonSuccessPayload as s, CacheClearScope as st, VALIDATE_EXIT_CODES as t, TailwindTokenLocation as tt, TailwindcssPatchCommand as u, CacheIndexFileV2 as ut, ConfigFileMigrationReport as v, logger as w, RestoreConfigFilesResult as x, MigrateConfigFilesOptions as y, NormalizedCacheOptions as z };
+export { TailwindV4SourceOptions as $, groupTokensByFile as A, NormalizedTailwindCssPatchOptions as B, MIGRATION_REPORT_SCHEMA_VERSION as C, extractRawCandidates as D, extractProjectCandidatesWithPositions as E, CacheStrategy as F, TailwindV4Options as G, TailwindCssPatchOptions as H, ExposeContextOptions as I, TailwindV4DesignSystem as J, TailwindV4CandidateSource as K, ExtendLengthUnitsOptions as L, normalizeOptions as M, ApplyOptions as N, extractRawCandidatesWithPositions as O, CacheOptions as P, TailwindV4ResolvedSource as Q, ExtractOptions as R, MIGRATION_REPORT_KIND as S, TailwindcssPatcher as T, TailwindV2Options as U, TailwindCssOptions as V, TailwindV3Options as W, TailwindV4GenerateOptions as X, TailwindV4Engine as Y, TailwindV4GenerateResult as Z, ConfigFileMigrationEntry as _, CacheContextMetadata as _t, ValidateFailureSummary as a, PatchStatusReport as at, RestoreConfigFilesOptions as b, CacheReadResult as bt, TailwindcssPatchCliMountOptions as c, TailwindTokenFileKey as ct, TailwindcssPatchCommandContext as d, TailwindcssClassCache as dt, ExtractResult as et, TailwindcssPatchCommandHandler as f, TailwindcssRuntimeContext as ft, tailwindcssPatchCommands as g, CacheContextDescriptor as gt, TailwindcssPatchCommandOptions as h, CacheClearScope as ht, ValidateFailureReason as i, PatchStatusEntry as it, BareArbitraryValueOptions as j, extractValidCandidates as k, TailwindcssPatchCliOptions as l, TailwindTokenLocation as lt, TailwindcssPatchCommandOptionDefinition as m, CacheClearResult as mt, VALIDATE_FAILURE_REASONS as n, PatchCheckStatus as nt, ValidateJsonFailurePayload as o, TailwindPatchRuntime as ot, TailwindcssPatchCommandHandlerMap as p, CacheClearOptions as pt, TailwindV4CssSource as q, ValidateCommandError as r, PatchName as rt, ValidateJsonSuccessPayload as s, TailwindTokenByFileMap as st, VALIDATE_EXIT_CODES as t, ILengthUnitsPatchOptions as tt, TailwindcssPatchCommand as u, TailwindTokenReport as ut, ConfigFileMigrationReport as v, CacheIndexFileV2 as vt, logger as w, RestoreConfigFilesResult as x, MigrateConfigFilesOptions as y, CacheReadMeta as yt, NormalizedCacheOptions as z };

package/dist/{validate-Sq_yuh3r.mjs → validate-cMWKFUKS.mjs}

@@ -16,7 +16,7 @@ import _babelTraverse from "@babel/traverse";
 import { parse, parse as parse$1 } from "@babel/parser";
 import { loadConfig } from "tailwindcss-config";
 //#region package.json
-var version = "9.3.2";
+var version = "9.3.3";
 //#endregion
 //#region src/constants.ts
 const pkgName = "tailwindcss-patch";
@@ -1323,6 +1323,13 @@ function normalizeExtendLengthUnitsOptions(extend) {
 function normalizeTailwindV4Options(v4, fallbackBase) {
 	const configuredBase = v4?.base ? path.resolve(v4.base) : void 0;
 	const base = configuredBase ?? fallbackBase;
+	const resolveV4Path = (value) => path.isAbsolute(value) ? path.resolve(value) : path.resolve(fallbackBase, value);
+	const cssSources = Array.isArray(v4?.cssSources) ? v4.cssSources.filter((source) => typeof source?.css === "string").map((source) => ({
+		css: source.css,
+		...source.base === void 0 ? {} : { base: resolveV4Path(source.base) },
+		...source.file === void 0 ? {} : { file: resolveV4Path(source.file) },
+		...source.dependencies === void 0 ? {} : { dependencies: source.dependencies.filter(Boolean).map(resolveV4Path) }
+	})) : [];
 	const cssEntries = Array.isArray(v4?.cssEntries) ? v4.cssEntries.filter((entry) => Boolean(entry)).map((entry) => path.resolve(entry)) : [];
 	const userSources = v4?.sources;
 	const hasUserDefinedSources = Boolean(userSources?.length);
@@ -1335,6 +1342,7 @@ function normalizeTailwindV4Options(v4, fallbackBase) {
 		base,
 		...configuredBase === void 0 ? {} : { configuredBase },
 		...v4?.css === void 0 ? {} : { css: v4.css },
+		cssSources,
 		cssEntries,
 		sources,
 		hasUserDefinedSources,
@@ -2315,6 +2323,25 @@ async function collectClassesFromTailwindV4(options) {
 			negated: source.negated
 		}));
 	};
+	const addCandidates = async (extractOptions) => {
+		const candidates = await extractValidCandidates(extractOptions);
+		for (const candidate of candidates) if (options.filter(candidate)) set.add(candidate);
+	};
+	if (v4Options.cssSources.length > 0) for (const source of v4Options.cssSources) {
+		const sourceFile = toAbsolute(source.file);
+		const sourceBase = toAbsolute(source.base) ?? (sourceFile ? path.dirname(sourceFile) : resolvedDefaultBase);
+		const designSystemBases = resolvedConfiguredBase && resolvedConfiguredBase !== sourceBase ? [sourceBase, resolvedConfiguredBase] : [sourceBase];
+		const sources = resolveSources(sourceBase);
+		const firstBase = designSystemBases[0] ?? sourceBase;
+		await addCandidates({
+			cwd: options.projectRoot,
+			base: firstBase,
+			baseFallbacks: designSystemBases.slice(1),
+			css: source.css,
+			...v4Options.bareArbitraryValues === void 0 ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues },
+			...sources === void 0 ? {} : { sources }
+		});
+	}
 	if (v4Options.cssEntries.length > 0) for (const entry of v4Options.cssEntries) {
 		const filePath = path.isAbsolute(entry) ? entry : path.resolve(options.projectRoot, entry);
 		if (!await fs.pathExists(filePath)) continue;
@@ -2323,7 +2350,7 @@ async function collectClassesFromTailwindV4(options) {
 		const designSystemBases = resolvedConfiguredBase && resolvedConfiguredBase !== entryDir ? [entryDir, resolvedConfiguredBase] : [entryDir];
 		const sources = resolveSources(resolvedConfiguredBase ?? entryDir);
 		const firstBase = designSystemBases[0] ?? entryDir;
-		const candidates = await extractValidCandidates({
+		await addCandidates({
 			cwd: options.projectRoot,
 			base: firstBase,
 			baseFallbacks: designSystemBases.slice(1),
@@ -2331,19 +2358,17 @@ async function collectClassesFromTailwindV4(options) {
 			...v4Options.bareArbitraryValues === void 0 ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues },
 			...sources === void 0 ? {} : { sources }
 		});
-		for (const candidate of candidates) if (options.filter(candidate)) set.add(candidate);
 	}
-	else {
+	else if (v4Options.cssSources.length === 0) {
 		const baseForCss = resolvedConfiguredBase ?? resolvedDefaultBase;
 		const sources = resolveSources(baseForCss);
-		const candidates = await extractValidCandidates({
+		await addCandidates({
 			cwd: options.projectRoot,
 			base: baseForCss,
 			...v4Options.bareArbitraryValues === void 0 ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues },
 			...v4Options.css === void 0 ? {} : { css: v4Options.css },
 			...sources === void 0 ? {} : { sources }
 		});
-		for (const candidate of candidates) if (options.filter(candidate)) set.add(candidate);
 	}
 	return set;
 }

package/dist/{validate-C8-qsOWo.d.mts → validate-rPPCy1cl.d.ts}

@@ -1,9 +1,10 @@
-import { PackageInfo, PackageResolvingOptions } from "local-pkg";
-import * as _$consola from "consola";
-import { Node, Rule } from "postcss";
 import { CAC, Command } from "cac";
+import { PackageInfo, PackageResolvingOptions } from "local-pkg";
 import { SourceEntry } from "@tailwindcss/oxide";
+import { Node, Rule } from "postcss";
 import { Config } from "tailwindcss";
+import * as _$consola from "consola";
+
 //#region src/cache/types.d.ts
 declare const CACHE_SCHEMA_VERSION = 2;
 declare const CACHE_FINGERPRINT_VERSION = 1;
@@ -158,6 +159,78 @@ interface PatchStatusReport {
   entries: PatchStatusEntry[];
 }
 //#endregion
+//#region src/v4/types.d.ts
+interface TailwindV4SourceOptions {
+  projectRoot?: string;
+  cwd?: string;
+  base?: string;
+  baseFallbacks?: string[];
+  css?: string;
+  cssSources?: TailwindV4CssSource[];
+  cssEntries?: string[];
+  packageName?: string;
+}
+interface TailwindV4CssSource {
+  css: string;
+  base?: string;
+  file?: string;
+  dependencies?: string[];
+}
+interface TailwindV4ResolvedSource {
+  projectRoot: string;
+  base: string;
+  baseFallbacks: string[];
+  css: string;
+  dependencies: string[];
+}
+interface TailwindV4CandidateSource {
+  content: string;
+  extension?: string;
+}
+interface TailwindV4GenerateOptions {
+  candidates?: Iterable<string>;
+  sources?: TailwindV4CandidateSource[];
+  /**
+   * Enables UnoCSS-style bare arbitrary values such as `p-10%` and `p-2.5px`.
+   */
+  bareArbitraryValues?: boolean | {
+    units?: string[];
+  };
+  /**
+   * 扫描文件系统 source entries 中的候选类名。
+   *
+   * - `true`：使用 Tailwind v4 编译入口解析出的 `@source` 列表。
+   * - `TailwindV4SourcePattern[]`：使用调用方显式传入的 source 列表。
+   */
+  scanSources?: boolean | TailwindV4SourcePattern[];
+}
+interface TailwindV4SourcePattern {
+  base: string;
+  pattern: string;
+  negated: boolean;
+}
+interface TailwindV4GenerateResult {
+  css: string;
+  classSet: Set<string>;
+  rawCandidates: Set<string>;
+  dependencies: string[];
+  sources: TailwindV4SourcePattern[];
+  root: null | 'none' | {
+    base: string;
+    pattern: string;
+  };
+}
+interface TailwindV4DesignSystem {
+  parseCandidate: (candidate: string) => unknown[];
+  candidatesToCss: (candidates: string[]) => Array<string | null | undefined>;
+}
+interface TailwindV4Engine {
+  source: TailwindV4ResolvedSource;
+  loadDesignSystem: () => Promise<TailwindV4DesignSystem>;
+  validateCandidates: (candidates: Iterable<string>) => Promise<Set<string>>;
+  generate: (options?: TailwindV4GenerateOptions) => Promise<TailwindV4GenerateResult>;
+}
+//#endregion
 //#region src/options/types.d.ts
 type CacheStrategy = 'merge' | 'overwrite';
 type CacheDriver = 'file' | 'memory' | 'noop';
@@ -245,6 +318,8 @@ interface TailwindV4Options {
   base?: string;
   /** Raw CSS passed directly to the v4 design system. */
   css?: string;
+  /** 构建器在 CSS 落盘前捕获的内存 CSS 入口。 */
+  cssSources?: TailwindV4CssSource[];
   /** Set of CSS entry files that should be scanned for `@config` directives. */
   cssEntries?: string[];
   /** Overrides the content sources scanned by the oxide scanner. */
@@ -327,6 +402,7 @@ interface NormalizedTailwindV4Options {
   base: string;
   configuredBase?: string;
   css?: string;
+  cssSources: TailwindV4CssSource[];
   cssEntries: string[];
   sources: SourceEntry[];
   hasUserDefinedSources: boolean;
@@ -698,4 +774,4 @@ declare class ValidateCommandError extends Error {
   constructor(summary: ValidateFailureSummary, options?: ErrorOptions);
 }
 //#endregion
-export { TailwindTokenByFileMap as $, groupTokensByFile as A, NormalizedTailwindCssPatchOptions as B, MIGRATION_REPORT_SCHEMA_VERSION as C, extractRawCandidates as D, extractProjectCandidatesWithPositions as E, CacheStrategy as F, TailwindV4Options as G, TailwindCssPatchOptions as H, ExposeContextOptions as I, PatchCheckStatus as J, ExtractResult as K, ExtendLengthUnitsOptions as L, normalizeOptions as M, ApplyOptions as N, extractRawCandidatesWithPositions as O, CacheOptions as P, TailwindPatchRuntime as Q, ExtractOptions as R, MIGRATION_REPORT_KIND as S, TailwindcssPatcher as T, TailwindV2Options as U, TailwindCssOptions as V, TailwindV3Options as W, PatchStatusEntry as X, PatchName as Y, PatchStatusReport as Z, ConfigFileMigrationEntry as _, ValidateFailureSummary as a, CacheClearOptions as at, RestoreConfigFilesOptions as b, TailwindcssPatchCliMountOptions as c, CacheContextDescriptor as ct, TailwindcssPatchCommandContext as d, CacheReadMeta as dt, TailwindTokenFileKey as et, TailwindcssPatchCommandHandler as f, CacheReadResult as ft, tailwindcssPatchCommands as g, TailwindcssPatchCommandOptions as h, ValidateFailureReason as i, TailwindcssRuntimeContext as it, BareArbitraryValueOptions as j, extractValidCandidates as k, TailwindcssPatchCliOptions as l, CacheContextMetadata as lt, TailwindcssPatchCommandOptionDefinition as m, VALIDATE_FAILURE_REASONS as n, TailwindTokenReport as nt, ValidateJsonFailurePayload as o, CacheClearResult as ot, TailwindcssPatchCommandHandlerMap as p, ILengthUnitsPatchOptions as q, ValidateCommandError as r, TailwindcssClassCache as rt, ValidateJsonSuccessPayload as s, CacheClearScope as st, VALIDATE_EXIT_CODES as t, TailwindTokenLocation as tt, TailwindcssPatchCommand as u, CacheIndexFileV2 as ut, ConfigFileMigrationReport as v, logger as w, RestoreConfigFilesResult as x, MigrateConfigFilesOptions as y, NormalizedCacheOptions as z };
+export { TailwindV4SourceOptions as $, groupTokensByFile as A, NormalizedTailwindCssPatchOptions as B, MIGRATION_REPORT_SCHEMA_VERSION as C, extractRawCandidates as D, extractProjectCandidatesWithPositions as E, CacheStrategy as F, TailwindV4Options as G, TailwindCssPatchOptions as H, ExposeContextOptions as I, TailwindV4DesignSystem as J, TailwindV4CandidateSource as K, ExtendLengthUnitsOptions as L, normalizeOptions as M, ApplyOptions as N, extractRawCandidatesWithPositions as O, CacheOptions as P, TailwindV4ResolvedSource as Q, ExtractOptions as R, MIGRATION_REPORT_KIND as S, TailwindcssPatcher as T, TailwindV2Options as U, TailwindCssOptions as V, TailwindV3Options as W, TailwindV4GenerateOptions as X, TailwindV4Engine as Y, TailwindV4GenerateResult as Z, ConfigFileMigrationEntry as _, CacheContextMetadata as _t, ValidateFailureSummary as a, PatchStatusReport as at, RestoreConfigFilesOptions as b, CacheReadResult as bt, TailwindcssPatchCliMountOptions as c, TailwindTokenFileKey as ct, TailwindcssPatchCommandContext as d, TailwindcssClassCache as dt, ExtractResult as et, TailwindcssPatchCommandHandler as f, TailwindcssRuntimeContext as ft, tailwindcssPatchCommands as g, CacheContextDescriptor as gt, TailwindcssPatchCommandOptions as h, CacheClearScope as ht, ValidateFailureReason as i, PatchStatusEntry as it, BareArbitraryValueOptions as j, extractValidCandidates as k, TailwindcssPatchCliOptions as l, TailwindTokenLocation as lt, TailwindcssPatchCommandOptionDefinition as m, CacheClearResult as mt, VALIDATE_FAILURE_REASONS as n, PatchCheckStatus as nt, ValidateJsonFailurePayload as o, TailwindPatchRuntime as ot, TailwindcssPatchCommandHandlerMap as p, CacheClearOptions as pt, TailwindV4CssSource as q, ValidateCommandError as r, PatchName as rt, ValidateJsonSuccessPayload as s, TailwindTokenByFileMap as st, VALIDATE_EXIT_CODES as t, ILengthUnitsPatchOptions as tt, TailwindcssPatchCommand as u, TailwindTokenReport as ut, ConfigFileMigrationReport as v, CacheIndexFileV2 as vt, logger as w, RestoreConfigFilesResult as x, MigrateConfigFilesOptions as y, CacheReadMeta as yt, NormalizedCacheOptions as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tailwindcss-patch",
-  "version": "9.3.2",
+  "version": "9.3.3",
   "description": "patch tailwindcss for exposing context and extract classes",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",

package/src/index.bundle.ts

@@ -105,6 +105,7 @@ export type { TailwindCssPatchOptions } from './config'
 export * from './types'
 export type {
   TailwindV4CandidateSource,
+  TailwindV4CssSource,
   TailwindV4DesignSystem,
   TailwindV4Engine,
   TailwindV4GenerateOptions,

package/src/index.ts

@@ -60,6 +60,7 @@ export {
 } from './v4'
 export type {
   TailwindV4CandidateSource,
+  TailwindV4CssSource,
   TailwindV4DesignSystem,
   TailwindV4Engine,
   TailwindV4GenerateOptions,

package/src/options/normalize.ts

@@ -148,6 +148,19 @@ function normalizeTailwindV4Options(
 ): NormalizedTailwindV4Options {
   const configuredBase = v4?.base ? path.resolve(v4.base) : undefined
   const base = configuredBase ?? fallbackBase
+  const resolveV4Path = (value: string) => path.isAbsolute(value) ? path.resolve(value) : path.resolve(fallbackBase, value)
+  const cssSources = Array.isArray(v4?.cssSources)
+    ? v4!.cssSources
+        .filter(source => typeof source?.css === 'string')
+        .map(source => ({
+          css: source.css,
+          ...(source.base === undefined ? {} : { base: resolveV4Path(source.base) }),
+          ...(source.file === undefined ? {} : { file: resolveV4Path(source.file) }),
+          ...(source.dependencies === undefined
+            ? {}
+            : { dependencies: source.dependencies.filter(Boolean).map(resolveV4Path) }),
+        }))
+    : []
   const cssEntries = Array.isArray(v4?.cssEntries)
     ? v4!.cssEntries.filter((entry): entry is string => Boolean(entry)).map(entry => path.resolve(entry))
     : []
@@ -167,6 +180,7 @@ function normalizeTailwindV4Options(
     base,
     ...(configuredBase === undefined ? {} : { configuredBase }),
     ...(v4?.css === undefined ? {} : { css: v4.css }),
+    cssSources,
     cssEntries,
     sources,
     hasUserDefinedSources,

package/src/options/types.ts

@@ -1,6 +1,7 @@
 import type { SourceEntry } from '@tailwindcss/oxide'
 import type { PackageResolvingOptions } from 'local-pkg'
 import type { ILengthUnitsPatchOptions } from '../types'
+import type { TailwindV4CssSource } from '../v4/types'
 
 export type CacheStrategy = 'merge' | 'overwrite'
 export type CacheDriver = 'file' | 'memory' | 'noop'
@@ -97,6 +98,8 @@ export interface TailwindV4Options {
   base?: string
   /** Raw CSS passed directly to the v4 design system. */
   css?: string
+  /** 构建器在 CSS 落盘前捕获的内存 CSS 入口。 */
+  cssSources?: TailwindV4CssSource[]
   /** Set of CSS entry files that should be scanned for `@config` directives. */
   cssEntries?: string[]
   /** Overrides the content sources scanned by the oxide scanner. */
@@ -187,6 +190,7 @@ export interface NormalizedTailwindV4Options {
   base: string
   configuredBase?: string
   css?: string
+  cssSources: TailwindV4CssSource[]
   cssEntries: string[]
   sources: SourceEntry[]
   hasUserDefinedSources: boolean

package/src/runtime/class-collector.ts

@@ -1,3 +1,4 @@
+import type { ExtractValidCandidatesOption } from '../extraction/candidate-extractor'
 import type { NormalizedTailwindCssPatchOptions } from '../options/types'
 import type { TailwindcssRuntimeContext } from '../types'
 import process from 'node:process'
@@ -63,6 +64,35 @@ export async function collectClassesFromTailwindV4(
       negated: source.negated,
     }))
   }
+  const addCandidates = async (extractOptions: ExtractValidCandidatesOption) => {
+    const candidates = await extractValidCandidates(extractOptions)
+    for (const candidate of candidates) {
+      if (options.filter(candidate)) {
+        set.add(candidate)
+      }
+    }
+  }
+
+  if (v4Options.cssSources.length > 0) {
+    for (const source of v4Options.cssSources) {
+      const sourceFile = toAbsolute(source.file)
+      const sourceBase = toAbsolute(source.base)
+        ?? (sourceFile ? path.dirname(sourceFile) : resolvedDefaultBase)
+      const designSystemBases = resolvedConfiguredBase && resolvedConfiguredBase !== sourceBase
+        ? [sourceBase, resolvedConfiguredBase]
+        : [sourceBase]
+      const sources = resolveSources(sourceBase)
+      const firstBase = designSystemBases[0] ?? sourceBase
+      await addCandidates({
+        cwd: options.projectRoot,
+        base: firstBase,
+        baseFallbacks: designSystemBases.slice(1),
+        css: source.css,
+        ...(v4Options.bareArbitraryValues === undefined ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues }),
+        ...(sources === undefined ? {} : { sources }),
+      })
+    }
+  }
 
   if (v4Options.cssEntries.length > 0) {
     for (const entry of v4Options.cssEntries) {
@@ -86,15 +116,10 @@ export async function collectClassesFromTailwindV4(
         ...(v4Options.bareArbitraryValues === undefined ? {} : { bareArbitraryValues: v4Options.bareArbitraryValues }),
         ...(sources === undefined ? {} : { sources }),
       }
-      const candidates = await extractValidCandidates(extractOptions)
-      for (const candidate of candidates) {
-        if (options.filter(candidate)) {
-          set.add(candidate)
-        }
-      }
+      await addCandidates(extractOptions)
     }
   }
-  else {
+  else if (v4Options.cssSources.length === 0) {
     const baseForCss = resolvedConfiguredBase ?? resolvedDefaultBase
     const sources = resolveSources(baseForCss)
     const extractOptions = {
@@ -104,12 +129,7 @@ export async function collectClassesFromTailwindV4(
       ...(v4Options.css === undefined ? {} : { css: v4Options.css }),
       ...(sources === undefined ? {} : { sources }),
     }
-    const candidates = await extractValidCandidates(extractOptions)
-    for (const candidate of candidates) {
-      if (options.filter(candidate)) {
-        set.add(candidate)
-      }
-    }
+    await addCandidates(extractOptions)
   }
 
   return set

package/src/v4/index.ts

@@ -15,6 +15,7 @@ export {
 } from './source'
 export type {
   TailwindV4CandidateSource,
+  TailwindV4CssSource,
   TailwindV4DesignSystem,
   TailwindV4Engine,
   TailwindV4GenerateOptions,

package/src/v4/source.ts

@@ -1,5 +1,5 @@
 import type { NormalizedTailwindCssPatchOptions, TailwindCssPatchOptions } from '../config'
-import type { TailwindV4ResolvedSource, TailwindV4SourceOptions } from './types'
+import type { TailwindV4CssSource, TailwindV4ResolvedSource, TailwindV4SourceOptions } from './types'
 import { promises as fs } from 'node:fs'
 import process from 'node:process'
 import path from 'pathe'
@@ -87,6 +87,35 @@ async function resolveCssEntries(entries: string[], projectRoot: string, base: s
   }
 }
 
+function resolveCssSources(sources: TailwindV4CssSource[], projectRoot: string, base: string | undefined) {
+  const resolvedSources = sources.map(source => ({
+    ...source,
+    base: source.base === undefined ? undefined : resolveBase(source.base, projectRoot),
+    file: source.file === undefined
+      ? undefined
+      : path.isAbsolute(source.file)
+        ? path.resolve(source.file)
+        : path.resolve(projectRoot, source.file),
+    dependencies: source.dependencies?.map(dependency =>
+      path.isAbsolute(dependency) ? path.resolve(dependency) : path.resolve(projectRoot, dependency),
+    ) ?? [],
+  }))
+  const firstSource = resolvedSources[0]
+  const resolvedBase = base
+    ?? firstSource?.base
+    ?? (firstSource?.file ? path.dirname(firstSource.file) : projectRoot)
+  const dependencies = resolvedSources.flatMap(source => [
+    source.file,
+    ...source.dependencies,
+  ]).filter((dependency): dependency is string => Boolean(dependency))
+
+  return {
+    base: resolvedBase,
+    css: resolvedSources.map(source => source.css).join('\n'),
+    dependencies,
+  }
+}
+
 function normalizeResolvedSource(
   source: {
     projectRoot: string
@@ -129,15 +158,27 @@ export async function resolveTailwindV4Source(options: TailwindV4SourceOptions =
     })
   }
 
-  if (options.cssEntries?.length) {
-    const entries = await resolveCssEntries(options.cssEntries, projectRoot, configuredBase)
+  if (options.cssEntries?.length || options.cssSources?.length) {
+    const entries = options.cssEntries?.length
+      ? await resolveCssEntries(options.cssEntries, projectRoot, configuredBase)
+      : undefined
+    const sources = options.cssSources?.length
+      ? resolveCssSources(options.cssSources, projectRoot, configuredBase)
+      : undefined
+    const css = [
+      entries?.css,
+      sources?.css,
+    ].filter(Boolean).join('\n')
     return normalizeResolvedSource({
       projectRoot,
       cwd,
-      base: entries.base,
+      base: configuredBase ?? entries?.base ?? sources?.base ?? cwd,
       baseFallbacks,
-      css: entries.css,
-      dependencies: entries.dependencies,
+      css,
+      dependencies: [
+        ...(entries?.dependencies ?? []),
+        ...(sources?.dependencies ?? []),
+      ],
     })
   }
 
@@ -177,6 +218,7 @@ function createSourceOptionsFromNormalizedPatchOptions(
     ...(v4?.configuredBase === undefined ? {} : { base: v4.configuredBase }),
     baseFallbacks,
     ...(v4?.css === undefined ? {} : { css: v4.css }),
+    ...(v4?.cssSources === undefined ? {} : { cssSources: v4.cssSources }),
     ...(v4?.cssEntries === undefined ? {} : { cssEntries: v4.cssEntries }),
     packageName: options.tailwind.packageName,
   }

package/src/v4/types.ts

@@ -4,10 +4,18 @@ export interface TailwindV4SourceOptions {
   base?: string
   baseFallbacks?: string[]
   css?: string
+  cssSources?: TailwindV4CssSource[]
   cssEntries?: string[]
   packageName?: string
 }
 
+export interface TailwindV4CssSource {
+  css: string
+  base?: string
+  file?: string
+  dependencies?: string[]
+}
+
 export interface TailwindV4ResolvedSource {
   projectRoot: string
   base: string