@angular/cli 22.2.0 → 22.3.0-next.0

package/lib/cli-PRIRL3WP.js

@@ -0,0 +1,185 @@
+import {
+  isNodeVersionSupported
+} from "./chunk-XFL2J3CJ.js";
+import {
+  RootCommands
+} from "./chunk-5AASRQKS.js";
+import {
+  CommandModule
+} from "./chunk-YM7ILCS5.js";
+import {
+  VERSION
+} from "./chunk-XG3HVNIL.js";
+import {
+  colors
+} from "./chunk-GHUUJYOY.js";
+import "./chunk-FZ5GFCWU.js";
+
+// packages/angular/cli/src/commands/version/version-info.js
+import { createRequire } from "node:module";
+var PACKAGE_PATTERNS = [
+  /^@angular\/.*/,
+  /^@angular-devkit\/.*/,
+  /^@ngtools\/.*/,
+  /^@schematics\/.*/,
+  /^rxjs$/,
+  /^typescript$/,
+  /^ng-packagr$/,
+  /^vitest$/,
+  /^webpack$/,
+  /^zone\.js$/
+];
+async function gatherVersionInfo(context) {
+  const workspaceRequire = createRequire(context.root + "/");
+  let workspacePackage;
+  try {
+    workspacePackage = workspaceRequire("./package.json");
+  } catch {
+  }
+  const allDependencies = {
+    ...workspacePackage?.dependencies,
+    ...workspacePackage?.devDependencies
+  };
+  const packageNames = new Set(Object.keys(allDependencies));
+  const packages = {};
+  for (const name of packageNames) {
+    if (PACKAGE_PATTERNS.some((p) => p.test(name))) {
+      packages[name] = {
+        requested: allDependencies[name] ?? "error",
+        installed: getVersion(name, workspaceRequire)
+      };
+    }
+  }
+  const angularCoreVersion = packages["@angular/core"];
+  return {
+    cli: {
+      version: VERSION.full
+    },
+    framework: {
+      version: angularCoreVersion?.installed
+    },
+    system: {
+      node: {
+        version: process.versions.node,
+        unsupported: !isNodeVersionSupported()
+      },
+      os: {
+        platform: process.platform,
+        architecture: process.arch
+      },
+      packageManager: {
+        name: context.packageManager.name,
+        version: await context.packageManager.getVersion()
+      }
+    },
+    packages
+  };
+}
+function getVersion(moduleName, workspaceRequire) {
+  let packageInfo;
+  try {
+    packageInfo = workspaceRequire(`${moduleName}/package.json`);
+  } catch {
+  }
+  if (packageInfo) {
+    return packageInfo.version;
+  }
+  return "<error>";
+}
+
+// packages/angular/cli/src/commands/version/cli.js
+var ASCII_ART = `
+     _                      _                 ____ _     ___
+    / \\   _ __   __ _ _   _| | __ _ _ __     / ___| |   |_ _|
+   / \u25B3 \\ | '_ \\ / _\` | | | | |/ _\` | '__|   | |   | |    | |
+  / ___ \\| | | | (_| | |_| | | (_| | |      | |___| |___ | |
+ /_/   \\_\\_| |_|\\__, |\\__,_|_|\\__,_|_|       \\____|_____|___|
+                |___/
+    `.split("\n").map((x) => colors.red(x)).join("\n");
+var VersionCommandModule = class extends CommandModule {
+  command = "version";
+  aliases = RootCommands["version"].aliases;
+  describe = "Outputs Angular CLI version.";
+  /**
+   * 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.option("json", {
+      describe: "Outputs version information in JSON format.",
+      type: "boolean"
+    });
+  }
+  /**
+   * The main execution logic for the `ng version` command.
+   */
+  async run(options) {
+    const { logger } = this.context;
+    const versionInfo = await gatherVersionInfo(this.context);
+    if (options.json) {
+      console.log(JSON.stringify(versionInfo, null, 2));
+      return;
+    }
+    const { cli: { version: ngCliVersion }, framework, system: { node: { version: nodeVersion, unsupported: unsupportedNodeVersion }, os: { platform: os, architecture: arch }, packageManager: { name: packageManagerName, version: packageManagerVersion } }, packages } = versionInfo;
+    const headerInfo = [{ label: "Angular CLI", value: ngCliVersion }];
+    if (framework.version) {
+      headerInfo.push({ label: "Angular", value: framework.version });
+    }
+    headerInfo.push({
+      label: "Node.js",
+      value: `${nodeVersion}${unsupportedNodeVersion ? colors.yellow(" (Unsupported)") : ""}`
+    }, {
+      label: "Package Manager",
+      value: `${packageManagerName} ${packageManagerVersion ?? "<error>"}`
+    }, { label: "Operating System", value: `${os} ${arch}` });
+    const maxHeaderLabelLength = Math.max(...headerInfo.map((l) => l.label.length));
+    const header = headerInfo.map(({ label, value }) => colors.bold(label.padEnd(maxHeaderLabelLength + 2)) + `: ${colors.cyan(value)}`).join("\n");
+    const packageTable = this.formatPackageTable(packages);
+    logger.info([ASCII_ART, header, packageTable].join("\n\n"));
+    if (unsupportedNodeVersion) {
+      logger.warn(`Warning: The current version of Node (${nodeVersion}) is not supported by Angular.`);
+    }
+  }
+  /**
+   * 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 "";
+    }
+    const headers = {
+      name: "Package",
+      installed: "Installed Version",
+      requested: "Requested Version"
+    };
+    const maxNameLength = Math.max(headers.name.length, ...versionKeys.map((key) => key.length));
+    const maxInstalledLength = Math.max(headers.installed.length, ...versionKeys.map((key) => versions[key].installed.length));
+    const maxRequestedLength = Math.max(headers.requested.length, ...versionKeys.map((key) => versions[key].requested.length));
+    const tableRows = versionKeys.map((module) => {
+      const { requested, installed } = versions[module];
+      const name = module.padEnd(maxNameLength);
+      const coloredInstalled = installed === "<error>" ? colors.red(installed) : colors.cyan(installed);
+      const installedPadding = " ".repeat(maxInstalledLength - installed.length);
+      return `\u2502 ${name} \u2502 ${coloredInstalled}${installedPadding} \u2502 ${requested.padEnd(maxRequestedLength)} \u2502`;
+    }).sort();
+    const top = `\u250C\u2500${"\u2500".repeat(maxNameLength)}\u2500\u252C\u2500${"\u2500".repeat(maxInstalledLength)}\u2500\u252C\u2500${"\u2500".repeat(maxRequestedLength)}\u2500\u2510`;
+    const header = `\u2502 ${headers.name.padEnd(maxNameLength)} \u2502 ${headers.installed.padEnd(maxInstalledLength)} \u2502 ${headers.requested.padEnd(maxRequestedLength)} \u2502`;
+    const separator = `\u251C\u2500${"\u2500".repeat(maxNameLength)}\u2500\u253C\u2500${"\u2500".repeat(maxInstalledLength)}\u2500\u253C\u2500${"\u2500".repeat(maxRequestedLength)}\u2500\u2524`;
+    const bottom = `\u2514\u2500${"\u2500".repeat(maxNameLength)}\u2500\u2534\u2500${"\u2500".repeat(maxInstalledLength)}\u2500\u2534\u2500${"\u2500".repeat(maxRequestedLength)}\u2500\u2518`;
+    return [top, header, separator, ...tableRows, bottom].join("\n");
+  }
+};
+export {
+  VersionCommandModule as default
+};
+/**
+ * @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
+ */

package/lib/cli-PU5VH7JB.js

@@ -0,0 +1,189 @@
+import {
+  getCacheConfig,
+  updateCacheConfig
+} from "./chunk-A2VIYA2E.js";
+import {
+  addCommandModuleToYargs,
+  demandCommandFailureMessage
+} from "./chunk-G7TRU43D.js";
+import {
+  CommandModule,
+  CommandScope
+} from "./chunk-YM7ILCS5.js";
+import {
+  isCI
+} from "./chunk-XG3HVNIL.js";
+import {
+  colors
+} from "./chunk-GHUUJYOY.js";
+import "./chunk-FZ5GFCWU.js";
+
+// packages/angular/cli/src/commands/cache/clean/cli.js
+import { rm } from "node:fs/promises";
+var CacheCleanModule = class extends CommandModule {
+  command = "clean";
+  describe = "Deletes persistent disk cache from disk.";
+  scope = CommandScope.In;
+  builder(localYargs) {
+    return localYargs.strict();
+  }
+  run() {
+    const { path } = getCacheConfig(this.context.workspace);
+    return rm(path, {
+      force: true,
+      recursive: true,
+      maxRetries: 3
+    });
+  }
+};
+
+// packages/angular/cli/src/commands/cache/info/cli.js
+import * as fs from "node:fs/promises";
+import { join } from "node:path";
+var CacheInfoCommandModule = class extends CommandModule {
+  command = "info";
+  describe = "Prints persistent disk cache configuration and statistics in the console.";
+  scope = CommandScope.In;
+  builder(localYargs) {
+    return localYargs.strict();
+  }
+  async run() {
+    const cacheConfig = getCacheConfig(this.context.workspace);
+    const { path, environment, enabled } = cacheConfig;
+    const effectiveStatus = this.effectiveEnabledStatus(cacheConfig);
+    const sizeOnDisk = await this.getSizeOfDirectory(path);
+    const info = [
+      {
+        label: "Enabled",
+        value: enabled ? colors.green("Yes") : colors.red("No")
+      },
+      {
+        label: "Environment",
+        value: colors.cyan(environment)
+      },
+      {
+        label: "Path",
+        value: colors.cyan(path)
+      },
+      {
+        label: "Size on disk",
+        value: colors.cyan(sizeOnDisk)
+      },
+      {
+        label: "Effective Status",
+        value: (effectiveStatus ? colors.green("Enabled") : colors.red("Disabled")) + " (current machine)"
+      }
+    ];
+    const maxLabelLength = Math.max(...info.map((l) => l.label.length));
+    const output = info.map(({ label, value }) => colors.bold(label.padEnd(maxLabelLength + 2)) + `: ${value}`).join("\n");
+    this.context.logger.info(`
+${colors.bold("Cache Information")}
+
+${output}
+`);
+  }
+  async getSizeOfDirectory(path) {
+    const directoriesStack = [path];
+    let size = 0;
+    while (directoriesStack.length) {
+      const dirPath = directoriesStack.pop();
+      let entries = [];
+      try {
+        entries = await fs.readdir(dirPath);
+      } catch {
+      }
+      for (const entry of entries) {
+        const entryPath = join(dirPath, entry);
+        const stats = await fs.stat(entryPath);
+        if (stats.isDirectory()) {
+          directoriesStack.push(entryPath);
+        }
+        size += stats.size;
+      }
+    }
+    return this.formatSize(size);
+  }
+  formatSize(size) {
+    if (size <= 0) {
+      return "0 bytes";
+    }
+    const abbreviations = ["bytes", "kB", "MB", "GB"];
+    const index = Math.floor(Math.log(size) / Math.log(1024));
+    const roundedSize = size / Math.pow(1024, index);
+    const fractionDigits = index === 0 ? 0 : 2;
+    return `${roundedSize.toFixed(fractionDigits)} ${abbreviations[index]}`;
+  }
+  effectiveEnabledStatus(cacheConfig) {
+    const { enabled, environment } = cacheConfig;
+    if (enabled) {
+      switch (environment) {
+        case "ci":
+          return isCI;
+        case "local":
+          return !isCI;
+      }
+    }
+    return enabled;
+  }
+};
+
+// packages/angular/cli/src/commands/cache/long-description.md
+var long_description_default = 'Angular CLI saves a number of cachable operations on disk by default.\n\nWhen you re-run the same build, the build system restores the state of the previous build and re-uses previously performed operations, which decreases the time taken to build and test your applications and libraries.\n\nTo amend the default cache settings, add the `cli.cache` object to your [Workspace Configuration](reference/configs/workspace-config).\nThe object goes under `cli.cache` at the top level of the file, outside the `projects` sections.\n\n```jsonc\n{\n  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",\n  "version": 1,\n  "cli": {\n    "cache": {\n      // ...\n    },\n  },\n  "projects": {},\n}\n```\n\nFor more information, see [cache options](reference/configs/workspace-config#cache-options).\n\n### Cache environments\n\nBy default, disk cache is only enabled for local environments. The value of environment can be one of the following:\n\n- `all` - allows disk cache on all machines.\n- `local` - allows disk cache only on development machines.\n- `ci` - allows disk cache only on continuous integration (CI) systems.\n\nTo change the environment setting to `all`, run the following command:\n\n```bash\nng config cli.cache.environment all\n```\n\nFor more information, see `environment` in [cache options](reference/configs/workspace-config#cache-options).\n\n<div class="alert is-helpful">\n\nThe Angular CLI checks for the presence and value of the `CI` environment variable to determine in which environment it is running.\n\n</div>\n\n### Cache path\n\nBy default, `.angular/cache` is used as a base directory to store cache results.\n\nTo change this path to `.cache/ng`, run the following command:\n\n```bash\nng config cli.cache.path ".cache/ng"\n```\n';
+
+// packages/angular/cli/src/commands/cache/settings/cli.js
+var CacheDisableModule = class extends CommandModule {
+  command = "disable";
+  aliases = "off";
+  describe = "Disables persistent disk cache for all projects in the workspace.";
+  scope = CommandScope.In;
+  builder(localYargs) {
+    return localYargs;
+  }
+  run() {
+    return updateCacheConfig(this.getWorkspaceOrThrow(), "enabled", false);
+  }
+};
+var CacheEnableModule = class extends CommandModule {
+  command = "enable";
+  aliases = "on";
+  describe = "Enables disk cache for all projects in the workspace.";
+  scope = CommandScope.In;
+  builder(localYargs) {
+    return localYargs;
+  }
+  run() {
+    return updateCacheConfig(this.getWorkspaceOrThrow(), "enabled", true);
+  }
+};
+
+// packages/angular/cli/src/commands/cache/cli.js
+var CacheCommandModule = class extends CommandModule {
+  command = "cache";
+  describe = "Configure persistent disk cache and retrieve cache statistics.";
+  longDescription = long_description_default;
+  scope = CommandScope.In;
+  builder(localYargs) {
+    const subcommands = [
+      CacheEnableModule,
+      CacheDisableModule,
+      CacheCleanModule,
+      CacheInfoCommandModule
+    ].sort();
+    for (const module of subcommands) {
+      addCommandModuleToYargs(module, this.context);
+    }
+    return localYargs.demandCommand(1, demandCommandFailureMessage).strict();
+  }
+  run(_options) {
+  }
+};
+export {
+  CacheCommandModule as default
+};
+/**
+ * @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
+ */

package/lib/cli-QUH44NUB.js

@@ -0,0 +1,68 @@
+import {
+  addCommandModuleToYargs
+} from "./chunk-G7TRU43D.js";
+import {
+  CommandModule,
+  hasGlobalCliInstall,
+  initializeAutocomplete
+} from "./chunk-YM7ILCS5.js";
+import "./chunk-XG3HVNIL.js";
+import {
+  colors
+} from "./chunk-GHUUJYOY.js";
+import {
+  assertIsError
+} from "./chunk-FZ5GFCWU.js";
+
+// packages/angular/cli/src/commands/completion/long-description.md
+var long_description_default = "Setting up autocompletion configures your terminal, so pressing the `<TAB>` key while in the middle\nof typing will display various commands and options available to you. This makes it very easy to\ndiscover and use CLI commands without lots of memorization.\n\n![A demo of Angular CLI autocompletion in a terminal. The user types several partial `ng` commands,\nusing autocompletion to finish several arguments and list contextual options.\n](assets/images/guide/cli/completion.gif)\n\n## Automated setup\n\nThe CLI should prompt and ask to set up autocompletion for you the first time you use it (v14+).\nSimply answer \"Yes\" and the CLI will take care of the rest.\n\n```\n$ ng serve\n? Would you like to enable autocompletion? This will set up your terminal so pressing TAB while typing Angular CLI commands will show possible options and autocomplete arguments. (Enabling autocompletion will modify configuration files in your home directory.) Yes\nAppended `source <(ng completion script)` to `/home/my-username/.bashrc`. Restart your terminal or run:\n\nsource <(ng completion script)\n\nto autocomplete `ng` commands.\n\n# Serve output...\n```\n\nIf you already refused the prompt, it won't ask again. But you can run `ng completion` to\ndo the same thing automatically.\n\nThis modifies your terminal environment to load Angular CLI autocompletion, but can't update your\ncurrent terminal session. Either restart it or run `source <(ng completion script)` directly to\nenable autocompletion in your current session.\n\nTest it out by typing `ng ser<TAB>` and it should autocomplete to `ng serve`. Ambiguous arguments\nwill show all possible options and their documentation, such as `ng generate <TAB>`.\n\n## Manual setup\n\nSome users may have highly customized terminal setups, possibly with configuration files checked\ninto source control with an opinionated structure. `ng completion` only ever appends Angular's setup\nto an existing configuration file for your current shell, or creates one if none exists. If you want\nmore control over exactly where this configuration lives, you can manually set it up by having your\nshell run at startup:\n\n```bash\nsource <(ng completion script)\n```\n\nThis is equivalent to what `ng completion` will automatically set up, and gives power users more\nflexibility in their environments when desired.\n\n## Platform support\n\nAngular CLI supports autocompletion for the Bash and Zsh shells on MacOS and Linux operating\nsystems. On Windows, Git Bash and [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/)\nusing Bash or Zsh are supported.\n\n## Global install\n\nAutocompletion works by configuring your terminal to invoke the Angular CLI on startup to load the\nsetup script. This means the terminal must be able to find and execute the Angular CLI, typically\nthrough a global install that places the binary on the user's `$PATH`. If you get\n`command not found: ng`, make sure the CLI is installed globally which you can do with the `-g`\nflag:\n\n```bash\nnpm install -g @angular/cli\n```\n";
+
+// packages/angular/cli/src/commands/completion/cli.js
+var CompletionCommandModule = class extends CommandModule {
+  command = "completion";
+  describe = "Set up Angular CLI autocompletion for your terminal.";
+  longDescription = long_description_default;
+  builder(localYargs) {
+    addCommandModuleToYargs(CompletionScriptCommandModule, this.context);
+    return localYargs;
+  }
+  async run() {
+    let rcFile;
+    try {
+      rcFile = await initializeAutocomplete();
+    } catch (err) {
+      assertIsError(err);
+      this.context.logger.error(err.message);
+      return 1;
+    }
+    this.context.logger.info(`
+Appended \`source <(ng completion script)\` to \`${rcFile}\`. Restart your terminal or run the following to autocomplete \`ng\` commands:
+
+    ${colors.yellow("source <(ng completion script)")}
+      `.trim());
+    if (await hasGlobalCliInstall() === false) {
+      this.context.logger.warn("Setup completed successfully, but there does not seem to be a global install of the Angular CLI. For autocompletion to work, the CLI will need to be on your `$PATH`, which is typically done with the `-g` flag in `npm install -g @angular/cli`.\n\nFor more information, see https://angular.dev/cli/completion#global-install");
+    }
+    return 0;
+  }
+};
+var CompletionScriptCommandModule = class extends CommandModule {
+  command = "script";
+  describe = "Generate a bash and zsh real-time type-ahead autocompletion script.";
+  builder(localYargs) {
+    return localYargs;
+  }
+  run() {
+    this.context.yargsInstance.showCompletionScript();
+  }
+};
+export {
+  CompletionCommandModule as default
+};
+/**
+ * @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
+ */

package/lib/cli-VVITNTBC.js

@@ -0,0 +1,50 @@
+import {
+  ArchitectCommandModule
+} from "./chunk-CAZUOCTC.js";
+import "./chunk-DHWVZMLH.js";
+import "./chunk-YM7ILCS5.js";
+import "./chunk-XG3HVNIL.js";
+import "./chunk-GHUUJYOY.js";
+import "./chunk-FZ5GFCWU.js";
+
+// packages/angular/cli/src/commands/extract-i18n/cli.js
+import { createRequire } from "node:module";
+import { join } from "node:path";
+var ExtractI18nCommandModule = class extends ArchitectCommandModule {
+  multiTarget = false;
+  command = "extract-i18n [project]";
+  describe = "Extracts i18n messages from source code.";
+  async findDefaultBuilderName(project) {
+    if (project.extensions["projectType"] !== "application") {
+      return;
+    }
+    const buildTarget = project.targets.get("build");
+    if (!buildTarget) {
+      return;
+    }
+    switch (buildTarget.builder) {
+      case "@angular-devkit/build-angular:application":
+      case "@angular-devkit/build-angular:browser-esbuild":
+      case "@angular-devkit/build-angular:browser":
+        return "@angular-devkit/build-angular:extract-i18n";
+      case "@angular/build:application":
+        return "@angular/build:extract-i18n";
+    }
+    try {
+      const projectRequire = createRequire(join(this.context.root, project.root) + "/");
+      projectRequire.resolve("@angular-devkit/build-angular");
+      return "@angular-devkit/build-angular:extract-i18n";
+    } catch {
+    }
+  }
+};
+export {
+  ExtractI18nCommandModule as default
+};
+/**
+ * @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
+ */