chore(main): release 3.3.1 - #3017

🤖 I have created a release beep boop

3.3.1 (2026-08-12)

Features

• Add type: "null" downcasting when in oneOf and anyOf for OpenAPI v3 (782cf8d)
• add contains/minContains/maxContains members (78475e3)
• add contains/minContains/maxContains members (1a974f8)
• add JsonConverter for OpenApiSchema System.Text.Json serialization (#2915) (2f8b3d2)
• adds deserialization of the example extension (e5a1080)
• adds support for anchor and id external resolution (1591007)
• do not ignore multiple types when serializing to 3.0 (#2960) (ebaf27a)
• hidi validate command now logs warnings (76a3c0f)
• hidi validate command now logs warnings (1d3d085)
• hidi validate command now logs warnings (18ed5ac)
• hidi validate command now logs warnings (62e7d56)
• library: add Extensions support for schema references in v3.1/v3.2; add SerializeAsV32 with loop detection (9b422bf)
• library: add missing json schema properties (9b1aed6)
• library: add missing json schema properties (82f84e0)
• library: preserve PatternProperties as x-jsonschema-patternProperties extension for OpenAPI v2/v3.0 serialization (d969fdc)
• library: Preserve PatternProperties via x-jsonschema-patternProperties extension for OpenAPI v2/v3.0 (16ab5e4)
• library: support schema keywords on references (434b2f8)
• library: support schema keywords on references (66a9d04), closes #2903
• models: add shared Content interface (80e4bbf)
• models: add shared Content interface (9e13b25)
• models: add shared Content interface (#2695) (338566f)
• models: add shared Content interface (#2695) (80e4bbf)
• models: add shared Content interface (#2695) (9e13b25)
• models: support mutualTLS security scheme (f9cf5b8)
• models: support mutualTLS security scheme (a4efdfe)
• reader: remove ParseNode infrastructure (9b4f45b)
• reader: remove ParseNode infrastructure (157e72b)
• schema: resolve bare $dynamicRef via $dynamicAnchor index (#2913) (eacc2fc)
• securityscheme: add oauth2MetadataUrl support (OpenAPI 3.2) (4509488)
• serialize license identifier as extension for earlier versions (d090989)
• serialize license identifier as extension for earlier versions (60971ba)
• support relative URI resolution in $dynamicRef (#2928) (#2945) (821053b)

Bug Fixes

• a bug where path parameter validation would fail if they contained forbidden JSON pointer characters (ef55b2c)
• a bug where path parameter validation would fail if they contained forbidden JSON pointer characters (4b3164a)
• additional properties serialization should not emit a schema in v2 (946cba9)
• additional properties serialization should not emit a schema in v2 fix: additional properties serialization should not emit booleans in v3.1+ (275dd9d)
• additional properties serialization should not emit booleans in v3.1+ (946cba9)
• adds explicit error message for invalid json pointers (63fc55d)
• adds explicit error message for invalid json pointers (bc93efe)
• better nullability round-tripping (655c2c8)
• bound YAML anchor/alias expansion to prevent OOM (billion laughs) (#3000) (2179326)
• broken binary compatibility due to interface changes in previous version (d96bba7)
• correct error pointer when extension parser throws OpenApiException (43c75a9)
• default mapping is not being serialized with the correct shape (fe4a25f)
• deserialize metadata url from extension in earlier version (9387b01)
• differentiate unset value from null value in OpenApiSchema.Const (#2936) (07b525f)
• discriminator property validation fails any/allOf cases when it shouldn't (ff6e411)
• discriminator property validation fails any/allOf cases when it shouldn't (fb6cecc)
• discriminator property validation fails any/allOf cases when it shouldn't (7def73d)
• discriminator property validation fails any/allOf cases when it shouldn't (a8fb81c)
• Don't silently skip null assignment to OpenApiDocument.Tags (3764142)
• double encoding of json pointer for invalid reference rule (b246cd0)
• encoding of special characters for JSON paths (4c757e1)
• handle nullability more accurately during serialization for 3.0/2.0 (#2933) (0ace243)
• handling of nullable enums for 3.0 (#2920) (beb68f5)
• hidi: remove Humanizer.Inflections namespace for Humanizer 3.x compatibility (6cbf2ab)
• hidi: update Microsoft.OpenApi.OData to 3.2.1 (b0a68fb)
• hidi: update Microsoft.OpenApi.OData to 3.2.1 (8c22ab2), closes #2811
• implement unevaluatedProperties as schema per JSON Schema 2020-12 (#2728) (7c13fb3)
• library: always copy unevaluated properties (4907d1c)
• library: avoid false circular refs for external schema re-exports (b635242)
• library: avoid false circular refs for external schema re-exports (7a443c2)
• library: do not emit unevaluatedProperties for non-object schemas (852fb4c)
• library: do not emit unevaluatedProperties for non-object schemas (19538aa)
• library: enforce spec-compliant $ref serialization; add Extensions support for schema references in v3.1/v3.2 (9bf61de)
• library: handle circular schema references (b3cd42b)
• library: handle circular schema references (91a989f)
• library: keep v3 schema references ref-only (c938727)
• library: remove unshipped schema extension fallback (cf54bb3)
• library: serialize additionalProperties schema in OpenAPI V2 (f3165fa)
• library: serialize additionalProperties schema in OpenAPI V2 documents (3d07756)
• library: use version-specific schema keyword callbacks (6e22ec6)
• library: use x-jsonschema schema extensions (eb1891a)
• load JSON documents that are preceded by multiple whitespace (640e59a)
• load JSON documents that are preceded by multiple whitespace (6461bac)
• marks deprecated properties from the specification as obsolete (787b045)
• marks deprecated properties from the specification as obsolete (953c22a)
• non-seekable json streams would fail to load as a document (76b0159)
• non-seekable json streams would fail to load as a document (2436d73)
• null reference exception for boolean component schemas (f97f91a)
• null reference exception for boolean component schemas (fe0b50a)
• optimize parsing V3.1 documents by reducing GetLocation method allocation on hot path(#2748) (f690681)
• potential double encoding of paths (471a61a)
• preserve JSON Schema 2020-12 keyword siblings on $ref schemas for OAS 3.1+ (#2896) (08160c8)
• reader: preserve Null flag when nullable appears before type in V3.0/V3.1/V3.2 deserializers (2b9d7f4)
• reader: preserve nullable Null flag when type appears after nullable in V3.1/V3.2 deserializers (94b606d)
• reading streams in an asp.net context would cause async exceptions (f9e5248)
• schema: always serialize additionalProperties: false (6651c36)
• schema: always serialize additionalProperties: false (e36fc95)
• schema: serialize compatibility examples from examples list (5d8ec3a)
• schema: support boolean schemas in deserializer for OpenAPI 3.1/3.2 (05b44be)
• security scheme references serialization (a5acb89)
• serialize examples as extension in v2/v3 (ff1dbc9)
• serialize examples as extension in v2/v3 (edf3c67)
• Support custom tag ordering (008576c)
• Support custom tag ordering (7610d07)
• use async method for crypto flush (6e675d9)
• validate required properties of security scheme before serialization (#2952) (f31b192)
• wrap extension parser calls in try-catch to ensure correct error pointers (63cf4a3)
• wrap extension parser calls in try-catch to ensure correct error pointers (458cabe)
• wrap extension parser calls in try-catch to ensure correct error pointers (50b44aa)

Performance Improvements

• schema: optimize boolean schema deserialization (7316e3f)

This PR was generated with Release Please. See documentation.