@angular/forms 21.0.0-rc.1 → 21.0.0-rc.2

package/package.json

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

package/types/forms.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0-rc.1
+ * @license Angular v21.0.0-rc.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -604,6 +604,8 @@ declare class CheckboxControlValueAccessor extends BuiltInControlValueAccessor i
  * @description
  * Defines the map of errors returned from failed validation checks.
  *
+ * @see [Defining custom validators](guide/forms/form-validation#defining-custom-validators)
+ *
  * @publicApi
  */
 type ValidationErrors = {
@@ -765,6 +767,8 @@ declare class MinValidator extends AbstractValidatorDirective {
  * }
  * ```
  *
+ * @see [Creating asynchronous validators](guide/forms/form-validation#creating-asynchronous-validators)
+ *
  * @publicApi
  */
 interface AsyncValidator extends Validator {
@@ -877,6 +881,8 @@ declare class EmailValidator extends AbstractValidatorDirective {
  * A function that receives a control and synchronously returns a map of
  * validation errors if present, otherwise null.
  *
+ * @see [Defining custom validators](guide/forms/form-validation#defining-custom-validators)
+ *
  * @publicApi
  */
 interface ValidatorFn {
@@ -887,6 +893,8 @@ interface ValidatorFn {
  * A function that receives a control and returns a Promise or observable
  * that emits validation errors if present, otherwise null.
  *
+ * @see [Creating asynchronous validators](guide/forms/form-validation#creating-asynchronous-validators)
+ *
  * @publicApi
  */
 interface AsyncValidatorFn {
@@ -1065,6 +1073,9 @@ type ɵFormArrayRawValue<T extends AbstractControl<any>> = ɵTypedOrUntyped<T, A
  * the `FormArray` directly, as that result in strange and unexpected behavior such
  * as broken change detection.
  *
+ * @see [FormArray: Dynamic, Homogenous Collections](guide/forms/typed-forms#formcontrol-getting-started)
+ * @see [Creating dynamic forms](guide/forms/reactive-forms#creating-dynamic-forms)
+ *
  * @publicApi
  */
 declare class FormArray<TControl extends AbstractControl<any> = any> extends AbstractControl<ɵTypedOrUntyped<TControl, ɵFormArrayValue<TControl>, any>, ɵTypedOrUntyped<TControl, ɵFormArrayRawValue<TControl>, any>> {
@@ -1579,6 +1590,9 @@ interface ɵFormControlCtor {
  * console.log(control.value); // 'Drew'
  * console.log(control.status); // 'DISABLED'
  * ```
+ *
+ * @see [FormControl: Getting Started](guide/forms/typed-forms#formcontrol-getting-started)
+ *
  */
 interface FormControl<TValue = any> extends AbstractControl<TValue> {
     /**
@@ -1868,6 +1882,9 @@ type ɵOptionalKeys<T> = {
  * Notice that `c.value.one` has type `string|null|undefined`. This is because calling `c.reset({})`
  * without providing the optional key `one` will cause it to become `null`.
  *
+ * @see [Grouping form controls](guide/forms/reactive-forms#grouping-form-controls)
+ * @see [FormGroup and FormRecord](guide/forms/typed-forms#formgroup-and-formrecord)
+ *
  * @publicApi
  */
 declare class FormGroup<TControl extends {
@@ -2156,6 +2173,8 @@ declare const isFormGroup: (control: unknown) => control is FormGroup;
  * numbers.removeControl('bill');
  * ```
  *
+ * @see [FormGroup and FormRecord](guide/forms/typed-forms#formgroup-and-formrecord)
+ *
  * @publicApi
  */
 declare class FormRecord<TControl extends AbstractControl = AbstractControl> extends FormGroup<{
@@ -4881,6 +4900,8 @@ declare class FormBuilder {
  * `NonNullableFormBuilder` is similar to {@link FormBuilder}, but automatically constructed
  * {@link FormControl} elements have `{nonNullable: true}` and are non-nullable.
  *
+ * @see [FormBuilder and NonNullableFormBuilder](guide/forms/typed-forms#formbuilder-and-nonnullableformbuilder)
+ *
  * @publicApi
  */
 declare abstract class NonNullableFormBuilder {
@@ -4969,6 +4990,8 @@ declare class UntypedFormBuilder extends FormBuilder {
  * }
  * ```
  *
+ * @see [Defining custom validators](guide/forms/form-validation#defining-custom-validators)
+ *
  * @publicApi
  */
 declare const NG_VALIDATORS: InjectionToken<readonly (Function | Validator)[]>;
@@ -4999,6 +5022,8 @@ declare const NG_VALIDATORS: InjectionToken<readonly (Function | Validator)[]>;
  * }
  * ```
  *
+ * @see [Implementing a custom async validator](guide/forms/form-validation#implementing-a-custom-async-validator)
+ *
  * @publicApi
  */
 declare const NG_ASYNC_VALIDATORS: InjectionToken<readonly (Function | Validator)[]>;