@speclynx/apidom-reference 2.4.0 → 2.5.0

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [2.5.0](https://github.com/speclynx/apidom/compare/v2.4.0...v2.5.0) (2026-01-30)
+
+### Features
+
+- **reference:** add initial dereferencing strategy for Arazzo 1.x ([#54](https://github.com/speclynx/apidom/issues/54)) ([3561dbf](https://github.com/speclynx/apidom/commit/3561dbf34c417a9c945129acc529bd5fd825fd65))
+- **reference:** add JSON Schema dereferencing for Arazzo ([#56](https://github.com/speclynx/apidom/issues/56)) ([03bbd2c](https://github.com/speclynx/apidom/commit/03bbd2cc6a30a252c7e15d21abb687ba6888a60f))
+
 # [2.4.0](https://github.com/speclynx/apidom/compare/v2.3.0...v2.4.0) (2026-01-29)
 
 ### Features

package/README.md

@@ -1481,7 +1481,7 @@ const dereferenced = await dereferenceApiDOM(apidom, {
 #### [Dereference strategies](https://github.com/speclynx/apidom/tree/main/packages/apidom-reference/src/dereference/strategies)
 
 Dereference strategy determines how a document is internally or externally dereferenced. Depending on document `mediaType` option,
-every strategy differs significantly. `Dereference component` comes with four (4) default dereference strategies.
+every strategy differs significantly. `Dereference component` comes with six (6) default dereference strategies.
 
 #### [apidom](https://github.com/speclynx/apidom/tree/main/packages/apidom-reference/src/dereference/strategies/apidom)
 
@@ -1530,6 +1530,23 @@ Supported media types:
 ]
 ```
 
+##### [arazzo-1](https://github.com/speclynx/apidom/tree/main/packages/apidom-reference/src/dereference/strategies/arazzo-1)
+
+Dereference strategy for dereferencing [Arazzo 1.x](https://spec.openapis.org/arazzo/latest.html) definitions.
+
+Supported media types:
+
+```js
+[
+  'application/vnd.oai.workflows;version=1.0.0',
+  'application/vnd.oai.workflows+json;version=1.0.0',
+  'application/vnd.oai.workflows+yaml;version=1.0.0',
+  'application/vnd.oai.workflows;version=1.0.1',
+  'application/vnd.oai.workflows+json;version=1.0.1',
+  'application/vnd.oai.workflows+yaml;version=1.0.1',
+]
+```
+
 ##### [openapi-2](https://github.com/speclynx/apidom/tree/main/packages/apidom-reference/src/dereference/strategies/openapi-2)
 
 Dereference strategy for dereferencing [OpenApi 2.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md) definitions.
@@ -1606,6 +1623,7 @@ returns `true` or until entire list of strategies is exhausted (throws error).
   new OpenAPI3_0DereferenceStrategy(),
   new OpenAPI3_1DereferenceStrategy(),
   new AsyncAPI2DereferenceStrategy(),
+  new Arazzo1DereferenceStrategy(),
   new ApiDOMDereferenceStrategy(),
 ]
 ```
@@ -1616,6 +1634,7 @@ It's possible to **change** strategies **order globally** by mutating global `de
 ```js
 import { options } from '@speclynx/apidom-reference';
 import AsyncAPI2DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/asyncapi-2';
+import Arazzo1DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/arazzo-1';
 import OpenAPI2DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/openapi-2';
 import OpenAPI3_0DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/openapi-3-0';
 import OpenAPI3_1DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/openapi-3-1';
@@ -1626,6 +1645,7 @@ options.dereference.strategies = [
   new OpenAPI3_0DereferenceStrategy(),
   new OpenAPI3_1DereferenceStrategy(),
   new AsyncAPI2DereferenceStrategy(),
+  new Arazzo1DereferenceStrategy(),
   new ApiDOMDereferenceStrategy(),
 ];
 ```
@@ -1635,6 +1655,7 @@ To **change** the strategies **order** on ad-hoc basis:
 ```js
 import { dereference } from '@speclynx/apidom-reference';
 import AsyncAPI2DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/asyncapi-2';
+import Arazzo1DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/arazzo-1';
 import OpenAPI2DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/openapi-2';
 import OpenAPI3_0DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/openapi-3-0';
 import OpenAPI3_1DereferenceStrategy from '@speclynx/apidom-reference/dereference/strategies/openapi-3-1';
@@ -1648,6 +1669,7 @@ await dereference('/home/user/oas.json', {
   dereference: {
     strategies: [
       new AsyncAPI2DereferenceStrategy(),
+      new Arazzo1DereferenceStrategy(),
       new OpenAPI2DereferenceStrategy(),
       new OpenAPI3_0DereferenceStrategy(),
       new OpenAPI3_1DereferenceStrategy(),