@vestig/next 0.6.0 → 0.9.0

package/dist/error/breadcrumbs.js

@@ -0,0 +1,273 @@
+/**
+ * Breadcrumb System
+ *
+ * Captures user actions and events leading up to an error.
+ * Provides context for debugging by showing what happened before the crash.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create a unique breadcrumb ID
+ */
+function createBreadcrumbId() {
+    return `bc_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 5)}`;
+}
+/**
+ * Create the breadcrumb store
+ */
+function createBreadcrumbStore() {
+    let breadcrumbs = [];
+    let maxSize = 50;
+    return {
+        add(entry) {
+            const breadcrumb = {
+                ...entry,
+                id: createBreadcrumbId(),
+                timestamp: new Date().toISOString(),
+            };
+            breadcrumbs.push(breadcrumb);
+            // Trim to max size
+            if (breadcrumbs.length > maxSize) {
+                breadcrumbs = breadcrumbs.slice(-maxSize);
+            }
+        },
+        getAll() {
+            return [...breadcrumbs];
+        },
+        getByCategory(category) {
+            return breadcrumbs.filter((b) => b.category === category);
+        },
+        clear() {
+            breadcrumbs = [];
+        },
+        setMaxSize(size) {
+            maxSize = size;
+            if (breadcrumbs.length > maxSize) {
+                breadcrumbs = breadcrumbs.slice(-maxSize);
+            }
+        },
+    };
+}
+/**
+ * Global breadcrumb store singleton
+ */
+export const breadcrumbStore = createBreadcrumbStore();
+/**
+ * Add a log breadcrumb
+ *
+ * @example
+ * ```ts
+ * addLogBreadcrumb('info', 'User clicked button', 'ui')
+ * ```
+ */
+export function addLogBreadcrumb(level, message, namespace, data) {
+    breadcrumbStore.add({
+        category: 'log',
+        level,
+        message,
+        namespace,
+        data,
+    });
+}
+/**
+ * Add a navigation breadcrumb
+ *
+ * @example
+ * ```ts
+ * addNavigationBreadcrumb('/dashboard', '/settings')
+ * ```
+ */
+export function addNavigationBreadcrumb(from, to) {
+    breadcrumbStore.add({
+        category: 'navigation',
+        message: `Navigated from ${from} to ${to}`,
+        data: { from, to },
+    });
+}
+/**
+ * Add a click breadcrumb
+ *
+ * @example
+ * ```ts
+ * addClickBreadcrumb('Submit button', 'button#submit')
+ * ```
+ */
+export function addClickBreadcrumb(elementDescription, selector) {
+    breadcrumbStore.add({
+        category: 'click',
+        message: `Clicked: ${elementDescription}`,
+        data: selector ? { selector } : undefined,
+    });
+}
+/**
+ * Add an input breadcrumb (sanitizes sensitive data)
+ *
+ * @example
+ * ```ts
+ * addInputBreadcrumb('email', 'user@example.com', 'input#email')
+ * ```
+ */
+export function addInputBreadcrumb(fieldName, value, selector) {
+    // Sanitize potentially sensitive fields
+    const sensitiveFields = ['password', 'token', 'secret', 'key', 'credit', 'card', 'ssn', 'cvv'];
+    const isSensitive = sensitiveFields.some((f) => fieldName.toLowerCase().includes(f));
+    breadcrumbStore.add({
+        category: 'input',
+        message: `Input: ${fieldName}`,
+        data: {
+            field: fieldName,
+            value: isSensitive ? '[REDACTED]' : value,
+            selector,
+        },
+    });
+}
+/**
+ * Add a fetch/API breadcrumb
+ *
+ * @example
+ * ```ts
+ * addFetchBreadcrumb('GET', '/api/users', 200, 150)
+ * ```
+ */
+export function addFetchBreadcrumb(method, url, status, durationMs) {
+    breadcrumbStore.add({
+        category: 'fetch',
+        message: `${method} ${url}${status ? ` → ${status}` : ''}`,
+        data: {
+            method,
+            url,
+            status,
+            durationMs,
+        },
+    });
+}
+/**
+ * Add an error breadcrumb (for non-fatal errors)
+ *
+ * @example
+ * ```ts
+ * addErrorBreadcrumb('Failed to load user preferences', error)
+ * ```
+ */
+export function addErrorBreadcrumb(message, error) {
+    breadcrumbStore.add({
+        category: 'error',
+        level: 'error',
+        message,
+        data: error
+            ? {
+                name: error.name,
+                message: error.message,
+            }
+            : undefined,
+    });
+}
+/**
+ * Add a custom breadcrumb
+ *
+ * @example
+ * ```ts
+ * addCustomBreadcrumb('Feature flag enabled', { flag: 'new-dashboard' })
+ * ```
+ */
+export function addCustomBreadcrumb(message, data) {
+    breadcrumbStore.add({
+        category: 'custom',
+        message,
+        data,
+    });
+}
+/**
+ * Setup automatic click tracking
+ * Call this once in your app to capture click breadcrumbs
+ */
+export function setupClickTracking() {
+    if (typeof document === 'undefined')
+        return () => { };
+    const handleClick = (event) => {
+        const target = event.target;
+        if (!target)
+            return;
+        // Get a description of the clicked element
+        let description = target.tagName.toLowerCase();
+        // Add text content if short enough
+        const textContent = target.textContent?.trim();
+        if (textContent && textContent.length < 50) {
+            description += `: "${textContent.slice(0, 30)}${textContent.length > 30 ? '...' : ''}"`;
+        }
+        // Add id or class for identification
+        if (target.id) {
+            description += ` #${target.id}`;
+        }
+        else if (target.className && typeof target.className === 'string') {
+            const firstClass = target.className.split(' ')[0];
+            if (firstClass)
+                description += ` .${firstClass}`;
+        }
+        // Build selector
+        let selector = target.tagName.toLowerCase();
+        if (target.id)
+            selector += `#${target.id}`;
+        addClickBreadcrumb(description, selector);
+    };
+    document.addEventListener('click', handleClick, { capture: true, passive: true });
+    return () => {
+        document.removeEventListener('click', handleClick, { capture: true });
+    };
+}
+/**
+ * Setup automatic fetch tracking
+ * Patches global fetch to capture API call breadcrumbs
+ */
+export function setupFetchTracking() {
+    if (typeof window === 'undefined')
+        return () => { };
+    const originalFetch = window.fetch;
+    window.fetch = async function (input, init) {
+        const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+        const method = init?.method ?? 'GET';
+        const startTime = performance.now();
+        try {
+            const response = await originalFetch.call(this, input, init);
+            const duration = performance.now() - startTime;
+            addFetchBreadcrumb(method, url, response.status, duration);
+            return response;
+        }
+        catch (error) {
+            const duration = performance.now() - startTime;
+            addFetchBreadcrumb(method, url, 0, duration);
+            throw error;
+        }
+    };
+    return () => {
+        window.fetch = originalFetch;
+    };
+}
+/**
+ * Format breadcrumbs for display
+ */
+export function formatBreadcrumbs(breadcrumbs) {
+    return breadcrumbs
+        .map((b) => {
+        const time = new Date(b.timestamp).toLocaleTimeString();
+        const prefix = b.level ? `[${b.level.toUpperCase()}]` : `[${b.category.toUpperCase()}]`;
+        return `${time} ${prefix} ${b.message}`;
+    })
+        .join('\n');
+}
+/**
+ * Get category icon for display
+ */
+export function getCategoryIcon(category) {
+    const icons = {
+        log: '📝',
+        navigation: '🧭',
+        click: '👆',
+        input: '⌨️',
+        fetch: '🌐',
+        error: '❌',
+        custom: '📌',
+    };
+    return icons[category];
+}
+//# sourceMappingURL=breadcrumbs.js.map

package/dist/error/breadcrumbs.js.map

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

package/dist/error/fingerprint.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Error Fingerprinting
+ *
+ * Generates unique fingerprints for errors to group similar errors together.
+ * Useful for error aggregation in monitoring systems.
+ *
+ * @packageDocumentation
+ */
+import type { FingerprintOptions, StackFrame } from './types';
+/**
+ * Generate a fingerprint for an error
+ *
+ * The fingerprint is designed to group similar errors together while
+ * distinguishing between genuinely different errors.
+ *
+ * @param error - The error to fingerprint
+ * @param frames - Parsed stack frames
+ * @param options - Fingerprinting options
+ * @returns A hex string fingerprint
+ *
+ * @example
+ * ```ts
+ * const fingerprint = generateFingerprint(error, frames)
+ * // 'a1b2c3d4e5f6g7h8'
+ * ```
+ */
+export declare function generateFingerprint(error: Error, frames: StackFrame[], options?: FingerprintOptions): string;
+/**
+ * Check if two errors have the same fingerprint
+ */
+export declare function isSameError(error1: {
+    fingerprint: string;
+}, error2: {
+    fingerprint: string;
+}): boolean;
+/**
+ * Group errors by fingerprint
+ */
+export declare function groupErrors<T extends {
+    fingerprint: string;
+}>(errors: T[]): Map<string, T[]>;
+//# sourceMappingURL=fingerprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/error/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AA2E7D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,kBAAuB,GAC9B,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAC/B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAU5F"}

package/dist/error/fingerprint.js

@@ -0,0 +1,135 @@
+/**
+ * Error Fingerprinting
+ *
+ * Generates unique fingerprints for errors to group similar errors together.
+ * Useful for error aggregation in monitoring systems.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Simple hash function for strings
+ * Uses djb2 algorithm for fast, consistent hashing
+ */
+function hashString(str) {
+    let hash = 5381;
+    for (let i = 0; i < str.length; i++) {
+        hash = (hash * 33) ^ str.charCodeAt(i);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+/**
+ * Normalize a file path for consistent fingerprinting
+ * Removes dynamic parts like hashes, timestamps, query strings
+ */
+function normalizeFilePath(path) {
+    return (path
+        // Remove webpack chunk hashes
+        .replace(/\.[a-f0-9]{8,}\./, '.')
+        // Remove query strings
+        .replace(/\?.*$/, '')
+        // Remove line/column from paths
+        .replace(/:\d+:\d+$/, '')
+        // Normalize slashes
+        .replace(/\\/g, '/')
+        // Remove absolute path prefixes
+        .replace(/^.*\/node_modules\//, 'node_modules/')
+        .replace(/^.*\/(src|app|pages|components)\//, '$1/'));
+}
+/**
+ * Normalize function name for consistent fingerprinting
+ */
+function normalizeFunctionName(name) {
+    if (!name)
+        return '<anonymous>';
+    return (name
+        // Remove React component wrappers
+        .replace(/^(Object\.)?/, '')
+        // Remove module prefixes
+        .replace(/^exports\./, '')
+        // Remove async prefixes
+        .replace(/^async /, ''));
+}
+/**
+ * Extract key parts from an error message
+ * Removes dynamic values like IDs, timestamps, etc.
+ */
+function normalizeErrorMessage(message) {
+    return (message
+        // Remove UUIDs
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, '<UUID>')
+        // Remove numbers that look like IDs
+        .replace(/\b\d{5,}\b/g, '<ID>')
+        // Remove URLs
+        .replace(/https?:\/\/[^\s]+/g, '<URL>')
+        // Remove file paths
+        .replace(/\/[^\s:]+\.(js|ts|tsx|jsx)/g, '<FILE>')
+        // Remove quoted strings (might be dynamic)
+        .replace(/"[^"]{20,}"/g, '"<STRING>"')
+        .replace(/'[^']{20,}'/g, "'<STRING>'")
+        // Trim whitespace
+        .trim());
+}
+/**
+ * Generate a fingerprint for an error
+ *
+ * The fingerprint is designed to group similar errors together while
+ * distinguishing between genuinely different errors.
+ *
+ * @param error - The error to fingerprint
+ * @param frames - Parsed stack frames
+ * @param options - Fingerprinting options
+ * @returns A hex string fingerprint
+ *
+ * @example
+ * ```ts
+ * const fingerprint = generateFingerprint(error, frames)
+ * // 'a1b2c3d4e5f6g7h8'
+ * ```
+ */
+export function generateFingerprint(error, frames, options = {}) {
+    const { includeFilePaths = true, includeLineNumbers = false, maxFrames = 5 } = options;
+    const parts = [];
+    // 1. Error type/name
+    parts.push(error.name || 'Error');
+    // 2. Normalized error message
+    parts.push(normalizeErrorMessage(error.message));
+    // 3. Stack frames (focus on app code)
+    const appFrames = frames.filter((f) => f.isAppCode).slice(0, maxFrames);
+    // If no app frames, use first few frames
+    const relevantFrames = appFrames.length > 0 ? appFrames : frames.slice(0, maxFrames);
+    for (const frame of relevantFrames) {
+        const frameParts = [];
+        // Function name is most stable
+        frameParts.push(normalizeFunctionName(frame.functionName));
+        // File path (optional)
+        if (includeFilePaths && frame.fileName) {
+            frameParts.push(normalizeFilePath(frame.fileName));
+        }
+        // Line number (optional - less stable across builds)
+        if (includeLineNumbers && frame.lineNumber) {
+            frameParts.push(String(frame.lineNumber));
+        }
+        parts.push(frameParts.join(':'));
+    }
+    // Generate hash from combined parts
+    return hashString(parts.join('|'));
+}
+/**
+ * Check if two errors have the same fingerprint
+ */
+export function isSameError(error1, error2) {
+    return error1.fingerprint === error2.fingerprint;
+}
+/**
+ * Group errors by fingerprint
+ */
+export function groupErrors(errors) {
+    const groups = new Map();
+    for (const error of errors) {
+        const existing = groups.get(error.fingerprint) ?? [];
+        existing.push(error);
+        groups.set(error.fingerprint, existing);
+    }
+    return groups;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/error/fingerprint.js.map

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

package/dist/error/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @vestig/next/error - Enhanced Error Handling
+ *
+ * This module provides enhanced error handling for Next.js applications
+ * with rich development experience including:
+ *
+ * - **Stack trace parsing** with app code highlighting
+ * - **Breadcrumb trails** showing events before the error
+ * - **Error fingerprinting** for grouping similar errors
+ * - **React component tree** visualization
+ *
+ * @example Basic Usage
+ * ```tsx
+ * // app/layout.tsx
+ * import { EnhancedErrorBoundary } from '@vestig/next/error'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <EnhancedErrorBoundary>
+ *           {children}
+ *         </EnhancedErrorBoundary>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example With Breadcrumb Tracking
+ * ```tsx
+ * import { EnhancedErrorBoundary, setupClickTracking, setupFetchTracking } from '@vestig/next/error'
+ *
+ * // In a client component
+ * useEffect(() => {
+ *   const cleanupClick = setupClickTracking()
+ *   const cleanupFetch = setupFetchTracking()
+ *   return () => {
+ *     cleanupClick()
+ *     cleanupFetch()
+ *   }
+ * }, [])
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { EnhancedErrorBoundary } from './boundary';
+export { breadcrumbStore, addLogBreadcrumb, addNavigationBreadcrumb, addClickBreadcrumb, addInputBreadcrumb, addFetchBreadcrumb, addErrorBreadcrumb, addCustomBreadcrumb, setupClickTracking, setupFetchTracking, formatBreadcrumbs, getCategoryIcon, } from './breadcrumbs';
+export { parseStackTrace, parseComponentStack, getMostRelevantFrame, formatStackFrame, formatStackTrace, } from './stack-parser';
+export { generateFingerprint, isSameError, groupErrors, } from './fingerprint';
+export type { BreadcrumbCategory, Breadcrumb, StackFrame, EnhancedError, EnhancedErrorBoundaryProps, EnhancedErrorBoundaryState, FingerprintOptions, BreadcrumbStore, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAKH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGlD,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GACf,MAAM,eAAe,CAAA;AAGtB,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACN,mBAAmB,EACnB,WAAW,EACX,WAAW,GACX,MAAM,eAAe,CAAA;AAGtB,YAAY,EACX,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,GACf,MAAM,SAAS,CAAA"}

package/dist/error/index.js

@@ -0,0 +1,56 @@
+/**
+ * @vestig/next/error - Enhanced Error Handling
+ *
+ * This module provides enhanced error handling for Next.js applications
+ * with rich development experience including:
+ *
+ * - **Stack trace parsing** with app code highlighting
+ * - **Breadcrumb trails** showing events before the error
+ * - **Error fingerprinting** for grouping similar errors
+ * - **React component tree** visualization
+ *
+ * @example Basic Usage
+ * ```tsx
+ * // app/layout.tsx
+ * import { EnhancedErrorBoundary } from '@vestig/next/error'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <EnhancedErrorBoundary>
+ *           {children}
+ *         </EnhancedErrorBoundary>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example With Breadcrumb Tracking
+ * ```tsx
+ * import { EnhancedErrorBoundary, setupClickTracking, setupFetchTracking } from '@vestig/next/error'
+ *
+ * // In a client component
+ * useEffect(() => {
+ *   const cleanupClick = setupClickTracking()
+ *   const cleanupFetch = setupFetchTracking()
+ *   return () => {
+ *     cleanupClick()
+ *     cleanupFetch()
+ *   }
+ * }, [])
+ * ```
+ *
+ * @packageDocumentation
+ */
+'use client';
+// Main error boundary component
+export { EnhancedErrorBoundary } from './boundary';
+// Breadcrumb system
+export { breadcrumbStore, addLogBreadcrumb, addNavigationBreadcrumb, addClickBreadcrumb, addInputBreadcrumb, addFetchBreadcrumb, addErrorBreadcrumb, addCustomBreadcrumb, setupClickTracking, setupFetchTracking, formatBreadcrumbs, getCategoryIcon, } from './breadcrumbs';
+// Stack trace parsing
+export { parseStackTrace, parseComponentStack, getMostRelevantFrame, formatStackFrame, formatStackTrace, } from './stack-parser';
+// Error fingerprinting
+export { generateFingerprint, isSameError, groupErrors, } from './fingerprint';
+//# sourceMappingURL=index.js.map

package/dist/error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,YAAY,CAAA;AAEZ,gCAAgC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAElD,oBAAoB;AACpB,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GACf,MAAM,eAAe,CAAA;AAEtB,sBAAsB;AACtB,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,gBAAgB,CAAA;AAEvB,uBAAuB;AACvB,OAAO,EACN,mBAAmB,EACnB,WAAW,EACX,WAAW,GACX,MAAM,eAAe,CAAA"}

package/dist/error/stack-parser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Stack Trace Parser
+ *
+ * Parses JavaScript error stack traces into structured frames.
+ * Supports Chrome, Firefox, Safari, and Edge stack trace formats.
+ *
+ * @packageDocumentation
+ */
+import type { StackFrame } from './types';
+/**
+ * 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 declare function parseStackTrace(stack: string | undefined): StackFrame[];
+/**
+ * Parse React component stack into readable format
+ */
+export declare function parseComponentStack(componentStack: string | undefined): string[];
+/**
+ * Get the most relevant stack frame (first app code frame)
+ */
+export declare function getMostRelevantFrame(frames: StackFrame[]): StackFrame | null;
+/**
+ * Format a stack frame for display
+ */
+export declare function formatStackFrame(frame: StackFrame): string;
+/**
+ * Format entire stack trace for display
+ */
+export declare function formatStackTrace(frames: StackFrame[]): string;
+//# sourceMappingURL=stack-parser.d.ts.map

package/dist/error/stack-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-parser.d.ts","sourceRoot":"","sources":["../../src/error/stack-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAkEzC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EAAE,CAcvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAsBhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,GAAG,IAAI,CAW5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAqB1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAE7D"}