@angular-modernizer/api 0.1.3 → 0.2.0

package/dist/index.d.ts

@@ -16,8 +16,10 @@ export * from './analysis/external-template-loader.js';
 export { SymbolLocator, type SymbolInfo as ProjectSymbolInfo, } from './analysis/symbol-locator.js';
 export { StackTraceParser, type StackFrame, } from './investigation/stack-trace-parser.js';
 export { UsageFinder, type SymbolUsage, type UsageType, type FindUsagesOptions, } from './investigation/usage-finder.js';
-export { CallGraphBuilder, type CallNode, type CallGraphOptions, type CallGraphResult, } from './investigation/call-graph-builder.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, type ResolvedTypeInfo, } from './investigation/type-resolver.js';
 export { AngularSymbolFinder, type AngularSymbolResult, type AngularSymbolType, } from './investigation/angular-symbol-finder.js';
-export { CodebaseSearcher, type SearchResult, type SearchOptions, type SymbolKind, } from './investigation/codebase-searcher.js';
+export { CodebaseSearcher, type SearchResult, type SearchOptions, type SymbolKind, type SearchCoverage, type SearchWithCoverageResult, EXCLUDED_SEARCH_DIRECTORIES, } from './investigation/codebase-searcher.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,OAAO,EACL,aAAa,EACb,KAAK,UAAU,IAAI,iBAAiB,GACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,OAAO,EACL,aAAa,EACb,KAAK,UAAU,IAAI,iBAAiB,GACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,2BAA2B,GAC5B,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -15,8 +15,10 @@ export * from './analysis/external-template-loader.js';
 export { SymbolLocator, } from './analysis/symbol-locator.js';
 export { StackTraceParser, } from './investigation/stack-trace-parser.js';
 export { UsageFinder, } from './investigation/usage-finder.js';
+export { TemplateUsageFinder, } from './investigation/template-usage-finder.js';
+export { scanTemplate, templateMayMatch, } from './investigation/template-usage-scanner.js';
 export { CallGraphBuilder, } from './investigation/call-graph-builder.js';
 export { TypeResolver, } from './investigation/type-resolver.js';
 export { AngularSymbolFinder, } from './investigation/angular-symbol-finder.js';
-export { CodebaseSearcher, } from './investigation/codebase-searcher.js';
+export { CodebaseSearcher, EXCLUDED_SEARCH_DIRECTORIES, } from './investigation/codebase-searcher.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAE/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,OAAO,EACL,aAAa,GAEd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,GAEjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,WAAW,GAIZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gBAAgB,GAIjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,YAAY,GAEb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mBAAmB,GAGpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,gBAAgB,GAIjB,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAE/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,OAAO,EACL,aAAa,GAEd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,GAEjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,WAAW,GAIZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,GAGpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,gBAAgB,GAIjB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,gBAAgB,GAKjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,YAAY,GAEb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mBAAmB,GAGpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,gBAAgB,EAMhB,2BAA2B,GAC5B,MAAM,sCAAsC,CAAC"}

package/dist/investigation/call-graph-builder.d.ts

@@ -1,13 +1,36 @@
 /**
  * @angular-modernizer/api - Call Graph Builder
  *
- * Builds a call graph for a named method or function within a ts-morph Project.
+ * Builds a call graph for a named callable within a ts-morph Project.
  * Supports traversal upward (callers) and downward (callees) with configurable depth.
  *
+ * Supported targets (and graph nodes):
+ * - class methods and top-level functions
+ * - constructors (`'constructor'` or `'ClassName.constructor'`); a class
+ *   without an explicit constructor is represented by its field initializers
+ * - get/set accessors
+ * - properties and top-level variables initialized with an arrow function or
+ *   function expression
+ *
+ * Callees include:
+ * - call expressions (resolved via the type checker, name-based fallback
+ *   only when the symbol cannot be resolved)
+ * - `new X()` (edge to X's constructor, including X's field initializers)
+ * - `super(...)` (edge to the base class constructor)
+ * - property reads/writes that resolve to a getter/setter
+ * - for constructors: instance field initializers (they run during
+ *   construction)
+ *
+ * Callers are the enclosing callable of each reference: method, function,
+ * constructor, accessor, arrow-function property, or (for references in a
+ * field initializer) the owning class constructor. Callers of a constructor
+ * are the `new X()` sites and the constructors of subclasses.
+ *
  * @remarks
  * Used in bug investigation to understand how an error propagates through the
  * codebase. Combine with `find-usages` to trace the full call path from the
- * entry point to the failing code.
+ * entry point to the failing code, e.g. "what runs transitively while an
+ * interceptor is constructed" (ctor -> helper getter -> static config read).
  *
  * @example
  * ```typescript
@@ -18,17 +41,29 @@
  * });
  * // graph.callers → who calls getUser
  * // graph.callees → what getUser calls
+ *
+ * const ctorGraph = builder.buildCallGraph(
+ *   'AuthInterceptor.constructor',
+ *   '/src/app/auth.interceptor.ts',
+ *   { direction: 'down', depth: 3 },
+ * );
  * ```
  */
-import type { Project } from 'ts-morph';
+import { type Project } from 'ts-morph';
+/** Kind of callable represented by a call graph node. */
+export type CallableKind = 'method' | 'function' | 'constructor' | 'getter' | 'setter' | 'property' | 'variable';
 /** A node in the call graph tree. */
 export interface CallNode {
-    /** Method or function name. */
+    /** Method or function name (`'constructor'` for constructors). */
     name: string;
     /** Absolute file path where this method is declared. */
     file: string;
     /** 1-based line number of the declaration. */
     line: number;
+    /** Kind of callable (method, constructor, getter, ...). */
+    kind?: CallableKind;
+    /** Owning class name for class members. */
+    className?: string;
     /** Nested callers or callees (recursive to configured depth). */
     children: CallNode[];
 }
@@ -58,7 +93,8 @@ export interface CallGraphResult {
     callees: CallNode[];
 }
 /**
- * Builds caller/callee graphs for methods and functions across a ts-morph Project.
+ * Builds caller/callee graphs for methods, functions, constructors,
+ * accessors and arrow-function properties across a ts-morph Project.
  */
 export declare class CallGraphBuilder {
     private readonly project;
@@ -67,19 +103,70 @@ export declare class CallGraphBuilder {
      */
     constructor(project: Project);
     /**
-     * Builds a call graph rooted at the named method or function.
+     * Builds a call graph rooted at the named callable.
      *
-     * @param method - Name of the method or function to analyse.
-     * @param file - Absolute path of the source file containing the method.
+     * @param method - Name of the callable to analyse. Accepts a method,
+     *   function, accessor or arrow-function property name, `'constructor'`,
+     *   or a class-qualified name such as `'AuthInterceptor.constructor'` or
+     *   `'AuthInterceptor.headers'`.
+     * @param file - Absolute path of the source file containing the callable.
      * @param options - Traversal direction and depth. Defaults to `both` / depth `2`.
      * @returns A `CallGraphResult` with the target and its caller/callee trees.
      */
     buildCallGraph(method: string, file: string, options?: CallGraphOptions): CallGraphResult;
     private resolveTarget;
+    private findClassMember;
+    /**
+     * Converts a declaration node into a `Callable`, or `null` when the node
+     * cannot run code (e.g. a plain data property or an interface member).
+     */
+    private toCallable;
+    /**
+     * Constructor callable for a class: the explicit constructor body (if any)
+     * plus all non-static, non-function field initializers.
+     */
+    private constructorOf;
+    private functionInitializerBody;
+    private classNameOf;
+    private compact;
     private buildCallees;
+    private collectCalleeCallables;
+    private calleesAt;
+    private resolveCallExpressionTarget;
+    private resolveNewExpressionTarget;
+    private resolveAccessorTarget;
+    private superConstructor;
+    /**
+     * Resolves the declarations behind an expression via the type checker.
+     * Returns `undefined` when no symbol can be resolved (caller may fall back
+     * to name-based lookup) and an empty array when the symbol resolves to
+     * declarations that cannot be represented.
+     */
+    private resolveSymbolDeclarations;
+    /**
+     * Maps declarations to callables, preferring implementations (with body)
+     * over overload signatures and skipping ambient (.d.ts) declarations.
+     */
+    private pickCallables;
     private buildCallers;
+    private referenceNodes;
+    /**
+     * Maps a reference to the callable that performs the call. For
+     * constructor targets only `new X()` sites and subclass constructors
+     * (implicit or explicit `super()` calls) count.
+     */
+    private callerForReference;
+    /**
+     * Finds the callable that contains `node`. Anonymous callbacks are
+     * attributed to their enclosing named callable; references inside a
+     * non-function field initializer are attributed to the class constructor.
+     */
+    private enclosingCallable;
     private findDeclarationInProject;
+    private findClassInProject;
     private extractCallName;
+    private keyOf;
+    private toCallNode;
     private deduplicateNodes;
 }
 //# sourceMappingURL=call-graph-builder.d.ts.map

package/dist/investigation/call-graph-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-graph-builder.d.ts","sourceRoot":"","sources":["../../src/investigation/call-graph-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAA0C,MAAM,UAAU,CAAC;AAGhF,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAEnC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IAE1C,sEAAsE;IACtE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAEpB,wEAAwE;IACxE,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAID;;GAEG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC;;OAEG;gBAC0B,OAAO,EAAE,OAAO;IAE7C;;;;;;;OAOG;IACH,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,eAAe;IA4BlB,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,YAAY;IAuDpB,OAAO,CAAC,YAAY;IA+DpB,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;CAWzB"}
+{"version":3,"file":"call-graph-builder.d.ts","sourceRoot":"","sources":["../../src/investigation/call-graph-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,UAAU,CAAC;AAElB,yDAAyD;AACzD,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,UAAU,GACV,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,UAAU,CAAC;AAEf,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,2DAA2D;IAC3D,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iEAAiE;IACjE,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAEnC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IAE1C,sEAAsE;IACtE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAEpB,wEAAwE;IACxE,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAiBD;;;GAGG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC;;OAEG;gBAC0B,OAAO,EAAE,OAAO;IAE7C;;;;;;;;;;OAUG;IACH,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,eAAe;IAoClB,OAAO,CAAC,aAAa;IAsCrB,OAAO,CAAC,eAAe;IA2BvB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA8DlB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,0BAA0B;IAiBlC,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,gBAAgB;IAMxB;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,YAAY;IA6BpB,OAAO,CAAC,cAAc;IAsBtB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,gBAAgB;CAWzB"}