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

package/src/package-managers/package-manager.js

@@ -0,0 +1,304 @@
+"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 = void 0;
+/**
+ * @fileoverview This file contains the `PackageManager` class, which is the
+ * core execution engine for all package manager commands. It is designed to be
+ * a flexible and secure abstraction over the various package managers.
+ */
+const node_path_1 = require("node:path");
+const error_1 = require("./error");
+/**
+ * The fields to request from the registry for package metadata.
+ * This is a performance optimization to avoid downloading the full manifest
+ * when only summary data (like versions and tags) is needed.
+ */
+const METADATA_FIELDS = ['name', 'dist-tags', 'versions', 'time'];
+/**
+ * The fields to request from the registry for a package's manifest.
+ * This is a performance optimization to avoid downloading unnecessary data.
+ * These fields are the ones required by the CLI for operations like `ng add` and `ng update`.
+ */
+const MANIFEST_FIELDS = [
+    'name',
+    'version',
+    'deprecated',
+    'dependencies',
+    'peerDependencies',
+    'devDependencies',
+    'homepage',
+    'schematics',
+    'ng-add',
+    'ng-update',
+];
+/**
+ * A class that provides a high-level, package-manager-agnostic API for
+ * interacting with a project's dependencies.
+ *
+ * This class is an implementation of the Strategy design pattern. It is
+ * instantiated with a `PackageManagerDescriptor` that defines the specific
+ * commands and flags for a given package manager.
+ */
+class PackageManager {
+    host;
+    cwd;
+    descriptor;
+    options;
+    #manifestCache = new Map();
+    #metadataCache = new Map();
+    #dependencyCache = null;
+    /**
+     * Creates a new `PackageManager` instance.
+     * @param host A `Host` instance for interacting with the file system and running commands.
+     * @param cwd The absolute path to the project's working directory.
+     * @param descriptor A `PackageManagerDescriptor` that defines the commands for a specific package manager.
+     * @param options An options object to configure the instance.
+     */
+    constructor(host, cwd, descriptor, options = {}) {
+        this.host = host;
+        this.cwd = cwd;
+        this.descriptor = descriptor;
+        this.options = options;
+        if (this.options.dryRun && !this.options.logger) {
+            throw new Error('A logger must be provided when dryRun is enabled.');
+        }
+    }
+    /**
+     * The name of the package manager's binary.
+     */
+    get name() {
+        return this.descriptor.binary;
+    }
+    /**
+     * A private method to lazily populate the dependency cache.
+     * This is a performance optimization to avoid running `npm list` multiple times.
+     * @returns A promise that resolves to the dependency cache map.
+     */
+    async #populateDependencyCache() {
+        if (this.#dependencyCache !== null) {
+            return this.#dependencyCache;
+        }
+        const args = this.descriptor.listDependenciesCommand;
+        const dependencies = await this.#fetchAndParse(args, (stdout, logger) => this.descriptor.outputParsers.listDependencies(stdout, logger));
+        return (this.#dependencyCache = dependencies ?? new Map());
+    }
+    /**
+     * A private method to run a command using the package manager's binary.
+     * @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.
+     */
+    async #run(args, options = {}) {
+        const { registry, cwd, ...runOptions } = options;
+        const finalArgs = [...args];
+        let finalEnv;
+        if (registry) {
+            const registryOptions = this.descriptor.getRegistryOptions?.(registry);
+            if (!registryOptions) {
+                throw new Error(`The configured package manager, '${this.descriptor.binary}', does not support a custom registry.`);
+            }
+            if (registryOptions.args) {
+                finalArgs.push(...registryOptions.args);
+            }
+            if (registryOptions.env) {
+                finalEnv = registryOptions.env;
+            }
+        }
+        const executionDirectory = cwd ?? this.cwd;
+        if (this.options.dryRun) {
+            this.options.logger?.info(`[DRY RUN] Would execute in [${executionDirectory}]: ${this.descriptor.binary} ${finalArgs.join(' ')}`);
+            return { stdout: '', stderr: '' };
+        }
+        return this.host.runCommand(this.descriptor.binary, finalArgs, {
+            ...runOptions,
+            cwd: executionDirectory,
+            stdio: 'pipe',
+            env: finalEnv,
+        });
+    }
+    /**
+     * A private, generic method to encapsulate the common logic of running a command,
+     * handling errors, and parsing the output.
+     * @param args The arguments to pass to the command.
+     * @param parser A function that parses the command's stdout.
+     * @param options Options for the command, including caching.
+     * @returns A promise that resolves to the parsed data, or null if not found.
+     */
+    async #fetchAndParse(args, parser, options = {}) {
+        const { cache, cacheKey, bypassCache, ...runOptions } = options;
+        if (!bypassCache && cache && cacheKey && cache.has(cacheKey)) {
+            return cache.get(cacheKey);
+        }
+        let stdout;
+        let stderr;
+        try {
+            ({ stdout, stderr } = await this.#run(args, runOptions));
+        }
+        catch (e) {
+            if (e instanceof error_1.PackageManagerError && typeof e.exitCode === 'number' && e.exitCode !== 0) {
+                // Some package managers exit with a non-zero code when the package is not found.
+                if (cache && cacheKey) {
+                    cache.set(cacheKey, null);
+                }
+                return null;
+            }
+            throw e;
+        }
+        try {
+            const result = parser(stdout, this.options.logger);
+            if (cache && cacheKey) {
+                cache.set(cacheKey, result);
+            }
+            return result;
+        }
+        catch (e) {
+            const message = `Failed to parse package manager output: ${e instanceof Error ? e.message : ''}`;
+            throw new error_1.PackageManagerError(message, stdout, stderr, 0);
+        }
+    }
+    /**
+     * Adds a package to the project's dependencies.
+     * @param packageName The name of the package to add.
+     * @param save The save strategy to use.
+     * - `exact`: The package will be saved with an exact version.
+     * - `tilde`: The package will be saved with a tilde version range (`~`).
+     * - `none`: The package will be saved with the default version range (`^`).
+     * @param asDevDependency Whether to install the package as a dev dependency.
+     * @param noLockfile Whether to skip updating the lockfile.
+     * @param options Extra options for the command.
+     * @returns A promise that resolves when the command is complete.
+     */
+    async add(packageName, save, asDevDependency, noLockfile, ignoreScripts, options = {}) {
+        const flags = [
+            asDevDependency ? this.descriptor.saveDevFlag : '',
+            save === 'exact' ? this.descriptor.saveExactFlag : '',
+            save === 'tilde' ? this.descriptor.saveTildeFlag : '',
+            noLockfile ? this.descriptor.noLockfileFlag : '',
+            ignoreScripts ? this.descriptor.ignoreScriptsFlag : '',
+        ].filter((flag) => flag);
+        const args = [this.descriptor.addCommand, packageName, ...flags];
+        await this.#run(args, options);
+        this.#dependencyCache = null;
+    }
+    /**
+     * Installs all dependencies in the project.
+     * @param options Options for the installation.
+     * @param options.timeout The maximum time in milliseconds to wait for the command to complete.
+     * @param options.force If true, forces a clean install, potentially overwriting existing modules.
+     * @param options.registry The registry to use for the installation.
+     * @param options.ignoreScripts If true, prevents lifecycle scripts from being executed.
+     * @returns A promise that resolves when the command is complete.
+     */
+    async install(options = { ignoreScripts: true }) {
+        const flags = [
+            options.force ? this.descriptor.forceFlag : '',
+            options.ignoreScripts ? this.descriptor.ignoreScriptsFlag : '',
+        ].filter((flag) => flag);
+        const args = [...this.descriptor.installCommand, ...flags];
+        await this.#run(args, options);
+        this.#dependencyCache = null;
+    }
+    /**
+     * Gets the version of the package manager binary.
+     * @returns A promise that resolves to the trimmed version string.
+     */
+    async getVersion() {
+        const { stdout } = await this.#run(this.descriptor.versionCommand);
+        return stdout.trim();
+    }
+    /**
+     * Gets the installed details of a package from the project's dependencies.
+     * @param packageName The name of the package to check.
+     * @returns A promise that resolves to the installed package details, or `null` if the package is not installed.
+     */
+    async getInstalledPackage(packageName) {
+        const cache = await this.#populateDependencyCache();
+        return cache.get(packageName) ?? null;
+    }
+    /**
+     * Gets a map of all top-level dependencies installed in the project.
+     * @returns A promise that resolves to a map of package names to their installed package details.
+     */
+    async getProjectDependencies() {
+        const cache = await this.#populateDependencyCache();
+        // Return a copy to prevent external mutations of the cache.
+        return new Map(cache);
+    }
+    /**
+     * Fetches the registry metadata for a package. This is the full metadata,
+     * including all versions and distribution tags.
+     * @param packageName The name of the package to fetch the metadata for.
+     * @param options Options for the fetch.
+     * @param options.timeout The maximum time in milliseconds to wait for the command to complete.
+     * @param options.registry The registry to use for the fetch.
+     * @param options.bypassCache If true, ignores the in-memory cache and fetches fresh data.
+     * @returns A promise that resolves to the `PackageMetadata` object, or `null` if the package is not found.
+     */
+    async getRegistryMetadata(packageName, options = {}) {
+        const commandArgs = [...this.descriptor.getManifestCommand, packageName];
+        const formatter = this.descriptor.viewCommandFieldArgFormatter;
+        if (formatter) {
+            commandArgs.push(...formatter(METADATA_FIELDS));
+        }
+        const cacheKey = options.registry ? `${packageName}|${options.registry}` : packageName;
+        return this.#fetchAndParse(commandArgs, (stdout, logger) => this.descriptor.outputParsers.getRegistryMetadata(stdout, logger), { ...options, cache: this.#metadataCache, cacheKey });
+    }
+    /**
+     * Fetches the registry manifest for a specific version of a package.
+     * The manifest is similar to the package's `package.json` file.
+     * @param packageName The name of the package to fetch the manifest for.
+     * @param version The version of the package to fetch the manifest for.
+     * @param options Options for the fetch.
+     * @param options.timeout The maximum time in milliseconds to wait for the command to complete.
+     * @param options.registry The registry to use for the fetch.
+     * @param options.bypassCache If true, ignores the in-memory cache and fetches fresh data.
+     * @returns A promise that resolves to the `PackageManifest` object, or `null` if the package is not found.
+     */
+    async getPackageManifest(packageName, version, options = {}) {
+        const specifier = `${packageName}@${version}`;
+        const commandArgs = [...this.descriptor.getManifestCommand, specifier];
+        const formatter = this.descriptor.viewCommandFieldArgFormatter;
+        if (formatter) {
+            commandArgs.push(...formatter(MANIFEST_FIELDS));
+        }
+        const cacheKey = options.registry ? `${specifier}|${options.registry}` : specifier;
+        return this.#fetchAndParse(commandArgs, (stdout, logger) => this.descriptor.outputParsers.getPackageManifest(stdout, logger), { ...options, cache: this.#manifestCache, cacheKey });
+    }
+    /**
+     * Acquires a package by installing it into a temporary directory. The caller is
+     * responsible for managing the lifecycle of the temporary directory by calling
+     * the returned `cleanup` function.
+     *
+     * @param packageName The name of the package to install.
+     * @param options Options for the installation.
+     * @returns A promise that resolves to an object containing the temporary path
+     *   and a cleanup function.
+     */
+    async acquireTempPackage(packageName, options = {}) {
+        const workingDirectory = await this.host.createTempDirectory();
+        const cleanup = () => this.host.deleteDirectory(workingDirectory);
+        // Some package managers, like yarn classic, do not write a package.json when adding a package.
+        // This can cause issues with subsequent `require.resolve` calls.
+        // Writing an empty package.json file beforehand prevents this.
+        await this.host.writeFile((0, node_path_1.join)(workingDirectory, 'package.json'), '{}');
+        const args = [this.descriptor.addCommand, packageName];
+        try {
+            await this.#run(args, { ...options, cwd: workingDirectory });
+        }
+        catch (e) {
+            // If the command fails, clean up the temporary directory immediately.
+            await cleanup();
+            throw e;
+        }
+        return { workingDirectory, cleanup };
+    }
+}
+exports.PackageManager = PackageManager;
+//# sourceMappingURL=package-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["package-manager.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;GAIG;AAEH,yCAAiC;AACjC,mCAA8C;AAO9C;;;;GAIG;AACH,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAE3E;;;;GAIG;AACH,MAAM,eAAe,GAAG;IACtB,MAAM;IACN,SAAS;IACT,YAAY;IACZ,cAAc;IACd,kBAAkB;IAClB,iBAAiB;IACjB,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,WAAW;CACH,CAAC;AAgBX;;;;;;;GAOG;AACH,MAAa,cAAc;IAaN;IACA;IACA;IACA;IAfV,cAAc,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC3D,cAAc,GAAG,IAAI,GAAG,EAAkC,CAAC;IACpE,gBAAgB,GAAyC,IAAI,CAAC;IAE9D;;;;;;OAMG;IACH,YACmB,IAAU,EACV,GAAW,EACX,UAAoC,EACpC,UAAiC,EAAE;QAHnC,SAAI,GAAJ,IAAI,CAAM;QACV,QAAG,GAAH,GAAG,CAAQ;QACX,eAAU,GAAV,UAAU,CAA0B;QACpC,YAAO,GAAP,OAAO,CAA4B;QAEpD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,wBAAwB;QAC5B,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,gBAAgB,CAAC;QAC/B,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC;QAErD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CACtE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAC/D,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,gBAAgB,GAAG,YAAY,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CACR,IAAuB,EACvB,UAAiE,EAAE;QAEnE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;QACjD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5B,IAAI,QAA4C,CAAC;QAEjD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,CAAC;YACvE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,oCAAoC,IAAI,CAAC,UAAU,CAAC,MAAM,wCAAwC,CACnG,CAAC;YACJ,CAAC;YAED,IAAI,eAAe,CAAC,IAAI,EAAE,CAAC;gBACzB,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,eAAe,CAAC,GAAG,EAAE,CAAC;gBACxB,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,kBAAkB,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QAC3C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CACvB,+BAA+B,kBAAkB,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACvG,CAAC;YAEF,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE;YAC7D,GAAG,UAAU;YACb,GAAG,EAAE,kBAAkB;YACvB,KAAK,EAAE,MAAM;YACb,GAAG,EAAE,QAAQ;SACd,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,IAAuB,EACvB,MAAqD,EACrD,UAMI,EAAE;QAEN,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;QAEhE,IAAI,CAAC,WAAW,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAa,CAAC;QACzC,CAAC;QAED,IAAI,MAAM,CAAC;QACX,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,2BAAmB,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC3F,iFAAiF;gBACjF,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;oBACtB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC5B,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnD,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;gBACtB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9B,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,2CACd,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACnC,EAAE,CAAC;YACH,MAAM,IAAI,2BAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CACP,WAAmB,EACnB,IAAgC,EAChC,eAAwB,EACxB,UAAmB,EACnB,aAAsB,EACtB,UAAiC,EAAE;QAEnC,MAAM,KAAK,GAAG;YACZ,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;YAClD,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE;YACrD,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE;YACrD,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE;YAChD,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE;SACvD,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAEzB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE/B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CACX,UAKI,EAAE,aAAa,EAAE,IAAI,EAAE;QAE3B,MAAM,KAAK,GAAG;YACZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;YAC9C,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE;SAC/D,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,GAAG,KAAK,CAAC,CAAC;QAE3D,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE/B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAEnE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAEpD,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB;QAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAEpD,4DAA4D;QAC5D,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CACvB,WAAmB,EACnB,UAA0E,EAAE;QAE5E,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,4BAA4B,CAAC;QAC/D,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;QAEvF,OAAO,IAAI,CAAC,cAAc,CACxB,WAAW,EACX,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,EACrF,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,CACrD,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB,CACtB,WAAmB,EACnB,OAAe,EACf,UAA0E,EAAE;QAE5E,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,4BAA4B,CAAC;QAC/D,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAEnF,OAAO,IAAI,CAAC,cAAc,CACxB,WAAW,EACX,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,EACpF,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,CACrD,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACtB,WAAmB,EACnB,UAAiC,EAAE;QAEnC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC/D,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;QAElE,+FAA+F;QAC/F,iEAAiE;QACjE,+DAA+D;QAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAA,gBAAI,EAAC,gBAAgB,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;QAExE,MAAM,IAAI,GAAsB,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAE1E,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,sEAAsE;YACtE,MAAM,OAAO,EAAE,CAAC;YAChB,MAAM,CAAC,CAAC;QACV,CAAC;QAED,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;CACF;AArVD,wCAqVC"}

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

@@ -0,0 +1,87 @@
+/**
+ * @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 core interfaces for package metadata and manifests,
+ * providing a strongly-typed representation of the data returned by a package
+ * manager registry. These interfaces are crucial for features like `ng add`
+ * and `ng update`.
+ */
+/**
+ * Defines how a package's dependencies should be saved to `package.json`
+ * after being installed by the `ng add` command.
+ *
+ * - `dependencies`: Save to the `dependencies` section.
+ * - `devDependencies`: Save to the `devDependencies` section.
+ * - `false`: Do not save to `package.json`.
+ */
+export type NgAddSaveDependency = 'dependencies' | 'devDependencies' | false;
+/**
+ * Represents the configuration for `ng add` found in a package's manifest.
+ */
+export interface NgAdd {
+    /**
+     * Specifies how the package should be saved to `package.json`.
+     * @see NgAddSaveDependency
+     */
+    save?: NgAddSaveDependency;
+}
+/**
+ * Represents the configuration for `ng update` found in a package's manifest.
+ */
+export interface NgUpdate {
+    /**
+     * The path to the schematics collection for migrations.
+     */
+    migrations?: string;
+    /**
+     * A list of package names that should be updated together.
+     */
+    packageGroup?: string[];
+}
+/**
+ * Represents the full metadata for a package available in the registry.
+ * This includes a list of all available versions and distribution tags.
+ */
+export interface PackageMetadata {
+    /** The name of the package. */
+    name: string;
+    /** A mapping of distribution tags (e.g., 'latest', 'next') to version numbers. */
+    'dist-tags': Record<string, string>;
+    /** An array of all available version strings for the package. */
+    versions: string[];
+    /** A mapping of version numbers to their ISO 8601 publication time string. */
+    time?: Record<string, string>;
+}
+/**
+ * Represents the manifest (similar to `package.json`) for a specific version of a package.
+ * It contains metadata essential for the Angular CLI to perform operations like
+ * `ng add` and `ng update`.
+ */
+export interface PackageManifest {
+    /** The name of the package. */
+    name: string;
+    /** The version of the package. */
+    version: string;
+    /** A message indicating that the package version is deprecated. */
+    deprecated?: string;
+    /** A mapping of production dependencies. */
+    dependencies?: Record<string, string>;
+    /** A mapping of peer dependencies. */
+    peerDependencies?: Record<string, string>;
+    /** A mapping of development dependencies. */
+    devDependencies?: Record<string, string>;
+    /** The URL to the package's homepage. */
+    homepage?: string;
+    /** The path to the schematics collection definition, used by `ng generate`. */
+    schematics?: string;
+    /** Configuration for the `ng add` command. */
+    'ng-add'?: NgAdd;
+    /** Configuration for the `ng update` command. */
+    'ng-update'?: NgUpdate;
+}

package/src/package-managers/package-metadata.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=package-metadata.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * @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 interfaces for representing a project's installed
+ * package dependency tree.
+ */
+/**
+ * Represents a package that is installed in the project's node_modules.
+ */
+export interface InstalledPackage {
+    /** The name of the package. */
+    readonly name: string;
+    /** The installed version of the package. */
+    readonly version: string;
+    /** The absolute path to the package's directory on disk, if available. */
+    readonly path?: string;
+}

package/src/package-managers/package-tree.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=package-tree.js.map

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

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

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

@@ -0,0 +1,92 @@
+/**
+ * @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 contains the parser functions that are used to
+ * interpret the output of various package manager commands. Separating these
+ * into their own file improves modularity and allows for focused testing.
+ */
+import { Logger } from './logger';
+import { PackageManifest, PackageMetadata } from './package-metadata';
+import { InstalledPackage } from './package-tree';
+/**
+ * Parses the output of `npm list` or a compatible command.
+ *
+ * The expected JSON structure is:
+ * ```json
+ * {
+ *   "dependencies": {
+ *     "@angular/cli": {
+ *       "version": "18.0.0",
+ *       "path": "/path/to/project/node_modules/@angular/cli", // path is optional
+ *       ... (other package.json properties)
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns A map of package names to their installed package details.
+ */
+export declare function parseNpmLikeDependencies(stdout: string, logger?: Logger): Map<string, InstalledPackage>;
+/**
+ * Parses the output of `yarn list` (classic).
+ *
+ * The expected output is a JSON stream (JSONL), where each line is a JSON object.
+ * The relevant object has a `type` of `'tree'`.
+ * Yarn classic does not provide a path, so the `path` property will be `undefined`.
+ *
+ * ```json
+ * {"type":"tree","data":{"trees":[{"name":"@angular/cli@18.0.0","children":[]}]}}
+ * ```
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns A map of package names to their installed package details.
+ */
+export declare function parseYarnClassicDependencies(stdout: string, logger?: Logger): Map<string, InstalledPackage>;
+/**
+ * Parses the output of `yarn list` (modern).
+ *
+ * The expected JSON structure is a single object.
+ * Yarn modern does not provide a path, so the `path` property will be `undefined`.
+ *
+ * ```json
+ * {
+ *   "trees": [
+ *     { "name": "@angular/cli@18.0.0", "children": [] }
+ *   ]
+ * }
+ * ```
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns A map of package names to their installed package details.
+ */
+export declare function parseYarnModernDependencies(stdout: string, logger?: Logger): Map<string, InstalledPackage>;
+/**
+ * Parses the output of `npm view` or a compatible command to get a package manifest.
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns The package manifest object.
+ */
+export declare function parseNpmLikeManifest(stdout: string, logger?: Logger): PackageManifest | null;
+/**
+ * Parses the output of `npm view` or a compatible command to get package metadata.
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns The package metadata object.
+ */
+export declare function parseNpmLikeMetadata(stdout: string, logger?: Logger): PackageMetadata | null;
+/**
+ * Parses the output of `yarn info` (classic).
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns The package manifest object.
+ */
+export declare function parseYarnLegacyManifest(stdout: string, logger?: Logger): PackageManifest | null;