@angular-modernizer/api 0.1.3 → 0.2.0

package/dist/investigation/usage-finder.js

@@ -9,6 +9,14 @@
  * Uses ts-morph `findReferences()` under the hood. The project must already have
  * the relevant source files added before calling `findUsages`.
  *
+ * Two additional sources close gaps that would otherwise produce a false
+ * "0 usages" all-clear:
+ * - `unresolved`: same-name identifiers whose symbol does not resolve (e.g. a
+ *   class still used as a type after its import was removed, TS2304).
+ * - `template`: Angular template usages (component/directive selectors, pipe
+ *   names, member reads/calls/bindings) in `templateUrl` files and inline
+ *   templates, see `TemplateUsageFinder`.
+ *
  * @example
  * ```typescript
  * const finder = new UsageFinder(project);
@@ -16,6 +24,8 @@
  * // usages[0] → { file, line, col, snippet, usageType: 'read' }
  * ```
  */
+import { Node } from 'ts-morph';
+import { TemplateUsageFinder, } from './template-usage-finder.js';
 /**
  * Finds all references to named symbols across a ts-morph Project.
  */
@@ -35,50 +45,109 @@ export class UsageFinder {
      * @returns Array of resolved usages, sorted by file path then line number.
      */
     findUsages(symbol, options = {}) {
+        const declarations = this.project
+            .getSourceFiles()
+            .flatMap((sf) => this.findSymbolNodes(sf, symbol));
+        const usages = [
+            ...this.findReferenceUsages(declarations),
+            ...(options.includeUnresolved === false
+                ? []
+                : this.findUnresolvedUsages(symbol)),
+            ...(options.includeTemplates === false
+                ? []
+                : this.findTemplateUsages(symbol, declarations)),
+        ];
+        const fileFilter = options.file === undefined ? undefined : normalizePath(options.file);
+        return this.deduplicate(usages)
+            .filter((u) => fileFilter === undefined || normalizePath(u.file) === fileFilter)
+            .filter((u) => options.usageType === undefined || u.usageType === options.usageType)
+            .sort((a, b) => a.file === b.file ? a.line - b.line || a.col - b.col : a.file.localeCompare(b.file));
+    }
+    findReferenceUsages(declarations) {
+        const usages = [];
+        const languageService = this.project.getLanguageService();
+        for (const node of declarations) {
+            // Query by the name node: a decorated class starts at its decorator.
+            for (const refSymbol of languageService.findReferences(nameNodeOf(node))) {
+                for (const ref of refSymbol.getReferences()) {
+                    const refFile = ref.getSourceFile();
+                    const pos = ref.getNode().getStart();
+                    const lineAndCol = refFile.getLineAndColumnAtPos(pos);
+                    usages.push({
+                        file: refFile.getFilePath(),
+                        line: lineAndCol.line,
+                        col: lineAndCol.column,
+                        snippet: lineTextAt(refFile, lineAndCol.line),
+                        usageType: this.classifyUsage(ref.getNode()),
+                    });
+                }
+            }
+        }
+        return usages;
+    }
+    /**
+     * Same-name identifiers whose symbol does not resolve. The language
+     * service cannot link them to any declaration, so `findReferences` never
+     * returns them; without this pass a removed import looks like "0 usages".
+     */
+    findUnresolvedUsages(symbol) {
         const usages = [];
-        const sourceFiles = options.file
-            ? [this.project.getSourceFile(options.file)].filter(Boolean)
-            : this.project.getSourceFiles();
-        for (const sourceFile of sourceFiles) {
-            if (!sourceFile) {
+        for (const sf of this.project.getSourceFiles()) {
+            if (sf.isDeclarationFile() || sf.isInNodeModules()) {
                 continue;
             }
-            const nodes = this.findSymbolNodes(sourceFile, symbol);
-            for (const node of nodes) {
-                const refs = this.project.getLanguageService().findReferences(node);
-                for (const refSymbol of refs) {
-                    for (const ref of refSymbol.getReferences()) {
-                        const refFile = ref.getSourceFile();
-                        const refFilePath = refFile.getFilePath();
-                        if (options.file && refFilePath !== options.file) {
-                            continue;
-                        }
-                        const pos = ref.getNode().getStart();
-                        const lineAndCol = refFile.getLineAndColumnAtPos(pos);
-                        const lineText = refFile.getFullText().split('\n')[lineAndCol.line - 1] ?? '';
-                        const usageType = this.classifyUsage(ref.getNode());
-                        if (options.usageType && usageType !== options.usageType) {
-                            continue;
-                        }
-                        usages.push({
-                            file: refFilePath,
-                            line: lineAndCol.line,
-                            col: lineAndCol.column,
-                            snippet: lineText.trim(),
-                            usageType,
-                        });
-                    }
-                }
+            if (!sf.getFullText().includes(symbol)) {
+                continue;
             }
+            sf.forEachDescendant((node) => {
+                if (!Node.isIdentifier(node) || node.getText() !== symbol) {
+                    return;
+                }
+                const resolved = node.getSymbol();
+                const isResolved = resolved !== undefined && resolved.getDeclarations().length > 0;
+                if (isResolved) {
+                    return;
+                }
+                const { line, column } = sf.getLineAndColumnAtPos(node.getStart());
+                usages.push({
+                    file: sf.getFilePath(),
+                    line,
+                    col: column,
+                    snippet: lineTextAt(sf, line),
+                    usageType: 'unresolved',
+                    note: unresolvedNote(node, symbol),
+                });
+            });
         }
-        return this.deduplicate(usages).sort((a, b) => a.file !== b.file ? a.file.localeCompare(b.file) : a.line - b.line);
+        return usages;
+    }
+    findTemplateUsages(symbol, declarations) {
+        return new TemplateUsageFinder(this.project)
+            .findTemplateUsages(symbol, declarations)
+            .map((t) => ({
+            file: t.file,
+            line: t.line,
+            col: t.col,
+            snippet: t.snippet,
+            usageType: 'template',
+            templateKind: t.templateKind,
+            templateMatch: t.templateMatch,
+            component: t.component,
+            ...(t.note === undefined ? {} : { note: t.note }),
+        }));
     }
+    /**
+     * Declaration-like nodes named `symbol`. Expressions that merely carry a
+     * name (`svc.getUser` property accesses) are not declarations and would
+     * make `findReferences` resolve their receiver instead.
+     */
     findSymbolNodes(sourceFile, symbol) {
-        if (!sourceFile) {
-            return [];
-        }
         const nodes = [];
         sourceFile.forEachDescendant((node) => {
+            if (Node.isPropertyAccessExpression(node) ||
+                Node.isElementAccessExpression(node)) {
+                return;
+            }
             if ('getName' in node &&
                 typeof node.getName === 'function') {
                 if (node.getName() === symbol) {
@@ -120,7 +189,7 @@ export class UsageFinder {
     deduplicate(usages) {
         const seen = new Set();
         return usages.filter((u) => {
-            const key = `${u.file}:${u.line}:${u.col}`;
+            const key = `${u.file}:${u.line}:${u.col}:${u.templateKind ?? ''}`;
             if (seen.has(key)) {
                 return false;
             }
@@ -129,4 +198,28 @@ export class UsageFinder {
         });
     }
 }
+function normalizePath(path) {
+    return path.replaceAll('\\', '/');
+}
+function lineTextAt(sourceFile, line) {
+    return (sourceFile.getFullText().split('\n')[line - 1] ?? '').trim();
+}
+function unresolvedNote(node, symbol) {
+    const parent = node.getParent();
+    const isMemberName = parent !== undefined &&
+        Node.isPropertyAccessExpression(parent) &&
+        parent.getNameNode() === node;
+    if (isMemberName) {
+        return (`'${symbol}' is accessed on a receiver whose type is 'any' or unresolved; ` +
+            'it may or may not refer to the searched member.');
+    }
+    return (`'${symbol}' does not resolve to any declaration (missing import or ` +
+        'removed symbol, typically TS2304/TS2552). The file still depends on it.');
+}
+function nameNodeOf(node) {
+    const named = node;
+    return typeof named.getNameNode === 'function'
+        ? (named.getNameNode() ?? node)
+        : node;
+}
 //# sourceMappingURL=usage-finder.js.map

package/dist/investigation/usage-finder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular-modernizer/api",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Battle-tested analysis and transformation tools for Angular Modernizer",
   "keywords": [
     "angular",

package/src/index.ts

@@ -28,11 +28,24 @@ export {
   type UsageType,
   type FindUsagesOptions,
 } from './investigation/usage-finder.js';
+export {
+  TemplateUsageFinder,
+  type TemplateSymbolUsage,
+  type TemplateMatch,
+} from './investigation/template-usage-finder.js';
+export {
+  scanTemplate,
+  templateMayMatch,
+  type TemplateQuery,
+  type TemplateHit,
+  type TemplateUsageKind,
+} from './investigation/template-usage-scanner.js';
 export {
   CallGraphBuilder,
   type CallNode,
   type CallGraphOptions,
   type CallGraphResult,
+  type CallableKind,
 } from './investigation/call-graph-builder.js';
 export {
   TypeResolver,
@@ -48,4 +61,7 @@ export {
   type SearchResult,
   type SearchOptions,
   type SymbolKind,
+  type SearchCoverage,
+  type SearchWithCoverageResult,
+  EXCLUDED_SEARCH_DIRECTORIES,
 } from './investigation/codebase-searcher.js';