react-doctor 0.0.28 → 0.0.30

package/dist/cli.js

@@ -33,7 +33,6 @@ const FETCH_TIMEOUT_MS = 1e4;
 const GIT_LS_FILES_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
 const SPAWN_ARGS_MAX_LENGTH_CHARS = 24e3;
 const OFFLINE_MESSAGE = "You are offline, could not calculate score. Reconnect to calculate.";
-const OFFLINE_FLAG_MESSAGE = "Score not calculated. Remove --offline to calculate score.";
 const DEFAULT_BRANCH_CANDIDATES = ["main", "master"];
 const ERROR_RULE_PENALTY = 1.5;
 const WARNING_RULE_PENALTY = .75;
@@ -129,6 +128,13 @@ const estimateScoreLocally = (diagnostics) => {
 		estimatedLabel: getScoreLabel(estimatedScore)
 	};
 };
+const calculateScoreLocally = (diagnostics) => {
+	const { currentScore, currentLabel } = estimateScoreLocally(diagnostics);
+	return {
+		score: currentScore,
+		label: currentLabel
+	};
+};
 const calculateScore = async (diagnostics) => {
 	try {
 		const response = await proxyFetch(SCORE_API_URL, {
@@ -136,10 +142,10 @@ const calculateScore = async (diagnostics) => {
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify({ diagnostics })
 		});
-		if (!response.ok) return null;
+		if (!response.ok) return calculateScoreLocally(diagnostics);
 		return await response.json();
 	} catch {
-		return null;
+		return calculateScoreLocally(diagnostics);
 	}
 };
 const fetchEstimatedScore = async (diagnostics) => {
@@ -178,13 +184,33 @@ const colorizeByScore = (text, score) => {
 //#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) => JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+const readPackageJson = (packageJsonPath) => {
+	try {
+		return JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+	} catch (error) {
+		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";
+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",
@@ -200,7 +226,7 @@ const MISSING_REDUCED_MOTION_DIAGNOSTIC = {
 };
 const checkReducedMotion = (rootDirectory) => {
 	const packageJsonPath = path.join(rootDirectory, "package.json");
-	if (!fs.existsSync(packageJsonPath)) return [];
+	if (!isFile(packageJsonPath)) return [];
 	let hasMotionLibrary = false;
 	try {
 		const packageJson = readPackageJson(packageJsonPath);
@@ -228,7 +254,7 @@ const checkReducedMotion = (rootDirectory) => {
 //#region src/utils/match-glob-pattern.ts
 const REGEX_SPECIAL_CHARACTERS = /[.+^${}()|[\]\\]/g;
 const compileGlobPattern = (pattern) => {
-	const normalizedPattern = pattern.replace(/\\/g, "/");
+	const normalizedPattern = pattern.replace(/\\/g, "/").replace(/^\//, "");
 	let regexSource = "^";
 	let characterIndex = 0;
 	while (characterIndex < normalizedPattern.length) if (normalizedPattern[characterIndex] === "*" && normalizedPattern[characterIndex + 1] === "*") if (normalizedPattern[characterIndex + 2] === "/") {
@@ -266,25 +292,67 @@ const filterIgnoredDiagnostics = (diagnostics, config) => {
 		return true;
 	});
 };
+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 isRuleSuppressed = (commentRules, ruleId) => {
+	if (!commentRules?.trim()) return true;
+	return commentRules.split(/[,\s]+/).some((rule) => rule.trim() === ruleId);
+};
+const filterInlineSuppressions = (diagnostics, rootDirectory) => {
+	const fileLineCache = /* @__PURE__ */ new Map();
+	const getFileLines = (filePath) => {
+		const cached = fileLineCache.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");
+			fileLineCache.set(filePath, lines);
+			return lines;
+		} catch {
+			fileLineCache.set(filePath, null);
+			return null;
+		}
+	};
+	return diagnostics.filter((diagnostic) => {
+		if (diagnostic.line <= 0) return true;
+		const lines = getFileLines(diagnostic.filePath);
+		if (!lines) return true;
+		const ruleId = `${diagnostic.plugin}/${diagnostic.rule}`;
+		const currentLine = lines[diagnostic.line - 1];
+		if (currentLine) {
+			const lineMatch = currentLine.match(DISABLE_LINE_PATTERN);
+			if (lineMatch && isRuleSuppressed(lineMatch[1], ruleId)) return false;
+		}
+		if (diagnostic.line >= 2) {
+			const prevLine = lines[diagnostic.line - 2];
+			if (prevLine) {
+				const nextLineMatch = prevLine.match(DISABLE_NEXT_LINE_PATTERN);
+				if (nextLineMatch && isRuleSuppressed(nextLineMatch[1], ruleId)) return false;
+			}
+		}
+		return true;
+	});
+};
 
 //#endregion
 //#region src/utils/combine-diagnostics.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 allDiagnostics = [
+	const merged = [
 		...lintDiagnostics,
 		...deadCodeDiagnostics,
 		...isDiffMode ? [] : checkReducedMotion(directory)
 	];
-	return userConfig ? filterIgnoredDiagnostics(allDiagnostics, userConfig) : allDiagnostics;
+	return filterInlineSuppressions(userConfig ? filterIgnoredDiagnostics(merged, userConfig) : merged, directory);
 };
 
 //#endregion
 //#region src/utils/find-monorepo-root.ts
 const isMonorepoRoot = (directory) => {
-	if (fs.existsSync(path.join(directory, "pnpm-workspace.yaml"))) return true;
+	if (isFile(path.join(directory, "pnpm-workspace.yaml"))) return true;
+	if (isFile(path.join(directory, "nx.json"))) return true;
 	const packageJsonPath = path.join(directory, "package.json");
-	if (!fs.existsSync(packageJsonPath)) return false;
+	if (!isFile(packageJsonPath)) return false;
 	const packageJson = readPackageJson(packageJsonPath);
 	return Array.isArray(packageJson.workspaces) || Boolean(packageJson.workspaces?.packages);
 };
@@ -297,6 +365,10 @@ const findMonorepoRoot = (startDirectory) => {
 	return null;
 };
 
+//#endregion
+//#region src/utils/is-plain-object.ts
+const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+
 //#endregion
 //#region src/utils/discover-project.ts
 const REACT_COMPILER_PACKAGES = new Set([
@@ -335,7 +407,9 @@ const FRAMEWORK_PACKAGES = {
 	vite: "vite",
 	"react-scripts": "cra",
 	"@remix-run/react": "remix",
-	gatsby: "gatsby"
+	gatsby: "gatsby",
+	expo: "expo",
+	"react-native": "react-native"
 };
 const FRAMEWORK_DISPLAY_NAMES = {
 	nextjs: "Next.js",
@@ -343,10 +417,34 @@ const FRAMEWORK_DISPLAY_NAMES = {
 	cra: "Create React App",
 	remix: "Remix",
 	gatsby: "Gatsby",
+	expo: "Expo",
+	"react-native": "React Native",
 	unknown: "React"
 };
 const formatFrameworkName = (framework) => FRAMEWORK_DISPLAY_NAMES[framework];
-const countSourceFiles = (rootDirectory) => {
+const IGNORED_DIRECTORIES = new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"coverage"
+]);
+const countSourceFilesViaFilesystem = (rootDirectory) => {
+	let count = 0;
+	const stack = [rootDirectory];
+	while (stack.length > 0) {
+		const currentDirectory = stack.pop();
+		const entries = fs.readdirSync(currentDirectory, { withFileTypes: true });
+		for (const entry of entries) {
+			if (entry.isDirectory()) {
+				if (!entry.name.startsWith(".") && !IGNORED_DIRECTORIES.has(entry.name)) stack.push(path.join(currentDirectory, entry.name));
+				continue;
+			}
+			if (entry.isFile() && SOURCE_FILE_PATTERN.test(entry.name)) count++;
+		}
+	}
+	return count;
+};
+const countSourceFilesViaGit = (rootDirectory) => {
 	const result = spawnSync("git", [
 		"ls-files",
 		"--cached",
@@ -357,9 +455,10 @@ const countSourceFiles = (rootDirectory) => {
 		encoding: "utf-8",
 		maxBuffer: GIT_LS_FILES_MAX_BUFFER_BYTES
 	});
-	if (result.error || result.status !== 0) return 0;
+	if (result.error || result.status !== 0) return null;
 	return result.stdout.split("\n").filter((filePath) => filePath.length > 0 && SOURCE_FILE_PATTERN.test(filePath)).length;
 };
+const countSourceFiles = (rootDirectory) => countSourceFilesViaGit(rootDirectory) ?? countSourceFilesViaFilesystem(rootDirectory);
 const collectAllDependencies = (packageJson) => ({
 	...packageJson.peerDependencies,
 	...packageJson.dependencies,
@@ -369,16 +468,37 @@ const detectFramework = (dependencies) => {
 	for (const [packageName, frameworkName] of Object.entries(FRAMEWORK_PACKAGES)) if (dependencies[packageName]) return frameworkName;
 	return "unknown";
 };
+const isCatalogReference = (version) => version.startsWith("catalog:");
+const resolveVersionFromCatalog = (catalog, packageName) => {
+	const version = catalog[packageName];
+	if (typeof version === "string" && !isCatalogReference(version)) return version;
+	return null;
+};
+const resolveCatalogVersion = (packageJson, packageName) => {
+	const raw = packageJson;
+	if (isPlainObject(raw.catalog)) {
+		const version = resolveVersionFromCatalog(raw.catalog, packageName);
+		if (version) return version;
+	}
+	if (isPlainObject(raw.catalogs)) {
+		for (const catalogEntries of Object.values(raw.catalogs)) if (isPlainObject(catalogEntries)) {
+			const version = resolveVersionFromCatalog(catalogEntries, packageName);
+			if (version) return version;
+		}
+	}
+	return null;
+};
 const extractDependencyInfo = (packageJson) => {
 	const allDependencies = collectAllDependencies(packageJson);
+	const rawVersion = allDependencies.react ?? null;
 	return {
-		reactVersion: allDependencies.react ?? null,
+		reactVersion: rawVersion && !isCatalogReference(rawVersion) ? rawVersion : null,
 		framework: detectFramework(allDependencies)
 	};
 };
 const parsePnpmWorkspacePatterns = (rootDirectory) => {
 	const workspacePath = path.join(rootDirectory, "pnpm-workspace.yaml");
-	if (!fs.existsSync(workspacePath)) return [];
+	if (!isFile(workspacePath)) return [];
 	const content = fs.readFileSync(workspacePath, "utf-8");
 	const patterns = [];
 	let isInsidePackagesBlock = false;
@@ -404,14 +524,14 @@ const resolveWorkspaceDirectories = (rootDirectory, pattern) => {
 	const cleanPattern = pattern.replace(/["']/g, "").replace(/\/\*\*$/, "/*");
 	if (!cleanPattern.includes("*")) {
 		const directoryPath = path.join(rootDirectory, cleanPattern);
-		if (fs.existsSync(directoryPath) && fs.existsSync(path.join(directoryPath, "package.json"))) return [directoryPath];
+		if (fs.existsSync(directoryPath) && isFile(path.join(directoryPath, "package.json"))) return [directoryPath];
 		return [];
 	}
 	const wildcardIndex = cleanPattern.indexOf("*");
 	const baseDirectory = path.join(rootDirectory, cleanPattern.slice(0, wildcardIndex));
 	const suffixAfterWildcard = cleanPattern.slice(wildcardIndex + 1);
 	if (!fs.existsSync(baseDirectory) || !fs.statSync(baseDirectory).isDirectory()) return [];
-	return fs.readdirSync(baseDirectory).map((entry) => path.join(baseDirectory, entry, suffixAfterWildcard)).filter((entryPath) => fs.existsSync(entryPath) && fs.statSync(entryPath).isDirectory() && fs.existsSync(path.join(entryPath, "package.json")));
+	return fs.readdirSync(baseDirectory).map((entry) => path.join(baseDirectory, entry, suffixAfterWildcard)).filter((entryPath) => fs.existsSync(entryPath) && fs.statSync(entryPath).isDirectory() && isFile(path.join(entryPath, "package.json")));
 };
 const findDependencyInfoFromMonorepoRoot = (directory) => {
 	const monorepoRoot = findMonorepoRoot(directory);
@@ -419,11 +539,17 @@ const findDependencyInfoFromMonorepoRoot = (directory) => {
 		reactVersion: null,
 		framework: "unknown"
 	};
-	const rootPackageJson = readPackageJson(path.join(monorepoRoot, "package.json"));
+	const monorepoPackageJsonPath = path.join(monorepoRoot, "package.json");
+	if (!isFile(monorepoPackageJsonPath)) return {
+		reactVersion: null,
+		framework: "unknown"
+	};
+	const rootPackageJson = readPackageJson(monorepoPackageJsonPath);
 	const rootInfo = extractDependencyInfo(rootPackageJson);
+	const catalogVersion = resolveCatalogVersion(rootPackageJson, "react");
 	const workspaceInfo = findReactInWorkspaces(monorepoRoot, rootPackageJson);
 	return {
-		reactVersion: rootInfo.reactVersion ?? workspaceInfo.reactVersion,
+		reactVersion: rootInfo.reactVersion ?? catalogVersion ?? workspaceInfo.reactVersion,
 		framework: rootInfo.framework !== "unknown" ? rootInfo.framework : workspaceInfo.framework
 	};
 };
@@ -444,19 +570,35 @@ const findReactInWorkspaces = (rootDirectory, packageJson) => {
 	}
 	return result;
 };
+const REACT_DEPENDENCY_NAMES = new Set([
+	"react",
+	"react-native",
+	"next"
+]);
 const hasReactDependency = (packageJson) => {
 	const allDependencies = collectAllDependencies(packageJson);
-	return Object.keys(allDependencies).some((packageName) => packageName === "next" || packageName.includes("react"));
+	return Object.keys(allDependencies).some((packageName) => REACT_DEPENDENCY_NAMES.has(packageName));
 };
 const discoverReactSubprojects = (rootDirectory) => {
 	if (!fs.existsSync(rootDirectory) || !fs.statSync(rootDirectory).isDirectory()) return [];
-	const entries = fs.readdirSync(rootDirectory, { withFileTypes: true });
 	const packages = [];
+	const rootPackageJsonPath = path.join(rootDirectory, "package.json");
+	if (isFile(rootPackageJsonPath)) {
+		const rootPackageJson = readPackageJson(rootPackageJsonPath);
+		if (hasReactDependency(rootPackageJson)) {
+			const name = rootPackageJson.name ?? path.basename(rootDirectory);
+			packages.push({
+				name,
+				directory: rootDirectory
+			});
+		}
+	}
+	const entries = fs.readdirSync(rootDirectory, { withFileTypes: true });
 	for (const entry of entries) {
 		if (!entry.isDirectory() || entry.name.startsWith(".") || entry.name === "node_modules") continue;
 		const subdirectory = path.join(rootDirectory, entry.name);
 		const packageJsonPath = path.join(subdirectory, "package.json");
-		if (!fs.existsSync(packageJsonPath)) continue;
+		if (!isFile(packageJsonPath)) continue;
 		const packageJson = readPackageJson(packageJsonPath);
 		if (!hasReactDependency(packageJson)) continue;
 		const name = packageJson.name ?? entry.name;
@@ -469,7 +611,7 @@ const discoverReactSubprojects = (rootDirectory) => {
 };
 const listWorkspacePackages = (rootDirectory) => {
 	const packageJsonPath = path.join(rootDirectory, "package.json");
-	if (!fs.existsSync(packageJsonPath)) return [];
+	if (!isFile(packageJsonPath)) return [];
 	const patterns = getWorkspacePatterns(rootDirectory, readPackageJson(packageJsonPath));
 	if (patterns.length === 0) return [];
 	const packages = [];
@@ -492,7 +634,7 @@ const hasCompilerPackage = (packageJson) => {
 	return Object.keys(allDependencies).some((packageName) => REACT_COMPILER_PACKAGES.has(packageName));
 };
 const fileContainsPattern = (filePath, pattern) => {
-	if (!fs.existsSync(filePath)) return false;
+	if (!isFile(filePath)) return false;
 	const content = fs.readFileSync(filePath, "utf-8");
 	return pattern.test(content);
 };
@@ -506,7 +648,7 @@ const detectReactCompiler = (directory, packageJson) => {
 	let ancestorDirectory = path.dirname(directory);
 	while (ancestorDirectory !== path.dirname(ancestorDirectory)) {
 		const ancestorPackagePath = path.join(ancestorDirectory, "package.json");
-		if (fs.existsSync(ancestorPackagePath)) {
+		if (isFile(ancestorPackagePath)) {
 			if (hasCompilerPackage(readPackageJson(ancestorPackagePath))) return true;
 		}
 		ancestorDirectory = path.dirname(ancestorDirectory);
@@ -515,9 +657,10 @@ const detectReactCompiler = (directory, packageJson) => {
 };
 const discoverProject = (directory) => {
 	const packageJsonPath = path.join(directory, "package.json");
-	if (!fs.existsSync(packageJsonPath)) throw new Error(`No package.json found in ${directory}`);
+	if (!isFile(packageJsonPath)) throw new Error(`No package.json found in ${directory}`);
 	const packageJson = readPackageJson(packageJsonPath);
 	let { reactVersion, framework } = extractDependencyInfo(packageJson);
+	if (!reactVersion) reactVersion = resolveCatalogVersion(packageJson, "react");
 	if (!reactVersion || framework === "unknown") {
 		const workspaceInfo = findReactInWorkspaces(directory, packageJson);
 		if (!reactVersion && workspaceInfo.reactVersion) reactVersion = workspaceInfo.reactVersion;
@@ -617,23 +760,18 @@ const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText
 //#region src/utils/load-config.ts
 const CONFIG_FILENAME = "react-doctor.config.json";
 const PACKAGE_JSON_CONFIG_KEY = "reactDoctor";
-const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const loadConfig = (rootDirectory) => {
 	const configFilePath = path.join(rootDirectory, CONFIG_FILENAME);
-	if (fs.existsSync(configFilePath)) try {
+	if (isFile(configFilePath)) try {
 		const fileContent = fs.readFileSync(configFilePath, "utf-8");
 		const parsed = JSON.parse(fileContent);
-		if (!isPlainObject(parsed)) {
-			console.warn(`Warning: ${CONFIG_FILENAME} must be a JSON object, ignoring.`);
-			return null;
-		}
-		return parsed;
+		if (isPlainObject(parsed)) return parsed;
+		console.warn(`Warning: ${CONFIG_FILENAME} must be a JSON object, ignoring.`);
 	} catch (error) {
 		console.warn(`Warning: Failed to parse ${CONFIG_FILENAME}: ${error instanceof Error ? error.message : String(error)}`);
-		return null;
 	}
 	const packageJsonPath = path.join(rootDirectory, "package.json");
-	if (fs.existsSync(packageJsonPath)) try {
+	if (isFile(packageJsonPath)) try {
 		const fileContent = fs.readFileSync(packageJsonPath, "utf-8");
 		const embeddedConfig = JSON.parse(fileContent)[PACKAGE_JSON_CONFIG_KEY];
 		if (isPlainObject(embeddedConfig)) return embeddedConfig;
@@ -862,11 +1000,15 @@ const CONFIG_LOADING_ERROR_PATTERN = /Error loading .*\/([a-z-]+)\.config\./;
 const extractFailedPluginName = (error) => {
 	return String(error).match(CONFIG_LOADING_ERROR_PATTERN)?.[1] ?? null;
 };
+const TSCONFIG_FILENAMES = ["tsconfig.base.json", "tsconfig.json"];
+const resolveTsConfigFile = (directory) => TSCONFIG_FILENAMES.find((filename) => fs.existsSync(path.join(directory, filename)));
 const runKnipWithOptions = async (knipCwd, workspaceName) => {
+	const tsConfigFile = resolveTsConfigFile(knipCwd);
 	const options = await silenced(() => createOptions({
 		cwd: knipCwd,
 		isShowProgress: false,
-		...workspaceName ? { workspace: workspaceName } : {}
+		...workspaceName ? { workspace: workspaceName } : {},
+		...tsConfigFile ? { tsConfigFile } : {}
 	}));
 	const parsedConfig = options.parsedConfig;
 	for (let attempt = 0; attempt <= MAX_KNIP_RETRIES; attempt++) try {
@@ -888,7 +1030,7 @@ const runKnip = async (rootDirectory) => {
 	let knipResult;
 	if (monorepoRoot) {
 		const packageJsonPath = path.join(rootDirectory, "package.json");
-		const workspaceName = (fs.existsSync(packageJsonPath) ? JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")) : {}).name ?? path.basename(rootDirectory);
+		const workspaceName = (isFile(packageJsonPath) ? JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")) : {}).name ?? path.basename(rootDirectory);
 		try {
 			knipResult = await runKnipWithOptions(monorepoRoot, workspaceName);
 		} catch {
@@ -938,6 +1080,16 @@ const NEXTJS_RULES = {
 	"react-doctor/nextjs-no-head-import": "error",
 	"react-doctor/nextjs-no-side-effect-in-get-handler": "error"
 };
+const REACT_NATIVE_RULES = {
+	"react-doctor/rn-no-raw-text": "error",
+	"react-doctor/rn-no-deprecated-modules": "error",
+	"react-doctor/rn-no-legacy-expo-packages": "warn",
+	"react-doctor/rn-no-dimensions-get": "warn",
+	"react-doctor/rn-no-inline-flatlist-renderitem": "warn",
+	"react-doctor/rn-no-legacy-shadow-styles": "warn",
+	"react-doctor/rn-prefer-reanimated": "warn",
+	"react-doctor/rn-no-single-element-style-array": "warn"
+};
 const REACT_COMPILER_RULES = {
 	"react-hooks-js/set-state-in-render": "error",
 	"react-hooks-js/immutability": "error",
@@ -1041,7 +1193,8 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
 		"react-doctor/server-after-nonblocking": "warn",
 		"react-doctor/client-passive-event-listeners": "warn",
 		"react-doctor/async-parallel": "warn",
-		...framework === "nextjs" ? NEXTJS_RULES : {}
+		...framework === "nextjs" ? NEXTJS_RULES : {},
+		...framework === "expo" || framework === "react-native" ? REACT_NATIVE_RULES : {}
 	}
 });
 
@@ -1149,10 +1302,18 @@ const RULE_CATEGORY_MAP = {
 	"react-doctor/server-auth-actions": "Server",
 	"react-doctor/server-after-nonblocking": "Server",
 	"react-doctor/client-passive-event-listeners": "Performance",
-	"react-doctor/async-parallel": "Performance"
+	"react-doctor/async-parallel": "Performance",
+	"react-doctor/rn-no-raw-text": "React Native",
+	"react-doctor/rn-no-deprecated-modules": "React Native",
+	"react-doctor/rn-no-legacy-expo-packages": "React Native",
+	"react-doctor/rn-no-dimensions-get": "React Native",
+	"react-doctor/rn-no-inline-flatlist-renderitem": "React Native",
+	"react-doctor/rn-no-legacy-shadow-styles": "React Native",
+	"react-doctor/rn-prefer-reanimated": "React Native",
+	"react-doctor/rn-no-single-element-style-array": "React Native"
 };
 const RULE_HELP_MAP = {
-	"no-derived-state-effect": "For derived state, compute inline: `const x = fn(dep)`. For state resets on prop change, use a key prop: `<Component key={prop} />`",
+	"no-derived-state-effect": "For derived state, compute inline: `const x = fn(dep)`. For state resets on prop change, use a key prop: `<Component key={prop} />`. See https://react.dev/learn/you-might-not-need-an-effect",
 	"no-fetch-in-effect": "Use `useQuery()` from @tanstack/react-query, `useSWR()`, or fetch in a Server Component instead",
 	"no-cascading-set-state": "Combine into useReducer: `const [state, dispatch] = useReducer(reducer, initialState)`",
 	"no-effect-event-handler": "Move the conditional logic into onClick, onChange, or onSubmit handlers directly",
@@ -1192,7 +1353,7 @@ const RULE_HELP_MAP = {
 	"nextjs-no-use-search-params-without-suspense": "Wrap the component using useSearchParams: `<Suspense fallback={<Skeleton />}><SearchComponent /></Suspense>`",
 	"nextjs-no-client-fetch-for-server-data": "Remove 'use client' and fetch directly in the Server Component — no API round-trip, secrets stay on server",
 	"nextjs-missing-metadata": "Add `export const metadata = { title: '...', description: '...' }` or `export async function generateMetadata()`",
-	"nextjs-no-client-side-redirect": "Use `redirect('/path')` from 'next/navigation' in a Server Component, or handle in middleware",
+	"nextjs-no-client-side-redirect": "Use `redirect('/path')` from 'next/navigation' directly (works in both server and client components), or handle in middleware",
 	"nextjs-no-redirect-in-try-catch": "Move the redirect/notFound call outside the try block, or add `unstable_rethrow(error)` in the catch",
 	"nextjs-image-missing-sizes": "Add sizes for responsive behavior: `sizes=\"(max-width: 768px) 100vw, 50vw\"` matching your layout breakpoints",
 	"nextjs-no-native-script": "`import Script from \"next/script\"` — use `strategy=\"afterInteractive\"` for analytics or `\"lazyOnload\"` for widgets",
@@ -1205,7 +1366,15 @@ const RULE_HELP_MAP = {
 	"server-auth-actions": "Add `const session = await auth()` at the top and throw/redirect if unauthorized before any data access",
 	"server-after-nonblocking": "`import { after } from 'next/server'` then wrap: `after(() => analytics.track(...))` — response isn't blocked",
 	"client-passive-event-listeners": "Add `{ passive: true }` as the third argument: `addEventListener('scroll', handler, { passive: true })`",
-	"async-parallel": "Use `const [a, b] = await Promise.all([fetchA(), fetchB()])` to run independent operations concurrently"
+	"async-parallel": "Use `const [a, b] = await Promise.all([fetchA(), fetchB()])` to run independent operations concurrently",
+	"rn-no-raw-text": "Wrap text in a `<Text>` component: `<Text>{value}</Text>` — raw strings outside `<Text>` crash on React Native",
+	"rn-no-deprecated-modules": "Import from the community package instead — deprecated modules were removed from the react-native core",
+	"rn-no-legacy-expo-packages": "Migrate to the recommended replacement package — legacy Expo packages are no longer maintained",
+	"rn-no-dimensions-get": "Use `const { width, height } = useWindowDimensions()` — it updates reactively on rotation and resize",
+	"rn-no-inline-flatlist-renderitem": "Extract renderItem to a named function or wrap in useCallback to avoid re-creating on every render",
+	"rn-no-legacy-shadow-styles": "Use `boxShadow` for cross-platform shadows on the new architecture instead of platform-specific shadow properties",
+	"rn-prefer-reanimated": "Use `import Animated from 'react-native-reanimated'` — animations run on the UI thread instead of the JS thread",
+	"rn-no-single-element-style-array": "Use `style={value}` instead of `style={[value]}` — single-element arrays add unnecessary allocation"
 };
 const FILEPATH_WITH_LOCATION_PATTERN = /\S+\.\w+:\d+:\d+[\s\S]*$/;
 const REACT_COMPILER_MESSAGE = "React Compiler can't optimize this code";
@@ -1272,7 +1441,14 @@ const spawnOxlint = (args, rootDirectory, nodeBinaryPath) => new Promise((resolv
 	child.stdout.on("data", (buffer) => stdoutBuffers.push(buffer));
 	child.stderr.on("data", (buffer) => stderrBuffers.push(buffer));
 	child.on("error", (error) => reject(/* @__PURE__ */ new Error(`Failed to run oxlint: ${error.message}`)));
-	child.on("close", () => {
+	child.on("close", (code, signal) => {
+		if (signal) {
+			const stderrOutput = Buffer.concat(stderrBuffers).toString("utf-8").trim();
+			const hint = signal === "SIGABRT" ? " (out of memory — try scanning fewer files with --diff)" : "";
+			const detail = stderrOutput ? `: ${stderrOutput}` : "";
+			reject(/* @__PURE__ */ new Error(`oxlint was killed by ${signal}${hint}${detail}`));
+			return;
+		}
 		const output = Buffer.concat(stdoutBuffers).toString("utf-8").trim();
 		if (!output) {
 			const stderrOutput = Buffer.concat(stderrBuffers).toString("utf-8").trim();
@@ -1543,7 +1719,7 @@ const buildCountsSummaryLine = (diagnostics, totalSourceFileCount, elapsedMillis
 	renderedParts.push(highlighter.dim(fileCountText), highlighter.dim(elapsedTimeText));
 	return createFramedLine(plainParts.join("  "), renderedParts.join("  "));
 };
-const printSummary = (diagnostics, elapsedMilliseconds, scoreResult, projectName, totalSourceFileCount, noScoreMessage) => {
+const printSummary = (diagnostics, elapsedMilliseconds, scoreResult, projectName, totalSourceFileCount, noScoreMessage, isOffline) => {
 	printFramedBox([...buildBrandingLines(scoreResult, noScoreMessage), buildCountsSummaryLine(diagnostics, totalSourceFileCount, elapsedMilliseconds)]);
 	try {
 		const diagnosticsDirectory = writeDiagnosticsDirectory(diagnostics);
@@ -1552,9 +1728,11 @@ const printSummary = (diagnostics, elapsedMilliseconds, scoreResult, projectName
 	} catch {
 		logger.break();
 	}
-	const shareUrl = buildShareUrl(diagnostics, scoreResult, projectName);
-	logger.break();
-	logger.dim(`  Share your results: ${highlighter.info(shareUrl)}`);
+	if (!isOffline) {
+		const shareUrl = buildShareUrl(diagnostics, scoreResult, projectName);
+		logger.break();
+		logger.dim(`  Share your results: ${highlighter.info(shareUrl)}`);
+	}
 };
 const resolveOxlintNode = async (isLintEnabled, isScoreOnly) => {
 	if (!isLintEnabled) return null;
@@ -1639,13 +1817,15 @@ const scan = async (directory, inputOptions = {}) => {
 			return lintDiagnostics;
 		} catch (error) {
 			didLintFail = true;
-			const errorMessage = error instanceof Error ? error.message : String(error);
-			if (errorMessage.includes("native binding")) {
-				lintSpinner?.fail(`Lint checks failed — oxlint native binding not found (Node ${process.version}).`);
-				logger.dim(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`);
-			} else {
-				lintSpinner?.fail("Lint checks failed (non-fatal, skipping).");
-				logger.error(errorMessage);
+			if (!options.scoreOnly) {
+				const errorMessage = error instanceof Error ? error.message : String(error);
+				if (errorMessage.includes("native binding")) {
+					lintSpinner?.fail(`Lint checks failed — oxlint native binding not found (Node ${process.version}).`);
+					logger.dim(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`);
+				} else {
+					lintSpinner?.fail("Lint checks failed (non-fatal, skipping).");
+					logger.error(errorMessage);
+				}
 			}
 			return [];
 		}
@@ -1658,8 +1838,10 @@ const scan = async (directory, inputOptions = {}) => {
 			return knipDiagnostics;
 		} catch (error) {
 			didDeadCodeFail = true;
-			deadCodeSpinner?.fail("Dead code detection failed (non-fatal, skipping).");
-			logger.error(String(error));
+			if (!options.scoreOnly) {
+				deadCodeSpinner?.fail("Dead code detection failed (non-fatal, skipping).");
+				logger.error(String(error));
+			}
 			return [];
 		}
 	})() : Promise.resolve([]);
@@ -1670,8 +1852,8 @@ const scan = async (directory, inputOptions = {}) => {
 	if (didLintFail) skippedChecks.push("lint");
 	if (didDeadCodeFail) skippedChecks.push("dead code");
 	const hasSkippedChecks = skippedChecks.length > 0;
-	const scoreResult = options.offline ? null : await calculateScore(diagnostics);
-	const noScoreMessage = options.offline ? OFFLINE_FLAG_MESSAGE : OFFLINE_MESSAGE;
+	const scoreResult = options.offline ? calculateScoreLocally(diagnostics) : await calculateScore(diagnostics);
+	const noScoreMessage = OFFLINE_MESSAGE;
 	if (options.scoreOnly) {
 		if (scoreResult) logger.log(`${scoreResult.score}`);
 		else logger.dim(noScoreMessage);
@@ -1702,7 +1884,7 @@ const scan = async (directory, inputOptions = {}) => {
 	}
 	printDiagnostics(diagnostics, options.verbose);
 	const displayedSourceFileCount = isDiffMode ? includePaths.length : projectInfo.sourceFileCount;
-	printSummary(diagnostics, elapsedMilliseconds, scoreResult, projectInfo.projectName, displayedSourceFileCount, noScoreMessage);
+	printSummary(diagnostics, elapsedMilliseconds, scoreResult, projectInfo.projectName, displayedSourceFileCount, noScoreMessage, options.offline);
 	if (hasSkippedChecks) {
 		const skippedLabel = skippedChecks.join(" and ");
 		logger.break();
@@ -2029,7 +2211,18 @@ const maybePromptSkillInstall = async (shouldSkipPrompts) => {
 
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.28";
+const VERSION = "0.0.30";
+const VALID_FAIL_ON_LEVELS = new Set([
+	"error",
+	"warning",
+	"none"
+]);
+const isValidFailOnLevel = (level) => VALID_FAIL_ON_LEVELS.has(level);
+const shouldFailForDiagnostics = (diagnostics, failOnLevel) => {
+	if (failOnLevel === "none") return false;
+	if (failOnLevel === "warning") return diagnostics.length > 0;
+	return diagnostics.some((diagnostic) => diagnostic.severity === "error");
+};
 const exitWithFixHint = () => {
 	logger.break();
 	logger.log("Cancelled.");
@@ -2052,8 +2245,8 @@ const isAutomatedEnvironment = () => AUTOMATED_ENVIRONMENT_VARIABLES.some((envVa
 const resolveCliScanOptions = (flags, userConfig, programInstance) => {
 	const isCliOverride = (optionName) => programInstance.getOptionValueSource(optionName) === "cli";
 	return {
-		lint: isCliOverride("lint") ? flags.lint : userConfig?.lint ?? flags.lint,
-		deadCode: isCliOverride("deadCode") ? flags.deadCode : userConfig?.deadCode ?? flags.deadCode,
+		lint: isCliOverride("lint") ? flags.lint : userConfig?.lint ?? true,
+		deadCode: isCliOverride("deadCode") ? flags.deadCode : userConfig?.deadCode ?? true,
 		verbose: isCliOverride("verbose") ? Boolean(flags.verbose) : userConfig?.verbose ?? false,
 		scoreOnly: flags.score,
 		offline: flags.offline
@@ -2081,7 +2274,7 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isSco
 	});
 	return Boolean(shouldScanChangedOnly);
 };
-const program = new Command().name("react-doctor").description("Diagnose React codebase health").version(VERSION, "-v, --version", "display the version number").argument("[directory]", "project directory to scan", ".").option("--no-lint", "skip linting").option("--no-dead-code", "skip dead code detection").option("--verbose", "show file details per rule").option("--score", "output only the score").option("-y, --yes", "skip prompts, scan all workspace projects").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch").option("--offline", "skip telemetry (anonymous, not stored, only used to calculate score)").option("--no-ami", "skip Ami-related prompts").option("--fix", "open Ami to auto-fix all issues").action(async (directory, flags) => {
+const program = new Command().name("react-doctor").description("Diagnose React codebase health").version(VERSION, "-v, --version", "display the version number").argument("[directory]", "project directory to scan", ".").option("--lint", "enable linting").option("--no-lint", "skip linting").option("--dead-code", "enable dead code detection").option("--no-dead-code", "skip dead code detection").option("--verbose", "show file details per rule").option("--score", "output only the score").option("-y, --yes", "skip prompts, scan all workspace projects").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch").option("--offline", "skip telemetry (anonymous, not stored, only used to calculate score)").option("--ami", "enable Ami-related prompts").option("--fail-on <level>", "exit with error code on diagnostics: error, warning, none", "none").option("--fix", "open Ami to auto-fix all issues").action(async (directory, flags) => {
 	const isScoreOnly = flags.score;
 	try {
 		const resolvedDirectory = path.resolve(directory);
@@ -2131,6 +2324,8 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 			allDiagnostics.push(...scanResult.diagnostics);
 			if (!isScoreOnly) logger.break();
 		}
+		const resolvedFailOn = program.getOptionValueSource("failOn") === "cli" ? flags.failOn : userConfig?.failOn ?? flags.failOn;
+		if (shouldFailForDiagnostics(allDiagnostics, isValidFailOnLevel(resolvedFailOn) ? resolvedFailOn : "none")) process.exitCode = 1;
 		if (flags.fix) openAmiToFix(resolvedDirectory);
 		if (!isScoreOnly && !shouldSkipAmiPrompts && !flags.fix) {
 			await maybePromptSkillInstall(shouldSkipAmiPrompts);
@@ -2193,7 +2388,11 @@ const openAmiToFix = (directory) => {
 	if (!isInstalled) {
 		if (process.platform === "darwin") {
 			installAmi();
-			logger.success("Ami installed successfully.");
+			if (isAmiInstalled()) logger.success("Ami installed successfully.");
+			else {
+				logger.error("Installation could not be verified.");
+				logger.dim(`Install manually at ${highlighter.info(AMI_WEBSITE_URL)}`);
+			}
 		} else {
 			logger.error("Ami is not installed.");
 			logger.dim(`Download at ${highlighter.info(AMI_RELEASES_URL)}`);