@flotrace/runtime-core 2.2.4 → 2.3.0

package/dist/jsx-dev-runtime.d.mts

@@ -0,0 +1,64 @@
+import { jsxDEV as jsxDEV$1 } from 'react/jsx-dev-runtime';
+export { Fragment, JSX } from 'react/jsx-dev-runtime';
+
+/**
+ * Development JSX runtime entry — instrumented wrapper around React's `jsxDEV`.
+ *
+ * When the user sets `"jsxImportSource": "@flotrace/runtime-core"` in
+ * tsconfig.json, the compiler emits `jsxDEV(...)` calls importing from this
+ * module in dev builds. We intercept each call to:
+ *
+ *   1. Mark the global adoption sentinel (one-time, on first call).
+ *   2. Compute a stable per-callsite ID from the bundler-normalized
+ *      `file:line:col`.
+ *   3. Record the render timestamp into a 60-entry FIFO ring buffer keyed by
+ *      callSiteId (powers the Hot Call Sites tab + conditional-render hint).
+ *   4. Detect inline-literal props (`fn` / `obj` / `arr`) that would survive
+ *      every memo boundary — only observable here, before React processes the
+ *      props.
+ *   5. Attach a `FlotraceJsxSource` object to props under the `FLOTRACE_SOURCE`
+ *      symbol key. Symbol-keyed entries don't appear in `Object.keys` or
+ *      React's unknown-prop warnings, but they DO survive React's prop pipeline
+ *      and end up on `fiber.memoizedProps` unchanged — where the fiber walker
+ *      reads them back.
+ *   6. Delegate to React's real `jsxDEV` with the enriched props.
+ *
+ * The wrapper passes through unchanged when `source` or `props` is missing
+ * (classic runtime, non-dev compiler, stripped source plugin, etc.) — the
+ * existing heuristic ladder in fiberTreeWalker handles those fibers.
+ *
+ * Performance target: <10µs median per call (see jsx-dev-runtime.bench.ts).
+ * Memory: ring buffer caps at 60 × callSiteId-count timestamps (~2.4 MB for a
+ * 5000-callsite app); symbol-keyed source object adds ~200 bytes per
+ * user-component fiber (~1 MB for 5000 fibers).
+ */
+
+/**
+ * The wrapper takes the same arguments the compiler would pass to React's
+ * `jsxDEV`. We mirror React's argument types via `Parameters<typeof origJsxDEV>`
+ * rather than re-declaring them, so any drift in React's signature surfaces
+ * at compile time here. Return type is `ReactNode` (whatever React's jsxDEV
+ * returns — opaque to us).
+ */
+type JsxDEVArgs = Parameters<typeof jsxDEV$1>;
+type JsxDEVReturn = ReturnType<typeof jsxDEV$1>;
+type JsxDEVType = JsxDEVArgs[0];
+/** Shape of the compiler-supplied `source` argument to `jsxDEV`. Stable since React 17. */
+interface JsxSource {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+declare function jsxDEV(type: JsxDEVType, props: Record<string, unknown> | null, key: JsxDEVArgs[2], isStaticChildren: boolean, source: JsxSource | undefined, self: JsxDEVArgs[5]): JsxDEVReturn;
+/**
+ * `jsxsDEV` is what some compilers emit for statically-known children arrays.
+ * Behaviour is identical to `jsxDEV`; we alias rather than duplicate.
+ *
+ * React 17/18's `react/jsx-dev-runtime` doesn't export `jsxsDEV` directly —
+ * compilers call `jsxDEV` for both cases in dev. Re-exporting here under both
+ * names is defensive against compilers that happen to call `jsxsDEV` (some
+ * older Babel configs).
+ */
+declare const jsxsDEV: typeof jsxDEV;
+
+export { jsxDEV, jsxsDEV };

package/dist/jsx-dev-runtime.d.ts

@@ -0,0 +1,64 @@
+import { jsxDEV as jsxDEV$1 } from 'react/jsx-dev-runtime';
+export { Fragment, JSX } from 'react/jsx-dev-runtime';
+
+/**
+ * Development JSX runtime entry — instrumented wrapper around React's `jsxDEV`.
+ *
+ * When the user sets `"jsxImportSource": "@flotrace/runtime-core"` in
+ * tsconfig.json, the compiler emits `jsxDEV(...)` calls importing from this
+ * module in dev builds. We intercept each call to:
+ *
+ *   1. Mark the global adoption sentinel (one-time, on first call).
+ *   2. Compute a stable per-callsite ID from the bundler-normalized
+ *      `file:line:col`.
+ *   3. Record the render timestamp into a 60-entry FIFO ring buffer keyed by
+ *      callSiteId (powers the Hot Call Sites tab + conditional-render hint).
+ *   4. Detect inline-literal props (`fn` / `obj` / `arr`) that would survive
+ *      every memo boundary — only observable here, before React processes the
+ *      props.
+ *   5. Attach a `FlotraceJsxSource` object to props under the `FLOTRACE_SOURCE`
+ *      symbol key. Symbol-keyed entries don't appear in `Object.keys` or
+ *      React's unknown-prop warnings, but they DO survive React's prop pipeline
+ *      and end up on `fiber.memoizedProps` unchanged — where the fiber walker
+ *      reads them back.
+ *   6. Delegate to React's real `jsxDEV` with the enriched props.
+ *
+ * The wrapper passes through unchanged when `source` or `props` is missing
+ * (classic runtime, non-dev compiler, stripped source plugin, etc.) — the
+ * existing heuristic ladder in fiberTreeWalker handles those fibers.
+ *
+ * Performance target: <10µs median per call (see jsx-dev-runtime.bench.ts).
+ * Memory: ring buffer caps at 60 × callSiteId-count timestamps (~2.4 MB for a
+ * 5000-callsite app); symbol-keyed source object adds ~200 bytes per
+ * user-component fiber (~1 MB for 5000 fibers).
+ */
+
+/**
+ * The wrapper takes the same arguments the compiler would pass to React's
+ * `jsxDEV`. We mirror React's argument types via `Parameters<typeof origJsxDEV>`
+ * rather than re-declaring them, so any drift in React's signature surfaces
+ * at compile time here. Return type is `ReactNode` (whatever React's jsxDEV
+ * returns — opaque to us).
+ */
+type JsxDEVArgs = Parameters<typeof jsxDEV$1>;
+type JsxDEVReturn = ReturnType<typeof jsxDEV$1>;
+type JsxDEVType = JsxDEVArgs[0];
+/** Shape of the compiler-supplied `source` argument to `jsxDEV`. Stable since React 17. */
+interface JsxSource {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+declare function jsxDEV(type: JsxDEVType, props: Record<string, unknown> | null, key: JsxDEVArgs[2], isStaticChildren: boolean, source: JsxSource | undefined, self: JsxDEVArgs[5]): JsxDEVReturn;
+/**
+ * `jsxsDEV` is what some compilers emit for statically-known children arrays.
+ * Behaviour is identical to `jsxDEV`; we alias rather than duplicate.
+ *
+ * React 17/18's `react/jsx-dev-runtime` doesn't export `jsxsDEV` directly —
+ * compilers call `jsxDEV` for both cases in dev. Re-exporting here under both
+ * names is defensive against compilers that happen to call `jsxsDEV` (some
+ * older Babel configs).
+ */
+declare const jsxsDEV: typeof jsxDEV;
+
+export { jsxDEV, jsxsDEV };

package/dist/jsx-dev-runtime.js

@@ -0,0 +1,179 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jsx-dev-runtime.ts
+var jsx_dev_runtime_exports = {};
+__export(jsx_dev_runtime_exports, {
+  Fragment: () => import_jsx_dev_runtime.Fragment,
+  jsxDEV: () => jsxDEV,
+  jsxsDEV: () => jsxsDEV
+});
+module.exports = __toCommonJS(jsx_dev_runtime_exports);
+var import_jsx_dev_runtime = require("react/jsx-dev-runtime");
+
+// src/jsxRuntimeUtils.ts
+var FLOTRACE_SOURCE = /* @__PURE__ */ Symbol.for("flotrace.source");
+var JSX_RUNTIME_ACTIVE_KEY = /* @__PURE__ */ Symbol.for("flotrace.jsx-runtime-active");
+function normalizeJsxSourcePath(fileName) {
+  let p = fileName;
+  if (p.startsWith("file://")) p = p.slice("file://".length);
+  if (p.startsWith("webpack-internal:///./")) p = p.slice("webpack-internal:///./".length);
+  if (p.startsWith("[project]/")) p = p.slice("[project]/".length);
+  if (p.startsWith("./")) p = p.slice(2);
+  if (/^\/[a-zA-Z]:[\\/]/.test(p)) p = p.slice(1);
+  if (/^[a-zA-Z]:[\\/]/.test(p)) p = p[0].toLowerCase() + p.slice(1);
+  return p;
+}
+function computeCallSiteId(source) {
+  const normPath = normalizeJsxSourcePath(source.fileName);
+  const key = `${normPath}:${source.lineNumber}:${source.columnNumber}`;
+  let hash = 2166136261;
+  for (let i = 0; i < key.length; i++) {
+    hash ^= key.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+var callSiteRenders = /* @__PURE__ */ new Map();
+var RING_BUFFER_MAX = 60;
+function recordCallSiteRender(callSiteId, now = performance.now()) {
+  const arr = callSiteRenders.get(callSiteId);
+  if (arr === void 0) {
+    callSiteRenders.set(callSiteId, [now]);
+    return;
+  }
+  arr.push(now);
+  if (arr.length > RING_BUFFER_MAX) arr.shift();
+}
+var duplicateKeyEmitter = null;
+var currentKeyBatch = /* @__PURE__ */ new Map();
+var keyBatchFlushScheduled = false;
+function recordJsxKey(source, key) {
+  const keyType = typeof key;
+  if (keyType !== "string" && keyType !== "number" && keyType !== "boolean") return;
+  const keyStr = String(key);
+  const batchKey = `${source.callSiteId}|${keyStr}`;
+  const entry = currentKeyBatch.get(batchKey);
+  if (entry !== void 0) {
+    entry.count++;
+  } else {
+    currentKeyBatch.set(batchKey, { count: 1, source });
+  }
+  if (!keyBatchFlushScheduled) {
+    keyBatchFlushScheduled = true;
+    queueMicrotask(flushDuplicateKeys);
+  }
+}
+function flushDuplicateKeys() {
+  keyBatchFlushScheduled = false;
+  const emitter = duplicateKeyEmitter;
+  if (emitter === null) {
+    currentKeyBatch.clear();
+    return;
+  }
+  for (const [batchKey, { count, source }] of currentKeyBatch) {
+    if (count < 2) continue;
+    const sep = batchKey.indexOf("|");
+    const duplicateKey = batchKey.slice(sep + 1);
+    emitter({
+      callSiteId: source.callSiteId,
+      fileName: source.fileName,
+      lineNumber: source.lineNumber,
+      columnNumber: source.columnNumber,
+      duplicateKey,
+      occurrences: count
+    });
+  }
+  currentKeyBatch.clear();
+}
+function markJsxRuntimeActive() {
+  globalThis[JSX_RUNTIME_ACTIVE_KEY] = true;
+}
+var KNOWN_REACT_PROPS = /* @__PURE__ */ new Set(["key", "ref", "children", "className"]);
+var REACT_ELEMENT_TYPEOF_LEGACY = /* @__PURE__ */ Symbol.for("react.element");
+var REACT_ELEMENT_TYPEOF_R19 = /* @__PURE__ */ Symbol.for("react.transitional.element");
+function isReactElement(v) {
+  const typeOf = v.$$typeof;
+  return typeOf === REACT_ELEMENT_TYPEOF_LEGACY || typeOf === REACT_ELEMENT_TYPEOF_R19;
+}
+function detectInlineLiterals(props) {
+  let out;
+  for (const k in props) {
+    if (KNOWN_REACT_PROPS.has(k)) continue;
+    const v = props[k];
+    if (typeof v === "function") {
+      if (!v.name) {
+        (out ?? (out = {}))[k] = "fn";
+      }
+    } else if (Array.isArray(v)) {
+      if (v.length > 0) {
+        (out ?? (out = {}))[k] = "arr";
+      }
+    } else if (v !== null && typeof v === "object" && // Skip elements processed by our own runtime (marker present).
+    !(FLOTRACE_SOURCE in v) && // Skip React elements processed by ANY runtime — `$$typeof` is set on
+    // every element regardless of which jsx-runtime created it, so this
+    // catches mixed-runtime codebases. Without this guard, an inline
+    // `<Outer child={<Inner/>} />` would false-positive on `child` when
+    // Inner went through a different jsxImportSource.
+    !isReactElement(v)) {
+      const proto = Object.getPrototypeOf(v);
+      if (proto === Object.prototype || proto === null) {
+        (out ?? (out = {}))[k] = "obj";
+      }
+    }
+  }
+  return out;
+}
+
+// src/jsx-dev-runtime.ts
+var IS_BROWSER = typeof window !== "undefined" && typeof document !== "undefined";
+function jsxDEV(type, props, key, isStaticChildren, source, self) {
+  if (!source || !props) {
+    return (0, import_jsx_dev_runtime.jsxDEV)(type, props, key, isStaticChildren, source, self);
+  }
+  if (!IS_BROWSER) {
+    return (0, import_jsx_dev_runtime.jsxDEV)(type, props, key, isStaticChildren, source, self);
+  }
+  markJsxRuntimeActive();
+  const callSiteId = computeCallSiteId(source);
+  const inline = detectInlineLiterals(props);
+  const flotraceSource = inline ? {
+    fileName: normalizeJsxSourcePath(source.fileName),
+    lineNumber: source.lineNumber,
+    columnNumber: source.columnNumber,
+    callSiteId,
+    inline
+  } : {
+    fileName: normalizeJsxSourcePath(source.fileName),
+    lineNumber: source.lineNumber,
+    columnNumber: source.columnNumber,
+    callSiteId
+  };
+  recordCallSiteRender(callSiteId);
+  recordJsxKey(flotraceSource, key);
+  const enrichedProps = { ...props, [FLOTRACE_SOURCE]: flotraceSource };
+  return (0, import_jsx_dev_runtime.jsxDEV)(type, enrichedProps, key, isStaticChildren, source, self);
+}
+var jsxsDEV = jsxDEV;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Fragment,
+  jsxDEV,
+  jsxsDEV
+});

package/dist/jsx-dev-runtime.mjs

@@ -0,0 +1,46 @@
+import {
+  FLOTRACE_SOURCE,
+  computeCallSiteId,
+  detectInlineLiterals,
+  markJsxRuntimeActive,
+  normalizeJsxSourcePath,
+  recordCallSiteRender,
+  recordJsxKey
+} from "./chunk-QLOJU5F2.mjs";
+
+// src/jsx-dev-runtime.ts
+import { jsxDEV as origJsxDEV, Fragment } from "react/jsx-dev-runtime";
+var IS_BROWSER = typeof window !== "undefined" && typeof document !== "undefined";
+function jsxDEV(type, props, key, isStaticChildren, source, self) {
+  if (!source || !props) {
+    return origJsxDEV(type, props, key, isStaticChildren, source, self);
+  }
+  if (!IS_BROWSER) {
+    return origJsxDEV(type, props, key, isStaticChildren, source, self);
+  }
+  markJsxRuntimeActive();
+  const callSiteId = computeCallSiteId(source);
+  const inline = detectInlineLiterals(props);
+  const flotraceSource = inline ? {
+    fileName: normalizeJsxSourcePath(source.fileName),
+    lineNumber: source.lineNumber,
+    columnNumber: source.columnNumber,
+    callSiteId,
+    inline
+  } : {
+    fileName: normalizeJsxSourcePath(source.fileName),
+    lineNumber: source.lineNumber,
+    columnNumber: source.columnNumber,
+    callSiteId
+  };
+  recordCallSiteRender(callSiteId);
+  recordJsxKey(flotraceSource, key);
+  const enrichedProps = { ...props, [FLOTRACE_SOURCE]: flotraceSource };
+  return origJsxDEV(type, enrichedProps, key, isStaticChildren, source, self);
+}
+var jsxsDEV = jsxDEV;
+export {
+  Fragment,
+  jsxDEV,
+  jsxsDEV
+};

package/dist/jsx-runtime.d.mts

@@ -0,0 +1 @@
+export { Fragment, JSX, jsx, jsxs } from 'react/jsx-runtime';

package/dist/jsx-runtime.d.ts

@@ -0,0 +1 @@
+export { Fragment, JSX, jsx, jsxs } from 'react/jsx-runtime';

package/dist/jsx-runtime.js

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jsx-runtime.ts
+var jsx_runtime_exports = {};
+__export(jsx_runtime_exports, {
+  Fragment: () => import_jsx_runtime.Fragment,
+  jsx: () => import_jsx_runtime.jsx,
+  jsxs: () => import_jsx_runtime.jsxs
+});
+module.exports = __toCommonJS(jsx_runtime_exports);
+var import_jsx_runtime = require("react/jsx-runtime");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Fragment,
+  jsx,
+  jsxs
+});

package/dist/jsx-runtime.mjs

@@ -0,0 +1,7 @@
+// src/jsx-runtime.ts
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+export {
+  Fragment,
+  jsx,
+  jsxs
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flotrace/runtime-core",
-  "version": "2.2.4",
+  "version": "2.3.0",
   "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",
@@ -10,8 +10,19 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.mjs",
+      "require": "./dist/jsx-runtime.js"
+    },
+    "./jsx-dev-runtime": {
+      "types": "./dist/jsx-dev-runtime.d.ts",
+      "import": "./dist/jsx-dev-runtime.mjs",
+      "require": "./dist/jsx-dev-runtime.js"
     }
   },
+  "sideEffects": false,
   "files": [
     "dist",
     "LICENSE",