tailwind-lint 0.6.1 → 0.8.0

package/README.md

@@ -48,6 +48,7 @@ tailwind-lint --verbose
 ### How Auto-Discovery Works
 
 **Tailwind CSS v4:**
+
 - Finds CSS config files in common locations: `app.css`, `index.css`, `tailwind.css`, `global.css`, etc.
 - Searches in project root and subdirectories: `./`, `./src/`, `./src/styles/`, `./app/`, etc.
 - Uses file patterns from `@source` directives if present
@@ -55,6 +56,7 @@ tailwind-lint --verbose
 - **Note:** When CSS config is in a subdirectory (e.g., `src/styles/global.css`), files are discovered from the project root
 
 **Tailwind CSS v3:**
+
 - Finds JavaScript config files: `tailwind.config.js`, `tailwind.config.cjs`, `tailwind.config.mjs`, `tailwind.config.ts`
 - Uses file patterns from the `content` array in your config
 
@@ -63,6 +65,7 @@ tailwind-lint --verbose
 - `-c, --config <path>` - Path to Tailwind config file (default: auto-discover)
 - `-a, --auto` - Auto-discover files from config content patterns (legacy, enabled by default)
 - `--fix` - Automatically fix problems that can be fixed
+- `--format <text|json>` - Output format (`text` default, `json` for machine-readable output)
 - `-v, --verbose` - Enable verbose logging for debugging
 - `-h, --help` - Show help message
 - `--version` - Show version number
@@ -81,8 +84,33 @@ tailwind-lint "**/*.vue" --fix
 
 # Lint with a specific CSS config (v4)
 tailwind-lint --config ./styles/app.css
+
+# Machine-readable output for LLMs/agents
+tailwind-lint --auto --format json
 ```
 
+## LLM / Agent Integration
+
+Use JSON output to avoid brittle text parsing:
+
+```bash
+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`)
+- `files[]` - per-file diagnostics with 1-based `line`/`column` ranges
+
+Typical agent flow:
+
+1. Run `tailwind-lint --auto --format json`.
+2. If `summary.errors > 0`, fail the check and surface diagnostics.
+3. If only warnings exist, optionally continue and open a cleanup task.
+4. Re-run with `--fix` when autofix is allowed.
+
 ## Configuration
 
 ### Tailwind CSS v4
@@ -93,7 +121,7 @@ Create a CSS config file (`app.css`, `index.css`, or `tailwind.css`):
 @import "tailwindcss";
 
 @theme {
-  --color-primary: #3b82f6;
+	--color-primary: #3b82f6;
 }
 
 @source "./src/**/*.{js,jsx,ts,tsx,html}";
@@ -108,12 +136,12 @@ Create a JavaScript config file (`tailwind.config.js`):
 ```javascript
 /** @type {import('tailwindcss').Config} */
 module.exports = {
-  content: ['./src/**/*.{js,jsx,ts,tsx}'],
-  theme: {
-    extend: {},
-  },
-  plugins: [],
-}
+	content: ["./src/**/*.{js,jsx,ts,tsx}"],
+	theme: {
+		extend: {},
+	},
+	plugins: [],
+};
 ```
 
 ## Autofix
@@ -128,6 +156,7 @@ Files are written atomically with multiple iterations to ensure all fixes are ap
 ## Features
 
 **Core (v3 & v4):**
+
 - CSS Conflicts - Detects when multiple classes apply the same CSS properties (e.g., `block flex`, `text-left text-center`) - **Note:** Works reliably in v4, limited support in v3 - no autofix
 - Invalid @apply Usage - Validates if a class can be used with `@apply`
 - Invalid @screen References - Detects references to non-existent breakpoints
@@ -138,6 +167,7 @@ Files are written atomically with multiple iterations to ensure all fixes are ap
 - Autofix - Automatically fix issues with `--fix` flag
 
 **v4-Specific:**
+
 - Canonical Class Suggestions - Suggests shorthand equivalents for arbitrary values (e.g., `top-[60px]` → `top-15`)
 - Invalid @source Directives - Validates `@source` directive paths
 - Full theme loading - Automatically loads Tailwind's default theme
@@ -168,4 +198,25 @@ pnpm format
 
 # Check code without fixing
 pnpm lint
+
+# Preview next version locally (no publish)
+pnpm release:dry
 ```
+
+## Releases
+
+Releases are automated with Semantic Release on pushes to `main`.
+
+- Version bump is derived from Conventional Commits.
+- npm release and GitHub release are generated automatically.
+- npm publish uses npm Trusted Publishing (OIDC), no `NPM_TOKEN` required.
+
+Commit examples:
+
+- `feat: add json output mode` -> minor release
+- `fix: resolve v4 config discovery in monorepos` -> patch release
+- `feat: drop Node 20 support` + commit body `BREAKING CHANGE: Node 20 is no longer supported` -> major release
+- `perf: speed up config discovery` -> patch release
+- `docs: update readme` -> no release
+
+`pnpm release:dry` runs against the local repo metadata (`--repository-url .`) so it does not require GitHub remote access.

package/dist/cli.cjs

@@ -1,27 +1,85 @@
 #!/usr/bin/env node
-const require_linter = require('./linter-DVb9soAi.cjs');
+const require_state = require('./state-QQi4_-5a.cjs');
+const require_linter = require('./linter.cjs');
 let node_path = require("node:path");
-node_path = require_linter.__toESM(node_path);
+node_path = require_state.__toESM(node_path);
 let chalk = require("chalk");
-chalk = require_linter.__toESM(chalk);
+chalk = require_state.__toESM(chalk);
 let node_fs = require("node:fs");
-node_fs = require_linter.__toESM(node_fs);
+node_fs = require_state.__toESM(node_fs);
 let commander = require("commander");
 
-//#region src/cli.ts
-const MAX_FILENAME_DISPLAY_LENGTH = 50;
-function countDiagnosticsBySeverity(diagnostics) {
+//#region src/output.ts
+function countBySeverity(diagnostics) {
 	let errors = 0;
 	let warnings = 0;
 	for (const diagnostic of diagnostics) {
-		if (diagnostic.severity === require_linter.SEVERITY.ERROR) errors++;
-		if (diagnostic.severity === require_linter.SEVERITY.WARNING) warnings++;
+		if (diagnostic.severity === require_state.SEVERITY.ERROR) errors++;
+		if (diagnostic.severity === require_state.SEVERITY.WARNING) warnings++;
 	}
 	return {
 		errors,
 		warnings
 	};
 }
+function toJsonSeverity(severity) {
+	if (severity === require_state.SEVERITY.ERROR) return "error";
+	if (severity === require_state.SEVERITY.WARNING) return "warning";
+	return "info";
+}
+function toJsonDiagnostic(diagnostic) {
+	return {
+		line: diagnostic.range.start.line + 1,
+		column: diagnostic.range.start.character + 1,
+		endLine: diagnostic.range.end.line + 1,
+		endColumn: diagnostic.range.end.character + 1,
+		severity: toJsonSeverity(diagnostic.severity),
+		code: diagnostic.code ?? null,
+		message: diagnostic.message,
+		source: diagnostic.source
+	};
+}
+function createJsonOutput({ files, totalFilesProcessed, cwd, configPath, autoDiscover, fix, patterns }) {
+	let errors = 0;
+	let warnings = 0;
+	let fixed = 0;
+	let filesWithIssues = 0;
+	const mappedFiles = files.map((file) => {
+		const severityCount = countBySeverity(file.diagnostics);
+		errors += severityCount.errors;
+		warnings += severityCount.warnings;
+		fixed += file.fixedCount || 0;
+		if (file.diagnostics.length > 0) filesWithIssues++;
+		return {
+			path: file.path,
+			fixed: file.fixed || false,
+			fixedCount: file.fixedCount || 0,
+			diagnostics: file.diagnostics.map(toJsonDiagnostic)
+		};
+	});
+	return {
+		ok: errors === 0,
+		summary: {
+			errors,
+			warnings,
+			fixed,
+			filesWithIssues,
+			totalFilesProcessed
+		},
+		config: {
+			cwd,
+			configPath: configPath || null,
+			autoDiscover,
+			fix,
+			patterns
+		},
+		files: mappedFiles
+	};
+}
+
+//#endregion
+//#region src/cli.ts
+const MAX_FILENAME_DISPLAY_LENGTH = 50;
 function resolveOptions(files, options) {
 	const hasConfigFlag = !!options.config;
 	const hasAutoFlag = !!options.auto;
@@ -33,7 +91,7 @@ function resolveOptions(files, options) {
 		const absoluteConfigPath = node_path.isAbsolute(options.config) ? options.config : node_path.resolve(process.cwd(), options.config);
 		cwd = node_path.dirname(absoluteConfigPath);
 		configPath = node_path.basename(absoluteConfigPath);
-		patterns = [require_linter.DEFAULT_FILE_PATTERN];
+		patterns = [require_state.DEFAULT_FILE_PATTERN];
 	}
 	const autoDiscover = hasAutoFlag;
 	return {
@@ -65,15 +123,15 @@ async function displayResults(files, fixMode) {
 			console.log(chalk.default.green(`  ✔ Fixed ${issueText}`));
 			totalFixed += file.fixedCount || 0;
 		}
-		const { errors, warnings } = countDiagnosticsBySeverity(file.diagnostics);
+		const { errors, warnings } = countBySeverity(file.diagnostics);
 		totalErrors += errors;
 		totalWarnings += warnings;
 		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 ? chalk.default.red(severity) : chalk.default.yellow(severity);
+			const severity = diagnostic.severity === require_state.SEVERITY.ERROR ? "error" : "warning";
+			const severityColor = diagnostic.severity === require_state.SEVERITY.ERROR ? chalk.default.red(severity) : chalk.default.yellow(severity);
 			const code = diagnostic.code ? chalk.default.dim(`  (${diagnostic.code})`) : "";
 			console.log(`  ${chalk.default.dim(`${line}:${char}`)}  ${severityColor}  ${diagnostic.message}${code}`);
 		}
@@ -100,9 +158,9 @@ const program = new commander.Command();
 const getVersion = () => {
 	const packageJsonPath = node_path.join(__dirname, "../package.json");
 	try {
-		return JSON.parse(node_fs.readFileSync(packageJsonPath, "utf-8")).version || require_linter.DEFAULT_VERSION;
+		return JSON.parse(node_fs.readFileSync(packageJsonPath, "utf-8")).version || require_state.DEFAULT_VERSION;
 	} catch {
-		return require_linter.DEFAULT_VERSION;
+		return require_state.DEFAULT_VERSION;
 	}
 };
 program.configureHelp({ formatHelp: (cmd, helper) => {
@@ -131,7 +189,7 @@ 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 content patterns").option("--fix", "Automatically fix problems that can be fixed").option("-v, --verbose", "Enable verbose logging for debugging").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 content 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", `
 ${chalk.default.bold.cyan("Examples:")}
   ${chalk.default.dim("$")} tailwind-lint
   ${chalk.default.dim("$")} tailwind-lint ${chalk.default.green("\"src/**/*.{js,jsx,ts,tsx}\"")}
@@ -150,8 +208,9 @@ ${chalk.default.bold.cyan("Notes:")}
 	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";
 	try {
-		if (resolved.verbose) {
+		if (resolved.verbose && !isJsonOutput) {
 			console.log(chalk.default.cyan.bold("→ Configuration"));
 			console.log(chalk.default.dim(`  Working directory: ${resolved.cwd}`));
 			console.log(chalk.default.dim(`  Config path: ${resolved.configPath || "auto-discover"}`));
@@ -162,29 +221,51 @@ ${chalk.default.bold.cyan("Notes:")}
 		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${chalk.default.cyan("→")} Linting files... ${chalk.default.dim(`(${current}/${total})`)} ${chalk.default.dim(displayFile)}${" ".repeat(require_linter.TERMINAL_PADDING)}`);
+					process.stdout.write(`\r${chalk.default.cyan("→")} Linting files... ${chalk.default.dim(`(${current}/${total})`)} ${chalk.default.dim(displayFile)}${" ".repeat(require_state.TERMINAL_PADDING)}`);
 				} else if (resolved.verbose) console.log(chalk.default.dim(`  [${current}/${total}] Linting ${file}`));
 			}
 		});
-		if (process.stdout.isTTY && !resolved.verbose) process.stdout.write(`\r${" ".repeat(require_linter.TERMINAL_WIDTH)}\r`);
+		if (process.stdout.isTTY && !resolved.verbose && !isJsonOutput) process.stdout.write(`\r${" ".repeat(require_state.TERMINAL_WIDTH)}\r`);
 		if (results.totalFilesProcessed === 0) {
-			console.log();
-			console.log(chalk.default.yellow("⚠ No files found to lint"));
+			if (isJsonOutput) console.log(JSON.stringify(createJsonOutput({
+				...resolved,
+				files: [],
+				totalFilesProcessed: 0
+			})));
+			else {
+				console.log();
+				console.log(chalk.default.yellow("⚠ No files found to lint"));
+			}
 			process.exit(0);
 		}
 		if (results.files.length === 0) {
-			console.log(chalk.default.green.bold("✔ No issues found"));
+			if (isJsonOutput) console.log(JSON.stringify(createJsonOutput({
+				...resolved,
+				files: [],
+				totalFilesProcessed: results.totalFilesProcessed
+			})));
+			else console.log(chalk.default.green.bold("✔ No issues found"));
 			process.exit(0);
 		}
-		await displayResults(results.files, resolved.fix);
-		const hasErrors = results.files.some((file) => file.diagnostics.some((d) => d.severity === require_linter.SEVERITY.ERROR));
+		if (isJsonOutput) console.log(JSON.stringify(createJsonOutput({
+			...resolved,
+			files: results.files,
+			totalFilesProcessed: results.totalFilesProcessed
+		})));
+		else await displayResults(results.files, resolved.fix);
+		const hasErrors = results.files.some((file) => file.diagnostics.some((d) => d.severity === require_state.SEVERITY.ERROR));
 		process.exit(hasErrors ? 1 : 0);
 	} catch (error) {
 		const errorMessage = error instanceof Error ? error.message : String(error);
-		console.error(chalk.default.red("✖ Error:"), errorMessage);
-		if (resolved.verbose && error instanceof Error) {
+		if (isJsonOutput) console.log(JSON.stringify({
+			ok: false,
+			error: errorMessage
+		}));
+		else console.error(chalk.default.red("✖ Error:"), errorMessage);
+		if (resolved.verbose && error instanceof Error && !isJsonOutput) {
 			console.error(chalk.default.dim("\nStack trace:"));
 			console.error(chalk.default.dim(error.stack || error.toString()));
 		}

package/dist/linter.cjs

@@ -1,3 +1,169 @@
-const require_linter = require('./linter-DVb9soAi.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_state = require('./state-QQi4_-5a.cjs');
+let node_path = require("node:path");
+node_path = require_state.__toESM(node_path);
+let _tailwindcss_language_service = require("@tailwindcss/language-service");
+let chalk = require("chalk");
+chalk = require_state.__toESM(chalk);
+let fast_glob = require("fast-glob");
+fast_glob = require_state.__toESM(fast_glob);
+let vscode_languageserver_textdocument = require("vscode-languageserver-textdocument");
 
-exports.lint = require_linter.lint;
+//#region src/linter.ts
+async function validateDocument(state, filePath, content) {
+	try {
+		if (!state) throw new Error("State is not initialized");
+		if (state.v4 && !state.designSystem) throw new Error("Design system not initialized for Tailwind v4. This might indicate a configuration issue.");
+		if (!state.v4 && !state.modules?.tailwindcss) throw new Error("Tailwind modules not initialized for Tailwind v3. This might indicate a configuration issue.");
+		const languageId = require_state.getLanguageId(filePath);
+		const uri = `file://${filePath}`;
+		return await (0, _tailwindcss_language_service.doValidate)(state, vscode_languageserver_textdocument.TextDocument.create(uri, languageId, 1, content));
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		if (message.includes("Cannot read") || message.includes("undefined")) {
+			if (process.env.DEBUG) console.error(`Debug: Language service error for ${filePath}:`, error);
+			console.warn(`Warning: Language service crashed while validating ${filePath}. Skipping this file.`);
+			return [];
+		}
+		throw new Error(`Failed to validate document ${filePath}: ${message}`);
+	}
+}
+async function discoverFiles(cwd, patterns, configPath, autoDiscover) {
+	if (autoDiscover) return discoverFilesFromConfig(cwd, configPath);
+	return expandPatterns(cwd, patterns);
+}
+async function expandPatterns(cwd, patterns, extraIgnore = []) {
+	const files = await (0, fast_glob.default)(patterns, {
+		cwd,
+		absolute: false,
+		ignore: [...require_state.DEFAULT_IGNORE_PATTERNS, ...extraIgnore]
+	});
+	return [...new Set(files)].sort((a, b) => a.localeCompare(b));
+}
+async function discoverFilesFromConfig(cwd, configPath) {
+	const configFilePath = await require_state.findTailwindConfigPath(cwd, configPath);
+	if (!configFilePath) throw new Error("Could not find Tailwind config for auto-discovery.\nUse --config to specify the path, or provide file patterns directly.");
+	if (!require_state.isCssConfigFile(configFilePath)) {
+		const config = await require_state.loadTailwindConfig(configFilePath);
+		if (!config || !config.content) throw new Error("Tailwind config is missing the 'content' property.\nAdd a content array to specify which files to scan:\n  content: ['./src/**/*.{js,jsx,ts,tsx}']");
+		const patterns = extractContentPatterns(config);
+		if (patterns.length === 0) throw new Error("No content patterns found in Tailwind config.\nEnsure your config has a content array with file patterns.");
+		return expandPatterns(cwd, patterns);
+	}
+	const configDir = node_path.dirname(configFilePath);
+	const cssContent = require_state.readFileSync(configFilePath);
+	const { include, exclude } = extractSourcePatterns(cssContent);
+	const importSource = extractImportSourceDirectives(cssContent);
+	const resolveFromConfig = (pattern) => {
+		const absolutePattern = node_path.resolve(configDir, pattern);
+		return node_path.relative(cwd, absolutePattern);
+	};
+	const resolvedExclude = exclude.map(resolveFromConfig);
+	const gitignorePatterns = require_state.readGitignorePatterns(cwd);
+	const extraIgnore = [...resolvedExclude, ...gitignorePatterns];
+	if (include.length > 0) return expandPatterns(cwd, include.map(resolveFromConfig), extraIgnore);
+	if (importSource.roots.length > 0) return expandPatterns(cwd, importSource.roots.map((root) => resolveFromConfig(node_path.join(root, "**/*.{js,jsx,ts,tsx,html,vue,svelte,astro,mdx}"))), extraIgnore);
+	if (importSource.disableAutoSource) return [];
+	return expandPatterns(cwd, [require_state.DEFAULT_FILE_PATTERN], extraIgnore);
+}
+function extractContentPatterns(config) {
+	if (!config.content) return [];
+	return (Array.isArray(config.content) ? config.content : config.content.files || []).filter((p) => typeof p === "string");
+}
+function extractSourcePatterns(cssContent) {
+	const include = [];
+	const exclude = [];
+	for (const match of cssContent.matchAll(/@source\s+(not\s+)?(?:inline\(|["']([^"']+)["'])/g)) {
+		const isNot = !!match[1];
+		const filePath = match[2];
+		if (!filePath) continue;
+		if (isNot) exclude.push(filePath);
+		else include.push(filePath);
+	}
+	return {
+		include,
+		exclude
+	};
+}
+function extractImportSourceDirectives(cssContent) {
+	const roots = [];
+	let disableAutoSource = false;
+	for (const match of cssContent.matchAll(/@import\s+["']tailwindcss(?:[^;]*?)\ssource\(\s*(none|["'][^"']+["'])\s*\)/g)) {
+		const raw = match[1];
+		if (!raw) continue;
+		if (raw === "none") {
+			disableAutoSource = true;
+			continue;
+		}
+		const sourceRoot = raw.slice(1, -1).trim();
+		if (sourceRoot.length > 0) roots.push(sourceRoot);
+	}
+	return {
+		roots: [...new Set(roots)],
+		disableAutoSource
+	};
+}
+async function processFiles(state, cwd, files, fix, onProgress) {
+	const results = [];
+	for (let i = 0; i < files.length; i += require_state.CONCURRENT_FILES) {
+		const batch = files.slice(i, i + require_state.CONCURRENT_FILES);
+		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));
+	}
+	return results;
+}
+async function processFile(state, cwd, filePath, fix) {
+	const absolutePath = node_path.isAbsolute(filePath) ? filePath : node_path.resolve(cwd, filePath);
+	if (!require_state.fileExists(absolutePath)) return null;
+	const content = require_state.readFileSync(absolutePath);
+	let diagnostics = await validateDocument(state, absolutePath, content);
+	let fixedCount = 0;
+	if (fix && diagnostics.length > 0) {
+		const fixResult = await require_state.applyCodeActions(state, absolutePath, content, diagnostics);
+		if (fixResult.changed) {
+			require_state.writeFileSync(absolutePath, fixResult.content);
+			fixedCount = fixResult.fixedCount;
+			diagnostics = await validateDocument(state, absolutePath, fixResult.content);
+		}
+	}
+	return {
+		path: node_path.relative(cwd, absolutePath),
+		diagnostics,
+		fixed: fixedCount > 0,
+		fixedCount
+	};
+}
+async function initializeState(cwd, configPath, verbose = false) {
+	try {
+		const state = await require_state.createState(cwd, configPath, verbose);
+		if (verbose) console.log();
+		return state;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Failed to initialize Tailwind state: ${message}`);
+	}
+}
+async function lint({ cwd, patterns, configPath, autoDiscover, fix = false, verbose = false, onProgress }) {
+	const state = await initializeState(cwd, configPath, verbose);
+	const files = await discoverFiles(cwd, patterns, configPath, autoDiscover);
+	if (verbose) {
+		console.log(chalk.default.cyan.bold(`→ Discovered ${files.length} file${files.length !== 1 ? "s" : ""} to lint`));
+		console.log();
+	}
+	if (files.length === 0) return {
+		files: [],
+		totalFilesProcessed: 0
+	};
+	return {
+		files: (await processFiles(state, cwd, files, fix, onProgress)).filter((result) => result.diagnostics.length > 0 || result.fixed),
+		totalFilesProcessed: files.length
+	};
+}
+
+//#endregion
+exports.extractImportSourceDirectives = extractImportSourceDirectives;
+exports.extractSourcePatterns = extractSourcePatterns;
+exports.lint = lint;

package/dist/linter.d.cts

@@ -22,6 +22,14 @@ interface LintResult {
 }
 //#endregion
 //#region src/linter.d.ts
+declare function extractSourcePatterns(cssContent: string): {
+  include: string[];
+  exclude: string[];
+};
+declare function extractImportSourceDirectives(cssContent: string): {
+  roots: string[];
+  disableAutoSource: boolean;
+};
 declare function lint({
   cwd,
   patterns,
@@ -32,4 +40,4 @@ declare function lint({
   onProgress
 }: LintOptions): Promise<LintResult>;
 //#endregion
-export { type LintFileResult, type LintOptions, type LintResult, lint };
+export { type LintFileResult, type LintOptions, type LintResult, extractImportSourceDirectives, extractSourcePatterns, lint };

package/dist/{linter-DVb9soAi.cjs → state-QQi4_-5a.cjs}

@@ -1,4 +1,4 @@
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -68,11 +68,13 @@ const V4_CSS_NAMES = [
 	"global.css",
 	"styles.css",
 	"style.css",
-	"main.css"
+	"main.css",
+	"input.css"
 ];
 const V4_CSS_FOLDERS = [
 	"./",
 	"./src/",
+	"./src/app/",
 	"./src/css/",
 	"./src/style/",
 	"./src/styles/",
@@ -80,9 +82,12 @@ const V4_CSS_FOLDERS = [
 	"./app/css/",
 	"./app/style/",
 	"./app/styles/",
+	"./app/assets/css/",
 	"./css/",
 	"./style/",
-	"./styles/"
+	"./styles/",
+	"./assets/css/",
+	"./resources/css/"
 ];
 const LANGUAGE_MAP = {
 	".astro": "astro",
@@ -118,6 +123,7 @@ const TERMINAL_WIDTH = 80;
 const TERMINAL_PADDING = 10;
 const MAX_FIX_ITERATIONS = 100;
 const QUICKFIX_ACTION_KIND = "quickfix";
+const TAILWIND_V4_IMPORT_REGEX = /@import\s+["']tailwindcss(?:["'\s/]|$)/;
 function getLanguageId(filePath) {
 	return LANGUAGE_MAP[filePath.substring(filePath.lastIndexOf(".")).toLowerCase()] || "html";
 }
@@ -386,6 +392,19 @@ function writeFileSync(filePath, content) {
 	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 [];
+	try {
+		return node_fs.readFileSync(gitignorePath, "utf-8").split("\n").map((line) => line.trim()).filter((line) => line && !line.startsWith("#") && !line.startsWith("!")).map((pattern) => {
+			const cleaned = pattern.replace(/\/+$/, "");
+			if (cleaned.includes("/") || cleaned.includes("*")) return cleaned.endsWith("/**") ? cleaned : `${cleaned}/**`;
+			return `**/${cleaned}/**`;
+		});
+	} catch {
+		return [];
+	}
+}
 
 //#endregion
 //#region src/adapters/v4-adapter.ts
@@ -466,6 +485,7 @@ async function loadV4DesignSystem(state, cwd, configPath, verbose = false) {
 //#endregion
 //#region src/utils/config.ts
 const require$2 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href || __filename);
+const CONFIG_DISCOVERY_MAX_DEPTH = 8;
 const isCssConfigFile = (filePath) => filePath.endsWith(".css");
 async function loadTailwindConfig(configPath) {
 	if (isCssConfigFile(configPath)) return {};
@@ -492,16 +512,67 @@ async function findTailwindConfigPath(cwd, configPath) {
 		const fullPath = node_path.join(cwd, p);
 		if (fileExists(fullPath)) return fullPath;
 	}
+	const v3Recursive = await (0, fast_glob.default)(V3_CONFIG_PATHS.map((p) => `**/${p}`), {
+		cwd,
+		absolute: true,
+		ignore: DEFAULT_IGNORE_PATTERNS,
+		deep: CONFIG_DISCOVERY_MAX_DEPTH
+	});
+	if (v3Recursive.length > 0) return sortByPathDepth(v3Recursive)[0];
 	const v4Paths = V4_CSS_FOLDERS.flatMap((folder) => V4_CSS_NAMES.map((name) => node_path.join(folder, name)));
 	for (const p of v4Paths) {
 		const fullPath = node_path.join(cwd, p);
 		if (fileExists(fullPath)) try {
 			const content = readFileSync(fullPath);
-			if (content.includes("@import \"tailwindcss\"") || content.includes("@import 'tailwindcss'")) return fullPath;
+			if (TAILWIND_V4_IMPORT_REGEX.test(content)) return fullPath;
 		} catch {}
 	}
+	const cssCandidates = await (0, fast_glob.default)("**/*.css", {
+		cwd,
+		absolute: true,
+		ignore: DEFAULT_IGNORE_PATTERNS,
+		deep: CONFIG_DISCOVERY_MAX_DEPTH
+	});
+	const v4Matches = [];
+	for (const candidate of cssCandidates) try {
+		const content = readFileSync(candidate);
+		if (TAILWIND_V4_IMPORT_REGEX.test(content)) v4Matches.push(candidate);
+	} catch {}
+	if (v4Matches.length > 0) return sortCssCandidates(cwd, v4Matches)[0];
 	return null;
 }
+function sortByPathDepth(paths) {
+	return [...paths].sort((a, b) => {
+		const depthA = splitDepth(a);
+		const depthB = splitDepth(b);
+		if (depthA !== depthB) return depthA - depthB;
+		return a.localeCompare(b);
+	});
+}
+function sortCssCandidates(cwd, paths) {
+	return [...paths].sort((a, b) => {
+		const scoreA = cssCandidateScore(cwd, a);
+		const scoreB = cssCandidateScore(cwd, b);
+		if (scoreA !== scoreB) return scoreA - scoreB;
+		return a.localeCompare(b);
+	});
+}
+function cssCandidateScore(cwd, candidate) {
+	const normalized = node_path.relative(cwd, candidate).split(node_path.sep).join("/");
+	const base = node_path.basename(candidate);
+	const depth = splitDepth(normalized);
+	const nameScore = V4_CSS_NAMES.includes(base) ? 0 : 20;
+	const folderScore = isPreferredCssFolder(normalized) ? 0 : 10;
+	return depth * 100 + nameScore + folderScore;
+}
+function isPreferredCssFolder(relativePath) {
+	const folder = node_path.dirname(relativePath).replace(/\\/g, "/");
+	const withSlash = folder === "." ? "./" : `./${folder}/`;
+	return V4_CSS_FOLDERS.includes(withSlash);
+}
+function splitDepth(value) {
+	return value.split(/[\\/]/).filter(Boolean).length;
+}
 
 //#endregion
 //#region src/state.ts
@@ -571,130 +642,24 @@ async function createState(cwd, configPath, verbose = false) {
 }
 
 //#endregion
-//#region src/linter.ts
-async function validateDocument(state, filePath, content) {
-	try {
-		if (!state) throw new Error("State is not initialized");
-		if (state.v4 && !state.designSystem) throw new Error("Design system not initialized for Tailwind v4. This might indicate a configuration issue.");
-		if (!state.v4 && !state.modules?.tailwindcss) throw new Error("Tailwind modules not initialized for Tailwind v3. This might indicate a configuration issue.");
-		const languageId = getLanguageId(filePath);
-		const uri = `file://${filePath}`;
-		return await (0, _tailwindcss_language_service.doValidate)(state, vscode_languageserver_textdocument.TextDocument.create(uri, languageId, 1, content));
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		if (message.includes("Cannot read") || message.includes("undefined")) {
-			if (process.env.DEBUG) console.error(`Debug: Language service error for ${filePath}:`, error);
-			console.warn(`Warning: Language service crashed while validating ${filePath}. Skipping this file.`);
-			return [];
-		}
-		throw new Error(`Failed to validate document ${filePath}: ${message}`);
-	}
-}
-async function discoverFiles(cwd, patterns, configPath, autoDiscover) {
-	if (autoDiscover) return discoverFilesFromConfig(cwd, configPath);
-	return expandPatterns(cwd, patterns);
-}
-async function expandPatterns(cwd, patterns) {
-	return (0, fast_glob.default)(patterns, {
-		cwd,
-		absolute: false,
-		ignore: DEFAULT_IGNORE_PATTERNS
-	});
-}
-async function discoverFilesFromConfig(cwd, configPath) {
-	const configFilePath = await findTailwindConfigPath(cwd, configPath);
-	if (!configFilePath) throw new Error("Could not find Tailwind config for auto-discovery.\nUse --config to specify the path, or provide file patterns directly.");
-	if (!isCssConfigFile(configFilePath)) {
-		const config = await loadTailwindConfig(configFilePath);
-		if (!config || !config.content) throw new Error("Tailwind config is missing the 'content' property.\nAdd a content array to specify which files to scan:\n  content: ['./src/**/*.{js,jsx,ts,tsx}']");
-		const patterns = extractContentPatterns(config);
-		if (patterns.length === 0) throw new Error("No content patterns found in Tailwind config.\nEnsure your config has a content array with file patterns.");
-		return expandPatterns(cwd, patterns);
-	}
-	const configDir = node_path.dirname(configFilePath);
-	const sourcePatterns = extractSourcePatterns(readFileSync(configFilePath));
-	if (sourcePatterns.length > 0) return expandPatterns(cwd, sourcePatterns.map((pattern) => {
-		const absolutePattern = node_path.resolve(configDir, pattern);
-		return node_path.relative(cwd, absolutePattern);
-	}));
-	return expandPatterns(cwd, [DEFAULT_FILE_PATTERN]);
-}
-function extractContentPatterns(config) {
-	if (!config.content) return [];
-	return (Array.isArray(config.content) ? config.content : config.content.files || []).filter((p) => typeof p === "string");
-}
-function extractSourcePatterns(cssContent) {
-	const patterns = [];
-	for (const match of cssContent.matchAll(/@source\s+["']([^"']+)["']/g)) patterns.push(match[1]);
-	return patterns;
-}
-async function processFiles(state, cwd, files, fix, onProgress) {
-	const results = [];
-	for (let i = 0; i < files.length; i += CONCURRENT_FILES) {
-		const batch = files.slice(i, i + CONCURRENT_FILES);
-		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));
-	}
-	return results;
-}
-async function processFile(state, cwd, filePath, fix) {
-	const absolutePath = node_path.isAbsolute(filePath) ? filePath : node_path.resolve(cwd, filePath);
-	if (!fileExists(absolutePath)) return null;
-	const content = readFileSync(absolutePath);
-	let diagnostics = await validateDocument(state, absolutePath, content);
-	let fixedCount = 0;
-	if (fix && diagnostics.length > 0) {
-		const fixResult = await applyCodeActions(state, absolutePath, content, diagnostics);
-		if (fixResult.changed) {
-			writeFileSync(absolutePath, fixResult.content);
-			fixedCount = fixResult.fixedCount;
-			diagnostics = await validateDocument(state, absolutePath, fixResult.content);
-		}
-	}
-	return {
-		path: node_path.relative(cwd, absolutePath),
-		diagnostics,
-		fixed: fixedCount > 0,
-		fixedCount
-	};
-}
-async function initializeState(cwd, configPath, verbose = false) {
-	try {
-		const state = await createState(cwd, configPath, verbose);
-		if (verbose) console.log();
-		return state;
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`Failed to initialize Tailwind state: ${message}`);
-	}
-}
-async function lint({ cwd, patterns, configPath, autoDiscover, fix = false, verbose = false, onProgress }) {
-	const state = await initializeState(cwd, configPath, verbose);
-	const files = await discoverFiles(cwd, patterns, configPath, autoDiscover);
-	if (verbose) {
-		console.log(chalk.default.cyan.bold(`→ Discovered ${files.length} file${files.length !== 1 ? "s" : ""} to lint`));
-		console.log();
-	}
-	if (files.length === 0) return {
-		files: [],
-		totalFilesProcessed: 0
-	};
-	return {
-		files: (await processFiles(state, cwd, files, fix, onProgress)).filter((result) => result.diagnostics.length > 0 || result.fixed),
-		totalFilesProcessed: files.length
-	};
-}
-
-//#endregion
+Object.defineProperty(exports, 'CONCURRENT_FILES', {
+  enumerable: true,
+  get: function () {
+    return CONCURRENT_FILES;
+  }
+});
 Object.defineProperty(exports, 'DEFAULT_FILE_PATTERN', {
   enumerable: true,
   get: function () {
     return DEFAULT_FILE_PATTERN;
   }
 });
+Object.defineProperty(exports, 'DEFAULT_IGNORE_PATTERNS', {
+  enumerable: true,
+  get: function () {
+    return DEFAULT_IGNORE_PATTERNS;
+  }
+});
 Object.defineProperty(exports, 'DEFAULT_VERSION', {
   enumerable: true,
   get: function () {
@@ -725,9 +690,63 @@ Object.defineProperty(exports, '__toESM', {
     return __toESM;
   }
 });
-Object.defineProperty(exports, 'lint', {
+Object.defineProperty(exports, 'applyCodeActions', {
+  enumerable: true,
+  get: function () {
+    return applyCodeActions;
+  }
+});
+Object.defineProperty(exports, 'createState', {
+  enumerable: true,
+  get: function () {
+    return createState;
+  }
+});
+Object.defineProperty(exports, 'fileExists', {
+  enumerable: true,
+  get: function () {
+    return fileExists;
+  }
+});
+Object.defineProperty(exports, 'findTailwindConfigPath', {
+  enumerable: true,
+  get: function () {
+    return findTailwindConfigPath;
+  }
+});
+Object.defineProperty(exports, 'getLanguageId', {
+  enumerable: true,
+  get: function () {
+    return getLanguageId;
+  }
+});
+Object.defineProperty(exports, 'isCssConfigFile', {
+  enumerable: true,
+  get: function () {
+    return isCssConfigFile;
+  }
+});
+Object.defineProperty(exports, 'loadTailwindConfig', {
+  enumerable: true,
+  get: function () {
+    return loadTailwindConfig;
+  }
+});
+Object.defineProperty(exports, 'readFileSync', {
+  enumerable: true,
+  get: function () {
+    return readFileSync;
+  }
+});
+Object.defineProperty(exports, 'readGitignorePatterns', {
+  enumerable: true,
+  get: function () {
+    return readGitignorePatterns;
+  }
+});
+Object.defineProperty(exports, 'writeFileSync', {
   enumerable: true,
   get: function () {
-    return lint;
+    return writeFileSync;
   }
 });

package/package.json

@@ -1,74 +1,81 @@
 {
-  "name": "tailwind-lint",
-  "version": "0.6.1",
-  "description": "A command-line tool that uses the Tailwind CSS IntelliSense plugin to show linting suggestions for your Tailwind CSS classes",
-  "keywords": [
-    "tailwindcss",
-    "tailwind",
-    "linter",
-    "lint",
-    "cli",
-    "diagnostics",
-    "intellisense",
-    "css",
-    "utility-first",
-    "code-quality"
-  ],
-  "homepage": "https://github.com/ph1p/tailwind-lint#readme",
-  "bugs": {
-    "url": "https://github.com/ph1p/tailwind-lint/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ph1p/tailwind-lint.git"
-  },
-  "funding": {
-    "type": "github",
-    "url": "https://github.com/sponsors/ph1p"
-  },
-  "license": "MIT",
-  "author": "Philip Stapelfeldt <me@ph1p.dev>",
-  "type": "module",
-  "bin": {
-    "tailwind-lint": "./dist/cli.cjs"
-  },
-  "types": "./dist/linter.d.ts",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@tailwindcss/language-service": "^0.14.29",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.2",
-    "fast-glob": "^3.3.3",
-    "postcss": "^8.5.6",
-    "vscode-languageserver-textdocument": "^1.0.12"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.3.13",
-    "@types/node": "^25.1.0",
-    "tsdown": "^0.20.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
-  },
-  "engines": {
-    "node": ">=22.0.0",
-    "pnpm": ">=10.0.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "format": "biome check --write",
-    "lint": "biome check",
-    "start": "node dist/cli.cjs",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest"
-  }
-}
+	"name": "tailwind-lint",
+	"version": "0.8.0",
+	"description": "A command-line tool that uses the Tailwind CSS IntelliSense plugin to show linting suggestions for your Tailwind CSS classes",
+	"keywords": [
+		"cli",
+		"code-quality",
+		"css",
+		"diagnostics",
+		"intellisense",
+		"lint",
+		"linter",
+		"tailwind",
+		"tailwindcss",
+		"utility-first"
+	],
+	"homepage": "https://github.com/ph1p/tailwind-lint#readme",
+	"bugs": {
+		"url": "https://github.com/ph1p/tailwind-lint/issues"
+	},
+	"license": "MIT",
+	"author": "Philip Stapelfeldt <me@ph1p.dev>",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/ph1p/tailwind-lint.git"
+	},
+	"funding": {
+		"type": "github",
+		"url": "https://github.com/sponsors/ph1p"
+	},
+	"bin": {
+		"tailwind-lint": "./dist/cli.cjs"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"type": "module",
+	"types": "./dist/linter.d.ts",
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"scripts": {
+		"build": "tsdown",
+		"dev": "tsdown --watch",
+		"format": "oxfmt --write .",
+		"format:check": "oxfmt --check .",
+		"lint": "oxlint .",
+		"lint:fix": "oxlint --fix .",
+		"prepublishOnly": "pnpm build && pnpm test",
+		"release": "pnpm dlx semantic-release",
+		"release:dry": "SEMREL_LOCAL=1 pnpm dlx semantic-release --dry-run --no-ci --repository-url .",
+		"start": "node dist/cli.cjs",
+		"test": "vitest run",
+		"test:coverage": "vitest run --coverage",
+		"test:watch": "vitest"
+	},
+	"dependencies": {
+		"@tailwindcss/language-service": "^0.14.29",
+		"chalk": "^5.6.2",
+		"commander": "^14.0.3",
+		"fast-glob": "^3.3.3",
+		"postcss": "^8.5.6",
+		"vscode-languageserver-textdocument": "^1.0.12"
+	},
+	"devDependencies": {
+		"@types/node": "^25.3.0",
+		"oxfmt": "^0.34.0",
+		"oxlint": "^1.49.0",
+		"tsdown": "^0.20.3",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.18"
+	},
+	"engines": {
+		"node": ">=22.0.0",
+		"pnpm": ">=10.0.0"
+	},
+	"packageManager": "pnpm@10.30.1"
+}