@vestig/next 0.6.0 → 0.9.0

package/dist/dev/store.js

@@ -0,0 +1,210 @@
+/**
+ * Dev Overlay Log Store
+ *
+ * Simple pub/sub store for dev logs.
+ * Uses class-based architecture for clarity and reliability.
+ */
+/**
+ * Simple log store - no useSyncExternalStore needed
+ */
+class SimpleLogStore {
+    state = {
+        logs: [],
+        filters: {
+            levels: new Set(['trace', 'debug', 'info', 'warn', 'error']),
+            namespaces: new Set(),
+            search: '',
+            source: 'all',
+        },
+        isOpen: false,
+        maxLogs: 500,
+    };
+    listeners = new Set();
+    /**
+     * Subscribe to store changes
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            try {
+                listener();
+            }
+            catch (error) {
+                console.error('[vestig-dev] Listener error:', error);
+            }
+        }
+    }
+    /**
+     * Get current state snapshot
+     */
+    getSnapshot() {
+        return this.state;
+    }
+    /**
+     * Get filtered logs
+     */
+    getFilteredLogs() {
+        return this.state.logs.filter((log) => {
+            if (!this.state.filters.levels.has(log.level))
+                return false;
+            if (this.state.filters.source !== 'all' && log.source !== this.state.filters.source) {
+                return false;
+            }
+            if (this.state.filters.namespaces.size > 0 && log.namespace) {
+                if (!this.state.filters.namespaces.has(log.namespace))
+                    return false;
+            }
+            if (this.state.filters.search) {
+                const searchLower = this.state.filters.search.toLowerCase();
+                const matchesMessage = log.message.toLowerCase().includes(searchLower);
+                const matchesNamespace = log.namespace?.toLowerCase().includes(searchLower);
+                const matchesMetadata = JSON.stringify(log.metadata ?? {})
+                    .toLowerCase()
+                    .includes(searchLower);
+                if (!matchesMessage && !matchesNamespace && !matchesMetadata) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    generateId() {
+        return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    }
+    /**
+     * Add a log entry
+     */
+    addLog(entry) {
+        const log = {
+            ...entry,
+            id: this.generateId(),
+        };
+        this.state.logs.push(log);
+        while (this.state.logs.length > this.state.maxLogs) {
+            this.state.logs.shift();
+        }
+        this.notify();
+    }
+    /**
+     * Add multiple log entries
+     */
+    addLogs(entries) {
+        for (const entry of entries) {
+            this.state.logs.push({
+                ...entry,
+                id: this.generateId(),
+            });
+        }
+        while (this.state.logs.length > this.state.maxLogs) {
+            this.state.logs.shift();
+        }
+        this.notify();
+    }
+    /**
+     * Clear all logs
+     */
+    clearLogs() {
+        this.state.logs = [];
+        this.notify();
+    }
+    /**
+     * Toggle overlay visibility
+     */
+    toggleOpen() {
+        this.state.isOpen = !this.state.isOpen;
+        this.notify();
+    }
+    /**
+     * Set overlay visibility
+     */
+    setOpen(isOpen) {
+        this.state.isOpen = isOpen;
+        this.notify();
+    }
+    /**
+     * Update filter levels
+     */
+    setLevelFilter(level, enabled) {
+        if (enabled) {
+            this.state.filters.levels.add(level);
+        }
+        else {
+            this.state.filters.levels.delete(level);
+        }
+        this.notify();
+    }
+    /**
+     * Toggle all levels
+     */
+    toggleAllLevels(enabled) {
+        if (enabled) {
+            this.state.filters.levels = new Set(['trace', 'debug', 'info', 'warn', 'error']);
+        }
+        else {
+            this.state.filters.levels.clear();
+        }
+        this.notify();
+    }
+    /**
+     * Set namespace filter
+     */
+    setNamespaceFilter(namespace, enabled) {
+        if (enabled) {
+            this.state.filters.namespaces.add(namespace);
+        }
+        else {
+            this.state.filters.namespaces.delete(namespace);
+        }
+        this.notify();
+    }
+    /**
+     * Set search query
+     */
+    setSearch(search) {
+        this.state.filters.search = search;
+        this.notify();
+    }
+    /**
+     * Set source filter
+     */
+    setSourceFilter(source) {
+        this.state.filters.source = source;
+        this.notify();
+    }
+    /**
+     * Get all unique namespaces
+     */
+    getNamespaces() {
+        const namespaces = new Set();
+        for (const log of this.state.logs) {
+            if (log.namespace) {
+                namespaces.add(log.namespace);
+            }
+        }
+        return Array.from(namespaces).sort();
+    }
+    /**
+     * Get log counts by level
+     */
+    getLevelCounts() {
+        const counts = {
+            trace: 0,
+            debug: 0,
+            info: 0,
+            warn: 0,
+            error: 0,
+        };
+        for (const log of this.state.logs) {
+            counts[log.level]++;
+        }
+        return counts;
+    }
+}
+/**
+ * Singleton store instance
+ */
+export const logStore = new SimpleLogStore();
+//# sourceMappingURL=store.js.map

package/dist/dev/store.js.map

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

package/dist/error/boundary.d.ts

@@ -0,0 +1,36 @@
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+import type { EnhancedErrorBoundaryProps, EnhancedErrorBoundaryState } from './types';
+/**
+ * Enhanced Error Boundary Component
+ *
+ * Provides rich error context including:
+ * - Parsed stack traces with app code highlighted
+ * - Breadcrumb trail of events before the error
+ * - React component tree
+ * - Error fingerprinting for grouping
+ *
+ * @example
+ * ```tsx
+ * import { EnhancedErrorBoundary } from '@vestig/next/error'
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <EnhancedErrorBoundary
+ *       showBreadcrumbs
+ *       onError={(err) => sendToErrorService(err)}
+ *     >
+ *       {children}
+ *     </EnhancedErrorBoundary>
+ *   )
+ * }
+ * ```
+ */
+export declare class EnhancedErrorBoundary extends Component<EnhancedErrorBoundaryProps, EnhancedErrorBoundaryState> {
+    constructor(props: EnhancedErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): Partial<EnhancedErrorBoundaryState>;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    private reportError;
+    private handleReset;
+    render(): ReactNode;
+}
+//# sourceMappingURL=boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../src/error/boundary.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAsB,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrF,OAAO,KAAK,EAEX,0BAA0B,EAC1B,0BAA0B,EAE1B,MAAM,SAAS,CAAA;AA0RhB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,qBAAsB,SAAQ,SAAS,CACnD,0BAA0B,EAC1B,0BAA0B,CAC1B;gBACY,KAAK,EAAE,0BAA0B;IAa7C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAIzE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;YActD,WAAW;IAyBzB,OAAO,CAAC,WAAW,CAMlB;IAEQ,MAAM,IAAI,SAAS;CA8B5B"}

package/dist/error/boundary.js

@@ -0,0 +1,263 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component } from 'react';
+import { breadcrumbStore, getCategoryIcon } from './breadcrumbs';
+import { generateFingerprint } from './fingerprint';
+import { getMostRelevantFrame, parseComponentStack, parseStackTrace } from './stack-parser';
+/**
+ * Create an enhanced error object with all context
+ */
+function createEnhancedError(error, errorInfo) {
+    const frames = parseStackTrace(error.stack);
+    const fingerprint = generateFingerprint(error, frames);
+    const breadcrumbs = breadcrumbStore.getAll();
+    return {
+        error,
+        fingerprint,
+        frames,
+        componentStack: errorInfo.componentStack ?? undefined,
+        breadcrumbs,
+        timestamp: new Date().toISOString(),
+        environment: {
+            userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',
+            url: typeof window !== 'undefined' ? window.location.href : 'unknown',
+            pathname: typeof window !== 'undefined' ? window.location.pathname : 'unknown',
+        },
+    };
+}
+/**
+ * Development Error UI Component
+ */
+function DevErrorUI({ enhancedError, onReset, showBreadcrumbs = true, }) {
+    const { error, frames, componentStack, breadcrumbs, fingerprint } = enhancedError;
+    const relevantFrame = getMostRelevantFrame(frames);
+    const componentNames = parseComponentStack(componentStack);
+    const containerStyle = {
+        position: 'fixed',
+        inset: 0,
+        backgroundColor: 'rgba(0, 0, 0, 0.85)',
+        zIndex: 99999,
+        overflow: 'auto',
+        fontFamily: 'system-ui, -apple-system, sans-serif',
+    };
+    const contentStyle = {
+        maxWidth: '900px',
+        margin: '40px auto',
+        padding: '24px',
+        backgroundColor: '#1a1a2e',
+        borderRadius: '12px',
+        color: '#e4e4e7',
+    };
+    const headerStyle = {
+        display: 'flex',
+        alignItems: 'flex-start',
+        gap: '16px',
+        marginBottom: '24px',
+        paddingBottom: '16px',
+        borderBottom: '1px solid rgba(255, 255, 255, 0.1)',
+    };
+    const errorIconStyle = {
+        width: '48px',
+        height: '48px',
+        borderRadius: '50%',
+        backgroundColor: '#dc2626',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        fontSize: '24px',
+        flexShrink: 0,
+    };
+    const errorTitleStyle = {
+        fontSize: '20px',
+        fontWeight: 700,
+        color: '#fca5a5',
+        margin: 0,
+    };
+    const errorMessageStyle = {
+        fontSize: '16px',
+        color: '#e4e4e7',
+        margin: '8px 0 0',
+        lineHeight: 1.5,
+    };
+    const sectionStyle = {
+        marginBottom: '20px',
+    };
+    const sectionTitleStyle = {
+        fontSize: '12px',
+        fontWeight: 600,
+        textTransform: 'uppercase',
+        letterSpacing: '0.05em',
+        color: '#a1a1aa',
+        marginBottom: '8px',
+    };
+    const codeBlockStyle = {
+        backgroundColor: '#0f0f1a',
+        borderRadius: '8px',
+        padding: '12px',
+        fontSize: '13px',
+        fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
+        overflow: 'auto',
+        maxHeight: '200px',
+    };
+    const frameStyle = (isAppCode) => ({
+        padding: '4px 0',
+        color: isAppCode ? '#93c5fd' : '#71717a',
+        borderLeft: isAppCode ? '2px solid #3b82f6' : '2px solid transparent',
+        paddingLeft: '8px',
+    });
+    const componentStyle = {
+        display: 'inline-block',
+        padding: '2px 8px',
+        margin: '2px',
+        backgroundColor: 'rgba(139, 92, 246, 0.2)',
+        borderRadius: '4px',
+        fontSize: '12px',
+        color: '#c4b5fd',
+    };
+    const breadcrumbStyle = {
+        display: 'flex',
+        alignItems: 'flex-start',
+        gap: '8px',
+        padding: '6px 0',
+        borderBottom: '1px solid rgba(255, 255, 255, 0.05)',
+        fontSize: '12px',
+    };
+    const buttonStyle = {
+        padding: '10px 20px',
+        backgroundColor: '#3b82f6',
+        color: 'white',
+        border: 'none',
+        borderRadius: '6px',
+        fontSize: '14px',
+        fontWeight: 500,
+        cursor: 'pointer',
+    };
+    const fingerprintStyle = {
+        fontSize: '11px',
+        color: '#71717a',
+        fontFamily: 'monospace',
+    };
+    return (_jsx("div", { style: containerStyle, children: _jsxs("div", { style: contentStyle, children: [_jsxs("div", { style: headerStyle, children: [_jsx("div", { style: errorIconStyle, children: "\uD83D\uDCA5" }), _jsxs("div", { style: { flex: 1 }, children: [_jsx("h1", { style: errorTitleStyle, children: error.name }), _jsx("p", { style: errorMessageStyle, children: error.message }), relevantFrame && (_jsxs("p", { style: { ...fingerprintStyle, marginTop: '8px' }, children: [relevantFrame.fileName, ":", relevantFrame.lineNumber] }))] }), _jsx("button", { style: buttonStyle, onClick: onReset, children: "Try Again" })] }), componentNames.length > 0 && (_jsxs("div", { style: sectionStyle, children: [_jsx("div", { style: sectionTitleStyle, children: "Component Tree" }), _jsx("div", { children: componentNames.map((name, i) => (_jsx("span", { style: componentStyle, children: name }, i))) })] })), _jsxs("div", { style: sectionStyle, children: [_jsx("div", { style: sectionTitleStyle, children: "Stack Trace" }), _jsx("div", { style: codeBlockStyle, children: frames.slice(0, 10).map((frame, i) => (_jsxs("div", { style: frameStyle(frame.isAppCode), children: [frame.functionName || '<anonymous>', ' ', _jsxs("span", { style: { color: '#52525b' }, children: ["(", frame.fileName, ":", frame.lineNumber, ")"] })] }, i))) })] }), showBreadcrumbs && breadcrumbs.length > 0 && (_jsxs("div", { style: sectionStyle, children: [_jsxs("div", { style: sectionTitleStyle, children: ["Breadcrumbs (", breadcrumbs.length, " events before crash)"] }), _jsx("div", { style: { ...codeBlockStyle, maxHeight: '250px' }, children: breadcrumbs.slice(-15).map((bc) => (_jsxs("div", { style: breadcrumbStyle, children: [_jsx("span", { style: { flexShrink: 0 }, children: getCategoryIcon(bc.category) }), _jsx("span", { style: { color: '#a1a1aa', flexShrink: 0, width: '70px' }, children: new Date(bc.timestamp).toLocaleTimeString() }), _jsx("span", { style: { flex: 1 }, children: bc.message })] }, bc.id))) })] })), _jsx("div", { style: { ...sectionStyle, marginBottom: 0 }, children: _jsxs("div", { style: fingerprintStyle, children: ["Error fingerprint: ", fingerprint] }) })] }) }));
+}
+/**
+ * Production Error UI Component
+ */
+function ProdErrorUI({ error, onReset, }) {
+    return (_jsxs("div", { role: "alert", style: {
+            padding: '40px 20px',
+            textAlign: 'center',
+            fontFamily: 'system-ui, sans-serif',
+        }, children: [_jsx("div", { style: { fontSize: '48px', marginBottom: '16px' }, children: "\uD83D\uDE35" }), _jsx("h1", { style: { fontSize: '24px', margin: '0 0 8px', color: '#1f2937' }, children: "Something went wrong" }), _jsx("p", { style: { color: '#6b7280', marginBottom: '24px' }, children: "We've been notified and are working on a fix." }), _jsx("button", { onClick: onReset, style: {
+                    padding: '12px 24px',
+                    backgroundColor: '#3b82f6',
+                    color: 'white',
+                    border: 'none',
+                    borderRadius: '8px',
+                    fontSize: '16px',
+                    cursor: 'pointer',
+                }, children: "Try Again" })] }));
+}
+/**
+ * Enhanced Error Boundary Component
+ *
+ * Provides rich error context including:
+ * - Parsed stack traces with app code highlighted
+ * - Breadcrumb trail of events before the error
+ * - React component tree
+ * - Error fingerprinting for grouping
+ *
+ * @example
+ * ```tsx
+ * import { EnhancedErrorBoundary } from '@vestig/next/error'
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <EnhancedErrorBoundary
+ *       showBreadcrumbs
+ *       onError={(err) => sendToErrorService(err)}
+ *     >
+ *       {children}
+ *     </EnhancedErrorBoundary>
+ *   )
+ * }
+ * ```
+ */
+export class EnhancedErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.state = {
+            hasError: false,
+            enhancedError: null,
+        };
+        // Set max breadcrumbs
+        if (props.maxBreadcrumbs) {
+            breadcrumbStore.setMaxSize(props.maxBreadcrumbs);
+        }
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true };
+    }
+    componentDidCatch(error, errorInfo) {
+        const enhancedError = createEnhancedError(error, errorInfo);
+        this.setState({ enhancedError });
+        // Call onError callback
+        this.props.onError?.(enhancedError);
+        // Report to endpoint if configured
+        if (this.props.reportEndpoint) {
+            this.reportError(enhancedError);
+        }
+    }
+    async reportError(enhancedError) {
+        if (!this.props.reportEndpoint)
+            return;
+        try {
+            await fetch(this.props.reportEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    fingerprint: enhancedError.fingerprint,
+                    error: {
+                        name: enhancedError.error.name,
+                        message: enhancedError.error.message,
+                        stack: enhancedError.error.stack,
+                    },
+                    frames: enhancedError.frames,
+                    breadcrumbs: enhancedError.breadcrumbs,
+                    environment: enhancedError.environment,
+                    timestamp: enhancedError.timestamp,
+                }),
+            });
+        }
+        catch {
+            // Silently fail - don't want to cause more errors
+        }
+    }
+    handleReset = () => {
+        this.setState({
+            hasError: false,
+            enhancedError: null,
+        });
+        breadcrumbStore.clear();
+    };
+    render() {
+        const { hasError, enhancedError } = this.state;
+        const { children, fallback, showBreadcrumbs = true } = this.props;
+        if (hasError && enhancedError) {
+            // Custom fallback
+            if (typeof fallback === 'function') {
+                return fallback(enhancedError);
+            }
+            if (fallback !== undefined) {
+                return fallback;
+            }
+            // Development UI
+            if (process.env.NODE_ENV === 'development') {
+                return (_jsx(DevErrorUI, { enhancedError: enhancedError, onReset: this.handleReset, showBreadcrumbs: showBreadcrumbs }));
+            }
+            // Production UI
+            return _jsx(ProdErrorUI, { error: enhancedError.error, onReset: this.handleReset });
+        }
+        return children;
+    }
+}
+//# sourceMappingURL=boundary.js.map

package/dist/error/boundary.js.map

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

package/dist/error/breadcrumbs.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Breadcrumb System
+ *
+ * Captures user actions and events leading up to an error.
+ * Provides context for debugging by showing what happened before the crash.
+ *
+ * @packageDocumentation
+ */
+import type { Breadcrumb, BreadcrumbCategory, BreadcrumbStore } from './types';
+/**
+ * Global breadcrumb store singleton
+ */
+export declare const breadcrumbStore: BreadcrumbStore;
+/**
+ * Add a log breadcrumb
+ *
+ * @example
+ * ```ts
+ * addLogBreadcrumb('info', 'User clicked button', 'ui')
+ * ```
+ */
+export declare function addLogBreadcrumb(level: Breadcrumb['level'], message: string, namespace?: string, data?: Record<string, unknown>): void;
+/**
+ * Add a navigation breadcrumb
+ *
+ * @example
+ * ```ts
+ * addNavigationBreadcrumb('/dashboard', '/settings')
+ * ```
+ */
+export declare function addNavigationBreadcrumb(from: string, to: string): void;
+/**
+ * Add a click breadcrumb
+ *
+ * @example
+ * ```ts
+ * addClickBreadcrumb('Submit button', 'button#submit')
+ * ```
+ */
+export declare function addClickBreadcrumb(elementDescription: string, selector?: string): void;
+/**
+ * Add an input breadcrumb (sanitizes sensitive data)
+ *
+ * @example
+ * ```ts
+ * addInputBreadcrumb('email', 'user@example.com', 'input#email')
+ * ```
+ */
+export declare function addInputBreadcrumb(fieldName: string, value?: string, selector?: string): void;
+/**
+ * Add a fetch/API breadcrumb
+ *
+ * @example
+ * ```ts
+ * addFetchBreadcrumb('GET', '/api/users', 200, 150)
+ * ```
+ */
+export declare function addFetchBreadcrumb(method: string, url: string, status?: number, durationMs?: number): void;
+/**
+ * Add an error breadcrumb (for non-fatal errors)
+ *
+ * @example
+ * ```ts
+ * addErrorBreadcrumb('Failed to load user preferences', error)
+ * ```
+ */
+export declare function addErrorBreadcrumb(message: string, error?: Error): void;
+/**
+ * Add a custom breadcrumb
+ *
+ * @example
+ * ```ts
+ * addCustomBreadcrumb('Feature flag enabled', { flag: 'new-dashboard' })
+ * ```
+ */
+export declare function addCustomBreadcrumb(message: string, data?: Record<string, unknown>): void;
+/**
+ * Setup automatic click tracking
+ * Call this once in your app to capture click breadcrumbs
+ */
+export declare function setupClickTracking(): () => void;
+/**
+ * Setup automatic fetch tracking
+ * Patches global fetch to capture API call breadcrumbs
+ */
+export declare function setupFetchTracking(): () => void;
+/**
+ * Format breadcrumbs for display
+ */
+export declare function formatBreadcrumbs(breadcrumbs: Breadcrumb[]): string;
+/**
+ * Get category icon for display
+ */
+export declare function getCategoryIcon(category: BreadcrumbCategory): string;
+//# sourceMappingURL=breadcrumbs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/error/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAqD9E;;GAEG;AACH,eAAO,MAAM,eAAe,iBAA0B,CAAA;AAEtD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAC1B,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAQN;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAMtE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAMtF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAc7F;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GACjB,IAAI,CAWN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAYvE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMzF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,IAAI,CAoC/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,IAAI,CA2B/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAQnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAWpE"}