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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/forms",
-  "version": "22.0.0-next.4",
+  "version": "22.0.0-next.5",
   "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.4",
-    "@angular/common": "22.0.0-next.4",
-    "@angular/platform-browser": "22.0.0-next.4",
+    "@angular/core": "22.0.0-next.5",
+    "@angular/common": "22.0.0-next.5",
+    "@angular/platform-browser": "22.0.0-next.5",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {

package/types/_structure-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v22.0.0-next.4
+ * @license Angular v22.0.0-next.5
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -49,7 +49,7 @@ interface FormSubmitOptions<TRootModel, TSubmittedModel> {
      * Whether to ignore any of the validators when submitting:
      * - 'pending': Will submit if there are no invalid validators, pending validators do not block submission (default)
      * - 'none': Will not submit unless all validators are passing, pending validators block submission
-     * - 'ignore': Will always submit regardless of invalid or pending validators
+     * - 'all': Will always submit regardless of invalid or pending validators
      */
     ignoreValidators?: 'pending' | 'none' | 'all';
 }
@@ -276,25 +276,25 @@ interface ReadonlyFieldState<TValue, TKey extends string | number = string | num
      *
      * Applies to `<input>` with a numeric or date `type` attribute and custom controls.
      */
-    readonly max?: Signal<number | undefined>;
+    readonly max: Signal<number | undefined> | undefined;
     /**
      * A signal indicating the field's maximum string length, if applicable.
      *
      * Applies to `<input>`, `<textarea>`, and custom controls.
      */
-    readonly maxLength?: Signal<number | undefined>;
+    readonly maxLength: Signal<number | undefined> | undefined;
     /**
      * A signal indicating the field's minimum value, if applicable.
      *
      * Applies to `<input>` with a numeric or date `type` attribute and custom controls.
      */
-    readonly min?: Signal<number | undefined>;
+    readonly min: Signal<number | undefined> | undefined;
     /**
      * A signal indicating the field's minimum string length, if applicable.
      *
      * Applies to `<input>`, `<textarea>`, and custom controls.
      */
-    readonly minLength?: Signal<number | undefined>;
+    readonly minLength: Signal<number | undefined> | undefined;
     /**
      * A signal of a unique name for the field, by default based on the name of its parent field.
      */
@@ -437,6 +437,16 @@ interface FieldState<TValue, TKey extends string | number = string | number> ext
      * @param options Options for marking the field as touched.
      */
     markAsTouched(options?: MarkAsTouchedOptions): void;
+    /**
+     * Gets the first validation error of the given kind on this field.
+     *
+     * This method is reactive and will re-evaluate when the field's errors change if called
+     * within a reactive context (e.g. `computed` or `effect`).
+     *
+     * @param kind The kind of error (e.g. 'required', 'min').
+     * @returns The first matching error, or `undefined` if none.
+     */
+    getError(kind: string): ValidationError.WithFieldTree | undefined;
     /**
      * Resets the {@link touched} and {@link dirty} state of the field and its descendants.
      *
@@ -445,6 +455,10 @@ interface FieldState<TValue, TKey extends string | number = string | number> ext
      * @param value Optional value to set to the form. If not passed, the value will not be changed.
      */
     reset(value?: TValue): void;
+    /**
+     * Reloads all asynchronous validators for this field and its descendants.
+     */
+    reloadValidation(): void;
 }
 /**
  * This is FieldState also providing access to the wrapped FormControl.
@@ -805,6 +819,13 @@ declare const MetadataReducer: {
 };
 declare function override<T>(): MetadataReducer<T | undefined, T>;
 declare function override<T>(getInitial: () => T): MetadataReducer<T, T>;
+/**
+ * A symbol used to tag a `MetadataKey` as representing an asynchronous validation resource.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare const IS_ASYNC_VALIDATION_RESOURCE: unique symbol;
 /**
  * Represents metadata that is aggregated from multiple parts according to the key's reducer
  * function. A value can be contributed to the aggregated value for a field using an
@@ -819,10 +840,10 @@ declare function override<T>(getInitial: () => T): MetadataReducer<T, T>;
  */
 declare class MetadataKey<TRead, TWrite, TAcc> {
     readonly reducer: MetadataReducer<TAcc, TWrite>;
-    readonly create: ((s: Signal<TAcc>) => TRead) | undefined;
+    readonly create: ((state: FieldState<unknown>, data: Signal<TAcc>) => TRead) | undefined;
     private brand;
     /** Use {@link reducedMetadataKey}. */
-    protected constructor(reducer: MetadataReducer<TAcc, TWrite>, create: ((s: Signal<TAcc>) => TRead) | undefined);
+    protected constructor(reducer: MetadataReducer<TAcc, TWrite>, create: ((state: FieldState<unknown>, data: Signal<TAcc>) => TRead) | undefined);
 }
 /**
  * Extracts the the type that can be set into the given metadata key type using the `metadata()` rule.
@@ -864,7 +885,7 @@ declare function createMetadataKey<TWrite, TAcc>(reducer: MetadataReducer<TAcc,
  *
  * @experimental 21.0.0
  */
-declare function createManagedMetadataKey<TRead, TWrite>(create: (s: Signal<TWrite | undefined>) => TRead): MetadataKey<TRead, TWrite, TWrite | undefined>;
+declare function createManagedMetadataKey<TRead, TWrite>(create: (state: FieldState<unknown>, data: Signal<TWrite | undefined>) => TRead): MetadataKey<TRead, TWrite, TWrite | undefined>;
 /**
  * Creates a metadata key that exposes a managed value based on the accumulated result of the values
  * written to the key.
@@ -880,7 +901,7 @@ declare function createManagedMetadataKey<TRead, TWrite>(create: (s: Signal<TWri
  *
  * @experimental 21.0.0
  */
-declare function createManagedMetadataKey<TRead, TWrite, TAcc>(create: (s: Signal<TAcc>) => TRead, reducer: MetadataReducer<TAcc, TWrite>): MetadataKey<TRead, TWrite, TAcc>;
+declare function createManagedMetadataKey<TRead, TWrite, TAcc>(create: (state: FieldState<unknown>, data: Signal<TAcc>) => TRead, reducer: MetadataReducer<TAcc, TWrite>): MetadataKey<TRead, TWrite, TAcc>;
 /**
  * A {@link MetadataKey} representing whether the field is required.
  *
@@ -1103,6 +1124,7 @@ declare class FormField<T> {
     /** Any `ControlValueAccessor` instances provided on the host element. */
     private readonly controlValueAccessors;
     private readonly config;
+    private readonly validityMonitor;
     private readonly parseErrorsSource;
     /** A lazily instantiated fake `NgControl`. */
     private _interopNgControl;
@@ -1775,5 +1797,5 @@ 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 { BaseNgValidationError, EmailValidationError, FORM_FIELD, FormField, IS_ASYNC_VALIDATION_RESOURCE, 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, 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,5 +1,5 @@
 /**
- * @license Angular v22.0.0-next.4
+ * @license Angular v22.0.0-next.5
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */

package/types/signals-compat.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v22.0.0-next.4
+ * @license Angular v22.0.0-next.5
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */

package/types/signals.d.ts

@@ -1,13 +1,13 @@
 /**
- * @license Angular v22.0.0-next.4
+ * @license Angular v22.0.0-next.5
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
 import * as i0 from '@angular/core';
-import { Signal, ResourceRef, InputSignal, InputSignalWithTransform, OutputRef, ModelSignal, WritableSignal } from '@angular/core';
+import { DebounceTimer, 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, 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';
+export { AsyncValidationResult, BaseNgValidationError, ChildFieldContext, CompatFieldState, CompatSchemaPath, EmailValidationError, FORM_FIELD, Field, FieldState, FieldStateByMode, FormField, FormFieldBinding, FormFieldBindingOptions, FormOptions, FormSubmitOptions, IS_ASYNC_VALIDATION_RESOURCE, 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';
@@ -267,6 +267,11 @@ interface AsyncValidatorOptions<TValue, TParams, TResult, TPathKind extends Path
      * @returns The params for the resource.
      */
     readonly params: (ctx: FieldContext<TValue, TPathKind>) => TParams;
+    /**
+     * Duration in milliseconds to wait before triggering the async operation, or a function that
+     * returns a promise that resolves when the update should proceed.
+     */
+    readonly debounce?: DebounceTimer<TParams | undefined>;
     /**
      * A function that receives the resource params and returns a resource of the given params.
      * The given params should be used as is to create the resource.
@@ -352,6 +357,11 @@ interface HttpValidatorOptions<TValue, TResult, TPathKind extends PathKind = Pat
      * The options to use when creating the httpResource.
      */
     readonly options?: HttpResourceOptions<TResult, unknown>;
+    /**
+     * Duration in milliseconds to wait before triggering the async operation, or a function that
+     * returns a promise that resolves when the update should proceed.
+     */
+    readonly debounce?: DebounceTimer<string | HttpResourceRequest | undefined>;
 }
 /**
  * Adds async validation to the field corresponding to the given path based on an httpResource.
@@ -644,7 +654,7 @@ declare function transformedValue<TValue, TRaw>(value: ModelSignal<TValue>, opti
  * It automatically:
  * 1. Sets `novalidate` on the form element to disable browser validation.
  * 2. Listens for the `submit` event, prevents the default behavior, and calls `submit()` on the
- * `FieldTree`.
+ * `FieldTree` if it defines its own submission options.
  *
  * @usageNotes
  *