@angular-modernizer/api 0.1.0

package/dist/public-api.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Public API for @angular-modernizer/api
+ *
+ * This file exports the main interfaces and classes that plugins and tools
+ * can use for Angular analysis and transformation.
+ */
+import { NgMorphAdapter } from './transformation/ng-morph-adapter.js';
+import { NgModuleManager } from './transformation/ngmodule-manager.js';
+import { ImportManager } from './transformation/import-manager.js';
+import { ServicePatternRecognizer } from './analysis/service-pattern-recognizer.js';
+import { ServiceDetector } from './analysis/service-detector.js';
+import { SymbolLocator } from './analysis/symbol-locator.js';
+import { TemplateAnalyzer } from './analysis/template-analyzer.js';
+import type { Project } from 'ts-morph';
+/**
+ * Public API interface that provides access to all analysis and transformation tools
+ */
+export interface PublicApi {
+    /**
+     * Analysis tools for code inspection and pattern detection
+     */
+    analysis: {
+        /**
+         * Service pattern recognizer for classifying Angular service patterns
+         */
+        servicePatternRecognizer: ServicePatternRecognizer;
+        /**
+         * Service detector with caching and bulk operations
+         */
+        serviceDetector: ServiceDetector;
+        /**
+         * Symbol locator for resolving symbols across the project
+         */
+        symbolLocator: SymbolLocator;
+        /**
+         * Template analyzer for analyzing Angular templates
+         */
+        templateAnalyzer: TemplateAnalyzer;
+    };
+    /**
+     * Transformation tools for code modification
+     */
+    transformation: {
+        /**
+         * NgModule manager for managing NgModule declarations and exports
+         */
+        ngModuleManager: NgModuleManager;
+        /**
+         * Import manager for managing imports with hybrid ng-morph approach
+         */
+        importManager: ImportManager;
+    };
+    /**
+     * ng-morph adapter for Angular-specific AST operations
+     */
+    ngMorph: NgMorphAdapter;
+    /**
+     * The underlying ts-morph Project instance
+     */
+    project: Project;
+}
+/**
+ * Factory function to create a PublicApi instance
+ *
+ * @param project - The ts-morph Project instance
+ * @param options - Optional configuration for the adapters
+ */
+export declare function createPublicApi(project: Project, options?: {
+    rootPath?: string;
+    pattern?: string;
+}): PublicApi;
+export { NgMorphAdapter, type NgMorphAdapterOptions } from './transformation/ng-morph-adapter.js';
+export { NgModuleManager } from './transformation/ngmodule-manager.js';
+export { ImportManager } from './transformation/import-manager.js';
+export { ServiceDetector } from './analysis/service-detector.js';
+export { ServicePatternRecognizer } from './analysis/service-pattern-recognizer.js';
+//# sourceMappingURL=public-api.d.ts.map

package/dist/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EAEf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,EAAE;QACR;;WAEG;QACH,wBAAwB,EAAE,wBAAwB,CAAC;QAEnD;;WAEG;QACH,eAAe,EAAE,eAAe,CAAC;QAEjC;;WAEG;QACH,aAAa,EAAE,aAAa,CAAC;QAE7B;;WAEG;QACH,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,CAAC;IAEF;;OAEG;IACH,cAAc,EAAE;QACd;;WAEG;QACH,eAAe,EAAE,eAAe,CAAC;QAEjC;;WAEG;QACH,aAAa,EAAE,aAAa,CAAC;KAC9B,CAAC;IAEF;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,SAAS,CAyBX;AAGD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/public-api.js

@@ -0,0 +1,50 @@
+/**
+ * Public API for @angular-modernizer/api
+ *
+ * This file exports the main interfaces and classes that plugins and tools
+ * can use for Angular analysis and transformation.
+ */
+import { NgMorphAdapter, } from './transformation/ng-morph-adapter.js';
+import { NgModuleManager } from './transformation/ngmodule-manager.js';
+import { ImportManager } from './transformation/import-manager.js';
+import { ServicePatternRecognizer } from './analysis/service-pattern-recognizer.js';
+import { ServiceDetector } from './analysis/service-detector.js';
+import { SymbolLocator } from './analysis/symbol-locator.js';
+import { TemplateAnalyzer } from './analysis/template-analyzer.js';
+/**
+ * Factory function to create a PublicApi instance
+ *
+ * @param project - The ts-morph Project instance
+ * @param options - Optional configuration for the adapters
+ */
+export function createPublicApi(project, options) {
+    const ngMorphOptions = {
+        project,
+        rootPath: options?.rootPath,
+        pattern: options?.pattern,
+    };
+    const ngMorphAdapter = new NgMorphAdapter(ngMorphOptions);
+    const servicePatternRecognizer = new ServicePatternRecognizer(ngMorphAdapter);
+    const serviceDetector = new ServiceDetector(servicePatternRecognizer);
+    return {
+        analysis: {
+            servicePatternRecognizer,
+            serviceDetector,
+            symbolLocator: new SymbolLocator(),
+            templateAnalyzer: new TemplateAnalyzer(),
+        },
+        transformation: {
+            ngModuleManager: new NgModuleManager(ngMorphAdapter),
+            importManager: new ImportManager(ngMorphAdapter),
+        },
+        ngMorph: ngMorphAdapter,
+        project,
+    };
+}
+// Re-export key types and classes
+export { NgMorphAdapter } from './transformation/ng-morph-adapter.js';
+export { NgModuleManager } from './transformation/ngmodule-manager.js';
+export { ImportManager } from './transformation/import-manager.js';
+export { ServiceDetector } from './analysis/service-detector.js';
+export { ServicePatternRecognizer } from './analysis/service-pattern-recognizer.js';
+//# sourceMappingURL=public-api.js.map

package/dist/public-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,GAEf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AA0DnE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,OAGC;IAED,MAAM,cAAc,GAA0B;QAC5C,OAAO;QACP,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO;KAC1B,CAAC;IAEF,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC;IAC1D,MAAM,wBAAwB,GAAG,IAAI,wBAAwB,CAAC,cAAc,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,wBAAwB,CAAC,CAAC;IAEtE,OAAO;QACL,QAAQ,EAAE;YACR,wBAAwB;YACxB,eAAe;YACf,aAAa,EAAE,IAAI,aAAa,EAAE;YAClC,gBAAgB,EAAE,IAAI,gBAAgB,EAAE;SACzC;QACD,cAAc,EAAE;YACd,eAAe,EAAE,IAAI,eAAe,CAAC,cAAc,CAAC;YACpD,aAAa,EAAE,IAAI,aAAa,CAAC,cAAc,CAAC;SACjD;QACD,OAAO,EAAE,cAAc;QACvB,OAAO;KACR,CAAC;AACJ,CAAC;AAED,kCAAkC;AAClC,OAAO,EAAE,cAAc,EAA8B,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC"}

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

@@ -0,0 +1,276 @@
+/**
+ * @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 type { SourceFile } from 'ts-morph';
+import type { NgMorphAdapter } from './ng-morph-adapter.js';
+/**
+ * Import information.
+ */
+export interface ImportInfo {
+    /**
+     * Module specifier (e.g., '@angular/core').
+     */
+    moduleSpecifier: string;
+    /**
+     * Named imports (e.g., ['Component', 'OnInit']).
+     */
+    namedImports?: string[];
+    /**
+     * Default import (e.g., 'React').
+     */
+    defaultImport?: string;
+    /**
+     * Namespace import (e.g., '* as fs').
+     */
+    namespaceImport?: string;
+}
+/**
+ * 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 declare class ImportManager {
+    private readonly 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?: 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: SourceFile, moduleSpecifier: string, namedImport: string, alias?: string): void;
+    /**
+     * Check if a module specifier is an Angular import.
+     *
+     * @param moduleSpecifier - The module specifier to check
+     * @returns True if it's an Angular module
+     */
+    private isAngularImport;
+    /**
+     * 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
+     */
+    private tryAddAngularImport;
+    /**
+     * 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
+     */
+    private addImportUsingTsMorph;
+    /**
+     * 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: SourceFile, namedImport: string, moduleSpecifier?: string): void;
+    /**
+     * 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: SourceFile): ImportInfo[];
+    /**
+     * 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: SourceFile): void;
+    /**
+     * 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: SourceFile): void;
+    /**
+     * 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: SourceFile): void;
+    /**
+     * 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: SourceFile, symbol: string, module?: string): boolean;
+    /**
+     * 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: SourceFile, symbol: string, module?: string): string | undefined;
+}
+//# sourceMappingURL=import-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"import-manager.d.ts","sourceRoot":"","sources":["../../src/transformation/import-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAiB;IAEjD;;;;;;OAMG;gBACS,cAAc,CAAC,EAAE,cAAc;IAG3C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IAmBP;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAkC7B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,iBAAiB,CACf,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,IAAI;IA6CP;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE;IAkChD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAsF7C;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAI1C;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAmBjD;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IA+B3E;;;;;;;;;;;;;;OAcG;IACH,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,GAAG,SAAS;CAsBtB"}