feat: support normalizing Ds\Collection

[simPod]

When I use transformers

(new \CuyZ\Valinor\MapperBuilder())
    ->registerTransformer(fn (\Ds\Set $v) => $v->toArray())
    ->registerTransformer(fn(Value $v) => $v->get())
    ->normalizer(\CuyZ\Valinor\Normalizer\Format::json())

My \Ds\Set<Value> is normalized to array<Value> but the Value is then ignored since the serialization is not recursive for the Set.

This fixes it.

Initially, I wanted to make this work for all IteratorAggregates and Iterators but with then 'iterable class' case does not pass since it is designed to serialize its properties and not inner Iterator.

[romm]

Thanks @simPod! I've decided to change the behavior regarding iterable objects, which fixes the issue you had with Ds\Collection objects, or any other collection objects. 🙂

[simPod]

Awesome!

[simPod]

@romm hi, I was thinking whether valinor supports objects as a key in collections 🤔

[romm]

@simPod Hi! Would you have a real-life example of why this feature would be needed? 😊

[simPod]

E.g. serde of a ds map:

use \Ds\Map;

/** @var Map<list<int>, string> */
$m = new Map();
$m->put([1], 'le value');
$m->put([1, 2], 'le value2');

$normalizer->normalize($m);

or just a simple generator yield [1]=>'le value'