add dynamic interface resolution

src/InterfaceResolver.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace CuyZ\Valinor;
+
+/**
+ * @api
+ */
+interface InterfaceResolver
+{
+ /**
+ * @param array<string,mixed>|null $props
+ * @return class-string|null
+ */
+ public function resolve(string $interface, ?array $props): ?string;
+
+ /**
+ * @return string[]
+ */
+ public function getResolverProps(string $interface): array;
+
+ /**
+ * @return array<string|int,mixed>
+ */
+ public function transform(object $input, callable $next): array;
+}

src/Library/Container.php

@@ -128,6 +128,7 @@ public function __construct(Settings $settings)
  $this->get(FunctionDefinitionRepository::class),
  $settings->customConstructors
  ),
+ $settings->interfaceResolver,
  );
 
  $builder = new CasterProxyNodeBuilder($builder);

src/Library/Settings.php

@@ -4,6 +4,7 @@
 
 namespace CuyZ\Valinor\Library;
 
+use CuyZ\Valinor\InterfaceResolver;
 use CuyZ\Valinor\Mapper\Object\Constructor;
 use CuyZ\Valinor\Mapper\Object\DynamicConstructor;
 use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
@@ -59,6 +60,8 @@ final class Settings
  /** @var array<class-string, null> */
  public array $transformerAttributes = [];
 
+ public ?InterfaceResolver $interfaceResolver = null;
+
  public function __construct()
  {
  $this->inferredMapping[DateTimeInterface::class] = static fn () => DateTimeImmutable::class;

src/Mapper/Tree/Builder/InterfaceNodeBuilder.php

@@ -6,6 +6,7 @@
 
 use CuyZ\Valinor\Definition\FunctionsContainer;
 use CuyZ\Valinor\Definition\Repository\ClassDefinitionRepository;
+use CuyZ\Valinor\InterfaceResolver;
 use CuyZ\Valinor\Mapper\Object\Arguments;
 use CuyZ\Valinor\Mapper\Object\ArgumentsValues;
 use CuyZ\Valinor\Mapper\Object\Exception\InvalidSource;
@@ -27,6 +28,7 @@ public function __construct(
  private ObjectImplementations $implementations,
  private ClassDefinitionRepository $classDefinitionRepository,
  private FunctionsContainer $constructors,
+ private ?InterfaceResolver $interfaceResolver,
  ) {}
 
  public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode
@@ -53,6 +55,21 @@ public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode
 
  if (! $this->implementations->has($className)) {
  if ($type instanceof InterfaceType || $this->classDefinitionRepository->for($type)->isAbstract) {
+ if ($this->interfaceResolver) {
+ $value = $shell->value();
+ if (is_array($value)) {
+ $resolver_props = [];
+ foreach($this->interfaceResolver->getResolverProps($className) as $prop) {
+ $resolver_props[$prop] = $value[$prop];
+ unset($value[$prop]);
+ }
+ $resolvedClassName = $this->interfaceResolver->resolve($className, $resolver_props);
+ if ($resolvedClassName !== null) {
+ $shell = $shell->withType(new NativeClassType($resolvedClassName))->withValue($value);
+ return $this->delegate->build($shell, $rootBuilder);
+ }
+ }
+ }
  throw new CannotResolveObjectType($className);
  }
 

src/MapperBuilder.php

@@ -530,6 +530,15 @@ public function registerTransformer(callable|string $transformer, int $priority
  return $clone;
  }
 
+ public function withInterfaceResolver(InterfaceResolver $resolver): self
+ {
+
+ $clone = clone $this;
+ $clone->settings->interfaceResolver = $resolver;
+
+ return $clone->registerTransformer($resolver->transform(...));
+ }
+
  /**
  * Warms up the injected cache implementation with the provided class names.
  *