fix: Failing PHPStan

Author: autaut03

composer.json

@@ -10,7 +10,7 @@
 	],
 	"require": {
 		"php": ">=8.2",
-		"good-php/reflection": "dev-update-deps",
+		"good-php/reflection": "^2.0",
 		"illuminate/support": "^10.0 || ^11.0 || ^12.0"
 	},
 	"require-dev": {

src/TypeAdapter/Json/FromPrimitiveJsonTypeAdapterFactory.php

@@ -15,6 +15,9 @@
  */
 final class FromPrimitiveJsonTypeAdapterFactory implements TypeAdapterFactory
 {
+	/**
+	 * @return JsonTypeAdapter<mixed>|null
+	 */
 	public function create(string $typeAdapterType, Type $type, Attributes $attributes, Serializer $serializer): ?JsonTypeAdapter
 	{
 		if ($typeAdapterType !== JsonTypeAdapter::class) {

src/TypeAdapter/Primitive/BuiltIn/ArrayMapper.php

@@ -18,10 +18,10 @@ final class ArrayMapper
 	/**
 	 * @template T
 	 *
-	 * @param list<T>   $value
-	 * @param NamedType $type
+	 * @param array<mixed, T> $value
+	 * @param NamedType       $type
 	 *
-	 * @return list<mixed>
+	 * @return array<mixed, mixed>|stdClass
 	 */
 	#[MapTo(PrimitiveTypeAdapter::class)]
 	public function to(array $value, Type $type, Serializer $serializer): array|stdClass
@@ -49,10 +49,10 @@ public function to(array $value, Type $type, Serializer $serializer): array|stdC
 	}
 
 	/**
-	 * @param list<mixed> $value
-	 * @param NamedType   $type
+	 * @param array<mixed, mixed> $value
+	 * @param NamedType           $type
 	 *
-	 * @return list<mixed>
+	 * @return array<mixed, mixed>
 	 */
 	#[MapFrom(PrimitiveTypeAdapter::class)]
 	public function from(array $value, Type $type, Serializer $serializer): array

src/TypeAdapter/Primitive/BuiltIn/BackedEnumMapper.php

@@ -25,6 +25,7 @@ public function to(BackedEnum $value): string|int
 	#[MapFrom(PrimitiveTypeAdapter::class, new BaseTypeAcceptedByAcceptanceStrategy(BackedEnum::class))]
 	public function from(string|int $value, Type $type): BackedEnum
 	{
+		/** @var class-string<BackedEnum> $enumClass */
 		$enumClass = $type->name;
 		$enum = $enumClass::tryFrom($value);
 

src/TypeAdapter/Primitive/BuiltIn/Nullable/NullableTypeAdapterFactory.php

@@ -14,6 +14,9 @@
  */
 class NullableTypeAdapterFactory implements TypeAdapterFactory
 {
+	/**
+	 * @return NullableTypeAdapter<mixed>|null
+	 */
 	public function create(string $typeAdapterType, Type $type, Attributes $attributes, Serializer $serializer): ?NullableTypeAdapter
 	{
 		if ($typeAdapterType !== PrimitiveTypeAdapter::class || !$type instanceof NullableType) {

src/TypeAdapter/Primitive/ClassProperties/ClassPropertiesPrimitiveTypeAdapterFactory.php

@@ -25,6 +25,9 @@ public function __construct(
 		private readonly BoundClassPropertyFactory $boundClassPropertyFactory,
 	) {}
 
+	/**
+	 * @return ClassPropertiesPrimitiveTypeAdapter<object>|null
+	 */
 	public function create(string $typeAdapterType, Type $type, Attributes $attributes, Serializer $serializer): ?ClassPropertiesPrimitiveTypeAdapter
 	{
 		if ($typeAdapterType !== PrimitiveTypeAdapter::class || !$type instanceof NamedType) {

src/TypeAdapter/Primitive/MapperMethods/TypeAdapter/MapperMethodsPrimitiveTypeAdapterFactory.php

@@ -26,6 +26,9 @@ public function __construct(
 		Assert::true($this->toMappers || $this->fromMappers);
 	}
 
+	/**
+	 * @return MapperMethodsPrimitiveTypeAdapter<mixed>|null
+	 */
 	public function create(string $typeAdapterType, Type $type, Attributes $attributes, Serializer $serializer): ?MapperMethodsPrimitiveTypeAdapter
 	{
 		if ($typeAdapterType !== PrimitiveTypeAdapter::class || !$type instanceof NamedType) {

src/TypeAdapter/Primitive/PhpStandard/ValueEnumMapper.php

@@ -39,6 +39,7 @@ public function to(ValueEnum $value): string|int
 	#[MapFrom(PrimitiveTypeAdapter::class, new BaseTypeAcceptedByAcceptanceStrategy(ValueEnum::class))]
 	public function from(string|int $value, Type $type): ValueEnum
 	{
+		/** @var class-string<ValueEnum<string|int>> $enumClass */
 		$enumClass = $type->name;
 
 		try {

src/TypeAdapter/Primitive/Polymorphic/ClassPolymorphicTypeAdapterFactory.php

@@ -35,6 +35,9 @@ public static function for(string $parentClassName, string $serializedTypeNameFi
 		return new ClassPolymorphicTypeAdapterFactoryBuilder($parentClassName, $serializedTypeNameField);
 	}
 
+	/**
+	 * @return PolymorphicTypeAdapter<object>|null
+	 */
 	public function create(string $typeAdapterType, Type $type, Attributes $attributes, Serializer $serializer): ?PolymorphicTypeAdapter
 	{
 		if (

src/TypeAdapter/TypeAdapterFactory.php

@@ -14,6 +14,8 @@ interface TypeAdapterFactory
 {
 	/**
 	 * @param class-string<TypeAdapter<mixed, mixed>> $typeAdapterType
+	 *
+	 * @return TypeAdapter<mixed, mixed>|null
 	 */
 	public function create(string $typeAdapterType, Type $type, Attributes $attributes, Serializer $serializer): ?TypeAdapter;
 }