no-mistakes 0.19.0 → 0.20.0

package/index.d.ts

@@ -12,6 +12,7 @@ import type {
   ProjectOptions,
   QueueReport,
   ReactComponentFacts,
+  ReactUsagesReport,
   ReactViolation,
   ServerRoutesReport,
   SymbolsOptions,
@@ -55,5 +56,8 @@ export function serverRouteEdges(options?: ProjectOptions): Promise<GraphEdge[]>
 export function serverRouteRelated(options: ProjectOptions): Promise<GraphEdge[]>;
 export function reactAnalyze(options?: ProjectOptions): Promise<ReactComponentFacts[]>;
 export function reactCheck(options?: ProjectOptions): Promise<ReactViolation[]>;
+export function reactUsages(
+  options: ProjectOptions & { target: string },
+): Promise<ReactUsagesReport>;
 export function lockfileDiff(options: LockfileDiffOptions): Promise<LockfileDiffEntry[]>;
 export function version(): Promise<string>;

package/index.js

@@ -114,6 +114,10 @@ async function reactCheck(options) {
   return callJson(native.reactCheckJson, options);
 }
 
+async function reactUsages(options) {
+  return callJson(native.reactUsagesJson, options);
+}
+
 async function lockfileDiff(options) {
   return callJson(native.lockfileDiffJson, options);
 }
@@ -139,6 +143,7 @@ module.exports = {
   queueRelated,
   reactAnalyze,
   reactCheck,
+  reactUsages,
   related,
   serverRouteEdges,
   serverRouteList,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "no-mistakes",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Static codebase analysis tools for TS/JS dependencies, dependents, and symbols",
   "license": "MIT",
   "repository": {

package/report-types.d.ts

@@ -138,3 +138,22 @@ export interface ReactViolation {
   rule: string;
   detail?: string;
 }
+
+export interface ReactCallsite {
+  file: string;
+  line: number;
+  component: string;
+  props: string[];
+  hasSpread: boolean;
+}
+
+export interface ReactUsagesReport {
+  target: { file: string; symbol?: string };
+  callsites: ReactCallsite[];
+  /** Story files importing the target. Omitted when `props`/`tests`-only `include`. */
+  stories?: string[];
+  /** Test files importing the target. */
+  tests?: string[];
+  /** Exported prop type/interface names declared in the target file. */
+  propTypes?: string[];
+}

package/traversal-types.d.ts

@@ -114,6 +114,10 @@ export interface ProjectOptions {
   depth?: number;
   assertNoFetch?: boolean;
   direction?: "deps" | "dependents" | "both";
+  /** `reactUsages` target component (`path` or `path#Symbol`). */
+  target?: string;
+  /** `reactUsages` `--include` spec: comma-separated `stories,tests,props`. */
+  include?: string;
 }
 
 type BatchedProjectOptions = Omit<ProjectOptions, "root" | "tsconfig" | "config">;