@angular-modernizer/api 0.1.0

package/src/public-api.ts

@@ -0,0 +1,119 @@
+/**
+ * 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,
+  type NgMorphAdapterOptions,
+} 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 function createPublicApi(
+  project: Project,
+  options?: {
+    rootPath?: string;
+    pattern?: string;
+  },
+): PublicApi {
+  const ngMorphOptions: NgMorphAdapterOptions = {
+    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, 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';