@buoy-gg/js-top 7.0.40 → 7.0.42

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

@@ -1,133 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.buoyJsTopRunAs = buoyJsTopRunAs;
-exports.buoyJsTopWrapTask = buoyJsTopWrapTask;
-exports.debugDepth = debugDepth;
-exports.recentIntervals = recentIntervals;
-var _now = require("./now");
-var _state = require("./state");
-var _originRegistry = require("./originRegistry");
-/**
- * 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.
- */
-
-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. */
-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 = (0, _now.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 = (0, _now.now)();
-        const total = end - start;
-        const exclusive = Math.max(0, total - frame.childrenMs);
-        if (parent) parent.childrenMs += total;
-        (0, _originRegistry.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.
- */
-function buoyJsTopWrapTask(fn, api) {
-  if (typeof fn !== "function") return fn;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  if (fn[_state.WRAPPED_TAG]) return fn;
-  let originKey = (0, _state.isActive)() ? (0, _originRegistry.buoyJsTopScheduleOrigin)(api, fn, (0, _now.now)()) : null;
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const buoyJsTopTaskWrapper = function (...args) {
-    if (!(0, _state.isActive)()) return fn.apply(this, args);
-    if (originKey === null || !(0, _originRegistry.buoyJsTopOriginExists)(originKey)) {
-      // Scheduled while the engine was off, or stats cleared since —
-      // (re)resolve identity now, without stack capture (see scheduleOrigin).
-      originKey = (0, _originRegistry.buoyJsTopScheduleOrigin)(api, fn, (0, _now.now)(), false);
-    }
-    return buoyJsTopRunFrame(originKey, () => fn.apply(this, args));
-  };
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  buoyJsTopTaskWrapper[_state.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).
- */
-function buoyJsTopRunAs(api, name, thunk) {
-  if (!(0, _state.isActive)()) return thunk();
-  const originKey = (0, _originRegistry.buoyJsTopScheduleOrigin)(api, {
-    name
-  }, (0, _now.now)());
-  return buoyJsTopRunFrame(originKey, thunk);
-}
-
-/** Test-only: current nesting depth. */
-function debugDepth() {
-  return stack.length;
-}
-//# sourceMappingURL=frameStack.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.buoyJsTopRunAs=buoyJsTopRunAs;exports.buoyJsTopWrapTask=buoyJsTopWrapTask;exports.debugDepth=debugDepth;exports.recentIntervals=recentIntervals;var _now=require("./now");var _state=require("./state");var _originRegistry=require("./originRegistry");const DEPTH_CAP=32;const stack=[];const NOTABLE_INTERVAL_MS=20;const INTERVAL_RING_SIZE=64;const intervalRing=new Array(INTERVAL_RING_SIZE).fill(null);let intervalRingIndex=0;function recentIntervals(){return intervalRing}function buoyJsTopRunFrame(e,o){const t=(0,_now.now)();const n=stack.length>0?stack[stack.length-1]:null;let r=null;if(stack.length<DEPTH_CAP){r={originKey:e,start:t,childrenMs:0};stack.push(r)}try{return o()}finally{try{if(r){stack.pop();const s=(0,_now.now)();const i=s-t;const u=Math.max(0,i-r.childrenMs);if(n)n.childrenMs+=i;(0,_originRegistry.buoyJsTopBookExclusive)(e,u,t,s);if(!n&&i>=NOTABLE_INTERVAL_MS){intervalRing[intervalRingIndex]={originKey:e,start:t,end:s};intervalRingIndex=(intervalRingIndex+1)%INTERVAL_RING_SIZE}}}catch{}}}function buoyJsTopWrapTask(e,o){if(typeof e!=="function")return e;if(e[_state.WRAPPED_TAG])return e;let t=(0,_state.isActive)()?(0,_originRegistry.buoyJsTopScheduleOrigin)(o,e,(0,_now.now)()):null;const n=function(...r){if(!(0,_state.isActive)())return e.apply(this,r);if(t===null||!(0,_originRegistry.buoyJsTopOriginExists)(t)){t=(0,_originRegistry.buoyJsTopScheduleOrigin)(o,e,(0,_now.now)(),false)}return buoyJsTopRunFrame(t,()=>e.apply(this,r))};n[_state.WRAPPED_TAG]=true;return n}function buoyJsTopRunAs(e,o,t){if(!(0,_state.isActive)())return t();const n=(0,_originRegistry.buoyJsTopScheduleOrigin)(e,{name:o},(0,_now.now)());return buoyJsTopRunFrame(n,t)}function debugDepth(){return stack.length}

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

@@ -1,141 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.SYSTEM_FREEZE_KEY = void 0;
-exports.clearLongtasks = clearLongtasks;
-exports.getFreezeStats = getFreezeStats;
-exports.getLongtasks = getLongtasks;
-exports.installLongtaskObserver = installLongtaskObserver;
-var _state = require("./state");
-var _frameStack = require("./frameStack");
-var _originRegistry = require("./originRegistry");
-var _aggregator = require("./aggregator");
-/**
- * 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.
- */
-
-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. */
-const SYSTEM_FREEZE_KEY = exports.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 (0, _frameStack.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;
-}
-function installLongtaskObserver() {
-  if (installed) return {
-    longtask: supported
-  };
-  installed = true;
-  const PerformanceObserverCtor = _state.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 (!(0, _state.isActive)()) return;
-      try {
-        for (const entry of list.getEntries()) {
-          if (entry.entryType !== "longtask") continue;
-          const start = entry.startTime;
-          const duration = entry.duration;
-          (0, _aggregator.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). */
-function getLongtasks() {
-  return entries.map(e => ({
-    start: e.start,
-    duration: e.duration,
-    at: e.at,
-    originLabel: e.originKey ? (0, _originRegistry.labelForOrigin)(e.originKey) : null
-  }));
-}
-
-/** Windowed per-origin freeze aggregation for badges + header summary. */
-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
-  };
-}
-function clearLongtasks() {
-  entries.length = 0;
-}
-//# sourceMappingURL=longtasks.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.SYSTEM_FREEZE_KEY=void 0;exports.clearLongtasks=clearLongtasks;exports.getFreezeStats=getFreezeStats;exports.getLongtasks=getLongtasks;exports.installLongtaskObserver=installLongtaskObserver;var _state=require("./state");var _frameStack=require("./frameStack");var _originRegistry=require("./originRegistry");var _aggregator=require("./aggregator");const MAX_ENTRIES=40;const FREEZE_WINDOW_MS=6e4;const SYSTEM_FREEZE_KEY=exports.SYSTEM_FREEZE_KEY="unattributed";let installed=false;let supported=false;const entries=[];function correlate(e,o){const a=e+o;let n=null;let t=0;for(const r of(0,_frameStack.recentIntervals)()){if(!r)continue;const s=Math.min(a,r.end)-Math.max(e,r.start);if(s>t){t=s;n=r.originKey}}return n}function installLongtaskObserver(){if(installed)return{longtask:supported};installed=true;const e=_state.g.PerformanceObserver;if(typeof e!=="function"){return{longtask:false}}try{const o=new e(a=>{if(!(0,_state.isActive)())return;try{for(const n of a.getEntries()){if(n.entryType!=="longtask")continue;const t=n.startTime;const r=n.duration;(0,_aggregator.bookLongtaskRange)(t,t+r);entries.push({start:t,duration:r,at:Date.now(),originKey:correlate(t,r)});if(entries.length>MAX_ENTRIES)entries.shift()}}catch{}});o.observe({entryTypes:["longtask"]});supported=true}catch{supported=false}return{longtask:supported}}function getLongtasks(){return entries.map(e=>({start:e.start,duration:e.duration,at:e.at,originLabel:e.originKey?(0,_originRegistry.labelForOrigin)(e.originKey):null}))}function getFreezeStats(e){const o={};let a=0;let n=0;for(const t of entries){if(t.at>0&&e-t.at>FREEZE_WINDOW_MS)continue;a++;if(t.duration>n)n=t.duration;const r=t.originKey??SYSTEM_FREEZE_KEY;const s=o[r];if(s){s.count++;if(t.duration>s.maxMs)s.maxMs=t.duration}else{o[r]={count:1,maxMs:t.duration}}}return{count:a,worstMs:n,byOrigin:o}}function clearLongtasks(){entries.length=0}

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

@@ -1,38 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.now = now;
-exports.setNowForTests = setNowForTests;
-/**
- * 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;
-function now() {
-  return clock();
-}
-
-/** Test-only: swap the engine clock for a controllable one. */
-function setNowForTests(fn) {
-  clock = fn ?? resolved;
-}
-//# sourceMappingURL=now.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.now=now;exports.setNowForTests=setNowForTests;const g=typeof globalThis!=="undefined"?globalThis:void 0;const resolved=(()=>{if(typeof g?.nativePerformanceNow==="function"){const e=g.nativePerformanceNow;return()=>e()}if(typeof g?.performance?.now==="function"){const e=g.performance;return()=>e.now()}return()=>Date.now()})();let clock=resolved;function now(){return clock()}function setNowForTests(e){clock=e??resolved}