@buoy-gg/highlight-updates 7.0.21 → 7.0.22

package/lib/commonjs/highlight-updates/utils/CommitProfiler.js

@@ -45,9 +45,11 @@ const TOP_COMPONENTS_CAP = 20;
 let hookInstalled = false;
 let active = false;
 let sawDurations = false;
+let captureDetail = false;
 let totalCommits = 0;
 let totalRenders = 0;
 let totalRenderMs = 0;
+let totalCauses = {};
 let buckets = new Map();
 function getHook() {
   if (typeof global === "undefined") return null;
@@ -119,13 +121,129 @@ function isFrameworkWrapperName(name) {
   }
   return false;
 }
-function recordRender(fiber) {
+
+/** Bound on prop keys compared per render, so a fat props object can't stall a commit. */
+const MAX_PROPS_COMPARED = 40;
+/** Bound on distinct changed-prop key names remembered per component (detail tier). */
+const MAX_CHANGED_KEYS = 5;
+
+/**
+ * Are two values for the same prop key equivalent despite differing identity?
+ *
+ * Functions always count as equivalent: a fresh arrow per render is THE
+ * unstable-prop bug, and there's no way to compare behaviour anyway. Plain
+ * objects and arrays compare one level deep, which catches `style={{...}}`
+ * and `data={[...]}`. Anything else falls through to a real value change.
+ */
+function isEquivalentValue(a, b) {
+  if (Object.is(a, b)) return true;
+  const ta = typeof a;
+  if (ta !== typeof b) return false;
+  if (ta === "function") return true;
+  if (a === null || b === null || ta !== "object") return false;
+  const aIsArray = Array.isArray(a);
+  if (aIsArray !== Array.isArray(b)) return false;
+  if (aIsArray) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) if (!Object.is(a[i], b[i])) return false;
+    return true;
+  }
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (let i = 0; i < keysA.length; i++) {
+    const k = keysA[i];
+    if (!Object.prototype.hasOwnProperty.call(b, k)) return false;
+    if (!Object.is(a[k], b[k])) return false;
+  }
+  return true;
+}
+/**
+ * Why did this fiber render?
+ *
+ * Simpler than the overlay's RenderCauseDetector, and deliberately so: that
+ * one carries WeakMap fallbacks and fiber-swap detection because traceUpdates
+ * hands it fibers at an ambiguous moment. Here we're inside onCommitFiberRoot
+ * walking the committed tree, so `fiber` is current and `fiber.alternate` is
+ * previous by definition. Porting the swap logic would be cargo-cult.
+ */
+function detectCause(fiber, wantKeys) {
+  const prev = fiber.alternate;
+  if (!prev) return {
+    cause: "mount"
+  };
+  const nextProps = fiber.memoizedProps;
+  const prevProps = prev.memoizedProps;
+  if (nextProps !== prevProps && nextProps && prevProps) {
+    let sawChange = false;
+    let sawValueChange = false;
+    let changedKeys;
+    const keys = Object.keys(nextProps);
+    const limit = keys.length < MAX_PROPS_COMPARED ? keys.length : MAX_PROPS_COMPARED;
+    for (let i = 0; i < limit; i++) {
+      const k = keys[i];
+      const a = prevProps[k];
+      const b = nextProps[k];
+      if (Object.is(a, b)) continue;
+      sawChange = true;
+      if (wantKeys) {
+        if (!changedKeys) changedKeys = [];
+        if (changedKeys.length < MAX_CHANGED_KEYS) changedKeys.push(k);
+      }
+      if (!isEquivalentValue(a, b)) {
+        sawValueChange = true;
+        if (!wantKeys) break; // cause is settled; only keys need the full pass
+      }
+    }
+    // A removed key counts as a real change; cheap to detect via key count.
+    if (!sawValueChange && Object.keys(prevProps).length !== keys.length) {
+      sawChange = true;
+      sawValueChange = true;
+    }
+    if (sawChange) {
+      return {
+        cause: sawValueChange ? "props" : "propsUnstable",
+        changedKeys
+      };
+    }
+  }
+
+  // No prop change of substance. Own state/hooks next.
+  if (prev.memoizedState !== fiber.memoizedState) return {
+    cause: "hooks"
+  };
+  return {
+    cause: "parent"
+  };
+}
+
+/**
+ * Nearest ancestor that ALSO rendered this commit and is worth naming — i.e.
+ * skipping framework wrappers, which are never where a fix goes. Answers "who
+ * dragged this along", which is the actionable half of a cascade.
+ */
+function nearestRenderedAncestorName(fiber) {
+  for (let p = fiber.return; p != null; p = p.return) {
+    if (!isCompositeTag(p.tag)) continue;
+    if ((getFlags(p) & PerformedWork) === 0) continue;
+    const name = getComponentName(p);
+    if (isFrameworkWrapperName(name)) continue;
+    return name;
+  }
+  return undefined;
+}
+function recordRender(fiber, parentName) {
   const name = getComponentName(fiber);
   const selfMs = computeSelfMs(fiber);
   if (selfMs !== null) sawDurations = true;
   const ms = selfMs ?? 0;
   totalRenders += 1;
   totalRenderMs += ms;
+  const {
+    cause,
+    changedKeys
+  } = detectCause(fiber, captureDetail);
+  totalCauses[cause] = (totalCauses[cause] ?? 0) + 1;
 
   // Framework wrappers count toward totals but never surface as a row.
   if (isFrameworkWrapperName(name)) return;
@@ -136,13 +254,27 @@ function recordRender(fiber) {
     bucket = {
       renders: 0,
       totalSelfMs: 0,
-      maxSelfMs: 0
+      maxSelfMs: 0,
+      causes: {}
     };
     buckets.set(name, bucket);
   }
   bucket.renders += 1;
   bucket.totalSelfMs += ms;
   if (ms > bucket.maxSelfMs) bucket.maxSelfMs = ms;
+  bucket.causes[cause] = (bucket.causes[cause] ?? 0) + 1;
+  if (captureDetail) {
+    if (changedKeys) {
+      if (!bucket.changedProps) bucket.changedProps = new Set();
+      for (let i = 0; i < changedKeys.length; i++) {
+        if (bucket.changedProps.size >= MAX_CHANGED_KEYS) break;
+        bucket.changedProps.add(changedKeys[i]);
+      }
+    }
+    // First parent wins — a component rendered under several parents is rare,
+    // and the first is the one that showed up in the heaviest commit.
+    if (parentName && !bucket.parentName) bucket.parentName = parentName;
+  }
 }
 
 /**
@@ -161,13 +293,21 @@ function handleCommit(root) {
     let skipSubtree = false;
     const composite = isCompositeTag(fiber.tag);
     if (composite) {
-      // Prune Buoy's own devtools UI wholesale.
-      if ((0, _devtoolsComponentNames.isDevToolsComponentName)(getComponentName(fiber))) {
+      const compositeName = getComponentName(fiber);
+      // Only Buoy's render-tracking UI gets its SUBTREE pruned — walking it
+      // feeds its own renders back in and loops. Everything else that's merely
+      // devtools noise is skipped as a NODE and we keep descending: app
+      // components live underneath Buoy chrome, and pruning a subtree on a name
+      // match is what made a stray "Virtualized" prefix hide every FlatList in
+      // every app.
+      if ((0, _devtoolsComponentNames.isRenderLoopUnsafeName)(compositeName)) {
         skipSubtree = true;
+      } else if ((0, _devtoolsComponentNames.isDevToolsComponentName)(compositeName)) {
+        // skip this node, keep walking its children
       } else if ((getFlags(fiber) & PerformedWork) !== 0) {
         // PerformedWork is the only trustworthy "rendered this commit"
         // signal — actualDuration is stale on bailed-out fibers.
-        recordRender(fiber);
+        recordRender(fiber, captureDetail ? nearestRenderedAncestorName(fiber) : undefined);
       }
     }
     if (!skipSubtree) {
@@ -230,14 +370,24 @@ function isCapturing() {
   return active;
 }
 
-/** Begin a capture window, discarding any previous unclaimed data. */
-function startCapture() {
+/**
+ * Begin a capture window, discarding any previous unclaimed data.
+ *
+ * `detail` turns on the allocating tier — changed prop key names and parent
+ * component names. Causes themselves are always classified: it costs a shallow
+ * prop compare, against a `computeSelfMs` that already walks every direct
+ * child on every render, and the wasted-render total is the number most worth
+ * seeing without having to know to ask for it.
+ */
+function startCapture(opts) {
   if (!ensureHookInstalled()) return;
   buckets = new Map();
   sawDurations = false;
+  captureDetail = opts?.detail === true;
   totalCommits = 0;
   totalRenders = 0;
   totalRenderMs = 0;
+  totalCauses = {};
   active = true;
 }
 
@@ -253,19 +403,31 @@ function stopCapture() {
     renders: b.renders,
     totalMs: round2(b.totalSelfMs),
     maxMs: round2(b.maxSelfMs),
-    avgMs: b.renders > 0 ? round2(b.totalSelfMs / b.renders) : 0
+    avgMs: b.renders > 0 ? round2(b.totalSelfMs / b.renders) : 0,
+    causes: b.causes,
+    ...(b.changedProps && b.changedProps.size > 0 ? {
+      changedProps: Array.from(b.changedProps)
+    } : null),
+    ...(b.parentName ? {
+      parentName: b.parentName
+    } : null)
   }));
   const summary = {
     totalCommits,
     totalRenders,
     capturedDurations: sawDurations,
     totalRenderMs: round2(totalRenderMs),
+    // Parent cascades and identity-only prop churn are both removable without
+    // changing behaviour — together they're the recoverable share.
+    wastedRenders: (totalCauses.parent ?? 0) + (totalCauses.propsUnstable ?? 0),
+    causes: totalCauses,
     topComponents
   };
   buckets = new Map();
   totalCommits = 0;
   totalRenders = 0;
   totalRenderMs = 0;
+  totalCauses = {};
   return summary;
 }
 function round2(n) {

package/lib/commonjs/highlight-updates/utils/HighlightUpdatesController.js

@@ -555,7 +555,12 @@ function isOurOverlayNode(stateNode) {
 
         // Only check other dev tools if excludeDevTools is enabled
         if (excludeDevTools) {
-          if (_devtoolsComponentNames.OTHER_DEV_TOOLS_COMPONENTS.has(name)) {
+          // Two sets, same meaning: COMPONENTS is the original list, EXACT
+          // holds the names that used to be matched by over-broad prefixes
+          // (the "Virtualized" that hid every FlatList, the "Dial" that hid
+          // every Dialog). Both paths must consult both, or Buoy's own chrome
+          // starts flashing highlight boxes in one of them and not the other.
+          if (_devtoolsComponentNames.OTHER_DEV_TOOLS_COMPONENTS.has(name) || _devtoolsComponentNames.OTHER_DEV_TOOLS_EXACT.has(name)) {
             result = true;
             break;
           }

package/lib/commonjs/highlight-updates/utils/devtoolsComponentNames.js

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.OTHER_DEV_TOOLS_PREFIXES = exports.OTHER_DEV_TOOLS_COMPONENTS = exports.HIGHLIGHT_OVERLAY_PREFIXES = exports.HIGHLIGHT_OVERLAY_COMPONENTS = void 0;
+exports.OTHER_DEV_TOOLS_PREFIXES = exports.OTHER_DEV_TOOLS_EXACT = exports.OTHER_DEV_TOOLS_COMPONENTS = exports.HIGHLIGHT_OVERLAY_PREFIXES = exports.HIGHLIGHT_OVERLAY_COMPONENTS = void 0;
 exports.isCapturingBuoyToolRenders = isCapturingBuoyToolRenders;
 exports.isDevToolsComponentName = isDevToolsComponentName;
 exports.isJsTopComponentName = isJsTopComponentName;
 exports.isPerfMonitorComponentName = isPerfMonitorComponentName;
+exports.isRenderLoopUnsafeName = isRenderLoopUnsafeName;
 exports.setCaptureBuoyToolRenders = setCaptureBuoyToolRenders;
 // ============================================================================
 // Buoy devtools component-name sets, shared by HighlightUpdatesController's
@@ -66,16 +67,37 @@ const OTHER_DEV_TOOLS_COMPONENTS = exports.OTHER_DEV_TOOLS_COMPONENTS = new Set(
 // separately). The modal/table re-render on every 250ms snapshot tick.
 "TaskTable", "TaskRow", "BusySparkline"]);
 
-// Other dev tools prefixes - can be toggled via excludeDevTools setting
-const OTHER_DEV_TOOLS_PREFIXES = exports.OTHER_DEV_TOOLS_PREFIXES = ["JsModal", "TreeDiff", "DataViewer", "DiffView", "DiffSummary", "Virtualized",
-// Floating menu prefixes
-"Floating", "Minimized", "Dial", "Expandable", "Chevron", "Glitch", "Settings", "Onboarding", "DevTools", "ImageOverlay",
+/**
+ * Other dev-tools prefixes — noise reduction, toggleable via excludeDevTools.
+ *
+ * EVERY ENTRY HERE MUST BE BUOY-NAMESPACED. These are prefix matches, and a
+ * match hides the component from render reports. Generic English words do not
+ * belong in this list, because app components share them.
+ *
+ * This list used to contain `Virtualized`, meant for Buoy's own
+ * VirtualizedDataExplorer. React Native's FlatList renders a `VirtualizedList`,
+ * so the prefix matched — and because CommitProfiler pruned the whole subtree
+ * on a match, Buoy could not see inside ANY FlatList or SectionList in ANY
+ * app. Lists are the number-one source of render problems in React Native, and
+ * the render tools were blind to all of them. `Dial` was the same trap:
+ * "Dialog".startsWith("Dial") is true, so every Dialog vanished too.
+ *
+ * Names that are generic on their own now live in OTHER_DEV_TOOLS_COMPONENTS
+ * as exact matches instead.
+ */
+const OTHER_DEV_TOOLS_PREFIXES = exports.OTHER_DEV_TOOLS_PREFIXES = ["JsModal", "ImageOverlay",
 // Perf-monitor prefixes (safe: user code is Perf*, buoy code is
 // PerfMonitor* / PerfHud*)
 "PerfMonitor", "PerfHud",
 // JS TOP (js-top package)
 "JsTop"];
 
+/**
+ * Buoy component names that were previously matched by over-broad prefixes.
+ * Exact matches only — see the warning above.
+ */
+const OTHER_DEV_TOOLS_EXACT = exports.OTHER_DEV_TOOLS_EXACT = new Set(["VirtualizedDataExplorer", "TreeDiffView", "TreeDiffRow", "DataViewer", "DiffView", "DiffSummary", "FloatingDevTools", "FloatingMenu", "FloatingBubble", "MinimizedDock", "DialMenu", "DialItem", "ExpandableSection", "ChevronIcon", "GlitchText", "SettingsModal", "SettingsRow", "OnboardingFlow", "DevToolsMenu"]);
+
 // ── Bench "profile our own tools" mode ──────────────────────────────────
 // When enabled (by a dedicated benchmark screen, e.g. the example app's
 // /tool-bench page), render capture INCLUDES Buoy's tool UI so we can
@@ -140,8 +162,27 @@ function isDevToolsComponentName(name) {
     return isPerfMonitorComponentName(name) || isJsTopComponentName(name);
   }
   if (OTHER_DEV_TOOLS_COMPONENTS.has(name)) return true;
+  if (OTHER_DEV_TOOLS_EXACT.has(name)) return true;
   for (let i = 0; i < OTHER_DEV_TOOLS_PREFIXES.length; i++) {
     if (name.startsWith(OTHER_DEV_TOOLS_PREFIXES[i])) return true;
   }
   return false;
+}
+
+/**
+ * Is this name one whose SUBTREE must be skipped, not merely the node?
+ *
+ * Only the always-excluded group qualifies: walking Buoy's own render-tracking
+ * UI feeds its own renders back in and loops. Everything else in
+ * `isDevToolsComponentName` is noise reduction — hide the row, but keep
+ * walking, because app components live underneath Buoy chrome (a tool modal
+ * renders the host app behind it) and pruning on a NAME is how one bad prefix
+ * cost us every FlatList in every app.
+ */
+function isRenderLoopUnsafeName(name) {
+  if (HIGHLIGHT_OVERLAY_COMPONENTS.has(name)) return true;
+  for (let i = 0; i < HIGHLIGHT_OVERLAY_PREFIXES.length; i++) {
+    if (name.startsWith(HIGHLIGHT_OVERLAY_PREFIXES[i])) return true;
+  }
+  return false;
 }

package/lib/commonjs/sync/highlightUpdatesSyncAdapter.js

@@ -7,6 +7,7 @@ exports.highlightUpdatesSyncAdapter = void 0;
 var _HighlightUpdatesController = _interopRequireDefault(require("../highlight-updates/utils/HighlightUpdatesController"));
 var _RenderTracker = require("../highlight-updates/utils/RenderTracker");
 var _screenElements = require("../highlight-updates/utils/screenElements");
+var _CommitProfiler = require("../highlight-updates/utils/CommitProfiler");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function ensureInitialized() {
   if (!_HighlightUpdatesController.default.isInitialized()) {
@@ -65,6 +66,41 @@ function jsonSafeRender(render) {
   }
 }
 
+/**
+ * Measurement window for automated callers (MCP `measure_renders`).
+ *
+ * Backed by CommitProfiler, NOT the RenderTracker that feeds the overlay, and
+ * the difference is the whole point. RenderTracker tracks HOST VIEWS: ask it
+ * why `DealRow` re-rendered and it answers about the native `View` inside it —
+ * "props changed: accessibilityState, accessibilityValue" — which is true and
+ * useless. CommitProfiler walks COMPOSITE fibers, so it answers about the
+ * component you named: which of ITS props changed, whether they changed by
+ * value or only by identity, and which parent dragged it along.
+ *
+ * It also touches none of the user's overlay state — no enabling, no clearing
+ * counters someone was collecting, nothing drawn on screen. A measurement is
+ * invisible.
+ */
+function beginMeasurement() {
+  if (!_CommitProfiler.CommitProfiler.isSupported()) {
+    return {
+      ok: false,
+      reason: "render capture needs a dev build with the React DevTools hook available"
+    };
+  }
+  _CommitProfiler.CommitProfiler.startCapture({
+    detail: true
+  });
+  return {
+    ok: true
+  };
+}
+function endMeasurement() {
+  return {
+    summary: _CommitProfiler.CommitProfiler.stopCapture()
+  };
+}
+
 /**
  * Sync adapter for the highlight-updates tool, consumed by
  * @buoy-gg/external-sync's `useExternalSync` (structurally matches its
@@ -81,7 +117,9 @@ function jsonSafeRender(render) {
  * stay on the device. Dashboards fetch them via `getRenderDetail`.
  */
 const highlightUpdatesSyncAdapter = exports.highlightUpdatesSyncAdapter = {
-  version: 2,
+  // v3: beginMeasurement / endMeasurement — a CommitProfiler capture window
+  // for automated callers, with per-component causes. Invisible to the user.
+  version: 3,
   getSnapshot: () => ({
     enabled: _HighlightUpdatesController.default.isEnabled(),
     frozen: _HighlightUpdatesController.default.getFrozen(),
@@ -103,6 +141,10 @@ const highlightUpdatesSyncAdapter = exports.highlightUpdatesSyncAdapter = {
     };
   },
   actions: {
+    // Capture window for automated callers (MCP `measure_renders`). Pairs:
+    // begin -> drive the UI -> end. `end` always restores.
+    beginMeasurement: () => beginMeasurement(),
+    endMeasurement: () => endMeasurement(),
     /**
      * On-demand detail: one component's real renderHistory + lastRenderCause
      * (including hookChanges). Wire-form snapshots omit those.

package/lib/module/highlight-updates/utils/CommitProfiler.js

@@ -18,7 +18,7 @@
  * registry (see the registration in this package's index.tsx).
  */
 
-import { isDevToolsComponentName } from "./devtoolsComponentNames";
+import { isDevToolsComponentName, isRenderLoopUnsafeName } from "./devtoolsComponentNames";
 
 // React work tags for components that render user code.
 const FunctionComponent = 0;
@@ -42,9 +42,11 @@ const TOP_COMPONENTS_CAP = 20;
 let hookInstalled = false;
 let active = false;
 let sawDurations = false;
+let captureDetail = false;
 let totalCommits = 0;
 let totalRenders = 0;
 let totalRenderMs = 0;
+let totalCauses = {};
 let buckets = new Map();
 function getHook() {
   if (typeof global === "undefined") return null;
@@ -116,13 +118,129 @@ function isFrameworkWrapperName(name) {
   }
   return false;
 }
-function recordRender(fiber) {
+
+/** Bound on prop keys compared per render, so a fat props object can't stall a commit. */
+const MAX_PROPS_COMPARED = 40;
+/** Bound on distinct changed-prop key names remembered per component (detail tier). */
+const MAX_CHANGED_KEYS = 5;
+
+/**
+ * Are two values for the same prop key equivalent despite differing identity?
+ *
+ * Functions always count as equivalent: a fresh arrow per render is THE
+ * unstable-prop bug, and there's no way to compare behaviour anyway. Plain
+ * objects and arrays compare one level deep, which catches `style={{...}}`
+ * and `data={[...]}`. Anything else falls through to a real value change.
+ */
+function isEquivalentValue(a, b) {
+  if (Object.is(a, b)) return true;
+  const ta = typeof a;
+  if (ta !== typeof b) return false;
+  if (ta === "function") return true;
+  if (a === null || b === null || ta !== "object") return false;
+  const aIsArray = Array.isArray(a);
+  if (aIsArray !== Array.isArray(b)) return false;
+  if (aIsArray) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) if (!Object.is(a[i], b[i])) return false;
+    return true;
+  }
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (let i = 0; i < keysA.length; i++) {
+    const k = keysA[i];
+    if (!Object.prototype.hasOwnProperty.call(b, k)) return false;
+    if (!Object.is(a[k], b[k])) return false;
+  }
+  return true;
+}
+/**
+ * Why did this fiber render?
+ *
+ * Simpler than the overlay's RenderCauseDetector, and deliberately so: that
+ * one carries WeakMap fallbacks and fiber-swap detection because traceUpdates
+ * hands it fibers at an ambiguous moment. Here we're inside onCommitFiberRoot
+ * walking the committed tree, so `fiber` is current and `fiber.alternate` is
+ * previous by definition. Porting the swap logic would be cargo-cult.
+ */
+function detectCause(fiber, wantKeys) {
+  const prev = fiber.alternate;
+  if (!prev) return {
+    cause: "mount"
+  };
+  const nextProps = fiber.memoizedProps;
+  const prevProps = prev.memoizedProps;
+  if (nextProps !== prevProps && nextProps && prevProps) {
+    let sawChange = false;
+    let sawValueChange = false;
+    let changedKeys;
+    const keys = Object.keys(nextProps);
+    const limit = keys.length < MAX_PROPS_COMPARED ? keys.length : MAX_PROPS_COMPARED;
+    for (let i = 0; i < limit; i++) {
+      const k = keys[i];
+      const a = prevProps[k];
+      const b = nextProps[k];
+      if (Object.is(a, b)) continue;
+      sawChange = true;
+      if (wantKeys) {
+        if (!changedKeys) changedKeys = [];
+        if (changedKeys.length < MAX_CHANGED_KEYS) changedKeys.push(k);
+      }
+      if (!isEquivalentValue(a, b)) {
+        sawValueChange = true;
+        if (!wantKeys) break; // cause is settled; only keys need the full pass
+      }
+    }
+    // A removed key counts as a real change; cheap to detect via key count.
+    if (!sawValueChange && Object.keys(prevProps).length !== keys.length) {
+      sawChange = true;
+      sawValueChange = true;
+    }
+    if (sawChange) {
+      return {
+        cause: sawValueChange ? "props" : "propsUnstable",
+        changedKeys
+      };
+    }
+  }
+
+  // No prop change of substance. Own state/hooks next.
+  if (prev.memoizedState !== fiber.memoizedState) return {
+    cause: "hooks"
+  };
+  return {
+    cause: "parent"
+  };
+}
+
+/**
+ * Nearest ancestor that ALSO rendered this commit and is worth naming — i.e.
+ * skipping framework wrappers, which are never where a fix goes. Answers "who
+ * dragged this along", which is the actionable half of a cascade.
+ */
+function nearestRenderedAncestorName(fiber) {
+  for (let p = fiber.return; p != null; p = p.return) {
+    if (!isCompositeTag(p.tag)) continue;
+    if ((getFlags(p) & PerformedWork) === 0) continue;
+    const name = getComponentName(p);
+    if (isFrameworkWrapperName(name)) continue;
+    return name;
+  }
+  return undefined;
+}
+function recordRender(fiber, parentName) {
   const name = getComponentName(fiber);
   const selfMs = computeSelfMs(fiber);
   if (selfMs !== null) sawDurations = true;
   const ms = selfMs ?? 0;
   totalRenders += 1;
   totalRenderMs += ms;
+  const {
+    cause,
+    changedKeys
+  } = detectCause(fiber, captureDetail);
+  totalCauses[cause] = (totalCauses[cause] ?? 0) + 1;
 
   // Framework wrappers count toward totals but never surface as a row.
   if (isFrameworkWrapperName(name)) return;
@@ -133,13 +251,27 @@ function recordRender(fiber) {
     bucket = {
       renders: 0,
       totalSelfMs: 0,
-      maxSelfMs: 0
+      maxSelfMs: 0,
+      causes: {}
     };
     buckets.set(name, bucket);
   }
   bucket.renders += 1;
   bucket.totalSelfMs += ms;
   if (ms > bucket.maxSelfMs) bucket.maxSelfMs = ms;
+  bucket.causes[cause] = (bucket.causes[cause] ?? 0) + 1;
+  if (captureDetail) {
+    if (changedKeys) {
+      if (!bucket.changedProps) bucket.changedProps = new Set();
+      for (let i = 0; i < changedKeys.length; i++) {
+        if (bucket.changedProps.size >= MAX_CHANGED_KEYS) break;
+        bucket.changedProps.add(changedKeys[i]);
+      }
+    }
+    // First parent wins — a component rendered under several parents is rare,
+    // and the first is the one that showed up in the heaviest commit.
+    if (parentName && !bucket.parentName) bucket.parentName = parentName;
+  }
 }
 
 /**
@@ -158,13 +290,21 @@ function handleCommit(root) {
     let skipSubtree = false;
     const composite = isCompositeTag(fiber.tag);
     if (composite) {
-      // Prune Buoy's own devtools UI wholesale.
-      if (isDevToolsComponentName(getComponentName(fiber))) {
+      const compositeName = getComponentName(fiber);
+      // Only Buoy's render-tracking UI gets its SUBTREE pruned — walking it
+      // feeds its own renders back in and loops. Everything else that's merely
+      // devtools noise is skipped as a NODE and we keep descending: app
+      // components live underneath Buoy chrome, and pruning a subtree on a name
+      // match is what made a stray "Virtualized" prefix hide every FlatList in
+      // every app.
+      if (isRenderLoopUnsafeName(compositeName)) {
         skipSubtree = true;
+      } else if (isDevToolsComponentName(compositeName)) {
+        // skip this node, keep walking its children
       } else if ((getFlags(fiber) & PerformedWork) !== 0) {
         // PerformedWork is the only trustworthy "rendered this commit"
         // signal — actualDuration is stale on bailed-out fibers.
-        recordRender(fiber);
+        recordRender(fiber, captureDetail ? nearestRenderedAncestorName(fiber) : undefined);
       }
     }
     if (!skipSubtree) {
@@ -227,14 +367,24 @@ function isCapturing() {
   return active;
 }
 
-/** Begin a capture window, discarding any previous unclaimed data. */
-function startCapture() {
+/**
+ * Begin a capture window, discarding any previous unclaimed data.
+ *
+ * `detail` turns on the allocating tier — changed prop key names and parent
+ * component names. Causes themselves are always classified: it costs a shallow
+ * prop compare, against a `computeSelfMs` that already walks every direct
+ * child on every render, and the wasted-render total is the number most worth
+ * seeing without having to know to ask for it.
+ */
+function startCapture(opts) {
   if (!ensureHookInstalled()) return;
   buckets = new Map();
   sawDurations = false;
+  captureDetail = opts?.detail === true;
   totalCommits = 0;
   totalRenders = 0;
   totalRenderMs = 0;
+  totalCauses = {};
   active = true;
 }
 
@@ -250,19 +400,31 @@ function stopCapture() {
     renders: b.renders,
     totalMs: round2(b.totalSelfMs),
     maxMs: round2(b.maxSelfMs),
-    avgMs: b.renders > 0 ? round2(b.totalSelfMs / b.renders) : 0
+    avgMs: b.renders > 0 ? round2(b.totalSelfMs / b.renders) : 0,
+    causes: b.causes,
+    ...(b.changedProps && b.changedProps.size > 0 ? {
+      changedProps: Array.from(b.changedProps)
+    } : null),
+    ...(b.parentName ? {
+      parentName: b.parentName
+    } : null)
   }));
   const summary = {
     totalCommits,
     totalRenders,
     capturedDurations: sawDurations,
     totalRenderMs: round2(totalRenderMs),
+    // Parent cascades and identity-only prop churn are both removable without
+    // changing behaviour — together they're the recoverable share.
+    wastedRenders: (totalCauses.parent ?? 0) + (totalCauses.propsUnstable ?? 0),
+    causes: totalCauses,
     topComponents
   };
   buckets = new Map();
   totalCommits = 0;
   totalRenders = 0;
   totalRenderMs = 0;
+  totalCauses = {};
   return summary;
 }
 function round2(n) {

package/lib/module/highlight-updates/utils/HighlightUpdatesController.js

@@ -33,7 +33,7 @@ import { RenderTracker } from "./RenderTracker";
 import { PerformanceLogger, markEventReceived } from "./PerformanceLogger";
 import { detectRenderCause, clearRenderCauseState } from "./RenderCauseDetector";
 import { notifySubscriberCountChange } from "@buoy-gg/shared-ui";
-import { HIGHLIGHT_OVERLAY_COMPONENTS, HIGHLIGHT_OVERLAY_PREFIXES, OTHER_DEV_TOOLS_COMPONENTS, OTHER_DEV_TOOLS_PREFIXES, isCapturingBuoyToolRenders, isPerfMonitorComponentName } from "./devtoolsComponentNames";
+import { HIGHLIGHT_OVERLAY_COMPONENTS, HIGHLIGHT_OVERLAY_PREFIXES, OTHER_DEV_TOOLS_COMPONENTS, OTHER_DEV_TOOLS_EXACT, OTHER_DEV_TOOLS_PREFIXES, isCapturingBuoyToolRenders, isPerfMonitorComponentName } from "./devtoolsComponentNames";
 // State
 let globalEnabled = false; // User-controlled toggle for visual highlights
 // When true, tracking + measurement + storage all run as normal, but the
@@ -551,7 +551,12 @@ function isOurOverlayNode(stateNode) {
 
         // Only check other dev tools if excludeDevTools is enabled
         if (excludeDevTools) {
-          if (OTHER_DEV_TOOLS_COMPONENTS.has(name)) {
+          // Two sets, same meaning: COMPONENTS is the original list, EXACT
+          // holds the names that used to be matched by over-broad prefixes
+          // (the "Virtualized" that hid every FlatList, the "Dial" that hid
+          // every Dialog). Both paths must consult both, or Buoy's own chrome
+          // starts flashing highlight boxes in one of them and not the other.
+          if (OTHER_DEV_TOOLS_COMPONENTS.has(name) || OTHER_DEV_TOOLS_EXACT.has(name)) {
             result = true;
             break;
           }

package/lib/module/highlight-updates/utils/devtoolsComponentNames.js

@@ -57,16 +57,37 @@ export const OTHER_DEV_TOOLS_COMPONENTS = new Set([
 // separately). The modal/table re-render on every 250ms snapshot tick.
 "TaskTable", "TaskRow", "BusySparkline"]);
 
-// Other dev tools prefixes - can be toggled via excludeDevTools setting
-export const OTHER_DEV_TOOLS_PREFIXES = ["JsModal", "TreeDiff", "DataViewer", "DiffView", "DiffSummary", "Virtualized",
-// Floating menu prefixes
-"Floating", "Minimized", "Dial", "Expandable", "Chevron", "Glitch", "Settings", "Onboarding", "DevTools", "ImageOverlay",
+/**
+ * Other dev-tools prefixes — noise reduction, toggleable via excludeDevTools.
+ *
+ * EVERY ENTRY HERE MUST BE BUOY-NAMESPACED. These are prefix matches, and a
+ * match hides the component from render reports. Generic English words do not
+ * belong in this list, because app components share them.
+ *
+ * This list used to contain `Virtualized`, meant for Buoy's own
+ * VirtualizedDataExplorer. React Native's FlatList renders a `VirtualizedList`,
+ * so the prefix matched — and because CommitProfiler pruned the whole subtree
+ * on a match, Buoy could not see inside ANY FlatList or SectionList in ANY
+ * app. Lists are the number-one source of render problems in React Native, and
+ * the render tools were blind to all of them. `Dial` was the same trap:
+ * "Dialog".startsWith("Dial") is true, so every Dialog vanished too.
+ *
+ * Names that are generic on their own now live in OTHER_DEV_TOOLS_COMPONENTS
+ * as exact matches instead.
+ */
+export const OTHER_DEV_TOOLS_PREFIXES = ["JsModal", "ImageOverlay",
 // Perf-monitor prefixes (safe: user code is Perf*, buoy code is
 // PerfMonitor* / PerfHud*)
 "PerfMonitor", "PerfHud",
 // JS TOP (js-top package)
 "JsTop"];
 
+/**
+ * Buoy component names that were previously matched by over-broad prefixes.
+ * Exact matches only — see the warning above.
+ */
+export const OTHER_DEV_TOOLS_EXACT = new Set(["VirtualizedDataExplorer", "TreeDiffView", "TreeDiffRow", "DataViewer", "DiffView", "DiffSummary", "FloatingDevTools", "FloatingMenu", "FloatingBubble", "MinimizedDock", "DialMenu", "DialItem", "ExpandableSection", "ChevronIcon", "GlitchText", "SettingsModal", "SettingsRow", "OnboardingFlow", "DevToolsMenu"]);
+
 // ── Bench "profile our own tools" mode ──────────────────────────────────
 // When enabled (by a dedicated benchmark screen, e.g. the example app's
 // /tool-bench page), render capture INCLUDES Buoy's tool UI so we can
@@ -131,8 +152,27 @@ export function isDevToolsComponentName(name) {
     return isPerfMonitorComponentName(name) || isJsTopComponentName(name);
   }
   if (OTHER_DEV_TOOLS_COMPONENTS.has(name)) return true;
+  if (OTHER_DEV_TOOLS_EXACT.has(name)) return true;
   for (let i = 0; i < OTHER_DEV_TOOLS_PREFIXES.length; i++) {
     if (name.startsWith(OTHER_DEV_TOOLS_PREFIXES[i])) return true;
   }
   return false;
+}
+
+/**
+ * Is this name one whose SUBTREE must be skipped, not merely the node?
+ *
+ * Only the always-excluded group qualifies: walking Buoy's own render-tracking
+ * UI feeds its own renders back in and loops. Everything else in
+ * `isDevToolsComponentName` is noise reduction — hide the row, but keep
+ * walking, because app components live underneath Buoy chrome (a tool modal
+ * renders the host app behind it) and pruning on a NAME is how one bad prefix
+ * cost us every FlatList in every app.
+ */
+export function isRenderLoopUnsafeName(name) {
+  if (HIGHLIGHT_OVERLAY_COMPONENTS.has(name)) return true;
+  for (let i = 0; i < HIGHLIGHT_OVERLAY_PREFIXES.length; i++) {
+    if (name.startsWith(HIGHLIGHT_OVERLAY_PREFIXES[i])) return true;
+  }
+  return false;
 }

package/lib/module/sync/highlightUpdatesSyncAdapter.js

@@ -3,6 +3,7 @@
 import HighlightUpdatesController from "../highlight-updates/utils/HighlightUpdatesController";
 import { RenderTracker } from "../highlight-updates/utils/RenderTracker";
 import { describeScreen, tapElement } from "../highlight-updates/utils/screenElements";
+import { CommitProfiler } from "../highlight-updates/utils/CommitProfiler";
 function ensureInitialized() {
   if (!HighlightUpdatesController.isInitialized()) {
     HighlightUpdatesController.initialize();
@@ -60,6 +61,41 @@ function jsonSafeRender(render) {
   }
 }
 
+/**
+ * Measurement window for automated callers (MCP `measure_renders`).
+ *
+ * Backed by CommitProfiler, NOT the RenderTracker that feeds the overlay, and
+ * the difference is the whole point. RenderTracker tracks HOST VIEWS: ask it
+ * why `DealRow` re-rendered and it answers about the native `View` inside it —
+ * "props changed: accessibilityState, accessibilityValue" — which is true and
+ * useless. CommitProfiler walks COMPOSITE fibers, so it answers about the
+ * component you named: which of ITS props changed, whether they changed by
+ * value or only by identity, and which parent dragged it along.
+ *
+ * It also touches none of the user's overlay state — no enabling, no clearing
+ * counters someone was collecting, nothing drawn on screen. A measurement is
+ * invisible.
+ */
+function beginMeasurement() {
+  if (!CommitProfiler.isSupported()) {
+    return {
+      ok: false,
+      reason: "render capture needs a dev build with the React DevTools hook available"
+    };
+  }
+  CommitProfiler.startCapture({
+    detail: true
+  });
+  return {
+    ok: true
+  };
+}
+function endMeasurement() {
+  return {
+    summary: CommitProfiler.stopCapture()
+  };
+}
+
 /**
  * Sync adapter for the highlight-updates tool, consumed by
  * @buoy-gg/external-sync's `useExternalSync` (structurally matches its
@@ -76,7 +112,9 @@ function jsonSafeRender(render) {
  * stay on the device. Dashboards fetch them via `getRenderDetail`.
  */
 export const highlightUpdatesSyncAdapter = {
-  version: 2,
+  // v3: beginMeasurement / endMeasurement — a CommitProfiler capture window
+  // for automated callers, with per-component causes. Invisible to the user.
+  version: 3,
   getSnapshot: () => ({
     enabled: HighlightUpdatesController.isEnabled(),
     frozen: HighlightUpdatesController.getFrozen(),
@@ -98,6 +136,10 @@ export const highlightUpdatesSyncAdapter = {
     };
   },
   actions: {
+    // Capture window for automated callers (MCP `measure_renders`). Pairs:
+    // begin -> drive the UI -> end. `end` always restores.
+    beginMeasurement: () => beginMeasurement(),
+    endMeasurement: () => endMeasurement(),
     /**
      * On-demand detail: one component's real renderHistory + lastRenderCause
      * (including hookChanges). Wire-form snapshots omit those.

package/lib/typescript/highlight-updates/utils/CommitProfiler.d.ts

@@ -18,8 +18,18 @@
 import type { RenderCaptureSummary } from "@buoy-gg/shared-ui";
 declare function isSupported(): boolean;
 declare function isCapturing(): boolean;
-/** Begin a capture window, discarding any previous unclaimed data. */
-declare function startCapture(): void;
+/**
+ * Begin a capture window, discarding any previous unclaimed data.
+ *
+ * `detail` turns on the allocating tier — changed prop key names and parent
+ * component names. Causes themselves are always classified: it costs a shallow
+ * prop compare, against a `computeSelfMs` that already walks every direct
+ * child on every render, and the wasted-render total is the number most worth
+ * seeing without having to know to ask for it.
+ */
+declare function startCapture(opts?: {
+    detail?: boolean;
+}): void;
 /** End the window and return the aggregate (null if never started). */
 declare function stopCapture(): RenderCaptureSummary | null;
 export declare const CommitProfiler: {

package/lib/typescript/highlight-updates/utils/CommitProfiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommitProfiler.d.ts","sourceRoot":"","sources":["../../../../src/highlight-updates/utils/CommitProfiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,oBAAoB,CAAC;AA6Q5B,iBAAS,WAAW,IAAI,OAAO,CAI9B;AAED,iBAAS,WAAW,IAAI,OAAO,CAE9B;AAED,sEAAsE;AACtE,iBAAS,YAAY,IAAI,IAAI,CAQ5B;AAED,uEAAuE;AACvE,iBAAS,WAAW,IAAI,oBAAoB,GAAG,IAAI,CAkClD;AAMD,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC"}
+{"version":3,"file":"CommitProfiler.d.ts","sourceRoot":"","sources":["../../../../src/highlight-updates/utils/CommitProfiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,oBAAoB,CAAC;AA4a5B,iBAAS,WAAW,IAAI,OAAO,CAI9B;AAED,iBAAS,WAAW,IAAI,OAAO,CAE9B;AAED;;;;;;;;GAQG;AACH,iBAAS,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAUvD;AAED,uEAAuE;AACvE,iBAAS,WAAW,IAAI,oBAAoB,GAAG,IAAI,CA4ClD;AAMD,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC"}

package/lib/typescript/highlight-updates/utils/HighlightUpdatesController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HighlightUpdatesController.d.ts","sourceRoot":"","sources":["../../../../src/highlight-updates/utils/HighlightUpdatesController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HighlightUpdatesController.d.ts","sourceRoot":"","sources":["../../../../src/highlight-updates/utils/HighlightUpdatesController.ts"],"names":[],"mappings":"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"}

package/lib/typescript/highlight-updates/utils/devtoolsComponentNames.d.ts

@@ -1,7 +1,30 @@
 export declare const HIGHLIGHT_OVERLAY_COMPONENTS: Set<string>;
 export declare const HIGHLIGHT_OVERLAY_PREFIXES: string[];
 export declare const OTHER_DEV_TOOLS_COMPONENTS: Set<string>;
+/**
+ * Other dev-tools prefixes — noise reduction, toggleable via excludeDevTools.
+ *
+ * EVERY ENTRY HERE MUST BE BUOY-NAMESPACED. These are prefix matches, and a
+ * match hides the component from render reports. Generic English words do not
+ * belong in this list, because app components share them.
+ *
+ * This list used to contain `Virtualized`, meant for Buoy's own
+ * VirtualizedDataExplorer. React Native's FlatList renders a `VirtualizedList`,
+ * so the prefix matched — and because CommitProfiler pruned the whole subtree
+ * on a match, Buoy could not see inside ANY FlatList or SectionList in ANY
+ * app. Lists are the number-one source of render problems in React Native, and
+ * the render tools were blind to all of them. `Dial` was the same trap:
+ * "Dialog".startsWith("Dial") is true, so every Dialog vanished too.
+ *
+ * Names that are generic on their own now live in OTHER_DEV_TOOLS_COMPONENTS
+ * as exact matches instead.
+ */
 export declare const OTHER_DEV_TOOLS_PREFIXES: string[];
+/**
+ * Buoy component names that were previously matched by over-broad prefixes.
+ * Exact matches only — see the warning above.
+ */
+export declare const OTHER_DEV_TOOLS_EXACT: Set<string>;
 export declare function setCaptureBuoyToolRenders(enabled: boolean): void;
 export declare function isCapturingBuoyToolRenders(): boolean;
 /**
@@ -22,4 +45,15 @@ export declare function isJsTopComponentName(name: string): boolean;
  * RN's LogBox). Sets are checked first (O(1)), then prefixes.
  */
 export declare function isDevToolsComponentName(name: string): boolean;
+/**
+ * Is this name one whose SUBTREE must be skipped, not merely the node?
+ *
+ * Only the always-excluded group qualifies: walking Buoy's own render-tracking
+ * UI feeds its own renders back in and loops. Everything else in
+ * `isDevToolsComponentName` is noise reduction — hide the row, but keep
+ * walking, because app components live underneath Buoy chrome (a tool modal
+ * renders the host app behind it) and pruning on a NAME is how one bad prefix
+ * cost us every FlatList in every app.
+ */
+export declare function isRenderLoopUnsafeName(name: string): boolean;
 //# sourceMappingURL=devtoolsComponentNames.d.ts.map

package/lib/typescript/highlight-updates/utils/devtoolsComponentNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devtoolsComponentNames.d.ts","sourceRoot":"","sources":["../../../../src/highlight-updates/utils/devtoolsComponentNames.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,4BAA4B,aA4BvC,CAAC;AAGH,eAAO,MAAM,0BAA0B,UAWtC,CAAC;AAGF,eAAO,MAAM,0BAA0B,aAwIrC,CAAC;AAGH,eAAO,MAAM,wBAAwB,UAwBpC,CAAC;AAcF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEhE;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AA8BD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE;AAUD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiB7D"}
+{"version":3,"file":"devtoolsComponentNames.d.ts","sourceRoot":"","sources":["../../../../src/highlight-updates/utils/devtoolsComponentNames.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,4BAA4B,aA4BvC,CAAC;AAGH,eAAO,MAAM,0BAA0B,UAWtC,CAAC;AAGF,eAAO,MAAM,0BAA0B,aAwIrC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,UASpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAoBhC,CAAC;AAcH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEhE;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AA8BD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE;AAUD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkB7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM5D"}

package/lib/typescript/sync/highlightUpdatesSyncAdapter.d.ts

@@ -1,4 +1,5 @@
 import type { TrackedRender } from "../highlight-updates/utils/RenderTracker";
+import type { RenderCaptureSummary } from "@buoy-gg/shared-ui";
 /**
  * Sync adapter for the highlight-updates tool, consumed by
  * @buoy-gg/external-sync's `useExternalSync` (structurally matches its
@@ -28,6 +29,13 @@ export declare const highlightUpdatesSyncAdapter: {
     };
     subscribe: (onChange: () => void) => () => void;
     actions: {
+        beginMeasurement: () => {
+            ok: boolean;
+            reason?: string;
+        };
+        endMeasurement: () => {
+            summary: RenderCaptureSummary | null;
+        };
         /**
          * On-demand detail: one component's real renderHistory + lastRenderCause
          * (including hookChanges). Wire-form snapshots omit those.

package/lib/typescript/sync/highlightUpdatesSyncAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"highlightUpdatesSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/highlightUpdatesSyncAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,0CAA0C,CAAC;AAkElD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;0BAUhB,MAAM,IAAI;;QAc9B;;;WAGG;mCACwB,OAAO;;;;;;;;;;;;8BAcZ,OAAO;;;gCAYL,OAAO;mCASJ,OAAO;qCAQL,OAAO;;8BAad,OAAO;;CAEhC,CAAC"}
+{"version":3,"file":"highlightUpdatesSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/highlightUpdatesSyncAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,0CAA0C,CAAC;AAOlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AA4F/D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;0BAYhB,MAAM,IAAI;;;gBA3CC,OAAO;qBAAW,MAAM;;;qBAYrB,oBAAoB,GAAG,IAAI;;QAiD7D;;;WAGG;mCACwB,OAAO;;;;;;;;;;;;8BAcZ,OAAO;;;gCAYL,OAAO;mCASJ,OAAO;qCAQL,OAAO;;8BAad,OAAO;;CAEhC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/highlight-updates",
-  "version": "7.0.21",
+  "version": "7.0.22",
   "description": "Render highlighter for React Native — see every render with its cause: mount, state, props, or parent. Part of Buoy devtools.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -26,14 +26,14 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.21",
-    "@buoy-gg/floating-tools-core": "^7.0.21"
+    "@buoy-gg/shared-ui": "^7.0.22",
+    "@buoy-gg/floating-tools-core": "^7.0.22"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "7.0.21",
+    "@buoy-gg/license": "7.0.22",
     "react": "*",
     "react-native": "*",
-    "@buoy-gg/core": "^7.0.21"
+    "@buoy-gg/core": "^7.0.22"
   },
   "peerDependenciesMeta": {
     "@buoy-gg/core": {
@@ -44,8 +44,8 @@
     "@types/react": "^19.1.0",
     "@types/react-native": "^0.73.0",
     "typescript": "~5.8.3",
-    "@buoy-gg/core": "^7.0.21",
-    "@buoy-gg/license": "^7.0.21"
+    "@buoy-gg/core": "^7.0.22",
+    "@buoy-gg/license": "^7.0.22"
   },
   "react-native-builder-bob": {
     "source": "src",