Port FormGroup to Bootstrap 5 markup and flexible signature

Replace the stale Bootstrap 4 carry-over with a proper Bootstrap 5
widget: .mb-3 wrapper, .form-label label and .form-text helper text.

Restore the flexible ($label, $content, $placeholder, $helptext,
$addTagClass) signature used across callers. The previous strict
3-arg, Input-typed constructor threw on label-only/no-arg calls,
non-Input content (ATag, SelectTag) and the 4-arg helptext form,
and referenced a non-existent Ease\TWB5\DivTag.

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

Author: Vitexus

src/Ease/TWB5/FormGroup.php

@@ -16,22 +16,77 @@
 namespace Ease\TWB5;
 
 /**
- * Description of FormGroup.
+ * Bootstrap 5 form group.
  *
- * @author vitex
+ * Wraps a label, a form control and optional helper text using Bootstrap 5
+ * markup (.mb-3 wrapper, .form-label label, .form-text helper). Replaces the
+ * Bootstrap 4 .form-group based widget.
+ *
+ * @author Vítězslav Dvořák <info@vitexsoftware.cz>
  */
 class FormGroup extends \Ease\Html\DivTag
 {
-    public function __construct($label, \Ease\Html\Input $input, $desc = '')
-    {
-        $id = $input->setTagID();
-        parent::__construct(new \Ease\Html\LabelTag($id, $label));
-        $input->addTagClass('form-control');
-        $input->setTagProperties(['aria-describedby' => 'desc'.$id]);
-        $this->addItem($input);
-
-        if ($desc) {
-            $this->addItem(new DivTag($desc, ['id' => 'desc'.$id, 'class' => 'form-text']));
+    /**
+     * Bootstrap 5 form group.
+     *
+     * @param mixed  $label       field label (string, Tag or array)
+     * @param mixed  $content     form control widget (or any renderable content)
+     * @param string $placeholder placeholder text put into the control
+     * @param mixed  $helptext    helper text rendered below the control
+     * @param string $addTagClass CSS class applied to the control (Bootstrap: form-control)
+     */
+    public function __construct(
+        $label = null,
+        $content = null,
+        $placeholder = null,
+        $helptext = null,
+        $addTagClass = 'form-control',
+    ) {
+        parent::__construct(null, ['class' => 'mb-3']);
+
+        // Resolve an id used to bind the label to the control.
+        $id = null;
+
+        if (\is_object($content) && method_exists($content, 'getTagID')) {
+            $id = $content->getTagID();
+        }
+
+        if (empty($id) && \is_string($label) && $label !== '') {
+            $id = \Ease\Functions::lettersOnly($label);
+        }
+
+        if (empty($id)) {
+            $id = 'formgroup_'.\Ease\Functions::randomString();
+        }
+
+        if ($label !== null && $label !== '') {
+            $this->addItem(new \Ease\Html\LabelTag((string) $id, $label, ['class' => 'form-label']));
+        }
+
+        if (\is_object($content)) {
+            if ($addTagClass && method_exists($content, 'addTagClass')) {
+                $content->addTagClass($addTagClass);
+            }
+
+            if ($placeholder && method_exists($content, 'setTagProperties')) {
+                $content->setTagProperties(['placeholder' => $placeholder]);
+            }
+
+            if (method_exists($content, 'setTagID')) {
+                $content->setTagID((string) $id);
+            }
+
+            if ($helptext && method_exists($content, 'setTagProperties')) {
+                $content->setTagProperties(['aria-describedby' => 'desc'.$id]);
+            }
+
+            $this->addItem($content);
+        } elseif ($content !== null) {
+            $this->addItem($content);
+        }
+
+        if ($helptext) {
+            $this->addItem(new \Ease\Html\DivTag($helptext, ['id' => 'desc'.$id, 'class' => 'form-text']));
         }
     }
 }