rerender-lens 0.5.0 → 0.7.0

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

@@ -224,7 +224,34 @@ interface Options {
     /** Stop printing a component after this many reports (0 = unlimited). The notifier still receives them. Default 0. */
     maxReportsPerComponent?: number;
 }
+/**
+ * Why one component type is or is not tracked under the current options, in words a user can act on.
+ * Produced by `explainTracking`; `tracked` always agrees with `shouldTrack`.
+ */
+interface TrackingVerdict {
+    tracked: boolean;
+    /** One sentence: the rule that decided it. */
+    reason: string;
+    /** What to change to track it, when it is not tracked and something can be changed. */
+    fix?: string;
+    /** Display name, or `Anonymous` when the type has none. */
+    name: string;
+    /** `React.memo` component or `PureComponent` class. */
+    memoized: boolean;
+}
+/** What the current options select, plus how much of the page they actually cover. In `info().tracking`. */
+interface TrackingSummary {
+    /** `all` = every component, `memoized` = `React.memo`/`PureComponent` only, `marked` = only `track()` and `include`. */
+    mode: 'all' | 'memoized' | 'marked';
+    include: string[];
+    exclude: string[];
+    /** Distinct component names that rendered since `init`, and how many of those were tracked. */
+    renderedCount: number;
+    trackedCount: number;
+    /** True when more distinct names rendered than the counter keeps (`MAX_SEEN_COMPONENTS`); the counts are a floor. */
+    overflow: boolean;
+}
 /** 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 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 };
+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 TrackingSummary as T, type TrackingVerdict as a, type ReportLike as b, type Change as c, type HookSnapshot as d, type CommitPriority as e, type CommitCause as f, type ChangeLike as g, type ComponentMatcher as h, type RenderTrigger as i };

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

@@ -224,7 +224,34 @@ interface Options {
     /** Stop printing a component after this many reports (0 = unlimited). The notifier still receives them. Default 0. */
     maxReportsPerComponent?: number;
 }
+/**
+ * Why one component type is or is not tracked under the current options, in words a user can act on.
+ * Produced by `explainTracking`; `tracked` always agrees with `shouldTrack`.
+ */
+interface TrackingVerdict {
+    tracked: boolean;
+    /** One sentence: the rule that decided it. */
+    reason: string;
+    /** What to change to track it, when it is not tracked and something can be changed. */
+    fix?: string;
+    /** Display name, or `Anonymous` when the type has none. */
+    name: string;
+    /** `React.memo` component or `PureComponent` class. */
+    memoized: boolean;
+}
+/** What the current options select, plus how much of the page they actually cover. In `info().tracking`. */
+interface TrackingSummary {
+    /** `all` = every component, `memoized` = `React.memo`/`PureComponent` only, `marked` = only `track()` and `include`. */
+    mode: 'all' | 'memoized' | 'marked';
+    include: string[];
+    exclude: string[];
+    /** Distinct component names that rendered since `init`, and how many of those were tracked. */
+    renderedCount: number;
+    trackedCount: number;
+    /** True when more distinct names rendered than the counter keeps (`MAX_SEEN_COMPONENTS`); the counts are a floor. */
+    overflow: boolean;
+}
 /** 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 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 };
+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 TrackingSummary as T, type TrackingVerdict as a, type ReportLike as b, type Change as c, type HookSnapshot as d, type CommitPriority as e, type CommitCause as f, type ChangeLike as g, type ComponentMatcher as h, type RenderTrigger as i };

package/dist/vite.d.cts

@@ -1,4 +1,4 @@
-import { O as Options } from './types-DW5-N2XH.cjs';
+import { O as Options } from './types-DwNN5cWe.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-DW5-N2XH.js';
+import { O as Options } from './types-DwNN5cWe.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'> & {

package/dist/vitest-setup.cjs

@@ -388,16 +388,27 @@ function printReport(report, options) {
 }
 
 // src/state.ts
+var MAX_SEEN_COMPONENTS = 500;
 var KEY = /* @__PURE__ */ Symbol.for("rerender-lens.state");
 function getState() {
   const g = globalThis;
   let s = g[KEY];
   if (!s) {
-    s = { options: {}, enabled: false, printed: /* @__PURE__ */ new Map(), detach: null, nextInstanceId: 1, nextCommitId: 1, warnedOnce: /* @__PURE__ */ new Set(), scheduled: 0, commits: 0, overheadMs: 0, maxCommitMs: 0, truncated: 0 };
+    s = { options: {}, enabled: false, printed: /* @__PURE__ */ new Map(), detach: null, nextInstanceId: 1, nextCommitId: 1, warnedOnce: /* @__PURE__ */ new Set(), scheduled: 0, commits: 0, overheadMs: 0, maxCommitMs: 0, truncated: 0, seen: /* @__PURE__ */ new Set(), seenTracked: /* @__PURE__ */ new Set(), seenOverflow: false };
     g[KEY] = s;
   }
   return s;
 }
+function noteRendered(s, name, tracked) {
+  if (!s.seen.has(name)) {
+    if (s.seen.size >= MAX_SEEN_COMPONENTS) {
+      s.seenOverflow = true;
+      return;
+    }
+    s.seen.add(name);
+  }
+  if (tracked) s.seenTracked.add(name);
+}
 function warnOnce(key, message) {
   const s = getState();
   if (s.warnedOnce.has(key)) return;
@@ -475,6 +486,9 @@ function init(options = {}) {
   const s = getState();
   s.options = { ...options };
   s.printed.clear();
+  s.seen.clear();
+  s.seenTracked.clear();
+  s.seenOverflow = false;
   if (!s.enabled) {
     s.detach = attach();
     s.enabled = true;
@@ -1143,8 +1157,11 @@ function onCommit(root, commitPriority) {
     const alt = fiber.alternate;
     if (alt && isComponentTag(fiber.tag) && didRender(fiber)) {
       if (isHotSwapped(fiber, alt)) hot = true;
-      renderedNames.add(fiberName(fiber));
-      if (shouldTrack(fiberType(fiber), o)) rendered.push(fiber);
+      const name = fiberName(fiber);
+      renderedNames.add(name);
+      const tracked = shouldTrack(fiberType(fiber), o);
+      noteRendered(s, name, tracked);
+      if (tracked) rendered.push(fiber);
     }
     if (fiber.tag === SuspenseComponent && alt && alt.memoizedState !== null && fiber.memoizedState === null) (resolvedBoundaries ?? (resolvedBoundaries = [])).push(fiber);
     if (!alt || fiber.child !== alt.child) {