@angular/cli 22.2.0 → 22.3.0-next.0

package/lib/cli-Y2ECUR33.js

@@ -0,0 +1,33 @@
+import {
+  ArchitectCommandModule
+} from "./chunk-CAZUOCTC.js";
+import "./chunk-DHWVZMLH.js";
+import {
+  RootCommands
+} from "./chunk-5AASRQKS.js";
+import "./chunk-YM7ILCS5.js";
+import "./chunk-XG3HVNIL.js";
+import "./chunk-GHUUJYOY.js";
+import "./chunk-FZ5GFCWU.js";
+
+// packages/angular/cli/src/commands/build/long-description.md
+var long_description_default = 'The command can be used to build a project of type "application" or "library".\nWhen used to build a library, a different builder is invoked, and only the `ts-config`, `configuration`, `poll` and `watch` options are applied.\nAll other options apply only to building applications.\n\nThe application builder uses the [esbuild](https://esbuild.github.io/) build tool, with default configuration options specified in the workspace configuration file (`angular.json`) or with a named alternative configuration.\nA "development" configuration is created by default when you use the CLI to create the project, and you can use that configuration by specifying the `--configuration development`.\n\nThe configuration options generally correspond to the command options.\nYou can override individual configuration defaults by specifying the corresponding options on the command line.\nThe command can accept option names given in dash-case.\nNote that in the configuration file, you must specify names in camelCase.\n\nSome additional options can only be set through the configuration file,\neither by direct editing or with the `ng config` command.\nThese include `assets`, `styles`, and `scripts` objects that provide runtime-global resources to include in the project.\nResources in CSS, such as images and fonts, are automatically written and fingerprinted at the root of the output folder.\n\nFor further details, see [Workspace Configuration](reference/configs/workspace-config).\n';
+
+// packages/angular/cli/src/commands/build/cli.js
+var BuildCommandModule = class extends ArchitectCommandModule {
+  multiTarget = false;
+  command = "build [project]";
+  aliases = RootCommands["build"].aliases;
+  describe = "Compiles an Angular application or library into an output directory named dist/ at the given output path.";
+  longDescription = long_description_default;
+};
+export {
+  BuildCommandModule 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-YDSMJOSO.js

@@ -0,0 +1,182 @@
+import {
+  SchematicsCommandModule
+} from "./chunk-Q67GOPL7.js";
+import "./chunk-JBLF2TH3.js";
+import {
+  RootCommands
+} from "./chunk-5AASRQKS.js";
+import {
+  demandCommandFailureMessage
+} from "./chunk-G7TRU43D.js";
+import {
+  CommandModuleError
+} from "./chunk-YM7ILCS5.js";
+import "./chunk-XG3HVNIL.js";
+import "./chunk-GHUUJYOY.js";
+import "./chunk-FZ5GFCWU.js";
+
+// packages/angular/cli/src/commands/generate/cli.js
+import { strings } from "@angular-devkit/core";
+var GenerateCommandModule = class extends SchematicsCommandModule {
+  command = "generate";
+  aliases = RootCommands["generate"].aliases;
+  describe = "Generates and/or modifies files based on a schematic.";
+  async builder(argv) {
+    let localYargs = (await super.builder(argv)).command({
+      command: "$0 <schematic>",
+      describe: "Run the provided schematic.",
+      builder: (localYargs2) => localYargs2.positional("schematic", {
+        describe: "The [collection:schematic] to run.",
+        type: "string",
+        demandOption: true
+      }).strict(),
+      handler: (options) => this.handler(options)
+    });
+    for (const [schematicName, collectionName] of await this.getSchematicsToRegister()) {
+      const workflow = this.getOrCreateWorkflowForBuilder(collectionName);
+      const collection = workflow.engine.createCollection(collectionName);
+      const { description: { schemaJson, aliases: schematicAliases, hidden: schematicHidden, description: schematicDescription } } = collection.createSchematic(schematicName, true);
+      if (!schemaJson) {
+        continue;
+      }
+      const { "x-deprecated": xDeprecated, description = schematicDescription, hidden = schematicHidden } = schemaJson;
+      const options = await this.getSchematicOptions(collection, schematicName, workflow);
+      localYargs = localYargs.command({
+        command: await this.generateCommandString(collectionName, schematicName, options),
+        // When 'describe' is set to false, it results in a hidden command.
+        describe: hidden === true ? false : typeof description === "string" ? description : "",
+        deprecated: xDeprecated === true || typeof xDeprecated === "string" ? xDeprecated : false,
+        aliases: Array.isArray(schematicAliases) ? await this.generateCommandAliasesStrings(collectionName, schematicAliases) : void 0,
+        builder: (localYargs2) => this.addSchemaOptionsToCommand(localYargs2, options).strict(),
+        handler: (options2) => this.handler({
+          ...options2,
+          schematic: `${collectionName}:${schematicName}`
+        })
+      });
+    }
+    return localYargs.demandCommand(1, demandCommandFailureMessage);
+  }
+  async run(options) {
+    const { dryRun, schematic, defaults, force, interactive, ...schematicOptions } = options;
+    const [collectionName, schematicName] = this.parseSchematicInfo(schematic);
+    if (!collectionName || !schematicName) {
+      throw new CommandModuleError("A collection and schematic is required during execution.");
+    }
+    return this.runSchematic({
+      collectionName,
+      schematicName,
+      schematicOptions,
+      executionOptions: {
+        dryRun,
+        defaults,
+        force,
+        interactive
+      }
+    });
+  }
+  async getCollectionNames() {
+    const [collectionName] = this.parseSchematicInfo(
+      // positional = [generate, component] or [generate]
+      this.context.args.positional[1]
+    );
+    return collectionName ? [collectionName] : [...await this.getSchematicCollections()];
+  }
+  async shouldAddCollectionNameAsPartOfCommand() {
+    const [collectionNameFromArgs] = this.parseSchematicInfo(
+      // positional = [generate, component] or [generate]
+      this.context.args.positional[1]
+    );
+    const schematicCollectionsFromConfig = await this.getSchematicCollections();
+    const collectionNames = await this.getCollectionNames();
+    return !!collectionNameFromArgs || !collectionNames.some((c) => schematicCollectionsFromConfig.has(c));
+  }
+  /**
+   * Generate an aliases string array to be passed to the command builder.
+   *
+   * @example `[component]` or `[@schematics/angular:component]`.
+   */
+  async generateCommandAliasesStrings(collectionName, schematicAliases) {
+    return await this.shouldAddCollectionNameAsPartOfCommand() ? schematicAliases.map((alias) => `${collectionName}:${alias}`) : schematicAliases;
+  }
+  /**
+   * Generate a command string to be passed to the command builder.
+   *
+   * @example `component [name]` or `@schematics/angular:component [name]`.
+   */
+  async generateCommandString(collectionName, schematicName, options) {
+    const dasherizedSchematicName = strings.dasherize(schematicName);
+    const commandName = await this.shouldAddCollectionNameAsPartOfCommand() ? collectionName + ":" + dasherizedSchematicName : dasherizedSchematicName;
+    const positionalArgs = options.filter((o) => o.positional !== void 0).map((o) => {
+      const label = `${strings.dasherize(o.name)}${o.type === "array" ? " .." : ""}`;
+      return o.required ? `<${label}>` : `[${label}]`;
+    }).join(" ");
+    return `${commandName}${positionalArgs ? " " + positionalArgs : ""}`;
+  }
+  /**
+   * Get schematics that can to be registered as subcommands.
+   */
+  async *getSchematics() {
+    const seenNames = /* @__PURE__ */ new Set();
+    for (const collectionName of await this.getCollectionNames()) {
+      const workflow = this.getOrCreateWorkflowForBuilder(collectionName);
+      const collection = workflow.engine.createCollection(collectionName);
+      for (const schematicName of collection.listSchematicNames(
+        true
+        /** includeHidden */
+      )) {
+        if (!seenNames.has(schematicName)) {
+          seenNames.add(schematicName);
+          yield {
+            schematicName,
+            collectionName,
+            schematicAliases: this.listSchematicAliases(collection, schematicName)
+          };
+        }
+      }
+    }
+  }
+  listSchematicAliases(collection, schematicName) {
+    const description = collection.description.schematics[schematicName];
+    if (description) {
+      return description.aliases && new Set(description.aliases);
+    }
+    if (collection.baseDescriptions) {
+      for (const base of collection.baseDescriptions) {
+        const description2 = base.schematics[schematicName];
+        if (description2) {
+          return description2.aliases && new Set(description2.aliases);
+        }
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Get schematics that should to be registered as subcommands.
+   *
+   * @returns a sorted list of schematic that needs to be registered as subcommands.
+   */
+  async getSchematicsToRegister() {
+    const schematicsToRegister = [];
+    const [, schematicNameFromArgs] = this.parseSchematicInfo(
+      // positional = [generate, component] or [generate]
+      this.context.args.positional[1]
+    );
+    for await (const { schematicName, collectionName, schematicAliases } of this.getSchematics()) {
+      if (schematicNameFromArgs && (schematicName === schematicNameFromArgs || schematicAliases?.has(schematicNameFromArgs))) {
+        return [[schematicName, collectionName]];
+      }
+      schematicsToRegister.push([schematicName, collectionName]);
+    }
+    return schematicsToRegister.sort(([nameA], [nameB]) => nameA.localeCompare(nameB, void 0, { sensitivity: "accent" }));
+  }
+};
+export {
+  GenerateCommandModule 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/color-SJPGXZVA.js

@@ -0,0 +1,8 @@
+import {
+  colors,
+  supportColor
+} from "./chunk-GHUUJYOY.js";
+export {
+  colors,
+  supportColor
+};

package/lib/config/schema.json

@@ -464,6 +464,7 @@
                   "not": {
                     "enum": [
                       "@angular/build:application",
+                      "@angular/build:library",
                       "@angular/build:dev-server",
                       "@angular/build:extract-i18n",
                       "@angular/build:karma",
@@ -547,6 +548,28 @@
                 }
               }
             },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "builder": {
+                  "const": "@angular/build:library"
+                },
+                "defaultConfiguration": {
+                  "type": "string",
+                  "description": "A default named configuration to use when a target configuration is not provided."
+                },
+                "options": {
+                  "$ref": "#/definitions/AngularBuildBuildersLibrarySchema"
+                },
+                "configurations": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/definitions/AngularBuildBuildersLibrarySchema"
+                  }
+                }
+              }
+            },
             {
               "type": "object",
               "additionalProperties": false,
@@ -2752,6 +2775,179 @@
         }
       }
     },
+    "AngularBuildBuildersLibrarySchema": {
+      "title": "Library builder target options",
+      "description": "Library builder target options for Build Architect. Builds an Angular library package conforming to the Angular Package Format (APF).",
+      "type": "object",
+      "properties": {
+        "tsConfig": {
+          "type": "string",
+          "description": "The full path for the TypeScript configuration file, relative to the current workspace root."
+        },
+        "outputPath": {
+          "type": "string",
+          "description": "Specify the output directory for the built package, relative to the workspace root."
+        },
+        "assets": {
+          "type": "array",
+          "description": "Define the assets to be copied to the output directory. These assets are copied as-is without any further processing or hashing.",
+          "default": [],
+          "items": {
+            "$ref": "#/definitions/AngularBuildBuildersLibrarySchema/definitions/assetPattern"
+          }
+        },
+        "inlineStyleLanguage": {
+          "description": "The stylesheet language to use for the library's inline component styles.",
+          "type": "string",
+          "default": "css",
+          "enum": [
+            "css",
+            "less",
+            "sass",
+            "scss"
+          ]
+        },
+        "stylePreprocessorOptions": {
+          "description": "Options to pass to style preprocessors.",
+          "type": "object",
+          "properties": {
+            "includePaths": {
+              "description": "Paths to include. Paths will be resolved to workspace root.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": []
+            },
+            "sass": {
+              "description": "Options to pass to the sass preprocessor.",
+              "type": "object",
+              "properties": {
+                "fatalDeprecations": {
+                  "description": "A set of deprecations to treat as fatal. If a deprecation warning of any provided type is encountered during compilation, the compiler will error instead. If a Version is provided, then all deprecations that were active in that compiler version will be treated as fatal.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "silenceDeprecations": {
+                  "description": " A set of active deprecations to ignore. If a deprecation warning of any provided type is encountered during compilation, the compiler will ignore it instead.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "futureDeprecations": {
+                  "description": "A set of future deprecations to opt into early. Future deprecations passed here will be treated as active by the compiler, emitting warnings as necessary.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "declarationMap": {
+          "type": "boolean",
+          "description": "Generates a sourcemap for each corresponding '.d.ts' file.",
+          "default": false
+        },
+        "compilationMode": {
+          "type": "string",
+          "description": "Angular compilation mode. Use 'partial' when publishing to npm (APF requirement). Use 'full' only during development or for private, internal monorepo packages that are never published.",
+          "enum": [
+            "partial",
+            "full"
+          ],
+          "default": "partial"
+        },
+        "allowedNonPeerDependencies": {
+          "description": "A list of package names allowed in the 'dependencies' and 'optionalDependencies' sections of package.json. Values can be regular expression patterns.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        },
+        "keepLifecycleScripts": {
+          "description": "Enable this to keep the 'scripts' section in the published package.json.",
+          "type": "boolean",
+          "default": false
+        },
+        "deleteOutputPath": {
+          "type": "boolean",
+          "description": "Delete the output path before building.",
+          "default": true
+        },
+        "watch": {
+          "type": "boolean",
+          "description": "Run build when files change.",
+          "default": false
+        },
+        "poll": {
+          "type": "number",
+          "description": "Enable and define the file watching poll time period in milliseconds."
+        },
+        "preserveSymlinks": {
+          "type": "boolean",
+          "description": "Do not use the real path when resolving modules. If unset then will default to `true` if NodeJS option --preserve-symlinks is set."
+        },
+        "progress": {
+          "type": "boolean",
+          "description": "Log progress to the console while building.",
+          "default": true
+        },
+        "clearScreen": {
+          "type": "boolean",
+          "default": false,
+          "description": "Automatically clear the terminal screen during rebuilds."
+        }
+      },
+      "additionalProperties": false,
+      "definitions": {
+        "assetPattern": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "followSymlinks": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Allow glob patterns to follow symlink directories. This allows subdirectories of the symlink to be searched."
+                },
+                "glob": {
+                  "type": "string",
+                  "description": "The pattern to match."
+                },
+                "input": {
+                  "type": "string",
+                  "description": "The input directory path in which to apply 'glob'. Defaults to the project root."
+                },
+                "ignore": {
+                  "description": "An array of globs to ignore.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "output": {
+                  "type": "string",
+                  "default": "",
+                  "description": "Absolute path within the output."
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "string"
+            }
+          ]
+        }
+      }
+    },
     "AngularDevkitBuildAngularBuildersAppShellSchema": {
       "title": "App Shell Target",
       "description": "App Shell target options for Build Facade.",
@@ -4349,14 +4545,14 @@
             "**/*.spec.ts",
             "**/*.test.ts"
           ],
-          "description": "Specifies glob patterns of files to include for testing, relative to the project root. This option also has special handling for directory paths (includes all test files within) and file paths (includes the corresponding test file if one exists)."
+          "description": "Specifies glob patterns of files to include for testing, relative to the project source root. This option also has special handling for directory paths (includes all test files within) and file paths (includes the corresponding test file if one exists)."
         },
         "exclude": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "Specifies glob patterns of files to exclude from testing, relative to the project root."
+          "description": "Specifies glob patterns of files to exclude from testing, relative to the project source root."
         },
         "filter": {
           "type": "string",
@@ -4588,6 +4784,14 @@
           "description": "Specifies the path to a TypeScript file that provides an array of Angular providers for the test environment. The file must contain a default export of the provider array.",
           "minLength": 1
         },
+        "polyfills": {
+          "description": "A list of polyfills to include in the build. Can be a full path for a file, relative to the current workspace or module specifier. Example: 'zone.js'. If not specified, polyfills will be inherited from the build target.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "uniqueItems": true
+          }
+        },
         "setupFiles": {
           "type": "array",
           "items": {
@@ -4810,7 +5014,7 @@
           "default": [
             "**/*.spec.ts"
           ],
-          "description": "Globs of files to include, relative to project root. \nThere are 2 special cases:\n - when a path to directory is provided, all spec files ending \".spec.@(ts|tsx)\" will be included\n - when a path to a file is provided, and a matching spec file exists it will be included instead."
+          "description": "Globs of files to include, relative to the project source root. \nThere are 2 special cases:\n - when a path to a directory is provided, all spec files ending \".spec.@(ts|tsx)\" will be included\n - when a path to a file is provided, and a matching spec file exists, it will be included instead."
         },
         "exclude": {
           "type": "array",
@@ -4818,7 +5022,7 @@
             "type": "string"
           },
           "default": [],
-          "description": "Globs of files to exclude, relative to the project root."
+          "description": "Globs of files to exclude, relative to the project source root."
         },
         "sourceMap": {
           "description": "Output source maps for scripts and styles. For more information, see https://angular.dev/reference/configs/workspace-config#source-map-configuration.",
@@ -5118,7 +5322,7 @@
           "default": [
             "**/*.spec.ts"
           ],
-          "description": "Globs of files to include, relative to project root. \nThere are 2 special cases:\n - when a path to directory is provided, all spec files ending \".spec.@(ts|tsx)\" will be included\n - when a path to a file is provided, and a matching spec file exists it will be included instead."
+          "description": "Globs of files to include, relative to the project source root. \nThere are 2 special cases:\n - when a path to a directory is provided, all spec files ending \".spec.@(ts|tsx)\" will be included\n - when a path to a file is provided, and a matching spec file exists, it will be included instead."
         },
         "exclude": {
           "type": "array",
@@ -5126,7 +5330,7 @@
             "type": "string"
           },
           "default": [],
-          "description": "Globs of files to exclude, relative to the project root."
+          "description": "Globs of files to exclude, relative to the project source root."
         },
         "sourceMap": {
           "description": "Output source maps for scripts and styles. For more information, see https://angular.dev/reference/configs/workspace-config#source-map-configuration.",

package/lib/config-QXK7SSVG.js

@@ -0,0 +1,22 @@
+import {
+  AngularWorkspace,
+  getConfiguredPackageManager,
+  getProjectByCwd,
+  getSchematicDefaults,
+  getWorkspace,
+  getWorkspaceRaw,
+  isWarningEnabled,
+  validateWorkspace,
+  workspaceSchemaPath
+} from "./chunk-FZ5GFCWU.js";
+export {
+  AngularWorkspace,
+  getConfiguredPackageManager,
+  getProjectByCwd,
+  getSchematicDefaults,
+  getWorkspace,
+  getWorkspaceRaw,
+  isWarningEnabled,
+  validateWorkspace,
+  workspaceSchemaPath
+};