Introduce a Mapped Guesser

There's currently no easy way to avoid adding attributes in order to configure which normalizers to use for which types.

This `MappedGuesser` is a trivial Guesser implementation allowing users to specify a map of `Type::class => Normalizer::class` as an alternative to adding attributes to targets

Author: gsteel

phpstan-baseline.neon

@@ -168,12 +168,6 @@ parameters:
 			count: 2
 			path: tests/Unit/Normalizer/ArrayNormalizerTest.php
 
-		-
-			message: '#^Parameter \#1 \$normalizer of class Patchlevel\\Hydrator\\Normalizer\\ArrayNormalizer constructor expects Patchlevel\\Hydrator\\Normalizer\\Normalizer, PHPUnit\\Framework\\MockObject\\MockObject given\.$#'
-			identifier: argument.type
-			count: 1
-			path: tests/Unit/Normalizer/ArrayNormalizerTest.php
-
 		-
 			message: '#^Cannot cast mixed to int\.$#'
 			identifier: cast.int
@@ -185,9 +179,3 @@ parameters:
 			identifier: cast.string
 			count: 2
 			path: tests/Unit/Normalizer/ArrayShapeNormalizerTest.php
-
-		-
-			message: '#^Parameter \#1 \$normalizerMap of class Patchlevel\\Hydrator\\Normalizer\\ArrayShapeNormalizer constructor expects array\<Patchlevel\\Hydrator\\Normalizer\\Normalizer\>, array\<string, PHPUnit\\Framework\\MockObject\\MockObject\> given\.$#'
-			identifier: argument.type
-			count: 1
-			path: tests/Unit/Normalizer/ArrayShapeNormalizerTest.php

src/Guesser/MappedGuesser.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Patchlevel\Hydrator\Guesser;
+
+use Patchlevel\Hydrator\Normalizer\Normalizer;
+use Symfony\Component\TypeInfo\Type\ObjectType;
+
+use function array_key_exists;
+
+final readonly class MappedGuesser implements Guesser
+{
+    /** @param array<class-string, class-string<Normalizer>> $map */
+    public function __construct(private array $map)
+    {
+    }
+
+    /**
+     * @param ObjectType<T> $type
+     *
+     * @template T
+     */
+    public function guess(ObjectType $type): Normalizer|null
+    {
+        $className = $type->getClassName();
+        if (! array_key_exists($className, $this->map)) {
+            return null;
+        }
+
+        $normalizerType = $this->map[$className];
+
+        return new $normalizerType();
+    }
+}

tests/Unit/Guesser/MappedGuesserTest.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Patchlevel\Hydrator\Tests\Unit\Guesser;
+
+use Patchlevel\Hydrator\Guesser\MappedGuesser;
+use Patchlevel\Hydrator\Tests\Unit\Fixture\Email;
+use Patchlevel\Hydrator\Tests\Unit\Fixture\EmailNormalizer;
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\TypeInfo\Type\ObjectType;
+
+final class MappedGuesserTest extends TestCase
+{
+    public function testTheNormalizerIsNullWhenTheTypeHasNotBeenMapped(): void
+    {
+        $guesser = new MappedGuesser([]);
+
+        self::assertNull($guesser->guess(new ObjectType(Email::class)));
+    }
+
+    public function testTheNormalizerIsOfTheExpectedType(): void
+    {
+        $guesser = new MappedGuesser([
+            Email::class => EmailNormalizer::class,
+        ]);
+
+        $normalizer = $guesser->guess(new ObjectType(Email::class));
+
+        self::assertInstanceOf(EmailNormalizer::class, $normalizer);
+    }
+}