@angular-modernizer/api 0.1.0

package/dist/analysis/template-analyzer.js

@@ -0,0 +1,146 @@
+/**
+ * @angular-modernizer/api - Template Analyzer
+ *
+ * Dumb Collector - extracts ALL elements from Angular templates.
+ * Zero filtering, zero intelligence. Based on the "Trust the Map" principle.
+ *
+ * Philosophy: "Collect Everything, Filter Later"
+ * - No business logic in collectors
+ * - Plugins decide what matters
+ * - Raw data is more valuable than pre-filtered data
+ */
+/**
+ * Template Analyzer - extracts all usages from Angular templates.
+ *
+ * This is a "Dumb Collector" that doesn't filter or interpret.
+ * It just collects everything and lets plugins decide what's important.
+ */
+export class TemplateAnalyzer {
+    /**
+     * Analyze a template string and extract all usages.
+     *
+     * @param template - The template string to analyze
+     * @returns Array of template usages
+     *
+     * Philosophy: "Collect Everything, Filter Later"
+     * - Extracts ALL elements, attributes, pipes, directives
+     * - No filtering, no business logic
+     * - Plugins decide what's important using the SymbolMapper
+     */
+    analyze(template) {
+        const usages = [];
+        const lines = template.split('\n');
+        // Extract element tags (e.g., <fixture-child>, <div>, <custom-component>)
+        const elementRegex = /<([a-zA-Z][\w-]*)/g;
+        // Extract pipes (e.g., {{ value | pipeName }}, {{ value | pipeName: arg }})
+        const pipeRegex = /\|\s*([a-zA-Z]\w*)/g;
+        lines.forEach((line, lineIndex) => {
+            // Extract elements
+            let match;
+            while ((match = elementRegex.exec(line)) !== null) {
+                const tagName = match[1];
+                if (tagName) {
+                    usages.push({
+                        type: 'element',
+                        name: tagName,
+                        line: lineIndex + 1,
+                        column: match.index,
+                        raw: match[0],
+                    });
+                }
+            }
+            // Extract attributes - use multiple patterns for better coverage
+            // Pattern 1: Structural directives (*ngIf, *ngFor)
+            const structuralDirectiveRegex = /\*([a-zA-Z][\w-]*)/g;
+            while ((match = structuralDirectiveRegex.exec(line)) !== null) {
+                usages.push({
+                    type: 'structural-directive',
+                    name: `*${match[1]}`,
+                    line: lineIndex + 1,
+                    column: match.index,
+                    raw: match[0],
+                });
+            }
+            // Pattern 2: Angular 17+ control flow (@if, @for, @switch, @empty, @let)
+            const controlFlowRegex = /@(if|else if|for|switch|case|default|empty|let)\b/g;
+            while ((match = controlFlowRegex.exec(line)) !== null) {
+                usages.push({
+                    type: 'control-flow',
+                    name: match[1],
+                    line: lineIndex + 1,
+                    column: match.index,
+                    raw: match[0],
+                });
+            }
+            // Pattern 3: Property bindings ([propName]="value")
+            const propertyBindingRegex = /\[([a-zA-Z][\w-]*)\]/g;
+            while ((match = propertyBindingRegex.exec(line)) !== null) {
+                usages.push({
+                    type: 'directive',
+                    name: `[${match[1]}]`,
+                    line: lineIndex + 1,
+                    column: match.index,
+                    raw: match[0],
+                });
+            }
+            // Pattern 3: Bare attribute selectors (fixtureAttribute, ngModel)
+            // Look for attribute names that are NOT standard HTML attributes
+            const bareAttributeRegex = /\s+([a-z][\w-]*(?:[A-Z][\w-]*)+)\s*(?:=|>|\s|$)/g;
+            while ((match = bareAttributeRegex.exec(line)) !== null) {
+                const attrName = match[1];
+                // Only add if it looks like a directive (has camelCase or kebab-case)
+                if (attrName && (attrName.includes('-') || /[A-Z]/.test(attrName))) {
+                    usages.push({
+                        type: 'directive',
+                        name: attrName,
+                        line: lineIndex + 1,
+                        column: match.index,
+                        raw: match[0].trim(),
+                    });
+                }
+            }
+            // Extract pipes
+            const pipeMatches = line.matchAll(pipeRegex);
+            for (const pipeMatch of pipeMatches) {
+                const pipeName = pipeMatch[1];
+                if (pipeName) {
+                    usages.push({
+                        type: 'pipe',
+                        name: pipeName,
+                        line: lineIndex + 1,
+                        column: pipeMatch.index,
+                        raw: pipeMatch[0],
+                    });
+                }
+            }
+        });
+        return usages;
+    }
+    /**
+     * Extract inline template from component decorator.
+     *
+     * @param decoratorText - The `` decorator text
+     * @returns The template string or undefined
+     */
+    extractInlineTemplate(decoratorText) {
+        // Match template: `...` or template: '...' (including multiline)
+        const templateRegex = /template\s*:\s*(['`])([\s\S]*?)\1/;
+        const match = templateRegex.exec(decoratorText);
+        if (match) {
+            return match[2];
+        }
+        return undefined;
+    }
+    /**
+     * Check if a template uses a specific selector.
+     *
+     * @param template - The template string
+     * @param selector - The selector to search for
+     * @returns True if selector is used
+     */
+    usesSelector(template, selector) {
+        const usages = this.analyze(template);
+        return usages.some((usage) => usage.name === selector);
+    }
+}
+//# sourceMappingURL=template-analyzer.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Main entry point for @angular-modernizer/api
+ */
+export * from './public-api.js';
+export * from './transformation/ng-morph-adapter.js';
+export * from './transformation/ngmodule-manager.js';
+export * from './transformation/import-manager.js';
+export * from './analysis/service-pattern-recognizer.js';
+export * from './analysis/service-detector.js';
+export type { ServiceDetectionResult } from './analysis/service-pattern-recognizer.js';
+export * from './analysis/dependency-analyzer.js';
+export * from './analysis/template-analyzer.js';
+export * from './analysis/template-analyzer-usage.js';
+export * from './analysis/selector-mapper.js';
+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 { 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * Main entry point for @angular-modernizer/api
+ */
+export * from './public-api.js';
+export * from './transformation/ng-morph-adapter.js';
+export * from './transformation/ngmodule-manager.js';
+export * from './transformation/import-manager.js';
+export * from './analysis/service-pattern-recognizer.js';
+export * from './analysis/service-detector.js';
+export * from './analysis/dependency-analyzer.js';
+export * from './analysis/template-analyzer.js';
+export * from './analysis/template-analyzer-usage.js';
+export * from './analysis/selector-mapper.js';
+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 { 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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/investigation/angular-symbol-finder.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @angular-modernizer/api - Angular Symbol Finder
+ *
+ * Finds Angular symbols (components, directives, pipes, services, guards,
+ * interceptors, resolvers, modules, tokens) by selector, template name, class
+ * name, or token name. Supports standard Angular decorators as well as
+ * ngUWI-specific external decorators (@ExportComponent, @ExportFunction).
+ *
+ * @remarks
+ * The project must already have the relevant source files added before calling
+ * `findSymbol`. Queries are matched case-sensitively for class names, and
+ * substring-matched for selectors/pipe names (e.g. searching "app-list" also
+ * returns "app-list-item" selectors).
+ *
+ * @example
+ * ```typescript
+ * const finder = new AngularSymbolFinder(project);
+ * const results = finder.findSymbol('app-user');
+ * // results[0] → { file, className, angularType: 'component', selector: 'app-user', metadata: {...} }
+ *
+ * const pipes = finder.findSymbol('dateFormat', 'pipe');
+ * // pipes[0] → { file, className: 'DateFormatPipe', angularType: 'pipe', pipeName: 'dateFormat', metadata: {...} }
+ * ```
+ */
+import type { Project } from 'ts-morph';
+/** The Angular symbol type classification. */
+export type AngularSymbolType = 'component' | 'directive' | 'pipe' | 'service' | 'guard' | 'interceptor' | 'resolver' | 'module' | 'token';
+/** A resolved Angular symbol. */
+export interface AngularSymbolResult {
+    /** Absolute file path containing the class. */
+    file: string;
+    /** Class name (e.g. `UserComponent`). */
+    className: string;
+    /** Angular symbol type. */
+    angularType: AngularSymbolType;
+    /** CSS selector for components and directives (stripped of brackets). */
+    selector?: string;
+    /** Template name for pipes (value of `@Pipe({ name: '...' })`). */
+    pipeName?: string;
+    /** Raw decorator metadata (key-value pairs extracted from the decorator). */
+    metadata: Record<string, string>;
+}
+/**
+ * Finds Angular symbols across all source files in a ts-morph `Project`.
+ */
+export declare class AngularSymbolFinder {
+    private readonly project;
+    constructor(project: Project);
+    /**
+     * Find Angular symbols matching `query`.
+     *
+     * @param query - Selector (e.g. `app-user`, `appHighlight`), pipe name
+     *   (e.g. `dateFormat`), class name (e.g. `UserComponent`), or partial
+     *   selector substring.
+     * @param type - Optional filter; when provided only results of the given type
+     *   are returned.
+     * @returns Array of matching `AngularSymbolResult` objects, empty when none
+     *   are found.
+     *
+     * @example
+     * ```typescript
+     * // By selector
+     * finder.findSymbol('app-user');
+     *
+     * // By class name with type filter
+     * finder.findSymbol('UserService', 'service');
+     * ```
+     */
+    findSymbol(query: string, type?: AngularSymbolType): AngularSymbolResult[];
+    /**
+     * Attempts to classify a class declaration as an Angular symbol.
+     * Returns `null` when the class carries no recognised Angular decorator.
+     */
+    private classifyClass;
+}
+//# sourceMappingURL=angular-symbol-finder.d.ts.map

package/dist/investigation/angular-symbol-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-symbol-finder.d.ts","sourceRoot":"","sources":["../../src/investigation/angular-symbol-finder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAA+B,MAAM,UAAU,CAAC;AAErE,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,WAAW,GACX,MAAM,GACN,SAAS,GACT,OAAO,GACP,aAAa,GACb,UAAU,GACV,QAAQ,GACR,OAAO,CAAC;AAEZ,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IAEb,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,WAAW,EAAE,iBAAiB,CAAC;IAE/B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAuGD;;GAEG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,EAAE;IA4B1E;;;OAGG;IACH,OAAO,CAAC,aAAa;CA2CtB"}

package/dist/investigation/angular-symbol-finder.js

@@ -0,0 +1,199 @@
+/**
+ * @angular-modernizer/api - Angular Symbol Finder
+ *
+ * Finds Angular symbols (components, directives, pipes, services, guards,
+ * interceptors, resolvers, modules, tokens) by selector, template name, class
+ * name, or token name. Supports standard Angular decorators as well as
+ * ngUWI-specific external decorators (@ExportComponent, @ExportFunction).
+ *
+ * @remarks
+ * The project must already have the relevant source files added before calling
+ * `findSymbol`. Queries are matched case-sensitively for class names, and
+ * substring-matched for selectors/pipe names (e.g. searching "app-list" also
+ * returns "app-list-item" selectors).
+ *
+ * @example
+ * ```typescript
+ * const finder = new AngularSymbolFinder(project);
+ * const results = finder.findSymbol('app-user');
+ * // results[0] → { file, className, angularType: 'component', selector: 'app-user', metadata: {...} }
+ *
+ * const pipes = finder.findSymbol('dateFormat', 'pipe');
+ * // pipes[0] → { file, className: 'DateFormatPipe', angularType: 'pipe', pipeName: 'dateFormat', metadata: {...} }
+ * ```
+ */
+/** Decorator names that map to Angular symbol types. */
+const DECORATOR_TYPE_MAP = {
+    Component: 'component',
+    ExportComponent: 'component',
+    Directive: 'directive',
+    Pipe: 'pipe',
+    Injectable: 'service',
+    ExportFunction: 'service',
+    NgModule: 'module',
+    Guard: 'guard',
+    Interceptor: 'interceptor',
+    Resolver: 'resolver',
+};
+/**
+ * Extracts the string value of a named property from a decorator's argument
+ * object literal (e.g. `selector: 'app-foo'` → `'app-foo'`).
+ */
+function extractDecoratorProperty(decorator, property) {
+    try {
+        const args = decorator.getArguments();
+        if (args.length === 0) {
+            return undefined;
+        }
+        const arg = args[0];
+        if (arg === undefined) {
+            return undefined;
+        }
+        const text = arg.getText();
+        const match = new RegExp(`${property}\\s*:\\s*['"\`]([^'"\`]+)['"\`]`).exec(text);
+        return match?.[1];
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extracts all string-valued properties from a decorator's first argument
+ * as a flat `Record<string, string>`.
+ */
+function extractDecoratorMetadata(decorator) {
+    const metadata = {};
+    try {
+        const args = decorator.getArguments();
+        const firstArg = args[0];
+        if (args.length === 0 || firstArg === undefined) {
+            return metadata;
+        }
+        const text = firstArg.getText();
+        const pattern = /(\w+)\s*:\s*['"`]([^'"`]+)['"`]/g;
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const key = match[1];
+            const value = match[2];
+            if (key !== undefined && value !== undefined) {
+                metadata[key] = value;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return metadata;
+}
+/**
+ * Strips attribute-selector brackets from a selector string.
+ * `[appHighlight]` → `appHighlight`; `app-user` → `app-user`.
+ */
+function normalizeSelector(raw) {
+    return raw.replace(/^\[(.+)\]$/, '$1');
+}
+/**
+ * Returns `true` when the query matches the given selector (substring) or
+ * class name (exact).
+ */
+function matchesQuery(query, className, selector, pipeName) {
+    if (className === query) {
+        return true;
+    }
+    if (selector?.includes(query)) {
+        return true;
+    }
+    if (pipeName !== undefined && pipeName === query) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Finds Angular symbols across all source files in a ts-morph `Project`.
+ */
+export class AngularSymbolFinder {
+    project;
+    constructor(project) {
+        this.project = project;
+    }
+    /**
+     * Find Angular symbols matching `query`.
+     *
+     * @param query - Selector (e.g. `app-user`, `appHighlight`), pipe name
+     *   (e.g. `dateFormat`), class name (e.g. `UserComponent`), or partial
+     *   selector substring.
+     * @param type - Optional filter; when provided only results of the given type
+     *   are returned.
+     * @returns Array of matching `AngularSymbolResult` objects, empty when none
+     *   are found.
+     *
+     * @example
+     * ```typescript
+     * // By selector
+     * finder.findSymbol('app-user');
+     *
+     * // By class name with type filter
+     * finder.findSymbol('UserService', 'service');
+     * ```
+     */
+    findSymbol(query, type) {
+        const results = [];
+        for (const sourceFile of this.project.getSourceFiles()) {
+            for (const cls of sourceFile.getClasses()) {
+                const result = this.classifyClass(cls);
+                if (result === null) {
+                    continue;
+                }
+                if (type !== undefined && result.angularType !== type) {
+                    continue;
+                }
+                if (matchesQuery(query, result.className, result.selector, result.pipeName)) {
+                    results.push(result);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Attempts to classify a class declaration as an Angular symbol.
+     * Returns `null` when the class carries no recognised Angular decorator.
+     */
+    classifyClass(cls) {
+        for (const decorator of cls.getDecorators()) {
+            const decoratorName = decorator.getName();
+            const angularType = DECORATOR_TYPE_MAP[decoratorName];
+            if (angularType === undefined) {
+                continue;
+            }
+            const className = cls.getName() ?? '(anonymous)';
+            const file = cls.getSourceFile().getFilePath();
+            const metadata = extractDecoratorMetadata(decorator);
+            let selector;
+            let pipeName;
+            if (angularType === 'component' || angularType === 'directive') {
+                const rawSelector = extractDecoratorProperty(decorator, 'selector');
+                if (rawSelector !== undefined) {
+                    selector = normalizeSelector(rawSelector);
+                }
+            }
+            if (angularType === 'pipe') {
+                pipeName = extractDecoratorProperty(decorator, 'name');
+            }
+            const result = {
+                file,
+                className,
+                angularType,
+                metadata,
+            };
+            if (selector !== undefined) {
+                result.selector = selector;
+            }
+            if (pipeName !== undefined) {
+                result.pipeName = pipeName;
+            }
+            return result;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=angular-symbol-finder.js.map

package/dist/investigation/angular-symbol-finder.js.map

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

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

@@ -0,0 +1,85 @@
+/**
+ * @angular-modernizer/api - Call Graph Builder
+ *
+ * Builds a call graph for a named method or function within a ts-morph Project.
+ * Supports traversal upward (callers) and downward (callees) with configurable depth.
+ *
+ * @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.
+ *
+ * @example
+ * ```typescript
+ * const builder = new CallGraphBuilder(project);
+ * const graph = builder.buildCallGraph('getUser', '/src/app/user.service.ts', {
+ *   direction: 'both',
+ *   depth: 2,
+ * });
+ * // graph.callers → who calls getUser
+ * // graph.callees → what getUser calls
+ * ```
+ */
+import type { Project } from 'ts-morph';
+/** A node in the call graph tree. */
+export interface CallNode {
+    /** Method or function name. */
+    name: string;
+    /** Absolute file path where this method is declared. */
+    file: string;
+    /** 1-based line number of the declaration. */
+    line: number;
+    /** Nested callers or callees (recursive to configured depth). */
+    children: CallNode[];
+}
+/** Options for `buildCallGraph`. */
+export interface CallGraphOptions {
+    /**
+     * Traversal direction.
+     * - `'up'`   — callers only (who calls the target)
+     * - `'down'` — callees only (what the target calls)
+     * - `'both'` — both directions
+     * @default 'both'
+     */
+    direction?: 'up' | 'down' | 'both';
+    /**
+     * How many levels deep to traverse.
+     * @default 2
+     */
+    depth?: number;
+}
+/** Result of `buildCallGraph`. */
+export interface CallGraphResult {
+    /** The resolved target node, or `null` when not found. */
+    target: Omit<CallNode, 'children'> | null;
+    /** Nodes that call the target (populated for `'up'` and `'both'`). */
+    callers: CallNode[];
+    /** Nodes called by the target (populated for `'down'` and `'both'`). */
+    callees: CallNode[];
+}
+/**
+ * Builds caller/callee graphs for methods and functions across a ts-morph Project.
+ */
+export declare class CallGraphBuilder {
+    private readonly project;
+    /**
+     * @param project - A ts-morph `Project` instance with source files already added.
+     */
+    constructor(project: Project);
+    /**
+     * Builds a call graph rooted at the named method or function.
+     *
+     * @param method - Name of the method or function to analyse.
+     * @param file - Absolute path of the source file containing the method.
+     * @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 buildCallees;
+    private buildCallers;
+    private findDeclarationInProject;
+    private extractCallName;
+    private deduplicateNodes;
+}
+//# sourceMappingURL=call-graph-builder.d.ts.map

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

@@ -0,0 +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"}