@vestig/next 0.6.0 → 0.9.0

package/dist/error/stack-parser.js

@@ -0,0 +1,166 @@
+/**
+ * Stack Trace Parser
+ *
+ * Parses JavaScript error stack traces into structured frames.
+ * Supports Chrome, Firefox, Safari, and Edge stack trace formats.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Regex patterns for different browser stack trace formats
+ */
+const CHROME_STACK_REGEX = /^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?$/;
+const FIREFOX_STACK_REGEX = /^(?:(.+)@)?(.+?):(\d+):(\d+)$/;
+const SAFARI_STACK_REGEX = /^(?:(.+)@)?(.+?):(\d+):(\d+)$/;
+/**
+ * Check if a file path is from node_modules
+ */
+function isNodeModulePath(path) {
+    return path.includes('node_modules') || path.includes('node:');
+}
+/**
+ * Check if a file path is from app source code
+ */
+function isAppCodePath(path) {
+    // Not from node_modules
+    if (isNodeModulePath(path))
+        return false;
+    // Common app directories
+    const appPatterns = ['/src/', '/app/', '/pages/', '/components/', '/lib/', '/utils/', '/hooks/'];
+    return appPatterns.some((pattern) => path.includes(pattern));
+}
+/**
+ * Parse a single stack frame line
+ */
+function parseStackLine(line) {
+    const trimmedLine = line.trim();
+    if (!trimmedLine || trimmedLine === 'Error')
+        return null;
+    // Try Chrome format first (most common)
+    let match = CHROME_STACK_REGEX.exec(trimmedLine);
+    if (match) {
+        const [, functionName, fileName, lineNumber, columnNumber] = match;
+        return {
+            functionName: functionName?.trim(),
+            fileName: fileName,
+            lineNumber: Number.parseInt(lineNumber ?? '0', 10),
+            columnNumber: Number.parseInt(columnNumber ?? '0', 10),
+            isNodeModule: isNodeModulePath(fileName ?? ''),
+            isAppCode: isAppCodePath(fileName ?? ''),
+        };
+    }
+    // Try Firefox/Safari format
+    match = FIREFOX_STACK_REGEX.exec(trimmedLine);
+    if (match) {
+        const [, functionName, fileName, lineNumber, columnNumber] = match;
+        return {
+            functionName: functionName?.trim(),
+            fileName: fileName,
+            lineNumber: Number.parseInt(lineNumber ?? '0', 10),
+            columnNumber: Number.parseInt(columnNumber ?? '0', 10),
+            isNodeModule: isNodeModulePath(fileName ?? ''),
+            isAppCode: isAppCodePath(fileName ?? ''),
+        };
+    }
+    return null;
+}
+/**
+ * Parse an error stack trace into structured frames
+ *
+ * @param stack - The error.stack string
+ * @returns Array of parsed stack frames
+ *
+ * @example
+ * ```ts
+ * try {
+ *   throw new Error('Test')
+ * } catch (e) {
+ *   const frames = parseStackTrace(e.stack)
+ *   // [{ functionName: 'test', fileName: '/app/src/test.ts', lineNumber: 5, ... }]
+ * }
+ * ```
+ */
+export function parseStackTrace(stack) {
+    if (!stack)
+        return [];
+    const lines = stack.split('\n');
+    const frames = [];
+    for (const line of lines) {
+        const frame = parseStackLine(line);
+        if (frame) {
+            frames.push(frame);
+        }
+    }
+    return frames;
+}
+/**
+ * Parse React component stack into readable format
+ */
+export function parseComponentStack(componentStack) {
+    if (!componentStack)
+        return [];
+    const lines = componentStack.split('\n');
+    const components = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        // Extract component name from "at ComponentName (file:line:col)"
+        const match = /^at\s+(\w+)/.exec(trimmed);
+        if (match?.[1]) {
+            components.push(match[1]);
+        }
+        else if (trimmed.startsWith('in ')) {
+            // Alternative format: "in ComponentName"
+            const componentName = trimmed.slice(3).split(' ')[0];
+            if (componentName)
+                components.push(componentName);
+        }
+    }
+    return components;
+}
+/**
+ * Get the most relevant stack frame (first app code frame)
+ */
+export function getMostRelevantFrame(frames) {
+    // First, try to find an app code frame
+    const appFrame = frames.find((f) => f.isAppCode);
+    if (appFrame)
+        return appFrame;
+    // Fall back to first non-node_modules frame
+    const nonModuleFrame = frames.find((f) => !f.isNodeModule);
+    if (nonModuleFrame)
+        return nonModuleFrame;
+    // Last resort: first frame
+    return frames[0] ?? null;
+}
+/**
+ * Format a stack frame for display
+ */
+export function formatStackFrame(frame) {
+    const parts = [];
+    if (frame.functionName) {
+        parts.push(frame.functionName);
+    }
+    else {
+        parts.push('<anonymous>');
+    }
+    if (frame.fileName) {
+        let location = frame.fileName;
+        if (frame.lineNumber) {
+            location += `:${frame.lineNumber}`;
+            if (frame.columnNumber) {
+                location += `:${frame.columnNumber}`;
+            }
+        }
+        parts.push(`(${location})`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Format entire stack trace for display
+ */
+export function formatStackTrace(frames) {
+    return frames.map((frame, i) => `  at ${formatStackFrame(frame)}`).join('\n');
+}
+//# sourceMappingURL=stack-parser.js.map

package/dist/error/stack-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-parser.js","sourceRoot":"","sources":["../../src/error/stack-parser.ts"],"names":[],"mappings":"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"}

package/dist/error/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Error Types for Better Error DX
+ *
+ * Types for enhanced error handling with source maps,
+ * breadcrumbs, and fingerprinting.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Breadcrumb categories for filtering
+ */
+export type BreadcrumbCategory = 'log' | 'navigation' | 'click' | 'input' | 'fetch' | 'error' | 'custom';
+/**
+ * Enhanced breadcrumb with more context
+ */
+export interface Breadcrumb {
+    /** Unique ID */
+    id: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Breadcrumb category */
+    category: BreadcrumbCategory;
+    /** Log level (for log breadcrumbs) */
+    level?: 'trace' | 'debug' | 'info' | 'warn' | 'error';
+    /** Human-readable message */
+    message: string;
+    /** Logger namespace */
+    namespace?: string;
+    /** Additional data */
+    data?: Record<string, unknown>;
+}
+/**
+ * Parsed stack frame from error stack trace
+ */
+export interface StackFrame {
+    /** Function name (if available) */
+    functionName?: string;
+    /** File path */
+    fileName?: string;
+    /** Line number (1-indexed) */
+    lineNumber?: number;
+    /** Column number (1-indexed) */
+    columnNumber?: number;
+    /** Whether this is from node_modules */
+    isNodeModule: boolean;
+    /** Whether this is from the app's source code */
+    isAppCode: boolean;
+    /** Source code context (if available via source maps) */
+    sourceContext?: {
+        /** Lines before the error line */
+        pre: string[];
+        /** The error line */
+        line: string;
+        /** Lines after the error line */
+        post: string[];
+    };
+}
+/**
+ * Enhanced error with parsed stack and fingerprint
+ */
+export interface EnhancedError {
+    /** Original error */
+    error: Error;
+    /** Error fingerprint for grouping */
+    fingerprint: string;
+    /** Parsed stack frames */
+    frames: StackFrame[];
+    /** React component stack */
+    componentStack?: string;
+    /** Breadcrumbs leading up to the error */
+    breadcrumbs: Breadcrumb[];
+    /** Timestamp when error occurred */
+    timestamp: string;
+    /** Browser/environment info */
+    environment: {
+        userAgent: string;
+        url: string;
+        pathname: string;
+    };
+}
+/**
+ * Props for enhanced error boundary
+ */
+export interface EnhancedErrorBoundaryProps {
+    children: React.ReactNode;
+    /**
+     * Custom fallback UI
+     */
+    fallback?: React.ReactNode | ((error: EnhancedError) => React.ReactNode);
+    /**
+     * Callback when error is caught
+     */
+    onError?: (error: EnhancedError) => void;
+    /**
+     * Maximum breadcrumbs to keep
+     * @default 50
+     */
+    maxBreadcrumbs?: number;
+    /**
+     * Show source code context in development
+     * @default true in development
+     */
+    showSourceContext?: boolean;
+    /**
+     * Show breadcrumbs in error UI
+     * @default true in development
+     */
+    showBreadcrumbs?: boolean;
+    /**
+     * Categories of breadcrumbs to capture
+     * @default all categories
+     */
+    breadcrumbCategories?: BreadcrumbCategory[];
+    /**
+     * Report errors to endpoint
+     */
+    reportEndpoint?: string;
+}
+/**
+ * State for enhanced error boundary
+ */
+export interface EnhancedErrorBoundaryState {
+    hasError: boolean;
+    enhancedError: EnhancedError | null;
+}
+/**
+ * Options for error fingerprinting
+ */
+export interface FingerprintOptions {
+    /** Include file paths in fingerprint */
+    includeFilePaths?: boolean;
+    /** Include line numbers in fingerprint */
+    includeLineNumbers?: boolean;
+    /** Maximum stack frames to consider */
+    maxFrames?: number;
+}
+/**
+ * Breadcrumb store interface
+ */
+export interface BreadcrumbStore {
+    /** Add a breadcrumb */
+    add: (breadcrumb: Omit<Breadcrumb, 'id' | 'timestamp'>) => void;
+    /** Get all breadcrumbs */
+    getAll: () => Breadcrumb[];
+    /** Get breadcrumbs by category */
+    getByCategory: (category: BreadcrumbCategory) => Breadcrumb[];
+    /** Clear all breadcrumbs */
+    clear: () => void;
+    /** Set maximum breadcrumbs */
+    setMaxSize: (size: number) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/error/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/error/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC3B,KAAK,GACL,YAAY,GACZ,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,CAAA;AAEX;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IACrD,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAA;IACrB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAA;IAClB,yDAAyD;IACzD,aAAa,CAAC,EAAE;QACf,kCAAkC;QAClC,GAAG,EAAE,MAAM,EAAE,CAAA;QACb,qBAAqB;QACrB,IAAI,EAAE,MAAM,CAAA;QACZ,iCAAiC;QACjC,IAAI,EAAE,MAAM,EAAE,CAAA;KACd,CAAA;CACD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qBAAqB;IACrB,KAAK,EAAE,KAAK,CAAA;IACZ,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,0BAA0B;IAC1B,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0CAA0C;IAC1C,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,WAAW,EAAE;QACZ,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,CAAA;QACX,QAAQ,EAAE,MAAM,CAAA;KAChB,CAAA;CACD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;IACxE;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC3C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,uBAAuB;IACvB,GAAG,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,CAAA;IAC/D,0BAA0B;IAC1B,MAAM,EAAE,MAAM,UAAU,EAAE,CAAA;IAC1B,kCAAkC;IAClC,aAAa,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,UAAU,EAAE,CAAA;IAC7D,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,8BAA8B;IAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC"}

package/dist/error/types.js

@@ -0,0 +1,10 @@
+/**
+ * Error Types for Better Error DX
+ *
+ * Types for enhanced error handling with source maps,
+ * breadcrumbs, and fingerprinting.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/error/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/error/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/metrics/hooks/use-route-metrics.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Route Metrics Hook
+ *
+ * React hook for capturing route-level performance metrics
+ * including render time, hydration time, and data fetching.
+ *
+ * @packageDocumentation
+ */
+import type { MetricEntry } from '../types';
+/**
+ * Options for useRouteMetrics hook
+ */
+interface UseRouteMetricsOptions {
+    /** Enable route metrics collection */
+    enabled?: boolean;
+    /** Report endpoint */
+    reportEndpoint?: string;
+    /** Debug mode */
+    debug?: boolean;
+}
+/**
+ * Hook to capture route-level performance metrics
+ *
+ * Automatically tracks:
+ * - Route render time
+ * - Hydration time (client-side)
+ * - Navigation timing
+ *
+ * @example
+ * ```tsx
+ * function MyLayout({ children }) {
+ *   useRouteMetrics({
+ *     enabled: process.env.NODE_ENV === 'development',
+ *   })
+ *
+ *   return <div>{children}</div>
+ * }
+ * ```
+ */
+export declare function useRouteMetrics(options?: UseRouteMetricsOptions): void;
+/**
+ * Hook to get route metrics from the store
+ *
+ * Uses simple useState + useEffect pattern - React Compiler handles memoization.
+ *
+ * @returns Array of route metrics
+ */
+export declare function useRouteMetricsData(): MetricEntry[];
+/**
+ * Hook to manually measure render time
+ *
+ * Useful for measuring specific component render times.
+ *
+ * @example
+ * ```tsx
+ * function ExpensiveComponent() {
+ *   const { startMeasure, endMeasure } = useRenderTiming('ExpensiveComponent')
+ *
+ *   useEffect(() => {
+ *     startMeasure()
+ *     return () => endMeasure()
+ *   }, [])
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export declare function useRenderTiming(componentName: string): {
+    startMeasure: () => void;
+    endMeasure: () => void;
+};
+/**
+ * Hook to measure data fetching time
+ *
+ * @example
+ * ```tsx
+ * function DataComponent() {
+ *   const { measureFetch } = useDataFetchTiming()
+ *
+ *   useEffect(() => {
+ *     measureFetch('users', async () => {
+ *       const res = await fetch('/api/users')
+ *       return res.json()
+ *     })
+ *   }, [])
+ * }
+ * ```
+ */
+export declare function useDataFetchTiming(): {
+    measureFetch: <T>(name: string, fetchFn: () => Promise<T>) => Promise<T>;
+};
+export {};
+//# sourceMappingURL=use-route-metrics.d.ts.map

package/dist/metrics/hooks/use-route-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-route-metrics.d.ts","sourceRoot":"","sources":["../../../src/metrics/hooks/use-route-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAA;AAExD;;GAEG;AACH,UAAU,sBAAsB;IAC/B,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,IAAI,CA6F1E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,EAAE,CAcnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM;;;EA0BpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB;mBAEzB,CAAC,QAAQ,MAAM,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;EAwC/D"}

package/dist/metrics/hooks/use-route-metrics.js

@@ -0,0 +1,217 @@
+/**
+ * Route Metrics Hook
+ *
+ * React hook for capturing route-level performance metrics
+ * including render time, hydration time, and data fetching.
+ *
+ * @packageDocumentation
+ */
+'use client';
+import { usePathname } from 'next/navigation';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { MetricsReporter } from '../reporter';
+import { metricsStore } from '../store';
+/**
+ * Hook to capture route-level performance metrics
+ *
+ * Automatically tracks:
+ * - Route render time
+ * - Hydration time (client-side)
+ * - Navigation timing
+ *
+ * @example
+ * ```tsx
+ * function MyLayout({ children }) {
+ *   useRouteMetrics({
+ *     enabled: process.env.NODE_ENV === 'development',
+ *   })
+ *
+ *   return <div>{children}</div>
+ * }
+ * ```
+ */
+export function useRouteMetrics(options = {}) {
+    const { enabled = true, reportEndpoint = '/api/vestig/metrics', debug = false } = options;
+    const pathname = usePathname();
+    const renderStartRef = useRef(performance.now());
+    const lastPathnameRef = useRef(null);
+    const hydrationMeasuredRef = useRef(false);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const reporter = new MetricsReporter({
+            endpoint: reportEndpoint,
+            debug,
+            batchInterval: 10000, // Longer interval for route metrics
+        });
+        // Measure hydration time on initial mount
+        if (!hydrationMeasuredRef.current && typeof window !== 'undefined') {
+            hydrationMeasuredRef.current = true;
+            // Use requestIdleCallback or setTimeout to measure after hydration
+            const measureHydration = () => {
+                const hydrationTime = performance.now() - renderStartRef.current;
+                if (debug) {
+                    console.log(`[vestig-metrics] Hydration time for ${pathname}:`, hydrationTime.toFixed(2), 'ms');
+                }
+                const entry = {
+                    type: 'route',
+                    name: 'hydration',
+                    value: hydrationTime,
+                    metadata: {
+                        pathname,
+                    },
+                };
+                metricsStore.addMetric(entry);
+            };
+            if ('requestIdleCallback' in window) {
+                ;
+                window.requestIdleCallback(measureHydration);
+            }
+            else {
+                setTimeout(measureHydration, 0);
+            }
+        }
+        return () => {
+            reporter.destroy();
+        };
+    }, [enabled, reportEndpoint, debug, pathname]);
+    // Track route changes
+    useEffect(() => {
+        if (!enabled)
+            return;
+        // Skip initial render
+        if (lastPathnameRef.current === null) {
+            lastPathnameRef.current = pathname;
+            return;
+        }
+        // Route changed - measure navigation time
+        if (pathname !== lastPathnameRef.current) {
+            const navigationTime = performance.now() - renderStartRef.current;
+            if (debug) {
+                console.log(`[vestig-metrics] Navigation to ${pathname}:`, navigationTime.toFixed(2), 'ms');
+            }
+            const entry = {
+                type: 'route',
+                name: 'navigation',
+                value: navigationTime,
+                metadata: {
+                    pathname,
+                },
+            };
+            metricsStore.addMetric(entry);
+            // Reset for next navigation
+            lastPathnameRef.current = pathname;
+            renderStartRef.current = performance.now();
+        }
+    }, [enabled, pathname, debug]);
+}
+/**
+ * Hook to get route metrics from the store
+ *
+ * Uses simple useState + useEffect pattern - React Compiler handles memoization.
+ *
+ * @returns Array of route metrics
+ */
+export function useRouteMetricsData() {
+    const [routeMetrics, setRouteMetrics] = useState([]);
+    useEffect(() => {
+        setRouteMetrics(metricsStore.getRouteMetrics());
+        const unsubscribe = metricsStore.subscribe(() => {
+            setRouteMetrics(metricsStore.getRouteMetrics());
+        });
+        return unsubscribe;
+    }, []);
+    return routeMetrics;
+}
+/**
+ * Hook to manually measure render time
+ *
+ * Useful for measuring specific component render times.
+ *
+ * @example
+ * ```tsx
+ * function ExpensiveComponent() {
+ *   const { startMeasure, endMeasure } = useRenderTiming('ExpensiveComponent')
+ *
+ *   useEffect(() => {
+ *     startMeasure()
+ *     return () => endMeasure()
+ *   }, [])
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export function useRenderTiming(componentName) {
+    const startTimeRef = useRef(null);
+    const startMeasure = useCallback(() => {
+        startTimeRef.current = performance.now();
+    }, []);
+    const endMeasure = useCallback(() => {
+        if (startTimeRef.current === null)
+            return;
+        const renderTime = performance.now() - startTimeRef.current;
+        startTimeRef.current = null;
+        const entry = {
+            type: 'custom',
+            name: `render:${componentName}`,
+            value: renderTime,
+            metadata: {
+                pathname: typeof window !== 'undefined' ? window.location.pathname : undefined,
+            },
+        };
+        metricsStore.addMetric(entry);
+    }, [componentName]);
+    return { startMeasure, endMeasure };
+}
+/**
+ * Hook to measure data fetching time
+ *
+ * @example
+ * ```tsx
+ * function DataComponent() {
+ *   const { measureFetch } = useDataFetchTiming()
+ *
+ *   useEffect(() => {
+ *     measureFetch('users', async () => {
+ *       const res = await fetch('/api/users')
+ *       return res.json()
+ *     })
+ *   }, [])
+ * }
+ * ```
+ */
+export function useDataFetchTiming() {
+    const measureFetch = useCallback(async (name, fetchFn) => {
+        const start = performance.now();
+        try {
+            const result = await fetchFn();
+            const duration = performance.now() - start;
+            const entry = {
+                type: 'custom',
+                name: `fetch:${name}`,
+                value: duration,
+                metadata: {
+                    pathname: typeof window !== 'undefined' ? window.location.pathname : undefined,
+                },
+            };
+            metricsStore.addMetric(entry);
+            return result;
+        }
+        catch (error) {
+            const duration = performance.now() - start;
+            const entry = {
+                type: 'custom',
+                name: `fetch:${name}:error`,
+                value: duration,
+                metadata: {
+                    pathname: typeof window !== 'undefined' ? window.location.pathname : undefined,
+                },
+            };
+            metricsStore.addMetric(entry);
+            throw error;
+        }
+    }, []);
+    return { measureFetch };
+}
+//# sourceMappingURL=use-route-metrics.js.map

package/dist/metrics/hooks/use-route-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-route-metrics.js","sourceRoot":"","sources":["../../../src/metrics/hooks/use-route-metrics.ts"],"names":[],"mappings":"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"}