react-doctor 0.7.0-dev.574cba6 → 0.7.0-dev.6b21b70

package/dist/cli.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a88b7ed4-e1d2-587a-a826-36b16313d032")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e920d892-391e-5c2c-85c7-689bd4fe9775")}catch(e){}}();
 import { createRequire } from "node:module";
 import * as NodeChildProcess from "node:child_process";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
@@ -22475,6 +22475,16 @@ var JsonReportV1 = class extends Class("JsonReportV1")({
 	* successful `baseline` run (`schemaVersion: 2`) and on non-compare scopes.
 	*/
 	baselineDegraded: optional(Boolean$1),
+	/**
+	* Whether any scanned project resolved a React-compatible runtime (React
+	* or Preact). `false` means every React-runtime rule family was gated off,
+	* so an empty `diagnostics` array is vacuous — NOT the same as a clean
+	* React scan. Consumers gating on the report (CI, verifiers, hooks) should
+	* treat `reactDetected === false` as "wrong scan target", not "all clear".
+	* Absent when nothing was scanned (`projects` is empty), on error reports,
+	* and on reports from older CLI versions.
+	*/
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	projects: ArraySchema(JsonReportProjectEntry),
 	diagnostics: ArraySchema(Diagnostic),
@@ -22500,6 +22510,8 @@ var JsonReportV2 = class extends Class("JsonReportV2")({
 	ok: Boolean$1,
 	directory: String$1,
 	mode: JsonReportMode,
+	/** See `JsonReportV1.reactDetected`. */
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	baseline: JsonReportBaseline,
 	projects: ArraySchema(JsonReportProjectEntry),
@@ -40237,10 +40249,17 @@ function* collectSecurityScanFiles(rootDirectory) {
 		}
 	}
 }
+/**
+* Whether project discovery resolved a React-compatible runtime (React or
+* Preact, which ships the same hooks + JSX model). This is the same
+* predicate that grants the `react` capability, so `false` means every
+* React-runtime rule family was gated off for the project.
+*/
+const hasReactRuntime = (project) => project.reactVersion !== null || project.preactVersion !== null;
 const buildCapabilities = (project) => {
 	const capabilities = /* @__PURE__ */ new Set();
 	capabilities.add(project.framework);
-	if (project.reactVersion !== null || project.preactVersion !== null) capabilities.add("react");
+	if (hasReactRuntime(project)) capabilities.add("react");
 	if (project.framework === "expo" || project.framework === "react-native" || project.hasReactNativeWorkspace) capabilities.add("react-native");
 	if (project.expoVersion !== null) capabilities.add("expo");
 	if (project.nextjsMajorVersion !== null && project.nextjsMajorVersion >= 15) capabilities.add("nextjs:15");
@@ -45355,6 +45374,7 @@ const buildJsonReport = (input) => {
 	const worstScoredProject = findWorstScoredProject(projects);
 	const summary = summarizeDiagnostics(flattenedDiagnostics, worstScoredProject?.score?.score ?? null, worstScoredProject?.score?.label ?? null);
 	const shared = {
+		...input.scans.length > 0 ? { reactDetected: input.scans.some((scan) => hasReactRuntime(scan.result.project)) } : {},
 		version: input.version,
 		ok: true,
 		directory: input.directory,
@@ -45818,6 +45838,7 @@ const METRIC = {
 	scanScore: "scan.score",
 	scanClean: "scan.clean",
 	scanCheckSkipped: "scan.check_skipped",
+	scanNoReactDetected: "scan.no_react_detected",
 	baselineDegraded: "baseline.degraded",
 	ruleFired: "rule.fired",
 	ruleDisabled: "rule.disabled",
@@ -45887,7 +45908,7 @@ const makeNoopConsole = () => ({
 });
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.7.0-dev.574cba6";
+const VERSION = "0.7.0-dev.6b21b70";
 //#endregion
 //#region src/cli/utils/json-mode.ts
 let context = null;
@@ -46256,13 +46277,13 @@ const isDevVersion = (version) => version === "0.0.0" || version.includes("-");
 * uploads source-map artifacts under, so stack frames symbolicate. Honors the
 * standard `SENTRY_RELEASE` override.
 */
-const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.7.0-dev.574cba6`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.7.0-dev.6b21b70`;
 /**
 * Deployment environment shown in Sentry's environment filter. Defaults to
 * `production` for tagged releases and `development` for dev/unbuilt versions,
 * overridable via the standard `SENTRY_ENVIRONMENT` env var.
 */
-const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.7.0-dev.574cba6") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.7.0-dev.6b21b70") ? "development" : "production");
 /**
 * Performance-tracing sample rate in `[0, 1]`. Reads `SENTRY_TRACES_SAMPLE_RATE`
 * (set to `0` to disable tracing) and falls back to
@@ -62975,6 +62996,11 @@ const finalizeScans = (input) => {
 	const baselineComputed = input.completedScans.length > 0 && input.completedScans.every((scan) => scan.result.baselineDelta !== void 0);
 	const baselineDegraded = input.baselineIntended && !baselineComputed;
 	const mode = baselineDegraded ? "diff" : input.mode;
+	const isReactDetected = input.completedScans.some((scan) => hasReactRuntime(scan.result.project));
+	if (input.completedScans.length > 0 && !isReactDetected) {
+		recordCount(METRIC.scanNoReactDetected, 1);
+		cliLogger.warn(`No React project detected at ${input.resolvedDirectory} — React rules were gated off; this is not the same as a clean scan.`);
+	}
 	const jsonCompletedScans = filterCompletedScansByCategories(input.completedScans, input.categoryFilters);
 	if (input.isJsonMode) {
 		const baseline = baselineComputed && baselineDeltas.length > 0 ? {
@@ -64412,4 +64438,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=a88b7ed4-e1d2-587a-a826-36b16313d032
+//# debugId=e920d892-391e-5c2c-85c7-689bd4fe9775

package/dist/index.d.ts

@@ -9644,6 +9644,17 @@ interface DiagnoseResult {
   /** See `InspectResult.skippedCheckReasons`. */
   skippedCheckReasons?: Record<string, string>;
   project: ProjectInfo;
+  /**
+   * Whether the scanned project resolved a React-compatible runtime (React
+   * or Preact). `false` means every React-runtime rule family was gated
+   * off, so an empty `diagnostics` array is vacuous — NOT the same as a
+   * clean React scan. Consumers gating on the result should treat
+   * `reactDetected === false` as "wrong scan target", not "all clear".
+   * Mirrors `JsonReport.reactDetected`; same predicate as
+   * `hasReactRuntime(result.project)`. Always set by `diagnose()`;
+   * optional so hand-constructed results keep compiling.
+   */
+  reactDetected?: boolean;
   elapsedMilliseconds: number;
 }
 /**
@@ -9693,6 +9704,13 @@ interface DiagnoseProjectsResult {
   projects: ProjectResult[];
   diagnostics: Diagnostic[];
   score: ScoreResult | null;
+  /**
+   * Whether any successfully scanned project resolved a React-compatible
+   * runtime (React or Preact). Absent when no project scanned successfully.
+   * See `DiagnoseResult.reactDetected` for gating guidance; per-project
+   * detail is on each `ProjectResultOk.reactDetected`.
+   */
+  reactDetected?: boolean;
   elapsedMilliseconds: number;
 } //#endregion
 //#region src/types/handle-error.d.ts
@@ -9888,6 +9906,17 @@ interface JsonReportV1$1 {
   ok: boolean;
   directory: string;
   mode: JsonReportMode;
+  /**
+   * Whether any scanned project resolved a React-compatible runtime (React
+   * or Preact). `false` means every React-runtime rule family was gated off,
+   * so an empty `diagnostics` array is vacuous — NOT the same as a clean
+   * React scan. Consumers gating on the report (CI, verifiers, hooks) should
+   * treat `reactDetected === false` as "wrong scan target", not "all clear"
+   * (per project, `projects[].project.reactVersion` / `preactVersion` say
+   * which roots were non-React). Absent when nothing was scanned (`projects`
+   * is empty), on error reports, and on reports from older CLI versions.
+   */
+  reactDetected?: boolean;
   diff: JsonReportDiffInfo | null;
   projects: JsonReportProjectEntry[];
   /**
@@ -10172,6 +10201,16 @@ declare const summarizeDiagnostics: (diagnostics: Diagnostic[], worstScore?: num
 declare const defineConfig: (config: ReactDoctorConfig) => ReactDoctorConfig; //#endregion
 //#region src/utils/detect-ai-training-environment.d.ts
 //#endregion
+//#region src/utils/has-react-runtime.d.ts
+/**
+ * Whether project discovery resolved a React-compatible runtime (React or
+ * Preact, which ships the same hooks + JSX model). This is the same
+ * predicate that grants the `react` capability, so `false` means every
+ * React-runtime rule family was gated off for the project.
+ */
+declare const hasReactRuntime: (project: ProjectInfo) => boolean; //#endregion
+//#region src/utils/is-errno-exception.d.ts
+//#endregion
 //#region ../api/dist/index.d.ts
 //#region src/diagnose.d.ts
 interface Diagnose {
@@ -10198,5 +10237,5 @@ interface ToJsonReportOptions {
 }
 declare const toJsonReport: (result: DiagnoseResult, options: ToJsonReportOptions) => JsonReport;
 //#endregion
-export { AmbiguousProjectError, type DiagnoseOptions, type DiagnoseProjectsInput, type DiagnoseProjectsResult, type DiagnoseResult, type Diagnostic, type DiffInfo, type JsonReport, type JsonReportDiffInfo, type JsonReportError, type JsonReportMode, type JsonReportProjectEntry, type JsonReportSummary, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, type ProjectDefinition, type ProjectInfo, ProjectNotFoundError, type ProjectResult, type ProjectResultError, type ProjectResultOk, type ReactDoctorConfig, ReactDoctorError, type ScoreResult, buildJsonReport, buildJsonReportError, clearCaches, defineConfig, diagnose, filterSourceFiles, getDiffInfo, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
+export { AmbiguousProjectError, type DiagnoseOptions, type DiagnoseProjectsInput, type DiagnoseProjectsResult, type DiagnoseResult, type Diagnostic, type DiffInfo, type JsonReport, type JsonReportDiffInfo, type JsonReportError, type JsonReportMode, type JsonReportProjectEntry, type JsonReportSummary, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, type ProjectDefinition, type ProjectInfo, ProjectNotFoundError, type ProjectResult, type ProjectResultError, type ProjectResultOk, type ReactDoctorConfig, ReactDoctorError, type ScoreResult, buildJsonReport, buildJsonReportError, clearCaches, defineConfig, diagnose, filterSourceFiles, getDiffInfo, hasReactRuntime, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5c52dece-7b5e-5102-9381-7d05fa45734f")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="07deeb70-f47f-5572-9930-e743f970f84f")}catch(e){}}();
 import { r as __toESM$1, t as __commonJSMin$1 } from "./chunk-N93fKeF6.js";
 import { createRequire } from "node:module";
 import * as NFS from "node:fs";
@@ -19374,6 +19374,16 @@ var JsonReportV1 = class extends Class("JsonReportV1")({
 	* successful `baseline` run (`schemaVersion: 2`) and on non-compare scopes.
 	*/
 	baselineDegraded: optional(Boolean$1),
+	/**
+	* Whether any scanned project resolved a React-compatible runtime (React
+	* or Preact). `false` means every React-runtime rule family was gated off,
+	* so an empty `diagnostics` array is vacuous — NOT the same as a clean
+	* React scan. Consumers gating on the report (CI, verifiers, hooks) should
+	* treat `reactDetected === false` as "wrong scan target", not "all clear".
+	* Absent when nothing was scanned (`projects` is empty), on error reports,
+	* and on reports from older CLI versions.
+	*/
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	projects: ArraySchema(JsonReportProjectEntry),
 	diagnostics: ArraySchema(Diagnostic),
@@ -19399,6 +19409,8 @@ var JsonReportV2 = class extends Class("JsonReportV2")({
 	ok: Boolean$1,
 	directory: String$1,
 	mode: JsonReportMode,
+	/** See `JsonReportV1.reactDetected`. */
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	baseline: JsonReportBaseline,
 	projects: ArraySchema(JsonReportProjectEntry),
@@ -37010,10 +37022,17 @@ function* collectSecurityScanFiles(rootDirectory) {
 		}
 	}
 }
+/**
+* Whether project discovery resolved a React-compatible runtime (React or
+* Preact, which ships the same hooks + JSX model). This is the same
+* predicate that grants the `react` capability, so `false` means every
+* React-runtime rule family was gated off for the project.
+*/
+const hasReactRuntime = (project) => project.reactVersion !== null || project.preactVersion !== null;
 const buildCapabilities = (project) => {
 	const capabilities = /* @__PURE__ */ new Set();
 	capabilities.add(project.framework);
-	if (project.reactVersion !== null || project.preactVersion !== null) capabilities.add("react");
+	if (hasReactRuntime(project)) capabilities.add("react");
 	if (project.framework === "expo" || project.framework === "react-native" || project.hasReactNativeWorkspace) capabilities.add("react-native");
 	if (project.expoVersion !== null) capabilities.add("expo");
 	if (project.nextjsMajorVersion !== null && project.nextjsMajorVersion >= 15) capabilities.add("nextjs:15");
@@ -42088,6 +42107,7 @@ const buildJsonReport = (input) => {
 	const worstScoredProject = findWorstScoredProject(projects);
 	const summary = summarizeDiagnostics(flattenedDiagnostics, worstScoredProject?.score?.score ?? null, worstScoredProject?.score?.label ?? null);
 	const shared = {
+		...input.scans.length > 0 ? { reactDetected: input.scans.some((scan) => hasReactRuntime(scan.result.project)) } : {},
 		version: input.version,
 		ok: true,
 		directory: input.directory,
@@ -42317,6 +42337,7 @@ const outputToDiagnoseResult = (output, elapsedMilliseconds) => {
 		skippedChecks,
 		...Object.keys(skippedCheckReasons).length > 0 ? { skippedCheckReasons } : {},
 		project: output.project,
+		reactDetected: hasReactRuntime(output.project),
 		elapsedMilliseconds
 	};
 };
@@ -42372,10 +42393,12 @@ const diagnoseProjectBatch = async (input) => {
 	const startTime = globalThis.performance.now();
 	const { projects, concurrency, config: batchConfig, ...baseOptions } = input;
 	const projectResults = await mapWithConcurrency(projects, concurrency ?? 4, (projectDefinition) => diagnoseProject(projectDefinition, baseOptions, batchConfig));
+	const succeededProjects = projectResults.filter((projectResult) => projectResult.ok);
 	return {
 		projects: projectResults,
-		diagnostics: projectResults.flatMap((projectResult) => projectResult.ok ? projectResult.diagnostics : []),
+		diagnostics: succeededProjects.flatMap((projectResult) => projectResult.diagnostics),
 		score: findWorstScore(projectResults),
+		...succeededProjects.length > 0 ? { reactDetected: succeededProjects.some((projectResult) => projectResult.reactDetected) } : {},
 		elapsedMilliseconds: globalThis.performance.now() - startTime
 	};
 };
@@ -42410,7 +42433,7 @@ const toJsonReport = (result, options) => buildJsonReport({
 	totalElapsedMilliseconds: result.elapsedMilliseconds
 });
 //#endregion
-export { AmbiguousProjectError, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, ProjectNotFoundError, ReactDoctorError, buildJsonReport, buildJsonReportError, clearCaches, defineConfig, diagnose, filterSourceFiles, getDiffInfo, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
+export { AmbiguousProjectError, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, ProjectNotFoundError, ReactDoctorError, buildJsonReport, buildJsonReportError, clearCaches, defineConfig, diagnose, filterSourceFiles, getDiffInfo, hasReactRuntime, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
 
 //# sourceMappingURL=index.js.map
-//# debugId=5c52dece-7b5e-5102-9381-7d05fa45734f
+//# debugId=07deeb70-f47f-5572-9930-e743f970f84f

package/dist/lsp.js

@@ -19410,6 +19410,16 @@ var JsonReportV1 = class extends Class("JsonReportV1")({
 	* successful `baseline` run (`schemaVersion: 2`) and on non-compare scopes.
 	*/
 	baselineDegraded: optional(Boolean$1),
+	/**
+	* Whether any scanned project resolved a React-compatible runtime (React
+	* or Preact). `false` means every React-runtime rule family was gated off,
+	* so an empty `diagnostics` array is vacuous — NOT the same as a clean
+	* React scan. Consumers gating on the report (CI, verifiers, hooks) should
+	* treat `reactDetected === false` as "wrong scan target", not "all clear".
+	* Absent when nothing was scanned (`projects` is empty), on error reports,
+	* and on reports from older CLI versions.
+	*/
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	projects: ArraySchema(JsonReportProjectEntry),
 	diagnostics: ArraySchema(Diagnostic),
@@ -19435,6 +19445,8 @@ var JsonReportV2 = class extends Class("JsonReportV2")({
 	ok: Boolean$1,
 	directory: String$1,
 	mode: JsonReportMode,
+	/** See `JsonReportV1.reactDetected`. */
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	baseline: JsonReportBaseline,
 	projects: ArraySchema(JsonReportProjectEntry),
@@ -36995,10 +37007,17 @@ function* collectSecurityScanFiles(rootDirectory) {
 		}
 	}
 }
+/**
+* Whether project discovery resolved a React-compatible runtime (React or
+* Preact, which ships the same hooks + JSX model). This is the same
+* predicate that grants the `react` capability, so `false` means every
+* React-runtime rule family was gated off for the project.
+*/
+const hasReactRuntime = (project) => project.reactVersion !== null || project.preactVersion !== null;
 const buildCapabilities = (project) => {
 	const capabilities = /* @__PURE__ */ new Set();
 	capabilities.add(project.framework);
-	if (project.reactVersion !== null || project.preactVersion !== null) capabilities.add("react");
+	if (hasReactRuntime(project)) capabilities.add("react");
 	if (project.framework === "expo" || project.framework === "react-native" || project.hasReactNativeWorkspace) capabilities.add("react-native");
 	if (project.expoVersion !== null) capabilities.add("expo");
 	if (project.nextjsMajorVersion !== null && project.nextjsMajorVersion >= 15) capabilities.add("nextjs:15");
@@ -43792,6 +43811,7 @@ const METRIC = {
 	scanScore: "scan.score",
 	scanClean: "scan.clean",
 	scanCheckSkipped: "scan.check_skipped",
+	scanNoReactDetected: "scan.no_react_detected",
 	baselineDegraded: "baseline.degraded",
 	ruleFired: "rule.fired",
 	ruleDisabled: "rule.disabled",
@@ -44135,5 +44155,5 @@ const startLanguageServer = () => {
 };
 //#endregion
 export { startLanguageServer };
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1b40bd68-7ad4-55e0-a6bd-91b6cdcd0ba8")}catch(e){}}();
-//# debugId=1b40bd68-7ad4-55e0-a6bd-91b6cdcd0ba8
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1c7dd926-433e-5edb-a6d7-2bb0a9f6df24")}catch(e){}}();
+//# debugId=1c7dd926-433e-5edb-a6d7-2bb0a9f6df24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-doctor",
-  "version": "0.7.0-dev.574cba6",
+  "version": "0.7.0-dev.6b21b70",
   "description": "Your agent writes bad React. This catches it",
   "keywords": [
     "accessibility",
@@ -66,7 +66,7 @@
     "vscode-uri": "^3.1.0",
     "yaml": "^2.9.0",
     "deslop-js": "0.7.0",
-    "oxlint-plugin-react-doctor": "0.7.0-dev.574cba6"
+    "oxlint-plugin-react-doctor": "0.7.0-dev.6b21b70"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.27.0",