[release/10.0] Update OpenApi to 2.12

[Youssef1313]

No description provided.

[Copilot]

Pull request overview

Updates the repository’s dependency version constraints for the Microsoft.OpenApi and Microsoft.OpenApi.YamlReader packages to allow resolving OpenApi 2.12.x (while still preventing 3.x).

Changes:

• Bumped MicrosoftOpenApiVersion minimum from 2.7.5 to 2.12.0 (range remains < 3.0.0).
• Bumped MicrosoftOpenApiYamlReaderVersion minimum from 2.7.5 to 2.12.0 (range remains < 3.0.0).

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

[Youssef1313]

@copilot OpenApiSchema.Example is now deprecated. Update the usage to OpenApiSchema.Examples.

[Copilot]

@copilot OpenApiSchema.Example is now deprecated. Update the usage to OpenApiSchema.Examples.

Done in a02b7c9 — the XML comment schema transformer now sets schema.Examples = [example] instead of the deprecated schema.Example. Generator snapshots and tests were updated, along with the OpenAPI 3.1 integration snapshots (3.1 now serializes examples: [...]; 3.0 output is unchanged since a single-item Examples still writes example).

Note: OpenApiDocumentIntegrationTests.VerifyOpenApiDocument(documentName: "schemas-by-ref", version: OpenApi3_0) fails on this branch independently of this change — with 2.12, nullable schema references now serialize as oneOf: [{ "enum": [null], "nullable": true }, { "$ref": ... }] instead of the previous type: object + nullable: true shape. I left that snapshot alone since it's a library behavior change worth a deliberate decision.

[Youssef1313]

@copilot Don't move the Parse call around. Keep the original structure.

[Copilot]

Reverted in 3b7cb1e — back to if (typeComment.Examples?.FirstOrDefault() is { } jsonString) with schema.Examples = [jsonString.Parse()!];, matching the existing x-ref-example pattern below. Snapshots regenerated.