@angular-modernizer/api 0.1.0

package/dist/transformation/ngmodule-manager.js

@@ -0,0 +1,356 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-call */
+/* eslint-disable @typescript-eslint/no-unsafe-argument */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+/**
+ * @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
+ */
+/**
+ * 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 class NgModuleManager {
+    ngMorphAdapter;
+    /**
+     * Constructor for NgModuleManager.
+     *
+     * @param ngMorphAdapter - The ng-morph adapter instance
+     */
+    constructor(ngMorphAdapter) {
+        this.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, componentClassName) {
+        // TIER 1: Try ng-morph first (fast path for standard Angular)
+        const components = this.ngMorphAdapter.getComponents();
+        const component = components.find((comp) => comp.getName() === componentClassName);
+        if (component) {
+            // Found via ng-morph - use standard path
+            const module = this.ngMorphAdapter.findModuleForComponent(component);
+            if (module) {
+                const filePath = module.getSourceFile().getFilePath();
+                return project.getSourceFile(filePath);
+            }
+        }
+        // TIER 2: Fallback to ts-morph for components with custom decorators
+        // This handles cases like @ExportComponent, @ExportFunction, etc.
+        return this.findNgModuleForComponentWithCustomDecorators(project, componentClassName);
+    }
+    /**
+     * 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 {}
+     * ```
+     */
+    findNgModuleForComponentWithCustomDecorators(project, componentClassName) {
+        // Step 1: Find the component class in the project
+        let componentFile;
+        let componentClass;
+        for (const sourceFile of project.getSourceFiles()) {
+            const classes = sourceFile.getClasses();
+            for (const classDecl of classes) {
+                if (classDecl.getName() === componentClassName) {
+                    // Check if this class has a @Component decorator
+                    const hasComponentDecorator = classDecl
+                        .getDecorators()
+                        .some((dec) => dec.getName() === 'Component');
+                    if (hasComponentDecorator) {
+                        componentFile = sourceFile;
+                        componentClass = classDecl;
+                        break;
+                    }
+                }
+            }
+            if (componentClass) {
+                break;
+            }
+        }
+        if (!componentClass || !componentFile) {
+            return undefined;
+        }
+        // Step 2: Find NgModule that declares this component
+        // Search all files for NgModule with this component in declarations
+        for (const sourceFile of project.getSourceFiles()) {
+            const classes = sourceFile.getClasses();
+            for (const classDecl of classes) {
+                // Check if this is an NgModule
+                const ngModuleDecorator = classDecl
+                    .getDecorators()
+                    .find((dec) => dec.getName() === 'NgModule');
+                if (!ngModuleDecorator) {
+                    continue;
+                }
+                // Extract metadata from @NgModule decorator
+                const args = ngModuleDecorator.getArguments();
+                if (args.length === 0) {
+                    continue;
+                }
+                const metadata = args[0];
+                if (!metadata) {
+                    continue;
+                }
+                // Check if declarations array contains our component
+                const declarations = this.extractArrayFromMetadata(metadata, 'declarations');
+                if (declarations.includes(componentClassName)) {
+                    return sourceFile;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * 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, classNamesToRemove) {
+        if (classNamesToRemove.length === 0) {
+            return;
+        }
+        console.info(`  [NgModuleManager] removeDeclarations() called for: ${ngModuleFile.getFilePath()}`);
+        console.info(`  [NgModuleManager] Removing: [${classNamesToRemove.join(', ')}]`);
+        const namesToRemoveSet = new Set(classNamesToRemove);
+        // Use ts-morph directly instead of ng-morph (same pattern as getNgModuleImports)
+        const classes = ngModuleFile.getClasses();
+        for (const classDecl of classes) {
+            // Find the @NgModule decorator
+            const ngModuleDecorator = classDecl
+                .getDecorators()
+                .find((dec) => dec.getName() === 'NgModule');
+            if (!ngModuleDecorator) {
+                continue;
+            }
+            console.info(`  [NgModuleManager] Found @NgModule decorator on class: ${classDecl.getName()}`);
+            // Extract metadata from @NgModule decorator1
+            const args = ngModuleDecorator.getArguments();
+            if (args.length === 0) {
+                console.info(`  [NgModuleManager] Decorator has no arguments`);
+                continue;
+            }
+            const metadata = args[0];
+            if (!metadata) {
+                console.info(`  [NgModuleManager] First argument is null/undefined`);
+                continue;
+            }
+            // Remove from declarations and exports arrays using ts-morph metadata
+            console.info(`  [NgModuleManager] Removing from declarations and exports arrays...`);
+            this.removeFromMetadataArray(metadata, 'declarations', namesToRemoveSet);
+            this.removeFromMetadataArray(metadata, 'exports', namesToRemoveSet);
+            console.info(`  [NgModuleManager] Removal complete`);
+            return; // Done - only one NgModule per file
+        }
+        console.info(`  [NgModuleManager] No @NgModule decorator found in file`);
+    }
+    /**
+     * 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) {
+        const filePath = ngModuleFile.getFilePath();
+        console.info(`  [NgModuleManager] getNgModuleImports() called for: ${filePath}`);
+        // Use ts-morph directly instead of ng-morph (same as findNgModuleForComponentWithCustomDecorators)
+        // This ensures we can extract imports even when file isn't in ng-morph's Project
+        const classes = ngModuleFile.getClasses();
+        for (const classDecl of classes) {
+            // Find the @NgModule decorator
+            const ngModuleDecorator = classDecl
+                .getDecorators()
+                .find((dec) => dec.getName() === 'NgModule');
+            if (!ngModuleDecorator) {
+                continue;
+            }
+            console.info(`  [NgModuleManager] Found @NgModule decorator on class: ${classDecl.getName()}`);
+            // Extract metadata from @NgModule decorator
+            const args = ngModuleDecorator.getArguments();
+            if (args.length === 0) {
+                console.info(`  [NgModuleManager] Decorator has no arguments`);
+                continue;
+            }
+            const metadata = args[0];
+            if (!metadata) {
+                console.info(`  [NgModuleManager] First argument is null/undefined`);
+                continue;
+            }
+            console.info(`  [NgModuleManager] Extracting imports array...`);
+            // Extract imports array using ts-morph metadata
+            return this.extractArrayFromMetadata(metadata, 'imports');
+        }
+        console.info(`  [NgModuleManager] No @NgModule decorator found in file`);
+        return [];
+    }
+    /**
+     * 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
+     */
+    extractArrayFromMetadata(metadata, propertyName) {
+        console.info(`  [NgModuleManager] Extracting array: ${propertyName}`);
+        try {
+            const objLiteral = metadata.asKind(metadata.getKind());
+            if (!objLiteral || typeof objLiteral.getProperty !== 'function') {
+                console.info(`  [NgModuleManager] No objLiteral or getProperty function`);
+                return [];
+            }
+            const property = objLiteral.getProperty(propertyName);
+            if (!property || typeof property.getInitializer !== 'function') {
+                console.info(`  [NgModuleManager] No property '${propertyName}' or getInitializer function`);
+                console.info(`  [NgModuleManager] Available properties:`, objLiteral.getProperties
+                    ? objLiteral
+                        .getProperties()
+                        .map((p) => p.getName())
+                        .join(', ')
+                    : 'N/A');
+                return [];
+            }
+            const initializer = property.getInitializer();
+            if (!initializer || typeof initializer.getElements !== 'function') {
+                console.info(`  [NgModuleManager] No initializer or getElements function`);
+                return [];
+            }
+            const elements = initializer.getElements();
+            const result = elements.map((el) => el.getText().trim());
+            console.info(`  [NgModuleManager] Extracted ${result.length} elements: [${result.join(', ')}]`);
+            return result;
+        }
+        catch (error) {
+            console.info(`  [NgModuleManager] Exception during extraction:`, error);
+            return [];
+        }
+    }
+    /**
+     * 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
+     */
+    removeFromMetadataArray(metadata, propertyName, namesToRemove) {
+        try {
+            const objLiteral = metadata.asKind(metadata.getKind());
+            if (!objLiteral || typeof objLiteral.getProperty !== 'function') {
+                return;
+            }
+            const property = objLiteral.getProperty(propertyName);
+            if (!property || typeof property.getInitializer !== 'function') {
+                return;
+            }
+            const arrayLiteral = property.getInitializer();
+            if (!arrayLiteral || typeof arrayLiteral.getElements !== 'function') {
+                return;
+            }
+            const elements = arrayLiteral.getElements();
+            // Collect indices to remove
+            const indicesToRemove = [];
+            elements.forEach((element, index) => {
+                const elementName = element.getText().trim();
+                if (namesToRemove.has(elementName)) {
+                    indicesToRemove.push(index);
+                }
+            });
+            // Remove in reverse order to preserve indices
+            indicesToRemove.reverse().forEach((index) => {
+                if (typeof arrayLiteral.removeElement === 'function') {
+                    arrayLiteral.removeElement(index);
+                }
+            });
+        }
+        catch {
+            // Silently fail if metadata structure is unexpected
+        }
+    }
+}
+//# sourceMappingURL=ngmodule-manager.js.map

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

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@angular-modernizer/api",
+  "version": "0.1.0",
+  "description": "Battle-tested analysis and transformation tools for Angular Modernizer",
+  "keywords": [
+    "angular",
+    "modernization",
+    "typescript",
+    "ast",
+    "ts-morph",
+    "code-analysis",
+    "code-transformation"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eiweiss/tsanalyzer.git",
+    "directory": "packages/api"
+  },
+  "homepage": "https://github.com/eiweiss/tsanalyzer#readme",
+  "bugs": "https://github.com/eiweiss/tsanalyzer/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "!dist/**/__tests__/**",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.spec.ts"
+  ],
+  "dependencies": {
+    "@angular/compiler": "^17.3.12",
+    "lru-cache": "^10.4.3",
+    "ng-morph": "^4.8.4",
+    "ts-morph": "^27.0.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.0",
+    "jest": "^30.2.0",
+    "rimraf": "^6.1.0",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "typedocOptions": {
+    "entryPoints": [
+      "./src/index.ts"
+    ],
+    "tsconfig": "./tsconfig.json"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts"
+  }
+}

package/src/analysis/complexity-metrics-calculator.ts

@@ -0,0 +1,253 @@
+/**
+ * @angular-modernizer/api - Complexity Metrics Calculator
+ *
+ * Calculates code complexity and maintainability metrics for Angular applications.
+ * Provides quantitative measures to prioritize refactoring efforts.
+ */
+
+import type { SourceFile, ClassDeclaration, MethodDeclaration } from 'ts-morph';
+
+/**
+ * Angular-specific metrics for components and directives.
+ */
+export interface AngularMetrics {
+  /**
+   * Number of lifecycle hooks (ngOnInit, ngOnDestroy, etc.).
+   */
+  lifecycleHooks: number;
+
+  /**
+   * Number of @Input properties.
+   */
+  inputs: number;
+
+  /**
+   * Number of @Output properties.
+   */
+  outputs: number;
+
+  /**
+   * Number of Angular decorators (@Component, @Directive, etc.).
+   */
+  decorators: number;
+}
+
+/**
+ * Complexity Metrics Calculator - analyzes code complexity and maintainability.
+ */
+export class ComplexityMetricsCalculator {
+  /**
+   * Calculate overall complexity score for a class (0-100 scale).
+   * Custom weighted heuristic combining established metrics (McCabe's Cyclomatic Complexity,
+   * LOC, method count from CK metrics) with Angular-specific indicators.
+   *
+   * Combines multiple metrics:
+   * - Cyclomatic complexity
+   * - Lines of code
+   * - Method count
+   * - Angular-specific complexity
+   *
+   * @param classDecl - The class declaration to analyze
+   * @returns Complexity score (0-100)
+   */
+  calculateOverallComplexity(classDecl: ClassDeclaration): number {
+    const cyclomatic = this.calculateCyclomaticComplexity(classDecl);
+    const loc = this.calculateLOC(classDecl.getSourceFile());
+    const methods = this.calculateMethodCount(classDecl);
+    const angularMetrics = this.calculateAngularSpecificMetrics(classDecl);
+
+    // Weighted formula for overall complexity - Weights empirically tuned for Angular applications:
+    // - 40%: Cyclomatic complexity (McCabe, 1976) - control flow decision points
+    // - 20%: Lines of code (÷10 normalization) - file size indicator
+    // - 20%: Method count (×2 amplification) - class size indicator (inspired by WMC from CK metrics)
+    // - 20%: Angular features (×1.5 weight) - framework coupling (lifecycle hooks, @Input, @Output)
+    // Returns 0-100 scale for prioritizing refactoring efforts.
+    const score =
+      cyclomatic * 0.4 +
+      (loc / 10) * 0.2 +
+      methods * 2 * 0.2 +
+      (angularMetrics.lifecycleHooks +
+        angularMetrics.inputs +
+        angularMetrics.outputs) *
+        1.5 *
+        0.2;
+
+    return Math.min(100, Math.max(0, score));
+  }
+
+  /**
+   * Calculate cyclomatic complexity for a class.
+   *
+   * Measures the number of linearly independent paths through the code.
+   * Higher values indicate more complex control flow.
+   *
+   * @param classDecl - The class declaration
+   * @returns Cyclomatic complexity score
+   */
+  calculateCyclomaticComplexity(classDecl: ClassDeclaration): number {
+    let complexity = 1; // Base complexity
+
+    const methods = classDecl.getMethods();
+    for (const method of methods) {
+      complexity += this.calculateMethodComplexity(method);
+    }
+
+    return complexity;
+  }
+
+  /**
+   * Calculate cyclomatic complexity for a single method.
+   * Implements McCabe's algorithm by counting decision points:
+   * if/else if, loops, switch cases, ternary operators, logical operators.
+   */
+  private calculateMethodComplexity(method: MethodDeclaration): number {
+    let complexity = 1; // Base complexity
+
+    const patterns = [
+      { regex: /\bif\s*\(/g, description: 'if statements' },
+      { regex: /\b(for|while|do)\s*\(/g, description: 'loops' },
+      { regex: /\bcase\s+/g, description: 'switch cases' },
+      { regex: /\?/g, description: 'ternary operators' },
+      { regex: /(&&|\|\|)/g, description: 'logical operators' },
+    ];
+
+    const statements = method.getStatements();
+    statements.forEach((statement) => {
+      const text = statement.getText();
+      patterns.forEach(({ regex }) => {
+        const matches = text.match(regex);
+        complexity += matches?.length ?? 0;
+      });
+    });
+
+    return complexity;
+  }
+
+  /**
+   * Calculate lines of code for a source file.
+   *
+   * Excludes comments and whitespace for meaningful LOC count.
+   *
+   * @param sourceFile - The source file
+   * @returns Number of lines of code
+   */
+  calculateLOC(sourceFile: SourceFile): number {
+    const text = sourceFile.getText();
+    const lines = text.split('\n');
+
+    let loc = 0;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      // Count non-empty, non-comment lines
+      if (
+        trimmed &&
+        !trimmed.startsWith('//') &&
+        !trimmed.startsWith('/*') &&
+        !trimmed.startsWith('*')
+      ) {
+        loc++;
+      }
+    }
+
+    return loc;
+  }
+
+  /**
+   * Calculate the number of methods in a class.
+   *
+   * @param classDecl - The class declaration
+   * @returns Number of methods
+   */
+  calculateMethodCount(classDecl: ClassDeclaration): number {
+    return classDecl.getMethods().length;
+  }
+
+  /**
+   * Calculate dependency count for a source file.
+   *
+   * Counts unique external dependencies (imports from node_modules).
+   *
+   * @param sourceFile - The source file
+   * @returns Number of unique dependencies
+   */
+  calculateDependencyCount(sourceFile: SourceFile): number {
+    const importDeclarations = sourceFile.getImportDeclarations();
+    const dependencies = new Set<string>();
+
+    for (const importDecl of importDeclarations) {
+      const moduleSpecifier = importDecl.getModuleSpecifierValue();
+      // Only count external dependencies (not relative imports)
+      if (
+        !moduleSpecifier.startsWith('.') &&
+        !moduleSpecifier.startsWith('/')
+      ) {
+        dependencies.add(moduleSpecifier);
+      }
+    }
+
+    return dependencies.size;
+  }
+
+  /**
+   * Calculate Angular-specific metrics for a class.
+   *
+   * Analyzes Angular decorators and patterns.
+   *
+   * @param classDecl - The class declaration
+   * @returns Angular-specific metrics
+   */
+  calculateAngularSpecificMetrics(classDecl: ClassDeclaration): AngularMetrics {
+    const metrics = { lifecycleHooks: 0, inputs: 0, outputs: 0, decorators: 0 };
+
+    const lifecycleHookNames = new Set([
+      'ngOnInit',
+      'ngOnDestroy',
+      'ngOnChanges',
+      'ngDoCheck',
+      'ngAfterContentInit',
+      'ngAfterContentChecked',
+      'ngAfterViewInit',
+      'ngAfterViewChecked',
+    ]);
+
+    const countIODecorators = (
+      decorators: ReturnType<typeof classDecl.getDecorators>,
+    ) => {
+      decorators.forEach((decorator) => {
+        const name = decorator.getName();
+        if (name === 'Input') {
+          metrics.inputs++;
+        }
+        if (name === 'Output') {
+          metrics.outputs++;
+        }
+      });
+    };
+
+    classDecl.getDecorators().forEach((decorator) => {
+      const name = decorator.getName();
+      metrics.decorators++;
+
+      if (name === 'Component' || name === 'Directive') {
+        // Count lifecycle hook methods
+        classDecl.getMethods().forEach((method) => {
+          if (lifecycleHookNames.has(method.getName())) {
+            metrics.lifecycleHooks++;
+          }
+        });
+
+        // Count @Input and @Output on properties
+        classDecl.getProperties().forEach((prop) => {
+          countIODecorators(prop.getDecorators());
+        });
+
+        // Count @Input/@Output on setters
+        classDecl.getSetAccessors().forEach((setter) => {
+          countIODecorators(setter.getDecorators());
+        });
+      }
+    });
+
+    return metrics;
+  }
+}