@flotrace/runtime-core 2.3.0 → 2.3.1

package/babel-plugin.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Type declarations for `@flotrace/runtime-core/babel-plugin`.
+ *
+ * The plugin itself is a plain CommonJS module (`babel-plugin.js`) so Babel
+ * — which loads plugins via `require()` — can consume it without a build
+ * step. These declarations give the test suite and any TypeScript consumer
+ * a typed handle on the export.
+ */
+
+import type * as BabelTypes from '@babel/types';
+import type { NodePath, PluginObj } from '@babel/traverse';
+
+export interface FlotraceBabelPluginOptions {
+  /** Set to `false` to no-op (e.g. for production builds). Default `true`. */
+  development?: boolean;
+}
+
+export interface FlotraceBabelPluginState {
+  opts: FlotraceBabelPluginOptions;
+  file: { opts: { filename?: string | null } };
+}
+
+declare const flotraceBabelPlugin: {
+  (api: { types: typeof BabelTypes }): PluginObj<FlotraceBabelPluginState> & {
+    visitor: {
+      JSXOpeningElement(
+        path: NodePath<BabelTypes.JSXOpeningElement>,
+        state: FlotraceBabelPluginState,
+      ): void;
+    };
+  };
+  /** Constant attribute name — `data-flotrace-src`. Avoid string drift. */
+  FLOTRACE_ATTR_NAME: string;
+};
+
+export default flotraceBabelPlugin;

package/babel-plugin.js

@@ -0,0 +1,302 @@
+/**
+ * @flotrace/runtime-core/babel-plugin
+ *
+ * Injects source attribution into user code in two complementary places so
+ * every fiber in the FloTrace tree gets click-to-IDE coverage:
+ *
+ *   (A) `data-flotrace-src` JSX attribute on every JSX element.
+ *       Read at runtime from `fiber.memoizedProps['data-flotrace-src']`.
+ *       This covers every fiber that was created via user-written JSX
+ *       (`<MyComponent />`) — the "call site" attribution.
+ *
+ *   (B) `Component['data-flotrace-src'] = '{...}'` assignment after every
+ *       PascalCase function / arrow / class declaration. Read at runtime
+ *       from `fiber.type['data-flotrace-src']` as a fallback for fibers
+ *       whose memoizedProps lacks the attribute — i.e. when the component
+ *       was instantiated via `React.createElement(Component, ...)` from
+ *       inside a library (react-navigation `<Stack.Screen component={X}>`,
+ *       HOC-wrapped components, top-level App registered via
+ *       AppRegistry.registerComponent). This is the "definition site"
+ *       attribution.
+ *
+ * Together (A) + (B) ensure that every user component in the tree has a
+ * source — never a broken-state "no nav button" card.
+ *
+ * Why a string-keyed JSXAttribute (route A) instead of the JSX-runtime opt-in:
+ *
+ *   1. Coexists with any other `jsxImportSource` consumer (nativewind /
+ *      react-native-css-interop, Solid-style runtimes, etc.) — those claim
+ *      the single `importSource` slot per file; this plugin is independent.
+ *
+ *   2. Survives React 19's keyed-element prop clone. Symbol-keyed props get
+ *      silently dropped by React 19's `for-in` config clone whenever an
+ *      element has a `key` prop (list rows, `.map()` children, navigation
+ *      screens — the high-value source-tracking sites). String-keyed props
+ *      enumerate via for-in and survive.
+ *
+ *   3. `data-*` attributes are valid on every React DOM host element (no
+ *      unknown-prop warning) and silently ignored by React Native's native
+ *      renderer (no warning either).
+ *
+ *   4. JSON-encoded string value parses safely on Windows paths (`C:\...`)
+ *      where a `file:line:col` delimiter would be ambiguous.
+ *
+ * Usage in user babel.config.js (single line, no other config changes):
+ *
+ *   plugins: ['@flotrace/runtime-core/babel-plugin']
+ *
+ * Options:
+ *   - development (boolean, default true): when false, the plugin no-ops so
+ *     production bundles aren't bloated with source attributions.
+ *
+ * No conflict with `@babel/plugin-transform-react-jsx` (any runtime/source/
+ * importSource config) — this plugin only ADDS attributes and assignments,
+ * it doesn't touch the JSX transform itself.
+ */
+'use strict';
+
+const FLOTRACE_ATTR_NAME = 'data-flotrace-src';
+
+// React-component naming convention. Anything starting with an uppercase
+// letter is treated as a component candidate. Underscores tolerated for
+// generated names (`_AppComponent` etc.).
+const PASCAL_CASE_RE = /^[A-Z][A-Za-z0-9_$]*$/;
+
+/** Build the JSON payload string for the `data-flotrace-src` value. */
+function buildPayload(filename, loc) {
+  return JSON.stringify({
+    f: filename,
+    l: loc.start.line,
+    c: loc.start.column + 1, // 1-indexed to match React's convention
+  });
+}
+
+/** Filename + loc validation gates shared by all visitors. */
+function shouldVisit(state, loc) {
+  if (state.opts && state.opts.development === false) return null;
+  const filename = state.file && state.file.opts && state.file.opts.filename;
+  if (!filename) return null;
+  if (filename.indexOf('/node_modules/') !== -1) return null;
+  if (filename.indexOf('\\node_modules\\') !== -1) return null;
+  if (!loc || !loc.start) return null;
+  return filename;
+}
+
+/**
+ * Reject obviously-non-component initializer types. PascalCase + a function
+ * / class / HOC-call init IS a component (or close enough that tagging is
+ * harmless). PascalCase + a primitive / array / object literal is NOT.
+ */
+function isComponentLikeInit(node) {
+  if (!node) return false;
+  switch (node.type) {
+    case 'NullLiteral':
+    case 'NumericLiteral':
+    case 'StringLiteral':
+    case 'BooleanLiteral':
+    case 'BigIntLiteral':
+    case 'ArrayExpression':
+    case 'ObjectExpression':
+    case 'TemplateLiteral':
+    case 'RegExpLiteral':
+      return false;
+    default:
+      // Component-shaped: ArrowFunctionExpression, FunctionExpression,
+      // ClassExpression, CallExpression (HOC wrap), Identifier (re-export),
+      // MemberExpression (`X.Y`), ConditionalExpression, etc.
+      return true;
+  }
+}
+
+module.exports = function flotraceSourceAttributionPlugin({ types: t }) {
+  /**
+   * Build the `Identifier['data-flotrace-src'] = '<payload>';` statement.
+   * Guarded with `if (Identifier)` so reassignments to `undefined`/`null`
+   * before the assignment runs don't throw at module load.
+   */
+  function buildDeclTaggingStatement(name, payload) {
+    const idRef = t.identifier(name);
+    const memberAccess = t.memberExpression(
+      t.identifier(name),
+      t.stringLiteral(FLOTRACE_ATTR_NAME),
+      /* computed */ true,
+    );
+    return t.ifStatement(
+      idRef,
+      t.expressionStatement(
+        t.assignmentExpression('=', memberAccess, t.stringLiteral(payload)),
+      ),
+    );
+  }
+
+  /**
+   * Insert a sibling assignment immediately after a top-level declaration
+   * path. `path` here is the *outermost* statement we want to insert after
+   * — for an `export default function X() {}`, the outer path is the
+   * ExportDefaultDeclaration, not the FunctionDeclaration inside it.
+   * Returns true when injection happened (used by callers to mark the node
+   * as visited and prevent re-injection).
+   */
+  function insertDeclTagAfter(path, name, payload) {
+    // Idempotency: scan siblings for an existing assignment to the same
+    // identifier + same attribute. Babel can re-visit the path after other
+    // plugins mutate the program.
+    const siblings =
+      path.parentPath && path.parentPath.get('body')
+        ? [].concat(path.parentPath.get('body'))
+        : [];
+    for (let i = 0; i < siblings.length; i++) {
+      const sib = siblings[i].node;
+      if (
+        sib &&
+        sib.type === 'IfStatement' &&
+        sib.test &&
+        sib.test.type === 'Identifier' &&
+        sib.test.name === name &&
+        sib.consequent &&
+        sib.consequent.type === 'ExpressionStatement' &&
+        sib.consequent.expression &&
+        sib.consequent.expression.type === 'AssignmentExpression'
+      ) {
+        const left = sib.consequent.expression.left;
+        if (
+          left.type === 'MemberExpression' &&
+          left.computed &&
+          left.property.type === 'StringLiteral' &&
+          left.property.value === FLOTRACE_ATTR_NAME
+        ) {
+          return false;
+        }
+      }
+    }
+    path.insertAfter(buildDeclTaggingStatement(name, payload));
+    return true;
+  }
+
+  return {
+    name: 'flotrace-source-attribution',
+    visitor: {
+      // ────────────────────────────────────────────────────────────
+      // (A) Tag every JSX element with its call-site source.
+      // ────────────────────────────────────────────────────────────
+      JSXOpeningElement(path, state) {
+        const filename = shouldVisit(state, path.node.loc);
+        if (!filename) return;
+
+        // Idempotency: skip if a previous run already injected the attribute
+        // (Babel can re-traverse after another plugin mutates the node).
+        const attrs = path.node.attributes;
+        for (let i = 0; i < attrs.length; i++) {
+          const attr = attrs[i];
+          if (
+            attr.type === 'JSXAttribute' &&
+            attr.name &&
+            attr.name.type === 'JSXIdentifier' &&
+            attr.name.name === FLOTRACE_ATTR_NAME
+          ) {
+            return;
+          }
+        }
+
+        // Skip `<Fragment>` openings — Fragment doesn't accept arbitrary
+        // props, and React would warn on the unknown attribute. Note that
+        // `<></>` short-syntax is a `JSXFragment` AST node (not a
+        // `JSXOpeningElement`), so the visitor never fires for it — only
+        // the named forms reach this point.
+        const openingName = path.node.name;
+        if (openingName.type === 'JSXIdentifier' && openingName.name === 'Fragment') {
+          return;
+        }
+        // `<React.Fragment>` / `<MyNs.Fragment>` — JSXMemberExpression with
+        // a trailing `Fragment` identifier. (`React.Fragment` cannot appear
+        // as a plain JSXIdentifier — identifiers don't permit dots.)
+        if (
+          openingName.type === 'JSXMemberExpression' &&
+          openingName.property &&
+          openingName.property.name === 'Fragment'
+        ) {
+          return;
+        }
+
+        const payload = buildPayload(filename, path.node.loc);
+        // Wrap the JSON payload in a JSX expression container so the value
+        // uses JS-string-literal escaping rules. A bare `t.stringLiteral`
+        // here would render as `data-flotrace-src="..."` — but JSX string
+        // attributes don't support C-style escapes, so embedded `"` chars
+        // produce invalid JSX. The expression-container form (`name={...}`)
+        // sidesteps the whole quoting problem.
+        attrs.push(
+          t.jsxAttribute(
+            t.jsxIdentifier(FLOTRACE_ATTR_NAME),
+            t.jsxExpressionContainer(t.stringLiteral(payload)),
+          ),
+        );
+      },
+
+      // ────────────────────────────────────────────────────────────
+      // (B) Tag every PascalCase component definition with its declaration
+      //     source. Covers fibers instantiated via `React.createElement`
+      //     from inside a library (react-navigation screens, HOC-wrapped
+      //     components, AppRegistry-registered roots).
+      // ────────────────────────────────────────────────────────────
+      FunctionDeclaration(path, state) {
+        const id = path.node.id;
+        if (!id || !PASCAL_CASE_RE.test(id.name)) return;
+        const filename = shouldVisit(state, path.node.loc);
+        if (!filename) return;
+        // If wrapped in `export default function X() {}` /
+        // `export function X() {}`, attach the assignment AFTER the export
+        // statement so it's evaluated at module-eval time (function decls
+        // are hoisted, so the identifier is defined by then).
+        const target =
+          path.parentPath.isExportDefaultDeclaration() ||
+          path.parentPath.isExportNamedDeclaration()
+            ? path.parentPath
+            : path;
+        const payload = buildPayload(filename, path.node.loc);
+        insertDeclTagAfter(target, id.name, payload);
+      },
+
+      ClassDeclaration(path, state) {
+        const id = path.node.id;
+        if (!id || !PASCAL_CASE_RE.test(id.name)) return;
+        const filename = shouldVisit(state, path.node.loc);
+        if (!filename) return;
+        const target =
+          path.parentPath.isExportDefaultDeclaration() ||
+          path.parentPath.isExportNamedDeclaration()
+            ? path.parentPath
+            : path;
+        const payload = buildPayload(filename, path.node.loc);
+        insertDeclTagAfter(target, id.name, payload);
+      },
+
+      VariableDeclarator(path, state) {
+        const id = path.node.id;
+        if (!id || id.type !== 'Identifier') return;
+        if (!PASCAL_CASE_RE.test(id.name)) return;
+        if (!isComponentLikeInit(path.node.init)) return;
+        const filename = shouldVisit(state, path.node.loc);
+        if (!filename) return;
+        // VariableDeclarator's parent is VariableDeclaration; that may be
+        // wrapped in ExportNamedDeclaration (`export const Foo = ...`).
+        // Walk up to the outermost statement so the assignment lands at
+        // the right scope.
+        let target = path.parentPath; // VariableDeclaration
+        if (
+          target.parentPath &&
+          (target.parentPath.isExportNamedDeclaration() ||
+            target.parentPath.isExportDefaultDeclaration())
+        ) {
+          target = target.parentPath;
+        }
+        const payload = buildPayload(filename, path.node.loc);
+        insertDeclTagAfter(target, id.name, payload);
+      },
+    },
+  };
+};
+
+// Re-export the attribute name so the runtime reader and tests have a
+// single source of truth (no string drift between plugin and walker).
+module.exports.FLOTRACE_ATTR_NAME = FLOTRACE_ATTR_NAME;

package/dist/{chunk-QLOJU5F2.mjs → chunk-5LSFLPGP.mjs}

@@ -11,6 +11,44 @@ function normalizeJsxSourcePath(fileName) {
   if (/^[a-zA-Z]:[\\/]/.test(p)) p = p[0].toLowerCase() + p.slice(1);
   return p;
 }
+function normalizeStackFramePath(rawPath) {
+  let p = rawPath;
+  const queryIdx = p.indexOf("?");
+  if (queryIdx !== -1) p = p.slice(0, queryIdx);
+  const httpMatch = p.match(/^https?:\/\/[^/]+(\/.+)$/);
+  if (httpMatch) {
+    p = httpMatch[1];
+    if (p.startsWith("/")) p = p.slice(1);
+  }
+  return normalizeJsxSourcePath(p);
+}
+function isJsBundlePath(rawPath) {
+  if (/\bindex\.bundle\b/.test(rawPath)) return true;
+  if (/\.bundle(\?|$|\.js(\?|$))/.test(rawPath)) return true;
+  if (/\?platform=(ios|android|web|native)\b/.test(rawPath)) return true;
+  return false;
+}
+function parseFirstNonReactFrame(stack) {
+  const lines = stack.split("\n");
+  for (const line of lines) {
+    const parened = line.match(/\(([^)]+):(\d+):(\d+)\)/);
+    const hermes = line.match(/@([^\s]+):(\d+):(\d+)$/);
+    const match = parened ?? hermes;
+    if (!match) continue;
+    const path = match[1];
+    if (path.includes("react-dom")) continue;
+    if (path.includes("react-native/Libraries")) continue;
+    if (path.includes("/react/cjs/")) continue;
+    if (path.includes("/scheduler/")) continue;
+    if (isJsBundlePath(path)) continue;
+    return {
+      fileName: normalizeStackFramePath(path),
+      lineNumber: Number(match[2]),
+      columnNumber: Number(match[3])
+    };
+  }
+  return null;
+}
 function computeCallSiteId(source) {
   const normPath = normalizeJsxSourcePath(source.fileName);
   const key = `${normPath}:${source.lineNumber}:${source.columnNumber}`;
@@ -21,16 +59,71 @@ function computeCallSiteId(source) {
   }
   return (hash >>> 0).toString(16).padStart(8, "0");
 }
+var FLOTRACE_SRC_ATTR = "data-flotrace-src";
+function parseDataFlotraceSrc(value) {
+  let obj;
+  try {
+    obj = JSON.parse(value);
+  } catch {
+    return void 0;
+  }
+  if (!obj || typeof obj !== "object") return void 0;
+  const o = obj;
+  if (typeof o.f !== "string" || typeof o.l !== "number" || typeof o.c !== "number") {
+    return void 0;
+  }
+  const fileName = o.f;
+  const lineNumber = o.l;
+  const columnNumber = o.c;
+  return {
+    fileName,
+    lineNumber,
+    columnNumber,
+    callSiteId: computeCallSiteId({ fileName, lineNumber, columnNumber })
+  };
+}
 function readJsxSourceFromFiber(fiber) {
   const props = fiber.memoizedProps;
-  if (!props) return void 0;
-  const raw = props[FLOTRACE_SOURCE];
-  if (!raw || typeof raw !== "object") return void 0;
-  const obj = raw;
-  if (typeof obj.fileName !== "string" || typeof obj.lineNumber !== "number" || typeof obj.columnNumber !== "number" || typeof obj.callSiteId !== "string") {
-    return void 0;
+  if (props) {
+    const symRaw = props[FLOTRACE_SOURCE];
+    if (symRaw && typeof symRaw === "object") {
+      const obj = symRaw;
+      if (typeof obj.fileName === "string" && typeof obj.lineNumber === "number" && typeof obj.columnNumber === "number" && typeof obj.callSiteId === "string") {
+        return symRaw;
+      }
+    }
+    const strRaw = props[FLOTRACE_SRC_ATTR];
+    if (typeof strRaw === "string") {
+      const parsed = parseDataFlotraceSrc(strRaw);
+      if (parsed) return parsed;
+    }
+  }
+  const type = fiber.type;
+  if (type !== null && (typeof type === "function" || typeof type === "object")) {
+    const typeAttr = type[FLOTRACE_SRC_ATTR];
+    if (typeof typeAttr === "string") {
+      const parsed = parseDataFlotraceSrc(typeAttr);
+      if (parsed) return parsed;
+    }
+  }
+  return void 0;
+}
+function isUserComponent(fiber) {
+  const jsxSrc = readJsxSourceFromFiber({
+    memoizedProps: fiber.memoizedProps ?? null,
+    type: fiber.type
+  });
+  if (jsxSrc && !jsxSrc.fileName.includes("node_modules")) return true;
+  const debugSourcePath = fiber._debugSource?.fileName;
+  if (typeof debugSourcePath === "string" && !debugSourcePath.includes("node_modules")) {
+    return true;
+  }
+  const stack = fiber._debugStack?.stack;
+  if (typeof stack === "string") {
+    const frame = parseFirstNonReactFrame(stack);
+    if (frame && !frame.fileName.includes("node_modules")) return true;
   }
-  return raw;
+  return false;
 }
 var callSiteRenders = /* @__PURE__ */ new Map();
 var RING_BUFFER_MAX = 60;
@@ -166,8 +259,10 @@ export {
   FLOTRACE_SOURCE,
   JSX_RUNTIME_ACTIVE_KEY,
   normalizeJsxSourcePath,
+  parseFirstNonReactFrame,
   computeCallSiteId,
   readJsxSourceFromFiber,
+  isUserComponent,
   recordCallSiteRender,
   getCallSiteRenders,
   getCallSiteRenderRate,

package/dist/index.d.mts

@@ -79,6 +79,64 @@ declare function normalizeJsxSourcePath(fileName: string): string;
  * Not suitable as a security token.
  */
 declare function computeCallSiteId(source: JsxSourceArg): string;
+/**
+ * Top-priority "is this fiber a user-defined component?" check.
+ *
+ * Three routes, checked in order of precision (fastest + most reliable
+ * first). Returns `true` as soon as ANY route produces positive evidence
+ * that the fiber's source code lives outside `node_modules`.
+ *
+ *   Route A — `fiber.type[FLOTRACE_SRC_ATTR]` (babel plugin):
+ *     The `@flotrace/runtime-core/babel-plugin` declaration-tagging pass
+ *     writes a JSON `{f,l,c}` payload onto every PascalCase function /
+ *     class / variable in user code. Works for: React Native (Babel),
+ *     Vite + React (Babel), CRA, Webpack + Babel, Next.js Pages Router
+ *     (if Babel is opted in). Doesn't work for: Next.js with SWC.
+ *
+ *   Route B — `fiber._debugSource.fileName` (React 18 + Babel JSX source):
+ *     The `@babel/plugin-transform-react-jsx-source` plugin (auto-included
+ *     by RN's preset and CRA/Vite's React preset) injects `__source` on
+ *     every JSX element, which React 18 captures onto `fiber._debugSource`.
+ *     Empty under React 19+ (the field was deprecated upstream).
+ *
+ *   Route C — `fiber._debugStack.stack` (React 19+ web — Next.js SWC, Vite):
+ *     React 19 replaced `_debugSource` with an Error captured at JSX
+ *     creation time. We parse the first non-React stack frame for a path.
+ *     This is what makes Next.js (SWC, no babel config possible without
+ *     losing SWC) work — the React 19 reconciler attaches stack-frame
+ *     info regardless of the compiler used.
+ *
+ * For ALL routes the "is user code" criterion is the same: the resolved
+ * file path must not include `node_modules`. That string check is enough
+ * because every modern bundler resolves third-party deps through a path
+ * containing `/node_modules/` — there's no realistic false-negative.
+ *
+ * Returns `false` for:
+ *   - Host components (string `fiber.type` like `'View'` / `'div'`)
+ *   - Library / framework components (paths in `node_modules`, plus
+ *     bundle-URL frames which are skipped by `parseFirstNonReactFrame`)
+ *   - Fibers with no source signal at all (degrade to existing heuristics)
+ *
+ * Used by `fiberTreeWalker.ts` as a top-priority short-circuit before
+ * name-list / regex / path heuristics fire. A fiber that returns `true`
+ * here is authoritatively user code — every framework/library
+ * classification downstream should bypass.
+ *
+ * Generic over the fiber-like shape so cascadeAnalyzer / propDrillingAnalyzer
+ * / valueTraceResolver can all share one definition without importing the
+ * walker's `Fiber` type.
+ */
+declare function isUserComponent(fiber: {
+    type?: unknown;
+    memoizedProps?: Record<string, unknown> | null;
+    _debugSource?: {
+        fileName: string;
+        lineNumber?: number;
+    } | null;
+    _debugStack?: {
+        stack?: string;
+    } | null;
+}): boolean;
 /**
  * Record a render timestamp for a call site. Caller may inject `now` for
  * deterministic tests; production callers use the default `performance.now()`.
@@ -2074,4 +2132,4 @@ interface FtConsoleApi {
     download(filename?: string): void;
 }
 
-export { type ActionStateEntry, DEFAULT_CONFIG, type DetailedRenderReason, type DetailedRenderReasonType, type DuplicateKeyEvent, type EffectInfo, FLOTRACE_SOURCE, type Fiber$1 as Fiber, type FiberEffect, type FiberHookState, type FiberTreeWalkerOptions, type FloTraceConfig, FloTraceWebSocketClient, type FlotraceJsxSource, type FrameworkInfo, type HookInfo, type HookType, JSX_RUNTIME_ACTIVE_KEY, type LiveTreeNode, type MutationCorrelation, type NetworkRequestEntry, type PropChange, type ReduxStoreApi, type ResolvedFloTraceConfig, type RscCacheStatus, type RuntimeActionStateMessage, type RuntimeCallSiteMetricsMessage, type RuntimeDuplicateKeyMessage, type RuntimeHydrationEventMessage, type RuntimeNextjsContextMessage, type RuntimeOptimisticDiffMessage, type RuntimeRscPayloadMessage, type RuntimeTreeDiffMessage, type RuntimeValueTraceMessage, type SerializedValue, type SourceConfidence, type TanStackMutationInfo, type TanStackQueryClientApi, type TanStackQueryEvent, type TanStackQueryInfo, type TimelineEvent, type TimelineEventType, type TraceConfidence, type TraceStep, type TrackingOptions, type ValueTrace, type ValueTraceInput, type ZustandStoreApi, buildAncestorChain, clearCallSiteRenders, clearFetchOriginTags, computeCallSiteId, computeCallSiteMetricsPayload, describeFiberType, detectInlineLiterals, detectServerComponent, detectWebFramework, disposeWebSocketClient, findFetchOrigin, getCallSiteRenderRate, getCallSiteRenders, getChangedKeys, getComponentNameFromFiber, getCurrentRenderingFiber, getDetailedRenderReason, getFiberRefMap, getNodeEffects, getNodeHooks, getNodeProps, getReduxSnapshot, getTanstackSnapshot, getTimeline, getWebSocketClient, getZustandSnapshot, hasActiveTags, inspectEffects, inspectHooks, installFiberTreeWalker, installReduxTracker, installRscPayloadInterceptor, installTanStackQueryTracker, installTimelineTracker, installZustandTracker, isJsxRuntimeActive, isReduxStore, isTanStackQueryClient, logTreeSnapshot, logTreeSummary, markJsxRuntimeActive, maybeEmitNextjsContext, normalizeJsxSourcePath, recordCallSiteRender, recordTimelineEvent, requestFullSnapshot, requestTreeSnapshot, resetNextjsDetection, resolveValueTrace, serializeProps, serializeValue, setDuplicateKeyEmitter, setFiberDebug, tagFetchData, uninstallFiberTreeWalker, uninstallReduxTracker, uninstallRscPayloadInterceptor, uninstallTanStackQueryTracker, uninstallTimelineTracker, uninstallZustandTracker };
+export { type ActionStateEntry, DEFAULT_CONFIG, type DetailedRenderReason, type DetailedRenderReasonType, type DuplicateKeyEvent, type EffectInfo, FLOTRACE_SOURCE, type Fiber$1 as Fiber, type FiberEffect, type FiberHookState, type FiberTreeWalkerOptions, type FloTraceConfig, FloTraceWebSocketClient, type FlotraceJsxSource, type FrameworkInfo, type HookInfo, type HookType, JSX_RUNTIME_ACTIVE_KEY, type LiveTreeNode, type MutationCorrelation, type NetworkRequestEntry, type PropChange, type ReduxStoreApi, type ResolvedFloTraceConfig, type RscCacheStatus, type RuntimeActionStateMessage, type RuntimeCallSiteMetricsMessage, type RuntimeDuplicateKeyMessage, type RuntimeHydrationEventMessage, type RuntimeNextjsContextMessage, type RuntimeOptimisticDiffMessage, type RuntimeRscPayloadMessage, type RuntimeTreeDiffMessage, type RuntimeValueTraceMessage, type SerializedValue, type SourceConfidence, type TanStackMutationInfo, type TanStackQueryClientApi, type TanStackQueryEvent, type TanStackQueryInfo, type TimelineEvent, type TimelineEventType, type TraceConfidence, type TraceStep, type TrackingOptions, type ValueTrace, type ValueTraceInput, type ZustandStoreApi, buildAncestorChain, clearCallSiteRenders, clearFetchOriginTags, computeCallSiteId, computeCallSiteMetricsPayload, describeFiberType, detectInlineLiterals, detectServerComponent, detectWebFramework, disposeWebSocketClient, findFetchOrigin, getCallSiteRenderRate, getCallSiteRenders, getChangedKeys, getComponentNameFromFiber, getCurrentRenderingFiber, getDetailedRenderReason, getFiberRefMap, getNodeEffects, getNodeHooks, getNodeProps, getReduxSnapshot, getTanstackSnapshot, getTimeline, getWebSocketClient, getZustandSnapshot, hasActiveTags, inspectEffects, inspectHooks, installFiberTreeWalker, installReduxTracker, installRscPayloadInterceptor, installTanStackQueryTracker, installTimelineTracker, installZustandTracker, isJsxRuntimeActive, isReduxStore, isTanStackQueryClient, isUserComponent, logTreeSnapshot, logTreeSummary, markJsxRuntimeActive, maybeEmitNextjsContext, normalizeJsxSourcePath, recordCallSiteRender, recordTimelineEvent, requestFullSnapshot, requestTreeSnapshot, resetNextjsDetection, resolveValueTrace, serializeProps, serializeValue, setDuplicateKeyEmitter, setFiberDebug, tagFetchData, uninstallFiberTreeWalker, uninstallReduxTracker, uninstallRscPayloadInterceptor, uninstallTanStackQueryTracker, uninstallTimelineTracker, uninstallZustandTracker };

package/dist/index.d.ts

@@ -79,6 +79,64 @@ declare function normalizeJsxSourcePath(fileName: string): string;
  * Not suitable as a security token.
  */
 declare function computeCallSiteId(source: JsxSourceArg): string;
+/**
+ * Top-priority "is this fiber a user-defined component?" check.
+ *
+ * Three routes, checked in order of precision (fastest + most reliable
+ * first). Returns `true` as soon as ANY route produces positive evidence
+ * that the fiber's source code lives outside `node_modules`.
+ *
+ *   Route A — `fiber.type[FLOTRACE_SRC_ATTR]` (babel plugin):
+ *     The `@flotrace/runtime-core/babel-plugin` declaration-tagging pass
+ *     writes a JSON `{f,l,c}` payload onto every PascalCase function /
+ *     class / variable in user code. Works for: React Native (Babel),
+ *     Vite + React (Babel), CRA, Webpack + Babel, Next.js Pages Router
+ *     (if Babel is opted in). Doesn't work for: Next.js with SWC.
+ *
+ *   Route B — `fiber._debugSource.fileName` (React 18 + Babel JSX source):
+ *     The `@babel/plugin-transform-react-jsx-source` plugin (auto-included
+ *     by RN's preset and CRA/Vite's React preset) injects `__source` on
+ *     every JSX element, which React 18 captures onto `fiber._debugSource`.
+ *     Empty under React 19+ (the field was deprecated upstream).
+ *
+ *   Route C — `fiber._debugStack.stack` (React 19+ web — Next.js SWC, Vite):
+ *     React 19 replaced `_debugSource` with an Error captured at JSX
+ *     creation time. We parse the first non-React stack frame for a path.
+ *     This is what makes Next.js (SWC, no babel config possible without
+ *     losing SWC) work — the React 19 reconciler attaches stack-frame
+ *     info regardless of the compiler used.
+ *
+ * For ALL routes the "is user code" criterion is the same: the resolved
+ * file path must not include `node_modules`. That string check is enough
+ * because every modern bundler resolves third-party deps through a path
+ * containing `/node_modules/` — there's no realistic false-negative.
+ *
+ * Returns `false` for:
+ *   - Host components (string `fiber.type` like `'View'` / `'div'`)
+ *   - Library / framework components (paths in `node_modules`, plus
+ *     bundle-URL frames which are skipped by `parseFirstNonReactFrame`)
+ *   - Fibers with no source signal at all (degrade to existing heuristics)
+ *
+ * Used by `fiberTreeWalker.ts` as a top-priority short-circuit before
+ * name-list / regex / path heuristics fire. A fiber that returns `true`
+ * here is authoritatively user code — every framework/library
+ * classification downstream should bypass.
+ *
+ * Generic over the fiber-like shape so cascadeAnalyzer / propDrillingAnalyzer
+ * / valueTraceResolver can all share one definition without importing the
+ * walker's `Fiber` type.
+ */
+declare function isUserComponent(fiber: {
+    type?: unknown;
+    memoizedProps?: Record<string, unknown> | null;
+    _debugSource?: {
+        fileName: string;
+        lineNumber?: number;
+    } | null;
+    _debugStack?: {
+        stack?: string;
+    } | null;
+}): boolean;
 /**
  * Record a render timestamp for a call site. Caller may inject `now` for
  * deterministic tests; production callers use the default `performance.now()`.
@@ -2074,4 +2132,4 @@ interface FtConsoleApi {
     download(filename?: string): void;
 }
 
-export { type ActionStateEntry, DEFAULT_CONFIG, type DetailedRenderReason, type DetailedRenderReasonType, type DuplicateKeyEvent, type EffectInfo, FLOTRACE_SOURCE, type Fiber$1 as Fiber, type FiberEffect, type FiberHookState, type FiberTreeWalkerOptions, type FloTraceConfig, FloTraceWebSocketClient, type FlotraceJsxSource, type FrameworkInfo, type HookInfo, type HookType, JSX_RUNTIME_ACTIVE_KEY, type LiveTreeNode, type MutationCorrelation, type NetworkRequestEntry, type PropChange, type ReduxStoreApi, type ResolvedFloTraceConfig, type RscCacheStatus, type RuntimeActionStateMessage, type RuntimeCallSiteMetricsMessage, type RuntimeDuplicateKeyMessage, type RuntimeHydrationEventMessage, type RuntimeNextjsContextMessage, type RuntimeOptimisticDiffMessage, type RuntimeRscPayloadMessage, type RuntimeTreeDiffMessage, type RuntimeValueTraceMessage, type SerializedValue, type SourceConfidence, type TanStackMutationInfo, type TanStackQueryClientApi, type TanStackQueryEvent, type TanStackQueryInfo, type TimelineEvent, type TimelineEventType, type TraceConfidence, type TraceStep, type TrackingOptions, type ValueTrace, type ValueTraceInput, type ZustandStoreApi, buildAncestorChain, clearCallSiteRenders, clearFetchOriginTags, computeCallSiteId, computeCallSiteMetricsPayload, describeFiberType, detectInlineLiterals, detectServerComponent, detectWebFramework, disposeWebSocketClient, findFetchOrigin, getCallSiteRenderRate, getCallSiteRenders, getChangedKeys, getComponentNameFromFiber, getCurrentRenderingFiber, getDetailedRenderReason, getFiberRefMap, getNodeEffects, getNodeHooks, getNodeProps, getReduxSnapshot, getTanstackSnapshot, getTimeline, getWebSocketClient, getZustandSnapshot, hasActiveTags, inspectEffects, inspectHooks, installFiberTreeWalker, installReduxTracker, installRscPayloadInterceptor, installTanStackQueryTracker, installTimelineTracker, installZustandTracker, isJsxRuntimeActive, isReduxStore, isTanStackQueryClient, logTreeSnapshot, logTreeSummary, markJsxRuntimeActive, maybeEmitNextjsContext, normalizeJsxSourcePath, recordCallSiteRender, recordTimelineEvent, requestFullSnapshot, requestTreeSnapshot, resetNextjsDetection, resolveValueTrace, serializeProps, serializeValue, setDuplicateKeyEmitter, setFiberDebug, tagFetchData, uninstallFiberTreeWalker, uninstallReduxTracker, uninstallRscPayloadInterceptor, uninstallTanStackQueryTracker, uninstallTimelineTracker, uninstallZustandTracker };
+export { type ActionStateEntry, DEFAULT_CONFIG, type DetailedRenderReason, type DetailedRenderReasonType, type DuplicateKeyEvent, type EffectInfo, FLOTRACE_SOURCE, type Fiber$1 as Fiber, type FiberEffect, type FiberHookState, type FiberTreeWalkerOptions, type FloTraceConfig, FloTraceWebSocketClient, type FlotraceJsxSource, type FrameworkInfo, type HookInfo, type HookType, JSX_RUNTIME_ACTIVE_KEY, type LiveTreeNode, type MutationCorrelation, type NetworkRequestEntry, type PropChange, type ReduxStoreApi, type ResolvedFloTraceConfig, type RscCacheStatus, type RuntimeActionStateMessage, type RuntimeCallSiteMetricsMessage, type RuntimeDuplicateKeyMessage, type RuntimeHydrationEventMessage, type RuntimeNextjsContextMessage, type RuntimeOptimisticDiffMessage, type RuntimeRscPayloadMessage, type RuntimeTreeDiffMessage, type RuntimeValueTraceMessage, type SerializedValue, type SourceConfidence, type TanStackMutationInfo, type TanStackQueryClientApi, type TanStackQueryEvent, type TanStackQueryInfo, type TimelineEvent, type TimelineEventType, type TraceConfidence, type TraceStep, type TrackingOptions, type ValueTrace, type ValueTraceInput, type ZustandStoreApi, buildAncestorChain, clearCallSiteRenders, clearFetchOriginTags, computeCallSiteId, computeCallSiteMetricsPayload, describeFiberType, detectInlineLiterals, detectServerComponent, detectWebFramework, disposeWebSocketClient, findFetchOrigin, getCallSiteRenderRate, getCallSiteRenders, getChangedKeys, getComponentNameFromFiber, getCurrentRenderingFiber, getDetailedRenderReason, getFiberRefMap, getNodeEffects, getNodeHooks, getNodeProps, getReduxSnapshot, getTanstackSnapshot, getTimeline, getWebSocketClient, getZustandSnapshot, hasActiveTags, inspectEffects, inspectHooks, installFiberTreeWalker, installReduxTracker, installRscPayloadInterceptor, installTanStackQueryTracker, installTimelineTracker, installZustandTracker, isJsxRuntimeActive, isReduxStore, isTanStackQueryClient, isUserComponent, logTreeSnapshot, logTreeSummary, markJsxRuntimeActive, maybeEmitNextjsContext, normalizeJsxSourcePath, recordCallSiteRender, recordTimelineEvent, requestFullSnapshot, requestTreeSnapshot, resetNextjsDetection, resolveValueTrace, serializeProps, serializeValue, setDuplicateKeyEmitter, setFiberDebug, tagFetchData, uninstallFiberTreeWalker, uninstallReduxTracker, uninstallRscPayloadInterceptor, uninstallTanStackQueryTracker, uninstallTimelineTracker, uninstallZustandTracker };

package/dist/index.js

@@ -72,6 +72,7 @@ __export(index_exports, {
   isJsxRuntimeActive: () => isJsxRuntimeActive,
   isReduxStore: () => isReduxStore,
   isTanStackQueryClient: () => isTanStackQueryClient,
+  isUserComponent: () => isUserComponent,
   logTreeSnapshot: () => logTreeSnapshot,
   logTreeSummary: () => logTreeSummary,
   markJsxRuntimeActive: () => markJsxRuntimeActive,
@@ -133,6 +134,44 @@ function normalizeJsxSourcePath(fileName) {
   if (/^[a-zA-Z]:[\\/]/.test(p)) p = p[0].toLowerCase() + p.slice(1);
   return p;
 }
+function normalizeStackFramePath(rawPath) {
+  let p = rawPath;
+  const queryIdx = p.indexOf("?");
+  if (queryIdx !== -1) p = p.slice(0, queryIdx);
+  const httpMatch = p.match(/^https?:\/\/[^/]+(\/.+)$/);
+  if (httpMatch) {
+    p = httpMatch[1];
+    if (p.startsWith("/")) p = p.slice(1);
+  }
+  return normalizeJsxSourcePath(p);
+}
+function isJsBundlePath(rawPath) {
+  if (/\bindex\.bundle\b/.test(rawPath)) return true;
+  if (/\.bundle(\?|$|\.js(\?|$))/.test(rawPath)) return true;
+  if (/\?platform=(ios|android|web|native)\b/.test(rawPath)) return true;
+  return false;
+}
+function parseFirstNonReactFrame(stack) {
+  const lines = stack.split("\n");
+  for (const line of lines) {
+    const parened = line.match(/\(([^)]+):(\d+):(\d+)\)/);
+    const hermes = line.match(/@([^\s]+):(\d+):(\d+)$/);
+    const match = parened ?? hermes;
+    if (!match) continue;
+    const path = match[1];
+    if (path.includes("react-dom")) continue;
+    if (path.includes("react-native/Libraries")) continue;
+    if (path.includes("/react/cjs/")) continue;
+    if (path.includes("/scheduler/")) continue;
+    if (isJsBundlePath(path)) continue;
+    return {
+      fileName: normalizeStackFramePath(path),
+      lineNumber: Number(match[2]),
+      columnNumber: Number(match[3])
+    };
+  }
+  return null;
+}
 function computeCallSiteId(source) {
   const normPath = normalizeJsxSourcePath(source.fileName);
   const key = `${normPath}:${source.lineNumber}:${source.columnNumber}`;
@@ -143,16 +182,71 @@ function computeCallSiteId(source) {
   }
   return (hash >>> 0).toString(16).padStart(8, "0");
 }
+var FLOTRACE_SRC_ATTR = "data-flotrace-src";
+function parseDataFlotraceSrc(value) {
+  let obj;
+  try {
+    obj = JSON.parse(value);
+  } catch {
+    return void 0;
+  }
+  if (!obj || typeof obj !== "object") return void 0;
+  const o = obj;
+  if (typeof o.f !== "string" || typeof o.l !== "number" || typeof o.c !== "number") {
+    return void 0;
+  }
+  const fileName = o.f;
+  const lineNumber = o.l;
+  const columnNumber = o.c;
+  return {
+    fileName,
+    lineNumber,
+    columnNumber,
+    callSiteId: computeCallSiteId({ fileName, lineNumber, columnNumber })
+  };
+}
 function readJsxSourceFromFiber(fiber) {
   const props = fiber.memoizedProps;
-  if (!props) return void 0;
-  const raw = props[FLOTRACE_SOURCE];
-  if (!raw || typeof raw !== "object") return void 0;
-  const obj = raw;
-  if (typeof obj.fileName !== "string" || typeof obj.lineNumber !== "number" || typeof obj.columnNumber !== "number" || typeof obj.callSiteId !== "string") {
-    return void 0;
+  if (props) {
+    const symRaw = props[FLOTRACE_SOURCE];
+    if (symRaw && typeof symRaw === "object") {
+      const obj = symRaw;
+      if (typeof obj.fileName === "string" && typeof obj.lineNumber === "number" && typeof obj.columnNumber === "number" && typeof obj.callSiteId === "string") {
+        return symRaw;
+      }
+    }
+    const strRaw = props[FLOTRACE_SRC_ATTR];
+    if (typeof strRaw === "string") {
+      const parsed = parseDataFlotraceSrc(strRaw);
+      if (parsed) return parsed;
+    }
+  }
+  const type = fiber.type;
+  if (type !== null && (typeof type === "function" || typeof type === "object")) {
+    const typeAttr = type[FLOTRACE_SRC_ATTR];
+    if (typeof typeAttr === "string") {
+      const parsed = parseDataFlotraceSrc(typeAttr);
+      if (parsed) return parsed;
+    }
+  }
+  return void 0;
+}
+function isUserComponent(fiber) {
+  const jsxSrc = readJsxSourceFromFiber({
+    memoizedProps: fiber.memoizedProps ?? null,
+    type: fiber.type
+  });
+  if (jsxSrc && !jsxSrc.fileName.includes("node_modules")) return true;
+  const debugSourcePath = fiber._debugSource?.fileName;
+  if (typeof debugSourcePath === "string" && !debugSourcePath.includes("node_modules")) {
+    return true;
+  }
+  const stack = fiber._debugStack?.stack;
+  if (typeof stack === "string") {
+    const frame = parseFirstNonReactFrame(stack);
+    if (frame && !frame.fileName.includes("node_modules")) return true;
   }
-  return raw;
+  return false;
 }
 var callSiteRenders = /* @__PURE__ */ new Map();
 var RING_BUFFER_MAX = 60;
@@ -1716,7 +1810,11 @@ function runAnalysis(tree, fiberRefMap2) {
       }
     }
     for (const sourceId of sourceNodeIds) {
-      let dfs2 = function(currentId, currentPropKey, currentPath, visited) {
+      const firstEdge = outEdges.get(sourceId)?.[0];
+      if (!firstEdge) continue;
+      const sourcePropName = firstEdge.propKey;
+      const allPaths = [];
+      const dfs = (currentId, currentPropKey, currentPath, visited) => {
         if (visited.has(currentId)) return;
         visited.add(currentId);
         const outgoing = outEdges.get(currentId);
@@ -1729,7 +1827,7 @@ function runAnalysis(tree, fiberRefMap2) {
         }
         for (const edge of outgoing) {
           const isRename = edge.propKey !== edge.childPropKey;
-          dfs2(
+          dfs(
             edge.childNodeId,
             edge.childPropKey,
             [...currentPath, { nodeId: edge.childNodeId, propKey: edge.childPropKey, isRename }],
@@ -1738,12 +1836,7 @@ function runAnalysis(tree, fiberRefMap2) {
         }
         visited.delete(currentId);
       };
-      var dfs = dfs2;
-      const firstEdge = outEdges.get(sourceId)?.[0];
-      if (!firstEdge) continue;
-      const sourcePropName = firstEdge.propKey;
-      const allPaths = [];
-      dfs2(
+      dfs(
         sourceId,
         sourcePropName,
         [{ nodeId: sourceId, propKey: sourcePropName, isRename: false }],
@@ -2633,7 +2726,7 @@ function getComponentName2(fiber) {
   }
   return "Unknown";
 }
-function isUserComponent(fiber) {
+function isLikelyUserComponent(fiber) {
   if (!USER_COMPONENT_TAGS.has(fiber.tag)) return false;
   const name = getComponentName2(fiber);
   if (name === "Anonymous" || name === "Unknown" || name === "ForwardRef" || name === "Memo")
@@ -2737,17 +2830,28 @@ var FRAMEWORK_PATH_PATTERNS = [
   /react-hook-form/,
   /formik/
 ];
-function resolveEffectiveSourcePath(fiber) {
+function resolveEffectiveSourceLocation(fiber) {
   const jsxSrc = readJsxSourceFromFiber(fiber);
-  if (jsxSrc) return jsxSrc.fileName;
-  if (fiber._debugSource?.fileName) return fiber._debugSource.fileName;
+  if (jsxSrc) {
+    return {
+      fileName: jsxSrc.fileName,
+      lineNumber: jsxSrc.lineNumber,
+      columnNumber: jsxSrc.columnNumber
+    };
+  }
+  if (fiber._debugSource?.fileName) {
+    return {
+      fileName: fiber._debugSource.fileName,
+      lineNumber: fiber._debugSource.lineNumber
+    };
+  }
   const ownerHit = walkAncestors(
     fiber._debugOwner ?? null,
     3,
     (f) => f._debugOwner ?? null,
     (cur) => cur._debugSource?.fileName ?? void 0
   );
-  if (ownerHit) return ownerHit;
+  if (ownerHit) return { fileName: ownerHit };
   const stack = fiber._debugStack?.stack;
   if (typeof stack === "string") {
     const parsed = parseFirstNonReactFrame(stack);
@@ -2755,7 +2859,11 @@ function resolveEffectiveSourcePath(fiber) {
   }
   return null;
 }
+function resolveEffectiveSourcePath(fiber) {
+  return resolveEffectiveSourceLocation(fiber)?.fileName ?? null;
+}
 function resolveSourceConfidence(fiber, isFramework, isLibrary, precomputedJsxSource) {
+  if (isUserComponent(fiber)) return "exact";
   if (isFramework || isLibrary) return "package";
   const jsxSrc = precomputedJsxSource ?? readJsxSourceFromFiber(fiber);
   if (jsxSrc) return "exact";
@@ -2773,22 +2881,8 @@ function walkAncestors(start, maxHops, next, visit) {
   }
   return void 0;
 }
-function parseFirstNonReactFrame(stack) {
-  const lines = stack.split("\n");
-  for (const line of lines) {
-    const parened = line.match(/\(([^)]+):\d+:\d+\)/);
-    const hermes = line.match(/@([^\s]+):\d+:\d+$/);
-    const path = parened?.[1] ?? hermes?.[1];
-    if (!path) continue;
-    if (path.includes("react-dom")) continue;
-    if (path.includes("react-native/Libraries")) continue;
-    if (path.includes("/react/cjs/")) continue;
-    if (path.includes("/scheduler/")) continue;
-    return path;
-  }
-  return null;
-}
 function isFrameworkComponent(fiber, name) {
+  if (isUserComponent(fiber)) return false;
   if (walkerFilterConfig.frameworkNames.has(name)) return true;
   for (const pattern of walkerFilterConfig.frameworkNamePatterns) {
     if (pattern.test(name)) return true;
@@ -2828,6 +2922,7 @@ var KNOWN_LIBRARY_NAMES = /* @__PURE__ */ new Map([
   ["HeroIcon", "heroicons"]
 ]);
 function detectLibraryName(fiber, name) {
+  if (isUserComponent(fiber)) return void 0;
   if (name.includes(".")) {
     return name.split(".")[0].toLowerCase();
   }
@@ -2898,7 +2993,7 @@ function resolveEffectiveReactKey(fiber) {
     6,
     (f) => f.return ?? null,
     (cur) => {
-      if (isUserComponent(cur) && !isFrameworkComponent(cur, getComponentName2(cur))) {
+      if (isLikelyUserComponent(cur) && !isFrameworkComponent(cur, getComponentName2(cur))) {
         return STOP_WALK;
       }
       return typeof cur.key === "string" ? cur.key : void 0;
@@ -2914,7 +3009,7 @@ function walkFiber(fiber, parentId, sharedNameCountMap, depth = 0, inSuspenseFal
   while (current) {
     try {
       const tag = current.tag;
-      if (isUserComponent(current)) {
+      if (isLikelyUserComponent(current)) {
         const name = getComponentName2(current);
         const nameCount = nameCountMap.get(name) || 0;
         nameCountMap.set(name, nameCount + 1);
@@ -2944,6 +3039,8 @@ function walkFiber(fiber, parentId, sharedNameCountMap, depth = 0, inSuspenseFal
           libraryName !== void 0,
           jsxSource
         );
+        const needsStackFallback = (jsxSource?.fileName ?? current._debugSource?.fileName) === void 0 || (jsxSource?.lineNumber ?? current._debugSource?.lineNumber) === void 0;
+        const stackLocation = needsStackFallback ? resolveEffectiveSourceLocation(current) : null;
         const node = {
           id: nodeId,
           name,
@@ -2952,8 +3049,8 @@ function walkFiber(fiber, parentId, sharedNameCountMap, depth = 0, inSuspenseFal
           renderPhase,
           renderReason,
           renderDuration: current.actualDuration,
-          filePath: jsxSource?.fileName ?? current._debugSource?.fileName,
-          lineNumber: jsxSource?.lineNumber ?? current._debugSource?.lineNumber,
+          filePath: jsxSource?.fileName ?? current._debugSource?.fileName ?? stackLocation?.fileName,
+          lineNumber: jsxSource?.lineNumber ?? current._debugSource?.lineNumber ?? stackLocation?.lineNumber,
           isFramework: framework,
           reactKey: resolveEffectiveReactKey(current),
           queryHashes,
@@ -4789,6 +4886,7 @@ function detectWebFramework() {
   isJsxRuntimeActive,
   isReduxStore,
   isTanStackQueryClient,
+  isUserComponent,
   logTreeSnapshot,
   logTreeSummary,
   markJsxRuntimeActive,

package/dist/index.mjs

@@ -8,12 +8,14 @@ import {
   getCallSiteRenderRate,
   getCallSiteRenders,
   isJsxRuntimeActive,
+  isUserComponent,
   markJsxRuntimeActive,
   normalizeJsxSourcePath,
+  parseFirstNonReactFrame,
   readJsxSourceFromFiber,
   recordCallSiteRender,
   setDuplicateKeyEmitter
-} from "./chunk-QLOJU5F2.mjs";
+} from "./chunk-5LSFLPGP.mjs";
 
 // src/types.ts
 var DEFAULT_CONFIG = {
@@ -1510,7 +1512,11 @@ function runAnalysis(tree, fiberRefMap2) {
       }
     }
     for (const sourceId of sourceNodeIds) {
-      let dfs2 = function(currentId, currentPropKey, currentPath, visited) {
+      const firstEdge = outEdges.get(sourceId)?.[0];
+      if (!firstEdge) continue;
+      const sourcePropName = firstEdge.propKey;
+      const allPaths = [];
+      const dfs = (currentId, currentPropKey, currentPath, visited) => {
         if (visited.has(currentId)) return;
         visited.add(currentId);
         const outgoing = outEdges.get(currentId);
@@ -1523,7 +1529,7 @@ function runAnalysis(tree, fiberRefMap2) {
         }
         for (const edge of outgoing) {
           const isRename = edge.propKey !== edge.childPropKey;
-          dfs2(
+          dfs(
             edge.childNodeId,
             edge.childPropKey,
             [...currentPath, { nodeId: edge.childNodeId, propKey: edge.childPropKey, isRename }],
@@ -1532,12 +1538,7 @@ function runAnalysis(tree, fiberRefMap2) {
         }
         visited.delete(currentId);
       };
-      var dfs = dfs2;
-      const firstEdge = outEdges.get(sourceId)?.[0];
-      if (!firstEdge) continue;
-      const sourcePropName = firstEdge.propKey;
-      const allPaths = [];
-      dfs2(
+      dfs(
         sourceId,
         sourcePropName,
         [{ nodeId: sourceId, propKey: sourcePropName, isRename: false }],
@@ -2427,7 +2428,7 @@ function getComponentName2(fiber) {
   }
   return "Unknown";
 }
-function isUserComponent(fiber) {
+function isLikelyUserComponent(fiber) {
   if (!USER_COMPONENT_TAGS.has(fiber.tag)) return false;
   const name = getComponentName2(fiber);
   if (name === "Anonymous" || name === "Unknown" || name === "ForwardRef" || name === "Memo")
@@ -2531,17 +2532,28 @@ var FRAMEWORK_PATH_PATTERNS = [
   /react-hook-form/,
   /formik/
 ];
-function resolveEffectiveSourcePath(fiber) {
+function resolveEffectiveSourceLocation(fiber) {
   const jsxSrc = readJsxSourceFromFiber(fiber);
-  if (jsxSrc) return jsxSrc.fileName;
-  if (fiber._debugSource?.fileName) return fiber._debugSource.fileName;
+  if (jsxSrc) {
+    return {
+      fileName: jsxSrc.fileName,
+      lineNumber: jsxSrc.lineNumber,
+      columnNumber: jsxSrc.columnNumber
+    };
+  }
+  if (fiber._debugSource?.fileName) {
+    return {
+      fileName: fiber._debugSource.fileName,
+      lineNumber: fiber._debugSource.lineNumber
+    };
+  }
   const ownerHit = walkAncestors(
     fiber._debugOwner ?? null,
     3,
     (f) => f._debugOwner ?? null,
     (cur) => cur._debugSource?.fileName ?? void 0
   );
-  if (ownerHit) return ownerHit;
+  if (ownerHit) return { fileName: ownerHit };
   const stack = fiber._debugStack?.stack;
   if (typeof stack === "string") {
     const parsed = parseFirstNonReactFrame(stack);
@@ -2549,7 +2561,11 @@ function resolveEffectiveSourcePath(fiber) {
   }
   return null;
 }
+function resolveEffectiveSourcePath(fiber) {
+  return resolveEffectiveSourceLocation(fiber)?.fileName ?? null;
+}
 function resolveSourceConfidence(fiber, isFramework, isLibrary, precomputedJsxSource) {
+  if (isUserComponent(fiber)) return "exact";
   if (isFramework || isLibrary) return "package";
   const jsxSrc = precomputedJsxSource ?? readJsxSourceFromFiber(fiber);
   if (jsxSrc) return "exact";
@@ -2567,22 +2583,8 @@ function walkAncestors(start, maxHops, next, visit) {
   }
   return void 0;
 }
-function parseFirstNonReactFrame(stack) {
-  const lines = stack.split("\n");
-  for (const line of lines) {
-    const parened = line.match(/\(([^)]+):\d+:\d+\)/);
-    const hermes = line.match(/@([^\s]+):\d+:\d+$/);
-    const path = parened?.[1] ?? hermes?.[1];
-    if (!path) continue;
-    if (path.includes("react-dom")) continue;
-    if (path.includes("react-native/Libraries")) continue;
-    if (path.includes("/react/cjs/")) continue;
-    if (path.includes("/scheduler/")) continue;
-    return path;
-  }
-  return null;
-}
 function isFrameworkComponent(fiber, name) {
+  if (isUserComponent(fiber)) return false;
   if (walkerFilterConfig.frameworkNames.has(name)) return true;
   for (const pattern of walkerFilterConfig.frameworkNamePatterns) {
     if (pattern.test(name)) return true;
@@ -2622,6 +2624,7 @@ var KNOWN_LIBRARY_NAMES = /* @__PURE__ */ new Map([
   ["HeroIcon", "heroicons"]
 ]);
 function detectLibraryName(fiber, name) {
+  if (isUserComponent(fiber)) return void 0;
   if (name.includes(".")) {
     return name.split(".")[0].toLowerCase();
   }
@@ -2692,7 +2695,7 @@ function resolveEffectiveReactKey(fiber) {
     6,
     (f) => f.return ?? null,
     (cur) => {
-      if (isUserComponent(cur) && !isFrameworkComponent(cur, getComponentName2(cur))) {
+      if (isLikelyUserComponent(cur) && !isFrameworkComponent(cur, getComponentName2(cur))) {
         return STOP_WALK;
       }
       return typeof cur.key === "string" ? cur.key : void 0;
@@ -2708,7 +2711,7 @@ function walkFiber(fiber, parentId, sharedNameCountMap, depth = 0, inSuspenseFal
   while (current) {
     try {
       const tag = current.tag;
-      if (isUserComponent(current)) {
+      if (isLikelyUserComponent(current)) {
         const name = getComponentName2(current);
         const nameCount = nameCountMap.get(name) || 0;
         nameCountMap.set(name, nameCount + 1);
@@ -2738,6 +2741,8 @@ function walkFiber(fiber, parentId, sharedNameCountMap, depth = 0, inSuspenseFal
           libraryName !== void 0,
           jsxSource
         );
+        const needsStackFallback = (jsxSource?.fileName ?? current._debugSource?.fileName) === void 0 || (jsxSource?.lineNumber ?? current._debugSource?.lineNumber) === void 0;
+        const stackLocation = needsStackFallback ? resolveEffectiveSourceLocation(current) : null;
         const node = {
           id: nodeId,
           name,
@@ -2746,8 +2751,8 @@ function walkFiber(fiber, parentId, sharedNameCountMap, depth = 0, inSuspenseFal
           renderPhase,
           renderReason,
           renderDuration: current.actualDuration,
-          filePath: jsxSource?.fileName ?? current._debugSource?.fileName,
-          lineNumber: jsxSource?.lineNumber ?? current._debugSource?.lineNumber,
+          filePath: jsxSource?.fileName ?? current._debugSource?.fileName ?? stackLocation?.fileName,
+          lineNumber: jsxSource?.lineNumber ?? current._debugSource?.lineNumber ?? stackLocation?.lineNumber,
           isFramework: framework,
           reactKey: resolveEffectiveReactKey(current),
           queryHashes,
@@ -4582,6 +4587,7 @@ export {
   isJsxRuntimeActive,
   isReduxStore,
   isTanStackQueryClient,
+  isUserComponent,
   logTreeSnapshot,
   logTreeSummary,
   markJsxRuntimeActive,

package/dist/jsx-dev-runtime.mjs

@@ -6,7 +6,7 @@ import {
   normalizeJsxSourcePath,
   recordCallSiteRender,
   recordJsxKey
-} from "./chunk-QLOJU5F2.mjs";
+} from "./chunk-5LSFLPGP.mjs";
 
 // src/jsx-dev-runtime.ts
 import { jsxDEV as origJsxDEV, Fragment } from "react/jsx-dev-runtime";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flotrace/runtime-core",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "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",
@@ -20,11 +20,17 @@
       "types": "./dist/jsx-dev-runtime.d.ts",
       "import": "./dist/jsx-dev-runtime.mjs",
       "require": "./dist/jsx-dev-runtime.js"
+    },
+    "./babel-plugin": {
+      "types": "./babel-plugin.d.ts",
+      "default": "./babel-plugin.js"
     }
   },
   "sideEffects": false,
   "files": [
     "dist",
+    "babel-plugin.js",
+    "babel-plugin.d.ts",
     "LICENSE",
     "README.md"
   ],