react-doctor 0.0.41 → 0.0.44

package/README.md

@@ -40,7 +40,7 @@ npx -y react-doctor@latest . --verbose
 
 ## Install for your coding agent
 
-Teach your coding agent all 47+ React best practice rules. Run this at your project root:
+Teach your coding agent React best practices. Run this at your project root:
 
 ```bash
 npx -y react-doctor@latest install
@@ -71,7 +71,7 @@ Supports Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor, OpenCode, Facto
 | `github-token` |         | When set on `pull_request` events, posts findings as a PR comment |
 | `fail-on`      | `error` | Exit with error code on diagnostics: `error`, `warning`, `none`   |
 | `offline`      | `false` | Skip sending diagnostics to the react.doctor API                  |
-| `node-version` | `20`    | Node.js version to use                                            |
+| `node-version` | `22`    | Node.js version to use                                            |
 
 The action outputs a `score` (0–100) you can use in subsequent steps.
 
@@ -81,15 +81,73 @@ The action outputs a `score` (0–100) you can use in subsequent steps.
 Usage: react-doctor [directory] [options]
 
 Options:
-  -v, --version     display the version number
-  --no-lint         skip linting
-  --no-dead-code    skip dead code detection
-  --verbose         show file details per rule
-  --score           output only the score
-  -y, --yes         skip prompts, scan all workspace projects
-  --project <name>  select workspace project (comma-separated for multiple)
-  --diff [base]     scan only files changed vs base branch
-  -h, --help        display help for command
+  -v, --version      display the version number
+  --no-lint          skip linting
+  --no-dead-code     skip dead code detection
+  --verbose          show file details per rule
+  --score            output only the score
+  --json             output a single structured JSON report (suppresses other output)
+  -y, --yes          skip prompts, scan all workspace projects
+  --full             skip prompts, always run a full scan (decline diff-only)
+  --project <name>   select workspace project (comma-separated for multiple)
+  --diff [base]      scan only files changed vs base branch
+  --offline          skip telemetry (anonymous, not stored, only used to calculate score)
+  --staged           scan only staged (git index) files for pre-commit hooks
+  --fail-on <level>  exit with error code on diagnostics: error, warning, none
+  --annotations      output diagnostics as GitHub Actions annotations
+  -h, --help         display help for command
+```
+
+## JSON output
+
+Pass `--json` to get a single, parsable JSON object on stdout. All human-readable output, prompts, and the share link are suppressed; pipe straight into `jq`, `node`, or any other tool:
+
+```bash
+npx -y react-doctor@latest . --json | jq '.summary'
+```
+
+Exit code is `0` on success and `1` if the scan throws or `--fail-on` is triggered. Errors still produce a JSON object with `ok: false`, so the stdout is always a valid document.
+
+### Schema
+
+```ts
+interface JsonReport {
+  schemaVersion: 1;
+  version: string; // react-doctor version
+  ok: boolean; // false when an error was thrown
+  directory: string; // resolved root passed to the CLI
+  mode: "full" | "diff" | "staged";
+  diff: {
+    baseBranch: string;
+    currentBranch: string;
+    changedFileCount: number;
+    isCurrentChanges: boolean;
+  } | null;
+  projects: Array<{
+    directory: string;
+    project: ProjectInfo;
+    diagnostics: Diagnostic[];
+    score: { score: number; label: string } | null;
+    skippedChecks: string[];
+    elapsedMilliseconds: number;
+  }>;
+  diagnostics: Diagnostic[]; // flattened across all scanned projects
+  summary: {
+    errorCount: number;
+    warningCount: number;
+    affectedFileCount: number;
+    totalDiagnosticCount: number;
+    score: number | null; // worst project score, when available
+    scoreLabel: string | null;
+  };
+  elapsedMilliseconds: number; // total wall time across all projects
+  error: {
+    message: string;
+    name: string;
+    chain: string[]; // outer error message first, every `error.cause`
+    // unwrapped after; chain[0] always equals `message`
+  } | null; // null on success, populated when ok=false
+}
 ```
 
 ## Browser API
@@ -127,20 +185,65 @@ You can also use the `"reactDoctor"` key in your `package.json` instead:
 
 If both exist, `react-doctor.config.json` takes precedence.
 
+### Inline suppressions
+
+Suppress a rule on a specific line with `// react-doctor-disable-line` or the next line with `// react-doctor-disable-next-line`:
+
+```tsx
+// react-doctor-disable-next-line react-doctor/no-cascading-set-state
+useEffect(() => {
+  setA(value);
+  setB(value);
+  setC(value);
+}, [value]);
+
+const value = expensiveComputation(); // react-doctor-disable-line react-doctor/no-usememo-simple-expression
+```
+
+Comma- or space-separate multiple rule ids on the same comment. With no rule id, the comment suppresses every diagnostic on that line.
+
+### Respecting your existing project ignores
+
+By default, React Doctor honors all of the ignore-style files your project already has, so you don't need to maintain a separate "what should react-doctor skip" list:
+
+| File                                                         | What gets skipped                                                                                                                                                     |
+| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `.gitignore`                                                 | files git ignores (oxlint default)                                                                                                                                    |
+| `.eslintignore`                                              | files eslint skips (oxlint default)                                                                                                                                   |
+| `.oxlintignore`                                              | files oxlint skips (added via `--ignore-pattern` so `.eslintignore` still applies)                                                                                    |
+| `.prettierignore`                                            | files prettier skips — typically vendored code, generated builds, and lockfiles                                                                                       |
+| `.gitattributes` (`linguist-vendored`, `linguist-generated`) | paths GitHub's linguist library hides from language stats; if it's not "your" code by GitHub's reckoning, it shouldn't be audited as your code by react-doctor either |
+
+React Doctor also respects inline lint suppressions in source files:
+
+- `// oxlint-disable`, `// oxlint-disable-line`, `// oxlint-disable-next-line` — with or without rule ids.
+- `// eslint-disable`, `// eslint-disable-line`, `// eslint-disable-next-line` — oxlint reads both prefixes interchangeably.
+
+> Note: `.editorconfig` is intentionally NOT consulted. It describes editor settings (indent size, charset, end-of-line) and has no concept of "files to skip" — there's nothing in it that would change what react-doctor lints.
+
+If you want React Doctor to ignore those inline suppressions and audit your codebase for everything (useful for one-off "what does my project actually score?" runs), set:
+
+```jsonc
+{ "respectInlineDisables": false }
+```
+
+This only neutralizes the inline `// eslint-disable*` / `// oxlint-disable*` comments — the file-level ignore lists above are always honored, even in audit mode, because they typically point at vendored or generated code that genuinely shouldn't be linted.
+
 ### Config options
 
-| Key               | Type                             | Default  | Description                                                                                                                         |
-| ----------------- | -------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
-| `ignore.rules`    | `string[]`                       | `[]`     | Rules to suppress, using the `plugin/rule` format shown in diagnostic output (e.g. `react/no-danger`, `knip/exports`, `knip/types`) |
-| `ignore.files`    | `string[]`                       | `[]`     | File paths to exclude, supports glob patterns (`src/generated/**`, `**/*.test.tsx`)                                                 |
-| `lint`            | `boolean`                        | `true`   | Enable/disable lint checks (same as `--no-lint`)                                                                                    |
-| `deadCode`        | `boolean`                        | `true`   | Enable/disable dead code detection (same as `--no-dead-code`)                                                                       |
-| `verbose`         | `boolean`                        | `false`  | Show file details per rule (same as `--verbose`)                                                                                    |
-| `diff`            | `boolean \| string`              | —        | Force diff mode (`true`) or pin a base branch (`"main"`). Set to `false` to disable auto-detection.                                 |
-| `failOn`          | `"error" \| "warning" \| "none"` | `"none"` | Exit with error code on diagnostics of the given severity or above                                                                  |
-| `customRulesOnly` | `boolean`                        | `false`  | Disable built-in react/jsx-a11y/compiler rules, keeping only `react-doctor/*` plugin rules                                          |
-| `share`           | `boolean`                        | `true`   | Show the share-your-results URL after scanning                                                                                      |
-| `textComponents`  | `string[]`                       | `[]`     | React Native only. Component names whose children should not trigger `rn-no-raw-text` (e.g. `["MyText", "Label.Bold"]`)             |
+| Key                     | Type                             | Default  | Description                                                                                                                                                                                                                                          |
+| ----------------------- | -------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ignore.rules`          | `string[]`                       | `[]`     | Rules to suppress, using the `plugin/rule` format shown in diagnostic output (e.g. `react/no-danger`, `knip/exports`, `knip/types`)                                                                                                                  |
+| `ignore.files`          | `string[]`                       | `[]`     | File paths to exclude, supports glob patterns (`src/generated/**`, `**/*.test.tsx`)                                                                                                                                                                  |
+| `lint`                  | `boolean`                        | `true`   | Enable/disable lint checks (same as `--no-lint`)                                                                                                                                                                                                     |
+| `deadCode`              | `boolean`                        | `true`   | Enable/disable dead code detection (same as `--no-dead-code`)                                                                                                                                                                                        |
+| `verbose`               | `boolean`                        | `false`  | Show file details per rule (same as `--verbose`)                                                                                                                                                                                                     |
+| `diff`                  | `boolean \| string`              | —        | Force diff mode (`true`) or pin a base branch (`"main"`). Set to `false` to disable auto-detection.                                                                                                                                                  |
+| `failOn`                | `"error" \| "warning" \| "none"` | `"none"` | Exit with error code on diagnostics of the given severity or above                                                                                                                                                                                   |
+| `customRulesOnly`       | `boolean`                        | `false`  | Disable built-in react/jsx-a11y/compiler rules, keeping only `react-doctor/*` plugin rules                                                                                                                                                           |
+| `share`                 | `boolean`                        | `true`   | Show the share-your-results URL after scanning                                                                                                                                                                                                       |
+| `textComponents`        | `string[]`                       | `[]`     | React Native only. Component names whose children should not trigger `rn-no-raw-text` (e.g. `["MyText", "Label.Bold"]`)                                                                                                                              |
+| `respectInlineDisables` | `boolean`                        | `true`   | Respect inline `// eslint-disable*` / `// oxlint-disable*` comments. Set `false` for audit mode. File-level ignores (`.gitignore`, `.eslintignore`, `.oxlintignore`, `.prettierignore`, `.gitattributes` linguist annotations) are always respected. |
 
 CLI flags always override config values.
 
@@ -153,7 +256,7 @@ import { diagnose } from "react-doctor/api";
 
 const result = await diagnose("./path/to/your/react-project");
 
-console.log(result.score); // { score: 82, label: "Good" } or null
+console.log(result.score); // { score: 82, label: "Great" } or null
 console.log(result.diagnostics); // Array of Diagnostic objects
 console.log(result.project); // Detected framework, React version, etc.
 ```
@@ -183,22 +286,47 @@ interface Diagnostic {
 }
 ```
 
-## [Scores for popular open-source projects](https://react.doctor/leaderboard)
+To produce the same structured output the `--json` CLI flag emits, use `toJsonReport`:
+
+```js
+import { diagnose, toJsonReport, summarizeDiagnostics } from "react-doctor/api";
+
+const result = await diagnose(".");
+
+const report = toJsonReport(result, { version: "1.0.0" });
+console.log(JSON.stringify(report, null, 2));
+
+const counts = summarizeDiagnostics(result.diagnostics);
+console.log(`${counts.errorCount} errors, ${counts.warningCount} warnings`);
+```
+
+`react-doctor/api` also re-exports the `JsonReport`, `JsonReportSummary`, `JsonReportProjectEntry`, and `JsonReportMode` types, plus the lower-level `buildJsonReport` and `buildJsonReportError` builders if you need to assemble reports from multiple `diagnose()` calls.
+
+## Use the oxlint plugin standalone
+
+If you already use oxlint and just want React Doctor's rule set, register the plugin directly in your `.oxlintrc.json`:
+
+```jsonc
+{
+  "jsPlugins": [
+    {
+      "name": "react-doctor",
+      "specifier": "react-doctor/oxlint-plugin",
+    },
+  ],
+  "rules": {
+    "react-doctor/no-fetch-in-effect": "warn",
+    "react-doctor/no-derived-state-effect": "warn",
+    // ...pick the rules you want
+  },
+}
+```
+
+The full rule list is in [`oxlint-config.ts`](https://github.com/millionco/react-doctor/blob/main/packages/react-doctor/src/oxlint-config.ts).
+
+## Scores for popular open-source projects
 
-| Project                                                | Score  | Share                                                                                   |
-| ------------------------------------------------------ | ------ | --------------------------------------------------------------------------------------- |
-| [tldraw](https://github.com/tldraw/tldraw)             | **84** | [view](https://www.react.doctor/share?p=tldraw&s=84&e=98&w=139&f=40)                    |
-| [excalidraw](https://github.com/excalidraw/excalidraw) | **84** | [view](https://www.react.doctor/share?p=%40excalidraw%2Fexcalidraw&s=84&e=2&w=196&f=80) |
-| [twenty](https://github.com/twentyhq/twenty)           | **78** | [view](https://www.react.doctor/share?p=twenty-front&s=78&e=99&w=293&f=268)             |
-| [plane](https://github.com/makeplane/plane)            | **78** | [view](https://www.react.doctor/share?p=web&s=78&e=7&w=525&f=292)                       |
-| [formbricks](https://github.com/formbricks/formbricks) | **75** | [view](https://www.react.doctor/share?p=%40formbricks%2Fweb&s=75&e=15&w=389&f=242)      |
-| [posthog](https://github.com/PostHog/posthog)          | **72** | [view](https://www.react.doctor/share?p=%40posthog%2Ffrontend&s=72&e=82&w=1177&f=585)   |
-| [supabase](https://github.com/supabase/supabase)       | **69** | [view](https://www.react.doctor/share?p=studio&s=69&e=74&w=1087&f=566)                  |
-| [onlook](https://github.com/onlook-dev/onlook)         | **69** | [view](https://www.react.doctor/share?p=%40onlook%2Fweb-client&s=69&e=64&w=418&f=178)   |
-| [payload](https://github.com/payloadcms/payload)       | **68** | [view](https://www.react.doctor/share?p=%40payloadcms%2Fui&s=68&e=139&w=408&f=298)      |
-| [sentry](https://github.com/getsentry/sentry)          | **64** | [view](https://www.react.doctor/share?p=sentry&s=64&e=94&w=1345&f=818)                  |
-| [cal.com](https://github.com/calcom/cal.com)           | **63** | [view](https://www.react.doctor/share?p=%40calcom%2Fweb&s=63&e=31&w=558&f=311)          |
-| [dub](https://github.com/dubinc/dub)                   | **62** | [view](https://www.react.doctor/share?p=web&s=62&e=52&w=966&f=457)                      |
+See the live leaderboard at [react.doctor/leaderboard](https://react.doctor/leaderboard) for current scores across React projects.
 
 ## Contributing
 
@@ -208,13 +336,13 @@ Want to contribute? Check out the codebase and submit a PR.
 git clone https://github.com/millionco/react-doctor
 cd react-doctor
 pnpm install
-pnpm -r run build
+pnpm build
 ```
 
 Run locally:
 
 ```bash
-node packages/react-doctor/dist/cli.js /path/to/your/react-project
+node packages/react-doctor/bin/react-doctor.js /path/to/your/react-project
 ```
 
 ### License

package/bin/react-doctor.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import module from "node:module";
+
+if (module.enableCompileCache && !process.env.NODE_DISABLE_COMPILE_CACHE) {
+  try {
+    module.enableCompileCache();
+  } catch {
+    // Ignore compile-cache errors.
+  }
+}
+
+await import("../dist/cli.js");

package/dist/{process-browser-diagnostics-DpaZeYLI.js → browser-BOxs7MrK.js}

@@ -1,20 +1,15 @@
 //#region src/constants.ts
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
-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 ERROR_RULE_PENALTY = 1.5;
 const WARNING_RULE_PENALTY = .75;
-const GIT_SHOW_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
-
+const buildNoReactDependencyError = (directory) => `No React dependency found in ${directory}/package.json. Add "react" to dependencies (or peerDependencies) and re-run.`;
 //#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";
+	if (score >= 75) return "Great";
+	if (score >= 50) return "Needs work";
 	return "Critical";
 };
 const countUniqueRules = (diagnostics) => {
@@ -32,7 +27,7 @@ const countUniqueRules = (diagnostics) => {
 };
 const scoreFromRuleCounts = (errorRuleCount, warningRuleCount) => {
 	const penalty = errorRuleCount * ERROR_RULE_PENALTY + warningRuleCount * WARNING_RULE_PENALTY;
-	return Math.max(0, Math.round(PERFECT_SCORE - penalty));
+	return Math.max(0, Math.round(100 - penalty));
 };
 const calculateScoreLocally = (diagnostics) => {
 	const { errorRuleCount, warningRuleCount } = countUniqueRules(diagnostics);
@@ -42,7 +37,6 @@ const calculateScoreLocally = (diagnostics) => {
 		label: getScoreLabel(score)
 	};
 };
-
 //#endregion
 //#region src/core/try-score-from-api.ts
 const parseScoreResult = (value) => {
@@ -56,29 +50,40 @@ const parseScoreResult = (value) => {
 		label: labelValue
 	};
 };
+const stripFilePaths = (diagnostics) => diagnostics.map(({ filePath: _filePath, ...rest }) => rest);
+const isAbortError = (error) => error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError");
+const describeFailure = (error) => {
+	if (isAbortError(error)) return `timed out after ${FETCH_TIMEOUT_MS / 1e3}s`;
+	if (error instanceof Error && error.message) return error.message;
+	return String(error);
+};
 const tryScoreFromApi = async (diagnostics, fetchImplementation) => {
+	if (typeof fetchImplementation !== "function") return null;
 	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 }),
+			body: JSON.stringify({ diagnostics: stripFilePaths(diagnostics) }),
 			signal: controller.signal
 		});
-		if (!response.ok) return null;
+		if (!response.ok) {
+			console.warn(`[react-doctor] Score API returned ${response.status} ${response.statusText} — using local scoring`);
+			return null;
+		}
 		return parseScoreResult(await response.json());
-	} catch {
+	} catch (error) {
+		console.warn(`[react-doctor] Score API unreachable (${describeFailure(error)}) — using local scoring`);
 		return null;
 	} finally {
 		clearTimeout(timeoutId);
 	}
 };
-
 //#endregion
 //#region src/utils/calculate-score-browser.ts
-const calculateScore = async (diagnostics) => await tryScoreFromApi(diagnostics, fetch) ?? calculateScoreLocally(diagnostics);
-
+const getGlobalFetch = () => typeof fetch === "function" ? fetch : void 0;
+const calculateScore = async (diagnostics, fetchImplementation = getGlobalFetch()) => await tryScoreFromApi(diagnostics, fetchImplementation) ?? calculateScoreLocally(diagnostics);
 //#endregion
 //#region src/utils/match-glob-pattern.ts
 const REGEX_SPECIAL_CHARACTERS = /[.+^${}()|[\]\\]/g;
@@ -106,7 +111,6 @@ const compileGlobPattern = (pattern) => {
 	regexSource += "$";
 	return new RegExp(regexSource);
 };
-
 //#endregion
 //#region src/utils/is-ignored-file.ts
 const toRelativePath = (filePath, rootDirectory) => {
@@ -115,13 +119,16 @@ const toRelativePath = (filePath, rootDirectory) => {
 	if (normalizedFilePath.startsWith(normalizedRoot)) return normalizedFilePath.slice(normalizedRoot.length);
 	return normalizedFilePath.replace(/^\.\//, "");
 };
-const compileIgnoredFilePatterns = (userConfig) => Array.isArray(userConfig?.ignore?.files) ? userConfig.ignore.files.map(compileGlobPattern) : [];
+const compileIgnoredFilePatterns = (userConfig) => {
+	const files = userConfig?.ignore?.files;
+	if (!Array.isArray(files)) return [];
+	return files.filter((entry) => typeof entry === "string").map(compileGlobPattern);
+};
 const isFileIgnoredByPatterns = (filePath, rootDirectory, patterns) => {
 	if (patterns.length === 0) return false;
 	const relativePath = toRelativePath(filePath, rootDirectory);
 	return patterns.some((pattern) => pattern.test(relativePath));
 };
-
 //#endregion
 //#region src/utils/filter-diagnostics.ts
 const resolveCandidateReadPath = (rootDirectory, filePath) => {
@@ -157,9 +164,9 @@ const isRuleSuppressed = (commentRules, ruleId) => {
 	return commentRules.split(/[,\s]+/).some((rule) => rule.trim() === ruleId);
 };
 const filterIgnoredDiagnostics = (diagnostics, config, rootDirectory, readFileLinesSync) => {
-	const ignoredRules = new Set(Array.isArray(config.ignore?.rules) ? config.ignore.rules : []);
+	const ignoredRules = new Set(Array.isArray(config.ignore?.rules) ? config.ignore.rules.filter((rule) => typeof rule === "string") : []);
 	const ignoredFilePatterns = compileIgnoredFilePatterns(config);
-	const textComponentNames = new Set(Array.isArray(config.textComponents) ? config.textComponents : []);
+	const textComponentNames = new Set(Array.isArray(config.textComponents) ? config.textComponents.filter((name) => typeof name === "string") : []);
 	const hasTextComponents = textComponentNames.size > 0;
 	const getFileLines = createFileLinesCache(rootDirectory, readFileLinesSync);
 	return diagnostics.filter((diagnostic) => {
@@ -195,13 +202,11 @@ const filterInlineSuppressions = (diagnostics, rootDirectory, readFileLinesSync)
 		return true;
 	});
 };
-
 //#endregion
 //#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) => {
@@ -213,7 +218,6 @@ const buildDiagnoseTimedResult = async (input) => {
 		elapsedMilliseconds
 	};
 };
-
 //#endregion
 //#region src/adapters/browser/create-browser-read-file-lines.ts
 const normalizeKey = (rootDirectory, filePath) => {
@@ -229,11 +233,10 @@ const createBrowserReadFileLinesSync = (rootDirectory, projectFiles) => {
 		return content.split("\n");
 	};
 };
-
 //#endregion
 //#region src/adapters/browser/diagnose.ts
 const diagnose = async (input) => {
-	if (!input.project.reactVersion) throw new Error("No React dependency found in package.json");
+	if (!input.project.reactVersion) throw new Error(buildNoReactDependencyError(input.rootDirectory));
 	const readFileLinesSync = createBrowserReadFileLinesSync(input.rootDirectory, input.projectFiles);
 	const userConfig = input.userConfig ?? null;
 	const deadCodeDiagnostics = input.deadCodeDiagnostics ?? [];
@@ -255,20 +258,9 @@ const diagnose = async (input) => {
 		elapsedMilliseconds: timed.elapsedMilliseconds
 	};
 };
-
-//#endregion
-//#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/jsx-include-paths.ts
 const computeJsxIncludePaths = (includePaths) => includePaths.length > 0 ? includePaths.filter((filePath) => JSX_FILE_PATTERN.test(filePath)) : void 0;
-
 //#endregion
 //#region src/core/diagnose-core.ts
 const diagnoseCore = async (deps, options = {}) => {
@@ -280,7 +272,7 @@ const diagnoseCore = async (deps, options = {}) => {
 	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");
+	if (!projectInfo.reactVersion) throw new Error(buildNoReactDependencyError(deps.rootDirectory));
 	const lintIncludePaths = options.lintIncludePaths !== void 0 ? options.lintIncludePaths : computeJsxIncludePaths(includePaths);
 	const { runLint, runDeadCode } = deps.createRunners({
 		resolvedDirectory,
@@ -298,7 +290,11 @@ const diagnoseCore = async (deps, options = {}) => {
 		console.error("Dead code analysis failed:", error);
 		return emptyDiagnostics;
 	}) : Promise.resolve(emptyDiagnostics);
-	const [lintDiagnostics, deadCodeDiagnostics] = await Promise.all([lintPromise, deadCodePromise]);
+	const [lintSettled, deadCodeSettled] = await Promise.allSettled([lintPromise, deadCodePromise]);
+	const lintDiagnostics = lintSettled.status === "fulfilled" ? lintSettled.value : emptyDiagnostics;
+	const deadCodeDiagnostics = deadCodeSettled.status === "fulfilled" ? deadCodeSettled.value : emptyDiagnostics;
+	if (lintSettled.status === "rejected") console.error("Lint rejected:", lintSettled.reason);
+	if (deadCodeSettled.status === "rejected") console.error("Dead code rejected:", deadCodeSettled.reason);
 	const environmentDiagnostics = deps.getExtraDiagnostics?.() ?? [];
 	const timed = await buildDiagnoseTimedResult({
 		mergedDiagnostics: [
@@ -312,14 +308,13 @@ const diagnoseCore = async (deps, options = {}) => {
 		startTime,
 		calculateDiagnosticsScore: deps.calculateDiagnosticsScore
 	});
-	return buildDiagnoseResult({
+	return {
 		diagnostics: timed.diagnostics,
 		score: timed.score,
 		project: projectInfo,
 		elapsedMilliseconds: timed.elapsedMilliseconds
-	});
+	};
 };
-
 //#endregion
 //#region src/adapters/browser/diagnose-browser.ts
 const diagnoseBrowser = async (input, options = {}) => {
@@ -339,7 +334,6 @@ const diagnoseBrowser = async (input, options = {}) => {
 		})
 	}, options);
 };
-
 //#endregion
 //#region src/adapters/browser/process-browser-diagnostics.ts
 const processBrowserDiagnostics = async (input) => {
@@ -359,7 +353,7 @@ const processBrowserDiagnostics = async (input) => {
 		score: timed.score
 	};
 };
-
 //#endregion
 export { calculateScore as a, diagnose as i, diagnoseBrowser as n, calculateScoreLocally as o, diagnoseCore as r, processBrowserDiagnostics as t };
-//# sourceMappingURL=process-browser-diagnostics-DpaZeYLI.js.map
+
+//# sourceMappingURL=browser-BOxs7MrK.js.map

package/dist/{diagnose-browser-B17IqMa3.d.ts → browser-Dcq3yn-p.d.ts}

@@ -8,6 +8,7 @@ interface ProjectInfo {
   framework: Framework;
   hasTypeScript: boolean;
   hasReactCompiler: boolean;
+  hasTanStackQuery: boolean;
   sourceFileCount: number;
 }
 interface Diagnostic {
@@ -20,7 +21,6 @@ interface Diagnostic {
   line: number;
   column: number;
   category: string;
-  weight?: number;
 }
 interface ScoreResult {
   score: number;
@@ -40,13 +40,28 @@ interface ReactDoctorConfig {
   customRulesOnly?: boolean;
   share?: boolean;
   textComponents?: string[];
+  /**
+   * Whether to respect inline `// eslint-disable*` / `// oxlint-disable*`
+   * comments in source files. Default: `true`.
+   *
+   * File-level ignores (`.gitignore`, `.eslintignore`, `.oxlintignore`,
+   * `.prettierignore`, `.gitattributes` `linguist-vendored` /
+   * `linguist-generated`) are ALWAYS honored regardless of this option
+   * — they typically point at vendored or generated code that
+   * genuinely shouldn't be linted at all.
+   *
+   * Set to `false` for "audit mode": every inline suppression is
+   * neutralized so react-doctor reports every diagnostic regardless
+   * of historical hide-comments.
+   */
+  respectInlineDisables?: boolean;
 }
 //#endregion
 //#region src/core/calculate-score-locally.d.ts
 declare const calculateScoreLocally: (diagnostics: Diagnostic[]) => ScoreResult;
 //#endregion
 //#region src/utils/calculate-score-browser.d.ts
-declare const calculateScore: (diagnostics: Diagnostic[]) => Promise<ScoreResult | null>;
+declare const calculateScore: (diagnostics: Diagnostic[], fetchImplementation?: typeof fetch | undefined) => Promise<ScoreResult | null>;
 //#endregion
 //#region src/adapters/browser/diagnose.d.ts
 interface BrowserDiagnoseInput {
@@ -100,6 +115,19 @@ interface DiagnoseCoreDeps {
 }
 declare const diagnoseCore: (deps: DiagnoseCoreDeps, options?: DiagnoseCoreOptions) => Promise<DiagnoseCoreResult>;
 //#endregion
+//#region src/adapters/browser/diagnose-browser.d.ts
+interface DiagnoseBrowserInput {
+  rootDirectory: string;
+  project: ProjectInfo;
+  projectFiles: Record<string, string>;
+  userConfig?: ReactDoctorConfig | null;
+  runOxlint: (input: {
+    lintIncludePaths: string[] | undefined;
+    customRulesOnly: boolean;
+  }) => Promise<Diagnostic[]>;
+}
+declare const diagnoseBrowser: (input: DiagnoseBrowserInput, options?: DiagnoseCoreOptions) => Promise<DiagnoseCoreResult>;
+//#endregion
 //#region src/adapters/browser/process-browser-diagnostics.d.ts
 interface ProcessBrowserDiagnosticsInput {
   rootDirectory: string;
@@ -114,18 +142,5 @@ interface ProcessBrowserDiagnosticsResult {
 }
 declare const processBrowserDiagnostics: (input: ProcessBrowserDiagnosticsInput) => Promise<ProcessBrowserDiagnosticsResult>;
 //#endregion
-//#region src/adapters/browser/diagnose-browser.d.ts
-interface DiagnoseBrowserInput {
-  rootDirectory: string;
-  project: ProjectInfo;
-  projectFiles: Record<string, string>;
-  userConfig?: ReactDoctorConfig | null;
-  runOxlint: (input: {
-    lintIncludePaths: string[] | undefined;
-    customRulesOnly: boolean;
-  }) => Promise<Diagnostic[]>;
-}
-declare const diagnoseBrowser: (input: DiagnoseBrowserInput, options?: DiagnoseCoreOptions) => Promise<DiagnoseCoreResult>;
-//#endregion
-export { ScoreResult as _, processBrowserDiagnostics as a, diagnoseCore as c, diagnose as d, calculateScore as f, ReactDoctorConfig as g, ProjectInfo as h, ProcessBrowserDiagnosticsResult as i, BrowserDiagnoseInput as l, Diagnostic as m, diagnoseBrowser as n, DiagnoseCoreOptions as o, calculateScoreLocally as p, ProcessBrowserDiagnosticsInput as r, DiagnoseCoreResult as s, DiagnoseBrowserInput as t, BrowserDiagnoseResult as u };
-//# sourceMappingURL=diagnose-browser-B17IqMa3.d.ts.map
+export { ScoreResult as _, diagnoseBrowser as a, diagnoseCore as c, diagnose as d, calculateScore as f, ReactDoctorConfig as g, ProjectInfo as h, DiagnoseBrowserInput as i, BrowserDiagnoseInput as l, Diagnostic as m, ProcessBrowserDiagnosticsResult as n, DiagnoseCoreOptions as o, calculateScoreLocally as p, processBrowserDiagnostics as r, DiagnoseCoreResult as s, ProcessBrowserDiagnosticsInput as t, BrowserDiagnoseResult as u };
+//# sourceMappingURL=browser-Dcq3yn-p.d.ts.map

package/dist/browser.d.ts

@@ -1,2 +1,2 @@
-import { _ as ScoreResult, a as processBrowserDiagnostics, c as diagnoseCore, d as diagnose, f as calculateScore, g as ReactDoctorConfig, h as ProjectInfo, i as ProcessBrowserDiagnosticsResult, l as BrowserDiagnoseInput, m as Diagnostic, n as diagnoseBrowser, o as DiagnoseCoreOptions, p as calculateScoreLocally, r as ProcessBrowserDiagnosticsInput, s as DiagnoseCoreResult, t as DiagnoseBrowserInput, u as BrowserDiagnoseResult } from "./diagnose-browser-B17IqMa3.js";
-export { type BrowserDiagnoseInput, type BrowserDiagnoseResult, type DiagnoseBrowserInput, type DiagnoseCoreOptions, type DiagnoseCoreResult, type Diagnostic, type ProcessBrowserDiagnosticsInput, type ProcessBrowserDiagnosticsResult, type ProjectInfo, type ReactDoctorConfig, type ScoreResult, calculateScore, calculateScoreLocally, diagnose, diagnoseBrowser, diagnoseCore, processBrowserDiagnostics };
+import { _ as ScoreResult, a as diagnoseBrowser, c as diagnoseCore, d as diagnose, f as calculateScore, g as ReactDoctorConfig, h as ProjectInfo, i as DiagnoseBrowserInput, l as BrowserDiagnoseInput, m as Diagnostic, n as ProcessBrowserDiagnosticsResult, o as DiagnoseCoreOptions, p as calculateScoreLocally, r as processBrowserDiagnostics, s as DiagnoseCoreResult, t as ProcessBrowserDiagnosticsInput, u as BrowserDiagnoseResult } from "./browser-Dcq3yn-p.js";
+export { BrowserDiagnoseInput, BrowserDiagnoseResult, DiagnoseBrowserInput, DiagnoseCoreOptions, DiagnoseCoreResult, Diagnostic, ProcessBrowserDiagnosticsInput, ProcessBrowserDiagnosticsResult, ProjectInfo, ReactDoctorConfig, ScoreResult, calculateScore, calculateScoreLocally, diagnose, diagnoseBrowser, diagnoseCore, processBrowserDiagnostics };

package/dist/browser.js

@@ -1,3 +1,2 @@
-import { a as calculateScore, i as diagnose, n as diagnoseBrowser, o as calculateScoreLocally, r as diagnoseCore, t as processBrowserDiagnostics } from "./process-browser-diagnostics-DpaZeYLI.js";
-
-export { calculateScore, calculateScoreLocally, diagnose, diagnoseBrowser, diagnoseCore, processBrowserDiagnostics };
+import { a as calculateScore, i as diagnose, n as diagnoseBrowser, o as calculateScoreLocally, r as diagnoseCore, t as processBrowserDiagnostics } from "./browser-BOxs7MrK.js";
+export { calculateScore, calculateScoreLocally, diagnose, diagnoseBrowser, diagnoseCore, processBrowserDiagnostics };

package/dist/cli.d.ts

@@ -1,2 +1 @@
-#!/usr/bin/env node
 export { };