Fix linter issues

Author: SerafimArts

src/Platform/EmptyPlatform.php

@@ -5,6 +5,9 @@
 namespace TypeLang\Mapper\Platform;
 
 use TypeLang\Mapper\Context\Direction;
+use TypeLang\Mapper\Type\Builder\TypeBuilderInterface;
+use TypeLang\Mapper\Type\Coercer\TypeCoercerInterface;
+use TypeLang\Mapper\Type\TypeInterface;
 
 final class EmptyPlatform implements PlatformInterface
 {
@@ -13,11 +16,17 @@ public function getName(): string
         return 'empty';
     }
 
+    /**
+     * @return array<class-string<TypeInterface>, TypeCoercerInterface>
+     */
     public function getTypeCoercers(Direction $direction): array
     {
         return [];
     }
 
+    /**
+     * @return array<array-key, TypeBuilderInterface>
+     */
     public function getTypes(Direction $direction): array
     {
         return [];

src/Platform/Platform.php

@@ -27,7 +27,7 @@ abstract class Platform implements PlatformInterface
     protected readonly array $types;
 
     /**
-     * @var list<TypeCoercerInterface>
+     * @var array<class-string<TypeInterface>, TypeCoercerInterface>
      */
     protected readonly array $coercers;
 
@@ -86,13 +86,13 @@ public function getTypes(Direction $direction): iterable
     }
 
     /**
-     * @param iterable<mixed, TypeCoercerInterface> $coercers
+     * @param iterable<class-string<TypeInterface>, TypeCoercerInterface> $coercers
      *
-     * @return list<TypeCoercerInterface>
+     * @return array<class-string<TypeInterface>, TypeCoercerInterface>
      */
     protected function formatCoercers(iterable $coercers): array
     {
-        return iterable_to_array($coercers, true);
+        return iterable_to_array($coercers);
     }
 
     public function getTypeCoercers(Direction $direction): iterable

src/Type/Builder/BackedEnumToScalarTypeBuilder.php

@@ -15,6 +15,7 @@ class BackedEnumToScalarTypeBuilder extends BackedEnumTypeBuilder
 {
     protected function create(string $class, string $definition, TypeInterface $type): BackedEnumToScalarType
     {
+        /** @phpstan-ignore-next-line : Too complicated checks for PHPStan */
         return new BackedEnumToScalarType($class);
     }
 }

src/Type/DateTimeFromStringType.php

@@ -36,6 +36,7 @@ public function match(mixed $value, Context $context): bool
         }
 
         try {
+            /** @var string $value */
             return $this->tryParseDateTime($value) !== null;
         } catch (\Throwable) {
             return false;

src/Type/Repository/LoggableTypeRepository.php

@@ -95,6 +95,7 @@ public function getTypeByStatement(TypeStatement $statement): TypeInterface
     private function unwrap(TypeInterface $type): TypeInterface
     {
         if ($type instanceof TypeDecoratorInterface) {
+            /** @var TypeInterface<TArgResult> */
             return $type->getDecoratedType();
         }
 

src/Type/Repository/TypeDecorator/TypeDecorator.php

@@ -27,6 +27,7 @@ public function __construct(
     public function getDecoratedType(): TypeInterface
     {
         if ($this->delegate instanceof TypeDecoratorInterface) {
+            /** @var TypeInterface<TResult> */
             return $this->delegate->getDecoratedType();
         }
 

src/Type/Repository/TypeRepository.php

@@ -41,7 +41,7 @@ public function __construct(
     ) {
         $this->context = $this;
         $this->builders = iterable_to_array($builders, false);
-        $this->coercers = iterable_to_array($coercers, true);
+        $this->coercers = iterable_to_array($coercers);
     }
 
     /**

src/helpers.php

@@ -8,13 +8,17 @@
  * The {@see \iterator_to_array()} function supports {@see array} only starting
  * with PHP 8.2. To ensure compatibility, you can use this function.
  *
+ * @template TArgKey of mixed
  * @template TArgValue of mixed
  *
- * @return list<TArgValue>
+ * @param iterable<TArgKey, TArgValue> $iterator
+ *
+ * @return ($preserveKeys is true ? array<TArgKey, TArgValue> : list<TArgValue>)
  */
 function iterable_to_array(iterable $iterator, bool $preserveKeys = true): array
 {
     if (\PHP_VERSION_ID >= 80200 || !\is_array($iterator)) {
+        /** @var array<TArgKey, TArgValue> */
         return \iterator_to_array($iterator, $preserveKeys);
     }