react-render-detective 0.3.0 → 0.4.0

package/README.md

@@ -11,7 +11,7 @@
 [Guide](docs/GUIDE.md) · [API](docs/API.md) · [Feasibility report](docs/FEASIBILITY.md) ·
 [Benchmarks](docs/BENCHMARKS.md)
 
-> **Status: 0.3.0, early release.** 76 tests pass on React 18 and 19; benchmarks and bundle budgets
+> **Status: 0.4.0, early release.** 76 tests pass on React 18 and 19; benchmarks and bundle budgets
 > are green; the packed package is verified in a clean install for ESM, CJS and TypeScript
 > consumers; and the demo dashboard has been driven end to end in Chrome, which found four real
 > defects the jsdom suite had missed (see the [changelog](CHANGELOG.md)). Not yet exercised:

package/dist/chunk-H5RG2EPP.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+// src/testing/index.ts
+function profileFromEvents(scenario, events, remounts = {}) {
+  const components = {};
+  for (const event of events) {
+    const name = event.component.name;
+    const entry = components[name] ?? (components[name] = { renders: 0, remounts: remounts[name] ?? 0, avoidableRenders: 0 });
+    entry.renders++;
+    if (event.diagnosis.potentiallyAvoidable) entry.avoidableRenders++;
+  }
+  return { scenario, components };
+}
+var METRICS = ["renders", "remounts", "avoidableRenders"];
+function compareProfiles(baseline, current, options = {}) {
+  const { tolerance = 0, ignoreBelow = 0, ignore = [], failOnImprovement = false } = options;
+  const regressions = [];
+  const improvements = [];
+  const added = [];
+  for (const [component, currentProfile] of Object.entries(current.components)) {
+    if (ignore.includes(component)) continue;
+    const baseProfile = baseline.components[component];
+    if (!baseProfile) {
+      added.push(component);
+      continue;
+    }
+    for (const metric of METRICS) {
+      const before = baseProfile[metric];
+      const after = currentProfile[metric];
+      if (before < ignoreBelow && after < ignoreBelow) continue;
+      const allowed = before + Math.max(before * tolerance, 0);
+      if (after > allowed) {
+        regressions.push({ component, metric, baseline: before, current: after, delta: after - before });
+      } else if (after < before) {
+        improvements.push({ component, metric, baseline: before, current: after, delta: after - before });
+      }
+    }
+  }
+  const ok = regressions.length === 0 && (!failOnImprovement || improvements.length === 0);
+  return { ok, scenario: current.scenario, regressions, improvements, added, message: describe(current.scenario, regressions, improvements, added) };
+}
+function describe(scenario, regressions, improvements, added) {
+  if (regressions.length === 0) {
+    const parts = [`No render regressions in "${scenario}".`];
+    if (improvements.length > 0) {
+      parts.push(
+        `Improved: ${improvements.map((i) => `${i.component} ${i.metric} ${i.baseline}\u2192${i.current}`).join(", ")}.`,
+        "If these are intended, update the baseline so they cannot silently regress again."
+      );
+    }
+    if (added.length > 0) parts.push(`New components not in the baseline: ${added.join(", ")}.`);
+    return parts.join("\n");
+  }
+  const lines = [`Render regressions in "${scenario}":`, ""];
+  for (const r of regressions) {
+    lines.push(`  ${r.component}  ${r.metric}: ${r.baseline} \u2192 ${r.current}  (+${r.delta})`);
+  }
+  lines.push(
+    "",
+    "Each of these is a component doing more work than the baseline allows.",
+    "Run the scenario with the overlay or `explain()` to see which prop or parent is responsible,",
+    "or update the baseline if the change is intended."
+  );
+  return lines.join("\n");
+}
+function assertNoRenderRegressions(baseline, current, options) {
+  const result = compareProfiles(baseline, current, options);
+  if (!result.ok) throw new Error(result.message);
+}
+
+exports.assertNoRenderRegressions = assertNoRenderRegressions;
+exports.compareProfiles = compareProfiles;
+exports.profileFromEvents = profileFromEvents;
+//# sourceMappingURL=chunk-H5RG2EPP.cjs.map
+//# sourceMappingURL=chunk-H5RG2EPP.cjs.map

package/dist/chunk-H5RG2EPP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/index.ts"],"names":[],"mappings":"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","file":"chunk-H5RG2EPP.cjs","sourcesContent":["/**\n * Render-regression testing.\n *\n * Fixing a render problem once is easy; keeping it fixed is the hard part. This\n * turns render behaviour into something a pull request can fail on: record a\n * profile for a scripted interaction, commit it, and compare on every run.\n *\n * Deliberately assertion-library agnostic — it returns data and a message, and\n * your test framework decides what to do with it.\n */\nimport type { RenderEvent } from \"../core/types.js\";\n\nexport interface ComponentProfile {\n  renders: number;\n  remounts: number;\n  avoidableRenders: number;\n}\n\nexport interface RenderProfile {\n  /** Free-form label, e.g. \"search: type one character\". */\n  scenario: string;\n  components: Record<string, ComponentProfile>;\n}\n\nexport interface RegressionOptions {\n  /**\n   * Allowed growth before a component counts as regressed, as a fraction.\n   * `0.2` tolerates a 20% increase. Defaults to 0 — exact.\n   */\n  tolerance?: number;\n  /** Ignore components below this render count in the baseline. */\n  ignoreBelow?: number;\n  /** Component names to skip entirely. */\n  ignore?: string[];\n  /** Fail when a component is rendering *fewer* times too. Off by default. */\n  failOnImprovement?: boolean;\n}\n\nexport interface Regression {\n  component: string;\n  metric: \"renders\" | \"remounts\" | \"avoidableRenders\";\n  baseline: number;\n  current: number;\n  delta: number;\n}\n\nexport interface RegressionResult {\n  ok: boolean;\n  scenario: string;\n  regressions: Regression[];\n  improvements: Regression[];\n  /** Components present now but absent from the baseline. */\n  added: string[];\n  message: string;\n}\n\n/** Builds a profile from recorded events. Pass `getEvents()`. */\nexport function profileFromEvents(scenario: string, events: RenderEvent[], remounts: Record<string, number> = {}): RenderProfile {\n  const components: Record<string, ComponentProfile> = {};\n  for (const event of events) {\n    const name = event.component.name;\n    const entry = (components[name] ??= { renders: 0, remounts: remounts[name] ?? 0, avoidableRenders: 0 });\n    entry.renders++;\n    if (event.diagnosis.potentiallyAvoidable) entry.avoidableRenders++;\n  }\n  return { scenario, components };\n}\n\nconst METRICS: Array<Regression[\"metric\"]> = [\"renders\", \"remounts\", \"avoidableRenders\"];\n\nexport function compareProfiles(\n  baseline: RenderProfile,\n  current: RenderProfile,\n  options: RegressionOptions = {},\n): RegressionResult {\n  const { tolerance = 0, ignoreBelow = 0, ignore = [], failOnImprovement = false } = options;\n  const regressions: Regression[] = [];\n  const improvements: Regression[] = [];\n  const added: string[] = [];\n\n  for (const [component, currentProfile] of Object.entries(current.components)) {\n    if (ignore.includes(component)) continue;\n    const baseProfile = baseline.components[component];\n    if (!baseProfile) {\n      added.push(component);\n      continue;\n    }\n\n    for (const metric of METRICS) {\n      const before = baseProfile[metric];\n      const after = currentProfile[metric];\n      if (before < ignoreBelow && after < ignoreBelow) continue;\n      const allowed = before + Math.max(before * tolerance, 0);\n      if (after > allowed) {\n        regressions.push({ component, metric, baseline: before, current: after, delta: after - before });\n      } else if (after < before) {\n        improvements.push({ component, metric, baseline: before, current: after, delta: after - before });\n      }\n    }\n  }\n\n  const ok = regressions.length === 0 && (!failOnImprovement || improvements.length === 0);\n  return { ok, scenario: current.scenario, regressions, improvements, added, message: describe(current.scenario, regressions, improvements, added) };\n}\n\nfunction describe(scenario: string, regressions: Regression[], improvements: Regression[], added: string[]): string {\n  if (regressions.length === 0) {\n    const parts = [`No render regressions in \"${scenario}\".`];\n    if (improvements.length > 0) {\n      parts.push(\n        `Improved: ${improvements.map((i) => `${i.component} ${i.metric} ${i.baseline}→${i.current}`).join(\", \")}.`,\n        \"If these are intended, update the baseline so they cannot silently regress again.\",\n      );\n    }\n    if (added.length > 0) parts.push(`New components not in the baseline: ${added.join(\", \")}.`);\n    return parts.join(\"\\n\");\n  }\n\n  const lines = [`Render regressions in \"${scenario}\":`, \"\"];\n  for (const r of regressions) {\n    lines.push(`  ${r.component}  ${r.metric}: ${r.baseline} → ${r.current}  (+${r.delta})`);\n  }\n  lines.push(\n    \"\",\n    \"Each of these is a component doing more work than the baseline allows.\",\n    \"Run the scenario with the overlay or `explain()` to see which prop or parent is responsible,\",\n    \"or update the baseline if the change is intended.\",\n  );\n  return lines.join(\"\\n\");\n}\n\n/**\n * Throws when the current profile is worse than the baseline. The one-liner for\n * a test file; use `compareProfiles` when you want the data.\n */\nexport function assertNoRenderRegressions(\n  baseline: RenderProfile,\n  current: RenderProfile,\n  options?: RegressionOptions,\n): void {\n  const result = compareProfiles(baseline, current, options);\n  if (!result.ok) throw new Error(result.message);\n}\n"]}

package/dist/chunk-LILK23YH.js

@@ -0,0 +1,71 @@
+// src/testing/index.ts
+function profileFromEvents(scenario, events, remounts = {}) {
+  const components = {};
+  for (const event of events) {
+    const name = event.component.name;
+    const entry = components[name] ?? (components[name] = { renders: 0, remounts: remounts[name] ?? 0, avoidableRenders: 0 });
+    entry.renders++;
+    if (event.diagnosis.potentiallyAvoidable) entry.avoidableRenders++;
+  }
+  return { scenario, components };
+}
+var METRICS = ["renders", "remounts", "avoidableRenders"];
+function compareProfiles(baseline, current, options = {}) {
+  const { tolerance = 0, ignoreBelow = 0, ignore = [], failOnImprovement = false } = options;
+  const regressions = [];
+  const improvements = [];
+  const added = [];
+  for (const [component, currentProfile] of Object.entries(current.components)) {
+    if (ignore.includes(component)) continue;
+    const baseProfile = baseline.components[component];
+    if (!baseProfile) {
+      added.push(component);
+      continue;
+    }
+    for (const metric of METRICS) {
+      const before = baseProfile[metric];
+      const after = currentProfile[metric];
+      if (before < ignoreBelow && after < ignoreBelow) continue;
+      const allowed = before + Math.max(before * tolerance, 0);
+      if (after > allowed) {
+        regressions.push({ component, metric, baseline: before, current: after, delta: after - before });
+      } else if (after < before) {
+        improvements.push({ component, metric, baseline: before, current: after, delta: after - before });
+      }
+    }
+  }
+  const ok = regressions.length === 0 && (!failOnImprovement || improvements.length === 0);
+  return { ok, scenario: current.scenario, regressions, improvements, added, message: describe(current.scenario, regressions, improvements, added) };
+}
+function describe(scenario, regressions, improvements, added) {
+  if (regressions.length === 0) {
+    const parts = [`No render regressions in "${scenario}".`];
+    if (improvements.length > 0) {
+      parts.push(
+        `Improved: ${improvements.map((i) => `${i.component} ${i.metric} ${i.baseline}\u2192${i.current}`).join(", ")}.`,
+        "If these are intended, update the baseline so they cannot silently regress again."
+      );
+    }
+    if (added.length > 0) parts.push(`New components not in the baseline: ${added.join(", ")}.`);
+    return parts.join("\n");
+  }
+  const lines = [`Render regressions in "${scenario}":`, ""];
+  for (const r of regressions) {
+    lines.push(`  ${r.component}  ${r.metric}: ${r.baseline} \u2192 ${r.current}  (+${r.delta})`);
+  }
+  lines.push(
+    "",
+    "Each of these is a component doing more work than the baseline allows.",
+    "Run the scenario with the overlay or `explain()` to see which prop or parent is responsible,",
+    "or update the baseline if the change is intended."
+  );
+  return lines.join("\n");
+}
+function assertNoRenderRegressions(baseline, current, options) {
+  const result = compareProfiles(baseline, current, options);
+  if (!result.ok) throw new Error(result.message);
+}
+
+export { assertNoRenderRegressions, compareProfiles, profileFromEvents };
+//# sourceMappingURL=chunk-LILK23YH.js.map
+//# sourceMappingURL=chunk-LILK23YH.js.map

package/dist/chunk-LILK23YH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/index.ts"],"names":[],"mappings":"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","file":"chunk-LILK23YH.js","sourcesContent":["/**\n * Render-regression testing.\n *\n * Fixing a render problem once is easy; keeping it fixed is the hard part. This\n * turns render behaviour into something a pull request can fail on: record a\n * profile for a scripted interaction, commit it, and compare on every run.\n *\n * Deliberately assertion-library agnostic — it returns data and a message, and\n * your test framework decides what to do with it.\n */\nimport type { RenderEvent } from \"../core/types.js\";\n\nexport interface ComponentProfile {\n  renders: number;\n  remounts: number;\n  avoidableRenders: number;\n}\n\nexport interface RenderProfile {\n  /** Free-form label, e.g. \"search: type one character\". */\n  scenario: string;\n  components: Record<string, ComponentProfile>;\n}\n\nexport interface RegressionOptions {\n  /**\n   * Allowed growth before a component counts as regressed, as a fraction.\n   * `0.2` tolerates a 20% increase. Defaults to 0 — exact.\n   */\n  tolerance?: number;\n  /** Ignore components below this render count in the baseline. */\n  ignoreBelow?: number;\n  /** Component names to skip entirely. */\n  ignore?: string[];\n  /** Fail when a component is rendering *fewer* times too. Off by default. */\n  failOnImprovement?: boolean;\n}\n\nexport interface Regression {\n  component: string;\n  metric: \"renders\" | \"remounts\" | \"avoidableRenders\";\n  baseline: number;\n  current: number;\n  delta: number;\n}\n\nexport interface RegressionResult {\n  ok: boolean;\n  scenario: string;\n  regressions: Regression[];\n  improvements: Regression[];\n  /** Components present now but absent from the baseline. */\n  added: string[];\n  message: string;\n}\n\n/** Builds a profile from recorded events. Pass `getEvents()`. */\nexport function profileFromEvents(scenario: string, events: RenderEvent[], remounts: Record<string, number> = {}): RenderProfile {\n  const components: Record<string, ComponentProfile> = {};\n  for (const event of events) {\n    const name = event.component.name;\n    const entry = (components[name] ??= { renders: 0, remounts: remounts[name] ?? 0, avoidableRenders: 0 });\n    entry.renders++;\n    if (event.diagnosis.potentiallyAvoidable) entry.avoidableRenders++;\n  }\n  return { scenario, components };\n}\n\nconst METRICS: Array<Regression[\"metric\"]> = [\"renders\", \"remounts\", \"avoidableRenders\"];\n\nexport function compareProfiles(\n  baseline: RenderProfile,\n  current: RenderProfile,\n  options: RegressionOptions = {},\n): RegressionResult {\n  const { tolerance = 0, ignoreBelow = 0, ignore = [], failOnImprovement = false } = options;\n  const regressions: Regression[] = [];\n  const improvements: Regression[] = [];\n  const added: string[] = [];\n\n  for (const [component, currentProfile] of Object.entries(current.components)) {\n    if (ignore.includes(component)) continue;\n    const baseProfile = baseline.components[component];\n    if (!baseProfile) {\n      added.push(component);\n      continue;\n    }\n\n    for (const metric of METRICS) {\n      const before = baseProfile[metric];\n      const after = currentProfile[metric];\n      if (before < ignoreBelow && after < ignoreBelow) continue;\n      const allowed = before + Math.max(before * tolerance, 0);\n      if (after > allowed) {\n        regressions.push({ component, metric, baseline: before, current: after, delta: after - before });\n      } else if (after < before) {\n        improvements.push({ component, metric, baseline: before, current: after, delta: after - before });\n      }\n    }\n  }\n\n  const ok = regressions.length === 0 && (!failOnImprovement || improvements.length === 0);\n  return { ok, scenario: current.scenario, regressions, improvements, added, message: describe(current.scenario, regressions, improvements, added) };\n}\n\nfunction describe(scenario: string, regressions: Regression[], improvements: Regression[], added: string[]): string {\n  if (regressions.length === 0) {\n    const parts = [`No render regressions in \"${scenario}\".`];\n    if (improvements.length > 0) {\n      parts.push(\n        `Improved: ${improvements.map((i) => `${i.component} ${i.metric} ${i.baseline}→${i.current}`).join(\", \")}.`,\n        \"If these are intended, update the baseline so they cannot silently regress again.\",\n      );\n    }\n    if (added.length > 0) parts.push(`New components not in the baseline: ${added.join(\", \")}.`);\n    return parts.join(\"\\n\");\n  }\n\n  const lines = [`Render regressions in \"${scenario}\":`, \"\"];\n  for (const r of regressions) {\n    lines.push(`  ${r.component}  ${r.metric}: ${r.baseline} → ${r.current}  (+${r.delta})`);\n  }\n  lines.push(\n    \"\",\n    \"Each of these is a component doing more work than the baseline allows.\",\n    \"Run the scenario with the overlay or `explain()` to see which prop or parent is responsible,\",\n    \"or update the baseline if the change is intended.\",\n  );\n  return lines.join(\"\\n\");\n}\n\n/**\n * Throws when the current profile is worse than the baseline. The one-liner for\n * a test file; use `compareProfiles` when you want the data.\n */\nexport function assertNoRenderRegressions(\n  baseline: RenderProfile,\n  current: RenderProfile,\n  options?: RegressionOptions,\n): void {\n  const result = compareProfiles(baseline, current, options);\n  if (!result.ok) throw new Error(result.message);\n}\n"]}

package/dist/index.cjs

@@ -2,6 +2,7 @@
 
 var chunkJD4IJ4MN_cjs = require('./chunk-JD4IJ4MN.cjs');
 var chunkDZ3BZ654_cjs = require('./chunk-DZ3BZ654.cjs');
+var chunkH5RG2EPP_cjs = require('./chunk-H5RG2EPP.cjs');
 var React = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -138,6 +139,245 @@ function label(event) {
       return "undetermined";
   }
 }
+
+// src/core/interactions.ts
+var COMMIT_SLACK_MS = 100;
+var FALLBACK_CLOSE_MS = 50;
+var InteractionTracker = class {
+  constructor(capacity = 50) {
+    this.capacity = capacity;
+    this.records = [];
+    this.nextId = 0;
+  }
+  /** Returns false when the browser cannot report event timing. */
+  start() {
+    if (this.observer) return true;
+    const PO = globalThis.PerformanceObserver;
+    const supported = PO?.supportedEntryTypes?.includes("event");
+    if (!PO || !supported) return false;
+    try {
+      const observer = new PO((list) => {
+        for (const entry of list.getEntries()) {
+          const timing = entry;
+          this.record({
+            name: timing.name,
+            startTime: timing.startTime,
+            duration: timing.duration,
+            target: describeTarget(timing.target)
+          });
+        }
+      });
+      observer.observe({ type: "event", buffered: true, durationThreshold: 16 });
+      this.observer = observer;
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  stop() {
+    this.observer?.disconnect();
+    this.observer = void 0;
+  }
+  /** Is the automatic path available in this browser? */
+  get automatic() {
+    return this.observer !== void 0;
+  }
+  /**
+   * Time an interaction by hand.
+   *
+   * The automatic path depends on the Event Timing API, which Safari only
+   * gained in 16.4 and which does not fire for synthetic input at all — so
+   * anything driven by a test harness records nothing. This measures a specific
+   * action instead, up to the paint that follows it, and needs no browser
+   * support beyond `performance.now`.
+   */
+  measure(label2, action) {
+    const startTime = now();
+    let handlerMs = 0;
+    let finished = false;
+    const finish = () => {
+      if (finished) return;
+      finished = true;
+      this.record({ name: label2, startTime, duration: now() - startTime, handlerMs });
+    };
+    let result;
+    try {
+      result = action();
+      handlerMs = now() - startTime;
+    } catch (error) {
+      handlerMs = now() - startTime;
+      finish();
+      throw error;
+    }
+    const raf = globalThis.requestAnimationFrame;
+    if (raf) raf(() => raf(finish));
+    setTimeout(finish, FALLBACK_CLOSE_MS);
+    return result;
+  }
+  /** Exposed for tests and for `measure`. */
+  record(timing) {
+    const record = {
+      id: `interaction_${++this.nextId}`,
+      type: timing.name,
+      target: timing.target,
+      startTime: timing.startTime,
+      durationMs: timing.duration,
+      handlerMs: timing.handlerMs,
+      renders: [],
+      renderTimeMs: 0,
+      avoidableRenderTimeMs: 0
+    };
+    this.records.push(record);
+    if (this.records.length > this.capacity) this.records.shift();
+    return record;
+  }
+  clear() {
+    this.records.length = 0;
+  }
+  /**
+   * Joins render events to interactions by commit time. A render belongs to an
+   * interaction when it committed between the event starting and shortly after
+   * it finished — React commits just after the event handler returns.
+   */
+  attribute(events) {
+    for (const record of this.records) {
+      const from = record.startTime;
+      const to = record.startTime + record.durationMs + COMMIT_SLACK_MS;
+      record.renders = events.filter((e) => e.timings.commitTime >= from && e.timings.commitTime <= to);
+      record.renderTimeMs = record.renders.reduce((a, e) => a + e.timings.selfDuration, 0);
+      record.avoidableRenderTimeMs = record.renders.filter((e) => e.diagnosis.potentiallyAvoidable).reduce((a, e) => a + e.timings.selfDuration, 0);
+    }
+    return [...this.records].sort((a, b) => b.durationMs - a.durationMs);
+  }
+};
+function summarise(record) {
+  const byComponent = /* @__PURE__ */ new Map();
+  for (const event of record.renders) {
+    const entry = byComponent.get(event.component.name) ?? {
+      renders: 0,
+      totalMs: 0,
+      source: event.component.source,
+      cause: event.diagnosis.reason
+    };
+    entry.renders++;
+    entry.totalMs += event.timings.selfDuration;
+    byComponent.set(event.component.name, entry);
+  }
+  const contributors = [...byComponent.entries()].map(([component, v]) => ({ component, source: v.source, renders: v.renders, totalMs: v.totalMs, cause: v.cause })).sort((a, b) => b.totalMs - a.totalMs);
+  const top = contributors[0];
+  const accounted = (record.handlerMs ?? record.durationMs) + record.renderTimeMs;
+  const idleWindow = record.handlerMs !== void 0 && record.durationMs > accounted * 3 && record.durationMs - accounted > 100;
+  const effectiveMs = idleWindow ? accounted : record.durationMs;
+  const share = effectiveMs > 0 ? record.renderTimeMs / effectiveMs : 0;
+  let headline;
+  let nextStep;
+  let confidence = "medium";
+  if (idleWindow) {
+    headline = `${record.type}: ${fmt(record.handlerMs ?? 0)} in the handler and ${fmt(record.renderTimeMs)} rendering. The measured window was ${fmt(record.durationMs)}, but most of that was the page waiting for a frame \u2014 ignore it.`;
+    nextStep = record.renderTimeMs > (record.handlerMs ?? 0) ? `Rendering dominates the real work${top ? `; start with ${top.component}` : ""}.` : "The handler itself costs more than rendering. Profile the handler, not React.";
+    return { interaction: record, contributors, headline, nextStep, confidence: "medium" };
+  }
+  if (record.renders.length === 0) {
+    headline = `${record.type} took ${fmt(record.durationMs)}, and no instrumented component rendered inside it.`;
+    nextStep = "The cost is somewhere other than React rendering \u2014 an event handler, a layout, or an uninstrumented component. Instrument more of the tree to narrow it down.";
+    confidence = "low";
+  } else if (share >= 0.4 && record.avoidableRenderTimeMs > 0) {
+    headline = `${record.type} took ${fmt(record.durationMs)}; ${fmt(record.renderTimeMs)} of it was rendering, and ${fmt(record.avoidableRenderTimeMs)} of that had no input change to explain it.`;
+    nextStep = top ? `Start with ${top.component}${top.source ? ` (${top.source})` : ""} \u2014 ${fmt(top.totalMs)} across ${top.renders} render${top.renders === 1 ? "" : "s"}.` : "Look at the top contributor below.";
+    confidence = "high";
+  } else if (share >= 0.4) {
+    headline = `${record.type} took ${fmt(record.durationMs)}; ${fmt(record.renderTimeMs)} of it was rendering, all of it explained by real input changes.`;
+    nextStep = "This is genuine work. Make the renders cheaper rather than fewer \u2014 or do less of it per interaction.";
+    confidence = "high";
+  } else {
+    headline = `${record.type} took ${fmt(record.durationMs)}, but only ${fmt(record.renderTimeMs)} was React rendering.`;
+    nextStep = "Most of the cost is outside rendering \u2014 event handlers, layout or paint. A browser profile will show more than this tool can.";
+    confidence = "medium";
+  }
+  return { interaction: record, contributors, headline, nextStep, confidence };
+}
+function formatInteraction(summary) {
+  const { interaction: i } = summary;
+  const lines = [
+    `${i.type}${i.target ? ` on ${i.target}` : ""}   ${fmt(i.durationMs)}`,
+    "",
+    summary.headline
+  ];
+  if (summary.contributors.length > 0) {
+    lines.push("", "Rendering inside this interaction");
+    for (const c of summary.contributors.slice(0, 8)) {
+      lines.push(
+        `  ${c.component.padEnd(22)} ${String(c.renders).padStart(4)} render(s)  ${fmt(c.totalMs).padStart(8)}  ${c.cause}`
+      );
+    }
+  }
+  lines.push("", `Next step`, `  ${summary.nextStep}`, "", `Confidence: ${summary.confidence}`);
+  return lines.join("\n");
+}
+function describeTarget(target) {
+  if (!target || typeof target !== "object") return void 0;
+  const el = target;
+  if (!el.tagName) return void 0;
+  const tag = el.tagName.toLowerCase();
+  if (el.id) return `${tag}#${el.id}`;
+  const className = typeof el.className === "string" ? el.className.trim().split(/\s+/)[0] : void 0;
+  if (className) return `${tag}.${className}`;
+  const text = el.textContent?.trim().slice(0, 20);
+  return text ? `${tag} "${text}"` : tag;
+}
+var fmt = (ms) => `${ms.toFixed(1)}ms`;
+var now = () => typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+
+// src/core/opportunities.ts
+var DEFAULT_MIN_SAVING_MS = 1;
+function rankOpportunities({ events, lifecycles, minSavingMs = DEFAULT_MIN_SAVING_MS }) {
+  const names = new Set(events.map((e) => e.component.name));
+  const out = [];
+  for (const name of names) {
+    const lifecycle = lifecycles.get(name);
+    const explanation = chunkJD4IJ4MN_cjs.explainEvents(name, events, lifecycle);
+    if (!explanation) continue;
+    const mounts = events.filter((e) => e.component.name === name && e.phase === "mount");
+    const averageMountCost = mounts.length ? mounts.reduce((a, e) => a + e.timings.selfDuration, 0) / mounts.length : 0;
+    const remountSaving = explanation.remounts * averageMountCost;
+    const estimatedSavingMs = explanation.estimatedAvoidableTime + remountSaving;
+    if (estimatedSavingMs < minSavingMs) continue;
+    out.push({
+      component: name,
+      source: explanation.source,
+      estimatedSavingMs,
+      avoidableRenders: explanation.potentiallyAvoidableRenders,
+      remounts: explanation.remounts,
+      averageSelfDuration: explanation.averageSelfDuration,
+      summary: explanation.headline,
+      nextStep: explanation.nextStep,
+      confidence: explanation.confidence
+    });
+  }
+  return out.sort((a, b) => b.estimatedSavingMs - a.estimatedSavingMs);
+}
+function formatOpportunities(opportunities) {
+  if (opportunities.length === 0) {
+    return "React Render Detective\n\nNo measurable render waste found yet. Interact with the app and try again.";
+  }
+  const lines = [
+    "React Render Detective \u2014 where to spend your next hour",
+    "",
+    "Ranked by estimated recoverable time. These are estimates, not promises:",
+    "measure each fix.",
+    ""
+  ];
+  for (const [index, o] of opportunities.entries()) {
+    lines.push(
+      `${String(index + 1).padStart(2)}. ${o.component}${o.source ? `   ${o.source}` : ""}`,
+      `    ~${o.estimatedSavingMs.toFixed(0)}ms recoverable   ${o.avoidableRenders} avoidable render${o.avoidableRenders === 1 ? "" : "s"}${o.remounts > 0 ? `, ${o.remounts}\xD7 rebuilt` : ""}   (confidence: ${o.confidence})`,
+      `    ${o.summary}`,
+      `    \u2192 ${o.nextStep}`,
+      ""
+    );
+  }
+  return lines.join("\n");
+}
 var AncestryContext = React.createContext(void 0);
 AncestryContext.displayName = "RenderDetectiveAncestry";
 function useInstrumentedNode(name, props, source) {
@@ -305,12 +545,21 @@ function isRecord(v) {
 
 // src/index.ts
 var REPORTER = /* @__PURE__ */ Symbol.for("react-render-detective.reporter");
+var INTERACTIONS = /* @__PURE__ */ Symbol.for("react-render-detective.interactions");
+function tracker() {
+  const g = globalThis;
+  if (!g[INTERACTIONS]) g[INTERACTIONS] = new InteractionTracker();
+  return g[INTERACTIONS];
+}
 function init(options = {}) {
   const detective = chunkDZ3BZ654_cjs.getDetective();
   detective.init(options);
   const g = globalThis;
   g[REPORTER]?.();
   g[REPORTER] = void 0;
+  if (detective.enabled) {
+    tracker().start();
+  }
   if (detective.enabled && detective.config.mode !== "silent") {
     g[REPORTER] = attachConsoleReporter(detective);
   } else if (!detective.enabled) {
@@ -342,11 +591,14 @@ function subscribe(listener) {
 }
 function clear() {
   chunkDZ3BZ654_cjs.getDetective().clear();
+  tracker().clear();
 }
 function reset() {
   const g = globalThis;
   g[REPORTER]?.();
   g[REPORTER] = void 0;
+  g[INTERACTIONS]?.stop();
+  g[INTERACTIONS] = void 0;
   chunkDZ3BZ654_cjs.getDetective().reset();
 }
 function explain(componentName2) {
@@ -356,6 +608,47 @@ function explain(componentName2) {
 function explainStructured(componentName2) {
   return chunkJD4IJ4MN_cjs.explainEvents(componentName2, getEvents(), chunkDZ3BZ654_cjs.getDetective().lifecycleOf(componentName2));
 }
+function getRenderProfile(scenario) {
+  const remounts = {};
+  for (const stats of chunkDZ3BZ654_cjs.getDetective().getComponentStats()) remounts[stats.name] = stats.remountCount;
+  return chunkH5RG2EPP_cjs.profileFromEvents(scenario, getEvents(), remounts);
+}
+function getInteractions() {
+  return tracker().attribute(getEvents());
+}
+function explainInteractionStructured(id) {
+  const records = getInteractions();
+  const record = id ? records.find((r) => r.id === id) : records[0];
+  return record ? summarise(record) : void 0;
+}
+function explainInteraction(id) {
+  const summary = explainInteractionStructured(id);
+  return summary ? formatInteraction(summary) : void 0;
+}
+function printInteractions(limit = 5) {
+  const records = getInteractions().slice(0, limit);
+  if (records.length === 0) {
+    console.log(
+      tracker().automatic ? "No interactions recorded yet. Event timing is working \u2014 nothing has taken longer than 16ms.\nSynthetic clicks from a test harness never produce these entries; use measureInteraction() there." : "This browser does not report event timing (Safari before 16.4, jsdom).\nUse measureInteraction(label, fn) to time interactions by hand."
+    );
+    return;
+  }
+  console.log(records.map((r) => formatInteraction(summarise(r))).join("\n\n"));
+}
+function measureInteraction(label2, action) {
+  return tracker().measure(label2, action);
+}
+function getOpportunities(limit = 10) {
+  const detective = chunkDZ3BZ654_cjs.getDetective();
+  const lifecycles = /* @__PURE__ */ new Map();
+  for (const stats of detective.getComponentStats()) {
+    lifecycles.set(stats.name, { remounts: stats.remountCount });
+  }
+  return rankOpportunities({ events: detective.getEvents(), lifecycles }).slice(0, limit);
+}
+function printOpportunities(limit = 10) {
+  console.log(formatOpportunities(getOpportunities(limit)));
+}
 function printStats() {
   const s = getStats();
   const lines = [
@@ -401,6 +694,14 @@ var ReactRenderDetective = {
   reset,
   explain,
   explainStructured,
+  getOpportunities,
+  printOpportunities,
+  getInteractions,
+  explainInteraction,
+  explainInteractionStructured,
+  printInteractions,
+  measureInteraction,
+  getRenderProfile,
   printStats
 };
 
@@ -412,21 +713,34 @@ Object.defineProperty(exports, "formatExplanation", {
   enumerable: true,
   get: function () { return chunkJD4IJ4MN_cjs.formatExplanation; }
 });
+exports.InteractionTracker = InteractionTracker;
 exports.ReactRenderDetective = ReactRenderDetective;
 exports.RenderDetective = RenderDetective;
 exports.clear = clear;
 exports.configure = configure;
 exports.explain = explain;
+exports.explainInteraction = explainInteraction;
+exports.explainInteractionStructured = explainInteractionStructured;
 exports.explainStructured = explainStructured;
+exports.formatInteraction = formatInteraction;
+exports.formatOpportunities = formatOpportunities;
 exports.getComponentStats = getComponentStats;
 exports.getConfig = getConfig;
 exports.getEvents = getEvents;
+exports.getInteractions = getInteractions;
+exports.getOpportunities = getOpportunities;
+exports.getRenderProfile = getRenderProfile;
 exports.getStats = getStats;
 exports.init = init;
 exports.isEnabled = isEnabled;
+exports.measureInteraction = measureInteraction;
+exports.printInteractions = printInteractions;
+exports.printOpportunities = printOpportunities;
 exports.printStats = printStats;
+exports.rankOpportunities = rankOpportunities;
 exports.reset = reset;
 exports.subscribe = subscribe;
+exports.summariseInteraction = summarise;
 exports.useRenderDiagnostics = useRenderDiagnostics;
 exports.useTrackedContextValue = useTrackedContextValue;
 exports.useTrackedEffect = useTrackedEffect;