@schematics/angular 21.0.0-next.5 → 21.0.0-next.6

package/ai-config/index.js

@@ -11,6 +11,10 @@ exports.default = default_1;
 const schematics_1 = require("@angular-devkit/schematics");
 const schema_1 = require("./schema");
 const AI_TOOLS = {
+    agents: {
+        rulesName: 'AGENTS.md',
+        directory: '.',
+    },
     gemini: {
         rulesName: 'GEMINI.md',
         directory: '.gemini',
@@ -39,19 +43,32 @@ const AI_TOOLS = {
     },
 };
 function default_1({ tool }) {
-    if (!tool) {
-        return (0, schematics_1.noop)();
-    }
-    const rules = tool
-        .filter((tool) => tool !== schema_1.Tool.None)
-        .map((selectedTool) => AI_TOOLS[selectedTool])
-        .map(({ rulesName, directory, frontmatter }) => (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)('./files'), [
-        (0, schematics_1.applyTemplates)({
-            ...schematics_1.strings,
-            rulesName,
-            frontmatter,
-        }),
-        (0, schematics_1.move)(directory),
-    ])));
-    return (0, schematics_1.chain)(rules);
+    return (tree, context) => {
+        if (!tool) {
+            return (0, schematics_1.noop)();
+        }
+        const rules = tool
+            .filter((tool) => tool !== schema_1.Tool.None)
+            .map((selectedTool) => {
+            const { rulesName, directory, frontmatter } = AI_TOOLS[selectedTool];
+            const path = `${directory}/${rulesName}`;
+            if (tree.exists(path)) {
+                const toolName = schematics_1.strings.classify(selectedTool);
+                context.logger.warn(`Skipping configuration file for '${toolName}' at '${path}' because it already exists.\n` +
+                    'This is to prevent overwriting a potentially customized file. ' +
+                    'If you want to regenerate it with Angular recommended defaults, please delete the existing file and re-run the command.\n' +
+                    'You can review the latest recommendations at https://angular.dev/ai/develop-with-ai.');
+                return (0, schematics_1.noop)();
+            }
+            return (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)('./files'), [
+                (0, schematics_1.applyTemplates)({
+                    ...schematics_1.strings,
+                    rulesName,
+                    frontmatter,
+                }),
+                (0, schematics_1.move)(directory),
+            ]));
+        });
+        return (0, schematics_1.chain)(rules);
+    };
 }

package/ai-config/schema.d.ts

@@ -11,6 +11,7 @@ export type Schema = {
     tool?: Tool[];
 };
 export declare enum Tool {
+    Agents = "agents",
     Claude = "claude",
     Copilot = "copilot",
     Cursor = "cursor",

package/ai-config/schema.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tool = void 0;
 var Tool;
 (function (Tool) {
+    Tool["Agents"] = "agents";
     Tool["Claude"] = "claude";
     Tool["Copilot"] = "copilot";
     Tool["Cursor"] = "cursor";

package/ai-config/schema.json

@@ -18,6 +18,10 @@
             "value": "none",
             "label": "None"
           },
+          {
+            "value": "agents",
+            "label": "Agents.md      [ https://agents.md/                                               ]"
+          },
           {
             "value": "claude",
             "label": "Claude         [ https://docs.anthropic.com/en/docs/claude-code/memory            ]"
@@ -47,7 +51,7 @@
       "description": "Specifies which AI tools to generate configuration files for. These file are used to improve the outputs of AI tools by following the best practices.",
       "items": {
         "type": "string",
-        "enum": ["none", "gemini", "copilot", "claude", "cursor", "jetbrains", "windsurf"]
+        "enum": ["none", "gemini", "copilot", "claude", "cursor", "jetbrains", "windsurf", "agents"]
       }
     }
   }

package/application/files/module-files/src/app/app__suffix__.spec.ts.template

@@ -20,9 +20,9 @@ describe('App', () => {
     expect(app).toBeTruthy();
   });
 
-  it('should render title', () => {
+  it('should render title', <% if(zoneless) { %> async <% } %>() => {
     const fixture = TestBed.createComponent(App);
-    fixture.detectChanges();
+    <%= zoneless ? 'await fixture.whenStable();' : 'fixture.detectChanges();' %>
     const compiled = fixture.nativeElement as HTMLElement;
     expect(compiled.querySelector('h1')?.textContent).toContain('Hello, <%= name %>');
   });

package/application/files/standalone-files/src/app/app__suffix__.spec.ts.template

@@ -14,9 +14,9 @@ describe('App', () => {
     expect(app).toBeTruthy();
   });
 
-  it('should render title', () => {
+  it('should render title', <% if(zoneless) { %> async <% } %>() => {
     const fixture = TestBed.createComponent(App);
-    fixture.detectChanges();
+    <%= zoneless ? 'await fixture.whenStable();' : 'fixture.detectChanges();' %>
     const compiled = fixture.nativeElement as HTMLElement;
     expect(compiled.querySelector('h1')?.textContent).toContain('Hello, <%= name %>');
   });

package/component/files/__name@dasherize@if-flat__/__name@dasherize__.__type@dasherize__.spec.ts.template

@@ -14,7 +14,7 @@ describe('<%= classifiedName %>', () => {
 
     fixture = TestBed.createComponent(<%= classifiedName %>);
     component = fixture.componentInstance;
-    fixture.detectChanges();
+    <%= zoneless ? 'await fixture.whenStable();' : 'fixture.detectChanges();' %>
   });
 
   it('should create', () => {

package/component/index.js

@@ -12,6 +12,7 @@ const add_declaration_to_ng_module_1 = require("../utility/add-declaration-to-ng
 const find_module_1 = require("../utility/find-module");
 const parse_name_1 = require("../utility/parse-name");
 const project_1 = require("../utility/project");
+const project_targets_1 = require("../utility/project-targets");
 const validation_1 = require("../utility/validation");
 const workspace_1 = require("../utility/workspace");
 const schema_1 = require("./schema");
@@ -40,6 +41,7 @@ exports.default = (0, project_1.createProjectSchematic)((options, { project, tre
     const classifiedName = schematics_1.strings.classify(options.name) +
         (options.addTypeToClassName && options.type ? schematics_1.strings.classify(options.type) : '');
     (0, validation_1.validateClassName)(classifiedName);
+    const zoneless = (0, project_targets_1.isZonelessApp)(project);
     const skipStyleFile = options.inlineStyle || options.style === schema_1.Style.None;
     const templateSource = (0, schematics_1.apply)((0, schematics_1.url)('./files'), [
         options.skipTests ? (0, schematics_1.filter)((path) => !path.endsWith('.spec.ts.template')) : (0, schematics_1.noop)(),
@@ -52,6 +54,7 @@ exports.default = (0, project_1.createProjectSchematic)((options, { project, tre
             ...options,
             // Add a new variable for the classified name, conditionally including the type
             classifiedName,
+            zoneless,
         }),
         !options.type
             ? (0, schematics_1.forEach)(((file) => {

package/migrations/use-application-builder/migration.js

@@ -270,6 +270,7 @@ function default_1() {
             rootJson.modify(['compilerOptions', 'esModuleInterop'], true);
             rootJson.modify(['compilerOptions', 'downlevelIteration'], undefined);
             rootJson.modify(['compilerOptions', 'allowSyntheticDefaultImports'], undefined);
+            rootJson.modify(['compilerOptions', 'moduleResolution'], 'bundler');
         }),
     ]);
 }

package/ng-new/schema.d.ts

@@ -124,6 +124,7 @@ export type Schema = {
     zoneless?: boolean;
 };
 export declare enum AiConfig {
+    Agents = "agents",
     Claude = "claude",
     Copilot = "copilot",
     Cursor = "cursor",

package/ng-new/schema.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViewEncapsulation = exports.Style = exports.PackageManager = exports.FileNameStyleGuide = exports.AiConfig = void 0;
 var AiConfig;
 (function (AiConfig) {
+    AiConfig["Agents"] = "agents";
     AiConfig["Claude"] = "claude";
     AiConfig["Copilot"] = "copilot";
     AiConfig["Cursor"] = "cursor";

package/ng-new/schema.json

@@ -149,7 +149,7 @@
       "description": "Specifies which AI tools to generate configuration files for. These file are used to improve the outputs of AI tools by following the best practices.",
       "items": {
         "type": "string",
-        "enum": ["none", "gemini", "copilot", "claude", "cursor", "jetbrains", "windsurf"]
+        "enum": ["none", "gemini", "copilot", "claude", "cursor", "jetbrains", "windsurf", "agents"]
       }
     },
     "fileNameStyleGuide": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schematics/angular",
-  "version": "21.0.0-next.5",
+  "version": "21.0.0-next.6",
   "description": "Schematics specific to Angular",
   "homepage": "https://github.com/angular/angular-cli",
   "keywords": [
@@ -22,8 +22,8 @@
   },
   "schematics": "./collection.json",
   "dependencies": {
-    "@angular-devkit/core": "21.0.0-next.5",
-    "@angular-devkit/schematics": "21.0.0-next.5",
+    "@angular-devkit/core": "21.0.0-next.6",
+    "@angular-devkit/schematics": "21.0.0-next.6",
     "jsonc-parser": "3.3.1"
   },
   "repository": {

package/ssr/files/application-builder/server.ts.template

@@ -48,10 +48,10 @@ app.use((req, res, next) => {
 });
 
 /**
- * Start the server if this module is the main entry point.
+ * Start the server if this module is the main entry point, or it is ran via PM2.
  * The server listens on the port defined by the `PORT` environment variable, or defaults to 4000.
  */
-if (isMainModule(import.meta.url)) {
+if (isMainModule(import.meta.url) || process.env['pm_id']) {
   const port = process.env['PORT'] || 4000;
   app.listen(port, (error) => {
     if (error) {

package/utility/latest-versions/package.json

@@ -8,7 +8,7 @@
     "@types/node": "^20.17.19",
     "browser-sync": "^3.0.0",
     "express": "^5.1.0",
-    "jasmine-core": "~5.10.0",
+    "jasmine-core": "~5.11.0",
     "jasmine-spec-reporter": "~7.0.0",
     "karma-chrome-launcher": "~3.2.0",
     "karma-coverage": "~2.2.0",

package/utility/latest-versions.js

@@ -16,7 +16,7 @@ exports.latestVersions = {
     // As Angular CLI works with same minor versions of Angular Framework, a tilde match for the current
     Angular: '^21.0.0-next.0',
     NgPackagr: '^21.0.0-next.0',
-    DevkitBuildAngular: '^21.0.0-next.5',
-    AngularBuild: '^21.0.0-next.5',
-    AngularSSR: '^21.0.0-next.5',
+    DevkitBuildAngular: '^21.0.0-next.6',
+    AngularBuild: '^21.0.0-next.6',
+    AngularSSR: '^21.0.0-next.6',
 };

package/utility/project-targets.d.ts

@@ -9,3 +9,4 @@ import { SchematicsException } from '@angular-devkit/schematics';
 import { ProjectDefinition } from './workspace';
 export declare function targetBuildNotFoundError(): SchematicsException;
 export declare function isUsingApplicationBuilder(project: ProjectDefinition): boolean;
+export declare function isZonelessApp(project: ProjectDefinition): boolean;

package/utility/project-targets.js

@@ -9,6 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.targetBuildNotFoundError = targetBuildNotFoundError;
 exports.isUsingApplicationBuilder = isUsingApplicationBuilder;
+exports.isZonelessApp = isZonelessApp;
 const schematics_1 = require("@angular-devkit/schematics");
 const workspace_models_1 = require("./workspace-models");
 function targetBuildNotFoundError() {
@@ -19,3 +20,12 @@ function isUsingApplicationBuilder(project) {
     const isUsingApplicationBuilder = buildBuilder === workspace_models_1.Builders.Application || buildBuilder === workspace_models_1.Builders.BuildApplication;
     return isUsingApplicationBuilder;
 }
+function isZonelessApp(project) {
+    const buildTarget = project.targets.get('build');
+    if (!buildTarget?.options?.polyfills) {
+        return true;
+    }
+    const polyfills = buildTarget.options.polyfills;
+    const polyfillsList = Array.isArray(polyfills) ? polyfills : [polyfills];
+    return !polyfillsList.includes('zone.js');
+}