@angular/cli 21.0.0-next.1 → 21.0.0-next.10

package/src/package-managers/error.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * @fileoverview This file defines a custom error class for the package manager
+ * abstraction. This allows for structured error handling and provides consumers
+ * with detailed information about the process failure.
+ */
+/**
+ * A custom error class for package manager-related errors.
+ *
+ * This error class provides structured data about the failed process,
+ * including stdout, stderr, and the exit code.
+ */
+export declare class PackageManagerError extends Error {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    /**
+     * Creates a new `PackageManagerError` instance.
+     * @param message The error message.
+     * @param stdout The standard output of the failed process.
+     * @param stderr The standard error of the failed process.
+     * @param exitCode The exit code of the failed process.
+     */
+    constructor(message: string, stdout: string, stderr: string, exitCode: number | null);
+}

package/src/package-managers/error.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageManagerError = void 0;
+/**
+ * @fileoverview This file defines a custom error class for the package manager
+ * abstraction. This allows for structured error handling and provides consumers
+ * with detailed information about the process failure.
+ */
+/**
+ * A custom error class for package manager-related errors.
+ *
+ * This error class provides structured data about the failed process,
+ * including stdout, stderr, and the exit code.
+ */
+class PackageManagerError extends Error {
+    stdout;
+    stderr;
+    exitCode;
+    /**
+     * Creates a new `PackageManagerError` instance.
+     * @param message The error message.
+     * @param stdout The standard output of the failed process.
+     * @param stderr The standard error of the failed process.
+     * @param exitCode The exit code of the failed process.
+     */
+    constructor(message, stdout, stderr, exitCode) {
+        super(message);
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+    }
+}
+exports.PackageManagerError = PackageManagerError;
+//# sourceMappingURL=error.js.map

package/src/package-managers/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["error.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAU1B;IACA;IACA;IAXlB;;;;;;OAMG;IACH,YACE,OAAe,EACC,MAAc,EACd,MAAc,EACd,QAAuB;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAe;IAGzC,CAAC;CACF;AAhBD,kDAgBC"}

package/src/package-managers/factory.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { Logger } from './logger';
+import { PackageManager } from './package-manager';
+import { PackageManagerName } from './package-manager-descriptor';
+/**
+ * Creates a new `PackageManager` instance for a given project.
+ *
+ * This function is the main entry point for the package manager abstraction.
+ * It will determine, verify, and instantiate the correct package manager.
+ *
+ * @param options An object containing the options for creating the package manager.
+ * @returns A promise that resolves to a new `PackageManager` instance.
+ */
+export declare function createPackageManager(options: {
+    cwd: string;
+    configuredPackageManager?: PackageManagerName;
+    logger?: Logger;
+    dryRun?: boolean;
+}): Promise<PackageManager>;

package/src/package-managers/factory.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPackageManager = createPackageManager;
+const semver_1 = require("semver");
+const discovery_1 = require("./discovery");
+const host_1 = require("./host");
+const package_manager_1 = require("./package-manager");
+const package_manager_descriptor_1 = require("./package-manager-descriptor");
+/**
+ * The default package manager to use when none is discovered or configured.
+ */
+const DEFAULT_PACKAGE_MANAGER = 'npm';
+/**
+ * Gets the version of yarn installed on the system.
+ * @param host A `Host` instance for running commands.
+ * @param cwd The absolute path to the working directory.
+ * @param logger An optional logger instance.
+ * @returns A promise that resolves to the yarn version string, or null if yarn is not installed.
+ */
+async function getYarnVersion(host, cwd, logger) {
+    logger?.debug(`Getting yarn version...`);
+    try {
+        const { stdout } = await host.runCommand('yarn', ['--version'], { cwd });
+        const version = stdout.trim();
+        logger?.debug(`Yarn version is '${version}'.`);
+        return version;
+    }
+    catch (e) {
+        logger?.debug('Failed to get yarn version.');
+        return null;
+    }
+}
+/**
+ * Determines the package manager to use for a given project.
+ *
+ * This function will determine the package manager by checking for a configured
+ * package manager, discovering the package manager from lockfiles, or falling
+ * back to a default. It also handles differentiation between yarn classic and modern.
+ *
+ * @param host A `Host` instance for interacting with the file system and running commands.
+ * @param cwd The directory to start the search from.
+ * @param configured An optional, explicitly configured package manager.
+ * @param logger An optional logger instance.
+ * @returns A promise that resolves to an object containing the name and source of the package manager.
+ */
+async function determinePackageManager(host, cwd, configured, logger, dryRun) {
+    let name;
+    let source;
+    if (configured) {
+        name = configured;
+        source = 'configured';
+        logger?.debug(`Using configured package manager: '${name}'.`);
+    }
+    else {
+        const discovered = await (0, discovery_1.discover)(host, cwd, logger);
+        if (discovered) {
+            name = discovered;
+            source = 'discovered';
+            logger?.debug(`Discovered package manager: '${name}'.`);
+        }
+        else {
+            name = DEFAULT_PACKAGE_MANAGER;
+            source = 'default';
+            logger?.debug(`No lockfile found. Using default package manager: '${DEFAULT_PACKAGE_MANAGER}'.`);
+        }
+    }
+    if (name === 'yarn' && !dryRun) {
+        const version = await getYarnVersion(host, cwd, logger);
+        if (version && (0, semver_1.major)(version) < 2) {
+            name = 'yarn-classic';
+            logger?.debug(`Detected yarn classic. Using 'yarn-classic'.`);
+        }
+    }
+    else if (name === 'yarn') {
+        logger?.debug('Skipping yarn version check due to dry run. Assuming modern yarn.');
+    }
+    return { name, source };
+}
+/**
+ * Creates a new `PackageManager` instance for a given project.
+ *
+ * This function is the main entry point for the package manager abstraction.
+ * It will determine, verify, and instantiate the correct package manager.
+ *
+ * @param options An object containing the options for creating the package manager.
+ * @returns A promise that resolves to a new `PackageManager` instance.
+ */
+async function createPackageManager(options) {
+    const { cwd, configuredPackageManager, logger, dryRun } = options;
+    const host = host_1.NodeJS_HOST;
+    const { name, source } = await determinePackageManager(host, cwd, configuredPackageManager, logger, dryRun);
+    const descriptor = package_manager_descriptor_1.SUPPORTED_PACKAGE_MANAGERS[name];
+    if (!descriptor) {
+        throw new Error(`Unsupported package manager: "${name}"`);
+    }
+    const packageManager = new package_manager_1.PackageManager(host, cwd, descriptor, { dryRun, logger });
+    // Do not verify if the package manager is installed during a dry run.
+    if (!dryRun) {
+        try {
+            await packageManager.getVersion();
+        }
+        catch {
+            if (source === 'default') {
+                throw new Error(`'${DEFAULT_PACKAGE_MANAGER}' was selected as the default package manager, but it is not installed or` +
+                    ` cannot be found in the PATH. Please install '${DEFAULT_PACKAGE_MANAGER}' to continue.`);
+            }
+            else {
+                throw new Error(`The project is configured to use '${name}', but it is not installed or cannot be` +
+                    ` found in the PATH. Please install '${name}' to continue.`);
+            }
+        }
+    }
+    logger?.debug(`Successfully created PackageManager for '${name}'.`);
+    return packageManager;
+}
+//# sourceMappingURL=factory.js.map

package/src/package-managers/factory.js.map

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

package/src/package-managers/host.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { Stats } from 'node:fs';
+/**
+ * An abstraction layer for side-effectful operations.
+ */
+export interface Host {
+    /**
+     * Gets the stats of a file or directory.
+     * @param path The path to the file or directory.
+     * @returns A promise that resolves to the stats.
+     */
+    stat(path: string): Promise<Stats>;
+    /**
+     * Reads the contents of a directory.
+     * @param path The path to the directory.
+     * @returns A promise that resolves to an array of file and directory names.
+     */
+    readdir(path: string): Promise<string[]>;
+    /**
+     * Creates a new, unique temporary directory.
+     * @returns A promise that resolves to the absolute path of the created directory.
+     */
+    createTempDirectory(): Promise<string>;
+    /**
+     * Deletes a directory recursively.
+     * @param path The path to the directory to delete.
+     * @returns A promise that resolves when the deletion is complete.
+     */
+    deleteDirectory(path: string): Promise<void>;
+    /**
+     * Writes content to a file.
+     * @param path The path to the file.
+     * @param content The content to write.
+     * @returns A promise that resolves when the write is complete.
+     */
+    writeFile(path: string, content: string): Promise<void>;
+    /**
+     * Spawns a child process and returns a promise that resolves with the process's
+     * output or rejects with a structured error.
+     * @param command The command to run.
+     * @param args The arguments to pass to the command.
+     * @param options Options for the child process.
+     * @returns A promise that resolves with the standard output and standard error of the command.
+     */
+    runCommand(command: string, args: readonly string[], options?: {
+        timeout?: number;
+        stdio?: 'pipe' | 'ignore';
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+}
+/**
+ * A concrete implementation of the `Host` interface that uses the Node.js APIs.
+ */
+export declare const NodeJS_HOST: Host;

package/src/package-managers/host.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeJS_HOST = void 0;
+/**
+ * @fileoverview
+ * This file defines an abstraction layer for side-effectful operations, such as
+ * file system access and command execution. This allows for easier testing by
+ * enabling the injection of mock or test-specific implementations.
+ */
+const node_child_process_1 = require("node:child_process");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const error_1 = require("./error");
+/**
+ * A concrete implementation of the `Host` interface that uses the Node.js APIs.
+ */
+exports.NodeJS_HOST = {
+    stat: promises_1.stat,
+    readdir: promises_1.readdir,
+    writeFile: promises_1.writeFile,
+    createTempDirectory: () => (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'angular-cli-')),
+    deleteDirectory: (path) => (0, promises_1.rm)(path, { recursive: true, force: true }),
+    runCommand: async (command, args, options = {}) => {
+        const signal = options.timeout ? AbortSignal.timeout(options.timeout) : undefined;
+        return new Promise((resolve, reject) => {
+            const childProcess = (0, node_child_process_1.spawn)(command, args, {
+                shell: false,
+                stdio: options.stdio ?? 'pipe',
+                signal,
+                cwd: options.cwd,
+                env: {
+                    ...process.env,
+                    ...options.env,
+                },
+            });
+            let stdout = '';
+            childProcess.stdout?.on('data', (data) => (stdout += data.toString()));
+            let stderr = '';
+            childProcess.stderr?.on('data', (data) => (stderr += data.toString()));
+            childProcess.on('close', (code) => {
+                if (code === 0) {
+                    resolve({ stdout, stderr });
+                }
+                else {
+                    const message = `Process exited with code ${code}.`;
+                    reject(new error_1.PackageManagerError(message, stdout, stderr, code));
+                }
+            });
+            childProcess.on('error', (err) => {
+                if (err.name === 'AbortError') {
+                    const message = `Process timed out.`;
+                    reject(new error_1.PackageManagerError(message, stdout, stderr, null));
+                    return;
+                }
+                const message = `Process failed with error: ${err.message}`;
+                reject(new error_1.PackageManagerError(message, stdout, stderr, null));
+            });
+        });
+    },
+};
+//# sourceMappingURL=host.js.map

package/src/package-managers/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["host.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;GAKG;AAEH,2DAA2C;AAE3C,+CAAyE;AACzE,qCAAiC;AACjC,yCAAiC;AACjC,mCAA8C;AA6D9C;;GAEG;AACU,QAAA,WAAW,GAAS;IAC/B,IAAI,EAAJ,eAAI;IACJ,OAAO,EAAP,kBAAO;IACP,SAAS,EAAT,oBAAS;IACT,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAA,kBAAO,EAAC,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,cAAc,CAAC,CAAC;IAClE,eAAe,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAA,aAAE,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC7E,UAAU,EAAE,KAAK,EACf,OAAe,EACf,IAAuB,EACvB,UAKI,EAAE,EACuC,EAAE;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAElF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,YAAY,GAAG,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;gBACxC,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;gBAC9B,MAAM;gBACN,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE;oBACH,GAAG,OAAO,CAAC,GAAG;oBACd,GAAG,OAAO,CAAC,GAAG;iBACf;aACF,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAEvE,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAEvE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBAChC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,MAAM,OAAO,GAAG,4BAA4B,IAAI,GAAG,CAAC;oBACpD,MAAM,CAAC,IAAI,2BAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC9B,MAAM,OAAO,GAAG,oBAAoB,CAAC;oBACrC,MAAM,CAAC,IAAI,2BAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;oBAE/D,OAAO;gBACT,CAAC;gBACD,MAAM,OAAO,GAAG,8BAA8B,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC5D,MAAM,CAAC,IAAI,2BAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/src/package-managers/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+export { createPackageManager } from './factory';
+export type { PackageManagerName } from './package-manager-descriptor';
+export { PackageManager } from './package-manager';
+export type * from './package-metadata';
+export type { InstalledPackage } from './package-tree';

package/src/package-managers/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageManager = exports.createPackageManager = void 0;
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "createPackageManager", { enumerable: true, get: function () { return factory_1.createPackageManager; } });
+var package_manager_1 = require("./package-manager");
+Object.defineProperty(exports, "PackageManager", { enumerable: true, get: function () { return package_manager_1.PackageManager; } });
+//# sourceMappingURL=index.js.map

package/src/package-managers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,qCAAiD;AAAxC,+GAAA,oBAAoB,OAAA;AAE7B,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/src/package-managers/logger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * @fileoverview This file defines a basic logger interface that is used by
+ * the package manager abstraction. This allows the abstraction to be decoupled
+ * from any specific logging implementation.
+ */
+/**
+ * A basic logger interface for the package manager abstraction.
+ */
+export interface Logger {
+    /**
+     * Logs a debug message.
+     * @param message The message to log.
+     */
+    debug(message: string): void;
+    /**
+     * Logs an informational message.
+     * @param message The message to log.
+     */
+    info(message: string): void;
+}

package/src/package-managers/logger.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger.js.map

package/src/package-managers/logger.js.map

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

package/src/package-managers/package-manager-descriptor.d.ts

@@ -0,0 +1,204 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * @fileoverview This file defines the data structures and configuration for
+ * supported package managers. It is the single source of truth for all
+ * package-manager-specific commands, flags, and output parsing.
+ */
+import { Logger } from './logger';
+import { PackageManifest, PackageMetadata } from './package-metadata';
+import { InstalledPackage } from './package-tree';
+import { parseNpmLikeDependencies, parseNpmLikeManifest, parseNpmLikeMetadata, parseYarnClassicDependencies, parseYarnLegacyManifest, parseYarnModernDependencies } from './parsers';
+/**
+ * An interface that describes the commands and properties of a package manager.
+ */
+export interface PackageManagerDescriptor {
+    /** The binary executable for the package manager. */
+    readonly binary: string;
+    /** The lockfile names used by the package manager. */
+    readonly lockfiles: readonly string[];
+    /** The command to add a package. */
+    readonly addCommand: string;
+    /** The command to install all dependencies. */
+    readonly installCommand: readonly string[];
+    /** The flag to force a clean installation. */
+    readonly forceFlag: string;
+    /** The flag to save a package with an exact version. */
+    readonly saveExactFlag: string;
+    /** The flag to save a package with a tilde version range. */
+    readonly saveTildeFlag: string;
+    /** The flag to save a package as a dev dependency. */
+    readonly saveDevFlag: string;
+    /** The flag to prevent the lockfile from being updated. */
+    readonly noLockfileFlag: string;
+    /** The flag to prevent lifecycle scripts from being executed. */
+    readonly ignoreScriptsFlag: string;
+    /** A function that returns the arguments and environment variables to use a custom registry. */
+    readonly getRegistryOptions?: (registry: string) => {
+        args?: string[];
+        env?: Record<string, string>;
+    };
+    /** The command to get the package manager's version. */
+    readonly versionCommand: readonly string[];
+    /** The command to list all installed dependencies. */
+    readonly listDependenciesCommand: readonly string[];
+    /** The command to fetch the registry manifest of a package. */
+    readonly getManifestCommand: readonly string[];
+    /** A function that formats the arguments for field-filtered registry views. */
+    readonly viewCommandFieldArgFormatter?: (fields: readonly string[]) => string[];
+    /** A collection of functions to parse the output of specific commands. */
+    readonly outputParsers: {
+        /** A function to parse the output of `listDependenciesCommand`. */
+        listDependencies: (stdout: string, logger?: Logger) => Map<string, InstalledPackage>;
+        /** A function to parse the output of `getManifestCommand` for a specific version. */
+        getPackageManifest: (stdout: string, logger?: Logger) => PackageManifest | null;
+        /** A function to parse the output of `getManifestCommand` for the full package metadata. */
+        getRegistryMetadata: (stdout: string, logger?: Logger) => PackageMetadata | null;
+    };
+}
+/** A type that represents the name of a supported package manager. */
+export type PackageManagerName = keyof typeof SUPPORTED_PACKAGE_MANAGERS;
+/**
+ * A map of supported package managers to their descriptors.
+ * This is the single source of truth for all package-manager-specific
+ * configuration and behavior.
+ *
+ * Each descriptor is intentionally explicit and self-contained. This approach
+ * avoids inheritance or fallback logic between package managers, ensuring that
+ * the behavior for each one is clear, predictable, and easy to modify in
+ * isolation. For example, `yarn-classic` does not inherit any properties from
+ * the `yarn` descriptor; it is a complete and independent definition.
+ */
+export declare const SUPPORTED_PACKAGE_MANAGERS: {
+    npm: {
+        binary: string;
+        lockfiles: string[];
+        addCommand: string;
+        installCommand: string[];
+        forceFlag: string;
+        saveExactFlag: string;
+        saveTildeFlag: string;
+        saveDevFlag: string;
+        noLockfileFlag: string;
+        ignoreScriptsFlag: string;
+        getRegistryOptions: (registry: string) => {
+            args: string[];
+        };
+        versionCommand: string[];
+        listDependenciesCommand: string[];
+        getManifestCommand: string[];
+        viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
+        outputParsers: {
+            listDependencies: typeof parseNpmLikeDependencies;
+            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryMetadata: typeof parseNpmLikeMetadata;
+        };
+    };
+    yarn: {
+        binary: string;
+        lockfiles: string[];
+        addCommand: string;
+        installCommand: string[];
+        forceFlag: string;
+        saveExactFlag: string;
+        saveTildeFlag: string;
+        saveDevFlag: string;
+        noLockfileFlag: string;
+        ignoreScriptsFlag: string;
+        getRegistryOptions: (registry: string) => {
+            env: {
+                NPM_CONFIG_REGISTRY: string;
+            };
+        };
+        versionCommand: string[];
+        listDependenciesCommand: string[];
+        getManifestCommand: string[];
+        viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
+        outputParsers: {
+            listDependencies: typeof parseYarnModernDependencies;
+            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryMetadata: typeof parseNpmLikeMetadata;
+        };
+    };
+    'yarn-classic': {
+        binary: string;
+        lockfiles: never[];
+        addCommand: string;
+        installCommand: string[];
+        forceFlag: string;
+        saveExactFlag: string;
+        saveTildeFlag: string;
+        saveDevFlag: string;
+        noLockfileFlag: string;
+        ignoreScriptsFlag: string;
+        getRegistryOptions: (registry: string) => {
+            args: string[];
+        };
+        versionCommand: string[];
+        listDependenciesCommand: string[];
+        getManifestCommand: string[];
+        outputParsers: {
+            listDependencies: typeof parseYarnClassicDependencies;
+            getPackageManifest: typeof parseYarnLegacyManifest;
+            getRegistryMetadata: typeof parseNpmLikeMetadata;
+        };
+    };
+    pnpm: {
+        binary: string;
+        lockfiles: string[];
+        addCommand: string;
+        installCommand: string[];
+        forceFlag: string;
+        saveExactFlag: string;
+        saveTildeFlag: string;
+        saveDevFlag: string;
+        noLockfileFlag: string;
+        ignoreScriptsFlag: string;
+        getRegistryOptions: (registry: string) => {
+            args: string[];
+        };
+        versionCommand: string[];
+        listDependenciesCommand: string[];
+        getManifestCommand: string[];
+        viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
+        outputParsers: {
+            listDependencies: typeof parseNpmLikeDependencies;
+            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryMetadata: typeof parseNpmLikeMetadata;
+        };
+    };
+    bun: {
+        binary: string;
+        lockfiles: string[];
+        addCommand: string;
+        installCommand: string[];
+        forceFlag: string;
+        saveExactFlag: string;
+        saveTildeFlag: string;
+        saveDevFlag: string;
+        noLockfileFlag: string;
+        ignoreScriptsFlag: string;
+        getRegistryOptions: (registry: string) => {
+            args: string[];
+        };
+        versionCommand: string[];
+        listDependenciesCommand: string[];
+        getManifestCommand: string[];
+        viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
+        outputParsers: {
+            listDependencies: typeof parseNpmLikeDependencies;
+            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryMetadata: typeof parseNpmLikeMetadata;
+        };
+    };
+};
+/**
+ * The order of precedence for package managers.
+ * This is a best-effort ordering based on estimated Angular community usage and default presence.
+ */
+export declare const PACKAGE_MANAGER_PRECEDENCE: readonly PackageManagerName[];