react-render-detective 0.5.0 → 0.6.0

package/dist/interactions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/interactions.ts","../src/interactions/index.ts"],"names":["getDetective"],"mappings":"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","file":"interactions.cjs","sourcesContent":["import type { Confidence, RenderEvent } from \"./types.js\";\n\n/**\n * Interaction-scoped attribution.\n *\n * Performance is felt per interaction, not in aggregate — and INP is the metric\n * teams are actually judged on. This joins the two halves: the browser says a\n * keystroke took 240ms, and the render events say which components spent it and\n * why.\n *\n * Uses `PerformanceObserver` with `event` timing, a public browser API. Where it\n * is unsupported (older Safari, jsdom) interaction tracking simply stays empty\n * rather than guessing.\n */\nexport interface InteractionRecord {\n  id: string;\n  /** `click`, `keydown`, `pointerup`… */\n  type: string;\n  /** Best-effort description of what was interacted with. */\n  target?: string;\n  startTime: number;\n  /** Browser-reported event duration — the number INP is computed from. */\n  durationMs: number;\n  /**\n   * For a manually measured interaction: how long the synchronous action took.\n   * Immune to throttling, unlike the full window, which waits on a frame.\n   */\n  handlerMs?: number;\n  /** Renders committed inside this interaction's window. */\n  renders: RenderEvent[];\n  /** Sum of self durations for those renders. */\n  renderTimeMs: number;\n  /** Render time that no observable input change explains. */\n  avoidableRenderTimeMs: number;\n}\n\nexport interface InteractionSummary {\n  interaction: InteractionRecord;\n  /** Components ordered by cost within this interaction. */\n  contributors: Array<{ component: string; source?: string; renders: number; totalMs: number; cause: string }>;\n  headline: string;\n  nextStep: string;\n  confidence: Confidence;\n}\n\n/** Entries React commits slightly after the event finishes; allow for that. */\nconst COMMIT_SLACK_MS = 100;\n\n/** Used when requestAnimationFrame cannot fire — a hidden tab, or jsdom. */\nconst FALLBACK_CLOSE_MS = 50;\n\ninterface RawEventTiming {\n  name: string;\n  startTime: number;\n  duration: number;\n  target?: string;\n  handlerMs?: number;\n}\n\nexport class InteractionTracker {\n  private records: InteractionRecord[] = [];\n  private observer: { disconnect: () => void } | undefined;\n  private nextId = 0;\n\n  constructor(private capacity = 50) {}\n\n  /** Returns false when the browser cannot report event timing. */\n  start(): boolean {\n    if (this.observer) return true;\n    const PO = (globalThis as { PerformanceObserver?: typeof PerformanceObserver }).PerformanceObserver;\n    const supported = PO?.supportedEntryTypes?.includes(\"event\");\n    if (!PO || !supported) return false;\n\n    try {\n      const observer = new PO((list) => {\n        for (const entry of list.getEntries()) {\n          const timing = entry as PerformanceEntry & { duration: number; target?: Element };\n          this.record({\n            name: timing.name,\n            startTime: timing.startTime,\n            duration: timing.duration,\n            target: describeTarget(timing.target),\n          });\n        }\n      });\n      // 16ms: anything that misses a frame is worth attributing.\n      observer.observe({ type: \"event\", buffered: true, durationThreshold: 16 } as PerformanceObserverInit);\n      this.observer = observer;\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  stop(): void {\n    this.observer?.disconnect();\n    this.observer = undefined;\n  }\n\n  /** Is the automatic path available in this browser? */\n  get automatic(): boolean {\n    return this.observer !== undefined;\n  }\n\n  /**\n   * Time an interaction by hand.\n   *\n   * The automatic path depends on the Event Timing API, which Safari only\n   * gained in 16.4 and which does not fire for synthetic input at all — so\n   * anything driven by a test harness records nothing. This measures a specific\n   * action instead, up to the paint that follows it, and needs no browser\n   * support beyond `performance.now`.\n   */\n  measure<T>(label: string, action: () => T): T {\n    const startTime = now();\n    let handlerMs = 0;\n    let finished = false;\n    const finish = (): void => {\n      if (finished) return;\n      finished = true;\n      this.record({ name: label, startTime, duration: now() - startTime, handlerMs });\n    };\n\n    let result: T;\n    try {\n      result = action();\n      handlerMs = now() - startTime;\n    } catch (error) {\n      handlerMs = now() - startTime;\n      finish();\n      throw error;\n    }\n\n    /*\n     * Close the window after the frame in which React commits and paints.\n     *\n     * The timer is not belt-and-braces: `requestAnimationFrame` does not fire\n     * in a hidden tab, and does not exist in jsdom, so without it an\n     * interaction would simply never be recorded. Whichever fires first wins;\n     * the fallback is long enough that rAF normally does.\n     */\n    const raf = (globalThis as { requestAnimationFrame?: (cb: () => void) => void }).requestAnimationFrame;\n    if (raf) raf(() => raf(finish));\n    setTimeout(finish, FALLBACK_CLOSE_MS);\n\n    return result;\n  }\n\n  /** Exposed for tests and for `measure`. */\n  record(timing: RawEventTiming): InteractionRecord {\n    const record: InteractionRecord = {\n      id: `interaction_${++this.nextId}`,\n      type: timing.name,\n      target: timing.target,\n      startTime: timing.startTime,\n      durationMs: timing.duration,\n      handlerMs: timing.handlerMs,\n      renders: [],\n      renderTimeMs: 0,\n      avoidableRenderTimeMs: 0,\n    };\n    this.records.push(record);\n    if (this.records.length > this.capacity) this.records.shift();\n    return record;\n  }\n\n  clear(): void {\n    this.records.length = 0;\n  }\n\n  /**\n   * Joins render events to interactions by commit time. A render belongs to an\n   * interaction when it committed between the event starting and shortly after\n   * it finished — React commits just after the event handler returns.\n   */\n  attribute(events: RenderEvent[]): InteractionRecord[] {\n    for (const record of this.records) {\n      const from = record.startTime;\n      const to = record.startTime + record.durationMs + COMMIT_SLACK_MS;\n      record.renders = events.filter((e) => e.timings.commitTime >= from && e.timings.commitTime <= to);\n      record.renderTimeMs = record.renders.reduce((a, e) => a + e.timings.selfDuration, 0);\n      record.avoidableRenderTimeMs = record.renders\n        .filter((e) => e.diagnosis.potentiallyAvoidable)\n        .reduce((a, e) => a + e.timings.selfDuration, 0);\n    }\n    return [...this.records].sort((a, b) => b.durationMs - a.durationMs);\n  }\n}\n\nexport function summarise(record: InteractionRecord): InteractionSummary {\n  const byComponent = new Map<string, { renders: number; totalMs: number; source?: string; cause: string }>();\n  for (const event of record.renders) {\n    const entry = byComponent.get(event.component.name) ?? {\n      renders: 0,\n      totalMs: 0,\n      source: event.component.source,\n      cause: event.diagnosis.reason,\n    };\n    entry.renders++;\n    entry.totalMs += event.timings.selfDuration;\n    byComponent.set(event.component.name, entry);\n  }\n\n  const contributors = [...byComponent.entries()]\n    .map(([component, v]) => ({ component, source: v.source, renders: v.renders, totalMs: v.totalMs, cause: v.cause }))\n    .sort((a, b) => b.totalMs - a.totalMs);\n\n  const top = contributors[0];\n\n  /*\n   * A manually measured window waits for a frame, and a throttled or hidden tab\n   * can stretch that to hundreds of milliseconds of pure idling. Attributing\n   * that to the app would be inventing a problem, so when the window is far\n   * larger than the work inside it, reason about the work instead.\n   */\n  const accounted = (record.handlerMs ?? record.durationMs) + record.renderTimeMs;\n  const idleWindow = record.handlerMs !== undefined && record.durationMs > accounted * 3 && record.durationMs - accounted > 100;\n  const effectiveMs = idleWindow ? accounted : record.durationMs;\n  const share = effectiveMs > 0 ? record.renderTimeMs / effectiveMs : 0;\n\n  let headline: string;\n  let nextStep: string;\n  let confidence: Confidence = \"medium\";\n\n  if (idleWindow) {\n    headline =\n      `${record.type}: ${fmt(record.handlerMs ?? 0)} in the handler and ${fmt(record.renderTimeMs)} rendering. ` +\n      `The measured window was ${fmt(record.durationMs)}, but most of that was the page waiting for a frame — ignore it.`;\n    nextStep =\n      record.renderTimeMs > (record.handlerMs ?? 0)\n        ? `Rendering dominates the real work${top ? `; start with ${top.component}` : \"\"}.`\n        : \"The handler itself costs more than rendering. Profile the handler, not React.\";\n    return { interaction: record, contributors, headline, nextStep, confidence: \"medium\" };\n  }\n\n  if (record.renders.length === 0) {\n    headline = `${record.type} took ${fmt(record.durationMs)}, and no instrumented component rendered inside it.`;\n    nextStep =\n      \"The cost is somewhere other than React rendering — an event handler, a layout, or an uninstrumented component. Instrument more of the tree to narrow it down.\";\n    confidence = \"low\";\n  } else if (share >= 0.4 && record.avoidableRenderTimeMs > 0) {\n    headline =\n      `${record.type} took ${fmt(record.durationMs)}; ${fmt(record.renderTimeMs)} of it was rendering, ` +\n      `and ${fmt(record.avoidableRenderTimeMs)} of that had no input change to explain it.`;\n    nextStep = top\n      ? `Start with ${top.component}${top.source ? ` (${top.source})` : \"\"} — ${fmt(top.totalMs)} across ${top.renders} render${top.renders === 1 ? \"\" : \"s\"}.`\n      : \"Look at the top contributor below.\";\n    confidence = \"high\";\n  } else if (share >= 0.4) {\n    headline = `${record.type} took ${fmt(record.durationMs)}; ${fmt(record.renderTimeMs)} of it was rendering, all of it explained by real input changes.`;\n    nextStep = \"This is genuine work. Make the renders cheaper rather than fewer — or do less of it per interaction.\";\n    confidence = \"high\";\n  } else {\n    headline = `${record.type} took ${fmt(record.durationMs)}, but only ${fmt(record.renderTimeMs)} was React rendering.`;\n    nextStep = \"Most of the cost is outside rendering — event handlers, layout or paint. A browser profile will show more than this tool can.\";\n    confidence = \"medium\";\n  }\n\n  return { interaction: record, contributors, headline, nextStep, confidence };\n}\n\nexport function formatInteraction(summary: InteractionSummary): string {\n  const { interaction: i } = summary;\n  const lines = [\n    `${i.type}${i.target ? ` on ${i.target}` : \"\"}   ${fmt(i.durationMs)}`,\n    \"\",\n    summary.headline,\n  ];\n\n  if (summary.contributors.length > 0) {\n    lines.push(\"\", \"Rendering inside this interaction\");\n    for (const c of summary.contributors.slice(0, 8)) {\n      lines.push(\n        `  ${c.component.padEnd(22)} ${String(c.renders).padStart(4)} render(s)  ${fmt(c.totalMs).padStart(8)}  ${c.cause}`,\n      );\n    }\n  }\n\n  lines.push(\"\", `Next step`, `  ${summary.nextStep}`, \"\", `Confidence: ${summary.confidence}`);\n  return lines.join(\"\\n\");\n}\n\nfunction describeTarget(target: unknown): string | undefined {\n  if (!target || typeof target !== \"object\") return undefined;\n  const el = target as { tagName?: string; id?: string; className?: unknown; textContent?: string | null };\n  if (!el.tagName) return undefined;\n  const tag = el.tagName.toLowerCase();\n  if (el.id) return `${tag}#${el.id}`;\n  const className = typeof el.className === \"string\" ? el.className.trim().split(/\\s+/)[0] : undefined;\n  if (className) return `${tag}.${className}`;\n  const text = el.textContent?.trim().slice(0, 20);\n  return text ? `${tag} \"${text}\"` : tag;\n}\n\nconst fmt = (ms: number): string => `${ms.toFixed(1)}ms`;\n\nconst now = (): number =>\n  typeof performance !== \"undefined\" && typeof performance.now === \"function\" ? performance.now() : Date.now();\n","/**\n * Interaction and INP attribution — opt-in.\n *\n * Split out of the root entry in 0.6.0. It was started by `init()`, which meant\n * every consumer paid ~2 KB for it whether or not they used it, and the root\n * entry's budget had then been raised three releases running. Splitting was the\n * committed alternative to raising it a fourth time.\n *\n *   import { startInteractionTracking, printInteractions } from \"react-render-detective/interactions\";\n *   startInteractionTracking();\n */\nimport { formatInteraction, InteractionTracker, summarise } from \"../core/interactions.js\";\nimport type { InteractionRecord, InteractionSummary } from \"../core/interactions.js\";\nimport { getDetective } from \"../core/store.js\";\n\nconst TRACKER = Symbol.for(\"react-render-detective.interactions\");\ntype Global = typeof globalThis & { [TRACKER]?: InteractionTracker };\n\nfunction tracker(): InteractionTracker {\n  const g = globalThis as Global;\n  if (!g[TRACKER]) {\n    const created = new InteractionTracker();\n    g[TRACKER] = created;\n    // Follow the detective's lifecycle so `clear()` and `reset()` stay coherent\n    // without the root entry needing to know this module exists.\n    const detective = getDetective();\n    detective.registerClearHook(() => created.clear());\n    detective.registerResetHook(() => {\n      created.stop();\n      (globalThis as Global)[TRACKER] = undefined;\n    });\n  }\n  return g[TRACKER] as InteractionTracker;\n}\n\n/**\n * Begin capturing interactions. Returns `false` where the browser cannot report\n * event timing (Safari before 16.4, jsdom) — use `measureInteraction` there.\n */\nexport function startInteractionTracking(): boolean {\n  return tracker().start();\n}\n\nexport function stopInteractionTracking(): void {\n  tracker().stop();\n}\n\n/** Interactions, slowest first, with the renders committed inside each. */\nexport function getInteractions(): InteractionRecord[] {\n  return tracker().attribute(getDetective().getEvents());\n}\n\n/** Structured analysis of one interaction. Defaults to the slowest recorded. */\nexport function explainInteractionStructured(id?: string): InteractionSummary | undefined {\n  const records = getInteractions();\n  const record = id ? records.find((r) => r.id === id) : records[0];\n  return record ? summarise(record) : undefined;\n}\n\nexport function explainInteraction(id?: string): string | undefined {\n  const summary = explainInteractionStructured(id);\n  return summary ? formatInteraction(summary) : undefined;\n}\n\nexport function printInteractions(limit = 5): void {\n  const records = getInteractions().slice(0, limit);\n  if (records.length === 0) {\n    console.log(\n      tracker().automatic\n        ? \"No interactions recorded yet. Event timing is working — nothing has taken longer than 16ms.\\n\" +\n            \"Synthetic clicks from a test harness never produce these entries; use measureInteraction() there.\"\n        : \"This browser does not report event timing (Safari before 16.4, jsdom), or tracking was never started.\\n\" +\n            \"Call startInteractionTracking(), or use measureInteraction(label, fn) to time interactions by hand.\",\n    );\n    return;\n  }\n  console.log(records.map((r) => formatInteraction(summarise(r))).join(\"\\n\\n\"));\n}\n\n/**\n * Time one interaction explicitly, up to the paint that follows it. Needed\n * wherever the automatic path cannot see: Safari before 16.4, and any synthetic\n * input, which never produces Event Timing entries.\n */\nexport function measureInteraction<T>(label: string, action: () => T): T {\n  return tracker().measure(label, action);\n}\n\nexport { InteractionTracker, summarise as summariseInteraction, formatInteraction } from \"../core/interactions.js\";\nexport type { InteractionRecord, InteractionSummary } from \"../core/interactions.js\";\n"]}

package/dist/interactions.d.cts

@@ -0,0 +1,110 @@
+import { b as RenderEvent, j as Confidence } from './types-CRET8EhB.cjs';
+
+/**
+ * Interaction-scoped attribution.
+ *
+ * Performance is felt per interaction, not in aggregate — and INP is the metric
+ * teams are actually judged on. This joins the two halves: the browser says a
+ * keystroke took 240ms, and the render events say which components spent it and
+ * why.
+ *
+ * Uses `PerformanceObserver` with `event` timing, a public browser API. Where it
+ * is unsupported (older Safari, jsdom) interaction tracking simply stays empty
+ * rather than guessing.
+ */
+interface InteractionRecord {
+    id: string;
+    /** `click`, `keydown`, `pointerup`… */
+    type: string;
+    /** Best-effort description of what was interacted with. */
+    target?: string;
+    startTime: number;
+    /** Browser-reported event duration — the number INP is computed from. */
+    durationMs: number;
+    /**
+     * For a manually measured interaction: how long the synchronous action took.
+     * Immune to throttling, unlike the full window, which waits on a frame.
+     */
+    handlerMs?: number;
+    /** Renders committed inside this interaction's window. */
+    renders: RenderEvent[];
+    /** Sum of self durations for those renders. */
+    renderTimeMs: number;
+    /** Render time that no observable input change explains. */
+    avoidableRenderTimeMs: number;
+}
+interface InteractionSummary {
+    interaction: InteractionRecord;
+    /** Components ordered by cost within this interaction. */
+    contributors: Array<{
+        component: string;
+        source?: string;
+        renders: number;
+        totalMs: number;
+        cause: string;
+    }>;
+    headline: string;
+    nextStep: string;
+    confidence: Confidence;
+}
+interface RawEventTiming {
+    name: string;
+    startTime: number;
+    duration: number;
+    target?: string;
+    handlerMs?: number;
+}
+declare class InteractionTracker {
+    private capacity;
+    private records;
+    private observer;
+    private nextId;
+    constructor(capacity?: number);
+    /** Returns false when the browser cannot report event timing. */
+    start(): boolean;
+    stop(): void;
+    /** Is the automatic path available in this browser? */
+    get automatic(): boolean;
+    /**
+     * 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<T>(label: string, action: () => T): T;
+    /** Exposed for tests and for `measure`. */
+    record(timing: RawEventTiming): InteractionRecord;
+    clear(): void;
+    /**
+     * 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: RenderEvent[]): InteractionRecord[];
+}
+declare function summarise(record: InteractionRecord): InteractionSummary;
+declare function formatInteraction(summary: InteractionSummary): string;
+
+/**
+ * Begin capturing interactions. Returns `false` where the browser cannot report
+ * event timing (Safari before 16.4, jsdom) — use `measureInteraction` there.
+ */
+declare function startInteractionTracking(): boolean;
+declare function stopInteractionTracking(): void;
+/** Interactions, slowest first, with the renders committed inside each. */
+declare function getInteractions(): InteractionRecord[];
+/** Structured analysis of one interaction. Defaults to the slowest recorded. */
+declare function explainInteractionStructured(id?: string): InteractionSummary | undefined;
+declare function explainInteraction(id?: string): string | undefined;
+declare function printInteractions(limit?: number): void;
+/**
+ * Time one interaction explicitly, up to the paint that follows it. Needed
+ * wherever the automatic path cannot see: Safari before 16.4, and any synthetic
+ * input, which never produces Event Timing entries.
+ */
+declare function measureInteraction<T>(label: string, action: () => T): T;
+
+export { type InteractionRecord, type InteractionSummary, InteractionTracker, explainInteraction, explainInteractionStructured, formatInteraction, getInteractions, measureInteraction, printInteractions, startInteractionTracking, stopInteractionTracking, summarise as summariseInteraction };

package/dist/interactions.d.ts

@@ -0,0 +1,110 @@
+import { b as RenderEvent, j as Confidence } from './types-CRET8EhB.js';
+
+/**
+ * Interaction-scoped attribution.
+ *
+ * Performance is felt per interaction, not in aggregate — and INP is the metric
+ * teams are actually judged on. This joins the two halves: the browser says a
+ * keystroke took 240ms, and the render events say which components spent it and
+ * why.
+ *
+ * Uses `PerformanceObserver` with `event` timing, a public browser API. Where it
+ * is unsupported (older Safari, jsdom) interaction tracking simply stays empty
+ * rather than guessing.
+ */
+interface InteractionRecord {
+    id: string;
+    /** `click`, `keydown`, `pointerup`… */
+    type: string;
+    /** Best-effort description of what was interacted with. */
+    target?: string;
+    startTime: number;
+    /** Browser-reported event duration — the number INP is computed from. */
+    durationMs: number;
+    /**
+     * For a manually measured interaction: how long the synchronous action took.
+     * Immune to throttling, unlike the full window, which waits on a frame.
+     */
+    handlerMs?: number;
+    /** Renders committed inside this interaction's window. */
+    renders: RenderEvent[];
+    /** Sum of self durations for those renders. */
+    renderTimeMs: number;
+    /** Render time that no observable input change explains. */
+    avoidableRenderTimeMs: number;
+}
+interface InteractionSummary {
+    interaction: InteractionRecord;
+    /** Components ordered by cost within this interaction. */
+    contributors: Array<{
+        component: string;
+        source?: string;
+        renders: number;
+        totalMs: number;
+        cause: string;
+    }>;
+    headline: string;
+    nextStep: string;
+    confidence: Confidence;
+}
+interface RawEventTiming {
+    name: string;
+    startTime: number;
+    duration: number;
+    target?: string;
+    handlerMs?: number;
+}
+declare class InteractionTracker {
+    private capacity;
+    private records;
+    private observer;
+    private nextId;
+    constructor(capacity?: number);
+    /** Returns false when the browser cannot report event timing. */
+    start(): boolean;
+    stop(): void;
+    /** Is the automatic path available in this browser? */
+    get automatic(): boolean;
+    /**
+     * 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<T>(label: string, action: () => T): T;
+    /** Exposed for tests and for `measure`. */
+    record(timing: RawEventTiming): InteractionRecord;
+    clear(): void;
+    /**
+     * 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: RenderEvent[]): InteractionRecord[];
+}
+declare function summarise(record: InteractionRecord): InteractionSummary;
+declare function formatInteraction(summary: InteractionSummary): string;
+
+/**
+ * Begin capturing interactions. Returns `false` where the browser cannot report
+ * event timing (Safari before 16.4, jsdom) — use `measureInteraction` there.
+ */
+declare function startInteractionTracking(): boolean;
+declare function stopInteractionTracking(): void;
+/** Interactions, slowest first, with the renders committed inside each. */
+declare function getInteractions(): InteractionRecord[];
+/** Structured analysis of one interaction. Defaults to the slowest recorded. */
+declare function explainInteractionStructured(id?: string): InteractionSummary | undefined;
+declare function explainInteraction(id?: string): string | undefined;
+declare function printInteractions(limit?: number): void;
+/**
+ * Time one interaction explicitly, up to the paint that follows it. Needed
+ * wherever the automatic path cannot see: Safari before 16.4, and any synthetic
+ * input, which never produces Event Timing entries.
+ */
+declare function measureInteraction<T>(label: string, action: () => T): T;
+
+export { type InteractionRecord, type InteractionSummary, InteractionTracker, explainInteraction, explainInteractionStructured, formatInteraction, getInteractions, measureInteraction, printInteractions, startInteractionTracking, stopInteractionTracking, summarise as summariseInteraction };

package/dist/interactions.js

@@ -0,0 +1,241 @@
+import { getDetective } from './chunk-3TZNM7JO.js';
+
+// 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(label, action) {
+    const startTime = now();
+    let handlerMs = 0;
+    let finished = false;
+    const finish = () => {
+      if (finished) return;
+      finished = true;
+      this.record({ name: label, 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/interactions/index.ts
+var TRACKER = /* @__PURE__ */ Symbol.for("react-render-detective.interactions");
+function tracker() {
+  const g = globalThis;
+  if (!g[TRACKER]) {
+    const created = new InteractionTracker();
+    g[TRACKER] = created;
+    const detective = getDetective();
+    detective.registerClearHook(() => created.clear());
+    detective.registerResetHook(() => {
+      created.stop();
+      globalThis[TRACKER] = void 0;
+    });
+  }
+  return g[TRACKER];
+}
+function startInteractionTracking() {
+  return tracker().start();
+}
+function stopInteractionTracking() {
+  tracker().stop();
+}
+function getInteractions() {
+  return tracker().attribute(getDetective().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), or tracking was never started.\nCall startInteractionTracking(), or use measureInteraction(label, fn) to time interactions by hand."
+    );
+    return;
+  }
+  console.log(records.map((r) => formatInteraction(summarise(r))).join("\n\n"));
+}
+function measureInteraction(label, action) {
+  return tracker().measure(label, action);
+}
+
+export { InteractionTracker, explainInteraction, explainInteractionStructured, formatInteraction, getInteractions, measureInteraction, printInteractions, startInteractionTracking, stopInteractionTracking, summarise as summariseInteraction };
+//# sourceMappingURL=interactions.js.map
+//# sourceMappingURL=interactions.js.map

package/dist/interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/interactions.ts","../src/interactions/index.ts"],"names":[],"mappings":"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","file":"interactions.js","sourcesContent":["import type { Confidence, RenderEvent } from \"./types.js\";\n\n/**\n * Interaction-scoped attribution.\n *\n * Performance is felt per interaction, not in aggregate — and INP is the metric\n * teams are actually judged on. This joins the two halves: the browser says a\n * keystroke took 240ms, and the render events say which components spent it and\n * why.\n *\n * Uses `PerformanceObserver` with `event` timing, a public browser API. Where it\n * is unsupported (older Safari, jsdom) interaction tracking simply stays empty\n * rather than guessing.\n */\nexport interface InteractionRecord {\n  id: string;\n  /** `click`, `keydown`, `pointerup`… */\n  type: string;\n  /** Best-effort description of what was interacted with. */\n  target?: string;\n  startTime: number;\n  /** Browser-reported event duration — the number INP is computed from. */\n  durationMs: number;\n  /**\n   * For a manually measured interaction: how long the synchronous action took.\n   * Immune to throttling, unlike the full window, which waits on a frame.\n   */\n  handlerMs?: number;\n  /** Renders committed inside this interaction's window. */\n  renders: RenderEvent[];\n  /** Sum of self durations for those renders. */\n  renderTimeMs: number;\n  /** Render time that no observable input change explains. */\n  avoidableRenderTimeMs: number;\n}\n\nexport interface InteractionSummary {\n  interaction: InteractionRecord;\n  /** Components ordered by cost within this interaction. */\n  contributors: Array<{ component: string; source?: string; renders: number; totalMs: number; cause: string }>;\n  headline: string;\n  nextStep: string;\n  confidence: Confidence;\n}\n\n/** Entries React commits slightly after the event finishes; allow for that. */\nconst COMMIT_SLACK_MS = 100;\n\n/** Used when requestAnimationFrame cannot fire — a hidden tab, or jsdom. */\nconst FALLBACK_CLOSE_MS = 50;\n\ninterface RawEventTiming {\n  name: string;\n  startTime: number;\n  duration: number;\n  target?: string;\n  handlerMs?: number;\n}\n\nexport class InteractionTracker {\n  private records: InteractionRecord[] = [];\n  private observer: { disconnect: () => void } | undefined;\n  private nextId = 0;\n\n  constructor(private capacity = 50) {}\n\n  /** Returns false when the browser cannot report event timing. */\n  start(): boolean {\n    if (this.observer) return true;\n    const PO = (globalThis as { PerformanceObserver?: typeof PerformanceObserver }).PerformanceObserver;\n    const supported = PO?.supportedEntryTypes?.includes(\"event\");\n    if (!PO || !supported) return false;\n\n    try {\n      const observer = new PO((list) => {\n        for (const entry of list.getEntries()) {\n          const timing = entry as PerformanceEntry & { duration: number; target?: Element };\n          this.record({\n            name: timing.name,\n            startTime: timing.startTime,\n            duration: timing.duration,\n            target: describeTarget(timing.target),\n          });\n        }\n      });\n      // 16ms: anything that misses a frame is worth attributing.\n      observer.observe({ type: \"event\", buffered: true, durationThreshold: 16 } as PerformanceObserverInit);\n      this.observer = observer;\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  stop(): void {\n    this.observer?.disconnect();\n    this.observer = undefined;\n  }\n\n  /** Is the automatic path available in this browser? */\n  get automatic(): boolean {\n    return this.observer !== undefined;\n  }\n\n  /**\n   * Time an interaction by hand.\n   *\n   * The automatic path depends on the Event Timing API, which Safari only\n   * gained in 16.4 and which does not fire for synthetic input at all — so\n   * anything driven by a test harness records nothing. This measures a specific\n   * action instead, up to the paint that follows it, and needs no browser\n   * support beyond `performance.now`.\n   */\n  measure<T>(label: string, action: () => T): T {\n    const startTime = now();\n    let handlerMs = 0;\n    let finished = false;\n    const finish = (): void => {\n      if (finished) return;\n      finished = true;\n      this.record({ name: label, startTime, duration: now() - startTime, handlerMs });\n    };\n\n    let result: T;\n    try {\n      result = action();\n      handlerMs = now() - startTime;\n    } catch (error) {\n      handlerMs = now() - startTime;\n      finish();\n      throw error;\n    }\n\n    /*\n     * Close the window after the frame in which React commits and paints.\n     *\n     * The timer is not belt-and-braces: `requestAnimationFrame` does not fire\n     * in a hidden tab, and does not exist in jsdom, so without it an\n     * interaction would simply never be recorded. Whichever fires first wins;\n     * the fallback is long enough that rAF normally does.\n     */\n    const raf = (globalThis as { requestAnimationFrame?: (cb: () => void) => void }).requestAnimationFrame;\n    if (raf) raf(() => raf(finish));\n    setTimeout(finish, FALLBACK_CLOSE_MS);\n\n    return result;\n  }\n\n  /** Exposed for tests and for `measure`. */\n  record(timing: RawEventTiming): InteractionRecord {\n    const record: InteractionRecord = {\n      id: `interaction_${++this.nextId}`,\n      type: timing.name,\n      target: timing.target,\n      startTime: timing.startTime,\n      durationMs: timing.duration,\n      handlerMs: timing.handlerMs,\n      renders: [],\n      renderTimeMs: 0,\n      avoidableRenderTimeMs: 0,\n    };\n    this.records.push(record);\n    if (this.records.length > this.capacity) this.records.shift();\n    return record;\n  }\n\n  clear(): void {\n    this.records.length = 0;\n  }\n\n  /**\n   * Joins render events to interactions by commit time. A render belongs to an\n   * interaction when it committed between the event starting and shortly after\n   * it finished — React commits just after the event handler returns.\n   */\n  attribute(events: RenderEvent[]): InteractionRecord[] {\n    for (const record of this.records) {\n      const from = record.startTime;\n      const to = record.startTime + record.durationMs + COMMIT_SLACK_MS;\n      record.renders = events.filter((e) => e.timings.commitTime >= from && e.timings.commitTime <= to);\n      record.renderTimeMs = record.renders.reduce((a, e) => a + e.timings.selfDuration, 0);\n      record.avoidableRenderTimeMs = record.renders\n        .filter((e) => e.diagnosis.potentiallyAvoidable)\n        .reduce((a, e) => a + e.timings.selfDuration, 0);\n    }\n    return [...this.records].sort((a, b) => b.durationMs - a.durationMs);\n  }\n}\n\nexport function summarise(record: InteractionRecord): InteractionSummary {\n  const byComponent = new Map<string, { renders: number; totalMs: number; source?: string; cause: string }>();\n  for (const event of record.renders) {\n    const entry = byComponent.get(event.component.name) ?? {\n      renders: 0,\n      totalMs: 0,\n      source: event.component.source,\n      cause: event.diagnosis.reason,\n    };\n    entry.renders++;\n    entry.totalMs += event.timings.selfDuration;\n    byComponent.set(event.component.name, entry);\n  }\n\n  const contributors = [...byComponent.entries()]\n    .map(([component, v]) => ({ component, source: v.source, renders: v.renders, totalMs: v.totalMs, cause: v.cause }))\n    .sort((a, b) => b.totalMs - a.totalMs);\n\n  const top = contributors[0];\n\n  /*\n   * A manually measured window waits for a frame, and a throttled or hidden tab\n   * can stretch that to hundreds of milliseconds of pure idling. Attributing\n   * that to the app would be inventing a problem, so when the window is far\n   * larger than the work inside it, reason about the work instead.\n   */\n  const accounted = (record.handlerMs ?? record.durationMs) + record.renderTimeMs;\n  const idleWindow = record.handlerMs !== undefined && record.durationMs > accounted * 3 && record.durationMs - accounted > 100;\n  const effectiveMs = idleWindow ? accounted : record.durationMs;\n  const share = effectiveMs > 0 ? record.renderTimeMs / effectiveMs : 0;\n\n  let headline: string;\n  let nextStep: string;\n  let confidence: Confidence = \"medium\";\n\n  if (idleWindow) {\n    headline =\n      `${record.type}: ${fmt(record.handlerMs ?? 0)} in the handler and ${fmt(record.renderTimeMs)} rendering. ` +\n      `The measured window was ${fmt(record.durationMs)}, but most of that was the page waiting for a frame — ignore it.`;\n    nextStep =\n      record.renderTimeMs > (record.handlerMs ?? 0)\n        ? `Rendering dominates the real work${top ? `; start with ${top.component}` : \"\"}.`\n        : \"The handler itself costs more than rendering. Profile the handler, not React.\";\n    return { interaction: record, contributors, headline, nextStep, confidence: \"medium\" };\n  }\n\n  if (record.renders.length === 0) {\n    headline = `${record.type} took ${fmt(record.durationMs)}, and no instrumented component rendered inside it.`;\n    nextStep =\n      \"The cost is somewhere other than React rendering — an event handler, a layout, or an uninstrumented component. Instrument more of the tree to narrow it down.\";\n    confidence = \"low\";\n  } else if (share >= 0.4 && record.avoidableRenderTimeMs > 0) {\n    headline =\n      `${record.type} took ${fmt(record.durationMs)}; ${fmt(record.renderTimeMs)} of it was rendering, ` +\n      `and ${fmt(record.avoidableRenderTimeMs)} of that had no input change to explain it.`;\n    nextStep = top\n      ? `Start with ${top.component}${top.source ? ` (${top.source})` : \"\"} — ${fmt(top.totalMs)} across ${top.renders} render${top.renders === 1 ? \"\" : \"s\"}.`\n      : \"Look at the top contributor below.\";\n    confidence = \"high\";\n  } else if (share >= 0.4) {\n    headline = `${record.type} took ${fmt(record.durationMs)}; ${fmt(record.renderTimeMs)} of it was rendering, all of it explained by real input changes.`;\n    nextStep = \"This is genuine work. Make the renders cheaper rather than fewer — or do less of it per interaction.\";\n    confidence = \"high\";\n  } else {\n    headline = `${record.type} took ${fmt(record.durationMs)}, but only ${fmt(record.renderTimeMs)} was React rendering.`;\n    nextStep = \"Most of the cost is outside rendering — event handlers, layout or paint. A browser profile will show more than this tool can.\";\n    confidence = \"medium\";\n  }\n\n  return { interaction: record, contributors, headline, nextStep, confidence };\n}\n\nexport function formatInteraction(summary: InteractionSummary): string {\n  const { interaction: i } = summary;\n  const lines = [\n    `${i.type}${i.target ? ` on ${i.target}` : \"\"}   ${fmt(i.durationMs)}`,\n    \"\",\n    summary.headline,\n  ];\n\n  if (summary.contributors.length > 0) {\n    lines.push(\"\", \"Rendering inside this interaction\");\n    for (const c of summary.contributors.slice(0, 8)) {\n      lines.push(\n        `  ${c.component.padEnd(22)} ${String(c.renders).padStart(4)} render(s)  ${fmt(c.totalMs).padStart(8)}  ${c.cause}`,\n      );\n    }\n  }\n\n  lines.push(\"\", `Next step`, `  ${summary.nextStep}`, \"\", `Confidence: ${summary.confidence}`);\n  return lines.join(\"\\n\");\n}\n\nfunction describeTarget(target: unknown): string | undefined {\n  if (!target || typeof target !== \"object\") return undefined;\n  const el = target as { tagName?: string; id?: string; className?: unknown; textContent?: string | null };\n  if (!el.tagName) return undefined;\n  const tag = el.tagName.toLowerCase();\n  if (el.id) return `${tag}#${el.id}`;\n  const className = typeof el.className === \"string\" ? el.className.trim().split(/\\s+/)[0] : undefined;\n  if (className) return `${tag}.${className}`;\n  const text = el.textContent?.trim().slice(0, 20);\n  return text ? `${tag} \"${text}\"` : tag;\n}\n\nconst fmt = (ms: number): string => `${ms.toFixed(1)}ms`;\n\nconst now = (): number =>\n  typeof performance !== \"undefined\" && typeof performance.now === \"function\" ? performance.now() : Date.now();\n","/**\n * Interaction and INP attribution — opt-in.\n *\n * Split out of the root entry in 0.6.0. It was started by `init()`, which meant\n * every consumer paid ~2 KB for it whether or not they used it, and the root\n * entry's budget had then been raised three releases running. Splitting was the\n * committed alternative to raising it a fourth time.\n *\n *   import { startInteractionTracking, printInteractions } from \"react-render-detective/interactions\";\n *   startInteractionTracking();\n */\nimport { formatInteraction, InteractionTracker, summarise } from \"../core/interactions.js\";\nimport type { InteractionRecord, InteractionSummary } from \"../core/interactions.js\";\nimport { getDetective } from \"../core/store.js\";\n\nconst TRACKER = Symbol.for(\"react-render-detective.interactions\");\ntype Global = typeof globalThis & { [TRACKER]?: InteractionTracker };\n\nfunction tracker(): InteractionTracker {\n  const g = globalThis as Global;\n  if (!g[TRACKER]) {\n    const created = new InteractionTracker();\n    g[TRACKER] = created;\n    // Follow the detective's lifecycle so `clear()` and `reset()` stay coherent\n    // without the root entry needing to know this module exists.\n    const detective = getDetective();\n    detective.registerClearHook(() => created.clear());\n    detective.registerResetHook(() => {\n      created.stop();\n      (globalThis as Global)[TRACKER] = undefined;\n    });\n  }\n  return g[TRACKER] as InteractionTracker;\n}\n\n/**\n * Begin capturing interactions. Returns `false` where the browser cannot report\n * event timing (Safari before 16.4, jsdom) — use `measureInteraction` there.\n */\nexport function startInteractionTracking(): boolean {\n  return tracker().start();\n}\n\nexport function stopInteractionTracking(): void {\n  tracker().stop();\n}\n\n/** Interactions, slowest first, with the renders committed inside each. */\nexport function getInteractions(): InteractionRecord[] {\n  return tracker().attribute(getDetective().getEvents());\n}\n\n/** Structured analysis of one interaction. Defaults to the slowest recorded. */\nexport function explainInteractionStructured(id?: string): InteractionSummary | undefined {\n  const records = getInteractions();\n  const record = id ? records.find((r) => r.id === id) : records[0];\n  return record ? summarise(record) : undefined;\n}\n\nexport function explainInteraction(id?: string): string | undefined {\n  const summary = explainInteractionStructured(id);\n  return summary ? formatInteraction(summary) : undefined;\n}\n\nexport function printInteractions(limit = 5): void {\n  const records = getInteractions().slice(0, limit);\n  if (records.length === 0) {\n    console.log(\n      tracker().automatic\n        ? \"No interactions recorded yet. Event timing is working — nothing has taken longer than 16ms.\\n\" +\n            \"Synthetic clicks from a test harness never produce these entries; use measureInteraction() there.\"\n        : \"This browser does not report event timing (Safari before 16.4, jsdom), or tracking was never started.\\n\" +\n            \"Call startInteractionTracking(), or use measureInteraction(label, fn) to time interactions by hand.\",\n    );\n    return;\n  }\n  console.log(records.map((r) => formatInteraction(summarise(r))).join(\"\\n\\n\"));\n}\n\n/**\n * Time one interaction explicitly, up to the paint that follows it. Needed\n * wherever the automatic path cannot see: Safari before 16.4, and any synthetic\n * input, which never produces Event Timing entries.\n */\nexport function measureInteraction<T>(label: string, action: () => T): T {\n  return tracker().measure(label, action);\n}\n\nexport { InteractionTracker, summarise as summariseInteraction, formatInteraction } from \"../core/interactions.js\";\nexport type { InteractionRecord, InteractionSummary } from \"../core/interactions.js\";\n"]}

package/dist/overlay.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkJD4IJ4MN_cjs = require('./chunk-JD4IJ4MN.cjs');
-var chunkOSPTERGK_cjs = require('./chunk-OSPTERGK.cjs');
+var chunkRGT44QQI_cjs = require('./chunk-RGT44QQI.cjs');
+var chunkLCGXVRJR_cjs = require('./chunk-LCGXVRJR.cjs');
 
 // src/overlay/overlay.ts
 var MOUNTED = /* @__PURE__ */ Symbol.for("react-render-detective.overlay");
@@ -15,7 +15,7 @@ function mountOverlay() {
     } };
     return noop;
   }
-  const detective = chunkOSPTERGK_cjs.getDetective();
+  const detective = chunkLCGXVRJR_cjs.getDetective();
   const root = document.createElement("div");
   root.setAttribute("data-rrd-overlay", "");
   root.attachShadow({ mode: "open" });
@@ -77,8 +77,8 @@ function mountOverlay() {
         </div>`;
     }).join("");
     if (selected) {
-      const explanation = chunkJD4IJ4MN_cjs.explainEvents(selected, detective.getEvents(), detective.lifecycleOf(selected));
-      detailEl.textContent = explanation ? chunkJD4IJ4MN_cjs.formatExplanation(explanation) : `No recorded renders for ${selected}.`;
+      const explanation = chunkRGT44QQI_cjs.explainEvents(selected, detective.getEvents(), detective.lifecycleOf(selected));
+      detailEl.textContent = explanation ? chunkRGT44QQI_cjs.formatExplanation(explanation) : `No recorded renders for ${selected}.`;
     }
   }
   const handle = {

package/dist/overlay.js

@@ -1,5 +1,5 @@
-import { explainEvents, formatExplanation } from './chunk-HOTY7J3X.js';
-import { getDetective } from './chunk-DI5STJM4.js';
+import { explainEvents, formatExplanation } from './chunk-D7M4UC3Y.js';
+import { getDetective } from './chunk-3TZNM7JO.js';
 
 // src/overlay/overlay.ts
 var MOUNTED = /* @__PURE__ */ Symbol.for("react-render-detective.overlay");

package/dist/testing.d.cts

@@ -1,4 +1,4 @@
-import { b as RenderEvent } from './types-gl13xwmN.cjs';
+import { b as RenderEvent } from './types-CRET8EhB.cjs';
 
 /**
  * Render-regression testing.

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { b as RenderEvent } from './types-gl13xwmN.js';
+import { b as RenderEvent } from './types-CRET8EhB.js';
 
 /**
  * Render-regression testing.