Defer JsonContent creation to processors; support parameter-level JsonRequestBody

[DerManoMann]

Summary

• Move JsonContent creation from constructors into AugmentJsonResponse and AugmentJsonRequestBody processors — constructors now only record source
• Add TARGET_PARAMETER to JsonRequestBody attribute, enabling #[OAX\JsonRequestBody] on method parameters with type-hint inference
• AugmentJsonRequestBody dispatches based on source class annotation: #[OA\Schema] → inline JsonContent, #[OA\RequestBody] → component $ref
• Extract shared resolveDescription into Processors/Concerns/ResolvesDescription trait
• No swagger-php changes required — processor does its own reflection

New usage

// Parameter-level — ref inferred from type-hint
public function login(#[OAX\JsonRequestBody] LoginRequest $request)

// Explicit ref to a RequestBody component class
#[OAX\JsonRequestBody(ref: SharedCreateBody::class)]

Pipeline flow

Step 13: AugmentJsonRequestBody (extras) — resolves source, dispatches to JsonContent or component ref
Step 16: AugmentRefs (swagger-php) — resolves FQCN → #/components/schemas/...
Step 18: MergeJsonContent (swagger-php) — converts JsonContent → MediaType + Schema

Test plan

• Existing tests updated and passing (71 tests, 47832 assertions)
• New test: processor creates JsonContent when source is set
• New test: parameter type-hint resolution via ReflectionParameter
• New test: component $ref dispatch for RequestBody-annotated source classes
• Linting clean (cs-fixer + rector + phpstan)

🤖 Generated with Claude Code