@skillsmith/core 0.5.5 → 0.5.6

package/dist/analysis/aggregator.d.ts

@@ -0,0 +1,193 @@
+/**
+ * SMI-1303: Result Aggregator
+ * SMI-1337: Added metrics integration
+ *
+ * Aggregates parse results from multiple languages into unified context.
+ * Collects imports, exports, and functions across all analyzed files.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/aggregator
+ */
+import type { SupportedLanguage, ImportInfo, ExportInfo, FunctionInfo, ParseResult, CodebaseContext, FrameworkInfo, DependencyInfo } from './types.js';
+import { type AnalysisMetrics } from './metrics.js';
+/**
+ * Input for adding a parse result to the aggregator
+ */
+export interface AggregatorInput {
+    /** Path to the parsed file */
+    filePath: string;
+    /** Language of the file */
+    language: SupportedLanguage;
+    /** Parse result from the adapter */
+    result: ParseResult;
+}
+/**
+ * Metadata for building the final context
+ */
+export interface AggregatorMetadata {
+    /** Analysis duration in milliseconds */
+    durationMs: number;
+    /** Analyzer version string */
+    version: string;
+    /** Cache hit rate (0-1) */
+    cacheHitRate: number;
+}
+/**
+ * Options for ResultAggregator
+ */
+export interface AggregatorOptions {
+    /** Custom metrics instance (uses default if not provided) */
+    metrics?: AnalysisMetrics;
+}
+/**
+ * Aggregates parse results from multiple languages into unified context
+ *
+ * Collects results from individual file parses and merges them
+ * into a single CodebaseContext for skill recommendations.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ResultAggregator()
+ *
+ * // Add results as files are parsed
+ * aggregator.add({
+ *   filePath: 'src/main.py',
+ *   language: 'python',
+ *   result: pythonAdapter.parseFile(content, 'src/main.py')
+ * })
+ *
+ * aggregator.add({
+ *   filePath: 'src/index.ts',
+ *   language: 'typescript',
+ *   result: tsAdapter.parseFile(content, 'src/index.ts')
+ * })
+ *
+ * // Build final context
+ * const context = aggregator.build('/path/to/project', dependencies, frameworks, metadata)
+ * ```
+ */
+export declare class ResultAggregator {
+    private imports;
+    private exports;
+    private functions;
+    private filesByExtension;
+    private filesByLanguage;
+    private totalLines;
+    private languages;
+    private fileCount;
+    private readonly metrics;
+    constructor(options?: AggregatorOptions);
+    /**
+     * Add parse result to aggregation
+     *
+     * Extracts imports, exports, and functions from the result
+     * and annotates them with language information.
+     *
+     * SMI-1337: Updates aggregator metrics.
+     *
+     * @param input - File path, language, and parse result
+     *
+     * @example
+     * ```typescript
+     * aggregator.add({
+     *   filePath: 'src/utils.py',
+     *   language: 'python',
+     *   result: adapter.parseFile(content, 'src/utils.py')
+     * })
+     * ```
+     */
+    add(input: AggregatorInput): void;
+    /**
+     * Update aggregator metrics
+     * SMI-1337: Helper to keep metrics in sync
+     */
+    private updateMetrics;
+    /**
+     * Add line count for a file
+     *
+     * Call this separately from add() if line counting is done
+     * during file reading rather than parsing.
+     *
+     * @param count - Number of lines in the file
+     */
+    addLines(count: number): void;
+    /**
+     * Get current imports (read-only)
+     */
+    getImports(): readonly ImportInfo[];
+    /**
+     * Get current exports (read-only)
+     */
+    getExports(): readonly ExportInfo[];
+    /**
+     * Get current functions (read-only)
+     */
+    getFunctions(): readonly FunctionInfo[];
+    /**
+     * Get current file count
+     */
+    getFileCount(): number;
+    /**
+     * Get detected languages
+     */
+    getLanguages(): SupportedLanguage[];
+    /**
+     * Build final CodebaseContext
+     *
+     * Combines all aggregated data with dependencies, frameworks,
+     * and metadata into the final context structure.
+     *
+     * SMI-1337: Records final aggregation metrics.
+     *
+     * @param rootPath - Root path of the analyzed codebase
+     * @param dependencies - Dependencies from all package managers
+     * @param frameworks - Detected frameworks
+     * @param metadata - Analysis metadata
+     * @returns Complete codebase context
+     *
+     * @example
+     * ```typescript
+     * const context = aggregator.build(
+     *   '/path/to/project',
+     *   dependencies,
+     *   frameworks,
+     *   { durationMs: 1234, version: '2.0.0', cacheHitRate: 0.85 }
+     * )
+     * ```
+     */
+    build(rootPath: string, dependencies: DependencyInfo[], frameworks: FrameworkInfo[], metadata: AggregatorMetadata): CodebaseContext;
+    /**
+     * Build language stats with all languages initialized to 0
+     */
+    private buildLanguageStats;
+    /**
+     * Reset aggregator for new analysis
+     *
+     * Clears all collected data. Call this before starting
+     * a new analysis on a different codebase.
+     *
+     * SMI-1337: Resets aggregator metrics as well.
+     */
+    reset(): void;
+    /**
+     * Merge another aggregator's results into this one
+     *
+     * Useful for parallel processing where each worker
+     * has its own aggregator.
+     *
+     * @param other - Aggregator to merge from
+     */
+    merge(other: ResultAggregator): void;
+    /**
+     * Get summary statistics
+     */
+    getSummary(): {
+        files: number;
+        imports: number;
+        exports: number;
+        functions: number;
+        lines: number;
+        languages: SupportedLanguage[];
+    };
+}
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/analysis/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../src/analysis/aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,OAAO,GAAE,iBAAsB;IAI3C;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IA6CjC;;;OAGG;IACH,OAAO,CAAC,aAAa;IASrB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,UAAU,IAAI,SAAS,UAAU,EAAE;IAInC;;OAEG;IACH,UAAU,IAAI,SAAS,UAAU,EAAE;IAInC;;OAEG;IACH,YAAY,IAAI,SAAS,YAAY,EAAE;IAIvC;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,IAAI,iBAAiB,EAAE;IAInC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,cAAc,EAAE,EAC9B,UAAU,EAAE,aAAa,EAAE,EAC3B,QAAQ,EAAE,kBAAkB,GAC3B,eAAe;IA2BlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAcb;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAoBpC;;OAEG;IACH,UAAU,IAAI;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,iBAAiB,EAAE,CAAA;KAC/B;CAUF"}

package/dist/analysis/aggregator.js

@@ -0,0 +1,283 @@
+/**
+ * SMI-1303: Result Aggregator
+ * SMI-1337: Added metrics integration
+ *
+ * Aggregates parse results from multiple languages into unified context.
+ * Collects imports, exports, and functions across all analyzed files.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/aggregator
+ */
+import path from 'path';
+import { getAnalysisMetrics } from './metrics.js';
+/**
+ * Aggregates parse results from multiple languages into unified context
+ *
+ * Collects results from individual file parses and merges them
+ * into a single CodebaseContext for skill recommendations.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ResultAggregator()
+ *
+ * // Add results as files are parsed
+ * aggregator.add({
+ *   filePath: 'src/main.py',
+ *   language: 'python',
+ *   result: pythonAdapter.parseFile(content, 'src/main.py')
+ * })
+ *
+ * aggregator.add({
+ *   filePath: 'src/index.ts',
+ *   language: 'typescript',
+ *   result: tsAdapter.parseFile(content, 'src/index.ts')
+ * })
+ *
+ * // Build final context
+ * const context = aggregator.build('/path/to/project', dependencies, frameworks, metadata)
+ * ```
+ */
+export class ResultAggregator {
+    imports = [];
+    exports = [];
+    functions = [];
+    filesByExtension = {};
+    filesByLanguage = {};
+    totalLines = 0;
+    languages = new Set();
+    fileCount = 0;
+    metrics;
+    constructor(options = {}) {
+        this.metrics = options.metrics ?? getAnalysisMetrics();
+    }
+    /**
+     * Add parse result to aggregation
+     *
+     * Extracts imports, exports, and functions from the result
+     * and annotates them with language information.
+     *
+     * SMI-1337: Updates aggregator metrics.
+     *
+     * @param input - File path, language, and parse result
+     *
+     * @example
+     * ```typescript
+     * aggregator.add({
+     *   filePath: 'src/utils.py',
+     *   language: 'python',
+     *   result: adapter.parseFile(content, 'src/utils.py')
+     * })
+     * ```
+     */
+    add(input) {
+        const { filePath, language, result } = input;
+        // Track language
+        this.languages.add(language);
+        this.filesByLanguage[language] = (this.filesByLanguage[language] ?? 0) + 1;
+        this.fileCount++;
+        // Track extension
+        const ext = path.extname(filePath).toLowerCase();
+        if (ext) {
+            this.filesByExtension[ext] = (this.filesByExtension[ext] ?? 0) + 1;
+        }
+        // Add imports with language annotation
+        for (const imp of result.imports) {
+            this.imports.push({
+                ...imp,
+                language,
+                sourceFile: filePath,
+            });
+        }
+        // Add exports with language annotation
+        for (const exp of result.exports) {
+            this.exports.push({
+                ...exp,
+                language,
+                sourceFile: filePath,
+            });
+        }
+        // Add functions with language annotation
+        for (const func of result.functions) {
+            this.functions.push({
+                ...func,
+                language,
+                sourceFile: filePath,
+            });
+        }
+        // SMI-1337: Update aggregator metrics
+        this.updateMetrics();
+    }
+    /**
+     * Update aggregator metrics
+     * SMI-1337: Helper to keep metrics in sync
+     */
+    updateMetrics() {
+        this.metrics.updateAggregatorStats(this.fileCount, this.imports.length, this.exports.length, this.functions.length);
+    }
+    /**
+     * Add line count for a file
+     *
+     * Call this separately from add() if line counting is done
+     * during file reading rather than parsing.
+     *
+     * @param count - Number of lines in the file
+     */
+    addLines(count) {
+        this.totalLines += count;
+    }
+    /**
+     * Get current imports (read-only)
+     */
+    getImports() {
+        return this.imports;
+    }
+    /**
+     * Get current exports (read-only)
+     */
+    getExports() {
+        return this.exports;
+    }
+    /**
+     * Get current functions (read-only)
+     */
+    getFunctions() {
+        return this.functions;
+    }
+    /**
+     * Get current file count
+     */
+    getFileCount() {
+        return this.fileCount;
+    }
+    /**
+     * Get detected languages
+     */
+    getLanguages() {
+        return Array.from(this.languages);
+    }
+    /**
+     * Build final CodebaseContext
+     *
+     * Combines all aggregated data with dependencies, frameworks,
+     * and metadata into the final context structure.
+     *
+     * SMI-1337: Records final aggregation metrics.
+     *
+     * @param rootPath - Root path of the analyzed codebase
+     * @param dependencies - Dependencies from all package managers
+     * @param frameworks - Detected frameworks
+     * @param metadata - Analysis metadata
+     * @returns Complete codebase context
+     *
+     * @example
+     * ```typescript
+     * const context = aggregator.build(
+     *   '/path/to/project',
+     *   dependencies,
+     *   frameworks,
+     *   { durationMs: 1234, version: '2.0.0', cacheHitRate: 0.85 }
+     * )
+     * ```
+     */
+    build(rootPath, dependencies, frameworks, metadata) {
+        // SMI-1337: Final metrics update
+        this.updateMetrics();
+        this.metrics.updateMemoryUsage();
+        return {
+            rootPath,
+            imports: this.imports,
+            exports: this.exports,
+            functions: this.functions,
+            frameworks,
+            dependencies,
+            stats: {
+                totalFiles: this.fileCount,
+                filesByExtension: { ...this.filesByExtension },
+                filesByLanguage: this.buildLanguageStats(),
+                totalLines: this.totalLines,
+            },
+            metadata: {
+                durationMs: metadata.durationMs,
+                version: metadata.version,
+                languages: Array.from(this.languages),
+                cacheHitRate: metadata.cacheHitRate,
+            },
+        };
+    }
+    /**
+     * Build language stats with all languages initialized to 0
+     */
+    buildLanguageStats() {
+        const stats = {
+            typescript: 0,
+            javascript: 0,
+            python: 0,
+            go: 0,
+            rust: 0,
+            java: 0,
+        };
+        for (const [lang, count] of Object.entries(this.filesByLanguage)) {
+            stats[lang] = count;
+        }
+        return stats;
+    }
+    /**
+     * Reset aggregator for new analysis
+     *
+     * Clears all collected data. Call this before starting
+     * a new analysis on a different codebase.
+     *
+     * SMI-1337: Resets aggregator metrics as well.
+     */
+    reset() {
+        this.imports = [];
+        this.exports = [];
+        this.functions = [];
+        this.filesByExtension = {};
+        this.filesByLanguage = {};
+        this.totalLines = 0;
+        this.languages.clear();
+        this.fileCount = 0;
+        // SMI-1337: Reset metrics
+        this.updateMetrics();
+    }
+    /**
+     * Merge another aggregator's results into this one
+     *
+     * Useful for parallel processing where each worker
+     * has its own aggregator.
+     *
+     * @param other - Aggregator to merge from
+     */
+    merge(other) {
+        this.imports.push(...other.imports);
+        this.exports.push(...other.exports);
+        this.functions.push(...other.functions);
+        this.totalLines += other.totalLines;
+        this.fileCount += other.fileCount;
+        // Merge extension counts
+        for (const [ext, count] of Object.entries(other.filesByExtension)) {
+            this.filesByExtension[ext] = (this.filesByExtension[ext] ?? 0) + count;
+        }
+        // Merge language counts
+        for (const [lang, count] of Object.entries(other.filesByLanguage)) {
+            const typedLang = lang;
+            this.filesByLanguage[typedLang] = (this.filesByLanguage[typedLang] ?? 0) + count;
+            this.languages.add(typedLang);
+        }
+    }
+    /**
+     * Get summary statistics
+     */
+    getSummary() {
+        return {
+            files: this.fileCount,
+            imports: this.imports.length,
+            exports: this.exports.length,
+            functions: this.functions.length,
+            lines: this.totalLines,
+            languages: Array.from(this.languages),
+        };
+    }
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/analysis/aggregator.js.map

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

package/dist/analysis/cache.d.ts

@@ -0,0 +1,180 @@
+/**
+ * SMI-1303: Parse Result Cache
+ * SMI-1337: Added metrics integration
+ *
+ * LRU cache for parse results with content hash validation.
+ * Provides memory-based eviction to prevent memory exhaustion.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/cache
+ */
+import type { ParseResult, CacheStats } from './types.js';
+import { type AnalysisMetrics } from './metrics.js';
+/**
+ * Options for ParseCache
+ */
+export interface ParseCacheOptions {
+    /** Maximum memory in MB (default: 200) */
+    maxMemoryMB?: number;
+    /** TTL in milliseconds (default: no TTL) */
+    ttlMs?: number;
+    /** Custom metrics instance (uses default if not provided) */
+    metrics?: AnalysisMetrics;
+}
+/**
+ * LRU cache for parse results with memory-based eviction
+ *
+ * Caches parse results keyed by file path. Uses content hashing
+ * to detect when cached results are stale.
+ *
+ * @example
+ * ```typescript
+ * const cache = new ParseCache({ maxMemoryMB: 100 })
+ *
+ * // Check cache first
+ * const cached = cache.get('src/main.py', fileContent)
+ * if (cached) {
+ *   return cached
+ * }
+ *
+ * // Parse and cache
+ * const result = adapter.parseFile(fileContent, 'src/main.py')
+ * cache.set('src/main.py', fileContent, result)
+ * ```
+ */
+export declare class ParseCache {
+    private cache;
+    private readonly maxMemory;
+    private readonly metrics;
+    private hits;
+    private misses;
+    constructor(options?: ParseCacheOptions);
+    /**
+     * Get cached result if content unchanged
+     *
+     * Returns null if:
+     * - No entry exists for the path
+     * - Content hash doesn't match (file was modified)
+     * - Entry was evicted due to memory pressure
+     *
+     * SMI-1337: Records cache hit/miss metrics.
+     *
+     * @param filePath - Path to the file
+     * @param content - Current file content for hash comparison
+     * @returns Cached parse result or null
+     *
+     * @example
+     * ```typescript
+     * const cached = cache.get('src/main.py', fileContent)
+     * if (cached) {
+     *   console.log('Cache hit!')
+     *   return cached
+     * }
+     * ```
+     */
+    get(filePath: string, content: string): ParseResult | null;
+    /**
+     * Store parse result in cache
+     *
+     * The result is stored with a content hash for future validation.
+     * If the cache is at capacity, least recently used entries
+     * are evicted to make room.
+     *
+     * SMI-1337: Updates cache size metrics.
+     *
+     * @param filePath - Path to the file
+     * @param content - File content (used for hash)
+     * @param result - Parse result to cache
+     *
+     * @example
+     * ```typescript
+     * const result = adapter.parseFile(content, 'src/main.py')
+     * cache.set('src/main.py', content, result)
+     * ```
+     */
+    set(filePath: string, content: string, result: ParseResult): void;
+    /**
+     * Check if a file is cached (without counting as hit/miss)
+     *
+     * @param filePath - Path to check
+     * @returns True if entry exists (may be stale)
+     */
+    has(filePath: string): boolean;
+    /**
+     * Invalidate cache entries for changed files
+     *
+     * Call this when files are known to have changed
+     * to prevent stale cache hits.
+     *
+     * @param filePaths - Paths to invalidate
+     *
+     * @example
+     * ```typescript
+     * // On file system change event
+     * cache.invalidate(['src/modified.py', 'src/deleted.py'])
+     * ```
+     */
+    invalidate(filePaths: string[]): void;
+    /**
+     * Invalidate entries matching a pattern
+     *
+     * @param pattern - Glob-like pattern to match
+     *
+     * @example
+     * ```typescript
+     * // Invalidate all Python files
+     * cache.invalidatePattern('*.py')
+     * ```
+     */
+    invalidatePattern(pattern: string): void;
+    /**
+     * Clear entire cache
+     *
+     * Removes all entries and resets statistics.
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     *
+     * @returns Current cache statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = cache.getStats()
+     * console.log(`Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`)
+     * console.log(`Size: ${(stats.size / 1024 / 1024).toFixed(1)} MB`)
+     * ```
+     */
+    getStats(): CacheStats;
+    /**
+     * Get number of cached entries
+     */
+    get size(): number;
+    /**
+     * Reset hit/miss counters
+     */
+    resetStats(): void;
+    /**
+     * Hash file content for change detection
+     *
+     * Uses SHA-256 truncated to 16 characters for efficiency.
+     */
+    private hashContent;
+    /**
+     * Get language from file path extension
+     * SMI-1337: Helper for metrics labeling
+     */
+    private getLanguageFromPath;
+    /**
+     * Estimate memory size of a parse result
+     *
+     * Rough estimate based on array sizes and average item sizes.
+     * SMI-1335: Named constants for magic numbers
+     */
+    private estimateSize;
+    /**
+     * Convert glob pattern to regex
+     */
+    private patternToRegex;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/analysis/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/analysis/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAgBvE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;gBAEN,OAAO,GAAE,iBAAsB;IAa3C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAyB1D;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAejE;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrC;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASxC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;;;;;;;OAWG;IACH,QAAQ,IAAI,UAAU;IAUtB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,cAAc;CAQvB"}