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

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

@@ -0,0 +1,147 @@
+"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.PACKAGE_MANAGER_PRECEDENCE = exports.SUPPORTED_PACKAGE_MANAGERS = void 0;
+const parsers_1 = require("./parsers");
+/**
+ * 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.
+ */
+exports.SUPPORTED_PACKAGE_MANAGERS = {
+    npm: {
+        binary: 'npm',
+        lockfiles: ['package-lock.json', 'npm-shrinkwrap.json'],
+        addCommand: 'install',
+        installCommand: ['install'],
+        forceFlag: '--force',
+        saveExactFlag: '--save-exact',
+        saveTildeFlag: '--save-tilde',
+        saveDevFlag: '--save-dev',
+        noLockfileFlag: '--no-package-lock',
+        ignoreScriptsFlag: '--ignore-scripts',
+        getRegistryOptions: (registry) => ({ args: ['--registry', registry] }),
+        versionCommand: ['--version'],
+        listDependenciesCommand: ['list', '--depth=0', '--json=true', '--all=true'],
+        getManifestCommand: ['view', '--json'],
+        viewCommandFieldArgFormatter: (fields) => [...fields],
+        outputParsers: {
+            listDependencies: parsers_1.parseNpmLikeDependencies,
+            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+        },
+    },
+    yarn: {
+        binary: 'yarn',
+        lockfiles: ['yarn.lock'],
+        addCommand: 'add',
+        installCommand: ['install'],
+        forceFlag: '--force',
+        saveExactFlag: '--exact',
+        saveTildeFlag: '--tilde',
+        saveDevFlag: '--dev',
+        noLockfileFlag: '--no-lockfile',
+        ignoreScriptsFlag: '--ignore-scripts',
+        getRegistryOptions: (registry) => ({ env: { NPM_CONFIG_REGISTRY: registry } }),
+        versionCommand: ['--version'],
+        listDependenciesCommand: ['list', '--depth=0', '--json', '--recursive=false'],
+        getManifestCommand: ['npm', 'info', '--json'],
+        viewCommandFieldArgFormatter: (fields) => ['--fields', fields.join(',')],
+        outputParsers: {
+            listDependencies: parsers_1.parseYarnModernDependencies,
+            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+        },
+    },
+    'yarn-classic': {
+        binary: 'yarn',
+        // This is intentionally empty. `yarn-classic` is not a discoverable package manager.
+        // The discovery process finds `yarn` via `yarn.lock`, and the factory logic
+        // determines whether it is classic or modern by checking the installed version.
+        lockfiles: [],
+        addCommand: 'add',
+        installCommand: ['install'],
+        forceFlag: '--force',
+        saveExactFlag: '--exact',
+        saveTildeFlag: '--tilde',
+        saveDevFlag: '--dev',
+        noLockfileFlag: '--no-lockfile',
+        ignoreScriptsFlag: '--ignore-scripts',
+        getRegistryOptions: (registry) => ({ args: ['--registry', registry] }),
+        versionCommand: ['--version'],
+        listDependenciesCommand: ['list', '--depth=0', '--json'],
+        getManifestCommand: ['info', '--json'],
+        outputParsers: {
+            listDependencies: parsers_1.parseYarnClassicDependencies,
+            getPackageManifest: parsers_1.parseYarnLegacyManifest,
+            getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+        },
+    },
+    pnpm: {
+        binary: 'pnpm',
+        lockfiles: ['pnpm-lock.yaml'],
+        addCommand: 'add',
+        installCommand: ['install'],
+        forceFlag: '--force',
+        saveExactFlag: '--save-exact',
+        saveTildeFlag: '--save-tilde',
+        saveDevFlag: '--save-dev',
+        noLockfileFlag: '--no-lockfile',
+        ignoreScriptsFlag: '--ignore-scripts',
+        getRegistryOptions: (registry) => ({ args: ['--registry', registry] }),
+        versionCommand: ['--version'],
+        listDependenciesCommand: ['list', '--depth=0', '--json'],
+        getManifestCommand: ['view', '--json'],
+        viewCommandFieldArgFormatter: (fields) => [...fields],
+        outputParsers: {
+            listDependencies: parsers_1.parseNpmLikeDependencies,
+            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+        },
+    },
+    bun: {
+        binary: 'bun',
+        lockfiles: ['bun.lockb', 'bun.lock'],
+        addCommand: 'add',
+        installCommand: ['install'],
+        forceFlag: '--force',
+        saveExactFlag: '--exact',
+        saveTildeFlag: '', // Bun does not have a flag for tilde, it defaults to caret.
+        saveDevFlag: '--development',
+        noLockfileFlag: '', // Bun does not have a flag for this.
+        ignoreScriptsFlag: '--ignore-scripts',
+        getRegistryOptions: (registry) => ({ args: ['--registry', registry] }),
+        versionCommand: ['--version'],
+        listDependenciesCommand: ['pm', 'ls', '--json'],
+        getManifestCommand: ['pm', 'view', '--json'],
+        viewCommandFieldArgFormatter: (fields) => [...fields],
+        outputParsers: {
+            listDependencies: parsers_1.parseNpmLikeDependencies,
+            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+        },
+    },
+};
+/**
+ * The order of precedence for package managers.
+ * This is a best-effort ordering based on estimated Angular community usage and default presence.
+ */
+exports.PACKAGE_MANAGER_PRECEDENCE = [
+    'pnpm',
+    'yarn',
+    'bun',
+    'npm',
+];
+//# sourceMappingURL=package-manager-descriptor.js.map

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

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

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

@@ -0,0 +1,144 @@
+/**
+ * @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 { Host } from './host';
+import { Logger } from './logger';
+import { PackageManagerDescriptor } from './package-manager-descriptor';
+import { PackageManifest, PackageMetadata } from './package-metadata';
+import { InstalledPackage } from './package-tree';
+/**
+ * Options to configure the `PackageManager` instance.
+ */
+export interface PackageManagerOptions {
+    /**
+     * If true, no commands will be executed, but they will be logged to the logger.
+     * A logger must be provided if this is true.
+     */
+    dryRun?: boolean;
+    /** A logger instance for debugging and dry run output. */
+    logger?: Logger;
+}
+/**
+ * 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.
+ */
+export declare class PackageManager {
+    #private;
+    private readonly host;
+    private readonly cwd;
+    private readonly descriptor;
+    private readonly options;
+    /**
+     * 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: Host, cwd: string, descriptor: PackageManagerDescriptor, options?: PackageManagerOptions);
+    /**
+     * The name of the package manager's binary.
+     */
+    get name(): string;
+    /**
+     * 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.
+     */
+    add(packageName: string, save: 'exact' | 'tilde' | 'none', asDevDependency: boolean, noLockfile: boolean, ignoreScripts: boolean, options?: {
+        registry?: string;
+    }): Promise<void>;
+    /**
+     * 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.
+     */
+    install(options?: {
+        timeout?: number;
+        force?: boolean;
+        registry?: string;
+        ignoreScripts?: boolean;
+    }): Promise<void>;
+    /**
+     * Gets the version of the package manager binary.
+     * @returns A promise that resolves to the trimmed version string.
+     */
+    getVersion(): Promise<string>;
+    /**
+     * 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.
+     */
+    getInstalledPackage(packageName: string): Promise<InstalledPackage | 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.
+     */
+    getProjectDependencies(): Promise<Map<string, InstalledPackage>>;
+    /**
+     * 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.
+     */
+    getRegistryMetadata(packageName: string, options?: {
+        timeout?: number;
+        registry?: string;
+        bypassCache?: boolean;
+    }): Promise<PackageMetadata | null>;
+    /**
+     * 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.
+     */
+    getPackageManifest(packageName: string, version: string, options?: {
+        timeout?: number;
+        registry?: string;
+        bypassCache?: boolean;
+    }): Promise<PackageManifest | null>;
+    /**
+     * 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.
+     */
+    acquireTempPackage(packageName: string, options?: {
+        registry?: string;
+    }): Promise<{
+        workingDirectory: string;
+        cleanup: () => Promise<void>;
+    }>;
+}

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":"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"}