@angular/forms 21.1.3 → 21.2.0-next.1

package/fesm2022/_structure-chunk.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.1.3
+ * @license Angular v21.2.0-next.1
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -647,10 +647,19 @@ class FieldValidationState {
   }, ...(ngDevMode ? [{
     debugName: "asyncErrors"
   }] : []));
-  errors = computed(() => [...this.syncErrors(), ...this.asyncErrors().filter(err => err !== 'pending')], ...(ngDevMode ? [{
+  parseErrors = computed(() => this.node.formFieldBindings().flatMap(field => field.parseErrors()), ...(ngDevMode ? [{
+    debugName: "parseErrors"
+  }] : []));
+  errors = computed(() => [...this.parseErrors(), ...this.syncErrors(), ...this.asyncErrors().filter(err => err !== 'pending')], ...(ngDevMode ? [{
     debugName: "errors"
   }] : []));
-  errorSummary = computed(() => this.node.structure.reduceChildren(this.errors(), (child, result) => [...result, ...child.errorSummary()]), ...(ngDevMode ? [{
+  errorSummary = computed(() => {
+    const errors = this.node.structure.reduceChildren(this.errors(), (child, result) => [...result, ...child.errorSummary()]);
+    if (typeof ngServerMode === 'undefined' || !ngServerMode) {
+      untracked(() => errors.sort(compareErrorPosition));
+    }
+    return errors;
+  }, ...(ngDevMode ? [{
     debugName: "errorSummary"
   }] : []));
   pending = computed(() => this.node.structure.reduceChildren(this.asyncErrors().includes('pending'), (child, value) => value || child.validationState.asyncErrors().includes('pending')), ...(ngDevMode ? [{
@@ -701,6 +710,20 @@ function addDefaultField(errors, fieldTree) {
   }
   return errors;
 }
+function getFirstBoundElement(error) {
+  if (error.formField) return error.formField.element;
+  return error.fieldTree().formFieldBindings().reduce((el, binding) => {
+    if (!el || !binding.element) return el ?? binding.element;
+    return el.compareDocumentPosition(binding.element) & Node.DOCUMENT_POSITION_PRECEDING ? binding.element : el;
+  }, undefined);
+}
+function compareErrorPosition(a, b) {
+  const aEl = getFirstBoundElement(a);
+  const bEl = getFirstBoundElement(b);
+  if (aEl === bEl) return 0;
+  if (aEl === undefined || bEl === undefined) return aEl === undefined ? 1 : -1;
+  return aEl.compareDocumentPosition(bEl) & Node.DOCUMENT_POSITION_PRECEDING ? 1 : -1;
+}
 
 const DEBOUNCER = createMetadataKey();
 
@@ -1178,8 +1201,8 @@ class FieldNode {
     this.metadataState = new FieldMetadataState(this);
     this.submitState = new FieldSubmitState(this);
   }
-  focusBoundControl() {
-    this.getBindingForFocus()?.focus();
+  focusBoundControl(options) {
+    this.getBindingForFocus()?.focus(options);
   }
   getBindingForFocus() {
     const own = this.formFieldBindings().filter(b => b.focus !== undefined).reduce(firstInDom, undefined);
@@ -1214,6 +1237,9 @@ class FieldNode {
   get errors() {
     return this.validationState.errors;
   }
+  get parseErrors() {
+    return this.validationState.parseErrors;
+  }
   get errorSummary() {
     return this.validationState.errorSummary;
   }