@angular-modernizer/api 0.1.0

package/dist/analysis/dependency-analyzer.js

@@ -0,0 +1,451 @@
+/**
+ * @angular-modernizer/api - Dependency Analyzer
+ *
+ * The "All-Knowing Cartographer" - builds comprehensive symbol maps for Angular modules.
+ * Recursively walks NgModule imports to create a complete map of available symbols.
+ *
+ * Philosophy: "Trust the Map"
+ * - Builds the definitive map of what's available in a module's scope
+ * - Handles the critical edge case: `` on setters with aliases
+ * - Plugins use this map to make intelligent decisions
+ */
+/**
+ * Dependency Analyzer - extracts dependency relationships and builds symbol maps.
+ *
+ * This is the "All-Knowing Cartographer" that creates comprehensive maps of
+ * what's available in an NgModule's scope.
+ */
+export class DependencyAnalyzer {
+    /**
+     * Analyze all dependencies from a source file.
+     * Extracts all named imports and creates dependency objects for each.
+     *
+     * @param sourceFile - The source file to analyze
+     * @returns Array of dependencies
+     */
+    analyzeDependencies(sourceFile) {
+        const filePath = sourceFile.getFilePath();
+        return sourceFile.getImportDeclarations().flatMap((importDecl) => {
+            const moduleSpecifier = importDecl.getModuleSpecifierValue();
+            return importDecl.getNamedImports().map((namedImport) => ({
+                from: filePath,
+                to: moduleSpecifier,
+                type: 'import',
+                symbol: namedImport.getName(),
+            }));
+        });
+    }
+    /**
+     * Check if a file depends on another file.
+     *
+     * @param sourceFile - The source file
+     * @param targetPath - The target file path
+     * @returns True if dependency exists
+     */
+    dependsOn(sourceFile, targetPath) {
+        const dependencies = this.analyzeDependencies(sourceFile);
+        return dependencies.some((dep) => dep.to === targetPath);
+    }
+    /**
+     * Build a comprehensive symbol map for an NgModule.
+     *
+     * This is the heart of the "Trust the Map" architecture.
+     * It creates the definitive map of what's available in a module's scope.
+     *
+     * @param moduleFile - The source file containing the NgModule
+     * @param project - Optional ts-morph Project to resolve symbols across files
+     * @returns Complete symbol map
+     */
+    buildSymbolMap(moduleFile, project) {
+        const symbolMap = {
+            declared: new Map(),
+            imported: new Map(),
+            exported: new Map(),
+            available: new Map(),
+        };
+        // Find the NgModule class
+        const moduleClass = this.findNgModuleClass(moduleFile);
+        if (!moduleClass) {
+            return symbolMap;
+        }
+        // Extract symbols from the @NgModule decorator
+        const decorator = this.findDecorator(moduleClass, 'NgModule');
+        if (!decorator) {
+            return symbolMap;
+        }
+        // Parse the decorator to find declarations, imports, exports
+        const decoratorText = decorator.getText();
+        // Extract declared symbols
+        const declarations = this.extractArrayProperty(decoratorText, 'declarations');
+        declarations.forEach((className) => {
+            let symbolInfo = this.extractSymbolInfo(moduleFile, className);
+            if (!symbolInfo && project) {
+                const foundFile = project
+                    .getSourceFiles()
+                    .find((sf) => this.extractSymbolInfo(sf, className));
+                symbolInfo = foundFile
+                    ? this.extractSymbolInfo(foundFile, className)
+                    : undefined;
+            }
+            if (symbolInfo) {
+                symbolMap.declared.set(className, symbolInfo);
+                symbolMap.available.set(className, symbolInfo);
+            }
+        });
+        // Extract imported symbols (from other modules)
+        const imports = this.extractArrayProperty(decoratorText, 'imports');
+        const knownModules = new Set(['CommonModule', 'FormsModule']);
+        imports.forEach((moduleName) => {
+            if (knownModules.has(moduleName)) {
+                const builtInSymbol = {
+                    className: moduleName,
+                    selectors: [],
+                    inputs: [],
+                    outputs: [],
+                    type: 'module',
+                    filePath: '@angular/common',
+                };
+                symbolMap.imported.set(moduleName, builtInSymbol);
+                symbolMap.available.set(moduleName, builtInSymbol);
+            }
+            if (project && !knownModules.has(moduleName)) {
+                const importedModuleSymbols = this.loadModuleExports(moduleName, project, moduleFile);
+                importedModuleSymbols.forEach((symbolInfo, symbolName) => {
+                    symbolMap.imported.set(symbolName, symbolInfo);
+                    symbolMap.available.set(symbolName, symbolInfo);
+                });
+            }
+        });
+        // Extract exported symbols
+        const exports = this.extractArrayProperty(decoratorText, 'exports');
+        exports.forEach((className) => {
+            const symbolInfo = symbolMap.declared.get(className) ?? symbolMap.imported.get(className);
+            if (symbolInfo) {
+                symbolMap.exported.set(className, symbolInfo);
+            }
+        });
+        return symbolMap;
+    }
+    /**
+     * Load exported symbols from an imported module.
+     * Recursively resolves module imports to build complete symbol map.
+     *
+     * @param moduleName - The module class name to load
+     * @param project - The ts-morph project
+     * @param _currentFile - The current source file (reserved for future use in resolving relative imports)
+     * @returns Map of exported symbols
+     */
+    loadModuleExports(moduleName, project, _currentFile) {
+        const exports = new Map();
+        const allSourceFiles = project.getSourceFiles();
+        // Find the module class across all source files
+        const moduleResult = allSourceFiles
+            .map((sf) => ({ file: sf, class: sf.getClass(moduleName) }))
+            .find(({ class: cls }) => cls && this.findDecorator(cls, 'NgModule'));
+        if (!moduleResult?.class) {
+            return exports;
+        }
+        const { file: moduleFile, class: moduleClass } = moduleResult;
+        // Get the @NgModule decorator
+        const decorator = this.findDecorator(moduleClass, 'NgModule');
+        if (!decorator) {
+            return exports;
+        }
+        // Extract exported symbols from the module
+        const exportedSymbols = this.extractArrayProperty(decorator.getText(), 'exports');
+        exportedSymbols.forEach((symbolName) => {
+            let symbolInfo = this.extractSymbolInfo(moduleFile, symbolName);
+            if (!symbolInfo) {
+                const foundFile = allSourceFiles.find((sf) => this.extractSymbolInfo(sf, symbolName));
+                symbolInfo = foundFile
+                    ? this.extractSymbolInfo(foundFile, symbolName)
+                    : undefined;
+            }
+            if (symbolInfo) {
+                exports.set(symbolName, symbolInfo);
+            }
+        });
+        return exports;
+    }
+    /**
+     * Get all transitive dependencies for a source file.
+     * Follows dependency chain recursively.
+     *
+     * @param sourceFile - The source file
+     * @param project - The ts-morph project
+     * @param visited - Set of already visited files (for cycle detection)
+     * @returns Array of all transitive dependencies
+     */
+    getTransitiveDependencies(sourceFile, project, visited = new Set()) {
+        const filePath = sourceFile.getFilePath();
+        // Prevent infinite recursion
+        if (visited.has(filePath)) {
+            return [];
+        }
+        visited.add(filePath);
+        const directDependencies = this.analyzeDependencies(sourceFile);
+        const localDeps = directDependencies.filter((dep) => dep.to.startsWith('.') || dep.to.startsWith('/'));
+        const transitiveDeps = localDeps.flatMap((dep) => {
+            const depPath = dep.to.replace(/^\.\//, '').replace(/\.ts$/, '');
+            const depSourceFile = project.getSourceFiles().find((sf) => {
+                const sfPath = sf.getFilePath();
+                return (sfPath.includes(depPath + '.ts') ||
+                    sfPath.endsWith('/' + depPath + '.ts'));
+            });
+            return depSourceFile
+                ? this.getTransitiveDependencies(depSourceFile, project, visited)
+                : [];
+        });
+        return [...directDependencies, ...transitiveDeps];
+    }
+    /**
+     * Detect circular dependencies in a project.
+     *
+     * @param project - The ts-morph project
+     * @returns Array of circular dependency chains
+     */
+    detectCircularDependencies(project) {
+        const cycles = [];
+        const sourceFiles = project.getSourceFiles();
+        for (const sourceFile of sourceFiles) {
+            const filePath = sourceFile.getFilePath();
+            const visited = new Set();
+            const path = [];
+            this.detectCyclesFromFile(sourceFile, project, visited, path, cycles, filePath);
+        }
+        // Deduplicate cycles (same cycle can be found from different starting points)
+        return this.deduplicateCycles(cycles);
+    }
+    /**
+     * Detect cycles starting from a specific file.
+     * Recursively traverses local dependencies to find circular import chains.
+     * Severity based on cycle length: >3 files = error, ≤3 files = warning.
+     */
+    detectCyclesFromFile(sourceFile, project, visited, path, cycles, targetFile) {
+        const filePath = sourceFile.getFilePath();
+        // If we've returned to the target file, we found a cycle
+        if (path.length > 0 && filePath === targetFile) {
+            cycles.push({
+                cycle: [...path, filePath],
+                severity: path.length > 3 ? 'error' : 'warning',
+            });
+            return;
+        }
+        // Prevent infinite recursion on already visited paths
+        if (visited.has(filePath)) {
+            return;
+        }
+        visited.add(filePath);
+        path.push(filePath);
+        // Follow dependencies - filter to local project files only (not node_modules)
+        const localDeps = this.analyzeDependencies(sourceFile).filter((dep) => dep.to.startsWith('.') || dep.to.startsWith('/'));
+        localDeps.forEach((dep) => {
+            // Normalize import path: strip leading ./ and .ts extension
+            const depPath = dep.to.replace(/^\.\//, '').replace(/\.ts$/, '');
+            const depSourceFile = project.getSourceFiles().find((sf) => {
+                const sfPath = sf.getFilePath();
+                // Handle both relative imports with and without .ts extension
+                return (sfPath.includes(depPath + '.ts') ||
+                    sfPath.endsWith('/' + depPath + '.ts'));
+            });
+            if (depSourceFile) {
+                // Recurse with fresh visited set and path copy to track independent branches
+                this.detectCyclesFromFile(depSourceFile, project, new Set(visited), [...path], cycles, targetFile);
+            }
+        });
+    }
+    /**
+     * Deduplicate cycle arrays (same cycle in different order).
+     * Example: [A→B→C→A] and [B→C→A→B] represent the same cycle.
+     * Uses sorted paths to create unique signatures for comparison.
+     */
+    deduplicateCycles(cycles) {
+        const seen = new Set();
+        return cycles.filter((item) => {
+            // Normalize cycle by sorting paths and creating unique signature
+            const sorted = [...item.cycle].sort();
+            const signature = sorted.join('->');
+            if (seen.has(signature)) {
+                return false;
+            }
+            seen.add(signature);
+            return true;
+        });
+    }
+    /**
+     * Extract comprehensive symbol information from a class.
+     * Identifies Angular artifact types (``, ``, ``) and extracts metadata.
+     *
+     * CRITICAL: Handles the edge case of `` on setters with aliases.
+     *
+     * @param sourceFile - The source file
+     * @param className - The class name to analyze
+     * @returns Symbol information or undefined
+     */
+    extractSymbolInfo(sourceFile, className) {
+        const classDecl = sourceFile.getClass(className);
+        if (!classDecl) {
+            return undefined;
+        }
+        const filePath = sourceFile.getFilePath();
+        // Map decorator types to extraction methods
+        const decoratorHandlers = [
+            { name: 'Component', extract: this.extractComponentInfo.bind(this) },
+            { name: 'Directive', extract: this.extractDirectiveInfo.bind(this) },
+            { name: 'Pipe', extract: this.extractPipeInfo.bind(this) },
+        ];
+        for (const { name, extract } of decoratorHandlers) {
+            const decorator = this.findDecorator(classDecl, name);
+            if (decorator) {
+                return extract(classDecl, decorator, filePath);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract component information including selectors and inputs.
+     */
+    extractComponentInfo(classDecl, decorator, filePath) {
+        const decoratorText = decorator.getText();
+        const selector = this.extractStringProperty(decoratorText, 'selector');
+        return {
+            className: classDecl.getName() ?? 'UnknownComponent',
+            selectors: selector ? [selector] : [],
+            inputs: this.extractInputs(classDecl),
+            outputs: this.extractOutputs(classDecl),
+            type: 'component',
+            filePath,
+        };
+    }
+    /**
+     * Extract directive information including selectors and inputs.
+     */
+    extractDirectiveInfo(classDecl, decorator, filePath) {
+        const decoratorText = decorator.getText();
+        const selector = this.extractStringProperty(decoratorText, 'selector');
+        // For attribute selectors like '[myDirective]', we want both forms
+        const selectors = [];
+        if (selector) {
+            selectors.push(selector);
+            // If it's an attribute selector, also add the bare name
+            const bareSelector = selector.replace(/^\[|\]$/g, '');
+            if (bareSelector !== selector) {
+                selectors.push(bareSelector);
+            }
+        }
+        return {
+            className: classDecl.getName() ?? 'UnknownDirective',
+            selectors,
+            inputs: this.extractInputs(classDecl),
+            outputs: this.extractOutputs(classDecl),
+            type: 'directive',
+            filePath,
+        };
+    }
+    /**
+     * Extract pipe information.
+     */
+    extractPipeInfo(classDecl, decorator, filePath) {
+        const decoratorText = decorator.getText();
+        const name = this.extractStringProperty(decoratorText, 'name');
+        return {
+            className: classDecl.getName() ?? 'UnknownPipe',
+            selectors: name ? [name] : [],
+            inputs: [],
+            outputs: [],
+            type: 'pipe',
+            filePath,
+        };
+    }
+    /**
+     * Extract all `` properties from a class.
+     *
+     * CRITICAL: Handles the edge case of `` on setters with aliases.
+     * Example: ``('customValue') set value(val: any) { ... }
+     * This should extract 'customValue', not 'value'.
+     */
+    extractInputs(classDecl) {
+        // Helper to extract decorated names with optional aliases
+        const extractDecorated = (nodes, decoratorName) => {
+            const results = [];
+            nodes.forEach((node) => {
+                const decorator = this.findDecorator(node, decoratorName);
+                if (decorator) {
+                    const alias = this.extractDecoratorAlias(decorator);
+                    results.push(alias ?? node.getName());
+                }
+            });
+            return results;
+        };
+        // Extract from properties, setters (CRITICAL for fixture test!), and getters
+        return [
+            ...extractDecorated(classDecl.getProperties(), 'Input'),
+            ...extractDecorated(classDecl.getSetAccessors(), 'Input'),
+            ...extractDecorated(classDecl.getGetAccessors(), 'Input'),
+        ];
+    }
+    /**
+     * Extract all `` properties from a class.
+     */
+    extractOutputs(classDecl) {
+        const outputs = [];
+        classDecl.getProperties().forEach((prop) => {
+            const outputDecorator = this.findDecorator(prop, 'Output');
+            if (outputDecorator) {
+                const alias = this.extractDecoratorAlias(outputDecorator);
+                outputs.push(alias ?? prop.getName());
+            }
+        });
+        return outputs;
+    }
+    /**
+     * Extract alias from a decorator.
+     * Example: ``('customValue') -> 'customValue'
+     */
+    extractDecoratorAlias(decorator) {
+        const args = decorator.getArguments();
+        const firstArg = args[0];
+        // Remove quotes from string literal if argument exists
+        return firstArg?.getText().replace(/^['"`]|['"`]$/g, '');
+    }
+    /**
+     * Find a decorator on a node by name.
+     */
+    findDecorator(node, name) {
+        const decorators = node.getDecorators();
+        return decorators.find((d) => d.getName() === name);
+    }
+    /**
+     * Find the NgModule class in a source file.
+     */
+    findNgModuleClass(sourceFile) {
+        const classes = sourceFile.getClasses();
+        return classes.find((cls) => this.findDecorator(cls, 'NgModule') !== undefined);
+    }
+    /**
+     * Extract a string property value from decorator text.
+     * Example: selector: 'app-root' -> 'app-root'
+     */
+    extractStringProperty(text, propertyName) {
+        const regex = new RegExp(`${propertyName}\\s*:\\s*['"\`]([^'"\`]+)['"\`]`);
+        const match = text.match(regex);
+        return match ? match[1] : undefined;
+    }
+    /**
+     * Extract an array property value from decorator text.
+     * Example: declarations: [Foo, Bar] -> ['Foo', 'Bar']
+     */
+    extractArrayProperty(text, propertyName) {
+        const regex = new RegExp(`${propertyName}\\s*:\\s*\\[([^\\]]*)\\]`);
+        const match = text.match(regex);
+        if (!match?.[1]) {
+            return [];
+        }
+        const arrayContent = match[1];
+        return arrayContent
+            .split(',')
+            .map((item) => item.trim())
+            .filter((item) => item.length > 0);
+    }
+}
+//# sourceMappingURL=dependency-analyzer.js.map

package/dist/analysis/dependency-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analyzer.js","sourceRoot":"","sources":["../../src/analysis/dependency-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0GH;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;;;;;OAMG;IACH,mBAAmB,CAAC,UAAsB;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAE1C,OAAO,UAAU,CAAC,qBAAqB,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAC/D,MAAM,eAAe,GAAG,UAAU,CAAC,uBAAuB,EAAE,CAAC;YAC7D,OAAO,UAAU,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBACxD,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,eAAe;gBACnB,IAAI,EAAE,QAAiB;gBACvB,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE;aAC9B,CAAC,CAAC,CAAC;QACN,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,UAAsB,EAAE,UAAkB;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC1D,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,UAAsB,EAAE,OAAiB;QACtD,MAAM,SAAS,GAAc;YAC3B,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,SAAS,EAAE,IAAI,GAAG,EAAE;SACrB,CAAC;QAEF,0BAA0B;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,+CAA+C;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,6DAA6D;QAC7D,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAE1C,2BAA2B;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAC5C,aAAa,EACb,cAAc,CACf,CAAC;QAEF,YAAY,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YACjC,IAAI,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAE/D,IAAI,CAAC,UAAU,IAAI,OAAO,EAAE,CAAC;gBAC3B,MAAM,SAAS,GAAG,OAAO;qBACtB,cAAc,EAAE;qBAChB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;gBACvD,UAAU,GAAG,SAAS;oBACpB,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC;oBAC9C,CAAC,CAAC,SAAS,CAAC;YAChB,CAAC;YAED,IAAI,UAAU,EAAE,CAAC;gBACf,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;gBAC9C,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,gDAAgD;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACpE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;QAE9D,OAAO,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAC7B,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjC,MAAM,aAAa,GAAe;oBAChC,SAAS,EAAE,UAAU;oBACrB,SAAS,EAAE,EAAE;oBACb,MAAM,EAAE,EAAE;oBACV,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,iBAAiB;iBAC5B,CAAC;gBACF,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;gBAClD,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YACrD,CAAC;YAED,IAAI,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7C,MAAM,qBAAqB,GAAG,IAAI,CAAC,iBAAiB,CAClD,UAAU,EACV,OAAO,EACP,UAAU,CACX,CAAC;gBACF,qBAAqB,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE;oBACvD,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;oBAC/C,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;gBAClD,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACpE,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAC5B,MAAM,UAAU,GACd,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzE,IAAI,UAAU,EAAE,CAAC;gBACf,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAChD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACK,iBAAiB,CACvB,UAAkB,EAClB,OAAgB,EAChB,YAAwB;QAExB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAEhD,gDAAgD;QAChD,MAAM,YAAY,GAAG,cAAc;aAChC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;aAC3D,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;QAExE,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC;QAE9D,8BAA8B;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,2CAA2C;QAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAC/C,SAAS,CAAC,OAAO,EAAE,EACnB,SAAS,CACV,CAAC;QAEF,eAAe,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YACrC,IAAI,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAEhE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAC3C,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,CACvC,CAAC;gBACF,UAAU,GAAG,SAAS;oBACpB,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,UAAU,CAAC;oBAC/C,CAAC,CAAC,SAAS,CAAC;YAChB,CAAC;YAED,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,yBAAyB,CACvB,UAAsB,EACtB,OAAgB,EAChB,UAAU,IAAI,GAAG,EAAU;QAE3B,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAE1C,6BAA6B;QAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEtB,MAAM,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CACzC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAC1D,CAAC;QAEF,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACjE,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;gBACzD,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;gBAChC,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;oBAChC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,OAAO,GAAG,KAAK,CAAC,CACvC,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO,aAAa;gBAClB,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;gBACjE,CAAC,CAAC,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,kBAAkB,EAAE,GAAG,cAAc,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,0BAA0B,CACxB,OAAgB;QAEhB,MAAM,MAAM,GAAyD,EAAE,CAAC;QACxE,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAE7C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;YAClC,MAAM,IAAI,GAAa,EAAE,CAAC;YAE1B,IAAI,CAAC,oBAAoB,CACvB,UAAU,EACV,OAAO,EACP,OAAO,EACP,IAAI,EACJ,MAAM,EACN,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,8EAA8E;QAC9E,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACK,oBAAoB,CAC1B,UAAsB,EACtB,OAAgB,EAChB,OAAoB,EACpB,IAAc,EACd,MAA4D,EAC5D,UAAkB;QAElB,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAE1C,yDAAyD;QACzD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC;gBAC1B,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;aAChD,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEpB,8EAA8E;QAC9E,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,MAAM,CAC3D,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAC1D,CAAC;QAEF,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACxB,4DAA4D;YAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACjE,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;gBACzD,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;gBAChC,8DAA8D;gBAC9D,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;oBAChC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,OAAO,GAAG,KAAK,CAAC,CACvC,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,IAAI,aAAa,EAAE,CAAC;gBAClB,6EAA6E;gBAC7E,IAAI,CAAC,oBAAoB,CACvB,aAAa,EACb,OAAO,EACP,IAAI,GAAG,CAAC,OAAO,CAAC,EAChB,CAAC,GAAG,IAAI,CAAC,EACT,MAAM,EACN,UAAU,CACX,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CACvB,MAA4D;QAE5D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5B,iEAAiE;YACjE,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEpC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CACf,UAAsB,EACtB,SAAiB;QAEjB,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAE1C,4CAA4C;QAC5C,MAAM,iBAAiB,GAOjB;YACJ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACpE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACpE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC3D,CAAC;QAEF,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,iBAAiB,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACtD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,oBAAoB,CAC1B,SAA2B,EAC3B,SAAoB,EACpB,QAAgB;QAEhB,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAEvE,OAAO;YACL,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,kBAAkB;YACpD,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YACrC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;YACvC,IAAI,EAAE,WAAW;YACjB,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,oBAAoB,CAC1B,SAA2B,EAC3B,SAAoB,EACpB,QAAgB;QAEhB,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAEvE,mEAAmE;QACnE,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,IAAI,QAAQ,EAAE,CAAC;YACb,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,wDAAwD;YACxD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACtD,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC9B,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,kBAAkB;YACpD,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;YACvC,IAAI,EAAE,WAAW;YACjB,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,SAA2B,EAC3B,SAAoB,EACpB,QAAgB;QAEhB,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAE/D,OAAO;YACL,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,aAAa;YAC/C,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YAC7B,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,MAAM;YACZ,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,aAAa,CAAC,SAA2B;QAC/C,0DAA0D;QAC1D,MAAM,gBAAgB,GAAG,CACvB,KAIG,EACH,aAAqB,EACX,EAAE;YACZ,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACrB,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;gBAC1D,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;oBACpD,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QAEF,6EAA6E;QAC7E,OAAO;YACL,GAAG,gBAAgB,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC;YACvD,GAAG,gBAAgB,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,OAAO,CAAC;YACzD,GAAG,gBAAgB,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,OAAO,CAAC;SAC1D,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,SAA2B;QAChD,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,SAAS,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACzC,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC3D,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;gBAC1D,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAC,SAAoB;QAChD,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,uDAAuD;QACvD,OAAO,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,IAI0B,EAC1B,IAAY;QAEZ,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,UAAsB;QAEtB,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,SAAS,CAC3D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAC3B,IAAY,EACZ,YAAoB;QAEpB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,iCAAiC,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,CAAC;IAED;;;OAGG;IACK,oBAAoB,CAAC,IAAY,EAAE,YAAoB;QAC7D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,0BAA0B,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,YAAY;aAChB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/analysis/external-template-loader.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @angular-modernizer/api - External Template Loader
+ *
+ * Loads external Angular templates from templateUrl.
+ *
+ * Philosophy: "Support Both Inline and External"
+ * - Handles templateUrl: './component.html'
+ * - Resolves relative paths correctly
+ * - Graceful fallback on errors
+ */
+/**
+ * External Template Loader - Loads templates from templateUrl.
+ *
+ * Supports both relative and absolute template paths.
+ */
+export declare class ExternalTemplateLoader {
+    /**
+     * Load external template file.
+     *
+     * Handles templateUrl: './user.component.html'
+     *
+     * @param templateUrl - Template URL from `` metadata
+     * @param componentPath - Absolute path to the component file
+     * @returns Template content or empty string on error
+     */
+    loadExternalTemplate(templateUrl: string, componentPath: string): Promise<string>;
+    /**
+     * Check if a template path exists.
+     *
+     * @param templateUrl - Template URL from `` metadata
+     * @param componentPath - Absolute path to the component file
+     * @returns True if template file exists
+     */
+    templateExists(templateUrl: string, componentPath: string): Promise<boolean>;
+    /**
+     * Resolve template path from component path and templateUrl.
+     *
+     * @param templateUrl - Template URL from `` metadata
+     * @param componentPath - Absolute path to the component file
+     * @returns Absolute path to template file
+     */
+    resolveTemplatePath(templateUrl: string, componentPath: string): string;
+}
+//# sourceMappingURL=external-template-loader.d.ts.map

package/dist/analysis/external-template-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-template-loader.d.ts","sourceRoot":"","sources":["../../src/analysis/external-template-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC;;;;;;;;OAQG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAelB;;;;;;OAMG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;IAWnB;;;;;;OAMG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;CAGxE"}

package/dist/analysis/external-template-loader.js

@@ -0,0 +1,69 @@
+/**
+ * @angular-modernizer/api - External Template Loader
+ *
+ * Loads external Angular templates from templateUrl.
+ *
+ * Philosophy: "Support Both Inline and External"
+ * - Handles templateUrl: './component.html'
+ * - Resolves relative paths correctly
+ * - Graceful fallback on errors
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+/**
+ * External Template Loader - Loads templates from templateUrl.
+ *
+ * Supports both relative and absolute template paths.
+ */
+export class ExternalTemplateLoader {
+    /**
+     * Load external template file.
+     *
+     * Handles templateUrl: './user.component.html'
+     *
+     * @param templateUrl - Template URL from `` metadata
+     * @param componentPath - Absolute path to the component file
+     * @returns Template content or empty string on error
+     */
+    async loadExternalTemplate(templateUrl, componentPath) {
+        // Resolve template path relative to component
+        const templatePath = path.resolve(path.dirname(componentPath), templateUrl);
+        try {
+            return await fs.readFile(templatePath, 'utf-8');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.warn(`    Failed to load template: ${templatePath}`);
+            console.warn(`    Error: ${errorMessage}`);
+            return ''; // Conservative: no template = include all imports
+        }
+    }
+    /**
+     * Check if a template path exists.
+     *
+     * @param templateUrl - Template URL from `` metadata
+     * @param componentPath - Absolute path to the component file
+     * @returns True if template file exists
+     */
+    async templateExists(templateUrl, componentPath) {
+        const templatePath = path.resolve(path.dirname(componentPath), templateUrl);
+        try {
+            await fs.access(templatePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Resolve template path from component path and templateUrl.
+     *
+     * @param templateUrl - Template URL from `` metadata
+     * @param componentPath - Absolute path to the component file
+     * @returns Absolute path to template file
+     */
+    resolveTemplatePath(templateUrl, componentPath) {
+        return path.resolve(path.dirname(componentPath), templateUrl);
+    }
+}
+//# sourceMappingURL=external-template-loader.js.map

package/dist/analysis/external-template-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-template-loader.js","sourceRoot":"","sources":["../../src/analysis/external-template-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACjC;;;;;;;;OAQG;IACH,KAAK,CAAC,oBAAoB,CACxB,WAAmB,EACnB,aAAqB;QAErB,8CAA8C;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,cAAc,YAAY,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC,CAAC,kDAAkD;QAC/D,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,aAAqB;QAErB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CAAC,WAAmB,EAAE,aAAqB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/analysis/selector-mapper.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @angular-modernizer/api - Selector Mapper
+ *
+ * Reusable selector-to-className mapping utility.
+ * Extracted from Phase 3's selector map caching for reuse across components.
+ *
+ * Philosophy: "Build Once, Use Everywhere"
+ * - O(n) initial build, O(1) lookups
+ * - Lazy initialization (only builds when first needed)
+ * - Universal coverage (standard `` + custom decorators)
+ */
+import type { Project } from 'ts-morph';
+/**
+ * Selector Mapper - Maps component selectors to class names.
+ *
+ * Provides O(1) selector lookups using a cached map built from project files.
+ * Supports both standard `` decorators and custom decorators (e.g., ``).
+ */
+export declare class SelectorMapper {
+    private selectorMap;
+    /**
+     * Find a component class name by its selector.
+     *
+     * Builds the selector map lazily on first call, then reuses for O(1) lookups.
+     *
+     * @param project - ts-morph Project
+     * @param selector - Component selector (e.g., 'app-user-profile')
+     * @returns Class name (e.g., 'UserProfileComponent') or undefined if not found
+     */
+    findComponentBySelector(project: Project, selector: string): string | undefined;
+    /**
+     * Get the complete selector map.
+     *
+     * Builds the map lazily if not yet built.
+     *
+     * @param project - ts-morph Project
+     * @returns Map of selector → className
+     */
+    getSelectorMap(project: Project): Map<string, string>;
+    /**
+     * Clear the cached selector map.
+     *
+     * Useful for testing or when project files have changed significantly.
+     */
+    clearCache(): void;
+    /**
+     * Build a comprehensive selector map for the entire project.
+     *
+     * Scans all source files once to build selector → className mapping.
+     * Performance: O(n) initial build, O(1) lookup per selector.
+     *
+     * @param project - ts-morph Project
+     * @returns Map of selector → className
+     * @private
+     */
+    private buildSelectorMap;
+    /**
+     * Extract the selector from a `` decorator.
+     *
+     * @param decorator - The `` decorator
+     * @returns The selector string or undefined
+     * @private
+     */
+    private extractSelectorFromDecorator;
+    /**
+     * Find a decorator by name on a class declaration.
+     *
+     * Supports both standard decorators (``) and custom decorators (``).
+     *
+     * @param classDecl - Class declaration
+     * @param decoratorName - Decorator name (without @)
+     * @returns Decorator or undefined
+     * @private
+     */
+    private findDecorator;
+}
+//# sourceMappingURL=selector-mapper.d.ts.map