modestbench 0.0.1

package/dist/storage/history.cjs

@@ -0,0 +1,456 @@
+"use strict";
+/**
+ * ModestBench History Storage
+ *
+ * File-based storage system for benchmark run history and results. Provides
+ * querying, cleanup, and export capabilities for historical data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileHistoryStorage = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * File-based history storage implementation
+ */
+class FileHistoryStorage {
+    index = null;
+    indexFile;
+    maxFileSize;
+    storageDir;
+    constructor(options = {}) {
+        this.storageDir =
+            options.storageDir || (0, node_path_1.join)(process.cwd(), '.modestbench', 'history');
+        this.indexFile = (0, node_path_1.join)(this.storageDir, 'index.json');
+        this.maxFileSize = options.maxFileSize || 10 * 1024 * 1024; // 10MB default
+        this.ensureStorageDir();
+    }
+    static isValidBenchmarkRun(obj) {
+        // Type guard function that checks properties on unknown object
+        return (!!obj &&
+            typeof obj === 'object' &&
+            'id' in obj &&
+            typeof obj.id === 'string' &&
+            'files' in obj &&
+            Array.isArray(obj.files) &&
+            'startTime' in obj &&
+            !!obj.startTime &&
+            'endTime' in obj &&
+            !!obj.endTime &&
+            'environment' in obj &&
+            !!obj.environment &&
+            'summary' in obj &&
+            !!obj.summary);
+    }
+    /**
+     * Clean up old data according to retention policy
+     */
+    async cleanup(policy) {
+        try {
+            const index = await this.loadIndex();
+            const entriesToRemove = [];
+            let totalSize = 0;
+            // Calculate current storage metrics
+            for (const entry of index.entries) {
+                totalSize += entry.sizeBytes;
+            }
+            // Sort entries by date (oldest first) for cleanup
+            const sortedEntries = [...index.entries].sort((a, b) => a.date.getTime() - b.date.getTime());
+            // Apply retention policies
+            for (const entry of sortedEntries) {
+                let shouldRemove = false;
+                // Check max age
+                if (policy.maxAge &&
+                    Date.now() - entry.date.getTime() > policy.maxAge) {
+                    shouldRemove = true;
+                }
+                // Check max runs count (remove oldest)
+                if (policy.maxRuns &&
+                    index.entries.length - entriesToRemove.length > policy.maxRuns) {
+                    shouldRemove = true;
+                }
+                // Check max size (remove oldest until under limit)
+                if (policy.maxSize && totalSize > policy.maxSize) {
+                    shouldRemove = true;
+                    totalSize -= entry.sizeBytes;
+                }
+                if (shouldRemove) {
+                    entriesToRemove.push(entry);
+                }
+            }
+            // Remove files and update index
+            const removedFiles = [];
+            let freedBytes = 0;
+            for (const entry of entriesToRemove) {
+                const filePath = (0, node_path_1.join)(this.storageDir, entry.filename);
+                try {
+                    if ((0, node_fs_1.existsSync)(filePath)) {
+                        (0, node_fs_1.unlinkSync)(filePath);
+                        removedFiles.push(entry.filename);
+                        freedBytes += entry.sizeBytes;
+                    }
+                    await this.removeFromIndex(entry.id);
+                }
+                catch (error) {
+                    // Log but continue with other deletions
+                    console.warn(`Failed to remove file ${entry.filename}: ${error}`);
+                }
+            }
+            return {
+                freedBytes,
+                removedFiles,
+                removedRuns: entriesToRemove.length,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to cleanup storage: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Export historical data
+     */
+    async export(format, query) {
+        try {
+            const runs = await this.queryRuns(query || {});
+            if (format === 'json') {
+                return JSON.stringify(runs, null, 2);
+            }
+            else if (format === 'csv') {
+                return this.exportToCsv(runs);
+            }
+            else {
+                throw new Error(`Unsupported export format: ${format}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to export data: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get index of all stored runs
+     */
+    async getIndex() {
+        try {
+            const index = await this.loadIndex();
+            return index.entries.map((entry) => ({
+                date: entry.date,
+                id: entry.id,
+                summary: entry.summary,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to get storage index: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get storage statistics
+     */
+    async getStats() {
+        try {
+            const index = await this.loadIndex();
+            const dates = index.entries
+                .map((e) => e.date)
+                .sort((a, b) => a.getTime() - b.getTime());
+            return {
+                newestRun: dates[dates.length - 1],
+                oldestRun: dates[0],
+                totalRuns: index.entries.length,
+                totalSize: index.entries.reduce((total, entry) => total + entry.sizeBytes, 0),
+            };
+        }
+        catch {
+            return { totalRuns: 0, totalSize: 0 };
+        }
+    }
+    /**
+     * Get storage directory path
+     */
+    getStorageDir() {
+        return this.storageDir;
+    }
+    /**
+     * Get total storage size in bytes
+     */
+    async getStorageSize() {
+        try {
+            const index = await this.loadIndex();
+            return index.entries.reduce((total, entry) => total + entry.sizeBytes, 0);
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Load a specific benchmark run
+     */
+    async loadRun(id) {
+        try {
+            const index = await this.loadIndex();
+            const entry = index.entries.find((e) => e.id === id);
+            if (!entry) {
+                return null;
+            }
+            const filePath = (0, node_path_1.join)(this.storageDir, entry.filename);
+            if (!(0, node_fs_1.existsSync)(filePath)) {
+                // File missing, clean up index
+                await this.removeFromIndex(id);
+                return null;
+            }
+            const data = (0, node_fs_1.readFileSync)(filePath, 'utf8');
+            const run = JSON.parse(data);
+            // Validate the loaded run
+            if (!FileHistoryStorage.isValidBenchmarkRun(run)) {
+                throw new Error(`Invalid benchmark run data in file ${entry.filename}`);
+            }
+            return run;
+        }
+        catch (error) {
+            throw new Error(`Failed to load benchmark run ${id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Query historical runs
+     */
+    async queryRuns(query) {
+        try {
+            const index = await this.loadIndex();
+            let filteredEntries = [...index.entries];
+            // Apply filters
+            if (query.since) {
+                filteredEntries = filteredEntries.filter((e) => e.date >= query.since);
+            }
+            if (query.until) {
+                filteredEntries = filteredEntries.filter((e) => e.date <= query.until);
+            }
+            if (query.pattern) {
+                const regex = new RegExp(query.pattern, 'i');
+                filteredEntries = filteredEntries.filter((e) => regex.test(e.summary));
+            }
+            if (query.tags && query.tags.length > 0) {
+                filteredEntries = filteredEntries.filter((e) => query.tags.some((tag) => e.tags.includes(tag)));
+            }
+            // Apply sorting
+            const sortBy = query.sortBy || 'date';
+            const sort = query.sort || 'desc';
+            filteredEntries.sort((a, b) => {
+                let comparison = 0;
+                switch (sortBy) {
+                    case 'date':
+                        comparison = a.date.getTime() - b.date.getTime();
+                        break;
+                    case 'name':
+                        comparison = a.summary.localeCompare(b.summary);
+                        break;
+                    default:
+                        comparison = a.date.getTime() - b.date.getTime();
+                }
+                return sort === 'desc' ? -comparison : comparison;
+            });
+            // Apply pagination
+            const offset = query.offset || 0;
+            const limit = query.limit || filteredEntries.length;
+            const paginatedEntries = filteredEntries.slice(offset, offset + limit);
+            // Load the actual runs
+            const runs = [];
+            for (const entry of paginatedEntries) {
+                const run = await this.loadRun(entry.id);
+                if (run) {
+                    runs.push(run);
+                }
+            }
+            return runs;
+        }
+        catch (error) {
+            throw new Error(`Failed to query benchmark runs: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Save a benchmark run to storage
+     */
+    async saveRun(run) {
+        try {
+            this.ensureStorageDir();
+            // Generate filename based on run ID and timestamp
+            const filename = this.generateFilename(run);
+            const filePath = (0, node_path_1.join)(this.storageDir, filename);
+            // Serialize the run data
+            const data = JSON.stringify(run, null, 2);
+            // Check file size limit
+            if (Buffer.byteLength(data, 'utf8') > this.maxFileSize) {
+                throw new Error(`Benchmark run data exceeds maximum file size of ${this.maxFileSize} bytes`);
+            }
+            // Write the run data
+            (0, node_fs_1.writeFileSync)(filePath, data, 'utf8');
+            // Update the index
+            await this.updateIndex(run, filename, Buffer.byteLength(data, 'utf8'));
+        }
+        catch (error) {
+            throw new Error(`Failed to save benchmark run: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Ensure storage directory exists
+     */
+    ensureStorageDir() {
+        if (!(0, node_fs_1.existsSync)(this.storageDir)) {
+            (0, node_fs_1.mkdirSync)(this.storageDir, { recursive: true });
+        }
+    }
+    /**
+     * Export runs to CSV format
+     */
+    exportToCsv(runs) {
+        const headers = [
+            'runId',
+            'startTime',
+            'endTime',
+            'duration',
+            'files',
+            'suites',
+            'tasks',
+            'passed',
+            'failed',
+            'nodeVersion',
+            'platform',
+            'arch',
+            'gitCommit',
+            'gitBranch',
+        ];
+        const rows = runs.map((run) => [
+            run.id,
+            run.startTime.toISOString(),
+            run.endTime.toISOString(),
+            run.duration.toString(),
+            run.summary.totalFiles.toString(),
+            run.summary.totalSuites.toString(),
+            run.summary.totalTasks.toString(),
+            run.summary.passedTasks.toString(),
+            run.summary.failedTasks.toString(),
+            run.environment.nodeVersion,
+            run.environment.platform,
+            run.environment.arch,
+            run.git?.commit || '',
+            run.git?.branch || '',
+        ]);
+        const csvLines = [headers, ...rows];
+        return csvLines
+            .map((row) => row.map((cell) => `"${cell.replace(/"/g, '""')}"`).join(','))
+            .join('\n');
+    }
+    /**
+     * Generate filename for a benchmark run
+     */
+    generateFilename(run) {
+        const timestamp = run.startTime.toISOString().replace(/[:.]/g, '-');
+        const hash = (0, node_crypto_1.createHash)('md5').update(run.id).digest('hex').substring(0, 8);
+        return `run-${timestamp}-${hash}.json`;
+    }
+    /**
+     * Generate a human-readable summary for a run
+     */
+    generateSummary(run) {
+        const fileCount = run.files.length;
+        const taskCount = run.summary.totalTasks;
+        const failedCount = run.summary.failedTasks;
+        if (failedCount > 0) {
+            return `${fileCount} files, ${taskCount} tasks (${failedCount} failed)`;
+        }
+        else {
+            return `${fileCount} files, ${taskCount} tasks`;
+        }
+    }
+    /**
+     * Load the storage index
+     */
+    async loadIndex() {
+        if (this.index) {
+            return this.index;
+        }
+        if (!(0, node_fs_1.existsSync)(this.indexFile)) {
+            this.index = {
+                created: new Date(),
+                entries: [],
+                lastModified: new Date(),
+                version: '1.0.0',
+            };
+            await this.saveIndex();
+            return this.index; // We just assigned it, so it's not null
+        }
+        try {
+            const data = (0, node_fs_1.readFileSync)(this.indexFile, 'utf8');
+            const parsed = JSON.parse(data);
+            // Convert date strings back to Date objects
+            this.index = {
+                created: new Date(parsed.created),
+                entries: parsed.entries.map((entry) => ({
+                    ...entry,
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-member-access
+                    date: new Date(entry.date),
+                })),
+                lastModified: new Date(parsed.lastModified),
+                version: '1.0.0',
+            };
+            return this.index; // We just assigned it, so it's not null
+        }
+        catch (error) {
+            throw new Error(`Failed to load storage index: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Remove an entry from the index
+     */
+    async removeFromIndex(id) {
+        const index = await this.loadIndex();
+        const entryIndex = index.entries.findIndex((e) => e.id === id);
+        if (entryIndex >= 0) {
+            index.entries.splice(entryIndex, 1);
+            this.index = index;
+            await this.saveIndex();
+        }
+    }
+    /**
+     * Save the storage index
+     */
+    async saveIndex() {
+        if (!this.index) {
+            return;
+        }
+        try {
+            this.index = {
+                ...this.index,
+                lastModified: new Date(),
+            };
+            const data = JSON.stringify(this.index, null, 2);
+            (0, node_fs_1.writeFileSync)(this.indexFile, data, 'utf8');
+        }
+        catch (error) {
+            throw new Error(`Failed to save storage index: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Update index with a new run
+     */
+    async updateIndex(run, filename, sizeBytes) {
+        const index = await this.loadIndex();
+        const entry = {
+            date: run.startTime,
+            filename,
+            id: run.id,
+            sizeBytes,
+            summary: this.generateSummary(run),
+            tags: run.tags || [],
+        };
+        // Remove existing entry if it exists
+        const existingIndex = index.entries.findIndex((e) => e.id === run.id);
+        if (existingIndex >= 0) {
+            index.entries.splice(existingIndex, 1);
+        }
+        // Add new entry
+        index.entries.push(entry);
+        // Update index
+        this.index = index;
+        await this.saveIndex();
+    }
+}
+exports.FileHistoryStorage = FileHistoryStorage;
+//# sourceMappingURL=history.js.map

package/dist/storage/history.cjs.map

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

package/dist/storage/history.d.cts

@@ -0,0 +1,99 @@
+/**
+ * ModestBench History Storage
+ *
+ * File-based storage system for benchmark run history and results. Provides
+ * querying, cleanup, and export capabilities for historical data.
+ */
+import type { BenchmarkRun, CleanupResult, HistoryQuery, HistoryStorage, RetentionPolicy } from "../types/index.cjs";
+/**
+ * File-based history storage implementation
+ */
+export declare class FileHistoryStorage implements HistoryStorage {
+    private index;
+    private readonly indexFile;
+    private readonly maxFileSize;
+    private readonly storageDir;
+    constructor(options?: {
+        maxFileSize?: number;
+        storageDir?: string;
+    });
+    static isValidBenchmarkRun(obj: unknown): obj is BenchmarkRun;
+    /**
+     * Clean up old data according to retention policy
+     */
+    cleanup(policy: RetentionPolicy): Promise<CleanupResult>;
+    /**
+     * Export historical data
+     */
+    export(format: 'csv' | 'json', query?: HistoryQuery): Promise<string>;
+    /**
+     * Get index of all stored runs
+     */
+    getIndex(): Promise<Array<{
+        date: Date;
+        id: string;
+        summary: string;
+    }>>;
+    /**
+     * Get storage statistics
+     */
+    getStats(): Promise<{
+        newestRun?: Date | undefined;
+        oldestRun?: Date | undefined;
+        totalRuns: number;
+        totalSize: number;
+    }>;
+    /**
+     * Get storage directory path
+     */
+    getStorageDir(): string;
+    /**
+     * Get total storage size in bytes
+     */
+    getStorageSize(): Promise<number>;
+    /**
+     * Load a specific benchmark run
+     */
+    loadRun(id: string): Promise<BenchmarkRun | null>;
+    /**
+     * Query historical runs
+     */
+    queryRuns(query: HistoryQuery): Promise<BenchmarkRun[]>;
+    /**
+     * Save a benchmark run to storage
+     */
+    saveRun(run: BenchmarkRun): Promise<void>;
+    /**
+     * Ensure storage directory exists
+     */
+    private ensureStorageDir;
+    /**
+     * Export runs to CSV format
+     */
+    private exportToCsv;
+    /**
+     * Generate filename for a benchmark run
+     */
+    private generateFilename;
+    /**
+     * Generate a human-readable summary for a run
+     */
+    private generateSummary;
+    /**
+     * Load the storage index
+     */
+    private loadIndex;
+    /**
+     * Remove an entry from the index
+     */
+    private removeFromIndex;
+    /**
+     * Save the storage index
+     */
+    private saveIndex;
+    /**
+     * Update index with a new run
+     */
+    private updateIndex;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/storage/history.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/storage/history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,2BAA0B;AAwB3B;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,KAAK,CAA6B;IAE1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB;WAUM,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY;IAoBpE;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IA8E9D;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB3E;;OAEG;IACG,QAAQ,IAAI,OAAO,CACvB,KAAK,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CACnD;IAeD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAC7B,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAqBF;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IASvC;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiCvD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoE7D;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,WAAW;IA2CnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;YACW,SAAS;IA6CvB;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,SAAS;IAoBvB;;OAEG;YACW,WAAW;CA6B1B"}

package/dist/storage/history.d.ts

@@ -0,0 +1,99 @@
+/**
+ * ModestBench History Storage
+ *
+ * File-based storage system for benchmark run history and results. Provides
+ * querying, cleanup, and export capabilities for historical data.
+ */
+import type { BenchmarkRun, CleanupResult, HistoryQuery, HistoryStorage, RetentionPolicy } from "../types/index.js";
+/**
+ * File-based history storage implementation
+ */
+export declare class FileHistoryStorage implements HistoryStorage {
+    private index;
+    private readonly indexFile;
+    private readonly maxFileSize;
+    private readonly storageDir;
+    constructor(options?: {
+        maxFileSize?: number;
+        storageDir?: string;
+    });
+    static isValidBenchmarkRun(obj: unknown): obj is BenchmarkRun;
+    /**
+     * Clean up old data according to retention policy
+     */
+    cleanup(policy: RetentionPolicy): Promise<CleanupResult>;
+    /**
+     * Export historical data
+     */
+    export(format: 'csv' | 'json', query?: HistoryQuery): Promise<string>;
+    /**
+     * Get index of all stored runs
+     */
+    getIndex(): Promise<Array<{
+        date: Date;
+        id: string;
+        summary: string;
+    }>>;
+    /**
+     * Get storage statistics
+     */
+    getStats(): Promise<{
+        newestRun?: Date | undefined;
+        oldestRun?: Date | undefined;
+        totalRuns: number;
+        totalSize: number;
+    }>;
+    /**
+     * Get storage directory path
+     */
+    getStorageDir(): string;
+    /**
+     * Get total storage size in bytes
+     */
+    getStorageSize(): Promise<number>;
+    /**
+     * Load a specific benchmark run
+     */
+    loadRun(id: string): Promise<BenchmarkRun | null>;
+    /**
+     * Query historical runs
+     */
+    queryRuns(query: HistoryQuery): Promise<BenchmarkRun[]>;
+    /**
+     * Save a benchmark run to storage
+     */
+    saveRun(run: BenchmarkRun): Promise<void>;
+    /**
+     * Ensure storage directory exists
+     */
+    private ensureStorageDir;
+    /**
+     * Export runs to CSV format
+     */
+    private exportToCsv;
+    /**
+     * Generate filename for a benchmark run
+     */
+    private generateFilename;
+    /**
+     * Generate a human-readable summary for a run
+     */
+    private generateSummary;
+    /**
+     * Load the storage index
+     */
+    private loadIndex;
+    /**
+     * Remove an entry from the index
+     */
+    private removeFromIndex;
+    /**
+     * Save the storage index
+     */
+    private saveIndex;
+    /**
+     * Update index with a new run
+     */
+    private updateIndex;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/storage/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/storage/history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,0BAA0B;AAwB3B;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,KAAK,CAA6B;IAE1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB;WAUM,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY;IAoBpE;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IA8E9D;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB3E;;OAEG;IACG,QAAQ,IAAI,OAAO,CACvB,KAAK,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CACnD;IAeD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAC7B,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAqBF;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IASvC;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiCvD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoE7D;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,WAAW;IA2CnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;YACW,SAAS;IA6CvB;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,SAAS;IAoBvB;;OAEG;YACW,WAAW;CA6B1B"}