fix: phpstan

Author: Ark4ne

src/Descriptors/Resolver.php

@@ -11,7 +11,7 @@ trait Resolver
      * @param \Illuminate\Http\Request $request
      * @param iterable<mixed>|null $values
      *
-     * @return array<mixed>|null
+     * @return array<array-key, mixed>|null
      */
     protected function resolveValues(Request $request, ?iterable $values): ?array
     {

src/Descriptors/Values.php

@@ -101,11 +101,11 @@ protected function enum(null|string|Closure $attribute = null): ValueEnum
     }
 
     /**
-     * @param Closure(T):iterable<string, \Closure|mixed>|iterable<array-key, \Ark4ne\JsonApi\Descriptors\Values\Value> $attribute
+     * @param Closure(T):iterable<string, mixed|\Closure|\Ark4ne\JsonApi\Descriptors\Values\Value> $attribute
      *
      * @return \Ark4ne\JsonApi\Descriptors\Values\ValueStruct<T>
      */
-    protected function struct(Closure $attribute = null): ValueStruct
+    protected function struct(Closure $attribute): ValueStruct
     {
         return new ValueStruct($attribute);
     }

src/Descriptors/Values/ValueStruct.php

@@ -31,7 +31,7 @@ public function resolveFor(Request $request, mixed $model, string $field): mixed
     }
 
     /**
-     * @param mixed $of
+     * @param iterable<array-key, mixed> $of
      * @param Request $request
      *
      * @return array<array-key, mixed>

src/Resources/Concerns/Attributes.php

@@ -15,7 +15,7 @@ trait Attributes
      *
      * @param \Illuminate\Http\Request $request
      *
-     * @return iterable<string, \Closure|mixed>|iterable<array-key, \Ark4ne\JsonApi\Descriptors\Values\Value>
+     * @return iterable<array-key, mixed|\Closure|\Ark4ne\JsonApi\Descriptors\Values\Value>
      *
      * ```
      * return [

src/Resources/Concerns/Schema.php

@@ -94,7 +94,10 @@ private static function new(): static
 
     private static function structFields(mixed $resource, string $key, ValueStruct $struct, null|string $prefix = null): Collection
     {
-        return (new Collection(Values::mergeValues(($struct->retriever())($resource, $key))))
+        /** @var array<array-key, mixed> $attributes */
+        $attributes = ($struct->retriever())($resource, $key);
+
+        return (new Collection(Values::mergeValues($attributes)))
             ->flatMap(function($value, $key) use ($resource, $prefix) {
                 $prefixed = Describer::retrieveName($value, $key, $prefix);