@angular/cli 21.1.0-next.1 → 21.1.0-next.3

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

@@ -0,0 +1,148 @@
+"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.checkCleanGit = checkCleanGit;
+exports.hasChangesToCommit = hasChangesToCommit;
+exports.createCommit = createCommit;
+exports.findCurrentGitSha = findCurrentGitSha;
+exports.getShortHash = getShortHash;
+const node_child_process_1 = require("node:child_process");
+const path = __importStar(require("node:path"));
+/**
+ * Execute a git command.
+ * @param args Arguments to pass to the git command.
+ * @param input Optional input to pass to the command via stdin.
+ * @returns The output of the command.
+ */
+function execGit(args, input) {
+    return (0, node_child_process_1.execFileSync)('git', args, { encoding: 'utf8', stdio: 'pipe', input });
+}
+/**
+ * Checks if the git repository is clean.
+ * This function only checks for changes that are within the specified root directory.
+ * Changes outside the root directory are ignored.
+ * @param root The root directory of the project to check.
+ * @returns True if the repository is clean within the root, false otherwise.
+ */
+function checkCleanGit(root) {
+    try {
+        const topLevel = execGit(['rev-parse', '--show-toplevel']);
+        const result = execGit(['status', '--porcelain', '-z']);
+        if (result.length === 0) {
+            return true;
+        }
+        const entries = result.split('\0');
+        for (let i = 0; i < entries.length; i++) {
+            const line = entries[i];
+            if (!line) {
+                continue;
+            }
+            // Status is the first 2 characters.
+            // If the status is a rename ('R'), the next entry in the split array is the target path.
+            let filePath = line.slice(3);
+            const status = line.slice(0, 2);
+            if (status[0] === 'R') {
+                // Check the source path (filePath)
+                if (isPathInsideRoot(filePath, root, topLevel.trim())) {
+                    return false;
+                }
+                // The next entry is the target path of the rename.
+                i++;
+                filePath = entries[i];
+            }
+            if (isPathInsideRoot(filePath, root, topLevel.trim())) {
+                return false;
+            }
+        }
+    }
+    catch { } // eslint-disable-line no-empty
+    return true;
+}
+function isPathInsideRoot(filePath, root, topLevel) {
+    const relativeEntry = path.relative(path.resolve(root), path.resolve(topLevel, filePath));
+    return !relativeEntry.startsWith('..') && !path.isAbsolute(relativeEntry);
+}
+/**
+ * Checks if the working directory has pending changes to commit.
+ * @returns Whether or not the working directory has Git changes to commit. Returns false if not in a Git repository.
+ */
+function hasChangesToCommit() {
+    try {
+        // List all modified files not covered by .gitignore.
+        // If any files are returned, then there must be something to commit.
+        return execGit(['ls-files', '-m', '-d', '-o', '--exclude-standard']).trim() !== '';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stages all changes in the Git working tree and creates a new commit.
+ * @param message The commit message to use.
+ */
+function createCommit(message) {
+    // Stage entire working tree for commit.
+    execGit(['add', '-A']);
+    // Commit with the message passed via stdin to avoid bash escaping issues.
+    execGit(['commit', '--no-verify', '-F', '-'], message);
+}
+/**
+ * Finds the full Git SHA hash of the HEAD commit.
+ * @returns The full Git SHA hash of the HEAD commit. Returns null if unable to retrieve the hash.
+ */
+function findCurrentGitSha() {
+    try {
+        return execGit(['rev-parse', 'HEAD']).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Gets the short hash of a commit.
+ * @param commitHash The full commit hash.
+ * @returns The short hash (first 9 characters).
+ */
+function getShortHash(commitHash) {
+    return commitHash.slice(0, 9);
+}
+//# sourceMappingURL=git.js.map

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

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

package/src/commands/update/utilities/migration.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @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 { logging } from '@angular-devkit/core';
+import { SchematicDescription } from '@angular-devkit/schematics';
+import { FileSystemCollectionDescription, FileSystemSchematicDescription, NodeWorkflow } from '@angular-devkit/schematics/tools';
+export interface MigrationSchematicDescription extends SchematicDescription<FileSystemCollectionDescription, FileSystemSchematicDescription> {
+    version?: string;
+    optional?: boolean;
+    recommended?: boolean;
+    documentation?: string;
+}
+export declare function executeSchematic(workflow: NodeWorkflow, logger: logging.Logger, collection: string, schematic: string, options?: Record<string, unknown>): Promise<{
+    success: boolean;
+    files: Set<string>;
+}>;
+/**
+ * @return Whether or not the migration was performed successfully.
+ */
+export declare function executeMigration(workflow: NodeWorkflow, logger: logging.Logger, packageName: string, collectionPath: string, migrationName: string, commit?: boolean): Promise<number>;
+/**
+ * @return Whether or not the migrations were performed successfully.
+ */
+export declare function executeMigrations(workflow: NodeWorkflow, logger: logging.Logger, packageName: string, collectionPath: string, from: string, to: string, commit?: boolean): Promise<number>;
+/**
+ * @return Whether or not the commit was successful.
+ */
+export declare function commitChanges(logger: logging.Logger, message: string): boolean;

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

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.js

@@ -31,9 +31,10 @@ exports.NodeJS_HOST = {
     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,
@@ -41,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":"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"}
+{"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. */
@@ -59,10 +62,20 @@ export interface PackageManagerDescriptor {
         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
@@ -97,7 +110,9 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
             listDependencies: typeof parseNpmLikeDependencies;
             getRegistryManifest: typeof parseNpmLikeManifest;
             getRegistryMetadata: typeof parseNpmLikeMetadata;
+            getError: typeof parseNpmLikeError;
         };
+        isNotFound: typeof isKnownNotFound;
     };
     yarn: {
         binary: string;
@@ -123,7 +138,9 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
             listDependencies: typeof parseYarnModernDependencies;
             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;
-            getRegistryManifest: typeof parseYarnLegacyManifest;
-            getRegistryMetadata: typeof parseNpmLikeMetadata;
+            getRegistryManifest: typeof parseYarnClassicManifest;
+            getRegistryMetadata: typeof parseYarnClassicMetadata;
+            getError: typeof parseYarnClassicError;
         };
+        isNotFound: typeof isKnownNotFound;
     };
     pnpm: {
         binary: string;
@@ -170,7 +190,9 @@ export declare const SUPPORTED_PACKAGE_MANAGERS: {
             listDependencies: typeof parseNpmLikeDependencies;
             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;
             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 {};