@flotrace/runtime 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

@@ -21,6 +21,34 @@ Source code never leaves your machine. The runtime sends only metadata over `ws:
 
 ---
 
+## About FloTrace Desktop
+
+[**FloTrace Desktop**](https://flotrace.dev) is a free Electron app (macOS / Windows / Linux) that visualizes your React app's component hierarchy in real time. This runtime package is the bridge: drop `<FloTraceProvider>` into your app and the desktop renders the live tree, with full inspection of props, hooks, effects, state, network calls, and render cascades.
+
+When `@flotrace/runtime` (this package) is paired with the desktop, you get:
+
+- **Live component tree** — React Flow graph, render-flash animation, frequency-based heatmap, breadcrumb bar, search-with-fitView.
+- **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, pin-to-watch.
+- **React 19 + Next.js** — Actions monitor, concurrent-update signals (useTransition / Suspense), compiler memo health, Next.js App Router detection, RSC payload interception.
+- **Watch expressions** — pin values from 8 sources (Zustand / Redux / Router / Context / Props / Hooks / TanStack Query / API), max 20.
+- **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  ←→  ws://localhost:3457  ←→  FloTrace Desktop
+                       (this package — open source, MIT)         (closed-source commercial)
+```
+
+The desktop is free and binds to `127.0.0.1` only by default — your source code, props, and state never leave your machine.
+
+---
+
 ## 30-second setup
 
 ```bash
@@ -161,7 +189,7 @@ function MyComponent(props: MyProps) {
 
 - Source code never leaves your machine. The runtime sends only metadata (component names, prop types, render counts) over `ws://localhost:3457`.
 - Desktop app binds to `127.0.0.1` only. LAN connections (physical devices) require an opt-in auth token.
-- The desktop is closed-source commercial; this runtime package is **MIT-licensed** and open at [github.com/flotrace](https://github.com/flotrace).
+- The desktop is closed-source commercial; this runtime package is **MIT-licensed** and open at [github.com/sameersitre/runtime](https://github.com/sameersitre/runtime).
 
 ---
 
@@ -196,4 +224,8 @@ Type exports: `FloTraceConfig`, `LiveTreeNode`, `SerializedValue`, `HookInfo`, `
 
 ## License
 
-MIT. Issues and PRs welcome at [github.com/flotrace](https://github.com/flotrace).
+MIT — see [LICENSE](./LICENSE). Issues and PRs welcome at [github.com/sameersitre/runtime](https://github.com/sameersitre/runtime).
+
+---
+
+> **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

@@ -50,7 +50,7 @@ var import_runtime_core3 = require("@flotrace/runtime-core");
 // package.json
 var package_default = {
   name: "@flotrace/runtime",
-  version: "2.2.2",
+  version: "2.2.3",
   description: "Runtime package for FloTrace - enables real-time render tracking in your React app",
   main: "./dist/index.js",
   module: "./dist/index.mjs",
@@ -63,7 +63,9 @@ var package_default = {
     }
   },
   files: [
-    "dist"
+    "dist",
+    "LICENSE",
+    "README.md"
   ],
   scripts: {
     build: "tsup",
@@ -76,7 +78,7 @@ var package_default = {
     "release:major": "npm version major && npm publish"
   },
   dependencies: {
-    "@flotrace/runtime-core": "2.2.2"
+    "@flotrace/runtime-core": "2.2.3"
   },
   peerDependencies: {
     react: ">=16.9.0",
@@ -100,10 +102,13 @@ var package_default = {
     "flotrace"
   ],
   license: "MIT",
+  homepage: "https://flotrace.dev",
   repository: {
     type: "git",
-    url: "https://github.com/flotrace/flotrace.git",
-    directory: "packages/runtime"
+    url: "https://github.com/sameersitre/runtime.git"
+  },
+  bugs: {
+    url: "https://github.com/sameersitre/runtime/issues"
   },
   publishConfig: {
     access: "public"
@@ -287,6 +292,7 @@ var requestCounter = 0;
 var requestIndexMap = /* @__PURE__ */ new Map();
 var earlyRequestIndexMap = /* @__PURE__ */ new Map();
 var previousFetch = null;
+var trackedFetchRef = null;
 var originalXhrOpen = null;
 var originalXhrSend = null;
 var originalResponseJson = null;
@@ -328,8 +334,11 @@ function installNetworkTracker(wsClient) {
 function uninstallNetworkTracker() {
   if (!isInstalled2 && !isPrewarmed) return;
   if (previousFetch) {
-    globalThis.fetch = previousFetch;
+    if (globalThis.fetch === trackedFetchRef) {
+      globalThis.fetch = previousFetch;
+    }
     previousFetch = null;
+    trackedFetchRef = null;
   }
   if (originalXhrOpen) {
     XMLHttpRequest.prototype.open = originalXhrOpen;
@@ -367,10 +376,14 @@ function uninstallNetworkTracker() {
 function patchFetch() {
   if (typeof globalThis.fetch !== "function") return;
   previousFetch = globalThis.fetch;
-  globalThis.fetch = async function trackedFetch(input, init) {
+  const capturedPreviousFetch = previousFetch;
+  const trackedFetch = async function trackedFetch2(input, init) {
+    if (!isInstalled2 && !isPrewarmed) {
+      return capturedPreviousFetch.call(globalThis, input, init);
+    }
     const url = extractUrl(input);
     if (isNoiseUrl(url)) {
-      return previousFetch.call(globalThis, input, init);
+      return capturedPreviousFetch.call(globalThis, input, init);
     }
     const method = (init?.method ?? "GET").toUpperCase();
     const parsedUrl = parseUrl(url);
@@ -385,7 +398,7 @@ function patchFetch() {
     }
     pushEntry({ ...entry });
     try {
-      const response = await previousFetch.call(globalThis, input, init);
+      const response = await capturedPreviousFetch.call(globalThis, input, init);
       if (entry.state !== "aborted") {
         entry.state = response.ok ? "success" : "error";
         entry.status = response.status;
@@ -408,6 +421,8 @@ function patchFetch() {
       throw err;
     }
   };
+  trackedFetchRef = trackedFetch;
+  globalThis.fetch = trackedFetch;
 }
 function patchXhr() {
   if (typeof XMLHttpRequest === "undefined") return;

package/dist/index.mjs

@@ -33,7 +33,7 @@ import {
 // package.json
 var package_default = {
   name: "@flotrace/runtime",
-  version: "2.2.2",
+  version: "2.2.3",
   description: "Runtime package for FloTrace - enables real-time render tracking in your React app",
   main: "./dist/index.js",
   module: "./dist/index.mjs",
@@ -46,7 +46,9 @@ var package_default = {
     }
   },
   files: [
-    "dist"
+    "dist",
+    "LICENSE",
+    "README.md"
   ],
   scripts: {
     build: "tsup",
@@ -59,7 +61,7 @@ var package_default = {
     "release:major": "npm version major && npm publish"
   },
   dependencies: {
-    "@flotrace/runtime-core": "2.2.2"
+    "@flotrace/runtime-core": "2.2.3"
   },
   peerDependencies: {
     react: ">=16.9.0",
@@ -83,10 +85,13 @@ var package_default = {
     "flotrace"
   ],
   license: "MIT",
+  homepage: "https://flotrace.dev",
   repository: {
     type: "git",
-    url: "https://github.com/flotrace/flotrace.git",
-    directory: "packages/runtime"
+    url: "https://github.com/sameersitre/runtime.git"
+  },
+  bugs: {
+    url: "https://github.com/sameersitre/runtime/issues"
   },
   publishConfig: {
     access: "public"
@@ -276,6 +281,7 @@ var requestCounter = 0;
 var requestIndexMap = /* @__PURE__ */ new Map();
 var earlyRequestIndexMap = /* @__PURE__ */ new Map();
 var previousFetch = null;
+var trackedFetchRef = null;
 var originalXhrOpen = null;
 var originalXhrSend = null;
 var originalResponseJson = null;
@@ -317,8 +323,11 @@ function installNetworkTracker(wsClient) {
 function uninstallNetworkTracker() {
   if (!isInstalled2 && !isPrewarmed) return;
   if (previousFetch) {
-    globalThis.fetch = previousFetch;
+    if (globalThis.fetch === trackedFetchRef) {
+      globalThis.fetch = previousFetch;
+    }
     previousFetch = null;
+    trackedFetchRef = null;
   }
   if (originalXhrOpen) {
     XMLHttpRequest.prototype.open = originalXhrOpen;
@@ -356,10 +365,14 @@ function uninstallNetworkTracker() {
 function patchFetch() {
   if (typeof globalThis.fetch !== "function") return;
   previousFetch = globalThis.fetch;
-  globalThis.fetch = async function trackedFetch(input, init) {
+  const capturedPreviousFetch = previousFetch;
+  const trackedFetch = async function trackedFetch2(input, init) {
+    if (!isInstalled2 && !isPrewarmed) {
+      return capturedPreviousFetch.call(globalThis, input, init);
+    }
     const url = extractUrl(input);
     if (isNoiseUrl(url)) {
-      return previousFetch.call(globalThis, input, init);
+      return capturedPreviousFetch.call(globalThis, input, init);
     }
     const method = (init?.method ?? "GET").toUpperCase();
     const parsedUrl = parseUrl(url);
@@ -374,7 +387,7 @@ function patchFetch() {
     }
     pushEntry({ ...entry });
     try {
-      const response = await previousFetch.call(globalThis, input, init);
+      const response = await capturedPreviousFetch.call(globalThis, input, init);
       if (entry.state !== "aborted") {
         entry.state = response.ok ? "success" : "error";
         entry.status = response.status;
@@ -397,6 +410,8 @@ function patchFetch() {
       throw err;
     }
   };
+  trackedFetchRef = trackedFetch;
+  globalThis.fetch = trackedFetch;
 }
 function patchXhr() {
   if (typeof XMLHttpRequest === "undefined") return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flotrace/runtime",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "Runtime package for FloTrace - enables real-time render tracking in your React app",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -13,7 +13,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE",
+    "README.md"
   ],
   "scripts": {
     "build": "tsup",
@@ -26,7 +28,7 @@
     "release:major": "npm version major && npm publish"
   },
   "dependencies": {
-    "@flotrace/runtime-core": "2.2.2"
+    "@flotrace/runtime-core": "2.2.3"
   },
   "peerDependencies": {
     "react": ">=16.9.0",
@@ -50,10 +52,13 @@
     "flotrace"
   ],
   "license": "MIT",
+  "homepage": "https://flotrace.dev",
   "repository": {
     "type": "git",
-    "url": "https://github.com/flotrace/flotrace.git",
-    "directory": "packages/runtime"
+    "url": "https://github.com/sameersitre/runtime.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sameersitre/runtime/issues"
   },
   "publishConfig": {
     "access": "public"