@angular/cli 21.1.0-next.0 → 21.1.0-next.2

package/src/commands/update/utilities/migration.js

@@ -0,0 +1,257 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeSchematic = executeSchematic;
+exports.executeMigration = executeMigration;
+exports.executeMigrations = executeMigrations;
+exports.commitChanges = commitChanges;
+const schematics_1 = require("@angular-devkit/schematics");
+const semver = __importStar(require("semver"));
+const schematic_workflow_1 = require("../../../command-builder/utilities/schematic-workflow");
+const color_1 = require("../../../utilities/color");
+const error_1 = require("../../../utilities/error");
+const log_file_1 = require("../../../utilities/log-file");
+const prompt_1 = require("../../../utilities/prompt");
+const tty_1 = require("../../../utilities/tty");
+const cli_version_1 = require("./cli-version");
+const git_1 = require("./git");
+async function executeSchematic(workflow, logger, collection, schematic, options = {}) {
+    const workflowSubscription = (0, schematic_workflow_1.subscribeToWorkflow)(workflow, logger);
+    // TODO: Allow passing a schematic instance directly
+    try {
+        await workflow
+            .execute({
+            collection,
+            schematic,
+            options,
+            logger,
+        })
+            .toPromise();
+        return { success: !workflowSubscription.error, files: workflowSubscription.files };
+    }
+    catch (e) {
+        if (e instanceof schematics_1.UnsuccessfulWorkflowExecution) {
+            logger.error(`${color_1.figures.cross} Migration failed. See above for further details.\n`);
+        }
+        else {
+            (0, error_1.assertIsError)(e);
+            const logPath = (0, log_file_1.writeErrorToLogFile)(e);
+            logger.fatal(`${color_1.figures.cross} Migration failed: ${e.message}\n` +
+                `  See "${logPath}" for further details.\n`);
+        }
+        return { success: false, files: workflowSubscription.files };
+    }
+    finally {
+        workflowSubscription.unsubscribe();
+    }
+}
+/**
+ * @return Whether or not the migration was performed successfully.
+ */
+async function executeMigration(workflow, logger, packageName, collectionPath, migrationName, commit = false) {
+    const collection = workflow.engine.createCollection(collectionPath);
+    const name = collection.listSchematicNames().find((name) => name === migrationName);
+    if (!name) {
+        logger.error(`Cannot find migration '${migrationName}' in '${packageName}'.`);
+        return 1;
+    }
+    logger.info(color_1.colors.cyan(`** Executing '${migrationName}' of package '${packageName}' **\n`));
+    const schematic = workflow.engine.createSchematic(name, collection);
+    return executePackageMigrations(workflow, logger, [schematic.description], packageName, commit);
+}
+/**
+ * @return Whether or not the migrations were performed successfully.
+ */
+async function executeMigrations(workflow, logger, packageName, collectionPath, from, to, commit = false) {
+    const collection = workflow.engine.createCollection(collectionPath);
+    const migrationRange = new semver.Range('>' + (semver.prerelease(from) ? from.split('-')[0] + '-0' : from) + ' <=' + to.split('-')[0]);
+    const requiredMigrations = [];
+    const optionalMigrations = [];
+    for (const name of collection.listSchematicNames()) {
+        const schematic = workflow.engine.createSchematic(name, collection);
+        const description = schematic.description;
+        description.version = (0, cli_version_1.coerceVersionNumber)(description.version);
+        if (!description.version) {
+            continue;
+        }
+        if (semver.satisfies(description.version, migrationRange, { includePrerelease: true })) {
+            (description.optional ? optionalMigrations : requiredMigrations).push(description);
+        }
+    }
+    if (requiredMigrations.length === 0 && optionalMigrations.length === 0) {
+        return 0;
+    }
+    // Required migrations
+    if (requiredMigrations.length) {
+        logger.info(color_1.colors.cyan(`** Executing migrations of package '${packageName}' **\n`));
+        requiredMigrations.sort((a, b) => semver.compare(a.version, b.version) || a.name.localeCompare(b.name));
+        const result = await executePackageMigrations(workflow, logger, requiredMigrations, packageName, commit);
+        if (result === 1) {
+            return 1;
+        }
+    }
+    // Optional migrations
+    if (optionalMigrations.length) {
+        logger.info(color_1.colors.magenta(`** Optional migrations of package '${packageName}' **\n`));
+        optionalMigrations.sort((a, b) => semver.compare(a.version, b.version) || a.name.localeCompare(b.name));
+        const migrationsToRun = await getOptionalMigrationsToRun(logger, optionalMigrations, packageName);
+        if (migrationsToRun?.length) {
+            return executePackageMigrations(workflow, logger, migrationsToRun, packageName, commit);
+        }
+    }
+    return 0;
+}
+async function executePackageMigrations(workflow, logger, migrations, packageName, commit = false) {
+    for (const migration of migrations) {
+        const { title, description } = getMigrationTitleAndDescription(migration);
+        logger.info(color_1.colors.cyan(color_1.figures.pointer) + ' ' + color_1.colors.bold(title));
+        if (description) {
+            logger.info('  ' + description);
+        }
+        const { success, files } = await executeSchematic(workflow, logger, migration.collection.name, migration.name);
+        if (!success) {
+            return 1;
+        }
+        let modifiedFilesText;
+        switch (files.size) {
+            case 0:
+                modifiedFilesText = 'No changes made';
+                break;
+            case 1:
+                modifiedFilesText = '1 file modified';
+                break;
+            default:
+                modifiedFilesText = `${files.size} files modified`;
+                break;
+        }
+        logger.info(`  Migration completed (${modifiedFilesText}).`);
+        // Commit migration
+        if (commit) {
+            const commitPrefix = `${packageName} migration - ${migration.name}`;
+            const commitMessage = migration.description
+                ? `${commitPrefix}\n\n${migration.description}`
+                : commitPrefix;
+            const committed = commitChanges(logger, commitMessage);
+            if (!committed) {
+                // Failed to commit, something went wrong. Abort the update.
+                return 1;
+            }
+        }
+        logger.info(''); // Extra trailing newline.
+    }
+    return 0;
+}
+/**
+ * @return Whether or not the commit was successful.
+ */
+function commitChanges(logger, message) {
+    // Check if a commit is needed.
+    let commitNeeded;
+    try {
+        commitNeeded = (0, git_1.hasChangesToCommit)();
+    }
+    catch (err) {
+        logger.error(`  Failed to read Git tree:\n${err.stderr}`);
+        return false;
+    }
+    if (!commitNeeded) {
+        logger.info('  No changes to commit after migration.');
+        return true;
+    }
+    // Commit changes and abort on error.
+    try {
+        (0, git_1.createCommit)(message);
+    }
+    catch (err) {
+        logger.error(`Failed to commit update (${message}):\n${err.stderr}`);
+        return false;
+    }
+    // Notify user of the commit.
+    const hash = (0, git_1.findCurrentGitSha)();
+    const shortMessage = message.split('\n')[0];
+    if (hash) {
+        logger.info(`  Committed migration step (${(0, git_1.getShortHash)(hash)}): ${shortMessage}.`);
+    }
+    else {
+        // Commit was successful, but reading the hash was not. Something weird happened,
+        // but nothing that would stop the update. Just log the weirdness and continue.
+        logger.info(`  Committed migration step: ${shortMessage}.`);
+        logger.warn('  Failed to look up hash of most recent commit, continuing anyways.');
+    }
+    return true;
+}
+async function getOptionalMigrationsToRun(logger, optionalMigrations, packageName) {
+    const numberOfMigrations = optionalMigrations.length;
+    logger.info(`This package has ${numberOfMigrations} optional migration${numberOfMigrations > 1 ? 's' : ''} that can be executed.`);
+    if (!(0, tty_1.isTTY)()) {
+        for (const migration of optionalMigrations) {
+            const { title } = getMigrationTitleAndDescription(migration);
+            logger.info(color_1.colors.cyan(color_1.figures.pointer) + ' ' + color_1.colors.bold(title));
+            logger.info(color_1.colors.gray(`  ng update ${packageName} --name ${migration.name}`));
+            logger.info(''); // Extra trailing newline.
+        }
+        return undefined;
+    }
+    logger.info('Optional migrations may be skipped and executed after the update process, if preferred.');
+    logger.info(''); // Extra trailing newline.
+    const answer = await (0, prompt_1.askChoices)(`Select the migrations that you'd like to run`, optionalMigrations.map((migration) => {
+        const { title, documentation } = getMigrationTitleAndDescription(migration);
+        return {
+            name: `[${color_1.colors.white(migration.name)}] ${title}${documentation ? ` (${documentation})` : ''}`,
+            value: migration.name,
+            checked: migration.recommended,
+        };
+    }), null);
+    logger.info(''); // Extra trailing newline.
+    return optionalMigrations.filter(({ name }) => answer?.includes(name));
+}
+function getMigrationTitleAndDescription(migration) {
+    const [title, ...description] = migration.description.split('. ');
+    return {
+        title: title.endsWith('.') ? title : title + '.',
+        description: description.join('.\n  '),
+        documentation: migration.documentation
+            ? new URL(migration.documentation, 'https://angular.dev').href
+            : undefined,
+    };
+}
+//# sourceMappingURL=migration.js.map

package/src/commands/update/utilities/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["migration.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCH,4CAqCC;AAKD,4CA0BC;AAKD,8CA8EC;AAiED,sCAyCC;AAhSD,2DAAiG;AAOjG,+CAAiC;AACjC,8FAA4F;AAC5F,oDAA2D;AAC3D,oDAAyD;AACzD,0DAAkE;AAClE,sDAAuD;AACvD,gDAA+C;AAC/C,+CAAoD;AACpD,+BAA0F;AAgBnF,KAAK,UAAU,gBAAgB,CACpC,QAAsB,EACtB,MAAsB,EACtB,UAAkB,EAClB,SAAiB,EACjB,UAAmC,EAAE;IAErC,MAAM,oBAAoB,GAAG,IAAA,wCAAmB,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEnE,oDAAoD;IACpD,IAAI,CAAC;QACH,MAAM,QAAQ;aACX,OAAO,CAAC;YACP,UAAU;YACV,SAAS;YACT,OAAO;YACP,MAAM;SACP,CAAC;aACD,SAAS,EAAE,CAAC;QAEf,OAAO,EAAE,OAAO,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,CAAC;IACrF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,0CAA6B,EAAE,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,eAAO,CAAC,KAAK,qDAAqD,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACN,IAAA,qBAAa,EAAC,CAAC,CAAC,CAAC;YACjB,MAAM,OAAO,GAAG,IAAA,8BAAmB,EAAC,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CACV,GAAG,eAAO,CAAC,KAAK,sBAAsB,CAAC,CAAC,OAAO,IAAI;gBACjD,UAAU,OAAO,0BAA0B,CAC9C,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,CAAC;IAC/D,CAAC;YAAS,CAAC;QACT,oBAAoB,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CACpC,QAAsB,EACtB,MAAsB,EACtB,WAAmB,EACnB,cAAsB,EACtB,aAAqB,EACrB,SAAkB,KAAK;IAEvB,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,UAAU,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IACpF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,CAAC,0BAA0B,aAAa,SAAS,WAAW,IAAI,CAAC,CAAC;QAE9E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,IAAI,CAAC,iBAAiB,aAAa,iBAAiB,WAAW,QAAQ,CAAC,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEpE,OAAO,wBAAwB,CAC7B,QAAQ,EACR,MAAM,EACN,CAAC,SAAS,CAAC,WAA4C,CAAC,EACxD,WAAW,EACX,MAAM,CACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CACrC,QAAsB,EACtB,MAAsB,EACtB,WAAmB,EACnB,cAAsB,EACtB,IAAY,EACZ,EAAU,EACV,SAAkB,KAAK;IAEvB,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACpE,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,KAAK,CACrC,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC9F,CAAC;IAEF,MAAM,kBAAkB,GAA+C,EAAE,CAAC;IAC1E,MAAM,kBAAkB,GAA+C,EAAE,CAAC;IAE1E,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,kBAAkB,EAAE,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,SAAS,CAAC,WAA4C,CAAC;QAE3E,WAAW,CAAC,OAAO,GAAG,IAAA,iCAAmB,EAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACvF,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CACnE,WAAuD,CACxD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,sBAAsB;IACtB,IAAI,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,IAAI,CAAC,uCAAuC,WAAW,QAAQ,CAAC,CAAC,CAAC;QAErF,kBAAkB,CAAC,IAAI,CACrB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC/E,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,WAAW,EACX,MAAM,CACP,CAAC;QAEF,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,OAAO,CAAC,sCAAsC,WAAW,QAAQ,CAAC,CAAC,CAAC;QAEvF,kBAAkB,CAAC,IAAI,CACrB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC/E,CAAC;QAEF,MAAM,eAAe,GAAG,MAAM,0BAA0B,CACtD,MAAM,EACN,kBAAkB,EAClB,WAAW,CACZ,CAAC;QAEF,IAAI,eAAe,EAAE,MAAM,EAAE,CAAC;YAC5B,OAAO,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,QAAsB,EACtB,MAAsB,EACtB,UAA2C,EAC3C,WAAmB,EACnB,MAAM,GAAG,KAAK;IAEd,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,+BAA+B,CAAC,SAAS,CAAC,CAAC;QAE1E,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,IAAI,CAAC,eAAO,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,cAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAErE,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,gBAAgB,CAC/C,QAAQ,EACR,MAAM,EACN,SAAS,CAAC,UAAU,CAAC,IAAI,EACzB,SAAS,CAAC,IAAI,CACf,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,iBAAyB,CAAC;QAC9B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,CAAC;gBACJ,iBAAiB,GAAG,iBAAiB,CAAC;gBACtC,MAAM;YACR,KAAK,CAAC;gBACJ,iBAAiB,GAAG,iBAAiB,CAAC;gBACtC,MAAM;YACR;gBACE,iBAAiB,GAAG,GAAG,KAAK,CAAC,IAAI,iBAAiB,CAAC;gBACnD,MAAM;QACV,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,0BAA0B,iBAAiB,IAAI,CAAC,CAAC;QAE7D,mBAAmB;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,GAAG,WAAW,gBAAgB,SAAS,CAAC,IAAI,EAAE,CAAC;YACpE,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW;gBACzC,CAAC,CAAC,GAAG,YAAY,OAAO,SAAS,CAAC,WAAW,EAAE;gBAC/C,CAAC,CAAC,YAAY,CAAC;YACjB,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YACvD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,4DAA4D;gBAC5D,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;IAC7C,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAsB,EAAE,OAAe;IACnE,+BAA+B;IAC/B,IAAI,YAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,YAAY,GAAG,IAAA,wBAAkB,GAAE,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,+BAAgC,GAAgC,CAAC,MAAM,EAAE,CAAC,CAAC;QAExF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QAEvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,IAAI,CAAC;QACH,IAAA,kBAAY,EAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CACV,4BAA4B,OAAO,OAAQ,GAAgC,CAAC,MAAM,EAAE,CACrF,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6BAA6B;IAC7B,MAAM,IAAI,GAAG,IAAA,uBAAiB,GAAE,CAAC;IACjC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAA,kBAAY,EAAC,IAAI,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,iFAAiF;QACjF,+EAA+E;QAC/E,MAAM,CAAC,IAAI,CAAC,+BAA+B,YAAY,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,MAAsB,EACtB,kBAAmD,EACnD,WAAmB;IAEnB,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACrD,MAAM,CAAC,IAAI,CACT,oBAAoB,kBAAkB,sBACpC,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EACjC,wBAAwB,CACzB,CAAC;IAEF,IAAI,CAAC,IAAA,WAAK,GAAE,EAAE,CAAC;QACb,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;YAC3C,MAAM,EAAE,KAAK,EAAE,GAAG,+BAA+B,CAAC,SAAS,CAAC,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,IAAI,CAAC,eAAO,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,cAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,IAAI,CAAC,eAAe,WAAW,WAAW,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAChF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;QAC7C,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAI,CACT,yFAAyF,CAC1F,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;IAE3C,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAU,EAC7B,8CAA8C,EAC9C,kBAAkB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACnC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,+BAA+B,CAAC,SAAS,CAAC,CAAC;QAE5E,OAAO;YACL,IAAI,EAAE,IAAI,cAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/F,KAAK,EAAE,SAAS,CAAC,IAAI;YACrB,OAAO,EAAE,SAAS,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC,CAAC,EACF,IAAI,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;IAE3C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,+BAA+B,CAAC,SAAwC;IAK/E,MAAM,CAAC,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG;QAChD,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;QACtC,aAAa,EAAE,SAAS,CAAC,aAAa;YACpC,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC,IAAI;YAC9D,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

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

@@ -29,3 +29,15 @@ export declare class PackageManagerError extends Error {
      */
     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/host.d.ts

@@ -22,6 +22,12 @@ export interface Host {
      * @returns A promise that resolves to an array of file and directory names.
      */
     readdir(path: string): Promise<string[]>;
+    /**
+     * 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>;
     /**
      * Creates a new, unique temporary directory.
      * @returns A promise that resolves to the absolute path of the created directory.

package/src/package-managers/host.js

@@ -25,14 +25,16 @@ const error_1 = require("./error");
 exports.NodeJS_HOST = {
     stat: promises_1.stat,
     readdir: promises_1.readdir,
+    readFile: (path) => (0, promises_1.readFile)(path, { encoding: 'utf8' }),
     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;
+        const isWin32 = (0, node_os_1.platform)() === 'win32';
         return new Promise((resolve, reject) => {
-            const childProcess = (0, node_child_process_1.spawn)(command, args, {
-                shell: false,
+            const spawnOptions = {
+                shell: isWin32,
                 stdio: options.stdio ?? 'pipe',
                 signal,
                 cwd: options.cwd,
@@ -40,7 +42,10 @@ exports.NodeJS_HOST = {
                     ...process.env,
                     ...options.env,
                 },
-            });
+            };
+            const childProcess = isWin32
+                ? (0, node_child_process_1.spawn)(`${command} ${args.join(' ')}`, spawnOptions)
+                : (0, node_child_process_1.spawn)(command, args, spawnOptions);
             let stdout = '';
             childProcess.stdout?.on('data', (data) => (stdout += data.toString()));
             let stderr = '';

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

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

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

@@ -10,10 +10,11 @@
  * supported package managers. It is the single source of truth for all
  * package-manager-specific commands, flags, and output parsing.
  */
+import { ErrorInfo } from './error';
 import { Logger } from './logger';
 import { PackageManifest, PackageMetadata } from './package-metadata';
 import { InstalledPackage } from './package-tree';
-import { parseNpmLikeDependencies, parseNpmLikeManifest, parseNpmLikeMetadata, parseYarnClassicDependencies, parseYarnLegacyManifest, parseYarnModernDependencies } from './parsers';
+import { parseNpmLikeDependencies, parseNpmLikeError, parseNpmLikeManifest, parseNpmLikeMetadata, parseYarnClassicDependencies, parseYarnClassicError, parseYarnClassicManifest, parseYarnClassicMetadata, parseYarnModernDependencies } from './parsers';
 /**
  * An interface that describes the commands and properties of a package manager.
  */
@@ -49,6 +50,8 @@ export interface PackageManagerDescriptor {
     readonly listDependenciesCommand: readonly string[];
     /** The command to fetch the registry manifest of a package. */
     readonly getManifestCommand: readonly string[];
+    /** Whether a specific version lookup is needed prior to fetching a registry manifest. */
+    readonly requiresManifestVersionLookup?: boolean;
     /** 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. */
@@ -56,13 +59,23 @@ export interface PackageManagerDescriptor {
         /** 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;
+        getRegistryManifest: (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 function to parse the output when a command fails. */
+        getError?: (output: string, logger?: Logger) => ErrorInfo | null;
     };
+    /** A function that checks if a structured error represents a "package not found" error. */
+    readonly isNotFound: (error: ErrorInfo) => boolean;
 }
 /** A type that represents the name of a supported package manager. */
 export type PackageManagerName = keyof typeof SUPPORTED_PACKAGE_MANAGERS;
+/**
+ * A shared function to check if a structured error represents a "package not found" error.
+ * @param error The structured error to check.
+ * @returns True if the error code is a known "not found" code, false otherwise.
+ */
+declare function isKnownNotFound(error: ErrorInfo): boolean;
 /**
  * A map of supported package managers to their descriptors.
  * This is the single source of truth for all package-manager-specific
@@ -95,9 +108,11 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
         viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
         outputParsers: {
             listDependencies: typeof parseNpmLikeDependencies;
-            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryManifest: typeof parseNpmLikeManifest;
             getRegistryMetadata: typeof parseNpmLikeMetadata;
+            getError: typeof parseNpmLikeError;
         };
+        isNotFound: typeof isKnownNotFound;
     };
     yarn: {
         binary: string;
@@ -121,9 +136,11 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
         viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
         outputParsers: {
             listDependencies: typeof parseYarnModernDependencies;
-            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryManifest: typeof parseNpmLikeManifest;
             getRegistryMetadata: typeof parseNpmLikeMetadata;
+            getError: typeof parseNpmLikeError;
         };
+        isNotFound: typeof isKnownNotFound;
     };
     'yarn-classic': {
         binary: string;
@@ -142,11 +159,14 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
         versionCommand: string[];
         listDependenciesCommand: string[];
         getManifestCommand: string[];
+        requiresManifestVersionLookup: true;
         outputParsers: {
             listDependencies: typeof parseYarnClassicDependencies;
-            getPackageManifest: typeof parseYarnLegacyManifest;
-            getRegistryMetadata: typeof parseNpmLikeMetadata;
+            getRegistryManifest: typeof parseYarnClassicManifest;
+            getRegistryMetadata: typeof parseYarnClassicMetadata;
+            getError: typeof parseYarnClassicError;
         };
+        isNotFound: typeof isKnownNotFound;
     };
     pnpm: {
         binary: string;
@@ -168,9 +188,11 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
         viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
         outputParsers: {
             listDependencies: typeof parseNpmLikeDependencies;
-            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryManifest: typeof parseNpmLikeManifest;
             getRegistryMetadata: typeof parseNpmLikeMetadata;
+            getError: typeof parseNpmLikeError;
         };
+        isNotFound: typeof isKnownNotFound;
     };
     bun: {
         binary: string;
@@ -189,12 +211,13 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
         versionCommand: string[];
         listDependenciesCommand: string[];
         getManifestCommand: string[];
-        viewCommandFieldArgFormatter: (fields: readonly string[]) => string[];
         outputParsers: {
             listDependencies: typeof parseNpmLikeDependencies;
-            getPackageManifest: typeof parseNpmLikeManifest;
+            getRegistryManifest: typeof parseNpmLikeManifest;
             getRegistryMetadata: typeof parseNpmLikeMetadata;
+            getError: typeof parseNpmLikeError;
         };
+        isNotFound: typeof isKnownNotFound;
     };
 };
 /**
@@ -202,3 +225,4 @@ export declare const SUPPORTED_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[];
+export {};

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

@@ -9,6 +9,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PACKAGE_MANAGER_PRECEDENCE = exports.SUPPORTED_PACKAGE_MANAGERS = void 0;
 const parsers_1 = require("./parsers");
+/** A set of error codes that are known to indicate a "package not found" error. */
+const NOT_FOUND_ERROR_CODES = new Set(['E404']);
+/**
+ * A shared function to check if a structured error represents a "package not found" error.
+ * @param error The structured error to check.
+ * @returns True if the error code is a known "not found" code, false otherwise.
+ */
+function isKnownNotFound(error) {
+    return NOT_FOUND_ERROR_CODES.has(error.code);
+}
 /**
  * A map of supported package managers to their descriptors.
  * This is the single source of truth for all package-manager-specific
@@ -39,9 +49,11 @@ exports.SUPPORTED_PACKAGE_MANAGERS = {
         viewCommandFieldArgFormatter: (fields) => [...fields],
         outputParsers: {
             listDependencies: parsers_1.parseNpmLikeDependencies,
-            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryManifest: parsers_1.parseNpmLikeManifest,
             getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+            getError: parsers_1.parseNpmLikeError,
         },
+        isNotFound: isKnownNotFound,
     },
     yarn: {
         binary: 'yarn',
@@ -61,9 +73,11 @@ exports.SUPPORTED_PACKAGE_MANAGERS = {
         viewCommandFieldArgFormatter: (fields) => ['--fields', fields.join(',')],
         outputParsers: {
             listDependencies: parsers_1.parseYarnModernDependencies,
-            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryManifest: parsers_1.parseNpmLikeManifest,
             getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+            getError: parsers_1.parseNpmLikeError,
         },
+        isNotFound: isKnownNotFound,
     },
     'yarn-classic': {
         binary: 'yarn',
@@ -82,12 +96,15 @@ exports.SUPPORTED_PACKAGE_MANAGERS = {
         getRegistryOptions: (registry) => ({ args: ['--registry', registry] }),
         versionCommand: ['--version'],
         listDependenciesCommand: ['list', '--depth=0', '--json'],
-        getManifestCommand: ['info', '--json'],
+        getManifestCommand: ['info', '--json', '--verbose'],
+        requiresManifestVersionLookup: true,
         outputParsers: {
             listDependencies: parsers_1.parseYarnClassicDependencies,
-            getPackageManifest: parsers_1.parseYarnLegacyManifest,
-            getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+            getRegistryManifest: parsers_1.parseYarnClassicManifest,
+            getRegistryMetadata: parsers_1.parseYarnClassicMetadata,
+            getError: parsers_1.parseYarnClassicError,
         },
+        isNotFound: isKnownNotFound,
     },
     pnpm: {
         binary: 'pnpm',
@@ -107,9 +124,11 @@ exports.SUPPORTED_PACKAGE_MANAGERS = {
         viewCommandFieldArgFormatter: (fields) => [...fields],
         outputParsers: {
             listDependencies: parsers_1.parseNpmLikeDependencies,
-            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryManifest: parsers_1.parseNpmLikeManifest,
             getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+            getError: parsers_1.parseNpmLikeError,
         },
+        isNotFound: isKnownNotFound,
     },
     bun: {
         binary: 'bun',
@@ -126,12 +145,13 @@ exports.SUPPORTED_PACKAGE_MANAGERS = {
         versionCommand: ['--version'],
         listDependenciesCommand: ['pm', 'ls', '--json'],
         getManifestCommand: ['pm', 'view', '--json'],
-        viewCommandFieldArgFormatter: (fields) => [...fields],
         outputParsers: {
             listDependencies: parsers_1.parseNpmLikeDependencies,
-            getPackageManifest: parsers_1.parseNpmLikeManifest,
+            getRegistryManifest: parsers_1.parseNpmLikeManifest,
             getRegistryMetadata: parsers_1.parseNpmLikeMetadata,
+            getError: parsers_1.parseNpmLikeError,
         },
+        isNotFound: isKnownNotFound,
     },
 };
 /**

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

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

@@ -5,6 +5,7 @@
  * 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 npa from 'npm-package-arg';
 import { Host } from './host';
 import { Logger } from './logger';
 import { PackageManagerDescriptor } from './package-manager-descriptor';
@@ -120,7 +121,23 @@ export declare class PackageManager {
      * @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?: {
+    getRegistryManifest(packageName: string, version: string, options?: {
+        timeout?: number;
+        registry?: string;
+        bypassCache?: boolean;
+    }): Promise<PackageManifest | null>;
+    /**
+     * Fetches the manifest for a package.
+     *
+     * This method can resolve manifests for packages from the registry, as well
+     * as those specified by file paths, directory paths, and remote tarballs.
+     * Caching is only supported for registry packages.
+     *
+     * @param specifier The package specifier to resolve the manifest for.
+     * @param options Options for the fetch.
+     * @returns A promise that resolves to the `PackageManifest` object, or `null` if the package is not found.
+     */
+    getManifest(specifier: string | npa.Result, options?: {
         timeout?: number;
         registry?: string;
         bypassCache?: boolean;
@@ -130,13 +147,14 @@ export declare class PackageManager {
      * 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 specifier The specifier 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?: {
+    acquireTempPackage(specifier: string, options?: {
         registry?: string;
+        ignoreScripts?: boolean;
     }): Promise<{
         workingDirectory: string;
         cleanup: () => Promise<void>;