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

package/src/package-managers/discovery.js

@@ -0,0 +1,110 @@
+"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");
+/**
+ * A map from lockfile names to their corresponding package manager.
+ * This is a performance optimization to avoid iterating over all possible
+ * lockfiles in every directory.
+ */
+const LOCKFILE_TO_PACKAGE_MANAGER = new Map();
+for (const [name, descriptor] of Object.entries(package_manager_descriptor_1.SUPPORTED_PACKAGE_MANAGERS)) {
+    for (const lockfile of descriptor.lockfiles) {
+        LOCKFILE_TO_PACKAGE_MANAGER.set(lockfile, name);
+    }
+}
+/**
+ * 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}'...`);
+    try {
+        const files = await host.readdir(directory);
+        const foundPackageManagers = new Set();
+        for (const file of files) {
+            const packageManager = LOCKFILE_TO_PACKAGE_MANAGER.get(file);
+            if (packageManager) {
+                logger?.debug(`  Found '${file}'.`);
+                foundPackageManagers.add(packageManager);
+            }
+        }
+        return foundPackageManagers;
+    }
+    catch (e) {
+        logger?.debug(`  Failed to read directory: ${e}`);
+        // Ignore directories that don't exist or can't be read.
+        return new Set();
+    }
+}
+/**
+ * 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,31 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * @fileoverview This file defines a custom error class for the package manager
+ * abstraction. This allows for structured error handling and provides consumers
+ * with detailed information about the process failure.
+ */
+/**
+ * A custom error class for package manager-related errors.
+ *
+ * This error class provides structured data about the failed process,
+ * including stdout, stderr, and the exit code.
+ */
+export declare class PackageManagerError extends Error {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    /**
+     * Creates a new `PackageManagerError` instance.
+     * @param message The error message.
+     * @param stdout The standard output of the failed process.
+     * @param stderr The standard error of the failed process.
+     * @param exitCode The exit code of the failed process.
+     */
+    constructor(message: string, stdout: string, stderr: string, exitCode: number | null);
+}

package/src/package-managers/error.js

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

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

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

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

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

package/src/package-managers/factory.js

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

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

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

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

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

package/src/package-managers/host.js

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

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

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

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

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

package/src/package-managers/index.js

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

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

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

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

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

package/src/package-managers/logger.js

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

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

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