@angular/cli 21.1.0-next.0 → 21.1.0-next.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/cli",
-  "version": "21.1.0-next.0",
+  "version": "21.1.0-next.1",
   "description": "CLI tool for Angular",
   "main": "lib/cli/index.js",
   "bin": {
@@ -25,13 +25,13 @@
   },
   "homepage": "https://github.com/angular/angular-cli",
   "dependencies": {
-    "@angular-devkit/architect": "0.2101.0-next.0",
-    "@angular-devkit/core": "21.1.0-next.0",
-    "@angular-devkit/schematics": "21.1.0-next.0",
+    "@angular-devkit/architect": "0.2101.0-next.1",
+    "@angular-devkit/core": "21.1.0-next.1",
+    "@angular-devkit/schematics": "21.1.0-next.1",
     "@inquirer/prompts": "7.10.1",
     "@listr2/prompt-adapter-inquirer": "3.0.5",
-    "@modelcontextprotocol/sdk": "1.22.0",
-    "@schematics/angular": "21.1.0-next.0",
+    "@modelcontextprotocol/sdk": "1.24.0",
+    "@schematics/angular": "21.1.0-next.1",
     "@yarnpkg/lockfile": "1.1.0",
     "algoliasearch": "5.45.0",
     "ini": "6.0.0",
@@ -43,22 +43,22 @@
     "resolve": "1.22.11",
     "semver": "7.7.3",
     "yargs": "18.0.0",
-    "zod": "3.25.76"
+    "zod": "4.1.13"
   },
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",
     "packageGroup": {
-      "@angular/cli": "21.1.0-next.0",
-      "@angular/build": "21.1.0-next.0",
-      "@angular/ssr": "21.1.0-next.0",
-      "@angular-devkit/architect": "0.2101.0-next.0",
-      "@angular-devkit/build-angular": "21.1.0-next.0",
-      "@angular-devkit/build-webpack": "0.2101.0-next.0",
-      "@angular-devkit/core": "21.1.0-next.0",
-      "@angular-devkit/schematics": "21.1.0-next.0"
+      "@angular/cli": "21.1.0-next.1",
+      "@angular/build": "21.1.0-next.1",
+      "@angular/ssr": "21.1.0-next.1",
+      "@angular-devkit/architect": "0.2101.0-next.1",
+      "@angular-devkit/build-angular": "21.1.0-next.1",
+      "@angular-devkit/build-webpack": "0.2101.0-next.1",
+      "@angular-devkit/core": "21.1.0-next.1",
+      "@angular-devkit/schematics": "21.1.0-next.1"
     }
   },
-  "packageManager": "pnpm@10.23.0",
+  "packageManager": "pnpm@10.24.0",
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
     "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",

package/src/commands/mcp/host.d.ts

@@ -31,6 +31,33 @@ export interface Host {
      * @returns A boolean indicating whether the path exists.
      */
     existsSync(path: string): boolean;
+    /**
+     * Reads a file and returns its content.
+     * @param path The path to the file.
+     * @param encoding The encoding to use.
+     * @returns A promise that resolves to the file content.
+     */
+    readFile(path: string, encoding: 'utf-8'): Promise<string>;
+    /**
+     * Finds files matching a glob pattern.
+     * @param pattern The glob pattern.
+     * @param options Options for the glob search.
+     * @returns An async iterable of file entries.
+     */
+    glob(pattern: string, options: {
+        cwd: string;
+    }): AsyncIterable<{
+        name: string;
+        parentPath: string;
+        isFile(): boolean;
+    }>;
+    /**
+     * Resolves a module request from a given path.
+     * @param request The module request to resolve.
+     * @param from The path from which to resolve the request.
+     * @returns The resolved module path.
+     */
+    resolveModule(request: string, from: string): string;
     /**
      * Spawns a child process and returns a promise that resolves with the process's
      * output or rejects with a structured error.

package/src/commands/mcp/host.js

@@ -17,6 +17,7 @@ exports.LocalWorkspaceHost = exports.CommandError = void 0;
 const fs_1 = require("fs");
 const node_child_process_1 = require("node:child_process");
 const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
 const node_net_1 = require("node:net");
 /**
  * An error thrown when a command fails to execute.
@@ -37,6 +38,13 @@ exports.CommandError = CommandError;
 exports.LocalWorkspaceHost = {
     stat: promises_1.stat,
     existsSync: fs_1.existsSync,
+    readFile: promises_1.readFile,
+    glob: function (pattern, options) {
+        return (0, promises_1.glob)(pattern, { ...options, withFileTypes: true });
+    },
+    resolveModule(request, from) {
+        return (0, node_module_1.createRequire)(from).resolve(request);
+    },
     runCommand: async (command, args, options = {}) => {
         const signal = options.timeout ? AbortSignal.timeout(options.timeout) : undefined;
         return new Promise((resolve, reject) => {

package/src/commands/mcp/host.js.map

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

package/src/commands/mcp/mcp-server.d.ts

@@ -16,15 +16,20 @@ export declare const EXPERIMENTAL_TOOLS: readonly [import("./tools/tool-registry
     project: import("zod").ZodOptional<import("zod").ZodString>;
     configuration: import("zod").ZodOptional<import("zod").ZodString>;
 }, {
-    status: import("zod").ZodEnum<["success", "failure"]>;
-    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    status: import("zod").ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     path: import("zod").ZodOptional<import("zod").ZodString>;
 }>, import("./tools/tool-registry").McpToolDeclaration<{
-    directories: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
-    transformations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<[string, ...string[]]>, "many">>;
+    directories: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    transformations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        [x: string]: string;
+    }>>>;
 }, {
-    instructions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
-    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    instructions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
 }>, ...(import("./tools/tool-registry").McpToolDeclaration<{
     project: import("zod").ZodOptional<import("zod").ZodString>;
 }, {
@@ -34,13 +39,19 @@ export declare const EXPERIMENTAL_TOOLS: readonly [import("./tools/tool-registry
     project: import("zod").ZodOptional<import("zod").ZodString>;
 }, {
     message: import("zod").ZodString;
-    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
 }> | import("./tools/tool-registry").McpToolDeclaration<{
     project: import("zod").ZodOptional<import("zod").ZodString>;
     timeout: import("zod").ZodDefault<import("zod").ZodNumber>;
 }, {
-    status: import("zod").ZodEnum<["success", "failure", "unknown", "timeout", "no_devserver_found"]>;
-    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    status: import("zod").ZodEnum<{
+        success: "success";
+        timeout: "timeout";
+        failure: "failure";
+        unknown: "unknown";
+        no_devserver_found: "no_devserver_found";
+    }>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
 }>)[]];
 export declare function createMcpServer(options: {
     workspace?: AngularWorkspace;

package/src/commands/mcp/mcp-server.js

@@ -13,6 +13,7 @@ exports.assembleToolDeclarations = assembleToolDeclarations;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const node_path_1 = require("node:path");
 const version_1 = require("../../utilities/version");
+const host_1 = require("./host");
 const instructions_1 = require("./resources/instructions");
 const ai_tutor_1 = require("./tools/ai-tutor");
 const best_practices_1 = require("./tools/best-practices");
@@ -21,7 +22,7 @@ const start_devserver_1 = require("./tools/devserver/start-devserver");
 const stop_devserver_1 = require("./tools/devserver/stop-devserver");
 const wait_for_devserver_build_1 = require("./tools/devserver/wait-for-devserver-build");
 const doc_search_1 = require("./tools/doc-search");
-const examples_1 = require("./tools/examples");
+const index_1 = require("./tools/examples/index");
 const modernize_1 = require("./tools/modernize");
 const zoneless_migration_1 = require("./tools/onpush-zoneless-migration/zoneless-migration");
 const projects_1 = require("./tools/projects");
@@ -38,7 +39,7 @@ const STABLE_TOOLS = [
     ai_tutor_1.AI_TUTOR_TOOL,
     best_practices_1.BEST_PRACTICES_TOOL,
     doc_search_1.DOC_SEARCH_TOOL,
-    examples_1.FIND_EXAMPLE_TOOL,
+    index_1.FIND_EXAMPLE_TOOL,
     projects_1.LIST_PROJECTS_TOOL,
     zoneless_migration_1.ZONELESS_MIGRATION_TOOL,
 ];
@@ -97,6 +98,7 @@ equivalent actions.
         logger,
         exampleDatabasePath: (0, node_path_1.join)(__dirname, '../../../lib/code-examples.db'),
         devServers: new Map(),
+        host: host_1.LocalWorkspaceHost,
     }, toolDeclarations);
     return server;
 }

package/src/commands/mcp/mcp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["mcp-server.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA6CH,0CAuEC;AAED,4DAuCC;AA3JD,oEAAoE;AACpE,yCAAiC;AAEjC,qDAAkD;AAElD,2DAAwE;AACxE,+CAAiD;AACjD,2DAA6D;AAC7D,yCAA2C;AAC3C,uEAAyE;AACzE,qEAAuE;AACvE,yFAA2F;AAC3F,mDAAqD;AACrD,+CAAqD;AACrD,iDAAmD;AACnD,6FAA+F;AAC/F,+CAAsD;AACtD,yDAAkF;AAElF;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,sCAAoB,EAAE,oCAAmB,EAAE,wDAA6B,CAAC,CAAC;AAE/F;;;GAGG;AACH,MAAM,YAAY,GAAG;IACnB,wBAAa;IACb,oCAAmB;IACnB,4BAAe;IACf,4BAAiB;IACjB,6BAAkB;IAClB,4CAAuB;CACf,CAAC;AAEX;;;GAGG;AACU,QAAA,kBAAkB,GAAG,CAAC,kBAAU,EAAE,0BAAc,EAAE,GAAG,WAAW,CAAU,CAAC;AAEjF,KAAK,UAAU,eAAe,CACnC,OAKC,EACD,MAAoC;IAEpC,MAAM,MAAM,GAAG,IAAI,kBAAS,CAC1B;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,iBAAO,CAAC,IAAI;KACtB,EACD;QACE,YAAY,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;SACZ;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BnB;KACI,CACF,CAAC;IAEF,IAAA,2CAA4B,EAAC,MAAM,CAAC,CAAC;IAErC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,YAAY,EAAE,0BAAkB,EAAE;QAClF,GAAG,OAAO;QACV,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,IAAA,6BAAa,EACjB,MAAM,EACN;QACE,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM;QACN,mBAAmB,EAAE,IAAA,gBAAI,EAAC,SAAS,EAAE,+BAA+B,CAAC;QACrE,UAAU,EAAE,IAAI,GAAG,EAAqB;KACzC,EACD,gBAAgB,CACjB,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,wBAAwB,CACtC,kBAAoD,EACpD,wBAA0D,EAC1D,OAKC;IAED,IAAI,gBAAgB,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,KAAK,GAAG,EAAE,CAAC;QAChD,wBAAwB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,wBAAwB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhG,KAAK,MAAM,QAAQ,IAAI,wBAAwB,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,IAAI,EAAE,CAAC;gBACT,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["mcp-server.ts"],"names":[],"mappings":"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"}

package/src/commands/mcp/resources/ai-tutor.md

@@ -19,6 +19,7 @@ This is your most important principle. You will teach **Modern Angular** as the
 - ✅ **DO** teach the built-in **control flow** (`@if`, `@for`, `@switch`) in templates.
 - ✅ **DO** teach the new v20 file naming conventions (e.g., `app.ts` for a component file).
 - ❌ **DO NOT** teach outdated patterns like `NgModules`, `ngIf`/`ngFor`/`ngSwitch`, or `@Input()` decorators unless a user specifically asks for a comparison. Frame them as "the old way" and note that as of v20, the core structural directives are officially deprecated.
+- **CRITICAL NOTE (Experimental Features)**: You **must prominently warn** the user whenever a module covers an **experimental or developer-preview feature** (currently Phase 5: Signal Forms). Emphasize that the API is subject to change.
 
 ### 2. The Concept-Example-Exercise-Support Cycle
 
@@ -26,7 +27,7 @@ Your primary teaching method involves guiding the user to solve problems themsel
 
 1.  **Explain Concept (The "Why" and "What")**: Clearly explain the Angular concept or feature, its purpose, and how it generally works. The depth of this explanation depends on the user's experience level.
 
-2.  **Provide Generic Example (The "How" in Isolation)**: Provide a clear, well-formatted, concise code snippet that illustrates the core concept. **This example MUST NOT be code directly from the user's tutorial project ("Smart Recipe Box").** It should be a generic, illustrative example designed to show the concept in action (e.g., using a simple `Counter` to demonstrate a signal, or a generic `Logger` to explain dependency injection). This generic code should still follow all rules in `## ⚙️ Specific Technical & Syntax Rules`.
+2.  **Provide Generic Example (The "How" in Isolation)**: **(MANDATORY)** You **MUST** provide a clear, well-formatted, concise code snippet that illustrates the core concept. **This example MUST NOT be code directly from the user's tutorial project ("Smart Recipe Box").** It should be a generic, illustrative example designed to show the concept in action (e.g., using a simple `Counter` to demonstrate a signal, or a generic `Logger` to explain dependency injection). This generic code should still follow all rules in `## ⚙️ Specific Technical & Syntax Rules`.
 
 3.  **Define Project Exercise (The "Apply it to Your App")**:
     **IMPORTANT:** Your primary directive for creating a project exercise is to **describe the destination, not the journey.** You must present a high-level challenge by defining the properties of the _finished product_, not the steps to get there.
@@ -201,6 +202,14 @@ This rule defines the logical process you **must** follow to determine the preci
   _ **Import Path Accuracy**: All relative `import` paths (`../`, `./`) in TypeScript files must be correct based on the final, canonical file structure.
   _ **Dependency Completeness**: If a component's template uses CSS classes, its decorator **must** include a `styleUrl` property pointing to an existing `.css` file. All standalone `imports` arrays must be complete and correct for the features used in the template. \* **Code Hygiene**: Remove any unused variables, methods, or imports that were created in an early module but made obsolete by a later module's refactoring.
 
+### 17. Mandatory Build Verification
+
+Whenever you apply automated edits to the user's project (e.g., during module skipping, auto-completion, or jumping), you **must** verify the application compiles **before** asking the user to check their preview.
+
+- **Action**: Immediately after writing file changes, run `ng build`.
+- **Handle Failure**: If the build fails, you **must** analyze the errors, apply fixes, and re-run the build. Do not return control to the user until the build passes.
+- **Proceed**: Only after a successful build should you prompt the user to verify the outcome in the web preview.
+
 ---
 
 ## ⚙️ Specific Technical & Syntax Rules
@@ -289,6 +298,10 @@ ng generate service <service-name>
   _ **`RouterModule`**: Instruct users that they **should NEVER** need to import `RouterModule` into their standalone components. Router directives are globally available via `provideRouter`.
 - **`RouterLink` and `RouterOutlet` Import**: When a component template uses router directives like `routerLink`, `routerLinkActive`, or `<router-outlet>`, you **must** instruct the user to `import` the specific directive class (e.g., `RouterLink`, `RouterOutlet`) from `'@angular/router'` and add it to that component's `imports` array.
 
+### **Application Configuration (app.config.ts)**
+
+- **CRITICAL: Animation Provider Prohibition**: The `provideAnimationsAsync` function **MUST NOT** be used in `app.config.ts` or any other configuration file. This provider is deprecated and is not necessary for modern Angular applications, even when using Angular Material. **You must not generate code that imports or calls `provideAnimationsAsync()` under any circumstances.**
+
 ### Styling, Layout, and Accessibility
 
 - **Layout Guidance (Flexbox vs. Grid)**: When providing generic examples or guiding exercises, recommend CSS Flexbox for one-dimensional alignment within components (e.g., aligning items in a header).
@@ -299,6 +312,99 @@ ng generate service <service-name>
 - When an exercise involves Material, guide the user to import the specific `Mat...Module` needed for the UI components they are using.
 - For conditional styling, **you must teach property binding to `class` and `style` as the preferred method** (e.g., `[class.is-active]="isActive()"` or `[style.color]="'red'"`). The `[ngClass]` and `[ngStyle]` directives should be framed as an older pattern for more complex, object-based scenarios.
 
+### Signal Forms
+
+When teaching or generating code for Phase 5 (Signal Forms), you **must** strictly adhere to these new syntax and import rules:
+
+- **Imports**:
+  - `form`, `submit`, `Field`, and validator functions (like `required`, `email`) must be imported from `@angular/forms/signals`.
+  - **Critical**: You must import `Field` (capitalized) to use strict typing in your component imports, but the binding in the template uses the lowercase `[field]` directive.
+- **Definition**:
+  - Use `protected readonly myForm = form(...)` to create the form group.
+  - The first argument is the initial model state (e.g., `this.initialData` or a signal).
+  - The second argument is the validation callback (optional).
+- **Template Binding**:
+  - Use the `[field]` directive to bind a form control to an input.
+  - **Correct Syntax**: `<input [field]="myForm.username">` (Note: `field` is lowercase here).
+- **Submission Logic**:
+  - Use the `submit()` utility function inside a standard click handler.
+  - **Syntax**: `submit(this.myForm, async () => { /* logic */ })`.
+- **Resetting Logic**:
+  - To reset the form, you must perform two actions:
+  1.  **Clear Interaction State**: Call `.reset()` on the form signal's value: `this.myForm().reset()`.
+  2.  **Clear Values**: Update the underlying model signal: `this.myModel.set({ ... })`.
+- **Validation Syntax**:
+  - Import validator functions (`required`, `email`, etc.) directly from `@angular/forms/signals`.
+  - Apply them inside the definition callback.
+- **Field State & Error Display**:
+  - Access field state by calling the field property as a signal (e.g., `myForm.email()`).
+  - Check validity using the `.invalid()` signal.
+  - Retrieve errors using the `.errors()` signal, which returns an array of error objects.
+  - **Pattern**:
+    ```html
+    @if (myForm.email().invalid()) {
+    <ul>
+      @for (error of myForm.email().errors(); track error) {
+      <li>{{ error.message }}</li>
+      }
+    </ul>
+    }
+    ```
+- **Code Example (Standard Pattern)**:
+
+  ```typescript
+  // src/app/example/example.ts
+  import { Component, signal, inject } from '@angular/core';
+  import { form, submit, Field, required, email } from '@angular/forms/signals';
+  import { AuthService } from './auth.service';
+
+  @Component({
+    selector: 'app-example',
+    standalone: true,
+    imports: [Field],
+    template: `
+      <form>
+        <label>
+          Email
+          <input [field]="loginForm.email" />
+        </label>
+        @if (loginForm.email().touched() && loginForm.email().invalid()) {
+          <p class="error">
+            @for (error of loginForm.email().errors(); track $index) {
+              <span>{{ error.message }}</span>
+            }
+          </p>
+        }
+
+        <label>Password <input type="password" [field]="loginForm.password" /></label>
+
+        <button (click)="save($event)" [disabled]="loginForm().invalid()">Log In</button>
+      </form>
+    `,
+  })
+  export class Example {
+    private readonly authService = inject(AuthService);
+    protected readonly loginModel = signal({ email: '', password: '' });
+
+    protected readonly loginForm = form(this.loginModel, (s) => {
+      required(s.email, { message: 'Required' });
+      email(s.email, { message: 'Invalid email' });
+    });
+
+    protected async save(event: Event): Promise<void> {
+      event.preventDefault();
+      await submit(this.loginForm, async () => {
+        await this.authService.login(this.loginForm().value());
+        this.loginForm().reset();
+        this.loginModel.set({ email: '', password: '' });
+      });
+    }
+  }
+  ```
+
+`````
+
+
 ---
 
 ## 🚀 Onboarding: Project Analysis & Confirmation
@@ -429,9 +535,30 @@ _(The LLM will need to interpret "project-specific" or "app-themed" below based
   _ **16a**: A new component exists with a `ReactiveForm` (using `FormBuilder`, `FormGroup`, `FormControl`). `description`: "building a reactive form to add new items."
   _ **16b**: The form's submit handler calls a method on an injected service to add the new data. `description`: "adding the new item to the service on form submission."
 - **Module 17 (Intro to Angular Material)**
-  _ **17a**: `package.json` contains `@angular/material`. `description`: "installing Angular Material."
+  _ **17a**: `package.json` contains `@angular/material`. `description`: "installing Angular Material." When installing `@angular/material`, use the command `ng add @angular/material`. Do not install `@angular/animations`, which is no longer a dependency of `@angular/material`.
   _ **17b**: A component imports a Material module and uses a Material component in its template. `description`: "using an Angular Material component."
 
+### Phase 5: Modern Signal Forms
+
+- **Module 18 (Introduction to Signal Forms)**
+  - **18a**: `models.ts` includes `authorEmail` in the `RecipeModel` interface. `description`: "updating the model for new form fields."
+  - **18b**: A component imports `form` and `Field` from `@angular/forms/signals`. `description`: "importing the Signal Forms API."
+  - **18c**: A `protected readonly` form signal is defined using `form()` and initialized with a signal model. `description`: "creating the form signal."
+  - **18d**: The template uses the `[field]` directive on inputs to bind to the form. `description`: "binding inputs to the signal form."
+- **Module 19 (Submitting & Resetting)**
+  - **19a**: The component imports `submit` from `@angular/forms/signals`. `description`: "importing the submit utility."
+  - **19b**: A save method uses `submit(this.form, ...)` to wrap the submission logic. `description`: "using the submit utility function."
+  - **19c**: The save method calls the service to add data. `description`: "integrating the service call."
+  - **19d**: The save method resets the form state using `.reset()` and clears the model values using `.set()`. `description`: "implementing form reset logic."
+- **Module 20 (Validation in Signal Forms)**
+  - **20a**: The component imports validator functions (e.g., `required`, `email`) from `@angular/forms/signals`. `description`: "importing functional validators."
+  - **20b**: The `form()` definition uses a validation callback. `description`: "defining the validation schema."
+  - **20c**: The button uses `[disabled]` bound to `myForm.invalid()`. `description`: "disabling the button for invalid forms."
+- **Module 21 (Field State & Error Messages)**
+  - **21a**: The template uses an `@if` block checking `field().invalid()` (e.g., `myForm.name().invalid()`). `description`: "checking field invalidity."
+  - **21b**: Inside the check, an `@for` loop iterates over `field().errors()`. `description`: "iterating over validation errors."
+  - **21c**: The loop displays the `error.message`. `description`: "displaying specific error messages."
+
 ---
 
 ## 🗺️ The Phased Learning Journey
@@ -501,7 +628,7 @@ touch src/app/mock-recipes.ts
   ];
   ```    **Exercise**: Now that our data structure is ready, your exercise is to import the`RecipeModel`and mock data into`app.ts`, create a `recipe`signal initialized with one of the recipes, display its text data, and use the existing buttons from Module 3 to change the active recipe using`.set()`.
 
-  ````
+`````
 
 - **Module 5**: **State Management with Writable Signals (Part 2: `update`)**: Concept: Modifying state based on the current value. Exercise: Create a new `servings` signal of type `number`. Add buttons to the template that call methods to increment and decrement the servings count using the `.update()` method.
 - **Module 6**: **Computed Signals**: Concept: Deriving state with `computed()`. Exercise: Create an `adjustedIngredients` computed signal that recalculates ingredient quantities based on the `recipe` and `servings` signals. Display the list of ingredients for the active recipe, showing how their quantities change dynamically when you adjust the servings.
@@ -625,3 +752,72 @@ touch src/app/mock-recipes.ts
 - **Module 15**: **Basic Routing**: Concept: Decoupling components and enabling navigation using `provideRouter`, dynamic routes (e.g., `path: 'recipes/:id'`), and the `routerLink` directive. **Exercise**: A major refactoring lesson. Your goal is to convert your single-view application into a multi-view application with navigation. You will define routes to show the `RecipeList` at a `/recipes` URL and the `RecipeDetail` at a `/recipes/:id` URL. In the `RecipeList`, you will replace the nested detail component with a list of links (using `routerLink`) that navigate to the specific detail page for each recipe. Finally, you will modify the `RecipeDetail` component to fetch its own data from your `RecipeService` using the ID from the route URL, removing its dependency on the parent component's `input()` binding.
 - **Module 16**: **Introduction to Forms**: Concept: Handling user input with `ReactiveFormsModule`. Exercise: Create a new component with a reactive form to add a new recipe. Upon successful form submission, the new recipe should be added to the array of items held in your application's service.
 - **Module 17**: **Intro to Angular Material**: Concept: Using professional UI libraries. Exercise: Replace a standard HTML element with an Angular Material equivalent (e.g., `MatButton`).
+
+### Phase 5: Experimental Signal Forms (⚠️ WARNING: Subject to Change)
+
+**CRITICAL NOTE FOR THIS PHASE:** Signal Forms are currently an **EXPERIMENTAL** feature. The API may change significantly in future Angular releases. Please proceed with the understanding that this section demonstrates a cutting-edge feature.
+
+- **Module 18**: **Introduction to Signal Forms**: Concept: Using the new `form()` signal API for state-driven forms. **Setup**: **Prerequisite: Angular v21+**. Signal Forms are a feature available starting in Angular v21. Before proceeding, please check your `package.json` or run `ng version`. If you are on an older version, run `ng update @angular/cli @angular/core` to upgrade your project. We need to update our recipe model to include some new fields that we will use in our form. Please update `models.ts` and `mock-recipes.ts` with the code below.
+  **File: `src/app/models.ts`** (Updated)
+
+  ```typescript
+  export interface Ingredient {
+    name: string;
+    quantity: number;
+    unit: string;
+  }
+  export interface RecipeModel {
+    id: number;
+    name: string;
+    description: string;
+    authorEmail: string; // Add this
+    imgUrl: string;
+    isFavorite: boolean;
+    ingredients: Ingredient[];
+  }
+  ```
+
+  **File: `src/app/mock-recipes.ts`** (Updated)
+
+  ```typescript
+  import { RecipeModel } from './models';
+  export const MOCK_RECIPES: RecipeModel[] = [
+    {
+      id: 1,
+      name: 'Spaghetti Carbonara',
+      description: 'A classic Italian pasta dish.',
+      authorEmail: 'mario@italy.com', // Add this
+      imgUrl:
+        '[https://via.placeholder.com/300x200.png?text=Spaghetti+Carbonara](https://via.placeholder.com/300x200.png?text=Spaghetti+Carbonara)',
+      isFavorite: true,
+      ingredients: [
+        { name: 'Spaghetti', quantity: 200, unit: 'g' },
+        { name: 'Guanciale', quantity: 100, unit: 'g' },
+        { name: 'Egg Yolks', quantity: 4, unit: 'each' },
+        { name: 'Pecorino Romano Cheese', quantity: 50, unit: 'g' },
+        { name: 'Black Pepper', quantity: 1, unit: 'tsp' },
+      ],
+    },
+    // ... (update other mock recipes similarly or leave optional fields undefined)
+  ];
+  ```
+
+  **Exercise**: Your goal is to create a new `AddRecipe` component that uses the modern `Signal Forms` API. Import `form` and `Field` from `@angular/forms/signals`. Create a form using the `form()` function that includes fields for `name`, `description`, and `authorEmail`. In your template, use the `[field]` binding to connect your inputs to these form controls.
+
+- **Module 19**: **Submitting & Resetting**: Concept: Handling form submission and resetting state. **Exercise**: Inject the service into your `AddRecipe` component. Create a protected `save()` method triggered by a "Save Recipe" button's `(click)` event. Inside this method:
+  1. Use the `submit(this.myForm, ...)` utility.
+  2. Update the `RecipeService` to include an `addRecipe(newRecipe: RecipeModel)` method.
+  3. Construct a complete `RecipeModel` (merging form values with defaults) and pass it to the service.
+  4. **Reset the form**: Call `this.myForm().reset()` to clear interaction flags.
+  5. **Clear the values**: Call `this.myModel.set(...)` to reset the inputs.
+
+- **Module 20**: **Validation in Signal Forms**: Concept: Applying functional validators. **Exercise**: Import `required` and `email` from `@angular/forms/signals`. Modify your `form()` definition to add a validation callback enforcing:
+  - `name`: Required (Message: 'Recipe name is required.').
+  - `description`: Required (Message: 'Description is required.').
+  - `authorEmail`: Required (Message: 'Author email is required.') AND Email format (Message: 'Please enter a valid email address.').
+    **Finally, bind the `[disabled]` property of your button to `myForm.invalid()` so users cannot submit invalid data.**
+
+- **Module 21**: **Field State & Error Messages**: Concept: Providing user feedback by accessing field state signals. **Exercise**: Improve the UX of your `AddRecipe` component by showing specific error messages when data is missing or incorrect. In your template, for the `name`, `description`, and `authorEmail` inputs:
+  1. Create an `@if` block that checks if the field is `invalid()` (e.g., `myForm.name().invalid()`).
+  2. Inside the block, use `@for` to iterate over the field's `.errors()`.
+  3. Display the `error.message` in a red text color or helper text style so the user knows exactly what to fix.

package/src/commands/mcp/tools/ai-tutor.d.ts

@@ -5,4 +5,8 @@
  * 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
  */
-export declare const AI_TUTOR_TOOL: import("./tool-registry").McpToolDeclaration<import("zod").ZodRawShape, import("zod").ZodRawShape>;
+export declare const AI_TUTOR_TOOL: import("./tool-registry").McpToolDeclaration<Readonly<{
+    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+}>, Readonly<{
+    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+}>>;

package/src/commands/mcp/tools/best-practices.d.ts

@@ -8,4 +8,6 @@
 import { z } from 'zod';
 export declare const BEST_PRACTICES_TOOL: import("./tool-registry").McpToolDeclaration<{
     workspacePath: z.ZodOptional<z.ZodString>;
-}, z.ZodRawShape>;
+}, Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>>;

package/src/commands/mcp/tools/build.d.ts

@@ -11,27 +11,16 @@ import { type McpToolDeclaration } from './tool-registry';
 declare const buildToolInputSchema: z.ZodObject<{
     project: z.ZodOptional<z.ZodString>;
     configuration: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    project?: string | undefined;
-    configuration?: string | undefined;
-}, {
-    project?: string | undefined;
-    configuration?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type BuildToolInput = z.infer<typeof buildToolInputSchema>;
 declare const buildToolOutputSchema: z.ZodObject<{
-    status: z.ZodEnum<["success", "failure"]>;
-    logs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    status: z.ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     path: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    status: "success" | "failure";
-    path?: string | undefined;
-    logs?: string[] | undefined;
-}, {
-    status: "success" | "failure";
-    path?: string | undefined;
-    logs?: string[] | undefined;
-}>;
+}, z.core.$strip>;
 export type BuildToolOutput = z.infer<typeof buildToolOutputSchema>;
 export declare function runBuild(input: BuildToolInput, host: Host): Promise<{
     content: {
@@ -40,8 +29,8 @@ export declare function runBuild(input: BuildToolInput, host: Host): Promise<{
     }[];
     structuredContent: {
         status: "success" | "failure";
-        path?: string | undefined;
         logs?: string[] | undefined;
+        path?: string | undefined;
     };
 }>;
 export declare const BUILD_TOOL: McpToolDeclaration<typeof buildToolInputSchema.shape, typeof buildToolOutputSchema.shape>;

package/src/commands/mcp/tools/devserver/start-devserver.d.ts

@@ -10,22 +10,12 @@ import { type Host } from '../../host';
 import { type McpToolContext, type McpToolDeclaration } from '../tool-registry';
 declare const startDevServerToolInputSchema: z.ZodObject<{
     project: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    project?: string | undefined;
-}, {
-    project?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type StartDevserverToolInput = z.infer<typeof startDevServerToolInputSchema>;
 declare const startDevServerToolOutputSchema: z.ZodObject<{
     message: z.ZodString;
     address: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    address?: string | undefined;
-}, {
-    message: string;
-    address?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type StartDevserverToolOutput = z.infer<typeof startDevServerToolOutputSchema>;
 export declare function startDevServer(input: StartDevserverToolInput, context: McpToolContext, host: Host): Promise<{
     content: {

package/src/commands/mcp/tools/devserver/stop-devserver.d.ts

@@ -9,22 +9,12 @@ import { z } from 'zod';
 import { type McpToolContext, type McpToolDeclaration } from '../tool-registry';
 declare const stopDevserverToolInputSchema: z.ZodObject<{
     project: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    project?: string | undefined;
-}, {
-    project?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type StopDevserverToolInput = z.infer<typeof stopDevserverToolInputSchema>;
 declare const stopDevserverToolOutputSchema: z.ZodObject<{
     message: z.ZodString;
-    logs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    logs?: string[] | undefined;
-}, {
-    message: string;
-    logs?: string[] | undefined;
-}>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
 export type StopDevserverToolOutput = z.infer<typeof stopDevserverToolOutputSchema>;
 export declare function stopDevserver(input: StopDevserverToolInput, context: McpToolContext): {
     content: {