@angular/forms 22.0.0-next.3 → 22.0.0-next.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/forms",
-  "version": "22.0.0-next.3",
+  "version": "22.0.0-next.4",
   "description": "Angular - directives and services for creating forms",
   "author": "angular",
   "license": "MIT",
@@ -12,9 +12,9 @@
     "@standard-schema/spec": "^1.0.0"
   },
   "peerDependencies": {
-    "@angular/core": "22.0.0-next.3",
-    "@angular/common": "22.0.0-next.3",
-    "@angular/platform-browser": "22.0.0-next.3",
+    "@angular/core": "22.0.0-next.4",
+    "@angular/common": "22.0.0-next.4",
+    "@angular/platform-browser": "22.0.0-next.4",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {

package/types/_structure-chunk.d.ts

@@ -1,11 +1,11 @@
 /**
- * @license Angular v22.0.0-next.3
+ * @license Angular v22.0.0-next.4
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
 import * as i0 from '@angular/core';
-import { Signal, WritableSignal, Injector, InjectionToken, Provider } from '@angular/core';
+import { Signal, Injector, WritableSignal, InjectionToken, Provider } from '@angular/core';
 import { AbstractControl, ValidationErrors, FormControlStatus, ControlValueAccessor, ValidatorFn } from '@angular/forms';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
@@ -53,6 +53,18 @@ interface FormSubmitOptions<TRootModel, TSubmittedModel> {
      */
     ignoreValidators?: 'pending' | 'none' | 'all';
 }
+/**
+ * Options for the `markAsTouched` method.
+ *
+ * @experimental 21.2.0
+ */
+interface MarkAsTouchedOptions {
+    /**
+     * If `true`, only marks the current field as touched.
+     * If `false` or not provided, marks the field and all its descendants as touched.
+     */
+    skipDescendants?: boolean;
+}
 /**
  * A type that represents either a single value of type `T` or a readonly array of `T`.
  * @template T The type of the value(s).
@@ -177,7 +189,7 @@ type Field<TValue, TKey extends string | number = string | number> = () => Field
  * @category types
  * @experimental 21.0
  */
-type FieldTree<TModel, TKey extends string | number = string | number, TMode extends 'writable' | 'readonly' = 'writable'> = (() => [TModel] extends [AbstractControl] ? CompatFieldState<TModel, TKey, TMode> : FieldStateByMode<TModel, TKey, TMode>) & ([TModel] extends [AbstractControl] ? object : [TModel] extends [ReadonlyArray<infer U>] ? ReadonlyArrayLike<MaybeFieldTree<U, number, TMode>> : TModel extends Record<string, any> ? Subfields<TModel, TMode> : object);
+type FieldTree<TModel, TKey extends string | number = string | number, TMode extends 'writable' | 'readonly' = 'writable'> = (() => [TModel] extends [AbstractControl] ? CompatFieldState<TModel, TKey, TMode> : FieldStateByMode<TModel, TKey, TMode>) & (TModel extends AbstractControl ? object : TModel extends ReadonlyArray<infer U> ? ReadonlyArrayLike<MaybeFieldTree<U, number, TMode>> : TModel extends Record<string, any> ? Subfields<TModel, TMode> : object);
 /**
  * A readonly {@link FieldTree}.
  *
@@ -205,7 +217,11 @@ type Subfields<TModel, TMode extends 'writable' | 'readonly' = 'writable'> = {
  *
  * @experimental 21.0
  */
-type ReadonlyArrayLike<T> = Pick<ReadonlyArray<T>, number | 'length' | typeof Symbol.iterator>;
+interface ReadonlyArrayLike<T> {
+    readonly [n: number]: T;
+    readonly length: number;
+    [Symbol.iterator](): IterableIterator<T>;
+}
 /**
  * Helper type for defining `FieldTree`. Given a type `TValue` that may include `undefined`,
  * it extracts the `undefined` outside the `FieldTree` type.
@@ -416,9 +432,11 @@ interface FieldState<TValue, TKey extends string | number = string | number> ext
      */
     markAsDirty(): void;
     /**
-     * Sets the touched status of the field to `true`.
+     * Sets the touched status of the field and its descendants to `true`.
+     *
+     * @param options Options for marking the field as touched.
      */
-    markAsTouched(): void;
+    markAsTouched(options?: MarkAsTouchedOptions): void;
     /**
      * Resets the {@link touched} and {@link dirty} state of the field and its descendants.
      *
@@ -532,7 +550,9 @@ type CompatSchemaPath<TControl extends AbstractControl, TPathKind extends PathKi
  *
  * @experimental 21.0
  */
-type SchemaPathTree<TModel, TPathKind extends PathKind = PathKind.Root> = ([TModel] extends [AbstractControl] ? CompatSchemaPath<TModel, TPathKind> : SchemaPath<TModel, SchemaPathRules.Supported, TPathKind>) & (TModel extends AbstractControl ? unknown : TModel extends ReadonlyArray<any> ? unknown : TModel extends Record<string, any> ? {
+type SchemaPathTree<TModel, TPathKind extends PathKind = PathKind.Root> = ([TModel] extends [AbstractControl] ? CompatSchemaPath<TModel, TPathKind> : SchemaPath<TModel, SchemaPathRules.Supported, TPathKind>) & ([TModel] extends [AbstractControl] ? unknown : [
+    TModel
+] extends [ReadonlyArray<any>] ? unknown : TModel extends Record<string, any> ? {
     [K in keyof TModel]: MaybeSchemaPathTree<TModel[K], PathKind.Child>;
 } : unknown);
 /**
@@ -693,10 +713,10 @@ interface RootFieldContext<TValue> {
     /** Gets the value of the field represented by the given path. */
     valueOf<PValue>(p: SchemaPath<PValue, SchemaPathRules>): PValue;
     /** Gets the state of the field represented by the given path. */
-    stateOf<PControl extends AbstractControl>(p: CompatSchemaPath<PControl>): ReadonlyCompatFieldState<PControl>;
-    stateOf<PValue>(p: SchemaPath<PValue, SchemaPathRules>): ReadonlyFieldState<PValue>;
+    stateOf<PControl extends AbstractControl>(p: CompatSchemaPath<PControl>): [PControl] extends [any] ? ReadonlyCompatFieldState<PControl> : never;
+    stateOf<PValue>(p: SchemaPath<PValue, SchemaPathRules>): [PValue] extends [any] ? ReadonlyFieldState<PValue> : never;
     /** Gets the field represented by the given path. */
-    fieldTreeOf<PModel>(p: SchemaPathTree<PModel>): ReadonlyFieldTree<PModel>;
+    fieldTreeOf<PModel>(p: SchemaPathTree<PModel>): [PModel] extends [any] ? ReadonlyFieldTree<PModel> : never;
     /** The list of keys that lead from the root field to the current field. */
     readonly pathKeys: Signal<readonly string[]>;
 }
@@ -1138,8 +1158,6 @@ interface ValidationErrorOptions {
 type WithFieldTree<T> = T & {
     fieldTree: ReadonlyFieldTree<unknown>;
 };
-/** @deprecated Use `WithFieldTree` instead  */
-type WithField<T> = WithFieldTree<T>;
 /**
  * A type that allows the given type `T` to optionally have a `field` property.
  * @template T The type to optionally add a `field` to.
@@ -1149,8 +1167,6 @@ type WithField<T> = WithFieldTree<T>;
 type WithOptionalFieldTree<T> = Omit<T, 'fieldTree'> & {
     fieldTree?: ReadonlyFieldTree<unknown>;
 };
-/** @deprecated Use `WithOptionalFieldTree` instead  */
-type WithOptionalField<T> = WithOptionalFieldTree<T>;
 /**
  * A type that ensures the given type `T` does not have a `field` property.
  * @template T The type to remove the `field` from.
@@ -1160,8 +1176,6 @@ type WithOptionalField<T> = WithOptionalFieldTree<T>;
 type WithoutFieldTree<T> = T & {
     fieldTree: never;
 };
-/** @deprecated Use `WithoutFieldTree` instead  */
-type WithoutField<T> = WithoutFieldTree<T>;
 /**
  * Create a required error associated with the target field
  * @param options The validation error options
@@ -1762,4 +1776,4 @@ declare function submit<TModel>(form: FieldTree<TModel>, action: NoInfer<FormSub
 declare function schema<TValue>(fn: SchemaFn<TValue>): Schema<TValue>;
 
 export { BaseNgValidationError, EmailValidationError, FORM_FIELD, FormField, MAX, MAX_LENGTH, MIN, MIN_LENGTH, MaxLengthValidationError, MaxValidationError, MetadataKey, MetadataReducer, MinLengthValidationError, MinValidationError, NativeInputParseError, NgValidationError, PATTERN, PathKind, PatternValidationError, REQUIRED, RequiredValidationError, SchemaPathRules, StandardSchemaValidationError, ValidationError, apply, applyEach, applyWhen, applyWhenValue, createManagedMetadataKey, createMetadataKey, emailError, form, maxError, maxLengthError, metadata, minError, minLengthError, patternError, provideSignalFormsConfig, requiredError, schema, standardSchemaError, submit, validateStandardSchema, ɵNgFieldDirective };
-export type { AsyncValidationResult, ChildFieldContext, CompatFieldState, CompatSchemaPath, Debouncer, DisabledReason, Field, FieldContext, FieldState, FieldStateByMode, FieldTree, FieldValidator, FormFieldBinding, FormFieldBindingOptions, FormOptions, FormSubmitOptions, IgnoreUnknownProperties, ItemFieldContext, ItemType, LogicFn, MaybeFieldTree, MaybeSchemaPathTree, MetadataSetterType, OneOrMany, ReadonlyArrayLike, ReadonlyCompatFieldState, ReadonlyFieldState, ReadonlyFieldTree, RemoveStringIndexUnknownKey, RootFieldContext, Schema, SchemaFn, SchemaOrSchemaFn, SchemaPath, SchemaPathTree, SignalFormsConfig, Subfields, TreeValidationResult, TreeValidator, ValidationErrorOptions, ValidationResult, ValidationSuccess, Validator, WithField, WithFieldTree, WithOptionalField, WithOptionalFieldTree, WithoutField, WithoutFieldTree };
+export type { AsyncValidationResult, ChildFieldContext, CompatFieldState, CompatSchemaPath, Debouncer, DisabledReason, Field, FieldContext, FieldState, FieldStateByMode, FieldTree, FieldValidator, FormFieldBinding, FormFieldBindingOptions, FormOptions, FormSubmitOptions, IgnoreUnknownProperties, ItemFieldContext, ItemType, LogicFn, MarkAsTouchedOptions, MaybeFieldTree, MaybeSchemaPathTree, MetadataSetterType, OneOrMany, ReadonlyArrayLike, ReadonlyCompatFieldState, ReadonlyFieldState, ReadonlyFieldTree, RemoveStringIndexUnknownKey, RootFieldContext, Schema, SchemaFn, SchemaOrSchemaFn, SchemaPath, SchemaPathTree, SignalFormsConfig, Subfields, TreeValidationResult, TreeValidator, ValidationErrorOptions, ValidationResult, ValidationSuccess, Validator, WithFieldTree, WithOptionalFieldTree, WithoutFieldTree };

package/types/forms.d.ts

@@ -1,11 +1,11 @@
 /**
- * @license Angular v22.0.0-next.3
+ * @license Angular v22.0.0-next.4
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
 import * as i0 from '@angular/core';
-import { InjectionToken, Renderer2, ElementRef, OnDestroy, OnChanges, SimpleChanges, OnInit, Injector, EventEmitter, ChangeDetectorRef, AfterViewInit, Version, ModuleWithProviders } from '@angular/core';
+import { Renderer2, ElementRef, InjectionToken, OnDestroy, OnChanges, SimpleChanges, Injector, ɵControlDirectiveHost as _ControlDirectiveHost, OnInit, EventEmitter, Signal, ChangeDetectorRef, AfterViewInit, Version, ModuleWithProviders } from '@angular/core';
 import { Observable } from 'rxjs';
 
 /**
@@ -298,7 +298,7 @@ declare class SelectControlValueAccessor extends BuiltInControlValueAccessor imp
      */
     registerOnChange(fn: (value: any) => any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectControlValueAccessor, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SelectControlValueAccessor, "select:not([multiple])[formControlName],select:not([multiple])[formControl],select:not([multiple])[ngModel]", never, { "compareWith": { "alias": "compareWith"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SelectControlValueAccessor, "select:not([multiple]):not([ngNoCva])[formControlName],select:not([multiple]):not([ngNoCva])[formControl],select:not([multiple]):not([ngNoCva])[ngModel]", never, { "compareWith": { "alias": "compareWith"; "required": false; }; }, {}, never, never, false, never>;
 }
 /**
  * @description
@@ -398,7 +398,7 @@ declare class SelectMultipleControlValueAccessor extends BuiltInControlValueAcce
      */
     registerOnChange(fn: (value: any) => any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectMultipleControlValueAccessor, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SelectMultipleControlValueAccessor, "select[multiple][formControlName],select[multiple][formControl],select[multiple][ngModel]", never, { "compareWith": { "alias": "compareWith"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SelectMultipleControlValueAccessor, "select[multiple]:not([ngNoCva])[formControlName],select[multiple]:not([ngNoCva])[formControl],select[multiple]:not([ngNoCva])[ngModel]", never, { "compareWith": { "alias": "compareWith"; "required": false; }; }, {}, never, never, false, never>;
 }
 /**
  * @description
@@ -486,7 +486,7 @@ declare class DefaultValueAccessor extends BaseControlValueAccessor implements C
      */
     writeValue(value: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DefaultValueAccessor, [null, null, { optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<DefaultValueAccessor, "input:not([type=checkbox])[formControlName],textarea[formControlName],input:not([type=checkbox])[formControl],textarea[formControl],input:not([type=checkbox])[ngModel],textarea[ngModel],[ngDefaultControl]", never, {}, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<DefaultValueAccessor, "input:not([type=checkbox]):not([ngNoCva])[formControlName],textarea:not([ngNoCva])[formControlName],input:not([type=checkbox]):not([ngNoCva])[formControl],textarea:not([ngNoCva])[formControl],input:not([type=checkbox]):not([ngNoCva])[ngModel],textarea:not([ngNoCva])[ngModel],[ngDefaultControl]", never, {}, {}, never, never, false, never>;
 }
 
 /**
@@ -525,7 +525,7 @@ declare class NumberValueAccessor extends BuiltInControlValueAccessor implements
      */
     registerOnChange(fn: (_: number | null) => void): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NumberValueAccessor, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NumberValueAccessor, "input[type=number][formControlName],input[type=number][formControl],input[type=number][ngModel]", never, {}, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NumberValueAccessor, "input[type=number]:not([ngNoCva])[formControlName],input[type=number]:not([ngNoCva])[formControl],input[type=number]:not([ngNoCva])[ngModel]", never, {}, {}, never, never, false, never>;
 }
 
 /**
@@ -564,7 +564,7 @@ declare class RangeValueAccessor extends BuiltInControlValueAccessor implements
      */
     registerOnChange(fn: (_: number | null) => void): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RangeValueAccessor, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RangeValueAccessor, "input[type=range][formControlName],input[type=range][formControl],input[type=range][ngModel]", never, {}, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RangeValueAccessor, "input[type=range]:not([ngNoCva])[formControlName],input[type=range]:not([ngNoCva])[formControl],input[type=range]:not([ngNoCva])[ngModel]", never, {}, {}, never, never, false, never>;
 }
 
 /**
@@ -597,7 +597,7 @@ declare class CheckboxControlValueAccessor extends BuiltInControlValueAccessor i
      */
     writeValue(value: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxControlValueAccessor, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<CheckboxControlValueAccessor, "input[type=checkbox][formControlName],input[type=checkbox][formControl],input[type=checkbox][ngModel]", never, {}, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CheckboxControlValueAccessor, "input[type=checkbox]:not([ngNoCva])[formControlName],input[type=checkbox]:not([ngNoCva])[formControl],input[type=checkbox]:not([ngNoCva])[ngModel]", never, {}, {}, never, never, false, never>;
 }
 
 /**
@@ -3212,6 +3212,7 @@ declare abstract class AbstractControl<TValue = any, TRawValue extends TValue =
      * a control is extended.
      */
     private _assignAsyncValidators;
+    private _updateHasRequiredValidator;
 }
 
 /**
@@ -3430,6 +3431,14 @@ declare abstract class NgControl extends AbstractControlDirective {
      * The value accessor for the control
      */
     valueAccessor: ControlValueAccessor | null;
+    protected isCustomControlBased: boolean;
+    private isNativeFormElement;
+    /**
+     * Raw `ControlValueAccessor`s retrieved from DI.
+     */
+    private readonly rawValueAccessors;
+    private _selectedValueAccessor;
+    protected get selectedValueAccessor(): ControlValueAccessor | null;
     /**
      * @description
      * The callback method to update the model from the view when requested
@@ -3437,6 +3446,63 @@ declare abstract class NgControl extends AbstractControlDirective {
      * @param newValue The new value for the view
      */
     abstract viewToModelUpdate(newValue: any): void;
+    /**
+     * Validator function that returns current parse errors.
+     */
+    protected parseErrorsValidator: ValidatorFn | null;
+    /**
+     * Renderer for setting native DOM properties. Set by subclass constructor.
+     */
+    private renderer;
+    /**
+     * Injector for creating effects. Set by subclass constructor.
+     */
+    private readonly injector;
+    private requiredValidatorViaDi;
+    /**
+     * Container for any RxJS subscriptions related to the current control.
+     *
+     * This gets cleaned up and recreated when the control changes.
+     */
+    private subscription;
+    /**
+     * Tracks last bound values to avoid unnecessary FVC updates.
+     */
+    protected customControlBindings: {
+        value?: unknown;
+        disabled?: boolean;
+        touched?: boolean;
+        dirty?: boolean;
+        valid?: boolean;
+        invalid?: boolean;
+        pending?: boolean;
+        required?: boolean;
+        errors?: ValidationErrors | null;
+    } | null;
+    constructor(injector?: Injector, renderer?: Renderer2, rawValueAccessors?: ControlValueAccessor[]);
+    protected setupCustomControl(): void;
+    protected ngControlUpdate(host: _ControlDirectiveHost, bindRequired: boolean): void;
+    /**
+     * Returns true if the control is currently considered required, false otherwise.
+     *
+     * A control can be required either via `NG_VALIDATORS` including the `RequiredValidator`.
+     */
+    private get isRequired();
+    /**
+     * Whether the control should bind the `required` property (in custom control mode).
+     *
+     * Can be overridden by subclasses that handle `required` in a different way.
+     */
+    protected get shouldBindRequired(): boolean;
+    /**
+     * Binds a status property to FVC, falling back to native DOM if FVC lacks the input.
+     */
+    private bindControlProperty;
+    /**
+     * Converts Reactive Forms errors to Signal Forms error format.
+     */
+    private _convertErrors;
+    protected removeParseErrorsValidator(control: AbstractControl | null | undefined): void;
 }
 
 /**
@@ -3538,7 +3604,7 @@ declare class RadioControlValueAccessor extends BuiltInControlValueAccessor impl
     fireUncheck(value: any): void;
     private _checkName;
     static ɵfac: i0.ɵɵFactoryDeclaration<RadioControlValueAccessor, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RadioControlValueAccessor, "input[type=radio][formControlName],input[type=radio][formControl],input[type=radio][ngModel]", never, { "name": { "alias": "name"; "required": false; }; "formControlName": { "alias": "formControlName"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RadioControlValueAccessor, "input[type=radio]:not([ngNoCva])[formControlName],input[type=radio]:not([ngNoCva])[formControl],input[type=radio]:not([ngNoCva])[ngModel]", never, { "name": { "alias": "name"; "required": false; }; "formControlName": { "alias": "formControlName"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, {}, never, never, false, never>;
 }
 
 /**
@@ -3774,7 +3840,7 @@ declare class FormControlName extends NgControl implements OnChanges, OnDestroy
     model: any;
     /** @deprecated as of v6 */
     update: EventEmitter<any>;
-    constructor(parent: ControlContainer, validators: (Validator | ValidatorFn)[], asyncValidators: (AsyncValidator | AsyncValidatorFn)[], valueAccessors: ControlValueAccessor[], _ngModelWarningConfig: string | null);
+    constructor(parent: ControlContainer, validators: (Validator | ValidatorFn)[], asyncValidators: (AsyncValidator | AsyncValidatorFn)[], valueAccessors: ControlValueAccessor[], _ngModelWarningConfig: string | null, renderer?: Renderer2, injector?: Injector);
     /** @docs-private */
     ngOnChanges(changes: SimpleChanges): void;
     /** @docs-private */
@@ -3798,7 +3864,7 @@ declare class FormControlName extends NgControl implements OnChanges, OnDestroy
      */
     get formDirective(): any;
     private _setUpControl;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormControlName, [{ optional: true; host: true; skipSelf: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormControlName, [{ optional: true; host: true; skipSelf: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<FormControlName, "[formControlName]", never, { "name": { "alias": "formControlName"; "required": false; }; "isDisabled": { "alias": "disabled"; "required": false; }; "model": { "alias": "ngModel"; "required": false; }; }, { "update": "ngModelChange"; }, never, never, false, never>;
 }
 
@@ -4099,6 +4165,15 @@ declare class FormArrayName extends ControlContainer implements OnInit, OnDestro
     static ɵdir: i0.ɵɵDirectiveDeclaration<FormArrayName, "[formArrayName]", never, { "name": { "alias": "formArrayName"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+/**
+ * DI token that provides a writable signal that controls can use to set the signal of parse errors
+ * for the `FormField` directive or reactive directives. Used internally by `transformedValue`.
+ */
+declare const ɵFORM_FIELD_PARSE_ERRORS: InjectionToken<{
+    readonly set: (value: Signal<ReadonlyArray<{
+        readonly kind: string;
+    }>> | undefined) => void;
+}>;
 /**
  * The type for CALL_SET_DISABLED_STATE. If `always`, then ControlValueAccessor will always call
  * `setDisabledState` when attached, which is the most correct behavior. Otherwise, it will only be
@@ -4248,11 +4323,18 @@ declare class NgModel extends NgControl implements OnChanges, OnDestroy {
      * the view model updates.
      */
     update: EventEmitter<any>;
-    constructor(parent: ControlContainer, validators: (Validator | ValidatorFn)[], asyncValidators: (AsyncValidator | AsyncValidatorFn)[], valueAccessors: ControlValueAccessor[], _changeDetectorRef?: (ChangeDetectorRef | null) | undefined, callSetDisabledState?: SetDisabledStateOption | undefined);
+    constructor(parent: ControlContainer, validators: (Validator | ValidatorFn)[], asyncValidators: (AsyncValidator | AsyncValidatorFn)[], valueAccessors: ControlValueAccessor[], _changeDetectorRef?: (ChangeDetectorRef | null) | undefined, callSetDisabledState?: SetDisabledStateOption | undefined, injector?: Injector, renderer?: Renderer2);
     /** @docs-private */
     ngOnChanges(changes: SimpleChanges): void;
     /** @docs-private */
     ngOnDestroy(): void;
+    /**
+     * Template-driven forms handle `required` via the `RequiredValidator` directive.
+     *
+     * This directive has a `required` input and a host binding to `[attr.required]`. It defines the
+     * source of truth for required-ness, so disable the normal control binding for it.
+     */
+    protected get shouldBindRequired(): boolean;
     /**
      * @description
      * Returns an array that represents the path from the top-level form to this control.
@@ -4280,7 +4362,7 @@ declare class NgModel extends NgControl implements OnChanges, OnDestroy {
     private _updateValue;
     private _updateDisabled;
     private _getPath;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NgModel, [{ optional: true; host: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgModel, [{ optional: true; host: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<NgModel, "[ngModel]:not([formControlName]):not([formControl])", ["ngModel"], { "name": { "alias": "name"; "required": false; }; "isDisabled": { "alias": "disabled"; "required": false; }; "model": { "alias": "ngModel"; "required": false; }; "options": { "alias": "ngModelOptions"; "required": false; }; }, { "update": "ngModelChange"; }, never, never, false, never>;
 }
 
@@ -4613,7 +4695,7 @@ declare class FormControlDirective extends NgControl implements OnChanges, OnDes
     model: any;
     /** @deprecated as of v6 */
     update: EventEmitter<any>;
-    constructor(validators: (Validator | ValidatorFn)[], asyncValidators: (AsyncValidator | AsyncValidatorFn)[], valueAccessors: ControlValueAccessor[], _ngModelWarningConfig: string | null, callSetDisabledState?: SetDisabledStateOption | undefined);
+    constructor(validators: (Validator | ValidatorFn)[], asyncValidators: (AsyncValidator | AsyncValidatorFn)[], valueAccessors: ControlValueAccessor[], _ngModelWarningConfig: string | null, callSetDisabledState?: SetDisabledStateOption | undefined, renderer?: Renderer2, injector?: Injector);
     /** @docs-private */
     ngOnChanges(changes: SimpleChanges): void;
     /** @docs-private */
@@ -4637,7 +4719,7 @@ declare class FormControlDirective extends NgControl implements OnChanges, OnDes
      */
     viewToModelUpdate(newValue: any): void;
     private _isControlChanged;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormControlDirective, [{ optional: true; self: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormControlDirective, [{ optional: true; self: true; }, { optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<FormControlDirective, "[formControl]", ["ngForm"], { "form": { "alias": "formControl"; "required": false; }; "isDisabled": { "alias": "disabled"; "required": false; }; "model": { "alias": "ngModel"; "required": false; }; }, { "update": "ngModelChange"; }, never, never, false, never>;
 }
 
@@ -5335,6 +5417,30 @@ declare class Validators {
  */
 declare const VERSION: Version;
 
+/**
+ * Supported native control element types.
+ *
+ * The `type` property of a {@link HTMLTextAreaElement} should always be 'textarea', but the
+ * TypeScript DOM API type definition lacks this detail, so we include it here.
+ *
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTextAreaElement/type
+ */
+type NativeFormControl = HTMLInputElement | HTMLSelectElement | (HTMLTextAreaElement & {
+    type: 'textarea';
+});
+declare function isNativeFormElement(element: HTMLElement): element is NativeFormControl;
+declare function isNumericFormElement(element: HTMLElement): boolean;
+declare function isTextualFormElement(element: HTMLElement): boolean;
+/**
+ * Updates the native DOM property on the given node.
+ *
+ * @param renderer The renderer to use for DOM operations.
+ * @param element The native form control element.
+ * @param name The DOM attribute/property name.
+ * @param value The new value for the property.
+ */
+declare function setNativeDomProperty(renderer: Renderer2, element: NativeFormControl, name: 'name' | 'disabled' | 'required' | 'readonly' | 'min' | 'max' | 'minLength' | 'maxLength', value: string | number | boolean | undefined): void;
+
 /**
  * Exports the required providers and directives for template-driven forms,
  * making them available for import by NgModules that import this module.
@@ -5389,5 +5495,5 @@ declare class ReactiveFormsModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<ReactiveFormsModule>;
 }
 
-export { AbstractControl, AbstractControlDirective, AbstractFormDirective, AbstractFormGroupDirective, COMPOSITION_BUFFER_MODE, CheckboxControlValueAccessor, CheckboxRequiredValidator, ControlContainer, ControlEvent, DefaultValueAccessor, EmailValidator, FormArray, FormArrayDirective, FormArrayName, FormBuilder, FormControl, FormControlDirective, FormControlName, FormGroup, FormGroupDirective, FormGroupName, FormRecord, FormResetEvent, FormSubmittedEvent, FormsModule, MaxLengthValidator, MaxValidator, MinLengthValidator, MinValidator, NG_ASYNC_VALIDATORS, NG_VALIDATORS, NG_VALUE_ACCESSOR, NgControl, NgControlStatus, NgControlStatusGroup, NgForm, NgModel, NgModelGroup, NgSelectOption, NonNullableFormBuilder, NumberValueAccessor, PatternValidator, PristineChangeEvent, RadioControlValueAccessor, RangeValueAccessor, ReactiveFormsModule, RequiredValidator, SelectControlValueAccessor, SelectMultipleControlValueAccessor, StatusChangeEvent, TouchedChangeEvent, UntypedFormArray, UntypedFormBuilder, UntypedFormControl, UntypedFormGroup, VERSION, Validators, ValueChangeEvent, isFormArray, isFormControl, isFormGroup, isFormRecord, ɵInternalFormsSharedModule, ɵNgNoValidate, ɵNgSelectMultipleOption };
-export type { AbstractControlOptions, AsyncValidator, AsyncValidatorFn, ControlConfig, ControlValueAccessor, Form, FormControlOptions, FormControlState, FormControlStatus, SetDisabledStateOption, ValidationErrors, Validator, ValidatorFn, ɵCoerceStrArrToNumArr, ɵElement, ɵFormArrayRawValue, ɵFormArrayValue, ɵFormControlCtor, ɵFormGroupRawValue, ɵFormGroupValue, ɵGetProperty, ɵNavigate, ɵOptionalKeys, ɵRawValue, ɵTokenize, ɵTypedOrUntyped, ɵValue, ɵWriteable };
+export { AbstractControl, AbstractControlDirective, AbstractFormDirective, AbstractFormGroupDirective, COMPOSITION_BUFFER_MODE, CheckboxControlValueAccessor, CheckboxRequiredValidator, ControlContainer, ControlEvent, DefaultValueAccessor, EmailValidator, FormArray, FormArrayDirective, FormArrayName, FormBuilder, FormControl, FormControlDirective, FormControlName, FormGroup, FormGroupDirective, FormGroupName, FormRecord, FormResetEvent, FormSubmittedEvent, FormsModule, MaxLengthValidator, MaxValidator, MinLengthValidator, MinValidator, NG_ASYNC_VALIDATORS, NG_VALIDATORS, NG_VALUE_ACCESSOR, NgControl, NgControlStatus, NgControlStatusGroup, NgForm, NgModel, NgModelGroup, NgSelectOption, NonNullableFormBuilder, NumberValueAccessor, PatternValidator, PristineChangeEvent, RadioControlValueAccessor, RangeValueAccessor, ReactiveFormsModule, RequiredValidator, SelectControlValueAccessor, SelectMultipleControlValueAccessor, StatusChangeEvent, TouchedChangeEvent, UntypedFormArray, UntypedFormBuilder, UntypedFormControl, UntypedFormGroup, VERSION, Validators, ValueChangeEvent, isFormArray, isFormControl, isFormGroup, isFormRecord, ɵFORM_FIELD_PARSE_ERRORS, ɵInternalFormsSharedModule, ɵNgNoValidate, ɵNgSelectMultipleOption, isNativeFormElement as ɵisNativeFormElement, isNumericFormElement as ɵisNumericFormElement, isTextualFormElement as ɵisTextualFormElement, setNativeDomProperty as ɵsetNativeDomProperty };
+export type { AbstractControlOptions, AsyncValidator, AsyncValidatorFn, ControlConfig, ControlValueAccessor, Form, FormControlOptions, FormControlState, FormControlStatus, SetDisabledStateOption, ValidationErrors, Validator, ValidatorFn, ɵCoerceStrArrToNumArr, ɵElement, ɵFormArrayRawValue, ɵFormArrayValue, ɵFormControlCtor, ɵFormGroupRawValue, ɵFormGroupValue, ɵGetProperty, NativeFormControl as ɵNativeFormControl, ɵNavigate, ɵOptionalKeys, ɵRawValue, ɵTokenize, ɵTypedOrUntyped, ɵValue, ɵWriteable };

package/types/signals-compat.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v22.0.0-next.3
+ * @license Angular v22.0.0-next.4
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -112,6 +112,64 @@ declare function compatForm<TModel>(model: WritableSignal<TModel>, schemaOrOptio
  */
 declare function compatForm<TModel>(model: WritableSignal<TModel>, schema: SchemaOrSchemaFn<TModel>, options: CompatFormOptions<TModel>): FieldTree<TModel>;
 
+/**
+ * Type utility that recursively unwraps the value type of a `FieldTree`.
+ *
+ * If the value type contains `AbstractControl` instances (common in compat mode),
+ * they are replaced with their underlying value types.
+ */
+type RawValue<T> = T extends AbstractControl<infer TValue, any> ? TValue : T extends (infer U)[] ? RawValue<U>[] : T extends object ? {
+    [K in keyof T]: RawValue<T[K]>;
+} : T;
+/**
+ * A type that recursively makes all properties of T optional.
+ * Used for the result of `extractValue` when filtering is applied.
+ * @experimental 21.2.0
+ */
+type DeepPartial<T> = (T extends (infer U)[] ? DeepPartial<U>[] : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T) | undefined;
+/**
+ * Criteria that determine whether a field should be included in the extraction.
+ *
+ * Each property is optional; when provided, the field must match the specified state.
+ *
+ * @category interop
+ * @experimental 21.2.0
+ */
+interface ExtractFilter {
+    readonly dirty?: boolean;
+    readonly touched?: boolean;
+    readonly enabled?: boolean;
+}
+/**
+ * Utility to unwrap a {@link FieldTree} into its underlying raw value.
+ *
+ * This function is recursive, so if the field tree represents an object or an array,
+ * the result will be an object or an array of the raw values of its children.
+ *
+ * @param field The field tree to extract the value from.
+ * @returns The raw value of the field tree.
+ *
+ * @category interop
+ * @experimental 21.2.0
+ */
+declare function extractValue<T>(field: FieldTree<T>): RawValue<T>;
+/**
+ * Utility to unwrap a {@link FieldTree} into its underlying raw value.
+ *
+ * This function is recursive, so if the field tree represents an object or an array,
+ * the result will be an object or an array of the raw values of its children.
+ *
+ * @param field The field tree to extract the value from.
+ * @param filter Criteria to include only fields matching certain state (dirty, touched, enabled).
+ * @returns A partial value containing only the fields matching the filter, or `undefined` if none match.
+ *
+ * @category interop
+ * @experimental 21.2.0
+ */
+declare function extractValue<T>(field: FieldTree<T>, filter: ExtractFilter): DeepPartial<RawValue<T>>;
+
 /**
  * An error used for compat errors.
  *
@@ -262,5 +320,5 @@ declare class SignalFormControl<T> extends AbstractControl {
     }): void;
 }
 
-export { CompatValidationError, NG_STATUS_CLASSES, SignalFormControl, compatForm };
+export { CompatValidationError, NG_STATUS_CLASSES, SignalFormControl, compatForm, extractValue };
 export type { CompatFormOptions };

package/types/signals.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v22.0.0-next.3
+ * @license Angular v22.0.0-next.4
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -7,7 +7,7 @@
 import * as i0 from '@angular/core';
 import { Signal, ResourceRef, InputSignal, InputSignalWithTransform, OutputRef, ModelSignal, WritableSignal } from '@angular/core';
 import { PathKind, SchemaPath, SchemaPathRules, LogicFn, OneOrMany, ValidationError, FieldValidator, FieldContext, TreeValidationResult, TreeValidator, WithOptionalFieldTree, DisabledReason, Debouncer, FieldTree } from './_structure-chunk.js';
-export { AsyncValidationResult, BaseNgValidationError, ChildFieldContext, CompatFieldState, CompatSchemaPath, EmailValidationError, FORM_FIELD, Field, FieldState, FieldStateByMode, FormField, FormFieldBinding, FormFieldBindingOptions, FormOptions, FormSubmitOptions, IgnoreUnknownProperties, ItemFieldContext, ItemType, MAX, MAX_LENGTH, MIN, MIN_LENGTH, MaxLengthValidationError, MaxValidationError, MaybeFieldTree, MaybeSchemaPathTree, MetadataKey, MetadataReducer, MetadataSetterType, MinLengthValidationError, MinValidationError, NativeInputParseError, NgValidationError, PATTERN, PatternValidationError, REQUIRED, ReadonlyArrayLike, ReadonlyCompatFieldState, ReadonlyFieldState, ReadonlyFieldTree, RemoveStringIndexUnknownKey, RequiredValidationError, RootFieldContext, Schema, SchemaFn, SchemaOrSchemaFn, SchemaPathTree, SignalFormsConfig, StandardSchemaValidationError, Subfields, ValidationErrorOptions, ValidationResult, ValidationSuccess, Validator, WithField, WithFieldTree, WithOptionalField, WithoutField, WithoutFieldTree, apply, applyEach, applyWhen, applyWhenValue, createManagedMetadataKey, createMetadataKey, emailError, form, maxError, maxLengthError, metadata, minError, minLengthError, patternError, provideSignalFormsConfig, requiredError, schema, standardSchemaError, submit, validateStandardSchema, ɵNgFieldDirective } from './_structure-chunk.js';
+export { AsyncValidationResult, BaseNgValidationError, ChildFieldContext, CompatFieldState, CompatSchemaPath, EmailValidationError, FORM_FIELD, Field, FieldState, FieldStateByMode, FormField, FormFieldBinding, FormFieldBindingOptions, FormOptions, FormSubmitOptions, IgnoreUnknownProperties, ItemFieldContext, ItemType, MAX, MAX_LENGTH, MIN, MIN_LENGTH, MarkAsTouchedOptions, MaxLengthValidationError, MaxValidationError, MaybeFieldTree, MaybeSchemaPathTree, MetadataKey, MetadataReducer, MetadataSetterType, MinLengthValidationError, MinValidationError, NativeInputParseError, NgValidationError, PATTERN, PatternValidationError, REQUIRED, ReadonlyArrayLike, ReadonlyCompatFieldState, ReadonlyFieldState, ReadonlyFieldTree, RemoveStringIndexUnknownKey, RequiredValidationError, RootFieldContext, Schema, SchemaFn, SchemaOrSchemaFn, SchemaPathTree, SignalFormsConfig, StandardSchemaValidationError, Subfields, ValidationErrorOptions, ValidationResult, ValidationSuccess, Validator, WithFieldTree, WithoutFieldTree, apply, applyEach, applyWhen, applyWhenValue, createManagedMetadataKey, createMetadataKey, emailError, form, maxError, maxLengthError, metadata, minError, minLengthError, patternError, provideSignalFormsConfig, requiredError, schema, standardSchemaError, submit, validateStandardSchema, ɵNgFieldDirective } from './_structure-chunk.js';
 import { HttpResourceRequest, HttpResourceOptions } from '@angular/common/http';
 import '@angular/forms';
 import '@standard-schema/spec';