@angular/forms 20.2.3 → 21.0.0-next.1

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v20.2.3
+ * @license Angular v21.0.0-next.1
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -3643,7 +3643,7 @@ declare class NgControlStatus extends AbstractControlStatus {
 declare class NgControlStatusGroup extends AbstractControlStatus {
     constructor(cd: ControlContainer);
     static ɵfac: i0.ɵɵFactoryDeclaration<NgControlStatusGroup, [{ optional: true; self: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NgControlStatusGroup, "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],form:not([ngNoForm]),[ngForm]", never, {}, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgControlStatusGroup, "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],[formArray],form:not([ngNoForm]),[ngForm]", never, {}, {}, never, never, false, never>;
 }
 
 /**
@@ -3736,28 +3736,12 @@ declare class FormControlName extends NgControl implements OnChanges, OnDestroy
 /**
  * @description
  *
- * Binds an existing `FormGroup` or `FormRecord` to a DOM element.
- *
- * This directive accepts an existing `FormGroup` instance. It will then use this
- * `FormGroup` instance to match any child `FormControl`, `FormGroup`/`FormRecord`,
- * and `FormArray` instances to child `FormControlName`, `FormGroupName`,
- * and `FormArrayName` directives.
- *
- * @see [Reactive Forms Guide](guide/forms/reactive-forms)
- * @see {@link AbstractControl}
- *
- * @usageNotes
- * ### Register Form Group
- *
- * The following example registers a `FormGroup` with first name and last name controls,
- * and listens for the *ngSubmit* event when the button is clicked.
- *
- * {@example forms/ts/simpleFormGroup/simple_form_group_example.ts region='Component'}
+ * Abstract class for top-level form directives (FormArrayDirective, FormGroupDirective) who bind an
+ * existing `Form` to a DOM element.
  *
- * @ngModule ReactiveFormsModule
  * @publicApi
  */
-declare class FormGroupDirective extends ControlContainer implements Form, OnChanges, OnDestroy {
+declare abstract class AbstractFormDirective extends ControlContainer implements Form, OnChanges, OnDestroy {
     private callSetDisabledState?;
     /**
      * @description
@@ -3783,19 +3767,23 @@ declare class FormGroupDirective extends ControlContainer implements Form, OnCha
     directives: FormControlName[];
     /**
      * @description
-     * Tracks the `FormGroup` bound to this directive.
+     * Tracks the form bound to this directive.
      */
-    form: FormGroup;
+    abstract form: AbstractControl;
     /**
      * @description
      * Emits an event when the form submission has been triggered.
      */
-    ngSubmit: EventEmitter<any>;
+    abstract ngSubmit: EventEmitter<any>;
     constructor(validators: (Validator | ValidatorFn)[], asyncValidators: (AsyncValidator | AsyncValidatorFn)[], callSetDisabledState?: SetDisabledStateOption | undefined);
-    /** @docs-private */
+    /** @nodoc */
     ngOnChanges(changes: SimpleChanges): void;
-    /** @docs-private */
+    /** @nodoc */
     ngOnDestroy(): void;
+    /** @nodoc */
+    protected onChanges(changes: SimpleChanges): void;
+    /** @nodoc */
+    protected onDestroy(): void;
     /**
      * @description
      * Returns this directive's instance.
@@ -3803,9 +3791,9 @@ declare class FormGroupDirective extends ControlContainer implements Form, OnCha
     get formDirective(): Form;
     /**
      * @description
-     * Returns the `FormGroup` bound to this directive.
+     * Returns the Form bound to this directive.
      */
-    get control(): FormGroup;
+    abstract get control(): AbstractControl;
     /**
      * @description
      * Returns an array representing the path to this group. Because this directive
@@ -3854,6 +3842,13 @@ declare class FormGroupDirective extends ControlContainer implements Form, OnCha
      * @param dir The `FormGroupName` directive instance.
      */
     getFormGroup(dir: FormGroupName): FormGroup;
+    /**
+     * @description
+     * Retrieves the `FormArray` for a provided `FormArrayName` directive instance.
+     *
+     * @param dir The `FormArrayName` directive instance.
+     */
+    getFormArray(dir: FormArrayName): FormArray;
     /**
      * Performs the necessary setup when a `FormArrayName` directive instance is added to the view.
      *
@@ -3867,13 +3862,6 @@ declare class FormGroupDirective extends ControlContainer implements Form, OnCha
      * @param dir The `FormArrayName` directive instance.
      */
     removeFormArray(dir: FormArrayName): void;
-    /**
-     * @description
-     * Retrieves the `FormArray` for a provided `FormArrayName` directive instance.
-     *
-     * @param dir The `FormArrayName` directive instance.
-     */
-    getFormArray(dir: FormArrayName): FormArray;
     /**
      * Sets the new value for the provided `FormControlName` directive.
      *
@@ -3881,14 +3869,6 @@ declare class FormGroupDirective extends ControlContainer implements Form, OnCha
      * @param value The new value for the directive's control.
      */
     updateModel(dir: FormControlName, value: any): void;
-    /**
-     * @description
-     * Method called with the "submit" event is triggered on the form.
-     * Triggers the `ngSubmit` emitter to emit the "submit" event as its payload.
-     *
-     * @param $event The "submit" event object
-     */
-    onSubmit($event: Event): boolean;
     /**
      * @description
      * Method called when the "reset" event is triggered on the form.
@@ -3898,18 +3878,27 @@ declare class FormGroupDirective extends ControlContainer implements Form, OnCha
      * @description
      * Resets the form to an initial value and resets its submitted status.
      *
-     * @param value The new value for the form, `undefined` by default
+     * @param value The new value for the form.
      */
     resetForm(value?: any, options?: {
         onlySelf?: boolean;
         emitEvent?: boolean;
     }): void;
+    /**
+     * @description
+     * Method called with the "submit" event is triggered on the form.
+     * Triggers the `ngSubmit` emitter to emit the "submit" event as its payload.
+     *
+     * @param $event The "submit" event object
+     */
+    onSubmit($event: Event): boolean;
     private _setUpFormContainer;
     private _cleanUpFormContainer;
     private _updateRegistrations;
     private _updateValidators;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormGroupDirective, [{ optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<FormGroupDirective, "[formGroup]", ["ngForm"], { "form": { "alias": "formGroup"; "required": false; }; }, { "ngSubmit": "ngSubmit"; }, never, never, false, never>;
+    private _checkFormPresent;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AbstractFormDirective, [{ optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AbstractFormDirective, never, never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -3979,12 +3968,12 @@ declare class FormGroupName extends AbstractFormGroupDirective implements OnInit
  *
  * Syncs a nested `FormArray` to a DOM element.
  *
- * This directive is designed to be used with a parent `FormGroupDirective` (selector:
- * `[formGroup]`).
+ * This directive is designed to be used with a parent `FormGroupDirective`/`FormGroupArray` (selector:
+ * `[formGroup]`/`[formArray]`).
  *
  * It accepts the string name of the nested `FormArray` you want to link, and
  * will look for a `FormArray` registered with that name in the parent
- * `FormGroup` instance you passed into `FormGroupDirective`.
+ * `FormGroup`/`FormArray` instance you passed into `FormGroupDirective`/`FormGroupArray`.
  *
  * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  * @see {@link AbstractControl}
@@ -4030,7 +4019,7 @@ declare class FormArrayName extends ControlContainer implements OnInit, OnDestro
      * @description
      * The top-level directive for this group if present, otherwise null.
      */
-    get formDirective(): FormGroupDirective | null;
+    get formDirective(): AbstractFormDirective | null;
     /**
      * @description
      * Returns an array that represents the path from the top-level form to this control.
@@ -4467,7 +4456,49 @@ declare class NgForm extends ControlContainer implements Form, AfterViewInit {
     private _setUpdateStrategy;
     private _findContainer;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgForm, [{ optional: true; self: true; }, { optional: true; self: true; }, { optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForm, "form:not([ngNoForm]):not([formGroup]),ng-form,[ngForm]", ["ngForm"], { "options": { "alias": "ngFormOptions"; "required": false; }; }, { "ngSubmit": "ngSubmit"; }, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForm, "form:not([ngNoForm]):not([formGroup]):not([formArray]),ng-form,[ngForm]", ["ngForm"], { "options": { "alias": "ngFormOptions"; "required": false; }; }, { "ngSubmit": "ngSubmit"; }, never, never, false, never>;
+}
+
+/**
+ * @description
+ *
+ * Binds an existing `FormArray` to a DOM element.
+ *
+ * This directive accepts an existing `FormArray` instance. It will then use this
+ * `FormArray` instance to match any child `FormControl`, `FormGroup`/`FormRecord`,
+ * and `FormArray` instances to child `FormControlName`, `FormGroupName`,
+ * and `FormArrayName` directives.
+ *
+ * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see {@link AbstractControl}
+ *
+ * @usageNotes
+ * ### Register Form Array
+ *
+ * The following example registers a `FormArray` with first name and last name controls,
+ * and listens for the *ngSubmit* event when the button is clicked.
+ *
+ * @ngModule ReactiveFormsModule
+ * @publicApi
+ */
+declare class FormArrayDirective extends AbstractFormDirective {
+    /**
+     * @description
+     * Tracks the `FormArray` bound to this directive.
+     */
+    form: FormArray;
+    /**
+     * @description
+     * Emits an event when the form submission has been triggered.
+     */
+    ngSubmit: EventEmitter<any>;
+    /**
+     * @description
+     * Returns the `FormArray` bound to this directive.
+     */
+    get control(): FormArray;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormArrayDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FormArrayDirective, "[formArray]", ["ngForm"], { "form": { "alias": "formArray"; "required": false; }; }, { "ngSubmit": "ngSubmit"; }, never, never, false, never>;
 }
 
 /**
@@ -4541,6 +4572,50 @@ declare class FormControlDirective extends NgControl implements OnChanges, OnDes
     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>;
 }
 
+/**
+ * @description
+ *
+ * Binds an existing `FormGroup` or `FormRecord` to a DOM element.
+ *
+ * This directive accepts an existing `FormGroup` instance. It will then use this
+ * `FormGroup` instance to match any child `FormControl`, `FormGroup`/`FormRecord`,
+ * and `FormArray` instances to child `FormControlName`, `FormGroupName`,
+ * and `FormArrayName` directives.
+ *
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
+ * @see {@link AbstractControl}
+ *
+ * @usageNotes
+ * ### Register Form Group
+ *
+ * The following example registers a `FormGroup` with first name and last name controls,
+ * and listens for the *ngSubmit* event when the button is clicked.
+ *
+ * {@example forms/ts/simpleFormGroup/simple_form_group_example.ts region='Component'}
+ *
+ * @ngModule ReactiveFormsModule
+ * @publicApi
+ */
+declare class FormGroupDirective extends AbstractFormDirective {
+    /**
+     * @description
+     * Tracks the `FormGroup` bound to this directive.
+     */
+    form: FormGroup;
+    /**
+     * @description
+     * Emits an event when the form submission has been triggered.
+     */
+    ngSubmit: EventEmitter<any>;
+    /**
+     * @description
+     * Returns the `FormGroup` bound to this directive.
+     */
+    get control(): FormGroup;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormGroupDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FormGroupDirective, "[formGroup]", ["ngForm"], { "form": { "alias": "formGroup"; "required": false; }; }, { "ngSubmit": "ngSubmit"; }, never, never, false, never>;
+}
+
 /**
  * Internal module used for sharing directives between FormsModule and ReactiveFormsModule
  */
@@ -5235,9 +5310,9 @@ declare class ReactiveFormsModule {
         callSetDisabledState?: SetDisabledStateOption;
     }): ModuleWithProviders<ReactiveFormsModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ReactiveFormsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<ReactiveFormsModule, [typeof FormControlDirective, typeof FormGroupDirective, typeof FormControlName, typeof FormGroupName, typeof FormArrayName], never, [typeof ɵInternalFormsSharedModule, typeof FormControlDirective, typeof FormGroupDirective, typeof FormControlName, typeof FormGroupName, typeof FormArrayName]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ReactiveFormsModule, [typeof FormControlDirective, typeof FormGroupDirective, typeof FormArrayDirective, typeof FormControlName, typeof FormGroupName, typeof FormArrayName], never, [typeof ɵInternalFormsSharedModule, typeof FormControlDirective, typeof FormGroupDirective, typeof FormArrayDirective, typeof FormControlName, typeof FormGroupName, typeof FormArrayName]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<ReactiveFormsModule>;
 }
 
-export { AbstractControl, AbstractControlDirective, AbstractFormGroupDirective, COMPOSITION_BUFFER_MODE, CheckboxControlValueAccessor, CheckboxRequiredValidator, ControlContainer, ControlEvent, DefaultValueAccessor, EmailValidator, FormArray, 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 { 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/forms",
-  "version": "20.2.3",
+  "version": "21.0.0-next.1",
   "description": "Angular - directives and services for creating forms",
   "author": "angular",
   "license": "MIT",
@@ -11,9 +11,9 @@
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@angular/core": "20.2.3",
-    "@angular/common": "20.2.3",
-    "@angular/platform-browser": "20.2.3",
+    "@angular/core": "21.0.0-next.1",
+    "@angular/common": "21.0.0-next.1",
+    "@angular/platform-browser": "21.0.0-next.1",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {