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

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[];

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>;
+    }>;
+}