@buoy-gg/highlight-updates 2.1.2 → 2.1.3

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

@@ -42,6 +42,8 @@ export interface RenderCause {
     timestamp: number;
     componentCause?: ComponentCauseType;
     componentName?: string;
+    /** Parent component that triggered this re-render (for cascade visualization) */
+    parentComponentName?: string;
 }
 /**
  * A single render event in the history
@@ -103,6 +105,8 @@ type StateListener = (state: {
 }) => void;
 type SettingsListener = (settings: RenderTrackerSettings) => void;
 type FilterListener = (filters: FilterConfig) => void;
+/** Callback for individual render events (for unified events integration) */
+type RenderEventCallback = (event: RenderEvent, render: TrackedRender) => void;
 export interface RenderTrackerSettings {
     /**
      * Maximum number of components to highlight per batch.
@@ -171,6 +175,17 @@ export interface RenderTrackerSettings {
      * Default: "off"
      */
     debugLogLevel: DebugLogLevel;
+    /**
+     * Whether to exclude other dev tools components from highlighting.
+     * When true (default), all Buoy dev tools components (floating menu, modals,
+     * settings, etc.) are excluded from highlighting.
+     * When false, only the Highlight Updates overlay itself is excluded
+     * (to prevent infinite loops), but other dev tools will show highlights.
+     *
+     * Use this to debug and optimize the dev tools themselves.
+     * Default: true
+     */
+    excludeDevTools: boolean;
 }
 declare class RenderTrackerSingleton {
     private renders;
@@ -178,6 +193,8 @@ declare class RenderTrackerSingleton {
     private stateListeners;
     private settingsListeners;
     private filterListeners;
+    /** Callbacks for individual render events (unified events integration) */
+    private renderEventCallbacks;
     private isTracking;
     private isPaused;
     private settings;
@@ -210,6 +227,31 @@ declare class RenderTrackerSingleton {
      * Add a render event to a component's history (circular buffer)
      */
     private addRenderEvent;
+    /**
+     * Notify all render event callbacks
+     */
+    private notifyRenderEventCallbacks;
+    /**
+     * Emit a render event to callbacks only (without storing in the render list).
+     * Used by Events tool when visual highlights are off - we want events but not list updates.
+     */
+    emitRenderEvent(data: {
+        nativeTag: number;
+        viewType: string;
+        testID?: string;
+        nativeID?: string;
+        accessibilityLabel?: string;
+        componentName?: string;
+        measurements?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        color: string;
+        count: number;
+        renderCause?: RenderCause;
+    }): void;
     /**
      * Start batch mode - defers listener notifications until endBatch() is called.
      * Use this when tracking multiple renders in a loop to avoid O(n²) notifications.
@@ -355,6 +397,18 @@ declare class RenderTrackerSingleton {
      * Subscribe to filter changes
      */
     subscribeToFilters(listener: FilterListener): () => void;
+    /**
+     * Subscribe to individual render events as they occur.
+     * Used by unified events system to integrate render events into the timeline.
+     *
+     * @param callback - Called for each render event with the event and component info
+     * @returns Unsubscribe function
+     */
+    onRenderEvent(callback: RenderEventCallback): () => void;
+    /**
+     * Get the number of render event callbacks (for debugging)
+     */
+    getRenderEventCallbackCount(): number;
     /**
      * Check if a render should be visible based on current filters
      * Used by the overlay to filter frozen highlights

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

@@ -0,0 +1,11 @@
+/**
+ * Render Export Formatter
+ *
+ * Simple JSON export for render tracking data.
+ */
+import type { TrackedRender } from "./RenderTracker";
+/**
+ * Generate JSON export of all tracked renders
+ */
+export declare function generateRendersJson(renders: TrackedRender[]): string;
+//# sourceMappingURL=renderExportFormatter.d.ts.map

package/lib/typescript/index.d.ts

@@ -29,7 +29,8 @@ export { default as HighlightUpdatesController } from "./highlight-updates/utils
 export { HighlightUpdatesOverlay } from "./highlight-updates/HighlightUpdatesOverlay";
 export { installProfilerInterceptor, uninstallProfilerInterceptor, setComparisonCallback, isInterceptorInstalled, enableProfilerLogging, disableProfilerLogging, isLoggingEnabled, } from "./highlight-updates/utils/ProfilerInterceptor";
 export { RenderTracker } from "./highlight-updates/utils/RenderTracker";
-export type { TrackedRender, FilterConfig, RenderTrackerSettings, RenderCause, RenderCauseType, ComponentCauseType, RenderEvent, } from "./highlight-updates/utils/RenderTracker";
+export type { TrackedRender, FilterConfig, RenderTrackerSettings, RenderCause, RenderCauseType, ComponentCauseType, RenderEvent, HookStateChange, } from "./highlight-updates/utils/RenderTracker";
+export declare const onRenderEvent: (callback: (event: import("./highlight-updates/utils/RenderTracker").RenderEvent, render: import("./highlight-updates/utils/RenderTracker").TrackedRender) => void) => any;
 export { detectRenderCause, clearRenderCauseState, removeRenderCauseState, getRenderCauseStats, safeCloneForHistory, capturePropsSnapshot, captureStateSnapshot, } from "./highlight-updates/utils/RenderCauseDetector";
 export { PerformanceLogger } from "./highlight-updates/utils/PerformanceLogger";
 export type { BatchMetrics, BatchTimer } from "./highlight-updates/utils/PerformanceLogger";
@@ -40,4 +41,5 @@ export { RenderDetailView } from "./highlight-updates/components/RenderDetailVie
 export { HighlightFilterView } from "./highlight-updates/components/HighlightFilterView";
 export { RenderCauseBadge, TwoLevelCauseBadge, CAUSE_CONFIG, COMPONENT_CAUSE_CONFIG, } from "./highlight-updates/components/RenderCauseBadge";
 export { RenderHistoryViewer, RenderHistoryFooter, } from "./highlight-updates/components/RenderHistoryViewer";
+export { generateRendersJson, } from "./highlight-updates/utils/renderExportFormatter";
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/highlight-updates",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Control React DevTools highlight updates feature from your app",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -26,14 +26,14 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/shared-ui": "2.1.2",
-    "@buoy-gg/floating-tools-core": "2.1.2"
+    "@buoy-gg/shared-ui": "2.1.3",
+    "@buoy-gg/floating-tools-core": "2.1.3"
   },
   "peerDependencies": {
     "@buoy-gg/license": "*",
     "react": "*",
     "react-native": "*",
-    "@buoy-gg/core": "2.1.2"
+    "@buoy-gg/core": "2.1.3"
   },
   "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": "2.1.2",
-    "@buoy-gg/license": "2.1.2"
+    "@buoy-gg/core": "2.1.3",
+    "@buoy-gg/license": "2.1.3"
   },
   "react-native-builder-bob": {
     "source": "src",