feat: enhance ValueEnum and Values with generic type support

Author: Ark4ne

src/Descriptors/Values.php

@@ -70,9 +70,10 @@ protected function date(null|string|Closure $attribute = null): ValueDate
     }
 
     /**
+     * @template U
      * @param null|string|Closure(T):(array<mixed>|null) $attribute
      *
-     * @return ValueArray<T, mixed>
+     * @return ValueArray<T, U>
      */
     protected function array(null|string|Closure $attribute = null): ValueArray
     {
@@ -90,9 +91,10 @@ protected function mixed(null|string|Closure $attribute = null): ValueMixed
     }
 
     /**
+     * @template U
      * @param null|string|Closure(T):mixed $attribute
      *
-     * @return ValueEnum<T>
+     * @return ValueEnum<T, U>
      */
     protected function enum(null|string|Closure $attribute = null): ValueEnum
     {

src/Descriptors/Values/ValueEnum.php

@@ -8,10 +8,28 @@
 
 /**
  * @template T
+ * @template U extends UnitEnum|BackedEnum
  * @extends Value<T>
  */
 class ValueEnum extends Value
 {
+    /**
+     * @var class-string<U>|null
+     */
+    protected null|string $type = null;
+
+    /**
+     * Define the type of elements in the array
+     *
+     * @param class-string<U> $type
+     * @return $this<T, U>
+     */
+    public function of(string $type): static
+    {
+        $this->type = $type;
+        return $this;
+    }
+
     protected function value(mixed $of, Request $request): mixed
     {
         if ($of instanceof BackedEnum) return $of->value;