Add wrap parameter to JsonResponse

[DerManoMann]

Summary

• Add wrap parameter to JsonResponse (Attributes + Annotations), default 'data'
• Processor generates an inline wrapper schema with the wrap key as a required property containing the $ref
• Remove DataSchema — wrapping is a transport concern, not a data shape concern (see ADR-004)
• Move $_blacklist from JsonContentTrait to each consuming class

Usage

// Wrapped (default): {"data": {$ref: UserResource}}
#[OAX\JsonResponse(response: 200, ref: UserResource::class)]

// Custom wrap key: {"result": {$ref: UserResource}}
#[OAX\JsonResponse(response: 200, ref: UserResource::class, wrap: 'result')]

// Unwrapped — use the regular response annotation
#[OAT\Response(response: 200, content: new OAT\JsonContent(ref: UserResource::class))]

Breaking changes

• DataSchema removed — use OA\Schema on resources, wrapping now lives on the response attribute
• JsonResponse now wraps by default — existing bare-ref responses will gain an envelope

Test plan

• Existing tests updated and passing (70 tests)
• New tests for default wrap and custom wrap key
• composer test (PHPUnit + CS Fixer + Rector) green

🤖 Generated with Claude Code