fix: resolve Schema ref from parameter type in AugmentRequestBody

When #[OA\RequestBody] is on a method parameter whose type has a
#[OA\Schema] annotation, the existing augmentSchemaType + type2ref
lookup fails because it searches for a RequestBody annotation on the
class. Add a fallback that resolves the parameter type to a Schema ref
when ref remains UNDEFINED after the existing logic.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: DerManoMann

.gitignore

@@ -15,3 +15,4 @@ vendor/
 .idea/
 .phpstan/
 /.phpunit.cache/test-results
+/.claude/settings.local.json

src/Processors/AugmentRequestBody.php

@@ -58,6 +58,17 @@ protected function augmentRequestBody(Analysis $analysis, array $requestBodies):
                     $requestBody->ref = $schema->ref;
                 }
 
+                // Fall back: resolve parameter type to a Schema ref
+                if (Generator::isDefault($requestBody->ref)) {
+                    $type = $context->reflector->getType();
+                    if ($type instanceof \ReflectionNamedType && !$type->isBuiltin()) {
+                        $className = $type->getName();
+                        if ($schemaAnnotation = $analysis->getAnnotationForSource($className, OA\Schema::class)) {
+                            $requestBody->ref = OA\Components::ref($schemaAnnotation);
+                        }
+                    }
+                }
+
                 if (Generator::isDefault($requestBody->required)) {
                     $requestBody->required = !$schema->isNullable();
                 }

tests/Fixtures/Scratch/RequestBody.php

@@ -89,4 +89,17 @@ public function postRef()
     public function postRefFoo(#[OAT\RequestBody] RequestBodyRefFoo $body)
     {
     }
+
+    #[OAT\Post(
+        path: '/endpoint/schema-param',
+        responses: [
+            new OAT\Response(
+                response: 200,
+                description: 'All good'
+            ),
+        ]
+    )]
+    public function postSchemaParam(#[OAT\RequestBody] RequestBodySchema $body)
+    {
+    }
 }

tests/Fixtures/Scratch/RequestBody3.0.0-legacy.yaml

@@ -43,6 +43,14 @@ paths:
       responses:
         '200':
           description: 'All good'
+  /endpoint/schema-param:
+    post:
+      operationId: e9325a4f940b91d3babe398eeebd8426
+      requestBody:
+        $ref: '#/components/schemas/RequestBodySchema'
+      responses:
+        '200':
+          description: 'All good'
 components:
   schemas:
     RequestBodySchema: {  }

tests/Fixtures/Scratch/RequestBody3.0.0-type-info.yaml

@@ -43,6 +43,14 @@ paths:
       responses:
         '200':
           description: 'All good'
+  /endpoint/schema-param:
+    post:
+      operationId: e9325a4f940b91d3babe398eeebd8426
+      requestBody:
+        $ref: '#/components/schemas/RequestBodySchema'
+      responses:
+        '200':
+          description: 'All good'
 components:
   schemas:
     RequestBodySchema: {  }

tests/Fixtures/Scratch/RequestBody3.1.0-legacy.yaml

@@ -43,6 +43,14 @@ paths:
       responses:
         '200':
           description: 'All good'
+  /endpoint/schema-param:
+    post:
+      operationId: e9325a4f940b91d3babe398eeebd8426
+      requestBody:
+        $ref: '#/components/schemas/RequestBodySchema'
+      responses:
+        '200':
+          description: 'All good'
 components:
   schemas:
     RequestBodySchema: {  }

tests/Fixtures/Scratch/RequestBody3.1.0-type-info.yaml

@@ -43,6 +43,14 @@ paths:
       responses:
         '200':
           description: 'All good'
+  /endpoint/schema-param:
+    post:
+      operationId: e9325a4f940b91d3babe398eeebd8426
+      requestBody:
+        $ref: '#/components/schemas/RequestBodySchema'
+      responses:
+        '200':
+          description: 'All good'
 components:
   schemas:
     RequestBodySchema: {  }

tests/Fixtures/Scratch/RequestBody3.2.0-legacy.yaml

@@ -43,6 +43,14 @@ paths:
       responses:
         '200':
           description: 'All good'
+  /endpoint/schema-param:
+    post:
+      operationId: e9325a4f940b91d3babe398eeebd8426
+      requestBody:
+        $ref: '#/components/schemas/RequestBodySchema'
+      responses:
+        '200':
+          description: 'All good'
 components:
   schemas:
     RequestBodySchema: {  }

tests/Fixtures/Scratch/RequestBody3.2.0-type-info.yaml

@@ -43,6 +43,14 @@ paths:
       responses:
         '200':
           description: 'All good'
+  /endpoint/schema-param:
+    post:
+      operationId: e9325a4f940b91d3babe398eeebd8426
+      requestBody:
+        $ref: '#/components/schemas/RequestBodySchema'
+      responses:
+        '200':
+          description: 'All good'
 components:
   schemas:
     RequestBodySchema: {  }