react-dev-profiler 1.1.1 → 1.2.0

package/dist/index.js

@@ -29,6 +29,25 @@ function percentile(sorted, p) {
   return sorted[Math.max(0, idx)];
 }
 
+// src/constants.ts
+var COLOR_GREEN = "#4ade80";
+var COLOR_AMBER = "#f59e0b";
+var COLOR_RED = "#ef4444";
+var COLOR_MUTED = "#888";
+var COLOR_DIM = "#444";
+var COLOR_ACCENT = "#6366f1";
+var FPS_60_MS = 16.67;
+var FPS_30_MS = 33;
+var GRAPH_BG = "#111";
+var GRAPH_60FPS_LINE = "#1a3a1a";
+var GRAPH_30FPS_LINE = "#3a1a1a";
+var PANEL_GAP = 8;
+function ftColor(ms) {
+  if (ms > FPS_30_MS) return COLOR_RED;
+  if (ms > FPS_60_MS) return COLOR_AMBER;
+  return COLOR_GREEN;
+}
+
 // src/env.ts
 var __DEV__ = typeof process !== "undefined" ? process.env.NODE_ENV !== "production" : true;
 
@@ -75,7 +94,7 @@ var s = {
   },
   instanceBadge: {
     background: "#222",
-    color: "#888",
+    color: COLOR_MUTED,
     fontSize: 8,
     padding: "1px 5px",
     borderRadius: 4,
@@ -90,7 +109,7 @@ var s = {
   iconBtn: {
     background: "none",
     border: "none",
-    color: "#444",
+    color: COLOR_DIM,
     cursor: "pointer",
     padding: 4,
     margin: -4,
@@ -100,12 +119,12 @@ var s = {
     transition: "color 0.15s"
   },
   iconBtnActive: {
-    color: "#4ade80"
+    color: COLOR_GREEN
   },
   closeBtn: {
     background: "none",
     border: "none",
-    color: "#444",
+    color: COLOR_DIM,
     cursor: "pointer",
     fontSize: 13,
     padding: 4,
@@ -118,7 +137,7 @@ var s = {
     gap: 5
   },
   section: {
-    color: "#444",
+    color: COLOR_DIM,
     fontSize: 8,
     fontWeight: 600,
     letterSpacing: 1,
@@ -147,7 +166,7 @@ var s = {
   miniRow: {
     display: "flex",
     justifyContent: "space-between",
-    color: "#444",
+    color: COLOR_DIM,
     fontSize: 9,
     marginTop: -2,
     marginBottom: 2
@@ -200,9 +219,9 @@ var s = {
     textAlign: "center"
   }
 };
-var FLASH_OUTLINE = "2px solid rgba(99, 102, 241, 0.8)";
+var FLASH_OUTLINE = `2px solid ${COLOR_ACCENT}cc`;
 
-// src/hooks.ts
+// src/utils.ts
 function getEffectiveRect(el) {
   const rect = el.getBoundingClientRect();
   if (rect.width > 0 || rect.height > 0) return rect;
@@ -229,6 +248,8 @@ function getObservableChildren(el) {
   }
   return result;
 }
+
+// src/hooks.ts
 function useAnchorPosition(ref, position = "bottom-left") {
   const [pos, setPos] = useState({ top: 0, left: 0 });
   useEffect(() => {
@@ -374,22 +395,24 @@ function useLongTasks(enabled) {
 // src/DevStatsPanel.tsx
 import { useState as useState2, useEffect as useEffect2, useCallback as useCallback2, useRef as useRef2 } from "react";
 import { createPortal } from "react-dom";
+
+// src/FrameTimeGraph.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 function FrameTimeGraph({ history }) {
-  const max = Math.max(33, ...history);
+  const max = Math.max(FPS_30_MS, ...history);
   const w = 140;
   const h = 32;
   const barW = Math.max(1, w / HISTORY_SIZE - 0.5);
   return /* @__PURE__ */ jsx("div", { style: s.graphWrap, children: /* @__PURE__ */ jsxs("svg", { width: w, height: h, style: { display: "block" }, children: [
-    /* @__PURE__ */ jsx("rect", { width: w, height: h, rx: 3, fill: "#111" }),
+    /* @__PURE__ */ jsx("rect", { width: w, height: h, rx: 3, fill: GRAPH_BG }),
     /* @__PURE__ */ jsx(
       "line",
       {
         x1: 0,
-        y1: h - 16.67 / max * h,
+        y1: h - FPS_60_MS / max * h,
         x2: w,
-        y2: h - 16.67 / max * h,
-        stroke: "#1a3a1a",
+        y2: h - FPS_60_MS / max * h,
+        stroke: GRAPH_60FPS_LINE,
         strokeWidth: 1
       }
     ),
@@ -397,31 +420,36 @@ function FrameTimeGraph({ history }) {
       "line",
       {
         x1: 0,
-        y1: h - 33 / max * h,
+        y1: h - FPS_30_MS / max * h,
         x2: w,
-        y2: h - 33 / max * h,
-        stroke: "#3a1a1a",
+        y2: h - FPS_30_MS / max * h,
+        stroke: GRAPH_30FPS_LINE,
         strokeWidth: 1
       }
     ),
     history.map((ms, i) => {
       const x = i / HISTORY_SIZE * w;
       const barH = Math.min(ms / max * h, h);
-      const color = ms > 33 ? "#ef4444" : ms > 16.67 ? "#f59e0b" : "#4ade80";
-      return /* @__PURE__ */ jsx("rect", { x, y: h - barH, width: barW, height: barH, fill: color, opacity: 0.8, rx: 0.5 }, i);
+      return /* @__PURE__ */ jsx("rect", { x, y: h - barH, width: barW, height: barH, fill: ftColor(ms), opacity: 0.8, rx: 0.5 }, i);
     })
   ] }) });
 }
-function StatRow({ label, value, sub, color = "#4ade80" }) {
-  return /* @__PURE__ */ jsxs("div", { style: s.row, children: [
-    /* @__PURE__ */ jsx("span", { style: s.rowLabel, children: label }),
-    /* @__PURE__ */ jsxs("span", { children: [
-      /* @__PURE__ */ jsx("span", { style: { ...s.rowValue, color }, children: value }),
-      sub && /* @__PURE__ */ jsx("span", { style: { color: "#444", fontSize: 9, marginLeft: 4 }, children: sub })
+
+// src/StatRow.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function StatRow({ label, value, sub, color = COLOR_GREEN }) {
+  return /* @__PURE__ */ jsxs2("div", { style: s.row, children: [
+    /* @__PURE__ */ jsx2("span", { style: s.rowLabel, children: label }),
+    /* @__PURE__ */ jsxs2("span", { children: [
+      /* @__PURE__ */ jsx2("span", { style: { ...s.rowValue, color }, children: value }),
+      sub && /* @__PURE__ */ jsx2("span", { style: { color: COLOR_DIM, fontSize: 9, marginLeft: 4 }, children: sub })
     ] })
   ] });
 }
-var GAP = 8;
+
+// src/DevStatsPanel.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var GAP = PANEL_GAP;
 function getPanelStyle(pos, offset, position) {
   const style = {
     ...s.panel,
@@ -525,71 +553,71 @@ function DevStatsPanel({
     setExported(true);
     setTimeout(() => setExported(false), 1200);
   }, [stats]);
-  const ftColor = stats.frameTime > 33 ? "#ef4444" : stats.frameTime > 16.67 ? "#f59e0b" : "#4ade80";
-  const rpsColor = stats.rendersPerSecond > 30 ? "#ef4444" : stats.rendersPerSecond > 10 ? "#f59e0b" : "#4ade80";
-  const actualColor = stats.profiler.actualDuration > 16 ? "#ef4444" : stats.profiler.actualDuration > 8 ? "#f59e0b" : "#4ade80";
+  const frameTColor = ftColor(stats.frameTime);
+  const rpsColor = stats.rendersPerSecond > 30 ? COLOR_RED : stats.rendersPerSecond > 10 ? COLOR_AMBER : COLOR_GREEN;
+  const actualColor = stats.profiler.actualDuration > 16 ? COLOR_RED : stats.profiler.actualDuration > 8 ? COLOR_AMBER : COLOR_GREEN;
   const fps = stats.frameTime > 0 ? Math.round(1e3 / stats.frameTime) : 0;
   const memoGain = stats.profiler.baseDuration > 0 ? Math.round((1 - stats.profiler.actualDuration / stats.profiler.baseDuration) * 100) : 0;
-  const p99Color = stats.frameTimeP99 > 33 ? "#ef4444" : stats.frameTimeP99 > 16.67 ? "#f59e0b" : "#4ade80";
+  const p99Color = ftColor(stats.frameTimeP99);
   const exportStyle = exported ? { ...s.iconBtn, ...s.iconBtnActive } : s.iconBtn;
   return createPortal(
-    /* @__PURE__ */ jsxs("div", { style: getPanelStyle(pos, offset, position), ...dragHandlers, children: [
-      /* @__PURE__ */ jsxs("div", { style: s.panelHeader, children: [
-        /* @__PURE__ */ jsxs("span", { style: s.panelTitle, children: [
+    /* @__PURE__ */ jsxs3("div", { style: getPanelStyle(pos, offset, position), ...dragHandlers, children: [
+      /* @__PURE__ */ jsxs3("div", { style: s.panelHeader, children: [
+        /* @__PURE__ */ jsxs3("span", { style: s.panelTitle, children: [
           "Dev Profiler",
-          instanceCount > 1 && instanceId && /* @__PURE__ */ jsx("span", { style: s.instanceBadge, children: instanceId })
+          instanceCount > 1 && instanceId && /* @__PURE__ */ jsx3("span", { style: s.instanceBadge, children: instanceId })
         ] }),
-        /* @__PURE__ */ jsxs("div", { style: s.headerActions, children: [
-          /* @__PURE__ */ jsx(
+        /* @__PURE__ */ jsxs3("div", { style: s.headerActions, children: [
+          /* @__PURE__ */ jsx3(
             "button",
             {
               style: exportStyle,
               onClick: handleExport,
               title: exported ? "Exported!" : "Export stats as JSON",
-              children: exported ? /* @__PURE__ */ jsx("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx("polyline", { points: "3.5 8.5 6.5 11.5 12.5 4.5" }) }) : /* @__PURE__ */ jsx("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx("path", { d: "M8 2v8M4 7l4 4 4-4M2 14h12" }) })
+              children: exported ? /* @__PURE__ */ jsx3("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx3("polyline", { points: "3.5 8.5 6.5 11.5 12.5 4.5" }) }) : /* @__PURE__ */ jsx3("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx3("path", { d: "M8 2v8M4 7l4 4 4-4M2 14h12" }) })
             }
           ),
-          /* @__PURE__ */ jsx("button", { style: s.iconBtn, onClick: handleReset, title: "Reset counters", children: /* @__PURE__ */ jsx("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "currentColor", children: /* @__PURE__ */ jsx("path", { d: "M14 1a1 1 0 0 1 1 1v4a1 1 0 0 1-1 1h-4a1 1 0 0 1 0-2h1.6A6 6 0 0 0 2.07 7.5a1 1 0 1 1-1.97-.36A8 8 0 0 1 13 3.35V2a1 1 0 0 1 1-1zM2 15a1 1 0 0 1-1-1v-4a1 1 0 0 1 1-1h4a1 1 0 0 1 0 2H4.4A6 6 0 0 0 13.93 8.5a1 1 0 1 1 1.97.36A8 8 0 0 1 3 12.65V14a1 1 0 0 1-1 1z" }) }) }),
-          /* @__PURE__ */ jsx("button", { style: s.closeBtn, onClick: onClose, children: "\u2715" })
+          /* @__PURE__ */ jsx3("button", { style: s.iconBtn, onClick: handleReset, title: "Reset counters", children: /* @__PURE__ */ jsx3("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "currentColor", children: /* @__PURE__ */ jsx3("path", { d: "M14 1a1 1 0 0 1 1 1v4a1 1 0 0 1-1 1h-4a1 1 0 0 1 0-2h1.6A6 6 0 0 0 2.07 7.5a1 1 0 1 1-1.97-.36A8 8 0 0 1 13 3.35V2a1 1 0 0 1 1-1zM2 15a1 1 0 0 1-1-1v-4a1 1 0 0 1 1-1h4a1 1 0 0 1 0 2H4.4A6 6 0 0 0 13.93 8.5a1 1 0 1 1 1.97.36A8 8 0 0 1 3 12.65V14a1 1 0 0 1-1 1z" }) }) }),
+          /* @__PURE__ */ jsx3("button", { style: s.closeBtn, onClick: onClose, children: "\u2715" })
         ] })
       ] }),
-      /* @__PURE__ */ jsxs("div", { style: s.body, children: [
-        /* @__PURE__ */ jsx("span", { style: s.section, children: "Rendering" }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Frame time", value: `${stats.frameTime.toFixed(1)}ms`, sub: `${fps} fps`, color: ftColor }),
-        /* @__PURE__ */ jsx(FrameTimeGraph, { history: stats.frameTimeHistory }),
-        /* @__PURE__ */ jsxs("div", { style: s.miniRow, children: [
-          /* @__PURE__ */ jsxs("span", { children: [
+      /* @__PURE__ */ jsxs3("div", { style: s.body, children: [
+        /* @__PURE__ */ jsx3("span", { style: s.section, children: "Rendering" }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Frame time", value: `${stats.frameTime.toFixed(1)}ms`, sub: `${fps} fps`, color: frameTColor }),
+        /* @__PURE__ */ jsx3(FrameTimeGraph, { history: stats.frameTimeHistory }),
+        /* @__PURE__ */ jsxs3("div", { style: s.miniRow, children: [
+          /* @__PURE__ */ jsxs3("span", { children: [
             "min ",
             stats.frameTimeMin.toFixed(1)
           ] }),
-          /* @__PURE__ */ jsxs("span", { children: [
+          /* @__PURE__ */ jsxs3("span", { children: [
             "max ",
             stats.frameTimeMax.toFixed(1)
           ] }),
-          /* @__PURE__ */ jsxs("span", { style: { color: p99Color }, children: [
+          /* @__PURE__ */ jsxs3("span", { style: { color: p99Color }, children: [
             "p99 ",
             stats.frameTimeP99.toFixed(1)
           ] })
         ] }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Renders/s", value: String(stats.rendersPerSecond), color: rpsColor }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Long tasks", value: String(stats.longTasks), color: stats.longTasks > 0 ? "#f59e0b" : "#4ade80" }),
-        /* @__PURE__ */ jsx("div", { style: s.separator }),
-        /* @__PURE__ */ jsx("span", { style: s.section, children: "React Profiler" }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Phase", value: stats.profiler.phase, color: "#888" }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Render", value: `${stats.profiler.actualDuration.toFixed(2)}ms`, color: actualColor }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Base (no memo)", value: `${stats.profiler.baseDuration.toFixed(2)}ms`, color: "#888" }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Memo gain", value: `${memoGain}%`, color: memoGain > 50 ? "#4ade80" : memoGain > 20 ? "#f59e0b" : "#ef4444" }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Commits", value: String(stats.profiler.commitCount) }),
-        /* @__PURE__ */ jsx("div", { style: s.separator }),
-        /* @__PURE__ */ jsx("span", { style: s.section, children: "DOM" }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Nodes", value: stats.domNodes.toLocaleString() }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Mutations", value: String(stats.domMutations) }),
-        /* @__PURE__ */ jsx(StatRow, { label: "Size", value: stats.dimensions, color: "#888" }),
-        /* @__PURE__ */ jsx("div", { style: s.separator }),
-        /* @__PURE__ */ jsx("span", { style: s.section, children: "Memory" }),
-        /* @__PURE__ */ jsx(StatRow, { label: "JS Heap", value: stats.memory > 0 ? `${stats.memory} MB` : "N/A" })
+        /* @__PURE__ */ jsx3(StatRow, { label: "Renders/s", value: String(stats.rendersPerSecond), color: rpsColor }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Long tasks", value: String(stats.longTasks), color: stats.longTasks > 0 ? COLOR_AMBER : COLOR_GREEN }),
+        /* @__PURE__ */ jsx3("div", { style: s.separator }),
+        /* @__PURE__ */ jsx3("span", { style: s.section, children: "React Profiler" }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Phase", value: stats.profiler.phase, color: COLOR_MUTED }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Render", value: `${stats.profiler.actualDuration.toFixed(2)}ms`, color: actualColor }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Base (no memo)", value: `${stats.profiler.baseDuration.toFixed(2)}ms`, color: COLOR_MUTED }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Memo gain", value: `${memoGain}%`, color: memoGain > 50 ? COLOR_GREEN : memoGain > 20 ? COLOR_AMBER : COLOR_RED }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Commits", value: String(stats.profiler.commitCount) }),
+        /* @__PURE__ */ jsx3("div", { style: s.separator }),
+        /* @__PURE__ */ jsx3("span", { style: s.section, children: "DOM" }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Nodes", value: stats.domNodes.toLocaleString() }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Mutations", value: String(stats.domMutations) }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "Size", value: stats.dimensions, color: COLOR_MUTED }),
+        /* @__PURE__ */ jsx3("div", { style: s.separator }),
+        /* @__PURE__ */ jsx3("span", { style: s.section, children: "Memory" }),
+        /* @__PURE__ */ jsx3(StatRow, { label: "JS Heap", value: stats.memory > 0 ? `${stats.memory} MB` : "N/A" })
       ] }),
-      /* @__PURE__ */ jsx("div", { style: s.footer, children: "Ctrl+I to toggle" })
+      /* @__PURE__ */ jsx3("div", { style: s.footer, children: "Ctrl+I to toggle" })
     ] }),
     document.body
   );
@@ -598,8 +626,8 @@ function DevStatsPanel({
 // src/ToggleButton.tsx
 import { useState as useState3, useEffect as useEffect3 } from "react";
 import { createPortal as createPortal2 } from "react-dom";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-var GAP2 = 8;
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+var GAP2 = PANEL_GAP;
 function getButtonStyle(pos, position) {
   const style = { ...s.toggleBtn };
   if (position.startsWith("bottom")) {
@@ -618,7 +646,7 @@ function ToggleButton({
   targetRef,
   onClick,
   position = "bottom-left",
-  accentColor = "#6366f1"
+  accentColor = COLOR_ACCENT
 }) {
   const pos = useAnchorPosition(targetRef, position);
   const [fps, setFps] = useState3(0);
@@ -640,16 +668,16 @@ function ToggleButton({
     return () => cancelAnimationFrame(animId);
   }, []);
   return createPortal2(
-    /* @__PURE__ */ jsxs2(
+    /* @__PURE__ */ jsxs4(
       "button",
       {
         onClick,
         title: "Dev Profiler (Ctrl+I)",
         style: getButtonStyle(pos, position),
         children: [
-          /* @__PURE__ */ jsx2("span", { style: { ...s.toggleDot, background: accentColor, boxShadow: `0 0 4px ${accentColor}` } }),
-          /* @__PURE__ */ jsx2("span", { style: s.toggleFps, children: fps }),
-          /* @__PURE__ */ jsx2("span", { style: s.toggleLabel, children: "fps" })
+          /* @__PURE__ */ jsx4("span", { style: { ...s.toggleDot, background: accentColor, boxShadow: `0 0 4px ${accentColor}` } }),
+          /* @__PURE__ */ jsx4("span", { style: s.toggleFps, children: fps }),
+          /* @__PURE__ */ jsx4("span", { style: s.toggleLabel, children: "fps" })
         ]
       }
     ),
@@ -658,7 +686,7 @@ function ToggleButton({
 }
 
 // src/DevProfiler.tsx
-import { Fragment, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 var TOGGLE_EVENT = "devprofiler:toggle";
 var BOUND_KEY = "__devprofiler_bound";
 if (typeof window !== "undefined" && __DEV__ && !window[BOUND_KEY]) {
@@ -676,7 +704,7 @@ function DevProfiler({
   children,
   position = "bottom-left",
   id,
-  accentColor = "#6366f1"
+  accentColor = COLOR_ACCENT
 }) {
   const wrapperRef = useRef3(null);
   const [open, setOpen] = useState4(false);
@@ -713,11 +741,11 @@ function DevProfiler({
     window.addEventListener(TOGGLE_EVENT, handler);
     return () => window.removeEventListener(TOGGLE_EVENT, handler);
   }, []);
-  if (!__DEV__) return /* @__PURE__ */ jsx3(Fragment, { children });
-  return /* @__PURE__ */ jsxs3("div", { ref: wrapperRef, style: { display: "contents" }, children: [
-    /* @__PURE__ */ jsx3(Profiler, { id: "DevProfiler", onRender, children }),
-    !open && /* @__PURE__ */ jsx3(ToggleButton, { targetRef: wrapperRef, onClick: toggle, position, accentColor }),
-    open && /* @__PURE__ */ jsx3(
+  if (!__DEV__) return /* @__PURE__ */ jsx5(Fragment, { children });
+  return /* @__PURE__ */ jsxs5("div", { ref: wrapperRef, style: { display: "contents" }, children: [
+    /* @__PURE__ */ jsx5(Profiler, { id: "DevProfiler", onRender, children }),
+    !open && /* @__PURE__ */ jsx5(ToggleButton, { targetRef: wrapperRef, onClick: toggle, position, accentColor }),
+    open && /* @__PURE__ */ jsx5(
       DevStatsPanel,
       {
         targetRef: wrapperRef,
@@ -735,8 +763,7 @@ function DevProfiler({
   ] });
 }
 export {
-  DevProfiler,
-  DevProfiler as default
+  DevProfiler
 };
 /**
  * @module react-dev-profiler
@@ -744,6 +771,12 @@ export {
  * @author Frederic Denis (billywild87) — https://github.com/billywild87
  * @license MIT
  */
+/**
+ * @module react-dev-profiler
+ * @description Shared colors and thresholds used across the profiler UI.
+ * @author Frederic Denis (billywild87) — https://github.com/billywild87
+ * @license MIT
+ */
 /**
  * @module react-dev-profiler
  * @description Environment detection — works with Vite, webpack, Next.js, and any bundler.
@@ -756,12 +789,30 @@ export {
  * @author Frederic Denis (billywild87) — https://github.com/billywild87
  * @license MIT
  */
+/**
+ * @module react-dev-profiler
+ * @description Pure utility functions for DOM measurement.
+ * @author Frederic Denis (billywild87) — https://github.com/billywild87
+ * @license MIT
+ */
 /**
  * @module react-dev-profiler
  * @description Custom hooks that power the profiler's data collection.
  * @author Frederic Denis (billywild87) — https://github.com/billywild87
  * @license MIT
  */
+/**
+ * @module react-dev-profiler
+ * @description Rolling bar chart of frame times (last 60 samples).
+ * @author Frederic Denis (billywild87) — https://github.com/billywild87
+ * @license MIT
+ */
+/**
+ * @module react-dev-profiler
+ * @description Single label/value row used throughout the profiler panel.
+ * @author Frederic Denis (billywild87) — https://github.com/billywild87
+ * @license MIT
+ */
 /**
  * @module react-dev-profiler
  * @description The main stats panel — renders all performance metrics in a floating overlay.