ng-checkup 0.0.0-stage → 0.1.0

package/dist/checks/version.js

@@ -0,0 +1,107 @@
+import { majorOf, readInstalledVersion } from '../workspace.js';
+import { plural } from './context.js';
+/**
+ * Packages whose presence is a finding of its own, with what replaced them.
+ * `runtime` entries ship to users (a dead UI library), the others are tooling.
+ * The difference decides the grade: dead runtime code is a liability, dead
+ * tooling is friction.
+ */
+const END_OF_LIFE_PACKAGES = [
+    { name: '@angular/http', runtime: true, note: 'Removed in Angular 8. Replaced by `HttpClient` from `@angular/common/http`.' },
+    { name: '@angular/flex-layout', runtime: true, note: 'No longer maintained since Angular 15. Replaced by CSS flexbox/grid or a layout utility library.' },
+    { name: 'protractor', runtime: false, note: 'End of life since 2023. Replaced by Playwright or Cypress.' },
+    { name: 'tslint', runtime: false, note: 'Deprecated since 2019. Replaced by ESLint with `angular-eslint`.' },
+    { name: 'codelyzer', runtime: false, note: 'A set of TSLint rules, so it died with TSLint. Replaced by `angular-eslint`.' },
+    { name: 'node-sass', runtime: false, note: 'Deprecated. Replaced by `sass` (Dart Sass), which the Angular CLI already uses.' },
+];
+/**
+ * `@angular/*` packages that do not follow the framework's version numbers, so
+ * a different major is not a half-finished upgrade. AngularFire has its own
+ * release line, and flex-layout is reported as end of life instead.
+ */
+const OWN_VERSIONING = new Set(['@angular/fire', '@angular/flex-layout']);
+/** Builders that compile with webpack, which the esbuild `application` builder replaced as the default in v17. */
+const WEBPACK_BUILDERS = new Set(['@angular-devkit/build-angular:browser', '@nx/angular:webpack-browser', '@angular-builders/custom-webpack:browser']);
+/**
+ * Where the codebase stands against the newest Angular release, and whether
+ * its toolchain is current.
+ *
+ * Graded on the support window: Angular releases a major roughly every six
+ * months and supports each for 18 (6 active, 12 LTS), so the newest three
+ * majors are supported and anything older gets no security fixes. `ng update`
+ * moves one major at a time, so the gap is also the number of upgrade steps.
+ */
+export function versionCheck(context) {
+    const { workspace, latestAngular } = context;
+    const current = workspace.angular.major;
+    const findings = [];
+    const latestLabel = latestAngular.source === 'registry' ? 'npm registry' : 'offline, bundled estimate';
+    if (current === undefined) {
+        return {
+            id: 'version',
+            title: 'Angular version & tooling',
+            grade: 'info',
+            summary: 'No `@angular/core` dependency found in package.json.',
+            metrics: [{ label: 'Latest Angular', value: latestAngular.major, hint: latestLabel }],
+            findings: [],
+        };
+    }
+    const gap = Math.max(0, latestAngular.major - current);
+    const versionLabel = workspace.angular.installed ?? workspace.angular.declared ?? String(current);
+    if (gap >= 3) {
+        findings.push({
+            severity: 'high',
+            message: `Angular ${current} is ${gap} majors behind ${latestAngular.major} and out of support`,
+            detail: `Angular supports each major for 18 months, so only the newest three get fixes; ${current} receives no security patches. \`ng update\` moves one major at a time, which makes this ${plural(gap, 'sequential upgrade step')}, each with its own migrations to review.`,
+        });
+    }
+    else if (gap === 2) {
+        findings.push({
+            severity: 'medium',
+            message: `Angular ${current} is two majors behind and in its last months of LTS`,
+            detail: `Support for ${current} ends when Angular ${latestAngular.major + 1} ships, roughly six months after ${latestAngular.major}. Two \`ng update\` steps bring it current.`,
+        });
+    }
+    else if (gap === 1) {
+        findings.push({ severity: 'low', message: `One major behind (${current} → ${latestAngular.major})`, detail: 'Supported, but the next release will make it two.' });
+    }
+    const mismatched = Object.keys(workspace.dependencies)
+        .filter((name) => name.startsWith('@angular/') && !OWN_VERSIONING.has(name))
+        .map((name) => ({ name, major: majorOf(readInstalledVersion(workspace.root, name) ?? workspace.dependencies[name]) }))
+        .filter((entry) => entry.major !== undefined && entry.major !== current);
+    if (mismatched.length > 0) {
+        findings.push({
+            severity: 'medium',
+            message: `${plural(mismatched.length, 'Angular package')} on a different major than @angular/core ${current}`,
+            detail: `${mismatched.map((entry) => `${entry.name} ${entry.major}`).join(', ')}. Angular packages are released in lockstep and only tested against the same major; a mixed set is usually a half-finished upgrade.`,
+        });
+    }
+    const webpackTargets = workspace.targets.filter((target) => WEBPACK_BUILDERS.has(target.builder));
+    if (webpackTargets.length > 0) {
+        findings.push({
+            severity: 'medium',
+            message: `${plural(webpackTargets.length, 'project')} still built with the webpack builder`,
+            detail: `The esbuild-based \`application\` builder has been the default since Angular 17 and builds several times faster. \`ng update @angular/cli --name use-application-builder\` migrates the configuration. Projects: ${webpackTargets.map((target) => target.project).join(', ')}.`,
+        });
+    }
+    const endOfLife = END_OF_LIFE_PACKAGES.filter((entry) => entry.name in workspace.dependencies);
+    for (const entry of endOfLife) {
+        findings.push({ severity: entry.runtime ? 'high' : 'medium', message: `\`${entry.name}\` is end of life`, detail: entry.note });
+    }
+    const grade = gap >= 3 || endOfLife.some((entry) => entry.runtime) ? 'poor' : gap === 2 || mismatched.length > 0 || webpackTargets.length > 0 || endOfLife.length > 0 ? 'fair' : 'good';
+    const usesApplicationBuilder = workspace.targets.some((target) => /:(application|browser-esbuild)$/.test(target.builder));
+    return {
+        id: 'version',
+        title: 'Angular version & tooling',
+        grade,
+        summary: gap === 0 ? `On the latest major, Angular ${versionLabel}.` : `Angular ${versionLabel}, ${plural(gap, 'major')} behind ${latestAngular.major}.`,
+        metrics: [
+            { label: 'Installed', value: versionLabel, hint: workspace.angular.installed ? 'node_modules' : 'package.json range' },
+            { label: 'Latest', value: latestAngular.major, hint: latestLabel },
+            { label: 'Majors behind', value: gap },
+            { label: 'Build system', value: webpackTargets.length > 0 ? 'webpack' : usesApplicationBuilder ? 'esbuild' : 'unknown' },
+        ],
+        findings,
+    };
+}
+//# sourceMappingURL=version.js.map

package/dist/checks/version.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import type { Report } from './types.js';
+/** Parsed and validated command-line arguments. */
+interface CliArguments {
+    root: string;
+    reports: string[];
+    json: boolean;
+    verbose: boolean;
+    failOn?: 'fair' | 'poor';
+    maxExamples: number;
+    offline: boolean;
+    color: boolean;
+}
+/**
+ * Parses `argv` (without the node and script entries). Throws an `Error`
+ * whose message is meant for the user on anything invalid, which `main`
+ * prints with the hint to `--help`. Returns `'help'` or `'version'` for those
+ * two flags so `main` can print and exit before doing any work.
+ */
+export declare function parseCliArguments(argv: string[], environment?: NodeJS.ProcessEnv, isTty?: boolean): CliArguments | 'help' | 'version';
+/** Renders a report in the format its file extension names. */
+export declare function renderForFile(report: Report, path: string): string;
+/**
+ * True when some area is graded `failOn` or worse. `info` never fails a
+ * run: it means the area could not be measured, not that it is bad.
+ */
+export declare function shouldFail(report: Report, failOn: 'fair' | 'poor' | undefined): boolean;
+export {};

package/dist/cli.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, realpathSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, extname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import { runCheckup, TOOL } from './index.js';
+import { renderHtml } from './report/html.js';
+import { renderMarkdown } from './report/markdown.js';
+import { renderTerminal } from './report/terminal.js';
+const HELP = `Usage: ng-checkup [path] [options]
+
+A one-minute modernization report for an Angular codebase. Reads the code,
+never changes it, and sends nothing anywhere except one npm registry lookup
+of the latest Angular version (skip it with --offline).
+
+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
+      --no-color         Plain output (also off when NO_COLOR is set or not a TTY)
+  -h, --help             Show this help
+      --version          Show the version
+
+Examples:
+  npx ng-checkup
+  npx ng-checkup ../my-app --report checkup.html
+  npx ng-checkup --fail-on poor --report checkup.md`;
+/** Grades in order of how bad they are, for `--fail-on`. */
+const SEVERITY_ORDER = ['good', 'fair', 'poor'];
+/**
+ * Parses `argv` (without the node and script entries). Throws an `Error`
+ * whose message is meant for the user on anything invalid, which `main`
+ * prints with the hint to `--help`. Returns `'help'` or `'version'` for those
+ * two flags so `main` can print and exit before doing any work.
+ */
+export function parseCliArguments(argv, environment = process.env, isTty = Boolean(process.stdout.isTTY)) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            report: { type: 'string', short: 'r', multiple: true },
+            json: { type: 'boolean' },
+            verbose: { type: 'boolean', short: 'v' },
+            'fail-on': { type: 'string' },
+            'max-examples': { type: 'string' },
+            offline: { type: 'boolean' },
+            'no-color': { type: 'boolean' },
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean' },
+        },
+    });
+    if (values.help)
+        return 'help';
+    if (values.version)
+        return 'version';
+    if (positionals.length > 1)
+        throw new Error(`Expected one path, got ${positionals.length}: ${positionals.join(' ')}`);
+    const root = resolve(positionals[0] ?? '.');
+    if (!existsSync(root) || !statSync(root).isDirectory())
+        throw new Error(`Not a directory: ${root}`);
+    const reports = values.report ?? [];
+    for (const report of reports) {
+        if (!['.html', '.htm', '.md', '.json'].includes(extname(report).toLowerCase()))
+            throw new Error(`Unknown report format for ${report}: use .html, .md or .json`);
+    }
+    const failOn = values['fail-on'];
+    if (failOn !== undefined && failOn !== 'fair' && failOn !== 'poor')
+        throw new Error(`--fail-on takes poor or fair, got ${failOn}`);
+    const maxExamples = values['max-examples'] === undefined ? 5 : Number(values['max-examples']);
+    if (!Number.isInteger(maxExamples) || maxExamples < 0)
+        throw new Error(`--max-examples takes a whole number, got ${values['max-examples']}`);
+    return {
+        root,
+        reports,
+        json: values.json ?? false,
+        verbose: values.verbose ?? false,
+        failOn,
+        maxExamples,
+        offline: values.offline ?? false,
+        color: !values['no-color'] && environment['NO_COLOR'] === undefined && isTty,
+    };
+}
+/** Renders a report in the format its file extension names. */
+export function renderForFile(report, path) {
+    const extension = extname(path).toLowerCase();
+    if (extension === '.json')
+        return `${JSON.stringify(report, null, 2)}\n`;
+    if (extension === '.md')
+        return renderMarkdown(report);
+    return renderHtml(report);
+}
+/**
+ * True when some area is graded `failOn` or worse. `info` never fails a
+ * run: it means the area could not be measured, not that it is bad.
+ */
+export function shouldFail(report, failOn) {
+    if (!failOn)
+        return false;
+    const threshold = SEVERITY_ORDER.indexOf(failOn);
+    return report.checks.some((check) => check.grade !== 'info' && SEVERITY_ORDER.indexOf(check.grade) >= threshold);
+}
+/** Entry point. Exit codes: 0 done, 1 `--fail-on` tripped, 2 usage or runtime error. */
+async function main() {
+    let parsed;
+    try {
+        parsed = parseCliArguments(process.argv.slice(2));
+    }
+    catch (error) {
+        process.stderr.write(`ng-checkup: ${error instanceof Error ? error.message : String(error)}\nRun ng-checkup --help for usage.\n`);
+        return 2;
+    }
+    if (parsed === 'help') {
+        process.stdout.write(`${HELP}\n`);
+        return 0;
+    }
+    if (parsed === 'version') {
+        process.stdout.write(`${TOOL.version}\n`);
+        return 0;
+    }
+    const report = await runCheckup(parsed.root, { offline: parsed.offline, maxExamples: parsed.maxExamples });
+    for (const path of parsed.reports) {
+        const target = resolve(path);
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, renderForFile(report, target));
+    }
+    if (parsed.json) {
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    }
+    else {
+        process.stdout.write(`${renderTerminal(report, { color: parsed.color, verbose: parsed.verbose })}\n`);
+        for (const path of parsed.reports)
+            process.stdout.write(`Report written to ${resolve(path)}\n`);
+    }
+    return shouldFail(report, parsed.failOn) ? 1 : 0;
+}
+/**
+ * True when this file is the process entry point. Compared through
+ * `realpath` because npm starts the CLI through a symlink in `.bin`, so
+ * `argv[1]` names the link while `import.meta.url` names the target. A test
+ * importing the parsing helpers is not the entry point and runs nothing.
+ */
+function isEntryPoint() {
+    try {
+        return process.argv[1] !== undefined && realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntryPoint()) {
+    main().then((code) => {
+        process.exitCode = code;
+    }, (error) => {
+        process.stderr.write(`ng-checkup failed: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`);
+        process.exitCode = 2;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/deprecations.d.ts

@@ -0,0 +1,30 @@
+/** What a `@deprecated` tag says. */
+export interface DeprecationInfo {
+    /** The version the tag names, such as `20.0` or `20.2`, when the tag starts with one. */
+    since?: string;
+    /** The tag's text after the version, trimmed. Can be empty: some tags give no reason. */
+    message: string;
+}
+/** The deprecated exports of one import path, such as `@angular/common` or `@angular/common/http`. */
+export interface EntryDeprecations {
+    /** Exported name to its deprecation. */
+    symbols: Map<string, DeprecationInfo>;
+    /** `Owner.member` to its deprecation, for enum members and static class members. */
+    members: Map<string, DeprecationInfo>;
+}
+/** Import path to its deprecated exports. */
+export type DeprecationIndex = Map<string, EntryDeprecations>;
+/**
+ * Builds the deprecation index from the analysed repository's own `node_modules`.
+ *
+ * Reading the installed `.d.ts` files rather than shipping a hand-kept list is
+ * what keeps the report truthful: it names exactly what the installed version
+ * marks, with the version and reason Angular itself wrote. A hand-kept list
+ * drifts the moment a release adds or lifts a deprecation (Angular 22, for
+ * example, deprecates `ChangeDetectionStrategy.Default` in favour of `Eager`,
+ * because OnPush became the default).
+ *
+ * Returns an empty index when dependencies are not installed; the deprecations
+ * check then grades `info` and says why.
+ */
+export declare function buildDeprecationIndex(root: string): DeprecationIndex;

package/dist/deprecations.js

@@ -0,0 +1,279 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import ts from 'typescript';
+import { asRecord, readJson } from './workspace.js';
+/**
+ * Package scopes whose type definitions are indexed. Both publish their public
+ * API as bundled `.d.ts` files with `@deprecated` tags kept, and both are where
+ * an Angular upgrade breaks things.
+ */
+const INDEXED_SCOPES = ['@angular', '@ngrx'];
+/**
+ * Builds the deprecation index from the analysed repository's own `node_modules`.
+ *
+ * Reading the installed `.d.ts` files rather than shipping a hand-kept list is
+ * what keeps the report truthful: it names exactly what the installed version
+ * marks, with the version and reason Angular itself wrote. A hand-kept list
+ * drifts the moment a release adds or lifts a deprecation (Angular 22, for
+ * example, deprecates `ChangeDetectionStrategy.Default` in favour of `Eager`,
+ * because OnPush became the default).
+ *
+ * Returns an empty index when dependencies are not installed; the deprecations
+ * check then grades `info` and says why.
+ */
+export function buildDeprecationIndex(root) {
+    const index = new Map();
+    for (const scope of INDEXED_SCOPES) {
+        const scopeDirectory = join(root, 'node_modules', scope);
+        if (!existsSync(scopeDirectory))
+            continue;
+        for (const packageName of safeReaddir(scopeDirectory)) {
+            const packageDirectory = join(scopeDirectory, packageName);
+            for (const [entry, typesPath] of typeEntriesOf(packageDirectory)) {
+                const specifier = entry === '.' ? `${scope}/${packageName}` : `${scope}/${packageName}/${entry.slice(2)}`;
+                const deprecations = new DtsReader().exportsOf(typesPath);
+                if (deprecations.symbols.size > 0 || deprecations.members.size > 0)
+                    index.set(specifier, deprecations);
+            }
+        }
+    }
+    return index;
+}
+/**
+ * Each public entry point of a package with its type definition file.
+ *
+ * Reads `exports` (Angular 13+ and every NgRx release that matters), skipping
+ * wildcard and non-code entries. A package without an `exports` map uses the
+ * older layout, where every secondary entry point (`@angular/core/testing`,
+ * `@angular/common/http`) is a folder with its own `package.json` naming its
+ * `typings`; those are found by `legacyEntriesOf`.
+ */
+function typeEntriesOf(packageDirectory) {
+    const packageJson = readJson(join(packageDirectory, 'package.json'));
+    if (!packageJson)
+        return [];
+    const entries = [];
+    for (const [entry, target] of Object.entries(asRecord(packageJson['exports']))) {
+        if (entry.includes('*') || entry === './package.json' || !entry.startsWith('.'))
+            continue;
+        const types = asRecord(target)['types'] ?? asRecord(target)['typings'];
+        if (typeof types === 'string' && types.endsWith('.d.ts'))
+            entries.push([entry, resolve(packageDirectory, types)]);
+    }
+    if (entries.length === 0)
+        entries.push(...legacyEntriesOf(packageDirectory, '.', 0));
+    return entries.filter(([, path]) => existsSync(path));
+}
+/**
+ * Folders that never hold an entry point in the pre-`exports` layout: build
+ * formats, schematics and nested dependencies. Skipping them keeps the walk to
+ * a few dozen directories per package.
+ */
+const NON_ENTRY_DIRECTORIES = new Set(['node_modules', 'schematics', 'bundles', 'esm5', 'esm2015', 'esm2020', 'fesm5', 'fesm2015', 'fesm2020', 'src', 'locales', 'third_party', 'migrations']);
+/**
+ * Entry points of a package in the pre-`exports` layout (Angular 12 and
+ * older): this folder's `package.json` `typings`, then each subfolder's, up to
+ * three levels deep (`@angular/common/http/testing` is the deepest Angular has).
+ *
+ * @param entry The entry as an `exports` key would spell it: `.`, `./testing`.
+ */
+function legacyEntriesOf(directory, entry, depth) {
+    const entries = [];
+    const packageJson = readJson(join(directory, 'package.json'));
+    const types = packageJson?.['types'] ?? packageJson?.['typings'];
+    if (typeof types === 'string')
+        entries.push([entry, resolve(directory, types)]);
+    if (depth >= 3)
+        return entries;
+    for (const name of safeReaddir(directory)) {
+        if (NON_ENTRY_DIRECTORIES.has(name) || name.startsWith('.'))
+            continue;
+        const child = join(directory, name);
+        if (!existsSync(join(child, 'package.json')))
+            continue;
+        entries.push(...legacyEntriesOf(child, `${entry}/${name}`, depth + 1));
+    }
+    return entries;
+}
+/**
+ * Reads deprecations out of a bundle of `.d.ts` files, following re-exports
+ * between them.
+ *
+ * Angular 20+ ships each entry point as a thin `.d.ts` that re-exports from
+ * shared chunks, often under a different name (`export { a as NgIf } from
+ * './_common_module-chunk.js'`), so the deprecation sits on a declaration in
+ * one file and the public name lives in another. One reader instance memoises
+ * per file, which matters because many entry points share the same chunks.
+ */
+class DtsReader {
+    cache = new Map();
+    /** The deprecated names `path` exports, under the names it exports them as. */
+    exportsOf(path, depth = 0) {
+        const cached = this.cache.get(path);
+        if (cached)
+            return cached;
+        const result = { symbols: new Map(), members: new Map() };
+        // Set before recursing, so a re-export cycle between chunks ends here instead of overflowing.
+        this.cache.set(path, result);
+        if (depth > 8 || !existsSync(path))
+            return result;
+        const source = ts.createSourceFile(path, readFileSync(path, 'utf8'), ts.ScriptTarget.Latest, true);
+        const local = localDeprecations(source);
+        /** Names imported from sibling chunks, which a later `export { x }` may re-export. */
+        const importedFrom = new Map();
+        const exportAs = (from, original, exported) => {
+            const symbol = from.symbols.get(original);
+            if (symbol)
+                result.symbols.set(exported, symbol);
+            for (const [member, info] of from.members) {
+                if (member.startsWith(`${original}.`))
+                    result.members.set(`${exported}${member.slice(original.length)}`, info);
+            }
+        };
+        for (const statement of source.statements) {
+            if (ts.isImportDeclaration(statement) && ts.isStringLiteralLike(statement.moduleSpecifier) && statement.moduleSpecifier.text.startsWith('.')) {
+                const file = siblingDts(path, statement.moduleSpecifier.text);
+                const named = statement.importClause?.namedBindings;
+                if (named && ts.isNamedImports(named)) {
+                    for (const element of named.elements)
+                        importedFrom.set(element.name.text, { file, name: (element.propertyName ?? element.name).text });
+                }
+                continue;
+            }
+            if (ts.isExportDeclaration(statement)) {
+                const moduleSpecifier = statement.moduleSpecifier;
+                const target = moduleSpecifier && ts.isStringLiteralLike(moduleSpecifier) && moduleSpecifier.text.startsWith('.') ? this.exportsOf(siblingDts(path, moduleSpecifier.text), depth + 1) : undefined;
+                const clause = statement.exportClause;
+                if (!clause) {
+                    // `export * from './x.js'`: everything x exports, under the same names.
+                    if (target) {
+                        for (const [name, info] of target.symbols)
+                            result.symbols.set(name, info);
+                        for (const [name, info] of target.members)
+                            result.members.set(name, info);
+                    }
+                    continue;
+                }
+                if (!ts.isNamedExports(clause))
+                    continue;
+                for (const element of clause.elements) {
+                    const original = (element.propertyName ?? element.name).text;
+                    const exported = element.name.text;
+                    if (target) {
+                        exportAs(target, original, exported);
+                    }
+                    else if (local.symbols.has(original) || [...local.members.keys()].some((key) => key.startsWith(`${original}.`))) {
+                        exportAs(local, original, exported);
+                    }
+                    else {
+                        const imported = importedFrom.get(original);
+                        if (imported)
+                            exportAs(this.exportsOf(imported.file, depth + 1), imported.name, exported);
+                    }
+                }
+                continue;
+            }
+            // `export declare class X` and friends, exported under their own name.
+            if (ts.canHaveModifiers(statement) && ts.getModifiers(statement)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword)) {
+                for (const name of declaredNames(statement))
+                    exportAs(local, name, name);
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Deprecated top-level declarations of one file, by their local name, plus
+ * deprecated enum members and static class members.
+ *
+ * A name counts as deprecated only when **every** declaration of it carries the
+ * tag. Overloaded functions often deprecate one signature (an old parameter
+ * shape) while the function itself is fine, and an interface merged with a
+ * const (how Angular declares decorators) can deprecate one half. Flagging those
+ * would accuse every caller of using a deprecated API.
+ */
+function localDeprecations(source) {
+    const declarations = new Map();
+    const members = new Map();
+    for (const statement of source.statements) {
+        const info = deprecationOf(statement);
+        for (const name of declaredNames(statement)) {
+            const list = declarations.get(name) ?? [];
+            list.push(info);
+            declarations.set(name, list);
+        }
+        if (ts.isEnumDeclaration(statement)) {
+            for (const member of statement.members) {
+                const memberInfo = deprecationOf(member);
+                if (memberInfo && ts.isIdentifier(member.name))
+                    members.set(`${statement.name.text}.${member.name.text}`, memberInfo);
+            }
+        }
+        if (ts.isClassDeclaration(statement) && statement.name) {
+            const byMember = new Map();
+            for (const member of statement.members) {
+                const isStatic = ts.canHaveModifiers(member) && ts.getModifiers(member)?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword);
+                if (!isStatic || !member.name || !ts.isIdentifier(member.name))
+                    continue;
+                const list = byMember.get(member.name.text) ?? [];
+                list.push(deprecationOf(member));
+                byMember.set(member.name.text, list);
+            }
+            for (const [name, list] of byMember) {
+                const first = list[0];
+                if (first && list.every(Boolean))
+                    members.set(`${statement.name.text}.${name}`, first);
+            }
+        }
+    }
+    const symbols = new Map();
+    for (const [name, list] of declarations) {
+        // `ɵ` marks Angular's private API. Its deprecations are internal bookkeeping, not upgrade advice.
+        if (name.startsWith('ɵ'))
+            continue;
+        const first = list[0];
+        if (first && list.every(Boolean))
+            symbols.set(name, first);
+    }
+    return { symbols, members };
+}
+/** The names a top-level statement declares. Empty for anything that declares none. */
+function declaredNames(statement) {
+    if (ts.isVariableStatement(statement)) {
+        return statement.declarationList.declarations.flatMap((declaration) => (ts.isIdentifier(declaration.name) ? [declaration.name.text] : []));
+    }
+    if ((ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement) || ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement) || ts.isEnumDeclaration(statement)) &&
+        statement.name) {
+        return [statement.name.text];
+    }
+    return [];
+}
+/** The node's `@deprecated` tag, parsed, or undefined when it has none. */
+function deprecationOf(node) {
+    const tag = ts.getJSDocDeprecatedTag(node);
+    if (!tag)
+        return undefined;
+    const text = (ts.getTextOfJSDocComment(tag.comment) ?? '').replace(/\s+/g, ' ').trim();
+    // Angular writes the version three ways: `20.0 Use …`, `from v19.0.0, use …`, `since v17`.
+    const version = /^(?:(?:from|since|in)\s+)?v?(\d+(?:\.\d+){0,2})\b[:.,]?\s*/i.exec(text);
+    return version ? { since: version[1], message: text.slice(version[0].length) } : { since: undefined, message: text };
+}
+/** `./_chunk.js` next to `from`, as the `.d.ts` that types it. */
+function siblingDts(from, specifier) {
+    const base = resolve(dirname(from), specifier);
+    if (base.endsWith('.d.ts'))
+        return base;
+    if (base.endsWith('.js') || base.endsWith('.mjs'))
+        return base.replace(/\.m?js$/, '.d.ts');
+    return existsSync(`${base}.d.ts`) ? `${base}.d.ts` : join(base, 'index.d.ts');
+}
+/** `readdirSync` that treats an unreadable directory as empty. */
+function safeReaddir(directory) {
+    try {
+        return readdirSync(directory);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=deprecations.js.map