@speclynx/apidom-reference 3.1.0 → 3.2.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.2.0](https://github.com/speclynx/apidom/compare/v3.1.0...v3.2.0) (2026-03-08)
+
+### Bug Fixes
+
+- **referece:** fix indirection leak in dereference strategies ([#141](https://github.com/speclynx/apidom/issues/141)) ([57ec415](https://github.com/speclynx/apidom/commit/57ec4153baade728681e43223d058ef35b707212))
+
+### Features
+
+- add keywords to all package.json files for npm search discoverability ([#142](https://github.com/speclynx/apidom/issues/142)) ([f6c2b38](https://github.com/speclynx/apidom/commit/f6c2b387db48427f0f12e3019e1bdb8d7e05dd00))
+
 # [3.1.0](https://github.com/speclynx/apidom/compare/v3.0.0...v3.1.0) (2026-03-08)
 
 ### Features

package/dist/apidom-reference.browser.js

@@ -1653,6 +1653,7 @@ class Arazzo1DereferenceVisitor {
       path.skip();
       return;
     }
+    const indirectionsSize = this.indirections.length;
     try {
       // compute baseURI using rules around $id and $ref keywords
       let reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_22__.unsanitize(this.reference.uri));
@@ -1797,7 +1798,6 @@ class Arazzo1DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['arazzo-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -1830,7 +1830,6 @@ class Arazzo1DereferenceVisitor {
         // remove referencing reference from ancestors lineage
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       // Boolean JSON Schemas
       if ((0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_12__.isBooleanJSONSchemaElement)(referencedElement)) {
@@ -1873,6 +1872,8 @@ class Arazzo1DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Schema Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
 }
@@ -2229,6 +2230,7 @@ class AsyncAPI2DereferenceVisitor {
       return;
     }
     const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_18__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
+    const indirectionsSize = this.indirections.length;
     try {
       const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
@@ -2289,7 +2291,6 @@ class AsyncAPI2DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['asyncapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -2323,7 +2324,6 @@ class AsyncAPI2DereferenceVisitor {
         // remove referencing reference from ancestors lineage
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       // Boolean JSON Schemas
       if ((0,_speclynx_apidom_ns_asyncapi_2__WEBPACK_IMPORTED_MODULE_12__.isBooleanJSONSchemaElement)(referencedElement)) {
@@ -2358,6 +2358,8 @@ class AsyncAPI2DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Reference Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
   async ChannelItemElement(path) {
@@ -2388,6 +2390,7 @@ class AsyncAPI2DereferenceVisitor {
       return;
     }
     const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_18__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
+    const indirectionsSize = this.indirections.length;
     try {
       const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
@@ -2438,7 +2441,6 @@ class AsyncAPI2DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['asyncapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -2472,7 +2474,6 @@ class AsyncAPI2DereferenceVisitor {
         // remove referencing reference from ancestors lineage
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       /**
        * Creating a new version of Channel Item by merging fields from referenced Channel Item with referencing one.
@@ -2503,6 +2504,8 @@ class AsyncAPI2DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Channel Item Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
 }
@@ -2863,6 +2866,7 @@ class OpenAPI2DereferenceVisitor {
       return;
     }
     const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_20__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
+    const indirectionsSize = this.indirections.length;
     try {
       const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
@@ -2923,7 +2927,6 @@ class OpenAPI2DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['openapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -2955,7 +2958,6 @@ class OpenAPI2DereferenceVisitor {
         });
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       /**
        * Creating a new version of referenced element to avoid modifying the original one.
@@ -2976,6 +2978,8 @@ class OpenAPI2DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Reference Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
   async PathItemElement(path) {
@@ -3006,6 +3010,7 @@ class OpenAPI2DereferenceVisitor {
       return;
     }
     const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_20__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
+    const indirectionsSize = this.indirections.length;
     try {
       const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
@@ -3056,7 +3061,6 @@ class OpenAPI2DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['openapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -3090,7 +3094,6 @@ class OpenAPI2DereferenceVisitor {
         // remove referencing reference from ancestors lineage
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       /**
        * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
@@ -3122,6 +3125,8 @@ class OpenAPI2DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Path Item Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
   async JSONReferenceElement(path) {
@@ -3149,6 +3154,7 @@ class OpenAPI2DereferenceVisitor {
       return;
     }
     const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_20__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
+    const indirectionsSize = this.indirections.length;
     try {
       const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
@@ -3209,7 +3215,6 @@ class OpenAPI2DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['openapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -3243,7 +3248,6 @@ class OpenAPI2DereferenceVisitor {
         // remove referencing reference from ancestors lineage
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       /**
        * Creating a new version of referenced element to avoid modifying the original one.
@@ -3264,6 +3268,8 @@ class OpenAPI2DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing JSON Reference Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
 }
@@ -3623,6 +3629,7 @@ class OpenAPI3_0DereferenceVisitor {
       return;
     }
     const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_17__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
+    const indirectionsSize = this.indirections.length;
     try {
       const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
@@ -3683,7 +3690,6 @@ class OpenAPI3_0DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['openapi-3-0']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -3717,7 +3723,6 @@ class OpenAPI3_0DereferenceVisitor {
         // remove referencing reference from ancestors lineage
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       /**
        * Creating a new version of referenced element to avoid modifying the original one.
@@ -3738,6 +3743,8 @@ class OpenAPI3_0DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Reference Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
   async PathItemElement(path) {
@@ -3768,6 +3775,7 @@ class OpenAPI3_0DereferenceVisitor {
       return;
     }
     const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_17__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
+    const indirectionsSize = this.indirections.length;
     try {
       const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
@@ -3818,7 +3826,6 @@ class OpenAPI3_0DereferenceVisitor {
           });
           const replacer = this.options.dereference.strategyOpts['openapi-3-0']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
-          this.indirections.pop();
           path.replaceWith(replacement);
           return;
         }
@@ -3852,7 +3859,6 @@ class OpenAPI3_0DereferenceVisitor {
         // remove referencing reference from ancestors lineage
         directAncestors.delete(referencingElement);
       }
-      this.indirections.pop();
 
       /**
        * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
@@ -3883,6 +3889,8 @@ class OpenAPI3_0DereferenceVisitor {
     } catch (error) {
       const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Path Item Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
+    } finally {
+      if (this.indirections.length > indirectionsSize) this.indirections.pop();
     }
   }
   async LinkElement(path) {