@depup/angular__cli 21.2.1-depup.1

package/src/package-managers/parsers.js

@@ -0,0 +1,467 @@
+"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.parseNpmLikeDependencies = parseNpmLikeDependencies;
+exports.parseYarnClassicDependencies = parseYarnClassicDependencies;
+exports.parseNpmLikeManifest = parseNpmLikeManifest;
+exports.parseNpmLikeMetadata = parseNpmLikeMetadata;
+exports.parseYarnClassicManifest = parseYarnClassicManifest;
+exports.parseYarnClassicMetadata = parseYarnClassicMetadata;
+exports.parseNpmLikeError = parseNpmLikeError;
+exports.parseYarnClassicError = parseYarnClassicError;
+exports.parseBunDependencies = parseBunDependencies;
+exports.parseYarnModernDependencies = parseYarnModernDependencies;
+const MAX_LOG_LENGTH = 1024;
+function logStdout(stdout, logger) {
+    if (!logger) {
+        return;
+    }
+    let output = stdout;
+    if (output.length > MAX_LOG_LENGTH) {
+        output = `${output.slice(0, MAX_LOG_LENGTH)}... (truncated)`;
+    }
+    logger.debug(`  stdout:\n${output}`);
+}
+/**
+ * A generator function that parses a string containing JSONL (newline-delimited JSON)
+ * and yields each successfully parsed JSON object.
+ * @param output The string output to parse.
+ * @param logger An optional logger instance.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function* parseJsonLines(output, logger) {
+    for (const line of output.split('\n')) {
+        if (!line.trim()) {
+            continue;
+        }
+        try {
+            yield JSON.parse(line);
+        }
+        catch (e) {
+            logger?.debug(`  Ignoring non-JSON line: ${e}`);
+        }
+    }
+}
+/**
+ * Parses the output of `npm list` or a compatible command.
+ *
+ * The expected JSON structure is:
+ * ```json
+ * {
+ *   "dependencies": {
+ *     "@angular/cli": {
+ *       "version": "18.0.0",
+ *       "path": "/path/to/project/node_modules/@angular/cli", // path is optional
+ *       ... (other package.json properties)
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns A map of package names to their installed package details.
+ */
+function parseNpmLikeDependencies(stdout, logger) {
+    logger?.debug(`Parsing npm-like dependency list...`);
+    logStdout(stdout, logger);
+    const dependencies = new Map();
+    if (!stdout) {
+        logger?.debug('  stdout is empty. No dependencies found.');
+        return dependencies;
+    }
+    let data = JSON.parse(stdout);
+    if (Array.isArray(data)) {
+        // pnpm returns an array of projects.
+        data = data[0];
+    }
+    const dependencyMaps = [data.dependencies, data.devDependencies, data.unsavedDependencies].filter((d) => !!d);
+    if (dependencyMaps.length === 0) {
+        logger?.debug('  `dependencies` property not found. No dependencies found.');
+        return dependencies;
+    }
+    for (const dependencyMap of dependencyMaps) {
+        for (const [name, info] of Object.entries(dependencyMap)) {
+            dependencies.set(name, {
+                name,
+                version: info.version,
+                path: info.path,
+            });
+        }
+    }
+    logger?.debug(`  Found ${dependencies.size} dependencies.`);
+    return dependencies;
+}
+/**
+ * Parses the output of `yarn list` (classic).
+ *
+ * The expected output is a JSON stream (JSONL), where each line is a JSON object.
+ * The relevant object has a `type` of `'tree'` with a `data` property.
+ * Yarn classic does not provide a path, so the `path` property will be `undefined`.
+ *
+ * ```json
+ * {"type":"tree","data":{"trees":[{"name":"@angular/cli@18.0.0","children":[]}]}}
+ * ```
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns A map of package names to their installed package details.
+ */
+function parseYarnClassicDependencies(stdout, logger) {
+    logger?.debug(`Parsing yarn classic dependency list...`);
+    logStdout(stdout, logger);
+    const dependencies = new Map();
+    if (!stdout) {
+        logger?.debug('  stdout is empty. No dependencies found.');
+        return dependencies;
+    }
+    for (const json of parseJsonLines(stdout, logger)) {
+        if (json.type === 'tree' && json.data?.trees) {
+            for (const info of json.data.trees) {
+                const lastAtIndex = info.name.lastIndexOf('@');
+                const name = info.name.slice(0, lastAtIndex);
+                const version = info.name.slice(lastAtIndex + 1);
+                dependencies.set(name, {
+                    name,
+                    version,
+                });
+            }
+        }
+    }
+    logger?.debug(`  Found ${dependencies.size} dependencies.`);
+    return dependencies;
+}
+/**
+ * Parses the output of `npm view` or a compatible command to get a package manifest.
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns The package manifest object.
+ */
+function parseNpmLikeManifest(stdout, logger) {
+    logger?.debug(`Parsing npm-like manifest...`);
+    logStdout(stdout, logger);
+    if (!stdout) {
+        logger?.debug('  stdout is empty. No manifest found.');
+        return null;
+    }
+    const result = JSON.parse(stdout);
+    return Array.isArray(result) ? result[result.length - 1] : result;
+}
+/**
+ * Parses the output of `npm view` or a compatible command to get package metadata.
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns The package metadata object.
+ */
+function parseNpmLikeMetadata(stdout, logger) {
+    logger?.debug(`Parsing npm-like metadata...`);
+    logStdout(stdout, logger);
+    if (!stdout) {
+        logger?.debug('  stdout is empty. No metadata found.');
+        return null;
+    }
+    return JSON.parse(stdout);
+}
+/**
+ * Parses the output of `yarn info` (classic) to get a package manifest.
+ *
+ * When `yarn info --verbose` is used, the output is a JSONL stream. This function
+ * iterates through the lines to find the object with `type: 'inspect'` which contains
+ * the package manifest.
+ *
+ * For non-verbose output, it falls back to parsing a single JSON object.
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns The package manifest object, or `null` if not found.
+ */
+function parseYarnClassicManifest(stdout, logger) {
+    logger?.debug(`Parsing yarn classic manifest...`);
+    logStdout(stdout, logger);
+    if (!stdout) {
+        logger?.debug('  stdout is empty. No manifest found.');
+        return null;
+    }
+    // Yarn classic outputs JSONL. We need to find the relevant object.
+    let manifest;
+    for (const json of parseJsonLines(stdout, logger)) {
+        // The manifest data is in a JSON object with type 'inspect'.
+        if (json.type === 'inspect' && json.data) {
+            manifest = json.data;
+            break;
+        }
+    }
+    if (!manifest) {
+        logger?.debug('  Failed to find manifest in yarn classic output.');
+        return null;
+    }
+    // Yarn classic removes any field with a falsy value
+    // https://github.com/yarnpkg/yarn/blob/7cafa512a777048ce0b666080a24e80aae3d66a9/src/cli/commands/info.js#L26-L29
+    // Add a default of 'false' for the `save` field when the `ng-add` object is present but does not have any fields.
+    // There is a small chance this causes an incorrect value. However, the use of `ng-add` is rare and, in the cases
+    // it is used, save is set to either a `false` literal or a truthy value. Special cases can be added for specific
+    // packages if discovered.
+    if (manifest['ng-add'] &&
+        typeof manifest['ng-add'] === 'object' &&
+        Object.keys(manifest['ng-add']).length === 0) {
+        manifest['ng-add'].save ??= false;
+    }
+    return manifest;
+}
+/**
+ * Parses the output of `yarn info` (classic) to get package metadata.
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns The package metadata object.
+ */
+function parseYarnClassicMetadata(stdout, logger) {
+    logger?.debug(`Parsing yarn classic metadata...`);
+    logStdout(stdout, logger);
+    if (!stdout) {
+        logger?.debug('  stdout is empty. No metadata found.');
+        return null;
+    }
+    // Yarn classic outputs JSONL. We need to find the relevant object.
+    let metadata;
+    for (const json of parseJsonLines(stdout, logger)) {
+        // The metadata data is in a JSON object with type 'inspect'.
+        if (json.type === 'inspect' && json.data) {
+            metadata = json.data;
+            break;
+        }
+    }
+    if (!metadata) {
+        logger?.debug('  Failed to find metadata in yarn classic output.');
+        return null;
+    }
+    return metadata;
+}
+/**
+ * Parses the `stdout` or `stderr` output of npm, pnpm, modern yarn, or bun to extract structured error information.
+ *
+ * This parser uses a multi-stage approach. It first attempts to parse the entire `output` as a
+ * single JSON object, which is the standard for modern tools like pnpm, yarn, and bun. If JSON
+ * parsing fails, it falls back to a line-by-line regex-based approach to handle the plain
+ * text output from older versions of npm.
+ *
+ * Example JSON output (pnpm):
+ * ```json
+ * {
+ *   "code": "E404",
+ *   "summary": "Not Found - GET https://registry.npmjs.org/@angular%2fnon-existent - Not found",
+ *   "detail": "The requested resource '@angular/non-existent@*' could not be found or you do not have permission to access it."
+ * }
+ * ```
+ *
+ * Example text output (npm):
+ * ```
+ * npm error code E404
+ * npm error 404 Not Found - GET https://registry.npmjs.org/@angular%2fnon-existent - Not found
+ * ```
+ *
+ * @param output The standard output or standard error of the command.
+ * @param logger An optional logger instance.
+ * @returns An `ErrorInfo` object if parsing is successful, otherwise `null`.
+ */
+function parseNpmLikeError(output, logger) {
+    logger?.debug(`Parsing npm-like error output...`);
+    logStdout(output, logger); // Log output for debugging purposes
+    if (!output) {
+        logger?.debug('  output is empty. No error found.');
+        return null;
+    }
+    // Attempt to parse as JSON first (common for pnpm, modern yarn, bun)
+    try {
+        const jsonError = JSON.parse(output);
+        if (jsonError &&
+            typeof jsonError.code === 'string' &&
+            (typeof jsonError.summary === 'string' || typeof jsonError.message === 'string')) {
+            const summary = jsonError.summary || jsonError.message;
+            logger?.debug(`  Successfully parsed JSON error with code '${jsonError.code}'.`);
+            return {
+                code: jsonError.code,
+                summary,
+                detail: jsonError.detail,
+            };
+        }
+    }
+    catch (e) {
+        logger?.debug(`  Failed to parse output as JSON: ${e}. Attempting regex fallback.`);
+        // Fallback to regex for plain text errors (common for npm)
+    }
+    // Regex for npm-like error codes (e.g., `npm ERR! code E404` or `npm error code E404`)
+    const errorCodeMatch = output.match(/npm (ERR!|error) code (E\d{3}|[A-Z_]+)/);
+    if (errorCodeMatch) {
+        const code = errorCodeMatch[2]; // Capture group 2 is the actual error code
+        let summary;
+        // Find the most descriptive summary line (the line after `npm ERR! code ...` or `npm error code ...`).
+        for (const line of output.split('\n')) {
+            if (line.startsWith('npm ERR!') && !line.includes(' code ')) {
+                summary = line.replace('npm ERR! ', '').trim();
+                break;
+            }
+            else if (line.startsWith('npm error') && !line.includes(' code ')) {
+                summary = line.replace('npm error ', '').trim();
+                break;
+            }
+        }
+        logger?.debug(`  Successfully parsed text error with code '${code}'.`);
+        return {
+            code,
+            summary: summary || `Package manager error: ${code}`,
+        };
+    }
+    logger?.debug('  Failed to parse npm-like error. No structured error found.');
+    return null;
+}
+/**
+ * Parses the `stdout` or `stderr` output of yarn classic to extract structured error information.
+ *
+ * This parser first attempts to find an HTTP status code (e.g., 404, 401) in the verbose output.
+ * If found, it returns a standardized error code (`E${statusCode}`).
+ * If no HTTP status code is found, it falls back to parsing generic JSON error lines.
+ *
+ * Example verbose output (with HTTP status code):
+ * ```json
+ * {"type":"verbose","data":"Request \"https://registry.npmjs.org/@angular%2fnon-existent\" finished with status code 404."}
+ * ```
+ *
+ * Example generic JSON error output:
+ * ```json
+ * {"type":"error","data":"Received invalid response from npm."}
+ * ```
+ *
+ * @param output The standard output or standard error of the command.
+ * @param logger An optional logger instance.
+ * @returns An `ErrorInfo` object if parsing is successful, otherwise `null`.
+ */
+function parseYarnClassicError(output, logger) {
+    logger?.debug(`Parsing yarn classic error output...`);
+    logStdout(output, logger); // Log output for debugging purposes
+    if (!output) {
+        logger?.debug('  output is empty. No error found.');
+        return null;
+    }
+    // First, check for any HTTP status code in the verbose output.
+    const statusCodeMatch = output.match(/finished with status code (\d{3})/);
+    if (statusCodeMatch) {
+        const statusCode = Number(statusCodeMatch[1]);
+        // Status codes in the 200-299 range are successful.
+        if (statusCode < 200 || statusCode >= 300) {
+            logger?.debug(`  Detected HTTP error status code '${statusCode}' in verbose output.`);
+            return {
+                code: `E${statusCode}`,
+                summary: `Request failed with status code ${statusCode}.`,
+            };
+        }
+    }
+    // Fallback to the JSON error type if no HTTP status code is present.
+    for (const json of parseJsonLines(output, logger)) {
+        if (json.type === 'error' && typeof json.data === 'string') {
+            const summary = json.data;
+            logger?.debug(`  Successfully parsed generic yarn classic error.`);
+            return {
+                code: 'UNKNOWN_ERROR',
+                summary,
+            };
+        }
+    }
+    logger?.debug('  Failed to parse yarn classic error. No structured error found.');
+    return null;
+}
+/**
+ * Parses the output of `bun pm ls`.
+ *
+ * Bun does not support JSON output for `pm ls`. The output is a tree structure:
+ * ```
+ * /path/to/project node_modules (1084)
+ * ├── @angular/core@20.3.15
+ * ├── rxjs @7.8.2
+ * └── zone.js @0.15.1
+ * ```
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns A map of package names to their installed package details.
+ */
+function parseBunDependencies(stdout, logger) {
+    logger?.debug('Parsing Bun dependency list...');
+    logStdout(stdout, logger);
+    const dependencies = new Map();
+    if (!stdout) {
+        return dependencies;
+    }
+    const lines = stdout.split('\n');
+    // Skip the first line (project info)
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line) {
+            continue;
+        }
+        // Remove tree structure characters
+        const cleanLine = line.replace(/^[└├]──\s*/, '');
+        // Parse name and version
+        // Scoped: @angular/core@20.3.15
+        // Unscoped: rxjs @7.8.2
+        const match = cleanLine.match(/^(.+?)\s?@([^@\s]+)$/);
+        if (match) {
+            const name = match[1];
+            const version = match[2];
+            dependencies.set(name, { name, version });
+        }
+    }
+    logger?.debug(`  Found ${dependencies.size} dependencies.`);
+    return dependencies;
+}
+/**
+ * Parses the output of `yarn info --name-only --json`.
+ *
+ * The expected output is a JSON stream (JSONL) of strings.
+ * Each string represents a package locator.
+ *
+ * ```
+ * "karma@npm:6.4.4"
+ * "@angular/core@npm:20.3.15"
+ * ```
+ *
+ * @param stdout The standard output of the command.
+ * @param logger An optional logger instance.
+ * @returns A map of package names to their installed package details.
+ */
+function parseYarnModernDependencies(stdout, logger) {
+    logger?.debug('Parsing Yarn Berry dependency list...');
+    logStdout(stdout, logger);
+    const dependencies = new Map();
+    if (!stdout) {
+        return dependencies;
+    }
+    for (const json of parseJsonLines(stdout, logger)) {
+        if (typeof json === 'string') {
+            const match = json.match(/^(@?[^@]+)@(.+)$/);
+            if (match) {
+                const name = match[1];
+                let version = match[2];
+                // Handle "npm:" prefix
+                if (version.startsWith('npm:')) {
+                    version = version.slice(4);
+                }
+                // Handle complex locators with embedded version metadata (e.g., "patch:...", "virtual:...")
+                // Yarn Berry often appends metadata like "::version=x.y.z"
+                const versionParamMatch = version.match(/::version=([^&]+)/);
+                if (versionParamMatch) {
+                    version = versionParamMatch[1];
+                }
+                dependencies.set(name, { name, version });
+            }
+        }
+    }
+    logger?.debug(`  Found ${dependencies.size} dependencies.`);
+    return dependencies;
+}
+//# sourceMappingURL=parsers.js.map

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

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

package/src/utilities/color.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @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 { color as colors, figures } from 'listr2';
+export declare function supportColor(stream?: NodeJS.WritableStream): boolean;

package/src/utilities/color.js

@@ -0,0 +1,28 @@
+"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.figures = exports.colors = void 0;
+exports.supportColor = supportColor;
+const node_tty_1 = require("node:tty");
+var listr2_1 = require("listr2");
+Object.defineProperty(exports, "colors", { enumerable: true, get: function () { return listr2_1.color; } });
+Object.defineProperty(exports, "figures", { enumerable: true, get: function () { return listr2_1.figures; } });
+function supportColor(stream = process.stdout) {
+    if (stream instanceof node_tty_1.WriteStream) {
+        return stream.hasColors();
+    }
+    try {
+        // The hasColors function does not rely on any instance state and should ideally be static
+        return node_tty_1.WriteStream.prototype.hasColors();
+    }
+    catch {
+        return process.env['FORCE_COLOR'] !== undefined && process.env['FORCE_COLOR'] !== '0';
+    }
+}
+//# sourceMappingURL=color.js.map

package/src/utilities/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["color.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAMH,oCAWC;AAfD,uCAAuC;AAEvC,iCAAkD;AAAzC,gGAAA,KAAK,OAAU;AAAE,iGAAA,OAAO,OAAA;AAEjC,SAAgB,YAAY,CAAC,SAAgC,OAAO,CAAC,MAAM;IACzE,IAAI,MAAM,YAAY,sBAAW,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,0FAA0F;QAC1F,OAAO,sBAAW,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,GAAG,CAAC;IACxF,CAAC;AACH,CAAC"}

package/src/utilities/completion.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 { logging } from '@angular-devkit/core';
+/**
+ * Checks if it is appropriate to prompt the user to setup autocompletion. If not, does nothing. If
+ * so prompts and sets up autocompletion for the user. Returns an exit code if the program should
+ * terminate, otherwise returns `undefined`.
+ * @returns an exit code if the program should terminate, undefined otherwise.
+ */
+export declare function considerSettingUpAutocompletion(command: string, logger: logging.Logger): Promise<number | undefined>;
+/**
+ * Sets up autocompletion for the user's terminal. This attempts to find the configuration file for
+ * the current shell (`.bashrc`, `.zshrc`, etc.) and append a command which enables autocompletion
+ * for the Angular CLI. Supports only Bash and Zsh. Returns whether or not it was successful.
+ * @return The full path of the configuration file modified.
+ */
+export declare function initializeAutocomplete(): Promise<string>;
+/**
+ * Returns whether the user has a global CLI install.
+ * Execution from `npx` is *not* considered a global CLI install.
+ *
+ * This does *not* mean the current execution is from a global CLI install, only that a global
+ * install exists on the system.
+ */
+export declare function hasGlobalCliInstall(): Promise<boolean>;