ng-checkup 0.9.1 → 0.10.1

package/README.md

@@ -4,7 +4,7 @@
 
 **A one-minute modernization report for any Angular codebase.**
 
-Point it at a repository and it tells you how far the code is from current Angular, what will break on the next upgrade, and where the work is. Twelve areas get a grade, from the Angular version and third-party packages to security and bundle size, every finding names the files, and the HTML report is one self-contained page you can hand to your team lead.
+Point it at a repository and it tells you how far the code is from current Angular, what will break on the next upgrade, and where the work is. Twelve areas get a grade, from the Angular version and third-party packages to security and bundle size (and a thirteenth for AngularJS code still waiting to be migrated), every finding names the files, and the HTML report is one self-contained page you can hand to your team lead.
 
 ```bash
 npx ng-checkup
@@ -24,6 +24,7 @@ npx ng-checkup
 - [Baseline: adopt it on legacy code](#baseline-adopt-it-on-legacy-code)
 - [Watch mode](#watch-mode)
 - [Upgrade plan](#upgrade-plan)
+- [AngularJS and hybrid apps](#angularjs-and-hybrid-apps)
 - [Monorepos](#monorepos)
 - [Client report](#client-report)
 - [What it checks](#what-it-checks)
@@ -184,6 +185,28 @@ Upgrade plan  12 → 22, 10 steps, one major at a time
 
 The plan is in every format, including the HTML report ([example](https://stefankuburovic.github.io/ng-checkup/example.html#plan-title)) and the JSON (`report.plan`).
 
+## AngularJS and hybrid apps
+
+```bash
+npx ng-checkup github:orientechnologies/orientdb-studio --plan
+```
+
+When a repository still has AngularJS (1.x), a thirteenth area comes first in the report, **AngularJS migration**. It reads the JavaScript as well as the TypeScript, in every registration style real apps use (`angular.module('app').component(…)` chains, modules held in variables, ES-module AngularJS), and counts what there is to move: components, directives and controllers, services, filters, and templates with AngularJS syntax. It names what makes a piece hard to move: controllers and `ng-controller`, `$scope`, scope events used as a message bus, runtime `$compile`, `$watch`, `ng-include`, and directives using `compile`, `replace` or `terminal`, which `UpgradeComponent` cannot wrap. AngularJS packages get their Angular replacement (`angular-route`, `angular-translate`, AngularJS Material, ...), and the version comes from `package.json`, the lockfile, `bower.json`, a CDN script tag or a checked-in `angular.js`.
+
+In a **hybrid** app (`UpgradeModule`, `downgradeModule` or the old `UpgradeAdapter`) it measures how far the migration has come: the share of components already on Angular, and what crosses the border in each direction. An Angular class registered for AngularJS with `downgradeComponent` or `downgradeInjectable` counts as migrated.
+
+```text
+[POOR]  AngularJS migration   Hybrid AngularJS 1.5.9 and Angular 4: 35% of components on Angular, 115 AngularJS components left.
+         high   AngularJS 1.5.9 is end of life since January 2022
+         medium 88 controllers registered with `.controller()`, 83 bound with `ng-controller`
+         medium 5 directives use `compile`, `replace` or `terminal`
+         medium 64 scope events (`$broadcast`, `$emit`, `$rootScope.$on`) used as a message bus
+```
+
+With `--plan` the report adds the **migration plan**, in the order of the Angular upgrade guide and with this codebase's counts on every item: prepare on AngularJS (1.8, TypeScript, controllers to components, state off `$scope`), run Angular next to AngularJS, move the code bottom up (services, filters, components, templates, packages), remove AngularJS. A hybrid app on an old Angular gets the Angular upgrade plan next to it, and the client report puts both in its roadmap.
+
+Every count is a [measure](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#measures), so a [baseline](#baseline-adopt-it-on-legacy-code) in CI holds a running migration to one rule: AngularJS only ever shrinks.
+
 ## Monorepos
 
 In an Angular CLI workspace with several projects or an Nx workspace, the report adds a table with one row per project, worst score first (here [nx-examples](https://github.com/nrwl/nx-examples), shortened):
@@ -224,6 +247,7 @@ The codebase is named by its repository and commit, never by a path on your disk
 
 | Area | It looks at | Poor when |
 | --- | --- | --- |
+| [**AngularJS migration**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#angularjs) (only with AngularJS code or packages) | AngularJS components, directives, controllers, services, filters and templates; `$scope`, scope events, `$compile`, directives `UpgradeComponent` cannot wrap; AngularJS packages; hybrid progress | any AngularJS code left, unless a hybrid app has 80% of its components on Angular |
 | [**Angular version & tooling**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#version) | installed vs. latest Angular, mixed `@angular/*` majors, webpack builder, end-of-life packages | three or more majors behind, i.e. out of support |
 | [**Deprecated APIs**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#deprecated-apis) | every imported Angular/NgRx symbol your **installed** version tags `@deprecated`, plus `*ngIf` / `*ngFor` in templates | something deprecated two majors ago is still used |
 | [**Third-party compatibility**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#dependencies) | the `@angular/core` peer range of every installed package (PrimeNG, Kendo, ng-bootstrap, NGXS, ...), the release that supports the next majors, npm deprecations | a package does not accept the installed Angular, or no release supports the latest |
@@ -282,7 +306,8 @@ Options:
       --json             Print the report as JSON to stdout instead of the summary
   -v, --verbose          Print every finding with its files
       --plan             Add an upgrade plan to the latest Angular, one major
-                         at a time, with the migrations this code needs
+                         at a time, with the migrations this code needs, and
+                         the migration plan for AngularJS code
   -p, --project <name>   Analyse one project of an Angular CLI or Nx workspace.
                          Without it, a multi-project workspace also gets a
                          per-project table
@@ -321,7 +346,7 @@ Exit codes: `0` done, `1` `--fail-on` tripped, `2` usage error (including `--fai
 
 ## In CI
 
-**GitHub Action.** One comment on every pull request, edited in place on each push, with what got worse or better than the baseline, a grade per area and the top priorities. Plus the job summary, the full reports as an artifact, and optionally annotations on the changed lines:
+**GitHub Action** ([on the Marketplace](https://github.com/marketplace/actions/ng-checkup)). One comment on every pull request, edited in place on each push, with what got worse or better than the baseline, a grade per area and the top priorities. Plus the job summary, the full reports as an artifact, and optionally annotations on the changed lines:
 
 ```yaml
 name: ng-checkup
@@ -360,7 +385,16 @@ No `npm ci` needed: versions come from the lockfile. Inputs: `path` (a folder in
     path: checkup.*
 ```
 
-**GitLab CI.** One include gives merge requests the same: the findings in the Code Quality widget, where GitLab lists what the MR introduces and what it resolves against the target branch (on every tier, self-hosted included), the reports as artifacts, and one comment on the merge request, edited on every push:
+**GitLab CI.** One include gives merge requests the same: the findings in the Code Quality widget, where GitLab lists what the MR introduces and what it resolves against the target branch (on every tier, self-hosted included), the reports as artifacts, and one comment on the merge request, edited on every push. On gitlab.com, use the [CI/CD Catalog component](https://gitlab.com/explore/catalog/stefankuburovic/ng-checkup), configured through inputs (`path`, `fail-on`, `args`, `job-name` for one checkup per app, ...):
+
+```yaml
+include:
+  - component: $CI_SERVER_FQDN/stefankuburovic/ng-checkup/ng-checkup@0.10.0
+    inputs:
+      fail-on: regression
+```
+
+On a self-managed GitLab, which cannot include components from gitlab.com, use the template:
 
 ```yaml
 include:
@@ -371,7 +405,7 @@ ng-checkup:
     NG_CHECKUP_FAIL_ON: regression   # optional; also NG_CHECKUP_PATH, NG_CHECKUP_ARGS
 ```
 
-The job runs on merge requests and on the default branch, which is what the widget compares with. For the comment, add a project access token with the `api` scope as a masked CI/CD variable `NG_CHECKUP_TOKEN`; GitLab's own job token cannot write comments, so without it the comment is skipped and the rest runs. `npx ng-checkup init` writes this for a repository with a `.gitlab-ci.yml`. If your GitLab cannot reach GitHub, copy [`gitlab/ng-checkup.yml`](https://github.com/stefankuburovic/ng-checkup/blob/main/gitlab/ng-checkup.yml) into the repository and include it with `local:`.
+The job runs on merge requests and on the default branch, which is what the widget compares with. For the comment, add a token with the `api` scope as the CI/CD variable `NG_CHECKUP_TOKEN`, **masked but not protected** (merge request branches are not protected, so a protected variable never reaches them). A project access token comments as a bot; on gitlab.com Free, where those need Premium, a personal access token works and comments as you. GitLab's own job token cannot write comments, so without the variable the comment is skipped and the rest runs. A live example: [ng-checkup-demo](https://gitlab.com/stefankuburovic/ng-checkup-demo). `npx ng-checkup init` writes this for a repository with a `.gitlab-ci.yml`. If your GitLab cannot reach GitHub, copy [`gitlab/ng-checkup.yml`](https://github.com/stefankuburovic/ng-checkup/blob/main/gitlab/ng-checkup.yml) into the repository and include it with `local:`.
 
 **GitHub code scanning**
 
@@ -441,12 +475,11 @@ Package names and versions, and only to the public npm registry: the latest `@an
 
 **Why is bundle size "info"?** It reads the stats file of your last build instead of running one. `ng build --stats-json` writes it; run the checkup after that.
 
-**Which Angular versions?** Angular 2 and newer (not AngularJS). Checks whose rules changed between versions (standalone, OnPush, zoneless defaults) apply the rules of the version you run.
+**Which Angular versions?** Angular 2 and newer, and AngularJS 1.x on its way there: AngularJS code gets its own area and a [migration plan](#angularjs-and-hybrid-apps). Checks whose rules changed between versions (standalone, OnPush, zoneless defaults) apply the rules of the version you run.
 
 ## Roadmap
 
 - Per-project baselines for monorepos
-- The Action on the GitHub Marketplace
 - Change frequency from git history, to rank large files by how often they change
 - A VS Code extension showing findings inline
 

package/dist/angularjs.d.ts

@@ -0,0 +1,136 @@
+/** The AngularJS registration methods that define something a migration has to move. */
+export type RegistrationKind = 'component' | 'directive' | 'controller' | 'service' | 'factory' | 'provider' | 'filter';
+/** One `.controller('Name', …)`, `.component('name', …)` and so on. */
+export interface Registration {
+    kind: RegistrationKind;
+    name: string;
+    line: number;
+    /**
+     * True when the call chain starts at `angular.module(…)`, directly or
+     * through a variable this file assigned from it. False for `app.controller()`
+     * on a module that came from somewhere else, which is only counted when the
+     * repository shows other AngularJS evidence: Vue registers components,
+     * directives and filters with the same call shape.
+     */
+    rooted: boolean;
+    /**
+     * True for `.factory('X', downgradeInjectable(X))` and
+     * `.directive('x', downgradeComponent(…))`: an Angular class made available
+     * to AngularJS. That is migrated code, not code left to migrate.
+     */
+    downgraded: boolean;
+}
+/** A directive definition object using what `UpgradeComponent` rejects. */
+export interface LegacyDirective {
+    line: number;
+    /** Which of `compile`, `replace`, `terminal` it sets. */
+    keys: string[];
+}
+/** Everything the AngularJS check needs from one JavaScript or TypeScript file. */
+export interface AngularJsFileFacts {
+    /** Report path. */
+    path: string;
+    language: 'js' | 'ts';
+    isSpec: boolean;
+    /** Non-blank lines. */
+    linesOfCode: number;
+    /** Lines of `angular.module('x', [...])`, the form that defines a module (one argument only looks it up). */
+    moduleDefinitions: number[];
+    registrations: Registration[];
+    /** Lines mentioning `$scope`, as a parameter, a string in an injection array, or a reference. */
+    scopeLines: number[];
+    /** `$rootScope.$broadcast/$emit/$on` and `$scope.$broadcast/$emit`: events used as a message bus. */
+    scopeEventLines: number[];
+    /** `$watch`, `$watchCollection` and `$watchGroup` calls. */
+    watcherLines: number[];
+    /** Calls of an injected `$compile`: templates compiled at runtime. */
+    compileLines: number[];
+    legacyDirectives: LegacyDirective[];
+    /** `$routeProvider.when(…)` and `$stateProvider.state(…)`: routes to move to the Angular router. */
+    routeLines: number[];
+    /** `class X extends UpgradeComponent`: an AngularJS component wrapped for use in Angular. */
+    upgradedComponents: number;
+    /** Provider objects whose `deps` include `'$injector'`: AngularJS services made injectable in Angular. */
+    upgradedServices: number;
+}
+/** What `scanAngularJsFile` found: the facts, a vendored copy of AngularJS itself, or nothing worth keeping. */
+export type AngularJsScan = {
+    facts: AngularJsFileFacts;
+} | {
+    vendoredVersion: string;
+} | undefined;
+/**
+ * Reads one file for AngularJS code. Syntax-only, like `scanSourceFile`, and
+ * it runs on `.js` as well as `.ts` files, since most AngularJS code is
+ * plain JavaScript.
+ *
+ * Skips, by returning undefined: files that cannot contain AngularJS code
+ * (see `CANDIDATE`), minified files (very long lines), and files where
+ * nothing was found. A copy of `angular.js` itself returns its version
+ * instead, which is how an app that loads AngularJS from a checked-in file
+ * still gets a version in the report.
+ */
+export declare function scanAngularJsFile(root: string, absolutePath: string, text?: string): AngularJsScan;
+/** AngularJS attributes in one HTML file. */
+export interface AngularJsTemplateStats {
+    /** `ng-*="…"` and `data-ng-*="…"` attributes, which Angular templates never use. Bootstrap attributes such as `ng-app` are left out. */
+    attributes: number;
+    /** `ng-controller`: a controller bound in the template, which ngUpgrade cannot bridge. */
+    controllers: number;
+    /** `ng-include`: templates pulled in at runtime, with no Angular equivalent. */
+    includes: number;
+    /** `ng-app`: where AngularJS bootstraps. */
+    apps: number;
+    /** The AngularJS version in a CDN `<script>` URL, such as `…/angularjs/1.8.2/angular.min.js`. */
+    cdnVersion?: string;
+}
+/**
+ * Counts AngularJS syntax in a template. Only attributes with a value are
+ * counted (`ng-repeat="…"`): `class="a ng-hide b"` would otherwise match, and
+ * Angular's own `<ng-container>`/`<ng-template>` are elements, not attributes.
+ * Commented-out markup is not counted either (see `withoutHtmlComments`).
+ */
+export declare function scanAngularJsTemplate(template: string): AngularJsTemplateStats;
+/** `dependencies.angular` (or `devDependencies`) of `bower.json` at the root: how AngularJS apps installed packages before npm. */
+export declare function readBowerAngular(root: string): {
+    version?: string;
+    exists: boolean;
+};
+/** Where the AngularJS version in a report was read from. */
+export type AngularJsVersionSource = 'node_modules or lockfile' | 'package.json range' | 'bower.json' | 'script tag' | 'vendored copy';
+/** Everything AngularJS in the repository, as `AnalysisContext.angularJs`. */
+export interface AngularJsFacts {
+    /** Files with AngularJS code, test files included (checks filter them). */
+    files: AngularJsFileFacts[];
+    /** External templates with AngularJS syntax. */
+    templates: Array<{
+        path: string;
+        stats: AngularJsTemplateStats;
+    }>;
+    /** Undefined when AngularJS is neither a dependency nor loaded from a recognisable file or URL. */
+    version?: {
+        version: string;
+        source: AngularJsVersionSource;
+    };
+    /** A `bower.json` at the root. */
+    bower: boolean;
+}
+/**
+ * Assembles `AngularJsFacts` from the scanned files. The version comes from
+ * the first source that has one, most exact first: the installed or locked
+ * `angular` package, its `package.json` range, `bower.json`, a CDN script
+ * tag, a checked-in copy of `angular.js`.
+ *
+ * @param scans One result of `scanAngularJsFile` per JavaScript or
+ *   candidate TypeScript file.
+ * @param templates Every external template; those with AngularJS syntax are kept.
+ * @param angular `versions.angular` and `dependencies.angular` of the workspace.
+ */
+export declare function assembleAngularJs(root: string, scans: AngularJsScan[], templates: Array<{
+    path: string;
+    inline: boolean;
+    angularJs?: AngularJsTemplateStats;
+}>, angular: {
+    exact?: string;
+    declared?: string;
+}): AngularJsFacts;

package/dist/angularjs.js

@@ -0,0 +1,292 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import ts from 'typescript';
+import { isTestCode, toReportPath } from './files.js';
+import { withoutHtmlComments } from './template-text.js';
+const REGISTRATION_KINDS = new Set(['component', 'directive', 'controller', 'service', 'factory', 'provider', 'filter']);
+/**
+ * Cheap test before a parse: files without any of these strings cannot hold
+ * AngularJS code, and a monorepo's Node backend can have thousands of them.
+ * Whitespace around the dots is allowed: the AngularJS tutorial itself writes
+ * `angular.` and `module('x').` at line ends.
+ */
+const CANDIDATE = /angular\s*\.\s*module|\$scope|\$rootScope|\$compile|\$routeProvider|\$stateProvider|UpgradeComponent|\$injector|\.\s*(controller|directive|component|service|factory|provider|filter)\s*\(\s*['"`]/;
+/**
+ * The version in the license header AngularJS ships in every build
+ * (`@license AngularJS v1.5.8`). A file that carries it is a copy of the
+ * framework, not application code.
+ */
+const ANGULARJS_LICENSE = /@license AngularJS v(1\.\d+\.\d+)/;
+/**
+ * Reads one file for AngularJS code. Syntax-only, like `scanSourceFile`, and
+ * it runs on `.js` as well as `.ts` files, since most AngularJS code is
+ * plain JavaScript.
+ *
+ * Skips, by returning undefined: files that cannot contain AngularJS code
+ * (see `CANDIDATE`), minified files (very long lines), and files where
+ * nothing was found. A copy of `angular.js` itself returns its version
+ * instead, which is how an app that loads AngularJS from a checked-in file
+ * still gets a version in the report.
+ */
+export function scanAngularJsFile(root, absolutePath, text = readFileSync(absolutePath, 'utf8')) {
+    const head = text.slice(0, 2000);
+    const vendored = ANGULARJS_LICENSE.exec(head);
+    if (vendored)
+        return { vendoredVersion: vendored[1] };
+    if (!CANDIDATE.test(text) || isMinified(text))
+        return undefined;
+    const language = absolutePath.endsWith('.ts') ? 'ts' : 'js';
+    const source = ts.createSourceFile(absolutePath, text, ts.ScriptTarget.Latest, true, language === 'ts' ? ts.ScriptKind.TS : ts.ScriptKind.JS);
+    const path = toReportPath(root, absolutePath);
+    const facts = {
+        path,
+        language,
+        isSpec: isTestCode(path),
+        linesOfCode: text.split('\n').filter((line) => line.trim() !== '').length,
+        moduleDefinitions: [],
+        registrations: [],
+        scopeLines: [],
+        scopeEventLines: [],
+        watcherLines: [],
+        compileLines: [],
+        legacyDirectives: [],
+        routeLines: [],
+        upgradedComponents: 0,
+        upgradedServices: 0,
+    };
+    const lineOf = (node) => source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;
+    const addLine = (lines, node) => {
+        const line = lineOf(node);
+        if (lines[lines.length - 1] !== line)
+            lines.push(line);
+    };
+    /** Variables this file assigned from `angular.module(…)`, so `homeModule.controller()` counts as rooted. */
+    const moduleVariables = new Set();
+    const collectModuleVariables = (node) => {
+        if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer && isModuleChain(node.initializer, moduleVariables))
+            moduleVariables.add(node.name.text);
+        ts.forEachChild(node, collectModuleVariables);
+    };
+    collectModuleVariables(source);
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            if (isAngularModuleCall(node)) {
+                if (node.arguments.length >= 2)
+                    facts.moduleDefinitions.push(lineOf(node));
+            }
+            else if (ts.isPropertyAccessExpression(callee)) {
+                const method = callee.name.text;
+                const [first, second] = node.arguments;
+                const name = first && (ts.isStringLiteral(first) || ts.isNoSubstitutionTemplateLiteral(first)) ? first.text : undefined;
+                if (REGISTRATION_KINDS.has(method) && name !== undefined && second !== undefined) {
+                    facts.registrations.push({ kind: method, name, line: lineOf(node), rooted: isModuleChain(callee.expression, moduleVariables), downgraded: isDowngradeCall(second) });
+                }
+                else if (method === '$watch' || method === '$watchCollection' || method === '$watchGroup') {
+                    facts.watcherLines.push(lineOf(node));
+                }
+                else if (isScopeEvent(callee)) {
+                    facts.scopeEventLines.push(lineOf(node));
+                }
+                else if ((method === 'when' && chainRoot(callee) === '$routeProvider') || (method === 'state' && chainRoot(callee) === '$stateProvider')) {
+                    facts.routeLines.push(lineOf(node));
+                }
+            }
+            else if (ts.isIdentifier(callee) && callee.text === '$compile') {
+                facts.compileLines.push(lineOf(node));
+            }
+        }
+        else if (ts.isIdentifier(node) && node.text === '$scope') {
+            addLine(facts.scopeLines, node);
+        }
+        else if (ts.isStringLiteral(node) && node.text === '$scope') {
+            addLine(facts.scopeLines, node);
+        }
+        else if (ts.isObjectLiteralExpression(node)) {
+            const legacy = legacyDirectiveKeys(node);
+            if (legacy.length > 0)
+                facts.legacyDirectives.push({ line: lineOf(node), keys: legacy });
+            if (isUpgradedServiceProvider(node))
+                facts.upgradedServices++;
+        }
+        else if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) {
+            const extendsClause = node.heritageClauses?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword);
+            const base = extendsClause?.types[0]?.expression;
+            if (base && ts.isIdentifier(base) && base.text === 'UpgradeComponent')
+                facts.upgradedComponents++;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    const found = facts.moduleDefinitions.length +
+        facts.registrations.length +
+        facts.scopeLines.length +
+        facts.compileLines.length +
+        facts.routeLines.length +
+        facts.upgradedComponents +
+        facts.upgradedServices;
+    return found > 0 ? { facts } : undefined;
+}
+/** `angular.module(…)`, also on a namespace or default import named `angular`. */
+function isAngularModuleCall(node) {
+    const callee = node.expression;
+    return ts.isPropertyAccessExpression(callee) && callee.name.text === 'module' && ts.isIdentifier(callee.expression) && callee.expression.text === 'angular';
+}
+/**
+ * True when `expression` is, or ends a chain that starts at,
+ * `angular.module(…)`: `angular.module('a').controller(…).service(…)` and
+ * `homeModule` after `let homeModule = angular.module('app.home', [])`.
+ */
+function isModuleChain(expression, moduleVariables) {
+    let current = expression;
+    for (;;) {
+        if (ts.isParenthesizedExpression(current))
+            current = current.expression;
+        else if (ts.isIdentifier(current))
+            return moduleVariables.has(current.text);
+        else if (ts.isCallExpression(current)) {
+            if (isAngularModuleCall(current))
+                return true;
+            if (!ts.isPropertyAccessExpression(current.expression))
+                return false;
+            current = current.expression.expression;
+        }
+        else
+            return false;
+    }
+}
+/** The identifier a call chain such as `$routeProvider.when(…).when(…)` starts at. */
+function chainRoot(callee) {
+    let current = callee.expression;
+    while (ts.isCallExpression(current) && ts.isPropertyAccessExpression(current.expression))
+        current = current.expression.expression;
+    return ts.isIdentifier(current) ? current.text : undefined;
+}
+/** `downgradeInjectable(X)` or `downgradeComponent({…})`, by name: that is what the upgrade guide writes. */
+function isDowngradeCall(expression) {
+    if (!ts.isCallExpression(expression))
+        return false;
+    const callee = expression.expression;
+    const name = ts.isIdentifier(callee) ? callee.text : ts.isPropertyAccessExpression(callee) ? callee.name.text : '';
+    return name === 'downgradeInjectable' || name === 'downgradeComponent';
+}
+/** `$rootScope.$broadcast/$emit/$on` or `$scope.$broadcast/$emit`. `$scope.$on` is left out: mostly `$destroy` cleanup, not a message bus. */
+function isScopeEvent(callee) {
+    const receiver = callee.expression;
+    if (!ts.isIdentifier(receiver))
+        return false;
+    const method = callee.name.text;
+    if (receiver.text === '$rootScope')
+        return method === '$broadcast' || method === '$emit' || method === '$on';
+    return receiver.text === '$scope' && (method === '$broadcast' || method === '$emit');
+}
+/** Keys that only a directive definition object has, so `{ replace: true }` elsewhere is not mistaken for one. */
+const DIRECTIVE_KEYS = new Set(['restrict', 'link', 'template', 'templateUrl', 'transclude', 'require', 'bindToController', 'controllerAs', 'priority', 'scope']);
+/**
+ * The keys of a directive definition object that `UpgradeComponent` refuses
+ * (it throws "Upgraded directive … contains unsupported feature"): `compile`,
+ * `replace: true` and `terminal: true`. Empty for any other object.
+ */
+function legacyDirectiveKeys(node) {
+    const keys = new Map();
+    for (const property of node.properties) {
+        const name = property.name && (ts.isIdentifier(property.name) || ts.isStringLiteral(property.name)) ? property.name.text : undefined;
+        if (name)
+            keys.set(name, property);
+    }
+    if (![...keys.keys()].some((key) => DIRECTIVE_KEYS.has(key)))
+        return [];
+    const isTrue = (key) => {
+        const property = keys.get(key);
+        return property !== undefined && ts.isPropertyAssignment(property) && property.initializer.kind === ts.SyntaxKind.TrueKeyword;
+    };
+    const legacy = [];
+    if (keys.has('compile'))
+        legacy.push('compile');
+    if (isTrue('replace'))
+        legacy.push('replace');
+    if (isTrue('terminal'))
+        legacy.push('terminal');
+    return legacy;
+}
+/** `{ provide: X, useFactory: (i) => i.get('heroes'), deps: ['$injector'] }`. */
+function isUpgradedServiceProvider(node) {
+    return node.properties.some((property) => ts.isPropertyAssignment(property) &&
+        ts.isIdentifier(property.name) &&
+        property.name.text === 'deps' &&
+        ts.isArrayLiteralExpression(property.initializer) &&
+        property.initializer.elements.some((element) => ts.isStringLiteral(element) && element.text === '$injector'));
+}
+/**
+ * True for a minified file: some line longer than 1 000 characters within
+ * the first 20 lines. Hand-written code never has one; a bundle or a
+ * `.min.js` always does.
+ */
+function isMinified(text) {
+    return text
+        .split('\n', 20)
+        .some((line) => line.length > 1000);
+}
+/**
+ * Counts AngularJS syntax in a template. Only attributes with a value are
+ * counted (`ng-repeat="…"`): `class="a ng-hide b"` would otherwise match, and
+ * Angular's own `<ng-container>`/`<ng-template>` are elements, not attributes.
+ * Commented-out markup is not counted either (see `withoutHtmlComments`).
+ */
+export function scanAngularJsTemplate(template) {
+    const text = withoutHtmlComments(template);
+    const count = (pattern) => (text.match(pattern) ?? []).length;
+    const cdn = /<script[^>]+src=["'][^"']*angular(?:js|\.js)?[/@](1\.\d+\.\d+)[^"']*["']/i.exec(text);
+    return {
+        // Bootstrap attributes (`ng-app`, `ng-strict-di`, `ng-csp`, `ng-jq`) mark the host page, not a template to rewrite.
+        // `ng-reflect-*` and `ng-version` are what Angular itself writes into the DOM in dev mode; they end up in
+        // templates pasted from the browser's dev tools (an Ionic app's notifications page had a dozen).
+        attributes: count(/\s(?:data-)?ng-(?!(?:app|strict-di|csp|jq|version|reflect-[a-z-]+)\b)[a-z][a-z-]*\s*=\s*["']/g),
+        controllers: count(/\s(?:data-)?ng-controller\s*=\s*["']/g),
+        includes: count(/\s(?:data-)?ng-include\s*=\s*["']|<ng-include[\s>]/g),
+        apps: count(/\s(?:data-)?ng-app(?:\s*=|[\s>])/g),
+        ...(cdn ? { cdnVersion: cdn[1] } : {}),
+    };
+}
+/** `dependencies.angular` (or `devDependencies`) of `bower.json` at the root: how AngularJS apps installed packages before npm. */
+export function readBowerAngular(root) {
+    try {
+        const bower = JSON.parse(readFileSync(join(root, 'bower.json'), 'utf8'));
+        const version = bower.dependencies?.['angular'] ?? bower.devDependencies?.['angular'];
+        return { exists: true, ...(version ? { version } : {}) };
+    }
+    catch {
+        return { exists: false };
+    }
+}
+/**
+ * Assembles `AngularJsFacts` from the scanned files. The version comes from
+ * the first source that has one, most exact first: the installed or locked
+ * `angular` package, its `package.json` range, `bower.json`, a CDN script
+ * tag, a checked-in copy of `angular.js`.
+ *
+ * @param scans One result of `scanAngularJsFile` per JavaScript or
+ *   candidate TypeScript file.
+ * @param templates Every external template; those with AngularJS syntax are kept.
+ * @param angular `versions.angular` and `dependencies.angular` of the workspace.
+ */
+export function assembleAngularJs(root, scans, templates, angular) {
+    const files = scans.flatMap((scan) => (scan && 'facts' in scan ? [scan.facts] : []));
+    const vendored = scans.flatMap((scan) => (scan && 'vendoredVersion' in scan ? [scan.vendoredVersion] : []))[0];
+    const withSyntax = templates.flatMap((template) => (!template.inline && template.angularJs ? [{ path: template.path, stats: template.angularJs }] : []));
+    const cdn = withSyntax.find((template) => template.stats.cdnVersion)?.stats.cdnVersion;
+    const bower = readBowerAngular(root);
+    const version = angular.exact
+        ? { version: angular.exact, source: 'node_modules or lockfile' }
+        : angular.declared
+            ? { version: angular.declared.replace(/^[\s^~>=<]+/, ''), source: 'package.json range' }
+            : bower.version
+                ? { version: bower.version, source: 'bower.json' }
+                : cdn
+                    ? { version: cdn, source: 'script tag' }
+                    : vendored
+                        ? { version: vendored, source: 'vendored copy' }
+                        : undefined;
+    return { files, templates: withSyntax, ...(version ? { version } : {}), bower: bower.exists };
+}
+//# sourceMappingURL=angularjs.js.map

package/dist/angularjs.js.map

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

package/dist/cache.d.ts

@@ -1,3 +1,4 @@
+import type { AngularJsScan } from './angularjs.js';
 import type { PackageCompatibility } from './compatibility.js';
 import type { DeprecationIndex } from './deprecations.js';
 import type { SourceFileFacts, TemplateFact } from './scan.js';
@@ -14,9 +15,10 @@ import type { SourceFileFacts, TemplateFact } from './scan.js';
  *   be slow and impolite.
  */
 export interface AnalysisCache {
+    /** Keyed by absolute path; AngularJS scans under `angularjs:` plus the path, since a `.ts` file is scanned both ways. */
     files: Map<string, {
         stamp: string;
-        facts: SourceFileFacts | TemplateFact;
+        facts: CachedFacts;
     }>;
     dependencies?: {
         stamp: string;
@@ -29,6 +31,10 @@ export interface AnalysisCache {
         };
     };
 }
+/** What one file's scan produces, by kind of scan. */
+export type CachedFacts = SourceFileFacts | TemplateFact | {
+    angularJs: AngularJsScan;
+};
 /** An empty cache. */
 export declare function createAnalysisCache(): AnalysisCache;
 /** `mtime:size` of a file, or an empty string when it cannot be read. */
@@ -39,4 +45,4 @@ export declare function dependencyStamp(root: string): string;
  * The cached value for `path` when its stamp still matches, else `compute()`
  * stored under the new stamp. Without a cache it just computes.
  */
-export declare function cachedFacts<T extends SourceFileFacts | TemplateFact>(cache: AnalysisCache | undefined, path: string, compute: () => T): T;
+export declare function cachedFacts<T extends CachedFacts>(cache: AnalysisCache | undefined, path: string, compute: () => T, key?: string): T;

package/dist/cache.js

@@ -22,15 +22,15 @@ export function dependencyStamp(root) {
  * The cached value for `path` when its stamp still matches, else `compute()`
  * stored under the new stamp. Without a cache it just computes.
  */
-export function cachedFacts(cache, path, compute) {
+export function cachedFacts(cache, path, compute, key = path) {
     if (!cache)
         return compute();
     const stamp = fileStamp(path);
-    const hit = cache.files.get(path);
+    const hit = cache.files.get(key);
     if (hit && hit.stamp === stamp)
         return hit.facts;
     const facts = compute();
-    cache.files.set(path, { stamp, facts });
+    cache.files.set(key, { stamp, facts });
     return facts;
 }
 //# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA4BjC,sBAAsB;AACtB,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AAC9B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,CAAC,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,iCAAiC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtK,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAA2C,KAAgC,EAAE,IAAY,EAAE,OAAgB;IACpI,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC,KAAU,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiCjC,sBAAsB;AACtB,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AAC9B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,CAAC,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,iCAAiC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtK,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAwB,KAAgC,EAAE,IAAY,EAAE,OAAgB,EAAE,GAAG,GAAG,IAAI;IAC7H,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC,KAAU,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC"}