Improvement: refine UI input method contracts & component documentation

components/ILIAS/UI/src/Component/Component.php

@@ -34,7 +34,7 @@ public function getCanonicalName(): string;
     /**
      * The scheme starts at the leaves of the structure and applies the function
      * to each leave and moves up the tree recursively.
-     * @param Closure(Component, array): mixed $fn
+     * @param \Closure(Component, array): mixed $fn
      */
     public function reduceWith(\Closure $fn): mixed;
 

components/ILIAS/UI/src/Component/Input/Field/Numeric.php

@@ -27,6 +27,15 @@
  */
 interface Numeric extends FilterInput
 {
+    /**
+     * Returns the step size used for this numeric input field.
+     * This value specifies the step size used when incrementing or decrementing the field's value
+     * via arrow controls, or during validation checks.
+     *
+     * @return int|float The configured step size of the input field.
+     */
+    public function getStepSize(): int|float;
+
     /**
      * This will not only set the steps for the input's arrow controls,
      * but will also alter the field's transformation.

components/ILIAS/UI/src/Component/Input/Input.php

@@ -68,6 +68,17 @@ public function withValue($value);
      */
     public function withAdditionalTransformation(Transformation $trafo);
 
+    /**
+     * Retrieves the dedicated name for this input component.
+     * This name, if set via {@see Input::withDedicatedName(string $dedicated_name)},
+     * is used in the NAME attribute of the rendered input (instead of the auto-generated 'input_x').
+     * If no dedicated name was set, it returns null.
+     * The dedicated name can be useful for customizing how inputs are submitted or referenced programmatically.
+     *
+     * @return string|null The optional dedicated name assigned to this input, or null if none is set.
+     */
+    public function getDedicatedName(): ?string;
+
     /**
      * Sets an optional dedicated name for this input which is used in the NAME
      * attribute of the rendered input (instead of the auto-generated 'input_x').

components/ILIAS/UI/tests/Component/Input/Container/Filter/FilterTest.php

@@ -452,6 +452,7 @@ protected function inputMock()
             ->getMockBuilder(Input\Field\FormInputInternal::class)
             ->onlyMethods([
                 "getName",
+                "getDedicatedName",
                 "withDedicatedName",
                 "withNameFrom",
                 "withInput",

components/ILIAS/UI/tests/Component/Input/Container/Form/FormTest.php

@@ -437,6 +437,7 @@ protected function inputMock()
             ->getMockBuilder(Input\Field\FormInputInternal::class)
             ->onlyMethods([
                 "getName",
+                "getDedicatedName",
                 "withDedicatedName",
                 "withNameFrom",
                 "withInput",