@schematics/angular 19.1.0-next.2 → 19.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License
 
-Copyright (c) 2010-2024 Google LLC. https://angular.dev/license
+Copyright (c) 2010-2025 Google LLC. https://angular.dev/license
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/app-shell/schema.d.ts

@@ -1,13 +1,14 @@
 /**
- * Generates an application shell for running a server-side version of an app.
+ * Configures your project to generate an app-shell during build time.
  */
 export interface Schema {
     /**
-     * The name of the related client app.
+     * The name of the project where the app-shell should be generated.
      */
     project: string;
     /**
-     * Creates a server application using the Server Routing API (Developer Preview).
+     * Set up a server application using the Server Routing and App Engine APIs (Developer
+     * Preview).
      */
     serverRouting?: boolean;
 }

package/app-shell/schema.json

@@ -3,18 +3,18 @@
   "$id": "SchematicsAngularAppShell",
   "title": "Angular AppShell Options Schema",
   "type": "object",
-  "description": "Generates an application shell for running a server-side version of an app.",
+  "description": "Configures your project to generate an app-shell during build time.",
   "additionalProperties": false,
   "properties": {
     "project": {
       "type": "string",
-      "description": "The name of the related client app.",
+      "description": "The name of the project where the app-shell should be generated.",
       "$default": {
         "$source": "projectName"
       }
     },
     "serverRouting": {
-      "description": "Creates a server application using the Server Routing API (Developer Preview).",
+      "description": "Set up a server application using the Server Routing and App Engine APIs (Developer Preview).",
       "type": "boolean",
       "default": false
     }

package/application/schema.d.ts

@@ -1,84 +1,98 @@
 /**
- * Generates a new basic application definition in the "projects" subfolder of the workspace.
+ * Generates a new Angular application within your workspace. This schematic sets up the
+ * foundational structure of your project, including the root component, module, and
+ * configuration files. You can customize various aspects of the application, such as
+ * routing, styling, and testing.
  */
 export interface Schema {
     /**
-     * Create an application that does not utilize zone.js.
+     * Generate an application that does not use `zone.js`.
      */
     experimentalZoneless?: boolean;
     /**
-     * Include styles inline in the root component.ts file. Only CSS styles can be included
-     * inline. Default is false, meaning that an external styles file is created and referenced
-     * in the root component.ts file.
+     * Include the styles for the root component directly within the `app.component.ts` file.
+     * Only CSS styles can be included inline. By default, a separate stylesheet file (e.g.,
+     * `app.component.css`) is created.
      */
     inlineStyle?: boolean;
     /**
-     * Include template inline in the root component.ts file. Default is false, meaning that an
-     * external template file is created and referenced in the root component.ts file.
+     * Include the HTML template for the root component directly within the `app.component.ts`
+     * file. By default, a separate template file (e.g., `app.component.html`) is created.
      */
     inlineTemplate?: boolean;
     /**
-     * Create a bare-bones project without any testing frameworks. (Use for learning purposes
-     * only.)
+     * Generate a minimal project without any testing frameworks. This is intended for learning
+     * purposes and simple experimentation, not for production applications.
      */
     minimal?: boolean;
     /**
-     * The name of the new application.
+     * The name for the new application. This name will be used for the project directory and
+     * various identifiers throughout the application's code.
      */
     name: string;
     /**
-     * A prefix to apply to generated selectors.
+     * A prefix to be added to the selectors of components generated within this application.
+     * For example, if the prefix is `my-app` and you generate a component named `my-component`,
+     * the selector will be `my-app-my-component`.
      */
     prefix?: string;
     /**
-     * The root directory of the new application.
+     * The directory where the new application's files will be created, relative to the
+     * workspace root. If not specified, the application will be created in a subfolder within
+     * the `projects` directory, using the application's name.
      */
     projectRoot?: string;
     /**
-     * Creates an application with routing enabled.
+     * Generate an application with routing already configured. This sets up the necessary files
+     * and modules for managing navigation between different views in your application.
      */
     routing?: boolean;
     /**
-     * Creates a server application using the Server Routing and App Engine APIs (Developer
+     * Set up a server application using the Server Routing and App Engine APIs (Developer
      * Preview).
      */
     serverRouting?: boolean;
     /**
-     * Skip installing dependency packages.
+     * Skip the automatic installation of packages. You will need to manually install the
+     * dependencies later.
      */
     skipInstall?: boolean;
     /**
-     * Do not add dependencies to the "package.json" file.
+     * Do not add dependencies to the `package.json` file.
      */
     skipPackageJson?: boolean;
     /**
-     * Do not create "spec.ts" test files for the application.
+     * Skip the generation of a unit test files `spec.ts`.
      */
     skipTests?: boolean;
     /**
-     * Creates an application with Server-Side Rendering (SSR) and Static Site Generation
-     * (SSG/Prerendering) enabled.
+     * Configure the application for Server-Side Rendering (SSR) and Static Site Generation
+     * (SSG/Prerendering).
      */
     ssr?: boolean;
     /**
-     * Creates an application based upon the standalone API, without NgModules.
+     * Create an application that utilizes the standalone API, eliminating the need for
+     * NgModules. This can simplify the structure of your application.
      */
     standalone?: boolean;
     /**
-     * Creates an application with stricter bundle budgets settings.
+     * Enable stricter bundle budget settings for the application. This helps to keep your
+     * application's bundle size small and improve performance. For more information, see
+     * https://angular.dev/tools/cli/template-typecheck#strict-mode
      */
     strict?: boolean;
     /**
-     * The file extension or preprocessor to use for style files.
+     * The type of stylesheet files to be created for components in the application.
      */
     style?: Style;
     /**
-     * The view encapsulation strategy to use in the new application.
+     * Sets the view encapsulation mode for the application's components. This determines how
+     * component styles are scoped and applied.
      */
     viewEncapsulation?: ViewEncapsulation;
 }
 /**
- * The file extension or preprocessor to use for style files.
+ * The type of stylesheet files to be created for components in the application.
  */
 export declare enum Style {
     Css = "css",
@@ -87,7 +101,8 @@ export declare enum Style {
     Scss = "scss"
 }
 /**
- * The view encapsulation strategy to use in the new application.
+ * Sets the view encapsulation mode for the application's components. This determines how
+ * component styles are scoped and applied.
  */
 export declare enum ViewEncapsulation {
     Emulated = "Emulated",

package/application/schema.js

@@ -4,7 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViewEncapsulation = exports.Style = void 0;
 /**
- * The file extension or preprocessor to use for style files.
+ * The type of stylesheet files to be created for components in the application.
  */
 var Style;
 (function (Style) {
@@ -14,7 +14,8 @@ var Style;
     Style["Scss"] = "scss";
 })(Style || (exports.Style = Style = {}));
 /**
- * The view encapsulation strategy to use in the new application.
+ * Sets the view encapsulation mode for the application's components. This determines how
+ * component styles are scoped and applied.
  */
 var ViewEncapsulation;
 (function (ViewEncapsulation) {

package/application/schema.json

@@ -3,15 +3,15 @@
   "$id": "SchematicsAngularApp",
   "title": "Angular Application Options Schema",
   "type": "object",
-  "description": "Generates a new basic application definition in the \"projects\" subfolder of the workspace.",
+  "description": "Generates a new Angular application within your workspace. This schematic sets up the foundational structure of your project, including the root component, module, and configuration files. You can customize various aspects of the application, such as routing, styling, and testing.",
   "additionalProperties": false,
   "properties": {
     "projectRoot": {
-      "description": "The root directory of the new application.",
+      "description": "The directory where the new application's files will be created, relative to the workspace root. If not specified, the application will be created in a subfolder within the `projects` directory, using the application's name.",
       "type": "string"
     },
     "name": {
-      "description": "The name of the new application.",
+      "description": "The name for the new application. This name will be used for the project directory and various identifiers throughout the application's code.",
       "type": "string",
       "pattern": "^(?:@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*/)?[a-zA-Z0-9-~][a-zA-Z0-9-._~]*$",
       "$default": {
@@ -21,37 +21,37 @@
       "x-prompt": "What name would you like to use for the application?"
     },
     "inlineStyle": {
-      "description": "Include styles inline in the root component.ts file. Only CSS styles can be included inline. Default is false, meaning that an external styles file is created and referenced in the root component.ts file.",
+      "description": "Include the styles for the root component directly within the `app.component.ts` file. Only CSS styles can be included inline. By default, a separate stylesheet file (e.g., `app.component.css`) is created.",
       "type": "boolean",
       "alias": "s",
       "x-user-analytics": "ep.ng_inline_style"
     },
     "inlineTemplate": {
-      "description": "Include template inline in the root component.ts file. Default is false, meaning that an external template file is created and referenced in the root component.ts file. ",
+      "description": "Include the HTML template for the root component directly within the `app.component.ts` file. By default, a separate template file (e.g., `app.component.html`) is created.",
       "type": "boolean",
       "alias": "t",
       "x-user-analytics": "ep.ng_inline_template"
     },
     "viewEncapsulation": {
-      "description": "The view encapsulation strategy to use in the new application.",
+      "description": "Sets the view encapsulation mode for the application's components. This determines how component styles are scoped and applied.",
       "enum": ["Emulated", "None", "ShadowDom"],
       "type": "string"
     },
     "routing": {
       "type": "boolean",
-      "description": "Creates an application with routing enabled.",
+      "description": "Generate an application with routing already configured. This sets up the necessary files and modules for managing navigation between different views in your application.",
       "default": true,
       "x-user-analytics": "ep.ng_routing"
     },
     "prefix": {
       "type": "string",
       "format": "html-selector",
-      "description": "A prefix to apply to generated selectors.",
+      "description": "A prefix to be added to the selectors of components generated within this application. For example, if the prefix is `my-app` and you generate a component named `my-component`, the selector will be `my-app-my-component`.",
       "default": "app",
       "alias": "p"
     },
     "style": {
-      "description": "The file extension or preprocessor to use for style files.",
+      "description": "The type of stylesheet files to be created for components in the application.",
       "type": "string",
       "default": "css",
       "enum": ["css", "scss", "sass", "less"],
@@ -80,7 +80,7 @@
       "x-user-analytics": "ep.ng_style"
     },
     "skipTests": {
-      "description": "Do not create \"spec.ts\" test files for the application.",
+      "description": "Skip the generation of a unit test files `spec.ts`.",
       "type": "boolean",
       "default": false,
       "alias": "S"
@@ -88,42 +88,42 @@
     "skipPackageJson": {
       "type": "boolean",
       "default": false,
-      "description": "Do not add dependencies to the \"package.json\" file."
+      "description": "Do not add dependencies to the `package.json` file."
     },
     "minimal": {
-      "description": "Create a bare-bones project without any testing frameworks. (Use for learning purposes only.)",
+      "description": "Generate a minimal project without any testing frameworks. This is intended for learning purposes and simple experimentation, not for production applications.",
       "type": "boolean",
       "default": false
     },
     "skipInstall": {
-      "description": "Skip installing dependency packages.",
+      "description": "Skip the automatic installation of packages. You will need to manually install the dependencies later.",
       "type": "boolean",
       "default": false
     },
     "strict": {
-      "description": "Creates an application with stricter bundle budgets settings.",
+      "description": "Enable stricter bundle budget settings for the application. This helps to keep your application's bundle size small and improve performance. For more information, see https://angular.dev/tools/cli/template-typecheck#strict-mode",
       "type": "boolean",
       "default": true
     },
     "standalone": {
-      "description": "Creates an application based upon the standalone API, without NgModules.",
+      "description": "Create an application that utilizes the standalone API, eliminating the need for NgModules. This can simplify the structure of your application.",
       "type": "boolean",
       "default": true,
       "x-user-analytics": "ep.ng_standalone"
     },
     "ssr": {
-      "description": "Creates an application with Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) enabled.",
+      "description": "Configure the application for Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering).",
       "x-prompt": "Do you want to enable Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering)?",
       "type": "boolean",
       "default": false,
       "x-user-analytics": "ep.ng_ssr"
     },
     "serverRouting": {
-      "description": "Creates a server application using the Server Routing and App Engine APIs (Developer Preview).",
+      "description": "Set up a server application using the Server Routing and App Engine APIs (Developer Preview).",
       "type": "boolean"
     },
     "experimentalZoneless": {
-      "description": "Create an application that does not utilize zone.js.",
+      "description": "Generate an application that does not use `zone.js`.",
       "type": "boolean",
       "default": false
     }

package/class/schema.d.ts

@@ -1,25 +1,32 @@
 /**
- * Creates a new, generic class definition in the given project.
+ * Creates a new class in your project. Classes are the fundamental building blocks for
+ * object-oriented programming in TypeScript. They provide a blueprint for creating objects
+ * with properties and methods. This schematic helps you generate a new class with the basic
+ * structure and optional test files.
  */
 export interface Schema {
     /**
-     * The name of the new class.
+     * The name for the new class. This will be used to create the class file (e.g.,
+     * `my-class.ts`) and, if enabled, the corresponding test file `my-class.spec.ts`.
      */
     name: string;
     /**
-     * The path at which to create the class, relative to the workspace root.
+     * The path where the class file should be created, relative to the workspace root. If not
+     * specified, the class will be created in the current directory.
      */
     path?: string;
     /**
-     * The name of the project.
+     * The name of the project where the class should be added. If not specified, the CLI will
+     * determine the project from the current directory.
      */
     project: string;
     /**
-     * Do not create "spec.ts" test files for the new class.
+     * Skip the generation of a unit test file `spec.ts` for the new class.
      */
     skipTests?: boolean;
     /**
-     * Adds a developer-defined type to the filename, in the format "name.type.ts".
+     * Adds a custom type to the filename, allowing you to create more descriptive class names.
+     * For example, if you set the type to `helper`, the filename will be `my-class.helper.ts`.
      */
     type?: string;
 }

package/class/schema.json

@@ -3,12 +3,12 @@
   "$id": "SchematicsAngularClass",
   "title": "Angular Class Options Schema",
   "type": "object",
-  "description": "Creates a new, generic class definition in the given project.",
+  "description": "Creates a new class in your project. Classes are the fundamental building blocks for object-oriented programming in TypeScript. They provide a blueprint for creating objects with properties and methods. This schematic helps you generate a new class with the basic structure and optional test files.",
   "additionalProperties": false,
   "properties": {
     "name": {
       "type": "string",
-      "description": "The name of the new class.",
+      "description": "The name for the new class. This will be used to create the class file (e.g., `my-class.ts`) and, if enabled, the corresponding test file `my-class.spec.ts`.",
       "$default": {
         "$source": "argv",
         "index": 0
@@ -21,24 +21,24 @@
       "$default": {
         "$source": "workingDirectory"
       },
-      "description": "The path at which to create the class, relative to the workspace root.",
+      "description": "The path where the class file should be created, relative to the workspace root. If not specified, the class will be created in the current directory.",
       "visible": false
     },
     "project": {
       "type": "string",
-      "description": "The name of the project.",
+      "description": "The name of the project where the class should be added. If not specified, the CLI will determine the project from the current directory.",
       "$default": {
         "$source": "projectName"
       }
     },
     "skipTests": {
       "type": "boolean",
-      "description": "Do not create \"spec.ts\" test files for the new class.",
+      "description": "Skip the generation of a unit test file `spec.ts` for the new class.",
       "default": false
     },
     "type": {
       "type": "string",
-      "description": "Adds a developer-defined type to the filename, in the format \"name.type.ts\"."
+      "description": "Adds a custom type to the filename, allowing you to create more descriptive class names. For example, if you set the type to `helper`, the filename will be `my-class.helper.ts`."
     }
   },
   "required": ["name", "project"]

package/component/schema.d.ts

@@ -1,102 +1,119 @@
 /**
- * Creates a new, generic component definition in the given project.
+ * Creates a new Angular component. Components are the basic building blocks of Angular
+ * applications. Each component consists of a TypeScript class, an HTML template, and an
+ * optional CSS stylesheet. Use this schematic to generate a new component in your project.
  */
 export interface Schema {
     /**
-     * The change detection strategy to use in the new component.
+     * Configures the change detection strategy for the component.
      */
     changeDetection?: ChangeDetection;
     /**
-     * Specifies if the style will contain `:host { display: block; }`.
+     * Adds `:host { display: block; }` to the component's stylesheet, ensuring the component
+     * renders as a block-level element. This is useful for layout purposes.
      */
     displayBlock?: boolean;
     /**
-     * The declaring NgModule exports this component.
+     * Automatically export the component from the specified NgModule, making it accessible to
+     * other modules in the application.
      */
     export?: boolean;
     /**
-     * Use default export for the component instead of a named export.
+     * Use a default export for the component in its TypeScript file instead of a named export.
      */
     exportDefault?: boolean;
     /**
-     * Create the new files at the top level of the current project.
+     * Create the component files directly in the project's `src/app` directory instead of
+     * creating a new folder for them.
      */
     flat?: boolean;
     /**
-     * Include styles inline in the component.ts file. Only CSS styles can be included inline.
-     * By default, an external styles file is created and referenced in the component.ts file.
+     * Include the component's styles directly in the `component.ts` file. By default, a
+     * separate stylesheet file (e.g., `my-component.component.css`) is created.
      */
     inlineStyle?: boolean;
     /**
-     * Include template inline in the component.ts file. By default, an external template file
-     * is created and referenced in the component.ts file.
+     * Include the component's HTML template directly in the `component.ts` file. By default, a
+     * separate template file (e.g., `my-component.component.html`) is created.
      */
     inlineTemplate?: boolean;
     /**
-     * The declaring NgModule.
+     * Specify the NgModule where the component should be declared. If not provided, the CLI
+     * will attempt to find the closest NgModule in the component's path.
      */
     module?: string;
     /**
-     * The name of the component.
+     * The name for the new component. This will be used to create the component's class,
+     * template, and stylesheet files. For example, if you provide `my-component`, the files
+     * will be named `my-component.component.ts`, `my-component.component.html`, and
+     * `my-component.component.css`.
      */
     name: string;
     /**
-     * The path at which to create the component file, relative to the current workspace.
-     * Default is a folder with the same name as the component in the project root.
+     * The path where the component files should be created, relative to the current workspace.
+     * If not provided, a folder with the same name as the component will be created in the
+     * project's `src/app` directory.
      */
     path?: string;
     /**
-     * The prefix to apply to the generated component selector.
+     * A prefix to be added to the component's selector. For example, if the prefix is `app` and
+     * the component name is `my-component`, the selector will be `app-my-component`.
      */
     prefix?: string;
     /**
-     * The name of the project.
+     * The name of the project where the component should be added. If not specified, the CLI
+     * will determine the project from the current directory.
      */
     project: string;
     /**
-     * The HTML selector to use for this component.
+     * The HTML selector to use for this component. If not provided, a selector will be
+     * generated based on the component name (e.g., `app-my-component`).
      */
     selector?: string;
     /**
-     * Do not import this component into the owning NgModule.
+     * Do not automatically import the new component into its closest NgModule.
      */
     skipImport?: boolean;
     /**
-     * Specifies if the component should have a selector or not.
+     * Skip the generation of an HTML selector for the component.
      */
     skipSelector?: boolean;
     /**
-     * Do not create "spec.ts" test files for the new component.
+     * Skip the generation of unit test files `spec.ts`.
      */
     skipTests?: boolean;
     /**
-     * Whether the generated component is standalone.
+     * Generate a standalone component. Standalone components are self-contained and don't need
+     * to be declared in an NgModule. They can be used independently or imported directly into
+     * other standalone components.
      */
     standalone?: boolean;
     /**
-     * The file extension or preprocessor to use for style files, or 'none' to skip generating
-     * the style file.
+     * Specify the type of stylesheet to be created for the component, or `none` to skip
+     * creating a stylesheet.
      */
     style?: Style;
     /**
-     * Adds a developer-defined type to the filename, in the format "name.type.ts".
+     * Append a custom type to the component's filename. For example, if you set the type to
+     * `container`, the file will be named `my-component.container.ts`.
      */
     type?: string;
     /**
-     * The view encapsulation strategy to use in the new component.
+     * Sets the view encapsulation mode for the component. This determines how the component's
+     * styles are scoped and applied.
      */
     viewEncapsulation?: ViewEncapsulation;
 }
 /**
- * The change detection strategy to use in the new component.
+ * Configures the change detection strategy for the component.
  */
 export declare enum ChangeDetection {
     Default = "Default",
     OnPush = "OnPush"
 }
 /**
- * The file extension or preprocessor to use for style files, or 'none' to skip generating
- * the style file.
+ * Specify the type of stylesheet to be created for the component, or `none` to skip
+ * creating a stylesheet.
  */
 export declare enum Style {
     Css = "css",
@@ -106,7 +123,8 @@ export declare enum Style {
     Scss = "scss"
 }
 /**
- * The view encapsulation strategy to use in the new component.
+ * Sets the view encapsulation mode for the component. This determines how the component's
+ * styles are scoped and applied.
  */
 export declare enum ViewEncapsulation {
     Emulated = "Emulated",

package/component/schema.js

@@ -4,7 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViewEncapsulation = exports.Style = exports.ChangeDetection = void 0;
 /**
- * The change detection strategy to use in the new component.
+ * Configures the change detection strategy for the component.
  */
 var ChangeDetection;
 (function (ChangeDetection) {
@@ -12,8 +12,8 @@ var ChangeDetection;
     ChangeDetection["OnPush"] = "OnPush";
 })(ChangeDetection || (exports.ChangeDetection = ChangeDetection = {}));
 /**
- * The file extension or preprocessor to use for style files, or 'none' to skip generating
- * the style file.
+ * Specify the type of stylesheet to be created for the component, or `none` to skip
+ * creating a stylesheet.
  */
 var Style;
 (function (Style) {
@@ -24,7 +24,8 @@ var Style;
     Style["Scss"] = "scss";
 })(Style || (exports.Style = Style = {}));
 /**
- * The view encapsulation strategy to use in the new component.
+ * Sets the view encapsulation mode for the component. This determines how the component's
+ * styles are scoped and applied.
  */
 var ViewEncapsulation;
 (function (ViewEncapsulation) {