@buoy-gg/highlight-updates 2.1.9 → 2.1.11

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

@@ -1 +1,1431 @@
-"use strict";import{installProfilerInterceptor,uninstallProfilerInterceptor,setComparisonCallback}from"./ProfilerInterceptor";import{RenderTracker}from"./RenderTracker";import{PerformanceLogger,markEventReceived}from"./PerformanceLogger";import{detectRenderCause,clearRenderCauseState}from"./RenderCauseDetector";import{notifySubscriberCountChange}from"@buoy-gg/shared-ui";let globalEnabled=!1,backgroundTrackingEnabled=!1,initialized=!1,hook=null,highlightCallback=null,badgePressCallback=null,traceUpdatesUnsubscribe=null,isProcessing=!1,isFrozen=!1;const freezeListeners=new Set,stateListeners=new Set,nodeRenderCounts=new Map,COLORS=["#37afa9","#63b19e","#80b393","#97b488","#abb67d","#beb771","#cfb965","#dfba57","#efbb49","#febc38"],DEBUG=!1;function debugLog(e,n){}function getPublicInstance(e){if(!e)return null;const n=e;return n.canonical?.publicInstance?n.canonical.publicInstance:n.canonical&&"function"==typeof n.canonical.measure?n.canonical:"function"==typeof n.measure?n:null}function getNativeTag(e){if(null==e)return null;const n=e;if(null!=n.__nativeTag)return n.__nativeTag;if(null!=n._nativeTag)return n._nativeTag;if(null!=n.nativeTag)return n.nativeTag;if(n.canonical){if(null!=n.canonical.__nativeTag)return n.canonical.__nativeTag;if(null!=n.canonical._nativeTag)return n.canonical._nativeTag}return null}function extractComponentInfo(e){const n=e,t={viewType:"Unknown"};n?.canonical?.viewConfig?.uiViewClassName?t.viewType=n.canonical.viewConfig.uiViewClassName:n?.viewConfig?.uiViewClassName&&(t.viewType=n.viewConfig.uiViewClassName);const i=n?.canonical?.internalInstanceHandle||n?._internalInstanceHandle||n?._internalFiberInstanceHandleDEV,a=n?.canonical?.currentProps,r=n?.canonical?.pendingProps,o=i?.pendingProps,s=i?.memoizedProps;return t.testID=a?.testID||r?.testID||o?.testID||s?.testID||void 0,t.nativeID=a?.nativeID||r?.nativeID||o?.nativeID||s?.nativeID||void 0,t.accessibilityLabel=a?.accessibilityLabel||r?.accessibilityLabel||o?.accessibilityLabel||s?.accessibilityLabel||void 0,t.componentName=getOwningComponentName(i)||void 0,t}function describeNodeForLog(e){const n=e,t=getPublicInstance(e),i={nativeTag:(getNativeTag(e)||getNativeTag(t))??"unknown",type:n?.canonical?"Fabric":"Legacy",hasMeasure:"function"==typeof t?.measure};if(n){if(i.stateNodeKeys=Object.keys(n).slice(0,20),n.node&&(i.nodeKeys=Object.keys(n.node).slice(0,20)),n.viewConfig&&(i.viewConfig={uiViewClassName:n.viewConfig.uiViewClassName,validAttributes:n.viewConfig.validAttributes?Object.keys(n.viewConfig.validAttributes).slice(0,10):void 0}),n.canonical){const e=n.canonical;if(i.canonicalKeys=Object.keys(e).slice(0,20),e.viewConfig&&(i.canonicalViewConfig={uiViewClassName:e.viewConfig.uiViewClassName}),null!=e.nativeTag&&(i.canonicalNativeTag=e.nativeTag),e.internalInstanceHandle){const n=e.internalInstanceHandle;if(i.fiberKeys=Object.keys(n).slice(0,30),n.type&&(i.fiberType="function"==typeof n.type?n.type.name||n.type.displayName||"function":n.type),n.elementType&&(i.fiberElementType="function"==typeof n.elementType?n.elementType.name||n.elementType.displayName||"function":n.elementType),n._debugOwner){const e=n._debugOwner;i.fiberDebugOwner=e.type?.name||e.type?.displayName||e.elementType?.name||"unknown"}n._debugSource&&(i.fiberDebugSource=n._debugSource),null!=n.tag&&(i.fiberTag=n.tag),n.pendingProps&&(n.pendingProps.nativeID&&(i.fiberPendingNativeID=n.pendingProps.nativeID),n.pendingProps.testID&&(i.fiberPendingTestID=n.pendingProps.testID)),n.memoizedProps&&(n.memoizedProps.nativeID&&(i.fiberMemoizedNativeID=n.memoizedProps.nativeID),n.memoizedProps.testID&&(i.fiberMemoizedTestID=n.memoizedProps.testID))}if(e.publicInstance){const n=e.publicInstance;i.publicInstanceKeys=Object.keys(n).slice(0,20),null!=n.nativeID&&(i.nativeID=n.nativeID),null!=n._nativeID&&(i._nativeID=n._nativeID),n.props&&(i.publicInstanceProps=Object.keys(n.props).slice(0,15),n.props.nativeID&&(i.propsNativeID=n.props.nativeID),n.props.testID&&(i.propsTestID=n.props.testID),n.props.accessibilityLabel&&(i.accessibilityLabel=n.props.accessibilityLabel))}e.currentProps&&(i.currentPropsKeys=Object.keys(e.currentProps).slice(0,15),null!=e.currentProps.nativeID&&(i.currentPropsNativeID=e.currentProps.nativeID),null!=e.currentProps.testID&&(i.currentPropsTestID=e.currentProps.testID),null!=e.currentProps.accessibilityLabel&&(i.currentPropsAccessLabel=e.currentProps.accessibilityLabel)),e.pendingProps&&(i.pendingPropsKeys=Object.keys(e.pendingProps).slice(0,15),null!=e.pendingProps.nativeID&&(i.pendingPropsNativeID=e.pendingProps.nativeID),null!=e.pendingProps.testID&&(i.pendingPropsTestID=e.pendingProps.testID))}if(n._debugOwner){const e=n._debugOwner;i.debugOwnerType=e.type?.name||e.type?.displayName||typeof e.type}n._debugSource&&(i.debugSource=n._debugSource)}return i}const DEBUG_LOGGING=!1;let renderingLock=!1,renderingLockTimeout=null;const RENDER_LOCK_DURATION=350,renderedOverlayTags=new Set;function isOurOverlayTag(e){return null!=e&&renderedOverlayTags.has(e)}const HIGHLIGHT_OVERLAY_COMPONENTS=new Set(["HighlightUpdatesOverlay","HighlightUpdatesModal","HighlightFilterView","RenderDetailView","RenderListItem","RenderListItemInner","RenderHistoryViewer","RenderHistoryFooter","RenderCauseBadge","TwoLevelCauseBadge","EnhancedCauseDisplay","IsolatedRenderList","IsolatedRenderListInner","StatsDisplay","StatsDisplayInner","CurrentStateView","EventStepperFooter","EventsModal","UnifiedEventList","UnifiedEventItem","UnifiedEventDetail","UnifiedEventFilters","UnifiedEventViewer","ReactQueryEventDetail","EventsCopySettingsView"]),HIGHLIGHT_OVERLAY_NATIVE_IDS=new Set(["highlight-updates-overlay","__rn_buoy__highlight-modal"]),HIGHLIGHT_OVERLAY_PREFIXES=["HighlightUpdates","RenderList","RenderDetail","RenderHistory","RenderCause","EventStepper","UnifiedEvent","EventsModal","EventsCopy"],OTHER_DEV_TOOLS_COMPONENTS=new Set(["JsModalComponent","JsModal","TypePicker","PatternInput","PatternChip","DetectedItemsSection","DetectedCategoryBadge","IdentifierBadge","CategoryBadge","AppRenderer","AppOverlay","FloatingTools","DialDevTools","DevToolsVisibilityProvider","AppHostProvider","MinimizedToolsProvider","ModalHeader","TabSelector","SectionHeader","DraggableHeader","WindowControls","TreeDiffViewer","DataViewer","SplitDiffViewer","VirtualizedDataExplorer","DiffSummary","TypeLegend","IndentGuides","IndentGuidesOverlay","CyberpunkInput","DiffView","AnswerCard","DetailsSection","DetailRow","QuickActionsSection","FilterOptionCard","SearchSection","SearchSectionInner","HeaderActions","HeaderActionsInner","MainListHeader","FilterViewHeader","DetailViewHeader","FloatingMenu","FloatingDevTools","MinimizedToolsStack","MinimizedToolsContext","GlitchToolButton","ExpandablePopover","CollapsedPeek","ExpandedWrapper","DialIcon","DialMenu","DialIconItem","OnboardingTooltip","MenuLauncherIcon","DevToolsSettingsModal","SettingsModal","ToolCard","ToolIcon","GripVerticalIcon","UserStatus","Divider","ChevronDown","ChevronUp","ChevronLeft","ChevronRight","ChevronDownIcon","ChevronUpIcon","ChevronLeftIcon","ChevronRightIcon","LogBox","LogBoxLog","LogBoxLogNotification","LogBoxNotificationContainer","_LogBoxNotificationContainer","LogBoxInspector","LogBoxInspectorContainer","LogBoxInspectorHeader","LogBoxInspectorBody","LogBoxInspectorFooter","LogBoxInspectorMessageHeader","LogBoxInspectorStackFrame","LogBoxInspectorSection","LogBoxButton","LogBoxMessage"]),OTHER_DEV_TOOLS_PREFIXES=["JsModal","TreeDiff","DataViewer","DiffView","DiffSummary","Virtualized","Floating","Minimized","Dial","Expandable","Chevron","Glitch","Settings","Onboarding","DevTools"],OTHER_DEV_TOOLS_NATIVE_IDS=new Set(["jsmodal-root","logbox_inspector","logbox"]),devToolsNodeCache=new Map,CACHE_MAX_SIZE=500;function clearDevToolsCache(){devToolsNodeCache.clear()}function isHighlightOverlayNativeID(e){return!(!e||!HIGHLIGHT_OVERLAY_NATIVE_IDS.has(e)&&!e.startsWith("__highlight_"))}function isOtherDevToolsNativeID(e){if(!e)return!1;if(OTHER_DEV_TOOLS_NATIVE_IDS.has(e))return!0;const n=e.charCodeAt(0);return!(95!==n||!e.startsWith("__rn_buoy__"))||!(108!==n||!e.startsWith("logbox"))}function getComponentName(e){if(!e)return null;const n=e.type;if(n){if("string"==typeof n)return n;if(n.name)return n.name;if(n.displayName)return n.displayName}const t=e.elementType;if(t){if(t.name)return t.name;if(t.displayName)return t.displayName}return null}const INTERNAL_COMPONENT_NAMES=new Set(["View","Text","TextImpl","Image","ScrollView","FlatList","SectionList","TouchableOpacity","TouchableHighlight","TouchableWithoutFeedback","Pressable","TextInput","Switch","ActivityIndicator","Modal","StatusBar","KeyboardAvoidingView","AnimatedComponent","AnimatedComponentWrapper","ScreenContainer","ScreenStack","Screen","ScreenContentWrapper","Svg","G","Path","Rect","Circle","Line","Polygon","Polyline","Ellipse","Text as SVGText","TSpan","TextPath","Use","Symbol","Defs","ClipPath","LinearGradient","RadialGradient","Stop","Mask","Pattern","Image as SVGImage","SafeAreaProvider","SafeAreaView","SafeAreaListener","GestureHandlerRootView","GestureDetector","ReanimatedView","ReanimatedText","ReanimatedImage","ReanimatedScrollView","Fragment","Suspense","Provider","Consumer","Context","ForwardRef"]);function isInternalComponent(e){return!e||!!INTERNAL_COMPONENT_NAMES.has(e)||"Unknown"===e||"Component"===e||!!e.startsWith("Animated")}function getOwningComponentName(e){if(!e)return null;let n=e._debugOwner||e.return,t=0,i=null;for(;n&&t<30;){const e=getComponentName(n);if(e&&"string"!=typeof n.type&&(i||(i=e),!isInternalComponent(e)))return e;n=n.return,t++}return i}function isOurOverlayNode(e){const n=e,t=n?.canonical?.internalInstanceHandle||n?._internalInstanceHandle||n?._internalFiberInstanceHandleDEV,i=getNativeTag(e)||getNativeTag(n?.canonical?.publicInstance),a=RenderTracker.getSettings().excludeDevTools;if(null!=i&&a){const e=devToolsNodeCache.get(i);if(void 0!==e)return e}let r=!1;const o=t?.pendingProps?.nativeID||t?.memoizedProps?.nativeID||n?.canonical?.currentProps?.nativeID||null;if((isHighlightOverlayNativeID(o)||a&&isOtherDevToolsNativeID(o))&&(r=!0),!r&&t){let e=t,n=0;for(;e&&n<30;){const t=getComponentName(e);if(t){if(HIGHLIGHT_OVERLAY_COMPONENTS.has(t)){r=!0;break}for(const e of HIGHLIGHT_OVERLAY_PREFIXES)if(t.startsWith(e)){r=!0;break}if(r)break;if(a){if(OTHER_DEV_TOOLS_COMPONENTS.has(t)){r=!0;break}for(const e of OTHER_DEV_TOOLS_PREFIXES)if(t.startsWith(e)){r=!0;break}if(r)break}}const i=e.pendingProps?.nativeID||e.memoizedProps?.nativeID;if(isHighlightOverlayNativeID(i)){r=!0;break}if(a&&isOtherDevToolsNativeID(i)){r=!0;break}e=e.return,n++}}if(r&&null!=i&&a){if(devToolsNodeCache.size>=500){const e=Array.from(devToolsNodeCache.keys());for(let n=0;n<250;n++)devToolsNodeCache.delete(e[n])}devToolsNodeCache.set(i,r)}return r}function getColorForRenderCount(e){const n=Math.min(e-1,COLORS.length-1);return COLORS[Math.max(0,n)]}function handleTraceUpdates(e){if(0===e.size)return;if(!globalEnabled&&!backgroundTrackingEnabled)return;if(RenderTracker.getState().isPaused)return;PerformanceLogger.isEnabled()&&markEventReceived();const n=RenderTracker.getBatchSize(),t=PerformanceLogger.startBatch(e.size,n),i=[];let a=0,r=0;const o=RenderTracker.hasActiveFilters();for(const n of e)if(n&&"object"==typeof n)try{if(isOurOverlayNode(n)){a++;continue}const e=getPublicInstance(n),t=getNativeTag(n)||getNativeTag(e);if(null==t)continue;const s=extractComponentInfo(n);if(o&&!RenderTracker.passesFilters(s)){r++;continue}let l,c;RenderTracker.getSettings().showRenderCount?(l=(nodeRenderCounts.get(t)||0)+1,nodeRenderCounts.set(t,l),c=getColorForRenderCount(l)):(l=0,c=COLORS[0]),i.push({node:n,color:c,count:l})}catch{}if(t.markFilteringComplete(a+r,i.length),0===i.length)return void t.finish();const s=RenderTracker.getRenderEventCallbackCount()>0;if(!highlightCallback&&!s)return void(isProcessing=!1);t.markMeasurementStart();const l=i.slice(0,n).map(({node:e,color:n,count:t})=>new Promise(i=>{const a=getPublicInstance(e);if(!a)return void i({rect:null,stateNode:e,color:n,count:t});const r=getNativeTag(e)||getNativeTag(a);if(null!=r)try{a.measure((a,o,s,l,c,d)=>{i(null!=c&&null!=d&&null!=s&&null!=l?{rect:{id:r,x:c,y:d,width:s,height:l,color:n,count:t},stateNode:e,color:n,count:t}:{rect:null,stateNode:e,color:n,count:t})})}catch(a){i({rect:null,stateNode:e,color:n,count:t})}else i({rect:null,stateNode:e,color:n,count:t})}));Promise.all(l).then(e=>{const n=e.filter(e=>null!==e.rect),i=n.map(e=>e.rect);t.markMeasurementComplete(n.length,e.length-n.length);const a=RenderTracker.getSettings(),r=a.trackRenderCauses&&a.showRenderCount;let o=null;if(r){o=new Set;for(const{rect:e}of n)e&&o.add(e.id)}if(globalEnabled){RenderTracker.startBatch();for(const{rect:e,stateNode:t,color:i,count:s}of n)if(e){const n=extractComponentInfo(t);let l;if(r&&o){const n=t,i=n?.canonical?.internalInstanceHandle;l=detectRenderCause(e.id,i,o,a.debugLogLevel)}RenderTracker.trackRender({nativeTag:e.id,viewType:n.viewType,testID:n.testID,nativeID:n.nativeID,accessibilityLabel:n.accessibilityLabel,componentName:n.componentName,measurements:{x:e.x,y:e.y,width:e.width,height:e.height},color:i,count:s,renderCause:l})}RenderTracker.endBatch()}else for(const{rect:e,stateNode:t,color:i,count:s}of n)if(e){const n=extractComponentInfo(t);let l;if(r&&o){const n=t,i=n?.canonical?.internalInstanceHandle;l=detectRenderCause(e.id,i,o,a.debugLogLevel)}RenderTracker.emitRenderEvent({nativeTag:e.id,viewType:n.viewType,testID:n.testID,nativeID:n.nativeID,accessibilityLabel:n.accessibilityLabel,componentName:n.componentName,measurements:{x:e.x,y:e.y,width:e.width,height:e.height},color:i,count:s,renderCause:l})}t.markTrackingComplete(),i.length>0&&highlightCallback&&globalEnabled&&highlightCallback(i),t.markCallbackComplete(),t.finish()}).catch(e=>{console.error("[HighlightUpdates] Error in measurement pipeline:",e),t.finish()})}function setTraceUpdatesOnRenderers(e){if(!hook?.rendererInterfaces)return void debugLog("No rendererInterfaces available");let n=0;if(hook.rendererInterfaces.forEach((t,i)=>{if("function"==typeof t.setTraceUpdatesEnabled)try{t.setTraceUpdatesEnabled(e),n++,debugLog(`Renderer ${i}: setTraceUpdatesEnabled(${e})`)}catch(e){debugLog(`Renderer ${i}: error setting trace updates`,e)}else debugLog(`Renderer ${i}: no setTraceUpdatesEnabled method`)}),debugLog(`Set trace updates ${e?"enabled":"disabled"} on ${n} renderer(s)`),hook.reactDevtoolsAgent?.setTraceUpdatesEnabled)try{hook.reactDevtoolsAgent.setTraceUpdatesEnabled(e),debugLog("Also set trace updates on agent")}catch(e){debugLog("Error setting trace updates on agent",e)}}function subscribeToTraceUpdates(){hook&&(traceUpdatesUnsubscribe||(debugLog("Subscribing to traceUpdates event"),"function"==typeof hook.sub?(traceUpdatesUnsubscribe=hook.sub("traceUpdates",handleTraceUpdates),debugLog("Subscribed using hook.sub()")):debugLog("hook.sub not available, traceUpdates may not work"),setTraceUpdatesOnRenderers(!0)))}function unsubscribeFromTraceUpdates(){setTraceUpdatesOnRenderers(!1),traceUpdatesUnsubscribe&&(traceUpdatesUnsubscribe(),traceUpdatesUnsubscribe=null,debugLog("Unsubscribed from traceUpdates event"))}function setHighlightCallback(e){highlightCallback=e,debugLog("Highlight callback "+(e?"set":"cleared"))}function setBadgePressCallback(e){badgePressCallback=e,debugLog("Badge press callback "+(e?"set":"cleared"))}function getBadgePressCallback(){return badgePressCallback}function handleBadgePress(e){badgePressCallback&&badgePressCallback(e)}let spotlightCallback=null,currentSpotlightTag=null;function setSpotlightCallback(e){spotlightCallback=e,e&&null!==currentSpotlightTag&&e(currentSpotlightTag)}function setSpotlight(e){currentSpotlightTag=e,spotlightCallback&&spotlightCallback(e)}function getSpotlight(){return currentSpotlightTag}function notifyStateListeners(){stateListeners.forEach(e=>{try{e(globalEnabled)}catch(e){console.error("[HighlightUpdates] Error in state listener:",e)}})}function subscribe(e){return stateListeners.add(e),e(globalEnabled),()=>{stateListeners.delete(e)}}function initialize(){if("undefined"!=typeof __DEV__&&!__DEV__)return debugLog("Only available in development builds"),!1;if(initialized)return!0;if(hook=window?.__REACT_DEVTOOLS_GLOBAL_HOOK__||null,!hook)return debugLog("React DevTools hook not found"),!1;if(debugLog("Hook found"),debugLog(`Hook has sub: ${"function"==typeof hook.sub}`),debugLog(`Hook has on: ${"function"==typeof hook.on}`),debugLog(`Hook has emit: ${"function"==typeof hook.emit}`),installProfilerInterceptor(),hook.rendererInterfaces&&hook.rendererInterfaces.size>0)return initialized=!0,debugLog(`Initialized with ${hook.rendererInterfaces.size} renderer(s)`),exposeGlobally(),!0;const e=setInterval(()=>{hook?.rendererInterfaces&&hook.rendererInterfaces.size>0&&(clearInterval(e),initialized=!0,debugLog(`Initialized with ${hook.rendererInterfaces.size} renderer(s) (delayed)`),exposeGlobally())},100);return setTimeout(()=>clearInterval(e),1e4),!1}function exposeGlobally(){"undefined"!=typeof window&&(window.__HIGHLIGHT_UPDATES_CONTROLLER__={enable:enable,disable:disable,toggle:toggle,isEnabled:isEnabled,setEnabled:setEnabled,subscribe:subscribe,initialize:initialize,destroy:destroy,isInitialized:()=>initialized,setHighlightCallback:setHighlightCallback})}function enable(){("undefined"==typeof __DEV__||__DEV__)&&(initialized||initialize(),globalEnabled||(debugLog("Enabling highlights"),backgroundTrackingEnabled||subscribeToTraceUpdates(),RenderTracker.start(),globalEnabled=!0,notifyStateListeners(),notifySubscriberCountChange("render")))}function disable(){("undefined"==typeof __DEV__||__DEV__)&&globalEnabled&&(debugLog("Disabling highlights"),renderingLock=!1,isProcessing=!1,renderingLockTimeout&&(clearTimeout(renderingLockTimeout),renderingLockTimeout=null),renderedOverlayTags.clear(),devToolsNodeCache.clear(),clearRenderCauseState(),backgroundTrackingEnabled||unsubscribeFromTraceUpdates(),RenderTracker.stop(),globalEnabled=!1,notifyStateListeners(),notifySubscriberCountChange("render"))}function enableBackgroundTracking(){("undefined"==typeof __DEV__||__DEV__)&&(backgroundTrackingEnabled||(initialized||initialize(),debugLog("Enabling background tracking"),globalEnabled||subscribeToTraceUpdates(),backgroundTrackingEnabled=!0))}function disableBackgroundTracking(){("undefined"==typeof __DEV__||__DEV__)&&backgroundTrackingEnabled&&(debugLog("Disabling background tracking"),backgroundTrackingEnabled=!1,globalEnabled||unsubscribeFromTraceUpdates())}function isBackgroundTrackingEnabled(){return backgroundTrackingEnabled}function toggle(){("undefined"==typeof __DEV__||__DEV__)&&(globalEnabled?disable():enable())}function clearRenderCounts(){nodeRenderCounts.clear(),RenderTracker.clear(),debugLog("Cleared render counts")}function isEnabled(){return globalEnabled}function setEnabled(e){e?enable():disable()}function isInitialized(){return initialized}function notifyFreezeListeners(){freezeListeners.forEach(e=>{try{e(isFrozen)}catch(e){console.error("[HighlightUpdates] Error in freeze listener:",e)}})}function subscribeToFreeze(e){return freezeListeners.add(e),e(isFrozen),()=>{freezeListeners.delete(e)}}function freeze(){("undefined"==typeof __DEV__||__DEV__)&&(isFrozen||(isFrozen=!0,debugLog("Freeze mode enabled"),notifyFreezeListeners()))}function unfreeze(){("undefined"==typeof __DEV__||__DEV__)&&isFrozen&&(isFrozen=!1,debugLog("Freeze mode disabled"),highlightCallback&&highlightCallback([]),notifyFreezeListeners())}function toggleFreeze(){isFrozen?unfreeze():freeze()}function getFrozen(){return isFrozen}function destroy(){initialized&&(unsubscribeFromTraceUpdates(),uninstallProfilerInterceptor(),setComparisonCallback(null),isFrozen=!1,freezeListeners.clear(),globalEnabled=!1,hook=null,highlightCallback=null,initialized=!1,"undefined"!=typeof window&&delete window.__HIGHLIGHT_UPDATES_CONTROLLER__,debugLog("Destroyed"))}const HighlightUpdatesController={subscribe:subscribe,enable:enable,disable:disable,toggle:toggle,isEnabled:isEnabled,setEnabled:setEnabled,initialize:initialize,destroy:destroy,isInitialized:isInitialized,setHighlightCallback:setHighlightCallback,clearRenderCounts:clearRenderCounts,freeze:freeze,unfreeze:unfreeze,toggleFreeze:toggleFreeze,getFrozen:getFrozen,subscribeToFreeze:subscribeToFreeze,setBadgePressCallback:setBadgePressCallback,getBadgePressCallback:getBadgePressCallback,handleBadgePress:handleBadgePress,setSpotlightCallback:setSpotlightCallback,setSpotlight:setSpotlight,getSpotlight:getSpotlight,clearDevToolsCache:clearDevToolsCache,enableBackgroundTracking:enableBackgroundTracking,disableBackgroundTracking:disableBackgroundTracking,isBackgroundTrackingEnabled:isBackgroundTrackingEnabled};export default HighlightUpdatesController;
+/**
+ * Highlight Updates Controller
+ *
+ * Standalone implementation that replicates React DevTools' "Highlight updates
+ * when components render" feature WITHOUT requiring DevTools to be connected.
+ *
+ * Architecture:
+ * This controller directly enables the DevTools backend's traceUpdates feature
+ * by calling setTraceUpdatesEnabled(true) on each renderer interface. This is
+ * the same function that DevTools' frontend calls when you check the
+ * "Highlight updates when components render" checkbox.
+ *
+ * Key insight: The rendererInterfaces are available on the global hook even
+ * without DevTools frontend connected. We just need to enable tracing directly.
+ *
+ * Flow:
+ * 1. User enables highlights via toggle()
+ * 2. We call rendererInterface.setTraceUpdatesEnabled(true) on all renderers
+ * 3. DevTools backend now tracks renders and emits 'traceUpdates' events
+ * 4. We subscribe to 'traceUpdates' via hook.sub()
+ * 5. When components re-render, we receive the Set of host stateNodes
+ * 6. We measure each node and render colored border highlights
+ *
+ * This gives us 100% accuracy with DevTools behavior because we're using the
+ * exact same detection code - we're just enabling it programmatically.
+ */
+
+"use strict";
+
+import { installProfilerInterceptor, uninstallProfilerInterceptor, setComparisonCallback } from "./ProfilerInterceptor";
+import { RenderTracker } from "./RenderTracker";
+import { PerformanceLogger, markEventReceived } from "./PerformanceLogger";
+import { detectRenderCause, clearRenderCauseState } from "./RenderCauseDetector";
+import { notifySubscriberCountChange } from "@buoy-gg/shared-ui";
+// State
+let globalEnabled = false; // User-controlled toggle for visual highlights
+let backgroundTrackingEnabled = false; // Auto-enabled when event callbacks exist (Events tool)
+let initialized = false;
+let hook = null;
+let highlightCallback = null;
+let badgePressCallback = null;
+let traceUpdatesUnsubscribe = null;
+let isProcessing = false;
+
+// Freeze frame state
+let isFrozen = false;
+const freezeListeners = new Set();
+const stateListeners = new Set();
+
+// Track render counts per node (for color assignment like DevTools)
+// Map from nativeTag to render count - nativeTag is stable across re-renders
+const nodeRenderCounts = new Map();
+
+// Color palette for highlights (same as DevTools)
+// From: react-devtools-core/dist/backend.js line 6361
+const COLORS = ["#37afa9", "#63b19e", "#80b393", "#97b488", "#abb67d", "#beb771", "#cfb965", "#dfba57", "#efbb49", "#febc38"];
+
+// Set to true for verbose debugging of our implementation
+// Disabled for now to focus on profiler logs only
+const DEBUG = false;
+function debugLog(message, data) {
+  if (!DEBUG) return;
+  if (data !== undefined) {
+    console.log(`[HighlightUpdates] ${message}`, data);
+  } else {
+    console.log(`[HighlightUpdates] ${message}`);
+  }
+}
+
+/**
+ * Get the public instance from a stateNode (the node passed in traceUpdates)
+ */
+function getPublicInstance(stateNode) {
+  if (!stateNode) return null;
+  const node = stateNode;
+
+  // Fabric: stateNode.canonical.publicInstance
+  if (node.canonical?.publicInstance) {
+    return node.canonical.publicInstance;
+  }
+
+  // Legacy Fabric: stateNode.canonical with measure
+  if (node.canonical && typeof node.canonical.measure === "function") {
+    return node.canonical;
+  }
+
+  // Legacy renderer: stateNode has measure directly
+  if (typeof node.measure === "function") {
+    return node;
+  }
+  return null;
+}
+
+/**
+ * Get native tag from public instance or stateNode
+ */
+function getNativeTag(instance) {
+  if (instance == null) return null;
+  const inst = instance;
+
+  // Try direct properties
+  if (inst.__nativeTag != null) return inst.__nativeTag;
+  if (inst._nativeTag != null) return inst._nativeTag;
+  if (inst.nativeTag != null) return inst.nativeTag;
+
+  // Try canonical
+  if (inst.canonical) {
+    if (inst.canonical.__nativeTag != null) return inst.canonical.__nativeTag;
+    if (inst.canonical._nativeTag != null) return inst.canonical._nativeTag;
+  }
+  return null;
+}
+
+/**
+ * Extract component info from a stateNode for RenderTracker
+ */
+function extractComponentInfo(stateNode) {
+  const node = stateNode;
+  const info = {
+    viewType: "Unknown"
+  };
+
+  // Get viewType from viewConfig
+  if (node?.canonical?.viewConfig?.uiViewClassName) {
+    info.viewType = node.canonical.viewConfig.uiViewClassName;
+  } else if (node?.viewConfig?.uiViewClassName) {
+    info.viewType = node.viewConfig.uiViewClassName;
+  }
+
+  // Try to get props from various locations
+  // Fabric: canonical.internalInstanceHandle, Paper: _internalInstanceHandle, RN CLI DEV: _internalFiberInstanceHandleDEV
+  const fiber = node?.canonical?.internalInstanceHandle || node?._internalInstanceHandle || node?._internalFiberInstanceHandleDEV;
+  const currentProps = node?.canonical?.currentProps;
+  const pendingProps = node?.canonical?.pendingProps;
+  const fiberPendingProps = fiber?.pendingProps;
+  const fiberMemoizedProps = fiber?.memoizedProps;
+
+  // Extract testID
+  info.testID = currentProps?.testID || pendingProps?.testID || fiberPendingProps?.testID || fiberMemoizedProps?.testID || undefined;
+
+  // Extract nativeID
+  info.nativeID = currentProps?.nativeID || pendingProps?.nativeID || fiberPendingProps?.nativeID || fiberMemoizedProps?.nativeID || undefined;
+
+  // Extract accessibilityLabel
+  info.accessibilityLabel = currentProps?.accessibilityLabel || pendingProps?.accessibilityLabel || fiberPendingProps?.accessibilityLabel || fiberMemoizedProps?.accessibilityLabel || undefined;
+
+  // Extract componentName - use getOwningComponentName to get the React component
+  // that rendered this host component
+  info.componentName = getOwningComponentName(fiber) || undefined;
+  return info;
+}
+
+/**
+ * Describe a node for logging (extensive version for debugging)
+ */
+function describeNodeForLog(stateNode) {
+  const node = stateNode;
+  const publicInstance = getPublicInstance(stateNode);
+  const nativeTag = getNativeTag(stateNode) || getNativeTag(publicInstance);
+  const info = {
+    nativeTag: nativeTag ?? "unknown",
+    type: node?.canonical ? "Fabric" : "Legacy",
+    hasMeasure: typeof publicInstance?.measure === "function"
+  };
+
+  // Extract as much info as possible from the stateNode
+  if (node) {
+    // Direct properties on stateNode
+    info.stateNodeKeys = Object.keys(node).slice(0, 20);
+
+    // Check the 'node' property (might have useful info)
+    if (node.node) {
+      info.nodeKeys = Object.keys(node.node).slice(0, 20);
+    }
+
+    // Check for viewConfig (contains component type info)
+    if (node.viewConfig) {
+      info.viewConfig = {
+        uiViewClassName: node.viewConfig.uiViewClassName,
+        validAttributes: node.viewConfig.validAttributes ? Object.keys(node.viewConfig.validAttributes).slice(0, 10) : undefined
+      };
+    }
+
+    // Check canonical structure (Fabric)
+    if (node.canonical) {
+      const canonical = node.canonical;
+      info.canonicalKeys = Object.keys(canonical).slice(0, 20);
+      if (canonical.viewConfig) {
+        info.canonicalViewConfig = {
+          uiViewClassName: canonical.viewConfig.uiViewClassName
+        };
+      }
+      if (canonical.nativeTag != null) {
+        info.canonicalNativeTag = canonical.nativeTag;
+      }
+
+      // Check internalInstanceHandle (THE FIBER!)
+      if (canonical.internalInstanceHandle) {
+        const fiber = canonical.internalInstanceHandle;
+        info.fiberKeys = Object.keys(fiber).slice(0, 30);
+
+        // Component type info
+        if (fiber.type) {
+          info.fiberType = typeof fiber.type === "function" ? fiber.type.name || fiber.type.displayName || "function" : fiber.type;
+        }
+        if (fiber.elementType) {
+          info.fiberElementType = typeof fiber.elementType === "function" ? fiber.elementType.name || fiber.elementType.displayName || "function" : fiber.elementType;
+        }
+
+        // Debug info on fiber
+        if (fiber._debugOwner) {
+          const owner = fiber._debugOwner;
+          info.fiberDebugOwner = owner.type?.name || owner.type?.displayName || owner.elementType?.name || "unknown";
+        }
+        if (fiber._debugSource) {
+          info.fiberDebugSource = fiber._debugSource;
+        }
+
+        // Fiber tag (tells us what kind of fiber it is)
+        if (fiber.tag != null) {
+          info.fiberTag = fiber.tag;
+        }
+
+        // pendingProps on fiber might have testID/nativeID
+        if (fiber.pendingProps) {
+          if (fiber.pendingProps.nativeID) info.fiberPendingNativeID = fiber.pendingProps.nativeID;
+          if (fiber.pendingProps.testID) info.fiberPendingTestID = fiber.pendingProps.testID;
+        }
+        if (fiber.memoizedProps) {
+          if (fiber.memoizedProps.nativeID) info.fiberMemoizedNativeID = fiber.memoizedProps.nativeID;
+          if (fiber.memoizedProps.testID) info.fiberMemoizedTestID = fiber.memoizedProps.testID;
+        }
+      }
+
+      // Check publicInstance
+      if (canonical.publicInstance) {
+        const pub = canonical.publicInstance;
+        info.publicInstanceKeys = Object.keys(pub).slice(0, 20);
+
+        // Look for nativeID
+        if (pub.nativeID != null) info.nativeID = pub.nativeID;
+        if (pub._nativeID != null) info._nativeID = pub._nativeID;
+
+        // Look for props
+        if (pub.props) {
+          info.publicInstanceProps = Object.keys(pub.props).slice(0, 15);
+          if (pub.props.nativeID) info.propsNativeID = pub.props.nativeID;
+          if (pub.props.testID) info.propsTestID = pub.props.testID;
+          if (pub.props.accessibilityLabel) info.accessibilityLabel = pub.props.accessibilityLabel;
+        }
+      }
+
+      // Check for currentProps - log actual VALUES
+      if (canonical.currentProps) {
+        info.currentPropsKeys = Object.keys(canonical.currentProps).slice(0, 15);
+        // Log actual values of identifying props
+        if (canonical.currentProps.nativeID != null) info.currentPropsNativeID = canonical.currentProps.nativeID;
+        if (canonical.currentProps.testID != null) info.currentPropsTestID = canonical.currentProps.testID;
+        if (canonical.currentProps.accessibilityLabel != null) info.currentPropsAccessLabel = canonical.currentProps.accessibilityLabel;
+      }
+
+      // Check for pendingProps
+      if (canonical.pendingProps) {
+        info.pendingPropsKeys = Object.keys(canonical.pendingProps).slice(0, 15);
+        if (canonical.pendingProps.nativeID != null) info.pendingPropsNativeID = canonical.pendingProps.nativeID;
+        if (canonical.pendingProps.testID != null) info.pendingPropsTestID = canonical.pendingProps.testID;
+      }
+    }
+
+    // Check for fiber reference directly on node
+    if (node._debugOwner) {
+      const owner = node._debugOwner;
+      info.debugOwnerType = owner.type?.name || owner.type?.displayName || typeof owner.type;
+    }
+    if (node._debugSource) {
+      info.debugSource = node._debugSource;
+    }
+  }
+  return info;
+}
+
+// Set to true to enable debug logging
+const DEBUG_LOGGING = false;
+
+// Lock to prevent infinite loops when rendering our overlay
+let renderingLock = false;
+let renderingLockTimeout = null;
+
+// How long to ignore new events after starting a render (ms)
+// Should match HIGHLIGHT_DURATION in the overlay to prevent false triggers
+const RENDER_LOCK_DURATION = 350;
+
+// Track nativeTags of components we're currently highlighting
+// This helps us identify (and skip) our own overlay Views if they re-render
+const renderedOverlayTags = new Set();
+
+/**
+ * Check if a nativeTag belongs to our overlay (was rendered by us previously)
+ */
+function isOurOverlayTag(nativeTag) {
+  if (nativeTag == null) return false;
+  return renderedOverlayTags.has(nativeTag);
+}
+
+// ============================================================================
+// OPTIMIZED DEV TOOLS DETECTION
+// ============================================================================
+// Performance optimizations applied:
+// 1. Result caching by nativeTag (same tag = same result)
+// 2. Set-based O(1) lookups instead of multiple string comparisons
+// 3. Component name check FIRST (appears early in tree, ~depth 5-8)
+// 4. Early exit on first match
+// 5. Cached property access to avoid repeated traversal
+// ============================================================================
+
+// Components that MUST always be excluded to prevent infinite loops.
+// Includes the Highlight Updates overlay AND the Events tool (which subscribes
+// to render callbacks via RenderTracker.onRenderEvent - tracking its renders
+// would create an infinite callback loop).
+const HIGHLIGHT_OVERLAY_COMPONENTS = new Set([
+// Highlight Updates overlay components
+"HighlightUpdatesOverlay", "HighlightUpdatesModal", "HighlightFilterView", "RenderDetailView", "RenderListItem", "RenderListItemInner", "RenderHistoryViewer", "RenderHistoryFooter", "RenderCauseBadge", "TwoLevelCauseBadge", "EnhancedCauseDisplay", "IsolatedRenderList", "IsolatedRenderListInner", "StatsDisplay", "StatsDisplayInner", "CurrentStateView", "EventStepperFooter",
+// Events tool components - subscribes to onRenderEvent, tracking these causes infinite loops
+"EventsModal", "UnifiedEventList", "UnifiedEventItem", "UnifiedEventDetail", "UnifiedEventFilters", "UnifiedEventViewer", "ReactQueryEventDetail", "EventsCopySettingsView"]);
+
+// Native IDs that MUST always be excluded (highlight overlay)
+const HIGHLIGHT_OVERLAY_NATIVE_IDS = new Set(["highlight-updates-overlay", "__rn_buoy__highlight-modal"]);
+
+// Prefixes for always-excluded components (highlight overlay + events tool)
+const HIGHLIGHT_OVERLAY_PREFIXES = ["HighlightUpdates", "RenderList", "RenderDetail", "RenderHistory", "RenderCause", "EventStepper",
+// Events tool - subscribes to onRenderEvent, must always be excluded
+"UnifiedEvent", "EventsModal", "EventsCopy"];
+
+// Other dev tools components - can be toggled via excludeDevTools setting
+const OTHER_DEV_TOOLS_COMPONENTS = new Set([
+// React Buoy devtools components
+"JsModalComponent", "JsModal", "TypePicker", "PatternInput", "PatternChip", "DetectedItemsSection", "DetectedCategoryBadge", "IdentifierBadge", "CategoryBadge", "AppRenderer", "AppOverlay", "FloatingTools", "DialDevTools", "DevToolsVisibilityProvider", "AppHostProvider", "MinimizedToolsProvider",
+// Shared UI components used in modals
+"ModalHeader", "TabSelector", "SectionHeader", "DraggableHeader", "WindowControls",
+// Shared UI data viewer components (JSON diff viewers, etc.)
+"TreeDiffViewer", "DataViewer", "SplitDiffViewer", "VirtualizedDataExplorer", "DiffSummary", "TypeLegend", "IndentGuides", "IndentGuidesOverlay", "CyberpunkInput", "DiffView", "AnswerCard", "DetailsSection", "DetailRow", "QuickActionsSection", "FilterOptionCard",
+// Modal header sub-components
+"SearchSection", "SearchSectionInner", "HeaderActions", "HeaderActionsInner", "MainListHeader", "FilterViewHeader", "DetailViewHeader",
+// Floating menu components (minimized tools, dial, etc.)
+"FloatingMenu", "FloatingDevTools", "MinimizedToolsStack", "MinimizedToolsContext", "GlitchToolButton", "ExpandablePopover", "CollapsedPeek", "ExpandedWrapper", "DialIcon", "DialMenu", "DialIconItem", "OnboardingTooltip", "MenuLauncherIcon", "DevToolsSettingsModal", "SettingsModal",
+// Image Overlay components
+"ImageOverlayModal", "ImageOverlayStandalone", "ToolCard", "ToolIcon", "GripVerticalIcon", "UserStatus", "Divider",
+// Shared UI icon components (Chevrons, etc.)
+"ChevronDown", "ChevronUp", "ChevronLeft", "ChevronRight", "ChevronDownIcon", "ChevronUpIcon", "ChevronLeftIcon", "ChevronRightIcon",
+// React Native LogBox components (shown on reload/errors)
+"LogBox", "LogBoxLog", "LogBoxLogNotification", "LogBoxNotificationContainer", "_LogBoxNotificationContainer", "LogBoxInspector", "LogBoxInspectorContainer", "LogBoxInspectorHeader", "LogBoxInspectorBody", "LogBoxInspectorFooter", "LogBoxInspectorMessageHeader", "LogBoxInspectorStackFrame", "LogBoxInspectorSection", "LogBoxButton", "LogBoxMessage"]);
+
+// Other dev tools prefixes - can be toggled via excludeDevTools setting
+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 native IDs - can be toggled
+const OTHER_DEV_TOOLS_NATIVE_IDS = new Set(["jsmodal-root", "image-overlay-standalone",
+// LogBox native IDs
+"logbox_inspector", "logbox"]);
+
+// Cache: nativeTag -> isDevTools (avoid re-walking tree for same node)
+const devToolsNodeCache = new Map();
+const CACHE_MAX_SIZE = 500;
+
+/**
+ * Clear the devtools node cache.
+ * Call this when the excludeDevTools setting changes to re-evaluate all nodes.
+ */
+function clearDevToolsCache() {
+  devToolsNodeCache.clear();
+}
+
+/**
+ * Check if a nativeID belongs to highlight overlay (always excluded)
+ */
+function isHighlightOverlayNativeID(nativeID) {
+  if (!nativeID) return false;
+  // Direct Set lookup (O(1))
+  if (HIGHLIGHT_OVERLAY_NATIVE_IDS.has(nativeID)) return true;
+  // Prefix check for highlight overlay
+  if (nativeID.startsWith("__highlight_")) return true;
+  return false;
+}
+
+/**
+ * Check if a nativeID belongs to other dev tools (optionally excluded)
+ */
+function isOtherDevToolsNativeID(nativeID) {
+  if (!nativeID) return false;
+  // Direct Set lookup (O(1))
+  if (OTHER_DEV_TOOLS_NATIVE_IDS.has(nativeID)) return true;
+  // Prefix checks for other devtools nativeIDs
+  const firstChar = nativeID.charCodeAt(0);
+  if (firstChar === 95) {
+    // '_' = 95
+    if (nativeID.startsWith("__rn_buoy__")) return true;
+  }
+  // Check for LogBox nativeIDs (start with 'l')
+  if (firstChar === 108 && nativeID.startsWith("logbox")) {
+    // 'l' = 108
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Get component name from fiber (cached property access pattern)
+ * For host components (RCTView, RCTText), returns the native type.
+ * Use getOwningComponentName to get the React component that rendered it.
+ */
+function getComponentName(fiber) {
+  if (!fiber) return null;
+  // Most common: type.name
+  const type = fiber.type;
+  if (type) {
+    if (typeof type === 'string') return type;
+    if (type.name) return type.name;
+    if (type.displayName) return type.displayName;
+  }
+  // Fallback: elementType
+  const elementType = fiber.elementType;
+  if (elementType) {
+    if (elementType.name) return elementType.name;
+    if (elementType.displayName) return elementType.displayName;
+  }
+  return null;
+}
+
+// Common React Native internal component names to skip when finding user components
+const INTERNAL_COMPONENT_NAMES = new Set([
+// React Native core
+'View', 'Text', 'TextImpl', 'Image', 'ScrollView', 'FlatList', 'SectionList', 'TouchableOpacity', 'TouchableHighlight', 'TouchableWithoutFeedback', 'Pressable', 'TextInput', 'Switch', 'ActivityIndicator', 'Modal', 'StatusBar', 'KeyboardAvoidingView',
+// Animated components
+'AnimatedComponent', 'AnimatedComponentWrapper',
+// React Navigation / Screens
+'ScreenContainer', 'ScreenStack', 'Screen', 'ScreenContentWrapper',
+// SVG components
+'Svg', 'G', 'Path', 'Rect', 'Circle', 'Line', 'Polygon', 'Polyline', 'Ellipse', 'Text as SVGText', 'TSpan', 'TextPath', 'Use', 'Symbol', 'Defs', 'ClipPath', 'LinearGradient', 'RadialGradient', 'Stop', 'Mask', 'Pattern', 'Image as SVGImage',
+// SafeArea
+'SafeAreaProvider', 'SafeAreaView', 'SafeAreaListener',
+// Gesture Handler
+'GestureHandlerRootView', 'GestureDetector',
+// Reanimated
+'ReanimatedView', 'ReanimatedText', 'ReanimatedImage', 'ReanimatedScrollView',
+// Common wrapper names
+'Fragment', 'Suspense', 'Provider', 'Consumer', 'Context', 'ForwardRef']);
+
+/**
+ * Check if a component name is an internal/wrapper component that should be skipped
+ */
+function isInternalComponent(name) {
+  if (!name) return true;
+  if (INTERNAL_COMPONENT_NAMES.has(name)) return true;
+  // Skip anonymous components and common patterns
+  if (name === 'Unknown' || name === 'Component') return true;
+  // Skip Animated.* wrappers
+  if (name.startsWith('Animated')) return true;
+  return false;
+}
+
+/**
+ * Get the owning React component name for a host fiber.
+ * Walks up the fiber tree to find the first user-defined component,
+ * skipping React Native internal components.
+ */
+function getOwningComponentName(fiber) {
+  if (!fiber) return null;
+
+  // Walk up the fiber tree looking for a user-defined component
+  let current = fiber._debugOwner || fiber.return;
+  let depth = 0;
+  let firstNonHostName = null;
+  while (current && depth < 30) {
+    const name = getComponentName(current);
+
+    // Skip host components (their type is a string like "RCTView")
+    if (name && typeof current.type !== 'string') {
+      // Remember the first non-host component as fallback
+      if (!firstNonHostName) {
+        firstNonHostName = name;
+      }
+      // Return this component if it's not an internal wrapper
+      if (!isInternalComponent(name)) {
+        return name;
+      }
+    }
+    current = current.return;
+    depth++;
+  }
+
+  // Fallback to first non-host component found (even if internal)
+  return firstNonHostName;
+}
+
+/**
+ * Check if a stateNode belongs to our dev tools.
+ *
+ * OPTIMIZED: Uses caching, O(1) Set lookups, and early exit patterns.
+ * Walks up fiber tree checking component names (fast) before nativeIDs.
+ *
+ * When excludeDevTools setting is false, only the Highlight Updates overlay
+ * is excluded (to prevent infinite loops). Other dev tools will be highlighted.
+ */
+function isOurOverlayNode(stateNode) {
+  const node = stateNode;
+  // Fabric: fiber is at canonical.internalInstanceHandle
+  // Paper/Legacy: fiber is at _internalInstanceHandle directly on stateNode
+  // RN CLI DEV: fiber is at _internalFiberInstanceHandleDEV
+  const fiber = node?.canonical?.internalInstanceHandle || node?._internalInstanceHandle || node?._internalFiberInstanceHandleDEV;
+
+  // Get nativeTag for caching
+  const nativeTag = getNativeTag(stateNode) || getNativeTag(node?.canonical?.publicInstance);
+
+  // Check if we should exclude all dev tools or just highlight overlay
+  const excludeDevTools = RenderTracker.getSettings().excludeDevTools;
+
+  // Check cache first (O(1)) - but only for the current excludeDevTools setting
+  // When excludeDevTools is false, skip cache to re-evaluate all nodes
+  if (nativeTag != null && excludeDevTools) {
+    const cached = devToolsNodeCache.get(nativeTag);
+    if (cached !== undefined) {
+      return cached;
+    }
+  }
+  let result = false;
+
+  // Fast path: check direct nativeID
+  const directNativeID = fiber?.pendingProps?.nativeID || fiber?.memoizedProps?.nativeID || node?.canonical?.currentProps?.nativeID || null;
+
+  // Always check highlight overlay nativeIDs first (must always be excluded)
+  if (isHighlightOverlayNativeID(directNativeID)) {
+    result = true;
+  } else if (excludeDevTools && isOtherDevToolsNativeID(directNativeID)) {
+    // Only check other dev tools if excludeDevTools is enabled
+    result = true;
+  }
+  if (!result && fiber) {
+    // Walk up fiber tree - check component names FIRST (they appear early)
+    let current = fiber;
+    let depth = 0;
+
+    // Reduced max depth - component names appear by depth 15 typically
+    while (current && depth < 30) {
+      // Component name check FIRST (faster, appears earlier in tree)
+      const name = getComponentName(current);
+      if (name) {
+        // Always check highlight overlay components (must always be excluded)
+        if (HIGHLIGHT_OVERLAY_COMPONENTS.has(name)) {
+          result = true;
+          break;
+        }
+        // Check highlight overlay prefixes
+        for (const prefix of HIGHLIGHT_OVERLAY_PREFIXES) {
+          if (name.startsWith(prefix)) {
+            result = true;
+            break;
+          }
+        }
+        if (result) break;
+
+        // Only check other dev tools if excludeDevTools is enabled
+        if (excludeDevTools) {
+          if (OTHER_DEV_TOOLS_COMPONENTS.has(name)) {
+            result = true;
+            break;
+          }
+          // Check other dev tools prefixes
+          for (const prefix of OTHER_DEV_TOOLS_PREFIXES) {
+            if (name.startsWith(prefix)) {
+              result = true;
+              break;
+            }
+          }
+          if (result) break;
+        }
+      }
+
+      // NativeID check (only if component name didn't match)
+      const nativeID = current.pendingProps?.nativeID || current.memoizedProps?.nativeID;
+      if (isHighlightOverlayNativeID(nativeID)) {
+        result = true;
+        break;
+      }
+      if (excludeDevTools && isOtherDevToolsNativeID(nativeID)) {
+        result = true;
+        break;
+      }
+      current = current.return;
+      depth++;
+    }
+  }
+
+  // Only cache positive results when excludeDevTools is true (default mode)
+  // Don't cache when excludeDevTools is false to avoid complex cache invalidation
+  if (result && nativeTag != null && excludeDevTools) {
+    if (devToolsNodeCache.size >= CACHE_MAX_SIZE) {
+      // Clear oldest entries (simple strategy - clear half)
+      const entries = Array.from(devToolsNodeCache.keys());
+      for (let i = 0; i < CACHE_MAX_SIZE / 2; i++) {
+        devToolsNodeCache.delete(entries[i]);
+      }
+    }
+    devToolsNodeCache.set(nativeTag, result);
+  }
+  return result;
+}
+
+/**
+ * Get color based on render count (same algorithm as DevTools)
+ * More renders = warmer color (cyan → yellow)
+ */
+function getColorForRenderCount(count) {
+  // Clamp to color array bounds
+  const index = Math.min(count - 1, COLORS.length - 1);
+  return COLORS[Math.max(0, index)];
+}
+
+/**
+ * Handle traceUpdates event from DevTools backend
+ * This is called with a Set of stateNodes that should be highlighted
+ *
+ * Strategy to prevent infinite loops:
+ * 1. Use a rendering lock while rendering highlights
+ * 2. Use an isProcessing flag to prevent concurrent processing
+ * 3. If Chrome DevTools agent is available, use native overlay (faster, no React)
+ * 4. Otherwise, use our React overlay with locks to prevent cascading renders
+ */
+function handleTraceUpdates(nodes) {
+  if (nodes.size === 0) {
+    return;
+  }
+
+  // Skip if neither visual toggle nor background tracking is enabled
+  if (!globalEnabled && !backgroundTrackingEnabled) {
+    return;
+  }
+
+  // Skip processing when paused - don't count renders or show highlights
+  const trackerState = RenderTracker.getState();
+  if (trackerState.isPaused) {
+    return;
+  }
+
+  // Mark event received for end-to-end timing
+  if (PerformanceLogger.isEnabled()) {
+    markEventReceived();
+  }
+
+  // Start performance timing
+  const batchSize = RenderTracker.getBatchSize();
+  const perfTimer = PerformanceLogger.startBatch(nodes.size, batchSize);
+
+  // NOTE: Lock-based skipping disabled - relying on nativeID filtering instead
+  // If nativeID filtering doesn't work, re-enable this:
+  //
+  // if (renderingLock || isProcessing) {
+  //   if (DEBUG_LOGGING) {
+  //     console.log(`[HighlightUpdates] SKIPPED - lock:${renderingLock} processing:${isProcessing}`);
+  //   }
+  //   return;
+  // }
+  // isProcessing = true;
+
+  // Process nodes: track render counts and assign colors
+  // Filter out our own overlay nodes to prevent infinite loop
+  // Also apply user-defined filters to both overlay AND tracking
+  const nodesToDraw = [];
+  let skippedOverlayCount = 0;
+  let skippedByFilterCount = 0;
+  const hasActiveFilters = RenderTracker.hasActiveFilters();
+  for (const stateNode of nodes) {
+    if (stateNode && typeof stateNode === "object") {
+      try {
+        // Skip our own overlay nodes (identified by nativeID)
+        if (isOurOverlayNode(stateNode)) {
+          skippedOverlayCount++;
+          continue;
+        }
+
+        // Get nativeTag for tracking render counts
+        const publicInstance = getPublicInstance(stateNode);
+        const nativeTag = getNativeTag(stateNode) || getNativeTag(publicInstance);
+        if (nativeTag == null) {
+          continue;
+        }
+
+        // Extract component info for filtering
+        const componentInfo = extractComponentInfo(stateNode);
+
+        // Apply user-defined filters - skip components that don't pass filters
+        // This affects BOTH the overlay highlights AND the render list
+        if (hasActiveFilters && !RenderTracker.passesFilters(componentInfo)) {
+          skippedByFilterCount++;
+          continue;
+        }
+
+        // Check if render counting is enabled
+        const showRenderCount = RenderTracker.getSettings().showRenderCount;
+        let newCount;
+        let color;
+        if (showRenderCount) {
+          // Get current render count and increment (using nativeTag as stable key)
+          const currentCount = nodeRenderCounts.get(nativeTag) || 0;
+          newCount = currentCount + 1;
+          nodeRenderCounts.set(nativeTag, newCount);
+          // Assign color based on render count
+          color = getColorForRenderCount(newCount);
+        } else {
+          // Skip counting - use fixed color and count of 0
+          newCount = 0;
+          color = COLORS[0]; // Use first color (cyan)
+        }
+        nodesToDraw.push({
+          node: stateNode,
+          color,
+          count: newCount
+        });
+      } catch {
+        // Skip nodes from custom renderers (e.g. React Native Skia) that have
+        // non-standard stateNode structures
+      }
+    }
+  }
+
+  // Mark filtering phase complete (includes both overlay nodes and user-filtered nodes)
+  perfTimer.markFilteringComplete(skippedOverlayCount + skippedByFilterCount, nodesToDraw.length);
+
+  // Only log if there are real updates (not just overlay re-renders)
+  if (nodesToDraw.length === 0) {
+    // All nodes were overlay nodes - silently skip
+    perfTimer.finish(); // Still log the batch even if empty
+    return;
+  }
+
+  // Log actual component updates
+  if (DEBUG_LOGGING) {
+    console.log(`[HighlightUpdates] ${nodesToDraw.length} component(s) re-rendered`);
+  }
+
+  // NOTE: We prefer our React overlay for standalone operation.
+  // The native overlay only works when Chrome DevTools profiler is actively enabled.
+  // Uncomment below to use native overlay when available:
+  //
+  // const agent = hook?.reactDevtoolsAgent;
+  // if (agent?.emit) {
+  //   if (DEBUG_LOGGING) {
+  //     console.log(`[HighlightUpdates] Using native overlay (agent available)`);
+  //   }
+  //   agent.emit("drawTraceUpdates", nodesToDraw);
+  //   isProcessing = false;
+  //   return;
+  // }
+
+  // Check if we should process - either we have a visual callback OR event callbacks
+  const hasEventCallbacks = RenderTracker.getRenderEventCallbackCount() > 0;
+  if (!highlightCallback && !hasEventCallbacks) {
+    if (DEBUG_LOGGING) {
+      console.log(`[HighlightUpdates] No highlightCallback and no event callbacks - skipping render`);
+    }
+    isProcessing = false;
+    return;
+  }
+
+  // NOTE: Lock disabled - relying on nativeID filtering instead
+
+  // Measure each node and call the highlight callback
+  // Use batch size from RenderTracker settings (default: 150)
+  // Note: batchSize already retrieved above for perfTimer
+  perfTimer.markMeasurementStart();
+  const measurePromises = nodesToDraw.slice(0, batchSize).map(({
+    node: stateNode,
+    color,
+    count
+  }) => new Promise(resolve => {
+    const publicInstance = getPublicInstance(stateNode);
+    if (!publicInstance) {
+      resolve({
+        rect: null,
+        stateNode,
+        color,
+        count
+      });
+      return;
+    }
+    const nativeTag = getNativeTag(stateNode) || getNativeTag(publicInstance);
+    if (nativeTag == null) {
+      resolve({
+        rect: null,
+        stateNode,
+        color,
+        count
+      });
+      return;
+    }
+    try {
+      publicInstance.measure((x, y, width, height, pageX, pageY) => {
+        if (pageX == null || pageY == null || width == null || height == null) {
+          resolve({
+            rect: null,
+            stateNode,
+            color,
+            count
+          });
+          return;
+        }
+        resolve({
+          rect: {
+            id: nativeTag,
+            x: pageX,
+            y: pageY,
+            width,
+            height,
+            color,
+            count
+          },
+          stateNode,
+          color,
+          count
+        });
+      });
+    } catch (error) {
+      resolve({
+        rect: null,
+        stateNode,
+        color,
+        count
+      });
+    }
+  }));
+  Promise.all(measurePromises).then(results => {
+    const validResults = results.filter(r => r.rect !== null);
+    const rects = validResults.map(r => r.rect);
+
+    // Mark measurement phase complete
+    perfTimer.markMeasurementComplete(validResults.length, results.length - validResults.length);
+
+    // Track renders - behavior differs based on what's enabled:
+    // - globalEnabled (visual tool): full tracking with storage and list updates
+    // - backgroundTrackingEnabled only (Events tool): emit events only, no storage
+    const settings = RenderTracker.getSettings();
+    const trackCauses = settings.trackRenderCauses && settings.showRenderCount;
+    let batchNativeTags = null;
+    if (trackCauses) {
+      batchNativeTags = new Set();
+      for (const {
+        rect
+      } of validResults) {
+        if (rect) {
+          batchNativeTags.add(rect.id);
+        }
+      }
+    }
+    if (globalEnabled) {
+      // Visual tool is on - full tracking with storage and list notifications
+      RenderTracker.startBatch();
+      for (const {
+        rect,
+        stateNode,
+        color,
+        count
+      } of validResults) {
+        if (rect) {
+          const componentInfo = extractComponentInfo(stateNode);
+          let renderCause;
+          if (trackCauses && batchNativeTags) {
+            const node = stateNode;
+            const fiber = node?.canonical?.internalInstanceHandle;
+            renderCause = detectRenderCause(rect.id, fiber, batchNativeTags, settings.debugLogLevel);
+          }
+          RenderTracker.trackRender({
+            nativeTag: rect.id,
+            viewType: componentInfo.viewType,
+            testID: componentInfo.testID,
+            nativeID: componentInfo.nativeID,
+            accessibilityLabel: componentInfo.accessibilityLabel,
+            componentName: componentInfo.componentName,
+            measurements: {
+              x: rect.x,
+              y: rect.y,
+              width: rect.width,
+              height: rect.height
+            },
+            color,
+            count,
+            renderCause
+          });
+        }
+      }
+      RenderTracker.endBatch();
+    } else {
+      // Only background tracking (Events tool) - emit events without storage
+      for (const {
+        rect,
+        stateNode,
+        color,
+        count
+      } of validResults) {
+        if (rect) {
+          const componentInfo = extractComponentInfo(stateNode);
+          let renderCause;
+          if (trackCauses && batchNativeTags) {
+            const node = stateNode;
+            const fiber = node?.canonical?.internalInstanceHandle;
+            renderCause = detectRenderCause(rect.id, fiber, batchNativeTags, settings.debugLogLevel);
+          }
+          RenderTracker.emitRenderEvent({
+            nativeTag: rect.id,
+            viewType: componentInfo.viewType,
+            testID: componentInfo.testID,
+            nativeID: componentInfo.nativeID,
+            accessibilityLabel: componentInfo.accessibilityLabel,
+            componentName: componentInfo.componentName,
+            measurements: {
+              x: rect.x,
+              y: rect.y,
+              width: rect.width,
+              height: rect.height
+            },
+            color,
+            count,
+            renderCause
+          });
+        }
+      }
+    }
+
+    // Mark tracking phase complete
+    perfTimer.markTrackingComplete();
+
+    // Only show visual highlights when the visual tool is enabled (not just background tracking)
+    if (rects.length > 0 && highlightCallback && globalEnabled) {
+      highlightCallback(rects);
+    }
+
+    // Mark callback phase complete and finish timing
+    perfTimer.markCallbackComplete();
+    perfTimer.finish();
+  }).catch(error => {
+    console.error("[HighlightUpdates] Error in measurement pipeline:", error);
+    perfTimer.finish(); // Still log timing even on error
+  });
+}
+
+/**
+ * Enable or disable trace updates on all renderer interfaces.
+ * This is the key function that makes standalone tracing work!
+ *
+ * The rendererInterfaces map contains the renderer backend for each React root.
+ * Each renderer has a setTraceUpdatesEnabled function that controls whether
+ * it emits 'traceUpdates' events when components re-render.
+ *
+ * See: react-devtools-core/dist/backend.js line 15487-15489
+ */
+function setTraceUpdatesOnRenderers(enabled) {
+  if (!hook?.rendererInterfaces) {
+    debugLog("No rendererInterfaces available");
+    return;
+  }
+  let count = 0;
+  hook.rendererInterfaces.forEach((rendererInterface, rendererId) => {
+    if (typeof rendererInterface.setTraceUpdatesEnabled === "function") {
+      try {
+        rendererInterface.setTraceUpdatesEnabled(enabled);
+        count++;
+        debugLog(`Renderer ${rendererId}: setTraceUpdatesEnabled(${enabled})`);
+      } catch (error) {
+        debugLog(`Renderer ${rendererId}: error setting trace updates`, error);
+      }
+    } else {
+      debugLog(`Renderer ${rendererId}: no setTraceUpdatesEnabled method`);
+    }
+  });
+  debugLog(`Set trace updates ${enabled ? "enabled" : "disabled"} on ${count} renderer(s)`);
+
+  // Also try the agent if available (in case DevTools is connected)
+  if (hook.reactDevtoolsAgent?.setTraceUpdatesEnabled) {
+    try {
+      hook.reactDevtoolsAgent.setTraceUpdatesEnabled(enabled);
+      debugLog("Also set trace updates on agent");
+    } catch (error) {
+      debugLog("Error setting trace updates on agent", error);
+    }
+  }
+}
+
+/**
+ * Subscribe to the traceUpdates event from the hook
+ */
+function subscribeToTraceUpdates() {
+  if (!hook) return;
+  if (traceUpdatesUnsubscribe) return; // Already subscribed
+
+  debugLog("Subscribing to traceUpdates event");
+
+  // The hook uses EventEmitter pattern with 'sub' method
+  // See: react-devtools-core/dist/backend.js line 17526
+  // hook.sub('traceUpdates', agent.onTraceUpdates)
+  if (typeof hook.sub === "function") {
+    traceUpdatesUnsubscribe = hook.sub("traceUpdates", handleTraceUpdates);
+    debugLog("Subscribed using hook.sub()");
+  } else {
+    debugLog("hook.sub not available, traceUpdates may not work");
+  }
+
+  // CRITICAL: Enable trace updates on all renderers
+  // Without this, the renderers won't emit traceUpdates events
+  setTraceUpdatesOnRenderers(true);
+}
+
+/**
+ * Unsubscribe from the traceUpdates event
+ */
+function unsubscribeFromTraceUpdates() {
+  // Disable trace updates on renderers first
+  setTraceUpdatesOnRenderers(false);
+  if (traceUpdatesUnsubscribe) {
+    traceUpdatesUnsubscribe();
+    traceUpdatesUnsubscribe = null;
+    debugLog("Unsubscribed from traceUpdates event");
+  }
+}
+
+/**
+ * Set the callback for rendering highlights
+ */
+function setHighlightCallback(callback) {
+  highlightCallback = callback;
+  debugLog(`Highlight callback ${callback ? "set" : "cleared"}`);
+}
+
+/**
+ * Set the callback for when a badge is pressed.
+ * This is used to navigate to the detail view when a user taps a render count badge.
+ */
+function setBadgePressCallback(callback) {
+  badgePressCallback = callback;
+  debugLog(`Badge press callback ${callback ? "set" : "cleared"}`);
+}
+
+/**
+ * Get the current badge press callback.
+ * Used by the overlay to check if badge presses should be handled.
+ */
+function getBadgePressCallback() {
+  return badgePressCallback;
+}
+
+/**
+ * Handle a badge press event.
+ * Calls the registered callback with the nativeTag of the component.
+ */
+function handleBadgePress(nativeTag) {
+  if (badgePressCallback) {
+    badgePressCallback(nativeTag);
+  }
+}
+
+// Spotlight highlight state - for showing which component is being viewed in detail
+
+let spotlightCallback = null;
+let currentSpotlightTag = null;
+
+/**
+ * Set the callback for spotlight highlighting.
+ * Used by the overlay to show a special highlight for the component being viewed.
+ */
+function setSpotlightCallback(callback) {
+  spotlightCallback = callback;
+  // If there's an existing spotlight, notify the new callback
+  if (callback && currentSpotlightTag !== null) {
+    callback(currentSpotlightTag);
+  }
+}
+
+/**
+ * Set a spotlight highlight on a specific component.
+ * This is used when viewing a component's detail to show which one it is.
+ */
+function setSpotlight(nativeTag) {
+  currentSpotlightTag = nativeTag;
+  if (spotlightCallback) {
+    spotlightCallback(nativeTag);
+  }
+}
+
+/**
+ * Get the current spotlight nativeTag.
+ */
+function getSpotlight() {
+  return currentSpotlightTag;
+}
+function notifyStateListeners() {
+  stateListeners.forEach(listener => {
+    try {
+      listener(globalEnabled);
+    } catch (error) {
+      console.error("[HighlightUpdates] Error in state listener:", error);
+    }
+  });
+}
+function subscribe(listener) {
+  stateListeners.add(listener);
+  listener(globalEnabled);
+  return () => {
+    stateListeners.delete(listener);
+  };
+}
+function initialize() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) {
+    debugLog("Only available in development builds");
+    return false;
+  }
+  if (initialized) {
+    return true;
+  }
+  hook = window?.__REACT_DEVTOOLS_GLOBAL_HOOK__ || null;
+  if (!hook) {
+    debugLog("React DevTools hook not found");
+    return false;
+  }
+  debugLog("Hook found");
+  debugLog(`Hook has sub: ${typeof hook.sub === "function"}`);
+  debugLog(`Hook has on: ${typeof hook.on === "function"}`);
+  debugLog(`Hook has emit: ${typeof hook.emit === "function"}`);
+
+  // Install profiler interceptor to capture what DevTools detects
+  // This allows us to compare profiler data with our detection
+  installProfilerInterceptor();
+
+  // Comparison callback available for future use when we re-enable our implementation
+  // setComparisonCallback((profilerNodes: Set<unknown>) => {
+  //   debugLog(`[COMPARISON] Profiler detected ${profilerNodes.size} nodes`);
+  // });
+
+  if (hook.rendererInterfaces && hook.rendererInterfaces.size > 0) {
+    initialized = true;
+    debugLog(`Initialized with ${hook.rendererInterfaces.size} renderer(s)`);
+    exposeGlobally();
+    return true;
+  }
+
+  // Wait for renderer to be available
+  const checkInterval = setInterval(() => {
+    if (hook?.rendererInterfaces && hook.rendererInterfaces.size > 0) {
+      clearInterval(checkInterval);
+      initialized = true;
+      debugLog(`Initialized with ${hook.rendererInterfaces.size} renderer(s) (delayed)`);
+      exposeGlobally();
+    }
+  }, 100);
+  setTimeout(() => clearInterval(checkInterval), 10000);
+  return false;
+}
+function exposeGlobally() {
+  if (typeof window !== "undefined") {
+    window.__HIGHLIGHT_UPDATES_CONTROLLER__ = {
+      enable,
+      disable,
+      toggle,
+      isEnabled,
+      setEnabled,
+      subscribe,
+      initialize,
+      destroy,
+      isInitialized: () => initialized,
+      setHighlightCallback
+    };
+  }
+}
+function enable() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) return;
+  if (!initialized) {
+    initialize();
+  }
+  if (globalEnabled) {
+    return;
+  }
+  debugLog("Enabling highlights");
+
+  // Only subscribe if not already subscribed via background tracking
+  if (!backgroundTrackingEnabled) {
+    subscribeToTraceUpdates();
+  }
+
+  // Start tracking renders
+  RenderTracker.start();
+
+  // Note: profiler logging disabled for normal operation
+  // enableProfilerLogging();
+
+  globalEnabled = true;
+  notifyStateListeners();
+  notifySubscriberCountChange('render');
+}
+function disable() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) return;
+  if (!globalEnabled) {
+    return;
+  }
+  debugLog("Disabling highlights");
+
+  // Clear any pending locks/state
+  renderingLock = false;
+  isProcessing = false;
+  if (renderingLockTimeout) {
+    clearTimeout(renderingLockTimeout);
+    renderingLockTimeout = null;
+  }
+  renderedOverlayTags.clear();
+  devToolsNodeCache.clear(); // Clear detection cache
+  clearRenderCauseState(); // Clear render cause state to prevent memory leaks
+
+  // Only unsubscribe if background tracking doesn't need it
+  if (!backgroundTrackingEnabled) {
+    unsubscribeFromTraceUpdates();
+  }
+
+  // Stop tracking renders
+  RenderTracker.stop();
+
+  // Note: profiler logging disabled for normal operation
+  // disableProfilerLogging();
+
+  globalEnabled = false;
+  notifyStateListeners();
+  notifySubscriberCountChange('render');
+}
+
+/**
+ * Enable background render tracking (for Events tool).
+ * This enables render interception WITHOUT affecting the visual toggle state.
+ * The visual highlight toggle remains independent.
+ */
+function enableBackgroundTracking() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) return;
+  if (backgroundTrackingEnabled) {
+    return;
+  }
+  if (!initialized) {
+    initialize();
+  }
+  debugLog("Enabling background tracking");
+
+  // Only subscribe if not already subscribed via main toggle
+  if (!globalEnabled) {
+    subscribeToTraceUpdates();
+  }
+  backgroundTrackingEnabled = true;
+}
+
+/**
+ * Disable background render tracking (for Events tool).
+ * Only actually unsubscribes if the main toggle is also off.
+ */
+function disableBackgroundTracking() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) return;
+  if (!backgroundTrackingEnabled) {
+    return;
+  }
+  debugLog("Disabling background tracking");
+  backgroundTrackingEnabled = false;
+
+  // Only unsubscribe if main toggle is also off
+  if (!globalEnabled) {
+    unsubscribeFromTraceUpdates();
+  }
+}
+
+/**
+ * Check if background tracking is enabled (for debugging)
+ */
+function isBackgroundTrackingEnabled() {
+  return backgroundTrackingEnabled;
+}
+function toggle() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) return;
+  if (globalEnabled) {
+    disable();
+  } else {
+    enable();
+  }
+}
+
+/**
+ * Clear all render counts and tracked data
+ */
+function clearRenderCounts() {
+  nodeRenderCounts.clear();
+  RenderTracker.clear();
+  debugLog("Cleared render counts");
+}
+function isEnabled() {
+  return globalEnabled;
+}
+function setEnabled(enabled) {
+  if (enabled) enable();else disable();
+}
+function isInitialized() {
+  return initialized;
+}
+
+// ============================================================================
+// FREEZE FRAME MODE
+// ============================================================================
+
+/**
+ * Notify all freeze state listeners of a change
+ */
+function notifyFreezeListeners() {
+  freezeListeners.forEach(listener => {
+    try {
+      listener(isFrozen);
+    } catch (error) {
+      console.error("[HighlightUpdates] Error in freeze listener:", error);
+    }
+  });
+}
+
+/**
+ * Subscribe to freeze state changes
+ */
+function subscribeToFreeze(listener) {
+  freezeListeners.add(listener);
+  listener(isFrozen);
+  return () => {
+    freezeListeners.delete(listener);
+  };
+}
+
+/**
+ * Freeze highlights - prevents highlights from fading away.
+ * New renders are still captured but old highlights don't clear.
+ */
+function freeze() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) return;
+  if (isFrozen) return;
+  isFrozen = true;
+  debugLog("Freeze mode enabled");
+  notifyFreezeListeners();
+}
+
+/**
+ * Unfreeze highlights - resumes normal cleanup behavior.
+ * Clears all current highlights when unfreezing.
+ */
+function unfreeze() {
+  if (typeof __DEV__ !== "undefined" && !__DEV__) return;
+  if (!isFrozen) return;
+  isFrozen = false;
+  debugLog("Freeze mode disabled");
+
+  // Clear all current highlights when unfreezing
+  if (highlightCallback) {
+    highlightCallback([]);
+  }
+  notifyFreezeListeners();
+}
+
+/**
+ * Toggle freeze state
+ */
+function toggleFreeze() {
+  if (isFrozen) {
+    unfreeze();
+  } else {
+    freeze();
+  }
+}
+
+/**
+ * Check if freeze mode is active
+ */
+function getFrozen() {
+  return isFrozen;
+}
+function destroy() {
+  if (!initialized) return;
+  unsubscribeFromTraceUpdates();
+
+  // Uninstall profiler interceptor
+  uninstallProfilerInterceptor();
+  setComparisonCallback(null);
+
+  // Reset freeze state
+  isFrozen = false;
+  freezeListeners.clear();
+  globalEnabled = false;
+  hook = null;
+  highlightCallback = null;
+  initialized = false;
+  if (typeof window !== "undefined") {
+    delete window.__HIGHLIGHT_UPDATES_CONTROLLER__;
+  }
+  debugLog("Destroyed");
+}
+const HighlightUpdatesController = {
+  subscribe,
+  enable,
+  disable,
+  toggle,
+  isEnabled,
+  setEnabled,
+  initialize,
+  destroy,
+  isInitialized,
+  setHighlightCallback,
+  clearRenderCounts,
+  // Freeze frame mode
+  freeze,
+  unfreeze,
+  toggleFreeze,
+  getFrozen,
+  subscribeToFreeze,
+  // Badge press callback for "Click Overlay Badge → Jump to Detail"
+  setBadgePressCallback,
+  getBadgePressCallback,
+  handleBadgePress,
+  // Spotlight highlight for detail view
+  setSpotlightCallback,
+  setSpotlight,
+  getSpotlight,
+  // Cache management for excludeDevTools toggle
+  clearDevToolsCache,
+  // Background tracking for Events tool (separate from visual toggle)
+  enableBackgroundTracking,
+  disableBackgroundTracking,
+  isBackgroundTrackingEnabled
+};
+export default HighlightUpdatesController;