Support OpenAPI 3.1/3.2 $dynamicRef resolution with ApiDOM

[aqeelat]

Summary

Proposed Swagger Client resolver work for OpenAPI 3.1/3.2 $dynamicRef schemas using ApiDOM. This issue is linked from the broader Swagger UI coordination issue so the prerequisite relationship is visible.

Reference implementation / showcase

• https://github.com/aqeelat/openapi-dynamicref-adoption-tracker/

The showcase repository includes OpenAPI examples used to validate that dynamic response envelopes and root-local #/components/... refs resolve as expected.

Related issues

• Related coordination issue: Proposal: coordinate $dynamicRef support across ApiDOM, Swagger Client, and Swagger UI swagger-ui#10912
• Depends on ApiDOM core support: Add $dynamicRef dereference support for OpenAPI 3.1 and 3.2 strategies apidom#5176
• Related user-facing Swagger UI bug: Issue: $dynamicRef is not supported in Swagger UI / OpenAPI 3.1 swagger-ui#10651
• Related non-blocking Swagger UI display enhancement: Show resolved schema names for $dynamicRef-bound properties swagger-ui#10913

Proposed scope

• Delegate schemas with $dynamicRef to ApiDOM's dereference logic.
• Resolve with full OpenAPI document context where dynamic scope requires root-level context.
• Preserve compatibility for root-local #/components/... refs inside schemas that also declare absolute $id values.
• Add regression coverage for a dynamic-ref response schema shape.