@angular/cli 20.2.0-next.2 → 20.2.0-next.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/cli",
-  "version": "20.2.0-next.2",
+  "version": "20.2.0-next.3",
   "description": "CLI tool for Angular",
   "main": "lib/cli/index.js",
   "bin": {
@@ -25,15 +25,15 @@
   },
   "homepage": "https://github.com/angular/angular-cli",
   "dependencies": {
-    "@angular-devkit/architect": "0.2002.0-next.2",
-    "@angular-devkit/core": "20.2.0-next.2",
-    "@angular-devkit/schematics": "20.2.0-next.2",
-    "@inquirer/prompts": "7.7.1",
+    "@angular-devkit/architect": "0.2002.0-next.3",
+    "@angular-devkit/core": "20.2.0-next.3",
+    "@angular-devkit/schematics": "20.2.0-next.3",
+    "@inquirer/prompts": "7.8.0",
     "@listr2/prompt-adapter-inquirer": "3.0.1",
-    "@modelcontextprotocol/sdk": "1.17.0",
-    "@schematics/angular": "20.2.0-next.2",
+    "@modelcontextprotocol/sdk": "1.17.1",
+    "@schematics/angular": "20.2.0-next.3",
     "@yarnpkg/lockfile": "1.1.0",
-    "algoliasearch": "5.34.1",
+    "algoliasearch": "5.35.0",
     "ini": "5.0.0",
     "jsonc-parser": "3.3.1",
     "listr2": "9.0.1",
@@ -47,14 +47,14 @@
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",
     "packageGroup": {
-      "@angular/cli": "20.2.0-next.2",
-      "@angular/build": "20.2.0-next.2",
-      "@angular/ssr": "20.2.0-next.2",
-      "@angular-devkit/architect": "0.2002.0-next.2",
-      "@angular-devkit/build-angular": "20.2.0-next.2",
-      "@angular-devkit/build-webpack": "0.2002.0-next.2",
-      "@angular-devkit/core": "20.2.0-next.2",
-      "@angular-devkit/schematics": "20.2.0-next.2"
+      "@angular/cli": "20.2.0-next.3",
+      "@angular/build": "20.2.0-next.3",
+      "@angular/ssr": "20.2.0-next.3",
+      "@angular-devkit/architect": "0.2002.0-next.3",
+      "@angular-devkit/build-angular": "20.2.0-next.3",
+      "@angular-devkit/build-webpack": "0.2002.0-next.3",
+      "@angular-devkit/core": "20.2.0-next.3",
+      "@angular-devkit/schematics": "20.2.0-next.3"
     }
   },
   "packageManager": "pnpm@9.15.9",

package/src/commands/mcp/cli.js

@@ -18,7 +18,7 @@ To start using the Angular CLI MCP Server, add this configuration to your host:
   "mcpServers": {
     "angular-cli": {
       "command": "npx",
-      "args": ["@angular/cli", "mcp"]
+      "args": ["-y", "@angular/cli", "mcp"]
     }
   }
 }

package/src/commands/mcp/mcp-server.js

@@ -23,10 +23,14 @@ async function createMcpServer(context, logger) {
     const server = new mcp_js_1.McpServer({
         name: 'angular-cli-server',
         version: version_1.VERSION.full,
+    }, {
         capabilities: {
             resources: {},
             tools: {},
+            logging: {},
         },
+        instructions: 'For Angular development, this server provides tools to adhere to best practices, search documentation, and find code examples. ' +
+            'When writing or modifying Angular code, use the MCP server and its tools instead of direct shell commands where possible.',
     });
     server.registerResource('instructions', 'instructions://best-practices', {
         title: 'Angular Best Practices and Code Generation Guide',
@@ -41,8 +45,7 @@ async function createMcpServer(context, logger) {
     });
     (0, best_practices_1.registerBestPracticesTool)(server);
     // If run outside an Angular workspace (e.g., globally) skip the workspace specific tools.
-    // Currently only the `list_projects` tool.
-    if (!context.workspace) {
+    if (context.workspace) {
         (0, projects_1.registerListProjectsTool)(server, context);
     }
     await (0, doc_search_1.registerDocSearchTool)(server);
@@ -54,7 +57,7 @@ async function createMcpServer(context, logger) {
                 ' Registration of this tool has been skipped.');
         }
         else {
-            (0, examples_1.registerFindExampleTool)(server, node_path_1.default.join(__dirname, '../../../lib/code-examples.db'));
+            await (0, examples_1.registerFindExampleTool)(server, node_path_1.default.join(__dirname, '../../../lib/code-examples.db'));
         }
     }
     return server;

package/src/commands/mcp/tools/best-practices.js

@@ -14,6 +14,7 @@ exports.registerBestPracticesTool = registerBestPracticesTool;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 function registerBestPracticesTool(server) {
+    let bestPracticesText;
     server.registerTool('get_best_practices', {
         title: 'Get Angular Coding Best Practices Guide',
         description: 'You **MUST** use this tool to retrieve the Angular Best Practices Guide ' +
@@ -26,12 +27,16 @@ function registerBestPracticesTool(server) {
             openWorldHint: false,
         },
     }, async () => {
-        const text = await (0, promises_1.readFile)(node_path_1.default.join(__dirname, '..', 'instructions', 'best-practices.md'), 'utf-8');
+        bestPracticesText ??= await (0, promises_1.readFile)(node_path_1.default.join(__dirname, '..', 'instructions', 'best-practices.md'), 'utf-8');
         return {
             content: [
                 {
                     type: 'text',
-                    text,
+                    text: bestPracticesText,
+                    annotations: {
+                        audience: ['assistant'],
+                        priority: 0.9,
+                    },
                 },
             ],
         };

package/src/commands/mcp/tools/examples.d.ts

@@ -15,7 +15,7 @@ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
  * @param server The MCP server instance.
  * @param exampleDatabasePath The path to the SQLite database file containing the examples.
  */
-export declare function registerFindExampleTool(server: McpServer, exampleDatabasePath: string): void;
+export declare function registerFindExampleTool(server: McpServer, exampleDatabasePath: string): Promise<void>;
 /**
  * Escapes a search query for FTS5 by tokenizing and quoting terms.
  *

package/src/commands/mcp/tools/examples.js

@@ -39,9 +39,14 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerFindExampleTool = registerFindExampleTool;
 exports.escapeSearchQuery = escapeSearchQuery;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
 /**
  * Registers the `find_examples` tool with the MCP server.
@@ -52,9 +57,14 @@ const zod_1 = require("zod");
  * @param server The MCP server instance.
  * @param exampleDatabasePath The path to the SQLite database file containing the examples.
  */
-function registerFindExampleTool(server, exampleDatabasePath) {
+async function registerFindExampleTool(server, exampleDatabasePath) {
     let db;
     let queryStatement;
+    // Runtime directory of examples uses an in-memory database
+    if (process.env['NG_MCP_EXAMPLES_DIR']) {
+        db = await setupRuntimeExamples(process.env['NG_MCP_EXAMPLES_DIR']);
+    }
+    suppressSqliteWarning();
     server.registerTool('find_examples', {
         title: 'Find Angular Code Examples',
         description: 'Before writing or modifying any Angular code including templates, ' +
@@ -94,10 +104,11 @@ Examples of queries:
             openWorldHint: false,
         },
     }, async ({ query }) => {
-        if (!db || !queryStatement) {
-            suppressSqliteWarning();
+        if (!db) {
             const { DatabaseSync } = await Promise.resolve().then(() => __importStar(require('node:sqlite')));
             db = new DatabaseSync(exampleDatabasePath, { readOnly: true });
+        }
+        if (!queryStatement) {
             queryStatement = db.prepare('SELECT * from examples WHERE examples MATCH ? ORDER BY rank;');
         }
         const sanitizedQuery = escapeSearchQuery(query);
@@ -188,3 +199,19 @@ function suppressSqliteWarning() {
         return originalProcessEmit.apply(process, arguments);
     };
 }
+async function setupRuntimeExamples(examplesPath) {
+    const { DatabaseSync } = await Promise.resolve().then(() => __importStar(require('node:sqlite')));
+    const db = new DatabaseSync(':memory:');
+    db.exec(`CREATE VIRTUAL TABLE examples USING fts5(content, tokenize = 'porter ascii');`);
+    const insertStatement = db.prepare('INSERT INTO examples(content) VALUES(?);');
+    db.exec('BEGIN TRANSACTION');
+    for await (const entry of (0, promises_1.glob)('*.md', { cwd: examplesPath, withFileTypes: true })) {
+        if (!entry.isFile()) {
+            continue;
+        }
+        const example = await (0, promises_1.readFile)(node_path_1.default.join(entry.parentPath, entry.name), 'utf-8');
+        insertStatement.run(example);
+    }
+    db.exec('END TRANSACTION');
+    return db;
+}

package/src/commands/version/cli.d.ts

@@ -5,14 +5,36 @@
  * 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 { Argv } from 'yargs';
+import type { Argv } from 'yargs';
 import { CommandModule, CommandModuleImplementation } from '../../command-builder/command-module';
+/**
+ * The command-line module for the `ng version` command.
+ */
 export default class VersionCommandModule extends CommandModule implements CommandModuleImplementation {
     command: string;
     aliases: string[] | undefined;
     describe: string;
     longDescriptionPath?: string | undefined;
+    /**
+     * Builds the command-line options for the `ng version` command.
+     * @param localYargs The `yargs` instance to configure.
+     * @returns The configured `yargs` instance.
+     */
     builder(localYargs: Argv): Argv;
+    /**
+     * The main execution logic for the `ng version` command.
+     */
     run(): Promise<void>;
-    private getVersion;
+    /**
+     * Formats the Angular packages section of the version output.
+     * @param versionInfo An object containing the version information.
+     * @returns A string containing the formatted Angular packages information.
+     */
+    private formatAngularPackages;
+    /**
+     * Formats the package table section of the version output.
+     * @param versions A map of package names to their versions.
+     * @returns A string containing the formatted package table.
+     */
+    private formatPackageTable;
 }

package/src/commands/version/cli.js

@@ -6,104 +6,74 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_module_1 = __importDefault(require("node:module"));
-const node_path_1 = require("node:path");
 const command_module_1 = require("../../command-builder/command-module");
 const color_1 = require("../../utilities/color");
 const command_config_1 = require("../command-config");
+const version_info_1 = require("./version-info");
 /**
- * Major versions of Node.js that are officially supported by Angular.
+ * The Angular CLI logo, displayed as ASCII art.
+ */
+const ASCII_ART = `
+     _                      _                 ____ _     ___
+    / \\   _ __   __ _ _   _| | __ _ _ __     / ___| |   |_ _|
+   / △ \\ | '_ \\ / _\` | | | | |/ _\` | '__|   | |   | |    | |
+  / ___ \\| | | | (_| | |_| | | (_| | |      | |___| |___ | |
+ /_/   \\_\\_| |_|\\__, |\\__,_|_|\\__,_|_|       \\____|_____|___|
+                |___/
+    `
+    .split('\n')
+    .map((x) => color_1.colors.red(x))
+    .join('\n');
+/**
+ * The command-line module for the `ng version` command.
  */
-const SUPPORTED_NODE_MAJORS = [20, 22, 24];
-const PACKAGE_PATTERNS = [
-    /^@angular\/.*/,
-    /^@angular-devkit\/.*/,
-    /^@ngtools\/.*/,
-    /^@schematics\/.*/,
-    /^rxjs$/,
-    /^typescript$/,
-    /^ng-packagr$/,
-    /^webpack$/,
-    /^zone\.js$/,
-];
 class VersionCommandModule extends command_module_1.CommandModule {
     command = 'version';
     aliases = command_config_1.RootCommands['version'].aliases;
     describe = 'Outputs Angular CLI version.';
     longDescriptionPath;
+    /**
+     * Builds the command-line options for the `ng version` command.
+     * @param localYargs The `yargs` instance to configure.
+     * @returns The configured `yargs` instance.
+     */
     builder(localYargs) {
         return localYargs;
     }
+    /**
+     * The main execution logic for the `ng version` command.
+     */
     async run() {
-        const { packageManager, logger, root } = this.context;
-        const localRequire = node_module_1.default.createRequire((0, node_path_1.resolve)(__filename, '../../../'));
-        // Trailing slash is used to allow the path to be treated as a directory
-        const workspaceRequire = node_module_1.default.createRequire(root + '/');
-        const cliPackage = localRequire('./package.json');
-        let workspacePackage;
-        try {
-            workspacePackage = workspaceRequire('./package.json');
-        }
-        catch { }
-        const [nodeMajor] = process.versions.node.split('.').map((part) => Number(part));
-        const unsupportedNodeVersion = !SUPPORTED_NODE_MAJORS.includes(nodeMajor);
-        const packageNames = new Set(Object.keys({
-            ...cliPackage.dependencies,
-            ...cliPackage.devDependencies,
-            ...workspacePackage?.dependencies,
-            ...workspacePackage?.devDependencies,
-        }));
-        const versions = {};
-        for (const name of packageNames) {
-            if (PACKAGE_PATTERNS.some((p) => p.test(name))) {
-                versions[name] = this.getVersion(name, workspaceRequire, localRequire);
-            }
+        const { logger } = this.context;
+        const versionInfo = (0, version_info_1.gatherVersionInfo)(this.context);
+        const { ngCliVersion, nodeVersion, unsupportedNodeVersion, packageManagerName, packageManagerVersion, os, arch, versions, } = versionInfo;
+        const header = `
+      Angular CLI: ${ngCliVersion}
+      Node: ${nodeVersion}${unsupportedNodeVersion ? ' (Unsupported)' : ''}
+      Package Manager: ${packageManagerName} ${packageManagerVersion ?? '<error>'}
+      OS: ${os} ${arch}
+    `.replace(/^ {6}/gm, '');
+        const angularPackages = this.formatAngularPackages(versionInfo);
+        const packageTable = this.formatPackageTable(versions);
+        logger.info([ASCII_ART, header, angularPackages, packageTable].join('\n\n'));
+        if (unsupportedNodeVersion) {
+            logger.warn(`Warning: The current version of Node (${nodeVersion}) is not supported by Angular.`);
         }
-        const ngCliVersion = cliPackage.version;
-        let angularCoreVersion = '';
-        const angularSameAsCore = [];
-        if (workspacePackage) {
-            // Filter all angular versions that are the same as core.
-            angularCoreVersion = versions['@angular/core'];
-            if (angularCoreVersion) {
-                for (const [name, version] of Object.entries(versions)) {
-                    if (version === angularCoreVersion && name.startsWith('@angular/')) {
-                        angularSameAsCore.push(name.replace(/^@angular\//, ''));
-                        delete versions[name];
-                    }
-                }
-                // Make sure we list them in alphabetical order.
-                angularSameAsCore.sort();
-            }
+    }
+    /**
+     * Formats the Angular packages section of the version output.
+     * @param versionInfo An object containing the version information.
+     * @returns A string containing the formatted Angular packages information.
+     */
+    formatAngularPackages(versionInfo) {
+        const { angularCoreVersion, angularSameAsCore } = versionInfo;
+        if (!angularCoreVersion) {
+            return 'Angular: <error>';
         }
-        const namePad = ' '.repeat(Object.keys(versions).sort((a, b) => b.length - a.length)[0].length + 3);
-        const asciiArt = `
-     _                      _                 ____ _     ___
-    / \\   _ __   __ _ _   _| | __ _ _ __     / ___| |   |_ _|
-   / △ \\ | '_ \\ / _\` | | | | |/ _\` | '__|   | |   | |    | |
-  / ___ \\| | | | (_| | |_| | | (_| | |      | |___| |___ | |
- /_/   \\_\\_| |_|\\__, |\\__,_|_|\\__,_|_|       \\____|_____|___|
-                |___/
-    `
-            .split('\n')
-            .map((x) => color_1.colors.red(x))
-            .join('\n');
-        logger.info(asciiArt);
-        logger.info(`
-      Angular CLI: ${ngCliVersion}
-      Node: ${process.versions.node}${unsupportedNodeVersion ? ' (Unsupported)' : ''}
-      Package Manager: ${packageManager.name} ${packageManager.version ?? '<error>'}
-      OS: ${process.platform} ${process.arch}
-
-      Angular: ${angularCoreVersion}
-      ... ${angularSameAsCore
+        const wrappedPackages = angularSameAsCore
             .reduce((acc, name) => {
-            // Perform a simple word wrap around 60.
-            if (acc.length == 0) {
+            if (acc.length === 0) {
                 return [name];
             }
             const line = acc[acc.length - 1] + ', ' + name;
@@ -115,43 +85,32 @@ class VersionCommandModule extends command_module_1.CommandModule {
             }
             return acc;
         }, [])
-            .join('\n... ')}
-
-      Package${namePad.slice(7)}Version
-      -------${namePad.replace(/ /g, '-')}------------------
-      ${Object.keys(versions)
-            .map((module) => `${module}${namePad.slice(module.length)}${versions[module]}`)
-            .sort()
-            .join('\n')}
-    `.replace(/^ {6}/gm, ''));
-        if (unsupportedNodeVersion) {
-            logger.warn(`Warning: The current version of Node (${process.versions.node}) is not supported by Angular.`);
-        }
+            .join('\n... ');
+        return `Angular: ${angularCoreVersion}\n... ${wrappedPackages}`;
     }
-    getVersion(moduleName, workspaceRequire, localRequire) {
-        let packageInfo;
-        let cliOnly = false;
-        // Try to find the package in the workspace
-        try {
-            packageInfo = workspaceRequire(`${moduleName}/package.json`);
-        }
-        catch { }
-        // If not found, try to find within the CLI
-        if (!packageInfo) {
-            try {
-                packageInfo = localRequire(`${moduleName}/package.json`);
-                cliOnly = true;
-            }
-            catch { }
+    /**
+     * Formats the package table section of the version output.
+     * @param versions A map of package names to their versions.
+     * @returns A string containing the formatted package table.
+     */
+    formatPackageTable(versions) {
+        const versionKeys = Object.keys(versions);
+        if (versionKeys.length === 0) {
+            return '';
         }
-        // If found, attempt to get the version
-        if (packageInfo) {
-            try {
-                return packageInfo.version + (cliOnly ? ' (cli-only)' : '');
-            }
-            catch { }
-        }
-        return '<error>';
+        const header = 'Package';
+        const maxNameLength = Math.max(...versionKeys.map((key) => key.length));
+        const namePad = ' '.repeat(Math.max(0, maxNameLength - header.length) + 3);
+        const tableHeader = `${header}${namePad}Version`;
+        const separator = '-'.repeat(tableHeader.length);
+        const tableRows = versionKeys
+            .map((module) => {
+            const padding = ' '.repeat(maxNameLength - module.length + 3);
+            return `${module}${padding}${versions[module]}`;
+        })
+            .sort()
+            .join('\n');
+        return `${tableHeader}\n${separator}\n${tableRows}`;
     }
 }
 exports.default = VersionCommandModule;

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

@@ -0,0 +1,33 @@
+/**
+ * @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
+ */
+/**
+ * An object containing all the version information that will be displayed by the command.
+ */
+export interface VersionInfo {
+    ngCliVersion: string;
+    angularCoreVersion: string;
+    angularSameAsCore: string[];
+    versions: Record<string, string>;
+    unsupportedNodeVersion: boolean;
+    nodeVersion: string;
+    packageManagerName: string;
+    packageManagerVersion: string | undefined;
+    os: string;
+    arch: string;
+}
+/**
+ * Gathers all the version information from the environment and workspace.
+ * @returns An object containing all the version information.
+ */
+export declare function gatherVersionInfo(context: {
+    packageManager: {
+        name: string;
+        version: string | undefined;
+    };
+    root: string;
+}): VersionInfo;

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

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gatherVersionInfo = gatherVersionInfo;
+const node_module_1 = require("node:module");
+const node_path_1 = require("node:path");
+/**
+ * Major versions of Node.js that are officially supported by Angular.
+ * @see https://angular.dev/reference/versions#supported-node-js-versions
+ */
+const SUPPORTED_NODE_MAJORS = [20, 22, 24];
+/**
+ * A list of regular expression patterns that match package names that should be included in the
+ * version output.
+ */
+const PACKAGE_PATTERNS = [
+    /^@angular\/.*/,
+    /^@angular-devkit\/.*/,
+    /^@ngtools\/.*/,
+    /^@schematics\/.*/,
+    /^rxjs$/,
+    /^typescript$/,
+    /^ng-packagr$/,
+    /^webpack$/,
+    /^zone\.js$/,
+];
+/**
+ * Gathers all the version information from the environment and workspace.
+ * @returns An object containing all the version information.
+ */
+function gatherVersionInfo(context) {
+    const localRequire = (0, node_module_1.createRequire)((0, node_path_1.resolve)(__filename, '../../../'));
+    // Trailing slash is used to allow the path to be treated as a directory
+    const workspaceRequire = (0, node_module_1.createRequire)(context.root + '/');
+    const cliPackage = localRequire('./package.json');
+    let workspacePackage;
+    try {
+        workspacePackage = workspaceRequire('./package.json');
+    }
+    catch { }
+    const [nodeMajor] = process.versions.node.split('.').map((part) => Number(part));
+    const unsupportedNodeVersion = !SUPPORTED_NODE_MAJORS.includes(nodeMajor);
+    const packageNames = new Set(Object.keys({
+        ...cliPackage.dependencies,
+        ...cliPackage.devDependencies,
+        ...workspacePackage?.dependencies,
+        ...workspacePackage?.devDependencies,
+    }));
+    const versions = {};
+    for (const name of packageNames) {
+        if (PACKAGE_PATTERNS.some((p) => p.test(name))) {
+            versions[name] = getVersion(name, workspaceRequire, localRequire);
+        }
+    }
+    const ngCliVersion = cliPackage.version;
+    let angularCoreVersion = '';
+    const angularSameAsCore = [];
+    if (workspacePackage) {
+        // Filter all angular versions that are the same as core.
+        angularCoreVersion = versions['@angular/core'];
+        if (angularCoreVersion) {
+            for (const [name, version] of Object.entries(versions)) {
+                if (version === angularCoreVersion && name.startsWith('@angular/')) {
+                    angularSameAsCore.push(name.replace(/^@angular\//, ''));
+                    delete versions[name];
+                }
+            }
+            // Make sure we list them in alphabetical order.
+            angularSameAsCore.sort();
+        }
+    }
+    return {
+        ngCliVersion,
+        angularCoreVersion,
+        angularSameAsCore,
+        versions,
+        unsupportedNodeVersion,
+        nodeVersion: process.versions.node,
+        packageManagerName: context.packageManager.name,
+        packageManagerVersion: context.packageManager.version,
+        os: process.platform,
+        arch: process.arch,
+    };
+}
+/**
+ * Gets the version of a package.
+ * @param moduleName The name of the package.
+ * @param workspaceRequire A `require` function for the workspace.
+ * @param localRequire A `require` function for the CLI.
+ * @returns The version of the package, or `<error>` if it could not be found.
+ */
+function getVersion(moduleName, workspaceRequire, localRequire) {
+    let packageInfo;
+    let cliOnly = false;
+    // Try to find the package in the workspace
+    try {
+        packageInfo = workspaceRequire(`${moduleName}/package.json`);
+    }
+    catch { }
+    // If not found, try to find within the CLI
+    if (!packageInfo) {
+        try {
+            packageInfo = localRequire(`${moduleName}/package.json`);
+            cliOnly = true;
+        }
+        catch { }
+    }
+    // If found, attempt to get the version
+    if (packageInfo) {
+        try {
+            return packageInfo.version + (cliOnly ? ' (cli-only)' : '');
+        }
+        catch { }
+    }
+    return '<error>';
+}

package/src/utilities/environment-options.d.ts

@@ -5,8 +5,21 @@
  * 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
  */
+/** Disables all analytics reporting when the `NG_CLI_ANALYTICS` environment variable is set to '0' or 'false'. */
 export declare const analyticsDisabled: boolean;
+/** Identifies when the CLI is running in a Continuous Integration environment. */
 export declare const isCI: boolean;
+/** Disables the automatic version check when the `NG_DISABLE_VERSION_CHECK` environment variable is enabled. */
 export declare const disableVersionCheck: boolean;
+/** Enables debugging messages when the `NG_DEBUG` environment variable is enabled. */
 export declare const ngDebug: boolean;
+/**
+ * Forces the autocomplete script to be generated.
+ * The `NG_FORCE_AUTOCOMPLETE` environment variable can be 'true', 'false', or undefined (for default behavior).
+ */
 export declare const forceAutocomplete: boolean | undefined;
+/**
+ * When enabled, forces TTY mode.
+ * The `NG_FORCE_TTY` environment variable can be 'true', 'false', or undefined (for default behavior).
+ */
+export declare const forceTty: boolean | undefined;

package/src/utilities/environment-options.js

@@ -7,24 +7,53 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.forceAutocomplete = exports.ngDebug = exports.disableVersionCheck = exports.isCI = exports.analyticsDisabled = void 0;
+exports.forceTty = exports.forceAutocomplete = exports.ngDebug = exports.disableVersionCheck = exports.isCI = exports.analyticsDisabled = void 0;
+/** A set of strings that are considered "truthy" when parsing environment variables. */
+const TRUTHY_VALUES = new Set(['1', 'true']);
+/** A set of strings that are considered "falsy" when parsing environment variables. */
+const FALSY_VALUES = new Set(['0', 'false']);
+/**
+ * Checks if an environment variable is present and has a non-empty value.
+ * @param variable The environment variable to check.
+ * @returns `true` if the variable is a non-empty string.
+ */
 function isPresent(variable) {
     return typeof variable === 'string' && variable !== '';
 }
-function isDisabled(variable) {
-    return isPresent(variable) && (variable === '0' || variable.toLowerCase() === 'false');
-}
-function isEnabled(variable) {
-    return isPresent(variable) && (variable === '1' || variable.toLowerCase() === 'true');
-}
-function optional(variable) {
+/**
+ * Parses an environment variable into a boolean or undefined.
+ * @returns `true` if the variable is truthy ('1', 'true').
+ * @returns `false` if the variable is falsy ('0', 'false').
+ * @returns `undefined` if the variable is not present or has an unknown value.
+ */
+function parseTristate(variable) {
     if (!isPresent(variable)) {
         return undefined;
     }
-    return isEnabled(variable);
+    const value = variable.toLowerCase();
+    if (TRUTHY_VALUES.has(value)) {
+        return true;
+    }
+    if (FALSY_VALUES.has(value)) {
+        return false;
+    }
+    return undefined;
 }
-exports.analyticsDisabled = isDisabled(process.env['NG_CLI_ANALYTICS']);
-exports.isCI = isEnabled(process.env['CI']);
-exports.disableVersionCheck = isEnabled(process.env['NG_DISABLE_VERSION_CHECK']);
-exports.ngDebug = isEnabled(process.env['NG_DEBUG']);
-exports.forceAutocomplete = optional(process.env['NG_FORCE_AUTOCOMPLETE']);
+/** Disables all analytics reporting when the `NG_CLI_ANALYTICS` environment variable is set to '0' or 'false'. */
+exports.analyticsDisabled = parseTristate(process.env['NG_CLI_ANALYTICS']) === false;
+/** Identifies when the CLI is running in a Continuous Integration environment. */
+exports.isCI = parseTristate(process.env['CI']) === true;
+/** Disables the automatic version check when the `NG_DISABLE_VERSION_CHECK` environment variable is enabled. */
+exports.disableVersionCheck = parseTristate(process.env['NG_DISABLE_VERSION_CHECK']) === true;
+/** Enables debugging messages when the `NG_DEBUG` environment variable is enabled. */
+exports.ngDebug = parseTristate(process.env['NG_DEBUG']) === true;
+/**
+ * Forces the autocomplete script to be generated.
+ * The `NG_FORCE_AUTOCOMPLETE` environment variable can be 'true', 'false', or undefined (for default behavior).
+ */
+exports.forceAutocomplete = parseTristate(process.env['NG_FORCE_AUTOCOMPLETE']);
+/**
+ * When enabled, forces TTY mode.
+ * The `NG_FORCE_TTY` environment variable can be 'true', 'false', or undefined (for default behavior).
+ */
+exports.forceTty = parseTristate(process.env['NG_FORCE_TTY']);

package/src/utilities/tty.d.ts

@@ -5,4 +5,12 @@
  * 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
  */
+/**
+ * Determines if the `stream` is a TTY.
+ *
+ * @param stream A NodeJS stream to check. Defaults to `process.stdout`.
+ * @returns `true` if the `stream` is a TTY, `false` otherwise. This detection is overridden
+ * by the `NG_FORCE_TTY` environment variable. In a CI environment, this will also be `false`
+ * unless `NG_FORCE_TTY` is set.
+ */
 export declare function isTTY(stream?: NodeJS.WriteStream): boolean;

package/src/utilities/tty.js

@@ -8,15 +8,15 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isTTY = isTTY;
-function _isTruthy(value) {
-    // Returns true if value is a string that is anything but 0 or false.
-    return value !== undefined && value !== '0' && value.toUpperCase() !== 'FALSE';
-}
+const environment_options_1 = require("./environment-options");
+/**
+ * Determines if the `stream` is a TTY.
+ *
+ * @param stream A NodeJS stream to check. Defaults to `process.stdout`.
+ * @returns `true` if the `stream` is a TTY, `false` otherwise. This detection is overridden
+ * by the `NG_FORCE_TTY` environment variable. In a CI environment, this will also be `false`
+ * unless `NG_FORCE_TTY` is set.
+ */
 function isTTY(stream = process.stdout) {
-    // If we force TTY, we always return true.
-    const force = process.env['NG_FORCE_TTY'];
-    if (force !== undefined) {
-        return _isTruthy(force);
-    }
-    return !!stream.isTTY && !_isTruthy(process.env['CI']);
+    return environment_options_1.forceTty ?? (!!stream.isTTY && !environment_options_1.isCI);
 }

package/src/utilities/version.js

@@ -22,4 +22,4 @@ class Version {
         this.patch = patch;
     }
 }
-exports.VERSION = new Version('20.2.0-next.2');
+exports.VERSION = new Version('20.2.0-next.3');

package/src/utilities/load-esm.d.ts

@@ -1,20 +0,0 @@
-/**
- * @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
- */
-/**
- * This uses a dynamic import to load a module which may be ESM.
- * CommonJS code can load ESM code via a dynamic import. Unfortunately, TypeScript
- * will currently, unconditionally downlevel dynamic import into a require call.
- * require calls cannot load ESM code and will result in a runtime error. To workaround
- * this, a Function constructor is used to prevent TypeScript from changing the dynamic import.
- * Once TypeScript provides support for keeping the dynamic import this workaround can
- * be dropped.
- *
- * @param modulePath The path of the module to load.
- * @returns A Promise that resolves to the dynamically imported module.
- */
-export declare function loadEsmModule<T>(modulePath: string | URL): Promise<T>;

package/src/utilities/load-esm.js

@@ -1,30 +0,0 @@
-"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.loadEsmModule = loadEsmModule;
-/**
- * Lazily compiled dynamic import loader function.
- */
-let load;
-/**
- * This uses a dynamic import to load a module which may be ESM.
- * CommonJS code can load ESM code via a dynamic import. Unfortunately, TypeScript
- * will currently, unconditionally downlevel dynamic import into a require call.
- * require calls cannot load ESM code and will result in a runtime error. To workaround
- * this, a Function constructor is used to prevent TypeScript from changing the dynamic import.
- * Once TypeScript provides support for keeping the dynamic import this workaround can
- * be dropped.
- *
- * @param modulePath The path of the module to load.
- * @returns A Promise that resolves to the dynamically imported module.
- */
-function loadEsmModule(modulePath) {
-    load ??= new Function('modulePath', `return import(modulePath);`);
-    return load(modulePath);
-}