make addControl generic

Author: mvorisek

src/Form.php

@@ -330,8 +330,12 @@ public function jsSuccess($success = 'Success', $subHeader = null, bool $useTemp
     /**
      * Add form control into current layout. If no layout, create one. If no model, create blank one.
      *
-     * @param array<mixed>|Control $control
-     * @param array<mixed>         $fieldSeed
+     * @template T of Control = Control
+     *
+     * @param array{class-string<T>}|T $control
+     * @param array<mixed>             $fieldSeed
+     *
+     * @return T
      */
     public function addControl(string $name, $control = [], array $fieldSeed = []): Control
     {
@@ -374,7 +378,11 @@ public function addGroup($title = null)
      * 3. $f->type is converted into seed and evaluated
      * 4. lastly, falling back to Line, Dropdown (based on $reference and $enum)
      *
-     * @param array<string, mixed> $controlSeed
+     * @template T of Control
+     *
+     * @param array{class-string<T>}|T $controlSeed
+     *
+     * @return T
      */
     public function controlFactory(Field $field, $controlSeed = []): Control
     {

src/Form/AbstractLayout.php

@@ -27,6 +27,13 @@ abstract class AbstractLayout extends View
     /** Links layout to owner Form. */
     public Form $form;
 
+    /**
+     * @template T of Control
+     *
+     * @param T $control
+     *
+     * @return T
+     */
     protected function _addControl(Control $control, Field $field): Control
     {
         return $this->add($control, $this->template->hasTag($field->shortName) ? $field->shortName : null);
@@ -36,8 +43,12 @@ protected function _addControl(Control $control, Field $field): Control
      * Places element inside a layout somewhere. Should be called
      * through $form->addControl().
      *
-     * @param array<mixed>|Control $control
-     * @param array<mixed>         $fieldSeed
+     * @template T of Control = Control
+     *
+     * @param array{class-string<T>}|T $control
+     * @param array<mixed>             $fieldSeed
+     *
+     * @return T
      */
     public function addControl(string $name, $control = [], array $fieldSeed = []): Control
     {