@pga-ai/core 0.4.0

package/dist/monitoring/MonitoringDashboard.d.ts

@@ -0,0 +1,38 @@
+import type { MetricsCollector } from './MetricsCollector.js';
+export interface DashboardConfig {
+    refreshInterval?: number;
+    showPerformance?: boolean;
+    showCost?: boolean;
+    showHealth?: boolean;
+    showAlerts?: boolean;
+    showAuditLogs?: boolean;
+    maxLogs?: number;
+}
+export declare class MonitoringDashboard {
+    private config;
+    private metricsCollector;
+    private intervalId?;
+    private isRunning;
+    constructor(metricsCollector: MetricsCollector, config?: DashboardConfig);
+    start(): void;
+    stop(): void;
+    renderSnapshot(): void;
+    private render;
+    private renderHealth;
+    private renderPerformance;
+    private renderCost;
+    private renderAlerts;
+    private renderAuditLogs;
+    private getStatusIcon;
+    private getStatusColor;
+    private getComponentStatus;
+    private getSeverityIcon;
+    private getSeverityColor;
+    private getLogLevelIcon;
+    private formatDuration;
+    private formatLatency;
+    private formatPercentage;
+    private truncate;
+    private colors;
+}
+//# sourceMappingURL=MonitoringDashboard.d.ts.map

package/dist/monitoring/MonitoringDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitoringDashboard.d.ts","sourceRoot":"","sources":["../../src/monitoring/MonitoringDashboard.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,eAAe;IAK5B,eAAe,CAAC,EAAE,MAAM,CAAC;IAMzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAM1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAMnB,UAAU,CAAC,EAAE,OAAO,CAAC;IAMrB,UAAU,CAAC,EAAE,OAAO,CAAC;IAMrB,aAAa,CAAC,EAAE,OAAO,CAAC;IAMxB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,SAAS,CAAS;gBAEd,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,GAAE,eAAoB;IAgB5E,KAAK,IAAI,IAAI;IAqBb,IAAI,IAAI,IAAI;IAaZ,cAAc,IAAI,IAAI;IAOtB,OAAO,CAAC,MAAM;IAsCd,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,MAAM,CAOZ;CACL"}

package/dist/monitoring/MonitoringDashboard.js

@@ -0,0 +1,271 @@
+export class MonitoringDashboard {
+    config;
+    metricsCollector;
+    intervalId;
+    isRunning = false;
+    constructor(metricsCollector, config = {}) {
+        this.metricsCollector = metricsCollector;
+        this.config = {
+            refreshInterval: config.refreshInterval ?? 2000,
+            showPerformance: config.showPerformance ?? true,
+            showCost: config.showCost ?? true,
+            showHealth: config.showHealth ?? true,
+            showAlerts: config.showAlerts ?? true,
+            showAuditLogs: config.showAuditLogs ?? false,
+            maxLogs: config.maxLogs ?? 5,
+        };
+    }
+    start() {
+        if (this.isRunning) {
+            console.warn('Dashboard is already running');
+            return;
+        }
+        this.isRunning = true;
+        this.render();
+        this.intervalId = setInterval(() => {
+            this.render();
+        }, this.config.refreshInterval);
+        console.log('\n📊 Monitoring Dashboard Started');
+        console.log(`Refreshing every ${this.config.refreshInterval}ms`);
+        console.log('Press Ctrl+C to stop\n');
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+        this.isRunning = false;
+        console.log('\n📊 Monitoring Dashboard Stopped\n');
+    }
+    renderSnapshot() {
+        this.render();
+    }
+    render() {
+        if (process.stdout.isTTY) {
+            process.stdout.write('\x1Bc');
+        }
+        const timestamp = new Date().toISOString();
+        console.log('╔════════════════════════════════════════════════════════════════╗');
+        console.log('║       PGA MONITORING DASHBOARD — Real-Time Metrics            ║');
+        console.log('╠════════════════════════════════════════════════════════════════╣');
+        console.log(`║ Updated: ${timestamp}                       ║`);
+        console.log('╚════════════════════════════════════════════════════════════════╝\n');
+        if (this.config.showHealth) {
+            this.renderHealth();
+        }
+        if (this.config.showPerformance) {
+            this.renderPerformance();
+        }
+        if (this.config.showCost) {
+            this.renderCost();
+        }
+        if (this.config.showAlerts) {
+            this.renderAlerts();
+        }
+        if (this.config.showAuditLogs) {
+            this.renderAuditLogs();
+        }
+    }
+    renderHealth() {
+        const health = this.metricsCollector.getHealthStatus();
+        console.log('┌─ SYSTEM HEALTH ─────────────────────────────────────────────┐');
+        const statusIcon = this.getStatusIcon(health.status);
+        const statusColor = this.getStatusColor(health.status);
+        console.log(`│ Status: ${statusColor}${statusIcon} ${health.status.toUpperCase()}${this.colors.reset}`);
+        console.log('│');
+        console.log('│ Components:');
+        console.log(`│   LLM:     ${this.getComponentStatus(health.components.llm)}`);
+        console.log(`│   Storage: ${this.getComponentStatus(health.components.storage)}`);
+        console.log(`│   Genome:  ${this.getComponentStatus(health.components.genome)}`);
+        console.log('│');
+        console.log(`│ Uptime:       ${this.formatDuration(health.uptime)}`);
+        console.log(`│ Memory:       ${health.memoryUsage.toFixed(1)} MB`);
+        console.log('└─────────────────────────────────────────────────────────────┘\n');
+    }
+    renderPerformance() {
+        const perf = this.metricsCollector.getPerformanceMetrics();
+        console.log('┌─ PERFORMANCE ───────────────────────────────────────────────┐');
+        console.log(`│ Total Requests:    ${perf.totalRequests.toLocaleString()}`);
+        console.log(`│ Successful:        ${perf.successfulRequests.toLocaleString()} (${this.formatPercentage(perf.successRate)})`);
+        console.log(`│ Failed:            ${perf.failedRequests.toLocaleString()}`);
+        console.log('│');
+        console.log(`│ Avg Response Time: ${this.formatLatency(perf.avgResponseTime)}`);
+        console.log(`│ P95:               ${this.formatLatency(perf.p95ResponseTime)}`);
+        console.log(`│ P99:               ${this.formatLatency(perf.p99ResponseTime)}`);
+        console.log('│');
+        console.log(`│ Total Tokens:      ${perf.totalTokens.toLocaleString()}`);
+        console.log(`│ Avg/Request:       ${perf.avgTokensPerRequest.toFixed(0)}`);
+        console.log('└─────────────────────────────────────────────────────────────┘\n');
+    }
+    renderCost() {
+        const cost = this.metricsCollector.getCostMetrics();
+        console.log('┌─ COSTS ─────────────────────────────────────────────────────┐');
+        console.log(`│ Total Cost:        $${cost.totalCost.toFixed(4)}`);
+        console.log(`│ Avg/Request:       $${cost.avgCostPerRequest.toFixed(6)}`);
+        console.log('│');
+        console.log(`│ Input Tokens:      ${cost.totalInputTokens.toLocaleString()} ($${cost.inputTokensCost.toFixed(4)})`);
+        console.log(`│ Output Tokens:     ${cost.totalOutputTokens.toLocaleString()} ($${cost.outputTokensCost.toFixed(4)})`);
+        if (Object.keys(cost.costByModel).length > 0) {
+            console.log('│');
+            console.log('│ By Model:');
+            for (const [model, modelCost] of Object.entries(cost.costByModel)) {
+                const modelName = this.truncate(model, 20);
+                console.log(`│   ${modelName.padEnd(20)} $${modelCost.toFixed(6)}`);
+            }
+        }
+        console.log('└─────────────────────────────────────────────────────────────┘\n');
+    }
+    renderAlerts() {
+        const alerts = this.metricsCollector.getAlerts();
+        console.log('┌─ ACTIVE ALERTS ─────────────────────────────────────────────┐');
+        if (alerts.length === 0) {
+            console.log(`│ ${this.colors.green}✓ No active alerts${this.colors.reset}`);
+        }
+        else {
+            for (const alert of alerts.slice(0, 5)) {
+                const severityIcon = this.getSeverityIcon(alert.severity);
+                const severityColor = this.getSeverityColor(alert.severity);
+                console.log(`│ ${severityColor}${severityIcon} [${alert.severity.toUpperCase()}] ${alert.title}${this.colors.reset}`);
+                console.log(`│   ${this.truncate(alert.description, 58)}`);
+                console.log('│');
+            }
+            if (alerts.length > 5) {
+                console.log(`│ ... and ${alerts.length - 5} more alerts`);
+            }
+        }
+        console.log('└─────────────────────────────────────────────────────────────┘\n');
+    }
+    renderAuditLogs() {
+        const logs = this.metricsCollector.getAuditLogs(this.config.maxLogs);
+        console.log('┌─ RECENT ACTIVITY ───────────────────────────────────────────┐');
+        if (logs.length === 0) {
+            console.log('│ No recent activity');
+        }
+        else {
+            for (const log of logs.reverse()) {
+                const levelIcon = this.getLogLevelIcon(log.level);
+                const time = log.timestamp.toLocaleTimeString();
+                console.log(`│ ${levelIcon} [${time}] ${log.component}.${log.operation}`);
+                console.log(`│   ${this.truncate(log.message, 58)}`);
+                console.log('│');
+            }
+        }
+        console.log('└─────────────────────────────────────────────────────────────┘\n');
+    }
+    getStatusIcon(status) {
+        switch (status) {
+            case 'healthy':
+                return '✓';
+            case 'degraded':
+                return '⚠';
+            case 'unhealthy':
+                return '✗';
+            default:
+                return '?';
+        }
+    }
+    getStatusColor(status) {
+        switch (status) {
+            case 'healthy':
+                return this.colors.green;
+            case 'degraded':
+                return this.colors.yellow;
+            case 'unhealthy':
+                return this.colors.red;
+            default:
+                return this.colors.reset;
+        }
+    }
+    getComponentStatus(component) {
+        const icon = component.status === 'up' ? '●' : component.status === 'degraded' ? '◐' : '○';
+        const color = component.status === 'up'
+            ? this.colors.green
+            : component.status === 'degraded'
+                ? this.colors.yellow
+                : this.colors.red;
+        let statusStr = `${color}${icon} ${component.status}${this.colors.reset}`;
+        if (component.latency) {
+            statusStr += ` (${component.latency.toFixed(0)}ms)`;
+        }
+        return statusStr;
+    }
+    getSeverityIcon(severity) {
+        switch (severity) {
+            case 'low':
+                return 'ℹ';
+            case 'medium':
+                return '⚠';
+            case 'high':
+                return '⚠';
+            case 'critical':
+                return '🚨';
+            default:
+                return '?';
+        }
+    }
+    getSeverityColor(severity) {
+        switch (severity) {
+            case 'low':
+                return this.colors.blue;
+            case 'medium':
+                return this.colors.yellow;
+            case 'high':
+                return this.colors.orange;
+            case 'critical':
+                return this.colors.red;
+            default:
+                return this.colors.reset;
+        }
+    }
+    getLogLevelIcon(level) {
+        switch (level) {
+            case 'info':
+                return 'ℹ';
+            case 'warning':
+                return '⚠';
+            case 'error':
+                return '✗';
+            case 'critical':
+                return '🚨';
+            default:
+                return '·';
+        }
+    }
+    formatDuration(seconds) {
+        if (seconds < 60) {
+            return `${seconds.toFixed(0)}s`;
+        }
+        else if (seconds < 3600) {
+            return `${(seconds / 60).toFixed(1)}m`;
+        }
+        else {
+            return `${(seconds / 3600).toFixed(1)}h`;
+        }
+    }
+    formatLatency(ms) {
+        if (ms < 1000) {
+            return `${ms.toFixed(0)}ms`;
+        }
+        else {
+            return `${(ms / 1000).toFixed(2)}s`;
+        }
+    }
+    formatPercentage(value) {
+        return `${(value * 100).toFixed(1)}%`;
+    }
+    truncate(str, maxLength) {
+        if (str.length <= maxLength) {
+            return str;
+        }
+        return str.substring(0, maxLength - 3) + '...';
+    }
+    colors = {
+        reset: '\x1b[0m',
+        green: '\x1b[32m',
+        yellow: '\x1b[33m',
+        red: '\x1b[31m',
+        blue: '\x1b[34m',
+        orange: '\x1b[38;5;208m',
+    };
+}
+//# sourceMappingURL=MonitoringDashboard.js.map

package/dist/monitoring/MonitoringDashboard.js.map

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

package/dist/plugins/PluginManager.d.ts

@@ -0,0 +1,61 @@
+export interface PluginMetadata {
+    name: string;
+    version: string;
+    author?: string;
+    description?: string;
+    homepage?: string;
+    tags?: string[];
+    dependencies?: string[];
+}
+export interface PluginHooks {
+    onLoad?: () => void | Promise<void>;
+    onUnload?: () => void | Promise<void>;
+    beforeGenomeCreate?: (config: unknown) => unknown | Promise<unknown>;
+    afterGenomeCreate?: (genome: unknown) => void | Promise<void>;
+    beforeChat?: (message: string, context: unknown) => string | Promise<string>;
+    afterChat?: (response: unknown) => unknown | Promise<unknown>;
+    beforeMutation?: (proposal: unknown) => unknown | Promise<unknown>;
+    afterMutation?: (result: unknown) => void | Promise<void>;
+    onMetricsUpdate?: (metrics: unknown) => void | Promise<void>;
+    onAlert?: (alert: unknown) => void | Promise<void>;
+}
+export interface Plugin {
+    metadata: PluginMetadata;
+    hooks: PluginHooks;
+    api?: Record<string, (...args: unknown[]) => unknown>;
+}
+export interface PluginConfig {
+    enabled?: boolean;
+    config?: Record<string, unknown>;
+}
+export declare class PluginManager {
+    private plugins;
+    private hookOrder;
+    register(plugin: Plugin, config?: PluginConfig): Promise<void>;
+    unregister(name: string): Promise<void>;
+    enable(name: string): Promise<void>;
+    disable(name: string): Promise<void>;
+    callHook<K extends keyof PluginHooks>(hookName: K, ...args: Parameters<NonNullable<PluginHooks[K]>>): Promise<unknown>;
+    setHookOrder(hookName: keyof PluginHooks, order: string[]): void;
+    getPluginAPI(name: string): Record<string, (...args: unknown[]) => unknown> | undefined;
+    callPluginAPI(name: string, method: string, ...args: unknown[]): Promise<unknown>;
+    list(): Array<{
+        name: string;
+        version: string;
+        author?: string;
+        description?: string;
+        enabled: boolean;
+        loadedAt: Date;
+    }>;
+    search(tag: string): Plugin[];
+    getMetadata(name: string): PluginMetadata | undefined;
+    getConfig(name: string): Record<string, unknown> | undefined;
+    updateConfig(name: string, config: Record<string, unknown>): void;
+    getStats(): {
+        totalPlugins: number;
+        enabledPlugins: number;
+        disabledPlugins: number;
+        pluginsByTag: Record<string, number>;
+    };
+}
+//# sourceMappingURL=PluginManager.d.ts.map

package/dist/plugins/PluginManager.d.ts.map

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

package/dist/plugins/PluginManager.js

@@ -0,0 +1,154 @@
+export class PluginManager {
+    plugins = new Map();
+    hookOrder = new Map();
+    async register(plugin, config = {}) {
+        const name = plugin.metadata.name;
+        if (plugin.metadata.dependencies) {
+            for (const dep of plugin.metadata.dependencies) {
+                if (!this.plugins.has(dep)) {
+                    throw new Error(`Plugin ${name} requires dependency: ${dep}`);
+                }
+            }
+        }
+        if (this.plugins.has(name)) {
+            throw new Error(`Plugin ${name} is already registered`);
+        }
+        this.plugins.set(name, {
+            plugin,
+            config: {
+                enabled: config.enabled ?? true,
+                config: config.config || {},
+            },
+            loadedAt: new Date(),
+        });
+        if (config.enabled !== false && plugin.hooks.onLoad) {
+            await plugin.hooks.onLoad();
+        }
+    }
+    async unregister(name) {
+        const loaded = this.plugins.get(name);
+        if (!loaded) {
+            throw new Error(`Plugin ${name} is not registered`);
+        }
+        if (loaded.plugin.hooks.onUnload) {
+            await loaded.plugin.hooks.onUnload();
+        }
+        this.plugins.delete(name);
+    }
+    async enable(name) {
+        const loaded = this.plugins.get(name);
+        if (!loaded) {
+            throw new Error(`Plugin ${name} is not registered`);
+        }
+        if (loaded.config.enabled) {
+            return;
+        }
+        loaded.config.enabled = true;
+        if (loaded.plugin.hooks.onLoad) {
+            await loaded.plugin.hooks.onLoad();
+        }
+    }
+    async disable(name) {
+        const loaded = this.plugins.get(name);
+        if (!loaded) {
+            throw new Error(`Plugin ${name} is not registered`);
+        }
+        if (!loaded.config.enabled) {
+            return;
+        }
+        loaded.config.enabled = false;
+        if (loaded.plugin.hooks.onUnload) {
+            await loaded.plugin.hooks.onUnload();
+        }
+    }
+    async callHook(hookName, ...args) {
+        let result = args[0];
+        const order = this.hookOrder.get(hookName) || Array.from(this.plugins.keys());
+        for (const name of order) {
+            const loaded = this.plugins.get(name);
+            if (!loaded || !loaded.config.enabled) {
+                continue;
+            }
+            const hook = loaded.plugin.hooks[hookName];
+            if (!hook) {
+                continue;
+            }
+            try {
+                const hookResult = await hook(result, ...args.slice(1));
+                if (hookResult !== undefined) {
+                    result = hookResult;
+                }
+            }
+            catch (error) {
+                console.error(`Error in plugin ${name} hook ${hookName}:`, error);
+            }
+        }
+        return result;
+    }
+    setHookOrder(hookName, order) {
+        this.hookOrder.set(hookName, order);
+    }
+    getPluginAPI(name) {
+        const loaded = this.plugins.get(name);
+        if (!loaded || !loaded.config.enabled) {
+            return undefined;
+        }
+        return loaded.plugin.api;
+    }
+    async callPluginAPI(name, method, ...args) {
+        const api = this.getPluginAPI(name);
+        if (!api) {
+            throw new Error(`Plugin ${name} is not available`);
+        }
+        const fn = api[method];
+        if (!fn) {
+            throw new Error(`Plugin ${name} does not have method: ${method}`);
+        }
+        return await fn(...args);
+    }
+    list() {
+        return Array.from(this.plugins.entries()).map(([name, loaded]) => ({
+            name,
+            version: loaded.plugin.metadata.version,
+            author: loaded.plugin.metadata.author,
+            description: loaded.plugin.metadata.description,
+            enabled: loaded.config.enabled ?? true,
+            loadedAt: loaded.loadedAt,
+        }));
+    }
+    search(tag) {
+        return Array.from(this.plugins.values())
+            .filter((loaded) => loaded.plugin.metadata.tags?.includes(tag))
+            .map((loaded) => loaded.plugin);
+    }
+    getMetadata(name) {
+        return this.plugins.get(name)?.plugin.metadata;
+    }
+    getConfig(name) {
+        return this.plugins.get(name)?.config.config;
+    }
+    updateConfig(name, config) {
+        const loaded = this.plugins.get(name);
+        if (!loaded) {
+            throw new Error(`Plugin ${name} is not registered`);
+        }
+        loaded.config.config = { ...loaded.config.config, ...config };
+    }
+    getStats() {
+        const plugins = Array.from(this.plugins.values());
+        const enabled = plugins.filter((p) => p.config.enabled).length;
+        const pluginsByTag = {};
+        for (const loaded of plugins) {
+            for (const tag of loaded.plugin.metadata.tags || []) {
+                pluginsByTag[tag] = (pluginsByTag[tag] || 0) + 1;
+            }
+        }
+        return {
+            totalPlugins: plugins.length,
+            enabledPlugins: enabled,
+            disabledPlugins: plugins.length - enabled,
+            pluginsByTag,
+        };
+    }
+}
+//# sourceMappingURL=PluginManager.js.map

package/dist/plugins/PluginManager.js.map

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

package/dist/rag/RAGEngine.d.ts

@@ -0,0 +1,54 @@
+import type { LLMAdapter } from '../interfaces/LLMAdapter.js';
+import type { VectorStoreAdapter } from './VectorStoreAdapter.js';
+import type { MetricsCollector } from '../monitoring/MetricsCollector.js';
+export interface RAGDocument {
+    id: string;
+    content: string;
+    metadata: Record<string, any>;
+    embedding?: number[];
+}
+export interface RAGSearchResult {
+    document: RAGDocument;
+    score: number;
+    relevance: number;
+}
+export interface RAGContext {
+    query: string;
+    results: RAGSearchResult[];
+    augmentedPrompt: string;
+    totalTokens: number;
+}
+export interface RAGConfig {
+    enabled: boolean;
+    vectorStore: VectorStoreAdapter;
+    embeddings: {
+        model: string;
+        dimensions: number;
+    };
+    search: {
+        topK: number;
+        minScore: number;
+        hybridSearch: boolean;
+    };
+    context: {
+        maxTokens: number;
+        includeMetadata: boolean;
+    };
+}
+export declare class RAGEngine {
+    private llm;
+    private metricsCollector?;
+    private config;
+    constructor(llm: LLMAdapter, config: RAGConfig, metricsCollector?: MetricsCollector | undefined);
+    retrieve(query: string): Promise<RAGSearchResult[]>;
+    augment(query: string, basePrompt: string): Promise<RAGContext>;
+    generate(query: string, basePrompt: string): Promise<string>;
+    indexDocument(document: RAGDocument): Promise<void>;
+    indexDocuments(documents: RAGDocument[]): Promise<void>;
+    deleteDocument(documentId: string): Promise<void>;
+    private generateEmbedding;
+    private buildAugmentedPrompt;
+    private formatRetrievedContext;
+    private estimateTokens;
+}
+//# sourceMappingURL=RAGEngine.d.ts.map

package/dist/rag/RAGEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RAGEngine.d.ts","sourceRoot":"","sources":["../../src/rag/RAGEngine.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAI1E,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,SAAS;IACtB,OAAO,EAAE,OAAO,CAAC;IAEjB,WAAW,EAAE,kBAAkB,CAAC;IAEhC,UAAU,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,MAAM,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,OAAO,CAAC;KACzB,CAAC;IAEF,OAAO,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;KAC5B,CAAC;CACL;AAID,qBAAa,SAAS;IAId,OAAO,CAAC,GAAG;IAEX,OAAO,CAAC,gBAAgB,CAAC;IAL7B,OAAO,CAAC,MAAM,CAAY;gBAGd,GAAG,EAAE,UAAU,EACvB,MAAM,EAAE,SAAS,EACT,gBAAgB,CAAC,EAAE,gBAAgB,YAAA;IAQzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyDnD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAqB/D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB5D,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAanD,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDvD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAMzC,iBAAiB;IAM/B,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,cAAc;CAIzB"}