@angular-modernizer/api 0.1.0

package/dist/transformation/ng-morph-adapter.js

@@ -0,0 +1,179 @@
+/**
+ * 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 { getNgComponents, getNgModules, findNgModule, addImportToNgModule, addDeclarationToNgModule, addImportToComponent, addProviderToComponent, } from 'ng-morph';
+/**
+ * Adapter for ng-morph that integrates with our ts-morph Project
+ */
+export class NgMorphAdapter {
+    project;
+    pattern;
+    constructor(options) {
+        this.project = options.project;
+        this.pattern = options.pattern ?? '**/*.ts';
+    }
+    /**
+     * Get all Angular components matching a pattern
+     */
+    getComponents(pattern) {
+        return getNgComponents(pattern ?? this.pattern);
+    }
+    /**
+     * Get a specific component by file path
+     */
+    getComponent(filePath) {
+        const sourceFile = this.project.getSourceFile(filePath);
+        if (!sourceFile) {
+            return undefined;
+        }
+        const components = getNgComponents(filePath);
+        return components[0]; // Return first component in file
+    }
+    /**
+     * Get all Angular modules matching a pattern
+     */
+    getModules(pattern) {
+        return getNgModules(pattern ?? this.pattern);
+    }
+    /**
+     * Get a specific module by file path
+     */
+    getModule(filePath) {
+        const sourceFile = this.project.getSourceFile(filePath);
+        if (!sourceFile) {
+            return undefined;
+        }
+        const modules = getNgModules(filePath);
+        return modules[0]; // Return first module in file
+    }
+    /**
+     * Find the NgModule that declares a component
+     */
+    findModuleForComponent(component) {
+        return findNgModule(component, this.pattern);
+    }
+    /**
+     * 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, moduleName, options) {
+        addImportToNgModule(moduleClass, moduleName, options);
+    }
+    /**
+     * 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, declaration, options) {
+        addDeclarationToNgModule(moduleClass, declaration, options);
+    }
+    /**
+     * 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, componentName) {
+        try {
+            // Get the @NgModule decorator
+            const ngModuleDecorator = moduleClass.getDecorator('NgModule');
+            if (!ngModuleDecorator) {
+                return false;
+            }
+            // Get the decorator arguments (should be an object literal)
+            const args = ngModuleDecorator.getArguments();
+            if (args.length === 0) {
+                return false;
+            }
+            // Get the configuration object - type assertion needed for ng-morph/ts-morph compatibility
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
+            const configObj = args[0];
+            if (!configObj) {
+                return false;
+            }
+            // Find the declarations property
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+            const properties = configObj.getProperties?.() ?? [];
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            for (const prop of properties) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+                const propName = prop.getName?.() ?? '';
+                if (propName === 'declarations') {
+                    // Get the array of declarations
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+                    const initializer = prop.getInitializer?.();
+                    if (!initializer) {
+                        continue;
+                    }
+                    // Get array elements
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+                    const elements = initializer.getElements?.() ?? [];
+                    // Find and remove the component
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    for (const element of elements) {
+                        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+                        const elementText = element.getText();
+                        if (elementText === componentName) {
+                            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+                            element.remove();
+                            return true;
+                        }
+                    }
+                }
+            }
+            return false;
+        }
+        catch (error) {
+            console.warn(`Failed to remove ${componentName} from declarations:`, error);
+            return false;
+        }
+    }
+    /**
+     * 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, importName, options) {
+        addImportToComponent(componentClass, importName, options);
+    }
+    /**
+     * 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, provider, options) {
+        addProviderToComponent(componentClass, provider, options);
+    }
+    /**
+     * Apply all changes to the file system
+     * This delegates to the ts-morph Project's save method
+     */
+    async apply() {
+        await this.project.save();
+    }
+    /**
+     * Apply changes synchronously
+     */
+    applySync() {
+        this.project.saveSync();
+    }
+    /**
+     * Get the underlying ts-morph Project
+     */
+    getProject() {
+        return this.project;
+    }
+}
+//# sourceMappingURL=ng-morph-adapter.js.map

package/dist/transformation/ng-morph-adapter.js.map

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

package/dist/transformation/ngmodule-manager.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @angular-modernizer/api - NgModule Manager
+ *
+ * Service for managing NgModule declarations and exports.
+ * Handles finding NgModules and removing standalone components from them.
+ *
+ * This is critical for completing the standalone migration, as components
+ * marked as standalone must be removed from NgModule declarations/exports
+ * to avoid compiler errors.
+ *
+ * MIGRATION NOTE: Refactored to use ng-morph for Angular-specific operations.
+ * - Code reduction: 268 lines → ~150 lines (~44% reduction)
+ * - Eliminated SyntaxKind checking and manual AST traversal
+ * - Leverages ng-morph's high-level Angular abstractions
+ */
+import type { Project, SourceFile } from 'ts-morph';
+import type { NgMorphAdapter } from './ng-morph-adapter.js';
+/**
+ * NgModule Manager - manages NgModule modifications during migration.
+ *
+ * This service provides high-level operations for NgModule cleanup,
+ * enabling the removal of standalone components from NgModule declarations.
+ */
+export declare class NgModuleManager {
+    private readonly ngMorphAdapter;
+    /**
+     * Constructor for NgModuleManager.
+     *
+     * @param ngMorphAdapter - The ng-morph adapter instance
+     */
+    constructor(ngMorphAdapter: NgMorphAdapter);
+    /**
+     * Find the NgModule that declares a specific component.
+     *
+     * Uses two-tier detection strategy:
+     * 1. Fast path: ng-morph for standard `` decorators
+     * 2. Fallback: ts-morph for custom decorators (e.g., ``)
+     *
+     * This enables support for projects with external decorator patterns.
+     *
+     * @param project - The ts-morph Project instance
+     * @param componentClassName - The name of the component to find (e.g., 'CashbookOverviewComponent')
+     * @returns The source file containing the NgModule, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * const ngModuleFile = ngModuleManager.findNgModuleForComponent(project, 'CashbookOverviewComponent');
+     * if (ngModuleFile) {
+     *   console.info(`Found in: ${ngModuleFile.getFilePath()}`);
+     * }
+     * ```
+     *
+     * TIER 1 (ng-morph): Fast path for standard Angular components
+     * TIER 2 (ts-morph): Fallback for components with custom decorators
+     */
+    findNgModuleForComponent(project: Project, componentClassName: string): SourceFile | undefined;
+    /**
+     * Find NgModule for components with custom decorators (ts-morph fallback).
+     *
+     * Searches all files for:
+     * 1. A class with the target name
+     * 2. That has a `` decorator (standard or with custom decorators)
+     * 3. Then finds which NgModule declares that class
+     *
+     * This is slower than ng-morph but necessary for external decorator support.
+     *
+     * @param project - The ts-morph Project instance
+     * @param componentClassName - The name of the component class
+     * @returns The source file containing the declaring NgModule, or undefined
+     *
+     * @example
+     * ```typescript
+     * // Finds components like:
+     * // ``()
+     * // ``({ selector: 'app-user' })
+     * // export class UserComponent {}
+     * ```
+     */
+    private findNgModuleForComponentWithCustomDecorators;
+    /**
+     * Remove components from NgModule declarations and exports arrays.
+     *
+     * Uses ng-morph to locate the module and ts-morph to remove array elements.
+     * This is simpler than the previous implementation.
+     *
+     * @param ngModuleFile - The source file containing the NgModule
+     * @param classNamesToRemove - Array of component class names to remove
+     *
+     * @example
+     * ```typescript
+     * ngModuleManager.removeDeclarations(
+     *   ngModuleFile,
+     *   ['CashbookOverviewComponent', 'AddCashbookEntryDialogComponent']
+     * );
+     * ```
+     *
+     * BEFORE (ts-morph): 35+ lines with SyntaxKind and manual AST traversal
+     * AFTER (ng-morph + ts-morph): ~20 lines with cleaner logic
+     */
+    removeDeclarations(ngModuleFile: SourceFile, classNamesToRemove: string[]): void;
+    /**
+     * Get the imports array from an NgModule.
+     *
+     * Uses ng-morph to locate the module, then extracts imports using ts-morph.
+     * Simpler than the previous implementation.
+     *
+     * @param ngModuleFile - The source file containing the NgModule
+     * @returns Array of import names (e.g., ['CommonModule', 'ReactiveFormsModule'])
+     *
+     * @example
+     * ```typescript
+     * const imports = ngModuleManager.getNgModuleImports(cashbookModuleFile);
+     * // imports = ['CommonModule', 'ReactiveFormsModule', 'SharedComponentsModule']
+     * ```
+     *
+     * BEFORE (ts-morph): 45+ lines with SyntaxKind checking
+     * AFTER (ng-morph + ts-morph): ~15 lines with cleaner logic
+     */
+    getNgModuleImports(ngModuleFile: SourceFile): string[];
+    /**
+     * Extract an array property from NgModule metadata.
+     *
+     * Helper method to extract array values from metadata object.
+     *
+     * @param metadata - The metadata object from `` decorator
+     * @param propertyName - The property name (e.g., 'imports', 'declarations')
+     * @returns Array of string values from the property
+     *
+     * Note: Uses type assertions due to ng-morph/ts-morph version mismatch
+     */
+    private extractArrayFromMetadata;
+    /**
+     * Remove elements from a metadata array property.
+     *
+     * Helper method to remove specific values from arrays in metadata.
+     *
+     * @param metadata - The metadata object from `` decorator
+     * @param propertyName - The property name (e.g., 'declarations', 'exports')
+     * @param namesToRemove - Set of names to remove
+     *
+     * Note: Uses type assertions due to ng-morph/ts-morph version mismatch
+     */
+    private removeFromMetadataArray;
+}
+//# sourceMappingURL=ngmodule-manager.d.ts.map

package/dist/transformation/ngmodule-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngmodule-manager.d.ts","sourceRoot":"","sources":["../../src/transformation/ngmodule-manager.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAoB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEhD;;;;OAIG;gBACS,cAAc,EAAE,cAAc;IAI1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,wBAAwB,CACtB,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,GACzB,UAAU,GAAG,SAAS;IAwBzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,4CAA4C;IA0EpD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAAkB,CAChB,YAAY,EAAE,UAAU,EACxB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,IAAI;IAyDP;;;;;;;;;;;;;;;;;OAiBG;IACH,kBAAkB,CAAC,YAAY,EAAE,UAAU,GAAG,MAAM,EAAE;IA8CtD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;IAmDhC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,uBAAuB;CA0ChC"}