@skillsmith/core 0.2.0 → 2.0.0

package/dist/src/analysis/tree-sitter/manager.js

@@ -0,0 +1,239 @@
+/**
+ * SMI-1303: Tree-sitter Parser Manager
+ *
+ * Manages tree-sitter parser instances with lazy loading.
+ * Uses web-tree-sitter (WASM) to avoid native module conflicts.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @see ADR-002: Docker glibc Requirement
+ * @module analysis/tree-sitter/manager
+ */
+/**
+ * Manages tree-sitter parser instances with lazy loading
+ *
+ * Parsers are loaded on-demand and cached for reuse.
+ * Uses WASM-based web-tree-sitter to avoid native module issues.
+ *
+ * @example
+ * ```typescript
+ * const manager = new TreeSitterManager()
+ * const parser = await manager.getParser('python')
+ * const tree = parser.parse('def main(): pass')
+ * manager.dispose()
+ * ```
+ */
+export class TreeSitterManager {
+    parsers = new Map();
+    loading = new Map();
+    maxParsers;
+    initialized = false;
+    initPromise = null;
+    ParserClass = null;
+    // SMI-1333: Track access order for proper LRU eviction
+    accessOrder = [];
+    constructor(options = {}) {
+        this.maxParsers = options.maxParsers ?? 6;
+    }
+    /**
+     * SMI-1333: Update access order for LRU tracking
+     * Moves the accessed language to the end (most recently used)
+     */
+    updateAccessOrder(language) {
+        const index = this.accessOrder.indexOf(language);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+        this.accessOrder.push(language);
+    }
+    /**
+     * Initialize web-tree-sitter (must be called before first use)
+     *
+     * This initializes the WASM runtime. Called automatically by getParser().
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        this.initPromise = this.doInitialize();
+        await this.initPromise;
+    }
+    async doInitialize() {
+        try {
+            // Dynamic import for web-tree-sitter (WASM-based)
+            // @ts-expect-error - Optional dependency, may not have type declarations
+            const TreeSitter = await import('web-tree-sitter');
+            await TreeSitter.default.init();
+            this.ParserClass = TreeSitter.default;
+            this.initialized = true;
+        }
+        catch {
+            // Fallback: try native tree-sitter if WASM unavailable
+            try {
+                // @ts-expect-error - Optional dependency, may not have type declarations
+                const TreeSitterNative = await import('tree-sitter');
+                this.ParserClass = TreeSitterNative.default;
+                this.initialized = true;
+            }
+            catch {
+                throw new Error('tree-sitter is not available. Install web-tree-sitter or tree-sitter to enable multi-language analysis.');
+            }
+        }
+    }
+    /**
+     * Get parser for a language, loading if necessary
+     *
+     * Parsers are cached for reuse. If the maximum number of
+     * parsers is reached, the least recently used is evicted.
+     *
+     * @param language - Language to get parser for
+     * @returns Configured parser instance
+     * @throws Error if language is not supported or tree-sitter unavailable
+     *
+     * @example
+     * ```typescript
+     * const parser = await manager.getParser('python')
+     * const tree = parser.parse(pythonCode)
+     * ```
+     */
+    async getParser(language) {
+        // Ensure initialized
+        await this.initialize();
+        // Return cached parser
+        const cached = this.parsers.get(language);
+        if (cached) {
+            // SMI-1333: Update access order on cache hit
+            this.updateAccessOrder(language);
+            return cached;
+        }
+        // Return in-progress load
+        const loading = this.loading.get(language);
+        if (loading) {
+            return loading;
+        }
+        // Start new load
+        const loadPromise = this.loadParser(language);
+        this.loading.set(language, loadPromise);
+        try {
+            const parser = await loadPromise;
+            // SMI-1333: Evict LRU (first in accessOrder) if at capacity
+            if (this.parsers.size >= this.maxParsers) {
+                const lru = this.accessOrder.shift();
+                if (lru) {
+                    const oldParser = this.parsers.get(lru);
+                    oldParser?.delete();
+                    this.parsers.delete(lru);
+                }
+            }
+            this.parsers.set(language, parser);
+            // SMI-1333: Track new parser in access order
+            this.updateAccessOrder(language);
+            return parser;
+        }
+        finally {
+            this.loading.delete(language);
+        }
+    }
+    /**
+     * Load a parser for a specific language
+     */
+    async loadParser(language) {
+        if (!this.ParserClass) {
+            throw new Error('TreeSitterManager not initialized. Call initialize() first.');
+        }
+        const parser = new this.ParserClass();
+        const languageModule = await this.loadLanguageModule(language);
+        parser.setLanguage(languageModule);
+        return parser;
+    }
+    /**
+     * Load the language module for tree-sitter
+     */
+    async loadLanguageModule(language) {
+        try {
+            switch (language) {
+                case 'typescript':
+                case 'javascript': {
+                    // @ts-expect-error - Optional dependency, may not have type declarations
+                    const mod = await import('tree-sitter-typescript');
+                    // tree-sitter-typescript exports { typescript, tsx }
+                    return mod.typescript;
+                }
+                case 'python': {
+                    // @ts-expect-error - Optional dependency, may not have type declarations
+                    const mod = await import('tree-sitter-python');
+                    return mod.default;
+                }
+                case 'go': {
+                    // @ts-expect-error - Optional dependency, may not have type declarations
+                    const mod = await import('tree-sitter-go');
+                    return mod.default;
+                }
+                case 'rust': {
+                    // @ts-expect-error - Optional dependency, may not have type declarations
+                    const mod = await import('tree-sitter-rust');
+                    return mod.default;
+                }
+                case 'java': {
+                    // @ts-expect-error - Optional dependency, may not have type declarations
+                    const mod = await import('tree-sitter-java');
+                    return mod.default;
+                }
+                default:
+                    throw new Error(`Unsupported language: ${language}`);
+            }
+        }
+        catch (error) {
+            const err = error;
+            throw new Error(`Failed to load tree-sitter language module for ${language}: ${err.message}. ` +
+                `Make sure tree-sitter-${language} is installed.`);
+        }
+    }
+    /**
+     * Check if a language is available
+     *
+     * @param language - Language to check
+     * @returns True if the language can be loaded
+     */
+    async isLanguageAvailable(language) {
+        try {
+            await this.loadLanguageModule(language);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get list of currently loaded languages
+     */
+    getLoadedLanguages() {
+        return Array.from(this.parsers.keys());
+    }
+    /**
+     * Clean up all parser resources
+     *
+     * Call this when the manager is no longer needed
+     * to free memory and WASM resources.
+     */
+    dispose() {
+        for (const parser of this.parsers.values()) {
+            try {
+                parser.delete();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        this.parsers.clear();
+        this.loading.clear();
+        // SMI-1333: Clear access order
+        this.accessOrder = [];
+        this.initialized = false;
+        this.initPromise = null;
+        this.ParserClass = null;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/analysis/tree-sitter/manager.js.map

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

package/dist/src/analysis/types.d.ts

@@ -1,24 +1,39 @@
 /**
  * SMI-600: Codebase Analysis Types
  * SMI-1189: Extracted from CodebaseAnalyzer.ts
+ * SMI-1303: Extended with multi-language support
  *
- * Type definitions for codebase analysis functionality.
+ * Type definitions for multi-language codebase analysis.
  *
  * @see ADR-010: Codebase Analysis Scope
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/types
  */
 /**
- * Supported file extensions for analysis
+ * Supported languages for multi-language analysis
+ */
+export type SupportedLanguage = 'typescript' | 'javascript' | 'python' | 'go' | 'rust' | 'java';
+/**
+ * Supported file extensions for analysis (legacy, for backwards compatibility)
  */
 export declare const SUPPORTED_EXTENSIONS: string[];
+/**
+ * Multi-language file extensions mapping
+ */
+export declare const LANGUAGE_EXTENSIONS: Record<SupportedLanguage, string[]>;
 /**
  * Default directories to exclude from analysis
  */
 export declare const DEFAULT_EXCLUDE_DIRS: string[];
+/**
+ * Export kind enumeration (extended for multi-language)
+ */
+export type ExportKind = 'function' | 'class' | 'variable' | 'type' | 'interface' | 'enum' | 'struct' | 'trait' | 'module' | 'unknown';
 /**
  * Import information extracted from source files
  */
 export interface ImportInfo {
-    /** Module specifier (e.g., 'react', './utils') */
+    /** Module specifier (e.g., 'react', './utils', 'os') */
     module: string;
     /** Named imports (e.g., ['useState', 'useEffect']) */
     namedImports: string[];
@@ -30,6 +45,10 @@ export interface ImportInfo {
     isTypeOnly: boolean;
     /** Source file where import was found */
     sourceFile: string;
+    /** Source language */
+    language?: SupportedLanguage;
+    /** Line number */
+    line?: number;
 }
 /**
  * Export information extracted from source files
@@ -37,12 +56,18 @@ export interface ImportInfo {
 export interface ExportInfo {
     /** Exported name */
     name: string;
-    /** Kind of export (function, class, variable, type, interface) */
-    kind: 'function' | 'class' | 'variable' | 'type' | 'interface' | 'enum' | 'unknown';
+    /** Kind of export (function, class, variable, type, interface, etc.) */
+    kind: ExportKind;
     /** Whether this is a default export */
     isDefault: boolean;
     /** Source file where export was found */
     sourceFile: string;
+    /** Source language */
+    language?: SupportedLanguage;
+    /** Visibility (for Go, Rust, Java) */
+    visibility?: 'public' | 'private' | 'protected' | 'internal';
+    /** Line number */
+    line?: number;
 }
 /**
  * Function information extracted from source files
@@ -60,6 +85,14 @@ export interface FunctionInfo {
     sourceFile: string;
     /** Line number */
     line: number;
+    /** Source language */
+    language?: SupportedLanguage;
+    /** Method receiver (Go) */
+    receiver?: string;
+    /** Decorators (Python, Java) */
+    decorators?: string[];
+    /** Attributes (Rust) */
+    attributes?: string[];
 }
 /**
  * Detected framework information
@@ -97,7 +130,7 @@ export interface CodebaseContext {
     functions: FunctionInfo[];
     /** Detected frameworks */
     frameworks: FrameworkInfo[];
-    /** Dependencies from package.json */
+    /** Dependencies from all package managers */
     dependencies: DependencyInfo[];
     /** File statistics */
     stats: {
@@ -105,6 +138,8 @@ export interface CodebaseContext {
         totalFiles: number;
         /** Files by extension */
         filesByExtension: Record<string, number>;
+        /** Files by language (optional for backward compatibility) */
+        filesByLanguage?: Record<SupportedLanguage, number>;
         /** Total lines of code (approximate) */
         totalLines: number;
     };
@@ -114,6 +149,10 @@ export interface CodebaseContext {
         durationMs: number;
         /** Analyzer version */
         version: string;
+        /** Languages detected (optional for backward compatibility) */
+        languages?: SupportedLanguage[];
+        /** Cache hit rate (0-1, optional for backward compatibility) */
+        cacheHitRate?: number;
     };
 }
 /**
@@ -135,4 +174,28 @@ export interface ParseResult {
     exports: ExportInfo[];
     functions: FunctionInfo[];
 }
+/**
+ * Framework detection rule
+ */
+export interface FrameworkRule {
+    /** Framework name */
+    name: string;
+    /** Dependency indicators (package names) */
+    depIndicators: string[];
+    /** Import indicators (module specifiers) */
+    importIndicators: string[];
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /** Current size in bytes */
+    size: number;
+    /** Number of entries */
+    entries: number;
+    /** Maximum size in bytes */
+    maxSize: number;
+    /** Cache hit rate (0-1) */
+    hitRate: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/src/analysis/types.d.ts.map

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

package/dist/src/analysis/types.js

@@ -1,15 +1,29 @@
 /**
  * SMI-600: Codebase Analysis Types
  * SMI-1189: Extracted from CodebaseAnalyzer.ts
+ * SMI-1303: Extended with multi-language support
  *
- * Type definitions for codebase analysis functionality.
+ * Type definitions for multi-language codebase analysis.
  *
  * @see ADR-010: Codebase Analysis Scope
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/types
  */
 /**
- * Supported file extensions for analysis
+ * Supported file extensions for analysis (legacy, for backwards compatibility)
  */
 export const SUPPORTED_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+/**
+ * Multi-language file extensions mapping
+ */
+export const LANGUAGE_EXTENSIONS = {
+    typescript: ['.ts', '.tsx', '.mts', '.cts'],
+    javascript: ['.js', '.jsx', '.mjs', '.cjs'],
+    python: ['.py', '.pyi', '.pyw'],
+    go: ['.go'],
+    rust: ['.rs'],
+    java: ['.java'],
+};
 /**
  * Default directories to exclude from analysis
  */
@@ -21,5 +35,12 @@ export const DEFAULT_EXCLUDE_DIRS = [
     'coverage',
     '.next',
     '.nuxt',
+    '__pycache__',
+    '.pytest_cache',
+    'target',
+    'vendor',
+    'venv',
+    '.venv',
+    'env',
 ];
 //# sourceMappingURL=types.js.map

package/dist/src/analysis/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/analysis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAElF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,OAAO;IACP,OAAO;CACR,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/analysis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAElF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwC;IACtE,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAC/B,EAAE,EAAE,CAAC,KAAK,CAAC;IACX,IAAI,EAAE,CAAC,KAAK,CAAC;IACb,IAAI,EAAE,CAAC,OAAO,CAAC;CAChB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,OAAO;IACP,OAAO;IACP,aAAa;IACb,eAAe;IACf,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;IACP,KAAK;CACN,CAAA"}

package/dist/src/analysis/worker-pool.d.ts

@@ -0,0 +1,141 @@
+/**
+ * SMI-1308: Worker Thread Pool for Parallel File Parsing
+ * SMI-1337: Added metrics integration
+ *
+ * Uses Node.js worker_threads for true parallelism,
+ * bypassing the single-threaded event loop limitation.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/worker-pool
+ */
+import { isMainThread, parentPort, workerData } from 'worker_threads';
+import { EventEmitter } from 'events';
+import type { ParseResult } from './types.js';
+import { type AnalysisMetrics } from './metrics.js';
+/**
+ * Task to be parsed by a worker
+ */
+export interface ParseTask {
+    /** Path to the file */
+    filePath: string;
+    /** File content to parse */
+    content: string;
+    /** Programming language */
+    language: string;
+}
+/**
+ * Result from a worker parse operation
+ */
+export interface WorkerResult {
+    /** Path to the file */
+    filePath: string;
+    /** Parse result */
+    result: ParseResult;
+    /** Time taken to parse in milliseconds */
+    durationMs: number;
+    /** Error message if parsing failed */
+    error?: string;
+}
+/**
+ * Options for ParserWorkerPool
+ */
+export interface WorkerPoolOptions {
+    /** Number of workers in pool (default: CPU cores - 1) */
+    poolSize?: number;
+    /** Minimum batch size to use workers (default: 10) */
+    minBatchForWorkers?: number;
+    /** Custom metrics instance (uses default if not provided) */
+    metrics?: AnalysisMetrics;
+}
+export declare class ParserWorkerPool extends EventEmitter {
+    private workers;
+    private taskQueue;
+    private activeWorkers;
+    private readonly poolSize;
+    private readonly minBatchForWorkers;
+    private readonly metrics;
+    private disposed;
+    private router;
+    private routerPromise;
+    constructor(options?: WorkerPoolOptions);
+    /**
+     * SMI-1330/1331: Get or create shared router instance
+     * Lazily initializes the router on first use and caches it
+     */
+    private getRouter;
+    /**
+     * SMI-1330/1331: Initialize router with all adapters
+     */
+    private initializeRouter;
+    /**
+     * Parse files in parallel using worker threads
+     *
+     * SMI-1337: Records worker pool metrics.
+     *
+     * @param tasks - Array of parse tasks
+     * @returns Array of worker results
+     * @throws Error if pool has been disposed
+     *
+     * @example
+     * ```typescript
+     * const results = await pool.parseFiles([
+     *   { filePath: 'a.ts', content: 'export const a = 1', language: 'typescript' },
+     *   { filePath: 'b.ts', content: 'export const b = 2', language: 'typescript' },
+     * ])
+     * ```
+     */
+    parseFiles(tasks: ParseTask[]): Promise<WorkerResult[]>;
+    /**
+     * Record parse metrics for completed results
+     * SMI-1337: Helper to record metrics after parsing
+     */
+    private recordParseMetrics;
+    /**
+     * Get language from file extension
+     * SMI-1337: Helper for metrics
+     */
+    private getLanguageFromExtension;
+    /**
+     * Parse files inline (no workers)
+     *
+     * Used for small batches where worker overhead exceeds benefit.
+     * SMI-1330/1331: Uses cached router to avoid recreation overhead
+     */
+    private parseInline;
+    /**
+     * Parse files using worker threads
+     *
+     * Chunks tasks across available workers for parallel processing.
+     */
+    private parseWithWorkers;
+    /**
+     * Dispatch a chunk of tasks to a worker
+     */
+    private dispatchToWorker;
+    /**
+     * Chunk an array into smaller arrays
+     */
+    private chunkArray;
+    /**
+     * Get pool statistics
+     *
+     * SMI-1337: Also updates metrics.
+     *
+     * @returns Current pool statistics
+     */
+    getStats(): {
+        poolSize: number;
+        activeWorkers: number;
+        queuedTasks: number;
+        utilization: number;
+    };
+    /**
+     * Dispose of worker pool
+     *
+     * Terminates all workers and clears the task queue.
+     * SMI-1330/1331: Also disposes cached router
+     */
+    dispose(): void;
+}
+export { isMainThread, parentPort, workerData };
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/src/analysis/worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../src/analysis/worker-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAU,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAEvE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AA8BD,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAIV;IACP,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAQ;IAExB,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,aAAa,CAA2C;gBAEpD,OAAO,GAAE,iBAAsB;IAO3C;;;OAGG;YACW,SAAS;IASvB;;OAEG;YACW,gBAAgB;IAkB9B;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwB7D;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;;;;OAKG;YACW,WAAW;IAsCzB;;;;OAIG;YACW,gBAAgB;IAU9B;;OAEG;YACW,gBAAgB;IAyK9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;OAMG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;KACpB;IAcD;;;;;OAKG;IACH,OAAO,IAAI,IAAI;CAchB;AAGD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,CAAA"}