tailwindcss-patch 9.0.1 → 9.2.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-8l464Juk.js");
-const require_validate = require("./validate-B8H-8rWO.js");
-const require_index_bundle = require("./index.bundle-BGBMTX9A.js");
+const require_validate = require("./validate-749MHvAC.js");
+const require_index_bundle = require("./index.bundle-BQ_yKkd8.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 { T as logger, r as ValidateCommandError } from "./validate-BI8356RT.mjs";
-import { t as createTailwindcssPatchCli } from "./index.bundle-ByrTqrr3.mjs";
+import { k as logger, r as ValidateCommandError } from "./validate-D5elFZMj.mjs";
+import { t as createTailwindcssPatchCli } from "./index.bundle-dp_pw5fq.mjs";
 import process from "node:process";
 //#region src/cli.bundle.ts
 async function main() {

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-B8H-8rWO.js");
+const require_validate = require("../validate-749MHvAC.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 { S as loadWorkspaceConfigModule, T as logger, a as tailwindcssPatchCommands, b as groupTokensByFile, i as classifyValidateError, n as VALIDATE_FAILURE_REASONS, o as migrateConfigFiles, r as ValidateCommandError, s as restoreConfigFiles, t as VALIDATE_EXIT_CODES, u as TailwindcssPatcher, x as loadPatchOptionsForWorkspace } from "../validate-BI8356RT.mjs";
+import { E as loadWorkspaceConfigModule, T as loadPatchOptionsForWorkspace, a as tailwindcssPatchCommands, b as groupTokensByFile, i as classifyValidateError, k 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-D5elFZMj.mjs";
 import process from "node:process";
 import fs from "fs-extra";
 import path from "pathe";

package/dist/index.bundle-BQ_yKkd8.js

@@ -0,0 +1,239 @@
+const require_chunk = require("./chunk-8l464Juk.js");
+const require_validate = require("./validate-749MHvAC.js");
+let node_module = require("node:module");
+let node_process = require("node:process");
+node_process = require_chunk.__toESM(node_process);
+let pathe = require("pathe");
+pathe = require_chunk.__toESM(pathe);
+let node_fs = require("node:fs");
+//#region src/v4/engine.ts
+function resolveScanSources(options, compiledSources) {
+	if (Array.isArray(options?.scanSources)) return options.scanSources;
+	if (options?.scanSources === true) return compiledSources;
+	return [];
+}
+async function collectRawCandidates(source, options, compiledSources = []) {
+	const rawCandidates = /* @__PURE__ */ new Set();
+	for (const candidate of options?.candidates ?? []) rawCandidates.add(candidate);
+	for (const candidateSource of options?.sources ?? []) {
+		const candidates = await require_validate.extractRawCandidatesWithPositions(candidateSource.content, candidateSource.extension);
+		for (const candidate of candidates) rawCandidates.add(candidate.rawCandidate);
+	}
+	const filesystemSources = resolveScanSources(options, compiledSources);
+	if (filesystemSources.length > 0) for (const candidate of await require_validate.extractRawCandidates(filesystemSources)) rawCandidates.add(candidate);
+	const inlineSources = require_validate.extractTailwindV4InlineSourceCandidates(source.css);
+	for (const candidate of inlineSources.included) rawCandidates.add(candidate);
+	for (const candidate of inlineSources.excluded) rawCandidates.delete(candidate);
+	return rawCandidates;
+}
+function createTailwindV4Engine(source) {
+	return {
+		source,
+		loadDesignSystem() {
+			return require_validate.loadTailwindV4DesignSystem(source);
+		},
+		async validateCandidates(candidates) {
+			return require_validate.resolveValidTailwindV4Candidates(await require_validate.loadTailwindV4DesignSystem(source), candidates);
+		},
+		async generate(options) {
+			const { compiled, dependencies } = await require_validate.compileTailwindV4Source(source);
+			const rawCandidates = await collectRawCandidates(source, options, compiled.sources);
+			const classSet = require_validate.resolveValidTailwindV4Candidates(await require_validate.loadTailwindV4DesignSystem(source), rawCandidates);
+			const inlineSources = require_validate.extractTailwindV4InlineSourceCandidates(source.css);
+			for (const candidate of inlineSources.excluded) classSet.delete(candidate);
+			return {
+				css: compiled.build(Array.from(classSet)),
+				classSet,
+				rawCandidates,
+				dependencies: Array.from(dependencies),
+				sources: compiled.sources,
+				root: compiled.root
+			};
+		}
+	};
+}
+//#endregion
+//#region src/v4/source.ts
+function resolveBase(value, fallback) {
+	return value === void 0 ? fallback : pathe.default.isAbsolute(value) ? pathe.default.resolve(value) : pathe.default.resolve(fallback, value);
+}
+function uniquePaths(values) {
+	const result = [];
+	for (const value of values) {
+		if (!value) continue;
+		const resolved = pathe.default.resolve(value);
+		if (!result.includes(resolved)) result.push(resolved);
+	}
+	return result;
+}
+function toCssImportPath(value) {
+	return value.replaceAll("\\", "/");
+}
+function quoteCssImport(value) {
+	return value.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"");
+}
+function isPostcssPluginSpecifier(packageName) {
+	return packageName === "@tailwindcss/postcss" || /(?:^|[/\\])@tailwindcss[/\\]postcss(?:[/\\]|$)/.test(packageName) || /(?:^|[/\\])postcss(?:[/\\]|$)/i.test(packageName) || /postcss\.config\.[cm]?[jt]s$/i.test(packageName);
+}
+function createDefaultCss(packageName) {
+	return `@import "${quoteCssImport(toCssImportPath(packageName && !isPostcssPluginSpecifier(packageName) ? packageName : "tailwindcss"))}";`;
+}
+async function pathExists(filePath) {
+	try {
+		await node_fs.promises.access(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function resolveCssEntries(entries, projectRoot, base) {
+	const resolvedEntries = entries.map((entry) => ({
+		original: entry,
+		absolute: pathe.default.isAbsolute(entry) ? pathe.default.resolve(entry) : pathe.default.resolve(projectRoot, entry)
+	}));
+	const resolvedBase = base ?? pathe.default.dirname(resolvedEntries[0]?.absolute ?? projectRoot);
+	const dependencies = resolvedEntries.map((entry) => entry.absolute);
+	const cssParts = [];
+	for (const entry of resolvedEntries) {
+		if (await pathExists(entry.absolute)) {
+			cssParts.push(await node_fs.promises.readFile(entry.absolute, "utf8"));
+			continue;
+		}
+		const importPath = pathe.default.isAbsolute(entry.original) ? entry.absolute : pathe.default.relative(resolvedBase, entry.absolute);
+		cssParts.push(`@import "${quoteCssImport(toCssImportPath(importPath))}";`);
+	}
+	return {
+		base: resolvedBase,
+		css: cssParts.join("\n"),
+		dependencies
+	};
+}
+function normalizeResolvedSource(source) {
+	const baseFallbacks = uniquePaths([
+		...source.baseFallbacks,
+		source.projectRoot,
+		source.cwd
+	]).filter((base) => base !== source.base);
+	return {
+		projectRoot: source.projectRoot,
+		base: source.base,
+		baseFallbacks,
+		css: source.css,
+		dependencies: Array.from(new Set(source.dependencies.map((dependency) => pathe.default.resolve(dependency))))
+	};
+}
+async function resolveTailwindV4Source(options = {}) {
+	const projectRoot = resolveBase(options.projectRoot, node_process.default.cwd());
+	const cwd = resolveBase(options.cwd, projectRoot);
+	const configuredBase = options.base === void 0 ? void 0 : resolveBase(options.base, projectRoot);
+	const baseFallbacks = uniquePaths(options.baseFallbacks?.map((base) => resolveBase(base, projectRoot)) ?? []);
+	if (options.css !== void 0) return normalizeResolvedSource({
+		projectRoot,
+		cwd,
+		base: configuredBase ?? cwd,
+		baseFallbacks,
+		css: options.css,
+		dependencies: []
+	});
+	if (options.cssEntries?.length) {
+		const entries = await resolveCssEntries(options.cssEntries, projectRoot, configuredBase);
+		return normalizeResolvedSource({
+			projectRoot,
+			cwd,
+			base: entries.base,
+			baseFallbacks,
+			css: entries.css,
+			dependencies: entries.dependencies
+		});
+	}
+	return normalizeResolvedSource({
+		projectRoot,
+		cwd,
+		base: configuredBase ?? cwd,
+		baseFallbacks,
+		css: createDefaultCss(options.packageName),
+		dependencies: []
+	});
+}
+function resolveConfigDir(config, projectRoot) {
+	if (!config) return;
+	const configPath = pathe.default.isAbsolute(config) ? config : pathe.default.resolve(projectRoot, config);
+	return pathe.default.dirname(configPath);
+}
+function createSourceOptionsFromNormalizedPatchOptions(options) {
+	const v4 = options.tailwind.v4;
+	const configDir = resolveConfigDir(options.tailwind.config, options.projectRoot);
+	const baseFallbacks = uniquePaths([
+		v4?.configuredBase,
+		options.tailwind.cwd,
+		options.projectRoot,
+		configDir
+	]);
+	return {
+		projectRoot: options.projectRoot,
+		...options.tailwind.cwd === void 0 ? {} : { cwd: options.tailwind.cwd },
+		...v4?.configuredBase === void 0 ? {} : { base: v4.configuredBase },
+		baseFallbacks,
+		...v4?.css === void 0 ? {} : { css: v4.css },
+		...v4?.cssEntries === void 0 ? {} : { cssEntries: v4.cssEntries },
+		packageName: options.tailwind.packageName
+	};
+}
+function tailwindV4SourceOptionsFromPatchOptions(options) {
+	return createSourceOptionsFromNormalizedPatchOptions(require_validate.normalizeOptions(options));
+}
+async function resolveTailwindV4SourceFromPatchOptions(options) {
+	return resolveTailwindV4Source(tailwindV4SourceOptionsFromPatchOptions(options));
+}
+//#endregion
+//#region src/index.bundle.ts
+const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+function loadCliModule() {
+	return require$1("./commands/cli-runtime.js");
+}
+function mountTailwindcssPatchCommands(cli, options = {}) {
+	return loadCliModule().mountTailwindcssPatchCommands(cli, options);
+}
+function createTailwindcssPatchCli(options = {}) {
+	return loadCliModule().createTailwindcssPatchCli(options);
+}
+function defineConfig(config) {
+	return config;
+}
+//#endregion
+Object.defineProperty(exports, "createTailwindV4Engine", {
+	enumerable: true,
+	get: function() {
+		return createTailwindV4Engine;
+	}
+});
+Object.defineProperty(exports, "createTailwindcssPatchCli", {
+	enumerable: true,
+	get: function() {
+		return createTailwindcssPatchCli;
+	}
+});
+Object.defineProperty(exports, "defineConfig", {
+	enumerable: true,
+	get: function() {
+		return defineConfig;
+	}
+});
+Object.defineProperty(exports, "mountTailwindcssPatchCommands", {
+	enumerable: true,
+	get: function() {
+		return mountTailwindcssPatchCommands;
+	}
+});
+Object.defineProperty(exports, "resolveTailwindV4Source", {
+	enumerable: true,
+	get: function() {
+		return resolveTailwindV4Source;
+	}
+});
+Object.defineProperty(exports, "resolveTailwindV4SourceFromPatchOptions", {
+	enumerable: true,
+	get: function() {
+		return resolveTailwindV4SourceFromPatchOptions;
+	}
+});

package/dist/index.bundle-dp_pw5fq.mjs

@@ -0,0 +1,201 @@
+import { C as extractTailwindV4InlineSourceCandidates, D as normalizeOptions, S as loadTailwindV4DesignSystem, _ as extractRawCandidates, v as extractRawCandidatesWithPositions, w as resolveValidTailwindV4Candidates, x as compileTailwindV4Source } from "./validate-D5elFZMj.mjs";
+import { createRequire } from "node:module";
+import process from "node:process";
+import path from "pathe";
+import { promises } from "node:fs";
+//#region src/v4/engine.ts
+function resolveScanSources(options, compiledSources) {
+	if (Array.isArray(options?.scanSources)) return options.scanSources;
+	if (options?.scanSources === true) return compiledSources;
+	return [];
+}
+async function collectRawCandidates(source, options, compiledSources = []) {
+	const rawCandidates = /* @__PURE__ */ new Set();
+	for (const candidate of options?.candidates ?? []) rawCandidates.add(candidate);
+	for (const candidateSource of options?.sources ?? []) {
+		const candidates = await extractRawCandidatesWithPositions(candidateSource.content, candidateSource.extension);
+		for (const candidate of candidates) rawCandidates.add(candidate.rawCandidate);
+	}
+	const filesystemSources = resolveScanSources(options, compiledSources);
+	if (filesystemSources.length > 0) for (const candidate of await extractRawCandidates(filesystemSources)) rawCandidates.add(candidate);
+	const inlineSources = extractTailwindV4InlineSourceCandidates(source.css);
+	for (const candidate of inlineSources.included) rawCandidates.add(candidate);
+	for (const candidate of inlineSources.excluded) rawCandidates.delete(candidate);
+	return rawCandidates;
+}
+function createTailwindV4Engine(source) {
+	return {
+		source,
+		loadDesignSystem() {
+			return loadTailwindV4DesignSystem(source);
+		},
+		async validateCandidates(candidates) {
+			return resolveValidTailwindV4Candidates(await loadTailwindV4DesignSystem(source), candidates);
+		},
+		async generate(options) {
+			const { compiled, dependencies } = await compileTailwindV4Source(source);
+			const rawCandidates = await collectRawCandidates(source, options, compiled.sources);
+			const classSet = resolveValidTailwindV4Candidates(await loadTailwindV4DesignSystem(source), rawCandidates);
+			const inlineSources = extractTailwindV4InlineSourceCandidates(source.css);
+			for (const candidate of inlineSources.excluded) classSet.delete(candidate);
+			return {
+				css: compiled.build(Array.from(classSet)),
+				classSet,
+				rawCandidates,
+				dependencies: Array.from(dependencies),
+				sources: compiled.sources,
+				root: compiled.root
+			};
+		}
+	};
+}
+//#endregion
+//#region src/v4/source.ts
+function resolveBase(value, fallback) {
+	return value === void 0 ? fallback : path.isAbsolute(value) ? path.resolve(value) : path.resolve(fallback, value);
+}
+function uniquePaths(values) {
+	const result = [];
+	for (const value of values) {
+		if (!value) continue;
+		const resolved = path.resolve(value);
+		if (!result.includes(resolved)) result.push(resolved);
+	}
+	return result;
+}
+function toCssImportPath(value) {
+	return value.replaceAll("\\", "/");
+}
+function quoteCssImport(value) {
+	return value.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"");
+}
+function isPostcssPluginSpecifier(packageName) {
+	return packageName === "@tailwindcss/postcss" || /(?:^|[/\\])@tailwindcss[/\\]postcss(?:[/\\]|$)/.test(packageName) || /(?:^|[/\\])postcss(?:[/\\]|$)/i.test(packageName) || /postcss\.config\.[cm]?[jt]s$/i.test(packageName);
+}
+function createDefaultCss(packageName) {
+	return `@import "${quoteCssImport(toCssImportPath(packageName && !isPostcssPluginSpecifier(packageName) ? packageName : "tailwindcss"))}";`;
+}
+async function pathExists(filePath) {
+	try {
+		await promises.access(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function resolveCssEntries(entries, projectRoot, base) {
+	const resolvedEntries = entries.map((entry) => ({
+		original: entry,
+		absolute: path.isAbsolute(entry) ? path.resolve(entry) : path.resolve(projectRoot, entry)
+	}));
+	const resolvedBase = base ?? path.dirname(resolvedEntries[0]?.absolute ?? projectRoot);
+	const dependencies = resolvedEntries.map((entry) => entry.absolute);
+	const cssParts = [];
+	for (const entry of resolvedEntries) {
+		if (await pathExists(entry.absolute)) {
+			cssParts.push(await promises.readFile(entry.absolute, "utf8"));
+			continue;
+		}
+		const importPath = path.isAbsolute(entry.original) ? entry.absolute : path.relative(resolvedBase, entry.absolute);
+		cssParts.push(`@import "${quoteCssImport(toCssImportPath(importPath))}";`);
+	}
+	return {
+		base: resolvedBase,
+		css: cssParts.join("\n"),
+		dependencies
+	};
+}
+function normalizeResolvedSource(source) {
+	const baseFallbacks = uniquePaths([
+		...source.baseFallbacks,
+		source.projectRoot,
+		source.cwd
+	]).filter((base) => base !== source.base);
+	return {
+		projectRoot: source.projectRoot,
+		base: source.base,
+		baseFallbacks,
+		css: source.css,
+		dependencies: Array.from(new Set(source.dependencies.map((dependency) => path.resolve(dependency))))
+	};
+}
+async function resolveTailwindV4Source(options = {}) {
+	const projectRoot = resolveBase(options.projectRoot, process.cwd());
+	const cwd = resolveBase(options.cwd, projectRoot);
+	const configuredBase = options.base === void 0 ? void 0 : resolveBase(options.base, projectRoot);
+	const baseFallbacks = uniquePaths(options.baseFallbacks?.map((base) => resolveBase(base, projectRoot)) ?? []);
+	if (options.css !== void 0) return normalizeResolvedSource({
+		projectRoot,
+		cwd,
+		base: configuredBase ?? cwd,
+		baseFallbacks,
+		css: options.css,
+		dependencies: []
+	});
+	if (options.cssEntries?.length) {
+		const entries = await resolveCssEntries(options.cssEntries, projectRoot, configuredBase);
+		return normalizeResolvedSource({
+			projectRoot,
+			cwd,
+			base: entries.base,
+			baseFallbacks,
+			css: entries.css,
+			dependencies: entries.dependencies
+		});
+	}
+	return normalizeResolvedSource({
+		projectRoot,
+		cwd,
+		base: configuredBase ?? cwd,
+		baseFallbacks,
+		css: createDefaultCss(options.packageName),
+		dependencies: []
+	});
+}
+function resolveConfigDir(config, projectRoot) {
+	if (!config) return;
+	const configPath = path.isAbsolute(config) ? config : path.resolve(projectRoot, config);
+	return path.dirname(configPath);
+}
+function createSourceOptionsFromNormalizedPatchOptions(options) {
+	const v4 = options.tailwind.v4;
+	const configDir = resolveConfigDir(options.tailwind.config, options.projectRoot);
+	const baseFallbacks = uniquePaths([
+		v4?.configuredBase,
+		options.tailwind.cwd,
+		options.projectRoot,
+		configDir
+	]);
+	return {
+		projectRoot: options.projectRoot,
+		...options.tailwind.cwd === void 0 ? {} : { cwd: options.tailwind.cwd },
+		...v4?.configuredBase === void 0 ? {} : { base: v4.configuredBase },
+		baseFallbacks,
+		...v4?.css === void 0 ? {} : { css: v4.css },
+		...v4?.cssEntries === void 0 ? {} : { cssEntries: v4.cssEntries },
+		packageName: options.tailwind.packageName
+	};
+}
+function tailwindV4SourceOptionsFromPatchOptions(options) {
+	return createSourceOptionsFromNormalizedPatchOptions(normalizeOptions(options));
+}
+async function resolveTailwindV4SourceFromPatchOptions(options) {
+	return resolveTailwindV4Source(tailwindV4SourceOptionsFromPatchOptions(options));
+}
+//#endregion
+//#region src/index.bundle.ts
+const require = createRequire(import.meta.url);
+function loadCliModule() {
+	return require("./commands/cli-runtime.js");
+}
+function mountTailwindcssPatchCommands(cli, options = {}) {
+	return loadCliModule().mountTailwindcssPatchCommands(cli, options);
+}
+function createTailwindcssPatchCli(options = {}) {
+	return loadCliModule().createTailwindcssPatchCli(options);
+}
+function defineConfig(config) {
+	return config;
+}
+//#endregion
+export { resolveTailwindV4SourceFromPatchOptions as a, resolveTailwindV4Source as i, defineConfig as n, createTailwindV4Engine as o, mountTailwindcssPatchCommands as r, createTailwindcssPatchCli as t };

package/dist/index.d.mts

@@ -77,9 +77,81 @@ 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[];
+  /**
+   * 扫描文件系统 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>): Set<string>;
+//#endregion
+//#region src/v4/engine.d.ts
+declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): TailwindV4Engine;
+//#endregion
+//#region src/v4/node-adapter.d.ts
+declare function loadTailwindV4DesignSystem(source: TailwindV4ResolvedSource): Promise<TailwindV4DesignSystem>;
+//#endregion
+//#region src/v4/source.d.ts
+declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
+declare function resolveTailwindV4SourceFromPatchOptions(options: TailwindCssPatchOptions): Promise<TailwindV4ResolvedSource>;
+//#endregion
 //#region src/index.bundle.d.ts
 declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
 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, TailwindV4Options, 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, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, 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 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

@@ -77,9 +77,81 @@ 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[];
+  /**
+   * 扫描文件系统 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>): Set<string>;
+//#endregion
+//#region src/v4/engine.d.ts
+declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): TailwindV4Engine;
+//#endregion
+//#region src/v4/node-adapter.d.ts
+declare function loadTailwindV4DesignSystem(source: TailwindV4ResolvedSource): Promise<TailwindV4DesignSystem>;
+//#endregion
+//#region src/v4/source.d.ts
+declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
+declare function resolveTailwindV4SourceFromPatchOptions(options: TailwindCssPatchOptions): Promise<TailwindV4ResolvedSource>;
+//#endregion
 //#region src/index.bundle.d.ts
 declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
 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, TailwindV4Options, 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, createTailwindcssPatchCli, defineConfig, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, getPatchStatusReport, groupTokensByFile, loadRuntimeContexts, logger, migrateConfigFiles, mountTailwindcssPatchCommands, normalizeOptions, 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 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 };