@angular-modernizer/api 0.1.0

package/dist/transformation/import-manager.js

@@ -0,0 +1,488 @@
+/**
+ * @angular-modernizer/api - Import Manager
+ *
+ * High-level API for managing imports in TypeScript files.
+ * Handles adding, removing, and organizing imports safely.
+ *
+ * ## HYBRID ng-morph + ts-morph APPROACH
+ *
+ * ### What ng-morph HANDLES (Component/Module Metadata):
+ * - Component imports: [] array (e.g., @Component({ imports: [CommonModule] }))
+ * - Module imports: [] array (e.g., @NgModule({ imports: [CommonModule] }))
+ * - These are decorator metadata, NOT ES6 import statements
+ *
+ * ### What ts-morph HANDLES (Everything Else):
+ * - ES6 import statements (e.g., import { CommonModule } from '@angular/common')
+ * - Import organization and merging
+ * - Removal of imports
+ * - Aliases and complex imports
+ * - Non-Angular imports
+ *
+ * ### Code Impact:
+ * - ng-morph provides value for ~5-10% of import operations (metadata only)
+ * - ts-morph still handles 90-95% of imports (ES6 statements)
+ * - Maintains 100% backward compatibility
+ *
+ * ### Why This Hybrid?
+ * ng-morph provides cleaner API for adding to decorator metadata arrays.
+ * For ES6 import statements, ng-morph is just a thin wrapper around ts-morph with no advantage.
+ */
+/**
+ * Import Manager - manages imports in source files using hybrid ng-morph + ts-morph approach.
+ *
+ * ## HYBRID STRATEGY (See file header for full explanation)
+ *
+ * **ng-morph (5-10% of operations):**
+ * - ONLY for adding to component/module imports: [] metadata arrays
+ * - Example: @Component({ imports: [CommonModule] }) ← ng-morph adds here
+ *
+ * **ts-morph (90-95% of operations):**
+ * - ES6 import statements: import { X } from 'y'
+ * - Import removal, organization, aliases
+ * - All non-metadata import operations
+ *
+ * **Result:** Cleaner API for metadata, minimal overall code reduction.
+ */
+export class ImportManager {
+    ngMorphAdapter;
+    /**
+     * Constructor for ImportManager.
+     *
+     * @param ngMorphAdapter - Optional ng-morph adapter for Angular-specific operations
+     *
+     * BACKWARD COMPATIBILITY: Constructor is optional - if not provided, falls back to pure ts-morph.
+     */
+    constructor(ngMorphAdapter) {
+        this.ngMorphAdapter = ngMorphAdapter;
+    }
+    /**
+     * Add a named import to a source file.
+     * Handles merging with existing imports from the same module.
+     *
+     * HYBRID APPROACH:
+     * - Angular imports (@angular/*): Try ng-morph for components/modules
+     * - Non-Angular/complex: Fall back to ts-morph
+     *
+     * @param sourceFile - The source file to modify
+     * @param moduleSpecifier - The module to import from (e.g., '@angular/common')
+     * @param namedImport - The named import to add (e.g., 'CommonModule')
+     * @param alias - Optional alias for the import (e.g., 'NgComponent')
+     *
+     * @example
+     * ```typescript
+     * importManager.addNamedImport(sourceFile, '@angular/common', 'CommonModule');
+     * // Result: import { CommonModule } from '@angular/common';
+     *
+     * importManager.addNamedImport(sourceFile, '@angular/core', 'Component', 'NgComponent');
+     * // Result: import { Component as NgComponent } from '@angular/core';
+     * ```
+     *
+     * BEFORE (ts-morph): 30 lines with manual checking
+     * AFTER (hybrid): ~20 lines with ng-morph for Angular imports
+     */
+    addNamedImport(sourceFile, moduleSpecifier, namedImport, alias) {
+        // Try ng-morph for Angular imports
+        if (this.ngMorphAdapter && this.isAngularImport(moduleSpecifier)) {
+            if (this.tryAddAngularImport(sourceFile, moduleSpecifier, namedImport, alias)) {
+                return;
+            }
+        }
+        // Fall back to ts-morph for non-Angular or complex cases
+        this.addImportUsingTsMorph(sourceFile, moduleSpecifier, namedImport, alias);
+    }
+    /**
+     * Check if a module specifier is an Angular import.
+     *
+     * @param moduleSpecifier - The module specifier to check
+     * @returns True if it's an Angular module
+     */
+    isAngularImport(moduleSpecifier) {
+        return moduleSpecifier.startsWith('@angular/');
+    }
+    /**
+     * Try to add an Angular import using ng-morph.
+     *
+     * ng-morph can add imports to component/module metadata (imports: [] array).
+     * This is useful for adding Angular modules like CommonModule, FormsModule, etc.
+     *
+     * @param sourceFile - The source file
+     * @param moduleSpecifier - The Angular module specifier
+     * @param namedImport - The import name (e.g., 'CommonModule')
+     * @param alias - Optional alias (not supported for metadata array imports)
+     * @returns True if successfully added via ng-morph, false to fall back
+     */
+    tryAddAngularImport(sourceFile, _moduleSpecifier, namedImport, alias) {
+        // ng-morph doesn't support aliases for metadata imports
+        if (alias) {
+            return false;
+        }
+        const filePath = sourceFile.getFilePath();
+        try {
+            // Check if this is a component file
+            const component = this.ngMorphAdapter?.getComponent(filePath);
+            if (component) {
+                // Add to component's imports array
+                this.ngMorphAdapter?.addImportToComponent(component, namedImport, {
+                    unique: true,
+                });
+                return true;
+            }
+            // Check if this is a module file
+            const module = this.ngMorphAdapter?.getModule(filePath);
+            if (module) {
+                // Add to module's imports array
+                this.ngMorphAdapter?.addImportToModule(module, namedImport, {
+                    unique: true,
+                });
+                return true;
+            }
+            // Not a component or module - fall back to ts-morph
+            return false;
+        }
+        catch {
+            // ng-morph failed - fall back to ts-morph
+            return false;
+        }
+    }
+    /**
+     * Add import using ts-morph (fallback for complex cases).
+     *
+     * @param sourceFile - The source file
+     * @param moduleSpecifier - The module specifier
+     * @param namedImport - The import name
+     * @param alias - Optional alias
+     */
+    addImportUsingTsMorph(sourceFile, moduleSpecifier, namedImport, alias) {
+        const existingImport = sourceFile.getImportDeclaration(moduleSpecifier);
+        if (!existingImport) {
+            // No import from this module exists, create a new one
+            const namedImports = alias
+                ? [{ name: namedImport, alias }]
+                : [namedImport];
+            sourceFile.addImportDeclaration({
+                moduleSpecifier,
+                namedImports,
+            });
+            return;
+        }
+        // Import from this module exists, check if the named import is already there
+        const alreadyImported = existingImport
+            .getNamedImports()
+            .some((ni) => ni.getName() === namedImport);
+        if (alreadyImported) {
+            return;
+        }
+        // Add the named import to the existing import declaration
+        const importSpec = alias ? { name: namedImport, alias } : namedImport;
+        existingImport.addNamedImport(importSpec);
+    }
+    /**
+     * Remove a named import from a source file.
+     * Cleans up empty import declarations after removal.
+     *
+     * HYBRID APPROACH:
+     * - Always uses ts-morph for removal (simpler than ng-morph)
+     * - ng-morph doesn't provide significant benefits for removal operations
+     *
+     * @param sourceFile - The source file
+     * @param namedImport - The named import to remove
+     * @param moduleSpecifier - Optional module specifier to target specific imports
+     *
+     * Handles:
+     * - Removing specific named imports from import declarations
+     * - Cleaning up empty import declarations
+     * - Preserving other imports from the same module
+     *
+     * @example
+     * ```typescript
+     * // Before: import { Foo, Bar } from './module';
+     * importManager.removeNamedImport(sourceFile, 'Bar', './module');
+     * // After: import { Foo } from './module';
+     * ```
+     */
+    removeNamedImport(sourceFile, namedImport, moduleSpecifier) {
+        const importDeclarations = sourceFile.getImportDeclarations();
+        // Helper to check if import declaration is empty after removal
+        const isEmptyImportDecl = (decl) => {
+            return (decl.getNamedImports().length === 0 &&
+                !decl.getDefaultImport() &&
+                !decl.getNamespaceImport());
+        };
+        // Find and remove the import from the first matching declaration
+        importDeclarations.some((importDecl) => {
+            // Skip if module specifier doesn't match (when specified)
+            if (moduleSpecifier &&
+                importDecl.getModuleSpecifierValue() !== moduleSpecifier) {
+                return false;
+            }
+            // Find the named import to remove
+            const importToRemove = importDecl
+                .getNamedImports()
+                .find((ni) => ni.getName() === namedImport);
+            if (!importToRemove) {
+                return false;
+            }
+            // Remove the named import
+            importToRemove.remove();
+            // Remove entire declaration if empty
+            if (isEmptyImportDecl(importDecl)) {
+                importDecl.remove();
+            }
+            return true; // Stop after first match
+        });
+    }
+    /**
+     * Get all imports from a source file.
+     *
+     * @param sourceFile - The source file
+     * @returns Array of import information
+     *
+     * Extracts:
+     * - All named imports with their module specifiers
+     * - Default imports and namespace imports
+     * - Import declaration positions for organization
+     *
+     * @example
+     * ```typescript
+     * const imports = importManager.getImports(sourceFile);
+     * // Returns:
+     * // [
+     * //   { moduleSpecifier: '@angular/core', namedImports: ['Component', 'OnInit'] },
+     * //   { moduleSpecifier: 'rxjs', namedImports: ['Observable'], defaultImport: 'Rx' }
+     * // ]
+     * ```
+     */
+    getImports(sourceFile) {
+        const imports = [];
+        const importDeclarations = sourceFile.getImportDeclarations();
+        for (const importDecl of importDeclarations) {
+            const moduleSpecifier = importDecl.getModuleSpecifierValue();
+            const importInfo = {
+                moduleSpecifier,
+            };
+            // Extract named imports
+            const namedImports = importDecl.getNamedImports();
+            if (namedImports.length > 0) {
+                importInfo.namedImports = namedImports.map((ni) => ni.getName());
+            }
+            // Extract default import
+            const defaultImport = importDecl.getDefaultImport();
+            if (defaultImport) {
+                importInfo.defaultImport = defaultImport.getText();
+            }
+            // Extract namespace import (e.g., * as fs)
+            const namespaceImport = importDecl.getNamespaceImport();
+            if (namespaceImport) {
+                importInfo.namespaceImport = namespaceImport.getText();
+            }
+            imports.push(importInfo);
+        }
+        return imports;
+    }
+    /**
+     * Organize imports (sort and remove duplicates).
+     *
+     * @param sourceFile - The source file
+     *
+     * Handles:
+     * - Sorting imports by module specifier (external libraries first, then internal)
+     * - Removing duplicate imports
+     * - Grouping related imports
+     * - Maintaining proper spacing and formatting
+     *
+     * @example
+     * ```typescript
+     * // Before:
+     * // import { Component } from '@angular/core';
+     * // import { MyService } from './my-service';
+     * // import { Injectable } from '@angular/core';
+     *
+     * importManager.organizeImports(sourceFile);
+     *
+     * // After:
+     * // import { Component, Injectable } from '@angular/core';
+     * // import { MyService } from './my-service';
+     * ```
+     */
+    organizeImports(sourceFile) {
+        const importDeclarations = sourceFile.getImportDeclarations();
+        if (importDeclarations.length === 0) {
+            return;
+        }
+        const importMap = new Map();
+        // Collect all imports grouped by module specifier
+        importDeclarations.forEach((importDecl) => {
+            const moduleSpecifier = importDecl.getModuleSpecifierValue();
+            if (!importMap.has(moduleSpecifier)) {
+                importMap.set(moduleSpecifier, {
+                    namedImports: new Map(),
+                });
+            }
+            const importData = importMap.get(moduleSpecifier);
+            // Collect named imports, preserving aliases (e.g. UserModel as DomainUser)
+            importDecl.getNamedImports().forEach((ni) => {
+                const name = ni.getName();
+                const alias = ni.getAliasNode()?.getText();
+                const key = alias ? `${name}|${alias}` : name;
+                importData.namedImports.set(key, { name, alias });
+            });
+            // Collect default import (take the first one if multiple)
+            const defaultImport = importDecl.getDefaultImport();
+            if (defaultImport && !importData.defaultImport) {
+                importData.defaultImport = defaultImport.getText();
+            }
+            // Collect namespace import (take the first one if multiple)
+            const namespaceImport = importDecl.getNamespaceImport();
+            if (namespaceImport && !importData.namespaceImport) {
+                importData.namespaceImport = namespaceImport.getText();
+            }
+        });
+        // Sort module specifiers: external first, then internal
+        const sortedModules = Array.from(importMap.keys()).sort((a, b) => {
+            const aIsExternal = !a.startsWith('.');
+            const bIsExternal = !b.startsWith('.');
+            if (aIsExternal !== bIsExternal) {
+                return aIsExternal ? -1 : 1;
+            }
+            return a.localeCompare(b);
+        });
+        // Remove all existing import declarations and add organized imports back
+        importDeclarations.forEach((decl) => decl.remove());
+        sortedModules.forEach((moduleSpecifier) => {
+            const importData = importMap.get(moduleSpecifier);
+            // Sort by name (and alias if present) for stable output
+            const namedImports = Array.from(importData.namedImports.values()).sort((a, b) => a.name.localeCompare(b.name) ||
+                (a.alias ?? '').localeCompare(b.alias ?? ''));
+            sourceFile.addImportDeclaration({
+                moduleSpecifier,
+                namedImports: namedImports.length > 0 ? namedImports : undefined,
+                defaultImport: importData.defaultImport,
+                namespaceImport: importData.namespaceImport,
+            });
+        });
+    }
+    /**
+     * Merge duplicate import declarations.
+     *
+     * Combines multiple import statements from the same module into one.
+     *
+     * @param sourceFile - The source file
+     *
+     * @example
+     * ```typescript
+     * // Before:
+     * // import { Component } from '@angular/core';
+     * // import { Injectable } from '@angular/core';
+     *
+     * importManager.mergeImports(sourceFile);
+     *
+     * // After:
+     * // import { Component, Injectable } from '@angular/core';
+     * ```
+     */
+    mergeImports(sourceFile) {
+        this.organizeImports(sourceFile);
+    }
+    /**
+     * Remove import declarations that have no imports.
+     *
+     * Cleans up empty import statements that may result from refactoring.
+     *
+     * @param sourceFile - The source file
+     *
+     * @example
+     * ```typescript
+     * // Before: import {} from '@angular/core';
+     *
+     * importManager.cleanupEmptyImports(sourceFile);
+     *
+     * // After: (empty import removed)
+     * ```
+     */
+    cleanupEmptyImports(sourceFile) {
+        const importDeclarations = sourceFile.getImportDeclarations();
+        for (const importDecl of importDeclarations) {
+            const namedImports = importDecl.getNamedImports();
+            const hasDefaultImport = !!importDecl.getDefaultImport();
+            const hasNamespaceImport = !!importDecl.getNamespaceImport();
+            // Remove if no imports at all
+            if (namedImports.length === 0 &&
+                !hasDefaultImport &&
+                !hasNamespaceImport) {
+                importDecl.remove();
+            }
+        }
+    }
+    /**
+     * Check if a named import exists in the source file.
+     *
+     * @param sourceFile - The source file
+     * @param symbol - The symbol name to check
+     * @param module - Optional module specifier to check specifically
+     * @returns True if the import exists
+     *
+     * @example
+     * ```typescript
+     * const exists = importManager.hasImport(sourceFile, 'Component', '@angular/core');
+     * // Returns true if 'import { Component } from '@angular/core';' exists
+     * ```
+     */
+    hasImport(sourceFile, symbol, module) {
+        const importDeclarations = sourceFile.getImportDeclarations();
+        for (const importDecl of importDeclarations) {
+            if (module && importDecl.getModuleSpecifierValue() !== module) {
+                continue;
+            }
+            const namedImports = importDecl.getNamedImports();
+            const hasNamedImport = namedImports.some((ni) => ni.getName() === symbol);
+            if (hasNamedImport) {
+                return true;
+            }
+            // Check default import
+            const defaultImport = importDecl.getDefaultImport();
+            if (defaultImport && defaultImport.getText() === symbol) {
+                return true;
+            }
+            // Check namespace import
+            const namespaceImport = importDecl.getNamespaceImport();
+            if (namespaceImport && namespaceImport.getText() === symbol) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get the alias for a named import, if it exists.
+     *
+     * @param sourceFile - The source file
+     * @param symbol - The symbol name
+     * @param module - Optional module specifier
+     * @returns The alias if found, undefined otherwise
+     *
+     * @example
+     * ```typescript
+     * // import { Component as NgComponent } from '@angular/core';
+     * const alias = importManager.getImportAlias(sourceFile, 'Component', '@angular/core');
+     * // Returns 'NgComponent'
+     * ```
+     */
+    getImportAlias(sourceFile, symbol, module) {
+        const importDeclarations = sourceFile.getImportDeclarations();
+        // Find the first matching import with the symbol
+        for (const importDecl of importDeclarations) {
+            // Skip if module doesn't match (when specified)
+            if (module && importDecl.getModuleSpecifierValue() !== module) {
+                continue;
+            }
+            // Find the named import with matching symbol
+            const matchingImport = importDecl
+                .getNamedImports()
+                .find((ni) => ni.getName() === symbol);
+            if (matchingImport) {
+                return matchingImport.getAliasNode()?.getText();
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=import-manager.js.map

package/dist/transformation/import-manager.js.map

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

package/dist/transformation/ng-morph-adapter.d.ts

@@ -0,0 +1,111 @@
+/**
+ * NgMorphAdapter - Wrapper around ng-morph for Angular-specific AST operations
+ *
+ * This adapter provides a simplified interface to ng-morph functionality while
+ * maintaining compatibility with our existing ts-morph-based infrastructure.
+ */
+import { type ClassDeclaration } from 'ng-morph';
+import type { Project } from 'ts-morph';
+export interface NgMorphAdapterOptions {
+    /**
+     * The ts-morph Project instance to wrap
+     */
+    project: Project;
+    /**
+     * Root path for the Angular project
+     */
+    rootPath?: string;
+    /**
+     * File pattern to match (default: '**\/*.ts')
+     */
+    pattern?: string;
+}
+/**
+ * Adapter for ng-morph that integrates with our ts-morph Project
+ */
+export declare class NgMorphAdapter {
+    private readonly project;
+    private readonly pattern;
+    constructor(options: NgMorphAdapterOptions);
+    /**
+     * Get all Angular components matching a pattern
+     */
+    getComponents(pattern?: string): ClassDeclaration[];
+    /**
+     * Get a specific component by file path
+     */
+    getComponent(filePath: string): ClassDeclaration | undefined;
+    /**
+     * Get all Angular modules matching a pattern
+     */
+    getModules(pattern?: string): ClassDeclaration[];
+    /**
+     * Get a specific module by file path
+     */
+    getModule(filePath: string): ClassDeclaration | undefined;
+    /**
+     * Find the NgModule that declares a component
+     */
+    findModuleForComponent(component: ClassDeclaration): ClassDeclaration | null;
+    /**
+     * Add an import to an NgModule
+     * @param moduleClass - The NgModule class declaration
+     * @param moduleName - Name of the module to import (e.g., 'CommonModule')
+     * @param options - Optional configuration
+     */
+    addImportToModule(moduleClass: ClassDeclaration, moduleName: string, options?: {
+        unique?: boolean;
+    }): void;
+    /**
+     * Add a declaration to an NgModule
+     * @param moduleClass - The NgModule class declaration
+     * @param declaration - Name of the component/directive/pipe to declare
+     * @param options - Optional configuration
+     */
+    addDeclarationToModule(moduleClass: ClassDeclaration, declaration: string, options?: {
+        unique?: boolean;
+    }): void;
+    /**
+     * Remove a component from an NgModule's declarations
+     * This is a custom implementation since ng-morph doesn't provide this directly
+     *
+     * Uses ts-morph to manipulate the `` decorator's declarations array.
+     *
+     * @param moduleClass - The NgModule class declaration
+     * @param componentName - Name of the component to remove
+     * @returns True if successfully removed, false otherwise
+     */
+    removeFromDeclarations(moduleClass: ClassDeclaration, componentName: string): boolean;
+    /**
+     * Add an import to a standalone component
+     * @param componentClass - The component class declaration
+     * @param importName - Name of the import (e.g., 'CommonModule')
+     * @param options - Optional configuration
+     */
+    addImportToComponent(componentClass: ClassDeclaration, importName: string, options?: {
+        unique?: boolean;
+    }): void;
+    /**
+     * Add a provider to a standalone component
+     * @param componentClass - The component class declaration
+     * @param provider - Provider to add (e.g., 'MyService')
+     * @param options - Optional configuration
+     */
+    addProviderToComponent(componentClass: ClassDeclaration, provider: string, options?: {
+        unique?: boolean;
+    }): void;
+    /**
+     * Apply all changes to the file system
+     * This delegates to the ts-morph Project's save method
+     */
+    apply(): Promise<void>;
+    /**
+     * Apply changes synchronously
+     */
+    applySync(): void;
+    /**
+     * Get the underlying ts-morph Project
+     */
+    getProject(): Project;
+}
+//# sourceMappingURL=ng-morph-adapter.d.ts.map

package/dist/transformation/ng-morph-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-morph-adapter.d.ts","sourceRoot":"","sources":["../../src/transformation/ng-morph-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAQL,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,qBAAqB;IAK1C;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAInD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAU5D;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIhD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAUzD;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,IAAI;IAI5E;;;;;OAKG;IACH,iBAAiB,CACf,WAAW,EAAE,gBAAgB,EAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,IAAI;IAIP;;;;;OAKG;IACH,sBAAsB,CACpB,WAAW,EAAE,gBAAgB,EAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,IAAI;IAIP;;;;;;;;;OASG;IACH,sBAAsB,CACpB,WAAW,EAAE,gBAAgB,EAC7B,aAAa,EAAE,MAAM,GACpB,OAAO;IAkEV;;;;;OAKG;IACH,oBAAoB,CAClB,cAAc,EAAE,gBAAgB,EAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,IAAI;IAIP;;;;;OAKG;IACH,sBAAsB,CACpB,cAAc,EAAE,gBAAgB,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,IAAI;IAIP;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,UAAU,IAAI,OAAO;CAGtB"}