swagger-client 3.26.8 → 3.27.0

package/dist/swagger-client.browser.js

@@ -2192,11 +2192,12 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(46571);
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(68618);
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(1667);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(87024);
 /* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(31387);
 /* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(12349);
 /* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(57016);
 /* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(41544);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(66648);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(66648);
 /* harmony import */ var _visitors_dereference_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(7882);
 /* harmony import */ var _visitors_parameters_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(53628);
 /* harmony import */ var _visitors_properties_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(85001);
@@ -2214,7 +2215,6 @@ const visitAsync = _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__.visit[S
 const mergeAllVisitorsAsync = _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.mergeAll[Symbol.for('nodejs.util.promisify.custom')];
 const OpenApi3_1SwaggerClientDereferenceStrategy = _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_6__["default"].compose({
   props: {
-    useCircularStructures: true,
     allowMetaPatches: false,
     parameterMacro: null,
     modelPropertyMacro: null,
@@ -2222,7 +2222,6 @@ const OpenApi3_1SwaggerClientDereferenceStrategy = _swagger_api_apidom_reference
     ancestors: null
   },
   init({
-    useCircularStructures = this.useCircularStructures,
     allowMetaPatches = this.allowMetaPatches,
     parameterMacro = this.parameterMacro,
     modelPropertyMacro = this.modelPropertyMacro,
@@ -2230,7 +2229,6 @@ const OpenApi3_1SwaggerClientDereferenceStrategy = _swagger_api_apidom_reference
     ancestors = []
   } = {}) {
     this.name = 'openapi-3-1-swagger-client';
-    this.useCircularStructures = useCircularStructures;
     this.allowMetaPatches = allowMetaPatches;
     this.parameterMacro = parameterMacro;
     this.modelPropertyMacro = modelPropertyMacro;
@@ -2241,17 +2239,32 @@ const OpenApi3_1SwaggerClientDereferenceStrategy = _swagger_api_apidom_reference
     async dereference(file, options) {
       const visitors = [];
       const namespace = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.createNamespace)(_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_8__["default"]);
-      const refSet = options.dereference.refSet ?? (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__["default"])();
+      const immutableRefSet = options.dereference.refSet ?? (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__["default"])();
+      const mutableRefsSet = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__["default"])();
+      let refSet = immutableRefSet;
       let reference;
-      if (!refSet.has(file.uri)) {
+      if (!immutableRefSet.has(file.uri)) {
         reference = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_10__["default"])({
           uri: file.uri,
           value: file.parseResult
         });
-        refSet.add(reference);
+        immutableRefSet.add(reference);
       } else {
         // pre-computed refSet was provided as configuration option
-        reference = refSet.find(ref => ref.uri === file.uri);
+        reference = immutableRefSet.find(ref => ref.uri === file.uri);
+      }
+
+      /**
+       * Clone refSet due the dereferencing process being mutable.
+       * We don't want to mutate the original refSet and the references.
+       */
+      if (options.dereference.immutable) {
+        immutableRefSet.refs.map(ref => (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_10__["default"])({
+          ...ref,
+          value: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_11__.cloneDeep)(ref.value)
+        })).forEach(ref => mutableRefsSet.add(ref));
+        reference = mutableRefsSet.find(ref => ref.uri === file.uri);
+        refSet = mutableRefsSet;
       }
 
       // create main dereference visitor
@@ -2259,7 +2272,6 @@ const OpenApi3_1SwaggerClientDereferenceStrategy = _swagger_api_apidom_reference
         reference,
         namespace,
         options,
-        useCircularStructures: this.useCircularStructures,
         allowMetaPatches: this.allowMetaPatches,
         ancestors: this.ancestors
       });
@@ -2293,20 +2305,33 @@ const OpenApi3_1SwaggerClientDereferenceStrategy = _swagger_api_apidom_reference
 
       // establish root visitor by visitor merging
       const rootVisitor = mergeAllVisitorsAsync(visitors, {
-        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.getNodeType
+        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.getNodeType
       });
       const dereferencedElement = await visitAsync(refSet.rootRef.value, rootVisitor, {
-        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.keyMap,
-        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.getNodeType
+        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.keyMap,
+        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.getNodeType
       });
 
       /**
-       * Release all memory if this refSet was not provided as a configuration option.
+       * If immutable option is set, replay refs from the refSet.
+       */
+      if (options.dereference.immutable) {
+        mutableRefsSet.refs.filter(ref => ref.uri.startsWith('immutable://')).map(ref => (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_10__["default"])({
+          ...ref,
+          uri: ref.uri.replace(/^immutable:\/\//, '')
+        })).forEach(ref => immutableRefSet.add(ref));
+        reference = immutableRefSet.find(ref => ref.uri === file.uri);
+        refSet = immutableRefSet;
+      }
+
+      /**
+       * Release all memory if this refSet was not provided as an configuration option.
        * If provided as configuration option, then provider is responsible for cleanup.
        */
       if (options.dereference.refSet === null) {
-        refSet.clean();
+        immutableRefSet.clean();
       }
+      mutableRefsSet.clean();
       return dereferencedElement;
     }
   }
@@ -2406,11 +2431,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(33501);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(9999);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(87024);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(15461);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(3117);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(70281);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(15461);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(70281);
 /* harmony import */ var _utils_compose_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(79170);
 /* harmony import */ var _utils_to_path_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(12201);
 
@@ -2440,48 +2462,57 @@ const AllOfVisitor = (0,_utils_compose_js__WEBPACK_IMPORTED_MODULE_0__["default"
 
         // remove allOf keyword if empty
         if (schemaElement.allOf.isEmpty) {
-          return new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__.SchemaElement(schemaElement.content.filter(memberElement => (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(memberElement.key) !== 'allOf'), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.cloneDeep)(schemaElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.cloneDeep)(schemaElement.attributes));
+          schemaElement.remove('allOf');
+          return undefined;
         }
 
         // collect errors if allOf keyword contains anything else than Schema Object
-        const includesSchemaElementOnly = schemaElement.allOf.content.every(_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_6__.isSchemaElement);
+        const includesSchemaElementOnly = schemaElement.allOf.content.every(_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__.isSchemaElement);
         if (!includesSchemaElementOnly) {
           const error = new TypeError('Elements in allOf must be objects');
           error.fullPath = [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_2__["default"])([...ancestors, parent, schemaElement]), 'allOf'];
           this.options.dereference.dereferenceOpts?.errors?.push?.(error);
           return undefined;
         }
-        const mergedSchemaElement = _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"].all([...schemaElement.allOf.content, schemaElement]);
+        while (schemaElement.hasKey('allOf')) {
+          const {
+            allOf
+          } = schemaElement;
+          schemaElement.remove('allOf');
+          const allOfMerged = _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"].all([...allOf.content, schemaElement]);
 
-        /**
-         * If there was not an original $$ref value, make sure to remove
-         * any $$ref value that may exist from the result of `allOf` merges.
-         */
-        if (!schemaElement.hasKey('$$ref')) {
-          mergedSchemaElement.remove('$$ref');
-        }
+          /**
+           * If there was not an original $$ref value, make sure to remove
+           * any $$ref value that may exist from the result of `allOf` merges.
+           */
+          if (!schemaElement.hasKey('$$ref')) {
+            allOfMerged.remove('$$ref');
+          }
 
-        /**
-         * If there was an example keyword in the original definition,
-         * keep it instead of merging with example from other schema.
-         */
-        if (schemaElement.hasKey('example')) {
-          const member = mergedSchemaElement.getMember('example');
-          member.value = schemaElement.get('example');
-        }
+          /**
+           * If there was an example keyword in the original schema,
+           * keep it instead of merging with example from other schema.
+           */
+          if (schemaElement.hasKey('example')) {
+            const member = allOfMerged.getMember('example');
+            if (member) {
+              member.value = schemaElement.get('example');
+            }
+          }
 
-        /**
-         * If there was an examples keyword in the original definition,
-         * keep it instead of merging with examples from other schema.
-         */
-        if (schemaElement.hasKey('examples')) {
-          const member = mergedSchemaElement.getMember('examples');
-          member.value = schemaElement.get('examples');
+          /**
+           * If there was an examples keyword in the original schema,
+           * keep it instead of merging with examples from other schema.
+           */
+          if (schemaElement.hasKey('examples')) {
+            const member = allOfMerged.getMember('examples');
+            if (member) {
+              member.value = schemaElement.get('examples');
+            }
+          }
+          schemaElement.content = allOfMerged.content;
         }
-
-        // remove allOf keyword after the merge
-        mergedSchemaElement.remove('allOf');
-        return mergedSchemaElement;
+        return undefined;
       }
     }
   }
@@ -2500,26 +2531,27 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(46571);
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(42209);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(9999);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(33501);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(87024);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(9999);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(33501);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(44824);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(87024);
 /* harmony import */ var _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(98219);
 /* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(85013);
 /* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(3117);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(66648);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(70281);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(85270);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(18316);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(83748);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(70281);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(66648);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(85270);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(18316);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(83748);
 /* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(60503);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(15767);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(32346);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(51776);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(46432);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(16129);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(78311);
-/* harmony import */ var _utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(12201);
-/* harmony import */ var _utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(17381);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(15767);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(32346);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(51776);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(46432);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(16129);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(78311);
+/* harmony import */ var _utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(12201);
+/* harmony import */ var _utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(17381);
 /* harmony import */ var _specmap_lib_refs_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(7247);
 /* harmony import */ var _errors_index_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(21806);
 /* eslint-disable camelcase */
@@ -2542,13 +2574,7 @@ const visitAsync = _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_2__.visit[S
 
 // initialize element identity manager
 const identityManager = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_3__.IdentityManager)();
-
-/**
- * Predicate for detecting if element was created by merging referencing
- * element with particular element identity with a referenced element.
- */
-const wasReferencedBy = referencingElement => element => element.meta.hasKey('ref-referencing-element-id') && element.meta.get('ref-referencing-element-id').equals((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(identityManager.identify(referencingElement)));
-const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_5__["default"].compose({
+const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_4__["default"].compose({
   props: {
     useCircularStructures: true,
     allowMetaPatches: false,
@@ -2566,19 +2592,13 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
   methods: {
     async ReferenceElement(referencingElement, key, parent, path, ancestors) {
       try {
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
-
-        // skip already identified cycled Path Item Objects
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.includesClasses)(['cycle'], referencingElement.$ref)) {
-          return false;
-        }
-
-        // detect possible cycle in traversal and avoid it
-        if (ancestorsLineage.includesCycle(referencingElement)) {
+        // skip current referencing element as it's already been access
+        if (this.indirections.includes(referencingElement)) {
           return false;
         }
-        const retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
-        const isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.stripHash(this.reference.uri) === retrievalURI;
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+        const retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
+        const isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(this.reference.uri) === retrievalURI;
         const isExternalReference = !isInternalReference;
 
         // ignore resolving internal Reference Objects
@@ -2589,18 +2609,19 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         if (!this.options.resolve.external && isExternalReference) {
           return false;
         }
-        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
-        const $refBaseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
+        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
+        const $refBaseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
         this.indirections.push(referencingElement);
-        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__.uriToPointer)($refBaseURI);
+        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
 
         // possibly non-semantic fragment
-        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__["default"])(jsonPointer, reference.value.result);
+        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(jsonPointer, reference.value.result);
+        referencedElement.id = identityManager.identify(referencedElement);
 
         // applying semantics to a fragment
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isPrimitiveElement)(referencedElement)) {
-          const referencedElementType = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.meta.get('referenced-element'));
-          const cacheKey = `${referencedElementType}-${(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(identityManager.identify(referencedElement))}`;
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isPrimitiveElement)(referencedElement)) {
+          const referencedElementType = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.meta.get('referenced-element'));
+          const cacheKey = `${referencedElementType}-${(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(identityManager.identify(referencedElement))}`;
           if (this.refractCache.has(cacheKey)) {
             referencedElement = this.refractCache.get(cacheKey);
           } else if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_10__.isReferenceLikeElement)(referencedElement)) {
@@ -2617,109 +2638,127 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         }
 
         // detect direct or indirect reference
-        if (this.indirections.includes(referencedElement)) {
-          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Recursive JSON Pointer detected');
+        if (referencingElement === referencedElement) {
+          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Recursive Reference Object detected');
         }
 
         // detect maximum depth of dereferencing
         if (this.indirections.length > this.options.dereference.maxDepth) {
           throw new _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_13__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.includes(referencedElement);
-          if (hasCycles) {
-            if (_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const cycledReferenceElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.ReferenceElement({
-                $ref: $refBaseURI
-              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(referencingElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(referencingElement.attributes));
-              cycledReferenceElement.get('$ref').classes.push('cycle');
-              return cycledReferenceElement;
+
+        // 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 _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Circular reference detected');
+          } else if (this.options.dereference.circular === 'replace') {
+            const refElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.RefElement(referencedElement.id, {
+              type: 'reference',
+              uri: reference.uri,
+              $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref),
+              baseURI: $refBaseURI,
+              referencingElement
+            });
+            const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
+            const replacement = replacer(refElement);
+            if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.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
             }
-            // skip processing this reference
-            return false;
+            return !parent ? replacement : false;
           }
         }
 
-        // append referencing schema to ancestors lineage
-        directAncestors.add(referencingElement);
-
-        // dive deep into the fragment
-        const visitor = OpenApi3_1SwaggerClientDereferenceVisitor({
-          reference,
-          namespace: this.namespace,
-          indirections: [...this.indirections],
-          options: this.options,
-          ancestors: ancestorsLineage,
-          allowMetaPatches: this.allowMetaPatches,
-          useCircularStructures: this.useCircularStructures,
-          basePath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__["default"])([...ancestors, parent, referencingElement]), '$ref']
-        });
-        referencedElement = await visitAsync(referencedElement, visitor, {
-          keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.keyMap,
-          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.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 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 = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+        const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
+        if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.isReferenceElement)(referencedElement) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+          // 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 ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          });
+          referencedElement = await visitAsync(referencedElement, visitor, {
+            keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.keyMap,
+            nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.getNodeType
+          });
 
-        // remove referencing schema from ancestors lineage
-        directAncestors.delete(referencingElement);
+          // remove referencing reference from ancestors lineage
+          directAncestors.delete(referencingElement);
+        }
         this.indirections.pop();
-        const mergeAndAnnotateReferencedElement = refedElement => {
-          const copy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneShallow)(refedElement);
-
-          // annotate fragment with info about original Reference element
-          copy.setMetaProperty('ref-fields', {
-            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref),
-            description: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.description),
-            summary: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.summary)
-          });
-          // annotate fragment with info about origin
-          copy.setMetaProperty('ref-origin', reference.uri);
-          // annotate fragment with info about referencing element
-          copy.setMetaProperty('ref-referencing-element-id', (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(identityManager.identify(referencingElement)));
+        const mergedElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneShallow)(referencedElement);
 
-          // override description and summary (outer has higher priority then inner)
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isObjectElement)(refedElement)) {
-            if (referencingElement.hasKey('description') && 'description' in refedElement) {
-              copy.remove('description');
-              copy.set('description', referencingElement.get('description'));
-            }
-            if (referencingElement.hasKey('summary') && 'summary' in refedElement) {
-              copy.remove('summary');
-              copy.set('summary', referencingElement.get('summary'));
-            }
-          }
+        // annotate fragment with info about original Reference element
+        mergedElement.setMetaProperty('ref-fields', {
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref),
+          description: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.description),
+          summary: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(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,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(identityManager.identify(referencingElement)));
 
-          // apply meta patches
-          if (this.allowMetaPatches && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isObjectElement)(copy)) {
-            // apply meta patch only when not already applied
-            if (!copy.hasKey('$$ref')) {
-              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.resolve(retrievalURI, $refBaseURI);
-              copy.set('$$ref', baseURI);
-            }
+        // override description and summary (outer has higher priority then inner)
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isObjectElement)(referencedElement)) {
+          if (referencingElement.hasKey('description') && 'description' in referencedElement) {
+            mergedElement.remove('description');
+            mergedElement.set('description', referencingElement.get('description'));
           }
-          return copy;
-        };
+          if (referencingElement.hasKey('summary') && 'summary' in referencedElement) {
+            mergedElement.remove('summary');
+            mergedElement.set('summary', referencingElement.get('summary'));
+          }
+        }
 
-        // attempting to create cycle
-        if (ancestorsLineage.includes(referencingElement) || ancestorsLineage.includes(referencedElement)) {
-          const replaceWith = ancestorsLineage.findItem(wasReferencedBy(referencingElement)) ?? mergeAndAnnotateReferencedElement(referencedElement);
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isMemberElement)(parent)) {
-            parent.value = replaceWith; // eslint-disable-line no-param-reassign
-          } else if (Array.isArray(parent)) {
-            parent[key] = replaceWith; // eslint-disable-line no-param-reassign
+        // apply meta patches
+        if (this.allowMetaPatches && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isObjectElement)(mergedElement)) {
+          // apply meta patch only when not already applied
+          if (!mergedElement.hasKey('$$ref')) {
+            const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, $refBaseURI);
+            mergedElement.set('$$ref', baseURI);
           }
-          return false;
         }
 
-        // transclude the element for a fragment
-        return mergeAndAnnotateReferencedElement(referencedElement);
+        /**
+         * Transclude referencing element with merged referenced element.
+         */
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.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) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_17__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_19__["default"])(error);
         const wrappedError = wrapError(rootCause, {
           baseDoc: this.reference.uri,
-          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref),
-          pointer: (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref)),
-          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref),
+          pointer: (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref)),
+          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__["default"])([...ancestors, parent, referencingElement]), '$ref']
         });
         this.options.dereference.dereferenceOpts?.errors?.push?.(wrappedError);
         return undefined;
@@ -2727,24 +2766,23 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
     },
     async PathItemElement(pathItemElement, key, parent, path, ancestors) {
       try {
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
-
         // ignore PathItemElement without $ref field
-        if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isStringElement)(pathItemElement.$ref)) {
+        if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isStringElement)(pathItemElement.$ref)) {
           return undefined;
         }
 
-        // skip already identified cycled Path Item Objects
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.includesClasses)(['cycle'], pathItemElement.$ref)) {
+        // skip current referencing element as it's already been access
+        if (this.indirections.includes(pathItemElement)) {
           return false;
         }
 
-        // detect possible cycle in traversal and avoid it
-        if (ancestorsLineage.includesCycle(pathItemElement)) {
+        // skip already identified cycled Path Item Objects
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.includesClasses)(['cycle'], pathItemElement.$ref)) {
           return false;
         }
-        const retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref));
-        const isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.stripHash(this.reference.uri) === retrievalURI;
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+        const retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(pathItemElement.$ref));
+        const isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(this.reference.uri) === retrievalURI;
         const isExternalReference = !isInternalReference;
 
         // ignore resolving internal Path Item Elements
@@ -2755,17 +2793,18 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         if (!this.options.resolve.external && isExternalReference) {
           return undefined;
         }
-        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref));
-        const $refBaseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref));
+        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(pathItemElement.$ref));
+        const $refBaseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(pathItemElement.$ref));
         this.indirections.push(pathItemElement);
-        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__.uriToPointer)($refBaseURI);
+        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
 
         // possibly non-semantic referenced element
-        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__["default"])(jsonPointer, reference.value.result);
+        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(jsonPointer, reference.value.result);
+        referencedElement.id = identityManager.identify(referencedElement);
 
         // applying semantics to a referenced element
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isPrimitiveElement)(referencedElement)) {
-          const cacheKey = `pathItem-${(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(identityManager.identify(referencedElement))}`;
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isPrimitiveElement)(referencedElement)) {
+          const cacheKey = `path-item-${(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(identityManager.identify(referencedElement))}`;
           if (this.refractCache.has(cacheKey)) {
             referencedElement = this.refractCache.get(cacheKey);
           } else {
@@ -2775,102 +2814,127 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         }
 
         // detect direct or indirect reference
-        if (this.indirections.includes(referencedElement)) {
-          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Recursive JSON Pointer detected');
+        if (pathItemElement === referencedElement) {
+          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Recursive Path Item Object reference detected');
         }
 
         // detect maximum depth of dereferencing
         if (this.indirections.length > this.options.dereference.maxDepth) {
           throw new _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_13__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.includes(referencedElement);
-          if (hasCycles) {
-            if (_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const cycledPathItemElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.PathItemElement({
-                $ref: $refBaseURI
-              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(pathItemElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(pathItemElement.attributes));
-              cycledPathItemElement.get('$ref').classes.push('cycle');
-              return cycledPathItemElement;
+
+        // 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 _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Circular reference detected');
+          } else if (this.options.dereference.circular === 'replace') {
+            const refElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.RefElement(referencedElement.id, {
+              type: 'path-item',
+              uri: reference.uri,
+              $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(pathItemElement.$ref),
+              baseURI: $refBaseURI,
+              referencingElement: pathItemElement
+            });
+            const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
+            const replacement = replacer(refElement);
+            if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.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
             }
-            // skip processing this path item and all it's child elements
-            return false;
+            return !parent ? replacement : false;
           }
         }
 
-        // 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.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__["default"])([...ancestors, parent, pathItemElement]), '$ref']
-        });
-        referencedElement = await visitAsync(referencedElement, visitor, {
-          keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.keyMap,
-          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.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 = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+        const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
+        if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.isPathItemElement)(referencedElement) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+          // 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.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__["default"])([...ancestors, parent, pathItemElement]), '$ref']
+          });
+          referencedElement = await visitAsync(referencedElement, visitor, {
+            keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.keyMap,
+            nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.getNodeType
+          });
 
-        // remove referencing schema from ancestors lineage
-        directAncestors.delete(pathItemElement);
+          // remove referencing schema from ancestors lineage
+          directAncestors.delete(pathItemElement);
+        }
         this.indirections.pop();
-        const mergeAndAnnotateReferencedElement = refedElement => {
-          // merge fields from referenced Path Item with referencing one
-          const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.PathItemElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(refedElement.attributes));
+
+        /**
+         * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
+         */
+        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.isPathItemElement)(referencedElement)) {
+          const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.PathItemElement([...referencedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(referencedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(referencedElement.attributes));
           // existing keywords from referencing PathItemElement overrides ones from referenced element
           pathItemElement.forEach((value, keyElement, item) => {
-            mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(keyElement));
+            mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(keyElement));
             mergedElement.content.push(item);
           });
           mergedElement.remove('$ref');
 
           // annotate referenced element with info about original referencing element
           mergedElement.setMetaProperty('ref-fields', {
-            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref)
+            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(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,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(identityManager.identify(pathItemElement)));
+          mergedElement.setMetaProperty('ref-referencing-element-id', (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.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 = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.resolve(retrievalURI, $refBaseURI);
+              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, $refBaseURI);
               mergedElement.set('$$ref', baseURI);
             }
           }
-          return mergedElement;
-        };
+          referencedElement = mergedElement;
+        }
 
-        // attempting to create cycle
-        if (ancestorsLineage.includes(pathItemElement) || ancestorsLineage.includes(referencedElement)) {
-          const replaceWith = ancestorsLineage.findItem(wasReferencedBy(pathItemElement)) ?? mergeAndAnnotateReferencedElement(referencedElement);
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isMemberElement)(parent)) {
-            parent.value = replaceWith; // eslint-disable-line no-param-reassign
-          } else if (Array.isArray(parent)) {
-            parent[key] = replaceWith; // eslint-disable-line no-param-reassign
-          }
-          return false;
+        /**
+         * Transclude referencing element with merged referenced element.
+         */
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.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
-        return mergeAndAnnotateReferencedElement(referencedElement);
+        /**
+         * We're at the root of the tree, so we're just replacing the entire tree.
+         */
+        return !parent ? referencedElement : undefined;
       } catch (error) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_17__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_19__["default"])(error);
         const wrappedError = wrapError(rootCause, {
           baseDoc: this.reference.uri,
-          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref),
-          pointer: (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref)),
-          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__["default"])([...ancestors, parent, pathItemElement]), '$ref']
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(pathItemElement.$ref),
+          pointer: (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(pathItemElement.$ref)),
+          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__["default"])([...ancestors, parent, pathItemElement]), '$ref']
         });
         this.options.dereference.dereferenceOpts?.errors?.push?.(wrappedError);
         return undefined;
@@ -2878,38 +2942,32 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
     },
     async SchemaElement(referencingElement, key, parent, path, ancestors) {
       try {
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
-
         // skip current referencing schema as $ref keyword was not defined
-        if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isStringElement)(referencingElement.$ref)) {
+        if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isStringElement)(referencingElement.$ref)) {
           // skip traversing this schema but traverse all it's child schemas
           return undefined;
         }
 
-        // skip already identified cycled Path Item Objects
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.includesClasses)(['cycle'], referencingElement.$ref)) {
-          return false;
-        }
-
-        // detect possible cycle in traversal and avoid it
-        if (ancestorsLineage.includesCycle(referencingElement)) {
+        // 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(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.unsanitize(this.reference.uri));
+        let reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize(this.reference.uri));
         let {
           uri: retrievalURI
         } = reference;
-        const $refBaseURI = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.resolveSchema$refField)(retrievalURI, referencingElement);
-        const $refBaseURIStrippedHash = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.stripHash($refBaseURI);
-        const file = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_19__["default"])({
+        const $refBaseURI = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.resolveSchema$refField)(retrievalURI, referencingElement);
+        const $refBaseURIStrippedHash = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash($refBaseURI);
+        const file = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_21__["default"])({
           uri: $refBaseURIStrippedHash
         });
         const isUnknownURI = !this.options.resolve.resolvers.some(r => r.canRead(file));
         const isURL = !isUnknownURI;
-        const isInternalReference = uri => _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.stripHash(this.reference.uri) === uri;
-        const isExternalReference = uri => !isInternalReference(uri);
+        let isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(this.reference.uri) === $refBaseURI;
+        let isExternalReference = !isInternalReference;
         this.indirections.push(referencingElement);
 
         // determining reference, proper evaluation and selection mechanism
@@ -2917,66 +2975,95 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         try {
           if (isUnknownURI || isURL) {
             // we're dealing with canonical URI or URL with possible fragment
+            retrievalURI = this.toBaseURI($refBaseURI);
             const selector = $refBaseURI;
-            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_20__.evaluate)(selector, (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToSchemaElement)(reference.value.result));
+            const referenceAsSchema = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToSchemaElement)(reference.value.result);
+            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_22__.evaluate)(selector, referenceAsSchema);
+            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.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((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])($refBaseURI));
+            retrievalURI = this.toBaseURI($refBaseURI);
+            isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(this.reference.uri) === retrievalURI;
+            isExternalReference = !isInternalReference;
 
             // ignore resolving internal Schema Objects
-            if (!this.options.resolve.internal && isInternalReference(retrievalURI)) {
+            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(retrievalURI)) {
+            if (!this.options.resolve.external && isExternalReference) {
               // skip traversing this schema element but traverse all it's child elements
               return undefined;
             }
-            reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.unsanitize($refBaseURI));
-            const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__.uriToPointer)($refBaseURI);
-            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToSchemaElement)((0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__["default"])(selector, reference.value.result));
+            reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
+            const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
+            const referenceAsSchema = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToSchemaElement)(reference.value.result);
+            referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(selector, referenceAsSchema);
+            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.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 _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_21__["default"]) {
-            if ((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_22__.isAnchor)((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_22__.uriToAnchor)($refBaseURI))) {
+          if (isURL && error instanceof _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_23__["default"]) {
+            if ((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_24__.isAnchor)((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_24__.uriToAnchor)($refBaseURI))) {
               // we're dealing with JSON Schema $anchor here
-              retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])($refBaseURI));
+              isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(this.reference.uri) === retrievalURI;
+              isExternalReference = !isInternalReference;
 
               // ignore resolving internal Schema Objects
-              if (!this.options.resolve.internal && isInternalReference(retrievalURI)) {
+              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(retrievalURI)) {
+              if (!this.options.resolve.external && isExternalReference) {
                 // skip traversing this schema element but traverse all it's child elements
                 return undefined;
               }
-              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.unsanitize($refBaseURI));
-              const selector = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_22__.uriToAnchor)($refBaseURI);
-              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_22__.evaluate)(selector, (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToSchemaElement)(reference.value.result));
+              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
+              const selector = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_24__.uriToAnchor)($refBaseURI);
+              const referenceAsSchema = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToSchemaElement)(reference.value.result);
+              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_24__.evaluate)(selector, referenceAsSchema);
+              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToSchemaElement)(referencedElement);
+              referencedElement.id = identityManager.identify(referencedElement);
             } else {
               // we're assuming here that we're dealing with JSON Pointer here
-              retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])($refBaseURI));
+              retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])($refBaseURI));
+              isInternalReference = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(this.reference.uri) === retrievalURI;
+              isExternalReference = !isInternalReference;
 
               // ignore resolving internal Schema Objects
-              if (!this.options.resolve.internal && isInternalReference(retrievalURI)) {
+              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(retrievalURI)) {
+              if (!this.options.resolve.external && isExternalReference) {
                 // skip traversing this schema element but traverse all it's child elements
                 return undefined;
               }
-              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.unsanitize($refBaseURI));
-              const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__.uriToPointer)($refBaseURI);
-              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToSchemaElement)((0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__["default"])(selector, reference.value.result));
+              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
+              const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
+              const referenceAsSchema = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToSchemaElement)(reference.value.result);
+              referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(selector, referenceAsSchema);
+              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToSchemaElement)(referencedElement);
+              referencedElement.id = identityManager.identify(referencedElement);
             }
           } else {
             throw error;
@@ -2984,7 +3071,7 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         }
 
         // detect direct or indirect reference
-        if (this.indirections.includes(referencedElement)) {
+        if (referencingElement === referencedElement) {
           throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Recursive Schema Object reference detected');
         }
 
@@ -2993,106 +3080,134 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
           throw new _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_13__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
 
-        // useCircularStructures option processing
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.includes(referencedElement);
-          if (hasCycles) {
-            if (_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.resolve(retrievalURI, $refBaseURI);
-              const cycledSchemaElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.SchemaElement({
-                $ref: baseURI
-              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(referencingElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(referencingElement.attributes));
-              cycledSchemaElement.get('$ref').classes.push('cycle');
-              return cycledSchemaElement;
+        // 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 _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_12__["default"]('Circular reference detected');
+          } else if (this.options.dereference.circular === 'replace') {
+            const refElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.RefElement(referencedElement.id, {
+              type: 'json-schema',
+              uri: reference.uri,
+              $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref),
+              baseURI: _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, $refBaseURI),
+              referencingElement
+            });
+            const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
+            const replacement = replacer(refElement);
+            if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.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
             }
-            // skip processing this schema and all it's child schemas
-            return false;
+            return !parent ? replacement : false;
           }
         }
 
-        // 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.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__["default"])([...ancestors, parent, referencingElement]), '$ref']
-        });
-        referencedElement = await visitAsync(referencedElement, mergeVisitor, {
-          keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.keyMap,
-          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.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 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 = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+        const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
+        if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.isSchemaElement)(referencedElement) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+          // 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.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          });
+          referencedElement = await visitAsync(referencedElement, mergeVisitor, {
+            keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.keyMap,
+            nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.getNodeType
+          });
 
-        // remove referencing schema from ancestors lineage
-        directAncestors.delete(referencingElement);
+          // remove referencing schema from ancestors lineage
+          directAncestors.delete(referencingElement);
+        }
         this.indirections.pop();
-        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_23__.isBooleanJsonSchemaElement)(referencedElement)) {
-          const booleanJsonSchemaElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(referencedElement);
+        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.isBooleanJsonSchemaElement)(referencedElement)) {
+          const booleanJsonSchemaElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(referencedElement);
           // annotate referenced element with info about original referencing element
           booleanJsonSchemaElement.setMetaProperty('ref-fields', {
-            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref)
+            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(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,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(identityManager.identify(referencingElement)));
-          return booleanJsonSchemaElement;
+          booleanJsonSchemaElement.setMetaProperty('ref-referencing-element-id', (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(identityManager.identify(referencingElement)));
+          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isMemberElement)(parent)) {
+            parent.value = booleanJsonSchemaElement; // eslint-disable-line no-param-reassign
+          } else if (Array.isArray(parent)) {
+            parent[key] = booleanJsonSchemaElement; // eslint-disable-line no-param-reassign
+          }
+          return !parent ? booleanJsonSchemaElement : false;
         }
-        const mergeAndAnnotateReferencedElement = refedElement => {
+
+        /**
+         * Creating a new version of Schema Object by merging fields from referenced Schema Object with referencing one.
+         */
+        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.isSchemaElement)(referencedElement)) {
           // Schema Object - merge keywords from referenced schema with referencing schema
-          const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.SchemaElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(refedElement.attributes));
+          const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.SchemaElement([...referencedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(referencedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(referencedElement.attributes));
           // existing keywords from referencing schema overrides ones from referenced schema
           referencingElement.forEach((value, keyElement, item) => {
-            mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(keyElement));
+            mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(keyElement));
             mergedElement.content.push(item);
           });
           mergedElement.remove('$ref');
           // annotate referenced element with info about original referencing element
           mergedElement.setMetaProperty('ref-fields', {
-            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref)
+            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(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,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_14__.cloneDeep)(identityManager.identify(referencingElement)));
+          mergedElement.setMetaProperty('ref-referencing-element-id', (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.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 = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_7__.resolve(retrievalURI, $refBaseURI);
+              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, $refBaseURI);
               mergedElement.set('$$ref', baseURI);
             }
           }
-          return mergedElement;
-        };
+          referencedElement = mergedElement;
+        }
 
-        // attempting to create cycle
-        if (ancestorsLineage.includes(referencingElement) || ancestorsLineage.includes(referencedElement)) {
-          const replaceWith = ancestorsLineage.findItem(wasReferencedBy(referencingElement)) ?? mergeAndAnnotateReferencedElement(referencedElement);
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isMemberElement)(parent)) {
-            parent.value = replaceWith; // eslint-disable-line no-param-reassign
-          } else if (Array.isArray(parent)) {
-            parent[key] = replaceWith; // eslint-disable-line no-param-reassign
-          }
-          return false;
+        /**
+         * Transclude referencing element with merged referenced element.
+         */
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.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
-        return mergeAndAnnotateReferencedElement(referencedElement);
+        /**
+         * We're at the root of the tree, so we're just replacing the entire tree.
+         */
+        return !parent ? referencedElement : undefined;
       } catch (error) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_17__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_19__["default"])(error);
         const wrappedError = new _errors_index_js__WEBPACK_IMPORTED_MODULE_1__.SchemaRefError(`Could not resolve reference: ${rootCause.message}`, {
           baseDoc: this.reference.uri,
-          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref),
-          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref),
+          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__["default"])([...ancestors, parent, referencingElement]), '$ref']
         }, rootCause);
         this.options.dereference.dereferenceOpts?.errors?.push?.(wrappedError);
         return undefined;
@@ -3108,13 +3223,13 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
     },
     async ExampleElement(exampleElement, key, parent, path, ancestors) {
       try {
-        return await _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_5__["default"].compose.methods.ExampleElement.call(this, exampleElement, key, parent, path, ancestors);
+        return await _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_4__["default"].compose.methods.ExampleElement.call(this, exampleElement, key, parent, path, ancestors);
       } catch (error) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_17__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_19__["default"])(error);
         const wrappedError = wrapError(rootCause, {
           baseDoc: this.reference.uri,
-          externalValue: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(exampleElement.externalValue),
-          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_15__["default"])([...ancestors, parent, exampleElement]), 'externalValue']
+          externalValue: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(exampleElement.externalValue),
+          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__["default"])([...ancestors, parent, exampleElement]), 'externalValue']
         });
         this.options.dereference.dereferenceOpts?.errors?.push?.(wrappedError);
         return undefined;
@@ -4090,23 +4205,26 @@ pojoAdapter.cache = new WeakMap();
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   circularReplacer: () => (/* binding */ circularReplacer),
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(44824);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(65342);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(9999);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(60672);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(18316);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(60489);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(64884);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(3117);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(94145);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(83748);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(12349);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(31387);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(71614);
-/* harmony import */ var _swagger_api_apidom_reference_parse_parsers_binary__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(16960);
-/* harmony import */ var _swagger_api_apidom_reference_resolve_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(47724);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(9999);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(44824);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(87024);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(65342);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(60672);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(18316);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(60489);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(64884);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(3117);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(94145);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(83748);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(12349);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(31387);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(71614);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(48097);
+/* harmony import */ var _swagger_api_apidom_reference_parse_parsers_binary__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(16960);
+/* harmony import */ var _swagger_api_apidom_reference_resolve_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(47724);
 /* harmony import */ var _constants_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(3832);
 /* harmony import */ var _utils_options_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(40428);
 /* harmony import */ var _normalize_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(80947);
@@ -4132,6 +4250,18 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+const circularReplacer = refElement => {
+  const $refBaseURI = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(refElement.meta.get('baseURI'));
+  const referencingElement = refElement.meta.get('referencingElement');
+
+  /**
+   * Removing semantics from the absolutified referencing element by
+   * using generic ObjectElement to represent the reference.
+   */
+  return new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.ObjectElement({
+    $ref: $refBaseURI
+  }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_11__.cloneDeep)(referencingElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_11__.cloneDeep)(referencingElement.attributes));
+};
 const resolveOpenAPI31Strategy = async options => {
   const {
     spec,
@@ -4153,32 +4283,32 @@ const resolveOpenAPI31Strategy = async options => {
     } = resolveOpenAPI31Strategy;
 
     // determining BaseURI
-    const cwd = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__.isHttpUrl(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__.cwd()) ? _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__.cwd() : _constants_js__WEBPACK_IMPORTED_MODULE_0__.DEFAULT_BASE_URL;
+    const cwd = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_12__.isHttpUrl(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_12__.cwd()) ? _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_12__.cwd() : _constants_js__WEBPACK_IMPORTED_MODULE_0__.DEFAULT_BASE_URL;
     const retrievalURI = _utils_options_js__WEBPACK_IMPORTED_MODULE_1__.retrievalURI(options);
-    const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_9__.resolve(cwd, retrievalURI);
+    const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_12__.resolve(cwd, retrievalURI);
 
     // prepare spec for dereferencing
     let openApiElement;
     if (cache.has(spec)) {
       openApiElement = cache.get(spec);
     } else {
-      openApiElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_10__.OpenApi3_1Element.refract(spec);
+      openApiElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__.OpenApi3_1Element.refract(spec);
       openApiElement.classes.push('result');
       cache.set(spec, openApiElement);
     }
-    const openApiParseResultElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_11__.ParseResultElement([openApiElement]);
+    const openApiParseResultElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.ParseResultElement([openApiElement]);
 
     // prepare fragment for dereferencing
-    const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__["default"])(pathDiscriminator);
+    const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_14__["default"])(pathDiscriminator);
     const jsonPointerURI = jsonPointer === '' ? '' : `#${jsonPointer}`;
-    const fragmentElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__["default"])(jsonPointer, openApiElement);
+    const fragmentElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_15__["default"])(jsonPointer, openApiElement);
 
     // prepare reference set for dereferencing
-    const openApiElementReference = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_14__["default"])({
+    const openApiElementReference = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_16__["default"])({
       uri: baseURI,
       value: openApiParseResultElement
     });
-    const refSet = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_15__["default"])({
+    const refSet = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_17__["default"])({
       refs: [openApiElementReference]
     });
     if (jsonPointer !== '') refSet.rootRef = null; // reset root reference as we want fragment to become the root reference
@@ -4186,7 +4316,7 @@ const resolveOpenAPI31Strategy = async options => {
     // prepare ancestors; needed for cases where fragment is not OpenAPI element
     const ancestors = [new Set([fragmentElement])];
     const errors = [];
-    const dereferenced = await (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_16__.dereferenceApiDOM)(fragmentElement, {
+    const dereferenced = await (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_18__.dereferenceApiDOM)(fragmentElement, {
       resolve: {
         /**
          * swagger-client only supports resolving HTTP(S) URLs or spec objects.
@@ -4205,10 +4335,10 @@ const resolveOpenAPI31Strategy = async options => {
             responseInterceptor
           }
         },
-        strategies: [(0,_swagger_api_apidom_reference_resolve_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__["default"])()]
+        strategies: [(0,_swagger_api_apidom_reference_resolve_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__["default"])()]
       },
       parse: {
-        mediaType: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__["default"].latest(),
+        mediaType: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__["default"].latest(),
         parsers: [(0,_apidom_reference_parse_parsers_openapi_json_3_1_index_js__WEBPACK_IMPORTED_MODULE_6__["default"])({
           allowEmpty: false,
           sourceMap: false
@@ -4221,7 +4351,7 @@ const resolveOpenAPI31Strategy = async options => {
         }), (0,_apidom_reference_parse_parsers_yaml_1_2_index_js__WEBPACK_IMPORTED_MODULE_5__["default"])({
           allowEmpty: false,
           sourceMap: false
-        }), (0,_swagger_api_apidom_reference_parse_parsers_binary__WEBPACK_IMPORTED_MODULE_19__["default"])({
+        }), (0,_swagger_api_apidom_reference_parse_parsers_binary__WEBPACK_IMPORTED_MODULE_21__["default"])({
           allowEmpty: false,
           sourceMap: false
         })]
@@ -4240,17 +4370,19 @@ const resolveOpenAPI31Strategy = async options => {
         dereferenceOpts: {
           errors
         },
-        immutable: false
+        immutable: false,
+        circular: useCircularStructures ? 'ignore' : 'replace',
+        circularReplacer: useCircularStructures ? _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_22__["default"].dereference.circularReplacer : circularReplacer
       }
     });
-    const transcluded = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_20__.transclude)(fragmentElement, dereferenced, openApiElement);
+    const transcluded = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_23__.transclude)(fragmentElement, dereferenced, openApiElement);
     const normalized = skipNormalization ? transcluded : (0,_normalize_js__WEBPACK_IMPORTED_MODULE_2__["default"])(transcluded);
     return {
-      spec: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_21__["default"])(normalized),
+      spec: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(normalized),
       errors
     };
   } catch (error) {
-    if (error instanceof _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_22__["default"] || error instanceof _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_23__["default"]) {
+    if (error instanceof _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_24__["default"] || error instanceof _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_25__["default"]) {
       return {
         spec: null,
         errors: []
@@ -16781,7 +16913,7 @@ var defaults = {
     charset: 'utf-8',
     charsetSentinel: false,
     comma: false,
-    decodeDotInKeys: true,
+    decodeDotInKeys: false,
     decoder: utils.decode,
     delimiter: '&',
     depth: 5,
@@ -17544,6 +17676,10 @@ var decode = function (str, decoder, charset) {
     }
 };
 
+var limit = 1024;
+
+/* eslint operator-linebreak: [2, "before"] */
+
 var encode = function encode(str, defaultEncoder, charset, kind, format) {
     // This code was originally written by Brian White (mscdex) for the io.js core querystring library.
     // It has been adapted here for stricter adherence to RFC 3986
@@ -17565,45 +17701,54 @@ var encode = function encode(str, defaultEncoder, charset, kind, format) {
     }
 
     var out = '';
-    for (var i = 0; i < string.length; ++i) {
-        var c = string.charCodeAt(i);
-
-        if (
-            c === 0x2D // -
-            || c === 0x2E // .
-            || c === 0x5F // _
-            || c === 0x7E // ~
-            || (c >= 0x30 && c <= 0x39) // 0-9
-            || (c >= 0x41 && c <= 0x5A) // a-z
-            || (c >= 0x61 && c <= 0x7A) // A-Z
-            || (format === formats.RFC1738 && (c === 0x28 || c === 0x29)) // ( )
-        ) {
-            out += string.charAt(i);
-            continue;
-        }
+    for (var j = 0; j < string.length; j += limit) {
+        var segment = string.length >= limit ? string.slice(j, j + limit) : string;
+        var arr = [];
+
+        for (var i = 0; i < segment.length; ++i) {
+            var c = segment.charCodeAt(i);
+            if (
+                c === 0x2D // -
+                || c === 0x2E // .
+                || c === 0x5F // _
+                || c === 0x7E // ~
+                || (c >= 0x30 && c <= 0x39) // 0-9
+                || (c >= 0x41 && c <= 0x5A) // a-z
+                || (c >= 0x61 && c <= 0x7A) // A-Z
+                || (format === formats.RFC1738 && (c === 0x28 || c === 0x29)) // ( )
+            ) {
+                arr[arr.length] = segment.charAt(i);
+                continue;
+            }
 
-        if (c < 0x80) {
-            out = out + hexTable[c];
-            continue;
-        }
+            if (c < 0x80) {
+                arr[arr.length] = hexTable[c];
+                continue;
+            }
 
-        if (c < 0x800) {
-            out = out + (hexTable[0xC0 | (c >> 6)] + hexTable[0x80 | (c & 0x3F)]);
-            continue;
-        }
+            if (c < 0x800) {
+                arr[arr.length] = hexTable[0xC0 | (c >> 6)]
+                    + hexTable[0x80 | (c & 0x3F)];
+                continue;
+            }
 
-        if (c < 0xD800 || c >= 0xE000) {
-            out = out + (hexTable[0xE0 | (c >> 12)] + hexTable[0x80 | ((c >> 6) & 0x3F)] + hexTable[0x80 | (c & 0x3F)]);
-            continue;
+            if (c < 0xD800 || c >= 0xE000) {
+                arr[arr.length] = hexTable[0xE0 | (c >> 12)]
+                    + hexTable[0x80 | ((c >> 6) & 0x3F)]
+                    + hexTable[0x80 | (c & 0x3F)];
+                continue;
+            }
+
+            i += 1;
+            c = 0x10000 + (((c & 0x3FF) << 10) | (segment.charCodeAt(i) & 0x3FF));
+
+            arr[arr.length] = hexTable[0xF0 | (c >> 18)]
+                + hexTable[0x80 | ((c >> 12) & 0x3F)]
+                + hexTable[0x80 | ((c >> 6) & 0x3F)]
+                + hexTable[0x80 | (c & 0x3F)];
         }
 
-        i += 1;
-        c = 0x10000 + (((c & 0x3FF) << 10) | (string.charCodeAt(i) & 0x3FF));
-        /* eslint operator-linebreak: [2, "before"] */
-        out += hexTable[0xF0 | (c >> 18)]
-            + hexTable[0x80 | ((c >> 12) & 0x3F)]
-            + hexTable[0x80 | ((c >> 6) & 0x3F)]
-            + hexTable[0x80 | (c & 0x3F)];
+        out += arr.join('');
     }
 
     return out;