@angular-modernizer/api 0.1.0

package/dist/analysis/selector-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-mapper.d.ts","sourceRoot":"","sources":["../../src/analysis/selector-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAGV,OAAO,EAER,MAAM,UAAU,CAAC;AAGlB;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAkC;IAErD;;;;;;;;OAQG;IACH,uBAAuB,CACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS;IAQrB;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAKrD;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IA6BpC;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;CAetB"}

package/dist/analysis/selector-mapper.js

@@ -0,0 +1,146 @@
+/**
+ * @angular-modernizer/api - Selector Mapper
+ *
+ * Reusable selector-to-className mapping utility.
+ * Extracted from Phase 3's selector map caching for reuse across components.
+ *
+ * Philosophy: "Build Once, Use Everywhere"
+ * - O(n) initial build, O(1) lookups
+ * - Lazy initialization (only builds when first needed)
+ * - Universal coverage (standard `` + custom decorators)
+ */
+import { SyntaxKind } from 'ts-morph';
+/**
+ * Selector Mapper - Maps component selectors to class names.
+ *
+ * Provides O(1) selector lookups using a cached map built from project files.
+ * Supports both standard `` decorators and custom decorators (e.g., ``).
+ */
+export class SelectorMapper {
+    selectorMap;
+    /**
+     * Find a component class name by its selector.
+     *
+     * Builds the selector map lazily on first call, then reuses for O(1) lookups.
+     *
+     * @param project - ts-morph Project
+     * @param selector - Component selector (e.g., 'app-user-profile')
+     * @returns Class name (e.g., 'UserProfileComponent') or undefined if not found
+     */
+    findComponentBySelector(project, selector) {
+        // Build selector map lazily on first use
+        this.selectorMap ??= this.buildSelectorMap(project);
+        // O(1) lookup in cached map
+        return this.selectorMap.get(selector);
+    }
+    /**
+     * Get the complete selector map.
+     *
+     * Builds the map lazily if not yet built.
+     *
+     * @param project - ts-morph Project
+     * @returns Map of selector → className
+     */
+    getSelectorMap(project) {
+        this.selectorMap ??= this.buildSelectorMap(project);
+        return this.selectorMap;
+    }
+    /**
+     * Clear the cached selector map.
+     *
+     * Useful for testing or when project files have changed significantly.
+     */
+    clearCache() {
+        this.selectorMap = undefined;
+    }
+    /**
+     * Build a comprehensive selector map for the entire project.
+     *
+     * Scans all source files once to build selector → className mapping.
+     * Performance: O(n) initial build, O(1) lookup per selector.
+     *
+     * @param project - ts-morph Project
+     * @returns Map of selector → className
+     * @private
+     */
+    buildSelectorMap(project) {
+        const selectorMap = new Map();
+        const sourceFiles = project.getSourceFiles();
+        for (const sourceFile of sourceFiles) {
+            // Skip node_modules and test files for performance
+            const filePath = sourceFile.getFilePath();
+            if (filePath.includes('node_modules') ||
+                filePath.includes('.spec.ts') ||
+                filePath.includes('.d.ts')) {
+                continue;
+            }
+            const classes = sourceFile.getClasses();
+            for (const classDecl of classes) {
+                const className = classDecl.getName();
+                if (!className) {
+                    continue;
+                }
+                // Check if this class has a @Component decorator
+                // (regardless of other decorators like @ExportComponent)
+                const componentDecorator = this.findDecorator(classDecl, 'Component');
+                if (componentDecorator) {
+                    // Extract selector from @Component metadata
+                    const selector = this.extractSelectorFromDecorator(componentDecorator);
+                    if (selector) {
+                        // Add to map: selector → className
+                        selectorMap.set(selector, className);
+                    }
+                }
+            }
+        }
+        return selectorMap;
+    }
+    /**
+     * Extract the selector from a `` decorator.
+     *
+     * @param decorator - The `` decorator
+     * @returns The selector string or undefined
+     * @private
+     */
+    extractSelectorFromDecorator(decorator) {
+        const args = decorator.getArguments();
+        if (args.length === 0) {
+            return undefined;
+        }
+        const metadataObj = args[0];
+        if (!metadataObj ||
+            metadataObj.getKind() !== SyntaxKind.ObjectLiteralExpression) {
+            return undefined;
+        }
+        const objLiteral = metadataObj;
+        const selectorProperty = objLiteral.getProperty('selector');
+        if (selectorProperty) {
+            const initializer = selectorProperty.getChildAtIndex(2); // Skip name and colon
+            const text = initializer.getText();
+            // Remove quotes if present
+            return text.replaceAll(/^['"`]|['"`]$/g, '');
+        }
+        return undefined;
+    }
+    /**
+     * Find a decorator by name on a class declaration.
+     *
+     * Supports both standard decorators (``) and custom decorators (``).
+     *
+     * @param classDecl - Class declaration
+     * @param decoratorName - Decorator name (without @)
+     * @returns Decorator or undefined
+     * @private
+     */
+    findDecorator(classDecl, decoratorName) {
+        const decorators = classDecl.getDecorators();
+        for (const decorator of decorators) {
+            const name = decorator.getName();
+            if (name === decoratorName) {
+                return decorator;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=selector-mapper.js.map

package/dist/analysis/selector-mapper.js.map

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

package/dist/analysis/service-detector.d.ts

@@ -0,0 +1,164 @@
+/**
+ * @angular-modernizer/api - Service Detector
+ *
+ * Centralized service detection API with caching and bulk operations.
+ * Single source of truth for service detection across all analysis rules.
+ *
+ * ARCHITECTURE:
+ * - Wraps ServicePatternRecognizer for consistent detection
+ * - Provides caching to avoid redundant AST traversal
+ * - Supports bulk detection for performance
+ * - Used by all analysis rules that need service detection
+ */
+import type { SourceFile, ClassDeclaration } from 'ts-morph';
+import type { ServicePatternRecognizer, ServiceDetectionResult } from './service-pattern-recognizer.js';
+/**
+ * Bulk detection result for multiple classes.
+ */
+export interface BulkDetectionResult {
+    /** Map of class name to detection result */
+    results: Map<string, ServiceDetectionResult>;
+    /** Total number of services detected */
+    serviceCount: number;
+    /** Total number of classes analyzed */
+    totalCount: number;
+    /** Detection time in milliseconds */
+    detectionTimeMs: number;
+}
+/**
+ * ServiceDetector - Centralized service detection with caching.
+ *
+ * SINGLE SOURCE OF TRUTH:
+ * - All analysis rules should use this detector
+ * - Ensures consistent service detection across rules
+ * - Provides performance optimization through caching
+ *
+ * USAGE:
+ * ```typescript
+ * const detector = new ServiceDetector(recognizer);
+ *
+ * // Single detection
+ * const result = detector.detectService(classDecl);
+ *
+ * // Bulk detection
+ * const bulk = detector.detectServicesInFile(sourceFile);
+ *
+ * // Cache management
+ * detector.clearCache();
+ * ```
+ */
+export declare class ServiceDetector {
+    private readonly recognizer;
+    private readonly cache;
+    /**
+     * Create a new ServiceDetector.
+     *
+     * @param recognizer - ServicePatternRecognizer instance
+     */
+    constructor(recognizer: ServicePatternRecognizer);
+    /**
+     * Detect if a class is a service with caching.
+     *
+     * Results are cached by file path + class name for performance.
+     *
+     * @param classDecl - The class declaration to analyze
+     * @returns Service detection result with confidence
+     *
+     * @example
+     * ```typescript
+     * const result = detector.detectService(classDecl);
+     * if (result.isService && result.confidence >= 0.7) {
+     *   console.info(`High confidence service detected via ${result.detectionMethod}`);
+     * }
+     * ```
+     */
+    detectService(classDecl: ClassDeclaration): ServiceDetectionResult;
+    /**
+     * Simple check if a class is a service (cached).
+     *
+     * @param classDecl - The class declaration to check
+     * @returns True if detected as service
+     */
+    isService(classDecl: ClassDeclaration): boolean;
+    /**
+     * Detect all services in a source file (bulk operation).
+     *
+     * More efficient than detecting each class individually.
+     *
+     * @param sourceFile - The source file to analyze
+     * @returns Bulk detection result with statistics
+     *
+     * @example
+     * ```typescript
+     * const bulk = detector.detectServicesInFile(sourceFile);
+     * console.info(`Found ${bulk.serviceCount} services in ${bulk.detectionTimeMs}ms`);
+     *
+     * for (const [className, result] of bulk.results) {
+     *   if (result.isService) {
+     *     console.info(`${className}: ${result.detectionMethod} (${result.confidence})`);
+     *   }
+     * }
+     * ```
+     */
+    detectServicesInFile(sourceFile: SourceFile): BulkDetectionResult;
+    /**
+     * Detect services in multiple source files (bulk operation).
+     *
+     * @param sourceFiles - Array of source files to analyze
+     * @returns Bulk detection result with combined statistics
+     *
+     * @example
+     * ```typescript
+     * const files = project.getSourceFiles();
+     * const bulk = detector.detectServicesInFiles(files);
+     * console.info(`Found ${bulk.serviceCount} services across ${files.length} files`);
+     * ```
+     */
+    detectServicesInFiles(sourceFiles: SourceFile[]): BulkDetectionResult;
+    /**
+     * Filter classes to only services.
+     *
+     * @param classes - Array of class declarations
+     * @returns Array of service class declarations
+     *
+     * @example
+     * ```typescript
+     * const allClasses = sourceFile.getClasses();
+     * const services = detector.filterServices(allClasses);
+     * console.info(`Found ${services.length} services out of ${allClasses.length} classes`);
+     * ```
+     */
+    filterServices(classes: ClassDeclaration[]): ClassDeclaration[];
+    /**
+     * Get detection statistics from cache.
+     *
+     * @returns Statistics about cached detections
+     */
+    getCacheStatistics(): {
+        totalEntries: number;
+        serviceEntries: number;
+        nonServiceEntries: number;
+    };
+    /**
+     * Clear the detection cache.
+     *
+     * Call this when the AST has been modified and cached results
+     * may be stale.
+     *
+     * @example
+     * ```typescript
+     * // After modifying files
+     * await project.save();
+     * detector.clearCache();
+     * ```
+     */
+    clearCache(): void;
+    /**
+     * Get cache key for a class declaration.
+     *
+     * @param classDecl - The class declaration
+     * @returns Cache key string
+     */
+    private getCacheKey;
+}
+//# sourceMappingURL=service-detector.d.ts.map

package/dist/analysis/service-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-detector.d.ts","sourceRoot":"","sources":["../../src/analysis/service-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAE7C,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IAErB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAE5D;;;;OAIG;gBACS,UAAU,EAAE,wBAAwB;IAKhD;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,sBAAsB;IAgBlE;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO;IAI/C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB;IA+BjE;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,mBAAmB;IA+BrE;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE;IAI/D;;;;OAIG;IACH,kBAAkB,IAAI;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IAmBD;;;;;;;;;;;;OAYG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAKpB"}

package/dist/analysis/service-detector.js

@@ -0,0 +1,231 @@
+/**
+ * @angular-modernizer/api - Service Detector
+ *
+ * Centralized service detection API with caching and bulk operations.
+ * Single source of truth for service detection across all analysis rules.
+ *
+ * ARCHITECTURE:
+ * - Wraps ServicePatternRecognizer for consistent detection
+ * - Provides caching to avoid redundant AST traversal
+ * - Supports bulk detection for performance
+ * - Used by all analysis rules that need service detection
+ */
+/**
+ * ServiceDetector - Centralized service detection with caching.
+ *
+ * SINGLE SOURCE OF TRUTH:
+ * - All analysis rules should use this detector
+ * - Ensures consistent service detection across rules
+ * - Provides performance optimization through caching
+ *
+ * USAGE:
+ * ```typescript
+ * const detector = new ServiceDetector(recognizer);
+ *
+ * // Single detection
+ * const result = detector.detectService(classDecl);
+ *
+ * // Bulk detection
+ * const bulk = detector.detectServicesInFile(sourceFile);
+ *
+ * // Cache management
+ * detector.clearCache();
+ * ```
+ */
+export class ServiceDetector {
+    recognizer;
+    cache;
+    /**
+     * Create a new ServiceDetector.
+     *
+     * @param recognizer - ServicePatternRecognizer instance
+     */
+    constructor(recognizer) {
+        this.recognizer = recognizer;
+        this.cache = new Map();
+    }
+    /**
+     * Detect if a class is a service with caching.
+     *
+     * Results are cached by file path + class name for performance.
+     *
+     * @param classDecl - The class declaration to analyze
+     * @returns Service detection result with confidence
+     *
+     * @example
+     * ```typescript
+     * const result = detector.detectService(classDecl);
+     * if (result.isService && result.confidence >= 0.7) {
+     *   console.info(`High confidence service detected via ${result.detectionMethod}`);
+     * }
+     * ```
+     */
+    detectService(classDecl) {
+        const cacheKey = this.getCacheKey(classDecl);
+        // Check cache first
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Detect and cache result
+        const result = this.recognizer.detectService(classDecl);
+        this.cache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Simple check if a class is a service (cached).
+     *
+     * @param classDecl - The class declaration to check
+     * @returns True if detected as service
+     */
+    isService(classDecl) {
+        return this.detectService(classDecl).isService;
+    }
+    /**
+     * Detect all services in a source file (bulk operation).
+     *
+     * More efficient than detecting each class individually.
+     *
+     * @param sourceFile - The source file to analyze
+     * @returns Bulk detection result with statistics
+     *
+     * @example
+     * ```typescript
+     * const bulk = detector.detectServicesInFile(sourceFile);
+     * console.info(`Found ${bulk.serviceCount} services in ${bulk.detectionTimeMs}ms`);
+     *
+     * for (const [className, result] of bulk.results) {
+     *   if (result.isService) {
+     *     console.info(`${className}: ${result.detectionMethod} (${result.confidence})`);
+     *   }
+     * }
+     * ```
+     */
+    detectServicesInFile(sourceFile) {
+        const startTime = Date.now();
+        const results = new Map();
+        const classes = sourceFile.getClasses();
+        let serviceCount = 0;
+        for (const classDecl of classes) {
+            const className = classDecl.getName();
+            if (!className) {
+                continue;
+            }
+            const result = this.detectService(classDecl);
+            results.set(className, result);
+            if (result.isService) {
+                serviceCount++;
+            }
+        }
+        const endTime = Date.now();
+        return {
+            results,
+            serviceCount,
+            totalCount: classes.length,
+            detectionTimeMs: endTime - startTime,
+        };
+    }
+    /**
+     * Detect services in multiple source files (bulk operation).
+     *
+     * @param sourceFiles - Array of source files to analyze
+     * @returns Bulk detection result with combined statistics
+     *
+     * @example
+     * ```typescript
+     * const files = project.getSourceFiles();
+     * const bulk = detector.detectServicesInFiles(files);
+     * console.info(`Found ${bulk.serviceCount} services across ${files.length} files`);
+     * ```
+     */
+    detectServicesInFiles(sourceFiles) {
+        const startTime = Date.now();
+        const results = new Map();
+        let serviceCount = 0;
+        let totalCount = 0;
+        for (const sourceFile of sourceFiles) {
+            const fileResult = this.detectServicesInFile(sourceFile);
+            // Merge results with class name prefixed by file path for uniqueness
+            const filePath = sourceFile.getFilePath();
+            for (const [className, result] of fileResult.results) {
+                const key = `${filePath}:${className}`;
+                results.set(key, result);
+            }
+            serviceCount += fileResult.serviceCount;
+            totalCount += fileResult.totalCount;
+        }
+        const endTime = Date.now();
+        return {
+            results,
+            serviceCount,
+            totalCount,
+            detectionTimeMs: endTime - startTime,
+        };
+    }
+    /**
+     * Filter classes to only services.
+     *
+     * @param classes - Array of class declarations
+     * @returns Array of service class declarations
+     *
+     * @example
+     * ```typescript
+     * const allClasses = sourceFile.getClasses();
+     * const services = detector.filterServices(allClasses);
+     * console.info(`Found ${services.length} services out of ${allClasses.length} classes`);
+     * ```
+     */
+    filterServices(classes) {
+        return classes.filter((cls) => this.isService(cls));
+    }
+    /**
+     * Get detection statistics from cache.
+     *
+     * @returns Statistics about cached detections
+     */
+    getCacheStatistics() {
+        let serviceEntries = 0;
+        let nonServiceEntries = 0;
+        for (const result of this.cache.values()) {
+            if (result.isService) {
+                serviceEntries++;
+            }
+            else {
+                nonServiceEntries++;
+            }
+        }
+        return {
+            totalEntries: this.cache.size,
+            serviceEntries,
+            nonServiceEntries,
+        };
+    }
+    /**
+     * Clear the detection cache.
+     *
+     * Call this when the AST has been modified and cached results
+     * may be stale.
+     *
+     * @example
+     * ```typescript
+     * // After modifying files
+     * await project.save();
+     * detector.clearCache();
+     * ```
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache key for a class declaration.
+     *
+     * @param classDecl - The class declaration
+     * @returns Cache key string
+     */
+    getCacheKey(classDecl) {
+        const filePath = classDecl.getSourceFile().getFilePath();
+        const className = classDecl.getName() ?? 'anonymous';
+        return `${filePath}:${className}`;
+    }
+}
+//# sourceMappingURL=service-detector.js.map

package/dist/analysis/service-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-detector.js","sourceRoot":"","sources":["../../src/analysis/service-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsBH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,eAAe;IACT,UAAU,CAA2B;IACrC,KAAK,CAAsC;IAE5D;;;;OAIG;IACH,YAAY,UAAoC;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,SAA2B;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAE7C,oBAAoB;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,0BAA0B;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAA2B;QACnC,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,CAAC,UAAsB;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkC,CAAC;QAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;QAExC,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAE/B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,OAAO;YACL,OAAO;YACP,YAAY;YACZ,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,eAAe,EAAE,OAAO,GAAG,SAAS;SACrC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,WAAyB;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkC,CAAC;QAE1D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;YAEzD,qEAAqE;YACrE,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACrD,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACvC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC3B,CAAC;YAED,YAAY,IAAI,UAAU,CAAC,YAAY,CAAC;YACxC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC;QACtC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,OAAO;YACL,OAAO;YACP,YAAY;YACZ,UAAU;YACV,eAAe,EAAE,OAAO,GAAG,SAAS;SACrC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,OAA2B;QACxC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAKhB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,cAAc,EAAE,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,iBAAiB,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC7B,cAAc;YACd,iBAAiB;SAClB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,SAA2B;QAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,WAAW,CAAC;QACrD,OAAO,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;IACpC,CAAC;CACF"}