Dynamic definition of the property name

[andrey-helldar]

I didn't find it in the documentation and code, so I suggest adding the ability to dynamically determine the name of the incoming key when generating the DTO.

For example, my case study is that an object comes in for input:

$data = [
  'price_level_1' => 100,
  'price_level_2' => 200,
  'price_level_3' => 300,

  'user' => [
    'level' => 2,
  ],
];

And depending on the level of the customer loyalty program, you need to derive your price.

For example:

class SomeMapper extends NameMapper
{
    public function __construct(
        protected array $payload
    ) {}

    public function map(int|string $name)
    {
        return 'price_level_' . $this->level();
    }

    protected function level(): int
    {
        return Arr::get($this->payload, 'user.level', 1);
    }
}

class SomeDto extends Data
{
    #[MapInputName(SomeMapper::class)]
    public int $price;
}

return SomeDto::from($data)->price; // 200

This is similar to #261, but differs in that I suggest using the naming logic on the outside without touching the data itself.