@speclynx/apidom-reference 5.2.7 → 6.0.1

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [6.0.1](https://github.com/speclynx/apidom/compare/v6.0.0...v6.0.1) (2026-10-15)
+
+**Note:** Version bump only for package @speclynx/apidom-reference
+
+# [6.0.0](https://github.com/speclynx/apidom/compare/v5.2.7...v6.0.0) (2026-10-15)
+
+### Bug Fixes
+
+- **reference:** keep authority of network-path references ([14eb9a1](https://github.com/speclynx/apidom/commit/14eb9a10ae78e80a2b06b7d711eec54f375e1c0b))
+- **reference:** keep source position of dereferenced action refs ([1501cd0](https://github.com/speclynx/apidom/commit/1501cd074f99901e24ae74d66861bf0f18f839b3))
+
+### Features
+
+- **reference:** dereference overlay reusable action references ([ee5d4e1](https://github.com/speclynx/apidom/commit/ee5d4e1fbaf816318901707fe05100a9cadb72bd))
+- **reference:** resolve overlay extends against $self ([d002292](https://github.com/speclynx/apidom/commit/d00229286bcad30b30cd2df9080e8762f2a46b6a))
+
 ## [5.2.7](https://github.com/speclynx/apidom/compare/v5.2.6...v5.2.7) (2026-10-13)
 
 ### Bug Fixes

package/README.md

@@ -543,6 +543,8 @@ Supported media types are:
   'application/vnd.oai.overlay+json;version=1.0.0',
   'application/vnd.oai.overlay;version=1.1.0',
   'application/vnd.oai.overlay+json;version=1.1.0',
+  'application/vnd.oai.overlay;version=1.2.0',
+  'application/vnd.oai.overlay+json;version=1.2.0',
 ]
 ```
 
@@ -556,6 +558,7 @@ Parser-specific options take precedence over global options.
 
   The parsed extends document is added with an `'extends'` class and `retrievalURI` metadata.
   A `ParseResultElement` is also attached to the extends element's meta as `'parseResult'`.
+  The `extends` URI is resolved against the Overlay document's base URI (its `$self` field when present, otherwise its retrieval URI).
 
 ##### Error handling
 
@@ -656,6 +659,8 @@ Supported media types are:
   'application/vnd.oai.overlay+yaml;version=1.0.0',
   'application/vnd.oai.overlay;version=1.1.0',
   'application/vnd.oai.overlay+yaml;version=1.1.0',
+  'application/vnd.oai.overlay;version=1.2.0',
+  'application/vnd.oai.overlay+yaml;version=1.2.0',
 ]
 ```
 
@@ -669,6 +674,7 @@ Parser-specific options take precedence over global options. See [overlay-json-1
 
   The parsed extends document is added with an `'extends'` class and `retrievalURI` metadata.
   A `ParseResultElement` is also attached to the extends element's meta as `'parseResult'`.
+  The `extends` URI is resolved against the Overlay document's base URI (its `$self` field when present, otherwise its retrieval URI).
 
 ##### Error handling
 
@@ -1645,6 +1651,9 @@ Supported media types:
   'application/vnd.oai.overlay;version=1.1.0',
   'application/vnd.oai.overlay+json;version=1.1.0',
   'application/vnd.oai.overlay+yaml;version=1.1.0',
+  'application/vnd.oai.overlay;version=1.2.0',
+  'application/vnd.oai.overlay+json;version=1.2.0',
+  'application/vnd.oai.overlay+yaml;version=1.2.0',
 ]
 ```
 
@@ -2192,7 +2201,16 @@ dereferenceSourceDescriptions(
 
 ##### [overlay-1](https://github.com/speclynx/apidom/tree/main/packages/apidom-reference/src/dereference/strategies/overlay-1)
 
-Dereference strategy for dereferencing [Overlay 1.x](https://spec.openapis.org/overlay/v1.1.0.html) definitions.
+Dereference strategy for dereferencing [Overlay 1.x](https://spec.openapis.org/overlay/v1.2.0.html) definitions.
+
+[Reusable Action References](https://spec.openapis.org/overlay/v1.2.0.html#reusable-action-reference-object) (Overlay 1.2.0)
+in `actions` are replaced with the Action Objects they resolve to in `components.actions`. The reference provides `target`,
+and its `description` takes precedence over the one from the reusable action's `fields`. Every resolved Action Object
+carries `ref-fields`, `ref-origin` and `ref-type` meta. Reusable Action References are same-document references,
+so they are only dereferenced when `resolve.internal` is `true` (the default). As the specification requires,
+external references (relative or absolute URLs in `$ref`) are not supported and are reported as unresolvable. Unresolvable references
+raise `UnresolvableReferenceError`, honoring the `dereference.continueOnError` option; when errors are continued on,
+the reference is left in place.
 
 Supported media types:
 
@@ -2204,6 +2222,9 @@ Supported media types:
   'application/vnd.oai.overlay;version=1.1.0',
   'application/vnd.oai.overlay+json;version=1.1.0',
   'application/vnd.oai.overlay+yaml;version=1.1.0',
+  'application/vnd.oai.overlay;version=1.2.0',
+  'application/vnd.oai.overlay+json;version=1.2.0',
+  'application/vnd.oai.overlay+yaml;version=1.2.0',
 ]
 ```
 
@@ -2218,6 +2239,7 @@ Strategy-specific options take precedence over global options.
   The dereferenced extends document is added with an `'extends'` class and `retrievalURI` metadata.
   If the extends target was already parsed during the parse phase, it will be dereferenced in place
   without re-fetching.
+  The `extends` URI is resolved against the Overlay document's base URI (its `$self` field when present, otherwise its retrieval URI).
 
 ###### Error handling