rerender-lens 0.4.0 → 0.7.0

package/dist/{budget-LkNjGtRc.d.ts → budget-CA1MS7lB.d.cts}

@@ -1,9 +1,9 @@
-import { R as RenderReport } from './types-BzUEVkxJ.js';
+import { b as ReportLike, R as RenderReport } from './types-DwNN5cWe.cjs';
 
 /**
  * Concrete fixes derived from reports, ranked by how many avoidable re-renders each one removes.
- * The same logic drives the extension's Fixes view; here it is typed on `RenderReport` for tests,
- * CI budgets and the CLI. Pure.
+ * One implementation for the library (tests, CI budgets, the CLI, typed on `RenderReport`) and the
+ * DevTools panel (serialized reports): everything here reads only `ReportLike`. Pure.
  */
 
 type FixKind = 'memo' | 'useCallback' | 'useMemo' | 'useMemoElement' | 'children' | 'contextValue' | 'splitContext' | 'storeSnapshot' | 'bailout';
@@ -16,19 +16,29 @@ interface Fix {
     prop: string | null;
     label: string;
     detail: string;
+    /** Code sketch of the fix, `// <owner>` on the first line. */
+    snippet: string;
 }
-interface RankedFix extends Fix {
+interface RankedFix<R extends ReportLike = RenderReport> extends Fix {
     key: string;
     /** Avoidable re-renders this fix removes. */
     count: number;
     components: Record<string, number>;
+    /** The first (at most 50) reports the fix applies to. */
+    reports: R[];
 }
-declare function fixesFor(r: RenderReport): Fix[];
+/** `JSON.stringify` cut to `max` characters, for snippets and markdown; never throws. */
+declare function shortValue(v: unknown, max?: number): string;
+/** The concrete fixes one report suggests, each attributed to the component (file) that must change. */
+declare function fixesFor(r: ReportLike): Fix[];
 declare const fixKey: (f: Fix) => string;
-/** Every fix across `reports`, most re-renders removed first. */
-declare function rankFixes(reports: RenderReport[]): RankedFix[];
-/** Multi-line text for a test failure or a CI log. */
-declare function formatFixes(reports: RenderReport[], limit?: number): string;
+/** Every fix across `reports`, most avoidable re-renders removed first. */
+declare function rankFixes<R extends ReportLike>(reports: readonly R[]): RankedFix<R>[];
+/**
+ * Multi-line text for a test failure or a CI log: the ranked fixes, then (when the reports carry
+ * `commitId`) a "Root causes" section naming the components whose own changes started the cascades.
+ */
+declare function formatFixes(reports: readonly ReportLike[], limit?: number): string;
 
 /**
  * Re-render budgets for CI: a JSON baseline of allowed avoidable re-renders per component, checked
@@ -61,4 +71,4 @@ declare function toBudget(reports: RenderReport[]): Budget;
 /** Throws with the violations and the ranked fixes; use it from a test. */
 declare function assertWithinBudget(reports: RenderReport[], budget: Budget | number): BudgetResult;
 
-export { type Budget as B, type Fix as F, type RankedFix as R, type BudgetResult as a, type BudgetViolation as b, checkBudget as c, type FixKind as d, assertWithinBudget as e, formatFixes as f, avoidableCounts as g, fixKey as h, fixesFor as i, rankFixes as r, toBudget as t };
+export { type Budget as B, type Fix as F, type RankedFix as R, type BudgetResult as a, type BudgetViolation as b, checkBudget as c, type FixKind as d, assertWithinBudget as e, formatFixes as f, avoidableCounts as g, fixKey as h, fixesFor as i, rankFixes as r, shortValue as s, toBudget as t };

package/dist/{budget-COBu7jBU.d.cts → budget-ok1VDJ4t.d.ts}

@@ -1,9 +1,9 @@
-import { R as RenderReport } from './types-BzUEVkxJ.cjs';
+import { b as ReportLike, R as RenderReport } from './types-DwNN5cWe.js';
 
 /**
  * Concrete fixes derived from reports, ranked by how many avoidable re-renders each one removes.
- * The same logic drives the extension's Fixes view; here it is typed on `RenderReport` for tests,
- * CI budgets and the CLI. Pure.
+ * One implementation for the library (tests, CI budgets, the CLI, typed on `RenderReport`) and the
+ * DevTools panel (serialized reports): everything here reads only `ReportLike`. Pure.
  */
 
 type FixKind = 'memo' | 'useCallback' | 'useMemo' | 'useMemoElement' | 'children' | 'contextValue' | 'splitContext' | 'storeSnapshot' | 'bailout';
@@ -16,19 +16,29 @@ interface Fix {
     prop: string | null;
     label: string;
     detail: string;
+    /** Code sketch of the fix, `// <owner>` on the first line. */
+    snippet: string;
 }
-interface RankedFix extends Fix {
+interface RankedFix<R extends ReportLike = RenderReport> extends Fix {
     key: string;
     /** Avoidable re-renders this fix removes. */
     count: number;
     components: Record<string, number>;
+    /** The first (at most 50) reports the fix applies to. */
+    reports: R[];
 }
-declare function fixesFor(r: RenderReport): Fix[];
+/** `JSON.stringify` cut to `max` characters, for snippets and markdown; never throws. */
+declare function shortValue(v: unknown, max?: number): string;
+/** The concrete fixes one report suggests, each attributed to the component (file) that must change. */
+declare function fixesFor(r: ReportLike): Fix[];
 declare const fixKey: (f: Fix) => string;
-/** Every fix across `reports`, most re-renders removed first. */
-declare function rankFixes(reports: RenderReport[]): RankedFix[];
-/** Multi-line text for a test failure or a CI log. */
-declare function formatFixes(reports: RenderReport[], limit?: number): string;
+/** Every fix across `reports`, most avoidable re-renders removed first. */
+declare function rankFixes<R extends ReportLike>(reports: readonly R[]): RankedFix<R>[];
+/**
+ * Multi-line text for a test failure or a CI log: the ranked fixes, then (when the reports carry
+ * `commitId`) a "Root causes" section naming the components whose own changes started the cascades.
+ */
+declare function formatFixes(reports: readonly ReportLike[], limit?: number): string;
 
 /**
  * Re-render budgets for CI: a JSON baseline of allowed avoidable re-renders per component, checked
@@ -61,4 +71,4 @@ declare function toBudget(reports: RenderReport[]): Budget;
 /** Throws with the violations and the ranked fixes; use it from a test. */
 declare function assertWithinBudget(reports: RenderReport[], budget: Budget | number): BudgetResult;
 
-export { type Budget as B, type Fix as F, type RankedFix as R, type BudgetResult as a, type BudgetViolation as b, checkBudget as c, type FixKind as d, assertWithinBudget as e, formatFixes as f, avoidableCounts as g, fixKey as h, fixesFor as i, rankFixes as r, toBudget as t };
+export { type Budget as B, type Fix as F, type RankedFix as R, type BudgetResult as a, type BudgetViolation as b, checkBudget as c, type FixKind as d, assertWithinBudget as e, formatFixes as f, avoidableCounts as g, fixKey as h, fixesFor as i, rankFixes as r, shortValue as s, toBudget as t };