react-doctor 0.2.9 → 0.2.10

package/dist/{cli-logger-BliQX9s8.js → cli-logger-BRBUS1pE.js}

@@ -22,6 +22,7 @@ import * as Option from "effect/Option";
 import * as Ref from "effect/Ref";
 import * as Stream from "effect/Stream";
 import * as Cache from "effect/Cache";
+import { Worker } from "node:worker_threads";
 import * as NodeChildProcessSpawner from "@effect/platform-node-shared/NodeChildProcessSpawner";
 import * as NodeFileSystem from "@effect/platform-node-shared/NodeFileSystem";
 import * as NodePath from "@effect/platform-node-shared/NodePath";
@@ -2272,11 +2273,13 @@ const FRAMEWORK_DISPLAY_NAMES = {
 	gatsby: "Gatsby",
 	expo: "Expo",
 	"react-native": "React Native",
+	preact: "Preact",
 	unknown: "React"
 };
 const formatFrameworkName = (framework) => FRAMEWORK_DISPLAY_NAMES[framework];
 const detectFramework = (dependencies) => {
 	for (const [packageName, frameworkName] of Object.entries(FRAMEWORK_PACKAGES)) if (dependencies[packageName]) return frameworkName;
+	if (dependencies.preact && !dependencies.react) return "preact";
 	return "unknown";
 };
 const UPPER_BOUND_COMPARATOR = /<\s*=?\s*\d+(?:\.\d+){0,2}(?:-[^\s,|]+)?/g;
@@ -2740,6 +2743,13 @@ const hasReactNativeWorkspaceAnywhere = (rootDirectory, rootPackageJson) => {
 	}
 	return false;
 };
+const hasPreact = (packageJson) => {
+	return "preact" in {
+		...packageJson.peerDependencies,
+		...packageJson.dependencies,
+		...packageJson.devDependencies
+	};
+};
 const TANSTACK_QUERY_PACKAGES = new Set([
 	"@tanstack/react-query",
 	"@tanstack/query-core",
@@ -2777,7 +2787,8 @@ const resolveEffectiveReactMajor = (reactVersion, packageJson) => {
 const REACT_DEPENDENCY_NAMES = new Set([
 	"react",
 	"react-native",
-	"next"
+	"next",
+	"preact"
 ]);
 const hasReactDependency = (packageJson) => {
 	const allDependencies = {
@@ -2936,12 +2947,47 @@ const discoverProject = (directory) => {
 		hasTypeScript,
 		hasReactCompiler: detectReactCompiler(directory, packageJson),
 		hasTanStackQuery: hasTanStackQuery(packageJson),
+		hasPreact: hasPreact(packageJson),
 		hasReactNativeWorkspace,
 		sourceFileCount
 	};
 	cachedProjectInfos.set(directory, projectInfo);
 	return projectInfo;
 };
+const MAJOR_MINOR_PATTERN = /(\d{1,4})\.(\d{1,4})/;
+const MAJOR_ONLY_PATTERN = /(\d{1,4})/;
+const UPPER_BOUND_COMPARATOR_PATTERN = /<=?\s{0,8}\d{1,4}(?:\.\d{1,4}){0,2}(?:-[^\s,|]+)?/g;
+const parseReactMajorMinor = (reactVersion) => {
+	if (typeof reactVersion !== "string") return null;
+	const trimmed = reactVersion.trim();
+	if (trimmed.length === 0) return null;
+	const lowerBoundsOnly = trimmed.replace(UPPER_BOUND_COMPARATOR_PATTERN, " ").trim();
+	if (lowerBoundsOnly.length === 0) return null;
+	const majorMinorMatch = lowerBoundsOnly.match(MAJOR_MINOR_PATTERN);
+	if (majorMinorMatch) {
+		const major = Number.parseInt(majorMinorMatch[1], 10);
+		const minor = Number.parseInt(majorMinorMatch[2], 10);
+		if (!Number.isFinite(major) || major <= 0) return null;
+		if (!Number.isFinite(minor) || minor < 0) return null;
+		return {
+			major,
+			minor
+		};
+	}
+	const majorOnlyMatch = lowerBoundsOnly.match(MAJOR_ONLY_PATTERN);
+	if (!majorOnlyMatch) return null;
+	const major = Number.parseInt(majorOnlyMatch[1], 10);
+	if (!Number.isFinite(major) || major <= 0) return null;
+	return {
+		major,
+		minor: 0
+	};
+};
+const isReactAtLeast = (detected, required) => {
+	if (detected === null) return true;
+	if (detected.major !== required.major) return detected.major > required.major;
+	return detected.minor >= required.minor;
+};
 const parseTailwindMajorMinor = (tailwindVersion) => {
 	if (typeof tailwindVersion !== "string") return null;
 	const trimmed = tailwindVersion.trim();
@@ -2972,6 +3018,7 @@ const isTailwindAtLeast = (detected, required) => {
 	return detected.minor >= required.minor;
 };
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
+const MILLISECONDS_PER_SECOND = 1e3;
 const SCORE_API_URL = "https://www.react.doctor/api/score";
 const SHARE_BASE_URL = "https://www.react.doctor/share";
 const FETCH_TIMEOUT_MS = 1e4;
@@ -4491,6 +4538,49 @@ const collectIgnorePatterns = (rootDirectory) => {
 	return patterns;
 };
 const TSCONFIG_FILENAMES$1 = ["tsconfig.json", "tsconfig.base.json"];
+const DEAD_CODE_WORKER_SCRIPT = `
+const { parentPort, workerData } = require("node:worker_threads");
+
+const normalizeResult = (result) => ({
+  unusedFiles: result.unusedFiles.map((unusedFile) => ({
+    path: unusedFile.path,
+  })),
+  unusedExports: result.unusedExports.map((unusedExport) => ({
+    path: unusedExport.path,
+    name: unusedExport.name,
+    line: unusedExport.line,
+    column: unusedExport.column,
+    isTypeOnly: unusedExport.isTypeOnly,
+  })),
+  unusedDependencies: result.unusedDependencies.map((unusedDependency) => ({
+    name: unusedDependency.name,
+    isDevDependency: unusedDependency.isDevDependency,
+  })),
+  circularDependencies: result.circularDependencies.map((cycle) => ({
+    files: cycle.files,
+  })),
+});
+
+const serializeError = (error) =>
+  error instanceof Error
+    ? { name: error.name, message: error.message, stack: error.stack }
+    : { message: String(error) };
+
+(async () => {
+  try {
+    const { analyze, defineConfig } = await import(workerData.deslopJsModuleSpecifier);
+    const config = {
+      rootDir: workerData.rootDirectory,
+      ...(workerData.tsConfigPath ? { tsConfigPath: workerData.tsConfigPath } : {}),
+      ...(workerData.ignorePatterns.length > 0 ? { ignorePatterns: workerData.ignorePatterns } : {}),
+    };
+    const result = await analyze(defineConfig(config));
+    parentPort.postMessage({ ok: true, result: normalizeResult(result) });
+  } catch (error) {
+    parentPort.postMessage({ ok: false, error: serializeError(error) });
+  }
+})();
+`;
 const resolveTsConfigPath = (rootDirectory) => {
 	for (const filename of TSCONFIG_FILENAMES$1) {
 		const candidate = path.join(rootDirectory, filename);
@@ -4511,16 +4601,180 @@ const toRelativeFilePath = (rootDirectory, filePath) => {
 	const relative = toRelativePath(filePath, rootDirectory);
 	return relative.length > 0 ? relative : filePath.replace(/\\/g, "/");
 };
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parseArray = (value, label) => {
+	if (!Array.isArray(value)) throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseString = (value, label) => {
+	if (typeof value !== "string") throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseNumber = (value, label) => {
+	if (typeof value !== "number") throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseBoolean = (value, label) => {
+	if (typeof value !== "boolean") throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseStringArray = (value, label) => {
+	return parseArray(value, label).map((entry, index) => parseString(entry, `${label}[${index}]`));
+};
+const parseUnusedFiles = (value) => {
+	const values = parseArray(value, "unusedFiles");
+	const unusedFiles = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid unusedFiles[${index}].`);
+		unusedFiles.push({ path: parseString(entry.path, `unusedFiles[${index}].path`) });
+	}
+	return unusedFiles;
+};
+const parseUnusedExports = (value) => {
+	const values = parseArray(value, "unusedExports");
+	const unusedExports = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid unusedExports[${index}].`);
+		unusedExports.push({
+			path: parseString(entry.path, `unusedExports[${index}].path`),
+			name: parseString(entry.name, `unusedExports[${index}].name`),
+			line: parseNumber(entry.line, `unusedExports[${index}].line`),
+			column: parseNumber(entry.column, `unusedExports[${index}].column`),
+			isTypeOnly: parseBoolean(entry.isTypeOnly, `unusedExports[${index}].isTypeOnly`)
+		});
+	}
+	return unusedExports;
+};
+const parseUnusedDependencies = (value) => {
+	const values = parseArray(value, "unusedDependencies");
+	const unusedDependencies = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid unusedDependencies[${index}].`);
+		unusedDependencies.push({
+			name: parseString(entry.name, `unusedDependencies[${index}].name`),
+			isDevDependency: parseBoolean(entry.isDevDependency, `unusedDependencies[${index}].isDevDependency`)
+		});
+	}
+	return unusedDependencies;
+};
+const parseCircularDependencies = (value) => {
+	const values = parseArray(value, "circularDependencies");
+	const circularDependencies = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid circularDependencies[${index}].`);
+		circularDependencies.push({ files: parseStringArray(entry.files, `circularDependencies[${index}].files`) });
+	}
+	return circularDependencies;
+};
+const parseDeadCodeWorkerResult = (value) => {
+	if (!isRecord(value)) throw new Error("Dead-code worker returned an invalid result.");
+	return {
+		unusedFiles: parseUnusedFiles(value.unusedFiles),
+		unusedExports: parseUnusedExports(value.unusedExports),
+		unusedDependencies: parseUnusedDependencies(value.unusedDependencies),
+		circularDependencies: parseCircularDependencies(value.circularDependencies)
+	};
+};
+const parseDeadCodeWorkerError = (value) => {
+	if (!isRecord(value) || typeof value.message !== "string") return { message: "Dead-code worker failed." };
+	return {
+		...typeof value.name === "string" ? { name: value.name } : {},
+		message: value.message,
+		...typeof value.stack === "string" ? { stack: value.stack } : {}
+	};
+};
+const parseDeadCodeWorkerMessage = (value) => {
+	if (!isRecord(value)) throw new Error("Dead-code worker returned an invalid message.");
+	if (value.ok === true) return {
+		ok: true,
+		result: value.result
+	};
+	if (value.ok === false) return {
+		ok: false,
+		error: parseDeadCodeWorkerError(value.error)
+	};
+	throw new Error("Dead-code worker returned an invalid status.");
+};
+const buildDeadCodeWorkerError = (workerError) => {
+	const error = new Error(workerError.message);
+	if (workerError.name !== void 0) error.name = workerError.name;
+	if (workerError.stack !== void 0) error.stack = workerError.stack;
+	return error;
+};
+const createDeadCodeWorker = (input) => {
+	const worker = new Worker(DEAD_CODE_WORKER_SCRIPT, {
+		eval: true,
+		workerData: input
+	});
+	let didSettle = false;
+	return {
+		result: new Promise((resolve, reject) => {
+			const settle = (callback) => {
+				if (didSettle) return;
+				didSettle = true;
+				worker.removeAllListeners();
+				callback();
+			};
+			worker.once("message", (message) => {
+				try {
+					const parsedMessage = parseDeadCodeWorkerMessage(message);
+					if (parsedMessage.ok) {
+						settle(() => resolve(parsedMessage.result));
+						return;
+					}
+					settle(() => reject(buildDeadCodeWorkerError(parsedMessage.error)));
+				} catch (error) {
+					settle(() => reject(error));
+				}
+			});
+			worker.once("error", (error) => {
+				settle(() => reject(error));
+			});
+			worker.once("exit", (exitCode) => {
+				if (exitCode === 0) return;
+				settle(() => reject(/* @__PURE__ */ new Error(`Dead-code worker exited with code ${exitCode}.`)));
+			});
+		}),
+		terminate: () => {
+			didSettle = true;
+			worker.removeAllListeners();
+			return worker.terminate();
+		}
+	};
+};
+const runDeadCodeWorkerWithTimeout = (handle, timeoutMs) => new Promise((resolve, reject) => {
+	let didSettle = false;
+	const timeoutHandle = setTimeout(() => {
+		if (didSettle) return;
+		didSettle = true;
+		handle.terminate?.();
+		reject(/* @__PURE__ */ new Error(`Dead-code worker timed out after ${timeoutMs / MILLISECONDS_PER_SECOND}s.`));
+	}, timeoutMs);
+	timeoutHandle.unref?.();
+	handle.result.then((value) => {
+		if (didSettle) return;
+		didSettle = true;
+		clearTimeout(timeoutHandle);
+		handle.terminate?.();
+		resolve(value);
+	}, (error) => {
+		if (didSettle) return;
+		didSettle = true;
+		clearTimeout(timeoutHandle);
+		handle.terminate?.();
+		reject(error);
+	});
+});
 const checkDeadCode = async (options) => {
 	const { rootDirectory, userConfig } = options;
 	if (!fs.existsSync(path.join(rootDirectory, "package.json"))) return [];
-	const { analyze, defineConfig } = await import("deslop-js");
 	const ignorePatterns = collectDeadCodeIgnorePatterns(rootDirectory, userConfig);
-	const result = await analyze(defineConfig({
-		rootDir: rootDirectory,
+	const result = parseDeadCodeWorkerResult(await runDeadCodeWorkerWithTimeout((options.createWorker ?? createDeadCodeWorker)({
+		rootDirectory,
 		tsConfigPath: resolveTsConfigPath(rootDirectory),
-		...ignorePatterns.length > 0 ? { ignorePatterns } : {}
-	}));
+		ignorePatterns,
+		deslopJsModuleSpecifier: options.deslopJsModuleSpecifier ?? import.meta.resolve("deslop-js")
+	}), options.workerTimeoutMs ?? 12e4));
 	const toRelative = (filePath) => toRelativeFilePath(rootDirectory, filePath);
 	const diagnostics = [];
 	for (const unusedFile of result.unusedFiles) diagnostics.push({
@@ -5144,7 +5398,15 @@ const buildCapabilities = (project) => {
 	capabilities.add(project.framework);
 	if (project.framework === "expo" || project.framework === "react-native" || project.hasReactNativeWorkspace) capabilities.add("react-native");
 	const reactMajor = project.reactMajorVersion;
-	if (reactMajor !== null) for (let major = 17; major <= reactMajor; major++) capabilities.add(`react:${major}`);
+	if (reactMajor !== null) {
+		for (let major = 17; major <= reactMajor; major++) capabilities.add(`react:${major}`);
+		if (reactMajor >= 19) {
+			if (isReactAtLeast(parseReactMajorMinor(project.reactVersion), {
+				major: 19,
+				minor: 2
+			})) capabilities.add("react:19.2");
+		}
+	}
 	if (project.tailwindVersion !== null) {
 		capabilities.add("tailwind");
 		if (isTailwindAtLeast(parseTailwindMajorMinor(project.tailwindVersion), {
@@ -5155,6 +5417,10 @@ const buildCapabilities = (project) => {
 	if (project.hasReactCompiler) capabilities.add("react-compiler");
 	if (project.hasTanStackQuery) capabilities.add("tanstack-query");
 	if (project.hasTypeScript) capabilities.add("typescript");
+	if (project.hasPreact) {
+		capabilities.add("preact");
+		if (project.reactVersion === null) capabilities.add("pure-preact");
+	}
 	return capabilities;
 };
 const shouldEnableRule = (requires, tags, capabilities, ignoredTags, disabledBy) => {
@@ -6484,17 +6750,6 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 		didFail: false,
 		reason: null
 	});
-	const shouldRunDeadCode = input.runDeadCode && !isDiffMode;
-	const deadCodeFiber = yield* Effect.forkChild(shouldRunDeadCode ? Stream.runCollect(applyPerElementPipeline(deadCodeService.run({
-		rootDirectory: scanDirectory,
-		userConfig: resolvedConfig.config
-	}).pipe(Stream.catchTag("ReactDoctorError", (error) => Stream.unwrap(Effect.gen(function* () {
-		yield* Ref.set(deadCodeFailure, {
-			didFail: true,
-			reason: error.message
-		});
-		return Stream.empty;
-	})))))) : Effect.succeed([]));
 	const scanProgress = yield* progressService.start("Scanning...");
 	const scanStartTime = Date.now();
 	let lastReportedTotalFileCount = 0;
@@ -6524,11 +6779,18 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 	const lintCollected = yield* Stream.runCollect(applyPerElementPipeline(rawLintStream));
 	const lintFailureState = yield* Ref.get(lintFailure);
 	yield* afterLint(lintFailureState.didFail);
-	if (lintFailureState.didFail) {
-		yield* Fiber.interrupt(deadCodeFiber);
-		yield* scanProgress.fail(formatLintFailText(lintFailureState.reasonTag, process.version));
-	}
-	const deadCodeCollected = lintFailureState.didFail ? [] : yield* Fiber.join(deadCodeFiber);
+	if (lintFailureState.didFail) yield* scanProgress.fail(formatLintFailText(lintFailureState.reasonTag, process.version));
+	const shouldRunDeadCode = input.runDeadCode && !isDiffMode;
+	const deadCodeCollected = lintFailureState.didFail || !shouldRunDeadCode ? [] : yield* scanProgress.update("Analyzing dead code...").pipe(Effect.andThen(Stream.runCollect(applyPerElementPipeline(deadCodeService.run({
+		rootDirectory: scanDirectory,
+		userConfig: resolvedConfig.config
+	}).pipe(Stream.catchTag("ReactDoctorError", (error) => Stream.unwrap(Effect.gen(function* () {
+		yield* Ref.set(deadCodeFailure, {
+			didFail: true,
+			reason: error.message
+		});
+		return Stream.empty;
+	}))))))));
 	const deadCodeFailureState = yield* Ref.get(deadCodeFailure);
 	const scanElapsedSeconds = ((Date.now() - scanStartTime) / 1e3).toFixed(1);
 	const totalFileCount = lastReportedTotalFileCount || (lintIncludePaths?.length ?? project.sourceFileCount);
@@ -7023,7 +7285,7 @@ var cli_logger_exports = /* @__PURE__ */ __exportAll({ cliLogger: () => cliLogge
 /**
 * Thin synchronous façade over Effect's `Console` module. Used by
 * the imperative CLI helper files (`select-projects`, `run-explain`,
-* `install-skill`, the legacy paths in `cli/commands/inspect.ts`)
+* `install-react-doctor`, the legacy paths in `cli/commands/inspect.ts`)
 * that aren't yet Effect-typed. Every call drains into a single
 * `Console.*` Effect via `Effect.runSync`, so the underlying logging
 * pipeline is identical to the canonical `yield* Console.log(...)`
@@ -7056,4 +7318,4 @@ const cliLogger = {
 //#endregion
 export { isReactDoctorError as A, filterSourceFiles as C, groupBy as D, getDiffInfo as E, runInspect as F, toRelativePath as I, listWorkspacePackages as M, resolveScanTarget as N, highlighter as O, restoreLegacyThrow as P, filterDiagnosticsForSurface as S, formatReactDoctorError as T, Score as _, DeadCode as a, buildJsonReportError as b, LintPartialFailures as c, OXLINT_NODE_REQUIREMENT as d, Progress as f, SKILL_NAME as g, SHARE_BASE_URL as h, Config as i, layerOtlp as j, isMonorepoRoot as k, Linter as l, Reporter as m, cli_logger_exports as n, Files as o, Project as p, CANONICAL_GITHUB_URL as r, Git as s, cliLogger as t, NodeResolver as u, StagedFiles as v, formatErrorChain as w, discoverReactSubprojects as x, buildJsonReport as y };
 
-//# sourceMappingURL=cli-logger-BliQX9s8.js.map
+//# sourceMappingURL=cli-logger-BRBUS1pE.js.map

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./rolldown-runtime-uZX_iqCz.js";
-import { A as isReactDoctorError, C as filterSourceFiles, D as groupBy, E as getDiffInfo, F as runInspect, I as toRelativePath, M as listWorkspacePackages, N as resolveScanTarget, O as highlighter, P as restoreLegacyThrow, S as filterDiagnosticsForSurface, T as formatReactDoctorError, _ as Score, a as DeadCode, b as buildJsonReportError, c as LintPartialFailures, d as OXLINT_NODE_REQUIREMENT, f as Progress, g as SKILL_NAME, h as SHARE_BASE_URL, i as Config, j as layerOtlp, k as isMonorepoRoot, l as Linter, m as Reporter, o as Files, p as Project, r as CANONICAL_GITHUB_URL, s as Git, t as cliLogger, u as NodeResolver, v as StagedFiles, w as formatErrorChain, x as discoverReactSubprojects, y as buildJsonReport } from "./cli-logger-BliQX9s8.js";
+import { A as isReactDoctorError, C as filterSourceFiles, D as groupBy, E as getDiffInfo, F as runInspect, I as toRelativePath, M as listWorkspacePackages, N as resolveScanTarget, O as highlighter, P as restoreLegacyThrow, S as filterDiagnosticsForSurface, T as formatReactDoctorError, _ as Score, a as DeadCode, b as buildJsonReportError, c as LintPartialFailures, d as OXLINT_NODE_REQUIREMENT, f as Progress, g as SKILL_NAME, h as SHARE_BASE_URL, i as Config, j as layerOtlp, k as isMonorepoRoot, l as Linter, m as Reporter, o as Files, p as Project, r as CANONICAL_GITHUB_URL, s as Git, t as cliLogger, u as NodeResolver, v as StagedFiles, w as formatErrorChain, x as discoverReactSubprojects, y as buildJsonReport } from "./cli-logger-BRBUS1pE.js";
 import { createRequire } from "node:module";
 import { execFileSync, execSync } from "node:child_process";
 import path, { join } from "node:path";
@@ -6320,11 +6320,11 @@ const colorizeByScore = (text, score) => {
 	return highlighter.error(text);
 };
 //#endregion
+//#region src/cli/utils/constants.ts
+const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
+const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
+//#endregion
 //#region src/cli/utils/render-score-header.ts
-const SCORE_BAR_ANIMATION_FRAME_COUNT = 40;
-const SCORE_BAR_ANIMATION_FRAME_DELAY_MS = 50;
-const PERFECT_SCORE_RAINBOW_FRAME_COUNT = 16;
-const PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS = 50;
 const RAINBOW_HUE_SHIFT_PER_FRAME = 9;
 const RAINBOW_GRADIENT_WIDTH = 80;
 const RAINBOW_OKLCH_LIGHTNESS = .638;
@@ -6433,8 +6433,8 @@ const buildInitialScoreHeaderLine = ({ isPerfectScore, shouldAnimate, lineIndex,
 };
 const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectName) => Effect.gen(function* () {
 	const isPerfectScore = score === 100;
-	for (let frame = 0; frame <= SCORE_BAR_ANIMATION_FRAME_COUNT; frame += 1) {
-		const progress = easeOutCubic(frame / SCORE_BAR_ANIMATION_FRAME_COUNT);
+	for (let frame = 0; frame <= 40; frame += 1) {
+		const progress = easeOutCubic(frame / 40);
 		const animatedScore = Math.round(score * progress);
 		if (isPerfectScore) {
 			yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[4A"}\r${buildRainbowScoreHeaderFrame({
@@ -6444,16 +6444,16 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 				frame,
 				projectName
 			})}`);
-			if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+			if (frame < 40) yield* sleep(50);
 			continue;
 		}
 		const animatedScoreLine = buildScoreLine(animatedScore, score, label, projectName);
 		const animatedBarLine = buildScoreBar(animatedScore, score);
 		yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[2A"}\r${buildScoreHeaderLine(scoreFaceLine, animatedScoreLine)}\n\r${buildScoreHeaderLine(barFaceLine, animatedBarLine)}\n`);
-		if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+		if (frame < 40) yield* sleep(50);
 	}
 	if (!isPerfectScore) return;
-	for (let frame = 0; frame < PERFECT_SCORE_RAINBOW_FRAME_COUNT; frame += 1) {
+	for (let frame = 0; frame < 16; frame += 1) {
 		yield* writeScoreHeaderLine(`\x1b[4A\r${buildRainbowScoreHeaderFrame({
 			score,
 			displayScore: score,
@@ -6461,9 +6461,9 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 			frame,
 			projectName
 		})}`);
-		yield* sleep(PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS);
+		yield* sleep(50);
 	}
-	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, PERFECT_SCORE_RAINBOW_FRAME_COUNT, projectName)}\x1b[2A`);
+	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, 16, projectName)}\x1b[2A`);
 });
 const printScoreHeader = (scoreResult, projectName) => Effect.gen(function* () {
 	const isPerfectScore = scoreResult.score === 100;
@@ -6666,7 +6666,7 @@ const resolveOxlintNodeEffect = (isLintEnabled, isQuiet) => Effect.gen(function*
 const resolveOxlintNode = (isLintEnabled, isQuiet) => Effect.runPromise(resolveOxlintNodeEffect(isLintEnabled, isQuiet).pipe(Effect.provide(NodeResolver.layerNode)));
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.2.9";
+const VERSION = "0.2.10";
 //#endregion
 //#region src/inspect.ts
 const silentConsole = makeNoopConsole();
@@ -6854,10 +6854,6 @@ const finalizeAndRender = (input) => Effect.gen(function* () {
 	return buildResult();
 });
 //#endregion
-//#region src/cli/utils/constants.ts
-const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
-const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
-//#endregion
 //#region src/cli/utils/get-staged-files.ts
 const stagedFilesLayer = StagedFiles.layerNode.pipe(Layer.provide(Git.layerNode));
 const getStagedSourceFiles = async (directory) => {
@@ -7416,7 +7412,7 @@ const disableSetupPrompt = (projectRoot, storeOptions = {}) => {
 	return true;
 };
 const shouldPromptInstallSetup = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7426,13 +7422,13 @@ const shouldPromptInstallSetup = (options) => {
 	return !hasDoctorScript(options.projectRoot);
 };
 const resolveInstallSetupProjectRoot = (options) => {
-	if (options.completedScanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
+	if (options.scanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
 	const packageDirectories = /* @__PURE__ */ new Set();
-	for (const scanDirectory of options.completedScanDirectories) {
+	for (const scanDirectory of options.scanDirectories) {
 		const packageDirectory = findNearestPackageDirectory(scanDirectory, options.scanRoot) ?? findNearestPackageDirectory(scanDirectory) ?? scanDirectory;
 		packageDirectories.add(packageDirectory);
 	}
-	if (packageDirectories.size !== 1) return null;
+	if (packageDirectories.size !== 1) return findNearestPackageDirectory(options.scanRoot, options.scanRoot);
 	return [...packageDirectories][0] ?? null;
 };
 const defaultWait = (milliseconds) => new Promise((resolve) => {
@@ -7467,7 +7463,7 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-BliQX9s8.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-BRBUS1pE.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
@@ -7483,7 +7479,7 @@ const promptInstallSetup = async (options) => {
 			writeLine("You can always run `npx react-doctor@latest install` to set it up later.");
 			return;
 		}
-		const install = options.install ?? (await Promise.resolve().then(() => install_skill_exports)).runInstallSkill;
+		const install = options.install ?? (await Promise.resolve().then(() => install_react_doctor_exports)).runInstallReactDoctor;
 		const previousExitCode = process.exitCode;
 		let setupExitCode;
 		try {
@@ -7502,7 +7498,7 @@ const promptInstallSetup = async (options) => {
 	}
 };
 const shouldShowAgentInstallHint = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7567,7 +7563,7 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isQui
 	const { scanScope } = await prompts({
 		type: "select",
 		name: "scanScope",
-		message: "Select",
+		message: "Choose what to scan",
 		choices: [{
 			title: "Full codebase",
 			value: "full"
@@ -7709,7 +7705,7 @@ const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
 	}
 	if (packages.length === 0) return [rootDirectory];
 	if (packages.length === 1) {
-		cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages[0].name}`);
+		cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages[0].name}`);
 		return [packages[0].directory];
 	}
 	if (projectFlag) return resolveProjectFlag(projectFlag, packages);
@@ -7733,13 +7729,13 @@ const resolveProjectFlag = (projectFlag, workspacePackages) => {
 	return resolvedDirectories;
 };
 const printDiscoveredProjects = (packages) => {
-	cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
+	cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
 };
 const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 	const { selectedDirectories } = await prompts({
 		type: "multiselect",
 		name: "selectedDirectories",
-		message: "Select projects to scan",
+		message: "Select projects",
 		choices: workspacePackages.map((workspacePackage) => ({
 			title: workspacePackage.name,
 			description: path.relative(rootDirectory, workspacePackage.directory),
@@ -7996,13 +7992,13 @@ const inspectAction = async (directory, flags) => {
 		});
 		const setupProjectRoot = resolveInstallSetupProjectRoot({
 			scanRoot: resolvedDirectory,
-			completedScanDirectories: completedScans.map((scan) => scan.directory)
+			scanDirectories: projectDirectories
 		});
 		if (setupProjectRoot !== null) {
-			const hasScoredScan = completedScans.some((scan) => scan.result.score !== null);
+			const hasCompletedScan = completedScans.length > 0;
 			await promptInstallSetup({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				issueCount: filterDiagnosticsForSurface(allDiagnostics, scanOptions.outputSurface ?? "cli", userConfig).length,
 				isJsonMode,
 				isScoreOnly,
@@ -8011,7 +8007,7 @@ const inspectAction = async (directory, flags) => {
 			});
 			if (shouldShowAgentInstallHint({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				isJsonMode,
 				isScoreOnly,
 				isStaged: Boolean(flags.staged)
@@ -8643,8 +8639,12 @@ const installReactDoctorGitHook = (options) => {
 	return installDirectGitHook(options);
 };
 //#endregion
-//#region src/cli/utils/install-skill.ts
-var install_skill_exports = /* @__PURE__ */ __exportAll({ runInstallSkill: () => runInstallSkill });
+//#region src/cli/utils/install-react-doctor.ts
+var install_react_doctor_exports = /* @__PURE__ */ __exportAll({ runInstallReactDoctor: () => runInstallReactDoctor });
+const SETUP_OPTION_GIT_HOOK = "git-hook";
+const SETUP_OPTION_AGENT_HOOKS = "agent-hooks";
+const SETUP_OPTION_WORKFLOW = "workflow";
+const SETUP_OPTION_SKIP = "skip";
 const CONFIG_ONLY_GIT_HOOK_KINDS = new Set([
 	"ghooks",
 	"git-hooks-js",
@@ -8825,7 +8825,30 @@ const getSkillSourceDirectory = () => {
 	const distDirectory = path.dirname(fileURLToPath(import.meta.url));
 	return path.join(distDirectory, "skills", SKILL_NAME);
 };
-const runInstallSkill = async (options = {}) => {
+const canInstallNativeAgentHooks = (agents) => agents.some((agent) => agent === "claude-code" || agent === "cursor");
+const buildWorkflowContent = () => [
+	"name: React Doctor",
+	"",
+	"on:",
+	"  pull_request:",
+	"    branches: [main]",
+	"",
+	"permissions:",
+	"  contents: read",
+	"  pull-requests: write",
+	"",
+	"jobs:",
+	"  react-doctor:",
+	"    runs-on: ubuntu-latest",
+	"    steps:",
+	"      - uses: actions/checkout@v4",
+	"      - uses: millionco/react-doctor@main",
+	"        with:",
+	"          github-token: ${{ secrets.GITHUB_TOKEN }}",
+	"          diff: main",
+	""
+].join("\n");
+const runInstallReactDoctor = async (options = {}) => {
 	const requestedProjectRoot = options.projectRoot ?? process.cwd();
 	const projectRoot = findNearestPackageDirectory(requestedProjectRoot) ?? requestedProjectRoot;
 	const sourceDir = options.sourceDir ?? getSkillSourceDirectory();
@@ -8846,7 +8869,8 @@ const runInstallSkill = async (options = {}) => {
 	const gitHookTarget = options.gitHookPath === void 0 ? detectGitHookTarget(projectRoot) : options.gitHookPath === null ? null : buildManualGitHookTarget(options.gitHookPath, projectRoot);
 	const gitHookPath = gitHookTarget?.hookPath;
 	const promptOptions = options.onPromptCancel === void 0 ? {} : { onCancel: options.onPromptCancel };
-	const selectedAgents = skipPrompts ? detectedAgents : (await prompts({
+	const prompt = options.prompt ?? prompts;
+	const selectedAgents = skipPrompts ? detectedAgents : (await prompt({
 		type: "multiselect",
 		name: "agents",
 		message: `Install the ${highlighter.info(`/react-doctor`)} skill for:`,
@@ -8859,13 +8883,48 @@ const runInstallSkill = async (options = {}) => {
 		min: 1
 	}, promptOptions)).agents ?? [];
 	if (selectedAgents.length === 0) return;
-	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !skipPrompts && Boolean((await prompts({
-		type: "confirm",
-		name: "installGitHook",
-		message: "Check for issues before each commit?",
-		initial: true
-	}, promptOptions)).installGitHook));
-	const shouldInstallAgentHooks = Boolean(options.agentHooks);
+	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
+	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
+	const hasExistingWorkflows = existsSync(workflowsDirectory);
+	const canInstallWorkflow = !existsSync(workflowTargetPath);
+	const setupActionChoices = [
+		...gitHookPath === null || gitHookPath === void 0 ? [] : [{
+			title: "Pre-commit hook",
+			description: "Check staged changes before each commit",
+			value: SETUP_OPTION_GIT_HOOK,
+			selected: true
+		}],
+		...canInstallNativeAgentHooks(selectedAgents) ? [{
+			title: "Agent hooks",
+			description: "Ask Claude Code or Cursor to scan after code edits",
+			value: SETUP_OPTION_AGENT_HOOKS,
+			selected: Boolean(options.agentHooks)
+		}] : [],
+		...canInstallWorkflow ? [{
+			title: "GitHub Actions workflow",
+			description: "Scan pull requests in CI",
+			value: SETUP_OPTION_WORKFLOW,
+			selected: hasExistingWorkflows
+		}] : []
+	];
+	const setupChoices = setupActionChoices.length === 0 ? [] : [{
+		title: "Skip optional setup",
+		description: "Install only the agent skill and package setup",
+		value: SETUP_OPTION_SKIP,
+		selected: false
+	}, ...setupActionChoices];
+	const selectedSetupOptions = skipPrompts || setupChoices.length === 0 ? [] : (await prompt({
+		type: "multiselect",
+		name: "setupOptions",
+		message: "Select additional React Doctor setup:",
+		choices: setupChoices,
+		instructions: false
+	}, promptOptions)).setupOptions ?? [];
+	const selectedSetupActions = selectedSetupOptions.filter((setupOption) => setupOption !== SETUP_OPTION_SKIP);
+	const didSkipOptionalSetup = selectedSetupActions.length === 0 && selectedSetupOptions.includes(SETUP_OPTION_SKIP);
+	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_GIT_HOOK));
+	const shouldInstallAgentHooks = Boolean(options.agentHooks) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_AGENT_HOOKS);
+	const shouldInstallWorkflow = !skipPrompts && !didSkipOptionalSetup && canInstallWorkflow && selectedSetupActions.includes(SETUP_OPTION_WORKFLOW);
 	if (options.dryRun) {
 		cliLogger.log(`Dry run — would install ${SKILL_NAME} skill for:`);
 		for (const agent of selectedAgents) cliLogger.dim(`  - ${getSkillAgentConfig(agent).displayName}`);
@@ -8874,6 +8933,7 @@ const runInstallSkill = async (options = {}) => {
 		cliLogger.dim("  Dev dependency: react-doctor");
 		if (shouldInstallGitHook) cliLogger.dim(`  Git hook: ${gitHookPath}`);
 		if (shouldInstallAgentHooks) cliLogger.dim("  Agent hooks: Claude Code / Cursor when selected");
+		if (shouldInstallWorkflow) cliLogger.dim(`  GitHub Actions workflow: ${path.relative(projectRoot, workflowTargetPath)}`);
 		return;
 	}
 	const installSpinner = spinner(`Installing ${SKILL_NAME} skill...`).start();
@@ -8921,47 +8981,15 @@ const runInstallSkill = async (options = {}) => {
 			throw error;
 		}
 	}
-	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
-	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
-	if (!existsSync(workflowTargetPath) && !skipPrompts) {
-		const hasExistingWorkflows = existsSync(workflowsDirectory);
-		const { shouldInstallWorkflow } = await prompts({
-			type: "confirm",
-			name: "shouldInstallWorkflow",
-			message: "Add a GitHub Actions workflow to scan PRs?",
-			initial: hasExistingWorkflows
-		}, promptOptions);
-		if (shouldInstallWorkflow) {
-			if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
-			const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
-			try {
-				writeFileSync(workflowTargetPath, [
-					"name: React Doctor",
-					"",
-					"on:",
-					"  pull_request:",
-					"    branches: [main]",
-					"",
-					"permissions:",
-					"  contents: read",
-					"  pull-requests: write",
-					"",
-					"jobs:",
-					"  react-doctor:",
-					"    runs-on: ubuntu-latest",
-					"    steps:",
-					"      - uses: actions/checkout@v4",
-					"      - uses: millionco/react-doctor@main",
-					"        with:",
-					"          github-token: ${{ secrets.GITHUB_TOKEN }}",
-					"          diff: main",
-					""
-				].join("\n"));
-				workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
-			} catch (error) {
-				workflowSpinner.fail("Failed to add GitHub Actions workflow.");
-				throw error;
-			}
+	if (shouldInstallWorkflow) {
+		if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
+		const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
+		try {
+			writeFileSync(workflowTargetPath, buildWorkflowContent());
+			workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
+		} catch (error) {
+			workflowSpinner.fail("Failed to add GitHub Actions workflow.");
+			throw error;
 		}
 	}
 };
@@ -8971,7 +8999,7 @@ const installAction = async (options, command) => {
 	Effect.runSync(printBrandedHeader);
 	try {
 		const parentOptions = command?.parent?.opts?.();
-		await runInstallSkill({
+		await runInstallReactDoctor({
 			yes: options.yes ?? parentOptions?.yes,
 			dryRun: options.dryRun,
 			agentHooks: options.agentHooks,

package/dist/index.d.ts

@@ -232,7 +232,9 @@ interface ReactDoctorConfig {
    * `categories` field, but keyed by React Doctor's display
    * categories (`"Server"`, `"React Native"`, `"Architecture"`,
    * `"Bundle Size"`, `"State & Effects"`, `"Security"`,
-   * `"Accessibility"`, `"Performance"`, `"Correctness"`, …).
+   * `"Accessibility"`, `"Performance"`, `"Correctness"`,
+   * `"Next.js"`, `"Preact"`, `"TanStack Query"`,
+   * `"TanStack Start"`, …).
    *
    * ```json
    * { "categories": { "React Native": "warn", "Server": "off" } }
@@ -296,7 +298,7 @@ interface Diagnostic {
 }
 //#endregion
 //#region src/types/project-info.d.ts
-type Framework = "nextjs" | "vite" | "cra" | "remix" | "gatsby" | "expo" | "react-native" | "tanstack-start" | "unknown";
+type Framework = "nextjs" | "vite" | "cra" | "remix" | "gatsby" | "expo" | "react-native" | "tanstack-start" | "preact" | "unknown";
 interface ProjectInfo {
   rootDirectory: string;
   projectName: string;
@@ -307,6 +309,16 @@ interface ProjectInfo {
   hasTypeScript: boolean;
   hasReactCompiler: boolean;
   hasTanStackQuery: boolean;
+  /**
+   * `true` when `preact` is declared anywhere in the project's
+   * dependency manifest. Drives the `preact` capability in
+   * `buildCapabilities`, which gates every `preact-*` rule. Modeled
+   * on `hasTanStackQuery` rather than the `framework` field because
+   * the dominant Preact setup today is Preact-on-Vite — those
+   * projects classify as `framework: "vite"` for build-tool reasons
+   * but still need Preact-specific rules to fire.
+   */
+  hasPreact: boolean;
   /**
    * `true` when the project (or any of its workspace packages) declares
    * React Native or Expo as a dependency. Enables the `react-native`

package/dist/index.js

@@ -21,6 +21,7 @@ import * as Option from "effect/Option";
 import * as Ref from "effect/Ref";
 import * as Stream from "effect/Stream";
 import * as Cache from "effect/Cache";
+import { Worker } from "node:worker_threads";
 import * as NodeChildProcessSpawner from "@effect/platform-node-shared/NodeChildProcessSpawner";
 import * as NodeFileSystem from "@effect/platform-node-shared/NodeFileSystem";
 import * as NodePath from "@effect/platform-node-shared/NodePath";
@@ -2298,11 +2299,13 @@ const FRAMEWORK_DISPLAY_NAMES = {
 	gatsby: "Gatsby",
 	expo: "Expo",
 	"react-native": "React Native",
+	preact: "Preact",
 	unknown: "React"
 };
 const formatFrameworkName = (framework) => FRAMEWORK_DISPLAY_NAMES[framework];
 const detectFramework = (dependencies) => {
 	for (const [packageName, frameworkName] of Object.entries(FRAMEWORK_PACKAGES)) if (dependencies[packageName]) return frameworkName;
+	if (dependencies.preact && !dependencies.react) return "preact";
 	return "unknown";
 };
 const UPPER_BOUND_COMPARATOR = /<\s*=?\s*\d+(?:\.\d+){0,2}(?:-[^\s,|]+)?/g;
@@ -2766,6 +2769,13 @@ const hasReactNativeWorkspaceAnywhere = (rootDirectory, rootPackageJson) => {
 	}
 	return false;
 };
+const hasPreact = (packageJson) => {
+	return "preact" in {
+		...packageJson.peerDependencies,
+		...packageJson.dependencies,
+		...packageJson.devDependencies
+	};
+};
 const TANSTACK_QUERY_PACKAGES = new Set([
 	"@tanstack/react-query",
 	"@tanstack/query-core",
@@ -2803,7 +2813,8 @@ const resolveEffectiveReactMajor = (reactVersion, packageJson) => {
 const REACT_DEPENDENCY_NAMES = new Set([
 	"react",
 	"react-native",
-	"next"
+	"next",
+	"preact"
 ]);
 const hasReactDependency = (packageJson) => {
 	const allDependencies = {
@@ -2965,12 +2976,47 @@ const discoverProject = (directory) => {
 		hasTypeScript,
 		hasReactCompiler: detectReactCompiler(directory, packageJson),
 		hasTanStackQuery: hasTanStackQuery(packageJson),
+		hasPreact: hasPreact(packageJson),
 		hasReactNativeWorkspace,
 		sourceFileCount
 	};
 	cachedProjectInfos.set(directory, projectInfo);
 	return projectInfo;
 };
+const MAJOR_MINOR_PATTERN = /(\d{1,4})\.(\d{1,4})/;
+const MAJOR_ONLY_PATTERN = /(\d{1,4})/;
+const UPPER_BOUND_COMPARATOR_PATTERN = /<=?\s{0,8}\d{1,4}(?:\.\d{1,4}){0,2}(?:-[^\s,|]+)?/g;
+const parseReactMajorMinor = (reactVersion) => {
+	if (typeof reactVersion !== "string") return null;
+	const trimmed = reactVersion.trim();
+	if (trimmed.length === 0) return null;
+	const lowerBoundsOnly = trimmed.replace(UPPER_BOUND_COMPARATOR_PATTERN, " ").trim();
+	if (lowerBoundsOnly.length === 0) return null;
+	const majorMinorMatch = lowerBoundsOnly.match(MAJOR_MINOR_PATTERN);
+	if (majorMinorMatch) {
+		const major = Number.parseInt(majorMinorMatch[1], 10);
+		const minor = Number.parseInt(majorMinorMatch[2], 10);
+		if (!Number.isFinite(major) || major <= 0) return null;
+		if (!Number.isFinite(minor) || minor < 0) return null;
+		return {
+			major,
+			minor
+		};
+	}
+	const majorOnlyMatch = lowerBoundsOnly.match(MAJOR_ONLY_PATTERN);
+	if (!majorOnlyMatch) return null;
+	const major = Number.parseInt(majorOnlyMatch[1], 10);
+	if (!Number.isFinite(major) || major <= 0) return null;
+	return {
+		major,
+		minor: 0
+	};
+};
+const isReactAtLeast = (detected, required) => {
+	if (detected === null) return true;
+	if (detected.major !== required.major) return detected.major > required.major;
+	return detected.minor >= required.minor;
+};
 const parseTailwindMajorMinor = (tailwindVersion) => {
 	if (typeof tailwindVersion !== "string") return null;
 	const trimmed = tailwindVersion.trim();
@@ -3001,6 +3047,7 @@ const isTailwindAtLeast = (detected, required) => {
 	return detected.minor >= required.minor;
 };
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
+const MILLISECONDS_PER_SECOND = 1e3;
 const SCORE_API_URL = "https://www.react.doctor/api/score";
 const FETCH_TIMEOUT_MS = 1e4;
 const GITHUB_VIEWER_PERMISSION_TIMEOUT_MS = 2e3;
@@ -4522,6 +4569,49 @@ const collectIgnorePatterns = (rootDirectory) => {
 	return patterns;
 };
 const TSCONFIG_FILENAMES$1 = ["tsconfig.json", "tsconfig.base.json"];
+const DEAD_CODE_WORKER_SCRIPT = `
+const { parentPort, workerData } = require("node:worker_threads");
+
+const normalizeResult = (result) => ({
+  unusedFiles: result.unusedFiles.map((unusedFile) => ({
+    path: unusedFile.path,
+  })),
+  unusedExports: result.unusedExports.map((unusedExport) => ({
+    path: unusedExport.path,
+    name: unusedExport.name,
+    line: unusedExport.line,
+    column: unusedExport.column,
+    isTypeOnly: unusedExport.isTypeOnly,
+  })),
+  unusedDependencies: result.unusedDependencies.map((unusedDependency) => ({
+    name: unusedDependency.name,
+    isDevDependency: unusedDependency.isDevDependency,
+  })),
+  circularDependencies: result.circularDependencies.map((cycle) => ({
+    files: cycle.files,
+  })),
+});
+
+const serializeError = (error) =>
+  error instanceof Error
+    ? { name: error.name, message: error.message, stack: error.stack }
+    : { message: String(error) };
+
+(async () => {
+  try {
+    const { analyze, defineConfig } = await import(workerData.deslopJsModuleSpecifier);
+    const config = {
+      rootDir: workerData.rootDirectory,
+      ...(workerData.tsConfigPath ? { tsConfigPath: workerData.tsConfigPath } : {}),
+      ...(workerData.ignorePatterns.length > 0 ? { ignorePatterns: workerData.ignorePatterns } : {}),
+    };
+    const result = await analyze(defineConfig(config));
+    parentPort.postMessage({ ok: true, result: normalizeResult(result) });
+  } catch (error) {
+    parentPort.postMessage({ ok: false, error: serializeError(error) });
+  }
+})();
+`;
 const resolveTsConfigPath = (rootDirectory) => {
 	for (const filename of TSCONFIG_FILENAMES$1) {
 		const candidate = path.join(rootDirectory, filename);
@@ -4542,16 +4632,180 @@ const toRelativeFilePath = (rootDirectory, filePath) => {
 	const relative = toRelativePath(filePath, rootDirectory);
 	return relative.length > 0 ? relative : filePath.replace(/\\/g, "/");
 };
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parseArray = (value, label) => {
+	if (!Array.isArray(value)) throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseString = (value, label) => {
+	if (typeof value !== "string") throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseNumber = (value, label) => {
+	if (typeof value !== "number") throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseBoolean = (value, label) => {
+	if (typeof value !== "boolean") throw new Error(`Dead-code worker returned invalid ${label}.`);
+	return value;
+};
+const parseStringArray = (value, label) => {
+	return parseArray(value, label).map((entry, index) => parseString(entry, `${label}[${index}]`));
+};
+const parseUnusedFiles = (value) => {
+	const values = parseArray(value, "unusedFiles");
+	const unusedFiles = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid unusedFiles[${index}].`);
+		unusedFiles.push({ path: parseString(entry.path, `unusedFiles[${index}].path`) });
+	}
+	return unusedFiles;
+};
+const parseUnusedExports = (value) => {
+	const values = parseArray(value, "unusedExports");
+	const unusedExports = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid unusedExports[${index}].`);
+		unusedExports.push({
+			path: parseString(entry.path, `unusedExports[${index}].path`),
+			name: parseString(entry.name, `unusedExports[${index}].name`),
+			line: parseNumber(entry.line, `unusedExports[${index}].line`),
+			column: parseNumber(entry.column, `unusedExports[${index}].column`),
+			isTypeOnly: parseBoolean(entry.isTypeOnly, `unusedExports[${index}].isTypeOnly`)
+		});
+	}
+	return unusedExports;
+};
+const parseUnusedDependencies = (value) => {
+	const values = parseArray(value, "unusedDependencies");
+	const unusedDependencies = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid unusedDependencies[${index}].`);
+		unusedDependencies.push({
+			name: parseString(entry.name, `unusedDependencies[${index}].name`),
+			isDevDependency: parseBoolean(entry.isDevDependency, `unusedDependencies[${index}].isDevDependency`)
+		});
+	}
+	return unusedDependencies;
+};
+const parseCircularDependencies = (value) => {
+	const values = parseArray(value, "circularDependencies");
+	const circularDependencies = [];
+	for (const [index, entry] of values.entries()) {
+		if (!isRecord(entry)) throw new Error(`Dead-code worker returned invalid circularDependencies[${index}].`);
+		circularDependencies.push({ files: parseStringArray(entry.files, `circularDependencies[${index}].files`) });
+	}
+	return circularDependencies;
+};
+const parseDeadCodeWorkerResult = (value) => {
+	if (!isRecord(value)) throw new Error("Dead-code worker returned an invalid result.");
+	return {
+		unusedFiles: parseUnusedFiles(value.unusedFiles),
+		unusedExports: parseUnusedExports(value.unusedExports),
+		unusedDependencies: parseUnusedDependencies(value.unusedDependencies),
+		circularDependencies: parseCircularDependencies(value.circularDependencies)
+	};
+};
+const parseDeadCodeWorkerError = (value) => {
+	if (!isRecord(value) || typeof value.message !== "string") return { message: "Dead-code worker failed." };
+	return {
+		...typeof value.name === "string" ? { name: value.name } : {},
+		message: value.message,
+		...typeof value.stack === "string" ? { stack: value.stack } : {}
+	};
+};
+const parseDeadCodeWorkerMessage = (value) => {
+	if (!isRecord(value)) throw new Error("Dead-code worker returned an invalid message.");
+	if (value.ok === true) return {
+		ok: true,
+		result: value.result
+	};
+	if (value.ok === false) return {
+		ok: false,
+		error: parseDeadCodeWorkerError(value.error)
+	};
+	throw new Error("Dead-code worker returned an invalid status.");
+};
+const buildDeadCodeWorkerError = (workerError) => {
+	const error = new Error(workerError.message);
+	if (workerError.name !== void 0) error.name = workerError.name;
+	if (workerError.stack !== void 0) error.stack = workerError.stack;
+	return error;
+};
+const createDeadCodeWorker = (input) => {
+	const worker = new Worker(DEAD_CODE_WORKER_SCRIPT, {
+		eval: true,
+		workerData: input
+	});
+	let didSettle = false;
+	return {
+		result: new Promise((resolve, reject) => {
+			const settle = (callback) => {
+				if (didSettle) return;
+				didSettle = true;
+				worker.removeAllListeners();
+				callback();
+			};
+			worker.once("message", (message) => {
+				try {
+					const parsedMessage = parseDeadCodeWorkerMessage(message);
+					if (parsedMessage.ok) {
+						settle(() => resolve(parsedMessage.result));
+						return;
+					}
+					settle(() => reject(buildDeadCodeWorkerError(parsedMessage.error)));
+				} catch (error) {
+					settle(() => reject(error));
+				}
+			});
+			worker.once("error", (error) => {
+				settle(() => reject(error));
+			});
+			worker.once("exit", (exitCode) => {
+				if (exitCode === 0) return;
+				settle(() => reject(/* @__PURE__ */ new Error(`Dead-code worker exited with code ${exitCode}.`)));
+			});
+		}),
+		terminate: () => {
+			didSettle = true;
+			worker.removeAllListeners();
+			return worker.terminate();
+		}
+	};
+};
+const runDeadCodeWorkerWithTimeout = (handle, timeoutMs) => new Promise((resolve, reject) => {
+	let didSettle = false;
+	const timeoutHandle = setTimeout(() => {
+		if (didSettle) return;
+		didSettle = true;
+		handle.terminate?.();
+		reject(/* @__PURE__ */ new Error(`Dead-code worker timed out after ${timeoutMs / MILLISECONDS_PER_SECOND}s.`));
+	}, timeoutMs);
+	timeoutHandle.unref?.();
+	handle.result.then((value) => {
+		if (didSettle) return;
+		didSettle = true;
+		clearTimeout(timeoutHandle);
+		handle.terminate?.();
+		resolve(value);
+	}, (error) => {
+		if (didSettle) return;
+		didSettle = true;
+		clearTimeout(timeoutHandle);
+		handle.terminate?.();
+		reject(error);
+	});
+});
 const checkDeadCode = async (options) => {
 	const { rootDirectory, userConfig } = options;
 	if (!fs.existsSync(path.join(rootDirectory, "package.json"))) return [];
-	const { analyze, defineConfig } = await import("deslop-js");
 	const ignorePatterns = collectDeadCodeIgnorePatterns(rootDirectory, userConfig);
-	const result = await analyze(defineConfig({
-		rootDir: rootDirectory,
+	const result = parseDeadCodeWorkerResult(await runDeadCodeWorkerWithTimeout((options.createWorker ?? createDeadCodeWorker)({
+		rootDirectory,
 		tsConfigPath: resolveTsConfigPath(rootDirectory),
-		...ignorePatterns.length > 0 ? { ignorePatterns } : {}
-	}));
+		ignorePatterns,
+		deslopJsModuleSpecifier: options.deslopJsModuleSpecifier ?? import.meta.resolve("deslop-js")
+	}), options.workerTimeoutMs ?? 12e4));
 	const toRelative = (filePath) => toRelativeFilePath(rootDirectory, filePath);
 	const diagnostics = [];
 	for (const unusedFile of result.unusedFiles) diagnostics.push({
@@ -5175,7 +5429,15 @@ const buildCapabilities = (project) => {
 	capabilities.add(project.framework);
 	if (project.framework === "expo" || project.framework === "react-native" || project.hasReactNativeWorkspace) capabilities.add("react-native");
 	const reactMajor = project.reactMajorVersion;
-	if (reactMajor !== null) for (let major = 17; major <= reactMajor; major++) capabilities.add(`react:${major}`);
+	if (reactMajor !== null) {
+		for (let major = 17; major <= reactMajor; major++) capabilities.add(`react:${major}`);
+		if (reactMajor >= 19) {
+			if (isReactAtLeast(parseReactMajorMinor(project.reactVersion), {
+				major: 19,
+				minor: 2
+			})) capabilities.add("react:19.2");
+		}
+	}
 	if (project.tailwindVersion !== null) {
 		capabilities.add("tailwind");
 		if (isTailwindAtLeast(parseTailwindMajorMinor(project.tailwindVersion), {
@@ -5186,6 +5448,10 @@ const buildCapabilities = (project) => {
 	if (project.hasReactCompiler) capabilities.add("react-compiler");
 	if (project.hasTanStackQuery) capabilities.add("tanstack-query");
 	if (project.hasTypeScript) capabilities.add("typescript");
+	if (project.hasPreact) {
+		capabilities.add("preact");
+		if (project.reactVersion === null) capabilities.add("pure-preact");
+	}
 	return capabilities;
 };
 const shouldEnableRule = (requires, tags, capabilities, ignoredTags, disabledBy) => {
@@ -6515,17 +6781,6 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 		didFail: false,
 		reason: null
 	});
-	const shouldRunDeadCode = input.runDeadCode && !isDiffMode;
-	const deadCodeFiber = yield* Effect.forkChild(shouldRunDeadCode ? Stream.runCollect(applyPerElementPipeline(deadCodeService.run({
-		rootDirectory: scanDirectory,
-		userConfig: resolvedConfig.config
-	}).pipe(Stream.catchTag("ReactDoctorError", (error) => Stream.unwrap(Effect.gen(function* () {
-		yield* Ref.set(deadCodeFailure, {
-			didFail: true,
-			reason: error.message
-		});
-		return Stream.empty;
-	})))))) : Effect.succeed([]));
 	const scanProgress = yield* progressService.start("Scanning...");
 	const scanStartTime = Date.now();
 	let lastReportedTotalFileCount = 0;
@@ -6555,11 +6810,18 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 	const lintCollected = yield* Stream.runCollect(applyPerElementPipeline(rawLintStream));
 	const lintFailureState = yield* Ref.get(lintFailure);
 	yield* afterLint(lintFailureState.didFail);
-	if (lintFailureState.didFail) {
-		yield* Fiber.interrupt(deadCodeFiber);
-		yield* scanProgress.fail(formatLintFailText(lintFailureState.reasonTag, process.version));
-	}
-	const deadCodeCollected = lintFailureState.didFail ? [] : yield* Fiber.join(deadCodeFiber);
+	if (lintFailureState.didFail) yield* scanProgress.fail(formatLintFailText(lintFailureState.reasonTag, process.version));
+	const shouldRunDeadCode = input.runDeadCode && !isDiffMode;
+	const deadCodeCollected = lintFailureState.didFail || !shouldRunDeadCode ? [] : yield* scanProgress.update("Analyzing dead code...").pipe(Effect.andThen(Stream.runCollect(applyPerElementPipeline(deadCodeService.run({
+		rootDirectory: scanDirectory,
+		userConfig: resolvedConfig.config
+	}).pipe(Stream.catchTag("ReactDoctorError", (error) => Stream.unwrap(Effect.gen(function* () {
+		yield* Ref.set(deadCodeFailure, {
+			didFail: true,
+			reason: error.message
+		});
+		return Stream.empty;
+	}))))))));
 	const deadCodeFailureState = yield* Ref.get(deadCodeFailure);
 	const scanElapsedSeconds = ((Date.now() - scanStartTime) / 1e3).toFixed(1);
 	const totalFileCount = lastReportedTotalFileCount || (lintIncludePaths?.length ?? project.sourceFileCount);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-doctor",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Diagnose and fix React codebases for security, performance, correctness, accessibility, bundle-size, and architecture issues",
   "keywords": [
     "accessibility",
@@ -58,14 +58,14 @@
     "oxlint": "^1.66.0",
     "prompts": "^2.4.2",
     "typescript": ">=5.0.4 <7",
-    "oxlint-plugin-react-doctor": "0.2.9"
+    "oxlint-plugin-react-doctor": "0.2.10"
   },
   "devDependencies": {
     "@types/prompts": "^2.4.9",
     "commander": "^14.0.3",
     "ora": "^9.4.0",
-    "@react-doctor/api": "0.2.9",
-    "@react-doctor/core": "0.2.9"
+    "@react-doctor/api": "0.2.10",
+    "@react-doctor/core": "0.2.10"
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"