@angular/forms 21.1.0-next.4 → 21.1.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,6 +1,6 @@
 /**
- * @license Angular v21.1.0-next.4
- * (c) 2010-2025 Google LLC. https://angular.dev/
+ * @license Angular v21.1.0
+ * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
@@ -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"
   }] : []));
@@ -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)));
@@ -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: () => []
@@ -1178,6 +1178,14 @@ class FieldNode {
     this.metadataState = new FieldMetadataState(this);
     this.submitState = new FieldSubmitState(this);
   }
+  focusBoundControl() {
+    this.getBindingForFocus()?.focus();
+  }
+  getBindingForFocus() {
+    const own = this.formFieldBindings().filter(b => b.focus !== undefined).reduce(firstInDom, undefined);
+    if (own) return own;
+    return this.structure.children().map(child => child.getBindingForFocus()).reduce(firstInDom, undefined);
+  }
   pendingSync = linkedSignal({
     ...(ngDevMode ? {
       debugName: "pendingSync"
@@ -1236,8 +1244,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;
@@ -1347,6 +1355,12 @@ const EMPTY = computed(() => [], ...(ngDevMode ? [{
 const FALSE = computed(() => false, ...(ngDevMode ? [{
   debugName: "FALSE"
 }] : []));
+function firstInDom(a, b) {
+  if (!a) return b;
+  if (!b) return a;
+  const position = a.element.compareDocumentPosition(b.element);
+  return position & Node.DOCUMENT_POSITION_PRECEDING ? b : a;
+}
 
 class FieldNodeState {
   node;
@@ -1368,8 +1382,8 @@ class FieldNodeState {
   markAsUntouched() {
     this.selfTouched.set(false);
   }
-  fieldBindings = signal([], ...(ngDevMode ? [{
-    debugName: "fieldBindings"
+  formFieldBindings = signal([], ...(ngDevMode ? [{
+    debugName: "formFieldBindings"
   }] : []));
   constructor(node) {
     this.node = node;
@@ -1540,12 +1554,12 @@ 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];
   }
@@ -1561,7 +1575,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 +1588,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