rerender-lens 0.3.0 → 0.5.0

package/dist/{types-BzUEVkxJ.d.cts → types-DW5-N2XH.d.cts}

@@ -32,7 +32,7 @@ type RenderTrigger =
 /** More than one of the above. */
  | 'mixed';
 interface HookChange extends Change {
-    /** `useState`, `useReducer`, `useContext`, `useSyncExternalStore`, or `state` when the exact hook is unknown. */
+    /** `useState`, `useReducer`, `useContext`, `useSyncExternalStore`, `useDeferredValue` (dev builds), or `state` when the exact hook is unknown. */
     hook: string;
     /** Position of the hook in call order (0-based). */
     index: number;
@@ -124,6 +124,12 @@ interface RenderReport {
     path: string[];
     /** True for `React.memo` components and `PureComponent` classes: props alone decide whether they re-render. */
     memoized: boolean;
+    /**
+     * True when React Compiler compiled the component (its fiber carries a `useMemoCache` cache). React still
+     * calls it when the parent renders, but its output is memoized per input, so a `parent` render with
+     * identical props is cheap and not reported as avoidable.
+     */
+    compiled?: boolean;
     /** Time spent in this component's own render (children excluded), in ms, when React exposes it (dev/profiling builds). */
     selfDuration?: number;
     /** Time spent rendering this component and everything below it that rendered in the same commit, in ms. */
@@ -135,6 +141,53 @@ interface RenderReport {
     /** `performance.now()` (or `Date.now()`) when the report was produced. */
     time: number;
 }
+/**
+ * The fields the analysis helpers (`fixesFor`, `rankFixes`, `analyzeCommit`, `rankRootCauses`, `summarizeReports`, `summarize`) read,
+ * as a structural type: both a live `RenderReport` and the DevTools panel's serialized report satisfy
+ * it, so the panel and the library share one implementation without casts.
+ */
+interface ChangeLike {
+    path: string;
+    kind: ChangeKind;
+    prev?: unknown;
+    next?: unknown;
+    hook?: string;
+    index?: number;
+    provider?: {
+        component: string | null;
+        path: string[];
+    };
+    changedKeys?: string[];
+    totalKeys?: number;
+    custom?: string[];
+}
+interface ReportLike {
+    component: string;
+    avoidable: boolean;
+    trigger: string;
+    memoized?: boolean;
+    compiled?: boolean;
+    propChanges: ChangeLike[];
+    stateChanges: ChangeLike[];
+    hookChanges: ChangeLike[];
+    parent: {
+        name: string;
+        trigger: string;
+    } | null;
+    owner: string | null;
+    path: string[];
+    selfDuration?: number;
+    time: number;
+    /** Shared by every report of one React commit; the root-cause analysis groups by it. 0/absent = unknown. */
+    commitId?: number;
+    updaters?: string[];
+    commitCause?: string;
+    afterCommit?: number;
+    contexts?: {
+        name: string;
+        value: unknown;
+    }[];
+}
 type Notifier = (report: RenderReport) => void;
 type ComponentMatcher = string | RegExp | ((displayName: string) => boolean);
 interface Options {
@@ -174,4 +227,4 @@ interface Options {
 /** Marker static: `MyComponent.rerenderLens = true` opts a component in. */
 declare const MARKER: "rerenderLens";
 
-export { type ChangeKind as C, type HookChange as H, MARKER as M, type Notifier as N, type Options as O, type ParentInfo as P, type RenderReport as R, type SourceLocation as S, type Change as a, type HookSnapshot as b, type CommitPriority as c, type CommitCause as d, type ComponentMatcher as e, type RenderTrigger as f };
+export { type ChangeKind as C, type HookChange as H, MARKER as M, type Notifier as N, type Options as O, type ParentInfo as P, type RenderReport as R, type SourceLocation as S, type ReportLike as a, type Change as b, type HookSnapshot as c, type CommitPriority as d, type CommitCause as e, type ChangeLike as f, type ComponentMatcher as g, type RenderTrigger as h };

package/dist/{types-BzUEVkxJ.d.ts → types-DW5-N2XH.d.ts}

@@ -32,7 +32,7 @@ type RenderTrigger =
 /** More than one of the above. */
  | 'mixed';
 interface HookChange extends Change {
-    /** `useState`, `useReducer`, `useContext`, `useSyncExternalStore`, or `state` when the exact hook is unknown. */
+    /** `useState`, `useReducer`, `useContext`, `useSyncExternalStore`, `useDeferredValue` (dev builds), or `state` when the exact hook is unknown. */
     hook: string;
     /** Position of the hook in call order (0-based). */
     index: number;
@@ -124,6 +124,12 @@ interface RenderReport {
     path: string[];
     /** True for `React.memo` components and `PureComponent` classes: props alone decide whether they re-render. */
     memoized: boolean;
+    /**
+     * True when React Compiler compiled the component (its fiber carries a `useMemoCache` cache). React still
+     * calls it when the parent renders, but its output is memoized per input, so a `parent` render with
+     * identical props is cheap and not reported as avoidable.
+     */
+    compiled?: boolean;
     /** Time spent in this component's own render (children excluded), in ms, when React exposes it (dev/profiling builds). */
     selfDuration?: number;
     /** Time spent rendering this component and everything below it that rendered in the same commit, in ms. */
@@ -135,6 +141,53 @@ interface RenderReport {
     /** `performance.now()` (or `Date.now()`) when the report was produced. */
     time: number;
 }
+/**
+ * The fields the analysis helpers (`fixesFor`, `rankFixes`, `analyzeCommit`, `rankRootCauses`, `summarizeReports`, `summarize`) read,
+ * as a structural type: both a live `RenderReport` and the DevTools panel's serialized report satisfy
+ * it, so the panel and the library share one implementation without casts.
+ */
+interface ChangeLike {
+    path: string;
+    kind: ChangeKind;
+    prev?: unknown;
+    next?: unknown;
+    hook?: string;
+    index?: number;
+    provider?: {
+        component: string | null;
+        path: string[];
+    };
+    changedKeys?: string[];
+    totalKeys?: number;
+    custom?: string[];
+}
+interface ReportLike {
+    component: string;
+    avoidable: boolean;
+    trigger: string;
+    memoized?: boolean;
+    compiled?: boolean;
+    propChanges: ChangeLike[];
+    stateChanges: ChangeLike[];
+    hookChanges: ChangeLike[];
+    parent: {
+        name: string;
+        trigger: string;
+    } | null;
+    owner: string | null;
+    path: string[];
+    selfDuration?: number;
+    time: number;
+    /** Shared by every report of one React commit; the root-cause analysis groups by it. 0/absent = unknown. */
+    commitId?: number;
+    updaters?: string[];
+    commitCause?: string;
+    afterCommit?: number;
+    contexts?: {
+        name: string;
+        value: unknown;
+    }[];
+}
 type Notifier = (report: RenderReport) => void;
 type ComponentMatcher = string | RegExp | ((displayName: string) => boolean);
 interface Options {
@@ -174,4 +227,4 @@ interface Options {
 /** Marker static: `MyComponent.rerenderLens = true` opts a component in. */
 declare const MARKER: "rerenderLens";
 
-export { type ChangeKind as C, type HookChange as H, MARKER as M, type Notifier as N, type Options as O, type ParentInfo as P, type RenderReport as R, type SourceLocation as S, type Change as a, type HookSnapshot as b, type CommitPriority as c, type CommitCause as d, type ComponentMatcher as e, type RenderTrigger as f };
+export { type ChangeKind as C, type HookChange as H, MARKER as M, type Notifier as N, type Options as O, type ParentInfo as P, type RenderReport as R, type SourceLocation as S, type ReportLike as a, type Change as b, type HookSnapshot as c, type CommitPriority as d, type CommitCause as e, type ChangeLike as f, type ComponentMatcher as g, type RenderTrigger as h };

package/dist/vite.d.cts

@@ -1,4 +1,4 @@
-import { O as Options } from './types-BzUEVkxJ.cjs';
+import { O as Options } from './types-DW5-N2XH.cjs';
 
 /** `Options` minus the parts that cannot be serialized into a module (functions). Matchers may be strings or RegExps. */
 type VitePluginOptions = Omit<Options, 'notifier' | 'console' | 'include' | 'exclude'> & {

package/dist/vite.d.ts

@@ -1,4 +1,4 @@
-import { O as Options } from './types-BzUEVkxJ.js';
+import { O as Options } from './types-DW5-N2XH.js';
 
 /** `Options` minus the parts that cannot be serialized into a module (functions). Matchers may be strings or RegExps. */
 type VitePluginOptions = Omit<Options, 'notifier' | 'console' | 'include' | 'exclude'> & {