Utilize ipl\Stdlib\Option where applicable

The attribute setters are kept for now, to ensure
backwards compatibility with code relying on them.

Author: nilmerg

src/FormElement/BaseFormElement.php

@@ -20,12 +20,15 @@ abstract class BaseFormElement extends BaseHtmlElement implements FormElement, V
     use Translation;
 
     /** @var string Description of the element */
+    #[Option]
     protected $description;
 
     /** @var string Label of the element */
+    #[Option]
     protected $label;
 
     /** @var string Name of the element */
+    #[Option]
     protected $name;
 
     /** @var bool Whether the element is ignored */
@@ -41,6 +44,7 @@ abstract class BaseFormElement extends BaseHtmlElement implements FormElement, V
     protected $validators;
 
     /** @var mixed Value of the element */
+    #[Option]
     protected $value;
 
     /** @var array<int, mixed> Value candidates of the element */
@@ -139,6 +143,7 @@ public function isIgnored()
      *
      * @return $this
      */
+    #[Option]
     public function setIgnored($ignored = true)
     {
         $this->ignored = (bool) $ignored;
@@ -158,6 +163,7 @@ public function isRequired()
      *
      * @return $this
      */
+    #[Option]
     public function setRequired($required = true)
     {
         $this->required = (bool) $required;
@@ -197,6 +203,7 @@ public function getValidators()
      *
      * @return $this
      */
+    #[Option]
     public function setValidators($validators)
     {
         $this

src/FormElement/CheckboxElement.php

@@ -3,16 +3,19 @@
 namespace ipl\Html\FormElement;
 
 use ipl\Html\Attributes;
+use ipl\Stdlib\Option;
 
 class CheckboxElement extends InputElement
 {
     /** @var bool Whether the checkbox is checked */
     protected $checked = false;
 
     /** @var string Value of the checkbox when it is checked */
+    #[Option]
     protected $checkedValue = 'y';
 
     /** @var string Value of the checkbox when it is not checked */
+    #[Option]
     protected $uncheckedValue = 'n';
 
     protected $type = 'checkbox';
@@ -34,6 +37,7 @@ public function isChecked()
      *
      * @return $this
      */
+    #[Option]
     public function setChecked($checked)
     {
         $this->checked = (bool) $checked;

src/FormElement/FileElement.php

@@ -10,6 +10,7 @@
 use ipl\Html\HtmlElement;
 use ipl\Html\Text;
 use ipl\I18n\Translation;
+use ipl\Stdlib\Option;
 use ipl\Validator\FileValidator;
 use ipl\Validator\ValidatorChain;
 use Psr\Http\Message\UploadedFileInterface;
@@ -40,6 +41,7 @@ class FileElement extends InputElement
     protected $filesToRemove = [];
 
     /** @var ?string Path to store files to preserve them across requests */
+    #[Option]
     protected $destination;
 
     /** @var int The default maximum file size */

src/FormElement/InputElement.php

@@ -2,8 +2,8 @@
 
 namespace ipl\Html\FormElement;
 
-use ipl\Html\Attribute;
 use ipl\Html\Attributes;
+use ipl\Stdlib\Option;
 
 class InputElement extends BaseFormElement
 {
@@ -29,6 +29,7 @@ public function getType()
      *
      * @return $this
      */
+    #[Option]
     public function setType($type)
     {
         $this->type = (string) $type;

src/FormElement/RadioElement.php

@@ -8,6 +8,7 @@
 use ipl\Html\HtmlElement;
 use ipl\Html\Text;
 use ipl\I18n\Translation;
+use ipl\Stdlib\Option;
 use ipl\Validator\DeferredInArrayValidator;
 use ipl\Validator\ValidatorChain;
 
@@ -31,6 +32,7 @@ class RadioElement extends BaseFormElement
      *
      * @return $this
      */
+    #[Option]
     public function setOptions(array $options): self
     {
         $this->options = [];
@@ -74,6 +76,7 @@ public function getOption($value): RadioOption
      *
      * @return $this
      */
+    #[Option]
     public function setDisabledOptions(array $disabledOptions): self
     {
         if (! empty($this->options)) {

src/FormElement/SelectElement.php

@@ -2,11 +2,11 @@
 
 namespace ipl\Html\FormElement;
 
-use InvalidArgumentException;
 use ipl\Html\Attributes;
 use ipl\Html\Common\MultipleAttribute;
 use ipl\Html\Html;
 use ipl\Html\HtmlElement;
+use ipl\Stdlib\Option;
 use ipl\Validator\DeferredInArrayValidator;
 use ipl\Validator\ValidatorChain;
 use UnexpectedValueException;
@@ -48,6 +48,7 @@ public function getOption($value): ?SelectOption
      *
      * @return $this
      */
+    #[Option(name: ['options', 'multiOptions'])]
     public function setOptions(array $options): self
     {
         $this->options = [];
@@ -66,6 +67,7 @@ public function setOptions(array $options): self
      *
      * @return $this
      */
+    #[Option]
     public function setDisabledOptions(array $disabledOptions): self
     {
         if (! empty($this->options)) {

src/FormElement/SubmitButtonElement.php

@@ -4,6 +4,7 @@
 
 use ipl\Html\Attributes;
 use ipl\Html\Contract\FormSubmitElement;
+use ipl\Stdlib\Option;
 
 class SubmitButtonElement extends ButtonElement implements FormSubmitElement
 {
@@ -29,6 +30,7 @@ public function getSubmitValue(): string
      *
      * @return $this
      */
+    #[Option(name: 'value')]
     public function setSubmitValue(string $value): self
     {
         $this->submitValue = $value;

src/FormElement/TextElement.php

@@ -3,12 +3,14 @@
 namespace ipl\Html\FormElement;
 
 use ipl\Html\Attributes;
+use ipl\Stdlib\Option;
 
 class TextElement extends InputElement
 {
     protected $type = 'text';
 
     /** @var ?string Placeholder text for the input */
+    #[Option]
     protected ?string $placeholder = null;
 
     /**