@angular/forms 21.1.0-next.3 → 21.1.0-rc.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License
 
-Copyright (c) 2010-2025 Google LLC. https://angular.dev/license
+Copyright (c) 2010-2026 Google LLC. https://angular.dev/license
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/fesm2022/_structure-chunk.mjs

@@ -1,10 +1,10 @@
 /**
- * @license Angular v21.1.0-next.3
- * (c) 2010-2025 Google LLC. https://angular.dev/
+ * @license Angular v21.1.0-rc.0
+ * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
-import { untracked, computed, runInInjectionContext, Injector, linkedSignal, signal, APP_ID, effect, inject } from '@angular/core';
+import { untracked, ɵRuntimeError as _RuntimeError, computed, runInInjectionContext, Injector, linkedSignal, signal, APP_ID, effect, inject } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { SIGNAL } from '@angular/core/primitives/signals';
 
@@ -384,7 +384,7 @@ function getAllChildBuilders(builder, key) {
       predicates: []
     }] : [])];
   } else {
-    throw new Error('Unknown LogicNodeBuilder type');
+    throw new _RuntimeError(1909, ngDevMode && 'Unknown LogicNodeBuilder type');
   }
 }
 function createLogic(builder, predicates, depth) {
@@ -400,7 +400,7 @@ function createLogic(builder, predicates, depth) {
   } else if (builder instanceof NonMergeableLogicNodeBuilder) {
     logic.mergeIn(builder.logic);
   } else {
-    throw new Error('Unknown LogicNodeBuilder type');
+    throw new _RuntimeError(1909, ngDevMode && 'Unknown LogicNodeBuilder type');
   }
   return logic;
 }
@@ -509,7 +509,7 @@ function isSchemaOrSchemaFn(value) {
 }
 function assertPathIsCurrent(path) {
   if (currentCompilingNode !== FieldPathNode.unwrapFieldPath(path).root) {
-    throw new Error(`A FieldPath can only be used directly within the Schema that owns it,` + ` **not** outside of it or within a sub-schema.`);
+    throw new _RuntimeError(1908, ngDevMode && `A FieldPath can only be used directly within the Schema that owns it, **not** outside of it or within a sub-schema.`);
   }
 }
 
@@ -616,7 +616,7 @@ class FieldValidationState {
     if (this.shouldSkipValidation()) {
       return [];
     }
-    return [...this.node.logicNode.logic.syncErrors.compute(this.node.context), ...this.syncTreeErrors(), ...normalizeErrors(this.node.submitState.serverErrors())];
+    return [...this.node.logicNode.logic.syncErrors.compute(this.node.context), ...this.syncTreeErrors(), ...normalizeErrors(this.node.submitState.submissionErrors())];
   }, ...(ngDevMode ? [{
     debugName: "syncErrors"
   }] : []));
@@ -628,7 +628,7 @@ class FieldValidationState {
   }, ...(ngDevMode ? [{
     debugName: "syncValid"
   }] : []));
-  syncTreeErrors = computed(() => this.rawSyncTreeErrors().filter(err => err.field === this.node.fieldProxy), ...(ngDevMode ? [{
+  syncTreeErrors = computed(() => this.rawSyncTreeErrors().filter(err => err.fieldTree === this.node.fieldProxy), ...(ngDevMode ? [{
     debugName: "syncTreeErrors"
   }] : []));
   rawAsyncErrors = computed(() => {
@@ -643,7 +643,7 @@ class FieldValidationState {
     if (this.shouldSkipValidation()) {
       return [];
     }
-    return this.rawAsyncErrors().filter(err => err === 'pending' || err.field === this.node.fieldProxy);
+    return this.rawAsyncErrors().filter(err => err === 'pending' || err.fieldTree === this.node.fieldProxy);
   }, ...(ngDevMode ? [{
     debugName: "asyncErrors"
   }] : []));
@@ -691,13 +691,13 @@ function normalizeErrors(error) {
   }
   return [error];
 }
-function addDefaultField(errors, field) {
+function addDefaultField(errors, fieldTree) {
   if (isArray(errors)) {
     for (const error of errors) {
-      error.field ??= field;
+      error.fieldTree ??= fieldTree;
     }
   } else if (errors) {
-    errors.field ??= field;
+    errors.fieldTree ??= fieldTree;
   }
   return errors;
 }
@@ -720,13 +720,13 @@ class FieldNodeContext {
           stepsRemaining--;
           field = field.structure.parent;
           if (field === undefined) {
-            throw new Error('Path is not part of this field tree.');
+            throw new _RuntimeError(1900, ngDevMode && 'Path is not part of this field tree.');
           }
         }
         for (let key of targetPathNode.keys) {
           field = field.structure.getChild(key);
           if (field === undefined) {
-            throw new Error(`Cannot resolve path .${targetPathNode.keys.join('.')} relative to field ${['<root>', ...this.node.structure.pathKeys()].join('.')}.`);
+            throw new _RuntimeError(1901, ngDevMode && `Cannot resolve path .${targetPathNode.keys.join('.')} relative to field ${['<root>', ...this.node.structure.pathKeys()].join('.')}.`);
           }
         }
         return field.fieldProxy;
@@ -737,7 +737,7 @@ class FieldNodeContext {
     }
     return this.cache.get(target)();
   }
-  get field() {
+  get fieldTree() {
     return this.node.fieldProxy;
   }
   get state() {
@@ -755,7 +755,7 @@ class FieldNodeContext {
   index = computed(() => {
     const key = this.key();
     if (!isArray(untracked(this.node.structure.parent.value))) {
-      throw new Error(`RuntimeError: cannot access index, parent field is not an array`);
+      throw new _RuntimeError(1906, ngDevMode && 'Cannot access index, parent field is not an array.');
     }
     return Number(key);
   }, ...(ngDevMode ? [{
@@ -766,7 +766,7 @@ class FieldNodeContext {
   valueOf = p => {
     const result = this.resolve(p)().value();
     if (result instanceof AbstractControl) {
-      throw new Error(`Tried to read an 'AbstractControl' value form a 'form()'. Did you mean to use 'compatForm()' instead?`);
+      throw new _RuntimeError(1907, ngDevMode && `Tried to read an 'AbstractControl' value from a 'form()'. Did you mean to use 'compatForm()' instead?`);
     }
     return result;
   };
@@ -789,7 +789,7 @@ class FieldMetadataState {
     if (this.has(key)) {
       if (!this.metadata.has(key)) {
         if (key.create) {
-          throw Error('Managed metadata cannot be created lazily');
+          throw new _RuntimeError(1912, ngDevMode && 'Managed metadata cannot be created lazily');
         }
         const logic = this.node.logicNode.logic.getMetadata(key);
         this.metadata.set(key, computed(() => logic.compute(this.node.context)));
@@ -929,7 +929,7 @@ class FieldNodeStructure {
       const key = initialKeyInParent;
       return computed(() => {
         if (this.parent.structure.getChild(key) !== this.node) {
-          throw new Error(`RuntimeError: orphan field, looking for property '${key}' of ${getDebugName(this.parent)}`);
+          throw new _RuntimeError(1902, ngDevMode && `Orphan field, looking for property '${key}' of ${getDebugName(this.parent)}`);
         }
         return key;
       });
@@ -938,7 +938,7 @@ class FieldNodeStructure {
       return computed(() => {
         const parentValue = this.parent.structure.value();
         if (!isArray(parentValue)) {
-          throw new Error(`RuntimeError: orphan field, expected ${getDebugName(this.parent)} to be an array`);
+          throw new _RuntimeError(1903, ngDevMode && `Orphan field, expected ${getDebugName(this.parent)} to be an array`);
         }
         const data = parentValue[lastKnownKey];
         if (isObject(data) && data.hasOwnProperty(this.parent.structure.identitySymbol) && data[this.parent.structure.identitySymbol] === identityInParent) {
@@ -950,7 +950,7 @@ class FieldNodeStructure {
             return lastKnownKey = i.toString();
           }
         }
-        throw new Error(`RuntimeError: orphan field, can't find element in array ${getDebugName(this.parent)}`);
+        throw new _RuntimeError(1904, ngDevMode && `Orphan field, can't find element in array ${getDebugName(this.parent)}`);
       });
     }
   }
@@ -1084,7 +1084,7 @@ const ROOT_PATH_KEYS = computed(() => [], ...(ngDevMode ? [{
   debugName: "ROOT_PATH_KEYS"
 }] : []));
 const ROOT_KEY_IN_PARENT = computed(() => {
-  throw new Error(`RuntimeError: the top-level field in the form has no parent`);
+  throw new _RuntimeError(1905, ngDevMode && 'The top-level field in the form has no parent.');
 }, ...(ngDevMode ? [{
   debugName: "ROOT_KEY_IN_PARENT"
 }] : []));
@@ -1138,12 +1138,12 @@ class FieldSubmitState {
   selfSubmitting = signal(false, ...(ngDevMode ? [{
     debugName: "selfSubmitting"
   }] : []));
-  serverErrors;
+  submissionErrors;
   constructor(node) {
     this.node = node;
-    this.serverErrors = linkedSignal({
+    this.submissionErrors = linkedSignal({
       ...(ngDevMode ? {
-        debugName: "serverErrors"
+        debugName: "submissionErrors"
       } : {}),
       source: this.node.structure.value,
       computation: () => []
@@ -1236,8 +1236,8 @@ class FieldNode {
   get readonly() {
     return this.nodeState.readonly;
   }
-  get fieldBindings() {
-    return this.nodeState.fieldBindings;
+  get formFieldBindings() {
+    return this.nodeState.formFieldBindings;
   }
   get submitting() {
     return this.submitState.submitting;
@@ -1368,8 +1368,8 @@ class FieldNodeState {
   markAsUntouched() {
     this.selfTouched.set(false);
   }
-  fieldBindings = signal([], ...(ngDevMode ? [{
-    debugName: "fieldBindings"
+  formFieldBindings = signal([], ...(ngDevMode ? [{
+    debugName: "formFieldBindings"
   }] : []));
   constructor(node) {
     this.node = node;
@@ -1540,19 +1540,19 @@ async function submit(form, action) {
   node.submitState.selfSubmitting.set(true);
   try {
     const errors = await action(form);
-    errors && setServerErrors(node, errors);
+    errors && setSubmissionErrors(node, errors);
   } finally {
     node.submitState.selfSubmitting.set(false);
   }
 }
-function setServerErrors(submittedField, errors) {
+function setSubmissionErrors(submittedField, errors) {
   if (!isArray(errors)) {
     errors = [errors];
   }
   const errorsByField = new Map();
   for (const error of errors) {
     const errorWithField = addDefaultField(error, submittedField.fieldProxy);
-    const field = errorWithField.field();
+    const field = errorWithField.fieldTree();
     let fieldErrors = errorsByField.get(field);
     if (!fieldErrors) {
       fieldErrors = [];
@@ -1561,7 +1561,7 @@ function setServerErrors(submittedField, errors) {
     fieldErrors.push(errorWithField);
   }
   for (const [field, fieldErrors] of errorsByField) {
-    field.submitState.serverErrors.set(fieldErrors);
+    field.submitState.submissionErrors.set(fieldErrors);
   }
 }
 function schema(fn) {
@@ -1574,5 +1574,5 @@ function markAllAsTouched(node) {
   }
 }
 
-export { BasicFieldAdapter, DEBOUNCER, FieldNode, FieldNodeState, FieldNodeStructure, FieldPathNode, MAX, MAX_LENGTH, MIN, MIN_LENGTH, MetadataKey, MetadataReducer, PATTERN, REQUIRED, addDefaultField, apply, applyEach, applyWhen, applyWhenValue, assertPathIsCurrent, calculateValidationSelfStatus, createManagedMetadataKey, createMetadataKey, form, getInjectorFromOptions, isArray, metadata, normalizeFormArgs, schema, submit };
+export { BasicFieldAdapter, DEBOUNCER, FieldNode, FieldNodeState, FieldNodeStructure, FieldPathNode, MAX, MAX_LENGTH, MIN, MIN_LENGTH, MetadataKey, MetadataReducer, PATTERN, REQUIRED, addDefaultField, apply, applyEach, applyWhen, applyWhenValue, assertPathIsCurrent, calculateValidationSelfStatus, createManagedMetadataKey, createMetadataKey, form, getInjectorFromOptions, metadata, normalizeFormArgs, schema, submit };
 //# sourceMappingURL=_structure-chunk.mjs.map