swagger-client 3.27.8 → 3.28.0

package/lib/resolver/apidom/reference/dereference/strategies/openapi-3-1-swagger-client/visitors/dereference.js

@@ -23,420 +23,463 @@ const {
 const visitAsync = _apidomCore.visit[Symbol.for('nodejs.util.promisify.custom')];
 
 // initialize element identity manager
-const identityManager = (0, _apidomCore.IdentityManager)();
-const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1DereferenceVisitor.compose({
-  props: {
-    useCircularStructures: true,
-    allowMetaPatches: false,
-    basePath: null
-  },
-  init({
-    allowMetaPatches = this.allowMetaPatches,
-    useCircularStructures = this.useCircularStructures,
-    basePath = this.basePath
+const identityManager = new _apidomCore.IdentityManager();
+class OpenAPI3_1SwaggerClientDereferenceVisitor extends _openapi.OpenAPI3_1DereferenceVisitor {
+  useCircularStructures;
+  allowMetaPatches;
+  basePath;
+  constructor({
+    allowMetaPatches = true,
+    useCircularStructures = false,
+    basePath = null,
+    ...rest
   }) {
+    super(rest);
     this.allowMetaPatches = allowMetaPatches;
     this.useCircularStructures = useCircularStructures;
     this.basePath = basePath;
-  },
-  methods: {
-    async ReferenceElement(referencingElement, key, parent, path, ancestors) {
-      try {
-        // skip current referencing element as it's already been access
-        if (this.indirections.includes(referencingElement)) {
-          return false;
-        }
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
-        const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(referencingElement.$ref));
-        const isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
-        const isExternalReference = !isInternalReference;
-
-        // ignore resolving internal Reference Objects
-        if (!this.options.resolve.internal && isInternalReference) {
-          return false;
-        }
-        // ignore resolving external Reference Objects
-        if (!this.options.resolve.external && isExternalReference) {
-          return false;
-        }
-        const reference = await this.toReference((0, _apidomCore.toValue)(referencingElement.$ref));
-        const $refBaseURI = _empty.url.resolve(retrievalURI, (0, _apidomCore.toValue)(referencingElement.$ref));
-        this.indirections.push(referencingElement);
-        const jsonPointer = (0, _apidomJsonPointer.uriToPointer)($refBaseURI);
-
-        // possibly non-semantic fragment
-        let referencedElement = (0, _apidomJsonPointer.evaluate)(jsonPointer, reference.value.result);
-        referencedElement.id = identityManager.identify(referencedElement);
-
-        // applying semantics to a fragment
-        if ((0, _apidomCore.isPrimitiveElement)(referencedElement)) {
-          const referencedElementType = (0, _apidomCore.toValue)(referencingElement.meta.get('referenced-element'));
-          const cacheKey = `${referencedElementType}-${(0, _apidomCore.toValue)(identityManager.identify(referencedElement))}`;
-          if (this.refractCache.has(cacheKey)) {
-            referencedElement = this.refractCache.get(cacheKey);
-          } else if ((0, _apidomNsOpenapi.isReferenceLikeElement)(referencedElement)) {
-            // handling indirect references
-            referencedElement = _apidomNsOpenapi.ReferenceElement.refract(referencedElement);
-            referencedElement.setMetaProperty('referenced-element', referencedElementType);
-            this.refractCache.set(cacheKey, referencedElement);
-          } else {
-            // handling direct references
-            const ElementClass = this.namespace.getElementClass(referencedElementType);
-            referencedElement = ElementClass.refract(referencedElement);
-            this.refractCache.set(cacheKey, referencedElement);
-          }
-        }
-
-        // detect direct or indirect reference
-        if (referencingElement === referencedElement) {
-          throw new _apidomError.ApiDOMError('Recursive Reference Object detected');
+  }
+  async ReferenceElement(referencingElement, key, parent, path, ancestors) {
+    try {
+      // skip current referencing element as it's already been access
+      if (this.indirections.includes(referencingElement)) {
+        return false;
+      }
+      const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+      const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(referencingElement.$ref));
+      const isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
+      const isExternalReference = !isInternalReference;
+
+      // ignore resolving internal Reference Objects
+      if (!this.options.resolve.internal && isInternalReference) {
+        return false;
+      }
+      // ignore resolving external Reference Objects
+      if (!this.options.resolve.external && isExternalReference) {
+        return false;
+      }
+      const reference = await this.toReference((0, _apidomCore.toValue)(referencingElement.$ref));
+      const $refBaseURI = _empty.url.resolve(retrievalURI, (0, _apidomCore.toValue)(referencingElement.$ref));
+      this.indirections.push(referencingElement);
+      const jsonPointer = (0, _apidomJsonPointer.uriToPointer)($refBaseURI);
+
+      // possibly non-semantic fragment
+      let referencedElement = (0, _apidomJsonPointer.evaluate)(jsonPointer, reference.value.result);
+      referencedElement.id = identityManager.identify(referencedElement);
+
+      // applying semantics to a fragment
+      if ((0, _apidomCore.isPrimitiveElement)(referencedElement)) {
+        const referencedElementType = (0, _apidomCore.toValue)(referencingElement.meta.get('referenced-element'));
+        const cacheKey = `${referencedElementType}-${(0, _apidomCore.toValue)(identityManager.identify(referencedElement))}`;
+        if (this.refractCache.has(cacheKey)) {
+          referencedElement = this.refractCache.get(cacheKey);
+        } else if ((0, _apidomNsOpenapi.isReferenceLikeElement)(referencedElement)) {
+          // handling indirect references
+          referencedElement = _apidomNsOpenapi.ReferenceElement.refract(referencedElement);
+          referencedElement.setMetaProperty('referenced-element', referencedElementType);
+          this.refractCache.set(cacheKey, referencedElement);
+        } else {
+          // handling direct references
+          const ElementClass = this.namespace.getElementClass(referencedElementType);
+          referencedElement = ElementClass.refract(referencedElement);
+          this.refractCache.set(cacheKey, referencedElement);
         }
+      }
 
-        // detect maximum depth of dereferencing
-        if (this.indirections.length > this.options.dereference.maxDepth) {
-          throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
-        }
+      // detect direct or indirect reference
+      if (referencingElement === referencedElement) {
+        throw new _apidomError.ApiDOMError('Recursive Reference Object detected');
+      }
 
-        // detect second deep dive into the same fragment and avoid it
-        if (ancestorsLineage.includes(referencedElement)) {
-          reference.refSet.circular = true;
-          if (this.options.dereference.circular === 'error') {
-            throw new _apidomError.ApiDOMError('Circular reference detected');
-          } else if (this.options.dereference.circular === 'replace') {
-            var _this$options$derefer, _this$options$derefer2;
-            const refElement = new _apidomCore.RefElement(referencedElement.id, {
-              type: 'reference',
-              uri: reference.uri,
-              $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
-              baseURI: $refBaseURI,
-              referencingElement
-            });
-            const replacer = (_this$options$derefer = (_this$options$derefer2 = this.options.dereference.strategyOpts['openapi-3-1']) == null ? void 0 : _this$options$derefer2.circularReplacer) != null ? _this$options$derefer : this.options.dereference.circularReplacer;
-            const replacement = replacer(refElement);
-            if ((0, _apidomCore.isMemberElement)(parent)) {
-              parent.value = replacement; // eslint-disable-line no-param-reassign
-            } else if (Array.isArray(parent)) {
-              parent[key] = replacement; // eslint-disable-line no-param-reassign
-            }
-            return !parent ? replacement : false;
-          }
-        }
+      // detect maximum depth of dereferencing
+      if (this.indirections.length > this.options.dereference.maxDepth) {
+        throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      }
 
-        /**
-         * Dive deep into the fragment.
-         *
-         * Cases to consider:
-         *  1. We're crossing document boundary
-         *  2. Fragment is from non-root document
-         *  3. Fragment is a Reference Object. We need to follow it to get the eventual value
-         *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
-         */
-        const isNonRootDocument = _empty.url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
-        const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-        if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isReferenceElement)(referencedElement) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
-          var _this$basePath;
-          // append referencing reference to ancestors lineage
-          directAncestors.add(referencingElement);
-          const visitor = OpenApi3_1SwaggerClientDereferenceVisitor({
-            reference,
-            namespace: this.namespace,
-            indirections: [...this.indirections],
-            options: this.options,
-            refractCache: this.refractCache,
-            ancestors: ancestorsLineage,
-            allowMetaPatches: this.allowMetaPatches,
-            useCircularStructures: this.useCircularStructures,
-            basePath: (_this$basePath = this.basePath) != null ? _this$basePath : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref']
+      // detect second deep dive into the same fragment and avoid it
+      if (ancestorsLineage.includes(referencedElement)) {
+        reference.refSet.circular = true;
+        if (this.options.dereference.circular === 'error') {
+          throw new _apidomError.ApiDOMError('Circular reference detected');
+        } else if (this.options.dereference.circular === 'replace') {
+          var _this$options$derefer, _this$options$derefer2;
+          const refElement = new _apidomCore.RefElement(referencedElement.id, {
+            type: 'reference',
+            uri: reference.uri,
+            $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
+            baseURI: $refBaseURI,
+            referencingElement
           });
-          referencedElement = await visitAsync(referencedElement, visitor, {
-            keyMap: _apidomNsOpenapi.keyMap,
-            nodeTypeGetter: _apidomNsOpenapi.getNodeType
-          });
-
-          // remove referencing reference from ancestors lineage
-          directAncestors.delete(referencingElement);
+          const replacer = (_this$options$derefer = (_this$options$derefer2 = this.options.dereference.strategyOpts['openapi-3-1']) == null ? void 0 : _this$options$derefer2.circularReplacer) != null ? _this$options$derefer : this.options.dereference.circularReplacer;
+          const replacement = replacer(refElement);
+          if ((0, _apidomCore.isMemberElement)(parent)) {
+            parent.value = replacement; // eslint-disable-line no-param-reassign
+          } else if (Array.isArray(parent)) {
+            parent[key] = replacement; // eslint-disable-line no-param-reassign
+          }
+          return !parent ? replacement : false;
         }
-        this.indirections.pop();
-        const mergedElement = (0, _apidomCore.cloneShallow)(referencedElement);
+      }
 
-        // annotate fragment with info about original Reference element
-        mergedElement.setMetaProperty('ref-fields', {
-          $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
-          description: (0, _apidomCore.toValue)(referencingElement.description),
-          summary: (0, _apidomCore.toValue)(referencingElement.summary)
+      /**
+       * Dive deep into the fragment.
+       *
+       * Cases to consider:
+       *  1. We're crossing document boundary
+       *  2. Fragment is from non-root document
+       *  3. Fragment is a Reference Object. We need to follow it to get the eventual value
+       *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
+       */
+      const isNonRootDocument = _empty.url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+      const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
+      if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isReferenceElement)(referencedElement) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+        var _this$basePath;
+        // append referencing reference to ancestors lineage
+        directAncestors.add(referencingElement);
+        const visitor = new OpenAPI3_1SwaggerClientDereferenceVisitor({
+          reference,
+          namespace: this.namespace,
+          indirections: [...this.indirections],
+          options: this.options,
+          refractCache: this.refractCache,
+          ancestors: ancestorsLineage,
+          allowMetaPatches: this.allowMetaPatches,
+          useCircularStructures: this.useCircularStructures,
+          basePath: (_this$basePath = this.basePath) != null ? _this$basePath : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref']
+        });
+        referencedElement = await visitAsync(referencedElement, visitor, {
+          keyMap: _apidomNsOpenapi.keyMap,
+          nodeTypeGetter: _apidomNsOpenapi.getNodeType
         });
-        // annotate fragment with info about origin
-        mergedElement.setMetaProperty('ref-origin', reference.uri);
-        // annotate fragment with info about referencing element
-        mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
 
-        // override description and summary (outer has higher priority then inner)
-        if ((0, _apidomCore.isObjectElement)(referencedElement)) {
-          if (referencingElement.hasKey('description') && 'description' in referencedElement) {
-            mergedElement.remove('description');
-            mergedElement.set('description', referencingElement.get('description'));
-          }
-          if (referencingElement.hasKey('summary') && 'summary' in referencedElement) {
-            mergedElement.remove('summary');
-            mergedElement.set('summary', referencingElement.get('summary'));
-          }
+        // remove referencing reference from ancestors lineage
+        directAncestors.delete(referencingElement);
+      }
+      this.indirections.pop();
+      const mergedElement = (0, _apidomCore.cloneShallow)(referencedElement);
+
+      // annotate fragment with info about original Reference element
+      mergedElement.setMetaProperty('ref-fields', {
+        $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
+        description: (0, _apidomCore.toValue)(referencingElement.description),
+        summary: (0, _apidomCore.toValue)(referencingElement.summary)
+      });
+      // annotate fragment with info about origin
+      mergedElement.setMetaProperty('ref-origin', reference.uri);
+      // annotate fragment with info about referencing element
+      mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
+
+      // override description and summary (outer has higher priority then inner)
+      if ((0, _apidomCore.isObjectElement)(referencedElement)) {
+        if (referencingElement.hasKey('description') && 'description' in referencedElement) {
+          mergedElement.remove('description');
+          mergedElement.set('description', referencingElement.get('description'));
+        }
+        if (referencingElement.hasKey('summary') && 'summary' in referencedElement) {
+          mergedElement.remove('summary');
+          mergedElement.set('summary', referencingElement.get('summary'));
         }
+      }
 
-        // apply meta patches
-        if (this.allowMetaPatches && (0, _apidomCore.isObjectElement)(mergedElement)) {
-          // apply meta patch only when not already applied
-          if (!mergedElement.hasKey('$$ref')) {
-            const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
-            mergedElement.set('$$ref', baseURI);
-          }
+      // apply meta patches
+      if (this.allowMetaPatches && (0, _apidomCore.isObjectElement)(mergedElement)) {
+        // apply meta patch only when not already applied
+        if (!mergedElement.hasKey('$$ref')) {
+          const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
+          mergedElement.set('$$ref', baseURI);
         }
+      }
 
-        /**
-         * Transclude referencing element with merged referenced element.
-         */
-        if ((0, _apidomCore.isMemberElement)(parent)) {
-          parent.value = mergedElement; // eslint-disable-line no-param-reassign
-        } else if (Array.isArray(parent)) {
-          parent[key] = mergedElement; // eslint-disable-line no-param-reassign
-        }
+      /**
+       * Transclude referencing element with merged referenced element.
+       */
+      if ((0, _apidomCore.isMemberElement)(parent)) {
+        parent.value = mergedElement; // eslint-disable-line no-param-reassign
+      } else if (Array.isArray(parent)) {
+        parent[key] = mergedElement; // eslint-disable-line no-param-reassign
+      }
 
-        /**
-         * We're at the root of the tree, so we're just replacing the entire tree.
-         */
-        return !parent ? mergedElement : false;
-      } catch (error) {
-        var _this$basePath2, _this$options$derefer3;
-        const rootCause = (0, _getRootCause.default)(error);
-        const wrappedError = wrapError(rootCause, {
-          baseDoc: this.reference.uri,
-          $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
-          pointer: (0, _apidomJsonPointer.uriToPointer)((0, _apidomCore.toValue)(referencingElement.$ref)),
-          fullPath: (_this$basePath2 = this.basePath) != null ? _this$basePath2 : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref']
-        });
-        (_this$options$derefer3 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer3 = _this$options$derefer3.errors) == null || _this$options$derefer3.push == null || _this$options$derefer3.push(wrappedError);
+      /**
+       * We're at the root of the tree, so we're just replacing the entire tree.
+       */
+      return !parent ? mergedElement : false;
+    } catch (error) {
+      var _this$basePath2, _this$options$derefer3;
+      const rootCause = (0, _getRootCause.default)(error);
+      const wrappedError = wrapError(rootCause, {
+        baseDoc: this.reference.uri,
+        $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
+        pointer: (0, _apidomJsonPointer.uriToPointer)((0, _apidomCore.toValue)(referencingElement.$ref)),
+        fullPath: (_this$basePath2 = this.basePath) != null ? _this$basePath2 : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref']
+      });
+      (_this$options$derefer3 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer3 = _this$options$derefer3.errors) == null || _this$options$derefer3.push == null || _this$options$derefer3.push(wrappedError);
+      return undefined;
+    }
+  }
+  async PathItemElement(pathItemElement, key, parent, path, ancestors) {
+    try {
+      // ignore PathItemElement without $ref field
+      if (!(0, _apidomCore.isStringElement)(pathItemElement.$ref)) {
         return undefined;
       }
-    },
-    async PathItemElement(pathItemElement, key, parent, path, ancestors) {
-      try {
-        // ignore PathItemElement without $ref field
-        if (!(0, _apidomCore.isStringElement)(pathItemElement.$ref)) {
-          return undefined;
-        }
 
-        // skip current referencing element as it's already been access
-        if (this.indirections.includes(pathItemElement)) {
-          return false;
-        }
+      // skip current referencing element as it's already been access
+      if (this.indirections.includes(pathItemElement)) {
+        return false;
+      }
 
-        // skip already identified cycled Path Item Objects
-        if ((0, _apidomCore.includesClasses)(['cycle'], pathItemElement.$ref)) {
-          return false;
-        }
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
-        const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(pathItemElement.$ref));
-        const isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
-        const isExternalReference = !isInternalReference;
-
-        // ignore resolving internal Path Item Elements
-        if (!this.options.resolve.internal && isInternalReference) {
-          return undefined;
-        }
-        // ignore resolving external Path Item Elements
-        if (!this.options.resolve.external && isExternalReference) {
-          return undefined;
-        }
-        const reference = await this.toReference((0, _apidomCore.toValue)(pathItemElement.$ref));
-        const $refBaseURI = _empty.url.resolve(retrievalURI, (0, _apidomCore.toValue)(pathItemElement.$ref));
-        this.indirections.push(pathItemElement);
-        const jsonPointer = (0, _apidomJsonPointer.uriToPointer)($refBaseURI);
-
-        // possibly non-semantic referenced element
-        let referencedElement = (0, _apidomJsonPointer.evaluate)(jsonPointer, reference.value.result);
-        referencedElement.id = identityManager.identify(referencedElement);
-
-        // applying semantics to a referenced element
-        if ((0, _apidomCore.isPrimitiveElement)(referencedElement)) {
-          const cacheKey = `path-item-${(0, _apidomCore.toValue)(identityManager.identify(referencedElement))}`;
-          if (this.refractCache.has(cacheKey)) {
-            referencedElement = this.refractCache.get(cacheKey);
-          } else {
-            referencedElement = _apidomNsOpenapi.PathItemElement.refract(referencedElement);
-            this.refractCache.set(cacheKey, referencedElement);
-          }
-        }
+      // skip already identified cycled Path Item Objects
+      if ((0, _apidomCore.includesClasses)(['cycle'], pathItemElement.$ref)) {
+        return false;
+      }
+      const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+      const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(pathItemElement.$ref));
+      const isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
+      const isExternalReference = !isInternalReference;
 
-        // detect direct or indirect reference
-        if (pathItemElement === referencedElement) {
-          throw new _apidomError.ApiDOMError('Recursive Path Item Object reference detected');
+      // ignore resolving internal Path Item Elements
+      if (!this.options.resolve.internal && isInternalReference) {
+        return undefined;
+      }
+      // ignore resolving external Path Item Elements
+      if (!this.options.resolve.external && isExternalReference) {
+        return undefined;
+      }
+      const reference = await this.toReference((0, _apidomCore.toValue)(pathItemElement.$ref));
+      const $refBaseURI = _empty.url.resolve(retrievalURI, (0, _apidomCore.toValue)(pathItemElement.$ref));
+      this.indirections.push(pathItemElement);
+      const jsonPointer = (0, _apidomJsonPointer.uriToPointer)($refBaseURI);
+
+      // possibly non-semantic referenced element
+      let referencedElement = (0, _apidomJsonPointer.evaluate)(jsonPointer, reference.value.result);
+      referencedElement.id = identityManager.identify(referencedElement);
+
+      // applying semantics to a referenced element
+      if ((0, _apidomCore.isPrimitiveElement)(referencedElement)) {
+        const cacheKey = `path-item-${(0, _apidomCore.toValue)(identityManager.identify(referencedElement))}`;
+        if (this.refractCache.has(cacheKey)) {
+          referencedElement = this.refractCache.get(cacheKey);
+        } else {
+          referencedElement = _apidomNsOpenapi.PathItemElement.refract(referencedElement);
+          this.refractCache.set(cacheKey, referencedElement);
         }
+      }
 
-        // detect maximum depth of dereferencing
-        if (this.indirections.length > this.options.dereference.maxDepth) {
-          throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
-        }
+      // detect direct or indirect reference
+      if (pathItemElement === referencedElement) {
+        throw new _apidomError.ApiDOMError('Recursive Path Item Object reference detected');
+      }
 
-        // detect second deep dive into the same fragment and avoid it
-        if (ancestorsLineage.includes(referencedElement)) {
-          reference.refSet.circular = true;
-          if (this.options.dereference.circular === 'error') {
-            throw new _apidomError.ApiDOMError('Circular reference detected');
-          } else if (this.options.dereference.circular === 'replace') {
-            var _this$options$derefer4, _this$options$derefer5;
-            const refElement = new _apidomCore.RefElement(referencedElement.id, {
-              type: 'path-item',
-              uri: reference.uri,
-              $ref: (0, _apidomCore.toValue)(pathItemElement.$ref),
-              baseURI: $refBaseURI,
-              referencingElement: pathItemElement
-            });
-            const replacer = (_this$options$derefer4 = (_this$options$derefer5 = this.options.dereference.strategyOpts['openapi-3-1']) == null ? void 0 : _this$options$derefer5.circularReplacer) != null ? _this$options$derefer4 : this.options.dereference.circularReplacer;
-            const replacement = replacer(refElement);
-            if ((0, _apidomCore.isMemberElement)(parent)) {
-              parent.value = replacement; // eslint-disable-line no-param-reassign
-            } else if (Array.isArray(parent)) {
-              parent[key] = replacement; // eslint-disable-line no-param-reassign
-            }
-            return !parent ? replacement : false;
+      // detect maximum depth of dereferencing
+      if (this.indirections.length > this.options.dereference.maxDepth) {
+        throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      }
+
+      // detect second deep dive into the same fragment and avoid it
+      if (ancestorsLineage.includes(referencedElement)) {
+        reference.refSet.circular = true;
+        if (this.options.dereference.circular === 'error') {
+          throw new _apidomError.ApiDOMError('Circular reference detected');
+        } else if (this.options.dereference.circular === 'replace') {
+          var _this$options$derefer4, _this$options$derefer5;
+          const refElement = new _apidomCore.RefElement(referencedElement.id, {
+            type: 'path-item',
+            uri: reference.uri,
+            $ref: (0, _apidomCore.toValue)(pathItemElement.$ref),
+            baseURI: $refBaseURI,
+            referencingElement: pathItemElement
+          });
+          const replacer = (_this$options$derefer4 = (_this$options$derefer5 = this.options.dereference.strategyOpts['openapi-3-1']) == null ? void 0 : _this$options$derefer5.circularReplacer) != null ? _this$options$derefer4 : this.options.dereference.circularReplacer;
+          const replacement = replacer(refElement);
+          if ((0, _apidomCore.isMemberElement)(parent)) {
+            parent.value = replacement; // eslint-disable-line no-param-reassign
+          } else if (Array.isArray(parent)) {
+            parent[key] = replacement; // eslint-disable-line no-param-reassign
           }
+          return !parent ? replacement : false;
         }
+      }
 
-        /**
-         * Dive deep into the fragment.
-         *
-         * Cases to consider:
-         *  1. We're crossing document boundary
-         *  2. Fragment is from non-root document
-         *  3. Fragment is a Path Item Object with $ref field. We need to follow it to get the eventual value
-         *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
-         */
-        const isNonRootDocument = _empty.url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
-        const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-        if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isPathItemElement)(referencedElement) && (0, _apidomCore.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
-          var _this$basePath3;
-          // append referencing schema to ancestors lineage
-          directAncestors.add(pathItemElement);
-
-          // dive deep into the referenced element
-          const visitor = OpenApi3_1SwaggerClientDereferenceVisitor({
-            reference,
-            namespace: this.namespace,
-            indirections: [...this.indirections],
-            options: this.options,
-            ancestors: ancestorsLineage,
-            allowMetaPatches: this.allowMetaPatches,
-            useCircularStructures: this.useCircularStructures,
-            basePath: (_this$basePath3 = this.basePath) != null ? _this$basePath3 : [...(0, _toPath.default)([...ancestors, parent, pathItemElement]), '$ref']
-          });
-          referencedElement = await visitAsync(referencedElement, visitor, {
-            keyMap: _apidomNsOpenapi.keyMap,
-            nodeTypeGetter: _apidomNsOpenapi.getNodeType
-          });
+      /**
+       * Dive deep into the fragment.
+       *
+       * Cases to consider:
+       *  1. We're crossing document boundary
+       *  2. Fragment is from non-root document
+       *  3. Fragment is a Path Item Object with $ref field. We need to follow it to get the eventual value
+       *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
+       */
+      const isNonRootDocument = _empty.url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+      const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
+      if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isPathItemElement)(referencedElement) && (0, _apidomCore.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+        var _this$basePath3;
+        // append referencing schema to ancestors lineage
+        directAncestors.add(pathItemElement);
+
+        // dive deep into the referenced element
+        const visitor = new OpenAPI3_1SwaggerClientDereferenceVisitor({
+          reference,
+          namespace: this.namespace,
+          indirections: [...this.indirections],
+          options: this.options,
+          ancestors: ancestorsLineage,
+          allowMetaPatches: this.allowMetaPatches,
+          useCircularStructures: this.useCircularStructures,
+          basePath: (_this$basePath3 = this.basePath) != null ? _this$basePath3 : [...(0, _toPath.default)([...ancestors, parent, pathItemElement]), '$ref']
+        });
+        referencedElement = await visitAsync(referencedElement, visitor, {
+          keyMap: _apidomNsOpenapi.keyMap,
+          nodeTypeGetter: _apidomNsOpenapi.getNodeType
+        });
 
-          // remove referencing schema from ancestors lineage
-          directAncestors.delete(pathItemElement);
-        }
-        this.indirections.pop();
+        // remove referencing schema from ancestors lineage
+        directAncestors.delete(pathItemElement);
+      }
+      this.indirections.pop();
 
-        /**
-         * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
-         */
-        if ((0, _apidomNsOpenapi.isPathItemElement)(referencedElement)) {
-          const mergedElement = new _apidomNsOpenapi.PathItemElement([...referencedElement.content], (0, _apidomCore.cloneDeep)(referencedElement.meta), (0, _apidomCore.cloneDeep)(referencedElement.attributes));
-          // existing keywords from referencing PathItemElement overrides ones from referenced element
-          pathItemElement.forEach((value, keyElement, item) => {
-            mergedElement.remove((0, _apidomCore.toValue)(keyElement));
-            mergedElement.content.push(item);
-          });
-          mergedElement.remove('$ref');
+      /**
+       * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
+       */
+      if ((0, _apidomNsOpenapi.isPathItemElement)(referencedElement)) {
+        const mergedElement = new _apidomNsOpenapi.PathItemElement([...referencedElement.content], (0, _apidomCore.cloneDeep)(referencedElement.meta), (0, _apidomCore.cloneDeep)(referencedElement.attributes));
+        // existing keywords from referencing PathItemElement overrides ones from referenced element
+        pathItemElement.forEach((value, keyElement, item) => {
+          mergedElement.remove((0, _apidomCore.toValue)(keyElement));
+          mergedElement.content.push(item);
+        });
+        mergedElement.remove('$ref');
 
-          // annotate referenced element with info about original referencing element
-          mergedElement.setMetaProperty('ref-fields', {
-            $ref: (0, _apidomCore.toValue)(pathItemElement.$ref)
-          });
-          // annotate referenced element with info about origin
-          mergedElement.setMetaProperty('ref-origin', reference.uri);
-          // annotate fragment with info about referencing element
-          mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(pathItemElement)));
-
-          // apply meta patches
-          if (this.allowMetaPatches) {
-            // apply meta patch only when not already applied
-            if (typeof mergedElement.get('$$ref') === 'undefined') {
-              const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
-              mergedElement.set('$$ref', baseURI);
-            }
+        // annotate referenced element with info about original referencing element
+        mergedElement.setMetaProperty('ref-fields', {
+          $ref: (0, _apidomCore.toValue)(pathItemElement.$ref)
+        });
+        // annotate referenced element with info about origin
+        mergedElement.setMetaProperty('ref-origin', reference.uri);
+        // annotate fragment with info about referencing element
+        mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(pathItemElement)));
+
+        // apply meta patches
+        if (this.allowMetaPatches) {
+          // apply meta patch only when not already applied
+          if (typeof mergedElement.get('$$ref') === 'undefined') {
+            const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
+            mergedElement.set('$$ref', baseURI);
           }
-          referencedElement = mergedElement;
         }
+        referencedElement = mergedElement;
+      }
 
-        /**
-         * Transclude referencing element with merged referenced element.
-         */
-        if ((0, _apidomCore.isMemberElement)(parent)) {
-          parent.value = referencedElement; // eslint-disable-line no-param-reassign
-        } else if (Array.isArray(parent)) {
-          parent[key] = referencedElement; // eslint-disable-line no-param-reassign
-        }
+      /**
+       * Transclude referencing element with merged referenced element.
+       */
+      if ((0, _apidomCore.isMemberElement)(parent)) {
+        parent.value = referencedElement; // eslint-disable-line no-param-reassign
+      } else if (Array.isArray(parent)) {
+        parent[key] = referencedElement; // eslint-disable-line no-param-reassign
+      }
 
-        /**
-         * We're at the root of the tree, so we're just replacing the entire tree.
-         */
-        return !parent ? referencedElement : undefined;
-      } catch (error) {
-        var _this$basePath4, _this$options$derefer6;
-        const rootCause = (0, _getRootCause.default)(error);
-        const wrappedError = wrapError(rootCause, {
-          baseDoc: this.reference.uri,
-          $ref: (0, _apidomCore.toValue)(pathItemElement.$ref),
-          pointer: (0, _apidomJsonPointer.uriToPointer)((0, _apidomCore.toValue)(pathItemElement.$ref)),
-          fullPath: (_this$basePath4 = this.basePath) != null ? _this$basePath4 : [...(0, _toPath.default)([...ancestors, parent, pathItemElement]), '$ref']
-        });
-        (_this$options$derefer6 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer6 = _this$options$derefer6.errors) == null || _this$options$derefer6.push == null || _this$options$derefer6.push(wrappedError);
+      /**
+       * We're at the root of the tree, so we're just replacing the entire tree.
+       */
+      return !parent ? referencedElement : undefined;
+    } catch (error) {
+      var _this$basePath4, _this$options$derefer6;
+      const rootCause = (0, _getRootCause.default)(error);
+      const wrappedError = wrapError(rootCause, {
+        baseDoc: this.reference.uri,
+        $ref: (0, _apidomCore.toValue)(pathItemElement.$ref),
+        pointer: (0, _apidomJsonPointer.uriToPointer)((0, _apidomCore.toValue)(pathItemElement.$ref)),
+        fullPath: (_this$basePath4 = this.basePath) != null ? _this$basePath4 : [...(0, _toPath.default)([...ancestors, parent, pathItemElement]), '$ref']
+      });
+      (_this$options$derefer6 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer6 = _this$options$derefer6.errors) == null || _this$options$derefer6.push == null || _this$options$derefer6.push(wrappedError);
+      return undefined;
+    }
+  }
+  async SchemaElement(referencingElement, key, parent, path, ancestors) {
+    try {
+      // skip current referencing schema as $ref keyword was not defined
+      if (!(0, _apidomCore.isStringElement)(referencingElement.$ref)) {
+        // skip traversing this schema but traverse all it's child schemas
         return undefined;
       }
-    },
-    async SchemaElement(referencingElement, key, parent, path, ancestors) {
-      try {
-        // skip current referencing schema as $ref keyword was not defined
-        if (!(0, _apidomCore.isStringElement)(referencingElement.$ref)) {
-          // skip traversing this schema but traverse all it's child schemas
-          return undefined;
-        }
 
-        // skip current referencing element as it's already been access
-        if (this.indirections.includes(referencingElement)) {
-          return false;
+      // skip current referencing element as it's already been access
+      if (this.indirections.includes(referencingElement)) {
+        return false;
+      }
+      const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+
+      // compute baseURI using rules around $id and $ref keywords
+      let reference = await this.toReference(_empty.url.unsanitize(this.reference.uri));
+      let {
+        uri: retrievalURI
+      } = reference;
+      const $refBaseURI = (0, _openapi.resolveSchema$refField)(retrievalURI, referencingElement);
+      const $refBaseURIStrippedHash = _empty.url.stripHash($refBaseURI);
+      const file = new _empty.File({
+        uri: $refBaseURIStrippedHash
+      });
+      const isUnknownURI = !this.options.resolve.resolvers.some(r => r.canRead(file));
+      const isURL = !isUnknownURI;
+      let isInternalReference = _empty.url.stripHash(this.reference.uri) === $refBaseURI;
+      let isExternalReference = !isInternalReference;
+      this.indirections.push(referencingElement);
+
+      // determining reference, proper evaluation and selection mechanism
+      let referencedElement;
+      try {
+        if (isUnknownURI || isURL) {
+          // we're dealing with canonical URI or URL with possible fragment
+          retrievalURI = this.toBaseURI($refBaseURI);
+          const selector = $refBaseURI;
+          const referenceAsSchema = (0, _openapi.maybeRefractToSchemaElement)(reference.value.result);
+          referencedElement = (0, _uri.evaluate)(selector, referenceAsSchema);
+          referencedElement = (0, _openapi.maybeRefractToSchemaElement)(referencedElement);
+          referencedElement.id = identityManager.identify(referencedElement);
+
+          // ignore resolving internal Schema Objects
+          if (!this.options.resolve.internal && isInternalReference) {
+            // skip traversing this schema element but traverse all it's child elements
+            return undefined;
+          }
+          // ignore resolving external Schema Objects
+          if (!this.options.resolve.external && isExternalReference) {
+            // skip traversing this schema element but traverse all it's child elements
+            return undefined;
+          }
+        } else {
+          // we're assuming here that we're dealing with JSON Pointer here
+          retrievalURI = this.toBaseURI($refBaseURI);
+          isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
+          isExternalReference = !isInternalReference;
+
+          // ignore resolving internal Schema Objects
+          if (!this.options.resolve.internal && isInternalReference) {
+            // skip traversing this schema element but traverse all it's child elements
+            return undefined;
+          }
+          // ignore resolving external Schema Objects
+          if (!this.options.resolve.external && isExternalReference) {
+            // skip traversing this schema element but traverse all it's child elements
+            return undefined;
+          }
+          reference = await this.toReference(_empty.url.unsanitize($refBaseURI));
+          const selector = (0, _apidomJsonPointer.uriToPointer)($refBaseURI);
+          const referenceAsSchema = (0, _openapi.maybeRefractToSchemaElement)(reference.value.result);
+          referencedElement = (0, _apidomJsonPointer.evaluate)(selector, referenceAsSchema);
+          referencedElement = (0, _openapi.maybeRefractToSchemaElement)(referencedElement);
+          referencedElement.id = identityManager.identify(referencedElement);
         }
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
-
-        // compute baseURI using rules around $id and $ref keywords
-        let reference = await this.toReference(_empty.url.unsanitize(this.reference.uri));
-        let {
-          uri: retrievalURI
-        } = reference;
-        const $refBaseURI = (0, _openapi.resolveSchema$refField)(retrievalURI, referencingElement);
-        const $refBaseURIStrippedHash = _empty.url.stripHash($refBaseURI);
-        const file = (0, _empty.File)({
-          uri: $refBaseURIStrippedHash
-        });
-        const isUnknownURI = !this.options.resolve.resolvers.some(r => r.canRead(file));
-        const isURL = !isUnknownURI;
-        let isInternalReference = _empty.url.stripHash(this.reference.uri) === $refBaseURI;
-        let isExternalReference = !isInternalReference;
-        this.indirections.push(referencingElement);
-
-        // determining reference, proper evaluation and selection mechanism
-        let referencedElement;
-        try {
-          if (isUnknownURI || isURL) {
-            // we're dealing with canonical URI or URL with possible fragment
-            retrievalURI = this.toBaseURI($refBaseURI);
-            const selector = $refBaseURI;
-            const referenceAsSchema = (0, _openapi.maybeRefractToSchemaElement)(reference.value.result);
-            referencedElement = (0, _uri.evaluate)(selector, referenceAsSchema);
-            referencedElement = (0, _openapi.maybeRefractToSchemaElement)(referencedElement);
-            referencedElement.id = identityManager.identify(referencedElement);
+      } catch (error) {
+        /**
+         * No SchemaElement($id=URL) was not found, so we're going to try to resolve
+         * the URL and assume the returned response is a JSON Schema.
+         */
+        if (isURL && error instanceof _uri.EvaluationJsonSchemaUriError) {
+          if ((0, _$anchor.isAnchor)((0, _$anchor.uriToAnchor)($refBaseURI))) {
+            // we're dealing with JSON Schema $anchor here
+            isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
+            isExternalReference = !isInternalReference;
 
             // ignore resolving internal Schema Objects
             if (!this.options.resolve.internal && isInternalReference) {
@@ -448,9 +491,15 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
               // skip traversing this schema element but traverse all it's child elements
               return undefined;
             }
+            reference = await this.toReference(_empty.url.unsanitize($refBaseURI));
+            const selector = (0, _$anchor.uriToAnchor)($refBaseURI);
+            const referenceAsSchema = (0, _openapi.maybeRefractToSchemaElement)(reference.value.result);
+            referencedElement = (0, _$anchor.evaluate)(selector, referenceAsSchema);
+            referencedElement = (0, _openapi.maybeRefractToSchemaElement)(referencedElement);
+            referencedElement.id = identityManager.identify(referencedElement);
           } else {
             // we're assuming here that we're dealing with JSON Pointer here
-            retrievalURI = this.toBaseURI($refBaseURI);
+            retrievalURI = this.toBaseURI((0, _apidomCore.toValue)($refBaseURI));
             isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
             isExternalReference = !isInternalReference;
 
@@ -471,232 +520,183 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
             referencedElement = (0, _openapi.maybeRefractToSchemaElement)(referencedElement);
             referencedElement.id = identityManager.identify(referencedElement);
           }
-        } catch (error) {
-          /**
-           * No SchemaElement($id=URL) was not found, so we're going to try to resolve
-           * the URL and assume the returned response is a JSON Schema.
-           */
-          if (isURL && error instanceof _uri.EvaluationJsonSchemaUriError) {
-            if ((0, _$anchor.isAnchor)((0, _$anchor.uriToAnchor)($refBaseURI))) {
-              // we're dealing with JSON Schema $anchor here
-              isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
-              isExternalReference = !isInternalReference;
-
-              // ignore resolving internal Schema Objects
-              if (!this.options.resolve.internal && isInternalReference) {
-                // skip traversing this schema element but traverse all it's child elements
-                return undefined;
-              }
-              // ignore resolving external Schema Objects
-              if (!this.options.resolve.external && isExternalReference) {
-                // skip traversing this schema element but traverse all it's child elements
-                return undefined;
-              }
-              reference = await this.toReference(_empty.url.unsanitize($refBaseURI));
-              const selector = (0, _$anchor.uriToAnchor)($refBaseURI);
-              const referenceAsSchema = (0, _openapi.maybeRefractToSchemaElement)(reference.value.result);
-              referencedElement = (0, _$anchor.evaluate)(selector, referenceAsSchema);
-              referencedElement = (0, _openapi.maybeRefractToSchemaElement)(referencedElement);
-              referencedElement.id = identityManager.identify(referencedElement);
-            } else {
-              // we're assuming here that we're dealing with JSON Pointer here
-              retrievalURI = this.toBaseURI((0, _apidomCore.toValue)($refBaseURI));
-              isInternalReference = _empty.url.stripHash(this.reference.uri) === retrievalURI;
-              isExternalReference = !isInternalReference;
-
-              // ignore resolving internal Schema Objects
-              if (!this.options.resolve.internal && isInternalReference) {
-                // skip traversing this schema element but traverse all it's child elements
-                return undefined;
-              }
-              // ignore resolving external Schema Objects
-              if (!this.options.resolve.external && isExternalReference) {
-                // skip traversing this schema element but traverse all it's child elements
-                return undefined;
-              }
-              reference = await this.toReference(_empty.url.unsanitize($refBaseURI));
-              const selector = (0, _apidomJsonPointer.uriToPointer)($refBaseURI);
-              const referenceAsSchema = (0, _openapi.maybeRefractToSchemaElement)(reference.value.result);
-              referencedElement = (0, _apidomJsonPointer.evaluate)(selector, referenceAsSchema);
-              referencedElement = (0, _openapi.maybeRefractToSchemaElement)(referencedElement);
-              referencedElement.id = identityManager.identify(referencedElement);
-            }
-          } else {
-            throw error;
-          }
-        }
-
-        // detect direct or indirect reference
-        if (referencingElement === referencedElement) {
-          throw new _apidomError.ApiDOMError('Recursive Schema Object reference detected');
-        }
-
-        // detect maximum depth of dereferencing
-        if (this.indirections.length > this.options.dereference.maxDepth) {
-          throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+        } else {
+          throw error;
         }
+      }
 
-        // detect second deep dive into the same fragment and avoid it
-        if (ancestorsLineage.includes(referencedElement)) {
-          reference.refSet.circular = true;
-          if (this.options.dereference.circular === 'error') {
-            throw new _apidomError.ApiDOMError('Circular reference detected');
-          } else if (this.options.dereference.circular === 'replace') {
-            var _this$options$derefer7, _this$options$derefer8;
-            const refElement = new _apidomCore.RefElement(referencedElement.id, {
-              type: 'json-schema',
-              uri: reference.uri,
-              $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
-              baseURI: _empty.url.resolve(retrievalURI, $refBaseURI),
-              referencingElement
-            });
-            const replacer = (_this$options$derefer7 = (_this$options$derefer8 = this.options.dereference.strategyOpts['openapi-3-1']) == null ? void 0 : _this$options$derefer8.circularReplacer) != null ? _this$options$derefer7 : this.options.dereference.circularReplacer;
-            const replacement = replacer(refElement);
-            if ((0, _apidomCore.isMemberElement)(parent)) {
-              parent.value = replacement; // eslint-disable-line no-param-reassign
-            } else if (Array.isArray(parent)) {
-              parent[key] = replacement; // eslint-disable-line no-param-reassign
-            }
-            return !parent ? replacement : false;
-          }
-        }
+      // detect direct or indirect reference
+      if (referencingElement === referencedElement) {
+        throw new _apidomError.ApiDOMError('Recursive Schema Object reference detected');
+      }
 
-        /**
-         * Dive deep into the fragment.
-         *
-         * Cases to consider:
-         *  1. We're crossing document boundary
-         *  2. Fragment is from non-root document
-         *  3. Fragment is a Schema Object with $ref field. We need to follow it to get the eventual value
-         *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
-         */
-        const isNonRootDocument = _empty.url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
-        const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-        if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isSchemaElement)(referencedElement) && (0, _apidomCore.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
-          var _this$basePath5;
-          // append referencing schema to ancestors lineage
-          directAncestors.add(referencingElement);
-
-          // dive deep into the fragment
-          const mergeVisitor = OpenApi3_1SwaggerClientDereferenceVisitor({
-            reference,
-            namespace: this.namespace,
-            indirections: [...this.indirections],
-            options: this.options,
-            useCircularStructures: this.useCircularStructures,
-            allowMetaPatches: this.allowMetaPatches,
-            ancestors: ancestorsLineage,
-            basePath: (_this$basePath5 = this.basePath) != null ? _this$basePath5 : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref']
-          });
-          referencedElement = await visitAsync(referencedElement, mergeVisitor, {
-            keyMap: _apidomNsOpenapi.keyMap,
-            nodeTypeGetter: _apidomNsOpenapi.getNodeType
-          });
+      // detect maximum depth of dereferencing
+      if (this.indirections.length > this.options.dereference.maxDepth) {
+        throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      }
 
-          // remove referencing schema from ancestors lineage
-          directAncestors.delete(referencingElement);
-        }
-        this.indirections.pop();
-        if ((0, _apidomNsOpenapi.isBooleanJsonSchemaElement)(referencedElement)) {
-          const booleanJsonSchemaElement = (0, _apidomCore.cloneDeep)(referencedElement);
-          // annotate referenced element with info about original referencing element
-          booleanJsonSchemaElement.setMetaProperty('ref-fields', {
-            $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
+      // detect second deep dive into the same fragment and avoid it
+      if (ancestorsLineage.includes(referencedElement)) {
+        reference.refSet.circular = true;
+        if (this.options.dereference.circular === 'error') {
+          throw new _apidomError.ApiDOMError('Circular reference detected');
+        } else if (this.options.dereference.circular === 'replace') {
+          var _this$options$derefer7, _this$options$derefer8;
+          const refElement = new _apidomCore.RefElement(referencedElement.id, {
+            type: 'json-schema',
+            uri: reference.uri,
+            $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
+            baseURI: _empty.url.resolve(retrievalURI, $refBaseURI),
+            referencingElement
           });
-          // annotate referenced element with info about origin
-          booleanJsonSchemaElement.setMetaProperty('ref-origin', reference.uri);
-          // annotate fragment with info about referencing element
-          booleanJsonSchemaElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
+          const replacer = (_this$options$derefer7 = (_this$options$derefer8 = this.options.dereference.strategyOpts['openapi-3-1']) == null ? void 0 : _this$options$derefer8.circularReplacer) != null ? _this$options$derefer7 : this.options.dereference.circularReplacer;
+          const replacement = replacer(refElement);
           if ((0, _apidomCore.isMemberElement)(parent)) {
-            parent.value = booleanJsonSchemaElement; // eslint-disable-line no-param-reassign
+            parent.value = replacement; // eslint-disable-line no-param-reassign
           } else if (Array.isArray(parent)) {
-            parent[key] = booleanJsonSchemaElement; // eslint-disable-line no-param-reassign
+            parent[key] = replacement; // eslint-disable-line no-param-reassign
           }
-          return !parent ? booleanJsonSchemaElement : false;
+          return !parent ? replacement : false;
         }
+      }
 
-        /**
-         * Creating a new version of Schema Object by merging fields from referenced Schema Object with referencing one.
-         */
-        if ((0, _apidomNsOpenapi.isSchemaElement)(referencedElement)) {
-          // Schema Object - merge keywords from referenced schema with referencing schema
-          const mergedElement = new _apidomNsOpenapi.SchemaElement([...referencedElement.content], (0, _apidomCore.cloneDeep)(referencedElement.meta), (0, _apidomCore.cloneDeep)(referencedElement.attributes));
-          // existing keywords from referencing schema overrides ones from referenced schema
-          referencingElement.forEach((value, keyElement, item) => {
-            mergedElement.remove((0, _apidomCore.toValue)(keyElement));
-            mergedElement.content.push(item);
-          });
-          mergedElement.remove('$ref');
-          // annotate referenced element with info about original referencing element
-          mergedElement.setMetaProperty('ref-fields', {
-            $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
-          });
-          // annotate fragment with info about origin
-          mergedElement.setMetaProperty('ref-origin', reference.uri);
-          // annotate fragment with info about referencing element
-          mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
-
-          // allowMetaPatches option processing
-          if (this.allowMetaPatches) {
-            // apply meta patch only when not already applied
-            if (typeof mergedElement.get('$$ref') === 'undefined') {
-              const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
-              mergedElement.set('$$ref', baseURI);
-            }
-          }
-          referencedElement = mergedElement;
-        }
+      /**
+       * Dive deep into the fragment.
+       *
+       * Cases to consider:
+       *  1. We're crossing document boundary
+       *  2. Fragment is from non-root document
+       *  3. Fragment is a Schema Object with $ref field. We need to follow it to get the eventual value
+       *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
+       */
+      const isNonRootDocument = _empty.url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+      const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
+      if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isSchemaElement)(referencedElement) && (0, _apidomCore.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+        var _this$basePath5;
+        // append referencing schema to ancestors lineage
+        directAncestors.add(referencingElement);
+
+        // dive deep into the fragment
+        const mergeVisitor = new OpenAPI3_1SwaggerClientDereferenceVisitor({
+          reference,
+          namespace: this.namespace,
+          indirections: [...this.indirections],
+          options: this.options,
+          useCircularStructures: this.useCircularStructures,
+          allowMetaPatches: this.allowMetaPatches,
+          ancestors: ancestorsLineage,
+          basePath: (_this$basePath5 = this.basePath) != null ? _this$basePath5 : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref']
+        });
+        referencedElement = await visitAsync(referencedElement, mergeVisitor, {
+          keyMap: _apidomNsOpenapi.keyMap,
+          nodeTypeGetter: _apidomNsOpenapi.getNodeType
+        });
 
-        /**
-         * Transclude referencing element with merged referenced element.
-         */
+        // remove referencing schema from ancestors lineage
+        directAncestors.delete(referencingElement);
+      }
+      this.indirections.pop();
+      if ((0, _apidomNsOpenapi.isBooleanJsonSchemaElement)(referencedElement)) {
+        const booleanJsonSchemaElement = (0, _apidomCore.cloneDeep)(referencedElement);
+        // annotate referenced element with info about original referencing element
+        booleanJsonSchemaElement.setMetaProperty('ref-fields', {
+          $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
+        });
+        // annotate referenced element with info about origin
+        booleanJsonSchemaElement.setMetaProperty('ref-origin', reference.uri);
+        // annotate fragment with info about referencing element
+        booleanJsonSchemaElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
         if ((0, _apidomCore.isMemberElement)(parent)) {
-          parent.value = referencedElement; // eslint-disable-line no-param-reassign
+          parent.value = booleanJsonSchemaElement; // eslint-disable-line no-param-reassign
         } else if (Array.isArray(parent)) {
-          parent[key] = referencedElement; // eslint-disable-line no-param-reassign
+          parent[key] = booleanJsonSchemaElement; // eslint-disable-line no-param-reassign
         }
+        return !parent ? booleanJsonSchemaElement : false;
+      }
 
-        /**
-         * We're at the root of the tree, so we're just replacing the entire tree.
-         */
-        return !parent ? referencedElement : undefined;
-      } catch (error) {
-        var _this$basePath6, _this$options$derefer9;
-        const rootCause = (0, _getRootCause.default)(error);
-        const wrappedError = new _SchemaRefError.default(`Could not resolve reference: ${rootCause.message}`, {
-          baseDoc: this.reference.uri,
-          $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
-          fullPath: (_this$basePath6 = this.basePath) != null ? _this$basePath6 : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref'],
-          cause: rootCause
+      /**
+       * Creating a new version of Schema Object by merging fields from referenced Schema Object with referencing one.
+       */
+      if ((0, _apidomNsOpenapi.isSchemaElement)(referencedElement)) {
+        // Schema Object - merge keywords from referenced schema with referencing schema
+        const mergedElement = new _apidomNsOpenapi.SchemaElement([...referencedElement.content], (0, _apidomCore.cloneDeep)(referencedElement.meta), (0, _apidomCore.cloneDeep)(referencedElement.attributes));
+        // existing keywords from referencing schema overrides ones from referenced schema
+        referencingElement.forEach((value, keyElement, item) => {
+          mergedElement.remove((0, _apidomCore.toValue)(keyElement));
+          mergedElement.content.push(item);
         });
-        (_this$options$derefer9 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer9 = _this$options$derefer9.errors) == null || _this$options$derefer9.push == null || _this$options$derefer9.push(wrappedError);
-        return undefined;
+        mergedElement.remove('$ref');
+        // annotate referenced element with info about original referencing element
+        mergedElement.setMetaProperty('ref-fields', {
+          $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
+        });
+        // annotate fragment with info about origin
+        mergedElement.setMetaProperty('ref-origin', reference.uri);
+        // annotate fragment with info about referencing element
+        mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
+
+        // allowMetaPatches option processing
+        if (this.allowMetaPatches) {
+          // apply meta patch only when not already applied
+          if (typeof mergedElement.get('$$ref') === 'undefined') {
+            const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
+            mergedElement.set('$$ref', baseURI);
+          }
+        }
+        referencedElement = mergedElement;
       }
-    },
-    async LinkElement() {
+
       /**
-       * OpenApi3_1DereferenceVisitor is doing lookup of Operation Objects
-       * and assigns them to Link Object metadata. This is not needed in
-       * swagger-client context, so we're disabling it here.
+       * Transclude referencing element with merged referenced element.
        */
-      return undefined;
-    },
-    async ExampleElement(exampleElement, key, parent, path, ancestors) {
-      try {
-        return await _openapi.OpenApi3_1DereferenceVisitor.compose.methods.ExampleElement.call(this, exampleElement, key, parent, path, ancestors);
-      } catch (error) {
-        var _this$basePath7, _this$options$derefer10;
-        const rootCause = (0, _getRootCause.default)(error);
-        const wrappedError = wrapError(rootCause, {
-          baseDoc: this.reference.uri,
-          externalValue: (0, _apidomCore.toValue)(exampleElement.externalValue),
-          fullPath: (_this$basePath7 = this.basePath) != null ? _this$basePath7 : [...(0, _toPath.default)([...ancestors, parent, exampleElement]), 'externalValue']
-        });
-        (_this$options$derefer10 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer10 = _this$options$derefer10.errors) == null || _this$options$derefer10.push == null || _this$options$derefer10.push(wrappedError);
-        return undefined;
+      if ((0, _apidomCore.isMemberElement)(parent)) {
+        parent.value = referencedElement; // eslint-disable-line no-param-reassign
+      } else if (Array.isArray(parent)) {
+        parent[key] = referencedElement; // eslint-disable-line no-param-reassign
       }
+
+      /**
+       * We're at the root of the tree, so we're just replacing the entire tree.
+       */
+      return !parent ? referencedElement : undefined;
+    } catch (error) {
+      var _this$basePath6, _this$options$derefer9;
+      const rootCause = (0, _getRootCause.default)(error);
+      const wrappedError = new _SchemaRefError.default(`Could not resolve reference: ${rootCause.message}`, {
+        baseDoc: this.reference.uri,
+        $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
+        fullPath: (_this$basePath6 = this.basePath) != null ? _this$basePath6 : [...(0, _toPath.default)([...ancestors, parent, referencingElement]), '$ref'],
+        cause: rootCause
+      });
+      (_this$options$derefer9 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer9 = _this$options$derefer9.errors) == null || _this$options$derefer9.push == null || _this$options$derefer9.push(wrappedError);
+      return undefined;
+    }
+  }
+
+  // eslint-disable-next-line class-methods-use-this
+  async LinkElement() {
+    /**
+     * OpenApi3_1DereferenceVisitor is doing lookup of Operation Objects
+     * and assigns them to Link Object metadata. This is not needed in
+     * swagger-client context, so we're disabling it here.
+     */
+    return undefined;
+  }
+  async ExampleElement(exampleElement, key, parent, path, ancestors) {
+    try {
+      return await super.ExampleElement(exampleElement, key, parent, path, ancestors);
+    } catch (error) {
+      var _this$basePath7, _this$options$derefer10;
+      const rootCause = (0, _getRootCause.default)(error);
+      const wrappedError = wrapError(rootCause, {
+        baseDoc: this.reference.uri,
+        externalValue: (0, _apidomCore.toValue)(exampleElement.externalValue),
+        fullPath: (_this$basePath7 = this.basePath) != null ? _this$basePath7 : [...(0, _toPath.default)([...ancestors, parent, exampleElement]), 'externalValue']
+      });
+      (_this$options$derefer10 = this.options.dereference.dereferenceOpts) == null || (_this$options$derefer10 = _this$options$derefer10.errors) == null || _this$options$derefer10.push == null || _this$options$derefer10.push(wrappedError);
+      return undefined;
     }
   }
-});
-var _default = exports.default = OpenApi3_1SwaggerClientDereferenceVisitor;
+}
+var _default = exports.default = OpenAPI3_1SwaggerClientDereferenceVisitor;
 /* eslint-enable camelcase */