tw-migrate 0.3.0 → 0.4.0

package/README.md

@@ -47,6 +47,7 @@ node /path/to/tw-migrate/src/bin.ts
 - Vue `<style module>` blocks migrate against direct `:class="$style.x"` member bindings; any other `$style`/`useCssModule` appearance or a named module retains the block
 - direct CSS Module members, static template literals, and static expression literals
 - global `className` and `id` literals
+- React/Next.js `className` logical (`&&`, `||`, `??`) and conditional (`?:`) expressions: string and direct CSS Module member result leaves migrate without evaluating their conditions, `null`/`undefined`/`false`/empty-string results are warning-free, and unsupported result leaves retain with a warning while supported siblings still migrate
 - multi-compound CSS Module selectors whose element relationships are proven from the JSX graph
 - common state pseudo-classes, global arbitrary descendant variants, and conditional at-rules (`@media`, `@supports`, `@container`, `@starting-style`)
 - the tier-1 property mapping families with shorthand/longhand normalization
@@ -68,7 +69,7 @@ Everything outside this subset is retained and reported with one of the warning
 | `computed-css-module-reference`      | A computed CSS Module access cannot be verified, so the module is retained.                                            |
 | `cross-package-stylesheet-link`      | A linked stylesheet is owned by another package, so it is not analyzed outside workspace mode.                         |
 | `css-module-composes`                | The rule uses or is targeted by `composes`, so it is retained.                                                         |
-| `dynamic-class-name`                 | A `className` value is dynamic, so the element cannot be migrated.                                                     |
+| `dynamic-class-name`                 | A `className` value or expression result is dynamic, so that class site cannot be migrated.                            |
 | `dynamic-html-attribute`             | An HTML attribute is not a safely writable quoted literal, so the element cannot be migrated.                          |
 | `dynamic-template-class`             | A dynamic class binding makes a Vue template's class set unprovable, so its scoped rules are retained.                 |
 | `existing-tailwind-conflict`         | A generated utility may conflict with a Tailwind class already on the element.                                         |

package/dist/bin.js

@@ -4,7 +4,7 @@ import { styleText } from "node:util";
 //#region src/bin.ts
 const { version } = {
 	name: "tw-migrate",
-	version: "0.3.0",
+	version: "0.4.0",
 	description: "Preview and migrate React, Vue, and HTML CSS to Tailwind utilities",
 	keywords: [
 		"codemod",
@@ -33,7 +33,7 @@ const { version } = {
 	scripts: {
 		"build": "vp pack && napi build --manifest-path crates/tw_migrate/Cargo.toml --package-json-path package.json --output-dir . --platform --release --no-js --dts binding.d.ts",
 		"build:debug": "napi build --manifest-path crates/tw_migrate/Cargo.toml --package-json-path package.json --output-dir . --platform --no-js --dts binding.d.ts",
-		"artifacts": "napi artifacts --output-dir . --npm-dir npm",
+		"artifacts": "node -e \"const fs=require('node:fs'); const files=fs.readdirSync('.').filter((file)=>file.startsWith('tw-migrate.')&&file.endsWith('.node')); if(files.length===0) throw new Error('no tw-migrate.*.node artifact in the package root; run build first'); for(const file of files) fs.copyFileSync(file, 'npm/'+file.slice('tw-migrate.'.length, -'.node'.length)+'/'+file)\"",
 		"test": "cargo test && pnpm build:debug && vp test",
 		"test:ecosystem": "node ecosystem-ci/run.ts",
 		"typecheck": "tsc --noEmit",
@@ -41,7 +41,7 @@ const { version } = {
 		"test:snapshots": "pnpm snapshots:prepare && cargo test -p tw-migrate-snapshots",
 		"prepare": "vp config"
 	},
-	dependencies: { "parse5": "7.3.0" },
+	dependencies: { "parse5": "8.0.1" },
 	devDependencies: {
 		"@napi-rs/cli": "catalog:",
 		"@types/node": "catalog:",
@@ -74,8 +74,8 @@ const { version } = {
 			"x86_64-pc-windows-msvc"
 		]
 	},
-	engines: { "node": ">=22.18.0" },
-	packageManager: "pnpm@11.15.1"
+	engines: { "node": ">=22.23.2" },
+	packageManager: "pnpm@11.20.0"
 };
 const usage = "Usage: tw-migrate [style-file] [options]";
 const help = `${usage}
@@ -134,7 +134,10 @@ async function main() {
 		workspaces
 	});
 	if (report.diff) process.stdout.write(report.diff);
-	for (const warning of report.warnings) console.warn(styleText("yellow", `warning[${warning.code}] ${warning.file}:${warning.start}-${warning.end} ${warning.message}`, { stream: process.stderr }));
+	for (const warning of report.warnings) {
+		const location = warning.line ? `${warning.file}:${warning.line}:${warning.column}-${warning.endLine}:${warning.endColumn}` : warning.file;
+		console.warn(styleText("yellow", `warning[${warning.code}] ${location} ${warning.message}`, { stream: process.stderr }));
+	}
 	for (const failure of report.failures) console.warn(styleText("yellow", `skipped[${failure.package}] ${failure.message}`, { stream: process.stderr }));
 	console.log(`${write ? "Applied" : "Previewed"} ${report.changedFiles.length} file(s); ${report.convertedRules} rule(s) converted, ${report.retainedRules} retained.`);
 }

package/dist/index.d.ts

@@ -13,6 +13,11 @@ interface MigrationWarning {
   /** Byte offsets into the authored file, or (0, 0) when no unique mapping exists. */
   start: number;
   end: number;
+  /** 1-based UTF-16 positions, omitted when no unique authored mapping exists. */
+  line?: number;
+  column?: number;
+  endLine?: number;
+  endColumn?: number;
   message: string;
 }
 interface RuleReport {

package/dist/index.js

@@ -19,14 +19,13 @@ function unifiedDiff(path, before, after) {
 }
 //#endregion
 //#region src/parser/html.ts
-const RECOVERABLE_PARSE_ERRORS = /* @__PURE__ */ new Set(["missing-doctype"]);
 const TEMPLATE_MARKERS = /\{\{|\}\}|\$\{|<%|%>|<#|#>|\[%|%\]/;
 function parseHtmlSource(path, source) {
 	const errors = [];
 	const document = parse(source, {
 		sourceCodeLocationInfo: true,
 		onParseError(error) {
-			if (!RECOVERABLE_PARSE_ERRORS.has(error.code)) errors.push(error);
+			if (error.code !== "missing-doctype") errors.push(error);
 		}
 	});
 	if (errors.length > 0) throw new Error(`Failed to parse ${path}: ${errors.map((error) => error.code).join(", ")}`);
@@ -78,13 +77,16 @@ function parseHtmlSource(path, source) {
 				});
 				else if (classAttribute || idAttribute) {
 					if (!classAttribute && idAttribute) {
-						const insertion = classInsertionOffset$1(source, node.sourceCodeLocation?.startTag);
-						if (insertion !== void 0) classAttribute = {
-							value: "",
-							start: insertion,
-							end: insertion,
-							synthetic: true
-						};
+						const startTag = node.sourceCodeLocation?.startTag;
+						if (startTag && source[startTag.endOffset - 1] === ">") {
+							const insertion = classInsertionOffset(source, startTag.startOffset, startTag.endOffset - 1);
+							classAttribute = {
+								value: "",
+								start: insertion,
+								end: insertion,
+								synthetic: true
+							};
+						}
 					}
 					elements.push({
 						classAttribute,
@@ -159,12 +161,10 @@ function toByteOffsets(source, parsed) {
 		dynamicAttributes: parsed.dynamicAttributes.map((value) => attribute(value))
 	};
 }
-function classInsertionOffset$1(source, startTag) {
-	if (!startTag) return void 0;
-	let offset = startTag.endOffset - 1;
-	if (source[offset] !== ">") return void 0;
-	while (offset > startTag.startOffset && /\s/.test(source[offset - 1] ?? "")) offset -= 1;
+function classInsertionOffset(source, floor, tagEnd) {
+	let offset = tagEnd;
 	if (source[offset - 1] === "/") offset -= 1;
+	while (offset > floor && /\s/.test(source[offset - 1] ?? "")) offset -= 1;
 	return offset;
 }
 function stylesheetRel(value = "") {
@@ -240,11 +240,13 @@ async function loadProjectModule(packageRoot, name, errorMessage) {
 	const imported = await import(pathToFileURL(modulePath).href);
 	return imported.default ?? imported;
 }
+const missingCompilerMessage = (name) => `${name} must be installed in the target project.`;
+const MISSING_STYLE_COMPILER_MESSAGES = /* @__PURE__ */ new Set([missingCompilerMessage("Sass"), missingCompilerMessage("Less")]);
 function loadProjectSass(packageRoot) {
-	return loadProjectModule(packageRoot, "sass", "Sass must be installed in the target project.");
+	return loadProjectModule(packageRoot, "sass", missingCompilerMessage("Sass"));
 }
 function loadProjectLess(packageRoot) {
-	return loadProjectModule(packageRoot, "less", "Less must be installed in the target project.");
+	return loadProjectModule(packageRoot, "less", missingCompilerMessage("Less"));
 }
 async function compileStyleEntry(compilers, packageRoot, entryPath, source, options = {}) {
 	if (isSassPath(entryPath)) return compileSassEntry(compilers.sass ??= await loadProjectSass(packageRoot), entryPath, source, options);
@@ -356,6 +358,9 @@ const RECOVERABLE_INPUT_ERROR = "TW_MIGRATE_RECOVERABLE_INPUT:";
 function errorCode(error) {
 	return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0;
 }
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
 function isWithin(root, path) {
 	return path === root || path.startsWith(`${root}${sep}`);
 }
@@ -404,21 +409,20 @@ function recordSnapshot(snapshots, path, source) {
 	return source;
 }
 function packageFailure(workspaceRoot, packageRoot, error) {
-	const message = error instanceof Error ? error.message : String(error);
+	const message = errorMessage(error);
 	return {
 		package: normalizedRelativePath(workspaceRoot, packageRoot) || ".",
 		message: message.startsWith("TW_MIGRATE_RECOVERABLE_INPUT:") ? message.slice(29) : message
 	};
 }
 function isRecoverablePlanningError(error) {
-	return (error instanceof Error ? error.message : String(error)).startsWith(RECOVERABLE_INPUT_ERROR);
+	return errorMessage(error).startsWith(RECOVERABLE_INPUT_ERROR);
 }
 function isMissingStyleCompilerError(error) {
-	const message = error instanceof Error ? error.message : String(error);
-	return /^(?:Sass|Less) must be installed in the target project\.$/.test(message);
+	return MISSING_STYLE_COMPILER_MESSAGES.has(errorMessage(error));
 }
 function isIntegrityError(error) {
-	return (error instanceof Error ? error.message : String(error)).startsWith("Source changed during planning:");
+	return errorMessage(error).startsWith("Source changed during planning:");
 }
 function normalizedRelativePath(root, path) {
 	return relative(root, path).split(sep).join("/");
@@ -528,7 +532,7 @@ async function resolveScope(options) {
 	const currentPackage = await findPackageRoot(cwd);
 	const gitRoot = await findGitRoot(currentPackage);
 	const workspaceRoot = gitRoot && !await isIgnoredByGit(gitRoot, currentPackage) ? gitRoot : currentPackage;
-	const allPaths = await discoverFiles(workspaceRoot, workspaceRoot === gitRoot);
+	const allPaths = workspaceRoot === gitRoot ? await discoverGitFiles(workspaceRoot) : await collectFiles(workspaceRoot, isRelevantDiscoveredFile);
 	const scannedPaths = workspaceRoot === gitRoot ? [.../* @__PURE__ */ new Set([...allPaths, ...await collectFiles(workspaceRoot, isRelevantDiscoveredFile)])] : [...allPaths];
 	const explicitStyle = options.styleFile ? resolve(cwd, options.styleFile) : void 0;
 	const configuredEntry = options.tailwindCss ? resolve(cwd, options.tailwindCss) : void 0;
@@ -603,8 +607,7 @@ async function isIgnoredByGit(gitRoot, path) {
 		return false;
 	}
 }
-async function discoverFiles(root, useGit) {
-	if (!useGit) return collectFiles(root, isRelevantDiscoveredFile);
+async function discoverGitFiles(root) {
 	const { stdout } = await run("git", [
 		"ls-files",
 		"-co",
@@ -645,7 +648,6 @@ async function collectFiles(root, include) {
 	const files = [];
 	async function visit(directory) {
 		const entries = await readdir(directory, { withFileTypes: true });
-		entries.sort((left, right) => left.name.localeCompare(right.name));
 		for (const entry of entries) {
 			const path = join(directory, entry.name);
 			if (entry.isDirectory()) {
@@ -885,8 +887,30 @@ async function loadTailwind(packageRoot, tailwindCss, snapshots, workspaceRoot)
 	const { __unstable__loadDesignSystem: loadDesignSystem } = await loadProjectModule(packageRoot, "tailwindcss", "Tailwind v4 must be installed in the target project.");
 	const css = await snapshotFile(snapshots, tailwindCss);
 	const base = dirname(tailwindCss);
-	const loadModule = createModuleLoader(snapshots, workspaceRoot);
-	const loadStylesheet = createStylesheetLoader(projectRequire, packagePath, snapshots, workspaceRoot);
+	const tailwindRoot = dirname(packagePath);
+	const loadModule = async (id, moduleBase) => {
+		const path = createRequire(join(moduleBase, "package.json")).resolve(id);
+		if (isProjectInput(workspaceRoot, path)) await snapshotFile(snapshots, path);
+		const imported = await import(pathToFileURL(path).href);
+		return {
+			path,
+			base: dirname(path),
+			module: imported.default ?? imported
+		};
+	};
+	const loadStylesheet = async (id, sheetBase) => {
+		let path;
+		if (id === "tailwindcss") path = join(tailwindRoot, "index.css");
+		else if (id.startsWith("tailwindcss/")) {
+			const subpath = id.slice(12);
+			path = join(tailwindRoot, subpath.endsWith(".css") ? subpath : `${subpath}.css`);
+		} else if (id.startsWith(".") || isAbsolute(id)) path = resolve(sheetBase, id);
+		else path = projectRequire.resolve(id);
+		return {
+			content: isProjectInput(workspaceRoot, path) ? await snapshotFile(snapshots, path) : await readFile(path, "utf8"),
+			base: dirname(path)
+		};
+	};
 	const themeTokens = {
 		...extractThemeTokens(await readFile(join(dirname(packagePath), "theme.css"), "utf8")),
 		...await extractThemeTokensFromGraph(css, base, loadStylesheet)
@@ -922,34 +946,6 @@ function invalidCandidates(tailwind, candidates) {
 	const generated = tailwind.designSystem.candidatesToCss(candidates);
 	return candidates.filter((_, index) => generated[index] === null);
 }
-function createModuleLoader(snapshots, workspaceRoot) {
-	return async (id, base) => {
-		const path = createRequire(join(base, "package.json")).resolve(id);
-		if (isProjectInput(workspaceRoot, path)) await snapshotFile(snapshots, path);
-		const imported = await import(pathToFileURL(path).href);
-		return {
-			path,
-			base: dirname(path),
-			module: imported.default ?? imported
-		};
-	};
-}
-function createStylesheetLoader(projectRequire, tailwindPackagePath, snapshots, workspaceRoot) {
-	const tailwindRoot = dirname(tailwindPackagePath);
-	return async (id, base) => {
-		let path;
-		if (id === "tailwindcss") path = join(tailwindRoot, "index.css");
-		else if (id.startsWith("tailwindcss/")) {
-			const subpath = id.slice(12);
-			path = join(tailwindRoot, subpath.endsWith(".css") ? subpath : `${subpath}.css`);
-		} else if (id.startsWith(".") || isAbsolute(id)) path = resolve(base, id);
-		else path = projectRequire.resolve(id);
-		return {
-			content: isProjectInput(workspaceRoot, path) ? await snapshotFile(snapshots, path) : await readFile(path, "utf8"),
-			base: dirname(path)
-		};
-	};
-}
 //#endregion
 //#region src/parser/vue.ts
 const ESCAPE_SELECTOR = /(?:::v-|:)(?:deep|global|slotted)\(([^)]*)\)/g;
@@ -967,6 +963,13 @@ const SUPPORTED_STYLE_LANGUAGES = /* @__PURE__ */ new Set([
 	"sass",
 	"less"
 ]);
+const SUPPORTED_SCRIPT_LANGUAGES = /* @__PURE__ */ new Set([
+	void 0,
+	"js",
+	"jsx",
+	"ts",
+	"tsx"
+]);
 const NODE_ELEMENT = 1;
 const NODE_TEXT = 2;
 const NODE_INTERPOLATION = 5;
@@ -997,29 +1000,48 @@ function analyzeVueSource(compiler, path, source) {
 		message
 	});
 	const { descriptor, errors } = compiler.parse(source, { filename: path });
+	const styleRanges = descriptor.styles.map((style) => ({
+		start: style.loc.start.offset,
+		end: style.loc.end.offset
+	}));
+	const byteRanges = (offset) => ({
+		warnings: warnings.map((warning) => ({
+			...warning,
+			start: offset(warning.start),
+			end: offset(warning.end)
+		})),
+		styleRanges: styleRanges.map((range) => ({
+			start: offset(range.start),
+			end: offset(range.end)
+		}))
+	});
+	const retained = () => {
+		const offsets = utf8OffsetMap(source, [...warnings, ...styleRanges].flatMap((range) => [range.start, range.end]));
+		return {
+			retained: true,
+			...byteRanges(offsetLookup(offsets))
+		};
+	};
 	if (errors.length > 0) {
 		const offset = errors[0]?.loc?.start?.offset ?? 0;
 		warn("unsupported-sfc-block", offset, offset, `The SFC could not be parsed: ${errors[0].message}`);
-		return {
-			warnings: toByteWarnings(source, warnings),
-			retained: true
-		};
+		if (errors[0]?.loc?.start?.offset === 0) Object.assign(warnings[0], {
+			line: 1,
+			column: 1,
+			endLine: 1,
+			endColumn: 1
+		});
+		return retained();
 	}
 	const template = descriptor.template;
 	if (!template || template.lang || template.src) {
 		warn("unsupported-sfc-block", 0, 0, !template ? "The SFC has no template block, so its class usage cannot be analyzed." : "Only the default template language with inline content is analyzed.");
-		return {
-			warnings: toByteWarnings(source, warnings),
-			retained: true
-		};
+		return retained();
 	}
 	if (descriptor.customBlocks.length > 0) {
 		const block = descriptor.customBlocks[0];
 		warn("unsupported-sfc-block", block.loc.start.offset, block.loc.end.offset, `The custom <${block.type}> block is not analyzed.`);
-		return {
-			warnings: toByteWarnings(source, warnings),
-			retained: true
-		};
+		return retained();
 	}
 	const blocks = [];
 	const unscopedBlocks = [];
@@ -1119,13 +1141,7 @@ function analyzeVueSource(compiler, path, source) {
 	let scriptImportsUnverifiable = false;
 	const styleImports = [descriptor.script, descriptor.scriptSetup].flatMap((script) => {
 		if (!script) return [];
-		if (script.src || ![
-			void 0,
-			"js",
-			"jsx",
-			"ts",
-			"tsx"
-		].includes(script.lang)) {
+		if (script.src || !SUPPORTED_SCRIPT_LANGUAGES.has(script.lang)) {
 			scriptImportsUnverifiable = true;
 			return [];
 		}
@@ -1137,19 +1153,14 @@ function analyzeVueSource(compiler, path, source) {
 		}
 	});
 	let componentImports = [];
-	if (descriptor.scriptSetup && !descriptor.scriptSetup.src && [
-		void 0,
-		"js",
-		"jsx",
-		"ts",
-		"tsx"
-	].includes(descriptor.scriptSetup.lang)) try {
+	if (descriptor.scriptSetup && !descriptor.scriptSetup.src && SUPPORTED_SCRIPT_LANGUAGES.has(descriptor.scriptSetup.lang)) try {
 		componentImports = staticImportBindings(`${path}.${descriptor.scriptSetup.lang ?? "js"}`, descriptor.scriptSetup.content);
 	} catch {
 		componentImports = [];
 	}
 	const offsets = utf8OffsetMap(source, [
 		...warnings.flatMap((warning) => [warning.start, warning.end]),
+		...styleRanges.flatMap((range) => [range.start, range.end]),
 		...[
 			...blocks,
 			...unscopedBlocks,
@@ -1194,11 +1205,7 @@ function analyzeVueSource(compiler, path, source) {
 		}
 	});
 	return {
-		warnings: warnings.map((warning) => ({
-			...warning,
-			start: offset(warning.start),
-			end: offset(warning.end)
-		})),
+		...byteRanges(offset),
 		blocks: blocks.map(toByteBlock),
 		unscopedBlocks: unscopedBlocks.map(toByteBlock),
 		moduleBlocks: moduleBlocks.map(toByteBlock),
@@ -1309,7 +1316,7 @@ function templateSite(source, node, bindingClasses, classOpaque, state) {
 	}
 	const matchClasses = bindingClasses.length ? [...classAttribute?.value.split(/[\t\n\f\r ]+/).filter(Boolean) ?? [], ...bindingClasses] : void 0;
 	if (!classAttribute && (bindingClasses.length > 0 || !classOpaque && (node.tagType === TAG_COMPONENT || idAttribute))) {
-		const insertion = classInsertionOffset(source, node);
+		const insertion = nodeClassInsertionOffset(source, node);
 		if (insertion === void 0) state.dynamic = true;
 		else classAttribute = {
 			value: "",
@@ -1340,22 +1347,11 @@ function literalAttribute(source, node, name) {
 		end: end - 1
 	};
 }
-function classInsertionOffset(source, node) {
+function nodeClassInsertionOffset(source, node) {
 	const propsEnd = Math.max(node.loc.start.offset + 1 + node.tag.length, ...(node.props ?? []).map((prop) => prop.loc.end.offset));
 	const tagEnd = source.indexOf(">", propsEnd);
 	if (tagEnd < 0) return void 0;
-	let offset = tagEnd;
-	if (source[offset - 1] === "/") offset -= 1;
-	while (offset > node.loc.start.offset && /\s/.test(source[offset - 1])) offset -= 1;
-	return offset;
-}
-function toByteWarnings(source, warnings) {
-	const offsets = utf8OffsetMap(source, warnings.flatMap((warning) => [warning.start, warning.end]));
-	return warnings.map((warning) => ({
-		...warning,
-		start: offsets.get(warning.start) ?? warning.start,
-		end: offsets.get(warning.end) ?? warning.end
-	}));
+	return classInsertionOffset(source, node.loc.start.offset, tagEnd);
 }
 //#endregion
 //#region src/plan/vue.ts
@@ -1473,6 +1469,7 @@ async function preparePackageVue({ packageRoot, styleCompilers, sourceFiles, sty
 	const none = {
 		files: /* @__PURE__ */ new Map(),
 		stylesheets: [],
+		styleRanges: /* @__PURE__ */ new Map(),
 		stylePaths: /* @__PURE__ */ new Set(),
 		unscopedPaths: /* @__PURE__ */ new Set(),
 		warnings: [],
@@ -1768,6 +1765,7 @@ async function preparePackageVue({ packageRoot, styleCompilers, sourceFiles, sty
 	return {
 		files,
 		stylesheets,
+		styleRanges: new Map([...analyses].map(([path, analysis]) => [path, analysis.styleRanges])),
 		stylePaths,
 		unscopedPaths,
 		warnings,
@@ -1783,7 +1781,7 @@ async function verifySnapshots(snapshots) {
 		const read = reads[index];
 		if (read.status === "rejected") {
 			const error = read.reason;
-			const detail = errorCode(error) ?? (error instanceof Error ? error.message : String(error));
+			const detail = errorCode(error) ?? errorMessage(error);
 			throw new Error(`Source changed after planning: ${path} (${detail})`);
 		}
 		if (read.value !== before) throw new Error(`Source changed after planning: ${path}`);
@@ -1818,6 +1816,38 @@ async function writeChanges(changes, deletions) {
 }
 //#endregion
 //#region src/index.ts
+function indexWarningPositions(source, offsets, unicodeSeparatorsAreNewlines, formFeedIsNewline, initial = {
+	line: 1,
+	column: 1
+}) {
+	const targets = [...offsets].sort((left, right) => left - right);
+	const positions = /* @__PURE__ */ new Map();
+	let target = 0;
+	let byte = 0;
+	let { line, column } = initial;
+	let previousWasCarriageReturn = false;
+	const record = () => {
+		while (targets[target] === byte) {
+			positions.set(byte, {
+				line,
+				column
+			});
+			target += 1;
+		}
+	};
+	record();
+	for (const character of source) {
+		byte += Buffer.byteLength(character);
+		while ((targets[target] ?? Infinity) < byte) target += 1;
+		if (character === "\r" || character === "\n" && !previousWasCarriageReturn || unicodeSeparatorsAreNewlines && (character === "\u2028" || character === "\u2029") || formFeedIsNewline && character === "\f") {
+			line += 1;
+			column = 1;
+		} else if (character !== "\n") column += character.length;
+		previousWasCarriageReturn = character === "\r";
+		record();
+	}
+	return positions;
+}
 async function migrate(options = {}) {
 	if (options.styleFile && options.workspaces) throw new TypeError("styleFile cannot be combined with workspaces");
 	if (options.tailwindCss && options.workspaces) throw new TypeError("tailwindCss cannot be combined with workspaces");
@@ -1847,13 +1877,15 @@ async function migrate(options = {}) {
 	const sourceFiles = sourceCandidates.flatMap((file) => file ? [file] : []);
 	if (explicitStyle && isStylesheetPath(explicitStyle) && !styleSources.has(explicitStyle)) styleSources.set(explicitStyle, await snapshotFile(snapshots, explicitStyle));
 	if (configuredEntry && !styleSources.has(configuredEntry)) styleSources.set(configuredEntry, await snapshotFile(snapshots, configuredEntry));
+	const vueStyleRanges = /* @__PURE__ */ new Map();
 	const context = {
 		...scope,
 		options,
 		snapshots,
 		styleSources,
 		sourceFiles,
-		styleDependents: indexStylesheetDependents(styleSources)
+		styleDependents: indexStylesheetDependents(styleSources),
+		vueStyleRanges
 	};
 	const failures = [];
 	const plans = [];
@@ -1880,6 +1912,42 @@ async function migrate(options = {}) {
 		await writeChanges(changed, deleted);
 	}
 	warnings.sort((left, right) => left.file.localeCompare(right.file) || left.start - right.start || left.end - right.end || left.code.localeCompare(right.code));
+	const warningOffsets = /* @__PURE__ */ new Map();
+	for (const warning of warnings) {
+		if (warning.start === 0 && warning.end === 0) continue;
+		const offsets = warningOffsets.get(warning.file) ?? /* @__PURE__ */ new Set();
+		offsets.add(warning.start).add(warning.end);
+		warningOffsets.set(warning.file, offsets);
+	}
+	const warningPositions = new Map([...warningOffsets].flatMap(([file, offsets]) => {
+		const source = snapshots.get(file);
+		if (!source) return [];
+		const extension = extname(file);
+		const javascriptSource = SOURCE_EXTENSIONS.has(extension) && extension !== ".html" && extension !== ".vue";
+		const styleRanges = vueStyleRanges.get(file) ?? [];
+		const defaultOffsets = new Set(offsets);
+		for (const range of styleRanges) defaultOffsets.add(range.start);
+		const defaultPositions = indexWarningPositions(source, defaultOffsets, javascriptSource, isStylesheetPath(file));
+		const bytes = Buffer.from(source);
+		const sortedOffsets = [...offsets].sort((left, right) => left - right);
+		const stylePositions = /* @__PURE__ */ new Map();
+		let offsetIndex = 0;
+		for (const range of styleRanges) {
+			while ((sortedOffsets[offsetIndex] ?? Infinity) < range.start) offsetIndex += 1;
+			const relativeOffsets = /* @__PURE__ */ new Set();
+			while ((sortedOffsets[offsetIndex] ?? Infinity) <= range.end) {
+				relativeOffsets.add(sortedOffsets[offsetIndex] - range.start);
+				offsetIndex += 1;
+			}
+			const initial = defaultPositions.get(range.start);
+			if (!initial) continue;
+			for (const [offset, position] of indexWarningPositions(bytes.subarray(range.start, range.end).toString(), relativeOffsets, false, true, initial)) stylePositions.set(range.start + offset, position);
+		}
+		return [[file, {
+			default: defaultPositions,
+			style: stylePositions
+		}]];
+	}));
 	failures.sort((left, right) => left.package.localeCompare(right.package));
 	return {
 		changedFiles,
@@ -1891,15 +1959,29 @@ async function migrate(options = {}) {
 			file: normalizedRelativePath(cwd, rule.file)
 		})),
 		candidates: [...candidates].sort(),
-		warnings: warnings.map((warning) => ({
-			...warning,
-			file: normalizedRelativePath(cwd, warning.file)
-		})),
+		warnings: warnings.map((warning) => {
+			const indexed = warningPositions.get(warning.file);
+			const styleFrom = indexed?.style.get(warning.start);
+			const styleTo = indexed?.style.get(warning.end);
+			const located = warning.start !== 0 || warning.end !== 0;
+			const from = located ? styleFrom ?? indexed?.default.get(warning.start) : void 0;
+			const to = located ? styleFrom && styleTo ? styleTo : indexed?.default.get(warning.end) : void 0;
+			return {
+				...warning,
+				...from && to ? {
+					line: from.line,
+					column: from.column,
+					endLine: to.line,
+					endColumn: to.column
+				} : {},
+				file: normalizedRelativePath(cwd, warning.file)
+			};
+		}),
 		failures
 	};
 }
 async function planPackage(context, packageRoot) {
-	const { options, snapshots, workspaceRoot, explicitStyle, configuredEntry, styleSources, sourceFiles, styleDependents, pathOwners, targetable, selectedPackages, scannedPaths } = context;
+	const { options, snapshots, workspaceRoot, explicitStyle, configuredEntry, styleSources, sourceFiles, styleDependents, pathOwners, targetable, selectedPackages, scannedPaths, vueStyleRanges } = context;
 	const recover = (error, fatal = false) => {
 		if (!options.force || fatal) throw error;
 		return { failure: packageFailure(workspaceRoot, packageRoot, error) };
@@ -1936,6 +2018,12 @@ async function planPackage(context, packageRoot) {
 	} catch (error) {
 		return recover(error, isIntegrityError(error));
 	}
+	for (const [path, preparedRanges] of preparedVue.styleRanges) {
+		const ranges = vueStyleRanges.get(path) ?? [];
+		ranges.push(...preparedRanges);
+		ranges.sort((left, right) => left.start - right.start);
+		vueStyleRanges.set(path, ranges);
+	}
 	if (explicitStyle && extname(explicitStyle) === ".vue" && preparedVue.stylesheets.length === 0 && ![...preparedVue.stylePaths].some((path) => !isStylesheetModule(path))) return vueWarningsOnlyResult(preparedVue);
 	const packageSources = [...sourceFiles.filter((file) => extname(file.path) !== ".html").map((file) => preparedVue.files.get(file.path) ?? file), ...preparedHtml.files];
 	const ownedStyles = [...styleSources.keys()].filter((path) => pathOwners.get(path) === packageRoot && (targetable.has(path) || preparedHtml.stylePaths.has(path) || preparedVue.stylePaths.has(path)));
@@ -2167,7 +2255,7 @@ function mergePlans(plans, originals) {
 		retainedRules += plan.retainedRules;
 		rules.push(...plan.rules);
 		for (const warning of plan.warnings) {
-			const key = `${warning.code}\0${warning.file}\0${warning.start}\0${warning.end}`;
+			const key = `${warning.code}\0${warning.file}\0${warning.start}\0${warning.end}\0${warning.message}`;
 			if (seenWarnings.has(key)) continue;
 			seenWarnings.add(key);
 			warnings.push(warning);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tw-migrate",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Preview and migrate React, Vue, and HTML CSS to Tailwind utilities",
   "keywords": [
     "codemod",
@@ -35,7 +35,7 @@
   "scripts": {
     "build": "vp pack && napi build --manifest-path crates/tw_migrate/Cargo.toml --package-json-path package.json --output-dir . --platform --release --no-js --dts binding.d.ts",
     "build:debug": "napi build --manifest-path crates/tw_migrate/Cargo.toml --package-json-path package.json --output-dir . --platform --no-js --dts binding.d.ts",
-    "artifacts": "napi artifacts --output-dir . --npm-dir npm",
+    "artifacts": "node -e \"const fs=require('node:fs'); const files=fs.readdirSync('.').filter((file)=>file.startsWith('tw-migrate.')&&file.endsWith('.node')); if(files.length===0) throw new Error('no tw-migrate.*.node artifact in the package root; run build first'); for(const file of files) fs.copyFileSync(file, 'npm/'+file.slice('tw-migrate.'.length, -'.node'.length)+'/'+file)\"",
     "test": "cargo test && pnpm build:debug && vp test",
     "test:ecosystem": "node ecosystem-ci/run.ts",
     "typecheck": "tsc --noEmit",
@@ -44,7 +44,7 @@
     "prepare": "vp config"
   },
   "dependencies": {
-    "parse5": "7.3.0"
+    "parse5": "8.0.1"
   },
   "devDependencies": {
     "@napi-rs/cli": "catalog:",
@@ -62,11 +62,11 @@
     "vue": "catalog:"
   },
   "optionalDependencies": {
-    "tw-migrate-darwin-arm64": "0.3.0",
-    "tw-migrate-darwin-x64": "0.3.0",
-    "tw-migrate-linux-arm64-gnu": "0.3.0",
-    "tw-migrate-linux-x64-gnu": "0.3.0",
-    "tw-migrate-win32-x64-msvc": "0.3.0"
+    "tw-migrate-darwin-arm64": "0.4.0",
+    "tw-migrate-darwin-x64": "0.4.0",
+    "tw-migrate-linux-arm64-gnu": "0.4.0",
+    "tw-migrate-linux-x64-gnu": "0.4.0",
+    "tw-migrate-win32-x64-msvc": "0.4.0"
   },
   "napi": {
     "binaryName": "tw-migrate",
@@ -79,7 +79,7 @@
     ]
   },
   "engines": {
-    "node": ">=22.18.0"
+    "node": ">=22.23.2"
   },
-  "packageManager": "pnpm@11.15.1"
+  "packageManager": "pnpm@11.20.0"
 }