docs(many): simplify aria comments in v2 form controls

Condense the accessible-name/aria-describedby comments across the v2 form
controls and add a matching one-liner to NumberInput, RangeInput, and TextArea
so the messages-as-description rationale is documented consistently.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: git-nandor

packages/ui-checkbox/src/Checkbox/v2/index.tsx

@@ -225,9 +225,7 @@ class Checkbox extends Component<CheckboxProps, CheckboxState> {
       `[Checkbox] The \`simple\` variant does not support the \`labelPlacement\` property.  Use the \`toggle\` variant instead.`
     )
 
-    // The label text gets its own id so that, when there are messages, the
-    // input's accessible name can point at the label only (via
-    // `aria-labelledby`) instead of also including the message text.
+    // Give the label its own id so messages stay out of the accessible name.
     const labelContent = (
       <span id={this._labelId}>
         {label}

packages/ui-form-field/src/FormFieldLayout/v2/index.tsx

@@ -70,10 +70,8 @@ const FormFieldLayout = forwardRef<Element, FormFieldLayoutProps>(
     }, [])
 
     const messagesId = messagesIdProp || deterministicId
-    // The label element gets an id so that single form controls can point their
-    // `aria-labelledby` at the label text only. This keeps `messages` (which
-    // live inside the wrapping <label>) out of the control's accessible name
-    // while preserving the native click-on-label focus behavior.
+    // Give the label an id so controls can reference only the label text via
+    // `aria-labelledby`, keeping messages out of the accessible name.
     const labelId =
       labelIdProp || (deterministicId ? `${deterministicId}-Label` : undefined)
 
@@ -189,8 +187,6 @@ const FormFieldLayout = forwardRef<Element, FormFieldLayoutProps>(
             </legend>
           )
         }
-        // `id` lets single form controls reference just the label text via
-        // `aria-labelledby`, keeping `messages` out of their accessible name.
         return (
           <span css={styles?.formFieldLabel} id={labelId}>
             {labelContent}

packages/ui-number-input/src/NumberInput/v2/index.tsx

@@ -120,12 +120,6 @@ const NumberInput = forwardRef<NumberInputHandle, NumberInputProps>(
     const success =
       !!messages && messages.some((message) => message.type === 'success')
 
-    // Messages live inside the wrapping <label>. Reference them from the input
-    // via `aria-describedby` and point the accessible name at the label text
-    // only via `aria-labelledby`, so the messages are announced as a
-    // description rather than as part of the control's name.
-    // Only when a message actually renders (has text); FormField skips
-    // empty-text messages, so otherwise aria-describedby would dangle.
     const hasMessages = !!messages?.some((m) => !!m.text)
     const messagesId = id ? `${id}-messages` : undefined
     const labelId = id ? `${id}-label` : undefined
@@ -330,8 +324,6 @@ const NumberInput = forwardRef<NumberInputHandle, NumberInputProps>(
 
     const label = callRenderProp(renderLabel)
 
-    // `passthroughProps` is typed with `unknown` values; widen once here so the
-    // aria-* reads below don't each need a cast.
     const passedProps = passthroughProps(rest) as Record<string, any>
 
     // Don't render until we have an ID
@@ -360,6 +352,7 @@ const NumberInput = forwardRef<NumberInputHandle, NumberInputProps>(
               {...passedProps}
               css={styles?.input}
               aria-invalid={invalid ? 'true' : undefined}
+              // Keep messages in the description so the accessible name contains only the label.
               aria-describedby={
                 [
                   passedProps['aria-describedby'],

packages/ui-range-input/src/RangeInput/v2/index.tsx

@@ -188,12 +188,6 @@ class RangeInput extends Component<RangeInputProps, RangeInputState> {
 
     const props = omitProps(this.props, RangeInput.allowedProps)
 
-    // Messages live inside the wrapping <label>. Reference them from the input
-    // via `aria-describedby` and point the accessible name at the label text
-    // only via `aria-labelledby`, so the messages are announced as a
-    // description rather than as part of the control's name.
-    // Only when a message actually renders (has text); FormField skips
-    // empty-text messages, so otherwise aria-describedby would dangle.
     const hasMessages = !!messages?.some((m) => !!m.text)
     const messagesId = `${this.id}-messages`
     const labelId = `${this.id}-label`
@@ -223,6 +217,7 @@ class RangeInput extends Component<RangeInputProps, RangeInputState> {
             {...props}
             disabled={disabled || readOnly}
             aria-disabled={disabled || readOnly ? 'true' : undefined}
+            // Keep messages in the description so the accessible name contains only the label.
             aria-describedby={
               [props['aria-describedby'], hasMessages ? messagesId : null]
                 .filter(Boolean)

packages/ui-text-area/src/TextArea/v2/index.tsx

@@ -128,12 +128,6 @@ const TextArea = forwardRef<TextAreaElement, TextAreaProps>((props, ref) => {
     return { isInvalid, isSuccess }
   }, [messages])
 
-  // Messages live inside the wrapping <label>. Reference them from the textarea
-  // via `aria-describedby` and point the accessible name at the label text only
-  // via `aria-labelledby`, so the messages are announced as a description
-  // rather than as part of the control's name.
-  // Only when a message actually renders (has text); FormField skips empty-text
-  // messages, so otherwise aria-describedby would dangle.
   const hasMessages = !!messages?.some((m) => !!m.text)
   const messagesId = `${id}-messages`
   const labelId = `${id}-label`
@@ -403,6 +397,7 @@ const TextArea = forwardRef<TextAreaElement, TextAreaProps>((props, ref) => {
       required={required}
       aria-required={required}
       aria-invalid={isInvalid ? 'true' : undefined}
+      // Keep messages in the description so the accessible name contains only the label.
       aria-describedby={
         [rest['aria-describedby'], hasMessages ? messagesId : null]
           .filter(Boolean)