tailwindcss-patch 9.5.0 → 10.0.0

package/dist/{validate-Q00Ccqht.mjs → cli-BvMS3VVq.js}

@@ -1,8 +1,9 @@
 import { createRequire } from "node:module";
+import cac from "cac";
 import process from "node:process";
+import path from "pathe";
 import fs from "fs-extra";
 import { getPackageInfoSync } from "local-pkg";
-import path from "pathe";
 import { coerce } from "semver";
 import { createHash } from "node:crypto";
 import { createConsola } from "consola";
@@ -11,12 +12,237 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractSourceCandidates, extractSourceCandidatesWithPositions, extractValidCandidates, groupTokensByFile, resolveProjectSourceFiles } from "@tailwindcss-mangle/engine";
 import * as t from "@babel/types";
 import generate from "@babel/generator";
-import _babelTraverse from "@babel/traverse";
+import traverse from "@babel/traverse";
 import { parse, parse as parse$1 } from "@babel/parser";
 import postcss from "postcss";
 import { loadConfig } from "tailwindcss-config";
+//#region src/commands/token-output.ts
+const TOKEN_FORMATS = [
+	"json",
+	"lines",
+	"grouped-json"
+];
+const DEFAULT_TOKEN_REPORT = ".tw-patch/tw-token-report.json";
+function formatTokenLine(entry) {
+	return `${entry.relativeFile}:${entry.line}:${entry.column} ${entry.rawCandidate} (${entry.start}-${entry.end})`;
+}
+function formatGroupedPreview(map, limit = 3) {
+	const files = Object.keys(map);
+	if (!files.length) return {
+		preview: "",
+		moreFiles: 0
+	};
+	return {
+		preview: files.slice(0, limit).map((file) => {
+			const tokens = map[file] ?? [];
+			const sample = tokens.slice(0, 3).map((token) => token.rawCandidate).join(", ");
+			const suffix = tokens.length > 3 ? ", …" : "";
+			return `${file}: ${tokens.length} tokens (${sample}${suffix})`;
+		}).join("\n"),
+		moreFiles: Math.max(0, files.length - limit)
+	};
+}
+//#endregion
+//#region src/commands/command-definitions.ts
+function createCwdOptionDefinition(description = "Working directory") {
+	return {
+		flags: "--cwd <dir>",
+		description,
+		config: { default: process.cwd() }
+	};
+}
+function buildDefaultCommandDefinitions() {
+	return {
+		install: {
+			description: "Apply Tailwind CSS runtime patches",
+			optionDefs: [createCwdOptionDefinition()]
+		},
+		extract: {
+			description: "Collect generated class names into a cache file",
+			optionDefs: [
+				createCwdOptionDefinition(),
+				{
+					flags: "--output <file>",
+					description: "Override output file path"
+				},
+				{
+					flags: "--format <format>",
+					description: "Output format (json|lines)"
+				},
+				{
+					flags: "--css <file>",
+					description: "Tailwind CSS entry CSS when using v4"
+				},
+				{
+					flags: "--no-write",
+					description: "Skip writing to disk"
+				}
+			]
+		},
+		tokens: {
+			description: "Extract Tailwind tokens with file/position metadata",
+			optionDefs: [
+				createCwdOptionDefinition(),
+				{
+					flags: "--output <file>",
+					description: "Override output file path",
+					config: { default: DEFAULT_TOKEN_REPORT }
+				},
+				{
+					flags: "--format <format>",
+					description: "Output format (json|lines|grouped-json)",
+					config: { default: "json" }
+				},
+				{
+					flags: "--group-key <key>",
+					description: "Grouping key for grouped-json output (relative|absolute)",
+					config: { default: "relative" }
+				},
+				{
+					flags: "--no-write",
+					description: "Skip writing to disk"
+				}
+			]
+		},
+		init: {
+			description: "Generate a tailwindcss-patch config file",
+			optionDefs: [createCwdOptionDefinition()]
+		},
+		migrate: {
+			description: "Migrate deprecated config fields to modern options",
+			optionDefs: [
+				createCwdOptionDefinition(),
+				{
+					flags: "--config <file>",
+					description: "Migrate a specific config file path"
+				},
+				{
+					flags: "--workspace",
+					description: "Scan workspace recursively for config files"
+				},
+				{
+					flags: "--max-depth <n>",
+					description: "Maximum recursion depth for --workspace",
+					config: { default: 6 }
+				},
+				{
+					flags: "--include <glob>",
+					description: "Only migrate files that match this glob (repeatable)"
+				},
+				{
+					flags: "--exclude <glob>",
+					description: "Skip files that match this glob (repeatable)"
+				},
+				{
+					flags: "--report-file <file>",
+					description: "Write migration report JSON to a file"
+				},
+				{
+					flags: "--backup-dir <dir>",
+					description: "Write pre-migration backups into this directory"
+				},
+				{
+					flags: "--check",
+					description: "Exit with an error when migration changes are required"
+				},
+				{
+					flags: "--json",
+					description: "Print the migration report as JSON"
+				},
+				{
+					flags: "--dry-run",
+					description: "Preview changes without writing files"
+				}
+			]
+		},
+		restore: {
+			description: "Restore config files from a previous migration report backup snapshot",
+			optionDefs: [
+				createCwdOptionDefinition(),
+				{
+					flags: "--report-file <file>",
+					description: "Migration report file generated by migrate"
+				},
+				{
+					flags: "--dry-run",
+					description: "Preview restore targets without writing files"
+				},
+				{
+					flags: "--strict",
+					description: "Fail when any backup file is missing"
+				},
+				{
+					flags: "--json",
+					description: "Print the restore result as JSON"
+				}
+			]
+		},
+		validate: {
+			description: "Validate migration report compatibility without modifying files",
+			optionDefs: [
+				createCwdOptionDefinition(),
+				{
+					flags: "--report-file <file>",
+					description: "Migration report file to validate"
+				},
+				{
+					flags: "--strict",
+					description: "Fail when any backup file is missing"
+				},
+				{
+					flags: "--json",
+					description: "Print validation result as JSON"
+				}
+			]
+		},
+		status: {
+			description: "Check which Tailwind patches are applied",
+			optionDefs: [createCwdOptionDefinition(), {
+				flags: "--json",
+				description: "Print a JSON report of patch status"
+			}]
+		}
+	};
+}
+//#endregion
+//#region src/commands/command-metadata.ts
+function addPrefixIfMissing(value, prefix) {
+	if (!prefix || value.startsWith(prefix)) return value;
+	return `${prefix}${value}`;
+}
+function resolveCommandNames(command, mountOptions, prefix) {
+	const override = mountOptions.commandOptions?.[command];
+	return {
+		name: addPrefixIfMissing(override?.name ?? command, prefix),
+		aliases: (override?.aliases ?? []).map((alias) => addPrefixIfMissing(alias, prefix))
+	};
+}
+function resolveOptionDefinitions(defaults, override) {
+	if (!override) return defaults;
+	const appendDefaults = override.appendDefaultOptions ?? true;
+	const customDefs = override.optionDefs ?? [];
+	if (!appendDefaults) return customDefs;
+	if (customDefs.length === 0) return defaults;
+	return [...defaults, ...customDefs];
+}
+function resolveCommandMetadata(command, mountOptions, prefix, defaults) {
+	const names = resolveCommandNames(command, mountOptions, prefix);
+	const definition = defaults[command];
+	const override = mountOptions.commandOptions?.[command];
+	const description = override?.description ?? definition.description;
+	const optionDefs = resolveOptionDefinitions(definition.optionDefs, override);
+	return {
+		...names,
+		description,
+		optionDefs
+	};
+}
+function applyCommandOptions(command, optionDefs) {
+	for (const option of optionDefs) command.option(option.flags, option.description ?? "", option.config);
+}
+//#endregion
 //#region package.json
-var version = "9.5.0";
+var version = "10.0.0";
 //#endregion
 //#region src/constants.ts
 const pkgName = "tailwindcss-patch";
@@ -1442,7 +1668,7 @@ async function loadWorkspaceConfigModule() {
 	return configModulePromise;
 }
 async function loadWorkspaceDefu() {
-	if (!defuPromise) defuPromise = import("./dist-CxmNpfyy.mjs").then((mod) => mod.defu).catch(async (error) => {
+	if (!defuPromise) defuPromise = import("./dist-CxmNpfyy.js").then((mod) => mod.defu).catch(async (error) => {
 		if (!isMissingSharedModuleError(error)) throw error;
 		return (await import(pathToFileURL(path.resolve(__dirname, "../../../shared/src/utils.ts")).href)).defu;
 	});
@@ -1597,13 +1823,6 @@ function loadRuntimeContexts(packageInfo, majorVersion, refProperty) {
 	return [];
 }
 //#endregion
-//#region src/babel/index.ts
-function _interopDefaultCompat(e) {
-	return e && typeof e === "object" && "default" in e ? e.default : e;
-}
-const generate$1 = _interopDefaultCompat(generate);
-const traverse = _interopDefaultCompat(_babelTraverse);
-//#endregion
 //#region src/patching/operations/export-context/postcss-v2.ts
 const IDENTIFIER_RE$1 = /^[A-Z_$][\w$]*$/i;
 function toIdentifierName$1(property) {
@@ -1631,7 +1850,7 @@ function transformProcessTailwindFeaturesReturnContextV2(content) {
 		if (!alreadyReturnsContext) body.push(t.returnStatement(t.identifier("context")));
 	} });
 	return {
-		code: hasPatched ? content : generate$1(ast).code,
+		code: hasPatched ? content : generate(ast).code,
 		hasPatched
 	};
 }
@@ -1654,9 +1873,9 @@ function transformPostcssPluginV2(content, options) {
 				const declaration = previous.declarations[0];
 				return Boolean(declaration && t.isIdentifier(declaration.id) && declaration.id.name === refIdentifier.name);
 			})());
-			const alreadyAssignsExports = Boolean(beforePrevious && t.isExpressionStatement(beforePrevious) && t.isAssignmentExpression(beforePrevious.expression) && t.isMemberExpression(beforePrevious.expression.left) && t.isIdentifier(beforePrevious.expression.right) && beforePrevious.expression.right.name === refIdentifier.name && generate$1(beforePrevious.expression.left).code === generate$1(exportMember).code);
+			const alreadyAssignsExports = Boolean(beforePrevious && t.isExpressionStatement(beforePrevious) && t.isAssignmentExpression(beforePrevious.expression) && t.isMemberExpression(beforePrevious.expression.left) && t.isIdentifier(beforePrevious.expression.right) && beforePrevious.expression.right.name === refIdentifier.name && generate(beforePrevious.expression.left).code === generate(exportMember).code);
 			hasPatched = alreadyHasVariable && alreadyAssignsExports;
-			if (!alreadyHasVariable) program.body.splice(index, 0, t.variableDeclaration("var", [t.variableDeclarator(refIdentifier, t.objectExpression([t.objectProperty(t.identifier("value"), t.arrayExpression())]))]), t.expressionStatement(t.assignmentExpression("=", exportMember, refIdentifier)));
+			if (!alreadyHasVariable) program.body.splice(index, 0, t.variableDeclaration("var", [t.variableDeclarator(refIdentifier, t.objectExpression([t.objectProperty(t.identifier("value"), t.arrayExpression([]))]))]), t.expressionStatement(t.assignmentExpression("=", exportMember, refIdentifier)));
 		},
 		FunctionDeclaration(path) {
 			if (hasPatched) return;
@@ -1689,7 +1908,7 @@ function transformPostcssPluginV2(content, options) {
 		}
 	});
 	return {
-		code: hasPatched ? content : generate$1(ast).code,
+		code: hasPatched ? content : generate(ast).code,
 		hasPatched
 	};
 }
@@ -1722,7 +1941,7 @@ function transformProcessTailwindFeaturesReturnContext(content) {
 		if (!alreadyReturnsContext) body.push(t.returnStatement(t.identifier("context")));
 	} });
 	return {
-		code: hasPatched ? content : generate$1(ast).code,
+		code: hasPatched ? content : generate(ast).code,
 		hasPatched
 	};
 }
@@ -1745,9 +1964,9 @@ function transformPostcssPlugin(content, { refProperty }) {
 				const declaration = previousStatement.declarations[0];
 				return Boolean(declaration && t.isIdentifier(declaration.id) && declaration.id.name === refIdentifier.name);
 			})());
-			const alreadyAssignsModuleExports = Boolean(t.isExpressionStatement(lastStatement) && t.isAssignmentExpression(lastStatement.expression) && t.isMemberExpression(lastStatement.expression.left) && t.isIdentifier(lastStatement.expression.right) && lastStatement.expression.right.name === refIdentifier.name && generate$1(lastStatement.expression.left).code === generate$1(moduleExportsMember).code);
+			const alreadyAssignsModuleExports = Boolean(t.isExpressionStatement(lastStatement) && t.isAssignmentExpression(lastStatement.expression) && t.isMemberExpression(lastStatement.expression.left) && t.isIdentifier(lastStatement.expression.right) && lastStatement.expression.right.name === refIdentifier.name && generate(lastStatement.expression.left).code === generate(moduleExportsMember).code);
 			hasPatched = alreadyHasVariable && alreadyAssignsModuleExports;
-			if (!alreadyHasVariable) program.body.splice(index, 0, t.variableDeclaration("const", [t.variableDeclarator(refIdentifier, t.objectExpression([t.objectProperty(t.identifier("value"), t.arrayExpression())]))]));
+			if (!alreadyHasVariable) program.body.splice(index, 0, t.variableDeclaration("const", [t.variableDeclarator(refIdentifier, t.objectExpression([t.objectProperty(t.identifier("value"), t.arrayExpression([]))]))]));
 			if (!alreadyAssignsModuleExports) program.body.push(t.expressionStatement(t.assignmentExpression("=", moduleExportsMember, refIdentifier)));
 		},
 		FunctionExpression(path) {
@@ -1780,7 +1999,7 @@ function transformPostcssPlugin(content, { refProperty }) {
 		}
 	});
 	return {
-		code: hasPatched ? content : generate$1(ast).code,
+		code: hasPatched ? content : generate(ast).code,
 		hasPatched
 	};
 }
@@ -1889,7 +2108,7 @@ function applyExtendLengthUnitsPatchV3(rootDir, options) {
 		changed: false,
 		code: void 0
 	};
-	const { code } = generate$1(arrayRef, { jsescOption: { quotes: "single" } });
+	const { code } = generate(arrayRef, { jsescOption: { quotes: "single" } });
 	if (arrayRef.start != null && arrayRef.end != null) {
 		const nextCode = `${content.slice(0, arrayRef.start)}${code}${content.slice(arrayRef.end)}`;
 		if (opts.overwrite) {
@@ -1945,7 +2164,7 @@ function applyExtendLengthUnitsPatchV4(rootDir, options) {
 			}
 		} });
 		if (item.hasPatched) continue;
-		const { code: replacement } = generate$1(ast, { minified: true });
+		const { code: replacement } = generate(ast, { minified: true });
 		const start = match.index ?? 0;
 		item.code = spliceChangesIntoString(code, [{
 			start,
@@ -2513,6 +2732,142 @@ var TailwindcssPatcher = class {
 	}
 };
 //#endregion
+//#region src/commands/command-context.ts
+function resolveCommandCwd(rawCwd) {
+	if (!rawCwd) return process.cwd();
+	return path.resolve(rawCwd);
+}
+function createMemoizedPromiseRunner(factory) {
+	let promise;
+	return () => {
+		if (!promise) promise = factory();
+		return promise;
+	};
+}
+function createTailwindcssPatchCommandContext(cli, command, commandName, args, cwd) {
+	const loadCachedConfig = createMemoizedPromiseRunner(() => loadWorkspaceConfigModule().then((mod) => mod.getConfig(cwd)));
+	const loadCachedPatchOptions = createMemoizedPromiseRunner(() => loadPatchOptionsForWorkspace(cwd));
+	const createCachedPatcher = createMemoizedPromiseRunner(async () => {
+		return new TailwindcssPatcher(await loadCachedPatchOptions());
+	});
+	const loadPatchOptionsForContext = (overrides) => {
+		if (overrides) return loadPatchOptionsForWorkspace(cwd, overrides);
+		return loadCachedPatchOptions();
+	};
+	const createPatcherForContext = async (overrides) => {
+		if (overrides) return new TailwindcssPatcher(await loadPatchOptionsForWorkspace(cwd, overrides));
+		return createCachedPatcher();
+	};
+	return {
+		cli,
+		command,
+		commandName,
+		args,
+		cwd,
+		logger,
+		loadConfig: loadCachedConfig,
+		loadPatchOptions: loadPatchOptionsForContext,
+		createPatcher: createPatcherForContext
+	};
+}
+//#endregion
+//#region src/commands/command-runtime.ts
+function runWithCommandHandler(cli, command, commandName, args, handler, defaultHandler) {
+	const context = createTailwindcssPatchCommandContext(cli, command, commandName, args, resolveCommandCwd(args.cwd));
+	const runDefault = createMemoizedPromiseRunner(() => defaultHandler(context));
+	if (!handler) return runDefault();
+	return handler(context, runDefault);
+}
+//#endregion
+//#region src/commands/basic-handlers.ts
+const DEFAULT_CONFIG_NAME = "tailwindcss-mangle";
+async function installCommandDefaultHandler(_ctx) {
+	await (await _ctx.createPatcher()).patch();
+	logger.success("Tailwind CSS runtime patched successfully.");
+}
+async function extractCommandDefaultHandler(ctx) {
+	const { args } = ctx;
+	const overrides = {};
+	let hasOverrides = false;
+	if (args.output || args.format) {
+		overrides.extract = {
+			...args.output === void 0 ? {} : { file: args.output },
+			...args.format === void 0 ? {} : { format: args.format }
+		};
+		hasOverrides = true;
+	}
+	if (args.css) {
+		overrides.tailwindcss = { v4: { cssEntries: [args.css] } };
+		hasOverrides = true;
+	}
+	const patcher = await ctx.createPatcher(hasOverrides ? overrides : void 0);
+	const extractOptions = args.write === void 0 ? {} : { write: args.write };
+	const result = await patcher.extract(extractOptions);
+	if (result.filename) logger.success(`Collected ${result.classList.length} classes → ${result.filename}`);
+	else logger.success(`Collected ${result.classList.length} classes.`);
+	return result;
+}
+async function tokensCommandDefaultHandler(ctx) {
+	const { args } = ctx;
+	const report = await (await ctx.createPatcher()).collectContentTokens();
+	const shouldWrite = args.write ?? true;
+	let format = args.format ?? "json";
+	if (!TOKEN_FORMATS.includes(format)) format = "json";
+	const targetFile = args.output ?? ".tw-patch/tw-token-report.json";
+	const groupKey = args.groupKey === "absolute" ? "absolute" : "relative";
+	const buildGrouped = () => groupTokensByFile(report, {
+		key: groupKey,
+		stripAbsolutePaths: groupKey !== "absolute"
+	});
+	const grouped = format === "grouped-json" ? buildGrouped() : null;
+	const resolveGrouped = () => grouped ?? buildGrouped();
+	if (shouldWrite) {
+		const target = path.resolve(targetFile);
+		await fs.ensureDir(path.dirname(target));
+		if (format === "json") await fs.writeJSON(target, report, { spaces: 2 });
+		else if (format === "grouped-json") await fs.writeJSON(target, resolveGrouped(), { spaces: 2 });
+		else {
+			const lines = report.entries.map(formatTokenLine);
+			await fs.writeFile(target, `${lines.join("\n")}\n`, "utf8");
+		}
+		logger.success(`Collected ${report.entries.length} tokens (${format}) → ${target.replace(process.cwd(), ".")}`);
+	} else {
+		logger.success(`Collected ${report.entries.length} tokens from ${report.filesScanned} files.`);
+		if (format === "lines") {
+			const preview = report.entries.slice(0, 5).map(formatTokenLine).join("\n");
+			if (preview) {
+				logger.log("");
+				logger.info(preview);
+				if (report.entries.length > 5) logger.info(`…and ${report.entries.length - 5} more.`);
+			}
+		} else if (format === "grouped-json") {
+			const { preview, moreFiles } = formatGroupedPreview(resolveGrouped());
+			if (preview) {
+				logger.log("");
+				logger.info(preview);
+				if (moreFiles > 0) logger.info(`…and ${moreFiles} more files.`);
+			}
+		} else {
+			const previewEntries = report.entries.slice(0, 3);
+			if (previewEntries.length) {
+				logger.log("");
+				logger.info(JSON.stringify(previewEntries, null, 2));
+			}
+		}
+	}
+	if (report.skippedFiles.length) {
+		logger.warn("Skipped files:");
+		for (const skipped of report.skippedFiles) logger.warn(`  • ${skipped.file} (${skipped.reason})`);
+	}
+	return report;
+}
+async function initCommandDefaultHandler(ctx) {
+	const configModule = await loadWorkspaceConfigModule();
+	await configModule.initConfig(ctx.cwd);
+	const configName = configModule.CONFIG_NAME || DEFAULT_CONFIG_NAME;
+	logger.success(`✨ ${configName}.config.ts initialized!`);
+}
+//#endregion
 //#region src/commands/migration-report.ts
 const MIGRATION_REPORT_KIND = "tw-patch-migrate-report";
 const MIGRATION_REPORT_SCHEMA_VERSION = 1;
@@ -3059,17 +3414,230 @@ async function restoreConfigFiles(options) {
 	};
 }
 //#endregion
-//#region src/commands/types.ts
-const tailwindcssPatchCommands = [
-	"install",
-	"extract",
-	"tokens",
-	"init",
-	"migrate",
-	"restore",
-	"validate",
-	"status"
-];
+//#region src/commands/migration-args.ts
+function normalizePatternArgs(value) {
+	if (!value) return;
+	const values = (Array.isArray(value) ? value : [value]).flatMap((item) => item.split(",")).map((item) => item.trim()).filter(Boolean);
+	return values.length > 0 ? values : void 0;
+}
+function parseMaxDepth(value) {
+	if (value === void 0) return {
+		maxDepth: void 0,
+		hasInvalidMaxDepth: false
+	};
+	const parsed = Number(value);
+	if (!Number.isFinite(parsed) || parsed < 0) return {
+		maxDepth: void 0,
+		hasInvalidMaxDepth: true
+	};
+	return {
+		maxDepth: Math.floor(parsed),
+		hasInvalidMaxDepth: false
+	};
+}
+function resolveMigrateCommandArgs(args) {
+	const include = normalizePatternArgs(args.include);
+	const exclude = normalizePatternArgs(args.exclude);
+	const { maxDepth, hasInvalidMaxDepth } = parseMaxDepth(args.maxDepth);
+	const checkMode = args.check ?? false;
+	return {
+		include,
+		exclude,
+		maxDepth,
+		checkMode,
+		dryRun: args.dryRun ?? checkMode,
+		hasInvalidMaxDepth
+	};
+}
+function resolveRestoreCommandArgs(args) {
+	return {
+		reportFile: args.reportFile ?? ".tw-patch/migrate-report.json",
+		dryRun: args.dryRun ?? false,
+		strict: args.strict ?? false
+	};
+}
+function resolveValidateCommandArgs(args) {
+	return {
+		reportFile: args.reportFile ?? ".tw-patch/migrate-report.json",
+		strict: args.strict ?? false
+	};
+}
+//#endregion
+//#region src/commands/migration-output.ts
+function formatPathForLog(file) {
+	return file.replace(process.cwd(), ".");
+}
+function createMigrationCheckFailureError(changedFiles) {
+	return /* @__PURE__ */ new Error(`Migration check failed: ${changedFiles} file(s) still need migration.`);
+}
+async function writeMigrationReportFile(cwd, reportFile, report) {
+	const reportPath = path.resolve(cwd, reportFile);
+	await fs.ensureDir(path.dirname(reportPath));
+	await fs.writeJSON(reportPath, report, { spaces: 2 });
+	logger.info(`Migration report written: ${formatPathForLog(reportPath)}`);
+}
+function logMigrationReportAsJson(report) {
+	logger.log(JSON.stringify(report, null, 2));
+}
+function logNoMigrationConfigFilesWarning() {
+	logger.warn("No config files found for migration.");
+}
+function logMigrationEntries(report, dryRun) {
+	for (const entry of report.entries) {
+		const fileLabel = formatPathForLog(entry.file);
+		if (!entry.changed) {
+			logger.info(`No changes: ${fileLabel}`);
+			continue;
+		}
+		if (dryRun) logger.info(`[dry-run] ${fileLabel}`);
+		else logger.success(`Migrated: ${fileLabel}`);
+		for (const change of entry.changes) logger.info(`  - ${change}`);
+		if (entry.backupFile) logger.info(`  - backup: ${formatPathForLog(entry.backupFile)}`);
+	}
+}
+function logMigrationSummary(report) {
+	logger.info(`Migration summary: scanned=${report.scannedFiles}, changed=${report.changedFiles}, written=${report.writtenFiles}, backups=${report.backupsWritten}, missing=${report.missingFiles}, unchanged=${report.unchangedFiles}`);
+}
+function logRestoreResultAsJson(result) {
+	logger.log(JSON.stringify(result, null, 2));
+}
+function logRestoreSummary(result) {
+	logger.info(`Restore summary: scanned=${result.scannedEntries}, restorable=${result.restorableEntries}, restored=${result.restoredFiles}, missingBackups=${result.missingBackups}, skipped=${result.skippedEntries}`);
+	if (result.restored.length > 0) {
+		const preview = result.restored.slice(0, 5);
+		for (const file of preview) logger.info(`  - ${formatPathForLog(file)}`);
+		if (result.restored.length > preview.length) logger.info(`  ...and ${result.restored.length - preview.length} more`);
+	}
+}
+function logValidateSuccessAsJson(result) {
+	const payload = {
+		ok: true,
+		...result
+	};
+	logger.log(JSON.stringify(payload, null, 2));
+}
+function logValidateSuccessSummary(result) {
+	logger.success(`Migration report validated: scanned=${result.scannedEntries}, restorable=${result.restorableEntries}, missingBackups=${result.missingBackups}, skipped=${result.skippedEntries}`);
+	if (result.reportKind || result.reportSchemaVersion !== void 0) {
+		const kind = result.reportKind ?? "unknown";
+		const schema = result.reportSchemaVersion === void 0 ? "unknown" : String(result.reportSchemaVersion);
+		logger.info(`  metadata: kind=${kind}, schema=${schema}`);
+	}
+}
+function logValidateFailureAsJson(summary) {
+	const payload = {
+		ok: false,
+		reason: summary.reason,
+		exitCode: summary.exitCode,
+		message: summary.message
+	};
+	logger.log(JSON.stringify(payload, null, 2));
+}
+function logValidateFailureSummary(summary) {
+	logger.error(`Validation failed [${summary.reason}] (exit ${summary.exitCode}): ${summary.message}`);
+}
+//#endregion
+//#region src/commands/migrate-handler.ts
+async function migrateCommandDefaultHandler(ctx) {
+	const { args } = ctx;
+	const { include, exclude, maxDepth, checkMode, dryRun, hasInvalidMaxDepth } = resolveMigrateCommandArgs(args);
+	if (args.workspace && hasInvalidMaxDepth) logger.warn(`Invalid --max-depth value "${String(args.maxDepth)}", fallback to default depth.`);
+	const report = await migrateConfigFiles({
+		cwd: ctx.cwd,
+		dryRun,
+		...args.config ? { files: [args.config] } : {},
+		...args.workspace ? { workspace: true } : {},
+		...args.workspace && maxDepth !== void 0 ? { maxDepth } : {},
+		...args.backupDir ? { backupDir: args.backupDir } : {},
+		...include ? { include } : {},
+		...exclude ? { exclude } : {}
+	});
+	if (args.reportFile) await writeMigrationReportFile(ctx.cwd, args.reportFile, report);
+	if (args.json) {
+		logMigrationReportAsJson(report);
+		if (checkMode && report.changedFiles > 0) throw createMigrationCheckFailureError(report.changedFiles);
+		if (report.scannedFiles === 0) logNoMigrationConfigFilesWarning();
+		return report;
+	}
+	if (report.scannedFiles === 0) {
+		logNoMigrationConfigFilesWarning();
+		return report;
+	}
+	logMigrationEntries(report, dryRun);
+	logMigrationSummary(report);
+	if (checkMode && report.changedFiles > 0) throw createMigrationCheckFailureError(report.changedFiles);
+	return report;
+}
+//#endregion
+//#region src/commands/restore-handler.ts
+async function restoreCommandDefaultHandler(ctx) {
+	const { args } = ctx;
+	const restoreArgs = resolveRestoreCommandArgs(args);
+	const result = await restoreConfigFiles({
+		cwd: ctx.cwd,
+		reportFile: restoreArgs.reportFile,
+		dryRun: restoreArgs.dryRun,
+		strict: restoreArgs.strict
+	});
+	if (args.json) {
+		logRestoreResultAsJson(result);
+		return result;
+	}
+	logRestoreSummary(result);
+	return result;
+}
+//#endregion
+//#region src/commands/status-output.ts
+function formatFilesHint(entry) {
+	if (!entry.files.length) return "";
+	return ` (${entry.files.join(", ")})`;
+}
+function formatPackageLabel(report) {
+	return `${report.package.name ?? "tailwindcss"}@${report.package.version ?? "unknown"}`;
+}
+function partitionStatusEntries(report) {
+	return {
+		applied: report.entries.filter((entry) => entry.status === "applied"),
+		pending: report.entries.filter((entry) => entry.status === "not-applied"),
+		skipped: report.entries.filter((entry) => entry.status === "skipped" || entry.status === "unsupported")
+	};
+}
+function logStatusReportAsJson(report) {
+	logger.log(JSON.stringify(report, null, 2));
+}
+function logStatusReportSummary(report) {
+	const { applied, pending, skipped } = partitionStatusEntries(report);
+	logger.info(`Patch status for ${formatPackageLabel(report)} (v${report.majorVersion})`);
+	if (applied.length) {
+		logger.success("Applied:");
+		applied.forEach((entry) => logger.success(`  • ${entry.name}${formatFilesHint(entry)}`));
+	}
+	if (pending.length) {
+		logger.warn("Needs attention:");
+		pending.forEach((entry) => {
+			const details = entry.reason ? ` - ${entry.reason}` : "";
+			logger.warn(`  • ${entry.name}${formatFilesHint(entry)}${details}`);
+		});
+	} else logger.success("All applicable patches are applied.");
+	if (skipped.length) {
+		logger.info("Skipped:");
+		skipped.forEach((entry) => {
+			const details = entry.reason ? ` - ${entry.reason}` : "";
+			logger.info(`  • ${entry.name}${details}`);
+		});
+	}
+}
+//#endregion
+//#region src/commands/status-handler.ts
+async function statusCommandDefaultHandler(ctx) {
+	const report = await (await ctx.createPatcher()).getPatchStatus();
+	if (ctx.args.json) {
+		logStatusReportAsJson(report);
+		return report;
+	}
+	logStatusReportSummary(report);
+	return report;
+}
 //#endregion
 //#region src/commands/validate.ts
 const VALIDATE_EXIT_CODES = {
@@ -3131,4 +3699,79 @@ var ValidateCommandError = class extends Error {
 	}
 };
 //#endregion
-export { resolveProjectSourceFiles as C, CacheStore as D, normalizeOptions as E, logger as O, groupTokensByFile as S, loadWorkspaceConfigModule as T, extractRawCandidates as _, tailwindcssPatchCommands as a, extractSourceCandidatesWithPositions as b, MIGRATION_REPORT_KIND as c, getPatchStatusReport as d, runTailwindBuild as f, extractProjectCandidatesWithPositions as g, collectClassesFromTailwindV4 as h, classifyValidateError as i, MIGRATION_REPORT_SCHEMA_VERSION as l, collectClassesFromContexts as m, VALIDATE_FAILURE_REASONS as n, migrateConfigFiles as o, loadRuntimeContexts as p, ValidateCommandError as r, restoreConfigFiles as s, VALIDATE_EXIT_CODES as t, TailwindcssPatcher as u, extractRawCandidatesWithPositions as v, loadPatchOptionsForWorkspace as w, extractValidCandidates as x, extractSourceCandidates as y };
+//#region src/commands/validate-handler.ts
+async function validateCommandDefaultHandler(ctx) {
+	const { args } = ctx;
+	const validateArgs = resolveValidateCommandArgs(args);
+	try {
+		const result = await restoreConfigFiles({
+			cwd: ctx.cwd,
+			reportFile: validateArgs.reportFile,
+			dryRun: true,
+			strict: validateArgs.strict
+		});
+		if (args.json) {
+			logValidateSuccessAsJson(result);
+			return result;
+		}
+		logValidateSuccessSummary(result);
+		return result;
+	} catch (error) {
+		const summary = classifyValidateError(error);
+		if (args.json) logValidateFailureAsJson(summary);
+		else logValidateFailureSummary(summary);
+		throw new ValidateCommandError(summary, { cause: error });
+	}
+}
+//#endregion
+//#region src/commands/default-handler-map.ts
+const defaultCommandHandlers = {
+	install: installCommandDefaultHandler,
+	extract: extractCommandDefaultHandler,
+	tokens: tokensCommandDefaultHandler,
+	init: initCommandDefaultHandler,
+	migrate: migrateCommandDefaultHandler,
+	restore: restoreCommandDefaultHandler,
+	validate: validateCommandDefaultHandler,
+	status: statusCommandDefaultHandler
+};
+//#endregion
+//#region src/commands/command-registrar.ts
+function registerTailwindcssPatchCommand(cli, commandName, options, prefix, defaultDefinitions) {
+	const metadata = resolveCommandMetadata(commandName, options, prefix, defaultDefinitions);
+	const command = cli.command(metadata.name, metadata.description);
+	applyCommandOptions(command, metadata.optionDefs);
+	command.action(async (args) => {
+		const defaultHandler = defaultCommandHandlers[commandName];
+		return runWithCommandHandler(cli, command, commandName, args, options.commandHandlers?.[commandName], defaultHandler);
+	});
+	metadata.aliases.forEach((alias) => command.alias(alias));
+}
+//#endregion
+//#region src/commands/types.ts
+const tailwindcssPatchCommands = [
+	"install",
+	"extract",
+	"tokens",
+	"init",
+	"migrate",
+	"restore",
+	"validate",
+	"status"
+];
+//#endregion
+//#region src/commands/cli.ts
+function mountTailwindcssPatchCommands(cli, options = {}) {
+	const prefix = options.commandPrefix ?? "";
+	const selectedCommands = options.commands ?? tailwindcssPatchCommands;
+	const defaultDefinitions = buildDefaultCommandDefinitions();
+	for (const name of selectedCommands) registerTailwindcssPatchCommand(cli, name, options, prefix, defaultDefinitions);
+	return cli;
+}
+function createTailwindcssPatchCli(options = {}) {
+	const cli = cac(options.name ?? "tw-patch");
+	mountTailwindcssPatchCommands(cli, options.mountOptions);
+	return cli;
+}
+//#endregion
+export { groupTokensByFile as C, logger as D, CacheStore as E, extractValidCandidates as S, normalizeOptions as T, extractProjectCandidatesWithPositions as _, VALIDATE_FAILURE_REASONS as a, extractSourceCandidates as b, restoreConfigFiles as c, TailwindcssPatcher as d, getPatchStatusReport as f, collectClassesFromTailwindV4 as g, collectClassesFromContexts as h, VALIDATE_EXIT_CODES as i, MIGRATION_REPORT_KIND as l, loadRuntimeContexts as m, mountTailwindcssPatchCommands as n, ValidateCommandError as o, runTailwindBuild as p, tailwindcssPatchCommands as r, migrateConfigFiles as s, createTailwindcssPatchCli as t, MIGRATION_REPORT_SCHEMA_VERSION as u, extractRawCandidates as v, resolveProjectSourceFiles as w, extractSourceCandidatesWithPositions as x, extractRawCandidatesWithPositions as y };