ng-checkup 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stefan Kuburovic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,274 @@
-# Temporary Holding Version
+# ng-checkup
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/ng-checkup)](https://www.npmjs.com/package/ng-checkup) [![CI](https://github.com/stefankuburovic/ng-checkup/actions/workflows/ci.yml/badge.svg)](https://github.com/stefankuburovic/ng-checkup/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/stefankuburovic/ng-checkup/blob/main/LICENSE)
+
+**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. Eight areas get a grade, 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
+```
+
+![ng-checkup in a terminal](https://raw.githubusercontent.com/stefankuburovic/ng-checkup/main/docs/terminal.png)
+
+**[See a full example report →](https://stefankuburovic.github.io/ng-checkup/example.html)** (the Angular 12 version of the RealWorld example app)
+
+---
+
+## Contents
+
+- [Quick start](#quick-start)
+- [Set it up in a project](#set-it-up-in-a-project)
+- [Configuration](#configuration)
+- [What it checks](#what-it-checks)
+- [Reports](#reports)
+- [In CI](#in-ci)
+- [Programmatic API](#programmatic-api)
+- [What leaves your machine](#what-leaves-your-machine)
+- [How it works](#how-it-works)
+- [FAQ](#faq)
+- [Roadmap](#roadmap)
+- [Contributing](#contributing)
+
+## Quick start
+
+Run it in the root of an Angular CLI or Nx workspace. It needs Node 22 or newer and nothing else; your project does not have to build.
+
+```bash
+# 1. The summary in your terminal
+npx ng-checkup
+
+# 2. The full report as a page to share
+npx ng-checkup --report checkup.html
+
+# 3. Fail CI when an area turns poor
+npx ng-checkup --fail-on poor
+```
+
+Install dependencies first (`npm install`) if you can: the deprecated-API check reads the installed Angular packages, and without them it is skipped.
+
+## Set it up in a project
+
+To keep the checkup in the project, with a script, a config file and a CI step:
+
+```bash
+ng add ng-checkup        # Angular CLI: installs it and asks which CI to use
+# or
+npx ng-checkup init      # any workspace, including Nx
+```
+
+Both make the same changes and list what they changed:
+
+| File | Change |
+| --- | --- |
+| `package.json` | a `"checkup": "ng-checkup"` script, and `ng-checkup` in `devDependencies` (`init` only; `ng add` installs it itself) |
+| `ng-checkup.config.json` | writes `checkup.html` on every run, and an empty `ignore` list |
+| `.gitignore` | the generated reports, if the repository has a `.gitignore` |
+| `.github/workflows/ng-checkup.yml` | runs on every pull request, fails on a poor area, uploads the reports (when `.github/` exists) |
+| `ng-checkup.gitlab-ci.yml` | the same as a GitLab job; add `include: [{ local: ng-checkup.gitlab-ci.yml }]` to your `.gitlab-ci.yml` (when that file exists) |
+
+After that it is `npm run checkup` (or `pnpm checkup`, `yarn checkup`; the lockfile decides). Running either command again changes nothing. It never overwrites a file you wrote: an existing workflow or config is kept, and a different `checkup` script is kept unless you pass `--force`.
+
+```bash
+npx ng-checkup init --dry-run      # show the changes, write nothing
+npx ng-checkup init --ci gitlab    # pick the CI instead of detecting it (github, gitlab, none)
+```
+
+## Configuration
+
+`ng-checkup.config.json` in the project root. Every key is optional, and every command-line flag overrides its key.
+
+```json
+{
+  "reports": ["checkup.html"],
+  "failOn": "poor",
+  "maxExamples": 5,
+  "offline": false,
+  "ignore": ["src/legacy", "**/generated", "apps/*/e2e"]
+}
+```
+
+| Key | Meaning | Flag |
+| --- | --- | --- |
+| `reports` | report files to write, relative to the config file | `--report` |
+| `failOn` | exit with 1 when an area is `poor` (or `fair`) | `--fail-on` |
+| `maxExamples` | example files listed per finding | `--max-examples` |
+| `offline` | skip the npm lookup of the latest Angular version | `--offline` |
+| `ignore` | paths left out of the analysis; a path matches everything below it, `*` stays within a folder, `**` crosses folders | |
+
+An unknown key or a wrong type stops the run with an error, so a typo cannot silently switch off a CI threshold. Use `--config path/to/file.json` for a file elsewhere.
+
+## What it checks
+
+| Area | It looks at | Poor when |
+| --- | --- | --- |
+| [**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 |
+| [**Change detection**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#change-detection) | zoneless or zone.js, OnPush coverage, `NgZone`, zone-only test helpers | zone.js with less than half the components on OnPush |
+| [**Components & templates**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#components) | standalone, signal inputs and outputs, built-in control flow, `@defer` | average adoption below 40% |
+| [**State management**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#state) | classic NgRx, NgRx signal store, signals, `BehaviorSubject` services | the removed `@Effect()` decorator |
+| [**Testing**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#testing) | Karma / Jest / Vitest, specs next to components and services, Protractor / Playwright / Cypress | Karma, Protractor or no specs |
+| [**Type safety**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#type-safety) | `strictNullChecks`, `strictTemplates`, `noImplicitAny`, `any`, `x!`, `@ts-ignore`, `$any()` | both `strictNullChecks` and `strictTemplates` off |
+| [**Circular dependencies**](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md#circular-deps) | import cycles through relative paths, barrels and tsconfig `paths` | more than three groups or ten files in loops |
+
+Each finding says why it matters and which `ng generate` migration fixes it. **[Every check, its grading and its fix →](https://github.com/stefankuburovic/ng-checkup/blob/main/docs/checks.md)**
+
+Defaults that changed between versions are applied per version: a component without `standalone` is standalone from Angular 19, one without `changeDetection` is OnPush from 22, and an app without a zone provider is zoneless from 21.
+
+## Reports
+
+![The HTML report](https://raw.githubusercontent.com/stefankuburovic/ng-checkup/main/docs/report.png)
+
+| Command | Output |
+| --- | --- |
+| `npx ng-checkup` | summary and top five priorities in the terminal |
+| `npx ng-checkup --verbose` | every finding with its files in the terminal |
+| `npx ng-checkup --report checkup.html` | self-contained page: light and dark mode, prints cleanly to PDF, loads nothing from the network |
+| `npx ng-checkup --report checkup.md` | Markdown for a pull request, an issue or a wiki |
+| `npx ng-checkup --report checkup.json` | everything, machine-readable |
+| `npx ng-checkup --json` | the JSON on stdout, for piping |
+
+`--report` is repeatable, so one run can write all three files.
+
+<details>
+<summary>All options</summary>
+
+```text
+Usage: ng-checkup [path] [options]
+       ng-checkup init [path] [init options]
+
+Arguments:
+  path                   Repository root (default: current directory)
+
+Options:
+  -r, --report <file>    Write the full report; format from the extension:
+                         .html, .md or .json. Repeatable.
+      --json             Print the report as JSON to stdout instead of the summary
+  -v, --verbose          Print every finding with its files
+      --fail-on <grade>  Exit with code 1 if any area is graded <grade> or worse:
+                         poor or fair (for CI)
+      --max-examples <n> Example files listed per finding (default 5)
+      --offline          Do not look up the latest Angular version online
+      --config <file>    Config file (default: ng-checkup.config.json in the root)
+      --no-color         Plain output (also off when NO_COLOR is set or not a TTY)
+  -h, --help             Show this help
+      --version          Show the version
+
+Init options (ng-checkup init):
+      --ci <provider>    auto (default), github, gitlab or none
+      --dry-run          Show what would change without writing anything
+      --force            Replace an existing "checkup" script
+```
+
+Exit codes: `0` done, `1` `--fail-on` tripped, `2` usage error. Areas graded `info` never fail a run.
+
+</details>
+
+## In CI
+
+`ng add ng-checkup` and `npx ng-checkup init` write this for you. By hand:
+
+**GitHub Actions**
+
+```yaml
+- uses: actions/setup-node@v4
+  with:
+    node-version: 22
+- run: npm ci
+- run: npx ng-checkup --fail-on poor --report checkup.md --report checkup.html
+- uses: actions/upload-artifact@v4
+  if: always()
+  with:
+    name: ng-checkup
+    path: checkup.*
+```
+
+**GitLab CI**
+
+```yaml
+ng-checkup:
+  image: node:22
+  script:
+    - npm ci
+    - npx ng-checkup --fail-on poor --report checkup.md --report checkup.html
+  artifacts:
+    when: always
+    paths: [checkup.md, checkup.html]
+```
+
+Start with `--fail-on poor`. `--fail-on fair` is for codebases that are already in good shape and want to stay there.
+
+## Programmatic API
+
+```ts
+import { writeFile } from 'node:fs/promises';
+import { runCheckup, renderMarkdown, overallScore } from 'ng-checkup';
+
+const report = await runCheckup('path/to/app', { offline: true });
+
+console.log(overallScore(report)); // e.g. 45
+for (const check of report.checks) {
+  console.log(check.id, check.grade, check.summary);
+}
+
+// The same Markdown the CLI writes, e.g. to post as a pull-request comment.
+await writeFile('checkup.md', renderMarkdown(report));
+```
+
+`runCheckup` never writes anything. `renderHtml`, `renderMarkdown`, `overallScore`, `topPriorities`, `loadConfig` and `planInit` (what `init` would change, without writing it) are exported too, along with the `Report`, `CheckResult`, `Finding` and `Grade` types. `Report` is also the schema of the JSON output.
+
+## What leaves your machine
+
+One request: the latest `@angular/core` version from the npm registry, with a three-second timeout. `--offline` skips it and compares against the newest major this release knows, and the report says so. No source, no file names, no telemetry. The tool reads files and writes only the reports you ask for.
+
+## How it works
+
+- **Syntax only.** Every `.ts` file is parsed once with the TypeScript compiler API, without a type checker and without building your project. That is why it takes seconds on a large monorepo and works on a repository that does not compile. Identifiers are matched through their imports, so a local helper called `signal` is not counted as Angular's.
+- **Deprecations come from your `node_modules`.** It reads the `@deprecated` tags in the installed `@angular/*` and `@ngrx/*` type definitions, following Angular's re-exports between its bundled `.d.ts` chunks, in both the current package layout and the older one. The report always matches the version you actually run, in Angular's own words.
+- **Cycles are counted as groups.** A strongly connected component is one thing to untangle; counting individual cycles grows combinatorially.
+
+## FAQ
+
+**Does it change my code?** No. It only reads. The fixes it suggests are Angular's own `ng generate` migrations, which you run yourself.
+
+**Why is the deprecated-API check "info"?** Dependencies are not installed. Run `npm install` and run the checkup again.
+
+**My app is on Angular 12 and deprecated APIs are "good". Is that right?** Yes, for Angular 12: nothing that *Angular 12* deprecates is in use. Each upgrade step deprecates more, and the version check is where that gap shows.
+
+**Is "with a spec" my test coverage?** No. It counts components and services with an `x.spec.ts` next to `x.ts`. It needs no test run, which is what keeps the tool fast and usable on a repository it has never seen.
+
+**Does it support Nx?** Yes: it reads `project.json` targets and tsconfig `paths`. A workspace with several apps is reported as one codebase for now.
+
+**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.
+
+## Roadmap
+
+- Baseline mode: fail CI only when a number gets worse, so legacy code can adopt it on day one
+- Upgrade plan: the steps from your version to the latest, with the migrations each needs
+- Per-project reports for Nx and multi-project workspaces
+- Bundle size from the build's esbuild metafile
+- SARIF output for GitHub code scanning
+
+Ideas and bug reports are welcome in [issues](https://github.com/stefankuburovic/ng-checkup/issues).
+
+## Contributing
+
+```bash
+git clone https://github.com/stefankuburovic/ng-checkup.git
+cd ng-checkup
+npm install
+npm test            # builds, then runs the Vitest suite against the fixture apps in test/fixtures
+npm run typecheck
+node dist/cli.js path/to/some/angular/app
+```
+
+Each check is one file in `src/checks/` and a pure function of the analysis context, so a new check is a new file plus a fixture that shows it.
+
+## Need help acting on the report?
+
+I'm [Stefan Kuburovic](https://stefankuburovic.github.io/), and modernizing large Angular codebases is my job. If you'd rather have someone walk through the report with your team, or do the upgrade with you, have a look at the [Angular Health Check](https://stefankuburovic.github.io/#health-check).
+
+## License
+
+MIT

package/dist/checks/change-detection.d.ts

@@ -0,0 +1,22 @@
+import type { ComponentFact } from '../scan.js';
+import type { CheckResult } from '../types.js';
+import { type AnalysisContext } from './context.js';
+/**
+ * How far the app is from zoneless change detection.
+ *
+ * Zoneless has been stable since Angular 20.2 and is the default from 21: an
+ * app on 21+ runs zoneless unless it calls `provideZoneChangeDetection()`,
+ * which is how an app upgraded from an older version keeps zone.js. Before 21
+ * it is the other way round, zoneless only with `provideZonelessChangeDetection()`.
+ * Whether an app can switch is
+ * mostly decided by how much of it already tells Angular when something
+ * changed, and OnPush coverage is the best single proxy for that: an OnPush
+ * component already has to, an eager one usually relies on zone.js noticing.
+ */
+export declare function changeDetectionCheck(context: AnalysisContext): CheckResult;
+/**
+ * Whether a component is checked OnPush. From Angular 22 OnPush is the default
+ * and only an explicit `Default` or `Eager` opts out; before it, only an
+ * explicit `OnPush` opts in.
+ */
+export declare function isOnPush(component: ComponentFact, onPushByDefault: boolean): boolean;

package/dist/checks/change-detection.js

@@ -0,0 +1,99 @@
+import { applicationFiles, callSites, countCalls, filesImporting, formatCount, percent, plural, specFiles, verb } from './context.js';
+/** Test helpers that only work with zone.js loaded. */
+const ZONE_TEST_HELPERS = ['fakeAsync', 'waitForAsync', 'tick', 'flush', 'flushMicrotasks', 'discardPeriodicTasks'].map((name) => `@angular/core/testing#${name}`);
+/**
+ * How far the app is from zoneless change detection.
+ *
+ * Zoneless has been stable since Angular 20.2 and is the default from 21: an
+ * app on 21+ runs zoneless unless it calls `provideZoneChangeDetection()`,
+ * which is how an app upgraded from an older version keeps zone.js. Before 21
+ * it is the other way round, zoneless only with `provideZonelessChangeDetection()`.
+ * Whether an app can switch is
+ * mostly decided by how much of it already tells Angular when something
+ * changed, and OnPush coverage is the best single proxy for that: an OnPush
+ * component already has to, an eager one usually relies on zone.js noticing.
+ */
+export function changeDetectionCheck(context) {
+    const application = applicationFiles(context);
+    const major = context.workspace.angular.major;
+    const zonelessByDefault = major !== undefined && major >= 21;
+    const zoneless = zonelessByDefault
+        ? countCalls(application, '@angular/core#provideZoneChangeDetection') === 0
+        : countCalls(application, '@angular/core#provideZonelessChangeDetection', '@angular/core#provideExperimentalZonelessChangeDetection') > 0;
+    const usesZoneJs = 'zone.js' in context.workspace.dependencies ||
+        context.workspace.polyfills.some((entry) => entry.startsWith('zone.js')) ||
+        application.some((file) => file.imports.some((fact) => fact.specifier.startsWith('zone.js')));
+    const components = application.flatMap((file) => file.components.map((component) => ({ file: file.path, component })));
+    const onPushByDefault = major !== undefined && major >= 22;
+    const eager = components.filter(({ component }) => !isOnPush(component, onPushByDefault));
+    const onPushShare = percent(components.length - eager.length, components.length);
+    const ngZoneFiles = application.filter((file) => file.imports.some((fact) => fact.specifier === '@angular/core' && fact.bindings.some((binding) => binding.imported === 'NgZone' && !binding.typeOnly)));
+    const zoneHelpers = countCalls(specFiles(context), ...ZONE_TEST_HELPERS);
+    const findings = [];
+    if (!zoneless && (major === undefined || major >= 20)) {
+        findings.push({
+            severity: 'medium',
+            message: 'Change detection still runs on zone.js',
+            detail: `${zonelessByDefault ? 'Zoneless is the default since Angular 21; this app opts back into zone.js with `provideZoneChangeDetection()`.' : 'Zoneless change detection is stable since Angular 20.2 (`provideZonelessChangeDetection()`) and the default from 21.'} It removes zone.js from the bundle and the cost of patching every async API, but every component then has to notify Angular itself, through signals, \`markForCheck()\`, the async pipe or event bindings. OnPush coverage below shows how much of the app already does.`,
+        });
+    }
+    else if (!zoneless && major !== undefined) {
+        findings.push({ severity: 'info', message: 'Zoneless change detection needs Angular 20.2 or newer', detail: 'Upgrade first; OnPush coverage is the preparation that pays off now.' });
+    }
+    if (components.length > 0 && eager.length > 0) {
+        findings.push({
+            severity: onPushShare < 50 ? 'medium' : 'low',
+            message: `${plural(eager.length, 'component')} ${verb(eager.length, 'uses', 'use')} eager change detection (${100 - onPushShare}%)`,
+            detail: onPushByDefault
+                ? 'OnPush is the default since Angular 22, so these set `ChangeDetectionStrategy.Default` or `Eager` explicitly. Each is a component that relies on being checked on every cycle.'
+                : 'Without `changeDetection: ChangeDetectionStrategy.OnPush` a component is checked on every change detection cycle and usually relies on zone.js to notice mutations. These are the components to review before going zoneless.',
+            files: eager.slice(0, context.maxExamples).map(({ file, component }) => ({ path: file, line: component.line })),
+            count: eager.length,
+        });
+    }
+    if (zoneHelpers > 0) {
+        findings.push({
+            severity: zoneless ? 'medium' : 'low',
+            message: `${formatCount(zoneHelpers)} zone-based test helper calls (\`fakeAsync\`, \`tick\`, \`waitForAsync\`)`,
+            detail: 'These only run with zone.js loaded in the test environment. Once zone.js leaves the test setup too, each needs rewriting with the runner\'s fake timers (`vi.useFakeTimers()` and `vi.advanceTimersByTime()` under Vitest).',
+            files: callSites(specFiles(context), ...ZONE_TEST_HELPERS).slice(0, context.maxExamples),
+            count: callSites(specFiles(context), ...ZONE_TEST_HELPERS).length,
+        });
+    }
+    if (ngZoneFiles.length > 0) {
+        findings.push({
+            severity: 'low',
+            message: `${plural(ngZoneFiles.length, 'file')} ${verb(ngZoneFiles.length, 'injects', 'inject')} \`NgZone\``,
+            detail: 'Zoneless, `NgZone` is still injectable but `run()` no longer triggers change detection and `runOutsideAngular()` no longer saves any. Code that relied on either needs a signal or an explicit `markForCheck()` instead.',
+            files: filesImporting(ngZoneFiles, ['@angular/core']).slice(0, context.maxExamples),
+            count: ngZoneFiles.length,
+        });
+    }
+    const grade = major === undefined && components.length === 0 && !usesZoneJs ? 'info' : zoneless ? 'good' : onPushShare >= 50 ? 'fair' : 'poor';
+    return {
+        id: 'change-detection',
+        title: 'Change detection & zoneless readiness',
+        grade,
+        summary: zoneless
+            ? `Zoneless, with ${onPushShare}% of components on OnPush.`
+            : `Runs on zone.js; ${onPushShare}% of ${plural(components.length, 'component')} use OnPush.`,
+        metrics: [
+            { label: 'Mode', value: zoneless ? 'Zoneless' : 'zone.js', hint: zoneless && zonelessByDefault ? 'Angular 21+ default' : undefined },
+            { label: 'OnPush', value: `${onPushShare}%`, hint: `${formatCount(components.length - eager.length)} of ${plural(components.length, 'component')}` },
+            { label: 'Files injecting NgZone', value: formatCount(ngZoneFiles.length) },
+            { label: 'Zone test helpers', value: formatCount(zoneHelpers) },
+        ],
+        findings,
+    };
+}
+/**
+ * Whether a component is checked OnPush. From Angular 22 OnPush is the default
+ * and only an explicit `Default` or `Eager` opts out; before it, only an
+ * explicit `OnPush` opts in.
+ */
+export function isOnPush(component, onPushByDefault) {
+    if (component.changeDetection === undefined)
+        return onPushByDefault;
+    return component.changeDetection === 'OnPush';
+}
+//# sourceMappingURL=change-detection.js.map

package/dist/checks/change-detection.js.map

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

package/dist/checks/circular-deps.d.ts

@@ -0,0 +1,13 @@
+import type { CheckResult } from '../types.js';
+import { type AnalysisContext } from './context.js';
+/**
+ * Import cycles between application files.
+ *
+ * A cycle is more than a style issue in an Angular app: whichever file of the
+ * loop the bundler evaluates first sees the others' exports as `undefined`,
+ * which surfaces as "X is not a function" or "Cannot access X before
+ * initialization" only in some load orders, such as one lazy route or one test
+ * file run on its own. Cycles also stop the bundler from splitting the files
+ * into separate lazy chunks.
+ */
+export declare function circularDepsCheck(context: AnalysisContext): CheckResult;

package/dist/checks/circular-deps.js

@@ -0,0 +1,43 @@
+import { formatCount, plural } from './context.js';
+/** How many tangles get a finding of their own; the rest are summarised in one line. */
+const LISTED_TANGLES = 5;
+/**
+ * Import cycles between application files.
+ *
+ * A cycle is more than a style issue in an Angular app: whichever file of the
+ * loop the bundler evaluates first sees the others' exports as `undefined`,
+ * which surfaces as "X is not a function" or "Cannot access X before
+ * initialization" only in some load orders, such as one lazy route or one test
+ * file run on its own. Cycles also stop the bundler from splitting the files
+ * into separate lazy chunks.
+ */
+export function circularDepsCheck(context) {
+    const tangles = context.tangles;
+    const filesInTangles = tangles.reduce((sum, tangle) => sum + tangle.files.length, 0);
+    const largest = tangles[0]?.files.length ?? 0;
+    const findings = tangles.slice(0, LISTED_TANGLES).map((tangle) => ({
+        severity: tangle.files.length >= 10 ? 'high' : 'medium',
+        message: `${plural(tangle.files.length, 'file')} import each other in a loop`,
+        detail: `For example: ${tangle.example.map((path) => `\`${path}\``).join(' → ')}. The group dissolves once every loop in it loses one import; most often the culprit is a barrel (\`index.ts\`) import that drags in a sibling, fixed by importing the file directly.`,
+        files: tangle.files.slice(0, context.maxExamples).map((path) => ({ path })),
+        count: tangle.files.length,
+    }));
+    if (tangles.length > LISTED_TANGLES) {
+        const rest = tangles.slice(LISTED_TANGLES);
+        findings.push({ severity: 'medium', message: `${plural(rest.length, 'more tangle')} with ${plural(rest.reduce((sum, tangle) => sum + tangle.files.length, 0), 'file')}`, detail: 'Smaller than the ones above; the same fix applies.' });
+    }
+    const grade = tangles.length === 0 ? 'good' : tangles.length <= 3 && filesInTangles <= 10 ? 'fair' : 'poor';
+    return {
+        id: 'circular-deps',
+        title: 'Circular dependencies',
+        grade,
+        summary: tangles.length === 0 ? 'No import cycles between application files.' : `${plural(tangles.length, 'group')} of files importing each other in a loop, ${plural(filesInTangles, 'file')} in total.`,
+        metrics: [
+            { label: 'Tangles', value: formatCount(tangles.length), hint: 'groups of files in a loop' },
+            { label: 'Files involved', value: formatCount(filesInTangles) },
+            { label: 'Largest tangle', value: formatCount(largest), hint: 'files' },
+        ],
+        findings,
+    };
+}
+//# sourceMappingURL=circular-deps.js.map

package/dist/checks/circular-deps.js.map

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

package/dist/checks/components.d.ts

@@ -0,0 +1,19 @@
+import type { ComponentFact } from '../scan.js';
+import type { CheckResult } from '../types.js';
+import { type AnalysisContext } from './context.js';
+/**
+ * Adoption of the component APIs Angular has moved to: standalone components,
+ * signal inputs and outputs, and built-in control flow.
+ *
+ * Graded on the average adoption across the three, so a codebase is not
+ * punished for an API it has no use for (an app without a single `@Input`
+ * is not graded on signal inputs). Each lagging area comes with the
+ * `ng generate` migration Angular ships for it, because each is mostly
+ * mechanical and the report's job is to say how much work is left.
+ */
+export declare function componentsCheck(context: AnalysisContext): CheckResult;
+/**
+ * Whether a component is standalone. From Angular 19 that is the default and
+ * only `standalone: false` opts out; before it, only `standalone: true` opts in.
+ */
+export declare function isStandalone(component: ComponentFact, standaloneByDefault: boolean): boolean;

package/dist/checks/components.js

@@ -0,0 +1,97 @@
+import { applicationFiles, countCalls, formatCount, percent, plural } from './context.js';
+/** Calls that declare a signal input, including two-way `model()` bindings. */
+const SIGNAL_INPUTS = ['input', 'input.required', 'model', 'model.required'].map((name) => `@angular/core#${name}`);
+/** Calls that declare a function-based output. */
+const SIGNAL_OUTPUTS = ['@angular/core#output', '@angular/core/rxjs-interop#outputFromObservable'];
+/**
+ * Adoption of the component APIs Angular has moved to: standalone components,
+ * signal inputs and outputs, and built-in control flow.
+ *
+ * Graded on the average adoption across the three, so a codebase is not
+ * punished for an API it has no use for (an app without a single `@Input`
+ * is not graded on signal inputs). Each lagging area comes with the
+ * `ng generate` migration Angular ships for it, because each is mostly
+ * mechanical and the report's job is to say how much work is left.
+ */
+export function componentsCheck(context) {
+    const application = applicationFiles(context);
+    const major = context.workspace.angular.major;
+    const standaloneByDefault = major === undefined || major >= 19;
+    const components = application.flatMap((file) => file.components.map((component) => ({ file: file.path, component })));
+    if (components.length === 0) {
+        return { id: 'components', title: 'Components & templates', grade: 'info', summary: 'No `@Component` classes found.', metrics: [], findings: [] };
+    }
+    const moduleBased = components.filter(({ component }) => !isStandalone(component, standaloneByDefault));
+    const ngModules = application.reduce((sum, file) => sum + file.ngModules, 0);
+    const signalInputs = countCalls(application, ...SIGNAL_INPUTS);
+    const signalOutputs = countCalls(application, ...SIGNAL_OUTPUTS);
+    const decoratorInputs = application.reduce((sum, file) => sum + file.decoratorInputs, 0);
+    const decoratorOutputs = application.reduce((sum, file) => sum + file.decoratorOutputs, 0);
+    const totals = context.templates.reduce((sum, template) => ({
+        legacy: sum.legacy + template.stats.ngIf + template.stats.ngFor + template.stats.ngSwitch,
+        modern: sum.modern + template.stats.ifBlocks + template.stats.forBlocks + template.stats.switchBlocks,
+        defer: sum.defer + template.stats.deferBlocks,
+    }), { legacy: 0, modern: 0, defer: 0 });
+    const standaloneShare = percent(components.length - moduleBased.length, components.length);
+    const inputs = signalInputs + decoratorInputs;
+    const outputs = signalOutputs + decoratorOutputs;
+    const signalInputShare = percent(signalInputs, inputs);
+    const signalOutputShare = percent(signalOutputs, outputs);
+    const controlFlow = totals.legacy + totals.modern;
+    const controlFlowShare = percent(totals.modern, controlFlow);
+    const findings = [];
+    if (moduleBased.length > 0) {
+        findings.push({
+            severity: standaloneShare < 50 ? 'medium' : 'low',
+            message: `${plural(moduleBased.length, 'component')} still declared in NgModules (${plural(ngModules, 'NgModule')} in total)`,
+            detail: 'Standalone components are the default since Angular 19 and what every new API assumes. `ng generate @angular/core:standalone` converts declarations, removes the emptied NgModules and switches bootstrapping, in three passes that can be reviewed one at a time.',
+            files: moduleBased.slice(0, context.maxExamples).map(({ file, component }) => ({ path: file, line: component.line })),
+            count: moduleBased.length,
+        });
+    }
+    if (decoratorInputs + decoratorOutputs > 0) {
+        findings.push({
+            severity: signalInputShare < 50 ? 'medium' : 'low',
+            message: `${plural(decoratorInputs, '`@Input()` decorator')} and ${plural(decoratorOutputs, '`@Output()` decorator')} left`,
+            detail: 'Signal inputs (`input()`) make inputs readable in `computed()` and effects without `ngOnChanges`, and are what zoneless change detection tracks. `ng generate @angular/core:signal-input-migration` and `ng generate @angular/core:output-migration` convert most of them; the rest are usually inputs written to from inside the component.',
+            count: decoratorInputs + decoratorOutputs,
+        });
+    }
+    const controlFlowDeprecated = context.deprecations.get('@angular/common')?.symbols.has('NgIf') ?? false;
+    if (totals.legacy > 0 && !controlFlowDeprecated) {
+        // When NgIf is deprecated in the installed version the deprecated-APIs check reports this instead.
+        findings.push({
+            severity: 'low',
+            message: `${plural(totals.legacy, 'use')} of \`*ngIf\`, \`*ngFor\` and \`[ngSwitch]\``,
+            detail: 'Built-in control flow (`@if`, `@for`, `@switch`) is available from Angular 17. `ng generate @angular/core:control-flow` migrates most templates automatically.',
+            count: totals.legacy,
+        });
+    }
+    const shares = [standaloneShare, ...(inputs > 0 ? [signalInputShare] : []), ...(controlFlow > 0 ? [controlFlowShare] : [])];
+    const average = shares.reduce((sum, share) => sum + share, 0) / shares.length;
+    const grade = average >= 80 ? 'good' : average >= 40 ? 'fair' : 'poor';
+    const metrics = [
+        { label: 'Components', value: formatCount(components.length) },
+        { label: 'Standalone', value: `${standaloneShare}%`, hint: `${formatCount(ngModules)} NgModules` },
+        { label: 'Signal inputs', value: inputs > 0 ? `${signalInputShare}%` : 'n/a', hint: `${formatCount(signalInputs)} of ${formatCount(inputs)}` },
+        { label: 'Signal outputs', value: outputs > 0 ? `${signalOutputShare}%` : 'n/a', hint: `${formatCount(signalOutputs)} of ${formatCount(outputs)}` },
+        { label: 'Built-in control flow', value: controlFlow > 0 ? `${controlFlowShare}%` : 'n/a', hint: `${formatCount(totals.modern)} of ${formatCount(controlFlow)} blocks` },
+        { label: '@defer blocks', value: formatCount(totals.defer) },
+    ];
+    return {
+        id: 'components',
+        title: 'Components & templates',
+        grade,
+        summary: `${plural(components.length, 'component')}: ${standaloneShare}% standalone, ${inputs > 0 ? `${signalInputShare}% signal inputs` : 'no inputs'}, ${controlFlow > 0 ? `${controlFlowShare}% built-in control flow` : 'no control flow'}.`,
+        metrics,
+        findings,
+    };
+}
+/**
+ * Whether a component is standalone. From Angular 19 that is the default and
+ * only `standalone: false` opts out; before it, only `standalone: true` opts in.
+ */
+export function isStandalone(component, standaloneByDefault) {
+    return component.standalone ?? standaloneByDefault;
+}
+//# sourceMappingURL=components.js.map

package/dist/checks/components.js.map

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