@buoy-gg/js-top 7.0.3

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

@@ -0,0 +1,54 @@
+"use strict";
+
+/**
+ * Shared engine state + pre-patch originals.
+ *
+ * `active` is the single gate every patched global checks at schedule time:
+ * patches install once and are NEVER removed (restoring originals would
+ * clobber any wrapper another library — Sentry, Reanimated — layered on top
+ * of ours after install; same reasoning as highlight-updates' CommitProfiler
+ * hook). When inactive, a patched global forwards the raw callback to the
+ * original at the cost of one boolean check.
+ *
+ * `originals` are captured BEFORE patching so the engine's own probe and
+ * notify timers never flow through the wrappers — JS TOP must not list
+ * itself as a task.
+ */
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const g =
+// eslint-disable-next-line no-restricted-globals
+typeof globalThis !== "undefined" ? globalThis : {};
+let active = false;
+export function isActive() {
+  return active;
+}
+export function setActive(on) {
+  active = on;
+}
+let originals = null;
+
+/** Capture pre-patch globals. Idempotent; first call wins. */
+export function captureOriginals() {
+  if (!originals) {
+    originals = {
+      setTimeout: g.setTimeout?.bind(g),
+      setInterval: g.setInterval?.bind(g),
+      clearInterval: g.clearInterval?.bind(g),
+      clearTimeout: g.clearTimeout?.bind(g),
+      setImmediate: g.setImmediate?.bind(g),
+      requestAnimationFrame: g.requestAnimationFrame?.bind(g),
+      queueMicrotask: g.queueMicrotask?.bind(g)
+    };
+  }
+  return originals;
+}
+export function getOriginals() {
+  return captureOriginals();
+}
+
+/** Tag interned on patched globals so duplicate module instances skip re-patching. */
+export const PATCHED_TAG = Symbol.for("buoy.jsTop.patched");
+/** Marker set on wrapper functions so a wrapped fn is never wrapped twice. */
+export const WRAPPED_TAG = Symbol.for("buoy.jsTop.wrapped");
+//# sourceMappingURL=state.js.map

package/lib/module/js-top/engine/state.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["g","globalThis","active","isActive","setActive","on","originals","captureOriginals","setTimeout","bind","setInterval","clearInterval","clearTimeout","setImmediate","requestAnimationFrame","queueMicrotask","getOriginals","PATCHED_TAG","Symbol","for","WRAPPED_TAG"],"sourceRoot":"../../../../src","sources":["js-top/engine/state.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,OAAO,MAAMA,CAAM;AACjB;AACA,OAAOC,UAAU,KAAK,WAAW,GAAGA,UAAU,GAAG,CAAC,CAAC;AAErD,IAAIC,MAAM,GAAG,KAAK;AAElB,OAAO,SAASC,QAAQA,CAAA,EAAY;EAClC,OAAOD,MAAM;AACf;AAEA,OAAO,SAASE,SAASA,CAACC,EAAW,EAAQ;EAC3CH,MAAM,GAAGG,EAAE;AACb;AAYA,IAAIC,SAA2B,GAAG,IAAI;;AAEtC;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAAc;EAC5C,IAAI,CAACD,SAAS,EAAE;IACdA,SAAS,GAAG;MACVE,UAAU,EAAER,CAAC,CAACQ,UAAU,EAAEC,IAAI,CAACT,CAAC,CAAC;MACjCU,WAAW,EAAEV,CAAC,CAACU,WAAW,EAAED,IAAI,CAACT,CAAC,CAAC;MACnCW,aAAa,EAAEX,CAAC,CAACW,aAAa,EAAEF,IAAI,CAACT,CAAC,CAAC;MACvCY,YAAY,EAAEZ,CAAC,CAACY,YAAY,EAAEH,IAAI,CAACT,CAAC,CAAC;MACrCa,YAAY,EAAEb,CAAC,CAACa,YAAY,EAAEJ,IAAI,CAACT,CAAC,CAAC;MACrCc,qBAAqB,EAAEd,CAAC,CAACc,qBAAqB,EAAEL,IAAI,CAACT,CAAC,CAAC;MACvDe,cAAc,EAAEf,CAAC,CAACe,cAAc,EAAEN,IAAI,CAACT,CAAC;IAC1C,CAAC;EACH;EACA,OAAOM,SAAS;AAClB;AAEA,OAAO,SAASU,YAAYA,CAAA,EAAc;EACxC,OAAOT,gBAAgB,CAAC,CAAC;AAC3B;;AAEA;AACA,OAAO,MAAMU,WAAW,GAAGC,MAAM,CAACC,GAAG,CAAC,oBAAoB,CAAC;AAC3D;AACA,OAAO,MAAMC,WAAW,GAAGF,MAAM,CAACC,GAAG,CAAC,oBAAoB,CAAC","ignoreList":[]}

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

@@ -0,0 +1,91 @@
+"use strict";
+
+/**
+ * Dev-only origin symbolication via Metro's /symbolicate endpoint (the same
+ * one LogBox uses). Hermes stacks give function names + bundle offsets; for
+ * anonymous scheduling sites (the typical `useEffect(() => setInterval(…))`)
+ * that leaves an unreadable label. Metro maps the offset back to the real
+ * source file — so a row can say `setInterval ← ChatScreen.tsx:42`, which is
+ * component-level attribution in practice.
+ *
+ * Fire-and-forget with hard caps: one attempt per origin, few in flight,
+ * silent on any failure (release builds, tunnels, Metro gone). The origin's
+ * label/file/line are upgraded in place when the answer lands — the table
+ * re-renders every tick and picks it up.
+ */
+
+const MAX_IN_FLIGHT = 3;
+let inFlight = 0;
+function isDev() {
+  return typeof __DEV__ !== "undefined" && __DEV__;
+}
+
+/** Last two path segments of a source path — "screens/ChatScreen.tsx". */
+function tailPath(file) {
+  const clean = file.split("?")[0] ?? file;
+  const parts = clean.split("/").filter(Boolean);
+  return parts.slice(-2).join("/");
+}
+
+/** True for names like ChatScreen / PokemonScreen — reads as a component. */
+function looksLikeComponent(name) {
+  return /^[A-Z][A-Za-z0-9]*$/.test(name);
+}
+export function buoyJsTopSymbolicateOrigin(o, apiLabelText) {
+  if (!isDev()) return;
+  if (o.symbolicated || !o.frames || o.frames.length === 0) return;
+  if (inFlight >= MAX_IN_FLIGHT) return; // retried implicitly? no — one shot
+  o.symbolicated = true;
+  const top = o.frames[0];
+  if (!top || !/^https?:\/\//.test(top.file)) return;
+  let endpoint;
+  try {
+    endpoint = `${new URL(top.file).origin}/symbolicate`;
+  } catch {
+    return;
+  }
+  inFlight++;
+  const body = JSON.stringify({
+    stack: o.frames.map(f => ({
+      file: f.file,
+      lineNumber: f.line,
+      column: f.col,
+      methodName: ""
+    }))
+  });
+  fetch(endpoint, {
+    method: "POST",
+    body
+  }).then(res => res.ok ? res.json() : null).then(data => {
+    let frame = data?.stack?.find(f => f.file && !f.file.includes("node_modules")) ?? data?.stack?.[0];
+    // Some Metro configs (serialized source maps) reject full
+    // symbolication but still NAME the module in the error — that file
+    // path is exactly the scheduling site, so harvest it.
+    if (!frame?.file && data?.error) {
+      const m = /found: (\/.+)$/.exec(data.error);
+      if (m) frame = {
+        file: m[1]
+      };
+    }
+    if (!frame?.file) return;
+    const file = tailPath(frame.file);
+    const line = frame.lineNumber;
+    const method = frame.methodName && frame.methodName !== "<unknown>" ? frame.methodName : undefined;
+    o.file = file;
+    o.line = line ?? o.line;
+    // The existing label is name-anchored — append the source site
+    // once, and promote a component-looking method name.
+    const site = `${file.split("/").pop()}${line != null ? `:${line}` : ""}`;
+    if (method && looksLikeComponent(method) && !o.caller) {
+      o.caller = method;
+      o.label = `${o.label} ← <${method}> · ${site}`;
+    } else {
+      o.label = `${o.label} · ${site}`;
+    }
+  }).catch(() => {
+    // Symbolication is best-effort decoration — never surface failures.
+  }).finally(() => {
+    inFlight--;
+  });
+}
+//# sourceMappingURL=symbolicate.js.map

package/lib/module/js-top/engine/symbolicate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_IN_FLIGHT","inFlight","isDev","__DEV__","tailPath","file","clean","split","parts","filter","Boolean","slice","join","looksLikeComponent","name","test","buoyJsTopSymbolicateOrigin","o","apiLabelText","symbolicated","frames","length","top","endpoint","URL","origin","body","JSON","stringify","stack","map","f","lineNumber","line","column","col","methodName","fetch","method","then","res","ok","json","data","frame","find","includes","error","m","exec","undefined","site","pop","caller","label","catch","finally"],"sourceRoot":"../../../../src","sources":["js-top/engine/symbolicate.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/js-top/sync/jsTopSyncAdapter.js

@@ -0,0 +1,70 @@
+"use strict";
+
+/**
+ * Sync adapter for the JS TOP tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it — same pattern as
+ * perf-monitor's adapter).
+ *
+ * `subscribe` is only called while a dashboard is watching, and subscribing
+ * to JsTopController is exactly what starts the engine — so a desktop
+ * watcher auto-starts sampling and closing the desktop tool stops it. The
+ * snapshot IS the live channel; there is no heavy persisted state.
+ */
+
+import { JsTopController } from "../engine/JsTopController";
+export const jsTopSyncAdapter = {
+  version: 1,
+  getSnapshot: () => ({
+    live: JsTopController.getSnapshot(),
+    // "enabled" mirrors perf-monitor semantics: is the device sampling for
+    // any viewer (its own HUD/modal or a desktop's silent remote sampling).
+    enabled: JsTopController.isEnabled() || JsTopController.isRemoteSampling()
+  }),
+  subscribe: onChange => {
+    const unsubSnapshot = JsTopController.subscribe(() => onChange());
+    const unsubEnabled = JsTopController.subscribeEnabled(() => onChange());
+    return () => {
+      unsubSnapshot();
+      unsubEnabled();
+    };
+  },
+  actions: {
+    /**
+     * Silent sampling for a desktop viewer: streams snapshots without
+     * showing the device's own HUD. (Subscribing via `subscribe` already
+     * runs the engine while watched; this exists so MCP / scripted callers
+     * can force sampling on without a watch.)
+     */
+    setEnabled: params => {
+      const enabled = params.enabled;
+      JsTopController.setRemoteSampling(enabled);
+    },
+    pause: () => JsTopController.pause(),
+    resume: () => JsTopController.resume(),
+    clear: () => JsTopController.clear(),
+    /** Full detail for one origin (desktop tap-through parity). */
+    getOriginDetail: params => JsTopController.getOriginDetail(params.key),
+    /**
+     * One-shot sample for MCP/automation: ensure the engine is running,
+     * observe for `durationMs` (default 3s, capped 30s), return the
+     * resulting snapshot. `clearFirst` resets all stats before sampling so
+     * the result attributes exactly one interaction/window. Leaves sampling
+     * in its prior state.
+     */
+    sample: async params => {
+      const p = params;
+      const durationMs = Math.min(Math.max(p?.durationMs ?? 3000, 250), 30_000);
+      const wasSampling = JsTopController.isRemoteSampling() || JsTopController.isEnabled();
+      if (!wasSampling) JsTopController.setRemoteSampling(true);
+      if (p?.clearFirst) JsTopController.clear();
+      try {
+        await new Promise(resolve => setTimeout(resolve, durationMs));
+        return JsTopController.getSnapshot();
+      } finally {
+        if (!wasSampling) JsTopController.setRemoteSampling(false);
+      }
+    }
+  }
+};
+//# sourceMappingURL=jsTopSyncAdapter.js.map

package/lib/module/js-top/sync/jsTopSyncAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["JsTopController","jsTopSyncAdapter","version","getSnapshot","live","enabled","isEnabled","isRemoteSampling","subscribe","onChange","unsubSnapshot","unsubEnabled","subscribeEnabled","actions","setEnabled","params","setRemoteSampling","pause","resume","clear","getOriginDetail","key","sample","p","durationMs","Math","min","max","wasSampling","clearFirst","Promise","resolve","setTimeout"],"sourceRoot":"../../../../src","sources":["js-top/sync/jsTopSyncAdapter.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,eAAe,QAAQ,2BAA2B;AAG3D,OAAO,MAAMC,gBAAgB,GAAG;EAC9BC,OAAO,EAAE,CAAC;EACVC,WAAW,EAAEA,CAAA,MAAkD;IAC7DC,IAAI,EAAEJ,eAAe,CAACG,WAAW,CAAC,CAAC;IACnC;IACA;IACAE,OAAO,EACLL,eAAe,CAACM,SAAS,CAAC,CAAC,IAAIN,eAAe,CAACO,gBAAgB,CAAC;EACpE,CAAC,CAAC;EACFC,SAAS,EAAGC,QAAoB,IAAK;IACnC,MAAMC,aAAa,GAAGV,eAAe,CAACQ,SAAS,CAAC,MAAMC,QAAQ,CAAC,CAAC,CAAC;IACjE,MAAME,YAAY,GAAGX,eAAe,CAACY,gBAAgB,CAAC,MAAMH,QAAQ,CAAC,CAAC,CAAC;IACvE,OAAO,MAAM;MACXC,aAAa,CAAC,CAAC;MACfC,YAAY,CAAC,CAAC;IAChB,CAAC;EACH,CAAC;EACDE,OAAO,EAAE;IACP;AACJ;AACA;AACA;AACA;AACA;IACIC,UAAU,EAAGC,MAAe,IAAK;MAC/B,MAAMV,OAAO,GAAIU,MAAM,CAA0BV,OAAO;MACxDL,eAAe,CAACgB,iBAAiB,CAACX,OAAO,CAAC;IAC5C,CAAC;IACDY,KAAK,EAAEA,CAAA,KAAMjB,eAAe,CAACiB,KAAK,CAAC,CAAC;IACpCC,MAAM,EAAEA,CAAA,KAAMlB,eAAe,CAACkB,MAAM,CAAC,CAAC;IACtCC,KAAK,EAAEA,CAAA,KAAMnB,eAAe,CAACmB,KAAK,CAAC,CAAC;IACpC;IACAC,eAAe,EAAGL,MAAe,IAC/Bf,eAAe,CAACoB,eAAe,CAAEL,MAAM,CAAqBM,GAAG,CAAC;IAClE;AACJ;AACA;AACA;AACA;AACA;AACA;IACIC,MAAM,EAAE,MAAOP,MAAe,IAAK;MACjC,MAAMQ,CAAC,GAAGR,MAAuD;MACjE,MAAMS,UAAU,GAAGC,IAAI,CAACC,GAAG,CAACD,IAAI,CAACE,GAAG,CAACJ,CAAC,EAAEC,UAAU,IAAI,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC;MACzE,MAAMI,WAAW,GACf5B,eAAe,CAACO,gBAAgB,CAAC,CAAC,IAAIP,eAAe,CAACM,SAAS,CAAC,CAAC;MACnE,IAAI,CAACsB,WAAW,EAAE5B,eAAe,CAACgB,iBAAiB,CAAC,IAAI,CAAC;MACzD,IAAIO,CAAC,EAAEM,UAAU,EAAE7B,eAAe,CAACmB,KAAK,CAAC,CAAC;MAC1C,IAAI;QACF,MAAM,IAAIW,OAAO,CAAEC,OAAO,IAAKC,UAAU,CAACD,OAAO,EAAEP,UAAU,CAAC,CAAC;QAC/D,OAAOxB,eAAe,CAACG,WAAW,CAAC,CAAC;MACtC,CAAC,SAAS;QACR,IAAI,CAACyB,WAAW,EAAE5B,eAAe,CAACgB,iBAAiB,CAAC,KAAK,CAAC;MAC5D;IACF;EACF;AACF,CAAC","ignoreList":[]}

package/lib/module/js-top/types/index.js

@@ -0,0 +1,42 @@
+"use strict";
+
+/**
+ * JS TOP — live Task Manager for the React Native JS thread.
+ *
+ * Attribution model: the engine wraps every JS-thread entry point it can
+ * reach (timers, rAF, microtasks, Promise reactions, legacy-bridge call-ins)
+ * and books EXCLUSIVE time per "origin" (the place a callback was scheduled
+ * from). A high-frequency probe measures true thread occupancy; the gap
+ * between measured busy time and attributed time is surfaced honestly as an
+ * "unattributed" row rather than hidden.
+ */
+
+/** Which entry-point API a task came through. */
+
+/** One captured stack frame from an origin's scheduling site (dev-readable). */
+
+/**
+ * Which coverage tiers are live on this device. UIs gray out / banner what a
+ * runtime can't see (e.g. bridge call-ins don't exist on bridgeless).
+ */
+
+/** One row of the live table — a task origin ("process" in Task Manager terms). */
+
+/** A 50ms+ blocking task reported by the runtime, with our best attribution. */
+
+/** The JSON-serializable live snapshot (device UI + external-sync payload). */
+
+/** Everything the engine knows about one origin — the tap-through detail. */
+
+/** Engine tuning constants — exported for tests. */
+export const BUCKET_MS = 250;
+/** Rolling "recent" window: 20 buckets = 5s. */
+export const WINDOW_BUCKETS = 20;
+/** Global busy history ring: 120 buckets = 30s. */
+export const HISTORY_BUCKETS = 120;
+export const MAX_ORIGINS = 500;
+/** Promotion thresholds: capture a scheduling stack once an origin is hot. */
+export const PROMOTE_MIN_CALLS = 25;
+export const PROMOTE_MIN_TOTAL_MS = 50;
+export const SNAPSHOT_ROWS = 30;
+//# sourceMappingURL=index.js.map

package/lib/module/js-top/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BUCKET_MS","WINDOW_BUCKETS","HISTORY_BUCKETS","MAX_ORIGINS","PROMOTE_MIN_CALLS","PROMOTE_MIN_TOTAL_MS","SNAPSHOT_ROWS"],"sourceRoot":"../../../../src","sources":["js-top/types/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAYA;;AAOA;AACA;AACA;AACA;;AAYA;;AA0BA;;AAWA;;AAwBA;;AA2BA;AACA,OAAO,MAAMA,SAAS,GAAG,GAAG;AAC5B;AACA,OAAO,MAAMC,cAAc,GAAG,EAAE;AAChC;AACA,OAAO,MAAMC,eAAe,GAAG,GAAG;AAClC,OAAO,MAAMC,WAAW,GAAG,GAAG;AAC9B;AACA,OAAO,MAAMC,iBAAiB,GAAG,EAAE;AACnC,OAAO,MAAMC,oBAAoB,GAAG,EAAE;AACtC,OAAO,MAAMC,aAAa,GAAG,EAAE","ignoreList":[]}

package/lib/module/js-top/utils/preferences.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * Persisted JS TOP preferences. Same load-then-save contract as
+ * perf-monitor's hudPreferences: rehydrate async, and only persist
+ * user-driven changes after the load resolves so defaults never clobber
+ * last session's state.
+ */
+
+import { persistentStorage } from "@buoy-gg/shared-ui";
+const KEY = "@react_buoy/js-top/prefs";
+const DEFAULTS = {
+  enabled: false
+};
+export async function loadJsTopPrefs() {
+  try {
+    const raw = await persistentStorage.getItem(KEY);
+    if (!raw) return DEFAULTS;
+    const parsed = JSON.parse(raw);
+    return {
+      enabled: parsed.enabled === true
+    };
+  } catch {
+    return DEFAULTS;
+  }
+}
+export async function saveJsTopPrefs(prefs) {
+  try {
+    await persistentStorage.setItem(KEY, JSON.stringify(prefs));
+  } catch {
+    // Storage unavailable — non-fatal.
+  }
+}
+//# sourceMappingURL=preferences.js.map

package/lib/module/js-top/utils/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["persistentStorage","KEY","DEFAULTS","enabled","loadJsTopPrefs","raw","getItem","parsed","JSON","parse","saveJsTopPrefs","prefs","setItem","stringify"],"sourceRoot":"../../../../src","sources":["js-top/utils/preferences.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,iBAAiB,QAAQ,oBAAoB;AAEtD,MAAMC,GAAG,GAAG,0BAA0B;AAMtC,MAAMC,QAAoB,GAAG;EAAEC,OAAO,EAAE;AAAM,CAAC;AAE/C,OAAO,eAAeC,cAAcA,CAAA,EAAwB;EAC1D,IAAI;IACF,MAAMC,GAAG,GAAG,MAAML,iBAAiB,CAACM,OAAO,CAACL,GAAG,CAAC;IAChD,IAAI,CAACI,GAAG,EAAE,OAAOH,QAAQ;IACzB,MAAMK,MAAM,GAAGC,IAAI,CAACC,KAAK,CAACJ,GAAG,CAAwB;IACrD,OAAO;MAAEF,OAAO,EAAEI,MAAM,CAACJ,OAAO,KAAK;IAAK,CAAC;EAC7C,CAAC,CAAC,MAAM;IACN,OAAOD,QAAQ;EACjB;AACF;AAEA,OAAO,eAAeQ,cAAcA,CAACC,KAAiB,EAAiB;EACrE,IAAI;IACF,MAAMX,iBAAiB,CAACY,OAAO,CAACX,GAAG,EAAEO,IAAI,CAACK,SAAS,CAACF,KAAK,CAAC,CAAC;EAC7D,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ","ignoreList":[]}

package/lib/module/preset.js

@@ -0,0 +1,71 @@
+"use strict";
+
+/**
+ * Pre-configured JS TOP tools for FloatingDevTools.
+ *
+ * Two presets:
+ *  - jsTopPreset: toggle-only chip that turns the floating busy% pill on/off.
+ *  - jsTopModalPreset: opens the Task Manager window (ranked live table).
+ *
+ * @example
+ * ```tsx
+ * import { jsTopPreset, jsTopModalPreset } from '@buoy-gg/js-top';
+ *
+ * <FloatingDevTools apps={[jsTopPreset, jsTopModalPreset]} />
+ * ```
+ */
+
+import { useEffect, useState } from "react";
+import { Activity } from "@buoy-gg/shared-ui";
+import { JsTopController } from "./js-top/engine/JsTopController";
+import { JsTopModal } from "./js-top/components/JsTopModal";
+import { jsx as _jsx } from "react/jsx-runtime";
+export const JS_TOP_ENABLED_COLOR = "#34D399";
+export const JS_TOP_DISABLED_COLOR = "#6B7280";
+function JsTopToggleIcon({
+  size
+}) {
+  const [enabled, setEnabled] = useState(() => JsTopController.isEnabled());
+  useEffect(() => JsTopController.subscribeEnabled(setEnabled), []);
+  return /*#__PURE__*/_jsx(Activity, {
+    size: size,
+    color: enabled ? JS_TOP_ENABLED_COLOR : JS_TOP_DISABLED_COLOR
+  });
+}
+function EmptyComponent() {
+  return null;
+}
+
+/** Toggle-only preset: show/hide the floating busy% pill. */
+export const jsTopPreset = {
+  id: "js-top",
+  name: "JS TOP",
+  description: "Toggle the floating JS-thread busy pill",
+  slot: "row",
+  icon: JsTopToggleIcon,
+  component: EmptyComponent,
+  props: {},
+  launchMode: "toggle-only",
+  onPress: () => {
+    JsTopController.setEnabled(!JsTopController.isEnabled());
+  }
+};
+
+/** Modal preset: the live Task Manager window. */
+export const jsTopModalPreset = {
+  id: "js-top-modal",
+  name: "TASKS",
+  description: "Live Task Manager for the JS thread",
+  slot: "both",
+  icon: ({
+    size
+  }) => /*#__PURE__*/_jsx(Activity, {
+    size: size,
+    color: JS_TOP_ENABLED_COLOR
+  }),
+  component: JsTopModal,
+  props: {
+    enableSharedModalDimensions: false
+  }
+};
+//# sourceMappingURL=preset.js.map

package/lib/module/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useState","Activity","JsTopController","JsTopModal","jsx","_jsx","JS_TOP_ENABLED_COLOR","JS_TOP_DISABLED_COLOR","JsTopToggleIcon","size","enabled","setEnabled","isEnabled","subscribeEnabled","color","EmptyComponent","jsTopPreset","id","name","description","slot","icon","component","props","launchMode","onPress","jsTopModalPreset","enableSharedModalDimensions"],"sourceRoot":"../../src","sources":["preset.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,eAAe,QAAQ,iCAAiC;AACjE,SAASC,UAAU,QAAQ,gCAAgC;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAE5D,OAAO,MAAMC,oBAAoB,GAAG,SAAS;AAC7C,OAAO,MAAMC,qBAAqB,GAAG,SAAS;AAE9C,SAASC,eAAeA,CAAC;EAAEC;AAAuB,CAAC,EAAE;EACnD,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGX,QAAQ,CAAC,MAAME,eAAe,CAACU,SAAS,CAAC,CAAC,CAAC;EACzEb,SAAS,CAAC,MAAMG,eAAe,CAACW,gBAAgB,CAACF,UAAU,CAAC,EAAE,EAAE,CAAC;EACjE,oBACEN,IAAA,CAACJ,QAAQ;IACPQ,IAAI,EAAEA,IAAK;IACXK,KAAK,EAAEJ,OAAO,GAAGJ,oBAAoB,GAAGC;EAAsB,CAC/D,CAAC;AAEN;AAEA,SAASQ,cAAcA,CAAA,EAAG;EACxB,OAAO,IAAI;AACb;;AAEA;AACA,OAAO,MAAMC,WAAW,GAAG;EACzBC,EAAE,EAAE,QAAQ;EACZC,IAAI,EAAE,QAAQ;EACdC,WAAW,EAAE,yCAAyC;EACtDC,IAAI,EAAE,KAAc;EACpBC,IAAI,EAAEb,eAAe;EACrBc,SAAS,EAAEP,cAAc;EACzBQ,KAAK,EAAE,CAAC,CAAC;EACTC,UAAU,EAAE,aAAsB;EAClCC,OAAO,EAAEA,CAAA,KAAM;IACbvB,eAAe,CAACS,UAAU,CAAC,CAACT,eAAe,CAACU,SAAS,CAAC,CAAC,CAAC;EAC1D;AACF,CAAC;;AAED;AACA,OAAO,MAAMc,gBAAgB,GAAG;EAC9BT,EAAE,EAAE,cAAc;EAClBC,IAAI,EAAE,OAAO;EACbC,WAAW,EAAE,qCAAqC;EAClDC,IAAI,EAAE,MAAe;EACrBC,IAAI,EAAEA,CAAC;IAAEZ;EAAuB,CAAC,kBAC/BJ,IAAA,CAACJ,QAAQ;IAACQ,IAAI,EAAEA,IAAK;IAACK,KAAK,EAAER;EAAqB,CAAE,CACrD;EACDgB,SAAS,EAAEnB,UAAU;EACrBoB,KAAK,EAAE;IACLI,2BAA2B,EAAE;EAC/B;AACF,CAAC","ignoreList":[]}

package/lib/typescript/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @buoy-gg/js-top — live Task Manager for the React Native JS thread.
+ *
+ * Pure JS (Expo Go + release compatible): wraps timers / rAF / microtasks /
+ * Promise reactions / legacy-bridge call-ins and books exclusive time per
+ * scheduling origin; a calibrated busy probe measures true thread occupancy
+ * so unattributable work is surfaced honestly instead of hidden.
+ *
+ * Coverage tiers beyond the core (promises, bridge, longtask correlation)
+ * are registered here at module scope — the controller installs them lazily
+ * on first engine start, so importing this package costs nothing until a
+ * viewer opens the tool.
+ */
+export { JsTopController } from "./js-top/engine/JsTopController";
+export { jsTopSyncAdapter } from "./js-top/sync/jsTopSyncAdapter";
+export { JsTopModal } from "./js-top/components/JsTopModal";
+export type { JsTopModalProps, JsTopRemoteActions, } from "./js-top/components/JsTopModal";
+export { JsTopHudOverlay } from "./js-top/components/JsTopHudOverlay";
+export { jsTopPreset, jsTopModalPreset, JS_TOP_ENABLED_COLOR, JS_TOP_DISABLED_COLOR, } from "./preset";
+export type { JsTopSnapshot, JsTopRow, JsTopLongtask, JsTopOriginDetail, JsTopTiers, JsTopStatus, TaskApi, } from "./js-top/types";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkCH,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,aAAa,EACb,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,OAAO,GACR,MAAM,gBAAgB,CAAC"}

package/lib/typescript/js-top/components/BusySparkline.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Busy% history sparkline — plain View bars (no SVG dependency), tinted by
+ * severity. Renders at most the trailing 60 buckets (15s).
+ */
+export declare const BusySparkline: import("react").NamedExoticComponent<{
+    history: number[];
+}>;
+//# sourceMappingURL=BusySparkline.d.ts.map

package/lib/typescript/js-top/components/BusySparkline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusySparkline.d.ts","sourceRoot":"","sources":["../../../../src/js-top/components/BusySparkline.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,eAAO,MAAM,aAAa;aAGf,MAAM,EAAE;EAsBjB,CAAC"}

package/lib/typescript/js-top/components/JsTopHudOverlay.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Minimal floating HUD pill: busy% + the current top offender. Rendered by
+ * FloatingDevTools (guarded require) when the JS TOP toggle chip is on —
+ * same auto-mount pattern as the perf-monitor overlay. Display-only in v1
+ * (no drag; sits under the status bar on the left).
+ */
+export declare function JsTopHudOverlay(): import("react").JSX.Element | null;
+//# sourceMappingURL=JsTopHudOverlay.d.ts.map

package/lib/typescript/js-top/components/JsTopHudOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsTopHudOverlay.d.ts","sourceRoot":"","sources":["../../../../src/js-top/components/JsTopHudOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,wBAAgB,eAAe,uCA8B9B"}

package/lib/typescript/js-top/components/JsTopModal.d.ts

@@ -0,0 +1,39 @@
+/**
+ * JS TOP modal — the Task Manager window.
+ *
+ * Layout: header (busy% pill + pause/clear controls) → busy sparkline →
+ * coverage banner (when bridge tier is unavailable) → ranked task table →
+ * blocking-task list.
+ *
+ * Data source is the local JsTopController by default. The desktop
+ * dashboard mounts this same component via react-native-web and injects the
+ * synced device snapshot + remote actions through `remoteSnapshot` /
+ * `remoteActions` — the modal never samples the Electron renderer.
+ */
+import { type ModalState } from "@buoy-gg/shared-ui";
+import type { JsTopSnapshot } from "../types";
+export interface JsTopRemoteActions {
+    pause: () => void;
+    resume: () => void;
+    clear: () => void;
+}
+export interface JsTopModalProps {
+    visible: boolean;
+    onClose: () => void;
+    /** App-stack back (from the floating menu's AppHost). */
+    onBack?: () => void;
+    onMinimize?: (modalState: ModalState) => void;
+    initialModalState?: ModalState;
+    minimizeTargetPosition?: {
+        x: number;
+        y: number;
+    };
+    enableSharedModalDimensions?: boolean;
+    /** Desktop dashboard: render from a synced device snapshot. */
+    remoteSnapshot?: JsTopSnapshot | null;
+    remoteActions?: JsTopRemoteActions;
+    /** Desktop Workbench: render inline, parent supplies window chrome. */
+    embedded?: boolean;
+}
+export declare function JsTopModal({ visible, onClose, onBack, onMinimize, initialModalState, minimizeTargetPosition, remoteSnapshot, remoteActions, embedded, }: JsTopModalProps): import("react").JSX.Element;
+//# sourceMappingURL=JsTopModal.d.ts.map

package/lib/typescript/js-top/components/JsTopModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsTopModal.d.ts","sourceRoot":"","sources":["../../../../src/js-top/components/JsTopModal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,EAQL,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAO9C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,sBAAsB,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA2DD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,QAAgB,GACjB,EAAE,eAAe,+BA+LjB"}

package/lib/typescript/js-top/components/TaskDetailView.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TaskDetailView — the "inspect process" screen behind a row tap.
+ *
+ * Shows everything the engine knows about one origin: a 5s activity bar
+ * chart (the per-origin bucket ring, rendered nowhere else), the full stat
+ * grid (schedules vs runs, avg/max/total, freezes), the captured scheduling
+ * site (caller + raw frames), and a plain-language explanation of what this
+ * origin type means. Data refreshes with the modal's snapshot tick — the
+ * parent re-renders us and we re-pull the detail.
+ */
+import type { JsTopOriginDetail } from "../types";
+export declare const TaskDetailView: import("react").NamedExoticComponent<{
+    detail: JsTopOriginDetail;
+}>;
+//# sourceMappingURL=TaskDetailView.d.ts.map

package/lib/typescript/js-top/components/TaskDetailView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskDetailView.d.ts","sourceRoot":"","sources":["../../../../src/js-top/components/TaskDetailView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAW,MAAM,UAAU,CAAC;AAoD3D,eAAO,MAAM,cAAc;YAGjB,iBAAiB;EA2IzB,CAAC"}

package/lib/typescript/js-top/components/TaskTable.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The ranked task table — the "process list".
+ *
+ * Row layout (phone-first): the API is a small colored badge and the FULL
+ * width goes to the task name (the part that varies); numbers live on a
+ * second stats line instead of fixed-width columns, so nothing truncates:
+ *
+ *   1  [INTERVAL] hotIntervalWork              1240 ms  41%
+ *      ▓▓▓▓▓░░░░░  50 calls · avg 24.8 · max 31.0 · total 1.2k
+ *
+ * Sorting is a chip row above the list (column headers don't survive on a
+ * narrow screen). Rows keyed by origin key (never index: rows re-rank every
+ * tick) and memoized with a precise comparator so a tick only re-renders
+ * rows whose numbers moved.
+ */
+import type { JsTopRow, TaskApi } from "../types";
+export type SortKey = "windowMs" | "calls" | "avgMs" | "maxMs" | "totalMs";
+export declare const API_BADGE: Record<string, {
+    text: string;
+    color: string;
+    prefix?: string;
+}>;
+export declare function badgeFor(api: TaskApi): {
+    text: string;
+    color: string;
+    prefix?: string;
+};
+/** The row label minus its API prefix — the badge already says the API. */
+export declare function displayName(row: {
+    api: TaskApi;
+    label: string;
+}): string;
+export declare function TaskTable({ rows, onSelectRow, }: {
+    rows: JsTopRow[];
+    /** Tap-through to the origin detail view. Rows are static when absent. */
+    onSelectRow?: (row: JsTopRow) => void;
+}): import("react").JSX.Element;
+//# sourceMappingURL=TaskTable.d.ts.map

package/lib/typescript/js-top/components/TaskTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskTable.d.ts","sourceRoot":"","sources":["../../../../src/js-top/components/TaskTable.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAU3E,eAAO,MAAM,SAAS,EAAE,MAAM,CAC5B,MAAM,EACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAWjD,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO;UAb3B,MAAM;WAAS,MAAM;aAAW,MAAM;EAe/C;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQxE;AAgHD,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,WAAW,GACZ,EAAE;IACD,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CACvC,+BAyCA"}

package/lib/typescript/js-top/engine/JsTopController.d.ts

@@ -0,0 +1,78 @@
+/**
+ * JsTopController — singleton orchestrating the task-accounting engine.
+ *
+ * Lifecycle mirrors PerfMonitorController: the engine runs only while
+ * someone is looking (snapshot subscribers — the HUD/modal — or a desktop
+ * dashboard's silent remote sampling). Patches install once on first start
+ * and stay installed; stopping just clears the `active` gate and the probe,
+ * so a closed tool costs one boolean per schedule and nothing else.
+ */
+import { type JsTopOriginDetail, type JsTopSnapshot, type JsTopStatus, type JsTopTiers } from "../types";
+type SnapshotSubscriber = (snapshot: JsTopSnapshot) => void;
+type EnabledSubscriber = (enabled: boolean) => void;
+type FreezeStatsFn = (now: number) => {
+    count: number;
+    worstMs: number;
+    byOrigin: Record<string, {
+        count: number;
+        maxMs: number;
+    }>;
+};
+declare class JsTopControllerImpl {
+    private enabled;
+    private enabledLoaded;
+    private paused;
+    private remoteSampling;
+    private engineRunning;
+    private tiers;
+    private notifyHandle;
+    private appStateSub;
+    private snapshot;
+    private subscribers;
+    private enabledSubscribers;
+    /** Phase-2 seam: extra tier installers (promises/bridge/longtasks) register
+     * here so the controller stays ignorant of their internals. */
+    private tierInstallers;
+    private longtaskProvider;
+    private freezeStatsProvider;
+    private clearHooks;
+    constructor();
+    subscribe(fn: SnapshotSubscriber): () => void;
+    subscribeEnabled(fn: EnabledSubscriber): () => void;
+    /** HUD visibility toggle (persisted). Not required for the engine to run —
+     * the modal or a desktop watcher subscribing is what starts sampling. */
+    setEnabled(on: boolean): void;
+    isEnabled(): boolean;
+    /** Silent sampling for a desktop viewer — engine runs, device HUD stays
+     * hidden (same contract as perf-monitor's setRemoteSampling). */
+    setRemoteSampling(on: boolean): void;
+    isRemoteSampling(): boolean;
+    getStatus(): JsTopStatus;
+    pause(): void;
+    resume(): void;
+    clear(): void;
+    registerClearHook(fn: () => void): void;
+    getSnapshot(): JsTopSnapshot;
+    /**
+     * Full detail for one origin (tap-through view). Returns null when the
+     * origin was evicted or never existed. The pinned "unattributed" row gets
+     * a synthetic detail built from the probe residuals.
+     */
+    getOriginDetail(key: string): JsTopOriginDetail | null;
+    /** Phase-2 registration seam for additional patch tiers. */
+    registerTierInstaller(install: () => Partial<JsTopTiers>): void;
+    registerLongtaskProvider(fn: () => JsTopSnapshot["longtasks"]): void;
+    registerFreezeStatsProvider(fn: FreezeStatsFn): void;
+    private shouldRun;
+    private syncEngineState;
+    private runInstaller;
+    private startEngine;
+    private stopEngine;
+    private buildSnapshot;
+    private emitSnapshot;
+    /** Engine active state, for diagnostics/tests. */
+    isEngineActive(): boolean;
+}
+export declare const JsTopController: JsTopControllerImpl;
+export type { JsTopControllerImpl };
+//# sourceMappingURL=JsTopController.d.ts.map