@angular/forms 21.2.0-rc.0 → 21.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/forms",
-  "version": "21.2.0-rc.0",
+  "version": "21.2.0",
   "description": "Angular - directives and services for creating forms",
   "author": "angular",
   "license": "MIT",
@@ -12,9 +12,9 @@
     "@standard-schema/spec": "^1.0.0"
   },
   "peerDependencies": {
-    "@angular/core": "21.2.0-rc.0",
-    "@angular/common": "21.2.0-rc.0",
-    "@angular/platform-browser": "21.2.0-rc.0",
+    "@angular/core": "21.2.0",
+    "@angular/common": "21.2.0",
+    "@angular/platform-browser": "21.2.0",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {

package/types/_structure-chunk.d.ts

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

package/types/forms.d.ts

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

package/types/signals-compat.d.ts

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

package/types/signals.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.2.0-rc.0
+ * @license Angular v21.2.0
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -548,13 +548,13 @@ declare function debounce<TValue, TPathKind extends PathKind = PathKind.Root>(pa
  */
 interface ParseResult<TValue> {
     /**
-     * The parsed value, if parsing was successful.
+     * The parsed value. If omitted, the model is not updated.
      */
     readonly value?: TValue;
     /**
      * Errors encountered during parsing, if any.
      */
-    readonly errors?: readonly ValidationError.WithoutFieldTree[];
+    readonly error?: OneOrMany<ValidationError.WithoutFieldTree>;
 }
 /**
  * Options for `transformedValue`.
@@ -567,7 +567,7 @@ interface TransformedValueOptions<TValue, TRaw> {
      *
      * Should return an object containing the parsed result, which may contain:
      *   - `value`: The parsed model value. If `undefined`, the model will not be updated.
-     *   - `errors`: Any parse errors encountered. If `undefined`, no errors are reported.
+     *   - `error`: Any parse errors encountered. If `undefined`, no errors are reported.
      */
     parse: (rawValue: TRaw) => ParseResult<TValue>;
     /**
@@ -596,6 +596,14 @@ interface TransformedValueSignal<TRaw> extends WritableSignal<TRaw> {
  * representation into an underlying model value. For example, a numeric input that displays and
  * accepts string values but stores a number.
  *
+ * Parse errors are exposed via the returned signal’s `parseErrors()` property.
+ * When `transformedValue` is used within a Signal Forms field context, parse errors are also
+ * reported to the nearest field automatically. When no field context is present, no automatic
+ * reporting occurs and `parseErrors` can be consumed directly.
+ *
+ * Note: `parse` may return both a `value` and an `error`. Returning `value` updates the model;
+ * omitting it leaves the model unchanged.
+ *
  * @param value The model signal to synchronize with.
  * @param options Configuration including `parse` and `format` functions.
  * @returns A `TransformedValueSignal` representing the raw value with parse error tracking.
@@ -615,7 +623,7 @@ interface TransformedValueSignal<TRaw> extends WritableSignal<TRaw> {
  *       if (val === '') return {value: null};
  *       const num = Number(val);
  *       if (Number.isNaN(num)) {
- *         return {errors: [{kind: 'parse', message: `${val} is not numeric`}]};
+ *         return {error: {kind: 'parse', message: `${val} is not numeric`}};
  *       }
  *       return {value: num};
  *     },