react-doctor 0.2.14-dev.b612664 → 0.2.14-dev.daef23c

package/dist/index.d.ts

@@ -53,6 +53,14 @@ type RuleSeverityOverride = "error" | "warn" | "off";
  * `rules` and `categories` fields on `ReactDoctorConfig`. Per-rule
  * wins over per-category when both match the same diagnostic.
  */
+/**
+ * Closed set of severity buckets. Spelled out (rather than
+ * `Record<string, …>`) so an unknown/typo'd bucket key is a type error
+ * instead of a silent no-op.
+ */
+interface SeverityBuckets {
+  "compiler-cleanup"?: RuleSeverityOverride;
+}
 interface SurfaceControls {
   /**
    * Tag names whose diagnostics should be force-included on the surface,
@@ -66,9 +74,9 @@ interface SurfaceControls {
    * `["test-noise"]`) for a single channel without touching others.
    */
   excludeTags?: string[];
-  /** Category names (e.g. `"Architecture"`) to force-include. */
+  /** Category names (e.g. `"Maintainability"`) to force-include. */
   includeCategories?: string[];
-  /** Category names (e.g. `"Architecture"`) to exclude. */
+  /** Category names (e.g. `"Maintainability"`) to exclude. */
   excludeCategories?: string[];
   /**
    * Fully-qualified rule keys (`"<plugin>/<rule>"`, e.g.
@@ -85,12 +93,23 @@ interface ReactDoctorConfig {
   /**
    * Whether to run dead-code analysis (via `deslop-js`) alongside lint.
    * Reports unused files, unused exports, unused dependencies, and
-   * circular imports under the "Dead Code" category. Default: `true`.
+   * circular imports under the "Maintainability" category. Default: `true`.
    * Always skipped in `--diff` / `--staged` modes because reachability
    * is a whole-project property.
    */
   deadCode?: boolean;
   verbose?: boolean;
+  /**
+   * Whether to surface `"warning"`-severity diagnostics. Default: `false`
+   * — only `"error"`-severity findings reach any surface (CLI, PR comment,
+   * score, `--fail-on`).
+   *
+   * Set to `true` to surface every warning on every surface. This is the
+   * master toggle and runs after per-rule / per-category severity
+   * overrides: a rule the user explicitly restamps to `"warn"` (via
+   * `rules` / `categories`) still shows even when `warnings` is `false`.
+   */
+  warnings?: boolean;
   diff?: boolean | string;
   failOn?: FailOnLevel;
   customRulesOnly?: boolean;
@@ -229,15 +248,12 @@ interface ReactDoctorConfig {
   rules?: Record<string, RuleSeverityOverride>;
   /**
    * Per-category severity map. Mirrors oxlint's top-level
-   * `categories` field, but keyed by React Doctor's display
-   * categories (`"Server"`, `"React Native"`, `"Architecture"`,
-   * `"Bundle Size"`, `"State & Effects"`, `"Security"`,
-   * `"Accessibility"`, `"Performance"`, `"Correctness"`,
-   * `"Next.js"`, `"Preact"`, `"TanStack Query"`,
-   * `"TanStack Start"`, …).
+   * `categories` field, but keyed by React Doctor's five user-facing
+   * buckets: `"Security"`, `"Bugs"`, `"Performance"`,
+   * `"Accessibility"`, `"Maintainability"`.
    *
    * ```json
-   * { "categories": { "React Native": "warn", "Server": "off" } }
+   * { "categories": { "Maintainability": "off", "Performance": "warn" } }
    * ```
    *
    * To silence a whole tag-defined rule family (e.g. `"design"`,
@@ -245,6 +261,20 @@ interface ReactDoctorConfig {
    * single category, use `ignore.tags` instead.
    */
   categories?: Record<string, RuleSeverityOverride>;
+  /**
+   * Per-bucket severity map. Buckets are curated rule families with a
+   * shared gating story (not categories). Today the only bucket is
+   * `"compiler-cleanup"`: the redundant-memoization rule
+   * (`react-compiler-no-manual-memoization`) that ships as a warning once
+   * React Compiler is detected. Set it to `"error"` to re-enable strictness.
+   *
+   * ```json
+   * { "buckets": { "compiler-cleanup": "error" } }
+   * ```
+   *
+   * A per-rule override in `rules` still wins over a bucket entry.
+   */
+  buckets?: SeverityBuckets;
   /**
    * User-defined oxlint plugins to load alongside the built-in
    * `react-doctor` plugin. Each entry is either:
@@ -288,6 +318,7 @@ interface Diagnostic {
   plugin: string;
   rule: string;
   severity: "error" | "warning";
+  title?: string;
   message: string;
   help: string;
   url?: string;
@@ -371,6 +402,12 @@ interface DiagnoseOptions {
    * See that field's docs for the full contract.
    */
   respectInlineDisables?: boolean;
+  /**
+   * Per-call override for `ReactDoctorConfig.warnings`. See that field's
+   * docs — `"warning"`-severity diagnostics are hidden unless this (or
+   * the config) opts them back in.
+   */
+  warnings?: boolean;
 }
 interface DiagnoseResult {
   diagnostics: Diagnostic[];
@@ -410,6 +447,28 @@ interface InspectResult {
   skippedCheckReasons?: Record<string, string>;
   project: ProjectInfo;
   elapsedMilliseconds: number;
+  /**
+   * Number of files the scan reported. Distinct from
+   * `project.sourceFileCount` in diff / staged mode (where only changed
+   * files are scanned). Optional so non-orchestrator constructors keep
+   * working; the multi-project summary falls back to
+   * `project.sourceFileCount` when absent.
+   */
+  scannedFileCount?: number;
+  /**
+   * Absolute paths of every file the scan considered. Lets the
+   * multi-project summary count UNIQUE files across projects instead of
+   * summing per-project counts, which double-counts shared files when one
+   * workspace package's tree is nested inside another's.
+   */
+  scannedFilePaths?: ReadonlyArray<string>;
+  /**
+   * Wall-clock duration of the scan phase, in milliseconds. Distinct
+   * from `elapsedMilliseconds` (which spans the full `inspect()` call
+   * including score fetch + rendering). Used by the multi-project
+   * summary to report combined scan time.
+   */
+  scanElapsedMilliseconds?: number;
 }
 /**
  * Options accepted by `inspect()`. Mixes two concern groups; ordered