catalyst-core 0.2.0-beta.3 → 0.3.0-beta.1

package/dist/native/bridge/perf/index.js

@@ -1,4 +1,23 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _measure=require("./core/measure.js");var _store=require("./core/store.js");var _NavigationCollector=require("./collectors/NavigationCollector.js");var _ScrollCollector=require("./collectors/ScrollCollector.js");var _KeyboardCollector=require("./collectors/KeyboardCollector.js");var _RenderCollector=require("./collectors/RenderCollector.js");var _CacheCollector=require("./collectors/CacheCollector.js");var _HookCollector=require("./collectors/HookCollector.js");var _InteractionCollector=require("./collectors/InteractionCollector.js");var _InsightsCollector=require("./collectors/InsightsCollector.js");var _ThreadCollector=require("./collectors/ThreadCollector.js");var _ApiCollector=require("./collectors/ApiCollector.js");var _NetworkTimingCollector=require("./collectors/NetworkTimingCollector.js");/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _measure = require("./core/measure.js");
+var _store = require("./core/store.js");
+var _NavigationCollector = require("./collectors/NavigationCollector.js");
+var _ScrollCollector = require("./collectors/ScrollCollector.js");
+var _KeyboardCollector = require("./collectors/KeyboardCollector.js");
+var _RenderCollector = require("./collectors/RenderCollector.js");
+var _CacheCollector = require("./collectors/CacheCollector.js");
+var _HookCollector = require("./collectors/HookCollector.js");
+var _InteractionCollector = require("./collectors/InteractionCollector.js");
+var _InsightsCollector = require("./collectors/InsightsCollector.js");
+var _ThreadCollector = require("./collectors/ThreadCollector.js");
+var _ApiCollector = require("./collectors/ApiCollector.js");
+var _NetworkTimingCollector = require("./collectors/NetworkTimingCollector.js");
+/**
  * perf/index.js — WebPerfCollector
  *
  * Thin orchestrator. Responsibilities:
@@ -42,40 +61,342 @@
  *   CacheCollector.cache-summary → InsightsCollector.notifyCacheSummary
  *   All collectors → InsightsCollector (reactive warnings + session summary)
  *   All high-level collector outputs → PerfStore for waterfalls/tables/export
- */class WebPerfCollector{constructor(){// Align native timestamps (SystemClock.elapsedRealtime) to performance.now() space.
-// Read lazily on each call — __NATIVE_TIME_OFFSET is injected via evaluateJavascript
-// in onPageStarted which may not have executed yet when this constructor runs.
-const nativeToWeb=nativeMs=>nativeMs-(window.__NATIVE_TIME_OFFSET??0);this._nativeToWeb=nativeToWeb;// ── Shared core ────────────────────────────────────────────────────────
-const measure=new _measure.Measure();this._store=new _store.PerfStore(nativeToWeb);// ── Collectors ─────────────────────────────────────────────────────────
-this._nav=new _NavigationCollector.NavigationCollector(measure,nativeToWeb);this._scroll=new _ScrollCollector.ScrollCollector(measure,nativeToWeb);this._keyboard=new _KeyboardCollector.KeyboardCollector(measure,nativeToWeb);this._render=new _RenderCollector.RenderCollector(measure,()=>this._sessionContext(),nativeToWeb);this._cache=new _CacheCollector.CacheCollector(measure,nativeToWeb);this._hook=new _HookCollector.HookCollector(measure);this._interaction=new _InteractionCollector.InteractionCollector(measure);this._insights=new _InsightsCollector.InsightsCollector(measure);this._thread=new _ThreadCollector.ThreadCollector(measure,nativeToWeb);this._api=new _ApiCollector.ApiCollector(measure,nativeToWeb);this._networkTiming=new _NetworkTimingCollector.NetworkTimingCollector(measure);// ── Cross-collector wiring ─────────────────────────────────────────────
-// LoAF → ScrollCollector + HookCollector
-this._render.addLoafListener((start,end)=>this._scroll.onLoaf(start,end));this._render.addLoafListener((start,end)=>this._hook.onLoaf(start,end));// LoAF during navigation → Insights
-this._render.addLoafListener((start,end)=>{if(this._nav.isLoading){this._insights.notifyLoafDuringNav({durationMs:end-start,startTime:start,endTime:end});}});// Interaction session → RenderCollector
-this._render.setInteractionSource(()=>this._interaction);this._networkTiming.setInteractionSource(()=>this._interaction);this._api.setInteractionSource(()=>this._interaction);// Normalized store feed for waterfalls, tables, export, and future DevTools UI.
-this._nav.setWaterfallSource(data=>this._store.recordNavigation(data));this._interaction.setWaterfallSource(data=>this._store.recordInteraction(data));this._networkTiming.setWaterfallSource(data=>this._store.recordNetwork(data));this._api.setWaterfallSource(data=>this._store.recordNativeApi(data));this._render.setWaterfallSource(data=>this._store.recordRender(data));this._hook.setWaterfallSource(data=>this._store.recordHook(data));this._scroll.setWaterfallSource(data=>this._store.recordScroll(data));this._keyboard.setWaterfallSource(data=>this._store.recordKeyboard(data));// Interaction → Insights (slow tap-to-paint)
-this._interaction.setInsightsSource(data=>this._insights.notifySlowInteraction(data));// Render → Insights (layout shift + memory)
-this._render.setInsightsSource(data=>{if(data.currentMb!=null)this._insights.notifyHighMemory(data);else this._insights.notifyLayoutShift(data);});// Thread → Insights (hw-accel disabled during dropped frame)
-this._thread.setInsightsSource(data=>this._insights.notifyHwAccelDuringFrame(data));// Cache summary → Insights (low hit rate)
-this._cache.setInsightsSource(data=>this._insights.notifyCacheSummary(data));// Scroll jank → Insights
-this._scroll.setInsightsSource(data=>this._insights.notifyScrollJank(data));// Insights → normalized store
-this._insights.setStoreSource(data=>{this._store.recordInsight(data);});}static init(bridge){if(window.__catalystPerfCollector)return;const collector=new WebPerfCollector();window.__catalystPerfCollector=collector;collector._setup(bridge);console.log("[CatalystPerf] active — nativeOffset:",window.__NATIVE_TIME_OFFSET??0,"ms");}_setup(bridge){this._store.expose();// Native → web event receiver (called directly by Kotlin via evaluateJavascript)
-window.__catalystPerfEvent=jsonOrString=>{try{const event=typeof jsonOrString==="string"?JSON.parse(jsonOrString):jsonOrString;this._routeNativeEvent(event);}catch(e){console.warn("[CatalystPerf] Bad native event payload:",jsonOrString,e);}};// Native batch flush receiver — called by Kotlin after onPageFinished + 250ms delay.
-// Drains via requestIdleCallback so web render is not blocked.
-window.__catalystPerfBatch=(batchId,jsonArrayString)=>{if(jsonArrayString==null){jsonArrayString=batchId;batchId=null;}try{console.log("[CatalystPerf] __catalystPerfBatch received, length=",typeof jsonArrayString==="string"?jsonArrayString.length:"?");const events=typeof jsonArrayString==="string"?JSON.parse(jsonArrayString):jsonArrayString;if(!Array.isArray(events)||events.length===0){console.warn("[CatalystPerf] __catalystPerfBatch — empty or invalid array");return false;}if(batchId){this._acceptedBatchIds??=new Set();if(this._acceptedBatchIds.has(batchId))return true;this._acceptedBatchIds.add(batchId);if(this._acceptedBatchIds.size>100){this._acceptedBatchIds.delete(this._acceptedBatchIds.values().next().value);}}const typeSummary=events.reduce((acc,e)=>{acc[e.type]=(acc[e.type]||0)+1;return acc;},{});console.log("[CatalystPerf] __catalystPerfBatch events:",events.length,JSON.stringify(typeSummary));this._drainBatch(events);return true;}catch(e){console.warn("[CatalystPerf] Bad batch payload:",e);return false;}};// WebBridge fallback registration (for frameworks that route via bridge callbacks)
-if(bridge){bridge.register("CATALYST_PERF_EVENT",data=>{window.__catalystPerfEvent(data);});}// Initialise all collectors
-this._nav.init();this._scroll.init();this._keyboard.init();this._render.init();this._cache.init();this._hook.init();this._interaction.init();this._insights.init();this._thread.init();this._api.init();this._networkTiming.init();}// ─── Native batch drain ───────────────────────────────────────────────────
-// Processes buffered native events (boot timing, cache, api-call) via
-// requestIdleCallback so the web thread stays free for rendering.
-_drainBatch(events){let index=0;const CHUNK=20;// process up to 20 events per idle slice
-const processChunk=deadline=>{let processed=0;while(index<events.length&&processed<CHUNK){if(deadline&&deadline.timeRemaining()<1)break;this._routeBatchEvent(events[index++]);processed++;}if(index<events.length){if(typeof requestIdleCallback==="function"){requestIdleCallback(processChunk,{timeout:2000});}else{// Fallback: setTimeout for environments without rIC
-setTimeout(()=>processChunk(null),0);}}else{console.log(`[CatalystPerf] batch drained — ${events.length} events`);}};if(typeof requestIdleCallback==="function"){requestIdleCallback(processChunk,{timeout:2000});}else{setTimeout(()=>processChunk(null),0);}}_routeBatchEvent(event){const{type}=event;this._store.recordNativeEvent(event,"native-batch");if(type==="page-load-start"||type==="page-load-error"){this._nav.onNativeEvent(event);}else if(type==="page-load-end"){this._nav.onNativeEvent(event);if(event.durationMs!=null){this._insights.notifySlowLoad({url:event.url,durationMs:event.durationMs,...this._nativeRange(event)});}}else if(type?.startsWith("boot-")){this._nav.onBatchEvent(event);}else if(type?.startsWith("cache-")||type==="network-fetch-complete"){console.log("[CatalystPerf] routing cache event:",type,event.url?.slice(-40));this._cache.onBatchEvent(event);}else if(type==="cache-summary"){console.log("[CatalystPerf] routing cache-summary:",JSON.stringify(event));this._cache.onBatchEvent(event);}else if(type==="api-call"){this._api.onBatchEvent(event);}else if(type==="cold-start"){this._nav.onNativeEvent(event);this._insights.notifyColdStart({durationMs:event.durationMs,...this._nativeRange(event)});}else{// Unknown batch event — silently ignore (may be from future native additions)
-}}// ─── Native event router ──────────────────────────────────────────────────
-_routeNativeEvent(event){this._store.recordNativeEvent(event,"native-live");switch(event.type){case"keyboard-show":this._keyboard.onKeyboardShow(event);break;case"keyboard-hide":this._keyboard.onKeyboardHide(event);break;case"cache-hit-memory":case"cache-hit-disk":case"cache-miss-fetch":case"network-fetch-complete":// Legacy live path — only reached if buffer flush is disabled.
-// In normal operation, cache events go via __catalystPerfBatch.
-this._cache.onNativeEvent(event);break;case"page-load-start":case"page-load-error":this._nav.onNativeEvent(event);break;case"page-load-end":{this._nav.onNativeEvent(event);if(event.durationMs!=null){this._insights.notifySlowLoad({url:event.url,durationMs:event.durationMs,...this._nativeRange(event)});}break;}case"cold-start":this._nav.onNativeEvent(event);this._insights.notifyColdStart({durationMs:event.durationMs,...this._nativeRange(event)});break;case"fps-drop-episode":{const source=this._render.onNativeEvent(event);// Option B: feed fps-drop into scroll session if one is open
-if(this._scroll._session.isOpen){this._scroll.onFpsDrop(event);}this._insights.notifyFpsDrop({minFps:event.minFps,avgFps:event.avgFps,durationMs:event.durationMs,duringInteraction:source?.interactionId!=null,deltaFps:event.deltaFps??null,baselineFps:event.baselineFps??null,interactionId:source?.interactionId??null,startTime:source?.startTime,endTime:source?.endTime});break;}case"long-task":this._render.onNativeEvent(event);break;case"memory-snapshot":this._render.onNativeEvent(event);// Insights notified from RenderCollector via setInsightsSource (uses nativeMb)
-break;case"scroll-start":this._scroll.onScrollStart(event);break;case"scroll-end":this._scroll.onScrollEnd(event);break;case"hw-accel-change":this._thread.onNativeEvent(event);break;case"navigation-back":// Emit via NavigationCollector as a point-in-time batch-style event
-this._nav.onBatchEvent(event);break;default:console.warn("[CatalystPerf] Unknown native event type:",event.type);}}_nativeRange(event){const nativeEnd=event.nativeTime??event.nativeEndMs??event.endNativeTime;if(!Number.isFinite(nativeEnd))return{};const endTime=this._nativeToWeb(nativeEnd);const durationMs=Number.isFinite(event.durationMs)?event.durationMs:1;return{startTime:Math.max(0,endTime-durationMs),endTime};}// ─── Session context helper ───────────────────────────────────────────────
-// Used by RenderCollector to tag LoAF and layout-shift entries with the
-// active session so you can see in DevTools which phase a bad frame belongs to.
-_sessionContext(){if(this._nav.isLoading)return"navigation";if(this._scroll._session.isOpen)return"scroll";if(this._keyboard._session.isOpen)return"keyboard";return"none";}}var _default=exports.default=WebPerfCollector;
+ */
+
+class WebPerfCollector {
+  constructor() {
+    // Align native timestamps (SystemClock.elapsedRealtime) to performance.now() space.
+    // Read lazily on each call — __NATIVE_TIME_OFFSET is injected via evaluateJavascript
+    // in onPageStarted which may not have executed yet when this constructor runs.
+    const nativeToWeb = nativeMs => nativeMs - (window.__NATIVE_TIME_OFFSET ?? 0);
+    this._nativeToWeb = nativeToWeb;
+
+    // ── Shared core ────────────────────────────────────────────────────────
+    const measure = new _measure.Measure();
+    this._store = new _store.PerfStore(nativeToWeb);
+
+    // ── Collectors ─────────────────────────────────────────────────────────
+    this._nav = new _NavigationCollector.NavigationCollector(measure, nativeToWeb);
+    this._scroll = new _ScrollCollector.ScrollCollector(measure, nativeToWeb);
+    this._keyboard = new _KeyboardCollector.KeyboardCollector(measure, nativeToWeb);
+    this._render = new _RenderCollector.RenderCollector(measure, () => this._sessionContext(), nativeToWeb);
+    this._cache = new _CacheCollector.CacheCollector(measure, nativeToWeb);
+    this._hook = new _HookCollector.HookCollector(measure);
+    this._interaction = new _InteractionCollector.InteractionCollector(measure);
+    this._insights = new _InsightsCollector.InsightsCollector(measure);
+    this._thread = new _ThreadCollector.ThreadCollector(measure, nativeToWeb);
+    this._api = new _ApiCollector.ApiCollector(measure, nativeToWeb);
+    this._networkTiming = new _NetworkTimingCollector.NetworkTimingCollector(measure);
+
+    // ── Cross-collector wiring ─────────────────────────────────────────────
+
+    // LoAF → ScrollCollector + HookCollector
+    this._render.addLoafListener((start, end) => this._scroll.onLoaf(start, end));
+    this._render.addLoafListener((start, end) => this._hook.onLoaf(start, end));
+
+    // LoAF during navigation → Insights
+    this._render.addLoafListener((start, end) => {
+      if (this._nav.isLoading) {
+        this._insights.notifyLoafDuringNav({
+          durationMs: end - start,
+          startTime: start,
+          endTime: end
+        });
+      }
+    });
+
+    // Interaction session → RenderCollector
+    this._render.setInteractionSource(() => this._interaction);
+    this._networkTiming.setInteractionSource(() => this._interaction);
+    this._api.setInteractionSource(() => this._interaction);
+
+    // Normalized store feed for waterfalls, tables, export, and future DevTools UI.
+    this._nav.setWaterfallSource(data => this._store.recordNavigation(data));
+    this._interaction.setWaterfallSource(data => this._store.recordInteraction(data));
+    this._networkTiming.setWaterfallSource(data => this._store.recordNetwork(data));
+    this._api.setWaterfallSource(data => this._store.recordNativeApi(data));
+    this._render.setWaterfallSource(data => this._store.recordRender(data));
+    this._hook.setWaterfallSource(data => this._store.recordHook(data));
+    this._scroll.setWaterfallSource(data => this._store.recordScroll(data));
+    this._keyboard.setWaterfallSource(data => this._store.recordKeyboard(data));
+
+    // Interaction → Insights (slow tap-to-paint)
+    this._interaction.setInsightsSource(data => this._insights.notifySlowInteraction(data));
+
+    // Render → Insights (layout shift + memory)
+    this._render.setInsightsSource(data => {
+      if (data.currentMb != null) this._insights.notifyHighMemory(data);else this._insights.notifyLayoutShift(data);
+    });
+
+    // Thread → Insights (hw-accel disabled during dropped frame)
+    this._thread.setInsightsSource(data => this._insights.notifyHwAccelDuringFrame(data));
+
+    // Cache summary → Insights (low hit rate)
+    this._cache.setInsightsSource(data => this._insights.notifyCacheSummary(data));
+
+    // Scroll jank → Insights
+    this._scroll.setInsightsSource(data => this._insights.notifyScrollJank(data));
+
+    // Insights → normalized store
+    this._insights.setStoreSource(data => {
+      this._store.recordInsight(data);
+    });
+  }
+  static init(bridge) {
+    if (window.__catalystPerfCollector) return;
+    const collector = new WebPerfCollector();
+    window.__catalystPerfCollector = collector;
+    collector._setup(bridge);
+    console.log("[CatalystPerf] active — nativeOffset:", window.__NATIVE_TIME_OFFSET ?? 0, "ms");
+  }
+  _setup(bridge) {
+    this._store.expose();
+
+    // Native → web event receiver (called directly by Kotlin via evaluateJavascript)
+    window.__catalystPerfEvent = jsonOrString => {
+      try {
+        const event = typeof jsonOrString === "string" ? JSON.parse(jsonOrString) : jsonOrString;
+        this._routeNativeEvent(event);
+      } catch (e) {
+        console.warn("[CatalystPerf] Bad native event payload:", jsonOrString, e);
+      }
+    };
+
+    // Native batch flush receiver — called by Kotlin after onPageFinished + 250ms delay.
+    // Drains via requestIdleCallback so web render is not blocked.
+    window.__catalystPerfBatch = (batchId, jsonArrayString) => {
+      if (jsonArrayString == null) {
+        jsonArrayString = batchId;
+        batchId = null;
+      }
+      try {
+        console.log("[CatalystPerf] __catalystPerfBatch received, length=", typeof jsonArrayString === "string" ? jsonArrayString.length : "?");
+        const events = typeof jsonArrayString === "string" ? JSON.parse(jsonArrayString) : jsonArrayString;
+        if (!Array.isArray(events) || events.length === 0) {
+          console.warn("[CatalystPerf] __catalystPerfBatch — empty or invalid array");
+          return false;
+        }
+        if (batchId) {
+          this._acceptedBatchIds ??= new Set();
+          if (this._acceptedBatchIds.has(batchId)) return true;
+          this._acceptedBatchIds.add(batchId);
+          if (this._acceptedBatchIds.size > 100) {
+            this._acceptedBatchIds.delete(this._acceptedBatchIds.values().next().value);
+          }
+        }
+        const typeSummary = events.reduce((acc, e) => {
+          acc[e.type] = (acc[e.type] || 0) + 1;
+          return acc;
+        }, {});
+        console.log("[CatalystPerf] __catalystPerfBatch events:", events.length, JSON.stringify(typeSummary));
+        this._drainBatch(events);
+        return true;
+      } catch (e) {
+        console.warn("[CatalystPerf] Bad batch payload:", e);
+        return false;
+      }
+    };
+
+    // WebBridge fallback registration (for frameworks that route via bridge callbacks)
+    if (bridge) {
+      bridge.register("CATALYST_PERF_EVENT", data => {
+        window.__catalystPerfEvent(data);
+      });
+    }
+
+    // Initialise all collectors
+    this._nav.init();
+    this._scroll.init();
+    this._keyboard.init();
+    this._render.init();
+    this._cache.init();
+    this._hook.init();
+    this._interaction.init();
+    this._insights.init();
+    this._thread.init();
+    this._api.init();
+    this._networkTiming.init();
+  }
+
+  // ─── Native batch drain ───────────────────────────────────────────────────
+  // Processes buffered native events (boot timing, cache, api-call) via
+  // requestIdleCallback so the web thread stays free for rendering.
+
+  _drainBatch(events) {
+    let index = 0;
+    const CHUNK = 20; // process up to 20 events per idle slice
+
+    const processChunk = deadline => {
+      let processed = 0;
+      while (index < events.length && processed < CHUNK) {
+        if (deadline && deadline.timeRemaining() < 1) break;
+        this._routeBatchEvent(events[index++]);
+        processed++;
+      }
+      if (index < events.length) {
+        if (typeof requestIdleCallback === "function") {
+          requestIdleCallback(processChunk, {
+            timeout: 2000
+          });
+        } else {
+          // Fallback: setTimeout for environments without rIC
+          setTimeout(() => processChunk(null), 0);
+        }
+      } else {
+        console.log(`[CatalystPerf] batch drained — ${events.length} events`);
+      }
+    };
+    if (typeof requestIdleCallback === "function") {
+      requestIdleCallback(processChunk, {
+        timeout: 2000
+      });
+    } else {
+      setTimeout(() => processChunk(null), 0);
+    }
+  }
+  _routeBatchEvent(event) {
+    const {
+      type
+    } = event;
+    this._store.recordNativeEvent(event, "native-batch");
+    if (type === "page-load-start" || type === "page-load-error") {
+      this._nav.onNativeEvent(event);
+    } else if (type === "page-load-end") {
+      this._nav.onNativeEvent(event);
+      if (event.durationMs != null) {
+        this._insights.notifySlowLoad({
+          url: event.url,
+          durationMs: event.durationMs,
+          ...this._nativeRange(event)
+        });
+      }
+    } else if (type?.startsWith("boot-")) {
+      this._nav.onBatchEvent(event);
+    } else if (type?.startsWith("cache-") || type === "network-fetch-complete") {
+      console.log("[CatalystPerf] routing cache event:", type, event.url?.slice(-40));
+      this._cache.onBatchEvent(event);
+    } else if (type === "cache-summary") {
+      console.log("[CatalystPerf] routing cache-summary:", JSON.stringify(event));
+      this._cache.onBatchEvent(event);
+    } else if (type === "api-call") {
+      this._api.onBatchEvent(event);
+    } else if (type === "cold-start") {
+      this._nav.onNativeEvent(event);
+      this._insights.notifyColdStart({
+        durationMs: event.durationMs,
+        ...this._nativeRange(event)
+      });
+    } else {
+      // Unknown batch event — silently ignore (may be from future native additions)
+    }
+  }
+
+  // ─── Native event router ──────────────────────────────────────────────────
+
+  _routeNativeEvent(event) {
+    this._store.recordNativeEvent(event, "native-live");
+    switch (event.type) {
+      case "keyboard-show":
+        this._keyboard.onKeyboardShow(event);
+        break;
+      case "keyboard-hide":
+        this._keyboard.onKeyboardHide(event);
+        break;
+      case "cache-hit-memory":
+      case "cache-hit-disk":
+      case "cache-miss-fetch":
+      case "network-fetch-complete":
+        // Legacy live path — only reached if buffer flush is disabled.
+        // In normal operation, cache events go via __catalystPerfBatch.
+        this._cache.onNativeEvent(event);
+        break;
+      case "page-load-start":
+      case "page-load-error":
+        this._nav.onNativeEvent(event);
+        break;
+      case "page-load-end":
+        {
+          this._nav.onNativeEvent(event);
+          if (event.durationMs != null) {
+            this._insights.notifySlowLoad({
+              url: event.url,
+              durationMs: event.durationMs,
+              ...this._nativeRange(event)
+            });
+          }
+          break;
+        }
+      case "cold-start":
+        this._nav.onNativeEvent(event);
+        this._insights.notifyColdStart({
+          durationMs: event.durationMs,
+          ...this._nativeRange(event)
+        });
+        break;
+      case "fps-drop-episode":
+        {
+          const source = this._render.onNativeEvent(event);
+          // Option B: feed fps-drop into scroll session if one is open
+          if (this._scroll._session.isOpen) {
+            this._scroll.onFpsDrop(event);
+          }
+          this._insights.notifyFpsDrop({
+            minFps: event.minFps,
+            avgFps: event.avgFps,
+            durationMs: event.durationMs,
+            duringInteraction: source?.interactionId != null,
+            deltaFps: event.deltaFps ?? null,
+            baselineFps: event.baselineFps ?? null,
+            interactionId: source?.interactionId ?? null,
+            startTime: source?.startTime,
+            endTime: source?.endTime
+          });
+          break;
+        }
+      case "long-task":
+        this._render.onNativeEvent(event);
+        break;
+      case "memory-snapshot":
+        this._render.onNativeEvent(event);
+        // Insights notified from RenderCollector via setInsightsSource (uses nativeMb)
+        break;
+      case "scroll-start":
+        this._scroll.onScrollStart(event);
+        break;
+      case "scroll-end":
+        this._scroll.onScrollEnd(event);
+        break;
+      case "hw-accel-change":
+        this._thread.onNativeEvent(event);
+        break;
+      case "navigation-back":
+        // Emit via NavigationCollector as a point-in-time batch-style event
+        this._nav.onBatchEvent(event);
+        break;
+      default:
+        console.warn("[CatalystPerf] Unknown native event type:", event.type);
+    }
+  }
+  _nativeRange(event) {
+    const nativeEnd = event.nativeTime ?? event.nativeEndMs ?? event.endNativeTime;
+    if (!Number.isFinite(nativeEnd)) return {};
+    const endTime = this._nativeToWeb(nativeEnd);
+    const durationMs = Number.isFinite(event.durationMs) ? event.durationMs : 1;
+    return {
+      startTime: Math.max(0, endTime - durationMs),
+      endTime
+    };
+  }
+
+  // ─── Session context helper ───────────────────────────────────────────────
+  // Used by RenderCollector to tag LoAF and layout-shift entries with the
+  // active session so you can see in DevTools which phase a bad frame belongs to.
+
+  _sessionContext() {
+    if (this._nav.isLoading) return "navigation";
+    if (this._scroll._session.isOpen) return "scroll";
+    if (this._keyboard._session.isOpen) return "keyboard";
+    return "none";
+  }
+}
+var _default = exports.default = WebPerfCollector;

package/dist/native/bridge/safeArea.js

@@ -1,5 +1,53 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.setSafeAreaGlobal=exports.getSafeAreaFromGlobal=exports.getSafeArea=exports.DEFAULT_INSETS=void 0;const DEFAULT_INSETS=exports.DEFAULT_INSETS={top:0,right:0,bottom:0,left:0};const coerceNumber=value=>{const numeric=Number(value);// Ensure non-negative values
-return Number.isFinite(numeric)&&numeric>=0?numeric:0;};const normalizeInsets=input=>{if(!input||typeof input!=="object"){return{...DEFAULT_INSETS};}return{top:coerceNumber(input.top),right:coerceNumber(input.right),bottom:coerceNumber(input.bottom),left:coerceNumber(input.left)};};const getSafeAreaFromGlobal=()=>{// Use window on client, globalThis on server (SSR)
-// eslint-disable-next-line no-undef
-const global=typeof window!=="undefined"?window:globalThis;const value=global.__SAFE_AREA_INITIAL__;if(!value){return null;}return normalizeInsets(value);};exports.getSafeAreaFromGlobal=getSafeAreaFromGlobal;const setSafeAreaGlobal=insets=>{// eslint-disable-next-line no-undef
-const global=typeof window!=="undefined"?window:globalThis;const normalized=normalizeInsets(insets);global.__SAFE_AREA_INITIAL__=normalized;return normalized;};exports.setSafeAreaGlobal=setSafeAreaGlobal;const getSafeArea=()=>getSafeAreaFromGlobal()||{...DEFAULT_INSETS};exports.getSafeArea=getSafeArea;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setSafeAreaGlobal = exports.getSafeAreaFromGlobal = exports.getSafeArea = exports.DEFAULT_INSETS = void 0;
+const DEFAULT_INSETS = exports.DEFAULT_INSETS = {
+  top: 0,
+  right: 0,
+  bottom: 0,
+  left: 0
+};
+const coerceNumber = value => {
+  const numeric = Number(value);
+  // Ensure non-negative values
+  return Number.isFinite(numeric) && numeric >= 0 ? numeric : 0;
+};
+const normalizeInsets = input => {
+  if (!input || typeof input !== "object") {
+    return {
+      ...DEFAULT_INSETS
+    };
+  }
+  return {
+    top: coerceNumber(input.top),
+    right: coerceNumber(input.right),
+    bottom: coerceNumber(input.bottom),
+    left: coerceNumber(input.left)
+  };
+};
+const getSafeAreaFromGlobal = () => {
+  // Use window on client, globalThis on server (SSR)
+  // eslint-disable-next-line no-undef
+  const global = typeof window !== "undefined" ? window : globalThis;
+  const value = global.__SAFE_AREA_INITIAL__;
+  if (!value) {
+    return null;
+  }
+  return normalizeInsets(value);
+};
+exports.getSafeAreaFromGlobal = getSafeAreaFromGlobal;
+const setSafeAreaGlobal = insets => {
+  // eslint-disable-next-line no-undef
+  const global = typeof window !== "undefined" ? window : globalThis;
+  const normalized = normalizeInsets(insets);
+  global.__SAFE_AREA_INITIAL__ = normalized;
+  return normalized;
+};
+exports.setSafeAreaGlobal = setSafeAreaGlobal;
+const getSafeArea = () => getSafeAreaFromGlobal() || {
+  ...DEFAULT_INSETS
+};
+exports.getSafeArea = getSafeArea;