Features

• add support for dependentRequired (75d7a66)

Bug Fixes

• an issue where deprecation extension parsing would fail (5db8757)
• an issue where deprecation extension parsing would fail (b59864c)
• refactor ToIdentifier() to normalize flaggable enums (#2156) (b80e934)

Bug Fixes

• a bug where external reference loading for local files would not work on linux (df99a00)
• add meaningful exception message during validation (4a6547d)
• add meaningful exception message during validation (74d20ed)
• adds a cancellation token argument to external document loading (a5ffab1)
• parsing failure on nodes set to null (20aacc1)
• parsing failure on nodes set to null (4245de9)

Bug Fixes

• do not write null for types on parameters in v2 (f889937)
• do not write null for types on parameters in v2 (4aef7b7)

Features

• adds a net8 target to benefit from all the conditional compilation (a201aa2)
• adds components registration method for schemas (10e548a)
• adds deconstructor to read result (79336f6)
• adds deconstructor to read result (d8c1593)
• adds to identifier mapping to non nullable enum (bd9622e)
• bumps target OAS version to 3.1.1 (9e8d8a4)
• configure AOT for trimming compatibility (b4f9c3e)
• makes document optional (754f763)
• makes the reference interface covariant (7405f3c)
• splits described and summarized interfaces (2a10cd9)

Bug Fixes

• 3.0 serialization when type is set to null (920a51a)
• a bug where 3.0 downcast of type null would not work (6b636d5)
• a bug where 3.0 downcast of type null would not work (ac05342)
• a flaky behaviour for format property serialization (3ea1fa9)
• a flaky behaviour for format property serialization (52981d4)
• additional 3.1.0 constants after merge and v2 release (9e8d8a4)
• adds generic shallow copy method to avoid inadvertent conversions of references to schemas (e4c14a4)
• adds missing culture argument to date serialization (45329e4)
• adds missing null prop operator to proxy properties (8361069)
• adds missing null propagation operators for callback and header references (0cb4ccb)
• adds support for all component types (8a73b54)
• aligns callback parameter name with interface (68b25cc)
• aligns missing properties for override (e3325b9)
• aligns parameter name with interface definition for example (d7e1f91)
• aligns reference copy constructors (ce93aa7)
• aligns to null propagation operator (8d57b81)
• allow registration of component references (14750dc)
• an empty security requirement should not result in an object during serialization (1c6fd8e)
• build passes (ea68427)
• callback reference proxy implementation (028d60b)
• callback reference proxy implementation (2cbb0fa)
• components schema copy (88daad5)
• conditional version for extension causes invalid json (4030c1f)
• conditional version for extension causes invalid json (0ce92cc)
• date time and date time offset shifting zones (a6a44a7)
• default settings in case of null value (ab2ddf0)
• do not allow null argument for example copy constructor (aa80b19)
• do not copy host document as it negatively impact performance (1043e4e)
• do not copy host document as it negatively impact performance (a46e857)
• do not emit a type array in 3.1 when unnecessary (3b3d0e6)
• draft security scheme reference proxy design pattern (1bd2624)
• empty security requirements are actually valid. to negate the document ones (42bd396)
• enum description number values (ff7b4a9)
• enum description number values (e29e24c)
• enum parsing when encountering unknown values should not default to first member (d4e155b)
• enum parsing when encountering unknown values should not default to first member (9d07ebb)
• extensions collection initialization (4f28b65)
• extraneous null prop removal (1006879)
• failing unit test after merge (a4ac872)
• failing unit tests for security scheme references in security requirements (d2e4111)
• fixes inlining override when they should not happen (704943c)
• fixes invalid OAI document for unit tests (837f000)
• inconsistant API surface usage (47ad76b)
• last reference to copy constructor (d87375d)
• makes reference fields immutable (fda05d4)
• makes reference of holder immutable (a182f44)
• makes target field read only (89881fd)
• missing defensive programming in copy constructors (227d99d)
• missing doc comment for annotations (41759a1)
• missing null prop operator on parameter reference (019eb99)
• missing property rename (2443fa0)
• multiple performance fixes for type serialization (bd9622e)
• multiple performance fixes for type serialization feat: adds to identifier mapping to non nullable enum (5fef51c)
• multiple unit test failures (2f171a3)
• null flag comparison (081e251)
• null propagation for most failed reference lookup (7994691)
• null reference check (a5023d6)
• Open API header proxy design pattern implementation (77e0ad1)
• open API link reference proxy design pattern implementation (6a96462)
• open API link reference proxy design pattern implementation (376e54d)
• open api response reference should not clone objects (4243873)
• open api schema reference proxy design pattern implementation (e57d049)
• open api schema reference proxy design pattern implementation (aebefb7)
• parameter reference proxy design pattern implementation (ed6ffa1)
• parameter reference proxy design pattern implementation (eeb79a4)
• passes missing host document references to all layers (d7c4621)
• passes missing host document references to all layers (ff1406c)
• path item reference implementation (56f291b)
• path item reference implementation (c725267)
• potential NRT (9db6e2d)
• potential NRT for net8 build (f517deb)
• proxy design pattern implementation for OpenAPiExample (cc28ff2)
• proxy design pattern implementation for request body (425335e)
• references callback writer (88ad997)
• removes all obsolete APIs (e861c08)
• removes extraneuous null prop op in copy constructor (227d99d)
• removes nullable property that shouldn't be part of dom (4d9c17b)
• removes redundant assignment (8d70195)
• removes unnecessary null prop in copy constructor (aa993b1)
• removes unused parameters (de9d979)
• removes unused parameters (9cd7aae)
• removes useless condition for null check (4a50c77)
• removes useless virtual definitions in components (af3038a)
• removes virtual modifier in MediaType (4dfc9b8)
• request body references are converted to v2 properly (b84ea19)
• response reference proxy design pattern implementation (8103c20)
• response reference proxy design pattern implementation (5b4003b)
• restores default constructor for ISerializable implementation (778184f)
• returns reference instead of null (45e40fa)
• sets hidi version to a preview (975b1bf)
• sets hidi version to a preview (8999336)
• shallow copy for callback (4ea87ef)
• shallow copy for example (9bc3044)
• shallow copy for parameter link path item and request body (9af6f30)
• side effects in tag references (717deb0)
• side effects in tag references (878593b)
• single copy and maintain for references (30ee6ed)
• specifies encoding for net fx (95dafe6)
• specifies encoding for net fx (cd13481)
• support non-standard MIME type in response header (50ddca2)
• switches header to shallow copy (2a42c36)
• tag reference proxy design pattern implementation (46e08d4)
• tag, response, and security scheme shallow copy (7ac149c)
• updates public api file (b727581)
• updates public API surface with net8 target (1a1e013)
• uses backing fields instead of schema copy (6f4e7a2)
• uses the json node clone API to avoid unecessary allocs (818414d)
• v2 references for properties do not work as expected (aa90edf)
• v2 references for properties do not work as expected (ec9c01b)
• v2 request body content null propagation (6d064c4)
• v2 request body content null propagation (8b4833c)
• visibility of serialize internal methods (dc8a757)

Performance Improvements

• avoid round trip serialization (a6a44a7)

Features

• deduplicates tags at the document level (93c468e)
• tags references are now deduplicated as well (763c0c1)

Bug Fixes

• add logic for serializing date time objects (23395c5)
• adds missing cancellation parameter to async method (243a111)
• avoid creating new http clients to load additional documents of the workspace (0f23798)
• deduplicates exclusive min/max properties in the object model (08414a1)
• deduplicates exclusive min/max properties in the object model (0d5b471)
• moves the http client for the reader to settings so it can be passed by client application (9b910f3)
• OpenAPIDocument JsonSchemaDialect property is now a URI (45977b5)
• openapischema schema property is now a Uri (452a6b9)
• primitive parsing for strings as DateTimes is too greedy (4ee1d8b)
• removes static readers registry (fe7a2fd)
• use a single http client in hidi (9386fae)

1.6.31 (2026-08-20)

Bug Fixes

• circular ref guard (#3042) (02369d0)
• harden yaml parsing (v1 port) (#3040) (838c847)

1.6.30 (2026-08-13)

Bug Fixes

• readers: bound YAML anchor/alias expansion to prevent OOM (billion laughs) (1f9aea9)