@angular-modernizer/api 0.1.3 → 0.2.0

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

@@ -0,0 +1,279 @@
+/**
+ * @angular-modernizer/api - Template Usage Finder
+ *
+ * Project-level companion to `scanTemplate`: resolves what a symbol means
+ * in Angular templates (component/directive selector, pipe name, class
+ * member, input/output binding) and scans every component template
+ * (external `templateUrl` files and inline `template:` literals).
+ *
+ * @remarks
+ * Member hits are `verified` when they read the member from the component
+ * context (`foo`, `this.foo`) inside the template of the declaring class or
+ * one of its subclasses. Same-name reads elsewhere (other components, or
+ * `x.foo`) are reported as `template-unverified`: they may or may not refer
+ * to the searched member.
+ *
+ * @example
+ * ```typescript
+ * const finder = new TemplateUsageFinder(project);
+ * const usages = finder.findTemplateUsages('UserCardComponent', declarations);
+ * // [{ file: '/src/app/list.component.html', usageType: 'template', templateKind: 'element', ... }]
+ * ```
+ */
+import { Node, } from 'ts-morph';
+import { dirname, resolve } from 'node:path';
+import { scanTemplate, } from './template-usage-scanner.js';
+const COMPONENT_DECORATORS = new Set(['Component', 'ExportComponent']);
+const DIRECTIVE_DECORATORS = new Set([
+    'Component',
+    'ExportComponent',
+    'Directive',
+]);
+const SIGNAL_BINDING_FACTORIES = new Set(['input', 'output', 'model']);
+function findDecorator(cls, names) {
+    return cls.getDecorators().find((d) => names.has(d.getName()));
+}
+/** Reads a string-valued property (`selector`, `name`, `templateUrl`) from decorator metadata. */
+function readDecoratorString(decorator, property) {
+    const arg = decorator.getArguments()[0];
+    if (arg === undefined || !Node.isObjectLiteralExpression(arg)) {
+        return undefined;
+    }
+    const prop = arg.getProperty(property);
+    if (prop === undefined || !Node.isPropertyAssignment(prop)) {
+        return undefined;
+    }
+    const init = prop.getInitializer();
+    if (init !== undefined &&
+        (Node.isStringLiteral(init) || Node.isNoSubstitutionTemplateLiteral(init))) {
+        return { value: init.getLiteralText(), node: init };
+    }
+    return undefined;
+}
+function lineInfo(text, offset) {
+    const before = text.slice(0, offset);
+    const line = before.split('\n').length;
+    const lineStart = before.lastIndexOf('\n') + 1;
+    const lineEnd = text.indexOf('\n', offset);
+    const snippet = text.slice(lineStart, lineEnd === -1 ? undefined : lineEnd);
+    return { line, col: offset - lineStart + 1, snippet: snippet.trim() };
+}
+/** Input/output names under which a member can be bound from a parent template. */
+function bindingNamesOf(member) {
+    const names = [];
+    const name = Node.hasName(member) ? member.getName() : undefined;
+    if (Node.isDecoratable(member)) {
+        for (const decorator of member.getDecorators()) {
+            const decoratorName = decorator.getName();
+            if (decoratorName !== 'Input' && decoratorName !== 'Output') {
+                continue;
+            }
+            const alias = decorator.getArguments()[0];
+            const aliasText = alias !== undefined && Node.isStringLiteral(alias)
+                ? alias.getLiteralText()
+                : undefined;
+            names.push(aliasText ?? name ?? '');
+        }
+    }
+    if (Node.isPropertyDeclaration(member)) {
+        const init = member.getInitializer();
+        const callee = init !== undefined && Node.isCallExpression(init)
+            ? init.getExpression().getText().split('.')[0]
+            : undefined;
+        if (callee !== undefined && SIGNAL_BINDING_FACTORIES.has(callee)) {
+            names.push(name ?? '');
+            if (callee === 'model' && name !== undefined) {
+                names.push(`${name}Change`);
+            }
+        }
+    }
+    return names.filter((n) => n !== '');
+}
+function inheritsFrom(cls, owners) {
+    const seen = new Set();
+    let current = cls;
+    while (current !== undefined && !seen.has(current)) {
+        if (owners.has(current)) {
+            return true;
+        }
+        seen.add(current);
+        current = current.getBaseClass();
+    }
+    return false;
+}
+/**
+ * Finds usages of a symbol inside Angular component templates.
+ */
+export class TemplateUsageFinder {
+    project;
+    constructor(project) {
+        this.project = project;
+    }
+    /**
+     * @param symbol - Searched name (class, member, or pipe class name).
+     * @param declarations - Declaration nodes named `symbol` (as found by `UsageFinder`).
+     * @returns Template usages, unsorted.
+     */
+    findTemplateUsages(symbol, declarations) {
+        const selectorTargets = [];
+        const pipeNames = [];
+        const members = [];
+        for (const decl of declarations) {
+            if (Node.isClassDeclaration(decl)) {
+                const directive = findDecorator(decl, DIRECTIVE_DECORATORS);
+                const selector = directive === undefined
+                    ? undefined
+                    : readDecoratorString(directive, 'selector')?.value;
+                if (selector !== undefined) {
+                    selectorTargets.push(selector);
+                }
+                const pipe = findDecorator(decl, new Set(['Pipe']));
+                const pipeName = pipe === undefined ? undefined : readDecoratorString(pipe, 'name')?.value;
+                if (pipeName !== undefined) {
+                    pipeNames.push(pipeName);
+                }
+                continue;
+            }
+            // Parameter properties live in the constructor; other members directly in the class.
+            const ownerClass = Node.isParameterDeclaration(decl)
+                ? decl.getParent().getParent()
+                : decl.getParent();
+            const isMember = ownerClass !== undefined &&
+                Node.isClassDeclaration(ownerClass) &&
+                (Node.isMethodDeclaration(decl) ||
+                    Node.isPropertyDeclaration(decl) ||
+                    Node.isGetAccessorDeclaration(decl) ||
+                    Node.isSetAccessorDeclaration(decl) ||
+                    (Node.isParameterDeclaration(decl) && decl.isParameterProperty()));
+            if (isMember && Node.isClassDeclaration(ownerClass)) {
+                members.push({ owner: ownerClass, bindingNames: bindingNamesOf(decl) });
+            }
+        }
+        const hasClassTarget = selectorTargets.length > 0 || pipeNames.length > 0;
+        const scanMembers = members.length > 0 || declarations.length === 0;
+        if (!hasClassTarget && !scanMembers) {
+            return [];
+        }
+        const queries = this.buildQueries(symbol, selectorTargets, pipeNames, members, scanMembers);
+        const memberOwners = new Set(members.map((m) => m.owner));
+        const usages = [];
+        for (const template of this.collectTemplates()) {
+            for (const query of queries) {
+                for (const hit of scanTemplate(template.content, query)) {
+                    usages.push(this.toUsage(template, hit, memberOwners));
+                }
+            }
+        }
+        return usages;
+    }
+    buildQueries(symbol, selectors, pipeNames, members, scanMembers) {
+        const queries = [];
+        for (const selector of selectors) {
+            queries.push({ selector });
+        }
+        for (const pipeName of pipeNames) {
+            queries.push({ pipeName });
+        }
+        if (scanMembers) {
+            queries.push({ memberName: symbol });
+        }
+        for (const member of members) {
+            const directive = findDecorator(member.owner, DIRECTIVE_DECORATORS);
+            const bindingSelector = directive === undefined
+                ? undefined
+                : readDecoratorString(directive, 'selector')?.value;
+            if (bindingSelector === undefined) {
+                continue;
+            }
+            for (const bindingName of member.bindingNames) {
+                queries.push({ bindingName, bindingSelector });
+            }
+        }
+        return queries;
+    }
+    toUsage(template, hit, memberOwners) {
+        const position = template.locate(hit.offset);
+        const isMemberHit = hit.implicitReceiver !== undefined;
+        const verified = !isMemberHit ||
+            (hit.implicitReceiver === true && inheritsFrom(template.owner, memberOwners));
+        const component = template.owner.getName() ?? '<anonymous>';
+        return {
+            file: template.file,
+            line: position.line,
+            col: position.col,
+            snippet: position.snippet,
+            templateKind: hit.kind,
+            templateMatch: verified ? 'verified' : 'template-unverified',
+            component,
+            ...(verified
+                ? {}
+                : {
+                    note: hit.implicitReceiver === true
+                        ? `Same-name member used in the template of ${component}, which does not declare or inherit the searched member.`
+                        : `Same-name property accessed on another object ('x.${hit.name}') in the template of ${component}; receiver type not checked.`,
+                }),
+        };
+    }
+    /** All component templates in the project (inline and external). */
+    collectTemplates() {
+        const templates = [];
+        for (const sf of this.project.getSourceFiles()) {
+            if (sf.isDeclarationFile() || sf.isInNodeModules()) {
+                continue;
+            }
+            for (const cls of sf.getClasses()) {
+                const component = findDecorator(cls, COMPONENT_DECORATORS);
+                if (component === undefined) {
+                    continue;
+                }
+                const template = this.loadTemplate(sf, cls, component);
+                if (template !== undefined) {
+                    templates.push(template);
+                }
+            }
+        }
+        return templates;
+    }
+    loadTemplate(sf, owner, decorator) {
+        const inline = readDecoratorString(decorator, 'template');
+        if (inline !== undefined) {
+            // Raw text between the delimiters keeps offsets aligned with the .ts file.
+            const literalStart = inline.node.getStart() + 1;
+            const content = inline.node.getText().slice(1, -1);
+            return {
+                owner,
+                file: sf.getFilePath(),
+                content,
+                locate: (offset) => {
+                    const pos = literalStart + offset;
+                    const { line, column } = sf.getLineAndColumnAtPos(pos);
+                    const snippet = sf.getFullText().split('\n')[line - 1] ?? '';
+                    return { line, col: column, snippet: snippet.trim() };
+                },
+            };
+        }
+        const templateUrl = readDecoratorString(decorator, 'templateUrl');
+        if (templateUrl === undefined) {
+            return undefined;
+        }
+        const file = resolve(dirname(sf.getFilePath()), templateUrl.value).replaceAll('\\', '/');
+        const fs = this.project.getFileSystem();
+        let content;
+        try {
+            if (!fs.fileExistsSync(file)) {
+                return undefined;
+            }
+            content = fs.readFileSync(file);
+        }
+        catch {
+            return undefined;
+        }
+        return {
+            owner,
+            file,
+            content,
+            locate: (offset) => lineInfo(content, offset),
+        };
+    }
+}
+//# sourceMappingURL=template-usage-finder.js.map

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

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

package/dist/investigation/template-usage-scanner.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @angular-modernizer/api - Template Usage Scanner
+ *
+ * Parses a single Angular template with `@angular/compiler` and reports
+ * where a selector, pipe, class member, or input/output binding is used.
+ * Positions are returned as offsets into the template text so callers can
+ * map them to external `.html` files or to inline `template:` literals.
+ *
+ * @remarks
+ * Pure function over template text; it knows nothing about ts-morph. The
+ * project-level lookup (which templates belong to which class, selector and
+ * pipe resolution) lives in `TemplateUsageFinder`.
+ *
+ * @example
+ * ```typescript
+ * const hits = scanTemplate('<app-user (saved)="onSave()"></app-user>', {
+ *   selector: 'app-user',
+ *   memberName: 'onSave',
+ * });
+ * // [{ kind: 'element', ... }, { kind: 'method-call', implicitReceiver: true, ... }]
+ * ```
+ */
+/** How a template refers to the searched symbol. */
+export type TemplateUsageKind = 'element' | 'attribute' | 'pipe' | 'property-read' | 'property-write' | 'method-call' | 'input-binding' | 'output-binding';
+/** What to look for in a template. All fields are optional and combinable. */
+export interface TemplateQuery {
+    /** Component/directive CSS selector (may be a selector list). */
+    selector?: string;
+    /** Pipe name as used in templates (`{{ x | name }}`). */
+    pipeName?: string;
+    /** Class member name read, written, or called in expressions. */
+    memberName?: string;
+    /** Input/output name bound as `[name]`, `name="..."` or `(name)`. */
+    bindingName?: string;
+    /**
+     * Restricts `bindingName` matches to elements matching this selector.
+     * When omitted, bindings on any element match.
+     */
+    bindingSelector?: string;
+}
+/** A single match inside a template. */
+export interface TemplateHit {
+    /** 0-based offset into the template text. */
+    offset: number;
+    /** Kind of usage. */
+    kind: TemplateUsageKind;
+    /** Matched name (selector, pipe, member, or binding name). */
+    name: string;
+    /**
+     * For member hits: `true` when the expression reads the member from the
+     * component context (`foo`, `this.foo`), `false` for `x.foo`.
+     */
+    implicitReceiver?: boolean;
+}
+/**
+ * Cheap pre-check: can the template possibly contain a hit for `query`?
+ * Avoids parsing templates that do not mention any searched token.
+ */
+export declare function templateMayMatch(content: string, query: TemplateQuery): boolean;
+/**
+ * Scans one template for usages described by `query`.
+ *
+ * @param content - Raw template text.
+ * @param query - What to look for.
+ * @returns Hits ordered by offset. Returns `[]` when the template cannot be
+ *   parsed at all.
+ */
+export declare function scanTemplate(content: string, query: TemplateQuery): TemplateHit[];
+//# sourceMappingURL=template-usage-scanner.d.ts.map

package/dist/investigation/template-usage-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-usage-scanner.d.ts","sourceRoot":"","sources":["../../src/investigation/template-usage-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA+BH,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,WAAW,GACX,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,gBAAgB,CAAC;AAErB,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,qBAAqB;IACrB,IAAI,EAAE,iBAAiB,CAAC;IAExB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAmWD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CA8B/E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,WAAW,EAAE,CA6BjF"}