add support for array shapes

Author: DavidBadura

README.md

@@ -155,14 +155,44 @@ use Patchlevel\Hydrator\Normalizer\DateTimeImmutableNormalizer;
 
 final class DTO 
 {
-    #[ArrayNormalizer(new DateTimeImmutableNormalizer())]
+    /**
+     * @var list<DateTimeImmutable>
+     */
+    #[ArrayNormalizer]
     public array $dates;
+    
+    #[ArrayNormalizer(new DateTimeImmutableNormalizer())]
+    public array $explicitDates;
 }
 ```
 
 > [!NOTE]
 > The keys from the arrays are taken over here.
 
+#### ArrayShape
+
+If you have an array with a specific shape, you can use the `ArrayShapeNormalizer`.
+
+```php
+use Patchlevel\Hydrator\Normalizer\ArrayShapeNormalizer;
+use Patchlevel\Hydrator\Normalizer\DateTimeImmutableNormalizer;
+
+final class DTO 
+{
+    /**
+     * @var array{
+     *     date: DateTimeImmutable,
+     *     otherField: string
+     * }
+     */
+    #[ArrayShapeNormalizer]
+    public array $meta;
+    
+    #[ArrayShapeNormalizer(['date' => new DateTimeImmutableNormalizer()])]
+    public array $explicitMeta;
+}
+```
+
 #### DateTimeImmutable
 
 With the `DateTimeImmutable` Normalizer, as the name suggests,

composer.json

@@ -24,7 +24,7 @@
     "psr/cache": "^2.0.0 || ^3.0.0",
     "psr/simple-cache": "^2.0.0 || ^3.0.0",
     "symfony/event-dispatcher": "^5.4.29 || ^6.4.0 || ^7.0.0",
-    "symfony/type-info": "^7.2.4"
+    "symfony/type-info": "^7.3.0"
   },
   "require-dev": {
     "infection/infection": "^0.29.10",