tailwind-lint 0.14.0 → 0.15.0

package/README.md

@@ -75,6 +75,7 @@ tailwind-lint --verbose
 - `-c, --config <path>` - Path to Tailwind config file (default: auto-discover)
 - `-a, --auto` - Auto-discover files from the resolved Tailwind config or CSS `@source` directives
 - `--fix` - Automatically fix problems that can be fixed
+- `--dry-run` - Show the fixes `--fix` would apply (with a line diff) without writing any files
 - `--format <text|json>` - Output format (`text` default, `json` for machine-readable output)
 - `-v, --verbose` - Enable verbose logging for debugging
 - `-h, --help` - Show help message
@@ -95,6 +96,9 @@ tailwind-lint --config ./src/app.css
 # Lint and fix specific file types
 tailwind-lint "**/*.vue" --fix
 
+# Preview fixes without changing files
+tailwind-lint --dry-run
+
 # Lint with a specific CSS config (v4)
 tailwind-lint --config ./styles/app.css
 
@@ -116,8 +120,8 @@ tailwind-lint --auto --format json
 The JSON payload includes:
 
 - `ok` - `true` when no errors are found
-- `summary` - counts for `errors`, `warnings`, `fixed`, `filesWithIssues`, `totalFilesProcessed`
-- `config` - resolved runtime values (`cwd`, `configPath`, `autoDiscover`, `fix`, `patterns`)
+- `summary` - counts for `errors`, `warnings`, `fixable`, `fixed`, `filesWithIssues`, `totalFilesProcessed`
+- `config` - resolved runtime values (`cwd`, `configPath`, `autoDiscover`, `fix`, `dryRun`, `patterns`)
 - `files[]` - per-file diagnostics with 1-based `line`/`column` ranges
 
 On JSON errors, the CLI keeps the same top-level shape and adds `error` so agent integrations do not need a separate parser for failure cases.
@@ -228,7 +232,9 @@ Use `--fix` to automatically resolve issues:
 - **Canonical class suggestions** (v4) - Replaces arbitrary values with standard classes
 - **Recommended variant order** (v3 & v4) - Reorders variants correctly
 
-Files are written atomically with multiple iterations to ensure all fixes are applied. The autofix process has a safety limit of 100 iterations per file to prevent infinite loops.
+Use `--dry-run` to preview the changes without writing them.
+
+Fixes that do not overlap are applied together, and files are revalidated until no fixable issues remain. The autofix process has a safety limit of 100 iterations per file to prevent infinite loops.
 
 ## Features
 

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_linter = require("./linter-B-Bi_uRJ.cjs");
+const require_linter = require("./linter-CUpiAi7p.cjs");
 let node_path = require("node:path");
 node_path = require_linter.__toESM(node_path, 1);
 let ansis = require("ansis");
@@ -7,7 +7,40 @@ ansis = require_linter.__toESM(ansis, 1);
 let node_fs = require("node:fs");
 node_fs = require_linter.__toESM(node_fs, 1);
 let commander = require("commander");
-//#region src/output.ts
+// src/diff.ts
+/**
+* Minimal line diff for previewing fixes. Quickfixes rewrite class lists in
+* place, so lines usually map one-to-one; otherwise the region between the
+* common prefix and suffix is reported as removed/added.
+*/
+function diffLines(before, after) {
+	const a = before.split("\n");
+	const b = after.split("\n");
+	const changes = [];
+	if (a.length === b.length) {
+		for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) changes.push({
+			line: i + 1,
+			removed: a[i],
+			added: b[i]
+		});
+		return changes;
+	}
+	let start = 0;
+	while (start < a.length && start < b.length && a[start] === b[start]) start++;
+	let endA = a.length;
+	let endB = b.length;
+	while (endA > start && endB > start && a[endA - 1] === b[endB - 1]) {
+		endA--;
+		endB--;
+	}
+	for (let i = start; i < Math.max(endA, endB); i++) changes.push({
+		line: i + 1,
+		removed: i < endA ? a[i] : void 0,
+		added: i < endB ? b[i] : void 0
+	});
+	return changes;
+}
+// src/output.ts
 function countBySeverity(diagnostics) {
 	let errors = 0;
 	let warnings = 0;
@@ -20,6 +53,15 @@ function countBySeverity(diagnostics) {
 		warnings
 	};
 }
+const ALWAYS_FIXABLE_CODES = /* @__PURE__ */ new Set(["cssConflict", "invalidApply"]);
+function isFixable(diagnostic) {
+	if (ALWAYS_FIXABLE_CODES.has(String(diagnostic.code))) return true;
+	const { suggestions } = diagnostic;
+	return Array.isArray(suggestions) && suggestions.length > 0;
+}
+function countFixable(diagnostics) {
+	return diagnostics.filter(isFixable).length;
+}
 function toJsonSeverity(severity) {
 	if (severity === require_linter.SEVERITY.ERROR) return "error";
 	if (severity === require_linter.SEVERITY.WARNING) return "warning";
@@ -33,20 +75,22 @@ function toJsonDiagnostic(diagnostic) {
 		endColumn: diagnostic.range.end.character + 1,
 		severity: toJsonSeverity(diagnostic.severity),
 		code: diagnostic.code ?? null,
-		message: diagnostic.message,
+		message: typeof diagnostic.message === "string" ? diagnostic.message : diagnostic.message.value,
 		source: diagnostic.source
 	};
 }
-function createJsonOutput({ files, totalFilesProcessed, skippedFiles = [], cwd, configPath, autoDiscover, fix, patterns }) {
+function createJsonOutput({ files, totalFilesProcessed, skippedFiles = [], cwd, configPath, autoDiscover, fix, dryRun = false, patterns }) {
 	let errors = 0;
 	let warnings = 0;
 	let fixed = 0;
+	let fixable = 0;
 	let filesWithIssues = 0;
 	const mappedFiles = files.map((file) => {
 		const severityCount = countBySeverity(file.diagnostics);
 		errors += severityCount.errors;
 		warnings += severityCount.warnings;
 		fixed += file.fixedCount || 0;
+		fixable += countFixable(file.diagnostics);
 		if (file.diagnostics.length > 0) filesWithIssues++;
 		return {
 			path: file.path,
@@ -61,6 +105,7 @@ function createJsonOutput({ files, totalFilesProcessed, skippedFiles = [], cwd,
 			errors,
 			warnings,
 			fixed,
+			fixable,
 			filesWithIssues,
 			totalFilesProcessed
 		},
@@ -69,13 +114,14 @@ function createJsonOutput({ files, totalFilesProcessed, skippedFiles = [], cwd,
 			configPath: configPath || null,
 			autoDiscover,
 			fix,
+			dryRun,
 			patterns
 		},
 		files: mappedFiles,
 		skippedFiles
 	};
 }
-function createJsonErrorOutput({ error, cwd, configPath, autoDiscover, fix, patterns }) {
+function createJsonErrorOutput({ error, cwd, configPath, autoDiscover, fix, dryRun = false, patterns }) {
 	return {
 		ok: false,
 		error,
@@ -83,6 +129,7 @@ function createJsonErrorOutput({ error, cwd, configPath, autoDiscover, fix, patt
 			errors: 0,
 			warnings: 0,
 			fixed: 0,
+			fixable: 0,
 			filesWithIssues: 0,
 			totalFilesProcessed: 0
 		},
@@ -91,15 +138,17 @@ function createJsonErrorOutput({ error, cwd, configPath, autoDiscover, fix, patt
 			configPath: configPath || null,
 			autoDiscover,
 			fix,
+			dryRun,
 			patterns
 		},
 		files: [],
 		skippedFiles: []
 	};
 }
-//#endregion
-//#region src/cli.ts
+// src/cli.ts
 const MAX_FILENAME_DISPLAY_LENGTH = 50;
+const MAX_DIFF_LINES_PER_FILE = 10;
+const CLEAR_LINE = "\r\x1B[2K";
 function resolveOptions(files, options) {
 	const hasAutoFlag = !!options.auto;
 	const hasFiles = files.length > 0;
@@ -113,66 +162,97 @@ function resolveOptions(files, options) {
 		patterns = [];
 		autoDiscover = true;
 	}
+	const dryRun = options.dryRun || false;
 	return {
 		cwd,
 		configPath,
 		patterns: autoDiscover ? [] : patterns,
 		autoDiscover,
-		fix: options.fix || false,
+		fix: options.fix || dryRun,
+		dryRun,
 		verbose: options.verbose || false
 	};
 }
 function truncateFilename(filename) {
 	return filename.length > MAX_FILENAME_DISPLAY_LENGTH ? `...${filename.slice(-50)}` : filename;
 }
-async function displayResults(files, fixMode) {
-	let totalErrors = 0;
-	let totalWarnings = 0;
-	let totalFixed = 0;
-	let filesWithIssues = 0;
-	let isFirstFile = true;
-	for (const file of files) if (file.diagnostics.length > 0 || fixMode && file.fixed) {
-		if (isFirstFile) {
-			console.log();
-			isFirstFile = false;
-		} else console.log();
-		console.log(ansis.default.underline.bold(file.path));
-		if (fixMode && file.fixed) {
-			const issueText = `${file.fixedCount || 0} issue${file.fixedCount !== 1 ? "s" : ""}`;
-			console.log(ansis.default.green(`  ✔ Fixed ${issueText}`));
-			totalFixed += file.fixedCount || 0;
+function plural(count, word) {
+	return `${count} ${word}${count === 1 ? "" : "s"}`;
+}
+function formatDuration(ms) {
+	return ms < 1e3 ? `${Math.round(ms)}ms` : `${(ms / 1e3).toFixed(2)}s`;
+}
+function formatDiff(file) {
+	if (file.originalContent === void 0 || file.fixedContent === void 0) return [];
+	const changes = diffLines(file.originalContent, file.fixedContent);
+	const shown = changes.slice(0, MAX_DIFF_LINES_PER_FILE);
+	const width = String(shown.at(-1)?.line ?? 0).length;
+	const lines = [];
+	for (const change of shown) {
+		const lineNo = ansis.default.dim(String(change.line).padStart(width));
+		const blank = " ".repeat(width);
+		if (change.removed !== void 0) lines.push(`    ${lineNo} ${ansis.default.red(`- ${change.removed.trim()}`)}`);
+		if (change.added !== void 0) {
+			const prefix = change.removed !== void 0 ? blank : lineNo;
+			lines.push(`    ${prefix} ${ansis.default.green(`+ ${change.added.trim()}`)}`);
 		}
-		const { errors, warnings } = countBySeverity(file.diagnostics);
-		totalErrors += errors;
-		totalWarnings += warnings;
+	}
+	const hidden = changes.length - shown.length;
+	if (hidden > 0) lines.push(ansis.default.dim(`    … ${plural(hidden, "more changed line")}`));
+	return lines;
+}
+function formatFile(file, dryRun) {
+	const lines = [ansis.default.underline.bold(file.path)];
+	if (file.fixed) {
+		const issues = plural(file.fixedCount || 0, "issue");
+		lines.push(dryRun ? ansis.default.cyan(`  ~ Would fix ${issues}`) : ansis.default.green(`  ✔ Fixed ${issues}`));
+		if (dryRun) lines.push(...formatDiff(file));
+	}
+	const positions = file.diagnostics.map((d) => `${d.range.start.line + 1}:${d.range.start.character + 1}`);
+	const positionWidth = Math.max(0, ...positions.map((p) => p.length));
+	for (const [index, diagnostic] of file.diagnostics.entries()) {
+		const severity = diagnostic.severity === require_linter.SEVERITY.ERROR ? ansis.default.red("error  ") : ansis.default.yellow("warning");
+		const code = diagnostic.code ? `  ${ansis.default.dim(String(diagnostic.code))}` : "";
+		lines.push(`  ${ansis.default.dim(positions[index].padEnd(positionWidth))}  ${severity}  ${diagnostic.message}${code}`);
+	}
+	return lines;
+}
+function formatSummary(files, totalFilesProcessed, durationMs, fixMode, dryRun) {
+	let errors = 0;
+	let warnings = 0;
+	let fixed = 0;
+	let fixable = 0;
+	let filesWithIssues = 0;
+	let filesFixed = 0;
+	for (const file of files) {
+		const counts = countBySeverity(file.diagnostics);
+		errors += counts.errors;
+		warnings += counts.warnings;
+		fixable += countFixable(file.diagnostics);
 		if (file.diagnostics.length > 0) filesWithIssues++;
-		for (const diagnostic of file.diagnostics) {
-			const line = diagnostic.range.start.line + 1;
-			const char = diagnostic.range.start.character + 1;
-			const severity = diagnostic.severity === require_linter.SEVERITY.ERROR ? "error" : "warning";
-			const severityColor = diagnostic.severity === require_linter.SEVERITY.ERROR ? ansis.default.red(severity) : ansis.default.yellow(severity);
-			const code = diagnostic.code ? ansis.default.dim(`  (${diagnostic.code})`) : "";
-			console.log(`  ${ansis.default.dim(`${line}:${char}`)}  ${severityColor}  ${diagnostic.message}${code}`);
+		if (file.fixed) {
+			fixed += file.fixedCount || 0;
+			filesFixed++;
 		}
 	}
-	console.log();
-	if (totalErrors === 0 && totalWarnings === 0) {
-		if (totalFixed > 0) {
-			const issueText = `${totalFixed} issue${totalFixed !== 1 ? "s" : ""}`;
-			console.log(ansis.default.green.bold(`✔ Fixed ${issueText}`));
-		} else console.log(ansis.default.green.bold("✔ No issues found"));
+	const lines = [];
+	if (fixed > 0) {
+		const text = `${plural(fixed, "issue")} in ${plural(filesFixed, "file")}`;
+		lines.push(dryRun ? ansis.default.cyan.bold(`~ Would fix ${text} (dry run, no files written)`) : ansis.default.green.bold(`✔ Fixed ${text}`));
+	}
+	const problems = errors + warnings;
+	if (problems === 0) {
+		if (fixed === 0) lines.push(ansis.default.green.bold("✔ No issues found"));
 	} else {
-		const parts = [];
-		if (totalErrors > 0) parts.push(`${totalErrors} error${totalErrors !== 1 ? "s" : ""}`);
-		if (totalWarnings > 0) parts.push(`${totalWarnings} warning${totalWarnings !== 1 ? "s" : ""}`);
-		const fileText = `${filesWithIssues} file${filesWithIssues !== 1 ? "s" : ""}`;
-		const summary = `Found ${parts.join(" and ")} in ${fileText}`;
-		if (totalFixed > 0) {
-			const issueText = `${totalFixed} issue${totalFixed !== 1 ? "s" : ""}`;
-			console.log(ansis.default.green.bold(`✔ Fixed ${issueText}`));
-			console.log(summary);
-		} else console.log(summary);
+		const color = errors > 0 ? ansis.default.red.bold : ansis.default.yellow.bold;
+		lines.push(color(`✖ ${plural(problems, "problem")} (${plural(errors, "error")}, ${plural(warnings, "warning")}) in ${plural(filesWithIssues, "file")}`));
+		if (fixable > 0 && !fixMode) lines.push(ansis.default.dim(`  ${fixable} potentially fixable with ${ansis.default.yellow("--fix")} (preview with ${ansis.default.yellow("--dry-run")})`));
 	}
+	lines.push(ansis.default.dim(`Linted ${plural(totalFilesProcessed, "file")} in ${formatDuration(durationMs)}`));
+	return lines;
+}
+function writeAndExit(output, code) {
+	process.stdout.write(output, () => process.exit(code));
 }
 const program = new commander.Command();
 const getVersion = () => {
@@ -209,13 +289,14 @@ program.configureHelp({ formatHelp: (cmd, helper) => {
 	}
 	return output;
 } });
-program.name("tailwind-lint").description("A CLI tool for linting Tailwind CSS class usage").version(getVersion()).argument("[files...]", "File patterns to lint (e.g., \"src/**/*.{js,jsx,ts,tsx}\")").option("-c, --config <path>", "Path to Tailwind config file (default: auto-discover)").option("-a, --auto", "Auto-discover files from Tailwind config or CSS @source patterns").option("--fix", "Automatically fix problems that can be fixed").option("-v, --verbose", "Enable verbose logging for debugging").option("--format <format>", "Output format: text or json", "text").addHelpText("after", `
+program.name("tailwind-lint").description("A CLI tool for linting Tailwind CSS class usage").version(getVersion()).argument("[files...]", "File patterns to lint (e.g., \"src/**/*.{js,jsx,ts,tsx}\")").option("-c, --config <path>", "Path to Tailwind config file (default: auto-discover)").option("-a, --auto", "Auto-discover files from Tailwind config or CSS @source patterns").option("--fix", "Automatically fix problems that can be fixed").option("--dry-run", "Show which fixes --fix would apply without writing any files").option("-v, --verbose", "Enable verbose logging for debugging").option("--format <format>", "Output format: text or json", "text").addHelpText("after", `
 ${ansis.default.bold.cyan("Examples:")}
   ${ansis.default.dim("$")} tailwind-lint
   ${ansis.default.dim("$")} tailwind-lint ${ansis.default.green("\"src/**/*.{js,jsx,ts,tsx}\"")}
   ${ansis.default.dim("$")} tailwind-lint ${ansis.default.yellow("--config")} ${ansis.default.green("./tailwind.config.js")}
   ${ansis.default.dim("$")} tailwind-lint ${ansis.default.yellow("--config")} ${ansis.default.green("./src/app.css")}
   ${ansis.default.dim("$")} tailwind-lint ${ansis.default.green("\"src/**/*.tsx\"")} ${ansis.default.yellow("--fix")}
+  ${ansis.default.dim("$")} tailwind-lint ${ansis.default.yellow("--dry-run")}
   ${ansis.default.dim("$")} tailwind-lint ${ansis.default.green("\"**/*.vue\"")}
 
 ${ansis.default.bold.cyan("Notes:")}
@@ -226,73 +307,60 @@ ${ansis.default.bold.cyan("Notes:")}
   ${ansis.default.dim("•")} Default pattern: ${ansis.default.dim(require_linter.DEFAULT_FILE_PATTERN)}
   ${ansis.default.dim("•")} Reads Tailwind workspace settings from ${ansis.default.dim(".zed/settings.json")} and ${ansis.default.dim(".vscode/settings.json")}
   ${ansis.default.dim("•")} Use ${ansis.default.yellow("--fix")} to automatically resolve fixable issues
+  ${ansis.default.dim("•")} Use ${ansis.default.yellow("--dry-run")} to preview fixes without changing files
 `).action(async (files, options) => {
 	const hasConfigFlag = !!options.config;
 	const hasAutoFlag = !!options.auto;
 	if (!(files.length > 0) && !hasAutoFlag && !hasConfigFlag) options.auto = true;
 	const resolved = resolveOptions(files, options);
-	const isJsonOutput = (options.format === "json" ? "json" : "text") === "json";
+	const isJsonOutput = options.format === "json";
+	const showProgress = !isJsonOutput && !resolved.verbose && !!process.stdout.isTTY;
+	const startTime = performance.now();
 	try {
 		if (resolved.verbose && !isJsonOutput) {
 			console.log(ansis.default.cyan.bold("→ Configuration"));
 			console.log(ansis.default.dim(`  Working directory: ${resolved.cwd}`));
 			console.log(ansis.default.dim(`  Config path: ${resolved.configPath || "auto-discover"}`));
 			console.log(ansis.default.dim(`  Fix mode: ${resolved.fix}`));
+			console.log(ansis.default.dim(`  Dry run: ${resolved.dryRun}`));
 			console.log(ansis.default.dim(`  Patterns: ${resolved.patterns.length > 0 ? resolved.patterns.join(", ") : "auto-discover"}`));
 			console.log();
 		}
+		if (showProgress) process.stdout.write(`${ansis.default.cyan("→")} Loading Tailwind configuration...`);
 		const results = await require_linter.lint({
 			...resolved,
 			onProgress: (current, total, file) => {
-				if (isJsonOutput) return;
-				if (process.stdout.isTTY && !resolved.verbose) {
-					const displayFile = truncateFilename(file);
-					process.stdout.write(`\r${ansis.default.cyan("→")} Linting files... ${ansis.default.dim(`(${current}/${total})`)} ${ansis.default.dim(displayFile)}${" ".repeat(10)}`);
-				} else if (resolved.verbose) console.log(ansis.default.dim(`  [${current}/${total}] Linting ${file}`));
+				if (showProgress) process.stdout.write(`${CLEAR_LINE}${ansis.default.cyan("→")} Linting files... ${ansis.default.dim(`(${current}/${total})`)} ${ansis.default.dim(truncateFilename(file))}`);
+				else if (resolved.verbose && !isJsonOutput) console.log(ansis.default.dim(`  [${current}/${total}] Linting ${file}`));
 			}
 		});
-		if (process.stdout.isTTY && !resolved.verbose && !isJsonOutput) process.stdout.write(`\r${" ".repeat(80)}\r`);
-		if (results.skippedFiles.length > 0 && !isJsonOutput) for (const skipped of results.skippedFiles) console.log(ansis.default.yellow(`⚠ Skipped ${truncateFilename(skipped)} (exceeds size limit)`));
-		if (results.totalFilesProcessed === 0) {
-			if (isJsonOutput) console.log(JSON.stringify(createJsonOutput({
-				...resolved,
-				files: [],
-				totalFilesProcessed: 0,
-				skippedFiles: results.skippedFiles
-			})));
-			else {
-				console.log();
-				console.log(ansis.default.yellow("⚠ No files found to lint"));
-			}
-			process.exit(0);
-		}
-		if (results.files.length === 0) {
-			if (isJsonOutput) console.log(JSON.stringify(createJsonOutput({
-				...resolved,
-				files: [],
-				totalFilesProcessed: results.totalFilesProcessed,
-				skippedFiles: results.skippedFiles
-			})));
-			else console.log(ansis.default.green.bold("✔ No issues found"));
-			process.exit(0);
-		}
-		if (isJsonOutput) console.log(JSON.stringify(createJsonOutput({
+		if (showProgress) process.stdout.write(CLEAR_LINE);
+		const exitCode = results.files.some((file) => file.diagnostics.some((d) => d.severity === require_linter.SEVERITY.ERROR)) ? 1 : 0;
+		if (isJsonOutput) return writeAndExit(`${JSON.stringify(createJsonOutput({
 			...resolved,
 			files: results.files,
 			totalFilesProcessed: results.totalFilesProcessed,
 			skippedFiles: results.skippedFiles
-		})));
-		else await displayResults(results.files, resolved.fix);
-		const hasErrors = results.files.some((file) => file.diagnostics.some((d) => d.severity === require_linter.SEVERITY.ERROR));
-		process.exit(hasErrors ? 1 : 0);
+		}))}\n`, exitCode);
+		const lines = [];
+		for (const skipped of results.skippedFiles) lines.push(ansis.default.yellow(`⚠ Skipped ${truncateFilename(skipped)} (exceeds size limit)`));
+		if (results.totalFilesProcessed === 0) {
+			lines.push(ansis.default.yellow("⚠ No files found to lint"));
+			return writeAndExit(`${lines.join("\n")}\n`, 0);
+		}
+		for (const file of results.files) lines.push("", ...formatFile(file, resolved.dryRun));
+		if (results.files.length > 0) lines.push("");
+		lines.push(...formatSummary(results.files, results.totalFilesProcessed, performance.now() - startTime, resolved.fix, resolved.dryRun));
+		return writeAndExit(`${lines.join("\n")}\n`, exitCode);
 	} catch (error) {
+		if (showProgress) process.stdout.write(CLEAR_LINE);
 		const errorMessage = error instanceof Error ? error.message : String(error);
-		if (isJsonOutput) console.log(JSON.stringify(createJsonErrorOutput({
+		if (isJsonOutput) return writeAndExit(`${JSON.stringify(createJsonErrorOutput({
 			error: errorMessage,
 			...resolved
-		})));
-		else console.error(ansis.default.red("✖ Error:"), errorMessage);
-		if (resolved.verbose && error instanceof Error && !isJsonOutput) {
+		}))}\n`, 1);
+		console.error(ansis.default.red("✖ Error:"), errorMessage);
+		if (resolved.verbose && error instanceof Error) {
 			console.error(ansis.default.dim("\nStack trace:"));
 			console.error(ansis.default.dim(error.stack || error.toString()));
 		}
@@ -300,4 +368,3 @@ ${ansis.default.bold.cyan("Notes:")}
 	}
 });
 program.parse();
-//#endregion

package/dist/{linter-B-Bi_uRJ.cjs → linter-CUpiAi7p.cjs}

@@ -1,4 +1,4 @@
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -19,7 +19,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises, 1);
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
 let _tailwindcss_language_service = require("@tailwindcss/language-service");
@@ -33,8 +34,7 @@ node_fs = __toESM(node_fs, 1);
 let node_url = require("node:url");
 let postcss = require("postcss");
 postcss = __toESM(postcss, 1);
-let node_fs_promises = require("node:fs/promises");
-//#region src/constants.ts
+// src/constants.ts
 const DEFAULT_IGNORE_PATTERNS = [
 	"**/node_modules/**",
 	"**/dist/**",
@@ -125,8 +125,7 @@ function getLanguageId(filePath) {
 	const ext = filePath.substring(filePath.lastIndexOf(".")).toLowerCase();
 	return LANGUAGE_MAP[ext] || "html";
 }
-//#endregion
-//#region src/code-actions.ts
+// src/code-actions.ts
 async function getQuickfixes(state, document, uri, diagnostics) {
 	const lspDiagnostics = diagnostics.map((diag) => ({
 		range: diag.range,
@@ -151,49 +150,85 @@ async function getQuickfixes(state, document, uri, diagnostics) {
 	};
 	return (await (0, _tailwindcss_language_service.doCodeActions)(state, params, document)).filter((action) => action.kind === "quickfix" || action.kind?.startsWith(`quickfix.`));
 }
-function applyFirstQuickfix(action, uri, document, content) {
-	if (!action.edit?.changes?.[uri]) return null;
-	const sortedEdits = [...action.edit.changes[uri]].sort((a, b) => {
-		const lineDiff = b.range.start.line - a.range.start.line;
-		if (lineDiff !== 0) return lineDiff;
-		return b.range.start.character - a.range.start.character;
-	});
-	let newContent = content;
-	for (const edit of sortedEdits) {
-		const startOffset = document.offsetAt(edit.range.start);
-		const endOffset = document.offsetAt(edit.range.end);
-		newContent = newContent.substring(0, startOffset) + edit.newText + newContent.substring(endOffset);
+function diagnosticKey(diagnostic) {
+	const { start, end } = diagnostic.range;
+	return `${diagnostic.code}:${start.line}:${start.character}:${end.line}:${end.character}:${diagnostic.message}`;
+}
+function overlaps(a, b) {
+	return a.start === b.start || a.start < b.end && b.start < a.end;
+}
+/**
+* Picks the first quickfix for every diagnostic and keeps only those whose
+* edits do not overlap, so a single validation pass can fix many issues.
+* Overlapping fixes (e.g. two cssConflict fixes rewriting the same class list)
+* are left for the next pass, which sees the updated document.
+*/
+function selectNonOverlappingEdits(actions, uri, document) {
+	const handled = /* @__PURE__ */ new Set();
+	const accepted = [];
+	let fixCount = 0;
+	for (const action of actions) {
+		const edits = action.edit?.changes?.[uri];
+		if (!edits || edits.length === 0) continue;
+		const keys = (action.diagnostics ?? []).map(diagnosticKey);
+		if (keys.some((key) => handled.has(key))) continue;
+		const offsetEdits = edits.map((edit) => ({
+			start: document.offsetAt(edit.range.start),
+			end: document.offsetAt(edit.range.end),
+			newText: edit.newText
+		}));
+		if (offsetEdits.some((edit, index) => [...accepted, ...offsetEdits.slice(0, index)].some((other) => overlaps(edit, other)))) continue;
+		for (const key of keys) handled.add(key);
+		accepted.push(...offsetEdits);
+		fixCount++;
 	}
-	return { content: newContent };
+	return {
+		edits: accepted,
+		fixCount
+	};
+}
+function applyEdits(content, edits) {
+	const sorted = [...edits].sort((a, b) => a.start - b.start);
+	let result = "";
+	let cursor = 0;
+	for (const edit of sorted) {
+		result += content.slice(cursor, edit.start) + edit.newText;
+		cursor = edit.end;
+	}
+	return result + content.slice(cursor);
 }
 async function applyCodeActions(state, filePath, content, diagnostics) {
 	if (diagnostics.length === 0) return {
 		content,
 		changed: false,
-		fixedCount: 0
+		fixedCount: 0,
+		diagnostics
 	};
 	try {
 		const languageId = getLanguageId(filePath);
 		const uri = `file://${filePath}`;
 		let currentDocument = vscode_languageserver_textdocument.TextDocument.create(uri, languageId, 1, content);
 		let currentContent = content;
+		let currentDiagnostics = diagnostics;
 		let totalFixed = 0;
-		for (let iteration = 0; iteration < 100; iteration++) {
-			const currentDiagnostics = await (0, _tailwindcss_language_service.doValidate)(state, currentDocument);
+		for (let iteration = 0;; iteration++) {
+			if (iteration > 0) currentDiagnostics = await (0, _tailwindcss_language_service.doValidate)(state, currentDocument);
 			if (currentDiagnostics.length === 0) break;
-			const quickfixes = await getQuickfixes(state, currentDocument, uri, currentDiagnostics);
-			if (quickfixes.length === 0) break;
-			const fixResult = applyFirstQuickfix(quickfixes[0], uri, currentDocument, currentContent);
-			if (!fixResult) break;
-			currentContent = fixResult.content;
+			if (iteration === 100) {
+				console.warn(`Warning: Reached maximum fix iterations (100) for ${filePath}. Some issues may remain unfixed.`);
+				break;
+			}
+			const { edits, fixCount } = selectNonOverlappingEdits(await getQuickfixes(state, currentDocument, uri, currentDiagnostics), uri, currentDocument);
+			if (fixCount === 0) break;
+			currentContent = applyEdits(currentContent, edits);
 			currentDocument = vscode_languageserver_textdocument.TextDocument.create(uri, languageId, currentDocument.version + 1, currentContent);
-			totalFixed++;
-			if (iteration === 99) console.warn(`Warning: Reached maximum fix iterations (100) for ${filePath}. Some issues may remain unfixed.`);
+			totalFixed += fixCount;
 		}
 		return {
 			content: currentContent,
 			changed: currentContent !== content,
-			fixedCount: totalFixed
+			fixedCount: totalFixed,
+			diagnostics: currentDiagnostics
 		};
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
@@ -202,14 +237,14 @@ async function applyCodeActions(state, filePath, content, diagnostics) {
 			return {
 				content,
 				changed: false,
-				fixedCount: 0
+				fixedCount: 0,
+				diagnostics
 			};
 		}
 		throw error;
 	}
 }
-//#endregion
-//#region src/utils/fs.ts
+// src/utils/fs.ts
 function fileExists(filePath) {
 	try {
 		return node_fs.existsSync(filePath);
@@ -228,11 +263,6 @@ function readFileSync(filePath) {
 	if (!filePath || typeof filePath !== "string") throw new TypeError("File path must be a non-empty string");
 	return node_fs.readFileSync(filePath, "utf-8");
 }
-function writeFileSync(filePath, content) {
-	if (!filePath || typeof filePath !== "string") throw new TypeError("File path must be a non-empty string");
-	if (typeof content !== "string") throw new TypeError("Content must be a string");
-	node_fs.writeFileSync(filePath, content, "utf-8");
-}
 function readGitignorePatterns(cwd) {
 	const gitignorePath = node_path.join(cwd, ".gitignore");
 	if (!fileExists(gitignorePath)) return [];
@@ -246,8 +276,7 @@ function readGitignorePatterns(cwd) {
 		return [];
 	}
 }
-//#endregion
-//#region src/utils/settings.ts
+// src/utils/settings.ts
 function loadWorkspaceTailwindSettings(cwd) {
 	return mergeTailwindSettings(readVsCodeTailwindSettings(cwd), readZedTailwindSettings(cwd));
 }
@@ -396,8 +425,7 @@ function mergeEditorSettings(defaultSettings, overrides) {
 		}
 	};
 }
-//#endregion
-//#region src/adapters/editor-state-adapter.ts
+// src/adapters/editor-state-adapter.ts
 function isDirectory(filePath) {
 	try {
 		return node_fs.statSync(filePath).isDirectory();
@@ -480,8 +508,7 @@ function createEditorState(cwd) {
 		}
 	};
 }
-//#endregion
-//#region src/types.ts
+// src/types.ts
 /**
 * Error thrown when adapter fails to load required modules
 */
@@ -493,8 +520,7 @@ var AdapterLoadError = class extends Error {
 		this.name = "AdapterLoadError";
 	}
 };
-//#endregion
-//#region src/adapters/v3-adapter.ts
+// src/adapters/v3-adapter.ts
 const require$4 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href || __filename);
 function interopDefault(module) {
 	return module && typeof module === "object" && "default" in module ? module.default : module;
@@ -543,8 +569,7 @@ function extractConfigMetadata(state) {
 	state.blocklist = config.blocklist ?? [];
 	if (config.corePlugins) state.corePlugins = Array.isArray(config.corePlugins) ? config.corePlugins : Object.keys(config.corePlugins);
 }
-//#endregion
-//#region src/adapters/v4-adapter.ts
+// src/adapters/v4-adapter.ts
 const require$3 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href || __filename);
 function resolveModule(id, paths) {
 	let firstError;
@@ -592,6 +617,21 @@ function fromPostcss(nodes) {
 		}
 	});
 }
+function memoizeCanonicalize(designSystem) {
+	const canonicalize = designSystem.canonicalizeCandidates;
+	if (typeof canonicalize === "function") {
+		const cache = /* @__PURE__ */ new Map();
+		designSystem.canonicalizeCandidates = ((candidates, options) => {
+			const key = `${JSON.stringify(options ?? null)}\0${candidates.join(" ")}`;
+			let result = cache.get(key);
+			if (!result) {
+				result = canonicalize.call(designSystem, candidates, options);
+				cache.set(key, result);
+			}
+			return [...result];
+		});
+	}
+}
 async function loadV4DesignSystem(state, resolvePaths, target, verbose = false) {
 	try {
 		const tailwindPath = require$3.resolve("tailwindcss", { paths: resolvePaths });
@@ -637,19 +677,29 @@ async function loadV4DesignSystem(state, resolvePaths, target, verbose = false)
 					};
 				}
 			});
+			const compileUncached = (classes) => {
+				if (designSystem.candidatesToAst) return designSystem.candidatesToAst(classes);
+				if (designSystem.candidatesToCss) return designSystem.candidatesToCss(classes).map((css) => {
+					if (!css) return [];
+					try {
+						return fromPostcss(postcss.default.parse(css).nodes);
+					} catch {
+						return [];
+					}
+				});
+				return classes.map(() => []);
+			};
+			memoizeCanonicalize(designSystem);
+			const compileCache = /* @__PURE__ */ new Map();
 			Object.assign(designSystem, {
 				dependencies: () => /* @__PURE__ */ new Set(),
 				compile(classes) {
-					if (designSystem.candidatesToAst) return designSystem.candidatesToAst(classes);
-					if (designSystem.candidatesToCss) return designSystem.candidatesToCss(classes).map((css) => {
-						if (!css) return [];
-						try {
-							return fromPostcss(postcss.default.parse(css).nodes);
-						} catch {
-							return [];
-						}
-					});
-					return classes.map(() => []);
+					const missing = [...new Set(classes.filter((c) => !compileCache.has(c)))];
+					if (missing.length > 0) {
+						const compiled = compileUncached(missing);
+						for (const [index, className] of missing.entries()) compileCache.set(className, compiled[index] ?? []);
+					}
+					return classes.map((c) => compileCache.get(c) ?? []);
 				}
 			});
 			state.designSystem = designSystem;
@@ -662,8 +712,7 @@ async function loadV4DesignSystem(state, resolvePaths, target, verbose = false)
 		throw new Error(`Failed to load v4 design system: ${String(error)}`);
 	}
 }
-//#endregion
-//#region src/utils/config.ts
+// src/utils/config.ts
 const require$2 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href || __filename);
 const CONFIG_DISCOVERY_MAX_DEPTH = 8;
 const PROJECT_ROOT_MARKERS = ["package.json", ".git"];
@@ -838,8 +887,7 @@ function isPreferredCssFolder(relativePath) {
 function splitDepth(value) {
 	return value.split(/[\\/]/).filter(Boolean).length;
 }
-//#endregion
-//#region src/state.ts
+// src/state.ts
 const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href || __filename);
 function getTailwindVersion(paths) {
 	try {
@@ -916,8 +964,7 @@ async function createState(cwd, target, verbose = false) {
 	else await loadV3ClassMetadata(state, resolvePaths, verbose);
 	return state;
 }
-//#endregion
-//#region src/linter.ts
+// src/linter.ts
 const SOURCE_FILE_PATTERN = "**/*.{js,jsx,ts,tsx,html,vue,svelte,astro,mdx}";
 const GLOB_PATTERN_REGEX = /[*?[\]{}]/;
 const MAX_LISTED_PACKAGES = 10;
@@ -1019,37 +1066,53 @@ function extractImportSourceDirectives(cssContent) {
 		disableAutoSource
 	};
 }
-async function processFiles(state, cwd, files, fix, onProgress) {
-	const results = [];
-	for (let i = 0; i < files.length; i += 10) {
-		const batch = files.slice(i, i + 10);
-		const batchResults = await Promise.all(batch.map(async (file, batchIndex) => {
-			if (onProgress) onProgress(i + batchIndex + 1, files.length, file);
-			return processFile(state, cwd, file, fix);
-		}));
-		results.push(...batchResults.filter((r) => r !== null));
+async function processFiles(state, cwd, files, fix, dryRun, onProgress) {
+	const results = Array.from({ length: files.length });
+	let next = 0;
+	let started = 0;
+	const worker = async () => {
+		while (next < files.length) {
+			const index = next++;
+			const file = files[index];
+			onProgress?.(++started, files.length, file);
+			results[index] = await processFile(state, cwd, file, fix, dryRun);
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(10, files.length) }, worker));
+	return results.filter((result) => result !== null);
+}
+async function readFileIfExists(filePath) {
+	try {
+		return await node_fs_promises.readFile(filePath, "utf-8");
+	} catch {
+		return null;
 	}
-	return results;
 }
-async function processFile(state, cwd, filePath, fix) {
+async function processFile(state, cwd, filePath, fix, dryRun) {
 	const absolutePath = node_path.isAbsolute(filePath) ? filePath : node_path.resolve(cwd, filePath);
-	if (!fileExists(absolutePath)) return null;
-	const content = readFileSync(absolutePath);
+	const content = await readFileIfExists(absolutePath);
+	if (content === null) return null;
 	let diagnostics = await validateDocument(state, absolutePath, content);
 	let fixedCount = 0;
+	let fixedContent;
 	if (fix && diagnostics.length > 0) {
 		const fixResult = await applyCodeActions(state, absolutePath, content, diagnostics);
 		if (fixResult.changed) {
-			writeFileSync(absolutePath, fixResult.content);
+			if (dryRun) fixedContent = fixResult.content;
+			else await node_fs_promises.writeFile(absolutePath, fixResult.content, "utf-8");
 			fixedCount = fixResult.fixedCount;
-			diagnostics = await validateDocument(state, absolutePath, fixResult.content);
+			diagnostics = fixResult.diagnostics;
 		}
 	}
 	return {
 		path: node_path.relative(cwd, absolutePath),
 		diagnostics,
 		fixed: fixedCount > 0,
-		fixedCount
+		fixedCount,
+		...fixedContent !== void 0 && {
+			originalContent: content,
+			fixedContent
+		}
 	};
 }
 async function initializeState(cwd, target, verbose = false) {
@@ -1062,7 +1125,7 @@ async function initializeState(cwd, target, verbose = false) {
 		throw new Error(`Failed to initialize Tailwind state: ${message}`);
 	}
 }
-async function lint({ cwd, patterns, configPath, autoDiscover, fix = false, verbose = false, onProgress }) {
+async function lint({ cwd, patterns, configPath, autoDiscover, fix = false, dryRun = false, verbose = false, onProgress }) {
 	const targets = await resolveConfigTargets(cwd, configPath);
 	if (verbose) logTargets(cwd, targets);
 	const configRoots = targets.map((target) => target.root);
@@ -1100,7 +1163,7 @@ async function lint({ cwd, patterns, configPath, autoDiscover, fix = false, verb
 		if (!files) continue;
 		const offset = processedCount;
 		processedCount += files.length;
-		const processed = await processFiles(await initializeState(cwd, target, verbose), cwd, files.sort((a, b) => a.localeCompare(b)), fix, onProgress && ((current, _total, file) => onProgress(offset + current, totalFiles, file)));
+		const processed = await processFiles(await initializeState(cwd, target, verbose), cwd, files.sort((a, b) => a.localeCompare(b)), fix || dryRun, dryRun, onProgress && ((current, _total, file) => onProgress(offset + current, totalFiles, file)));
 		results.push(...processed);
 	}
 	return {
@@ -1138,7 +1201,6 @@ function logTargets(cwd, targets) {
 function ownershipScore(target, absolutePath) {
 	return isInsideDir(target.root, absolutePath) ? target.root.length : -1;
 }
-//#endregion
 Object.defineProperty(exports, "DEFAULT_FILE_PATTERN", {
 	enumerable: true,
 	get: function() {

package/dist/linter.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_linter = require("./linter-B-Bi_uRJ.cjs");
+const require_linter = require("./linter-CUpiAi7p.cjs");
 exports.extractImportSourceDirectives = require_linter.extractImportSourceDirectives;
 exports.extractSourcePatterns = require_linter.extractSourcePatterns;
 exports.lint = require_linter.lint;

package/dist/linter.d.cts

@@ -1,4 +1,3 @@
-//#region node_modules/.pnpm/vscode-languageserver-types@3.18.4/node_modules/vscode-languageserver-types/lib/esm/main.d.ts
 /**
  * A tagging type for string properties that are actually document URIs.
  */
@@ -430,13 +429,15 @@ declare namespace MarkupContent {
    */
   function is(value: any): value is MarkupContent;
 }
-//#endregion
-//#region src/types.d.ts
 interface LintFileResult {
   path: string;
   diagnostics: Diagnostic[];
   fixed?: boolean;
   fixedCount?: number;
+  /** Content before fixing; only set in dry-run mode when fixes are available */
+  originalContent?: string;
+  /** Content after fixing; only set in dry-run mode when fixes are available */
+  fixedContent?: string;
 }
 interface LintOptions {
   cwd: string;
@@ -444,6 +445,8 @@ interface LintOptions {
   configPath?: string;
   autoDiscover: boolean;
   fix?: boolean;
+  /** Compute fixes without writing them to disk (implies `fix`) */
+  dryRun?: boolean;
   verbose?: boolean;
   onProgress?: (current: number, total: number, file: string) => void;
 }
@@ -452,8 +455,6 @@ interface LintResult {
   totalFilesProcessed: number;
   skippedFiles: string[];
 }
-//#endregion
-//#region src/linter.d.ts
 declare function extractSourcePatterns(cssContent: string): {
   include: string[];
   exclude: string[];
@@ -462,6 +463,5 @@ declare function extractImportSourceDirectives(cssContent: string): {
   roots: string[];
   disableAutoSource: boolean;
 };
-export declare function lint({ cwd, patterns, configPath, autoDiscover, fix, verbose, onProgress }: LintOptions): Promise<LintResult>;
-//#endregion
+export declare function lint({ cwd, patterns, configPath, autoDiscover, fix, dryRun, verbose, onProgress }: LintOptions): Promise<LintResult>;
 export { type LintFileResult, type LintOptions, type LintResult, extractImportSourceDirectives, extractSourcePatterns };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "tailwind-lint",
-	"version": "0.14.0",
+	"version": "0.15.0",
 	"description": "A command-line tool that uses the Tailwind CSS IntelliSense plugin to show linting suggestions for your Tailwind CSS classes",
 	"keywords": [
 		"cli",
@@ -61,22 +61,22 @@
 		"@tailwindcss/language-service": "^0.16.0",
 		"ansis": "^4.4.0",
 		"commander": "^15.0.0",
-		"postcss": "^8.5.29",
+		"postcss": "^8.5.32",
 		"tinyglobby": "^0.2.17",
-		"vscode-languageserver-textdocument": "^1.0.15"
+		"vscode-languageserver-textdocument": "^1.0.16"
 	},
 	"devDependencies": {
-		"@types/node": "^26.6.4",
-		"oxfmt": "^0.72.0",
-		"oxlint": "^1.87.0",
-		"tsdown": "^0.23.0",
+		"@types/node": "^26.6.5",
+		"oxfmt": "^0.75.0",
+		"oxlint": "^1.90.0",
+		"tsdown": "^0.23.2",
 		"typescript": "^7.0.2",
-		"vitest": "^5.0.3",
-		"vscode-languageserver": "10.1.2"
+		"vitest": "^5.0.5",
+		"vscode-languageserver": "11.0.0"
 	},
 	"engines": {
 		"node": ">=22.0.0",
 		"pnpm": ">=10.0.0"
 	},
-	"packageManager": "pnpm@12.9.1"
+	"packageManager": "pnpm@12.15.0"
 }