@angular/forms 21.0.0-next.3 → 21.0.0-next.5

package/fesm2022/signals.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -1072,6 +1072,7 @@ function assertPathIsCurrent(path) {
  * Represents a property that may be defined on a field when it is created using a `property` rule
  * in the schema. A particular `Property` can only be defined on a particular field **once**.
  *
+ * @category logic
  * @experimental 21.0.0
  */
 class Property {
@@ -1175,36 +1176,42 @@ function andProperty() {
 /**
  * An aggregate property representing whether the field is required.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 const REQUIRED = orProperty();
 /**
  * An aggregate property representing the min value of the field.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 const MIN = maxProperty();
 /**
  * An aggregate property representing the max value of the field.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 const MAX = minProperty();
 /**
  * An aggregate property representing the min length of the field.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 const MIN_LENGTH = maxProperty();
 /**
  * An aggregate property representing the max length of the field.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 const MAX_LENGTH = minProperty();
 /**
  * An aggregate property representing the patterns the field must match.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 const PATTERN = listProperty();
@@ -1219,6 +1226,7 @@ const PATTERN = listProperty();
  * @template TValue The type of value stored in the field the logic is bound to.
  * @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
  */
 function disabled(path, logic) {
@@ -1247,6 +1255,7 @@ function disabled(path, logic) {
  * @template TValue The type of value stored in the field the logic is bound to.
  * @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
  */
 function readonly(path, logic = () => true) {
@@ -1271,6 +1280,7 @@ function readonly(path, logic = () => true) {
  * @template TValue The type of value stored in the field the logic is bound to.
  * @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
  */
 function hidden(path, logic) {
@@ -1286,6 +1296,7 @@ function hidden(path, logic) {
  * @template TValue The type of value stored in the field the logic is bound to.
  * @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
  */
 function validate(path, logic) {
@@ -1302,6 +1313,7 @@ function validate(path, logic) {
  * @template TValue The type of value stored in the field the logic is bound to.
  * @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
  */
 function validateTree(path, logic) {
@@ -1319,6 +1331,7 @@ function validateTree(path, logic) {
  * @template TPropItem The type of value the property aggregates over.
  * @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
  */
 function aggregateProperty(path, prop, logic) {
@@ -1353,6 +1366,7 @@ function property(path, ...rest) {
  * @template TResult The type of result returned by the resource
  * @template TPathKind The kind of path being validated (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function validateAsync(path, opts) {
@@ -1400,6 +1414,7 @@ function validateAsync(path, opts) {
  * @template TResult The type of result returned by the httpResource
  * @template TPathKind The kind of path being validated (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function validateHttp(path, opts) {
@@ -1542,6 +1557,7 @@ function isInputSignal(value) {
  *    forms `NgControl`. This is provided to improve interoperability with controls designed to work
  *    with reactive forms. It should not be used by controls written for signal forms.
  *
+ * @category control
  * @experimental 21.0.0
  */
 class Control {
@@ -1857,15 +1873,15 @@ class Control {
             }
         };
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.0-next.3", ngImport: i0, type: Control, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "21.0.0-next.3", type: Control, isStandalone: true, selector: "[control]", inputs: { _field: ["control", "_field"] }, providers: [
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.0-next.5", ngImport: i0, type: Control, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "21.0.0-next.5", type: Control, isStandalone: true, selector: "[control]", inputs: { _field: ["control", "_field"] }, providers: [
             {
                 provide: NgControl,
                 useFactory: () => inject(Control).ngControl,
             },
         ], ngImport: i0 });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.0-next.3", ngImport: i0, type: Control, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.0-next.5", ngImport: i0, type: Control, decorators: [{
             type: Directive,
             args: [{
                     selector: '[control]',
@@ -2619,14 +2635,12 @@ class FieldNodeState {
      * Marks this specific field as touched.
      */
     markAsTouched() {
-        // TODO: should this be noop for fields that are hidden/disabled/readonly
         this.selfTouched.set(true);
     }
     /**
      * Marks this specific field as dirty.
      */
     markAsDirty() {
-        // TODO: should this be noop for fields that are hidden/disabled/readonly
         this.selfDirty.set(true);
     }
     /**
@@ -2650,20 +2664,24 @@ class FieldNodeState {
      * Whether this field is considered dirty.
      *
      * A field is considered dirty if one of the following is true:
-     *  - It was directly dirtied
+     *  - It was directly dirtied and is interactive
      *  - One of its children is considered dirty
      */
     dirty = computed(() => {
-        return reduceChildren(this.node, this.selfDirty(), (child, value) => value || child.nodeState.dirty(), shortCircuitTrue);
+        const selfDirtyValue = this.selfDirty() && !this.isNonInteractive();
+        return reduceChildren(this.node, selfDirtyValue, (child, value) => value || child.nodeState.dirty(), shortCircuitTrue);
     }, ...(ngDevMode ? [{ debugName: "dirty" }] : []));
     /**
      * Whether this field is considered touched.
      *
      * A field is considered touched if one of the following is true:
-     *  - It was directly touched
+     *  - It was directly touched and is interactive
      *  - One of its children is considered touched
      */
-    touched = computed(() => reduceChildren(this.node, this.selfTouched(), (child, value) => value || child.nodeState.touched(), shortCircuitTrue), ...(ngDevMode ? [{ debugName: "touched" }] : []));
+    touched = computed(() => {
+        const selfTouchedValue = this.selfTouched() && !this.isNonInteractive();
+        return reduceChildren(this.node, selfTouchedValue, (child, value) => value || child.nodeState.touched(), shortCircuitTrue);
+    }, ...(ngDevMode ? [{ debugName: "touched" }] : []));
     /**
      * The reasons for this field's disablement. This includes disabled reasons for any parent field
      * that may have been disabled, indirectly causing this field to be disabled as well.
@@ -2709,6 +2727,14 @@ class FieldNodeState {
         }
         return `${parent.name()}.${this.node.structure.keyInParent()}`;
     }, ...(ngDevMode ? [{ debugName: "name" }] : []));
+    /** Whether this field is considered non-interactive.
+     *
+     * A field is considered non-interactive if one of the following is true:
+     * - It is hidden
+     * - It is disabled
+     * - It is readonly
+     */
+    isNonInteractive = computed(() => this.hidden() || this.disabled() || this.readonly(), ...(ngDevMode ? [{ debugName: "isNonInteractive" }] : []));
 }
 
 /**
@@ -2890,6 +2916,7 @@ function form(...args) {
  * element of the array.
  * @template TValue The data type of the item field to apply the schema to.
  *
+ * @category structure
  * @experimental 21.0.0
  */
 function applyEach(path, schema) {
@@ -2915,6 +2942,7 @@ function applyEach(path, schema) {
  * @param schema The schema to apply to the property
  * @template TValue The data type of the field to apply the schema to.
  *
+ * @category structure
  * @experimental 21.0.0
  */
 function apply(path, schema) {
@@ -2930,6 +2958,7 @@ function apply(path, schema) {
  * @param schema The schema to apply to the field when the `logic` function returns `true`.
  * @template TValue The data type of the field to apply the schema to.
  *
+ * @category structure
  * @experimental 21.0.0
  */
 function applyWhen(path, logic, schema) {
@@ -2971,6 +3000,7 @@ function applyWhenValue(path, predicate, schema) {
  * errors.
  * @template TValue The data type of the field being submitted.
  *
+ * @category submission
  * @experimental 21.0.0
  */
 async function submit(form, action) {
@@ -3020,6 +3050,7 @@ function setServerErrors(submittedField, errors) {
  * @returns A schema object that implements the given logic.
  * @template TValue The value type of a `Field` that this schema binds to.
  *
+ * @category structure
  * @experimental 21.0.0
  */
 function schema(fn) {
@@ -3063,6 +3094,7 @@ function customError(obj) {
 /**
  * A custom error that may contain additional properties
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class CustomValidationError {
@@ -3104,6 +3136,7 @@ class _NgValidationError {
 /**
  * An error used to indicate that a required field is empty.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class RequiredValidationError extends _NgValidationError {
@@ -3112,6 +3145,7 @@ class RequiredValidationError extends _NgValidationError {
 /**
  * An error used to indicate that a value is lower than the minimum allowed.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class MinValidationError extends _NgValidationError {
@@ -3125,6 +3159,7 @@ class MinValidationError extends _NgValidationError {
 /**
  * An error used to indicate that a value is higher than the maximum allowed.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class MaxValidationError extends _NgValidationError {
@@ -3138,6 +3173,7 @@ class MaxValidationError extends _NgValidationError {
 /**
  * An error used to indicate that a value is shorter than the minimum allowed length.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class MinLengthValidationError extends _NgValidationError {
@@ -3151,6 +3187,7 @@ class MinLengthValidationError extends _NgValidationError {
 /**
  * An error used to indicate that a value is longer than the maximum allowed length.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class MaxLengthValidationError extends _NgValidationError {
@@ -3164,6 +3201,7 @@ class MaxLengthValidationError extends _NgValidationError {
 /**
  * An error used to indicate that a value does not match the required pattern.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class PatternValidationError extends _NgValidationError {
@@ -3177,6 +3215,7 @@ class PatternValidationError extends _NgValidationError {
 /**
  * An error used to indicate that a value is not a valid email.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class EmailValidationError extends _NgValidationError {
@@ -3185,6 +3224,7 @@ class EmailValidationError extends _NgValidationError {
 /**
  * An error used to indicate an issue validating against a standard schema.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 class StandardSchemaValidationError extends _NgValidationError {
@@ -3217,6 +3257,7 @@ class StandardSchemaValidationError extends _NgValidationError {
  * }
  * ```
  *
+ * @category validation
  * @experimental 21.0.0
  */
 const NgValidationError = _NgValidationError;
@@ -3288,6 +3329,7 @@ const EMAIL_REGEXP = /^(?=.{1,254}$)(?=.{1,64}@)[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(
  *    or a function that receives the `FieldContext` and returns custom validation error(s).
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function email(path, config) {
@@ -3320,6 +3362,7 @@ function email(path, config) {
  *    or a function that receives the `FieldContext` and returns custom validation error(s).
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function max(path, maxValue, config) {
@@ -3359,6 +3402,7 @@ function max(path, maxValue, config) {
  * @template TValue The type of value stored in the field the logic is bound to.
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function maxLength(path, maxLength, config) {
@@ -3397,6 +3441,7 @@ function maxLength(path, maxLength, config) {
  *    or a function that receives the `FieldContext` and returns custom validation error(s).
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function min(path, minValue, config) {
@@ -3436,6 +3481,7 @@ function min(path, minValue, config) {
  * @template TValue The type of value stored in the field the logic is bound to.
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function minLength(path, minLength, config) {
@@ -3473,6 +3519,7 @@ function minLength(path, minLength, config) {
  *    or a function that receives the `FieldContext` and returns custom validation error(s).
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function pattern(path, pattern, config) {
@@ -3512,6 +3559,7 @@ function pattern(path, pattern, config) {
  * @template TValue The type of value stored in the field the logic is bound to.
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function required(path, config) {
@@ -3541,6 +3589,7 @@ function required(path, config) {
  *   or a partial of it.
  * @template TValue The type of value stored in the field being validated.
  *
+ * @category validation
  * @experimental 21.0.0
  */
 function validateStandardSchema(path, schema) {