react-doctor 0.0.37 → 0.0.40

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/utils/get-diff-files.ts","../src/index.ts"],"mappings":";KAAY,WAAA;AAAA,KAEA,SAAA;AAAA,UAWK,WAAA;EACf,aAAA;EACA,WAAA;EACA,YAAA;EACA,SAAA,EAAW,SAAA;EACX,aAAA;EACA,gBAAA;EACA,eAAA;AAAA;AAAA,UAiCe,UAAA;EACf,QAAA;EACA,MAAA;EACA,IAAA;EACA,QAAA;EACA,OAAA;EACA,IAAA;EACA,IAAA;EACA,MAAA;EACA,QAAA;EACA,MAAA;AAAA;AAAA,UA4Be,WAAA;EACf,KAAA;EACA,KAAA;AAAA;AAAA,UAmBe,QAAA;EACf,aAAA;EACA,UAAA;EACA,YAAA;EACA,gBAAA;AAAA;AAAA,UA2Ce,uBAAA;EACf,KAAA;EACA,KAAA;AAAA;AAAA,UAGe,iBAAA;EACf,MAAA,GAAS,uBAAA;EACT,IAAA;EACA,QAAA;EACA,OAAA;EACA,IAAA;EACA,MAAA,GAAS,WAAA;EACT,eAAA;EACA,KAAA;EACA,cAAA;AAAA;;;cC9FW,WAAA,GAAe,SAAA,UAAmB,kBAAA,cAA8B,QAAA;AAAA,cAiBhE,iBAAA,GAAqB,SAAA;;;UClFjB,eAAA;EACf,IAAA;EACA,QAAA;EACA,YAAA;AAAA;AAAA,UAGe,cAAA;EACf,WAAA,EAAa,UAAA;EACb,KAAA,EAAO,WAAA;EACP,OAAA,EAAS,WAAA;EACT,mBAAA;AAAA;AAAA,cAGW,QAAA,GACX,SAAA,UACA,OAAA,GAAS,eAAA,KACR,OAAA,CAAQ,cAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/utils/get-diff-files.ts","../src/index.ts"],"mappings":";KAAY,WAAA;AAAA,KAEA,SAAA;AAAA,UAWK,WAAA;EACf,aAAA;EACA,WAAA;EACA,YAAA;EACA,SAAA,EAAW,SAAA;EACX,aAAA;EACA,gBAAA;EACA,eAAA;AAAA;AAAA,UAiCe,UAAA;EACf,QAAA;EACA,MAAA;EACA,IAAA;EACA,QAAA;EACA,OAAA;EACA,IAAA;EACA,IAAA;EACA,MAAA;EACA,QAAA;EACA,MAAA;AAAA;AAAA,UA4Be,WAAA;EACf,KAAA;EACA,KAAA;AAAA;AAAA,UAmBe,QAAA;EACf,aAAA;EACA,UAAA;EACA,YAAA;EACA,gBAAA;AAAA;AAAA,UA2Ce,uBAAA;EACf,KAAA;EACA,KAAA;AAAA;AAAA,UAGe,iBAAA;EACf,MAAA,GAAS,uBAAA;EACT,IAAA;EACA,QAAA;EACA,OAAA;EACA,IAAA;EACA,MAAA,GAAS,WAAA;EACT,eAAA;EACA,KAAA;EACA,cAAA;AAAA;;;cC9FW,WAAA,GAAe,SAAA,UAAmB,kBAAA,cAA8B,QAAA;AAAA,cAiBhE,iBAAA,GAAqB,SAAA;;;UChFjB,eAAA;EACf,IAAA;EACA,QAAA;EACA,YAAA;AAAA;AAAA,UAGe,cAAA;EACf,WAAA,EAAa,UAAA;EACb,KAAA,EAAO,WAAA;EACP,OAAA,EAAS,WAAA;EACT,mBAAA;AAAA;AAAA,cAGW,QAAA,GACX,SAAA,UACA,OAAA,GAAS,eAAA,KACR,OAAA,CAAQ,cAAA"}

package/dist/index.js

@@ -1,6 +1,5 @@
 import { createRequire } from "node:module";
 import path from "node:path";
-import { performance } from "node:perf_hooks";
 import { execSync, spawn, spawnSync } from "node:child_process";
 import fs from "node:fs";
 import { main } from "knip";
@@ -8,194 +7,13 @@ import { createOptions } from "knip/session";
 import os from "node:os";
 import { fileURLToPath } from "node:url";
 
-//#region src/constants.ts
-const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?)$/;
-const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
-const ERROR_PREVIEW_LENGTH_CHARS = 200;
-const PERFECT_SCORE = 100;
-const SCORE_GOOD_THRESHOLD = 75;
-const SCORE_OK_THRESHOLD = 50;
-const SCORE_API_URL = "https://www.react.doctor/api/score";
-const FETCH_TIMEOUT_MS = 1e4;
-const GIT_LS_FILES_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
-const SPAWN_ARGS_MAX_LENGTH_CHARS = 24e3;
-const OXLINT_MAX_FILES_PER_BATCH = 500;
-const DEFAULT_BRANCH_CANDIDATES = ["main", "master"];
-const ERROR_RULE_PENALTY = 1.5;
-const WARNING_RULE_PENALTY = .75;
-const MAX_KNIP_RETRIES = 5;
-const GIT_SHOW_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
-const IGNORED_DIRECTORIES = new Set([
-	"node_modules",
-	"dist",
-	"build",
-	"coverage"
-]);
-
-//#endregion
-//#region src/utils/proxy-fetch.ts
-const readNpmConfigValue = (key) => {
-	try {
-		const value = execSync(`npm config get ${key}`, {
-			encoding: "utf-8",
-			stdio: [
-				"pipe",
-				"pipe",
-				"ignore"
-			]
-		}).trim();
-		if (value && value !== "null" && value !== "undefined") return value;
-	} catch {}
-};
-const resolveProxyUrl = () => process.env.HTTPS_PROXY ?? process.env.https_proxy ?? process.env.HTTP_PROXY ?? process.env.http_proxy ?? readNpmConfigValue("https-proxy") ?? readNpmConfigValue("proxy");
-let isProxyUrlResolved = false;
-let resolvedProxyUrl;
-const getProxyUrl = () => {
-	if (isProxyUrlResolved) return resolvedProxyUrl;
-	isProxyUrlResolved = true;
-	resolvedProxyUrl = resolveProxyUrl();
-	return resolvedProxyUrl;
-};
-const createProxyDispatcher = async (proxyUrl) => {
-	try {
-		const { ProxyAgent } = await import("undici");
-		return new ProxyAgent(proxyUrl);
-	} catch {
-		return null;
-	}
-};
-const proxyFetch = async (url, init) => {
-	const controller = new AbortController();
-	const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
-	try {
-		const proxyUrl = getProxyUrl();
-		const dispatcher = proxyUrl ? await createProxyDispatcher(proxyUrl) : null;
-		return await fetch(url, {
-			...init,
-			signal: controller.signal,
-			...dispatcher ? { dispatcher } : {}
-		});
-	} finally {
-		clearTimeout(timeoutId);
-	}
-};
-
-//#endregion
-//#region src/utils/calculate-score.ts
-const getScoreLabel = (score) => {
-	if (score >= SCORE_GOOD_THRESHOLD) return "Great";
-	if (score >= SCORE_OK_THRESHOLD) return "Needs work";
-	return "Critical";
-};
-const countUniqueRules = (diagnostics) => {
-	const errorRules = /* @__PURE__ */ new Set();
-	const warningRules = /* @__PURE__ */ new Set();
-	for (const diagnostic of diagnostics) {
-		const ruleKey = `${diagnostic.plugin}/${diagnostic.rule}`;
-		if (diagnostic.severity === "error") errorRules.add(ruleKey);
-		else warningRules.add(ruleKey);
-	}
-	return {
-		errorRuleCount: errorRules.size,
-		warningRuleCount: warningRules.size
-	};
-};
-const scoreFromRuleCounts = (errorRuleCount, warningRuleCount) => {
-	const penalty = errorRuleCount * ERROR_RULE_PENALTY + warningRuleCount * WARNING_RULE_PENALTY;
-	return Math.max(0, Math.round(PERFECT_SCORE - penalty));
-};
-const calculateScoreLocally = (diagnostics) => {
-	const { errorRuleCount, warningRuleCount } = countUniqueRules(diagnostics);
-	const score = scoreFromRuleCounts(errorRuleCount, warningRuleCount);
-	return {
-		score,
-		label: getScoreLabel(score)
-	};
-};
-const calculateScore = async (diagnostics) => {
-	try {
-		const response = await proxyFetch(SCORE_API_URL, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify({ diagnostics })
-		});
-		if (!response.ok) return calculateScoreLocally(diagnostics);
-		return await response.json();
-	} catch {
-		return calculateScoreLocally(diagnostics);
-	}
-};
-
-//#endregion
-//#region src/plugin/constants.ts
-const MOTION_LIBRARY_PACKAGES = new Set(["framer-motion", "motion"]);
-
-//#endregion
-//#region src/utils/is-file.ts
-const isFile = (filePath) => {
-	try {
-		return fs.statSync(filePath).isFile();
-	} catch {
-		return false;
-	}
-};
-
-//#endregion
-//#region src/utils/read-package-json.ts
-const readPackageJson = (packageJsonPath) => {
-	try {
-		return JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
-	} catch (error) {
-		if (error instanceof SyntaxError) return {};
-		if (error instanceof Error && "code" in error) {
-			const { code } = error;
-			if (code === "EISDIR" || code === "EACCES") return {};
-		}
-		throw error;
-	}
-};
-
-//#endregion
-//#region src/utils/check-reduced-motion.ts
-const REDUCED_MOTION_GREP_PATTERN = "prefers-reduced-motion|useReducedMotion|MotionConfig|reducedMotion";
-const REDUCED_MOTION_FILE_GLOBS = "\"*.ts\" \"*.tsx\" \"*.js\" \"*.jsx\" \"*.css\" \"*.scss\"";
-const MISSING_REDUCED_MOTION_DIAGNOSTIC = {
-	filePath: "package.json",
-	plugin: "react-doctor",
-	rule: "require-reduced-motion",
-	severity: "error",
-	message: "Project uses a motion library but has no prefers-reduced-motion handling — required for accessibility (WCAG 2.3.3)",
-	help: "Add `useReducedMotion()` from your animation library, or a `@media (prefers-reduced-motion: reduce)` CSS query",
-	line: 0,
-	column: 0,
-	category: "Accessibility",
-	weight: 2
-};
-const checkReducedMotion = (rootDirectory) => {
-	const packageJsonPath = path.join(rootDirectory, "package.json");
-	if (!isFile(packageJsonPath)) return [];
-	let hasMotionLibrary = false;
-	try {
-		const packageJson = readPackageJson(packageJsonPath);
-		const allDependencies = {
-			...packageJson.dependencies,
-			...packageJson.devDependencies
-		};
-		hasMotionLibrary = Object.keys(allDependencies).some((packageName) => MOTION_LIBRARY_PACKAGES.has(packageName));
-	} catch {
-		return [];
-	}
-	if (!hasMotionLibrary) return [];
-	try {
-		execSync(`git grep -ql -E "${REDUCED_MOTION_GREP_PATTERN}" -- ${REDUCED_MOTION_FILE_GLOBS}`, {
-			cwd: rootDirectory,
-			stdio: "pipe"
-		});
-		return [];
-	} catch {
-		return [MISSING_REDUCED_MOTION_DIAGNOSTIC];
-	}
-};
+//#region src/core/build-diagnose-result.ts
+const buildDiagnoseResult = (params) => ({
+	diagnostics: params.diagnostics,
+	score: params.score,
+	project: params.project,
+	elapsedMilliseconds: params.elapsedMilliseconds
+});
 
 //#endregion
 //#region src/utils/match-glob-pattern.ts
@@ -242,23 +60,22 @@ const isFileIgnoredByPatterns = (filePath, rootDirectory, patterns) => {
 
 //#endregion
 //#region src/utils/filter-diagnostics.ts
+const resolveCandidateReadPath = (rootDirectory, filePath) => {
+	const normalizedFile = filePath.replace(/\\/g, "/");
+	if (normalizedFile.startsWith("/") || /^[a-zA-Z]:\//.test(normalizedFile) || /^[a-zA-Z]:\\/.test(filePath)) return filePath;
+	return `${rootDirectory.replace(/\\/g, "/").replace(/\/$/, "")}/${normalizedFile.replace(/^\.\//, "")}`;
+};
 const OPENING_TAG_PATTERN = /<([A-Z][\w.]*)/;
 const DISABLE_NEXT_LINE_PATTERN = /\/\/\s*react-doctor-disable-next-line\b(?:\s+(.+))?/;
 const DISABLE_LINE_PATTERN = /\/\/\s*react-doctor-disable-line\b(?:\s+(.+))?/;
-const createFileLinesCache = (rootDirectory) => {
+const createFileLinesCache = (rootDirectory, readFileLinesSync) => {
 	const cache = /* @__PURE__ */ new Map();
 	return (filePath) => {
 		const cached = cache.get(filePath);
 		if (cached !== void 0) return cached;
-		const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(rootDirectory, filePath);
-		try {
-			const lines = fs.readFileSync(absolutePath, "utf-8").split("\n");
-			cache.set(filePath, lines);
-			return lines;
-		} catch {
-			cache.set(filePath, null);
-			return null;
-		}
+		const lines = readFileLinesSync(resolveCandidateReadPath(rootDirectory, filePath));
+		cache.set(filePath, lines);
+		return lines;
 	};
 };
 const isInsideTextComponent = (lines, diagnosticLine, textComponentNames) => {
@@ -275,12 +92,12 @@ const isRuleSuppressed = (commentRules, ruleId) => {
 	if (!commentRules?.trim()) return true;
 	return commentRules.split(/[,\s]+/).some((rule) => rule.trim() === ruleId);
 };
-const filterIgnoredDiagnostics = (diagnostics, config, rootDirectory) => {
+const filterIgnoredDiagnostics = (diagnostics, config, rootDirectory, readFileLinesSync) => {
 	const ignoredRules = new Set(Array.isArray(config.ignore?.rules) ? config.ignore.rules : []);
 	const ignoredFilePatterns = compileIgnoredFilePatterns(config);
 	const textComponentNames = new Set(Array.isArray(config.textComponents) ? config.textComponents : []);
 	const hasTextComponents = textComponentNames.size > 0;
-	const getFileLines = createFileLinesCache(rootDirectory);
+	const getFileLines = createFileLinesCache(rootDirectory, readFileLinesSync);
 	return diagnostics.filter((diagnostic) => {
 		const ruleIdentifier = `${diagnostic.plugin}/${diagnostic.rule}`;
 		if (ignoredRules.has(ruleIdentifier)) return false;
@@ -292,8 +109,8 @@ const filterIgnoredDiagnostics = (diagnostics, config, rootDirectory) => {
 		return true;
 	});
 };
-const filterInlineSuppressions = (diagnostics, rootDirectory) => {
-	const getFileLines = createFileLinesCache(rootDirectory);
+const filterInlineSuppressions = (diagnostics, rootDirectory, readFileLinesSync) => {
+	const getFileLines = createFileLinesCache(rootDirectory, readFileLinesSync);
 	return diagnostics.filter((diagnostic) => {
 		if (diagnostic.line <= 0) return true;
 		const lines = getFileLines(diagnostic.filePath);
@@ -316,15 +133,172 @@ const filterInlineSuppressions = (diagnostics, rootDirectory) => {
 };
 
 //#endregion
-//#region src/utils/combine-diagnostics.ts
+//#region src/utils/merge-and-filter-diagnostics.ts
+const mergeAndFilterDiagnostics = (mergedDiagnostics, directory, userConfig, readFileLinesSync) => {
+	return filterInlineSuppressions(userConfig ? filterIgnoredDiagnostics(mergedDiagnostics, userConfig, directory, readFileLinesSync) : mergedDiagnostics, directory, readFileLinesSync);
+};
+
+//#endregion
+//#region src/core/build-result.ts
+const buildDiagnoseTimedResult = async (input) => {
+	const diagnostics = mergeAndFilterDiagnostics(input.mergedDiagnostics, input.rootDirectory, input.userConfig, input.readFileLinesSync);
+	const elapsedMilliseconds = globalThis.performance.now() - input.startTime;
+	return {
+		diagnostics,
+		score: input.score !== void 0 ? input.score : await input.calculateDiagnosticsScore(diagnostics),
+		elapsedMilliseconds
+	};
+};
+
+//#endregion
+//#region src/constants.ts
+const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?)$/;
+const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
+const ERROR_PREVIEW_LENGTH_CHARS = 200;
+const PERFECT_SCORE = 100;
+const SCORE_GOOD_THRESHOLD = 75;
+const SCORE_OK_THRESHOLD = 50;
+const SCORE_API_URL = "https://www.react.doctor/api/score";
+const FETCH_TIMEOUT_MS = 1e4;
+const GIT_LS_FILES_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
+const SPAWN_ARGS_MAX_LENGTH_CHARS = 24e3;
+const OXLINT_MAX_FILES_PER_BATCH = 500;
+const DEFAULT_BRANCH_CANDIDATES = ["main", "master"];
+const ERROR_RULE_PENALTY = 1.5;
+const WARNING_RULE_PENALTY = .75;
+const MAX_KNIP_RETRIES = 5;
+const GIT_SHOW_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
+const IGNORED_DIRECTORIES = new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"coverage"
+]);
+
+//#endregion
+//#region src/utils/jsx-include-paths.ts
 const computeJsxIncludePaths = (includePaths) => includePaths.length > 0 ? includePaths.filter((filePath) => JSX_FILE_PATTERN.test(filePath)) : void 0;
-const combineDiagnostics = (lintDiagnostics, deadCodeDiagnostics, directory, isDiffMode, userConfig) => {
-	const merged = [
-		...lintDiagnostics,
-		...deadCodeDiagnostics,
-		...isDiffMode ? [] : checkReducedMotion(directory)
-	];
-	return filterInlineSuppressions(userConfig ? filterIgnoredDiagnostics(merged, userConfig, directory) : merged, directory);
+
+//#endregion
+//#region src/core/diagnose-core.ts
+const diagnoseCore = async (deps, options = {}) => {
+	const { includePaths = [] } = options;
+	const isDiffMode = includePaths.length > 0;
+	const startTime = globalThis.performance.now();
+	const resolvedDirectory = deps.rootDirectory;
+	const projectInfo = deps.discoverProjectInfo();
+	const userConfig = deps.loadUserConfig();
+	const effectiveLint = options.lint ?? userConfig?.lint ?? true;
+	const effectiveDeadCode = options.deadCode ?? userConfig?.deadCode ?? true;
+	if (!projectInfo.reactVersion) throw new Error("No React dependency found in package.json");
+	const lintIncludePaths = options.lintIncludePaths !== void 0 ? options.lintIncludePaths : computeJsxIncludePaths(includePaths);
+	const { runLint, runDeadCode } = deps.createRunners({
+		resolvedDirectory,
+		projectInfo,
+		userConfig,
+		lintIncludePaths,
+		isDiffMode
+	});
+	const emptyDiagnostics = [];
+	const lintPromise = effectiveLint ? runLint().catch((error) => {
+		console.error("Lint failed:", error);
+		return emptyDiagnostics;
+	}) : Promise.resolve(emptyDiagnostics);
+	const deadCodePromise = effectiveDeadCode && !isDiffMode ? runDeadCode().catch((error) => {
+		console.error("Dead code analysis failed:", error);
+		return emptyDiagnostics;
+	}) : Promise.resolve(emptyDiagnostics);
+	const [lintDiagnostics, deadCodeDiagnostics] = await Promise.all([lintPromise, deadCodePromise]);
+	const environmentDiagnostics = deps.getExtraDiagnostics?.() ?? [];
+	const timed = await buildDiagnoseTimedResult({
+		mergedDiagnostics: [
+			...lintDiagnostics,
+			...deadCodeDiagnostics,
+			...environmentDiagnostics
+		],
+		rootDirectory: resolvedDirectory,
+		userConfig,
+		readFileLinesSync: deps.readFileLinesSync,
+		startTime,
+		calculateDiagnosticsScore: deps.calculateDiagnosticsScore
+	});
+	return buildDiagnoseResult({
+		diagnostics: timed.diagnostics,
+		score: timed.score,
+		project: projectInfo,
+		elapsedMilliseconds: timed.elapsedMilliseconds
+	});
+};
+
+//#endregion
+//#region src/plugin/constants.ts
+const MOTION_LIBRARY_PACKAGES = new Set(["framer-motion", "motion"]);
+
+//#endregion
+//#region src/utils/is-file.ts
+const isFile = (filePath) => {
+	try {
+		return fs.statSync(filePath).isFile();
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region src/utils/read-package-json.ts
+const readPackageJson = (packageJsonPath) => {
+	try {
+		return JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+	} catch (error) {
+		if (error instanceof SyntaxError) return {};
+		if (error instanceof Error && "code" in error) {
+			const { code } = error;
+			if (code === "EISDIR" || code === "EACCES") return {};
+		}
+		throw error;
+	}
+};
+
+//#endregion
+//#region src/utils/check-reduced-motion.ts
+const REDUCED_MOTION_GREP_PATTERN = "prefers-reduced-motion|useReducedMotion|MotionConfig|reducedMotion";
+const REDUCED_MOTION_FILE_GLOBS = "\"*.ts\" \"*.tsx\" \"*.js\" \"*.jsx\" \"*.css\" \"*.scss\"";
+const MISSING_REDUCED_MOTION_DIAGNOSTIC = {
+	filePath: "package.json",
+	plugin: "react-doctor",
+	rule: "require-reduced-motion",
+	severity: "error",
+	message: "Project uses a motion library but has no prefers-reduced-motion handling — required for accessibility (WCAG 2.3.3)",
+	help: "Add `useReducedMotion()` from your animation library, or a `@media (prefers-reduced-motion: reduce)` CSS query",
+	line: 0,
+	column: 0,
+	category: "Accessibility",
+	weight: 2
+};
+const checkReducedMotion = (rootDirectory) => {
+	const packageJsonPath = path.join(rootDirectory, "package.json");
+	if (!isFile(packageJsonPath)) return [];
+	let hasMotionLibrary = false;
+	try {
+		const packageJson = readPackageJson(packageJsonPath);
+		const allDependencies = {
+			...packageJson.dependencies,
+			...packageJson.devDependencies
+		};
+		hasMotionLibrary = Object.keys(allDependencies).some((packageName) => MOTION_LIBRARY_PACKAGES.has(packageName));
+	} catch {
+		return [];
+	}
+	if (!hasMotionLibrary) return [];
+	try {
+		execSync(`git grep -ql -E "${REDUCED_MOTION_GREP_PATTERN}" -- ${REDUCED_MOTION_FILE_GLOBS}`, {
+			cwd: rootDirectory,
+			stdio: "pipe"
+		});
+		return [];
+	} catch {
+		return [MISSING_REDUCED_MOTION_DIAGNOSTIC];
+	}
 };
 
 //#endregion
@@ -728,6 +702,19 @@ const loadConfig = (rootDirectory) => {
 	return null;
 };
 
+//#endregion
+//#region src/utils/read-file-lines-node.ts
+const createNodeReadFileLinesSync = (rootDirectory) => {
+	return (filePath) => {
+		const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(rootDirectory, filePath);
+		try {
+			return fs.readFileSync(absolutePath, "utf-8").split("\n");
+		} catch {
+			return null;
+		}
+	};
+};
+
 //#endregion
 //#region src/utils/resolve-lint-include-paths.ts
 const listSourceFilesViaGit = (rootDirectory) => {
@@ -771,6 +758,136 @@ const resolveLintIncludePaths = (rootDirectory, userConfig) => {
 	});
 };
 
+//#endregion
+//#region src/core/calculate-score-locally.ts
+const getScoreLabel = (score) => {
+	if (score >= SCORE_GOOD_THRESHOLD) return "Great";
+	if (score >= SCORE_OK_THRESHOLD) return "Needs work";
+	return "Critical";
+};
+const countUniqueRules = (diagnostics) => {
+	const errorRules = /* @__PURE__ */ new Set();
+	const warningRules = /* @__PURE__ */ new Set();
+	for (const diagnostic of diagnostics) {
+		const ruleKey = `${diagnostic.plugin}/${diagnostic.rule}`;
+		if (diagnostic.severity === "error") errorRules.add(ruleKey);
+		else warningRules.add(ruleKey);
+	}
+	return {
+		errorRuleCount: errorRules.size,
+		warningRuleCount: warningRules.size
+	};
+};
+const scoreFromRuleCounts = (errorRuleCount, warningRuleCount) => {
+	const penalty = errorRuleCount * ERROR_RULE_PENALTY + warningRuleCount * WARNING_RULE_PENALTY;
+	return Math.max(0, Math.round(PERFECT_SCORE - penalty));
+};
+const calculateScoreLocally = (diagnostics) => {
+	const { errorRuleCount, warningRuleCount } = countUniqueRules(diagnostics);
+	const score = scoreFromRuleCounts(errorRuleCount, warningRuleCount);
+	return {
+		score,
+		label: getScoreLabel(score)
+	};
+};
+
+//#endregion
+//#region src/core/try-score-from-api.ts
+const parseScoreResult = (value) => {
+	if (typeof value !== "object" || value === null) return null;
+	if (!("score" in value) || !("label" in value)) return null;
+	const scoreValue = Reflect.get(value, "score");
+	const labelValue = Reflect.get(value, "label");
+	if (typeof scoreValue !== "number" || typeof labelValue !== "string") return null;
+	return {
+		score: scoreValue,
+		label: labelValue
+	};
+};
+const tryScoreFromApi = async (diagnostics, fetchImplementation) => {
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+	try {
+		const response = await fetchImplementation(SCORE_API_URL, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ diagnostics }),
+			signal: controller.signal
+		});
+		if (!response.ok) return null;
+		return parseScoreResult(await response.json());
+	} catch {
+		return null;
+	} finally {
+		clearTimeout(timeoutId);
+	}
+};
+
+//#endregion
+//#region src/utils/proxy-fetch.ts
+const getGlobalProcess = () => {
+	const candidate = globalThis.process;
+	return candidate?.versions?.node ? candidate : void 0;
+};
+const readEnvProxy = () => {
+	const proc = getGlobalProcess();
+	if (!proc?.env) return void 0;
+	return proc.env.HTTPS_PROXY ?? proc.env.https_proxy ?? proc.env.HTTP_PROXY ?? proc.env.http_proxy;
+};
+let isProxyUrlResolved = false;
+let resolvedProxyUrl;
+const getProxyUrl = () => {
+	if (isProxyUrlResolved) return resolvedProxyUrl;
+	isProxyUrlResolved = true;
+	resolvedProxyUrl = readEnvProxy();
+	return resolvedProxyUrl;
+};
+const createProxyDispatcher = async (proxyUrl) => {
+	try {
+		const { ProxyAgent } = await import("undici");
+		return new ProxyAgent(proxyUrl);
+	} catch {
+		return null;
+	}
+};
+const proxyFetch = async (url, init) => {
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+	try {
+		const proxyUrl = getProxyUrl();
+		const dispatcher = proxyUrl ? await createProxyDispatcher(proxyUrl) : null;
+		return await fetch(url, {
+			...init,
+			signal: controller.signal,
+			...dispatcher ? { dispatcher } : {}
+		});
+	} finally {
+		clearTimeout(timeoutId);
+	}
+};
+
+//#endregion
+//#region src/utils/calculate-score-node.ts
+const calculateScore = async (diagnostics) => {
+	const apiScore = await tryScoreFromApi(diagnostics, proxyFetch);
+	if (apiScore) return apiScore;
+	return calculateScoreLocally(diagnostics);
+};
+
+//#endregion
+//#region src/utils/collect-unused-file-paths.ts
+const collectUnusedFilePaths = (filesIssues) => {
+	if (filesIssues instanceof Set) return [...filesIssues];
+	if (Array.isArray(filesIssues)) return filesIssues.filter((entry) => typeof entry === "string");
+	if (!isPlainObject(filesIssues)) return [];
+	const unusedFilePaths = [];
+	for (const innerValue of Object.values(filesIssues)) {
+		if (!isPlainObject(innerValue)) continue;
+		for (const issue of Object.values(innerValue)) if (isPlainObject(issue) && typeof issue.filePath === "string") unusedFilePaths.push(issue.filePath);
+	}
+	return unusedFilePaths;
+};
+
 //#endregion
 //#region src/utils/run-knip.ts
 const KNIP_CATEGORY_MAP = {
@@ -868,8 +985,8 @@ const runKnip = async (rootDirectory) => {
 	} else knipResult = await runKnipWithOptions(rootDirectory);
 	const { issues } = knipResult;
 	const diagnostics = [];
-	for (const unusedFile of issues.files) diagnostics.push({
-		filePath: path.relative(rootDirectory, unusedFile),
+	for (const unusedFilePath of collectUnusedFilePaths(issues.files)) diagnostics.push({
+		filePath: path.relative(rootDirectory, unusedFilePath),
 		plugin: "knip",
 		rule: "files",
 		severity: KNIP_SEVERITY_MAP["files"],
@@ -1554,35 +1671,26 @@ const filterSourceFiles = (filePaths) => filePaths.filter((filePath) => SOURCE_F
 //#endregion
 //#region src/index.ts
 const diagnose = async (directory, options = {}) => {
-	const { includePaths = [] } = options;
-	const isDiffMode = includePaths.length > 0;
-	const startTime = performance.now();
 	const resolvedDirectory = path.resolve(directory);
-	const projectInfo = discoverProject(resolvedDirectory);
 	const userConfig = loadConfig(resolvedDirectory);
-	const effectiveLint = options.lint ?? userConfig?.lint ?? true;
-	const effectiveDeadCode = options.deadCode ?? userConfig?.deadCode ?? true;
-	if (!projectInfo.reactVersion) throw new Error("No React dependency found in package.json");
+	const includePaths = options.includePaths ?? [];
+	const isDiffMode = includePaths.length > 0;
 	const lintIncludePaths = computeJsxIncludePaths(includePaths) ?? resolveLintIncludePaths(resolvedDirectory, userConfig);
-	const emptyDiagnostics = [];
-	const effectiveCustomRulesOnly = userConfig?.customRulesOnly ?? false;
-	const lintPromise = effectiveLint ? runOxlint(resolvedDirectory, projectInfo.hasTypeScript, projectInfo.framework, projectInfo.hasReactCompiler, lintIncludePaths, void 0, effectiveCustomRulesOnly).catch((error) => {
-		console.error("Lint failed:", error);
-		return emptyDiagnostics;
-	}) : Promise.resolve(emptyDiagnostics);
-	const deadCodePromise = effectiveDeadCode && !isDiffMode ? runKnip(resolvedDirectory).catch((error) => {
-		console.error("Dead code analysis failed:", error);
-		return emptyDiagnostics;
-	}) : Promise.resolve(emptyDiagnostics);
-	const [lintDiagnostics, deadCodeDiagnostics] = await Promise.all([lintPromise, deadCodePromise]);
-	const diagnostics = combineDiagnostics(lintDiagnostics, deadCodeDiagnostics, resolvedDirectory, isDiffMode, userConfig);
-	const elapsedMilliseconds = performance.now() - startTime;
-	return {
-		diagnostics,
-		score: await calculateScore(diagnostics),
-		project: projectInfo,
-		elapsedMilliseconds
-	};
+	return diagnoseCore({
+		rootDirectory: resolvedDirectory,
+		readFileLinesSync: createNodeReadFileLinesSync(resolvedDirectory),
+		loadUserConfig: () => userConfig,
+		discoverProjectInfo: () => discoverProject(resolvedDirectory),
+		calculateDiagnosticsScore: calculateScore,
+		getExtraDiagnostics: () => isDiffMode ? [] : checkReducedMotion(resolvedDirectory),
+		createRunners: ({ resolvedDirectory: projectRoot, projectInfo, userConfig: config }) => ({
+			runLint: () => runOxlint(projectRoot, projectInfo.hasTypeScript, projectInfo.framework, projectInfo.hasReactCompiler, lintIncludePaths, void 0, config?.customRulesOnly ?? false),
+			runDeadCode: () => runKnip(projectRoot)
+		})
+	}, {
+		...options,
+		lintIncludePaths
+	});
 };
 
 //#endregion