Clarify Fieldset warnings and form wrapper property targets

src/Forms/EmailInput.php

@@ -56,6 +56,9 @@ public function id(string $id): self
         return $this;
     }
 
+    /**
+     * Sets properties on this component's outermost div, not the input.
+     */
     public function wrapperProps(string ...$properties): self
     {
         $this->wrapperProperties = array_values($properties);

src/Forms/Fieldset.php

@@ -33,6 +33,10 @@ class Fieldset implements Stringable
      */
     private array $elements = [];
 
+    /**
+     * Renders one group warning; callers must wire aria-invalid and
+     * aria-describedby on member controls (see Select's radio/checkbox modes).
+     */
     public static function create(
         string|Stringable $label,
         string|Stringable $name,
@@ -54,6 +58,9 @@ public function elements(string|Stringable ...$elements): self
         return $this;
     }
 
+    /**
+     * Sets properties on this component's outermost element: the fieldset.
+     */
     public function wrapperProps(string ...$properties): self
     {
         $this->wrapperProperties = $properties;

src/Forms/Password.php

@@ -58,6 +58,9 @@ public function id(string $id): self
         return $this;
     }
 
+    /**
+     * Sets properties on this component's outermost div, not the input.
+     */
     public function wrapperProps(string ...$properties): self
     {
         $this->wrapperProperties = array_values($properties);

src/Forms/Select.php

@@ -72,6 +72,10 @@ public function id(string $id): self
         return $this;
     }
 
+    /**
+     * Sets properties on the outermost div in dropdown/multiple modes,
+     * or the fieldset in radio/checkbox modes, not on member controls.
+     */
     public function wrapperProps(string ...$properties): self
     {
         $this->wrapperProperties = array_values($properties);

src/Forms/TextArea.php

@@ -59,6 +59,9 @@ public function id(string $id): self
         return $this;
     }
 
+    /**
+     * Sets properties on this component's outermost div, not the textarea.
+     */
     public function wrapperProps(string ...$properties): self
     {
         $this->wrapperProperties = array_values($properties);

src/Forms/TextInput.php

@@ -56,6 +56,9 @@ public function id(string $id): self
         return $this;
     }
 
+    /**
+     * Sets properties on this component's outermost div, not the input.
+     */
     public function wrapperProps(string ...$properties): self
     {
         $this->wrapperProperties = array_values($properties);