@flareapp/react 2.6.0 → 2.8.0

package/dist/inject.d.mts

@@ -1,2 +1,2 @@
-import { a as FlareErrorBoundaryFallbackProps, c as FlareReactContext, i as FlareErrorBoundary, l as MinifiedReactError, n as FlareReactErrorHandlerOptions, o as FlareErrorBoundaryProps, r as flareReactErrorHandler, s as ComponentStackFrame, t as FlareReactErrorHandlerCallback } from "./flareReactErrorHandler-BcVYRMtC.mjs";
+import { a as FlareErrorBoundaryFallbackProps, c as FlareReactContext, i as FlareErrorBoundary, l as MinifiedReactError, n as FlareReactErrorHandlerOptions, o as FlareErrorBoundaryProps, r as flareReactErrorHandler, s as ComponentStackFrame, t as FlareReactErrorHandlerCallback } from "./flareReactErrorHandler-Ce0sCyMK.mjs";
 export { type ComponentStackFrame, FlareErrorBoundary, type FlareErrorBoundaryFallbackProps, type FlareErrorBoundaryProps, type FlareReactContext, type FlareReactErrorHandlerCallback, type FlareReactErrorHandlerOptions, type MinifiedReactError, flareReactErrorHandler };

package/dist/inject.mjs

@@ -1,3 +1,3 @@
-import { n as FlareErrorBoundary, t as flareReactErrorHandler } from "./flareReactErrorHandler-CfcBSmhG.mjs";
+import { n as FlareErrorBoundary, t as flareReactErrorHandler } from "./flareReactErrorHandler-sRmFoJAG.mjs";
 
 export { FlareErrorBoundary, flareReactErrorHandler };

package/dist/profiler.cjs

@@ -0,0 +1,63 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_flareReactErrorHandler = require('./flareReactErrorHandler-DBmb7u7U.cjs');
+let react = require("react");
+let _flareapp_js_browser = require("@flareapp/js/browser");
+
+//#region src/profiler.ts
+const useMountEffect = typeof window === "undefined" ? react.useEffect : react.useLayoutEffect;
+const FlareProfilerContext = (0, react.createContext)(null);
+/** Records one `browser_component` span for its mount, nested under the nearest profiled ancestor
+*  or the active `browser_pageload` / `browser_navigation` root. */
+function FlareProfiler({ name, children }) {
+	const context = (0, react.useContext)(FlareProfilerContext);
+	const parentRef = (0, react.useRef)(void 0);
+	if (parentRef.current === void 0) try {
+		parentRef.current = (0, _flareapp_js_browser.resolveComponentParent)(context, (0, _flareapp_js_browser.activeComponentRoot)());
+	} catch {
+		parentRef.current = null;
+	}
+	const parent = parentRef.current;
+	const ownRef = (0, react.useRef)(null);
+	if (parent && ownRef.current === null) try {
+		const spanId = (0, _flareapp_js_browser.reserveSpanId)(parent.traceId);
+		ownRef.current = spanId ? {
+			spanId,
+			startNano: (0, _flareapp_js_browser.nowNano)()
+		} : null;
+	} catch {}
+	const providedRef = (0, react.useRef)(void 0);
+	if (providedRef.current === void 0) providedRef.current = parent && ownRef.current ? {
+		traceId: parent.traceId,
+		parentSpanId: ownRef.current.spanId
+	} : null;
+	const hasRecorded = (0, react.useRef)(false);
+	useMountEffect(() => {
+		const own = ownRef.current;
+		if (!parent || !own || hasRecorded.current) return;
+		hasRecorded.current = true;
+		try {
+			(0, _flareapp_js_browser.recordComponentSpan)({
+				name,
+				spanId: own.spanId,
+				parent,
+				startTimeUnixNano: own.startNano,
+				endTimeUnixNano: (0, _flareapp_js_browser.nowNano)()
+			});
+		} catch {}
+	}, []);
+	if (providedRef.current === null) return children ?? null;
+	return (0, react.createElement)(FlareProfilerContext.Provider, { value: providedRef.current }, children ?? null);
+}
+/** Wraps `Component` in a `FlareProfiler`. Name it explicitly when the component is anonymous or minified. */
+function withFlareProfiler(Component, options) {
+	const name = options?.name || Component.displayName || Component.name || "Unknown";
+	function Profiled(props) {
+		return (0, react.createElement)(FlareProfiler, { name }, (0, react.createElement)(Component, props));
+	}
+	Profiled.displayName = `withFlareProfiler(${name})`;
+	return Profiled;
+}
+
+//#endregion
+exports.FlareProfiler = FlareProfiler;
+exports.withFlareProfiler = withFlareProfiler;

package/dist/profiler.d.cts

@@ -0,0 +1,19 @@
+import { ComponentType, FunctionComponent, ReactNode } from "react";
+
+//#region src/profiler.d.ts
+type FlareProfilerProps = {
+  /** The span's name, as it appears in the trace. */name: string;
+  children?: ReactNode;
+};
+/** Records one `browser_component` span for its mount, nested under the nearest profiled ancestor
+ *  or the active `browser_pageload` / `browser_navigation` root. */
+declare function FlareProfiler({
+  name,
+  children
+}: FlareProfilerProps): ReactNode;
+/** Wraps `Component` in a `FlareProfiler`. Name it explicitly when the component is anonymous or minified. */
+declare function withFlareProfiler<P extends object>(Component: ComponentType<P>, options?: {
+  name?: string;
+}): FunctionComponent<P>;
+//#endregion
+export { FlareProfiler, FlareProfilerProps, withFlareProfiler };

package/dist/profiler.d.mts

@@ -0,0 +1,19 @@
+import { ComponentType, FunctionComponent, ReactNode } from "react";
+
+//#region src/profiler.d.ts
+type FlareProfilerProps = {
+  /** The span's name, as it appears in the trace. */name: string;
+  children?: ReactNode;
+};
+/** Records one `browser_component` span for its mount, nested under the nearest profiled ancestor
+ *  or the active `browser_pageload` / `browser_navigation` root. */
+declare function FlareProfiler({
+  name,
+  children
+}: FlareProfilerProps): ReactNode;
+/** Wraps `Component` in a `FlareProfiler`. Name it explicitly when the component is anonymous or minified. */
+declare function withFlareProfiler<P extends object>(Component: ComponentType<P>, options?: {
+  name?: string;
+}): FunctionComponent<P>;
+//#endregion
+export { FlareProfiler, FlareProfilerProps, withFlareProfiler };

package/dist/profiler.mjs

@@ -0,0 +1,60 @@
+import { createContext, createElement, useContext, useEffect, useLayoutEffect, useRef } from "react";
+import { activeComponentRoot, nowNano, recordComponentSpan, reserveSpanId, resolveComponentParent } from "@flareapp/js/browser";
+
+//#region src/profiler.ts
+const useMountEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
+const FlareProfilerContext = createContext(null);
+/** Records one `browser_component` span for its mount, nested under the nearest profiled ancestor
+*  or the active `browser_pageload` / `browser_navigation` root. */
+function FlareProfiler({ name, children }) {
+	const context = useContext(FlareProfilerContext);
+	const parentRef = useRef(void 0);
+	if (parentRef.current === void 0) try {
+		parentRef.current = resolveComponentParent(context, activeComponentRoot());
+	} catch {
+		parentRef.current = null;
+	}
+	const parent = parentRef.current;
+	const ownRef = useRef(null);
+	if (parent && ownRef.current === null) try {
+		const spanId = reserveSpanId(parent.traceId);
+		ownRef.current = spanId ? {
+			spanId,
+			startNano: nowNano()
+		} : null;
+	} catch {}
+	const providedRef = useRef(void 0);
+	if (providedRef.current === void 0) providedRef.current = parent && ownRef.current ? {
+		traceId: parent.traceId,
+		parentSpanId: ownRef.current.spanId
+	} : null;
+	const hasRecorded = useRef(false);
+	useMountEffect(() => {
+		const own = ownRef.current;
+		if (!parent || !own || hasRecorded.current) return;
+		hasRecorded.current = true;
+		try {
+			recordComponentSpan({
+				name,
+				spanId: own.spanId,
+				parent,
+				startTimeUnixNano: own.startNano,
+				endTimeUnixNano: nowNano()
+			});
+		} catch {}
+	}, []);
+	if (providedRef.current === null) return children ?? null;
+	return createElement(FlareProfilerContext.Provider, { value: providedRef.current }, children ?? null);
+}
+/** Wraps `Component` in a `FlareProfiler`. Name it explicitly when the component is anonymous or minified. */
+function withFlareProfiler(Component, options) {
+	const name = options?.name || Component.displayName || Component.name || "Unknown";
+	function Profiled(props) {
+		return createElement(FlareProfiler, { name }, createElement(Component, props));
+	}
+	Profiled.displayName = `withFlareProfiler(${name})`;
+	return Profiled;
+}
+
+//#endregion
+export { FlareProfiler, withFlareProfiler };

package/dist/react-router.cjs

@@ -0,0 +1,94 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_flareReactErrorHandler = require('./flareReactErrorHandler-DBmb7u7U.cjs');
+let _flareapp_js_browser = require("@flareapp/js/browser");
+
+//#region src/react-router.ts
+/**
+* Rebuild the parameterized template (`/product/:id`) by joining each match's declared `route.path`.
+* Follows Sentry's getNormalizedName, but reads the router's already-resolved `state.matches` rather
+* than matching again.
+*/
+function routeNameFromMatches(matches) {
+	if (!matches || matches.length === 0) return;
+	let path = "";
+	for (const match of matches) {
+		const routePath = match.route?.path;
+		if (!routePath) continue;
+		path = routePath[0] === "/" ? routePath : (path.endsWith("/") ? path : path + "/") + routePath;
+	}
+	if (!path) return;
+	if (path[0] !== "/") path = "/" + path;
+	return path.replace(/\/{2,}/g, "/");
+}
+/**
+* Trace a React Router v7 data router (createBrowserRouter / createHashRouter / createMemoryRouter):
+* name the browser_pageload root from the initial route, and open a parameterized, held
+* browser_navigation root per route change, named once the router settles. Returns a cleanup that
+* unsubscribes and unregisters. Safe to call before or after tracing is enabled; no-ops when off.
+* Calling it twice on the same router replaces the first instrumentation.
+*/
+function traceReactRouter(router) {
+	if (typeof router?.subscribe !== "function") return () => {};
+	return (0, _flareapp_js_browser.instrumentOnce)(router, (track) => install(router, track));
+}
+function install(router, track) {
+	const nav = (0, _flareapp_js_browser.registerNavigationSource)();
+	track(() => nav.unregister());
+	function routeNameFor(state) {
+		return (0, _flareapp_js_browser.routeName)(() => routeNameFromMatches(state.matches), state.location.pathname, hrefOf(state.location));
+	}
+	function hrefOf(loc) {
+		return (0, _flareapp_js_browser.resolveHref)(() => router.createHref?.(loc), keyOf(loc));
+	}
+	function keyOf(loc) {
+		return (loc.pathname || "") + (loc.search || "") + (loc.hash || "");
+	}
+	let sawInitialSettle = false;
+	let inFlight = false;
+	let lastLocationKey = keyOf(router.state.location);
+	try {
+		if (router.state.matches.length > 0) nav.setActiveRouteName(routeNameFor(router.state));
+		sawInitialSettle = router.state.initialized === true;
+	} catch {}
+	function onState(state) {
+		if (!sawInitialSettle) {
+			lastLocationKey = keyOf(state.location);
+			if (state.matches.length > 0) nav.setActiveRouteName(routeNameFor(state));
+			if (state.initialized) sawInitialSettle = true;
+			return;
+		}
+		const navState = state.navigation.state;
+		if (!inFlight && navState !== "idle") {
+			inFlight = true;
+			const destination = state.navigation.location ?? state.location;
+			nav.startNavigation({
+				path: destination.pathname,
+				url: hrefOf(destination),
+				hold: true
+			});
+			return;
+		}
+		if (inFlight && navState === "idle") {
+			inFlight = false;
+			lastLocationKey = keyOf(state.location);
+			nav.settleNavigation(routeNameFor(state));
+			return;
+		}
+		if (!inFlight && navState === "idle") {
+			const locationKey = keyOf(state.location);
+			if (locationKey !== lastLocationKey) {
+				lastLocationKey = locationKey;
+				nav.startNavigation({
+					path: state.location.pathname,
+					url: hrefOf(state.location)
+				});
+				nav.settleNavigation(routeNameFor(state));
+			}
+		}
+	}
+	track(router.subscribe((0, _flareapp_js_browser.insulate)(onState)));
+}
+
+//#endregion
+exports.routeNameFromMatches = routeNameFromMatches;
+exports.traceReactRouter = traceReactRouter;

package/dist/react-router.d.cts

@@ -0,0 +1,54 @@
+//#region src/vendor/reactRouterTypes.d.ts
+type ReactRouterLocationLike = {
+  pathname: string;
+  search?: string;
+  hash?: string;
+  state?: unknown;
+};
+type ReactRouterRouteLike = {
+  path?: string;
+  index?: boolean;
+  id?: string;
+};
+type ReactRouterMatchLike = {
+  route: ReactRouterRouteLike;
+  pathname: string;
+  params?: Record<string, string | undefined>;
+};
+type ReactRouterNavigationLike = {
+  state: 'idle' | 'loading' | 'submitting';
+  location?: ReactRouterLocationLike;
+};
+type ReactRouterStateLike = {
+  location: ReactRouterLocationLike;
+  matches: ReactRouterMatchLike[];
+  navigation: ReactRouterNavigationLike;
+  initialized?: boolean;
+};
+type ReactRouterLike = {
+  subscribe(cb: (state: ReactRouterStateLike) => void): () => void;
+  state: ReactRouterStateLike;
+  /**
+   * Applies the router's `basename` (and, for a hash router, the `#` prefix) to a location.
+   * `state.location.pathname` has both stripped. Optional so a hand-built router still types.
+   */
+  createHref?(location: ReactRouterLocationLike): string;
+};
+//#endregion
+//#region src/react-router.d.ts
+/**
+ * Rebuild the parameterized template (`/product/:id`) by joining each match's declared `route.path`.
+ * Follows Sentry's getNormalizedName, but reads the router's already-resolved `state.matches` rather
+ * than matching again.
+ */
+declare function routeNameFromMatches(matches: ReactRouterMatchLike[] | undefined): string | undefined;
+/**
+ * Trace a React Router v7 data router (createBrowserRouter / createHashRouter / createMemoryRouter):
+ * name the browser_pageload root from the initial route, and open a parameterized, held
+ * browser_navigation root per route change, named once the router settles. Returns a cleanup that
+ * unsubscribes and unregisters. Safe to call before or after tracing is enabled; no-ops when off.
+ * Calling it twice on the same router replaces the first instrumentation.
+ */
+declare function traceReactRouter(router: ReactRouterLike): () => void;
+//#endregion
+export { type ReactRouterLike, type ReactRouterLocationLike, type ReactRouterMatchLike, type ReactRouterNavigationLike, type ReactRouterRouteLike, type ReactRouterStateLike, routeNameFromMatches, traceReactRouter };

package/dist/react-router.d.mts

@@ -0,0 +1,54 @@
+//#region src/vendor/reactRouterTypes.d.ts
+type ReactRouterLocationLike = {
+  pathname: string;
+  search?: string;
+  hash?: string;
+  state?: unknown;
+};
+type ReactRouterRouteLike = {
+  path?: string;
+  index?: boolean;
+  id?: string;
+};
+type ReactRouterMatchLike = {
+  route: ReactRouterRouteLike;
+  pathname: string;
+  params?: Record<string, string | undefined>;
+};
+type ReactRouterNavigationLike = {
+  state: 'idle' | 'loading' | 'submitting';
+  location?: ReactRouterLocationLike;
+};
+type ReactRouterStateLike = {
+  location: ReactRouterLocationLike;
+  matches: ReactRouterMatchLike[];
+  navigation: ReactRouterNavigationLike;
+  initialized?: boolean;
+};
+type ReactRouterLike = {
+  subscribe(cb: (state: ReactRouterStateLike) => void): () => void;
+  state: ReactRouterStateLike;
+  /**
+   * Applies the router's `basename` (and, for a hash router, the `#` prefix) to a location.
+   * `state.location.pathname` has both stripped. Optional so a hand-built router still types.
+   */
+  createHref?(location: ReactRouterLocationLike): string;
+};
+//#endregion
+//#region src/react-router.d.ts
+/**
+ * Rebuild the parameterized template (`/product/:id`) by joining each match's declared `route.path`.
+ * Follows Sentry's getNormalizedName, but reads the router's already-resolved `state.matches` rather
+ * than matching again.
+ */
+declare function routeNameFromMatches(matches: ReactRouterMatchLike[] | undefined): string | undefined;
+/**
+ * Trace a React Router v7 data router (createBrowserRouter / createHashRouter / createMemoryRouter):
+ * name the browser_pageload root from the initial route, and open a parameterized, held
+ * browser_navigation root per route change, named once the router settles. Returns a cleanup that
+ * unsubscribes and unregisters. Safe to call before or after tracing is enabled; no-ops when off.
+ * Calling it twice on the same router replaces the first instrumentation.
+ */
+declare function traceReactRouter(router: ReactRouterLike): () => void;
+//#endregion
+export { type ReactRouterLike, type ReactRouterLocationLike, type ReactRouterMatchLike, type ReactRouterNavigationLike, type ReactRouterRouteLike, type ReactRouterStateLike, routeNameFromMatches, traceReactRouter };

package/dist/react-router.mjs

@@ -0,0 +1,91 @@
+import { instrumentOnce, insulate, registerNavigationSource, resolveHref, routeName } from "@flareapp/js/browser";
+
+//#region src/react-router.ts
+/**
+* Rebuild the parameterized template (`/product/:id`) by joining each match's declared `route.path`.
+* Follows Sentry's getNormalizedName, but reads the router's already-resolved `state.matches` rather
+* than matching again.
+*/
+function routeNameFromMatches(matches) {
+	if (!matches || matches.length === 0) return;
+	let path = "";
+	for (const match of matches) {
+		const routePath = match.route?.path;
+		if (!routePath) continue;
+		path = routePath[0] === "/" ? routePath : (path.endsWith("/") ? path : path + "/") + routePath;
+	}
+	if (!path) return;
+	if (path[0] !== "/") path = "/" + path;
+	return path.replace(/\/{2,}/g, "/");
+}
+/**
+* Trace a React Router v7 data router (createBrowserRouter / createHashRouter / createMemoryRouter):
+* name the browser_pageload root from the initial route, and open a parameterized, held
+* browser_navigation root per route change, named once the router settles. Returns a cleanup that
+* unsubscribes and unregisters. Safe to call before or after tracing is enabled; no-ops when off.
+* Calling it twice on the same router replaces the first instrumentation.
+*/
+function traceReactRouter(router) {
+	if (typeof router?.subscribe !== "function") return () => {};
+	return instrumentOnce(router, (track) => install(router, track));
+}
+function install(router, track) {
+	const nav = registerNavigationSource();
+	track(() => nav.unregister());
+	function routeNameFor(state) {
+		return routeName(() => routeNameFromMatches(state.matches), state.location.pathname, hrefOf(state.location));
+	}
+	function hrefOf(loc) {
+		return resolveHref(() => router.createHref?.(loc), keyOf(loc));
+	}
+	function keyOf(loc) {
+		return (loc.pathname || "") + (loc.search || "") + (loc.hash || "");
+	}
+	let sawInitialSettle = false;
+	let inFlight = false;
+	let lastLocationKey = keyOf(router.state.location);
+	try {
+		if (router.state.matches.length > 0) nav.setActiveRouteName(routeNameFor(router.state));
+		sawInitialSettle = router.state.initialized === true;
+	} catch {}
+	function onState(state) {
+		if (!sawInitialSettle) {
+			lastLocationKey = keyOf(state.location);
+			if (state.matches.length > 0) nav.setActiveRouteName(routeNameFor(state));
+			if (state.initialized) sawInitialSettle = true;
+			return;
+		}
+		const navState = state.navigation.state;
+		if (!inFlight && navState !== "idle") {
+			inFlight = true;
+			const destination = state.navigation.location ?? state.location;
+			nav.startNavigation({
+				path: destination.pathname,
+				url: hrefOf(destination),
+				hold: true
+			});
+			return;
+		}
+		if (inFlight && navState === "idle") {
+			inFlight = false;
+			lastLocationKey = keyOf(state.location);
+			nav.settleNavigation(routeNameFor(state));
+			return;
+		}
+		if (!inFlight && navState === "idle") {
+			const locationKey = keyOf(state.location);
+			if (locationKey !== lastLocationKey) {
+				lastLocationKey = locationKey;
+				nav.startNavigation({
+					path: state.location.pathname,
+					url: hrefOf(state.location)
+				});
+				nav.settleNavigation(routeNameFor(state));
+			}
+		}
+	}
+	track(router.subscribe(insulate(onState)));
+}
+
+//#endregion
+export { routeNameFromMatches, traceReactRouter };

package/dist/tanstack-router.cjs

@@ -0,0 +1,89 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_flareReactErrorHandler = require('./flareReactErrorHandler-DBmb7u7U.cjs');
+let _flareapp_js_browser = require("@flareapp/js/browser");
+
+//#region src/tanstack-router.ts
+/**
+* How long a held navigation root waits for `onResolved` before settling itself. Exported so the suite
+* drives it instead of hardcoding the number; not part of the supported surface.
+*/
+const STALE_NAVIGATION_TIMEOUT_MS = 5e3;
+/**
+* Trace a TanStack Router instance: name the `browser_pageload` root from the
+* initial route and open a parameterized `browser_navigation` root per route
+* change. Returns a cleanup that unsubscribes and unregisters. Safe to call
+* before or after tracing is enabled; no-ops when tracing is off. Calling it
+* twice on the same router replaces the first instrumentation rather than
+* stacking a second set of subscriptions.
+*/
+function traceTanStackRouter(router) {
+	if (typeof router?.subscribe !== "function") return () => {};
+	return (0, _flareapp_js_browser.instrumentOnce)(router, (track) => install(router, track));
+}
+function install(router, track) {
+	const nav = (0, _flareapp_js_browser.registerNavigationSource)();
+	track(() => nav.unregister());
+	function hrefOf(loc) {
+		return (0, _flareapp_js_browser.resolveHref)(() => loc.publicHref ?? loc.href, loc.pathname);
+	}
+	function routeNameFor(loc) {
+		return (0, _flareapp_js_browser.routeName)(() => {
+			const matches = router.matchRoutes(loc.pathname, loc.search, {
+				preload: false,
+				throwOnError: false
+			});
+			if (!matches.some((m) => m.routeId !== "__root__")) return;
+			const last = matches[matches.length - 1];
+			return last?.fullPath || last?.routeId;
+		}, loc.pathname, hrefOf(loc));
+	}
+	try {
+		nav.setActiveRouteName(routeNameFor(router.state.location));
+	} catch {}
+	let inFlight = false;
+	let destination = null;
+	let staleTimer = null;
+	function clearStaleTimer() {
+		if (staleTimer !== null) {
+			clearTimeout(staleTimer);
+			staleTimer = null;
+		}
+	}
+	function settle(location) {
+		clearStaleTimer();
+		inFlight = false;
+		destination = null;
+		nav.settleNavigation(routeNameFor(location));
+	}
+	track(clearStaleTimer);
+	track(router.subscribe("onBeforeLoad", (0, _flareapp_js_browser.insulate)((event) => {
+		if (event.fromLocation === void 0) return;
+		if (event.hrefChanged === false) return;
+		if (event.toLocation.state === event.fromLocation.state) return;
+		if (!inFlight) {
+			inFlight = true;
+			nav.startNavigation({
+				path: event.toLocation.pathname,
+				hold: true
+			});
+		}
+		destination = event.toLocation;
+		nav.setActiveRouteName(routeNameFor(event.toLocation));
+		clearStaleTimer();
+		staleTimer = setTimeout((0, _flareapp_js_browser.insulate)(() => {
+			staleTimer = null;
+			if (destination) settle(destination);
+		}), STALE_NAVIGATION_TIMEOUT_MS);
+	})));
+	track(router.subscribe("onResolved", (0, _flareapp_js_browser.insulate)((event) => {
+		if (event.fromLocation === void 0) {
+			nav.setActiveRouteName(routeNameFor(event.toLocation));
+			return;
+		}
+		if (inFlight) settle(event.toLocation);
+	})));
+}
+
+//#endregion
+exports.STALE_NAVIGATION_TIMEOUT_MS = STALE_NAVIGATION_TIMEOUT_MS;
+exports.traceTanStackRouter = traceTanStackRouter;

package/dist/tanstack-router.d.cts

@@ -0,0 +1,45 @@
+//#region src/vendor/tanstackRouterTypes.d.ts
+type TanStackLocationLike = {
+  pathname: string;
+  search: unknown;
+  href?: string;
+  publicHref?: string;
+  state?: unknown;
+};
+type TanStackNavEventLike = {
+  fromLocation?: TanStackLocationLike;
+  toLocation: TanStackLocationLike;
+  hrefChanged?: boolean;
+};
+type TanStackMatchLike = {
+  routeId?: string;
+  fullPath?: string;
+};
+type TanStackRouterLike = {
+  subscribe(eventType: 'onBeforeLoad' | 'onResolved', cb: (event: TanStackNavEventLike) => void): () => void;
+  matchRoutes(pathname: string, search: unknown, opts?: {
+    preload?: boolean;
+    throwOnError?: boolean;
+  }): TanStackMatchLike[];
+  state: {
+    location: TanStackLocationLike;
+  };
+};
+//#endregion
+//#region src/tanstack-router.d.ts
+/**
+ * How long a held navigation root waits for `onResolved` before settling itself. Exported so the suite
+ * drives it instead of hardcoding the number; not part of the supported surface.
+ */
+declare const STALE_NAVIGATION_TIMEOUT_MS = 5000;
+/**
+ * Trace a TanStack Router instance: name the `browser_pageload` root from the
+ * initial route and open a parameterized `browser_navigation` root per route
+ * change. Returns a cleanup that unsubscribes and unregisters. Safe to call
+ * before or after tracing is enabled; no-ops when tracing is off. Calling it
+ * twice on the same router replaces the first instrumentation rather than
+ * stacking a second set of subscriptions.
+ */
+declare function traceTanStackRouter(router: TanStackRouterLike): () => void;
+//#endregion
+export { STALE_NAVIGATION_TIMEOUT_MS, type TanStackLocationLike, type TanStackMatchLike, type TanStackNavEventLike, type TanStackRouterLike, traceTanStackRouter };

package/dist/tanstack-router.d.mts

@@ -0,0 +1,45 @@
+//#region src/vendor/tanstackRouterTypes.d.ts
+type TanStackLocationLike = {
+  pathname: string;
+  search: unknown;
+  href?: string;
+  publicHref?: string;
+  state?: unknown;
+};
+type TanStackNavEventLike = {
+  fromLocation?: TanStackLocationLike;
+  toLocation: TanStackLocationLike;
+  hrefChanged?: boolean;
+};
+type TanStackMatchLike = {
+  routeId?: string;
+  fullPath?: string;
+};
+type TanStackRouterLike = {
+  subscribe(eventType: 'onBeforeLoad' | 'onResolved', cb: (event: TanStackNavEventLike) => void): () => void;
+  matchRoutes(pathname: string, search: unknown, opts?: {
+    preload?: boolean;
+    throwOnError?: boolean;
+  }): TanStackMatchLike[];
+  state: {
+    location: TanStackLocationLike;
+  };
+};
+//#endregion
+//#region src/tanstack-router.d.ts
+/**
+ * How long a held navigation root waits for `onResolved` before settling itself. Exported so the suite
+ * drives it instead of hardcoding the number; not part of the supported surface.
+ */
+declare const STALE_NAVIGATION_TIMEOUT_MS = 5000;
+/**
+ * Trace a TanStack Router instance: name the `browser_pageload` root from the
+ * initial route and open a parameterized `browser_navigation` root per route
+ * change. Returns a cleanup that unsubscribes and unregisters. Safe to call
+ * before or after tracing is enabled; no-ops when tracing is off. Calling it
+ * twice on the same router replaces the first instrumentation rather than
+ * stacking a second set of subscriptions.
+ */
+declare function traceTanStackRouter(router: TanStackRouterLike): () => void;
+//#endregion
+export { STALE_NAVIGATION_TIMEOUT_MS, type TanStackLocationLike, type TanStackMatchLike, type TanStackNavEventLike, type TanStackRouterLike, traceTanStackRouter };