react-doctor 0.6.3 → 0.7.0-dev.6b21b70

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
@@ -9743,6 +9761,32 @@ interface InspectResult {
    */
   lintCacheHitFileCount?: number | null;
   lintCacheTotalFileCount?: number | null;
+  /**
+   * Sidecar lint cache outcome: cache-hit files whose cross-file diagnostics
+   * replayed from the sidecar store, and the hits considered. Both absent
+   * when the sidecar cache was off or bypassed. The CLI projects these onto
+   * the Sentry wide event as `lint.sidecarReplayRatio`.
+   */
+  lintSidecarReplayedFileCount?: number | null;
+  lintSidecarTotalFileCount?: number | null;
+  /**
+   * Dead-code result cache outcome: `true` when the pass replayed a cached
+   * result (the analysis never ran), `false` on a fresh analysis. Absent when
+   * the pass never consulted the cache — dead-code skipped, the cache
+   * disabled, or a whole-repo cache replay where no analysis ran. The CLI
+   * projects it onto the Sentry wide event as `deadCode.cacheHit`.
+   */
+  deadCodeCacheHit?: boolean | null;
+  /**
+   * deslop's incremental summary-cache outcome for the dead-code analysis:
+   * collected files served from cached parse summaries vs freshly parsed.
+   * Both absent whenever no analysis consulted the incremental store — a
+   * whole-result cache hit, the cache disabled, or dead-code skipped. The CLI
+   * projects them onto the Sentry wide event as `deadCode.summaryCacheHits` /
+   * `deadCode.summaryCacheMisses`.
+   */
+  deadCodeSummaryCacheHits?: number | null;
+  deadCodeSummaryCacheMisses?: number | null;
   /**
    * Present only for a baseline run (`InspectOptions.baseline` set). The
    * `diagnostics` above are then the *introduced* findings only; this
@@ -9862,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[];
   /**
@@ -10146,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 {
@@ -10172,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