swagger-client 3.24.4 → 3.24.5

package/dist/swagger-client.browser.js

@@ -2550,25 +2550,27 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(87395);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(50334);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(28552);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(50308);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(66316);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(74144);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(94481);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(84714);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(3608);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(8647);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(69239);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(67625);
-/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(35059);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(71550);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(77079);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(90609);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(14726);
-/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(552);
-/* harmony import */ var _utils_to_path_js__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(21352);
-/* harmony import */ var _utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(28495);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(47644);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(50334);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(28552);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(50308);
+/* harmony import */ var _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(42455);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(66316);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(74144);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(94481);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(84714);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(3608);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(8647);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(69239);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(67625);
+/* harmony import */ var _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(35059);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(71550);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(77079);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(90609);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(14726);
+/* harmony import */ var _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(552);
+/* harmony import */ var _utils_to_path_js__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(21352);
+/* harmony import */ var _utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(28495);
 /* harmony import */ var _specmap_lib_refs_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(58569);
 /* harmony import */ var _errors_index_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(75754);
 /* eslint-disable camelcase */
@@ -2583,11 +2585,21 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
 const {
   wrapError
 } = _specmap_lib_refs_js__WEBPACK_IMPORTED_MODULE_0__["default"];
 const visitAsync = _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_2__.visit[Symbol.for('nodejs.util.promisify.custom')];
-const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__["default"].compose({
+
+// 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({
   props: {
     useCircularStructures: true,
     allowMetaPatches: false,
@@ -2608,32 +2620,37 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
       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)) {
           return false;
         }
 
         // ignore resolving external Reference Objects
-        if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_4__.isReferenceElementExternal)(referencingElement)) {
+        if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_7__.isReferenceElementExternal)(referencingElement)) {
           return false;
         }
-        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref));
+        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
         const {
           uri: retrievalURI
         } = reference;
-        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));
+        const $refBaseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
         this.indirections.push(referencingElement);
-        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
+        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.uriToPointer)($refBaseURI);
 
         // possibly non-semantic fragment
-        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(jsonPointer, reference.value.result);
+        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__["default"])(jsonPointer, reference.value.result);
 
         // applying semantics to a fragment
-        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'));
-          if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_10__.isReferenceLikeElement)(referencedElement)) {
+        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'));
+          if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.isReferenceLikeElement)(referencedElement)) {
             // handling indirect references
-            referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.ReferenceElement.refract(referencedElement);
+            referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.ReferenceElement.refract(referencedElement);
             referencedElement.setMetaProperty('referenced-element', referencedElementType);
           } else {
             // handling direct references
@@ -2644,21 +2661,23 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
 
         // detect direct or indirect reference
         if (this.indirections.includes(referencedElement)) {
-          throw new Error('Recursive JSON Pointer detected');
+          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_13__["default"]('Recursive JSON Pointer 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_12__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+          throw new _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_14__["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_6__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.isFileSystemPath(retrievalURI)) {
+            if (_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.isFileSystemPath(retrievalURI)) {
               // make the referencing URL or file system path absolute
-              return new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.ReferenceElement({
+              const cycledReferenceElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.ReferenceElement({
                 $ref: $refBaseURI
-              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(referencingElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(referencingElement.attributes));
+              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(referencingElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(referencingElement.attributes));
+              cycledReferenceElement.get('$ref').classes.push('cycle');
+              return cycledReferenceElement;
             }
             // skip processing this reference
             return false;
@@ -2677,51 +2696,47 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
           ancestors: ancestorsLineage,
           allowMetaPatches: this.allowMetaPatches,
           useCircularStructures: this.useCircularStructures,
-          basePath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_14__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          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_15__.keyMap,
-          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
+          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);
         this.indirections.pop();
         const mergeAndAnnotateReferencedElement = refedElement => {
-          const copy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneShallow)(refedElement);
+          const copy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneShallow)(refedElement);
 
           // annotate fragment with info about original Reference element
           copy.setMetaProperty('ref-fields', {
-            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref),
-            // @ts-ignore
-            description: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.description),
-            // @ts-ignore
-            summary: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.summary)
+            $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_15__.cloneDeep)(identityManager.identify(referencingElement)));
 
           // override description and summary (outer has higher priority then inner)
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isObjectElement)(refedElement)) {
+          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isObjectElement)(refedElement)) {
             if (referencingElement.hasKey('description') && 'description' in refedElement) {
-              // @ts-ignore
               copy.remove('description');
-              // @ts-ignore
               copy.set('description', referencingElement.get('description'));
             }
             if (referencingElement.hasKey('summary') && 'summary' in refedElement) {
-              // @ts-ignore
               copy.remove('summary');
-              // @ts-ignore
               copy.set('summary', referencingElement.get('summary'));
             }
           }
 
           // apply meta patches
-          if (this.allowMetaPatches && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isObjectElement)(copy)) {
+          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_6__.resolve(retrievalURI, $refBaseURI);
+              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.resolve(retrievalURI, $refBaseURI);
               copy.set('$$ref', baseURI);
             }
           }
@@ -2729,11 +2744,12 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         };
 
         // attempting to create cycle
-        if (ancestorsLineage.includes(referencedElement)) {
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isMemberElement)(parent)) {
-            parent.value = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+        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] = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+            parent[key] = replaceWith; // eslint-disable-line no-param-reassign
           }
 
           return false;
@@ -2742,12 +2758,12 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         // transclude the element for a fragment
         return mergeAndAnnotateReferencedElement(referencedElement);
       } catch (error) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_16__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_18__["default"])(error);
         const wrappedError = wrapError(rootCause, {
           baseDoc: this.reference.uri,
-          $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_14__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref),
+          pointer: (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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;
@@ -2758,52 +2774,59 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
         // ignore PathItemElement without $ref field
-        if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isStringElement)(pathItemElement.$ref)) {
+        if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.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)) {
+          return false;
+        }
+
         // detect possible cycle in traversal and avoid it
         if (ancestorsLineage.includesCycle(pathItemElement)) {
           return false;
         }
 
         // ignore resolving external Path Item Elements
-        if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_4__.isPathItemElementExternal)(pathItemElement)) {
+        if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_7__.isPathItemElementExternal)(pathItemElement)) {
           return undefined;
         }
-        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(pathItemElement.$ref));
+        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref));
         const {
           uri: retrievalURI
         } = reference;
-        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));
+        const $refBaseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref));
         this.indirections.push(pathItemElement);
-        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
+        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.uriToPointer)($refBaseURI);
 
         // possibly non-semantic referenced element
-        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(jsonPointer, reference.value.result);
+        let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__["default"])(jsonPointer, reference.value.result);
 
         // applying semantics to a referenced element
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isPrimitiveElement)(referencedElement)) {
-          referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.PathItemElement.refract(referencedElement);
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.isPrimitiveElement)(referencedElement)) {
+          referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.PathItemElement.refract(referencedElement);
         }
 
         // detect direct or indirect reference
         if (this.indirections.includes(referencedElement)) {
-          throw new Error('Recursive JSON Pointer detected');
+          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_13__["default"]('Recursive JSON Pointer 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_12__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+          throw new _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_14__["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_6__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.isFileSystemPath(retrievalURI)) {
+            if (_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.isFileSystemPath(retrievalURI)) {
               // make the referencing URL or file system path absolute
-              return new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.PathItemElement({
+              const cycledPathItemElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.PathItemElement({
                 $ref: $refBaseURI
-              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(pathItemElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(pathItemElement.attributes));
+              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(pathItemElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(pathItemElement.attributes));
+              cycledPathItemElement.get('$ref').classes.push('cycle');
+              return cycledPathItemElement;
             }
             // skip processing this path item and all it's child elements
             return false;
@@ -2822,11 +2845,11 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
           ancestors: ancestorsLineage,
           allowMetaPatches: this.allowMetaPatches,
           useCircularStructures: this.useCircularStructures,
-          basePath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_14__["default"])([...ancestors, parent, pathItemElement]), '$ref']
+          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_15__.keyMap,
-          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
+          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
@@ -2834,26 +2857,28 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         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_13__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(refedElement.attributes));
+          const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.PathItemElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(refedElement.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_5__["default"])(keyElement));
+            mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_5__["default"])(pathItemElement.$ref)
+            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_15__.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_6__.resolve(retrievalURI, $refBaseURI);
+              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.resolve(retrievalURI, $refBaseURI);
               mergedElement.set('$$ref', baseURI);
             }
           }
@@ -2861,11 +2886,12 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         };
 
         // attempting to create cycle
-        if (ancestorsLineage.includes(referencedElement)) {
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isMemberElement)(parent)) {
-            parent.value = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+        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] = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+            parent[key] = replaceWith; // eslint-disable-line no-param-reassign
           }
 
           return false;
@@ -2874,12 +2900,12 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         // transclude referencing element with merged referenced element
         return mergeAndAnnotateReferencedElement(referencedElement);
       } catch (error) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_16__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_18__["default"])(error);
         const wrappedError = wrapError(rootCause, {
           baseDoc: this.reference.uri,
-          $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_14__["default"])([...ancestors, parent, pathItemElement]), '$ref']
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(pathItemElement.$ref),
+          pointer: (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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;
@@ -2890,24 +2916,29 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         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_9__.isStringElement)(referencingElement.$ref)) {
+        if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_6__.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)) {
           return false;
         }
 
         // compute baseURI using rules around $id and $ref keywords
-        let reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize(this.reference.uri));
+        let reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.unsanitize(this.reference.uri));
         let {
           uri: retrievalURI
         } = reference;
-        const $refBaseURI = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.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_18__["default"])({
+        const $refBaseURI = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__.resolveSchema$refField)(retrievalURI, referencingElement);
+        const $refBaseURIStrippedHash = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.stripHash($refBaseURI);
+        const file = (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_20__["default"])({
           uri: $refBaseURIStrippedHash
         });
         const isUnknownURI = !this.options.resolve.resolvers.some(r => r.canRead(file));
@@ -2927,32 +2958,32 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
           if (isUnknownURI || isURL) {
             // we're dealing with canonical URI or URL with possible fragment
             const selector = $refBaseURI;
-            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_19__.evaluate)(selector, (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.maybeRefractToSchemaElement)(reference.value.result));
+            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_21__.evaluate)(selector, (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__.maybeRefractToSchemaElement)(reference.value.result));
           } else {
             // we're assuming here that we're dealing with JSON Pointer here
-            reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
+            reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.unsanitize($refBaseURI));
             retrievalURI = reference.uri;
-            const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
-            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.maybeRefractToSchemaElement)((0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(selector, reference.value.result));
+            const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.uriToPointer)($refBaseURI);
+            referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__.maybeRefractToSchemaElement)((0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__["default"])(selector, reference.value.result));
           }
         } 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_20__["default"]) {
-            if ((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_21__.isAnchor)((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_21__.uriToAnchor)($refBaseURI))) {
+          if (isURL && error instanceof _swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_uri__WEBPACK_IMPORTED_MODULE_22__["default"]) {
+            if ((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_23__.isAnchor)((0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_23__.uriToAnchor)($refBaseURI))) {
               // we're dealing with JSON Schema $anchor here
-              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
+              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.unsanitize($refBaseURI));
               retrievalURI = reference.uri;
-              const selector = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_21__.uriToAnchor)($refBaseURI);
-              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_21__.evaluate)(selector, (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.maybeRefractToSchemaElement)(reference.value.result));
+              const selector = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_23__.uriToAnchor)($refBaseURI);
+              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1_selectors_$anchor__WEBPACK_IMPORTED_MODULE_23__.evaluate)(selector, (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__.maybeRefractToSchemaElement)(reference.value.result));
             } else {
               // we're assuming here that we're dealing with JSON Pointer here
-              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
+              reference = await this.toReference(_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.unsanitize($refBaseURI));
               retrievalURI = reference.uri;
-              const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_7__.uriToPointer)($refBaseURI);
-              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.maybeRefractToSchemaElement)((0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_8__["default"])(selector, reference.value.result));
+              const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.uriToPointer)($refBaseURI);
+              referencedElement = (0,_swagger_api_apidom_reference_dereference_strategies_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__.maybeRefractToSchemaElement)((0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__["default"])(selector, reference.value.result));
             }
           } else {
             throw error;
@@ -2961,24 +2992,26 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
 
         // detect direct or indirect reference
         if (this.indirections.includes(referencedElement)) {
-          throw new Error('Recursive Schema Object reference detected');
+          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_13__["default"]('Recursive Schema 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_12__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+          throw new _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_14__["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.some(ancs => ancs.has(referencedElement));
+          const hasCycles = ancestorsLineage.includes(referencedElement);
           if (hasCycles) {
-            if (_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.isFileSystemPath(retrievalURI)) {
+            if (_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.isHttpUrl(retrievalURI) || _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.isFileSystemPath(retrievalURI)) {
               // make the referencing URL or file system path absolute
-              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, $refBaseURI);
-              return new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.SchemaElement({
+              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.resolve(retrievalURI, $refBaseURI);
+              const cycledSchemaElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.SchemaElement({
                 $ref: baseURI
-              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(referencingElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(referencingElement.attributes));
+              }, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(referencingElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(referencingElement.attributes));
+              cycledSchemaElement.get('$ref').classes.push('cycle');
+              return cycledSchemaElement;
             }
             // skip processing this schema and all it's child schemas
             return false;
@@ -2997,47 +3030,51 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
           useCircularStructures: this.useCircularStructures,
           allowMetaPatches: this.allowMetaPatches,
           ancestors: ancestorsLineage,
-          basePath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_14__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          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_15__.keyMap,
-          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
+          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);
         this.indirections.pop();
-        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_4__.isBooleanJsonSchemaElement)(referencedElement)) {
-          const booleanJsonSchemaElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(referencedElement);
+        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_7__.isBooleanJsonSchemaElement)(referencedElement)) {
+          const booleanJsonSchemaElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(referencedElement);
           // annotate referenced element with info about original referencing element
           booleanJsonSchemaElement.setMetaProperty('ref-fields', {
-            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref)
+            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_15__.cloneDeep)(identityManager.identify(referencingElement)));
           return booleanJsonSchemaElement;
         }
         const mergeAndAnnotateReferencedElement = refedElement => {
           // 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_13__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_13__.cloneDeep)(refedElement.attributes));
+          const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_12__.SchemaElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_15__.cloneDeep)(refedElement.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_5__["default"])(keyElement));
+            mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_5__["default"])(referencingElement.$ref)
+            $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_15__.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_6__.resolve(retrievalURI, $refBaseURI);
+              const baseURI = _swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_8__.resolve(retrievalURI, $refBaseURI);
               mergedElement.set('$$ref', baseURI);
             }
           }
@@ -3045,11 +3082,12 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         };
 
         // attempting to create cycle
-        if (ancestorsLineage.includes(referencedElement)) {
-          if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__.isMemberElement)(parent)) {
-            parent.value = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+        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] = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+            parent[key] = replaceWith; // eslint-disable-line no-param-reassign
           }
 
           return false;
@@ -3058,11 +3096,11 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _swagger_api_apidom_reference_
         // transclude referencing element with merged referenced element
         return mergeAndAnnotateReferencedElement(referencedElement);
       } catch (error) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_16__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_18__["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_5__["default"])(referencingElement.$ref),
-          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_14__["default"])([...ancestors, parent, referencingElement]), '$ref']
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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;
@@ -3078,13 +3116,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_3__["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_5__["default"].compose.methods.ExampleElement.call(this, exampleElement, key, parent, path, ancestors);
       } catch (error) {
-        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_16__["default"])(error);
+        const rootCause = (0,_utils_get_root_cause_js__WEBPACK_IMPORTED_MODULE_18__["default"])(error);
         const wrappedError = wrapError(rootCause, {
           baseDoc: this.reference.uri,
-          externalValue: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(exampleElement.externalValue),
-          fullPath: this.basePath ?? [...(0,_utils_to_path_js__WEBPACK_IMPORTED_MODULE_14__["default"])([...ancestors, parent, exampleElement]), 'externalValue']
+          externalValue: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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;
@@ -4166,7 +4204,7 @@ const resolveOpenAPI31Strategy = async options => {
     if (jsonPointer !== '') refSet.rootRef = null; // reset root reference as we want fragment to become the root reference
 
     // prepare ancestors; needed for cases where fragment is not OpenAPI element
-    const ancestors = [new WeakSet([fragmentElement])];
+    const ancestors = [new Set([fragmentElement])];
     const errors = [];
     const dereferenced = await (0,_swagger_api_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_16__.dereferenceApiDOM)(fragmentElement, {
       resolve: {
@@ -18827,6 +18865,480 @@ var trimCharsStart = (0,ramda__WEBPACK_IMPORTED_MODULE_0__.curry)(function (char
 
 /***/ }),
 
+/***/ 77913:
+/***/ ((module) => {
+
+"use strict";
+
+var ShortUniqueId = (() => {
+  var __defProp = Object.defineProperty;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __propIsEnum = Object.prototype.propertyIsEnumerable;
+  var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+  var __spreadValues = (a, b) => {
+    for (var prop in b || (b = {}))
+      if (__hasOwnProp.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    if (__getOwnPropSymbols)
+      for (var prop of __getOwnPropSymbols(b)) {
+        if (__propIsEnum.call(b, prop))
+          __defNormalProp(a, prop, b[prop]);
+      }
+    return a;
+  };
+  var __export = (target, all) => {
+    for (var name in all)
+      __defProp(target, name, { get: all[name], enumerable: true });
+  };
+  var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from === "object" || typeof from === "function") {
+      for (let key of __getOwnPropNames(from))
+        if (!__hasOwnProp.call(to, key) && key !== except)
+          __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+    }
+    return to;
+  };
+  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+  var __publicField = (obj, key, value) => {
+    __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+    return value;
+  };
+
+  // src/index.ts
+  var src_exports = {};
+  __export(src_exports, {
+    DEFAULT_OPTIONS: () => DEFAULT_OPTIONS,
+    DEFAULT_UUID_LENGTH: () => DEFAULT_UUID_LENGTH,
+    default: () => ShortUniqueId
+  });
+
+  // package.json
+  var version = "5.0.2";
+
+  // src/index.ts
+  var DEFAULT_UUID_LENGTH = 6;
+  var DEFAULT_OPTIONS = {
+    dictionary: "alphanum",
+    shuffle: true,
+    debug: false,
+    length: DEFAULT_UUID_LENGTH,
+    counter: 0
+  };
+  var _ShortUniqueId = class _ShortUniqueId {
+    constructor(argOptions = {}) {
+      __publicField(this, "counter");
+      __publicField(this, "debug");
+      __publicField(this, "dict");
+      __publicField(this, "version");
+      __publicField(this, "dictIndex", 0);
+      __publicField(this, "dictRange", []);
+      __publicField(this, "lowerBound", 0);
+      __publicField(this, "upperBound", 0);
+      __publicField(this, "dictLength", 0);
+      __publicField(this, "uuidLength");
+      __publicField(this, "_digit_first_ascii", 48);
+      __publicField(this, "_digit_last_ascii", 58);
+      __publicField(this, "_alpha_lower_first_ascii", 97);
+      __publicField(this, "_alpha_lower_last_ascii", 123);
+      __publicField(this, "_hex_last_ascii", 103);
+      __publicField(this, "_alpha_upper_first_ascii", 65);
+      __publicField(this, "_alpha_upper_last_ascii", 91);
+      __publicField(this, "_number_dict_ranges", {
+        digits: [this._digit_first_ascii, this._digit_last_ascii]
+      });
+      __publicField(this, "_alpha_dict_ranges", {
+        lowerCase: [this._alpha_lower_first_ascii, this._alpha_lower_last_ascii],
+        upperCase: [this._alpha_upper_first_ascii, this._alpha_upper_last_ascii]
+      });
+      __publicField(this, "_alpha_lower_dict_ranges", {
+        lowerCase: [this._alpha_lower_first_ascii, this._alpha_lower_last_ascii]
+      });
+      __publicField(this, "_alpha_upper_dict_ranges", {
+        upperCase: [this._alpha_upper_first_ascii, this._alpha_upper_last_ascii]
+      });
+      __publicField(this, "_alphanum_dict_ranges", {
+        digits: [this._digit_first_ascii, this._digit_last_ascii],
+        lowerCase: [this._alpha_lower_first_ascii, this._alpha_lower_last_ascii],
+        upperCase: [this._alpha_upper_first_ascii, this._alpha_upper_last_ascii]
+      });
+      __publicField(this, "_alphanum_lower_dict_ranges", {
+        digits: [this._digit_first_ascii, this._digit_last_ascii],
+        lowerCase: [this._alpha_lower_first_ascii, this._alpha_lower_last_ascii]
+      });
+      __publicField(this, "_alphanum_upper_dict_ranges", {
+        digits: [this._digit_first_ascii, this._digit_last_ascii],
+        upperCase: [this._alpha_upper_first_ascii, this._alpha_upper_last_ascii]
+      });
+      __publicField(this, "_hex_dict_ranges", {
+        decDigits: [this._digit_first_ascii, this._digit_last_ascii],
+        alphaDigits: [this._alpha_lower_first_ascii, this._hex_last_ascii]
+      });
+      __publicField(this, "_dict_ranges", {
+        _number_dict_ranges: this._number_dict_ranges,
+        _alpha_dict_ranges: this._alpha_dict_ranges,
+        _alpha_lower_dict_ranges: this._alpha_lower_dict_ranges,
+        _alpha_upper_dict_ranges: this._alpha_upper_dict_ranges,
+        _alphanum_dict_ranges: this._alphanum_dict_ranges,
+        _alphanum_lower_dict_ranges: this._alphanum_lower_dict_ranges,
+        _alphanum_upper_dict_ranges: this._alphanum_upper_dict_ranges,
+        _hex_dict_ranges: this._hex_dict_ranges
+      });
+      /* tslint:disable consistent-return */
+      __publicField(this, "log", (...args) => {
+        const finalArgs = [...args];
+        finalArgs[0] = `[short-unique-id] ${args[0]}`;
+        if (this.debug === true) {
+          if (typeof console !== "undefined" && console !== null) {
+            return console.log(...finalArgs);
+          }
+        }
+      });
+      /* tslint:enable consistent-return */
+      /** Change the dictionary after initialization. */
+      __publicField(this, "setDictionary", (dictionary, shuffle) => {
+        let finalDict;
+        if (dictionary && Array.isArray(dictionary) && dictionary.length > 1) {
+          finalDict = dictionary;
+        } else {
+          finalDict = [];
+          let i;
+          this.dictIndex = i = 0;
+          const rangesName = `_${dictionary}_dict_ranges`;
+          const ranges = this._dict_ranges[rangesName];
+          Object.keys(ranges).forEach((rangeType) => {
+            const rangeTypeKey = rangeType;
+            this.dictRange = ranges[rangeTypeKey];
+            this.lowerBound = this.dictRange[0];
+            this.upperBound = this.dictRange[1];
+            for (this.dictIndex = i = this.lowerBound; this.lowerBound <= this.upperBound ? i < this.upperBound : i > this.upperBound; this.dictIndex = this.lowerBound <= this.upperBound ? i += 1 : i -= 1) {
+              finalDict.push(String.fromCharCode(this.dictIndex));
+            }
+          });
+        }
+        if (shuffle) {
+          const PROBABILITY = 0.5;
+          finalDict = finalDict.sort(() => Math.random() - PROBABILITY);
+        }
+        this.dict = finalDict;
+        this.dictLength = this.dict.length;
+        this.setCounter(0);
+      });
+      __publicField(this, "seq", () => {
+        return this.sequentialUUID();
+      });
+      /**
+       * Generates UUID based on internal counter that's incremented after each ID generation.
+       * @alias `const uid = new ShortUniqueId(); uid.seq();`
+       */
+      __publicField(this, "sequentialUUID", () => {
+        let counterDiv;
+        let counterRem;
+        let id = "";
+        counterDiv = this.counter;
+        do {
+          counterRem = counterDiv % this.dictLength;
+          counterDiv = Math.trunc(counterDiv / this.dictLength);
+          id += this.dict[counterRem];
+        } while (counterDiv !== 0);
+        this.counter += 1;
+        return id;
+      });
+      __publicField(this, "rnd", (uuidLength = this.uuidLength || DEFAULT_UUID_LENGTH) => {
+        return this.randomUUID(uuidLength);
+      });
+      /**
+       * Generates UUID by creating each part randomly.
+       * @alias `const uid = new ShortUniqueId(); uid.rnd(uuidLength: number);`
+       */
+      __publicField(this, "randomUUID", (uuidLength = this.uuidLength || DEFAULT_UUID_LENGTH) => {
+        let id;
+        let randomPartIdx;
+        let j;
+        if (uuidLength === null || typeof uuidLength === "undefined" || uuidLength < 1) {
+          throw new Error("Invalid UUID Length Provided");
+        }
+        const isPositive = uuidLength >= 0;
+        id = "";
+        for (j = 0; j < uuidLength; j += 1) {
+          randomPartIdx = parseInt(
+            (Math.random() * this.dictLength).toFixed(0),
+            10
+          ) % this.dictLength;
+          id += this.dict[randomPartIdx];
+        }
+        return id;
+      });
+      __publicField(this, "fmt", (format, date) => {
+        return this.formattedUUID(format, date);
+      });
+      /**
+       * Generates custom UUID with the provided format string.
+       * @alias `const uid = new ShortUniqueId(); uid.fmt(format: string);`
+       */
+      __publicField(this, "formattedUUID", (format, date) => {
+        const fnMap = {
+          "$r": this.randomUUID,
+          "$s": this.sequentialUUID,
+          "$t": this.stamp
+        };
+        const result = format.replace(
+          /\$[rs]\d{0,}|\$t0|\$t[1-9]\d{1,}/g,
+          (m) => {
+            const fn = m.slice(0, 2);
+            const len = parseInt(m.slice(2), 10);
+            if (fn === "$s") {
+              return fnMap[fn]().padStart(len, "0");
+            }
+            if (fn === "$t" && date) {
+              return fnMap[fn](len, date);
+            }
+            return fnMap[fn](len);
+          }
+        );
+        return result;
+      });
+      /**
+       * Calculates total number of possible UUIDs.
+       *
+       * Given that:
+       *
+       * - `H` is the total number of possible UUIDs
+       * - `n` is the number of unique characters in the dictionary
+       * - `l` is the UUID length
+       *
+       * Then `H` is defined as `n` to the power of `l`:
+       *
+       * <div style="background: white; padding: 5px; border-radius: 5px; overflow: hidden;">
+       *  <img src="https://render.githubusercontent.com/render/math?math=%5CHuge%20H=n%5El"/>
+       * </div>
+       *
+       * This function returns `H`.
+       */
+      __publicField(this, "availableUUIDs", (uuidLength = this.uuidLength) => {
+        return parseFloat(
+          Math.pow([...new Set(this.dict)].length, uuidLength).toFixed(0)
+        );
+      });
+      /**
+       * Calculates approximate number of hashes before first collision.
+       *
+       * Given that:
+       *
+       * - `H` is the total number of possible UUIDs, or in terms of this library,
+       * the result of running `availableUUIDs()`
+       * - the expected number of values we have to choose before finding the
+       * first collision can be expressed as the quantity `Q(H)`
+       *
+       * Then `Q(H)` can be approximated as the square root of the product of half
+       * of pi times `H`:
+       *
+       * <div style="background: white; padding: 5px; border-radius: 5px; overflow: hidden;">
+       *  <img src="https://render.githubusercontent.com/render/math?math=%5CHuge%20Q(H)%5Capprox%5Csqrt%7B%5Cfrac%7B%5Cpi%7D%7B2%7DH%7D"/>
+       * </div>
+       *
+       * This function returns `Q(H)`.
+       * 
+       * (see [Poisson distribution](https://en.wikipedia.org/wiki/Poisson_distribution))
+       */
+      __publicField(this, "approxMaxBeforeCollision", (rounds = this.availableUUIDs(this.uuidLength)) => {
+        return parseFloat(
+          Math.sqrt(Math.PI / 2 * rounds).toFixed(20)
+        );
+      });
+      /**
+       * Calculates probability of generating duplicate UUIDs (a collision) in a
+       * given number of UUID generation rounds.
+       *
+       * Given that:
+       *
+       * - `r` is the maximum number of times that `randomUUID()` will be called,
+       * or better said the number of _rounds_
+       * - `H` is the total number of possible UUIDs, or in terms of this library,
+       * the result of running `availableUUIDs()`
+       *
+       * Then the probability of collision `p(r; H)` can be approximated as the result
+       * of dividing the square root of the product of half of pi times `r` by `H`:
+       *
+       * <div style="background: white; padding: 5px; border-radius: 5px; overflow: hidden;">
+       *  <img src="https://render.githubusercontent.com/render/math?math=%5CHuge%20p(r%3B%20H)%5Capprox%5Cfrac%7B%5Csqrt%7B%5Cfrac%7B%5Cpi%7D%7B2%7Dr%7D%7D%7BH%7D"/>
+       * </div>
+       *
+       * This function returns `p(r; H)`.
+       * 
+       * (see [Poisson distribution](https://en.wikipedia.org/wiki/Poisson_distribution))
+       *
+       * (Useful if you are wondering _"If I use this lib and expect to perform at most
+       * `r` rounds of UUID generations, what is the probability that I will hit a duplicate UUID?"_.)
+       */
+      __publicField(this, "collisionProbability", (rounds = this.availableUUIDs(this.uuidLength), uuidLength = this.uuidLength) => {
+        return parseFloat(
+          (this.approxMaxBeforeCollision(rounds) / this.availableUUIDs(uuidLength)).toFixed(20)
+        );
+      });
+      /**
+       * Calculate a "uniqueness" score (from 0 to 1) of UUIDs based on size of
+       * dictionary and chosen UUID length.
+       *
+       * Given that:
+       *
+       * - `H` is the total number of possible UUIDs, or in terms of this library,
+       * the result of running `availableUUIDs()`
+       * - `Q(H)` is the approximate number of hashes before first collision,
+       * or in terms of this library, the result of running `approxMaxBeforeCollision()`
+       *
+       * Then `uniqueness` can be expressed as the additive inverse of the probability of
+       * generating a "word" I had previously generated (a duplicate) at any given iteration
+       * up to the the total number of possible UUIDs expressed as the quotiend of `Q(H)` and `H`:
+       *
+       * <div style="background: white; padding: 5px; border-radius: 5px; overflow: hidden;">
+       *  <img src="https://render.githubusercontent.com/render/math?math=%5CHuge%201-%5Cfrac%7BQ(H)%7D%7BH%7D"/>
+       * </div>
+       *
+       * (Useful if you need a value to rate the "quality" of the combination of given dictionary
+       * and UUID length. The closer to 1, higher the uniqueness and thus better the quality.)
+       */
+      __publicField(this, "uniqueness", (rounds = this.availableUUIDs(this.uuidLength)) => {
+        const score = parseFloat(
+          (1 - this.approxMaxBeforeCollision(rounds) / rounds).toFixed(20)
+        );
+        return score > 1 ? 1 : score < 0 ? 0 : score;
+      });
+      /**
+       * Return the version of this module.
+       */
+      __publicField(this, "getVersion", () => {
+        return this.version;
+      });
+      /**
+       * Generates a UUID with a timestamp that can be extracted using `uid.parseStamp(stampString);`.
+       * 
+       * ```js
+       *  const uidWithTimestamp = uid.stamp(32);
+       *  console.log(uidWithTimestamp);
+       *  // GDa608f973aRCHLXQYPTbKDbjDeVsSb3
+       * 
+       *  console.log(uid.parseStamp(uidWithTimestamp));
+       *  // 2021-05-03T06:24:58.000Z
+       *  ```
+       */
+      __publicField(this, "stamp", (finalLength, date) => {
+        const hexStamp = Math.floor(+(date || /* @__PURE__ */ new Date()) / 1e3).toString(16);
+        if (typeof finalLength === "number" && finalLength === 0) {
+          return hexStamp;
+        }
+        if (typeof finalLength !== "number" || finalLength < 10) {
+          throw new Error(
+            [
+              "Param finalLength must be a number greater than or equal to 10,",
+              "or 0 if you want the raw hexadecimal timestamp"
+            ].join("\n")
+          );
+        }
+        const idLength = finalLength - 9;
+        const rndIdx = Math.round(Math.random() * (idLength > 15 ? 15 : idLength));
+        const id = this.randomUUID(idLength);
+        return `${id.substring(0, rndIdx)}${hexStamp}${id.substring(rndIdx)}${rndIdx.toString(16)}`;
+      });
+      /**
+       * Extracts the date embeded in a UUID generated using the `uid.stamp(finalLength);` method.
+       * 
+       * ```js
+       *  const uidWithTimestamp = uid.stamp(32);
+       *  console.log(uidWithTimestamp);
+       *  // GDa608f973aRCHLXQYPTbKDbjDeVsSb3
+       * 
+       *  console.log(uid.parseStamp(uidWithTimestamp));
+       *  // 2021-05-03T06:24:58.000Z
+       *  ```
+       */
+      __publicField(this, "parseStamp", (suid, format) => {
+        if (format && !/t0|t[1-9]\d{1,}/.test(format)) {
+          throw new Error("Cannot extract date from a formated UUID with no timestamp in the format");
+        }
+        const stamp = format ? format.replace(
+          /\$[rs]\d{0,}|\$t0|\$t[1-9]\d{1,}/g,
+          (m) => {
+            const fnMap = {
+              "$r": (len2) => [...Array(len2)].map(() => "r").join(""),
+              "$s": (len2) => [...Array(len2)].map(() => "s").join(""),
+              "$t": (len2) => [...Array(len2)].map(() => "t").join("")
+            };
+            const fn = m.slice(0, 2);
+            const len = parseInt(m.slice(2), 10);
+            return fnMap[fn](len);
+          }
+        ).replace(
+          /^(.*?)(t{8,})(.*)$/g,
+          (_m, p1, p2) => {
+            return suid.substring(p1.length, p1.length + p2.length);
+          }
+        ) : suid;
+        if (stamp.length === 8) {
+          return new Date(parseInt(stamp, 16) * 1e3);
+        }
+        if (stamp.length < 10) {
+          throw new Error("Stamp length invalid");
+        }
+        const rndIdx = parseInt(stamp.substring(stamp.length - 1), 16);
+        return new Date(parseInt(stamp.substring(rndIdx, rndIdx + 8), 16) * 1e3);
+      });
+      /**
+       * Set the counter to a specific value.
+       */
+      __publicField(this, "setCounter", (counter) => {
+        this.counter = counter;
+      });
+      const options = __spreadValues(__spreadValues({}, DEFAULT_OPTIONS), argOptions);
+      this.counter = 0;
+      this.debug = false;
+      this.dict = [];
+      this.version = version;
+      const {
+        dictionary,
+        shuffle,
+        length,
+        counter
+      } = options;
+      this.uuidLength = length;
+      this.setDictionary(dictionary, shuffle);
+      this.setCounter(counter);
+      this.debug = options.debug;
+      this.log(this.dict);
+      this.log(
+        `Generator instantiated with Dictionary Size ${this.dictLength} and counter set to ${this.counter}`
+      );
+      this.log = this.log.bind(this);
+      this.setDictionary = this.setDictionary.bind(this);
+      this.setCounter = this.setCounter.bind(this);
+      this.seq = this.seq.bind(this);
+      this.sequentialUUID = this.sequentialUUID.bind(this);
+      this.rnd = this.rnd.bind(this);
+      this.randomUUID = this.randomUUID.bind(this);
+      this.fmt = this.fmt.bind(this);
+      this.formattedUUID = this.formattedUUID.bind(this);
+      this.availableUUIDs = this.availableUUIDs.bind(this);
+      this.approxMaxBeforeCollision = this.approxMaxBeforeCollision.bind(this);
+      this.collisionProbability = this.collisionProbability.bind(this);
+      this.uniqueness = this.uniqueness.bind(this);
+      this.getVersion = this.getVersion.bind(this);
+      this.stamp = this.stamp.bind(this);
+      this.parseStamp = this.parseStamp.bind(this);
+      return this;
+    }
+  };
+  /** @hidden */
+  __publicField(_ShortUniqueId, "default", _ShortUniqueId);
+  var ShortUniqueId = _ShortUniqueId;
+  return __toCommonJS(src_exports);
+})();
+//# sourceMappingURL=short-unique-id.js.map
+ true&&(module.exports=ShortUniqueId.default),'undefined'!=typeof window&&(ShortUniqueId=ShortUniqueId.default);
+
+/***/ }),
+
 /***/ 37478:
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
@@ -19825,7 +20337,7 @@ class CloneError extends _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_0__[
   constructor(message, structuredOptions) {
     super(message, structuredOptions);
     if (typeof structuredOptions !== 'undefined') {
-      this.value = structuredOptions.source;
+      this.value = structuredOptions.value;
     }
   }
 }
@@ -20260,6 +20772,103 @@ class SourceMap extends minim__WEBPACK_IMPORTED_MODULE_0__.ArrayElement {
 
 /***/ }),
 
+/***/ 66398:
+/***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) => {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
+/* harmony export */ });
+/* harmony import */ var _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(29096);
+
+class ElementIdentityError extends _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_0__["default"] {
+  constructor(message, structuredOptions) {
+    super(message, structuredOptions);
+    if (typeof structuredOptions !== 'undefined') {
+      this.value = structuredOptions.value;
+    }
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (ElementIdentityError);
+
+/***/ }),
+
+/***/ 47644:
+/***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) => {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   IdentityManager: () => (/* binding */ IdentityManager),
+/* harmony export */   defaultIdentityManager: () => (/* binding */ defaultIdentityManager)
+/* harmony export */ });
+/* harmony import */ var minim__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(43500);
+/* harmony import */ var stampit__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(43992);
+/* harmony import */ var short_unique_id__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(77913);
+/* harmony import */ var _errors_ElementIdentityError_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(66398);
+/* harmony import */ var _predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(28552);
+
+
+
+
+
+const IdentityManager = stampit__WEBPACK_IMPORTED_MODULE_1__({
+  props: {
+    uuid: null,
+    length: null,
+    identityMap: null
+  },
+  init({
+    length = 6
+  } = {}) {
+    this.length = 6;
+    this.uuid = new short_unique_id__WEBPACK_IMPORTED_MODULE_2__({
+      length
+    });
+    this.identityMap = new WeakMap();
+  },
+  methods: {
+    identify(element) {
+      if (!(0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__.isElement)(element)) {
+        throw new _errors_ElementIdentityError_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]('Cannot not identify the element. `element` is neither structurally compatible nor a subclass of an Element class.', {
+          value: element
+        });
+      }
+
+      // use already assigned identity
+      if (element.meta.hasKey('id') && (0,_predicates_index_mjs__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(element.meta.id) && !element.meta.id.equals('')) {
+        return element.id;
+      }
+
+      // assign identity in immutable way
+      if (this.identityMap.has(element)) {
+        return this.identityMap.get(element);
+      }
+
+      // return element identity
+      const id = new minim__WEBPACK_IMPORTED_MODULE_0__.StringElement(this.generateId());
+      this.identityMap.set(element, id);
+      return id;
+    },
+    forget(element) {
+      if (this.identityMap.has(element)) {
+        this.identityMap.delete(element);
+        return true;
+      }
+      return false;
+    },
+    generateId() {
+      return this.uuid.randomUUID();
+    }
+  }
+});
+const defaultIdentityManager = IdentityManager({
+  length: 6
+});
+
+/***/ }),
+
 /***/ 63244:
 /***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) => {
 
@@ -38665,30 +39274,31 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var stampit__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(43992);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(25546);
-/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(4926);
+/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(4926);
 /* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(87395);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(28552);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(50334);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(50308);
-/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(44344);
-/* harmony import */ var _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(42455);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(3608);
-/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(8647);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(66316);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(74144);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(94481);
-/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(84714);
-/* harmony import */ var _selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(90609);
-/* harmony import */ var _selectors_uri_mjs__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(14726);
-/* harmony import */ var _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(67625);
-/* harmony import */ var _errors_MaximumResolverDepthError_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(58496);
-/* harmony import */ var _util_url_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(69239);
-/* harmony import */ var _parse_index_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(42215);
-/* harmony import */ var _Reference_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(68488);
-/* harmony import */ var _util_File_mjs__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(35059);
-/* harmony import */ var _resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(77079);
-/* harmony import */ var _util_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(90719);
-/* harmony import */ var _errors_EvaluationJsonSchemaUriError_mjs__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(552);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(47644);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(50334);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(28552);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(50308);
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(44344);
+/* harmony import */ var _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(42455);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(3608);
+/* harmony import */ var _swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(8647);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(66316);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(74144);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(94481);
+/* harmony import */ var _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(84714);
+/* harmony import */ var _selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(90609);
+/* harmony import */ var _selectors_uri_mjs__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(14726);
+/* harmony import */ var _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(67625);
+/* harmony import */ var _errors_MaximumResolverDepthError_mjs__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(58496);
+/* harmony import */ var _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(69239);
+/* harmony import */ var _parse_index_mjs__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(42215);
+/* harmony import */ var _Reference_mjs__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(68488);
+/* harmony import */ var _util_File_mjs__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(35059);
+/* harmony import */ var _resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(77079);
+/* harmony import */ var _util_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(90719);
+/* harmony import */ var _errors_EvaluationJsonSchemaUriError_mjs__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(552);
 
 
 
@@ -38709,6 +39319,15 @@ __webpack_require__.r(__webpack_exports__);
  // @ts-ignore
 const visitAsync = _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_2__.visit[Symbol.for('nodejs.util.promisify.custom')];
 
+// 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)));
+
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
   props: {
@@ -38723,22 +39342,22 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
     reference,
     namespace,
     options,
-    ancestors = new _util_mjs__WEBPACK_IMPORTED_MODULE_3__.AncestorLineage()
+    ancestors = new _util_mjs__WEBPACK_IMPORTED_MODULE_5__.AncestorLineage()
   }) {
     this.indirections = indirections;
     this.namespace = namespace;
     this.reference = reference;
     this.options = options;
-    this.ancestors = new _util_mjs__WEBPACK_IMPORTED_MODULE_3__.AncestorLineage(...ancestors);
+    this.ancestors = new _util_mjs__WEBPACK_IMPORTED_MODULE_5__.AncestorLineage(...ancestors);
   },
   methods: {
     toBaseURI(uri) {
-      return _util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.resolve(this.reference.uri, _util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.sanitize(_util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.stripHash(uri)));
+      return _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.resolve(this.reference.uri, _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.sanitize(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.stripHash(uri)));
     },
     async toReference(uri) {
       // detect maximum depth of resolution
       if (this.reference.depth >= this.options.resolve.maxDepth) {
-        throw new _errors_MaximumResolverDepthError_mjs__WEBPACK_IMPORTED_MODULE_5__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`);
+        throw new _errors_MaximumResolverDepthError_mjs__WEBPACK_IMPORTED_MODULE_7__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`);
       }
       const baseURI = this.toBaseURI(uri);
       const {
@@ -38749,7 +39368,7 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       if (refSet.has(baseURI)) {
         return refSet.find((0,ramda__WEBPACK_IMPORTED_MODULE_1__.propEq)(baseURI, 'uri'));
       }
-      const parseResult = await (0,_parse_index_mjs__WEBPACK_IMPORTED_MODULE_6__["default"])(_util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.unsanitize(baseURI), {
+      const parseResult = await (0,_parse_index_mjs__WEBPACK_IMPORTED_MODULE_8__["default"])(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.unsanitize(baseURI), {
         ...this.options,
         parse: {
           ...this.options.parse,
@@ -38758,7 +39377,7 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       });
 
       // register new Reference with ReferenceSet
-      const reference = (0,_Reference_mjs__WEBPACK_IMPORTED_MODULE_7__["default"])({
+      const reference = (0,_Reference_mjs__WEBPACK_IMPORTED_MODULE_9__["default"])({
         uri: baseURI,
         value: parseResult,
         depth: this.reference.depth + 1
@@ -38771,8 +39390,8 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
        * Compute full ancestors lineage.
        * Ancestors are flatten to unwrap all Element instances.
        */
-      const directAncestors = new WeakSet(ancestors.filter(_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isElement));
-      const ancestorsLineage = new _util_mjs__WEBPACK_IMPORTED_MODULE_3__.AncestorLineage(...this.ancestors, directAncestors);
+      const directAncestors = new Set(ancestors.filter(_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isElement));
+      const ancestorsLineage = new _util_mjs__WEBPACK_IMPORTED_MODULE_5__.AncestorLineage(...this.ancestors, directAncestors);
       return [ancestorsLineage, directAncestors];
     },
     async ReferenceElement(referencingElement, key, parent, path, ancestors) {
@@ -38784,26 +39403,26 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       }
 
       // ignore resolving external Reference Objects
-      if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_9__.isReferenceElementExternal)(referencingElement)) {
+      if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.isReferenceElementExternal)(referencingElement)) {
         return false;
       }
-      const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.$ref));
+      const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       const {
         uri: retrievalURI
       } = reference;
-      const $refBaseURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.$ref));
+      const $refBaseURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
-      const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.uriToPointer)($refBaseURI);
+      const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.uriToPointer)($refBaseURI);
 
       // possibly non-semantic fragment
-      let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__["default"])(jsonPointer, reference.value.result);
+      let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__["default"])(jsonPointer, reference.value.result);
 
       // applying semantics to a fragment
-      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isPrimitiveElement)(referencedElement)) {
-        const referencedElementType = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.meta.get('referenced-element'));
-        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__.isReferenceLikeElement)(referencedElement)) {
+      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isPrimitiveElement)(referencedElement)) {
+        const referencedElementType = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.meta.get('referenced-element'));
+        if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isReferenceLikeElement)(referencedElement)) {
           // handling indirect references
-          referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.ReferenceElement.refract(referencedElement);
+          referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.ReferenceElement.refract(referencedElement);
           referencedElement.setMetaProperty('referenced-element', referencedElementType);
         } else {
           // handling direct references
@@ -38814,12 +39433,12 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
 
       // detect direct or indirect reference
       if (this.indirections.includes(referencedElement)) {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_15__["default"]('Recursive Reference Object detected');
+        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_16__["default"]('Recursive Reference Object detected');
       }
 
       // detect maximum depth of dereferencing
       if (this.indirections.length > this.options.dereference.maxDepth) {
-        throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_16__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+        throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_17__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
       }
 
       // append referencing reference to ancestors lineage
@@ -38834,29 +39453,31 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
         ancestors: ancestorsLineage
       });
       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
+        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.keyMap,
+        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.getNodeType
       });
 
       // 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_18__.cloneShallow)(refedElement);
+        const copy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneShallow)(refedElement);
 
         // annotate fragment with info about original Reference element
         copy.setMetaProperty('ref-fields', {
-          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.$ref),
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref),
           // @ts-ignore
-          description: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.description),
+          description: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.description),
           // @ts-ignore
-          summary: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.summary)
+          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_19__.cloneDeep)(identityManager.identify(referencingElement)));
 
         // override description and summary (outer has higher priority then inner)
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isObjectElement)(refedElement)) {
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isObjectElement)(refedElement)) {
           if (referencingElement.hasKey('description') && 'description' in refedElement) {
             // @ts-ignore
             copy.remove('description');
@@ -38874,11 +39495,13 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       };
 
       // attempting to create cycle
-      if (ancestorsLineage.includes(referencedElement)) {
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isMemberElement)(parent)) {
-          parent.value = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+      if (ancestorsLineage.includes(referencingElement) || ancestorsLineage.includes(referencedElement)) {
+        var _ancestorsLineage$fin;
+        const replaceWith = (_ancestorsLineage$fin = ancestorsLineage.findItem(wasReferencedBy(referencingElement))) !== null && _ancestorsLineage$fin !== void 0 ? _ancestorsLineage$fin : mergeAndAnnotateReferencedElement(referencedElement);
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isMemberElement)(parent)) {
+          parent.value = replaceWith; // eslint-disable-line no-param-reassign
         } else if (Array.isArray(parent)) {
-          parent[key] = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+          parent[key] = replaceWith; // eslint-disable-line no-param-reassign
         }
 
         return false;
@@ -38891,7 +39514,7 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
       // ignore PathItemElement without $ref field
-      if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(referencingElement.$ref)) {
+      if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(referencingElement.$ref)) {
         return undefined;
       }
 
@@ -38901,33 +39524,33 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       }
 
       // ignore resolving external Path Item Elements
-      if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_9__.isPathItemElementExternal)(referencingElement)) {
+      if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.isPathItemElementExternal)(referencingElement)) {
         return undefined;
       }
-      const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.$ref));
+      const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       const {
         uri: retrievalURI
       } = reference;
-      const $refBaseURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.$ref));
+      const $refBaseURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
-      const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.uriToPointer)($refBaseURI);
+      const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.uriToPointer)($refBaseURI);
 
       // possibly non-semantic referenced element
-      let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__["default"])(jsonPointer, reference.value.result);
+      let referencedElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__["default"])(jsonPointer, reference.value.result);
 
       // applying semantics to a referenced element
-      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isPrimitiveElement)(referencedElement)) {
-        referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.PathItemElement.refract(referencedElement);
+      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isPrimitiveElement)(referencedElement)) {
+        referencedElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.PathItemElement.refract(referencedElement);
       }
 
       // detect direct or indirect reference
       if (this.indirections.includes(referencedElement)) {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_15__["default"]('Recursive Path Item Object reference detected');
+        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_16__["default"]('Recursive Path Item Object reference detected');
       }
 
       // detect maximum depth of dereferencing
       if (this.indirections.length > this.options.dereference.maxDepth) {
-        throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_16__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+        throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_17__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
       }
 
       // append referencing path item to ancestors lineage
@@ -38942,8 +39565,8 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
         ancestors: ancestorsLineage
       });
       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
+        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.keyMap,
+        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.getNodeType
       });
 
       // remove referencing path item from ancestors lineage
@@ -38951,29 +39574,33 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       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_14__.PathItemElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(refedElement.attributes));
+        const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.PathItemElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneDeep)(refedElement.attributes));
         // existing keywords from referencing PathItemElement overrides ones from referenced element
         referencingElement.forEach((value, keyElement, item) => {
-          mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(keyElement));
+          mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_10__["default"])(referencingElement.$ref)
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(referencingElement.$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_19__.cloneDeep)(identityManager.identify(referencingElement)));
         return mergedElement;
       };
 
       // attempting to create cycle
-      if (ancestorsLineage.includes(referencedElement)) {
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isMemberElement)(parent)) {
-          parent.value = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+      if (ancestorsLineage.includes(referencingElement) || ancestorsLineage.includes(referencedElement)) {
+        var _ancestorsLineage$fin2;
+        const replaceWith = (_ancestorsLineage$fin2 = ancestorsLineage.findItem(wasReferencedBy(referencingElement))) !== null && _ancestorsLineage$fin2 !== void 0 ? _ancestorsLineage$fin2 : mergeAndAnnotateReferencedElement(referencedElement);
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isMemberElement)(parent)) {
+          parent.value = replaceWith; // eslint-disable-line no-param-reassign
         } else if (Array.isArray(parent)) {
-          parent[key] = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+          parent[key] = replaceWith; // eslint-disable-line no-param-reassign
         }
 
         return false;
@@ -38984,48 +39611,48 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
     },
     async LinkElement(linkElement) {
       // ignore LinkElement without operationRef or operationId field
-      if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(linkElement.operationRef) && !(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(linkElement.operationId)) {
+      if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(linkElement.operationRef) && !(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(linkElement.operationId)) {
         return undefined;
       }
 
       // ignore resolving external Path Item Elements
-      if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_9__.isLinkElementExternal)(linkElement)) {
+      if (!this.options.resolve.external && (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.isLinkElementExternal)(linkElement)) {
         return undefined;
       }
 
       // operationRef and operationId fields are mutually exclusive
-      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(linkElement.operationRef) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(linkElement.operationId)) {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_15__["default"]('LinkElement operationRef and operationId fields are mutually exclusive.');
+      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(linkElement.operationRef) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(linkElement.operationId)) {
+        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_16__["default"]('LinkElement operationRef and operationId fields are mutually exclusive.');
       }
       let operationElement;
-      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(linkElement.operationRef)) {
+      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(linkElement.operationRef)) {
         var _linkElementCopy$oper;
         // possibly non-semantic referenced element
-        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(linkElement.operationRef));
-        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(linkElement.operationRef));
-        operationElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__["default"])(jsonPointer, reference.value.result);
+        const jsonPointer = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.uriToPointer)((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(linkElement.operationRef));
+        const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(linkElement.operationRef));
+        operationElement = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__["default"])(jsonPointer, reference.value.result);
         // applying semantics to a referenced element
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isPrimitiveElement)(operationElement)) {
-          operationElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.OperationElement.refract(operationElement);
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isPrimitiveElement)(operationElement)) {
+          operationElement = _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.OperationElement.refract(operationElement);
         }
         // create shallow clone to be able to annotate with metadata
-        operationElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneShallow)(operationElement);
+        operationElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneShallow)(operationElement);
         // annotate operation element with info about origin
         operationElement.setMetaProperty('ref-origin', reference.uri);
-        const linkElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneShallow)(linkElement);
+        const linkElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneShallow)(linkElement);
         (_linkElementCopy$oper = linkElementCopy.operationRef) === null || _linkElementCopy$oper === void 0 || _linkElementCopy$oper.meta.set('operation', operationElement);
         return linkElementCopy;
       }
-      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(linkElement.operationId)) {
+      if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(linkElement.operationId)) {
         var _linkElementCopy$oper2;
-        const operationId = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(linkElement.operationId);
-        const reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.unsanitize(this.reference.uri));
-        operationElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__["default"])(e => (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_9__.isOperationElement)(e) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isElement)(e.operationId) && e.operationId.equals(operationId), reference.value.result);
+        const operationId = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(linkElement.operationId);
+        const reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.unsanitize(this.reference.uri));
+        operationElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_20__["default"])(e => (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.isOperationElement)(e) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isElement)(e.operationId) && e.operationId.equals(operationId), reference.value.result);
         // OperationElement not found by its operationId
-        if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_20__["default"])(operationElement)) {
-          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_15__["default"](`OperationElement(operationId=${operationId}) not found.`);
+        if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_21__["default"])(operationElement)) {
+          throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_16__["default"](`OperationElement(operationId=${operationId}) not found.`);
         }
-        const linkElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneShallow)(linkElement);
+        const linkElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneShallow)(linkElement);
         (_linkElementCopy$oper2 = linkElementCopy.operationId) === null || _linkElementCopy$oper2 === void 0 || _linkElementCopy$oper2.meta.set('operation', operationElement);
         return linkElementCopy;
       }
@@ -39035,7 +39662,7 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       const [ancestorsLineage] = this.toAncestorLineage([...ancestors, parent]);
 
       // ignore ExampleElement without externalValue field
-      if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(exampleElement.externalValue)) {
+      if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(exampleElement.externalValue)) {
         return undefined;
       }
 
@@ -39045,21 +39672,21 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       }
 
       // ignore resolving ExampleElement externalValue
-      if (!this.options.resolve.external && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(exampleElement.externalValue)) {
+      if (!this.options.resolve.external && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(exampleElement.externalValue)) {
         return undefined;
       }
 
       // value and externalValue fields are mutually exclusive
-      if (exampleElement.hasKey('value') && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isStringElement)(exampleElement.externalValue)) {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_15__["default"]('ExampleElement value and externalValue fields are mutually exclusive.');
+      if (exampleElement.hasKey('value') && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(exampleElement.externalValue)) {
+        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_16__["default"]('ExampleElement value and externalValue fields are mutually exclusive.');
       }
-      const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(exampleElement.externalValue));
+      const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["default"])(exampleElement.externalValue));
 
       // shallow clone of the referenced element
-      const valueElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneShallow)(reference.value.result);
+      const valueElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneShallow)(reference.value.result);
       // annotate operation element with info about origin
       valueElement.setMetaProperty('ref-origin', reference.uri);
-      const exampleElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneShallow)(exampleElement);
+      const exampleElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneShallow)(exampleElement);
       exampleElementCopy.value = valueElement;
       return exampleElementCopy;
     },
@@ -39067,7 +39694,7 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       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_8__.isStringElement)(referencingElement.$ref)) {
+      if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isStringElement)(referencingElement.$ref)) {
         // skip traversing this schema but traverse all it's child schemas
         return undefined;
       }
@@ -39078,13 +39705,13 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       }
 
       // compute baseURI using rules around $id and $ref keywords
-      let reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.unsanitize(this.reference.uri));
+      let reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.unsanitize(this.reference.uri));
       let {
         uri: retrievalURI
       } = reference;
-      const $refBaseURI = (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_21__.resolveSchema$refField)(retrievalURI, referencingElement);
-      const $refBaseURIStrippedHash = _util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.stripHash($refBaseURI);
-      const file = (0,_util_File_mjs__WEBPACK_IMPORTED_MODULE_22__["default"])({
+      const $refBaseURI = (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_22__.resolveSchema$refField)(retrievalURI, referencingElement);
+      const $refBaseURIStrippedHash = _util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.stripHash($refBaseURI);
+      const file = (0,_util_File_mjs__WEBPACK_IMPORTED_MODULE_23__["default"])({
         uri: $refBaseURIStrippedHash
       });
       const isUnknownURI = (0,ramda__WEBPACK_IMPORTED_MODULE_1__.none)(r => r.canRead(file), this.options.resolve.resolvers);
@@ -39104,39 +39731,39 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
         if (isUnknownURI || isURL) {
           // we're dealing with canonical URI or URL with possible fragment
           const selector = $refBaseURI;
-          referencedElement = (0,_selectors_uri_mjs__WEBPACK_IMPORTED_MODULE_23__.evaluate)(selector,
+          referencedElement = (0,_selectors_uri_mjs__WEBPACK_IMPORTED_MODULE_24__.evaluate)(selector,
           // @ts-ignore
-          (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_21__.maybeRefractToSchemaElement)(reference.value.result));
+          (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_22__.maybeRefractToSchemaElement)(reference.value.result));
         } else {
           // we're assuming here that we're dealing with JSON Pointer here
-          reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.unsanitize($refBaseURI));
-          const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.uriToPointer)($refBaseURI);
-          referencedElement = (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_21__.maybeRefractToSchemaElement)(
+          reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
+          const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.uriToPointer)($refBaseURI);
+          referencedElement = (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_22__.maybeRefractToSchemaElement)(
           // @ts-ignore
-          (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__["default"])(selector, reference.value.result));
+          (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__["default"])(selector, reference.value.result));
         }
       } 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 _errors_EvaluationJsonSchemaUriError_mjs__WEBPACK_IMPORTED_MODULE_24__["default"]) {
-          if ((0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_25__.isAnchor)((0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_25__.uriToAnchor)($refBaseURI))) {
+        if (isURL && error instanceof _errors_EvaluationJsonSchemaUriError_mjs__WEBPACK_IMPORTED_MODULE_25__["default"]) {
+          if ((0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_26__.isAnchor)((0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_26__.uriToAnchor)($refBaseURI))) {
             // we're dealing with JSON Schema $anchor here
-            reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.unsanitize($refBaseURI));
+            reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
             retrievalURI = reference.uri;
-            const selector = (0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_25__.uriToAnchor)($refBaseURI);
-            referencedElement = (0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_25__.evaluate)(selector,
+            const selector = (0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_26__.uriToAnchor)($refBaseURI);
+            referencedElement = (0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_26__.evaluate)(selector,
             // @ts-ignore
-            (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_21__.maybeRefractToSchemaElement)(reference.value.result));
+            (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_22__.maybeRefractToSchemaElement)(reference.value.result));
           } else {
             // we're assuming here that we're dealing with JSON Pointer here
-            reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_4__.unsanitize($refBaseURI));
+            reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_6__.unsanitize($refBaseURI));
             retrievalURI = reference.uri;
-            const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.uriToPointer)($refBaseURI);
-            referencedElement = (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_21__.maybeRefractToSchemaElement)(
+            const selector = (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.uriToPointer)($refBaseURI);
+            referencedElement = (0,_resolve_strategies_openapi_3_1_util_mjs__WEBPACK_IMPORTED_MODULE_22__.maybeRefractToSchemaElement)(
             // @ts-ignore
-            (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__["default"])(selector, reference.value.result));
+            (0,_swagger_api_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__["default"])(selector, reference.value.result));
           }
         } else {
           throw error;
@@ -39145,12 +39772,12 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
 
       // detect direct or indirect reference
       if (this.indirections.includes(referencedElement)) {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_15__["default"]('Recursive Schema Object reference detected');
+        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_16__["default"]('Recursive Schema Object reference detected');
       }
 
       // detect maximum depth of dereferencing
       if (this.indirections.length > this.options.dereference.maxDepth) {
-        throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_16__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+        throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_17__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
       }
 
       // append referencing schema to ancestors lineage
@@ -39165,8 +39792,8 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
         ancestors: ancestorsLineage
       });
       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
+        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.keyMap,
+        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.getNodeType
       });
 
       // remove referencing schema from ancestors lineage
@@ -39174,46 +39801,50 @@ const OpenApi3_1DereferenceVisitor = stampit__WEBPACK_IMPORTED_MODULE_0__({
       this.indirections.pop();
 
       // Boolean JSON Schemas
-      if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_9__.isBooleanJsonSchemaElement)(referencedElement)) {
-        const booleanJsonSchemaElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(referencedElement);
+      if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_11__.isBooleanJsonSchemaElement)(referencedElement)) {
+        const booleanJsonSchemaElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneDeep)(referencedElement);
         // annotate referenced element with info about original referencing element
         booleanJsonSchemaElement.setMetaProperty('ref-fields', {
-          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__["default"])(referencingElement.$ref)
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_19__.cloneDeep)(identityManager.identify(referencingElement)));
         return booleanJsonSchemaElement;
       }
       const mergeAndAnnotateReferencedElement = refedElement => {
         // Schema Object - merge keywords from referenced schema with referencing schema
-        const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.SchemaElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_18__.cloneDeep)(refedElement.attributes));
+        const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.SchemaElement([...refedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneDeep)(refedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_19__.cloneDeep)(refedElement.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_10__["default"])(keyElement));
+          mergedElement.remove((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_10__["default"])(referencingElement.$ref)
+          $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__["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_19__.cloneDeep)(identityManager.identify(referencingElement)));
         return mergedElement;
       };
 
       // attempting to create cycle
-      if (ancestorsLineage.includes(referencedElement)) {
-        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_8__.isMemberElement)(parent)) {
-          parent.value = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+      if (ancestorsLineage.includes(referencingElement) || ancestorsLineage.includes(referencedElement)) {
+        var _ancestorsLineage$fin3;
+        const replaceWith = (_ancestorsLineage$fin3 = ancestorsLineage.findItem(wasReferencedBy(referencingElement))) !== null && _ancestorsLineage$fin3 !== void 0 ? _ancestorsLineage$fin3 : mergeAndAnnotateReferencedElement(referencedElement);
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_10__.isMemberElement)(parent)) {
+          parent.value = replaceWith; // eslint-disable-line no-param-reassign
         } else if (Array.isArray(parent)) {
-          parent[key] = mergeAndAnnotateReferencedElement(referencedElement); // eslint-disable-line no-param-reassign
+          parent[key] = replaceWith; // eslint-disable-line no-param-reassign
         }
 
         return false;
       }
-
-      // transclude referencing element with merged referenced element
       return mergeAndAnnotateReferencedElement(referencedElement);
     }
   }
@@ -39230,17 +39861,30 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   AncestorLineage: () => (/* binding */ AncestorLineage)
 /* harmony export */ });
+/* harmony import */ var _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(28552);
+
+
 // eslint-disable-next-line import/prefer-default-export
 class AncestorLineage extends Array {
   includesCycle(element) {
     return this.filter(ancestors => ancestors.has(element)).length > 1;
   }
   includes(searchElement, fromIndex) {
-    if (searchElement instanceof WeakSet) {
+    if (searchElement instanceof Set) {
       return super.includes(searchElement, fromIndex);
     }
     return this.some(ancestors => ancestors.has(searchElement));
   }
+  findItem(predicate) {
+    for (const set of this) {
+      for (const item of set) {
+        if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_0__.isElement)(item) && predicate(item)) {
+          return item;
+        }
+      }
+    }
+    return undefined;
+  }
 }
 
 /***/ }),