@depup/angular__cli 21.2.1-depup.1

package/src/commands/version/version-info.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @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 { CommandContext } from '../../command-builder/definitions';
+/**
+ * An object containing version information for a single package.
+ */
+export interface PackageVersionInfo {
+    requested: string;
+    installed: string;
+}
+/**
+ * An object containing all the version information that will be displayed by the command.
+ */
+export interface VersionInfo {
+    cli: {
+        version: string;
+    };
+    framework: {
+        version: string | undefined;
+    };
+    system: {
+        node: {
+            version: string;
+            unsupported: boolean;
+        };
+        os: {
+            platform: string;
+            architecture: string;
+        };
+        packageManager: {
+            name: string;
+            version: string | undefined;
+        };
+    };
+    packages: Record<string, PackageVersionInfo>;
+}
+/**
+ * Gathers all the version information from the environment and workspace.
+ * @returns An object containing all the version information.
+ */
+export declare function gatherVersionInfo(context: CommandContext): Promise<VersionInfo>;

package/src/commands/version/version-info.js

@@ -0,0 +1,107 @@
+"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.gatherVersionInfo = gatherVersionInfo;
+const node_module_1 = require("node:module");
+const version_1 = require("../../utilities/version");
+/**
+ * Major versions of Node.js that are officially supported by Angular.
+ * @see https://angular.dev/reference/versions#supported-node-js-versions
+ */
+const SUPPORTED_NODE_MAJORS = [20, 22, 24];
+/**
+ * A list of regular expression patterns that match package names that should be included in the
+ * version output.
+ */
+const PACKAGE_PATTERNS = [
+    /^@angular\/.*/,
+    /^@angular-devkit\/.*/,
+    /^@ngtools\/.*/,
+    /^@schematics\/.*/,
+    /^rxjs$/,
+    /^typescript$/,
+    /^ng-packagr$/,
+    /^vitest$/,
+    /^webpack$/,
+    /^zone\.js$/,
+];
+/**
+ * Gathers all the version information from the environment and workspace.
+ * @returns An object containing all the version information.
+ */
+async function gatherVersionInfo(context) {
+    // Trailing slash is used to allow the path to be treated as a directory
+    const workspaceRequire = (0, node_module_1.createRequire)(context.root + '/');
+    let workspacePackage;
+    try {
+        workspacePackage = workspaceRequire('./package.json');
+    }
+    catch { }
+    const [nodeMajor] = process.versions.node.split('.').map((part) => Number(part));
+    const unsupportedNodeVersion = !SUPPORTED_NODE_MAJORS.includes(nodeMajor);
+    const allDependencies = {
+        ...workspacePackage?.dependencies,
+        ...workspacePackage?.devDependencies,
+    };
+    const packageNames = new Set(Object.keys(allDependencies));
+    const packages = {};
+    for (const name of packageNames) {
+        if (PACKAGE_PATTERNS.some((p) => p.test(name))) {
+            packages[name] = {
+                requested: allDependencies[name] ?? 'error',
+                installed: getVersion(name, workspaceRequire),
+            };
+        }
+    }
+    const angularCoreVersion = packages['@angular/core'];
+    return {
+        cli: {
+            version: version_1.VERSION.full,
+        },
+        framework: {
+            version: angularCoreVersion?.installed,
+        },
+        system: {
+            node: {
+                version: process.versions.node,
+                unsupported: unsupportedNodeVersion,
+            },
+            os: {
+                platform: process.platform,
+                architecture: process.arch,
+            },
+            packageManager: {
+                name: context.packageManager.name,
+                version: await context.packageManager.getVersion(),
+            },
+        },
+        packages,
+    };
+}
+/**
+ * Gets the version of a package.
+ * @param moduleName The name of the package.
+ * @param workspaceRequire A `require` function for the workspace.
+ * @param localRequire A `require` function for the CLI.
+ * @returns The version of the package, or `<error>` if it could not be found.
+ */
+function getVersion(moduleName, workspaceRequire) {
+    let packageInfo;
+    // Try to find the package in the workspace
+    try {
+        packageInfo = workspaceRequire(`${moduleName}/package.json`);
+    }
+    catch { }
+    // If found, attempt to get the version
+    if (packageInfo) {
+        return packageInfo.version;
+    }
+    return '<error>';
+}
+//# sourceMappingURL=version-info.js.map

package/src/commands/version/version-info.js.map

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

package/src/package-managers/discovery.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
+ */
+import { Host } from './host';
+import { Logger } from './logger';
+import { PackageManagerName } from './package-manager-descriptor';
+/**
+ * Discovers the package manager used in a project by searching for lockfiles.
+ *
+ * This function searches for lockfiles in the given directory and its ancestors.
+ * If multiple lockfiles are found, it uses the precedence array to determine
+ * which package manager to use. The search is bounded by the git repository root.
+ *
+ * @param host A `Host` instance for interacting with the file system.
+ * @param startDir The directory to start the search from.
+ * @param logger An optional logger instance.
+ * @returns A promise that resolves to the name of the discovered package manager, or null if none is found.
+ */
+export declare function discover(host: Host, startDir: string, logger?: Logger): Promise<PackageManagerName | null>;

package/src/package-managers/discovery.js

@@ -0,0 +1,104 @@
+"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.discover = discover;
+/**
+ * @fileoverview This file contains the logic for discovering the package manager
+ * used in a project by searching for lockfiles. It is designed to be efficient
+ * and to correctly handle monorepo structures.
+ */
+const node_path_1 = require("node:path");
+const package_manager_descriptor_1 = require("./package-manager-descriptor");
+/**
+ * Searches a directory for lockfiles and returns a set of package managers that correspond to them.
+ * @param host A `Host` instance for interacting with the file system.
+ * @param directory The directory to search.
+ * @param logger An optional logger instance.
+ * @returns A promise that resolves to a set of package manager names.
+ */
+async function findLockfiles(host, directory, logger) {
+    logger?.debug(`Searching for lockfiles in '${directory}'...`);
+    const foundPackageManagers = new Set();
+    const checks = [];
+    for (const [name, descriptor] of Object.entries(package_manager_descriptor_1.SUPPORTED_PACKAGE_MANAGERS)) {
+        const manager = name;
+        for (const lockfile of descriptor.lockfiles) {
+            checks.push((async () => {
+                try {
+                    const path = (0, node_path_1.join)(directory, lockfile);
+                    const stats = await host.stat(path);
+                    if (stats.isFile()) {
+                        logger?.debug(`  Found '${lockfile}'.`);
+                        foundPackageManagers.add(manager);
+                    }
+                }
+                catch {
+                    // File does not exist or cannot be accessed.
+                }
+            })());
+        }
+    }
+    await Promise.all(checks);
+    return foundPackageManagers;
+}
+/**
+ * Checks if a given path is a directory.
+ * @param host A `Host` instance for interacting with the file system.
+ * @param path The path to check.
+ * @returns A promise that resolves to true if the path is a directory, false otherwise.
+ */
+async function isDirectory(host, path) {
+    try {
+        return (await host.stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Discovers the package manager used in a project by searching for lockfiles.
+ *
+ * This function searches for lockfiles in the given directory and its ancestors.
+ * If multiple lockfiles are found, it uses the precedence array to determine
+ * which package manager to use. The search is bounded by the git repository root.
+ *
+ * @param host A `Host` instance for interacting with the file system.
+ * @param startDir The directory to start the search from.
+ * @param logger An optional logger instance.
+ * @returns A promise that resolves to the name of the discovered package manager, or null if none is found.
+ */
+async function discover(host, startDir, logger) {
+    logger?.debug(`Starting package manager discovery in '${startDir}'...`);
+    let currentDir = startDir;
+    while (true) {
+        const found = await findLockfiles(host, currentDir, logger);
+        if (found.size > 0) {
+            logger?.debug(`Found lockfile(s): [${[...found].join(', ')}]. Applying precedence...`);
+            for (const packageManager of package_manager_descriptor_1.PACKAGE_MANAGER_PRECEDENCE) {
+                if (found.has(packageManager)) {
+                    logger?.debug(`Selected '${packageManager}' based on precedence.`);
+                    return packageManager;
+                }
+            }
+        }
+        // Stop searching if we reach the git repository root.
+        if (await isDirectory(host, (0, node_path_1.join)(currentDir, '.git'))) {
+            logger?.debug(`Reached repository root at '${currentDir}'. Stopping search.`);
+            return null;
+        }
+        const parentDir = (0, node_path_1.dirname)(currentDir);
+        if (parentDir === currentDir) {
+            // We have reached the filesystem root.
+            logger?.debug('Reached filesystem root. No lockfile found.');
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+//# sourceMappingURL=discovery.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * @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);
+}
+/**
+ * Represents structured information about an error returned by a package manager command.
+ * This is a data interface, not an `Error` subclass.
+ */
+export interface ErrorInfo {
+    /** A specific error code (e.g. 'E404', 'EACCES'). */
+    readonly code: string;
+    /** A short, human-readable summary of the error. */
+    readonly summary: string;
+    /** An optional, detailed description of the error. */
+    readonly detail?: string;
+}

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,30 @@
+/**
+ * @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';
+/**
+ * Information about the package manager to use for a given project.
+ */
+export type ConfiguredPackageManagerInfo = [name?: PackageManagerName, version?: string];
+/**
+ * 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?: ConfiguredPackageManagerInfo;
+    logger?: Logger;
+    dryRun?: boolean;
+    tempDirectory?: string;
+}): Promise<PackageManager>;

package/src/package-managers/factory.js

@@ -0,0 +1,137 @@
+"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
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPackageManager = createPackageManager;
+const strict_1 = __importDefault(require("node:assert/strict"));
+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 the package manager.
+ * @param host A `Host` instance for running commands.
+ * @param cwd The absolute path to the working directory.
+ * @param name The name of the package manager.
+ * @param logger An optional logger instance.
+ * @returns A promise that resolves to the version string.
+ */
+async function getPackageManagerVersion(host, cwd, name, logger) {
+    const descriptor = package_manager_descriptor_1.SUPPORTED_PACKAGE_MANAGERS[name];
+    logger?.debug(`Getting ${name} version...`);
+    const { stdout } = await host.runCommand(descriptor.binary, descriptor.versionCommand, { cwd });
+    const version = stdout.trim();
+    logger?.debug(`${name} version is '${version}'.`);
+    return version;
+}
+/**
+ * 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, version] = configured;
+    let source;
+    if (name) {
+        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) {
+        strict_1.default.deepStrictEqual(package_manager_descriptor_1.SUPPORTED_PACKAGE_MANAGERS.yarn.versionCommand, package_manager_descriptor_1.SUPPORTED_PACKAGE_MANAGERS['yarn-classic'].versionCommand, 'Yarn and Yarn Classic version commands must match for detection logic to be valid.');
+        try {
+            version ??= await getPackageManagerVersion(host, cwd, name, logger);
+            if (version && (0, semver_1.major)(version) < 2) {
+                name = 'yarn-classic';
+                logger?.debug(`Detected yarn classic. Using 'yarn-classic'.`);
+            }
+        }
+        catch {
+            logger?.debug('Failed to get yarn version.');
+        }
+    }
+    else if (name === 'yarn') {
+        logger?.debug('Skipping yarn version check due to dry run. Assuming modern yarn.');
+    }
+    return { name, source, version };
+}
+/**
+ * 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, tempDirectory } = options;
+    const host = host_1.NodeJS_HOST;
+    const result = await determinePackageManager(host, cwd, configuredPackageManager, logger, dryRun);
+    const { name, source } = result;
+    let { version } = result;
+    const descriptor = package_manager_descriptor_1.SUPPORTED_PACKAGE_MANAGERS[name];
+    if (!descriptor) {
+        throw new Error(`Unsupported package manager: "${name}"`);
+    }
+    // Do not verify if the package manager is installed during a dry run.
+    let initializationError;
+    if (!dryRun && !version) {
+        try {
+            version = await getPackageManagerVersion(host, cwd, name, logger);
+        }
+        catch {
+            if (source === 'default') {
+                initializationError = 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 {
+                initializationError = 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.`);
+            }
+        }
+    }
+    const packageManager = new package_manager_1.PackageManager(host, cwd, descriptor, {
+        dryRun,
+        logger,
+        tempDirectory,
+        version,
+        initializationError,
+    });
+    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,86 @@
+/**
+ * @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 {
+    /**
+     * Whether shell quoting is required for package manager specifiers.
+     * This is typically true on Windows, where commands are executed in a shell.
+     */
+    readonly requiresQuoting?: boolean;
+    /**
+     * Creates a directory.
+     * @param path The path to the directory.
+     * @param options Options for the directory creation.
+     * @returns A promise that resolves when the directory is created.
+     */
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<string | undefined>;
+    /**
+     * 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 content of a file.
+     * @param path The path to the file.
+     * @returns A promise that resolves to the file content as a string.
+     */
+    readFile(path: string): Promise<string>;
+    /**
+     * Copies a file from the source path to the destination path.
+     * @param src The path to the source file.
+     * @param dest The path to the destination file.
+     * @returns A promise that resolves when the copy is complete.
+     */
+    copyFile(src: string, dest: string): Promise<void>;
+    /**
+     * Creates a new, unique temporary directory.
+     * @param baseDir The base directory in which to create the temporary directory.
+     * @returns A promise that resolves to the absolute path of the created directory.
+     */
+    createTempDirectory(baseDir?: string): 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;