feat: add alias for MapperBuilder

README.md

@@ -99,6 +99,33 @@ services:
 
 </details>
 
+---
+
+For more granular control, a `MapperBuilder` instance can be injected instead.
+
+```php
+use CuyZ\Valinor\Mapper\MapperBuilder;
+
+final class SomeAutowiredService
+{
+    public function __construct(
+        private MapperBuilder $mapperBuilder,
+    ) {}
+
+    public function someMethod(): void
+    {
+        $this->mapperBuilder
+            // …
+            // Some mapper configuration 
+            // …
+            ->mapper()
+            ->map(SomeDto::class, /* … */);
+
+        // …
+    }
+}
+````
+
 ## Bundle configuration
 
 Global configuration for the bundle can be done in a package configuration file…

src/Resources/config/services.php

@@ -47,6 +47,7 @@
     // @formatter:off
     $container->services()
         ->alias(TreeMapper::class, 'valinor.tree_mapper')
+        ->alias(MapperBuilder::class, 'valinor.mapper_builder')
 
         ->set('valinor.tree_mapper', TreeMapper::class)
             ->factory([service('valinor.mapper_builder'), 'mapper'])

tests/App/src/Mapper/MapperContainer.php

@@ -5,6 +5,7 @@
 namespace CuyZ\ValinorBundle\Tests\App\Mapper;
 
 use CuyZ\Valinor\Mapper\TreeMapper;
+use CuyZ\Valinor\MapperBuilder;
 use CuyZ\ValinorBundle\Configurator\Attributes\AllowPermissiveTypes;
 use CuyZ\ValinorBundle\Configurator\Attributes\AllowSuperfluousKeys;
 use CuyZ\ValinorBundle\Configurator\Attributes\EnableFlexibleCasting;
@@ -14,6 +15,7 @@
 final class MapperContainer
 {
     public function __construct(
+        public MapperBuilder $mapperBuilder,
         public TreeMapper $defaultMapper,
         #[EnableFlexibleCasting]
         public TreeMapper $mapperWithFlexibleCasting,

tests/Integration/MapperBuilderTest.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CuyZ\ValinorBundle\Tests\Integration;
+
+final class MapperBuilderTest extends IntegrationTestCase
+{
+    public function test_mapper_builder_is_injected_and_works_properly(): void
+    {
+        $result = $this->mapperContainer()
+            ->mapperBuilder
+            ->mapper()
+            ->map('string', 'foo');
+
+        self::assertSame('foo', $result);
+    }
+}