@buoy-gg/js-top 7.0.40 → 7.0.42

package/lib/module/js-top/engine/frameStack.js

@@ -1,126 +1 @@
-"use strict";
-
-/**
- * wrapTask — the single wrapper every patched entry point uses, plus the
- * frame stack that makes nested wrapped calls book EXCLUSIVE time.
- *
- * The no-double-count rule: every wrapper at any depth books
- * `(end − start) − childrenMs` to its own origin and adds its TOTAL to its
- * parent frame's childrenMs. Thread occupancy is then the sum of exclusive
- * time at all depths, which equals the union of wrapped wall intervals —
- * nesting (e.g. rAF callbacks fired inside a wrapped bridge call-in) can
- * never inflate totals.
- *
- * Naming: exported/inner functions carry a `buoyJsTop` prefix on purpose —
- * Hermes dev stacks only show function names + bundle offsets, and the
- * registry's stack parser filters engine frames by that prefix.
- */
-
-import { now } from "./now";
-import { isActive, WRAPPED_TAG } from "./state";
-import { buoyJsTopBookExclusive, buoyJsTopOriginExists, buoyJsTopScheduleOrigin } from "./originRegistry";
-const DEPTH_CAP = 32;
-const stack = [];
-
-/** Depth-0 completed intervals ≥ this feed the longtask correlator. */
-const NOTABLE_INTERVAL_MS = 20;
-const INTERVAL_RING_SIZE = 64;
-const intervalRing = new Array(INTERVAL_RING_SIZE).fill(null);
-let intervalRingIndex = 0;
-
-/** Recent depth-0 wrapped intervals, unordered — consumers scan all slots. */
-export function recentIntervals() {
-  return intervalRing;
-}
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-
-/** Push a frame (unless depth-capped), run `invoke`, book on the way out. */
-function buoyJsTopRunFrame(originKey, invoke) {
-  const start = now();
-  const parent = stack.length > 0 ? stack[stack.length - 1] : null;
-  let frame = null;
-  if (stack.length < DEPTH_CAP) {
-    frame = {
-      originKey,
-      start,
-      childrenMs: 0
-    };
-    stack.push(frame);
-  }
-  try {
-    // The user code runs OUTSIDE any catch of ours: errors propagate to the
-    // runtime's normal unhandled-error path untouched.
-    return invoke();
-  } finally {
-    try {
-      if (frame) {
-        stack.pop();
-        const end = now();
-        const total = end - start;
-        const exclusive = Math.max(0, total - frame.childrenMs);
-        if (parent) parent.childrenMs += total;
-        buoyJsTopBookExclusive(originKey, exclusive, start, end);
-        if (!parent && total >= NOTABLE_INTERVAL_MS) {
-          intervalRing[intervalRingIndex] = {
-            originKey,
-            start,
-            end
-          };
-          intervalRingIndex = (intervalRingIndex + 1) % INTERVAL_RING_SIZE;
-        }
-      }
-    } catch {
-      // Bookkeeping must never break the app.
-    }
-  }
-}
-
-/**
- * Wrap a callback at schedule time. ALWAYS wraps once patches are installed
- * (installation itself only happens on first engine start): a long-lived
- * callback — the classic forgotten setInterval — must stay attributable
- * even when it was scheduled while the engine was off, or after clear()
- * deleted its origin record. Identity is therefore resolved eagerly at
- * schedule time when possible (best stack context) and re-resolved lazily
- * at fire time otherwise. Inactive-engine cost per fire: one boolean.
- */
-export function buoyJsTopWrapTask(fn, api) {
-  if (typeof fn !== "function") return fn;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  if (fn[WRAPPED_TAG]) return fn;
-  let originKey = isActive() ? buoyJsTopScheduleOrigin(api, fn, now()) : null;
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const buoyJsTopTaskWrapper = function (...args) {
-    if (!isActive()) return fn.apply(this, args);
-    if (originKey === null || !buoyJsTopOriginExists(originKey)) {
-      // Scheduled while the engine was off, or stats cleared since —
-      // (re)resolve identity now, without stack capture (see scheduleOrigin).
-      originKey = buoyJsTopScheduleOrigin(api, fn, now(), false);
-    }
-    return buoyJsTopRunFrame(originKey, () => fn.apply(this, args));
-  };
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  buoyJsTopTaskWrapper[WRAPPED_TAG] = true;
-  return buoyJsTopTaskWrapper;
-}
-
-/**
- * Run a thunk as a named task frame — for entry points that aren't
- * schedule-a-callback shaped (e.g. bridge call-ins, where the "origin" is
- * the module.method being invoked right now).
- */
-export function buoyJsTopRunAs(api, name, thunk) {
-  if (!isActive()) return thunk();
-  const originKey = buoyJsTopScheduleOrigin(api, {
-    name
-  }, now());
-  return buoyJsTopRunFrame(originKey, thunk);
-}
-
-/** Test-only: current nesting depth. */
-export function debugDepth() {
-  return stack.length;
-}
-//# sourceMappingURL=frameStack.js.map
+"use strict";import{now as s}from"./now";import{isActive as c,WRAPPED_TAG as f}from"./state";import{buoyJsTopBookExclusive as x,buoyJsTopOriginExists as A,buoyJsTopScheduleOrigin as p}from"./originRegistry";const b=32;const e=[];const g=20;const y=64;const T=new Array(y).fill(null);let a=0;export function recentIntervals(){return T}function h(t,i){const n=s();const r=e.length>0?e[e.length-1]:null;let o=null;if(e.length<b){o={originKey:t,start:n,childrenMs:0};e.push(o)}try{return i()}finally{try{if(o){e.pop();const u=s();const l=u-n;const m=Math.max(0,l-o.childrenMs);if(r)r.childrenMs+=l;x(t,m,n,u);if(!r&&l>=g){T[a]={originKey:t,start:n,end:u};a=(a+1)%y}}}catch{}}}export function buoyJsTopWrapTask(t,i){if(typeof t!=="function")return t;if(t[f])return t;let n=c()?p(i,t,s()):null;const r=function(...o){if(!c())return t.apply(this,o);if(n===null||!A(n)){n=p(i,t,s(),false)}return h(n,()=>t.apply(this,o))};r[f]=true;return r}export function buoyJsTopRunAs(t,i,n){if(!c())return n();const r=p(t,{name:i},s());return h(r,n)}export function debugDepth(){return e.length}

package/lib/module/js-top/engine/longtasks.js

@@ -1,133 +1 @@
-"use strict";
-
-/**
- * Freeze tracking. RN ships a real `PerformanceObserver('longtask')` (C++
- * TurboModule, present in Expo Go and release): entries fire for any task
- * that blocks the JS event loop ≥ 50ms — what a user feels as a dropped tap
- * or stuttered animation — but carry NO attribution. We supply it: each
- * entry is overlap-matched against the ring of recent depth-0 wrapped
- * intervals; the biggest overlap names the offender.
- *
- * Freeze data doesn't get its own UI section — it decorates the places you
- * already look: per-row ⚠ badges in the task table and a summary chip in
- * the header, both fed by getFreezeStats() (trailing 60s window). The raw
- * entry list is still exported for the desktop panel and MCP payloads.
- *
- * The observer installs once and stays connected (uninstalling/reinstalling
- * observers has its own churn); its handler early-outs when the engine is
- * inactive — longtasks only fire on 50ms+ blocks, so the idle cost is nil.
- */
-
-import { g, isActive } from "./state";
-import { recentIntervals } from "./frameStack";
-import { labelForOrigin } from "./originRegistry";
-import { bookLongtaskRange } from "./aggregator";
-const MAX_ENTRIES = 40;
-/** Freeze badges/summary only consider the trailing window. */
-const FREEZE_WINDOW_MS = 60_000;
-
-/** Per-origin key for freezes we couldn't attribute to a wrapped callback. */
-export const SYSTEM_FREEZE_KEY = "unattributed";
-let installed = false;
-let supported = false;
-const entries = [];
-function correlate(start, duration) {
-  const end = start + duration;
-  let bestKey = null;
-  let bestOverlap = 0;
-  for (const interval of recentIntervals()) {
-    if (!interval) continue;
-    const overlap = Math.min(end, interval.end) - Math.max(start, interval.start);
-    if (overlap > bestOverlap) {
-      bestOverlap = overlap;
-      bestKey = interval.originKey;
-    }
-  }
-  return bestKey;
-}
-export function installLongtaskObserver() {
-  if (installed) return {
-    longtask: supported
-  };
-  installed = true;
-  const PerformanceObserverCtor = g.PerformanceObserver;
-  if (typeof PerformanceObserverCtor !== "function") {
-    return {
-      longtask: false
-    };
-  }
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const observer = new PerformanceObserverCtor(list => {
-      if (!isActive()) return;
-      try {
-        for (const entry of list.getEntries()) {
-          if (entry.entryType !== "longtask") continue;
-          const start = entry.startTime;
-          const duration = entry.duration;
-          bookLongtaskRange(start, start + duration);
-          entries.push({
-            start,
-            duration,
-            at: Date.now(),
-            originKey: correlate(start, duration)
-          });
-          if (entries.length > MAX_ENTRIES) entries.shift();
-        }
-      } catch {
-        // Never let observation break the app.
-      }
-    });
-    observer.observe({
-      entryTypes: ["longtask"]
-    });
-    supported = true;
-  } catch {
-    supported = false;
-  }
-  return {
-    longtask: supported
-  };
-}
-
-/** Raw recent entries (desktop panel + MCP payload shape). */
-export function getLongtasks() {
-  return entries.map(e => ({
-    start: e.start,
-    duration: e.duration,
-    at: e.at,
-    originLabel: e.originKey ? labelForOrigin(e.originKey) : null
-  }));
-}
-
-/** Windowed per-origin freeze aggregation for badges + header summary. */
-export function getFreezeStats(now) {
-  const byOrigin = {};
-  let count = 0;
-  let worstMs = 0;
-  for (const e of entries) {
-    if (e.at > 0 && now - e.at > FREEZE_WINDOW_MS) continue;
-    count++;
-    if (e.duration > worstMs) worstMs = e.duration;
-    const key = e.originKey ?? SYSTEM_FREEZE_KEY;
-    const s = byOrigin[key];
-    if (s) {
-      s.count++;
-      if (e.duration > s.maxMs) s.maxMs = e.duration;
-    } else {
-      byOrigin[key] = {
-        count: 1,
-        maxMs: e.duration
-      };
-    }
-  }
-  return {
-    count,
-    worstMs,
-    byOrigin
-  };
-}
-export function clearLongtasks() {
-  entries.length = 0;
-}
-//# sourceMappingURL=longtasks.js.map
+"use strict";import{g as f,isActive as l}from"./state";import{recentIntervals as g}from"./frameStack";import{labelForOrigin as p}from"./originRegistry";import{bookLongtaskRange as m}from"./aggregator";const y=40;const d=6e4;export const SYSTEM_FREEZE_KEY="unattributed";let u=false;let c=false;const a=[];function b(n,o){const i=n+o;let r=null;let t=0;for(const e of g()){if(!e)continue;const s=Math.min(i,e.end)-Math.max(n,e.start);if(s>t){t=s;r=e.originKey}}return r}export function installLongtaskObserver(){if(u)return{longtask:c};u=true;const n=f.PerformanceObserver;if(typeof n!=="function"){return{longtask:false}}try{const o=new n(i=>{if(!l())return;try{for(const r of i.getEntries()){if(r.entryType!=="longtask")continue;const t=r.startTime;const e=r.duration;m(t,t+e);a.push({start:t,duration:e,at:Date.now(),originKey:b(t,e)});if(a.length>y)a.shift()}}catch{}});o.observe({entryTypes:["longtask"]});c=true}catch{c=false}return{longtask:c}}export function getLongtasks(){return a.map(n=>({start:n.start,duration:n.duration,at:n.at,originLabel:n.originKey?p(n.originKey):null}))}export function getFreezeStats(n){const o={};let i=0;let r=0;for(const t of a){if(t.at>0&&n-t.at>d)continue;i++;if(t.duration>r)r=t.duration;const e=t.originKey??SYSTEM_FREEZE_KEY;const s=o[e];if(s){s.count++;if(t.duration>s.maxMs)s.maxMs=t.duration}else{o[e]={count:1,maxMs:t.duration}}}return{count:i,worstMs:r,byOrigin:o}}export function clearLongtasks(){a.length=0}

package/lib/module/js-top/engine/now.js

@@ -1,33 +1 @@
-"use strict";
-
-/**
- * High-res monotonic clock for the engine's hot path. Resolved once at module
- * load: `nativePerformanceNow` (JSI global, cheapest) → `performance.now` →
- * `Date.now`. All engine timestamps share this single time base.
- */
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const g =
-// eslint-disable-next-line no-restricted-globals
-typeof globalThis !== "undefined" ? globalThis : undefined;
-const resolved = (() => {
-  if (typeof g?.nativePerformanceNow === "function") {
-    const native = g.nativePerformanceNow;
-    return () => native();
-  }
-  if (typeof g?.performance?.now === "function") {
-    const perf = g.performance;
-    return () => perf.now();
-  }
-  return () => Date.now();
-})();
-let clock = resolved;
-export function now() {
-  return clock();
-}
-
-/** Test-only: swap the engine clock for a controllable one. */
-export function setNowForTests(fn) {
-  clock = fn ?? resolved;
-}
-//# sourceMappingURL=now.js.map
+"use strict";const n=typeof globalThis!=="undefined"?globalThis:void 0;const o=(()=>{if(typeof n?.nativePerformanceNow==="function"){const e=n.nativePerformanceNow;return()=>e()}if(typeof n?.performance?.now==="function"){const e=n.performance;return()=>e.now()}return()=>Date.now()})();let t=o;export function now(){return t()}export function setNowForTests(e){t=e??o}