From ad3693f44f54fdc581ee585da64b4c680bf3d288 Mon Sep 17 00:00:00 2001
From: Matthieu Riegler <kyro38@gmail.com>
Date: Fri, 19 Jun 2026 15:31:23 +0200
Subject: [PATCH] docs(forms): add jsdoc for `ReadonlyFieldState`

(cherry picked from commit d93e922517152c05e0f6c404d577e89c7ce67ad4)
---
 goldens/public-api/forms/signals/index.api.md | 1 -
 packages/forms/signals/src/api/types.ts       | 4 ++++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/goldens/public-api/forms/signals/index.api.md b/goldens/public-api/forms/signals/index.api.md
index c75e94dc014..842907bd85f 100644
--- a/goldens/public-api/forms/signals/index.api.md
+++ b/goldens/public-api/forms/signals/index.api.md
@@ -589,7 +589,6 @@ export interface ReadonlyFieldState<TValue, TKey extends string | number = strin
     readonly disabled: Signal<boolean>;
     // (undocumented)
     readonly disabledReasons: Signal<readonly DisabledReason[]>;
-    // (undocumented)
     readonly errors: Signal<ValidationError.WithFieldTree[]>;
     readonly errorSummary: Signal<ValidationError.WithFieldTree[]>;
     readonly fieldTree: ReadonlyFieldTree<unknown, TKey>;
diff --git a/packages/forms/signals/src/api/types.ts b/packages/forms/signals/src/api/types.ts
index d30d6be019c..e7bb61a52d3 100644
--- a/packages/forms/signals/src/api/types.ts
+++ b/packages/forms/signals/src/api/types.ts
@@ -430,6 +430,10 @@ export interface ReadonlyFieldState<TValue, TKey extends string | number = strin
    */
   readonly hidden: Signal<boolean>;
   readonly disabledReasons: Signal<readonly DisabledReason[]>;
+
+  /**
+   * A signal containing the {@link errors} of the field itself, excluding its descendants.
+   */
   readonly errors: Signal<ValidationError.WithFieldTree[]>;
 
   /**