Add explanation support

src/Apility/Forms/Concerns/Attributes/Explanation.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Apility\Forms\Concerns\Attributes;
+
+use Apility\Forms\View\Components\Field;
+
+trait Explanation
+{
+    public function explanation()
+    {
+        /** @var Field $this */
+
+        return once(fn () => $this->field->getFormFieldOptions()['explanation'] ?? null);
+    }
+
+    public function explanationId()
+    {
+        /** @var Field $this */
+
+        if ($this->explanation() !== null) {
+            $id = method_exists($this, 'id') ? $this->id() : null;
+            return implode('-', array_filter([$id ?? null, 'explanation']));
+        }
+    }
+}

src/Apility/Forms/View/Components/Field.php

@@ -2,6 +2,7 @@
 
 namespace Apility\Forms\View\Components;
 
+use Apility\Forms\Concerns\Attributes\Explanation;
 use Illuminate\View\Component;
 use Illuminate\Support\Str;
 use Illuminate\Support\Facades\View;
@@ -11,6 +12,8 @@
 
 abstract class Field extends Component
 {
+    use Explanation;
+
     public FormFieldContract $field;
 
     public function __construct(FormFieldContract $field)

src/resources/views/components/fields/input.blade.php

@@ -26,6 +26,19 @@
             'step' => $step ?? null,
             'title' => $title ?? null,
             'value' => $value ?? null,
+            'explanation' => $explanationId ?? null
         ])
     ])
 >
+    @if($explanation)
+        aria-describedby="{{ implode('-', array_filter([$id ?? null, 'explanation'])) }}"
+    @endif
+>
+@if($explanation ?? null)
+    <div
+        id="{{ $explanationId ?? null }}"
+        class="form-text"
+    >
+        {{ $explanation }}
+    </div>
+@endif

src/resources/views/partials/explanation.blade.php

@@ -0,0 +1,3 @@
+@if($explanationId() !== null)
+aria-describedby="{{ $explanationId }}"
+@endif