@flotrace/runtime-core 2.2.2 → 2.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sameer Sitre
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -11,6 +11,33 @@ Platform-agnostic core for [FloTrace](https://flotrace.dev) — fiber walker, ho
 
 `runtime-core` is published publicly so adapters can pin a compatible version and so users can audit the open-source half of FloTrace. It has zero runtime dependency on `window` / `document` / `XMLHttpRequest` — all platform-specific features live in the adapters.
 
+---
+
+## About FloTrace Desktop
+
+[**FloTrace Desktop**](https://flotrace.dev) is a free Electron app (macOS / Windows / Linux) that visualizes a running React app's component hierarchy in real time. It pairs with this runtime over a local WebSocket on port `3457` — the runtime sits inside your app and emits metadata; the desktop app renders the live tree, props, hooks, effects, and state. **Source code never leaves your machine.**
+
+What you get when this runtime is paired with the desktop:
+
+- **Live component tree** — React Flow graph, render-flash animation, frequency-based heatmap, breadcrumb navigation.
+- **Per-node inspection** — props (with diff history), hooks (14 classified types + dep diffs), effects (willRun + dep diffs), component timeline.
+- **State tracking** — Zustand (per-store), Redux (with change highlighting), Router, TanStack Query (with health warnings + wasted-refetch detection), Context.
+- **Render cascade tracing** — trigger log, cascade tree, flame chart, cascade compare modal.
+- **Prop drilling detection** — chain detection (≥3 levels deep), severity badges, heatmap overlay, refactor recommendations.
+- **Network health** — fetch / XHR tracking, method badges, status dots, duplicate detection, API → store causal correlation.
+- **Watch expressions** — pin values from 8 sources (Zustand / Redux / Router / Context / Props / Hooks / TanStack Query / API).
+- **AI Code Review Dashboard** — 6-tab review (Re-renders, Memo, Drilling, Effects, Compiler, Network) with Lighthouse-style scores.
+- **Copy-as-Prompt** — turn any panel into an AI-ready prompt for Cursor / Claude / ChatGPT in one click.
+
+How it fits together:
+
+```
+your React app  ←→  @flotrace/runtime[-native]  ←→  ws://localhost:3457  ←→  FloTrace Desktop
+                       (this stack — open source, MIT)         (closed-source commercial)
+```
+
+[**Download FloTrace Desktop →**](https://flotrace.dev) · [Docs](https://flotrace.dev/docs) · [Security model](https://flotrace.dev/security)
+
 ## What's inside
 
 | Module | Purpose |
@@ -38,8 +65,12 @@ The runtime is what lives inside your app. Open-source means you can read every
 
 ## Contributing
 
-Issues and PRs welcome at [github.com/flotrace](https://github.com/flotrace). The runtime packages target Hermes, V8 (Chromium), and JavaScriptCore — please test against all three when changing fiber-walker or serializer code.
+Issues and PRs welcome at [github.com/sameersitre/runtime-core](https://github.com/sameersitre/runtime-core). The runtime packages target Hermes, V8 (Chromium), and JavaScriptCore — please test against all three when changing fiber-walker or serializer code.
 
 ## License
 
-MIT.
+MIT — see [LICENSE](./LICENSE).
+
+---
+
+> **Mirrored from the [flotrace-desktop](https://github.com/sameersitre/flotrace-desktop) monorepo.** This repo is read-only — every release is regenerated by the lockstep publisher in the desktop monorepo. Issues filed here are tracked, but PRs are best opened against the upstream monorepo where the canonical source lives.

package/dist/index.js

@@ -1847,20 +1847,23 @@ function extractRoute(url) {
 var originalFetch = null;
 var interceptorClient = null;
 var isInstalled2 = false;
+var patchedFetchRef = null;
 function installRscPayloadInterceptor(client2) {
   if (isInstalled2 || typeof globalThis.fetch !== "function") return;
   isInstalled2 = true;
   interceptorClient = client2;
   originalFetch = globalThis.fetch;
-  globalThis.fetch = async function patchedFetch(input, init) {
+  const capturedOriginalFetch = originalFetch;
+  const capturedClient = client2;
+  const patchedFetch = async function patchedFetch2(input, init) {
     const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
     const isRscRequest = RSC_URL_PATTERNS.some((p) => p.test(url));
-    const response = await originalFetch.call(globalThis, input, init);
-    if (isRscRequest && interceptorClient?.connected) {
+    const response = await capturedOriginalFetch.call(globalThis, input, init);
+    if (isRscRequest && interceptorClient === capturedClient && capturedClient.connected) {
       try {
         const sizeHeader = response.headers.get("content-length");
         const payloadSizeBytes = sizeHeader ? parseInt(sizeHeader, 10) : 0;
-        interceptorClient.send({
+        capturedClient.send({
           type: "runtime:rscPayload",
           route: extractRoute(url),
           payloadSizeBytes: isNaN(payloadSizeBytes) ? 0 : payloadSizeBytes,
@@ -1872,11 +1875,16 @@ function installRscPayloadInterceptor(client2) {
     }
     return response;
   };
+  patchedFetchRef = patchedFetch;
+  globalThis.fetch = patchedFetch;
 }
 function uninstallRscPayloadInterceptor() {
   if (!isInstalled2 || !originalFetch) return;
-  globalThis.fetch = originalFetch;
+  if (globalThis.fetch === patchedFetchRef) {
+    globalThis.fetch = originalFetch;
+  }
   originalFetch = null;
+  patchedFetchRef = null;
   interceptorClient = null;
   isInstalled2 = false;
 }

package/dist/index.mjs

@@ -1765,20 +1765,23 @@ function extractRoute(url) {
 var originalFetch = null;
 var interceptorClient = null;
 var isInstalled2 = false;
+var patchedFetchRef = null;
 function installRscPayloadInterceptor(client2) {
   if (isInstalled2 || typeof globalThis.fetch !== "function") return;
   isInstalled2 = true;
   interceptorClient = client2;
   originalFetch = globalThis.fetch;
-  globalThis.fetch = async function patchedFetch(input, init) {
+  const capturedOriginalFetch = originalFetch;
+  const capturedClient = client2;
+  const patchedFetch = async function patchedFetch2(input, init) {
     const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
     const isRscRequest = RSC_URL_PATTERNS.some((p) => p.test(url));
-    const response = await originalFetch.call(globalThis, input, init);
-    if (isRscRequest && interceptorClient?.connected) {
+    const response = await capturedOriginalFetch.call(globalThis, input, init);
+    if (isRscRequest && interceptorClient === capturedClient && capturedClient.connected) {
       try {
         const sizeHeader = response.headers.get("content-length");
         const payloadSizeBytes = sizeHeader ? parseInt(sizeHeader, 10) : 0;
-        interceptorClient.send({
+        capturedClient.send({
           type: "runtime:rscPayload",
           route: extractRoute(url),
           payloadSizeBytes: isNaN(payloadSizeBytes) ? 0 : payloadSizeBytes,
@@ -1790,11 +1793,16 @@ function installRscPayloadInterceptor(client2) {
     }
     return response;
   };
+  patchedFetchRef = patchedFetch;
+  globalThis.fetch = patchedFetch;
 }
 function uninstallRscPayloadInterceptor() {
   if (!isInstalled2 || !originalFetch) return;
-  globalThis.fetch = originalFetch;
+  if (globalThis.fetch === patchedFetchRef) {
+    globalThis.fetch = originalFetch;
+  }
   originalFetch = null;
+  patchedFetchRef = null;
   interceptorClient = null;
   isInstalled2 = false;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flotrace/runtime-core",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "Platform-agnostic core for FloTrace runtime — fiber walker, analyzers, trackers. Shared by @flotrace/runtime (web) and @flotrace/runtime-native (React Native).",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -13,7 +13,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE",
+    "README.md"
   ],
   "scripts": {
     "build": "tsup",
@@ -46,10 +48,13 @@
     "flotrace"
   ],
   "license": "MIT",
+  "homepage": "https://flotrace.dev",
   "repository": {
     "type": "git",
-    "url": "https://github.com/flotrace/flotrace.git",
-    "directory": "packages/runtime-core"
+    "url": "https://github.com/sameersitre/runtime-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sameersitre/runtime-core/issues"
   },
   "publishConfig": {
     "access": "public"