@buoy-gg/highlight-updates 7.0.41 → 7.0.42

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

@@ -1,359 +1,26 @@
-/**
- * PerformanceLogger
- *
- * Dedicated performance measurement utility for the Highlight Updates feature.
- * Tracks timing metrics across the render detection pipeline to identify bottlenecks
- * and measure optimization improvements.
- *
- * Usage:
- *   PerformanceLogger.setEnabled(true);  // Enable logging
- *   const batch = PerformanceLogger.startBatch(nodesReceived);
- *   batch.markFilteringComplete(nodesFiltered, nodesToProcess);
- *   batch.markMeasurementComplete(successCount, failCount);
- *   batch.markTrackingComplete();
- *   batch.markCallbackComplete();
- *   batch.finish();  // Logs the complete metrics
- */
-
-"use strict";
-
-// Declare performance API available in React Native's JavaScript environment
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = exports.PerformanceLogger = void 0;
-exports.markEventReceived = markEventReceived;
-exports.markOverlayRendered = markOverlayRendered;
-// Track the last event timestamp to measure end-to-end latency
-let lastEventTimestamp = 0;
-let pendingBatchId = null;
-
-/**
- * Call this when a traceUpdates event is received to track end-to-end latency
- */
-function markEventReceived() {
-  lastEventTimestamp = performance.now();
-  return lastEventTimestamp;
-}
-
-/**
- * Call this from the overlay when highlights are actually rendered
- */
-function markOverlayRendered(highlightCount, renderTime) {
-  if (lastEventTimestamp > 0 && highlightCount > 0) {
-    // Reset to avoid double-counting (end-to-end logging removed - silent by default)
-    lastEventTimestamp = 0;
-  }
-}
-
-// Rolling statistics for summary logging
-
-class PerformanceLoggerSingleton {
-  enabled = false;
-  batchCounter = 0;
-  listeners = new Set();
-
-  // Rolling stats for periodic summaries
-  rollingStats = {
-    batchCount: 0,
-    totalNodes: 0,
-    totalFiltered: 0,
-    totalProcessed: 0,
-    totalTime: 0,
-    maxTime: 0,
-    minTime: Infinity,
-    avgMeasurementTime: 0
-  };
-
-  // Recent batch history for analysis
-  recentBatches = [];
-  MAX_HISTORY = 100;
-
-  // Summary logging interval
-  summaryInterval = null;
-  SUMMARY_INTERVAL_MS = 10000; // Log summary every 10s
-
-  /**
-   * Enable or disable performance logging
-   */
-  setEnabled(enabled) {
-    const wasEnabled = this.enabled;
-    this.enabled = enabled;
-    if (enabled && !wasEnabled) {
-      this.resetStats();
-      // Summary interval removed - no periodic logging
-    } else if (!enabled && wasEnabled) {
-      this.stopSummaryInterval();
-    }
-    // Silent enable/disable - no console logs
-  }
-
-  /**
-   * Check if logging is enabled
-   */
-  isEnabled() {
-    return this.enabled;
-  }
-
-  /**
-   * Start timing a new batch of render updates
-   */
-  startBatch(nodesReceived, batchSize) {
-    const batchId = `batch_${++this.batchCounter}`;
-    const startTime = performance.now();
-    let filteringEndTime = null;
-    let measurementStartTime = null;
-    let measurementEndTime = null;
-    let trackingEndTime = null;
-    let callbackEndTime = null;
-    let nodesFiltered = 0;
-    let nodesToProcess = 0;
-    let measurementSuccessCount = 0;
-    let measurementFailCount = 0;
-    let overlayRenderTime;
-    const timer = {
-      markFilteringComplete: (filtered, toProcess) => {
-        filteringEndTime = performance.now();
-        nodesFiltered = filtered;
-        nodesToProcess = toProcess;
-      },
-      markMeasurementStart: () => {
-        measurementStartTime = performance.now();
-      },
-      markMeasurementComplete: (success, fail) => {
-        measurementEndTime = performance.now();
-        measurementSuccessCount = success;
-        measurementFailCount = fail;
-      },
-      markTrackingComplete: () => {
-        trackingEndTime = performance.now();
-      },
-      markCallbackComplete: () => {
-        callbackEndTime = performance.now();
-      },
-      setOverlayRenderTime: timeMs => {
-        overlayRenderTime = timeMs;
-      },
-      getBatchId: () => batchId,
-      finish: () => {
-        const endTime = performance.now();
-        const metrics = {
-          batchId,
-          timestamp: Date.now(),
-          nodesReceived,
-          nodesFiltered,
-          nodesToProcess,
-          batchSize,
-          nodesInBatch: Math.min(nodesToProcess, batchSize),
-          filteringTime: filteringEndTime ? filteringEndTime - startTime : 0,
-          measurementTime: measurementStartTime && measurementEndTime ? measurementEndTime - measurementStartTime : 0,
-          trackingTime: measurementEndTime && trackingEndTime ? trackingEndTime - measurementEndTime : 0,
-          callbackTime: trackingEndTime && callbackEndTime ? callbackEndTime - trackingEndTime : 0,
-          totalTime: endTime - startTime,
-          measurementSuccessCount,
-          measurementFailCount,
-          overlayRenderTime
-        };
-        if (this.enabled) {
-          this.recordMetrics(metrics);
-        }
-        return metrics;
-      }
-    };
-    return timer;
-  }
-
-  /**
-   * Record metrics and log them
-   */
-  recordMetrics(metrics) {
-    // Update rolling stats
-    this.rollingStats.batchCount++;
-    this.rollingStats.totalNodes += metrics.nodesReceived;
-    this.rollingStats.totalFiltered += metrics.nodesFiltered;
-    this.rollingStats.totalProcessed += metrics.nodesInBatch;
-    this.rollingStats.totalTime += metrics.totalTime;
-    this.rollingStats.maxTime = Math.max(this.rollingStats.maxTime, metrics.totalTime);
-    this.rollingStats.minTime = Math.min(this.rollingStats.minTime, metrics.totalTime);
-
-    // Update rolling average for measurement time
-    const prevAvg = this.rollingStats.avgMeasurementTime;
-    const n = this.rollingStats.batchCount;
-    this.rollingStats.avgMeasurementTime = prevAvg + (metrics.measurementTime - prevAvg) / n;
-
-    // Store in history
-    this.recentBatches.push(metrics);
-    if (this.recentBatches.length > this.MAX_HISTORY) {
-      this.recentBatches.shift();
-    }
-
-    // Notify listeners
-    this.notifyListeners(metrics);
-  }
-
-  /**
-   * Log a single batch's metrics
-   */
-  logBatch(metrics) {
-    const {
-      batchId,
-      nodesReceived,
-      nodesFiltered,
-      nodesInBatch,
-      batchSize,
-      filteringTime,
-      measurementTime,
-      trackingTime,
-      callbackTime,
-      totalTime,
-      measurementSuccessCount,
-      measurementFailCount,
-      overlayRenderTime
-    } = metrics;
-
-    // Compact single-line log for quick scanning
-    console.log(`[HighlightPerf] ${batchId} | ` + `In:${nodesReceived} Filt:${nodesFiltered} Proc:${nodesInBatch}/${batchSize} | ` + `Filter:${filteringTime.toFixed(1)}ms Measure:${measurementTime.toFixed(1)}ms ` + `Track:${trackingTime.toFixed(1)}ms Callback:${callbackTime.toFixed(1)}ms | ` + `Total:${totalTime.toFixed(1)}ms` + (overlayRenderTime ? ` Render:${overlayRenderTime.toFixed(1)}ms` : "") + ` | Success:${measurementSuccessCount} Fail:${measurementFailCount}`);
-
-    // Flag slow batches
-    if (totalTime > 100) {
-      console.warn(`[HighlightPerf] ⚠️ SLOW BATCH: ${totalTime.toFixed(1)}ms - ` + `Measurement phase: ${measurementTime.toFixed(1)}ms (${(measurementTime / totalTime * 100).toFixed(0)}%)`);
-    }
-  }
-
-  /**
-   * Log periodic summary stats
-   */
-  logSummary() {
-    if (this.rollingStats.batchCount === 0) return;
-    const stats = this.rollingStats;
-    const avgTime = stats.totalTime / stats.batchCount;
-    const avgNodes = stats.totalNodes / stats.batchCount;
-    console.log(`\n[HighlightPerf] ════════ SUMMARY (last ${this.SUMMARY_INTERVAL_MS / 1000}s) ════════\n` + `  Batches: ${stats.batchCount}\n` + `  Avg nodes/batch: ${avgNodes.toFixed(1)} (filtered: ${(stats.totalFiltered / stats.batchCount).toFixed(1)})\n` + `  Avg total time: ${avgTime.toFixed(1)}ms\n` + `  Avg measurement time: ${stats.avgMeasurementTime.toFixed(1)}ms\n` + `  Min/Max time: ${stats.minTime.toFixed(1)}ms / ${stats.maxTime.toFixed(1)}ms\n` + `══════════════════════════════════════════════\n`);
-
-    // Reset rolling stats for next interval
-    this.resetStats();
-  }
-
-  /**
-   * Reset rolling statistics
-   */
-  resetStats() {
-    this.rollingStats = {
-      batchCount: 0,
-      totalNodes: 0,
-      totalFiltered: 0,
-      totalProcessed: 0,
-      totalTime: 0,
-      maxTime: 0,
-      minTime: Infinity,
-      avgMeasurementTime: 0
-    };
-  }
-
-  /**
-   * Start the summary logging interval
-   */
-  startSummaryInterval() {
-    this.stopSummaryInterval();
-    this.summaryInterval = setInterval(() => {
-      this.logSummary();
-    }, this.SUMMARY_INTERVAL_MS);
-  }
-
-  /**
-   * Stop the summary logging interval
-   */
-  stopSummaryInterval() {
-    if (this.summaryInterval) {
-      clearInterval(this.summaryInterval);
-      this.summaryInterval = null;
-    }
-  }
-
-  /**
-   * Subscribe to metrics updates
-   */
-  subscribe(listener) {
-    this.listeners.add(listener);
-    return () => {
-      this.listeners.delete(listener);
-    };
-  }
-
-  /**
-   * Notify all listeners of new metrics
-   */
-  notifyListeners(metrics) {
-    for (const listener of this.listeners) {
-      try {
-        listener(metrics);
-      } catch (error) {
-        console.error("[HighlightPerf] Error in metrics listener:", error);
-      }
-    }
-  }
-
-  /**
-   * Get recent batch history
-   */
-  getRecentBatches() {
-    return [...this.recentBatches];
-  }
-
-  /**
-   * Get current rolling stats
-   */
-  getRollingStats() {
-    return {
-      ...this.rollingStats
-    };
-  }
-
-  /**
-   * Clear all history and stats
-   */
-  clear() {
-    this.recentBatches = [];
-    this.resetStats();
-    this.batchCounter = 0;
-  }
-
-  /**
-   * Generate a detailed report of recent performance
-   */
-  generateReport() {
-    const batches = this.recentBatches;
-    if (batches.length === 0) {
-      return "No performance data collected yet.";
-    }
-    const totalTime = batches.reduce((sum, b) => sum + b.totalTime, 0);
-    const avgTime = totalTime / batches.length;
-    const totalMeasureTime = batches.reduce((sum, b) => sum + b.measurementTime, 0);
-    const avgMeasureTime = totalMeasureTime / batches.length;
-    const slowBatches = batches.filter(b => b.totalTime > 100);
-    const fastBatches = batches.filter(b => b.totalTime < 20);
-    const report = `
-╔══════════════════════════════════════════════════════════════╗
-║              HIGHLIGHT UPDATES PERFORMANCE REPORT            ║
-╠══════════════════════════════════════════════════════════════╣
-║ Total batches analyzed: ${batches.length.toString().padStart(5)}                              ║
-║ Average total time:     ${avgTime.toFixed(1).padStart(5)}ms                             ║
-║ Average measure time:   ${avgMeasureTime.toFixed(1).padStart(5)}ms (${(avgMeasureTime / avgTime * 100).toFixed(0)}% of total)           ║
-╠══════════════════════════════════════════════════════════════╣
-║ Fast batches (<20ms):   ${fastBatches.length.toString().padStart(5)} (${(fastBatches.length / batches.length * 100).toFixed(0)}%)                          ║
-║ Slow batches (>100ms):  ${slowBatches.length.toString().padStart(5)} (${(slowBatches.length / batches.length * 100).toFixed(0)}%)                          ║
-╠══════════════════════════════════════════════════════════════╣
-║ Time breakdown (avg):                                        ║
-║   Filtering:    ${batches.reduce((s, b) => s + b.filteringTime, 0 / batches.length).toFixed(1).padStart(6)}ms                                    ║
-║   Measurement:  ${avgMeasureTime.toFixed(1).padStart(6)}ms  ← Primary bottleneck              ║
-║   Tracking:     ${(batches.reduce((s, b) => s + b.trackingTime, 0) / batches.length).toFixed(1).padStart(6)}ms                                    ║
-║   Callback:     ${(batches.reduce((s, b) => s + b.callbackTime, 0) / batches.length).toFixed(1).padStart(6)}ms                                    ║
-╚══════════════════════════════════════════════════════════════╝
-`;
-    return report;
-  }
-}
-
-// Export singleton instance
-const PerformanceLogger = exports.PerformanceLogger = new PerformanceLoggerSingleton();
-var _default = exports.default = PerformanceLogger;
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=exports.PerformanceLogger=void 0;exports.markEventReceived=markEventReceived;exports.markOverlayRendered=markOverlayRendered;let lastEventTimestamp=0;let pendingBatchId=null;function markEventReceived(){lastEventTimestamp=performance.now();return lastEventTimestamp}function markOverlayRendered(S,e){if(lastEventTimestamp>0&&S>0){lastEventTimestamp=0}}class PerformanceLoggerSingleton{enabled=false;batchCounter=0;listeners=new Set;rollingStats={batchCount:0,totalNodes:0,totalFiltered:0,totalProcessed:0,totalTime:0,maxTime:0,minTime:Infinity,avgMeasurementTime:0};recentBatches=[];MAX_HISTORY=100;summaryInterval=null;SUMMARY_INTERVAL_MS=1e4;setEnabled(e){const a=this.enabled;this.enabled=e;if(e&&!a){this.resetStats()}else if(!e&&a){this.stopSummaryInterval()}}isEnabled(){return this.enabled}startBatch(e,a){const r=`batch_${++this.batchCounter}`;const h=performance.now();let o=null;let l=null;let s=null;let i=null;let t=null;let n=0;let m=0;let u=0;let T=0;let g;const f={markFilteringComplete:(c,d)=>{o=performance.now();n=c;m=d},markMeasurementStart:()=>{l=performance.now()},markMeasurementComplete:(c,d)=>{s=performance.now();u=c;T=d},markTrackingComplete:()=>{i=performance.now()},markCallbackComplete:()=>{t=performance.now()},setOverlayRenderTime:c=>{g=c},getBatchId:()=>r,finish:()=>{const c=performance.now();const d={batchId:r,timestamp:Date.now(),nodesReceived:e,nodesFiltered:n,nodesToProcess:m,batchSize:a,nodesInBatch:Math.min(m,a),filteringTime:o?o-h:0,measurementTime:l&&s?s-l:0,trackingTime:s&&i?i-s:0,callbackTime:i&&t?t-i:0,totalTime:c-h,measurementSuccessCount:u,measurementFailCount:T,overlayRenderTime:g};if(this.enabled){this.recordMetrics(d)}return d}};return f}recordMetrics(e){this.rollingStats.batchCount++;this.rollingStats.totalNodes+=e.nodesReceived;this.rollingStats.totalFiltered+=e.nodesFiltered;this.rollingStats.totalProcessed+=e.nodesInBatch;this.rollingStats.totalTime+=e.totalTime;this.rollingStats.maxTime=Math.max(this.rollingStats.maxTime,e.totalTime);this.rollingStats.minTime=Math.min(this.rollingStats.minTime,e.totalTime);const a=this.rollingStats.avgMeasurementTime;const r=this.rollingStats.batchCount;this.rollingStats.avgMeasurementTime=a+(e.measurementTime-a)/r;this.recentBatches.push(e);if(this.recentBatches.length>this.MAX_HISTORY){this.recentBatches.shift()}this.notifyListeners(e)}logBatch(e){const{batchId:a,nodesReceived:r,nodesFiltered:h,nodesInBatch:o,batchSize:l,filteringTime:s,measurementTime:i,trackingTime:t,callbackTime:n,totalTime:m,measurementSuccessCount:u,measurementFailCount:T,overlayRenderTime:g}=e;console.log(`[HighlightPerf] ${a} | In:${r} Filt:${h} Proc:${o}/${l} | Filter:${s.toFixed(1)}ms Measure:${i.toFixed(1)}ms Track:${t.toFixed(1)}ms Callback:${n.toFixed(1)}ms | Total:${m.toFixed(1)}ms`+(g?` Render:${g.toFixed(1)}ms`:"")+` | Success:${u} Fail:${T}`);if(m>100){console.warn(`[HighlightPerf] \u26A0\uFE0F SLOW BATCH: ${m.toFixed(1)}ms - Measurement phase: ${i.toFixed(1)}ms (${(i/m*100).toFixed(0)}%)`)}}logSummary(){if(this.rollingStats.batchCount===0)return;const e=this.rollingStats;const a=e.totalTime/e.batchCount;const r=e.totalNodes/e.batchCount;console.log(`
+[HighlightPerf] \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 SUMMARY (last ${this.SUMMARY_INTERVAL_MS/1e3}s) \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
+  Batches: ${e.batchCount}
+  Avg nodes/batch: ${r.toFixed(1)} (filtered: ${(e.totalFiltered/e.batchCount).toFixed(1)})
+  Avg total time: ${a.toFixed(1)}ms
+  Avg measurement time: ${e.avgMeasurementTime.toFixed(1)}ms
+  Min/Max time: ${e.minTime.toFixed(1)}ms / ${e.maxTime.toFixed(1)}ms
+\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
+`);this.resetStats()}resetStats(){this.rollingStats={batchCount:0,totalNodes:0,totalFiltered:0,totalProcessed:0,totalTime:0,maxTime:0,minTime:Infinity,avgMeasurementTime:0}}startSummaryInterval(){this.stopSummaryInterval();this.summaryInterval=setInterval(()=>{this.logSummary()},this.SUMMARY_INTERVAL_MS)}stopSummaryInterval(){if(this.summaryInterval){clearInterval(this.summaryInterval);this.summaryInterval=null}}subscribe(e){this.listeners.add(e);return()=>{this.listeners.delete(e)}}notifyListeners(e){for(const a of this.listeners){try{a(e)}catch(r){console.error("[HighlightPerf] Error in metrics listener:",r)}}}getRecentBatches(){return[...this.recentBatches]}getRollingStats(){return{...this.rollingStats}}clear(){this.recentBatches=[];this.resetStats();this.batchCounter=0}generateReport(){const e=this.recentBatches;if(e.length===0){return"No performance data collected yet."}const a=e.reduce((t,n)=>t+n.totalTime,0);const r=a/e.length;const h=e.reduce((t,n)=>t+n.measurementTime,0);const o=h/e.length;const l=e.filter(t=>t.totalTime>100);const s=e.filter(t=>t.totalTime<20);const i=`
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551              HIGHLIGHT UPDATES PERFORMANCE REPORT            \u2551
+\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563
+\u2551 Total batches analyzed: ${e.length.toString().padStart(5)}                              \u2551
+\u2551 Average total time:     ${r.toFixed(1).padStart(5)}ms                             \u2551
+\u2551 Average measure time:   ${o.toFixed(1).padStart(5)}ms (${(o/r*100).toFixed(0)}% of total)           \u2551
+\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563
+\u2551 Fast batches (<20ms):   ${s.length.toString().padStart(5)} (${(s.length/e.length*100).toFixed(0)}%)                          \u2551
+\u2551 Slow batches (>100ms):  ${l.length.toString().padStart(5)} (${(l.length/e.length*100).toFixed(0)}%)                          \u2551
+\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563
+\u2551 Time breakdown (avg):                                        \u2551
+\u2551   Filtering:    ${e.reduce((t,n)=>t+n.filteringTime,0/e.length).toFixed(1).padStart(6)}ms                                    \u2551
+\u2551   Measurement:  ${o.toFixed(1).padStart(6)}ms  \u2190 Primary bottleneck              \u2551
+\u2551   Tracking:     ${(e.reduce((t,n)=>t+n.trackingTime,0)/e.length).toFixed(1).padStart(6)}ms                                    \u2551
+\u2551   Callback:     ${(e.reduce((t,n)=>t+n.callbackTime,0)/e.length).toFixed(1).padStart(6)}ms                                    \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+`;return i}}const PerformanceLogger=exports.PerformanceLogger=new PerformanceLoggerSingleton;var _default=exports.default=PerformanceLogger;