@vestig/next 0.6.0 → 0.8.0

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

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

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,91 @@
+/**
+ * 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
+ *
+ * @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;AAOH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAA;AAGxD;;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;;;;GAIG;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,216 @@
+/**
+ * Route Metrics Hook
+ *
+ * React hook for capturing route-level performance metrics
+ * including render time, hydration time, and data fetching.
+ *
+ * @packageDocumentation
+ */
+'use client';
+import { useCallback, useEffect, useRef, useSyncExternalStore } from 'react';
+import { usePathname } from 'next/navigation';
+import { metricsStore } from '../store';
+import { MetricsReporter } from '../reporter';
+/**
+ * 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
+ *
+ * @returns Array of route metrics
+ */
+export function useRouteMetricsData() {
+    const subscribe = useCallback((onStoreChange) => {
+        return metricsStore.subscribe(onStoreChange);
+    }, []);
+    const getSnapshot = useCallback(() => {
+        return metricsStore.getSnapshot().metrics.filter((m) => m.type === 'route');
+    }, []);
+    const getServerSnapshot = useCallback(() => {
+        return [];
+    }, []);
+    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+/**
+ * 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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"}

package/dist/metrics/hooks/use-web-vitals.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Web Vitals Hook
+ *
+ * React hook for capturing Core Web Vitals metrics.
+ * Integrates with the web-vitals library and the metrics store.
+ *
+ * @packageDocumentation
+ */
+import type { MetricEntry, WebVitalName } from '../types';
+/**
+ * Options for useWebVitals hook
+ */
+interface UseWebVitalsOptions {
+    /** Enable Web Vitals collection */
+    enabled?: boolean;
+    /** Sampling rate (0.0 - 1.0) */
+    sampleRate?: number;
+    /** Report endpoint */
+    reportEndpoint?: string;
+    /** Report immediately when rating is poor */
+    reportPoorImmediately?: boolean;
+    /** Debug mode */
+    debug?: boolean;
+}
+/**
+ * Hook to capture Core Web Vitals
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useWebVitals({
+ *     enabled: process.env.NODE_ENV === 'development',
+ *     sampleRate: 0.1,
+ *     reportPoorImmediately: true,
+ *   })
+ *
+ *   return <div>My App</div>
+ * }
+ * ```
+ */
+export declare function useWebVitals(options?: UseWebVitalsOptions): void;
+/**
+ * Hook to get the current Web Vitals from the store
+ *
+ * @returns Latest Web Vitals values
+ *
+ * @example
+ * ```tsx
+ * function MetricsDisplay() {
+ *   const vitals = useWebVitalsData()
+ *
+ *   return (
+ *     <div>
+ *       <p>LCP: {vitals.LCP?.value ?? 'N/A'}</p>
+ *       <p>CLS: {vitals.CLS?.value ?? 'N/A'}</p>
+ *       <p>INP: {vitals.INP?.value ?? 'N/A'}</p>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function useWebVitalsData(): Partial<Record<WebVitalName, MetricEntry>>;
+/**
+ * Hook to get Web Vitals summary statistics
+ *
+ * @returns Summary statistics for all Web Vitals
+ */
+export declare function useWebVitalsSummary(): Partial<Record<WebVitalName, import('../types').MetricSummary>>;
+export {};
+//# sourceMappingURL=use-web-vitals.d.ts.map

package/dist/metrics/hooks/use-web-vitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-web-vitals.d.ts","sourceRoot":"","sources":["../../../src/metrics/hooks/use-web-vitals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAkB,YAAY,EAAE,MAAM,UAAU,CAAA;AAGzE;;GAEG;AACH,UAAU,mBAAmB;IAC5B,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6CAA6C;IAC7C,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAmBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI,CA8DpE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAc7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAC7C,MAAM,CAAC,YAAY,EAAE,OAAO,UAAU,EAAE,aAAa,CAAC,CACtD,CAgBA"}

package/dist/metrics/hooks/use-web-vitals.js

@@ -0,0 +1,146 @@
+/**
+ * Web Vitals Hook
+ *
+ * React hook for capturing Core Web Vitals metrics.
+ * Integrates with the web-vitals library and the metrics store.
+ *
+ * @packageDocumentation
+ */
+'use client';
+import { useCallback, useEffect, useSyncExternalStore } from 'react';
+import { onCLS, onFCP, onINP, onLCP, onTTFB } from 'web-vitals';
+import { metricsStore } from '../store';
+import { MetricsReporter } from '../reporter';
+/**
+ * Convert web-vitals Metric to our MetricEntry format
+ */
+function toMetricEntry(metric) {
+    return {
+        type: 'web-vital',
+        name: metric.name,
+        value: metric.value,
+        rating: metric.rating,
+        metadata: {
+            navigationType: metric.navigationType,
+            delta: metric.delta,
+            pathname: typeof window !== 'undefined' ? window.location.pathname : undefined,
+        },
+    };
+}
+/**
+ * Hook to capture Core Web Vitals
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useWebVitals({
+ *     enabled: process.env.NODE_ENV === 'development',
+ *     sampleRate: 0.1,
+ *     reportPoorImmediately: true,
+ *   })
+ *
+ *   return <div>My App</div>
+ * }
+ * ```
+ */
+export function useWebVitals(options = {}) {
+    const { enabled = true, sampleRate = 1.0, reportEndpoint = '/api/vestig/metrics', reportPoorImmediately = true, debug = false, } = options;
+    useEffect(() => {
+        // Skip if disabled or failed sample
+        if (!enabled)
+            return;
+        if (Math.random() > sampleRate)
+            return;
+        // Create reporter for this session
+        const reporter = new MetricsReporter({
+            endpoint: reportEndpoint,
+            debug,
+        });
+        // Handler for all metrics
+        const handleMetric = (metric) => {
+            const entry = toMetricEntry(metric);
+            // Add to store
+            metricsStore.addMetric(entry);
+            if (debug) {
+                console.log(`[vestig-metrics] ${metric.name}:`, {
+                    value: metric.value,
+                    rating: metric.rating,
+                    delta: metric.delta,
+                });
+            }
+            // Create full entry with ID for reporter
+            const fullEntry = {
+                ...entry,
+                id: `m_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`,
+                timestamp: new Date().toISOString(),
+            };
+            // Report immediately if poor, otherwise batch
+            if (reportPoorImmediately && metric.rating === 'poor') {
+                reporter.reportImmediate(fullEntry);
+            }
+            else {
+                reporter.report(fullEntry);
+            }
+        };
+        // Subscribe to all Core Web Vitals
+        // Note: onFID is deprecated, use onINP instead
+        onLCP(handleMetric);
+        onCLS(handleMetric);
+        onINP(handleMetric);
+        onTTFB(handleMetric);
+        onFCP(handleMetric);
+        return () => {
+            reporter.destroy();
+        };
+    }, [enabled, sampleRate, reportEndpoint, reportPoorImmediately, debug]);
+}
+/**
+ * Hook to get the current Web Vitals from the store
+ *
+ * @returns Latest Web Vitals values
+ *
+ * @example
+ * ```tsx
+ * function MetricsDisplay() {
+ *   const vitals = useWebVitalsData()
+ *
+ *   return (
+ *     <div>
+ *       <p>LCP: {vitals.LCP?.value ?? 'N/A'}</p>
+ *       <p>CLS: {vitals.CLS?.value ?? 'N/A'}</p>
+ *       <p>INP: {vitals.INP?.value ?? 'N/A'}</p>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export function useWebVitalsData() {
+    const subscribe = useCallback((onStoreChange) => {
+        return metricsStore.subscribe(onStoreChange);
+    }, []);
+    const getSnapshot = useCallback(() => {
+        return metricsStore.getSnapshot().latestVitals;
+    }, []);
+    const getServerSnapshot = useCallback(() => {
+        return {};
+    }, []);
+    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+/**
+ * Hook to get Web Vitals summary statistics
+ *
+ * @returns Summary statistics for all Web Vitals
+ */
+export function useWebVitalsSummary() {
+    const subscribe = useCallback((onStoreChange) => {
+        return metricsStore.subscribe(onStoreChange);
+    }, []);
+    const getSnapshot = useCallback(() => {
+        return metricsStore.getVitalsSummary();
+    }, []);
+    const getServerSnapshot = useCallback(() => {
+        return {};
+    }, []);
+    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+//# sourceMappingURL=use-web-vitals.js.map

package/dist/metrics/hooks/use-web-vitals.js.map

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

package/dist/metrics/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @vestig/next/metrics - Performance Metrics Module
+ *
+ * This module provides Core Web Vitals and route-level performance
+ * monitoring for Next.js applications.
+ *
+ * @example Quick Start
+ * ```tsx
+ * // app/layout.tsx
+ * import { VestigMetrics } from '@vestig/next/metrics'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <VestigMetrics />
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example With Dev Overlay
+ * ```tsx
+ * import { VestigDevOverlay } from '@vestig/next/dev'
+ * import { VestigMetrics } from '@vestig/next/metrics'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         {process.env.NODE_ENV === 'development' && <VestigDevOverlay />}
+ *         <VestigMetrics />
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { VestigMetrics, type VestigMetricsProps } from './web-vitals';
+export { metricsStore } from './store';
+export { useWebVitals, useWebVitalsData, useWebVitalsSummary, } from './hooks/use-web-vitals';
+export { useRouteMetrics, useRouteMetricsData, useRenderTiming, useDataFetchTiming, } from './hooks/use-route-metrics';
+export { THRESHOLDS, RATING_COLORS, getRating, getRatingColors, getMetricDescription, getMetricUnit, formatMetricValue, } from './thresholds';
+export { MetricsReporter } from './reporter';
+export type { WebVitalName, MetricRating, NavigationType, WebVitalMetric, RouteMetric, MetricEntry, MetricSummary, HistogramBucket, MetricsState, MetricsStore, VestigMetricsConfig, MetricsReportPayload, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAKH,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAGtC,OAAO,EACN,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACnB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GAClB,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EACN,UAAU,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GACjB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAG5C,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,SAAS,CAAA"}

package/dist/metrics/index.js

@@ -0,0 +1,56 @@
+/**
+ * @vestig/next/metrics - Performance Metrics Module
+ *
+ * This module provides Core Web Vitals and route-level performance
+ * monitoring for Next.js applications.
+ *
+ * @example Quick Start
+ * ```tsx
+ * // app/layout.tsx
+ * import { VestigMetrics } from '@vestig/next/metrics'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <VestigMetrics />
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example With Dev Overlay
+ * ```tsx
+ * import { VestigDevOverlay } from '@vestig/next/dev'
+ * import { VestigMetrics } from '@vestig/next/metrics'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         {process.env.NODE_ENV === 'development' && <VestigDevOverlay />}
+ *         <VestigMetrics />
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+'use client';
+// Main component
+export { VestigMetrics } from './web-vitals';
+// Store for programmatic access
+export { metricsStore } from './store';
+// Hooks
+export { useWebVitals, useWebVitalsData, useWebVitalsSummary, } from './hooks/use-web-vitals';
+export { useRouteMetrics, useRouteMetricsData, useRenderTiming, useDataFetchTiming, } from './hooks/use-route-metrics';
+// Thresholds and utilities
+export { THRESHOLDS, RATING_COLORS, getRating, getRatingColors, getMetricDescription, getMetricUnit, formatMetricValue, } from './thresholds';
+// Reporter for custom integrations
+export { MetricsReporter } from './reporter';
+//# sourceMappingURL=index.js.map