ng-checkup 0.0.0-stage → 0.1.0

package/dist/scan.js

@@ -0,0 +1,270 @@
+import { readFileSync } from 'node:fs';
+import ts from 'typescript';
+import { isSpecFile, toReportPath } from './files.js';
+/**
+ * Parses one file and extracts its facts. Parsing is syntax-only (no type
+ * checker, no program), which is what lets a 3 000-file repository finish in
+ * seconds and lets the tool run without the project's dependencies installed.
+ * The cost is that identifiers are matched by their import, never by type.
+ */
+export function scanSourceFile(root, absolutePath) {
+    const text = readFileSync(absolutePath, 'utf8');
+    const source = ts.createSourceFile(absolutePath, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const path = toReportPath(root, absolutePath);
+    const facts = {
+        path,
+        absolutePath,
+        isSpec: isSpecFile(absolutePath),
+        linesOfCode: countLinesOfCode(text),
+        imports: [],
+        components: [],
+        ngModules: 0,
+        injectables: 0,
+        decoratorInputs: 0,
+        decoratorOutputs: 0,
+        calls: new Map(),
+        constructions: new Map(),
+        memberAccesses: new Map(),
+        jasmineCalls: 0,
+        anyLines: [],
+        nonNullLines: [],
+        definiteAssignments: 0,
+        typeSuppressions: (text.match(/@ts-(ignore|expect-error|nocheck)\b/g) ?? []).length,
+        inlineTemplates: [],
+    };
+    /** Imported bindings by local name: what `signal` in this file actually refers to. */
+    const locals = new Map();
+    for (const statement of source.statements) {
+        const fact = importFactOf(statement, source);
+        if (!fact)
+            continue;
+        facts.imports.push(fact);
+        for (const binding of fact.bindings)
+            locals.set(binding.local, { module: fact.specifier, imported: binding.imported });
+    }
+    const lineOf = (node) => source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;
+    /** `module#name` for an identifier bound by an import, undefined for anything local or global. */
+    const keyOf = (expression) => {
+        if (ts.isIdentifier(expression)) {
+            const binding = locals.get(expression.text);
+            return binding && binding.imported !== '*' ? `${binding.module}#${binding.imported}` : undefined;
+        }
+        if (ts.isPropertyAccessExpression(expression) && ts.isIdentifier(expression.expression)) {
+            const binding = locals.get(expression.expression.text);
+            if (!binding)
+                return undefined;
+            // `core.signal()` on a namespace import is `signal`; `input.required()` on a named import is `input.required`.
+            return binding.imported === '*' ? `${binding.module}#${expression.name.text}` : `${binding.module}#${binding.imported}.${expression.name.text}`;
+        }
+        return undefined;
+    };
+    const record = (map, key, line) => {
+        const lines = map.get(key);
+        if (lines)
+            lines.push(line);
+        else
+            map.set(key, [line]);
+    };
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const key = keyOf(node.expression);
+            if (key)
+                record(facts.calls, key, lineOf(node));
+            else if (isJasmineGlobalCall(node.expression, locals))
+                facts.jasmineCalls++;
+            if (node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+                const [argument] = node.arguments;
+                if (argument && ts.isStringLiteralLike(argument)) {
+                    facts.imports.push({ specifier: argument.text, line: lineOf(node), typeOnly: false, dynamic: true, bindings: [] });
+                }
+            }
+        }
+        else if (ts.isNewExpression(node)) {
+            const key = keyOf(node.expression);
+            if (key)
+                record(facts.constructions, key, lineOf(node));
+        }
+        else if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression)) {
+            const binding = locals.get(node.expression.text);
+            if (binding && binding.imported !== '*')
+                record(facts.memberAccesses, `${binding.module}#${binding.imported}.${node.name.text}`, lineOf(node));
+        }
+        else if (node.kind === ts.SyntaxKind.AnyKeyword) {
+            facts.anyLines.push(lineOf(node));
+        }
+        else if (ts.isNonNullExpression(node)) {
+            facts.nonNullLines.push(lineOf(node));
+        }
+        else if (ts.isPropertyDeclaration(node) && node.exclamationToken) {
+            facts.definiteAssignments++;
+        }
+        if (ts.isClassDeclaration(node))
+            visitClassDecorators(node);
+        if ((ts.isPropertyDeclaration(node) || ts.isSetAccessorDeclaration(node) || ts.isGetAccessorDeclaration(node)) && ts.canHaveDecorators(node)) {
+            for (const decorator of ts.getDecorators(node) ?? []) {
+                const key = decoratorKey(decorator);
+                if (key === '@angular/core#Input')
+                    facts.decoratorInputs++;
+                else if (key === '@angular/core#Output')
+                    facts.decoratorOutputs++;
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    /** `module#Name` of a decorator such as `@Component({...})`, resolved through the imports. */
+    const decoratorKey = (decorator) => {
+        const expression = ts.isCallExpression(decorator.expression) ? decorator.expression.expression : decorator.expression;
+        return keyOf(expression);
+    };
+    const visitClassDecorators = (node) => {
+        for (const decorator of ts.getDecorators(node) ?? []) {
+            const key = decoratorKey(decorator);
+            if (key === '@angular/core#NgModule')
+                facts.ngModules++;
+            else if (key === '@angular/core#Injectable')
+                facts.injectables++;
+            else if (key === '@angular/core#Component') {
+                const metadata = ts.isCallExpression(decorator.expression) ? decorator.expression.arguments[0] : undefined;
+                const component = { name: node.name?.text ?? '(anonymous)', line: lineOf(node) };
+                if (metadata && ts.isObjectLiteralExpression(metadata)) {
+                    for (const property of metadata.properties) {
+                        if (!ts.isPropertyAssignment(property) || !ts.isIdentifier(property.name))
+                            continue;
+                        const value = property.initializer;
+                        if (property.name.text === 'standalone') {
+                            if (value.kind === ts.SyntaxKind.TrueKeyword)
+                                component.standalone = true;
+                            else if (value.kind === ts.SyntaxKind.FalseKeyword)
+                                component.standalone = false;
+                        }
+                        else if (property.name.text === 'changeDetection' && ts.isPropertyAccessExpression(value)) {
+                            component.changeDetection = value.name.text;
+                        }
+                        else if (property.name.text === 'template') {
+                            const template = templateTextOf(value);
+                            if (template !== undefined) {
+                                const stats = scanTemplate(template.text);
+                                const legacyOffset = firstLegacyOffset(template.text);
+                                facts.inlineTemplates.push({
+                                    path,
+                                    inline: true,
+                                    stats,
+                                    firstLegacyLine: legacyOffset === undefined ? undefined : source.getLineAndCharacterOfPosition(template.start + legacyOffset).line + 1,
+                                });
+                            }
+                        }
+                    }
+                }
+                facts.components.push(component);
+            }
+        }
+    };
+    visit(source);
+    return facts;
+}
+/** Turns an import or re-export statement into an `ImportFact`; undefined for any other statement. */
+function importFactOf(statement, source) {
+    const line = source.getLineAndCharacterOfPosition(statement.getStart(source)).line + 1;
+    if (ts.isImportDeclaration(statement) && ts.isStringLiteralLike(statement.moduleSpecifier)) {
+        const clause = statement.importClause;
+        const bindings = [];
+        const clauseTypeOnly = clause?.isTypeOnly ?? false;
+        if (clause?.name)
+            bindings.push({ imported: 'default', local: clause.name.text, typeOnly: clauseTypeOnly });
+        const named = clause?.namedBindings;
+        if (named && ts.isNamespaceImport(named))
+            bindings.push({ imported: '*', local: named.name.text, typeOnly: clauseTypeOnly });
+        if (named && ts.isNamedImports(named)) {
+            for (const element of named.elements) {
+                bindings.push({ imported: (element.propertyName ?? element.name).text, local: element.name.text, typeOnly: clauseTypeOnly || element.isTypeOnly });
+            }
+        }
+        return {
+            specifier: statement.moduleSpecifier.text,
+            line,
+            typeOnly: clauseTypeOnly || (bindings.length > 0 && bindings.every((binding) => binding.typeOnly)),
+            dynamic: false,
+            bindings,
+        };
+    }
+    if (ts.isExportDeclaration(statement) && statement.moduleSpecifier && ts.isStringLiteralLike(statement.moduleSpecifier)) {
+        const clause = statement.exportClause;
+        const bindings = clause && ts.isNamedExports(clause)
+            ? clause.elements.map((element) => ({
+                imported: (element.propertyName ?? element.name).text,
+                // A re-export binds nothing locally; the empty name keeps it out of the local lookup.
+                local: '',
+                typeOnly: statement.isTypeOnly || element.isTypeOnly,
+            }))
+            : [];
+        return {
+            specifier: statement.moduleSpecifier.text,
+            line,
+            typeOnly: statement.isTypeOnly || (bindings.length > 0 && bindings.every((binding) => binding.typeOnly)),
+            dynamic: false,
+            bindings,
+        };
+    }
+    return undefined;
+}
+/**
+ * True for `spyOn(...)` and `jasmine.x(...)` when neither name is imported. An
+ * imported `spyOn` (some Vitest setups re-export one) is not Jasmine.
+ */
+function isJasmineGlobalCall(expression, locals) {
+    if (ts.isIdentifier(expression))
+        return (expression.text === 'spyOn' || expression.text === 'spyOnProperty') && !locals.has(expression.text);
+    return ts.isPropertyAccessExpression(expression) && ts.isIdentifier(expression.expression) && expression.expression.text === 'jasmine' && !locals.has('jasmine');
+}
+/**
+ * The text of an inline template and the offset of its first character in the
+ * file. For a template literal with `${}` substitutions only the literal parts
+ * are kept, which is enough for counting control flow and rare in practice.
+ */
+function templateTextOf(value) {
+    if (ts.isStringLiteral(value) || ts.isNoSubstitutionTemplateLiteral(value))
+        return { text: value.text, start: value.getStart() + 1 };
+    if (ts.isTemplateExpression(value)) {
+        return { text: [value.head.text, ...value.templateSpans.map((span) => span.literal.text)].join(' '), start: value.getStart() + 1 };
+    }
+    return undefined;
+}
+/** Counts control flow in one template's text. */
+export function scanTemplate(text) {
+    const count = (pattern) => (text.match(pattern) ?? []).length;
+    return {
+        ngIf: count(/\*ngIf\s*=|\[ngIf\]\s*=/g),
+        ngFor: count(/\*ngFor\s*=|\[ngForOf\]\s*=/g),
+        ngSwitch: count(/\[ngSwitch\]\s*=/g),
+        ifBlocks: count(/@if\s*\(/g),
+        forBlocks: count(/@for\s*\(/g),
+        switchBlocks: count(/@switch\s*\(/g),
+        deferBlocks: count(/@defer\b/g),
+        anyCasts: count(/\$any\s*\(/g),
+    };
+}
+/** Character offset of the first legacy structural directive in a template, or undefined. */
+export function firstLegacyOffset(text) {
+    const match = /\*ngIf\s*=|\[ngIf\]\s*=|\*ngFor\s*=|\[ngForOf\]\s*=|\[ngSwitch\]\s*=/.exec(text);
+    return match?.index;
+}
+/** Scans an external template file. */
+export function scanTemplateFile(root, absolutePath) {
+    const text = readFileSync(absolutePath, 'utf8');
+    const offset = firstLegacyOffset(text);
+    return {
+        path: toReportPath(root, absolutePath),
+        inline: false,
+        stats: scanTemplate(text),
+        firstLegacyLine: offset === undefined ? undefined : text.slice(0, offset).split('\n').length,
+    };
+}
+/** Non-blank lines, the figure a reader expects behind "lines of code". */
+function countLinesOfCode(text) {
+    let count = 0;
+    for (const line of text.split('\n'))
+        if (line.trim() !== '')
+            count++;
+    return count;
+}
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The shapes every check produces and every report renderer consumes.
+ *
+ * Kept in one dependency-free file so the renderers never import a check and a
+ * check never imports a renderer: a check only describes what it found, and the
+ * terminal, Markdown, HTML and JSON outputs decide independently how to show it.
+ */
+/**
+ * How a check judges the area it looked at.
+ *
+ * `info` means the check had nothing to grade, either because the codebase has
+ * none of what it measures (no components, no tests) or because a required
+ * input was missing (no `node_modules`). It never counts against the codebase.
+ */
+export type Grade = 'good' | 'fair' | 'poor' | 'info';
+/**
+ * How urgent a single finding is. `high` findings are lifted into the
+ * "top priorities" list at the head of every report.
+ */
+export type Severity = 'high' | 'medium' | 'low' | 'info';
+/** A source location, relative to the analysed root and always with `/` separators. */
+export interface FileRef {
+    path: string;
+    /** 1-based; absent when the finding concerns the file as a whole. */
+    line?: number;
+}
+/** One headline number shown in a check's metric grid. */
+export interface Metric {
+    label: string;
+    value: string | number;
+    /** A short qualifier rendered under the value, such as "of 214 components". */
+    hint?: string;
+}
+/** One thing a check wants a reader to act on, or at least to know. */
+export interface Finding {
+    severity: Severity;
+    /** One line, readable without the detail. Backticks mark code, as in Markdown; nothing else is markup. */
+    message: string;
+    /** Why it matters and what fixing it involves. Same markup rule as `message`. */
+    detail?: string;
+    /**
+     * Example locations, already capped at `maxExamples`. `count` holds the real
+     * total, so a renderer can say "and 40 more".
+     */
+    files?: FileRef[];
+    count?: number;
+}
+/** What one check returns. */
+export interface CheckResult {
+    /** Stable machine id, used by `--fail-on` and in the JSON output. */
+    id: string;
+    title: string;
+    grade: Grade;
+    /** One sentence shown next to the grade in every format. */
+    summary: string;
+    metrics: Metric[];
+    findings: Finding[];
+}
+/** The `ng-checkup` result as a whole, which is also the JSON output schema. */
+export interface Report {
+    tool: {
+        name: string;
+        version: string;
+    };
+    /** ISO 8601. */
+    generatedAt: string;
+    root: string;
+    project: {
+        name: string;
+        kind: WorkspaceKind;
+        angularVersion?: string;
+        sourceFiles: number;
+        templateFiles: number;
+        linesOfCode: number;
+    };
+    checks: CheckResult[];
+    durationMs: number;
+}
+/**
+ * How the repository is organised. It decides where project configuration is
+ * read from: `angular.json` for the Angular CLI, the `project.json` files for
+ * Nx. A repository with neither is still analysed, its builders are just unknown.
+ */
+export type WorkspaceKind = 'angular-cli' | 'nx' | 'unknown';
+/** Options shared by the CLI and the programmatic API. */
+export interface CheckupOptions {
+    /**
+     * Skip the npm registry lookup of the latest Angular version. The version
+     * check then compares against the newest major this release of the tool
+     * knows about and says so.
+     */
+    offline?: boolean;
+    /** How many example locations a finding lists. Defaults to 5. */
+    maxExamples?: number;
+}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * The shapes every check produces and every report renderer consumes.
+ *
+ * Kept in one dependency-free file so the renderers never import a check and a
+ * check never imports a renderer: a check only describes what it found, and the
+ * terminal, Markdown, HTML and JSON outputs decide independently how to show it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/workspace.d.ts

@@ -0,0 +1,70 @@
+import type { WorkspaceKind } from './types.js';
+/** One build/test/e2e target of one project, as `angular.json` or a `project.json` declares it. */
+export interface TargetInfo {
+    project: string;
+    target: string;
+    /** The `builder` (Angular CLI) or `executor` (Nx), such as `@angular/build:application`. */
+    builder: string;
+    /** The target's `options` block, untyped because every builder defines its own. */
+    options: Record<string, unknown>;
+    /** Absolute directory the project's relative option paths resolve against. */
+    baseDirectory: string;
+}
+/** What the analysis knows about the repository before it reads any source file. */
+export interface WorkspaceInfo {
+    root: string;
+    name: string;
+    kind: WorkspaceKind;
+    /** `dependencies` and `devDependencies` of the root `package.json`, merged. Empty when there is none. */
+    dependencies: Record<string, string>;
+    /** Whether `node_modules/@angular/core` exists, which the deprecation index needs. */
+    hasNodeModules: boolean;
+    angular: {
+        /** The range `package.json` asks for, such as `^17.3.0`. */
+        declared?: string;
+        /** The exact version in `node_modules`, when dependencies are installed. */
+        installed?: string;
+        /** From `installed` when present, else from `declared`. Absent when Angular is not a dependency. */
+        major?: number;
+    };
+    targets: TargetInfo[];
+    /** Every polyfill entry of every target, which is where `zone.js` is wired in for CLI 15+ projects. */
+    polyfills: string[];
+    /** The tsconfig the application is compiled with, used for the strictness flags. */
+    appTsconfig?: string;
+    /** The tsconfig holding repository-wide `paths`, used to resolve imports for the dependency graph. */
+    rootTsconfig?: string;
+}
+/**
+ * Reads the repository-level configuration: `package.json`, `angular.json` or
+ * the Nx `project.json` files, and the tsconfig files that matter.
+ *
+ * Every read is defensive. A repository is analysed as far as it can be, so a
+ * missing or malformed file leaves the corresponding field empty instead of
+ * aborting the run; the checks that depend on it then grade `info`.
+ *
+ * @param projectJsons The `project.json` paths the file walk already found, so
+ *   an Nx workspace is not walked a second time.
+ */
+export declare function readWorkspace(root: string, projectJsons: string[]): WorkspaceInfo;
+/**
+ * The major version in a version or a range: `^17.3.0` gives 17, `~22.0.8`
+ * gives 22, `22.0.8` gives 22. Undefined for anything without a leading number,
+ * such as `latest`, a git URL or a `workspace:` protocol.
+ */
+export declare function majorOf(versionOrRange: string | undefined): number | undefined;
+/**
+ * The `version` field of an installed package, or undefined when the package
+ * is not in `node_modules`. Reads `package.json` directly instead of using
+ * `require.resolve`, which would honour the analysed package's `exports` map
+ * and refuse a path it does not export.
+ */
+export declare function readInstalledVersion(root: string, packageName: string): string | undefined;
+/**
+ * Parses a JSON file that may contain comments and trailing commas, which
+ * `angular.json`, `project.json` and every tsconfig are allowed to. Returns
+ * undefined for a missing file, a parse error, or anything that is not an object.
+ */
+export declare function readJson(path: string): Record<string, unknown> | undefined;
+/** Narrows an unknown JSON value to an object, treating anything else as empty. */
+export declare function asRecord(value: unknown): Record<string, unknown>;

package/dist/workspace.js

@@ -0,0 +1,155 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import ts from 'typescript';
+/**
+ * Reads the repository-level configuration: `package.json`, `angular.json` or
+ * the Nx `project.json` files, and the tsconfig files that matter.
+ *
+ * Every read is defensive. A repository is analysed as far as it can be, so a
+ * missing or malformed file leaves the corresponding field empty instead of
+ * aborting the run; the checks that depend on it then grade `info`.
+ *
+ * @param projectJsons The `project.json` paths the file walk already found, so
+ *   an Nx workspace is not walked a second time.
+ */
+export function readWorkspace(root, projectJsons) {
+    const packageJson = readJson(join(root, 'package.json'));
+    const dependencies = {
+        ...asStringRecord(packageJson?.['devDependencies']),
+        ...asStringRecord(packageJson?.['dependencies']),
+    };
+    const angularJson = readJson(join(root, 'angular.json'));
+    const isNx = existsSync(join(root, 'nx.json'));
+    const kind = angularJson ? 'angular-cli' : isNx ? 'nx' : 'unknown';
+    const targets = angularJson ? readAngularJsonTargets(root, angularJson) : readProjectJsonTargets(projectJsons);
+    const installed = readInstalledVersion(root, '@angular/core');
+    const declared = dependencies['@angular/core'];
+    return {
+        root,
+        name: typeof packageJson?.['name'] === 'string' ? packageJson['name'] : basename(root),
+        kind,
+        dependencies,
+        hasNodeModules: installed !== undefined,
+        angular: { declared, installed, major: majorOf(installed ?? declared) },
+        targets,
+        polyfills: targets.flatMap((target) => polyfillsOf(target.options)),
+        appTsconfig: findAppTsconfig(root, targets),
+        rootTsconfig: ['tsconfig.base.json', 'tsconfig.json'].map((name) => join(root, name)).find((path) => existsSync(path)),
+    };
+}
+/**
+ * The major version in a version or a range: `^17.3.0` gives 17, `~22.0.8`
+ * gives 22, `22.0.8` gives 22. Undefined for anything without a leading number,
+ * such as `latest`, a git URL or a `workspace:` protocol.
+ */
+export function majorOf(versionOrRange) {
+    const match = versionOrRange?.match(/(\d+)\.\d+/) ?? versionOrRange?.match(/^[\^~>=<\s]*(\d+)$/);
+    return match ? Number(match[1]) : undefined;
+}
+/**
+ * The `version` field of an installed package, or undefined when the package
+ * is not in `node_modules`. Reads `package.json` directly instead of using
+ * `require.resolve`, which would honour the analysed package's `exports` map
+ * and refuse a path it does not export.
+ */
+export function readInstalledVersion(root, packageName) {
+    const version = readJson(join(root, 'node_modules', packageName, 'package.json'))?.['version'];
+    return typeof version === 'string' ? version : undefined;
+}
+/** Targets from `angular.json`, which calls them `architect` in older files and `targets` in newer ones. */
+function readAngularJsonTargets(root, angularJson) {
+    const projects = asRecord(angularJson['projects']);
+    const targets = [];
+    for (const [projectName, value] of Object.entries(projects)) {
+        const project = asRecord(value);
+        const projectRoot = typeof project['root'] === 'string' ? project['root'] : '';
+        const declared = asRecord(project['architect'] ?? project['targets']);
+        for (const [targetName, target] of Object.entries(declared)) {
+            const builder = asRecord(target)['builder'];
+            if (typeof builder !== 'string')
+                continue;
+            // angular.json resolves option paths against the workspace root, not the project root.
+            targets.push({ project: projectName || projectRoot, target: targetName, builder, options: asRecord(asRecord(target)['options']), baseDirectory: root });
+        }
+    }
+    return targets;
+}
+/** Targets from Nx `project.json` files, which name the builder `executor`. */
+function readProjectJsonTargets(projectJsons) {
+    const targets = [];
+    for (const path of projectJsons) {
+        const project = readJson(path);
+        if (!project)
+            continue;
+        const projectName = typeof project['name'] === 'string' ? project['name'] : basename(dirname(path));
+        for (const [targetName, target] of Object.entries(asRecord(project['targets']))) {
+            const record = asRecord(target);
+            const builder = record['executor'] ?? record['builder'];
+            if (typeof builder !== 'string')
+                continue;
+            // Nx resolves option paths against the workspace root as well, which is
+            // two or more levels above the project.json in a typical apps/ layout.
+            targets.push({ project: projectName, target: targetName, builder, options: asRecord(record['options']), baseDirectory: findWorkspaceRoot(path) });
+        }
+    }
+    return targets;
+}
+/** The nearest ancestor of `path` holding `nx.json`, falling back to the file's own directory. */
+function findWorkspaceRoot(path) {
+    let directory = dirname(path);
+    while (true) {
+        if (existsSync(join(directory, 'nx.json')))
+            return directory;
+        const parent = dirname(directory);
+        if (parent === directory)
+            return dirname(path);
+        directory = parent;
+    }
+}
+/** `polyfills` is a string in CLI 15–16 projects and an array from CLI 17 on. */
+function polyfillsOf(options) {
+    const polyfills = options['polyfills'];
+    if (typeof polyfills === 'string')
+        return [polyfills];
+    return Array.isArray(polyfills) ? polyfills.filter((entry) => typeof entry === 'string') : [];
+}
+/**
+ * The application's tsconfig: the `tsConfig` option of the first application
+ * build target, then a root `tsconfig.app.json`, then the root `tsconfig.json`.
+ *
+ * A library's build target is skipped on purpose. Libraries are commonly built
+ * with laxer settings than the app, and the app config is what decides how
+ * strictly the shipped code is checked.
+ */
+function findAppTsconfig(root, targets) {
+    const applicationBuild = targets.find((target) => target.target === 'build' && /:(application|browser|browser-esbuild|webpack-browser)$/.test(target.builder));
+    const fromTarget = applicationBuild?.options['tsConfig'];
+    if (applicationBuild && typeof fromTarget === 'string') {
+        const path = resolve(applicationBuild.baseDirectory, fromTarget);
+        if (existsSync(path))
+            return path;
+    }
+    return ['tsconfig.app.json', 'tsconfig.json'].map((name) => join(root, name)).find((path) => existsSync(path));
+}
+/**
+ * Parses a JSON file that may contain comments and trailing commas, which
+ * `angular.json`, `project.json` and every tsconfig are allowed to. Returns
+ * undefined for a missing file, a parse error, or anything that is not an object.
+ */
+export function readJson(path) {
+    if (!existsSync(path))
+        return undefined;
+    const parsed = ts.parseConfigFileTextToJson(path, readFileSync(path, 'utf8'));
+    if (parsed.error || typeof parsed.config !== 'object' || parsed.config === null)
+        return undefined;
+    return parsed.config;
+}
+/** Narrows an unknown JSON value to an object, treating anything else as empty. */
+export function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : {};
+}
+/** Narrows a dependency map, dropping any entry whose version is not a string. */
+function asStringRecord(value) {
+    return Object.fromEntries(Object.entries(asRecord(value)).filter((entry) => typeof entry[1] === 'string'));
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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