fix: detects nested objects with colliding keys.

[jorgerobles]

Problem Solved

Previously, nested objects using some constructor properties with the same signature thrown errors.

Example of the problem:

class Order {
    public function __construct(public Id $id) {}
}

class Id {
    public function __construct(
        public string $id,        // collision with parent property name
        public string $type
    ) {}
}

// This would fail:
$data = [
    "id" => "123",
    "type" => "item",
];

Changes

• ShapedArrayNodeBuilder.php: Added ClassDefinitionRepository dependency and resolveFlatToNestedValue() method to detect and handle nested mapping patterns
• Container.php: Inject ClassDefinitionRepository into ShapedArrayNodeBuilder
• FlatToNestedMappingTest.php: Comprehensive test suite with tests covering various scenarios validating:
  • Name collision scenarios
  • No name collision scenarios
  • Multiple parameters (3+)
  • Optional parameters
  • Custom constructors with #[Constructor] attribute
  • Already nested data (backward compatibility)
  • Multiple properties with nested objects
  • Recursion