@schematics/angular 22.0.1 → 22.1.0-next.0

package/ai-config/file_utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { Rule } from '@angular-devkit/schematics';
+import { FileConfigurationHandlerOptions } from './types';
+/**
+ * Create or update a JSON MCP configuration file to include the Angular MCP server.
+ */
+export declare function addJsonMcpConfig({ tree, fileInfo }: FileConfigurationHandlerOptions, mcpServersProperty: string): Rule;
+/**
+ * Create or update a TOML MCP configuration file to include the Angular MCP server.
+ */
+export declare function addTomlMcpConfig({ tree, context, fileInfo, tool, }: FileConfigurationHandlerOptions): Rule;
+/**
+ * Create an Angular best practices Markdown.
+ * If the file exists, the configuration is skipped.
+ */
+export declare function addBestPracticesMarkdown({ tree, context, fileInfo, tool, }: FileConfigurationHandlerOptions): Rule;

package/ai-config/file_utils.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addJsonMcpConfig = addJsonMcpConfig;
+exports.addTomlMcpConfig = addTomlMcpConfig;
+exports.addBestPracticesMarkdown = addBestPracticesMarkdown;
+const schematics_1 = require("@angular-devkit/schematics");
+const jsonc_parser_1 = require("jsonc-parser");
+const json_file_1 = require("../utility/json-file");
+const TOML_MCP_SERVERS_PROP = '[mcp_servers.angular-cli]';
+/**
+ * Create or update a JSON MCP configuration file to include the Angular MCP server.
+ */
+function addJsonMcpConfig({ tree, fileInfo }, mcpServersProperty) {
+    const { name, directory } = fileInfo;
+    return (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)('./files'), [
+        (0, schematics_1.filter)((path) => path.includes('__jsonConfigName__')),
+        (0, schematics_1.applyTemplates)({
+            ...schematics_1.strings,
+            jsonConfigName: name,
+            mcpServersProperty,
+        }),
+        (0, schematics_1.move)(directory),
+        (0, schematics_1.forEach)((file) => {
+            if (!tree.exists(file.path)) {
+                return file;
+            }
+            // If we have an existing file, update the server property with
+            // Angular MCP server configuration.
+            const existingConfig = new json_file_1.JSONFile(tree, file.path);
+            const existingMcpServers = existingConfig.get([mcpServersProperty]) ?? {};
+            const templateServersProp = (0, jsonc_parser_1.parse)(file.content.toString())[mcpServersProperty];
+            existingConfig.modify([mcpServersProperty], {
+                ...existingMcpServers,
+                ...templateServersProp,
+            });
+            return null;
+        }),
+    ]));
+}
+/**
+ * Create or update a TOML MCP configuration file to include the Angular MCP server.
+ */
+function addTomlMcpConfig({ tree, context, fileInfo, tool, }) {
+    const { name, directory } = fileInfo;
+    return (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)('./files'), [
+        (0, schematics_1.filter)((path) => path.includes('__tomlConfigName__')),
+        (0, schematics_1.applyTemplates)({
+            ...schematics_1.strings,
+            tomlConfigName: name,
+        }),
+        (0, schematics_1.move)(directory),
+        (0, schematics_1.forEach)((file) => {
+            if (!tree.exists(file.path)) {
+                return file;
+            }
+            const existingFileBuffer = tree.read(file.path);
+            if (existingFileBuffer) {
+                let existing = existingFileBuffer.toString();
+                if (existing.includes(TOML_MCP_SERVERS_PROP)) {
+                    const path = `${directory}/${name}`;
+                    const toolName = schematics_1.strings.classify(tool);
+                    context.logger.warn(`Skipping Angular MCP server configuration for '${toolName}'.\n` +
+                        `Configuration already exists in '${path}'.\n`);
+                    return null;
+                }
+                // Add the configuration at the end of the file.
+                const template = file.content.toString();
+                existing = existing.length ? existing + '\n\n' + template : template;
+                tree.overwrite(file.path, existing);
+                return null;
+            }
+            return file;
+        }),
+    ]));
+}
+/**
+ * Create an Angular best practices Markdown.
+ * If the file exists, the configuration is skipped.
+ */
+function addBestPracticesMarkdown({ tree, context, fileInfo, tool, }) {
+    const { name, directory } = fileInfo;
+    const path = `${directory}/${name}`;
+    if (tree.exists(path)) {
+        const toolName = schematics_1.strings.classify(tool);
+        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.\n');
+        return (0, schematics_1.noop)();
+    }
+    return (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)('./files'), [
+        (0, schematics_1.filter)((path) => path.includes('__bestPracticesName__')),
+        (0, schematics_1.applyTemplates)({
+            ...schematics_1.strings,
+            bestPracticesName: name,
+        }),
+        (0, schematics_1.move)(directory),
+    ]));
+}
+//# sourceMappingURL=file_utils.js.map

package/ai-config/file_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_utils.js","sourceRoot":"","sources":["file_utils.ts"],"names":[],"mappings":"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"}

package/ai-config/files/{__rulesName__.template → __bestPracticesName__.template}

@@ -1,5 +1,3 @@
-<% if (frontmatter) { %><%= frontmatter %>
-<% } %>
 You are an expert in TypeScript, Angular, and scalable web application development. You write functional, maintainable, performant, and accessible code following Angular and TypeScript best practices.
 
 ## TypeScript Best Practices
@@ -12,6 +10,7 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 
 - Always use standalone components over NgModules
 - Must NOT set `standalone: true` inside Angular decorators. It's the default in Angular v20+.
+- Do NOT set `changeDetection: ChangeDetectionStrategy.OnPush` explicitly. `OnPush` is the default in Angular v22+.
 - Use signals for state management
 - Implement lazy loading for feature routes
 - Do NOT use the `@HostBinding` and `@HostListener` decorators. Put host bindings inside the `host` object of the `@Component` or `@Directive` decorator instead
@@ -27,9 +26,12 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 
 - Keep components small and focused on a single responsibility
 - Use `input()` and `output()` functions instead of decorators
+- Use `model()` for two-way bound properties with `[(prop)]` syntax instead of pairing `input()` with `output()`
 - Use `computed()` for derived state
+- Use `linkedSignal()` for state derived from multiple reactive sources that must stay synchronized
 - Prefer inline templates for small components
-- Prefer Reactive forms instead of Template-driven ones
+- Prefer Signal Forms (`@angular/forms/signals`) for new forms. They are stable in Angular v22+ and provide signal-based state, type-safe field access, and schema-based validation
+- When not using Signal Forms, prefer Reactive forms instead of Template-driven ones
 - Do NOT use `ngClass`, use `class` bindings instead
 - Do NOT use `ngStyle`, use `style` bindings instead
 - When using external templates/styles, use paths relative to the component TS file.
@@ -52,4 +54,5 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 
 - Design services around a single responsibility
 - Use the `providedIn: 'root'` option for singleton services
+- Prefer the `@Service` decorator over `@Injectable({providedIn: 'root'})` for new singleton services (Angular v22+)
 - Use the `inject()` function instead of constructor injection

package/ai-config/files/__jsonConfigName__.template

@@ -0,0 +1,8 @@
+{
+  "<%= mcpServersProperty %>": {
+    "angular-cli": {
+      "command": "npx",
+      "args": ["-y", "@angular/cli", "mcp"]
+    }
+  }
+}

package/ai-config/files/__tomlConfigName__.template

@@ -0,0 +1,3 @@
+[mcp_servers.angular-cli]
+command = "npx"
+args = ["-y", "@angular/cli", "mcp"]

package/ai-config/index.js

@@ -9,38 +9,59 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
 const schematics_1 = require("@angular-devkit/schematics");
+const file_utils_1 = require("./file_utils");
 const schema_1 = require("./schema");
+const types_1 = require("./types");
+const AGENTS_MD_CFG = {
+    type: types_1.ContextFileType.BestPracticesMd,
+    name: 'AGENTS.md',
+    directory: '.',
+};
 const AI_TOOLS = {
-    agents: {
-        rulesName: 'AGENTS.md',
-        directory: '.',
-    },
-    gemini: {
-        rulesName: 'GEMINI.md',
-        directory: '.gemini',
-    },
-    claude: {
-        rulesName: 'CLAUDE.md',
-        directory: '.claude',
-    },
-    copilot: {
-        rulesName: 'copilot-instructions.md',
-        directory: '.github',
-    },
-    windsurf: {
-        rulesName: 'guidelines.md',
-        directory: '.windsurf/rules',
-    },
-    jetbrains: {
-        rulesName: 'guidelines.md',
-        directory: '.junie',
-    },
-    // Cursor file has a front matter section.
-    cursor: {
-        rulesName: 'cursor.mdc',
-        directory: '.cursor/rules',
-        frontmatter: `---\ncontext: true\npriority: high\nscope: project\n---`,
-    },
+    ['claude-code']: [
+        AGENTS_MD_CFG,
+        {
+            type: types_1.ContextFileType.McpConfig,
+            name: '.mcp.json',
+            directory: '.',
+        },
+    ],
+    cursor: [
+        AGENTS_MD_CFG,
+        {
+            type: types_1.ContextFileType.McpConfig,
+            name: 'mcp.json',
+            directory: '.cursor',
+        },
+    ],
+    ['gemini-cli']: [
+        {
+            type: types_1.ContextFileType.BestPracticesMd,
+            name: 'GEMINI.md',
+            directory: '.gemini',
+        },
+        {
+            type: types_1.ContextFileType.McpConfig,
+            name: 'settings.json',
+            directory: '.gemini',
+        },
+    ],
+    ['open-ai-codex']: [
+        AGENTS_MD_CFG,
+        {
+            type: types_1.ContextFileType.McpConfig,
+            name: 'config.toml',
+            directory: '.codex',
+        },
+    ],
+    vscode: [
+        AGENTS_MD_CFG,
+        {
+            type: types_1.ContextFileType.McpConfig,
+            name: 'mcp.json',
+            directory: '.vscode',
+        },
+    ],
 };
 function default_1({ tool }) {
     return (tree, context) => {
@@ -49,26 +70,31 @@ function default_1({ tool }) {
         }
         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)();
+            .flatMap((selectedTool) => AI_TOOLS[selectedTool].map((fileInfo) => {
+            const fileCfgOpts = {
+                tree,
+                context,
+                fileInfo,
+                tool: selectedTool,
+            };
+            switch (fileInfo.type) {
+                case types_1.ContextFileType.BestPracticesMd:
+                    return (0, file_utils_1.addBestPracticesMarkdown)(fileCfgOpts);
+                case types_1.ContextFileType.McpConfig:
+                    switch (selectedTool) {
+                        case schema_1.Tool.ClaudeCode:
+                        case schema_1.Tool.Cursor:
+                        case schema_1.Tool.GeminiCli:
+                            return (0, file_utils_1.addJsonMcpConfig)(fileCfgOpts, 'mcpServers');
+                        case schema_1.Tool.OpenAiCodex:
+                            return (0, file_utils_1.addTomlMcpConfig)(fileCfgOpts);
+                        case schema_1.Tool.Vscode:
+                            return (0, file_utils_1.addJsonMcpConfig)(fileCfgOpts, 'servers');
+                        default:
+                            throw new Error(`Unsupported '${schematics_1.strings.classify(selectedTool)}' MCP server configuraiton.`);
+                    }
             }
-            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/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAsDH,4BAsCC;AA1FD,2DAUoC;AACpC,qCAAyD;AAEzD,MAAM,QAAQ,GAA2D;IACvE,MAAM,EAAE;QACN,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,GAAG;KACf;IACD,MAAM,EAAE;QACN,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,SAAS;KACrB;IACD,MAAM,EAAE;QACN,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,SAAS;KACrB;IACD,OAAO,EAAE;QACP,SAAS,EAAE,yBAAyB;QACpC,SAAS,EAAE,SAAS;KACrB;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,eAAe;QAC1B,SAAS,EAAE,iBAAiB;KAC7B;IACD,SAAS,EAAE;QACT,SAAS,EAAE,eAAe;QAC1B,SAAS,EAAE,QAAQ;KACpB;IACD,0CAA0C;IAC1C,MAAM,EAAE;QACN,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,yDAAyD;KACvE;CACF,CAAC;AAQF,mBAAyB,EAAE,IAAI,EAAiB;IAC9C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACvB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAA,iBAAI,GAAE,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI;aACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAI,CAAC,IAAI,CAAC;aACpC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;YACpB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;YACrE,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;YAEzC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,MAAM,QAAQ,GAAG,oBAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAChD,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,oCAAoC,QAAQ,SAAS,IAAI,gCAAgC;oBACvF,gEAAgE;oBAChE,2HAA2H;oBAC3H,sFAAsF,CACzF,CAAC;gBAEF,OAAO,IAAA,iBAAI,GAAE,CAAC;YAChB,CAAC;YAED,OAAO,IAAA,sBAAS,EACd,IAAA,kBAAK,EAAC,IAAA,gBAAG,EAAC,SAAS,CAAC,EAAE;gBACpB,IAAA,2BAAc,EAAC;oBACb,GAAG,oBAAO;oBACV,SAAS;oBACT,WAAW;iBACZ,CAAC;gBACF,IAAA,iBAAI,EAAC,SAAS,CAAC;aAChB,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEL,OAAO,IAAA,kBAAK,EAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA4DH,4BAyCC;AAnGD,2DAAwE;AACxE,6CAA4F;AAC5F,qCAAyD;AACzD,mCAA4F;AAE5F,MAAM,aAAa,GAAoB;IACrC,IAAI,EAAE,uBAAe,CAAC,eAAe;IACrC,IAAI,EAAE,WAAW;IACjB,SAAS,EAAE,GAAG;CACf,CAAC;AAEF,MAAM,QAAQ,GAA6D;IACzE,CAAC,aAAa,CAAC,EAAE;QACf,aAAa;QACb;YACE,IAAI,EAAE,uBAAe,CAAC,SAAS;YAC/B,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,GAAG;SACf;KACF;IACD,MAAM,EAAE;QACN,aAAa;QACb;YACE,IAAI,EAAE,uBAAe,CAAC,SAAS;YAC/B,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,SAAS;SACrB;KACF;IACD,CAAC,YAAY,CAAC,EAAE;QACd;YACE,IAAI,EAAE,uBAAe,CAAC,eAAe;YACrC,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,SAAS;SACrB;QACD;YACE,IAAI,EAAE,uBAAe,CAAC,SAAS;YAC/B,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,SAAS;SACrB;KACF;IACD,CAAC,eAAe,CAAC,EAAE;QACjB,aAAa;QACb;YACE,IAAI,EAAE,uBAAe,CAAC,SAAS;YAC/B,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,QAAQ;SACpB;KACF;IACD,MAAM,EAAE;QACN,aAAa;QACb;YACE,IAAI,EAAE,uBAAe,CAAC,SAAS;YAC/B,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,SAAS;SACrB;KACF;CACF,CAAC;AAEF,mBAAyB,EAAE,IAAI,EAAiB;IAC9C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACvB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAA,iBAAI,GAAE,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI;aACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAI,CAAC,IAAI,CAAC;aACpC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CACxB,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YACtC,MAAM,WAAW,GAAoC;gBACnD,IAAI;gBACJ,OAAO;gBACP,QAAQ;gBACR,IAAI,EAAE,YAAY;aACnB,CAAC;YAEF,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtB,KAAK,uBAAe,CAAC,eAAe;oBAClC,OAAO,IAAA,qCAAwB,EAAC,WAAW,CAAC,CAAC;gBAC/C,KAAK,uBAAe,CAAC,SAAS;oBAC5B,QAAQ,YAAY,EAAE,CAAC;wBACrB,KAAK,aAAI,CAAC,UAAU,CAAC;wBACrB,KAAK,aAAI,CAAC,MAAM,CAAC;wBACjB,KAAK,aAAI,CAAC,SAAS;4BACjB,OAAO,IAAA,6BAAgB,EAAC,WAAW,EAAE,YAAY,CAAC,CAAC;wBACrD,KAAK,aAAI,CAAC,WAAW;4BACnB,OAAO,IAAA,6BAAgB,EAAC,WAAW,CAAC,CAAC;wBACvC,KAAK,aAAI,CAAC,MAAM;4BACd,OAAO,IAAA,6BAAgB,EAAC,WAAW,EAAE,SAAS,CAAC,CAAC;wBAClD;4BACE,MAAM,IAAI,KAAK,CACb,gBAAgB,oBAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,6BAA6B,CAC5E,CAAC;oBACN,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEJ,OAAO,IAAA,kBAAK,EAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}

package/ai-config/schema.d.ts

@@ -1,22 +1,20 @@
 /**
- * Generates AI configuration files for Angular projects. This schematic creates
- * configuration files that help AI tools follow Angular best practices, improving the
- * quality of AI-generated code and suggestions.
+ * Generates AI configuration files for Angular projects. This schematic creates AGENTS.md
+ * file and Angular MCP server configuration, improving the quality of AI-generated code and
+ * suggestions.
  */
 export type Schema = {
     /**
-     * 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.
+     * Specifies which AI tools to generate configuration files (AGENTS.md, MCP server config)
+     * for.
      */
     tool?: Tool[];
 };
 export declare enum Tool {
-    Agents = "agents",
-    Claude = "claude",
-    Copilot = "copilot",
+    ClaudeCode = "claude-code",
     Cursor = "cursor",
-    Gemini = "gemini",
-    Jetbrains = "jetbrains",
+    GeminiCli = "gemini-cli",
     None = "none",
-    Windsurf = "windsurf"
+    OpenAiCodex = "open-ai-codex",
+    Vscode = "vscode"
 }

package/ai-config/schema.js

@@ -5,13 +5,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tool = void 0;
 var Tool;
 (function (Tool) {
-    Tool["Agents"] = "agents";
-    Tool["Claude"] = "claude";
-    Tool["Copilot"] = "copilot";
+    Tool["ClaudeCode"] = "claude-code";
     Tool["Cursor"] = "cursor";
-    Tool["Gemini"] = "gemini";
-    Tool["Jetbrains"] = "jetbrains";
+    Tool["GeminiCli"] = "gemini-cli";
     Tool["None"] = "none";
-    Tool["Windsurf"] = "windsurf";
+    Tool["OpenAiCodex"] = "open-ai-codex";
+    Tool["Vscode"] = "vscode";
 })(Tool || (exports.Tool = Tool = {}));
 //# sourceMappingURL=schema.js.map

package/ai-config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":";AACA,mFAAmF;AACnF,oFAAoF;;;AAepF,IAAY,IASX;AATD,WAAY,IAAI;IACZ,yBAAiB,CAAA;IACjB,yBAAiB,CAAA;IACjB,2BAAmB,CAAA;IACnB,yBAAiB,CAAA;IACjB,yBAAiB,CAAA;IACjB,+BAAuB,CAAA;IACvB,qBAAa,CAAA;IACb,6BAAqB,CAAA;AACzB,CAAC,EATW,IAAI,oBAAJ,IAAI,QASf"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":";AACA,mFAAmF;AACnF,oFAAoF;;;AAepF,IAAY,IAOX;AAPD,WAAY,IAAI;IACZ,kCAA0B,CAAA;IAC1B,yBAAiB,CAAA;IACjB,gCAAwB,CAAA;IACxB,qBAAa,CAAA;IACb,qCAA6B,CAAA;IAC7B,yBAAiB,CAAA;AACrB,CAAC,EAPW,IAAI,oBAAJ,IAAI,QAOf"}

package/ai-config/schema.json

@@ -4,14 +4,14 @@
   "title": "Angular AI Config File Options Schema",
   "type": "object",
   "additionalProperties": false,
-  "description": "Generates AI configuration files for Angular projects. This schematic creates configuration files that help AI tools follow Angular best practices, improving the quality of AI-generated code and suggestions.",
+  "description": "Generates AI configuration files for Angular projects. This schematic creates AGENTS.md file and Angular MCP server configuration, improving the quality of AI-generated code and suggestions.",
   "properties": {
     "tool": {
       "type": "array",
       "uniqueItems": true,
       "default": ["none"],
       "x-prompt": {
-        "message": "Which AI tools do you want to configure with Angular best practices? https://angular.dev/ai/develop-with-ai",
+        "message": "Which AI tools should Angular integrate with? https://angular.dev/ai/develop-with-ai",
         "type": "list",
         "items": [
           {
@@ -19,39 +19,31 @@
             "label": "None"
           },
           {
-            "value": "agents",
-            "label": "Agents.md      [ https://agents.md/                                               ]"
-          },
-          {
-            "value": "claude",
-            "label": "Claude         [ https://docs.anthropic.com/en/docs/claude-code/memory            ]"
+            "value": "claude-code",
+            "label": "Claude Code   [ `AGENTS.md` + Angular MCP server config ]"
           },
           {
             "value": "cursor",
-            "label": "Cursor         [ https://docs.cursor.com/en/context/rules                         ]"
-          },
-          {
-            "value": "gemini",
-            "label": "Gemini         [ https://ai.google.dev/gemini-api/docs                            ]"
+            "label": "Cursor        [ `AGENTS.md` + Angular MCP server config ]"
           },
           {
-            "value": "copilot",
-            "label": "GitHub Copilot [ https://code.visualstudio.com/docs/copilot/copilot-customization ]"
+            "value": "gemini-cli",
+            "label": "Gemini CLI    [ `GEMINI.md` + Angular MCP server config ]"
           },
           {
-            "value": "jetbrains",
-            "label": "JetBrains AI   [ https://www.jetbrains.com/help/junie/customize-guidelines.html   ]"
+            "value": "open-ai-codex",
+            "label": "Open AI Codex [ `AGENTS.md` + Angular MCP server config ]"
           },
           {
-            "value": "windsurf",
-            "label": "Windsurf       [ https://docs.windsurf.com/windsurf/cascade/memories#rules        ]"
+            "value": "vscode",
+            "label": "VSCode        [ `AGENTS.md` + Angular MCP server config ]"
           }
         ]
       },
-      "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.",
+      "description": "Specifies which AI tools to generate configuration files (AGENTS.md, MCP server config) for.",
       "items": {
         "type": "string",
-        "enum": ["none", "gemini", "copilot", "claude", "cursor", "jetbrains", "windsurf", "agents"]
+        "enum": ["none", "claude-code", "cursor", "gemini-cli", "open-ai-codex", "vscode"]
       }
     }
   }

package/ai-config/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { SchematicContext, Tree } from '@angular-devkit/schematics';
+import { Tool } from './schema';
+/**
+ * Types of supported AI configuration files.
+ */
+export declare enum ContextFileType {
+    /** Represents a Markdown AI instructions file (e.g. AGENTS.md). */
+    BestPracticesMd = 0,
+    /** Represents an MCP server configuration (e.g. Angular MCP).  */
+    McpConfig = 1
+}
+/**
+ * AI configuration file metadata.
+ */
+export interface ContextFileInfo {
+    type: ContextFileType;
+    name: string;
+    directory: string;
+}
+/**
+ * Represents the file configuration handler options
+ * that are normally passed to the handler functions.
+ */
+export type FileConfigurationHandlerOptions = {
+    tree: Tree;
+    context: SchematicContext;
+    fileInfo: ContextFileInfo;
+    tool: Tool;
+};

package/ai-config/types.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextFileType = void 0;
+/**
+ * Types of supported AI configuration files.
+ */
+var ContextFileType;
+(function (ContextFileType) {
+    /** Represents a Markdown AI instructions file (e.g. AGENTS.md). */
+    ContextFileType[ContextFileType["BestPracticesMd"] = 0] = "BestPracticesMd";
+    /** Represents an MCP server configuration (e.g. Angular MCP).  */
+    ContextFileType[ContextFileType["McpConfig"] = 1] = "McpConfig";
+})(ContextFileType || (exports.ContextFileType = ContextFileType = {}));
+//# sourceMappingURL=types.js.map

package/ai-config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAKH;;GAEG;AACH,IAAY,eAMX;AAND,WAAY,eAAe;IACzB,mEAAmE;IACnE,2EAAmB,CAAA;IAEnB,kEAAkE;IAClE,+DAAa,CAAA;AACf,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B"}

package/config/index.js

@@ -69,7 +69,7 @@ async function addBrowserslistConfig(projectRoot) {
     return (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)('./files'), [
         (0, schematics_1.filter)((p) => p.endsWith('.browserslistrc.template')),
         // The below is replaced by bazel `npm_package`.
-        (0, schematics_1.applyTemplates)({ baselineDate: '2025-10-20' }),
+        (0, schematics_1.applyTemplates)({ baselineDate: '2026-05-07' }),
         (0, schematics_1.move)(projectRoot),
     ]));
 }

package/ng-new/schema.d.ts

@@ -126,14 +126,12 @@ export type Schema = {
     zoneless?: boolean;
 };
 export declare enum AiConfig {
-    Agents = "agents",
-    Claude = "claude",
-    Copilot = "copilot",
+    ClaudeCode = "claude-code",
     Cursor = "cursor",
-    Gemini = "gemini",
-    Jetbrains = "jetbrains",
+    GeminiCli = "gemini-cli",
     None = "none",
-    Windsurf = "windsurf"
+    OpenAiCodex = "open-ai-codex",
+    Vscode = "vscode"
 }
 /**
  * Configure the initial Git commit for the new repository.

package/ng-new/schema.js

@@ -5,14 +5,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViewEncapsulation = exports.TestRunner = exports.Style = exports.PackageManager = exports.FileNameStyleGuide = exports.AiConfig = void 0;
 var AiConfig;
 (function (AiConfig) {
-    AiConfig["Agents"] = "agents";
-    AiConfig["Claude"] = "claude";
-    AiConfig["Copilot"] = "copilot";
+    AiConfig["ClaudeCode"] = "claude-code";
     AiConfig["Cursor"] = "cursor";
-    AiConfig["Gemini"] = "gemini";
-    AiConfig["Jetbrains"] = "jetbrains";
+    AiConfig["GeminiCli"] = "gemini-cli";
     AiConfig["None"] = "none";
-    AiConfig["Windsurf"] = "windsurf";
+    AiConfig["OpenAiCodex"] = "open-ai-codex";
+    AiConfig["Vscode"] = "vscode";
 })(AiConfig || (exports.AiConfig = AiConfig = {}));
 /**
  * The file naming convention to use for generated files. The '2025' style guide (default)

package/ng-new/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":";AACA,mFAAmF;AACnF,oFAAoF;;;AAkIpF,IAAY,QASX;AATD,WAAY,QAAQ;IAChB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,yBAAa,CAAA;IACb,iCAAqB,CAAA;AACzB,CAAC,EATW,QAAQ,wBAAR,QAAQ,QASnB;AAcD;;;;;GAKG;AACH,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC1B,sCAAgB,CAAA;IAChB,sCAAgB,CAAA;AACpB,CAAC,EAHW,kBAAkB,kCAAlB,kBAAkB,QAG7B;AAED;;GAEG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACtB,6BAAW,CAAA;IACX,6BAAW,CAAA;IACX,+BAAa,CAAA;IACb,+BAAa,CAAA;AACjB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB;AAED;;GAEG;AACH,IAAY,KAMX;AAND,WAAY,KAAK;IACb,oBAAW,CAAA;IACX,sBAAa,CAAA;IACb,sBAAa,CAAA;IACb,sBAAa,CAAA;IACb,8BAAqB,CAAA;AACzB,CAAC,EANW,KAAK,qBAAL,KAAK,QAMhB;AAED;;GAEG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,6BAAe,CAAA;IACf,+BAAiB,CAAA;AACrB,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAED;;;;;GAKG;AACH,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,kCAAa,CAAA;IACb,4CAAuB,CAAA;AAC3B,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":";AACA,mFAAmF;AACnF,oFAAoF;;;AAkIpF,IAAY,QAOX;AAPD,WAAY,QAAQ;IAChB,sCAA0B,CAAA;IAC1B,6BAAiB,CAAA;IACjB,oCAAwB,CAAA;IACxB,yBAAa,CAAA;IACb,yCAA6B,CAAA;IAC7B,6BAAiB,CAAA;AACrB,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB;AAcD;;;;;GAKG;AACH,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC1B,sCAAgB,CAAA;IAChB,sCAAgB,CAAA;AACpB,CAAC,EAHW,kBAAkB,kCAAlB,kBAAkB,QAG7B;AAED;;GAEG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACtB,6BAAW,CAAA;IACX,6BAAW,CAAA;IACX,+BAAa,CAAA;IACb,+BAAa,CAAA;AACjB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB;AAED;;GAEG;AACH,IAAY,KAMX;AAND,WAAY,KAAK;IACb,oBAAW,CAAA;IACX,sBAAa,CAAA;IACb,sBAAa,CAAA;IACb,sBAAa,CAAA;IACb,8BAAqB,CAAA;AACzB,CAAC,EANW,KAAK,qBAAL,KAAK,QAMhB;AAED;;GAEG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,6BAAe,CAAA;IACf,+BAAiB,CAAA;AACrB,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAED;;;;;GAKG;AACH,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,kCAAa,CAAA;IACb,4CAAuB,CAAA;AAC3B,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B"}

package/ng-new/schema.json

@@ -155,7 +155,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", "agents"]
+        "enum": ["none", "claude-code", "cursor", "gemini-cli", "open-ai-codex", "vscode"]
       }
     },
     "fileNameStyleGuide": {

package/package.json

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

package/utility/latest-versions.js

@@ -14,10 +14,10 @@ const dependencies = require('./latest-versions/package.json')['dependencies'];
 exports.latestVersions = {
     ...dependencies,
     // As Angular CLI works with same minor versions of Angular Framework, a tilde match for the current
-    Angular: '^22.0.0',
-    NgPackagr: '^22.0.0',
-    DevkitBuildAngular: '^22.0.1',
-    AngularBuild: '^22.0.1',
-    AngularSSR: '^22.0.1',
+    Angular: '^22.1.0-next.0',
+    NgPackagr: '^22.1.0-next.0',
+    DevkitBuildAngular: '^22.1.0-next.0',
+    AngularBuild: '^22.1.0-next.0',
+    AngularSSR: '^22.1.0-next.0',
 };
 //# sourceMappingURL=latest-versions.js.map