feat: Smart example distribution and automatic type broadening (oneOf/anyOf)

[squiaios]

Description

This Pull Request improves the handling of multiple examples and union types (anyOf/oneOf)

Usage Example

You no longer need to manually define the union type if your examples cover the expected types:

public function rules() {
    return [
        /**
         * @example {"type": "string", "value": "AZE-123", "summary": "Text Format"}
         * @example {"type": "int", "value": 456, "summary": "Numeric Format"}
         */
        'external_id' => 'alpha_num',
    ];
}

Generated OpenAPI Result:

"external_id": {
  "oneOf": [
    {
      "type": "string",
      "description": "Text Format",
      "example": "AZE-123"
    },
    {
      "type": "integer",
      "description": "Numeric Format",
      "example": 456
    }
  ]
}