@speclynx/apidom-reference 4.7.0 → 4.7.1

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [4.7.1](https://github.com/speclynx/apidom/compare/v4.7.0...v4.7.1) (2026-04-16)
+
+### Bug Fixes
+
+- **reference:** prevent exponential tree growth on deref ([#244](https://github.com/speclynx/apidom/issues/244)) ([2873e2a](https://github.com/speclynx/apidom/commit/2873e2ac8a2489396091b6bdf321138a34398d44)), closes [#12](https://github.com/speclynx/apidom/issues/12)
+
 # [4.7.0](https://github.com/speclynx/apidom/compare/v4.6.0...v4.7.0) (2026-04-12)
 
 **Note:** Version bump only for package @speclynx/apidom-reference

package/dist/apidom-reference.browser.js

@@ -1659,6 +1659,7 @@ class Arazzo1DereferenceVisitor {
      * Transclude referencing element with merged referenced element.
      */
     path.replaceWith(mergedElement);
+    path.skip();
   }
   async JSONSchemaElement(path) {
     const referencingElement = path.node;
@@ -1819,6 +1820,7 @@ class Arazzo1DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['arazzo-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -1862,6 +1864,7 @@ class Arazzo1DereferenceVisitor {
         booleanJsonSchemaElement.meta.set('ref-origin', reference.uri);
         booleanJsonSchemaElement.meta.set('ref-type', referencingElement.element);
         path.replaceWith(booleanJsonSchemaElement);
+        path.skip();
         return;
       }
 
@@ -2318,6 +2321,7 @@ class AsyncAPI2DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['asyncapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -2362,6 +2366,7 @@ class AsyncAPI2DereferenceVisitor {
         booleanJsonSchemaElement.meta.set('ref-origin', reference.uri);
         booleanJsonSchemaElement.meta.set('ref-type', referencingElement.element);
         path.replaceWith(booleanJsonSchemaElement);
+        path.skip();
         return;
       }
 
@@ -2381,6 +2386,7 @@ class AsyncAPI2DereferenceVisitor {
        * Transclude referencing element with merged referenced element.
        */
       path.replaceWith(mergedElement);
+      path.skip();
     } 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);
@@ -2960,6 +2966,7 @@ class OpenAPI2DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -3007,6 +3014,7 @@ class OpenAPI2DereferenceVisitor {
        * Transclude referencing element with merged referenced element.
        */
       path.replaceWith(mergedElement);
+      path.skip();
     } 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);
@@ -3094,6 +3102,7 @@ class OpenAPI2DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -3248,6 +3257,7 @@ class OpenAPI2DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-2']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -3297,6 +3307,7 @@ class OpenAPI2DereferenceVisitor {
        * Transclude referencing element with merged referenced element.
        */
       path.replaceWith(mergedElement);
+      path.skip();
     } 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);
@@ -3729,6 +3740,7 @@ class OpenAPI3_0DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-3-0']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -3778,6 +3790,7 @@ class OpenAPI3_0DereferenceVisitor {
        * Transclude referencing element with merged referenced element.
        */
       path.replaceWith(mergedElement);
+      path.skip();
     } 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);
@@ -3865,6 +3878,7 @@ class OpenAPI3_0DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-3-0']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -4734,6 +4748,7 @@ class OpenAPI3_1DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -4886,6 +4901,7 @@ class OpenAPI3_1DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -5242,6 +5258,7 @@ class OpenAPI3_1DereferenceVisitor {
           const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
           path.replaceWith(replacement);
+          path.skip();
           return;
         }
       }
@@ -5283,6 +5300,7 @@ class OpenAPI3_1DereferenceVisitor {
         booleanJsonSchemaElement.meta.set('ref-origin', reference.uri);
         booleanJsonSchemaElement.meta.set('ref-type', referencingElement.element);
         path.replaceWith(booleanJsonSchemaElement);
+        path.skip();
         return;
       }
 
@@ -99331,11 +99349,6 @@ function* traverseGenerator(root, visitor, options) {
         if (currentPath.shouldStop) {
           break;
         }
-        if (currentPath.shouldSkip) {
-          if (!isLeaving) {
-            continue;
-          }
-        }
         if (currentPath.removed) {
           edits.push([key, null]);
           if (!isLeaving) {
@@ -99345,12 +99358,19 @@ function* traverseGenerator(root, visitor, options) {
           const replacement = currentPath._getReplacementNode();
           edits.push([key, replacement]);
           if (!isLeaving) {
+            if (currentPath.shouldSkip) {
+              continue;
+            }
             if (nodePredicate(replacement)) {
               node = replacement;
             } else {
               continue;
             }
           }
+        } else if (currentPath.shouldSkip) {
+          if (!isLeaving) {
+            continue;
+          }
         } else if (result !== undefined) {
           // Support return value replacement for backwards compatibility
           edits.push([key, result]);