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

package/dist/native/bridge/perf/collectors/RenderCollector.js

@@ -1,4 +1,11 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.RenderCollector=void 0;var _constants=require("../core/constants.js");/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RenderCollector = void 0;
+var _constants = require("../core/constants.js");
+/**
  * RenderCollector.js
  *
  * Instruments: bugs #1, #6, #10, #14, #15, #16
@@ -25,16 +32,253 @@
  * Notifies:
  *   ScrollCollector.onLoaf()       — so scroll session can increment its loafCount
  *   HookCollector.onLoaf()         — so hook mount sessions can detect LoAF bursts
- */class RenderCollector{constructor(measure,getSessionContext,nativeToWeb){this._measure=measure;// getSessionContext() returns 'navigation'|'scroll'|'keyboard'|'none'
-// provided by index.js so RenderCollector doesn't import other collectors
-this._getSessionContext=getSessionContext;this._nativeToWeb=nativeToWeb??(t=>t);this._loafListeners=[];// [fn] called on every LoAF
-this._getInteraction=null;// set by index.js after construction
-}/** Called by index.js to wire up interaction session context. */setInteractionSource(fn){this._getInteraction=fn;}/** Called by index.js to wire up insights notifications. */setInsightsSource(fn){this._notifyInsights=fn;}/** Called by index.js to feed the normalized perf store. */setWaterfallSource(fn){this._notifyWaterfall=fn;}// Allow other collectors to subscribe to LoAF events
-addLoafListener(fn){this._loafListeners.push(fn);}init(){this._observeLoAF();this._observeLayoutShift();}// ─── Native MetricsMonitor events ────────────────────────────────────────
-onNativeEvent(event){const t=this._nativeToWeb(event.nativeTime);switch(event.type){case"fps-drop-episode":{const start=Math.max(0,this._nativeToWeb(event.startNativeTime));const end=Math.max(start,this._nativeToWeb(event.endNativeTime));const markName=`${_constants.PREFIX.FPS_DROP}:${Math.round(start)}`;performance.mark(markName,{startTime:start});const interactionId=this._getInteraction?.()?.interactionIdForRange(start,end)??null;if(interactionId)this._getInteraction?.()?.onFpsDrop();this._measure.emit(`${interactionId?`[${interactionId}] `:""}FPS drop: ${event.minFps.toFixed(1)}fps - ${Math.round(event.durationMs)}ms`,markName,end,{interactionId,minFps:event.minFps,avgFps:event.avgFps,durationMs:event.durationMs,sessionContext:this._getSessionContext(),thread:event.thread??null,simulatorValid:false},_constants.TRACK.RENDER,event.minFps<30?"error":"tertiary");this._notifyWaterfall?.({metric:"fps-drop",startTime:start,endTime:end,durationMs:event.durationMs,minFps:event.minFps,avgFps:event.avgFps,sessionId:interactionId});return{interactionId,startTime:start,endTime:end};}case"long-task":{const markName=`${_constants.PREFIX.LONG_TASK}:${Math.round(t)}`;const interactionId=this._getInteraction?.()?.interactionIdForRange(t,t+event.durationMs)??null;performance.mark(markName,{startTime:t});this._measure.emit(`${interactionId?`[${interactionId}] `:""}Long task: ${event.durationMs}ms`,markName,t+event.durationMs,{interactionId,durationMs:event.durationMs,sessionContext:this._getSessionContext(),thread:event.thread??null,simulatorValid:true},_constants.TRACK.RENDER,event.durationMs>100?"error":"tertiary");this._notifyWaterfall?.({metric:"long-task",startTime:t,endTime:t+event.durationMs,durationMs:event.durationMs,sessionId:interactionId});break;}case"memory-snapshot":{const jvmMark=`catalyst:mem/jvm:${Math.round(t)}`;performance.mark(jvmMark,{startTime:t});this._measure.emit(`JVM memory: ${event.jvmMb.toFixed(1)}MB`,jvmMark,t+1,{memoryId:`memory-jvm-${Math.round(t)}`,jvmMb:event.jvmMb,peakMb:event.peakMb,thread:event.thread??null,simulatorValid:false,...(event.coldStartMs!=null?{coldStartMs:event.coldStartMs}:{})},_constants.TRACK.MEMORY,"primary");const webviewMemoryId=`memory-webview-${Math.round(t)}`;const webviewMark=`catalyst:mem/webview:${Math.round(t)}`;performance.mark(webviewMark,{startTime:t});this._measure.emit(`WebView memory: ${event.webviewMb.toFixed(1)}MB`,webviewMark,t+1,{memoryId:webviewMemoryId,webviewMb:event.webviewMb,otherMb:event.otherMb,peakMb:event.peakMb,thread:event.thread??null,simulatorValid:false,...(event.coldStartMs!=null?{coldStartMs:event.coldStartMs}:{})},_constants.TRACK.MEMORY,"tertiary-dark");const totalMark=`${_constants.PREFIX.MEMORY_TOTAL}:${Math.round(t)}`;performance.mark(totalMark,{startTime:t});this._measure.emit(`Total memory: ${event.totalMb.toFixed(1)}MB`,totalMark,t+1,{memoryId:`memory-total-${Math.round(t)}`,totalMb:event.totalMb,jvmMb:event.jvmMb,webviewMb:event.webviewMb,otherMb:event.otherMb,peakMb:event.peakMb,thread:event.thread??null,simulatorValid:false,...(event.coldStartMs!=null?{coldStartMs:event.coldStartMs}:{})},_constants.TRACK.MEMORY,event.totalMb>400?"error":"secondary");this._notifyInsights?.({currentMb:event.webviewMb,startTime:t,endTime:t+1,memoryId:webviewMemoryId});this._notifyWaterfall?.({metric:"memory",startTime:t,endTime:t+1,durationMs:1,totalMb:event.totalMb,webviewMb:event.webviewMb});break;}}}// ─── Long Animation Frames ────────────────────────────────────────────────
-_observeLoAF(){if(!PerformanceObserver.supportedEntryTypes?.includes("long-animation-frame"))return;const obs=new PerformanceObserver(list=>{for(const entry of list.getEntries()){const start=entry.startTime;const end=start+entry.duration;const context=this._getSessionContext();// Register with shared Measure so all collectors get overlap detection
-this._measure.recordLoaf(start,end);// Notify subscribers (ScrollCollector, HookCollector)
-this._loafListeners.forEach(fn=>fn(start,end));const markName=`${_constants.PREFIX.LOAF}:${Math.round(start)}`;performance.mark(markName,{startTime:start});this._measure.emit(`${_constants.PREFIX.LOAF}|${Math.round(entry.duration)}ms`,markName,end,{blockingDuration:entry.blockingDuration,scriptCount:entry.scripts?.length??0,sessionContext:context,simulatorValid:false},_constants.TRACK.RENDER);this._notifyWaterfall?.({metric:"loaf",startTime:start,endTime:end,durationMs:entry.duration});}});obs.observe({type:"long-animation-frame",buffered:true});}// ─── Layout shift ─────────────────────────────────────────────────────────
-_observeLayoutShift(){if(!PerformanceObserver.supportedEntryTypes?.includes("layout-shift"))return;const obs=new PerformanceObserver(list=>{for(const entry of list.getEntries()){if(entry.hadRecentInput)continue;// user-initiated shift, ignore
-const context=this._getSessionContext();const markName=`catalyst:cls:${Math.round(entry.startTime)}`;performance.mark(markName,{startTime:entry.startTime});if(entry.value>0.1){this._notifyInsights?.({value:entry.value,sessionContext:context,startTime:entry.startTime,endTime:entry.startTime+1});}this._measure.emit(`${_constants.PREFIX.LAYOUT_SHIFT}|${entry.value.toFixed(4)}`,markName,entry.startTime+1,// point-in-time event, minimal duration
-{value:entry.value,sessionContext:context,simulatorValid:false},_constants.TRACK.RENDER);this._notifyWaterfall?.({metric:"layout-shift",startTime:entry.startTime,endTime:entry.startTime+1,durationMs:1,value:entry.value});}});obs.observe({type:"layout-shift",buffered:true});}}exports.RenderCollector=RenderCollector;
+ */
+
+class RenderCollector {
+  constructor(measure, getSessionContext, nativeToWeb) {
+    this._measure = measure;
+    // getSessionContext() returns 'navigation'|'scroll'|'keyboard'|'none'
+    // provided by index.js so RenderCollector doesn't import other collectors
+    this._getSessionContext = getSessionContext;
+    this._nativeToWeb = nativeToWeb ?? (t => t);
+    this._loafListeners = []; // [fn] called on every LoAF
+    this._getInteraction = null; // set by index.js after construction
+  }
+
+  /** Called by index.js to wire up interaction session context. */
+  setInteractionSource(fn) {
+    this._getInteraction = fn;
+  }
+
+  /** Called by index.js to wire up insights notifications. */
+  setInsightsSource(fn) {
+    this._notifyInsights = fn;
+  }
+
+  /** Called by index.js to feed the normalized perf store. */
+  setWaterfallSource(fn) {
+    this._notifyWaterfall = fn;
+  }
+
+  // Allow other collectors to subscribe to LoAF events
+  addLoafListener(fn) {
+    this._loafListeners.push(fn);
+  }
+  init() {
+    this._observeLoAF();
+    this._observeLayoutShift();
+  }
+
+  // ─── Native MetricsMonitor events ────────────────────────────────────────
+
+  onNativeEvent(event) {
+    const t = this._nativeToWeb(event.nativeTime);
+    switch (event.type) {
+      case "fps-drop-episode":
+        {
+          const start = Math.max(0, this._nativeToWeb(event.startNativeTime));
+          const end = Math.max(start, this._nativeToWeb(event.endNativeTime));
+          const markName = `${_constants.PREFIX.FPS_DROP}:${Math.round(start)}`;
+          performance.mark(markName, {
+            startTime: start
+          });
+          const interactionId = this._getInteraction?.()?.interactionIdForRange(start, end) ?? null;
+          if (interactionId) this._getInteraction?.()?.onFpsDrop();
+          this._measure.emit(`${interactionId ? `[${interactionId}] ` : ""}FPS drop: ${event.minFps.toFixed(1)}fps - ${Math.round(event.durationMs)}ms`, markName, end, {
+            interactionId,
+            minFps: event.minFps,
+            avgFps: event.avgFps,
+            durationMs: event.durationMs,
+            sessionContext: this._getSessionContext(),
+            thread: event.thread ?? null,
+            simulatorValid: false
+          }, _constants.TRACK.RENDER, event.minFps < 30 ? "error" : "tertiary");
+          this._notifyWaterfall?.({
+            metric: "fps-drop",
+            startTime: start,
+            endTime: end,
+            durationMs: event.durationMs,
+            minFps: event.minFps,
+            avgFps: event.avgFps,
+            sessionId: interactionId
+          });
+          return {
+            interactionId,
+            startTime: start,
+            endTime: end
+          };
+        }
+      case "long-task":
+        {
+          const markName = `${_constants.PREFIX.LONG_TASK}:${Math.round(t)}`;
+          const interactionId = this._getInteraction?.()?.interactionIdForRange(t, t + event.durationMs) ?? null;
+          performance.mark(markName, {
+            startTime: t
+          });
+          this._measure.emit(`${interactionId ? `[${interactionId}] ` : ""}Long task: ${event.durationMs}ms`, markName, t + event.durationMs, {
+            interactionId,
+            durationMs: event.durationMs,
+            sessionContext: this._getSessionContext(),
+            thread: event.thread ?? null,
+            simulatorValid: true
+          }, _constants.TRACK.RENDER, event.durationMs > 100 ? "error" : "tertiary");
+          this._notifyWaterfall?.({
+            metric: "long-task",
+            startTime: t,
+            endTime: t + event.durationMs,
+            durationMs: event.durationMs,
+            sessionId: interactionId
+          });
+          break;
+        }
+      case "memory-snapshot":
+        {
+          const jvmMark = `catalyst:mem/jvm:${Math.round(t)}`;
+          performance.mark(jvmMark, {
+            startTime: t
+          });
+          this._measure.emit(`JVM memory: ${event.jvmMb.toFixed(1)}MB`, jvmMark, t + 1, {
+            memoryId: `memory-jvm-${Math.round(t)}`,
+            jvmMb: event.jvmMb,
+            peakMb: event.peakMb,
+            thread: event.thread ?? null,
+            simulatorValid: false,
+            ...(event.coldStartMs != null ? {
+              coldStartMs: event.coldStartMs
+            } : {})
+          }, _constants.TRACK.MEMORY, "primary");
+          const webviewMemoryId = `memory-webview-${Math.round(t)}`;
+          const webviewMark = `catalyst:mem/webview:${Math.round(t)}`;
+          performance.mark(webviewMark, {
+            startTime: t
+          });
+          this._measure.emit(`WebView memory: ${event.webviewMb.toFixed(1)}MB`, webviewMark, t + 1, {
+            memoryId: webviewMemoryId,
+            webviewMb: event.webviewMb,
+            otherMb: event.otherMb,
+            peakMb: event.peakMb,
+            thread: event.thread ?? null,
+            simulatorValid: false,
+            ...(event.coldStartMs != null ? {
+              coldStartMs: event.coldStartMs
+            } : {})
+          }, _constants.TRACK.MEMORY, "tertiary-dark");
+          const totalMark = `${_constants.PREFIX.MEMORY_TOTAL}:${Math.round(t)}`;
+          performance.mark(totalMark, {
+            startTime: t
+          });
+          this._measure.emit(`Total memory: ${event.totalMb.toFixed(1)}MB`, totalMark, t + 1, {
+            memoryId: `memory-total-${Math.round(t)}`,
+            totalMb: event.totalMb,
+            jvmMb: event.jvmMb,
+            webviewMb: event.webviewMb,
+            otherMb: event.otherMb,
+            peakMb: event.peakMb,
+            thread: event.thread ?? null,
+            simulatorValid: false,
+            ...(event.coldStartMs != null ? {
+              coldStartMs: event.coldStartMs
+            } : {})
+          }, _constants.TRACK.MEMORY, event.totalMb > 400 ? "error" : "secondary");
+          this._notifyInsights?.({
+            currentMb: event.webviewMb,
+            startTime: t,
+            endTime: t + 1,
+            memoryId: webviewMemoryId
+          });
+          this._notifyWaterfall?.({
+            metric: "memory",
+            startTime: t,
+            endTime: t + 1,
+            durationMs: 1,
+            totalMb: event.totalMb,
+            webviewMb: event.webviewMb
+          });
+          break;
+        }
+    }
+  }
+
+  // ─── Long Animation Frames ────────────────────────────────────────────────
+
+  _observeLoAF() {
+    if (!PerformanceObserver.supportedEntryTypes?.includes("long-animation-frame")) return;
+    const obs = new PerformanceObserver(list => {
+      for (const entry of list.getEntries()) {
+        const start = entry.startTime;
+        const end = start + entry.duration;
+        const context = this._getSessionContext();
+
+        // Register with shared Measure so all collectors get overlap detection
+        this._measure.recordLoaf(start, end);
+
+        // Notify subscribers (ScrollCollector, HookCollector)
+        this._loafListeners.forEach(fn => fn(start, end));
+        const markName = `${_constants.PREFIX.LOAF}:${Math.round(start)}`;
+        performance.mark(markName, {
+          startTime: start
+        });
+        this._measure.emit(`${_constants.PREFIX.LOAF}|${Math.round(entry.duration)}ms`, markName, end, {
+          blockingDuration: entry.blockingDuration,
+          scriptCount: entry.scripts?.length ?? 0,
+          sessionContext: context,
+          simulatorValid: false
+        }, _constants.TRACK.RENDER);
+        this._notifyWaterfall?.({
+          metric: "loaf",
+          startTime: start,
+          endTime: end,
+          durationMs: entry.duration
+        });
+      }
+    });
+    obs.observe({
+      type: "long-animation-frame",
+      buffered: true
+    });
+  }
+
+  // ─── Layout shift ─────────────────────────────────────────────────────────
+
+  _observeLayoutShift() {
+    if (!PerformanceObserver.supportedEntryTypes?.includes("layout-shift")) return;
+    const obs = new PerformanceObserver(list => {
+      for (const entry of list.getEntries()) {
+        if (entry.hadRecentInput) continue; // user-initiated shift, ignore
+
+        const context = this._getSessionContext();
+        const markName = `catalyst:cls:${Math.round(entry.startTime)}`;
+        performance.mark(markName, {
+          startTime: entry.startTime
+        });
+        if (entry.value > 0.1) {
+          this._notifyInsights?.({
+            value: entry.value,
+            sessionContext: context,
+            startTime: entry.startTime,
+            endTime: entry.startTime + 1
+          });
+        }
+        this._measure.emit(`${_constants.PREFIX.LAYOUT_SHIFT}|${entry.value.toFixed(4)}`, markName, entry.startTime + 1,
+        // point-in-time event, minimal duration
+        {
+          value: entry.value,
+          sessionContext: context,
+          simulatorValid: false
+        }, _constants.TRACK.RENDER);
+        this._notifyWaterfall?.({
+          metric: "layout-shift",
+          startTime: entry.startTime,
+          endTime: entry.startTime + 1,
+          durationMs: 1,
+          value: entry.value
+        });
+      }
+    });
+    obs.observe({
+      type: "layout-shift",
+      buffered: true
+    });
+  }
+}
+exports.RenderCollector = RenderCollector;

package/dist/native/bridge/perf/collectors/ScrollCollector.js

@@ -1,4 +1,12 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.ScrollCollector=void 0;var _constants=require("../core/constants.js");var _session=require("../core/session.js");/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ScrollCollector = void 0;
+var _constants = require("../core/constants.js");
+var _session = require("../core/session.js");
+/**
  * ScrollCollector.js
  *
  * Instruments: bugs #3, #13
@@ -15,11 +23,89 @@
  *
  * fps-drop-episode routed here (Option B) when scroll session is open:
  *   index.js checks this._scroll._session.isOpen before calling onFpsDrop(event)
- */class ScrollCollector{constructor(measure,nativeToWeb){this._measure=measure;this._nativeToWeb=nativeToWeb;this._session=new _session.Session(_constants.PREFIX.SESSION_SCROLL,measure,_constants.TRACK.INPUT);this._insightsCb=null;// set by index.js via setInsightsSource
-this._frameDropCount=0;this._minFps=60;}init(){// No DOM listener — scroll events come from native GestureDetector
-}setInsightsSource(cb){this._insightsCb=cb;}setWaterfallSource(fn){this._notifyWaterfall=fn;}// Called by RenderCollector when a LoAF fires (shared notification, kept for compat)
-onLoaf(){if(this._session.isOpen){this._session.increment("loafCount");}}// ─── Native event handlers ────────────────────────────────────────────────
-onScrollStart(event){if(this._session.isOpen)return;// already tracking, ignore duplicate start
-const webNow=this._nativeToWeb(event.nativeTime);this._frameDropCount=0;this._minFps=60;this._session.open({loafCount:0},webNow);}onScrollEnd(event){if(!this._session.isOpen)return;const startTime=this._session.startTime;const webNow=this._nativeToWeb(event.nativeTime);const loafCount=this._session.get("loafCount")??0;const janky=this._frameDropCount>0||this._minFps<55;const durationMs=Math.round(webNow-startTime);this._session.close({loafCount,frameDropCount:this._frameDropCount,minFps:this._minFps,janky,simulatorValid:false},webNow);if(janky&&this._insightsCb){this._insightsCb({minFps:this._minFps,frameDropCount:this._frameDropCount,startTime,endTime:webNow});}this._notifyWaterfall?.({kind:"scroll",startTime,endTime:webNow,durationMs,loafCount,frameDropCount:this._frameDropCount,minFps:this._minFps,janky});this._frameDropCount=0;this._minFps=60;}// ─── fps-drop-episode correlation (Option B) ──────────────────────────────
-// Called from index.js _routeNativeEvent when scroll session is open.
-onFpsDrop(event){this._frameDropCount++;if(event.minFps!=null&&event.minFps<this._minFps){this._minFps=event.minFps;}}}exports.ScrollCollector=ScrollCollector;
+ */
+
+class ScrollCollector {
+  constructor(measure, nativeToWeb) {
+    this._measure = measure;
+    this._nativeToWeb = nativeToWeb;
+    this._session = new _session.Session(_constants.PREFIX.SESSION_SCROLL, measure, _constants.TRACK.INPUT);
+    this._insightsCb = null; // set by index.js via setInsightsSource
+    this._frameDropCount = 0;
+    this._minFps = 60;
+  }
+  init() {
+    // No DOM listener — scroll events come from native GestureDetector
+  }
+  setInsightsSource(cb) {
+    this._insightsCb = cb;
+  }
+  setWaterfallSource(fn) {
+    this._notifyWaterfall = fn;
+  }
+
+  // Called by RenderCollector when a LoAF fires (shared notification, kept for compat)
+  onLoaf() {
+    if (this._session.isOpen) {
+      this._session.increment("loafCount");
+    }
+  }
+
+  // ─── Native event handlers ────────────────────────────────────────────────
+
+  onScrollStart(event) {
+    if (this._session.isOpen) return; // already tracking, ignore duplicate start
+    const webNow = this._nativeToWeb(event.nativeTime);
+    this._frameDropCount = 0;
+    this._minFps = 60;
+    this._session.open({
+      loafCount: 0
+    }, webNow);
+  }
+  onScrollEnd(event) {
+    if (!this._session.isOpen) return;
+    const startTime = this._session.startTime;
+    const webNow = this._nativeToWeb(event.nativeTime);
+    const loafCount = this._session.get("loafCount") ?? 0;
+    const janky = this._frameDropCount > 0 || this._minFps < 55;
+    const durationMs = Math.round(webNow - startTime);
+    this._session.close({
+      loafCount,
+      frameDropCount: this._frameDropCount,
+      minFps: this._minFps,
+      janky,
+      simulatorValid: false
+    }, webNow);
+    if (janky && this._insightsCb) {
+      this._insightsCb({
+        minFps: this._minFps,
+        frameDropCount: this._frameDropCount,
+        startTime,
+        endTime: webNow
+      });
+    }
+    this._notifyWaterfall?.({
+      kind: "scroll",
+      startTime,
+      endTime: webNow,
+      durationMs,
+      loafCount,
+      frameDropCount: this._frameDropCount,
+      minFps: this._minFps,
+      janky
+    });
+    this._frameDropCount = 0;
+    this._minFps = 60;
+  }
+
+  // ─── fps-drop-episode correlation (Option B) ──────────────────────────────
+  // Called from index.js _routeNativeEvent when scroll session is open.
+
+  onFpsDrop(event) {
+    this._frameDropCount++;
+    if (event.minFps != null && event.minFps < this._minFps) {
+      this._minFps = event.minFps;
+    }
+  }
+}
+exports.ScrollCollector = ScrollCollector;

package/dist/native/bridge/perf/collectors/ThreadCollector.js

@@ -1,4 +1,11 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.ThreadCollector=void 0;var _constants=require("../core/constants.js");/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ThreadCollector = void 0;
+var _constants = require("../core/constants.js");
+/**
  * ThreadCollector.js
  *
  * Instruments: thread visibility gap during cache serving.
@@ -20,8 +27,85 @@
  * Overlap detection:
  *   If a LoAF overlaps a software-render window → notifyInsights so
  *   InsightsCollector can fire an 'hw-accel-during-frame' critical insight.
- */class ThreadCollector{constructor(measure,nativeToWeb){this._measure=measure;this._nativeToWeb=nativeToWeb;// Track open software-render windows: { startMark, startTime, thread }
-this._openWindow=null;this._notifyInsights=null;}/** Called by index.js to wire up insights notifications. */setInsightsSource(fn){this._notifyInsights=fn;}init(){// No web-side observers — all events come from native via onNativeEvent()
-}onNativeEvent(event){if(event.type!=="hw-accel-change")return;const{state,trigger,thread,nativeTime}=event;const webTime=nativeTime!=null?this._nativeToWeb(nativeTime):performance.now();if(state==="off"){// Software-render window opens — record start, wait for 'on' to close span
-const markName=`${_constants.PREFIX.HW_ACCEL}/off:start:${Math.round(webTime)}`;performance.mark(markName,{startTime:webTime});this._openWindow={startMark:markName,startTime:webTime,thread:thread??null,trigger:trigger??null};}else if(state==="on"){const endTime=webTime;if(this._openWindow){const{startMark,startTime,thread:offThread,trigger:offTrigger}=this._openWindow;this._openWindow=null;const loafOverlap=this._measure.overlapsLoaf(startTime,endTime);this._measure.emit(`${_constants.PREFIX.HW_ACCEL}/sw-render-window|${offTrigger??"unknown"}`,startMark,endTime,{trigger:offTrigger??null,thread:offThread??null,loafOverlap,simulatorValid:false},_constants.TRACK.RENDER,loafOverlap?_constants.COLOR.ERROR:_constants.COLOR.SECONDARY_DARK);if(loafOverlap){this._notifyInsights?.({durationMs:endTime-startTime,thread:offThread,trigger:offTrigger,startTime,endTime});}}// Emit a point-in-time marker for hw-accel restored
-const onMark=`${_constants.PREFIX.HW_ACCEL}/on:${Math.round(endTime)}`;performance.mark(onMark,{startTime:endTime});this._measure.emit(`${_constants.PREFIX.HW_ACCEL}/restored`,onMark,endTime+1,{trigger:trigger??null,thread:thread??null,simulatorValid:false},_constants.TRACK.RENDER,_constants.COLOR.SECONDARY);}}}exports.ThreadCollector=ThreadCollector;
+ */
+
+class ThreadCollector {
+  constructor(measure, nativeToWeb) {
+    this._measure = measure;
+    this._nativeToWeb = nativeToWeb;
+
+    // Track open software-render windows: { startMark, startTime, thread }
+    this._openWindow = null;
+    this._notifyInsights = null;
+  }
+
+  /** Called by index.js to wire up insights notifications. */
+  setInsightsSource(fn) {
+    this._notifyInsights = fn;
+  }
+  init() {
+    // No web-side observers — all events come from native via onNativeEvent()
+  }
+  onNativeEvent(event) {
+    if (event.type !== "hw-accel-change") return;
+    const {
+      state,
+      trigger,
+      thread,
+      nativeTime
+    } = event;
+    const webTime = nativeTime != null ? this._nativeToWeb(nativeTime) : performance.now();
+    if (state === "off") {
+      // Software-render window opens — record start, wait for 'on' to close span
+      const markName = `${_constants.PREFIX.HW_ACCEL}/off:start:${Math.round(webTime)}`;
+      performance.mark(markName, {
+        startTime: webTime
+      });
+      this._openWindow = {
+        startMark: markName,
+        startTime: webTime,
+        thread: thread ?? null,
+        trigger: trigger ?? null
+      };
+    } else if (state === "on") {
+      const endTime = webTime;
+      if (this._openWindow) {
+        const {
+          startMark,
+          startTime,
+          thread: offThread,
+          trigger: offTrigger
+        } = this._openWindow;
+        this._openWindow = null;
+        const loafOverlap = this._measure.overlapsLoaf(startTime, endTime);
+        this._measure.emit(`${_constants.PREFIX.HW_ACCEL}/sw-render-window|${offTrigger ?? "unknown"}`, startMark, endTime, {
+          trigger: offTrigger ?? null,
+          thread: offThread ?? null,
+          loafOverlap,
+          simulatorValid: false
+        }, _constants.TRACK.RENDER, loafOverlap ? _constants.COLOR.ERROR : _constants.COLOR.SECONDARY_DARK);
+        if (loafOverlap) {
+          this._notifyInsights?.({
+            durationMs: endTime - startTime,
+            thread: offThread,
+            trigger: offTrigger,
+            startTime,
+            endTime
+          });
+        }
+      }
+
+      // Emit a point-in-time marker for hw-accel restored
+      const onMark = `${_constants.PREFIX.HW_ACCEL}/on:${Math.round(endTime)}`;
+      performance.mark(onMark, {
+        startTime: endTime
+      });
+      this._measure.emit(`${_constants.PREFIX.HW_ACCEL}/restored`, onMark, endTime + 1, {
+        trigger: trigger ?? null,
+        thread: thread ?? null,
+        simulatorValid: false
+      }, _constants.TRACK.RENDER, _constants.COLOR.SECONDARY);
+    }
+  }
+}
+exports.ThreadCollector = ThreadCollector;

package/dist/native/bridge/perf/core/constants.js

@@ -1,26 +1,97 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.TRACK_GROUP=exports.TRACK=exports.THRESHOLD=exports.PREFIX=exports.COLOR=void 0;/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TRACK_GROUP = exports.TRACK = exports.THRESHOLD = exports.PREFIX = exports.COLOR = void 0;
+/**
  * constants.js
  *
  * Single source of truth for track names, thresholds, and color rules.
  * All collectors import from here — no magic strings scattered across files.
- */// ─── Chrome DevTools track group ─────────────────────────────────────────────
-const TRACK_GROUP=exports.TRACK_GROUP="Catalyst";const TRACK=exports.TRACK={NAVIGATION:"Navigation",SCROLL:"Scroll",INPUT:"Input",KEYBOARD:"Keyboard",// alias kept for backward compat — collectors use TRACK.INPUT
-RENDER:"Render",MEMORY:"Memory",CACHE:"Cache",NETWORK:"Network",HOOK:"Hook",INTERACTION:"Interaction",INSIGHTS:"Insights",NATIVE_API:"Native API"};// ─── Measure name prefixes ────────────────────────────────────────────────────
-const PREFIX=exports.PREFIX={SESSION_NAV:"catalyst:session/navigation",SESSION_SCROLL:"catalyst:session/scroll",SESSION_INPUT:"catalyst:session/input",SESSION_KEYBOARD:"catalyst:session/keyboard",// alias — KeyboardCollector still uses this
-LCP:"catalyst:lcp",FCP:"catalyst:fcp",LOAF:"catalyst:loaf",LAYOUT_SHIFT:"catalyst:layout-shift",VIEWPORT_RESIZE:"catalyst:viewport-resize",ROUTE_TRANSITION:"catalyst:route-transition",CACHE:"catalyst:cache",CACHE_GROUP:"catalyst:cache-group",NETWORK_TIMING:"catalyst:network",NATIVE_API:"catalyst:native-api",HOOK_MOUNT:"catalyst:hook/mount",HOOK_LAZY:"catalyst:hook/lazy",INTERACTION:"catalyst:interaction",SESSION_INTERACTION:"catalyst:session/interaction",LONG_PRESS:"catalyst:long-press",INSIGHT:"catalyst:insight",HW_ACCEL:"catalyst:hw-accel",// Native MetricsMonitor events
-PAGE_LOAD:"catalyst:page-load",COLD_START:"catalyst:cold-start",FPS_DROP:"catalyst:fps-drop",LONG_TASK:"catalyst:long-task",MEMORY_JVM:"catalyst:mem/jvm",MEMORY_NATIVE:"catalyst:mem/native",MEMORY_TOTAL:"catalyst:mem/total"};// ─── Thresholds ───────────────────────────────────────────────────────────────
-const THRESHOLD=exports.THRESHOLD={LCP_BAD_MS:2500,// LCP > 2.5s = poor (Core Web Vitals)
-NAV_SESSION_BAD_MS:2500,// navigation session > 2.5s = slow page
-FETCH_SLOW_MS:300,// network fetch > 300ms = slow
-SCROLL_IDLE_MS:150,// scroll ends after 150ms of no scroll events
-VIEWPORT_MIN_DELTA:50,// ignore viewport resize < 50px (not keyboard)
-CACHE_GROUP_IDLE_MS:300,// close cache group after 300ms idle
-LOAF_WINDOW:5,// keep last N LoAF entries for overlap detection
-LONG_PRESS_MS:500,// pointerdown held > 500ms = long press
-INTERACTION_SLOW_MS:100,// tap → paint > 100ms = slow response
-LAZY_LOAF_WINDOW_MS:2000,// watch for LoAF bursts up to 2s after interaction
-CLS_BAD:0.1// CLS > 0.1 per entry = significant shift
-};// ─── Colors ───────────────────────────────────────────────────────────────────
+ */
+
+// ─── Chrome DevTools track group ─────────────────────────────────────────────
+
+const TRACK_GROUP = exports.TRACK_GROUP = "Catalyst";
+const TRACK = exports.TRACK = {
+  NAVIGATION: "Navigation",
+  SCROLL: "Scroll",
+  INPUT: "Input",
+  KEYBOARD: "Keyboard",
+  // alias kept for backward compat — collectors use TRACK.INPUT
+  RENDER: "Render",
+  MEMORY: "Memory",
+  CACHE: "Cache",
+  NETWORK: "Network",
+  HOOK: "Hook",
+  INTERACTION: "Interaction",
+  INSIGHTS: "Insights",
+  NATIVE_API: "Native API"
+};
+
+// ─── Measure name prefixes ────────────────────────────────────────────────────
+
+const PREFIX = exports.PREFIX = {
+  SESSION_NAV: "catalyst:session/navigation",
+  SESSION_SCROLL: "catalyst:session/scroll",
+  SESSION_INPUT: "catalyst:session/input",
+  SESSION_KEYBOARD: "catalyst:session/keyboard",
+  // alias — KeyboardCollector still uses this
+  LCP: "catalyst:lcp",
+  FCP: "catalyst:fcp",
+  LOAF: "catalyst:loaf",
+  LAYOUT_SHIFT: "catalyst:layout-shift",
+  VIEWPORT_RESIZE: "catalyst:viewport-resize",
+  ROUTE_TRANSITION: "catalyst:route-transition",
+  CACHE: "catalyst:cache",
+  CACHE_GROUP: "catalyst:cache-group",
+  NETWORK_TIMING: "catalyst:network",
+  NATIVE_API: "catalyst:native-api",
+  HOOK_MOUNT: "catalyst:hook/mount",
+  HOOK_LAZY: "catalyst:hook/lazy",
+  INTERACTION: "catalyst:interaction",
+  SESSION_INTERACTION: "catalyst:session/interaction",
+  LONG_PRESS: "catalyst:long-press",
+  INSIGHT: "catalyst:insight",
+  HW_ACCEL: "catalyst:hw-accel",
+  // Native MetricsMonitor events
+  PAGE_LOAD: "catalyst:page-load",
+  COLD_START: "catalyst:cold-start",
+  FPS_DROP: "catalyst:fps-drop",
+  LONG_TASK: "catalyst:long-task",
+  MEMORY_JVM: "catalyst:mem/jvm",
+  MEMORY_NATIVE: "catalyst:mem/native",
+  MEMORY_TOTAL: "catalyst:mem/total"
+};
+
+// ─── Thresholds ───────────────────────────────────────────────────────────────
+
+const THRESHOLD = exports.THRESHOLD = {
+  LCP_BAD_MS: 2500,
+  // LCP > 2.5s = poor (Core Web Vitals)
+  NAV_SESSION_BAD_MS: 2500,
+  // navigation session > 2.5s = slow page
+  FETCH_SLOW_MS: 300,
+  // network fetch > 300ms = slow
+  SCROLL_IDLE_MS: 150,
+  // scroll ends after 150ms of no scroll events
+  VIEWPORT_MIN_DELTA: 50,
+  // ignore viewport resize < 50px (not keyboard)
+  CACHE_GROUP_IDLE_MS: 300,
+  // close cache group after 300ms idle
+  LOAF_WINDOW: 5,
+  // keep last N LoAF entries for overlap detection
+  LONG_PRESS_MS: 500,
+  // pointerdown held > 500ms = long press
+  INTERACTION_SLOW_MS: 100,
+  // tap → paint > 100ms = slow response
+  LAZY_LOAF_WINDOW_MS: 2000,
+  // watch for LoAF bursts up to 2s after interaction
+  CLS_BAD: 0.1 // CLS > 0.1 per entry = significant shift
+};
+
+// ─── Colors ───────────────────────────────────────────────────────────────────
 // Chrome DevTools Extensibility API color values (all 9 values):
 //
 //   primary / primary-light / primary-dark    → blue tones
@@ -40,4 +111,16 @@ CLS_BAD:0.1// CLS > 0.1 per entry = significant shift
 //   tertiary       = network fetch after miss (expected but slow)
 //   tertiary-light = small CLS, long-press (low signal)
 //   tertiary-dark  = insight warning (non-critical)
-const COLOR=exports.COLOR={ERROR:"error",PRIMARY:"primary",PRIMARY_LIGHT:"primary-light",PRIMARY_DARK:"primary-dark",SECONDARY:"secondary",SECONDARY_LIGHT:"secondary-light",SECONDARY_DARK:"secondary-dark",TERTIARY:"tertiary",TERTIARY_LIGHT:"tertiary-light",TERTIARY_DARK:"tertiary-dark"};
+
+const COLOR = exports.COLOR = {
+  ERROR: "error",
+  PRIMARY: "primary",
+  PRIMARY_LIGHT: "primary-light",
+  PRIMARY_DARK: "primary-dark",
+  SECONDARY: "secondary",
+  SECONDARY_LIGHT: "secondary-light",
+  SECONDARY_DARK: "secondary-dark",
+  TERTIARY: "tertiary",
+  TERTIARY_LIGHT: "tertiary-light",
+  TERTIARY_DARK: "tertiary-dark"
+};