Fix parameter-level schema output by returning raw definition

src/Utils/SchemaGenerator.php

@@ -183,6 +183,10 @@ private function buildParameterSchema(array $paramInfo, ?array $methodLevelParam
         // Parameter-level takes highest precedence
         $parameterLevelSchema = $paramInfo['parameter_schema'];
         if (!empty($parameterLevelSchema)) {
+            if (isset($parameterLevelSchema['definition']) && is_array($parameterLevelSchema['definition'])) {
+                return $parameterLevelSchema['definition'];
+            }
+
             $mergedSchema = $this->mergeSchemas($mergedSchema, $parameterLevelSchema);
         }
 

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']);
+});