@angular/forms 21.2.0-next.2 → 21.2.0-rc.0

package/types/_structure-chunk.d.ts

@@ -1,249 +1,58 @@
 /**
- * @license Angular v21.2.0-next.2
+ * @license Angular v21.2.0-rc.0
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
 import * as i0 from '@angular/core';
-import { Signal, WritableSignal, InjectionToken, Injector, Provider } from '@angular/core';
-import * as _angular_forms from '@angular/forms';
+import { WritableSignal, Signal, InjectionToken, Injector, Provider } from '@angular/core';
 import { AbstractControl, ValidationErrors, FormControlStatus, ControlValueAccessor, ValidatorFn } from '@angular/forms';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
 /**
- * Sets a value for the {@link MetadataKey} for this field.
- *
- * This value is combined via a reduce operation defined by the particular key,
- * since multiple rules in the schema might set values for it.
- *
- * @param path The target path to set the metadata for.
- * @param key The metadata key
- * @param logic A function that receives the `FieldContext` and returns a value for the metadata.
- * @template TValue The type of value stored in the field the logic is bound to.
- * @template TKey The type of metadata key.
- * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
- *
- * @category logic
- * @experimental 21.0.0
- */
-declare function metadata<TValue, TKey extends MetadataKey<any, any, any>, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, key: TKey, logic: NoInfer<LogicFn<TValue, MetadataSetterType<TKey>, TPathKind>>): TKey;
-/**
- * A reducer that determines the accumulated value for a metadata key by reducing the individual
- * values contributed from `metadata()` rules.
- *
- * @template TAcc The accumulated type of the reduce operation.
- * @template TItem The type of the individual items that are reduced over.
- * @experimental 21.0.2
- */
-interface MetadataReducer<TAcc, TItem> {
-    /** The reduce function. */
-    reduce: (acc: TAcc, item: TItem) => TAcc;
-    /** Gets the initial accumulated value. */
-    getInitial: () => TAcc;
-}
-declare const MetadataReducer: {
-    /** Creates a reducer that accumulates a list of its individual item values. */
-    readonly list: <TItem>() => MetadataReducer<TItem[], TItem | undefined>;
-    /** Creates a reducer that accumulates the min of its individual item values. */
-    readonly min: () => MetadataReducer<number | undefined, number | undefined>;
-    /** Creates a reducer that accumulates a the max of its individual item values. */
-    readonly max: () => MetadataReducer<number | undefined, number | undefined>;
-    /** Creates a reducer that logically or's its accumulated value with each individual item value. */
-    readonly or: () => MetadataReducer<boolean, boolean>;
-    /** Creates a reducer that logically and's its accumulated value with each individual item value. */
-    readonly and: () => MetadataReducer<boolean, boolean>;
-    /** Creates a reducer that always takes the next individual item value as the accumulated value. */
-    readonly override: typeof override;
-};
-declare function override<T>(): MetadataReducer<T | undefined, T>;
-declare function override<T>(getInitial: () => T): MetadataReducer<T, T>;
-/**
- * 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
- * `metadata` rule in the schema. There may be multiple rules in a schema that contribute
- * values to the same `MetadataKey` of the same field.
- *
- * @template TRead The type read from the `FieldState` for this key
- * @template TWrite The type written to this key using the `metadata()` rule
- * @template TAcc The type of the reducer's accumulated value.
- *
- * @experimental 21.0.0
- */
-declare class MetadataKey<TRead, TWrite, TAcc> {
-    readonly reducer: MetadataReducer<TAcc, TWrite>;
-    readonly create: ((s: Signal<TAcc>) => TRead) | undefined;
-    private brand;
-    /** Use {@link reducedMetadataKey}. */
-    protected constructor(reducer: MetadataReducer<TAcc, TWrite>, create: ((s: Signal<TAcc>) => TRead) | undefined);
-}
-/**
- * Extracts the the type that can be set into the given metadata key type using the `metadata()` rule.
- *
- * @template TKey The `MetadataKey` type
- *
- * @experimental 21.0.0
- */
-type MetadataSetterType<TKey> = TKey extends MetadataKey<any, infer TWrite, any> ? TWrite : never;
-/**
- * Creates a metadata key used to contain a computed value.
- * The last value set on a given field tree node overrides any previously set values.
- *
- * @template TWrite The type written to this key using the `metadata()` rule
- *
- * @experimental 21.0.0
- */
-declare function createMetadataKey<TWrite>(): MetadataKey<Signal<TWrite | undefined>, TWrite, TWrite | undefined>;
-/**
- * Creates a metadata key used to contain a computed value.
- *
- * @param reducer The reducer used to combine individually set values into the final computed value.
- * @template TWrite The type written to this key using the `metadata()` rule
- * @template TAcc The type of the reducer's accumulated value.
- *
- * @experimental 21.0.0
- */
-declare function createMetadataKey<TWrite, TAcc>(reducer: MetadataReducer<TAcc, TWrite>): MetadataKey<Signal<TAcc>, TWrite, TAcc>;
-/**
- * Creates a metadata key that exposes a managed value based on the accumulated result of the values
- * written to the key. The accumulated value takes the last value set on a given field tree node,
- * overriding any previously set values.
- *
- * @param create A function that receives a signal of the accumulated value and returns the managed
- *   value based on it. This function runs during the construction of the `FieldTree` node,
- *   and runs in the injection context of that node.
- * @template TRead The type read from the `FieldState` for this key
- * @template TWrite The type written to this key using the `metadata()` rule
- *
- * @experimental 21.0.0
- */
-declare function createManagedMetadataKey<TRead, TWrite>(create: (s: 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.
- *
- * @param create A function that receives a signal of the accumulated value and returns the managed
- *   value based on it. This function runs during the construction of the `FieldTree` node,
- *   and runs in the injection context of that node.
- * @param reducer The reducer used to combine individual value written to the key,
- *   this will determine the accumulated value that the create function receives.
- * @template TRead The type read from the `FieldState` for this key
- * @template TWrite The type written to this key using the `metadata()` rule
- * @template TAcc The type of the reducer's accumulated value.
- *
- * @experimental 21.0.0
- */
-declare function createManagedMetadataKey<TRead, TWrite, TAcc>(create: (s: Signal<TAcc>) => TRead, reducer: MetadataReducer<TAcc, TWrite>): MetadataKey<TRead, TWrite, TAcc>;
-/**
- * A {@link MetadataKey} representing whether the field is required.
- *
- * @category validation
- * @experimental 21.0.0
- */
-declare const REQUIRED: MetadataKey<Signal<boolean>, boolean, boolean>;
-/**
- * A {@link MetadataKey} representing the min value of the field.
- *
- * @category validation
- * @experimental 21.0.0
- */
-declare const MIN: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
-/**
- * A {@link MetadataKey} representing the max value of the field.
- *
- * @category validation
- * @experimental 21.0.0
- */
-declare const MAX: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
-/**
- * A {@link MetadataKey} representing the min length of the field.
- *
- * @category validation
- * @experimental 21.0.0
- */
-declare const MIN_LENGTH: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
-/**
- * A {@link MetadataKey} representing the max length of the field.
- *
- * @category validation
- * @experimental 21.0.0
- */
-declare const MAX_LENGTH: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
-/**
- * A {@link MetadataKey} representing the patterns the field must match.
- *
- * @category validation
- * @experimental 21.0.0
- */
-declare const PATTERN: MetadataKey<Signal<RegExp[]>, RegExp | undefined, RegExp[]>;
-
-/**
- * Utility type that removes a string index key when its value is `unknown`,
- * i.e. `{[key: string]: unknown}`. It allows specific string keys to pass through, even if their
- * value is `unknown`, e.g. `{key: unknown}`.
- *
- * @experimental 21.0.0
- */
-type RemoveStringIndexUnknownKey<K, V> = string extends K ? unknown extends V ? never : K : K;
-/**
- * Utility type that recursively ignores unknown string index properties on the given object.
- * We use this on the `TSchema` type in `validateStandardSchema` in order to accommodate Zod's
- * `looseObject` which includes `{[key: string]: unknown}` as part of the type.
- *
- * @experimental 21.0.0
- */
-type IgnoreUnknownProperties<T> = T extends Record<PropertyKey, unknown> ? {
-    [K in keyof T as RemoveStringIndexUnknownKey<K, T[K]>]: IgnoreUnknownProperties<T[K]>;
-} : T;
-/**
- * Validates a field using a `StandardSchemaV1` compatible validator (e.g. a Zod validator).
- *
- * See https://github.com/standard-schema/standard-schema for more about standard schema.
- *
- * @param path The `FieldPath` to the field to validate.
- * @param schema The standard schema compatible validator to use for validation.
- * @template TSchema The type validated by the schema. This may be either the full `TValue` type,
- *   or a partial of it.
- * @template TValue The type of value stored in the field being validated.
- *
- * @see [Signal Form Schema Validation](guide/forms/signals/validation#integration-with-schema-validation-libraries)
- * @category validation
- * @experimental 21.0.0
- */
-declare function validateStandardSchema<TSchema, TModel extends IgnoreUnknownProperties<TSchema>>(path: SchemaPath<TModel> & SchemaPathTree<TModel>, schema: StandardSchemaV1<TSchema>): void;
-/**
- * Create a standard schema issue error associated with the target field
- * @param issue The standard schema issue
- * @param options The validation error options
- *
- * @category validation
- * @experimental 21.0.0
- */
-declare function standardSchemaError(issue: StandardSchemaV1.Issue, options: WithFieldTree<ValidationErrorOptions>): StandardSchemaValidationError;
-/**
- * Create a standard schema issue error
- * @param issue The standard schema issue
- * @param options The optional validation error options
- *
- * @category validation
- * @experimental 21.0.0
+ * Symbol used to retain generic type information when it would otherwise be lost.
  */
-declare function standardSchemaError(issue: StandardSchemaV1.Issue, options?: ValidationErrorOptions): WithoutFieldTree<StandardSchemaValidationError>;
+declare const ɵɵTYPE: unique symbol;
 /**
- * An error used to indicate an issue validating against a standard schema.
+ * Options that can be specified when submitting a form.
  *
- * @category validation
- * @experimental 21.0.0
+ * @experimental 21.2.0
  */
-declare class StandardSchemaValidationError extends BaseNgValidationError {
-    readonly issue: StandardSchemaV1.Issue;
-    readonly kind = "standardSchema";
-    constructor(issue: StandardSchemaV1.Issue, options?: ValidationErrorOptions);
+interface FormSubmitOptions<TRootModel, TSubmittedModel> {
+    /**
+     * Function to run when submitting the form data (when form is valid).
+     *
+     * @param field The contextually relevant field for this action function (the root field when
+     *   specified during form creation, and the submitted field when specified as part of the
+     *   `submit()` call)
+     * @param detail An object containing the root field of the submitted form as well as the
+     *   submitted field itself
+     */
+    action: (field: FieldTree<TRootModel & TSubmittedModel>, detail: {
+        root: FieldTree<TRootModel>;
+        submitted: FieldTree<TSubmittedModel>;
+    }) => Promise<TreeValidationResult>;
+    /**
+     * Function to run when attempting to submit the form data but validation is failing.
+     *
+     * @param field The contextually relevant field for this onInvalid function (the root field when
+     *   specified during form creation, and the submitted field when specified as part of the
+     *   `submit()` call)
+     * @param detail An object containing the root field of the submitted form as well as the
+     *   submitted field itself
+     */
+    onInvalid?: (field: FieldTree<TRootModel & TSubmittedModel>, detail: {
+        root: FieldTree<TRootModel>;
+        submitted: FieldTree<TSubmittedModel>;
+    }) => void;
+    /**
+     * 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
+     */
+    ignoreValidators?: 'pending' | 'none' | 'all';
 }
-
-/**
- * Symbol used to retain generic type information when it would otherwise be lost.
- */
-declare const ɵɵTYPE: unique symbol;
 /**
  * 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).
@@ -343,6 +152,16 @@ type ValidationResult<E extends ValidationError = ValidationError> = ValidationS
  * @experimental 21.0.0
  */
 type AsyncValidationResult<E extends ValidationError = ValidationError> = ValidationResult<E> | 'pending';
+/**
+ * A field accessor function that returns the state of the field.
+ *
+ * @template TValue The type of the value stored in the field.
+ * @template TKey The type of the property key which this field resides under in its parent.
+ *
+ * @category types
+ * @experimental 21.2.0
+ */
+type Field<TValue, TKey extends string | number = string | number> = () => FieldState<TValue, TKey>;
 /**
  * An object that represents a tree of fields in a form. This includes both primitive value fields
  * (e.g. fields that contain a `string` or `number`), as well as "grouping fields" that contain
@@ -398,6 +217,10 @@ type MaybeFieldTree<TModel, TKey extends string | number = string | number> = (T
  * @experimental 21.0.0
  */
 interface FieldState<TValue, TKey extends string | number = string | number> {
+    /**
+     * The {@link FieldTree} associated with this field state.
+     */
+    readonly fieldTree: FieldTree<unknown, TKey>;
     /**
      * A writable signal containing the value for this field.
      *
@@ -823,6 +646,236 @@ type ItemType<T extends Object> = T extends ReadonlyArray<any> ? T[number] : T[k
  */
 type Debouncer<TValue, TPathKind extends PathKind = PathKind.Root> = (context: FieldContext<TValue, TPathKind>, abortSignal: AbortSignal) => Promise<void> | void;
 
+/**
+ * Sets a value for the {@link MetadataKey} for this field.
+ *
+ * This value is combined via a reduce operation defined by the particular key,
+ * since multiple rules in the schema might set values for it.
+ *
+ * @param path The target path to set the metadata for.
+ * @param key The metadata key
+ * @param logic A function that receives the `FieldContext` and returns a value for the metadata.
+ * @template TValue The type of value stored in the field the logic is bound to.
+ * @template TKey The type of metadata key.
+ * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
+ *
+ * @category logic
+ * @experimental 21.0.0
+ */
+declare function metadata<TValue, TKey extends MetadataKey<any, any, any>, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, key: TKey, logic: NoInfer<LogicFn<TValue, MetadataSetterType<TKey>, TPathKind>>): TKey;
+/**
+ * A reducer that determines the accumulated value for a metadata key by reducing the individual
+ * values contributed from `metadata()` rules.
+ *
+ * @template TAcc The accumulated type of the reduce operation.
+ * @template TItem The type of the individual items that are reduced over.
+ * @experimental 21.0.2
+ */
+interface MetadataReducer<TAcc, TItem> {
+    /** The reduce function. */
+    reduce: (acc: TAcc, item: TItem) => TAcc;
+    /** Gets the initial accumulated value. */
+    getInitial: () => TAcc;
+}
+declare const MetadataReducer: {
+    /** Creates a reducer that accumulates a list of its individual item values. */
+    readonly list: <TItem>() => MetadataReducer<TItem[], TItem | undefined>;
+    /** Creates a reducer that accumulates the min of its individual item values. */
+    readonly min: () => MetadataReducer<number | undefined, number | undefined>;
+    /** Creates a reducer that accumulates a the max of its individual item values. */
+    readonly max: () => MetadataReducer<number | undefined, number | undefined>;
+    /** Creates a reducer that logically or's its accumulated value with each individual item value. */
+    readonly or: () => MetadataReducer<boolean, boolean>;
+    /** Creates a reducer that logically and's its accumulated value with each individual item value. */
+    readonly and: () => MetadataReducer<boolean, boolean>;
+    /** Creates a reducer that always takes the next individual item value as the accumulated value. */
+    readonly override: typeof override;
+};
+declare function override<T>(): MetadataReducer<T | undefined, T>;
+declare function override<T>(getInitial: () => T): MetadataReducer<T, T>;
+/**
+ * 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
+ * `metadata` rule in the schema. There may be multiple rules in a schema that contribute
+ * values to the same `MetadataKey` of the same field.
+ *
+ * @template TRead The type read from the `FieldState` for this key
+ * @template TWrite The type written to this key using the `metadata()` rule
+ * @template TAcc The type of the reducer's accumulated value.
+ *
+ * @experimental 21.0.0
+ */
+declare class MetadataKey<TRead, TWrite, TAcc> {
+    readonly reducer: MetadataReducer<TAcc, TWrite>;
+    readonly create: ((s: Signal<TAcc>) => TRead) | undefined;
+    private brand;
+    /** Use {@link reducedMetadataKey}. */
+    protected constructor(reducer: MetadataReducer<TAcc, TWrite>, create: ((s: Signal<TAcc>) => TRead) | undefined);
+}
+/**
+ * Extracts the the type that can be set into the given metadata key type using the `metadata()` rule.
+ *
+ * @template TKey The `MetadataKey` type
+ *
+ * @experimental 21.0.0
+ */
+type MetadataSetterType<TKey> = TKey extends MetadataKey<any, infer TWrite, any> ? TWrite : never;
+/**
+ * Creates a metadata key used to contain a computed value.
+ * The last value set on a given field tree node overrides any previously set values.
+ *
+ * @template TWrite The type written to this key using the `metadata()` rule
+ *
+ * @experimental 21.0.0
+ */
+declare function createMetadataKey<TWrite>(): MetadataKey<Signal<TWrite | undefined>, TWrite, TWrite | undefined>;
+/**
+ * Creates a metadata key used to contain a computed value.
+ *
+ * @param reducer The reducer used to combine individually set values into the final computed value.
+ * @template TWrite The type written to this key using the `metadata()` rule
+ * @template TAcc The type of the reducer's accumulated value.
+ *
+ * @experimental 21.0.0
+ */
+declare function createMetadataKey<TWrite, TAcc>(reducer: MetadataReducer<TAcc, TWrite>): MetadataKey<Signal<TAcc>, TWrite, TAcc>;
+/**
+ * Creates a metadata key that exposes a managed value based on the accumulated result of the values
+ * written to the key. The accumulated value takes the last value set on a given field tree node,
+ * overriding any previously set values.
+ *
+ * @param create A function that receives a signal of the accumulated value and returns the managed
+ *   value based on it. This function runs during the construction of the `FieldTree` node,
+ *   and runs in the injection context of that node.
+ * @template TRead The type read from the `FieldState` for this key
+ * @template TWrite The type written to this key using the `metadata()` rule
+ *
+ * @experimental 21.0.0
+ */
+declare function createManagedMetadataKey<TRead, TWrite>(create: (s: 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.
+ *
+ * @param create A function that receives a signal of the accumulated value and returns the managed
+ *   value based on it. This function runs during the construction of the `FieldTree` node,
+ *   and runs in the injection context of that node.
+ * @param reducer The reducer used to combine individual value written to the key,
+ *   this will determine the accumulated value that the create function receives.
+ * @template TRead The type read from the `FieldState` for this key
+ * @template TWrite The type written to this key using the `metadata()` rule
+ * @template TAcc The type of the reducer's accumulated value.
+ *
+ * @experimental 21.0.0
+ */
+declare function createManagedMetadataKey<TRead, TWrite, TAcc>(create: (s: Signal<TAcc>) => TRead, reducer: MetadataReducer<TAcc, TWrite>): MetadataKey<TRead, TWrite, TAcc>;
+/**
+ * A {@link MetadataKey} representing whether the field is required.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare const REQUIRED: MetadataKey<Signal<boolean>, boolean, boolean>;
+/**
+ * A {@link MetadataKey} representing the min value of the field.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare const MIN: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
+/**
+ * A {@link MetadataKey} representing the max value of the field.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare const MAX: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
+/**
+ * A {@link MetadataKey} representing the min length of the field.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare const MIN_LENGTH: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
+/**
+ * A {@link MetadataKey} representing the max length of the field.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare const MAX_LENGTH: MetadataKey<Signal<number | undefined>, number | undefined, number | undefined>;
+/**
+ * A {@link MetadataKey} representing the patterns the field must match.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare const PATTERN: MetadataKey<Signal<RegExp[]>, RegExp | undefined, RegExp[]>;
+
+/**
+ * Utility type that removes a string index key when its value is `unknown`,
+ * i.e. `{[key: string]: unknown}`. It allows specific string keys to pass through, even if their
+ * value is `unknown`, e.g. `{key: unknown}`.
+ *
+ * @experimental 21.0.0
+ */
+type RemoveStringIndexUnknownKey<K, V> = string extends K ? unknown extends V ? never : K : K;
+/**
+ * Utility type that recursively ignores unknown string index properties on the given object.
+ * We use this on the `TSchema` type in `validateStandardSchema` in order to accommodate Zod's
+ * `looseObject` which includes `{[key: string]: unknown}` as part of the type.
+ *
+ * @experimental 21.0.0
+ */
+type IgnoreUnknownProperties<T> = T extends Record<PropertyKey, unknown> ? {
+    [K in keyof T as RemoveStringIndexUnknownKey<K, T[K]>]: IgnoreUnknownProperties<T[K]>;
+} : T;
+/**
+ * Validates a field using a `StandardSchemaV1` compatible validator (e.g. a Zod validator).
+ *
+ * See https://github.com/standard-schema/standard-schema for more about standard schema.
+ *
+ * @param path The `FieldPath` to the field to validate.
+ * @param schema The standard schema compatible validator to use for validation, or a LogicFn that returns the schema.
+ * @template TSchema The type validated by the schema. This may be either the full `TValue` type,
+ *   or a partial of it.
+ * @template TValue The type of value stored in the field being validated.
+ *
+ * @see [Signal Form Schema Validation](guide/forms/signals/validation#integration-with-schema-validation-libraries)
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare function validateStandardSchema<TSchema, TModel extends IgnoreUnknownProperties<TSchema>>(path: SchemaPath<TModel> & SchemaPathTree<TModel>, schema: StandardSchemaV1<TSchema> | LogicFn<TModel, StandardSchemaV1<unknown> | undefined>): void;
+/**
+ * Create a standard schema issue error associated with the target field
+ * @param issue The standard schema issue
+ * @param options The validation error options
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare function standardSchemaError(issue: StandardSchemaV1.Issue, options: WithFieldTree<ValidationErrorOptions>): StandardSchemaValidationError;
+/**
+ * Create a standard schema issue error
+ * @param issue The standard schema issue
+ * @param options The optional validation error options
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare function standardSchemaError(issue: StandardSchemaV1.Issue, options?: ValidationErrorOptions): WithoutFieldTree<StandardSchemaValidationError>;
+/**
+ * An error used to indicate an issue validating against a standard schema.
+ *
+ * @category validation
+ * @experimental 21.0.0
+ */
+declare class StandardSchemaValidationError extends BaseNgValidationError {
+    readonly issue: StandardSchemaV1.Issue;
+    readonly kind = "standardSchema";
+    constructor(issue: StandardSchemaV1.Issue, options?: ValidationErrorOptions);
+}
+
 /**
  * Represents a combination of `NgControl` and `AbstractControl`.
  *
@@ -884,10 +937,6 @@ interface FormFieldBindingOptions {
      * asked to focus this binding.
      */
     readonly focus?: (focusOptions?: FocusOptions) => void;
-    /**
-     * Source of parse errors for this binding.
-     */
-    readonly parseErrors?: Signal<ValidationError.WithoutFieldTree[]>;
 }
 /**
  * Lightweight DI token provided by the {@link FormField} directive.
@@ -916,11 +965,11 @@ declare const FORM_FIELD: InjectionToken<FormField<unknown>>;
  * @experimental 21.0.0
  */
 declare class FormField<T> {
-    readonly fieldTree: i0.InputSignal<FieldTree<T>>;
+    readonly field: i0.InputSignal<Field<T>>;
     /**
      * `FieldState` for the currently bound field.
      */
-    readonly state: Signal<[T] extends [_angular_forms.AbstractControl<any, any, any>] ? CompatFieldState<T, string | number> : FieldState<T, string | number>>;
+    readonly state: Signal<FieldState<T, string | number>>;
     /**
      * The node injector for the element this field binding.
      */
@@ -975,7 +1024,7 @@ declare class FormField<T> {
      */
     readonly [ɵNgFieldDirective]: true;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormField<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<FormField<any>, "[formField]", ["formField"], { "fieldTree": { "alias": "formField"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FormField<any>, "[formField]", ["formField"], { "field": { "alias": "formField"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -1293,6 +1342,15 @@ declare class PatternValidationError extends BaseNgValidationError {
 declare class EmailValidationError extends BaseNgValidationError {
     readonly kind = "email";
 }
+/**
+ * An error used to indicate that a value entered in a native input does not parse.
+ *
+ * @category validation
+ * @experimental 21.2.0
+ */
+declare class NativeInputParseError extends BaseNgValidationError {
+    readonly kind = "parse";
+}
 /**
  * The base class for all built-in, non-custom errors. This class can be used to check if an error
  * is one of the standard kinds, allowing you to switch on the kind to further narrow the type.
@@ -1319,7 +1377,7 @@ declare class EmailValidationError extends BaseNgValidationError {
  * @experimental 21.0.0
  */
 declare const NgValidationError: abstract new () => NgValidationError;
-type NgValidationError = RequiredValidationError | MinValidationError | MaxValidationError | MinLengthValidationError | MaxLengthValidationError | PatternValidationError | EmailValidationError | StandardSchemaValidationError;
+type NgValidationError = RequiredValidationError | MinValidationError | MaxValidationError | MinLengthValidationError | MaxLengthValidationError | PatternValidationError | EmailValidationError | StandardSchemaValidationError | NativeInputParseError;
 
 /**
  * Configuration options for signal forms.
@@ -1339,24 +1397,6 @@ interface SignalFormsConfig {
  */
 declare function provideSignalFormsConfig(config: SignalFormsConfig): Provider[];
 
-/**
- * Options that can be specified when submitting a form.
- *
- * @experimental 21.2.0
- */
-interface FormSubmitOptions<TModel> {
-    /** Function to run when submitting the form data (when form is valid). */
-    action: (form: FieldTree<TModel>) => Promise<TreeValidationResult>;
-    /** Function to run when attempting to submit the form data but validation is failing. */
-    onInvalid?: (form: FieldTree<TModel>) => void;
-    /**
-     * 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
-     */
-    ignoreValidators?: 'pending' | 'none' | 'all';
-}
 /**
  * Options that may be specified when creating a form.
  *
@@ -1372,7 +1412,7 @@ interface FormOptions<TModel> {
     /** The name of the root form, used in generating name attributes for the fields. */
     name?: string;
     /** Options that define how to handle form submission. */
-    submission?: FormSubmitOptions<TModel>;
+    submission?: FormSubmitOptions<TModel, unknown>;
 }
 /**
  * Creates a form wrapped around the given model data. A form is represented as simply a `FieldTree`
@@ -1613,8 +1653,8 @@ declare function applyWhenValue<TValue>(path: SchemaPath<TValue>, predicate: (va
  * @category submission
  * @experimental 21.0.0
  */
-declare function submit<TModel>(form: FieldTree<TModel>, options?: FormSubmitOptions<TModel>): Promise<boolean>;
-declare function submit<TModel>(form: FieldTree<TModel>, action: FormSubmitOptions<TModel>['action']): Promise<boolean>;
+declare function submit<TModel>(form: FieldTree<TModel>, options?: NoInfer<FormSubmitOptions<unknown, TModel>>): Promise<boolean>;
+declare function submit<TModel>(form: FieldTree<TModel>, action: NoInfer<FormSubmitOptions<unknown, TModel>['action']>): Promise<boolean>;
 /**
  * Creates a `Schema` that adds logic rules to a form.
  * @param fn A **non-reactive** function that sets up reactive logic rules for the form.
@@ -1626,5 +1666,5 @@ declare function submit<TModel>(form: FieldTree<TModel>, action: FormSubmitOptio
  */
 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, 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, FieldContext, FieldState, FieldTree, FieldValidator, FormFieldBindingOptions, FormOptions, FormSubmitOptions, IgnoreUnknownProperties, ItemFieldContext, ItemType, LogicFn, MaybeFieldTree, MaybeSchemaPathTree, MetadataSetterType, OneOrMany, ReadonlyArrayLike, RemoveStringIndexUnknownKey, RootFieldContext, Schema, SchemaFn, SchemaOrSchemaFn, SchemaPath, SchemaPathTree, SignalFormsConfig, Subfields, TreeValidationResult, TreeValidator, ValidationErrorOptions, ValidationResult, ValidationSuccess, Validator, WithField, WithFieldTree, WithOptionalField, WithOptionalFieldTree, WithoutField, WithoutFieldTree };
+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, FieldTree, FieldValidator, FormFieldBindingOptions, FormOptions, FormSubmitOptions, IgnoreUnknownProperties, ItemFieldContext, ItemType, LogicFn, MaybeFieldTree, MaybeSchemaPathTree, MetadataSetterType, OneOrMany, ReadonlyArrayLike, RemoveStringIndexUnknownKey, RootFieldContext, Schema, SchemaFn, SchemaOrSchemaFn, SchemaPath, SchemaPathTree, SignalFormsConfig, Subfields, TreeValidationResult, TreeValidator, ValidationErrorOptions, ValidationResult, ValidationSuccess, Validator, WithField, WithFieldTree, WithOptionalField, WithOptionalFieldTree, WithoutField, WithoutFieldTree };

package/types/forms.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.2.0-next.2
+ * @license Angular v21.2.0-rc.0
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */