fix: schema definition wrapped in 'definition' key when using parameter-level #[Schema(definition: [...])]

Author: judus

src/Attributes/Schema.php

@@ -132,9 +132,7 @@ public function __construct(
     public function toArray(): array
     {
         if ($this->definition !== null) {
-            return [
-                'definition' => $this->definition,
-            ];
+            return $this->definition;
         }
 
         $schema = [];

tests/Fixtures/Utils/SchemaGeneratorFixture.php

@@ -397,4 +397,17 @@ public function parameterSchemaInferredType(
         $inferredParam
     ): void {
     }
+
+    /**
+     * Parameter with complete custom definition via #[Schema(definition: ...)]
+     */
+    public function parameterWithRawDefinition(
+        #[Schema(definition: [
+            'description' => 'Custom-defined schema',
+            'type' => 'string',
+            'format' => 'uuid'
+        ])]
+        string $custom
+    ): void {
+    }
 }

tests/Integration/SchemaGenerationTest.php

@@ -354,3 +354,16 @@
 
     expect($schema['required'])->toEqual(['inferredParam']);
 });
+
+it('uses raw parameter-level schema definition as-is', function () {
+    $method = new ReflectionMethod(SchemaGeneratorFixture::class, 'parameterWithRawDefinition');
+    $schema = $this->schemaGenerator->generate($method);
+
+    expect($schema['properties']['custom'])->toEqual([
+        'description' => 'Custom-defined schema',
+        'type' => 'string',
+        'format' => 'uuid'
+    ]);
+
+    expect($schema['required'])->toEqual(['custom']);
+});