@angular/cli 19.1.0-next.2 → 19.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -470,6 +470,7 @@
470
470
  "@angular/build:application",
471
471
  "@angular/build:dev-server",
472
472
  "@angular/build:extract-i18n",
473
+ "@angular/build:ng-packagr",
473
474
  "@angular-devkit/build-angular:application",
474
475
  "@angular-devkit/build-angular:app-shell",
475
476
  "@angular-devkit/build-angular:browser",
@@ -857,6 +858,28 @@
857
858
  }
858
859
  }
859
860
  }
861
+ },
862
+ {
863
+ "type": "object",
864
+ "additionalProperties": false,
865
+ "properties": {
866
+ "builder": {
867
+ "const": "@angular/build:ng-packagr"
868
+ },
869
+ "defaultConfiguration": {
870
+ "type": "string",
871
+ "description": "A default named configuration to use when a target configuration is not provided."
872
+ },
873
+ "options": {
874
+ "$ref": "#/definitions/AngularBuildBuildersNgPackagrSchema"
875
+ },
876
+ "configurations": {
877
+ "type": "object",
878
+ "additionalProperties": {
879
+ "$ref": "#/definitions/AngularBuildBuildersNgPackagrSchema"
880
+ }
881
+ }
882
+ }
860
883
  }
861
884
  ]
862
885
  }
@@ -885,15 +908,15 @@
885
908
  "SchematicsAngularApplicationSchema": {
886
909
  "title": "Angular Application Options Schema",
887
910
  "type": "object",
888
- "description": "Generates a new basic application definition in the \"projects\" subfolder of the workspace.",
911
+ "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.",
889
912
  "additionalProperties": false,
890
913
  "properties": {
891
914
  "projectRoot": {
892
- "description": "The root directory of the new application.",
915
+ "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.",
893
916
  "type": "string"
894
917
  },
895
918
  "name": {
896
- "description": "The name of the new application.",
919
+ "description": "The name for the new application. This name will be used for the project directory and various identifiers throughout the application's code.",
897
920
  "type": "string",
898
921
  "pattern": "^(?:@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*/)?[a-zA-Z0-9-~][a-zA-Z0-9-._~]*$",
899
922
  "$default": {
@@ -902,17 +925,17 @@
902
925
  }
903
926
  },
904
927
  "inlineStyle": {
905
- "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.",
928
+ "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.",
906
929
  "type": "boolean",
907
930
  "alias": "s"
908
931
  },
909
932
  "inlineTemplate": {
910
- "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. ",
933
+ "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.",
911
934
  "type": "boolean",
912
935
  "alias": "t"
913
936
  },
914
937
  "viewEncapsulation": {
915
- "description": "The view encapsulation strategy to use in the new application.",
938
+ "description": "Sets the view encapsulation mode for the application's components. This determines how component styles are scoped and applied.",
916
939
  "enum": [
917
940
  "Emulated",
918
941
  "None",
@@ -922,18 +945,18 @@
922
945
  },
923
946
  "routing": {
924
947
  "type": "boolean",
925
- "description": "Creates an application with routing enabled.",
948
+ "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.",
926
949
  "default": true
927
950
  },
928
951
  "prefix": {
929
952
  "type": "string",
930
953
  "format": "html-selector",
931
- "description": "A prefix to apply to generated selectors.",
954
+ "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`.",
932
955
  "default": "app",
933
956
  "alias": "p"
934
957
  },
935
958
  "style": {
936
- "description": "The file extension or preprocessor to use for style files.",
959
+ "description": "The type of stylesheet files to be created for components in the application.",
937
960
  "type": "string",
938
961
  "default": "css",
939
962
  "enum": [
@@ -944,7 +967,7 @@
944
967
  ]
945
968
  },
946
969
  "skipTests": {
947
- "description": "Do not create \"spec.ts\" test files for the application.",
970
+ "description": "Skip the generation of a unit test files `spec.ts`.",
948
971
  "type": "boolean",
949
972
  "default": false,
950
973
  "alias": "S"
@@ -952,39 +975,39 @@
952
975
  "skipPackageJson": {
953
976
  "type": "boolean",
954
977
  "default": false,
955
- "description": "Do not add dependencies to the \"package.json\" file."
978
+ "description": "Do not add dependencies to the `package.json` file."
956
979
  },
957
980
  "minimal": {
958
- "description": "Create a bare-bones project without any testing frameworks. (Use for learning purposes only.)",
981
+ "description": "Generate a minimal project without any testing frameworks. This is intended for learning purposes and simple experimentation, not for production applications.",
959
982
  "type": "boolean",
960
983
  "default": false
961
984
  },
962
985
  "skipInstall": {
963
- "description": "Skip installing dependency packages.",
986
+ "description": "Skip the automatic installation of packages. You will need to manually install the dependencies later.",
964
987
  "type": "boolean",
965
988
  "default": false
966
989
  },
967
990
  "strict": {
968
- "description": "Creates an application with stricter bundle budgets settings.",
991
+ "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",
969
992
  "type": "boolean",
970
993
  "default": true
971
994
  },
972
995
  "standalone": {
973
- "description": "Creates an application based upon the standalone API, without NgModules.",
996
+ "description": "Create an application that utilizes the standalone API, eliminating the need for NgModules. This can simplify the structure of your application.",
974
997
  "type": "boolean",
975
998
  "default": true
976
999
  },
977
1000
  "ssr": {
978
- "description": "Creates an application with Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) enabled.",
1001
+ "description": "Configure the application for Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering).",
979
1002
  "type": "boolean",
980
1003
  "default": false
981
1004
  },
982
1005
  "serverRouting": {
983
- "description": "Creates a server application using the Server Routing and App Engine APIs (Developer Preview).",
1006
+ "description": "Set up a server application using the Server Routing and App Engine APIs (Developer Preview).",
984
1007
  "type": "boolean"
985
1008
  },
986
1009
  "experimentalZoneless": {
987
- "description": "Create an application that does not utilize zone.js.",
1010
+ "description": "Generate an application that does not use `zone.js`.",
988
1011
  "type": "boolean",
989
1012
  "default": false
990
1013
  }
@@ -993,12 +1016,12 @@
993
1016
  "SchematicsAngularClassSchema": {
994
1017
  "title": "Angular Class Options Schema",
995
1018
  "type": "object",
996
- "description": "Creates a new, generic class definition in the given project.",
1019
+ "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.",
997
1020
  "additionalProperties": false,
998
1021
  "properties": {
999
1022
  "name": {
1000
1023
  "type": "string",
1001
- "description": "The name of the new class.",
1024
+ "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`.",
1002
1025
  "$default": {
1003
1026
  "$source": "argv",
1004
1027
  "index": 0
@@ -1010,31 +1033,31 @@
1010
1033
  "$default": {
1011
1034
  "$source": "workingDirectory"
1012
1035
  },
1013
- "description": "The path at which to create the class, relative to the workspace root.",
1036
+ "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.",
1014
1037
  "visible": false
1015
1038
  },
1016
1039
  "project": {
1017
1040
  "type": "string",
1018
- "description": "The name of the project.",
1041
+ "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.",
1019
1042
  "$default": {
1020
1043
  "$source": "projectName"
1021
1044
  }
1022
1045
  },
1023
1046
  "skipTests": {
1024
1047
  "type": "boolean",
1025
- "description": "Do not create \"spec.ts\" test files for the new class.",
1048
+ "description": "Skip the generation of a unit test file `spec.ts` for the new class.",
1026
1049
  "default": false
1027
1050
  },
1028
1051
  "type": {
1029
1052
  "type": "string",
1030
- "description": "Adds a developer-defined type to the filename, in the format \"name.type.ts\"."
1053
+ "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`."
1031
1054
  }
1032
1055
  }
1033
1056
  },
1034
1057
  "SchematicsAngularComponentSchema": {
1035
1058
  "title": "Angular Component Options Schema",
1036
1059
  "type": "object",
1037
- "description": "Creates a new, generic component definition in the given project.",
1060
+ "description": "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.",
1038
1061
  "additionalProperties": false,
1039
1062
  "properties": {
1040
1063
  "path": {
@@ -1043,49 +1066,49 @@
1043
1066
  "$default": {
1044
1067
  "$source": "workingDirectory"
1045
1068
  },
1046
- "description": "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.",
1069
+ "description": "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.",
1047
1070
  "visible": false
1048
1071
  },
1049
1072
  "project": {
1050
1073
  "type": "string",
1051
- "description": "The name of the project.",
1074
+ "description": "The name of the project where the component should be added. If not specified, the CLI will determine the project from the current directory.",
1052
1075
  "$default": {
1053
1076
  "$source": "projectName"
1054
1077
  }
1055
1078
  },
1056
1079
  "name": {
1057
1080
  "type": "string",
1058
- "description": "The name of the component.",
1081
+ "description": "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`.",
1059
1082
  "$default": {
1060
1083
  "$source": "argv",
1061
1084
  "index": 0
1062
1085
  }
1063
1086
  },
1064
1087
  "displayBlock": {
1065
- "description": "Specifies if the style will contain `:host { display: block; }`.",
1088
+ "description": "Adds `:host { display: block; }` to the component's stylesheet, ensuring the component renders as a block-level element. This is useful for layout purposes.",
1066
1089
  "type": "boolean",
1067
1090
  "default": false,
1068
1091
  "alias": "b"
1069
1092
  },
1070
1093
  "inlineStyle": {
1071
- "description": "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.",
1094
+ "description": "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.",
1072
1095
  "type": "boolean",
1073
1096
  "default": false,
1074
1097
  "alias": "s"
1075
1098
  },
1076
1099
  "inlineTemplate": {
1077
- "description": "Include template inline in the component.ts file. By default, an external template file is created and referenced in the component.ts file.",
1100
+ "description": "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.",
1078
1101
  "type": "boolean",
1079
1102
  "default": false,
1080
1103
  "alias": "t"
1081
1104
  },
1082
1105
  "standalone": {
1083
- "description": "Whether the generated component is standalone.",
1106
+ "description": "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.",
1084
1107
  "type": "boolean",
1085
1108
  "default": true
1086
1109
  },
1087
1110
  "viewEncapsulation": {
1088
- "description": "The view encapsulation strategy to use in the new component.",
1111
+ "description": "Sets the view encapsulation mode for the component. This determines how the component's styles are scoped and applied.",
1089
1112
  "enum": [
1090
1113
  "Emulated",
1091
1114
  "None",
@@ -1095,7 +1118,7 @@
1095
1118
  "alias": "v"
1096
1119
  },
1097
1120
  "changeDetection": {
1098
- "description": "The change detection strategy to use in the new component.",
1121
+ "description": "Configures the change detection strategy for the component.",
1099
1122
  "enum": [
1100
1123
  "Default",
1101
1124
  "OnPush"
@@ -1106,7 +1129,7 @@
1106
1129
  },
1107
1130
  "prefix": {
1108
1131
  "type": "string",
1109
- "description": "The prefix to apply to the generated component selector.",
1132
+ "description": "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`.",
1110
1133
  "alias": "p",
1111
1134
  "oneOf": [
1112
1135
  {
@@ -1119,7 +1142,7 @@
1119
1142
  ]
1120
1143
  },
1121
1144
  "style": {
1122
- "description": "The file extension or preprocessor to use for style files, or 'none' to skip generating the style file.",
1145
+ "description": "Specify the type of stylesheet to be created for the component, or `none` to skip creating a stylesheet.",
1123
1146
  "type": "string",
1124
1147
  "default": "css",
1125
1148
  "enum": [
@@ -1132,60 +1155,60 @@
1132
1155
  },
1133
1156
  "type": {
1134
1157
  "type": "string",
1135
- "description": "Adds a developer-defined type to the filename, in the format \"name.type.ts\".",
1158
+ "description": "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`.",
1136
1159
  "default": "Component"
1137
1160
  },
1138
1161
  "skipTests": {
1139
1162
  "type": "boolean",
1140
- "description": "Do not create \"spec.ts\" test files for the new component.",
1163
+ "description": "Skip the generation of unit test files `spec.ts`.",
1141
1164
  "default": false
1142
1165
  },
1143
1166
  "flat": {
1144
1167
  "type": "boolean",
1145
- "description": "Create the new files at the top level of the current project.",
1168
+ "description": "Create the component files directly in the project's `src/app` directory instead of creating a new folder for them.",
1146
1169
  "default": false
1147
1170
  },
1148
1171
  "skipImport": {
1149
1172
  "type": "boolean",
1150
- "description": "Do not import this component into the owning NgModule.",
1173
+ "description": "Do not automatically import the new component into its closest NgModule.",
1151
1174
  "default": false
1152
1175
  },
1153
1176
  "selector": {
1154
1177
  "type": "string",
1155
1178
  "format": "html-selector",
1156
- "description": "The HTML selector to use for this component."
1179
+ "description": "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`)."
1157
1180
  },
1158
1181
  "skipSelector": {
1159
1182
  "type": "boolean",
1160
1183
  "default": false,
1161
- "description": "Specifies if the component should have a selector or not."
1184
+ "description": "Skip the generation of an HTML selector for the component."
1162
1185
  },
1163
1186
  "module": {
1164
1187
  "type": "string",
1165
- "description": "The declaring NgModule.",
1188
+ "description": "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.",
1166
1189
  "alias": "m"
1167
1190
  },
1168
1191
  "export": {
1169
1192
  "type": "boolean",
1170
1193
  "default": false,
1171
- "description": "The declaring NgModule exports this component."
1194
+ "description": "Automatically export the component from the specified NgModule, making it accessible to other modules in the application."
1172
1195
  },
1173
1196
  "exportDefault": {
1174
1197
  "type": "boolean",
1175
1198
  "default": false,
1176
- "description": "Use default export for the component instead of a named export."
1199
+ "description": "Use a default export for the component in its TypeScript file instead of a named export."
1177
1200
  }
1178
1201
  }
1179
1202
  },
1180
1203
  "SchematicsAngularDirectiveSchema": {
1181
1204
  "title": "Angular Directive Options Schema",
1182
1205
  "type": "object",
1183
- "description": "Creates a new, generic directive definition in the given project.",
1206
+ "description": "Creates a new directive in your project. Directives are used to extend the behavior or appearance of HTML elements and components. They allow you to manipulate the DOM, add custom attributes, and respond to events. This schematic generates the necessary files and boilerplate code for a new directive.",
1184
1207
  "additionalProperties": false,
1185
1208
  "properties": {
1186
1209
  "name": {
1187
1210
  "type": "string",
1188
- "description": "The name of the new directive.",
1211
+ "description": "The name for the new directive. This will be used to create the directive's class and spec files (e.g., `my-directive.directive.ts` and `my-directive.directive.spec.ts`).",
1189
1212
  "$default": {
1190
1213
  "$source": "argv",
1191
1214
  "index": 0
@@ -1197,19 +1220,19 @@
1197
1220
  "$default": {
1198
1221
  "$source": "workingDirectory"
1199
1222
  },
1200
- "description": "The path at which to create the interface that defines the directive, relative to the workspace root.",
1223
+ "description": "The path where the directive files should be created, relative to the workspace root. If not provided, the directive will be created in the current directory.",
1201
1224
  "visible": false
1202
1225
  },
1203
1226
  "project": {
1204
1227
  "type": "string",
1205
- "description": "The name of the project.",
1228
+ "description": "The name of the project where the directive should be added. If not specified, the CLI will determine the project from the current directory.",
1206
1229
  "$default": {
1207
1230
  "$source": "projectName"
1208
1231
  }
1209
1232
  },
1210
1233
  "prefix": {
1211
1234
  "type": "string",
1212
- "description": "A prefix to apply to generated selectors.",
1235
+ "description": "A prefix to be added to the directive's selector. For example, if the prefix is `app` and the directive name is `highlight`, the selector will be `appHighlight`.",
1213
1236
  "alias": "p",
1214
1237
  "oneOf": [
1215
1238
  {
@@ -1223,50 +1246,50 @@
1223
1246
  },
1224
1247
  "skipTests": {
1225
1248
  "type": "boolean",
1226
- "description": "Do not create \"spec.ts\" test files for the new class.",
1249
+ "description": "Skip the generation of a unit test file `spec.ts` for the new directive.",
1227
1250
  "default": false
1228
1251
  },
1229
1252
  "skipImport": {
1230
1253
  "type": "boolean",
1231
- "description": "Do not import this directive into the owning NgModule.",
1254
+ "description": "Do not automatically import the new directive into its closest NgModule.",
1232
1255
  "default": false
1233
1256
  },
1234
1257
  "selector": {
1235
1258
  "type": "string",
1236
1259
  "format": "html-selector",
1237
- "description": "The HTML selector to use for this directive."
1260
+ "description": "The HTML selector to use for this directive. If not provided, a selector will be generated based on the directive's name (e.g., `appHighlight`)."
1238
1261
  },
1239
1262
  "standalone": {
1240
- "description": "Whether the generated directive is standalone.",
1263
+ "description": "Generate a standalone directive. Standalone directives 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 or directives.",
1241
1264
  "type": "boolean",
1242
1265
  "default": true
1243
1266
  },
1244
1267
  "flat": {
1245
1268
  "type": "boolean",
1246
- "description": "When true (the default), creates the new files at the top level of the current project.",
1269
+ "description": "Creates the new directive files at the top level of the current project. If set to false, a new folder with the directive's name will be created to contain the files.",
1247
1270
  "default": true
1248
1271
  },
1249
1272
  "module": {
1250
1273
  "type": "string",
1251
- "description": "The declaring NgModule.",
1274
+ "description": "Specify the NgModule where the directive should be declared. If not provided, the CLI will attempt to find the closest NgModule in the directive's path.",
1252
1275
  "alias": "m"
1253
1276
  },
1254
1277
  "export": {
1255
1278
  "type": "boolean",
1256
1279
  "default": false,
1257
- "description": "The declaring NgModule exports this directive."
1280
+ "description": "Automatically export the directive from the specified NgModule, making it accessible to other modules in the application."
1258
1281
  }
1259
1282
  }
1260
1283
  },
1261
1284
  "SchematicsAngularEnumSchema": {
1262
1285
  "title": "Angular Enum Options Schema",
1263
1286
  "type": "object",
1264
- "description": "Generates a new, generic enum definition in the given project.",
1287
+ "description": "Creates a new enum in your project. Enums (enumerations) are a way to define a set of named constants, making your code more readable and maintainable. This schematic generates a new enum with the specified name and type.",
1265
1288
  "additionalProperties": false,
1266
1289
  "properties": {
1267
1290
  "name": {
1268
1291
  "type": "string",
1269
- "description": "The name of the enum.",
1292
+ "description": "The name for the new enum. This will be used to create the enum file (e.g., `my-enum.enum.ts`).",
1270
1293
  "$default": {
1271
1294
  "$source": "argv",
1272
1295
  "index": 0
@@ -1278,31 +1301,31 @@
1278
1301
  "$default": {
1279
1302
  "$source": "workingDirectory"
1280
1303
  },
1281
- "description": "The path at which to create the enum definition, relative to the current workspace.",
1304
+ "description": "The path where the enum file should be created, relative to the current workspace. If not specified, the enum will be created in the current directory.",
1282
1305
  "visible": false
1283
1306
  },
1284
1307
  "project": {
1285
1308
  "type": "string",
1286
- "description": "The name of the project in which to create the enum. Default is the configured default project for the workspace.",
1309
+ "description": "The name of the project where the enum should be created. If not specified, the CLI will determine the project from the current directory.",
1287
1310
  "$default": {
1288
1311
  "$source": "projectName"
1289
1312
  }
1290
1313
  },
1291
1314
  "type": {
1292
1315
  "type": "string",
1293
- "description": "Adds a developer-defined type to the filename, in the format \"name.type.ts\"."
1316
+ "description": "Adds a custom type to the filename, allowing you to create more descriptive enum names. For example, if you set the type to `status`, the filename will be `my-enum.status.ts`."
1294
1317
  }
1295
1318
  }
1296
1319
  },
1297
1320
  "SchematicsAngularGuardSchema": {
1298
1321
  "title": "Angular Guard Options Schema",
1299
1322
  "type": "object",
1300
- "description": "Generates a new, generic route guard definition in the given project.",
1323
+ "description": "Creates a new route guard in your project. Route guards are used to control access to parts of your application by checking certain conditions before a route is activated. This schematic generates a new guard with the specified name, type, and options.",
1301
1324
  "additionalProperties": false,
1302
1325
  "properties": {
1303
1326
  "name": {
1304
1327
  "type": "string",
1305
- "description": "The name of the new route guard.",
1328
+ "description": "The name for the new route guard. This will be used to create the guard's class and spec files (e.g., `my-guard.guard.ts` and `my-guard.guard.spec.ts`).",
1306
1329
  "$default": {
1307
1330
  "$source": "argv",
1308
1331
  "index": 0
@@ -1310,12 +1333,12 @@
1310
1333
  },
1311
1334
  "skipTests": {
1312
1335
  "type": "boolean",
1313
- "description": "Do not create \"spec.ts\" test files for the new guard.",
1336
+ "description": "Skip the generation of a unit test file `spec.ts` for the new guard.",
1314
1337
  "default": false
1315
1338
  },
1316
1339
  "flat": {
1317
1340
  "type": "boolean",
1318
- "description": "When true (the default), creates the new files at the top level of the current project.",
1341
+ "description": "Creates the new guard files at the top level of the current project. If set to false, a new folder with the guard's name will be created to contain the files.",
1319
1342
  "default": true
1320
1343
  },
1321
1344
  "path": {
@@ -1324,25 +1347,25 @@
1324
1347
  "$default": {
1325
1348
  "$source": "workingDirectory"
1326
1349
  },
1327
- "description": "The path at which to create the interface that defines the guard, relative to the current workspace.",
1350
+ "description": "The path where the guard files should be created, relative to the current workspace. If not provided, the guard will be created in the current directory.",
1328
1351
  "visible": false
1329
1352
  },
1330
1353
  "project": {
1331
1354
  "type": "string",
1332
- "description": "The name of the project.",
1355
+ "description": "The name of the project where the guard should be created. If not specified, the CLI will determine the project from the current directory.",
1333
1356
  "$default": {
1334
1357
  "$source": "projectName"
1335
1358
  }
1336
1359
  },
1337
1360
  "functional": {
1338
1361
  "type": "boolean",
1339
- "description": "Specifies whether to generate a guard as a function.",
1362
+ "description": "Generate the guard as a function instead of a class. Functional guards can be simpler for basic scenarios.",
1340
1363
  "default": true
1341
1364
  },
1342
1365
  "implements": {
1343
1366
  "alias": "guardType",
1344
1367
  "type": "array",
1345
- "description": "Specifies which type of guard to create.",
1368
+ "description": "Specifies the type(s) of guard to create. You can choose one or more of the following: `CanActivate` (controls access to a route), `CanActivateChild` (controls access to child routes), `CanDeactivate` (asks for confirmation before leaving a route), `CanMatch` (determines if a route can be matched).",
1346
1369
  "uniqueItems": true,
1347
1370
  "minItems": 1,
1348
1371
  "items": {
@@ -1364,11 +1387,11 @@
1364
1387
  "title": "Angular Interceptor Options Schema",
1365
1388
  "type": "object",
1366
1389
  "additionalProperties": false,
1367
- "description": "Creates a new, generic interceptor definition in the given project.",
1390
+ "description": "Creates a new interceptor in your project. Interceptors are used to intercept and modify HTTP requests and responses before they reach their destination. This allows you to perform tasks like adding authentication headers, handling errors, or logging requests. This schematic generates the necessary files and boilerplate code for a new interceptor.",
1368
1391
  "properties": {
1369
1392
  "name": {
1370
1393
  "type": "string",
1371
- "description": "The name of the interceptor.",
1394
+ "description": "The name for the new interceptor. This will be used to create the interceptor's class and spec files (e.g., `my-interceptor.interceptor.ts` and `my-interceptor.interceptor.spec.ts`).",
1372
1395
  "$default": {
1373
1396
  "$source": "argv",
1374
1397
  "index": 0
@@ -1380,12 +1403,12 @@
1380
1403
  "$default": {
1381
1404
  "$source": "workingDirectory"
1382
1405
  },
1383
- "description": "The path at which to create the interceptor, relative to the workspace root.",
1406
+ "description": "The path where the interceptor files should be created, relative to the workspace root. If not provided, the interceptor will be created in the current directory.",
1384
1407
  "visible": false
1385
1408
  },
1386
1409
  "project": {
1387
1410
  "type": "string",
1388
- "description": "The name of the project.",
1411
+ "description": "The name of the project where the interceptor should be created. If not specified, the CLI will determine the project from the current directory.",
1389
1412
  "$default": {
1390
1413
  "$source": "projectName"
1391
1414
  }
@@ -1393,16 +1416,16 @@
1393
1416
  "flat": {
1394
1417
  "type": "boolean",
1395
1418
  "default": true,
1396
- "description": "When true (the default), creates files at the top level of the project."
1419
+ "description": "Creates the new interceptor files at the top level of the current project. If set to false, a new folder with the interceptor's name will be created to contain the files."
1397
1420
  },
1398
1421
  "skipTests": {
1399
1422
  "type": "boolean",
1400
- "description": "Do not create \"spec.ts\" test files for the new interceptor.",
1423
+ "description": "Skip the generation of a unit test file `spec.ts` for the new interceptor.",
1401
1424
  "default": false
1402
1425
  },
1403
1426
  "functional": {
1404
1427
  "type": "boolean",
1405
- "description": "Creates the interceptor as a `HttpInterceptorFn`.",
1428
+ "description": "Creates the interceptor as a function `HttpInterceptorFn` instead of a class. Functional interceptors can be simpler for basic scenarios.",
1406
1429
  "default": true
1407
1430
  }
1408
1431
  }
@@ -1411,11 +1434,11 @@
1411
1434
  "title": "Angular Interface Options Schema",
1412
1435
  "type": "object",
1413
1436
  "additionalProperties": false,
1414
- "description": "Creates a new, generic interface definition in the given project.",
1437
+ "description": "Creates a new interface in your project. Interfaces define the structure of objects in TypeScript, ensuring type safety and code clarity. This schematic generates a new interface with the specified name and type.",
1415
1438
  "properties": {
1416
1439
  "name": {
1417
1440
  "type": "string",
1418
- "description": "The name of the interface.",
1441
+ "description": "The name for the new interface. This will be used to create the interface file (e.g., `my-interface.interface.ts`).",
1419
1442
  "$default": {
1420
1443
  "$source": "argv",
1421
1444
  "index": 0
@@ -1427,23 +1450,23 @@
1427
1450
  "$default": {
1428
1451
  "$source": "workingDirectory"
1429
1452
  },
1430
- "description": "The path at which to create the interface, relative to the workspace root.",
1453
+ "description": "The path where the interface file should be created, relative to the workspace root. If not provided, the interface will be created in the current directory.",
1431
1454
  "visible": false
1432
1455
  },
1433
1456
  "project": {
1434
1457
  "type": "string",
1435
- "description": "The name of the project.",
1458
+ "description": "The name of the project where the interface should be created. If not specified, the CLI will determine the project from the current directory.",
1436
1459
  "$default": {
1437
1460
  "$source": "projectName"
1438
1461
  }
1439
1462
  },
1440
1463
  "prefix": {
1441
1464
  "type": "string",
1442
- "description": "A prefix to apply to generated selectors."
1465
+ "description": "A prefix to be added to the interface name. This is typically not used for interfaces, as they don't have selectors like components or directives."
1443
1466
  },
1444
1467
  "type": {
1445
1468
  "type": "string",
1446
- "description": "Adds a developer-defined type to the filename, in the format \"name.type.ts\".",
1469
+ "description": "Adds a custom type to the filename, allowing you to create more descriptive interface names. For example, if you set the type to `data`, the filename will be `my-interface.data.ts`.",
1447
1470
  "$default": {
1448
1471
  "$source": "argv",
1449
1472
  "index": 1
@@ -1454,12 +1477,12 @@
1454
1477
  "SchematicsAngularLibrarySchema": {
1455
1478
  "title": "Library Options Schema",
1456
1479
  "type": "object",
1457
- "description": "Creates a new, generic library project in the current workspace.",
1480
+ "description": "Creates a new library project in your Angular workspace. Libraries are reusable collections of components, services, and other Angular artifacts that can be shared across multiple applications. This schematic simplifies the process of generating a new library with the necessary files and configurations.",
1458
1481
  "additionalProperties": false,
1459
1482
  "properties": {
1460
1483
  "name": {
1461
1484
  "type": "string",
1462
- "description": "The name of the library.",
1485
+ "description": "The name for the new library. This name will be used for the project directory and various identifiers within the library's code.",
1463
1486
  "pattern": "^(?:@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*/)?[a-zA-Z0-9-~][a-zA-Z0-9-._~]*$",
1464
1487
  "$default": {
1465
1488
  "$source": "argv",
@@ -1469,37 +1492,37 @@
1469
1492
  "entryFile": {
1470
1493
  "type": "string",
1471
1494
  "format": "path",
1472
- "description": "The path at which to create the library's public API file, relative to the workspace root.",
1495
+ "description": "The path to the library's public API file, relative to the workspace root. This file defines what parts of the library are accessible to applications that import it.",
1473
1496
  "default": "public-api"
1474
1497
  },
1475
1498
  "prefix": {
1476
1499
  "type": "string",
1477
1500
  "format": "html-selector",
1478
- "description": "A prefix to apply to generated selectors.",
1501
+ "description": "A prefix to be added to the selectors of components generated within this library. For example, if the prefix is `my-lib` and you generate a component named `my-component`, the selector will be `my-lib-my-component`.",
1479
1502
  "default": "lib",
1480
1503
  "alias": "p"
1481
1504
  },
1482
1505
  "skipPackageJson": {
1483
1506
  "type": "boolean",
1484
1507
  "default": false,
1485
- "description": "Do not add dependencies to the \"package.json\" file. "
1508
+ "description": "Do not automatically add dependencies to the `package.json` file."
1486
1509
  },
1487
1510
  "skipInstall": {
1488
- "description": "Do not install dependency packages.",
1511
+ "description": "Skip the automatic installation of packages. You will need to manually install the dependencies later.",
1489
1512
  "type": "boolean",
1490
1513
  "default": false
1491
1514
  },
1492
1515
  "skipTsConfig": {
1493
1516
  "type": "boolean",
1494
1517
  "default": false,
1495
- "description": "Do not update \"tsconfig.json\" to add a path mapping for the new library. The path mapping is needed to use the library in an app, but can be disabled here to simplify development."
1518
+ "description": "Do not update the workspace `tsconfig.json` file to add a path mapping for the new library. The path mapping is needed to use the library in an application, but can be disabled here to simplify development."
1496
1519
  },
1497
1520
  "projectRoot": {
1498
1521
  "type": "string",
1499
- "description": "The root directory of the new library."
1522
+ "description": "The root directory for the new library, relative to the workspace root. If not specified, the library will be created in a subfolder within the `projects` directory, using the library's name."
1500
1523
  },
1501
1524
  "standalone": {
1502
- "description": "Creates a library based upon the standalone API, without NgModules.",
1525
+ "description": "Create a library that utilizes the standalone API, eliminating the need for NgModules. This can simplify the structure of your library and its usage in applications.",
1503
1526
  "type": "boolean",
1504
1527
  "default": true
1505
1528
  }
@@ -1509,11 +1532,11 @@
1509
1532
  "title": "Angular Pipe Options Schema",
1510
1533
  "type": "object",
1511
1534
  "additionalProperties": false,
1512
- "description": "Creates a new, generic pipe definition in the given project.",
1535
+ "description": "Creates a new pipe in your project. Pipes are used to transform data for display in templates. They take input values and apply a specific transformation, such as formatting dates, currency, or filtering arrays. This schematic generates the necessary files and boilerplate code for a new pipe.",
1513
1536
  "properties": {
1514
1537
  "name": {
1515
1538
  "type": "string",
1516
- "description": "The name of the pipe.",
1539
+ "description": "The name for the new pipe. This will be used to create the pipe's class and spec files (e.g., `my-pipe.pipe.ts` and `my-pipe.pipe.spec.ts`).",
1517
1540
  "$default": {
1518
1541
  "$source": "argv",
1519
1542
  "index": 0
@@ -1525,12 +1548,12 @@
1525
1548
  "$default": {
1526
1549
  "$source": "workingDirectory"
1527
1550
  },
1528
- "description": "The path at which to create the pipe, relative to the workspace root.",
1551
+ "description": "The path where the pipe files should be created, relative to the workspace root. If not provided, the pipe will be created in the current directory.",
1529
1552
  "visible": false
1530
1553
  },
1531
1554
  "project": {
1532
1555
  "type": "string",
1533
- "description": "The name of the project.",
1556
+ "description": "The name of the project where the pipe should be created. If not specified, the CLI will determine the project from the current directory.",
1534
1557
  "$default": {
1535
1558
  "$source": "projectName"
1536
1559
  }
@@ -1538,47 +1561,47 @@
1538
1561
  "flat": {
1539
1562
  "type": "boolean",
1540
1563
  "default": true,
1541
- "description": "When true (the default) creates files at the top level of the project."
1564
+ "description": "Creates the new pipe files at the top level of the current project. If set to false, a new folder with the pipe's name will be created to contain the files."
1542
1565
  },
1543
1566
  "skipTests": {
1544
1567
  "type": "boolean",
1545
- "description": "Do not create \"spec.ts\" test files for the new pipe.",
1568
+ "description": "Prevent the generation of a unit test file `spec.ts` for the new pipe.",
1546
1569
  "default": false
1547
1570
  },
1548
1571
  "skipImport": {
1549
1572
  "type": "boolean",
1550
1573
  "default": false,
1551
- "description": "Do not import this pipe into the owning NgModule."
1574
+ "description": "Do not automatically import the new pipe into its closest NgModule."
1552
1575
  },
1553
1576
  "standalone": {
1554
- "description": "Whether the generated pipe is standalone.",
1577
+ "description": "Generate a standalone pipe. Standalone pipes 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, directives, or pipes.",
1555
1578
  "type": "boolean",
1556
1579
  "default": true
1557
1580
  },
1558
1581
  "module": {
1559
1582
  "type": "string",
1560
- "description": "The declaring NgModule.",
1583
+ "description": "Specify the NgModule where the pipe should be declared. If not provided, the CLI will attempt to find the closest NgModule in the pipe's path.",
1561
1584
  "alias": "m"
1562
1585
  },
1563
1586
  "export": {
1564
1587
  "type": "boolean",
1565
1588
  "default": false,
1566
- "description": "The declaring NgModule exports this pipe."
1589
+ "description": "Automatically export the pipe from the specified NgModule, making it accessible to other modules in the application."
1567
1590
  }
1568
1591
  }
1569
1592
  },
1570
1593
  "SchematicsAngularNgNewSchema": {
1571
1594
  "title": "Angular Ng New Options Schema",
1572
1595
  "type": "object",
1573
- "description": "Creates a new project by combining the workspace and application schematics.",
1596
+ "description": "Creates a new Angular workspace and an initial project. This schematic sets up the foundation for your Angular development, generating the workspace configuration files and an optional starter application. You can customize various aspects of the workspace and the initial project, such as routing, styling, and testing.",
1574
1597
  "additionalProperties": false,
1575
1598
  "properties": {
1576
1599
  "directory": {
1577
1600
  "type": "string",
1578
- "description": "The directory name to create the workspace in."
1601
+ "description": "The directory where the new workspace and project should be created. If not specified, the workspace will be created in the current directory."
1579
1602
  },
1580
1603
  "name": {
1581
- "description": "The name of the new workspace and initial project.",
1604
+ "description": "The name for the new workspace and the initial project. This name will be used for the root directory and various identifiers throughout the project.",
1582
1605
  "type": "string",
1583
1606
  "$default": {
1584
1607
  "$source": "argv",
@@ -1586,18 +1609,18 @@
1586
1609
  }
1587
1610
  },
1588
1611
  "skipInstall": {
1589
- "description": "Do not install dependency packages.",
1612
+ "description": "Skip the automatic installation of packages. You will need to manually install the dependencies later.",
1590
1613
  "type": "boolean",
1591
1614
  "default": false
1592
1615
  },
1593
1616
  "skipGit": {
1594
- "description": "Do not initialize a git repository.",
1617
+ "description": "Do not initialize a Git repository in the new workspace. By default, a Git repository is initialized to help you track changes to your project.",
1595
1618
  "type": "boolean",
1596
1619
  "default": false,
1597
1620
  "alias": "g"
1598
1621
  },
1599
1622
  "commit": {
1600
- "description": "Initial git repository commit information.",
1623
+ "description": "Configure the initial Git commit for the new repository.",
1601
1624
  "oneOf": [
1602
1625
  {
1603
1626
  "type": "boolean"
@@ -1621,22 +1644,22 @@
1621
1644
  "default": true
1622
1645
  },
1623
1646
  "newProjectRoot": {
1624
- "description": "The path where new projects will be created, relative to the new workspace root.",
1647
+ "description": "The path where new projects will be created within the workspace, relative to the workspace root. By default, new projects are created in the `projects` directory.",
1625
1648
  "type": "string",
1626
1649
  "default": "projects"
1627
1650
  },
1628
1651
  "inlineStyle": {
1629
- "description": "Include styles inline in the component TS file. By default, an external styles file is created and referenced in the component TypeScript file.",
1652
+ "description": "Include the styles for the initial application's root component directly within the `app.component.ts` file. By default, a separate stylesheet file (e.g., `app.component.css`) is created.",
1630
1653
  "type": "boolean",
1631
1654
  "alias": "s"
1632
1655
  },
1633
1656
  "inlineTemplate": {
1634
- "description": "Include template inline in the component TS file. By default, an external template file is created and referenced in the component TypeScript file.",
1657
+ "description": "Include the HTML template for the initial application's root component directly within the `app.component.ts` file. By default, a separate template file (e.g., `app.component.html`) is created.",
1635
1658
  "type": "boolean",
1636
1659
  "alias": "t"
1637
1660
  },
1638
1661
  "viewEncapsulation": {
1639
- "description": "The view encapsulation strategy to use in the initial project.",
1662
+ "description": "Sets the view encapsulation mode for components in the initial project. This determines how component styles are scoped and applied. Options include: `Emulated` (default, styles are scoped to the component), `None` (styles are global), and `ShadowDom` (styles are encapsulated using Shadow DOM).",
1640
1663
  "enum": [
1641
1664
  "Emulated",
1642
1665
  "None",
@@ -1654,18 +1677,18 @@
1654
1677
  },
1655
1678
  "routing": {
1656
1679
  "type": "boolean",
1657
- "description": "Enable routing in the initial project."
1680
+ "description": "Enable routing in the initial application project. This sets up the necessary files and modules for managing navigation between different views in your application."
1658
1681
  },
1659
1682
  "prefix": {
1660
1683
  "type": "string",
1661
1684
  "format": "html-selector",
1662
- "description": "The prefix to apply to generated selectors for the initial project.",
1685
+ "description": "The prefix to apply to generated selectors for the initial project. For example, if the prefix is `my-app` and you generate a component named `my-component`, the selector will be `my-app-my-component`.",
1663
1686
  "minLength": 1,
1664
1687
  "default": "app",
1665
1688
  "alias": "p"
1666
1689
  },
1667
1690
  "style": {
1668
- "description": "The file extension or preprocessor to use for style files.",
1691
+ "description": "The type of stylesheet files to be created for components in the initial project.",
1669
1692
  "type": "string",
1670
1693
  "enum": [
1671
1694
  "css",
@@ -1675,23 +1698,23 @@
1675
1698
  ]
1676
1699
  },
1677
1700
  "skipTests": {
1678
- "description": "Do not generate \"spec.ts\" test files for the new project.",
1701
+ "description": "Skip the generation of unit test files `spec.ts`.",
1679
1702
  "type": "boolean",
1680
1703
  "default": false,
1681
1704
  "alias": "S"
1682
1705
  },
1683
1706
  "createApplication": {
1684
- "description": "Create a new initial application project in the 'src' folder of the new workspace. When false, creates an empty workspace with no initial application. You can then use the generate application command so that all applications are created in the projects folder.",
1707
+ "description": "Create a new initial application project in the new workspace. When false, creates an empty workspace with no initial application. You can then use the `ng generate application` command to create applications in the `projects` directory.",
1685
1708
  "type": "boolean",
1686
1709
  "default": true
1687
1710
  },
1688
1711
  "minimal": {
1689
- "description": "Create a workspace without any testing frameworks. (Use for learning purposes only.)",
1712
+ "description": "Generate a minimal Angular workspace without any testing frameworks. This is intended for learning purposes and simple experimentation, not for production applications.",
1690
1713
  "type": "boolean",
1691
1714
  "default": false
1692
1715
  },
1693
1716
  "strict": {
1694
- "description": "Creates a workspace with stricter type checking and stricter bundle budgets settings. This setting helps improve maintainability and catch bugs ahead of time. For more information, see https://angular.dev/tools/cli/template-typecheck#strict-mode",
1717
+ "description": "Enable stricter type checking and stricter bundle budgets settings. This setting helps improve maintainability and catch bugs ahead of time. For more information, see https://angular.dev/tools/cli/template-typecheck#strict-mode",
1695
1718
  "type": "boolean",
1696
1719
  "default": true
1697
1720
  },
@@ -1712,29 +1735,29 @@
1712
1735
  "default": true
1713
1736
  },
1714
1737
  "ssr": {
1715
- "description": "Creates an application with Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) enabled.",
1738
+ "description": "Configure the initial application for Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering).",
1716
1739
  "type": "boolean"
1717
1740
  },
1718
1741
  "serverRouting": {
1719
- "description": "Creates a server application using the Server Routing and App Engine APIs (Developer Preview).",
1742
+ "description": "Create a server application in the initial project using the Server Routing and App Engine APIs (Developer Preview).",
1720
1743
  "type": "boolean"
1721
1744
  },
1722
1745
  "experimentalZoneless": {
1723
- "description": "Create an application that does not utilize zone.js.",
1746
+ "description": "Create an initial application that does not utilize `zone.js`.",
1724
1747
  "type": "boolean",
1725
1748
  "default": false
1726
1749
  }
1727
1750
  }
1728
1751
  },
1729
1752
  "SchematicsAngularResolverSchema": {
1730
- "title": "Angular resolver Options Schema",
1753
+ "title": "Angular Resolver Options Schema",
1731
1754
  "type": "object",
1732
1755
  "additionalProperties": false,
1733
- "description": "Generates a new, generic resolver definition in the given project.",
1756
+ "description": "Creates a new resolver in your project. Resolvers are used to pre-fetch data before a route is activated, ensuring that the necessary data is available before the component is displayed. This can improve the user experience by preventing delays and loading states. This schematic generates a new resolver with the specified name and options.",
1734
1757
  "properties": {
1735
1758
  "name": {
1736
1759
  "type": "string",
1737
- "description": "The name of the new resolver.",
1760
+ "description": "The name for the new resolver. This will be used to create the resolver's class and spec files (e.g., `my-resolver.resolver.ts` and `my-resolver.resolver.spec.ts`).",
1738
1761
  "$default": {
1739
1762
  "$source": "argv",
1740
1763
  "index": 0
@@ -1742,17 +1765,17 @@
1742
1765
  },
1743
1766
  "skipTests": {
1744
1767
  "type": "boolean",
1745
- "description": "Do not create \"spec.ts\" test files for the new resolver.",
1768
+ "description": "Skip the generation of a unit test file `spec.ts` for the new resolver.",
1746
1769
  "default": false
1747
1770
  },
1748
1771
  "flat": {
1749
1772
  "type": "boolean",
1750
- "description": "When true (the default), creates the new files at the top level of the current project.",
1773
+ "description": "Creates the new resolver files at the top level of the current project. If set to false, a new folder with the resolver's name will be created to contain the files.",
1751
1774
  "default": true
1752
1775
  },
1753
1776
  "functional": {
1754
1777
  "type": "boolean",
1755
- "description": "Creates the resolver as a `ResolveFn`.",
1778
+ "description": "Creates the resolver as a function `ResolveFn` instead of a class. Functional resolvers can be simpler for basic scenarios.",
1756
1779
  "default": true
1757
1780
  },
1758
1781
  "path": {
@@ -1761,12 +1784,12 @@
1761
1784
  "$default": {
1762
1785
  "$source": "workingDirectory"
1763
1786
  },
1764
- "description": "The path at which to create the interface that defines the resolver, relative to the current workspace.",
1787
+ "description": "The path where the resolver files should be created, relative to the current workspace. If not provided, the resolver will be created in the current directory.",
1765
1788
  "visible": false
1766
1789
  },
1767
1790
  "project": {
1768
1791
  "type": "string",
1769
- "description": "The name of the project.",
1792
+ "description": "The name of the project where the resolver should be created. If not specified, the CLI will determine the project from the current directory.",
1770
1793
  "$default": {
1771
1794
  "$source": "projectName"
1772
1795
  }
@@ -1777,11 +1800,11 @@
1777
1800
  "title": "Angular Service Options Schema",
1778
1801
  "type": "object",
1779
1802
  "additionalProperties": false,
1780
- "description": "Creates a new, generic service definition in the given project.",
1803
+ "description": "Creates a new service in your project. Services are used to encapsulate reusable logic, such as data access, API calls, or utility functions. This schematic simplifies the process of generating a new service with the necessary files and boilerplate code.",
1781
1804
  "properties": {
1782
1805
  "name": {
1783
1806
  "type": "string",
1784
- "description": "The name of the service.",
1807
+ "description": "The name for the new service. This will be used to create the service's class and spec files (e.g., `my-service.service.ts` and `my-service.service.spec.ts`).",
1785
1808
  "$default": {
1786
1809
  "$source": "argv",
1787
1810
  "index": 0
@@ -1792,12 +1815,12 @@
1792
1815
  "$default": {
1793
1816
  "$source": "workingDirectory"
1794
1817
  },
1795
- "description": "The path at which to create the service, relative to the workspace root.",
1818
+ "description": "The path where the service files should be created, relative to the workspace root. If not provided, the service will be created in the project's `src/app` directory.",
1796
1819
  "visible": false
1797
1820
  },
1798
1821
  "project": {
1799
1822
  "type": "string",
1800
- "description": "The name of the project.",
1823
+ "description": "The name of the project where the service should be added. If not specified, the CLI will determine the project from the current directory.",
1801
1824
  "$default": {
1802
1825
  "$source": "projectName"
1803
1826
  }
@@ -1805,11 +1828,11 @@
1805
1828
  "flat": {
1806
1829
  "type": "boolean",
1807
1830
  "default": true,
1808
- "description": "When true (the default), creates files at the top level of the project."
1831
+ "description": "Creates files at the top level of the project or the given path. If set to false, a new folder with the service's name will be created to contain the files."
1809
1832
  },
1810
1833
  "skipTests": {
1811
1834
  "type": "boolean",
1812
- "description": "Do not create \"spec.ts\" test files for the new service.",
1835
+ "description": "Skip the generation of a unit test file `spec.ts` for the service.",
1813
1836
  "default": false
1814
1837
  }
1815
1838
  }
@@ -1818,7 +1841,7 @@
1818
1841
  "title": "Angular Web Worker Options Schema",
1819
1842
  "type": "object",
1820
1843
  "additionalProperties": false,
1821
- "description": "Creates a new, generic web worker definition in the given project.",
1844
+ "description": "Creates a new web worker in your project. Web workers allow you to run JavaScript code in the background, improving the performance and responsiveness of your application by offloading computationally intensive tasks. This schematic generates the necessary files for a new web worker and provides an optional code snippet to demonstrate its usage.",
1822
1845
  "properties": {
1823
1846
  "path": {
1824
1847
  "type": "string",
@@ -1826,19 +1849,19 @@
1826
1849
  "$default": {
1827
1850
  "$source": "workingDirectory"
1828
1851
  },
1829
- "description": "The path at which to create the worker file, relative to the current workspace.",
1852
+ "description": "The path where the web worker file should be created, relative to the current workspace. If not specified, the worker will be created in the current directory.",
1830
1853
  "visible": false
1831
1854
  },
1832
1855
  "project": {
1833
1856
  "type": "string",
1834
- "description": "The name of the project.",
1857
+ "description": "The name of the project where the web worker should be created. If not specified, the CLI will determine the project from the current directory.",
1835
1858
  "$default": {
1836
1859
  "$source": "projectName"
1837
1860
  }
1838
1861
  },
1839
1862
  "name": {
1840
1863
  "type": "string",
1841
- "description": "The name of the worker.",
1864
+ "description": "The name for the new web worker. This will be used to create the worker file (e.g., `my-worker.worker.ts`).",
1842
1865
  "$default": {
1843
1866
  "$source": "argv",
1844
1867
  "index": 0
@@ -1847,7 +1870,7 @@
1847
1870
  "snippet": {
1848
1871
  "type": "boolean",
1849
1872
  "default": true,
1850
- "description": "Add a worker creation snippet in a sibling file of the same name."
1873
+ "description": "Generate a code snippet that demonstrates how to create and use the new web worker."
1851
1874
  }
1852
1875
  }
1853
1876
  },
@@ -5197,6 +5220,31 @@
5197
5220
  }
5198
5221
  },
5199
5222
  "additionalProperties": false
5223
+ },
5224
+ "AngularBuildBuildersNgPackagrSchema": {
5225
+ "title": "ng-packagr Target",
5226
+ "description": "ng-packagr target options for Build Architect. Use to build library projects.",
5227
+ "type": "object",
5228
+ "properties": {
5229
+ "project": {
5230
+ "type": "string",
5231
+ "description": "The file path for the ng-packagr configuration file, relative to the current workspace."
5232
+ },
5233
+ "tsConfig": {
5234
+ "type": "string",
5235
+ "description": "The full path for the TypeScript configuration file, relative to the current workspace."
5236
+ },
5237
+ "watch": {
5238
+ "type": "boolean",
5239
+ "description": "Run build when files change.",
5240
+ "default": false
5241
+ },
5242
+ "poll": {
5243
+ "type": "number",
5244
+ "description": "Enable and define the file watching poll time period in milliseconds."
5245
+ }
5246
+ },
5247
+ "additionalProperties": false
5200
5248
  }
5201
5249
  }
5202
5250
  }