@intentsolutions/blueprint 2.6.0 → 2.8.0

package/dist/analytics/dashboard.js

@@ -0,0 +1,346 @@
+/**
+ * Analytics Dashboard
+ * Generates usage reports and visualizations
+ */
+/**
+ * Analytics Dashboard
+ */
+export class AnalyticsDashboard {
+    collector;
+    constructor(collector) {
+        this.collector = collector;
+    }
+    /**
+     * Get dashboard data
+     */
+    async getData(options = { period: 'month', format: 'table' }) {
+        const days = this.periodToDays(options.period);
+        const events = this.collector.loadEvents(days);
+        return {
+            summary: this.calculateSummary(events, options.period),
+            templateStats: this.calculateTemplateStats(events),
+            packStats: this.calculatePackStats(events),
+            recentSessions: this.calculateSessionStats(events),
+            errors: this.calculateErrorStats(events),
+        };
+    }
+    /**
+     * Convert period to days
+     */
+    periodToDays(period) {
+        switch (period) {
+            case 'day': return 1;
+            case 'week': return 7;
+            case 'month': return 30;
+            case 'quarter': return 90;
+            case 'year': return 365;
+            case 'all': return 3650;
+            default: return 30;
+        }
+    }
+    /**
+     * Calculate usage summary
+     */
+    calculateSummary(events, period) {
+        const days = this.periodToDays(period);
+        const start = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
+        const end = new Date();
+        // Count totals
+        const sessions = new Set(events.map(e => e.sessionId)).size;
+        const generations = events.filter(e => e.type === 'template_generated').length;
+        const exports = events.filter(e => e.type === 'export_completed').length;
+        const errors = events.filter(e => e.type === 'error_occurred').length;
+        // Top templates
+        const templateCounts = new Map();
+        for (const event of events.filter(e => e.type === 'template_generated')) {
+            const id = event.data.templateId;
+            const existing = templateCounts.get(id) || { id, name: id, count: 0 };
+            existing.count++;
+            templateCounts.set(id, existing);
+        }
+        const topTemplates = Array.from(templateCounts.values())
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 5);
+        // Top packs
+        const packCounts = new Map();
+        for (const event of events.filter(e => e.type === 'pack_installed')) {
+            const id = event.data.packId;
+            const existing = packCounts.get(id) || { id, name: id, count: 0 };
+            existing.count++;
+            packCounts.set(id, existing);
+        }
+        const topPacks = Array.from(packCounts.values())
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 5);
+        // Daily activity
+        const dailyActivity = new Map();
+        for (const event of events) {
+            const date = event.timestamp.split('T')[0];
+            const existing = dailyActivity.get(date) || { date, generations: 0, sessions: new Set() };
+            if (event.type === 'template_generated') {
+                existing.generations++;
+            }
+            existing.sessions.add(event.sessionId);
+            dailyActivity.set(date, existing);
+        }
+        const dailyActivityArray = Array.from(dailyActivity.values())
+            .map(d => ({ date: d.date, generations: d.generations, sessions: d.sessions.size }))
+            .sort((a, b) => a.date.localeCompare(b.date));
+        return {
+            period: {
+                start: start.toISOString(),
+                end: end.toISOString(),
+            },
+            totals: { sessions, generations, exports, errors },
+            topTemplates,
+            topPacks,
+            dailyActivity: dailyActivityArray,
+        };
+    }
+    /**
+     * Calculate template statistics
+     */
+    calculateTemplateStats(events) {
+        const templateMap = new Map();
+        for (const event of events.filter(e => e.type === 'template_generated')) {
+            const id = event.data.templateId;
+            const existing = templateMap.get(id) || {
+                templateId: id,
+                generations: 0,
+                users: new Set(),
+                durations: [],
+                variables: new Map(),
+                formats: new Map(),
+                lastUsed: event.timestamp,
+            };
+            existing.generations++;
+            if (event.userId)
+                existing.users.add(event.userId);
+            if (event.data.duration)
+                existing.durations.push(event.data.duration);
+            if (event.data.format) {
+                const format = event.data.format;
+                existing.formats.set(format, (existing.formats.get(format) || 0) + 1);
+            }
+            if (event.timestamp > existing.lastUsed) {
+                existing.lastUsed = event.timestamp;
+            }
+            templateMap.set(id, existing);
+        }
+        return Array.from(templateMap.values()).map(t => ({
+            templateId: t.templateId,
+            templateName: t.templateId, // Would be resolved from template registry
+            totalGenerations: t.generations,
+            uniqueUsers: t.users.size,
+            avgCompletionTime: t.durations.length > 0
+                ? t.durations.reduce((a, b) => a + b, 0) / t.durations.length
+                : 0,
+            lastUsed: t.lastUsed,
+            popularVariables: Array.from(t.variables.entries())
+                .map(([name, count]) => ({ name, count }))
+                .sort((a, b) => b.count - a.count)
+                .slice(0, 5),
+            commonOutputFormats: Array.from(t.formats.entries())
+                .map(([format, count]) => ({ format, count }))
+                .sort((a, b) => b.count - a.count),
+        })).sort((a, b) => b.totalGenerations - a.totalGenerations);
+    }
+    /**
+     * Calculate pack statistics
+     */
+    calculatePackStats(events) {
+        const packMap = new Map();
+        for (const event of events) {
+            if (event.type === 'pack_installed' || event.type === 'pack_uninstalled') {
+                const id = event.data.packId;
+                const existing = packMap.get(id) || {
+                    packId: id,
+                    installs: 0,
+                    uninstalls: 0,
+                    lastUpdated: event.timestamp,
+                };
+                if (event.type === 'pack_installed') {
+                    existing.installs++;
+                }
+                else {
+                    existing.uninstalls++;
+                }
+                if (event.timestamp > existing.lastUpdated) {
+                    existing.lastUpdated = event.timestamp;
+                }
+                packMap.set(id, existing);
+            }
+        }
+        return Array.from(packMap.values()).map(p => ({
+            packId: p.packId,
+            packName: p.packId, // Would be resolved from pack registry
+            totalInstalls: p.installs,
+            activeInstalls: p.installs - p.uninstalls,
+            uninstalls: p.uninstalls,
+            lastUpdated: p.lastUpdated,
+        })).sort((a, b) => b.totalInstalls - a.totalInstalls);
+    }
+    /**
+     * Calculate session statistics
+     */
+    calculateSessionStats(events) {
+        const sessionMap = new Map();
+        for (const event of events) {
+            const existing = sessionMap.get(event.sessionId) || {
+                sessionId: event.sessionId,
+                events: [],
+                startTime: event.timestamp,
+            };
+            existing.events.push(event);
+            if (event.timestamp < existing.startTime) {
+                existing.startTime = event.timestamp;
+            }
+            if (event.type === 'session_ended') {
+                existing.endTime = event.timestamp;
+            }
+            sessionMap.set(event.sessionId, existing);
+        }
+        return Array.from(sessionMap.values())
+            .map(s => ({
+            sessionId: s.sessionId,
+            startTime: s.startTime,
+            endTime: s.endTime,
+            duration: s.endTime
+                ? new Date(s.endTime).getTime() - new Date(s.startTime).getTime()
+                : undefined,
+            eventsCount: s.events.length,
+            templatesGenerated: s.events.filter(e => e.type === 'template_generated').length,
+            errors: s.events.filter(e => e.type === 'error_occurred').length,
+        }))
+            .sort((a, b) => b.startTime.localeCompare(a.startTime))
+            .slice(0, 10);
+    }
+    /**
+     * Calculate error statistics
+     */
+    calculateErrorStats(events) {
+        const errorMap = new Map();
+        for (const event of events.filter(e => e.type === 'error_occurred')) {
+            const type = event.data.errorType;
+            const existing = errorMap.get(type) || { type, count: 0, lastOccurred: event.timestamp };
+            existing.count++;
+            if (event.timestamp > existing.lastOccurred) {
+                existing.lastOccurred = event.timestamp;
+            }
+            errorMap.set(type, existing);
+        }
+        return Array.from(errorMap.values()).sort((a, b) => b.count - a.count);
+    }
+    /**
+     * Format dashboard data as table
+     */
+    formatAsTable(data) {
+        const lines = [];
+        // Header
+        lines.push('═══════════════════════════════════════════════════════════════════');
+        lines.push('                     INTENT BLUEPRINT ANALYTICS                     ');
+        lines.push('═══════════════════════════════════════════════════════════════════');
+        lines.push('');
+        // Summary
+        lines.push('USAGE SUMMARY');
+        lines.push('─────────────────────────────────────────────────────────────────────');
+        lines.push(`Period: ${data.summary.period.start.split('T')[0]} to ${data.summary.period.end.split('T')[0]}`);
+        lines.push('');
+        lines.push(`  Sessions:    ${data.summary.totals.sessions.toString().padStart(8)}`);
+        lines.push(`  Generations: ${data.summary.totals.generations.toString().padStart(8)}`);
+        lines.push(`  Exports:     ${data.summary.totals.exports.toString().padStart(8)}`);
+        lines.push(`  Errors:      ${data.summary.totals.errors.toString().padStart(8)}`);
+        lines.push('');
+        // Top Templates
+        if (data.summary.topTemplates.length > 0) {
+            lines.push('TOP TEMPLATES');
+            lines.push('─────────────────────────────────────────────────────────────────────');
+            for (const t of data.summary.topTemplates) {
+                lines.push(`  ${t.name.padEnd(40)} ${t.count.toString().padStart(5)} uses`);
+            }
+            lines.push('');
+        }
+        // Top Packs
+        if (data.summary.topPacks.length > 0) {
+            lines.push('TOP PACKS');
+            lines.push('─────────────────────────────────────────────────────────────────────');
+            for (const p of data.summary.topPacks) {
+                lines.push(`  ${p.name.padEnd(40)} ${p.count.toString().padStart(5)} installs`);
+            }
+            lines.push('');
+        }
+        // Recent Sessions
+        if (data.recentSessions.length > 0) {
+            lines.push('RECENT SESSIONS');
+            lines.push('─────────────────────────────────────────────────────────────────────');
+            for (const s of data.recentSessions.slice(0, 5)) {
+                const duration = s.duration ? `${Math.round(s.duration / 1000 / 60)}m` : 'active';
+                lines.push(`  ${s.startTime.split('T')[0]} ${duration.padStart(8)} │ ${s.templatesGenerated} templates, ${s.errors} errors`);
+            }
+            lines.push('');
+        }
+        // Errors
+        if (data.errors && data.errors.length > 0) {
+            lines.push('ERROR SUMMARY');
+            lines.push('─────────────────────────────────────────────────────────────────────');
+            for (const e of data.errors.slice(0, 5)) {
+                lines.push(`  ${e.type.padEnd(30)} ${e.count.toString().padStart(5)}x │ Last: ${e.lastOccurred.split('T')[0]}`);
+            }
+            lines.push('');
+        }
+        lines.push('═══════════════════════════════════════════════════════════════════');
+        return lines.join('\n');
+    }
+    /**
+     * Format dashboard data as JSON
+     */
+    formatAsJson(data) {
+        return JSON.stringify(data, null, 2);
+    }
+    /**
+     * Format dashboard data as CSV
+     */
+    formatAsCsv(data) {
+        const lines = [];
+        // Summary section
+        lines.push('Section,Metric,Value');
+        lines.push(`Summary,Sessions,${data.summary.totals.sessions}`);
+        lines.push(`Summary,Generations,${data.summary.totals.generations}`);
+        lines.push(`Summary,Exports,${data.summary.totals.exports}`);
+        lines.push(`Summary,Errors,${data.summary.totals.errors}`);
+        lines.push('');
+        // Templates section
+        lines.push('Template ID,Template Name,Generations,Unique Users,Avg Time,Last Used');
+        for (const t of data.templateStats) {
+            lines.push(`${t.templateId},${t.templateName},${t.totalGenerations},${t.uniqueUsers},${t.avgCompletionTime.toFixed(0)},${t.lastUsed}`);
+        }
+        lines.push('');
+        // Packs section
+        lines.push('Pack ID,Pack Name,Installs,Active,Uninstalls');
+        for (const p of data.packStats) {
+            lines.push(`${p.packId},${p.packName},${p.totalInstalls},${p.activeInstalls},${p.uninstalls}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Render dashboard
+     */
+    async render(options = { period: 'month', format: 'table' }) {
+        const data = await this.getData(options);
+        switch (options.format) {
+            case 'json':
+                return this.formatAsJson(data);
+            case 'csv':
+                return this.formatAsCsv(data);
+            default:
+                return this.formatAsTable(data);
+        }
+    }
+}
+/**
+ * Create an analytics dashboard instance
+ */
+export function createAnalyticsDashboard(collector) {
+    return new AnalyticsDashboard(collector);
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/analytics/dashboard.js.map

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

package/dist/analytics/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Analytics Module
+ * Usage metrics collection and reporting
+ */
+export * from './types.js';
+export * from './collector.js';
+export * from './dashboard.js';
+import { AnalyticsCollector } from './collector.js';
+import { AnalyticsDashboard } from './dashboard.js';
+import type { AnalyticsConfig, DashboardOptions, DashboardData } from './types.js';
+/**
+ * Analytics facade
+ */
+export declare class Analytics {
+    private collector;
+    private dashboard;
+    constructor(config?: Partial<AnalyticsConfig>);
+    /**
+     * Get the collector for tracking events
+     */
+    getCollector(): AnalyticsCollector;
+    /**
+     * Get the dashboard for viewing reports
+     */
+    getDashboard(): AnalyticsDashboard;
+    /**
+     * Track a template generation
+     */
+    trackGeneration(templateId: string, variables: string[], format: string, duration: number): void;
+    /**
+     * Track a pack installation
+     */
+    trackInstall(packId: string, version: string): void;
+    /**
+     * Track an export
+     */
+    trackExport(destination: string, format: string, success: boolean): void;
+    /**
+     * Track an error
+     */
+    trackError(type: string, message: string, context?: Record<string, unknown>): void;
+    /**
+     * Render the analytics dashboard
+     */
+    renderDashboard(options?: DashboardOptions): Promise<string>;
+    /**
+     * Get dashboard data
+     */
+    getDashboardData(options?: DashboardOptions): Promise<DashboardData>;
+    /**
+     * Flush analytics data to storage
+     */
+    flush(): void;
+    /**
+     * End the session and save data
+     */
+    endSession(): void;
+    /**
+     * Clean up old analytics data
+     */
+    cleanup(): number;
+}
+/**
+ * Create an analytics instance
+ */
+export declare function createAnalytics(config?: Partial<AnalyticsConfig>): Analytics;
+/**
+ * Get or create the global analytics instance
+ */
+export declare function getAnalytics(config?: Partial<AnalyticsConfig>): Analytics;
+/**
+ * Reset the global analytics instance
+ */
+export declare function resetAnalytics(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAA4B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAA4B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;gBAE1B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAK7C;;OAEG;IACH,YAAY,IAAI,kBAAkB;IAIlC;;OAEG;IACH,YAAY,IAAI,kBAAkB;IAIlC;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIhG;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAIxE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIlF;;OAEG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlE;;OAEG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,IAAI,MAAM;CAGlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAE5E;AAOD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAKzE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAKrC"}

package/dist/analytics/index.js

@@ -0,0 +1,115 @@
+/**
+ * Analytics Module
+ * Usage metrics collection and reporting
+ */
+export * from './types.js';
+export * from './collector.js';
+export * from './dashboard.js';
+import { createAnalyticsCollector } from './collector.js';
+import { createAnalyticsDashboard } from './dashboard.js';
+/**
+ * Analytics facade
+ */
+export class Analytics {
+    collector;
+    dashboard;
+    constructor(config) {
+        this.collector = createAnalyticsCollector(config);
+        this.dashboard = createAnalyticsDashboard(this.collector);
+    }
+    /**
+     * Get the collector for tracking events
+     */
+    getCollector() {
+        return this.collector;
+    }
+    /**
+     * Get the dashboard for viewing reports
+     */
+    getDashboard() {
+        return this.dashboard;
+    }
+    /**
+     * Track a template generation
+     */
+    trackGeneration(templateId, variables, format, duration) {
+        this.collector.trackTemplateGenerated(templateId, variables, format, duration);
+    }
+    /**
+     * Track a pack installation
+     */
+    trackInstall(packId, version) {
+        this.collector.trackPackInstalled(packId, version);
+    }
+    /**
+     * Track an export
+     */
+    trackExport(destination, format, success) {
+        this.collector.trackExportCompleted(destination, format, success);
+    }
+    /**
+     * Track an error
+     */
+    trackError(type, message, context) {
+        this.collector.trackError(type, message, context);
+    }
+    /**
+     * Render the analytics dashboard
+     */
+    async renderDashboard(options) {
+        return this.dashboard.render(options);
+    }
+    /**
+     * Get dashboard data
+     */
+    async getDashboardData(options) {
+        return this.dashboard.getData(options);
+    }
+    /**
+     * Flush analytics data to storage
+     */
+    flush() {
+        this.collector.flush();
+    }
+    /**
+     * End the session and save data
+     */
+    endSession() {
+        this.collector.endSession();
+    }
+    /**
+     * Clean up old analytics data
+     */
+    cleanup() {
+        return this.collector.cleanup();
+    }
+}
+/**
+ * Create an analytics instance
+ */
+export function createAnalytics(config) {
+    return new Analytics(config);
+}
+/**
+ * Singleton instance for global access
+ */
+let globalAnalytics = null;
+/**
+ * Get or create the global analytics instance
+ */
+export function getAnalytics(config) {
+    if (!globalAnalytics) {
+        globalAnalytics = createAnalytics(config);
+    }
+    return globalAnalytics;
+}
+/**
+ * Reset the global analytics instance
+ */
+export function resetAnalytics() {
+    if (globalAnalytics) {
+        globalAnalytics.flush();
+        globalAnalytics = null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAsB,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAsB,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG9E;;GAEG;AACH,MAAM,OAAO,SAAS;IACZ,SAAS,CAAqB;IAC9B,SAAS,CAAqB;IAEtC,YAAY,MAAiC;QAC3C,IAAI,CAAC,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,UAAkB,EAAE,SAAmB,EAAE,MAAc,EAAE,QAAgB;QACvF,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAc,EAAE,OAAe;QAC1C,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,WAAmB,EAAE,MAAc,EAAE,OAAgB;QAC/D,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY,EAAE,OAAe,EAAE,OAAiC;QACzE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAA0B;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAA0B;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiC;IAC/D,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,IAAI,eAAe,GAAqB,IAAI,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiC;IAC5D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,KAAK,EAAE,CAAC;QACxB,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;AACH,CAAC"}