@speclynx/apidom-reference 5.2.4 → 5.2.6

package/dist/apidom-reference.browser.js

@@ -456,6 +456,12 @@ const cf = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__.fixedFields)(_s
   indexed: true
 });
 
+/**
+ * A bundled JSON Schema resource awaiting placement into the entry document's
+ * `components.inputs`.
+ * @public
+ */
+
 /**
  * @public
  */
@@ -503,17 +509,47 @@ class Arazzo1BundleVisitor {
    * components that are still being bundled.
    */
   reservedNames;
+
+  /**
+   * Embedded resources waiting to be placed into the entry document's
+   * `components.inputs`, shared across the entry document and every external
+   * document visitor. Placement is deferred until the entry document traversal
+   * completes: the traversal walks live content, so placing a resource mid-way
+   * would make it descend into the resource and re-bundle its `$ref`s against
+   * the entry document's base URI instead of the resource's own.
+   */
+  placements;
+
+  /**
+   * Index of `$id`-bearing schemas per document, shared across the entry document
+   * and every external document visitor of a single bundle run so it never
+   * outlives mutations of the documents (e.g. the final placement of inputs).
+   */
+  schema$idIndex;
   constructor({
     reference,
     options,
     assignments = new Map(),
-    reservedNames = new Map()
+    reservedNames = new Map(),
+    placements = [],
+    schema$idIndex = new WeakMap()
   }) {
     this.reference = reference;
     this.baseURI = (0,_dereference_strategies_arazzo_1_util_ts__WEBPACK_IMPORTED_MODULE_23__.resolveArazzo$selfField)(reference.uri, reference.value?.result);
     this.options = options;
     this.assignments = assignments;
     this.reservedNames = reservedNames;
+    this.placements = placements;
+    this.schema$idIndex = schema$idIndex;
+  }
+
+  /**
+   * Base URI of the entry document — its `$self` when present, otherwise its
+   * retrieval URI. It is the base against which a relative `$id` written into
+   * `components.inputs` resolves.
+   */
+  get entryBaseURI() {
+    return (0,_dereference_strategies_arazzo_1_util_ts__WEBPACK_IMPORTED_MODULE_23__.resolveArazzo$selfField)(_util_url_ts__WEBPACK_IMPORTED_MODULE_17__.stripHash(this.reference.refSet.rootRef.uri), this.entryResult);
   }
   toBaseURI(uri) {
     return _util_url_ts__WEBPACK_IMPORTED_MODULE_17__.resolve(this.baseURI, _util_url_ts__WEBPACK_IMPORTED_MODULE_17__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_17__.stripHash(uri)));
@@ -665,14 +701,17 @@ class Arazzo1BundleVisitor {
 
   /**
    * Computes a collision-free component name within `components.inputs`. A name
-   * is taken if it's already placed in inputs or reserved by a component that is
-   * still being bundled (reserved before recursion).
+   * is taken if it's already present in the entry document's inputs or reserved
+   * by a component that is still being bundled (reserved before recursion).
    */
   uniqueName(candidate) {
     const field = cf.inputs.name;
-    const inputs = this.ensureInputsField();
+    const {
+      components
+    } = this.entryResult;
+    const inputs = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isObjectElement)(components) ? components.get(field) : undefined;
     const reserved = this.reservedNames.get(field) ?? new Set();
-    return (0,_util_ts__WEBPACK_IMPORTED_MODULE_25__.uniqueName)(candidate, name => inputs.hasKey(name) || reserved.has(name));
+    return (0,_util_ts__WEBPACK_IMPORTED_MODULE_25__.uniqueName)(candidate, name => (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isObjectElement)(inputs) && inputs.hasKey(name) || reserved.has(name));
   }
 
   /**
@@ -697,14 +736,36 @@ class Arazzo1BundleVisitor {
     this.entryParseResult.content.push(annotation);
   }
 
+  /**
+   * The entry document traversal is rooted at its Parse Result (nested
+   * traversals are rooted at schema resources), so leaving it marks the moment
+   * the whole entry document has been visited and the collected resources can
+   * be placed into `components.inputs` without the traversal descending into them.
+   * Guarded on the node so that a traversal rooted at any other Parse Result
+   * never flushes the shared placements early.
+   */
+  ParseResultElement = {
+    leave: path => {
+      if (path.node !== this.entryParseResult) return;
+      for (const {
+        name,
+        element
+      } of this.placements) {
+        this.ensureInputsField().set(name, element);
+      }
+      this.placements.length = 0;
+    }
+  };
+
   /**
    * JSON Schema Objects in Arazzo (used by Input Objects and inline schemas) are
    * a JSON Schema 2020-12 dialect — the only external reference type Arazzo
    * defines. They are bundled per the JSON Schema Compound Document rules: the
    * external schema RESOURCE is embedded verbatim into `components.inputs`
-   * (carrying its `$id`), and the referencing `$ref` is left UNCHANGED — it
-   * keeps resolving against the embedded resource's `$id`. This mirrors the
-   * openapi-3-1 strategy's Schema Object handling.
+   * (carrying its `$id`), and the referencing `$ref` is rebased onto that `$id`
+   * when it resolves to a different URI (a location-based `$ref` to a
+   * self-identifying resource); otherwise it is left unchanged. This mirrors
+   * the openapi-3-1 strategy's Schema Object handling.
    */
   async JSONSchemaElement(path) {
     const referencingElement = path.node;
@@ -719,7 +780,8 @@ class Arazzo1BundleVisitor {
       // current document's base URI is derived directly (not via toReference)
       // so an internal $ref needs no resolution and never trips the
       // resolve.maxDepth guard.
-      const $refBaseURI = (0,_dereference_strategies_arazzo_1_util_ts__WEBPACK_IMPORTED_MODULE_24__.resolveSchema$refField)(this.baseURI, referencingElement);
+      const schemaBaseURI = (0,_dereference_strategies_arazzo_1_util_ts__WEBPACK_IMPORTED_MODULE_24__.resolveSchemaBaseURI)(this.baseURI, path);
+      const $refBaseURI = (0,_dereference_strategies_arazzo_1_util_ts__WEBPACK_IMPORTED_MODULE_24__.resolveSchema$refField)(schemaBaseURI, referencingElement);
       const $refBaseURIStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_17__.stripHash($refBaseURI);
       const file = new _File_ts__WEBPACK_IMPORTED_MODULE_20__["default"]({
         uri: $refBaseURIStrippedHash
@@ -757,7 +819,10 @@ class Arazzo1BundleVisitor {
       let schemaReference = this.reference;
       try {
         const referenceAsSchema = (0,_dereference_strategies_arazzo_1_util_ts__WEBPACK_IMPORTED_MODULE_23__.maybeRefractToJSONSchemaElement)(schemaReference.value.result);
-        (0,_dereference_strategies_arazzo_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_22__.evaluate)($refBaseURI, referenceAsSchema);
+        (0,_dereference_strategies_arazzo_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_22__.evaluate)($refBaseURI, referenceAsSchema, {
+          baseURI: this.baseURI,
+          index: this.schema$idIndex
+        });
       } catch (error) {
         if (isURL && error instanceof _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_16__["default"]) {
           if ((0,_dereference_strategies_arazzo_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_21__.isAnchor)((0,_dereference_strategies_arazzo_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_21__.uriToAnchor)($refBaseURI))) {
@@ -796,20 +861,23 @@ class Arazzo1BundleVisitor {
       const field = cf.inputs.name;
       const canonicalKey = `${field}\t${resourceBaseURI}`;
 
-      // resource already embedded (or being embedded) — leave the referencing
-      // $ref untouched and stop. This also terminates circular external schema
+      // a location-based $ref to a self-identifying resource is rebased onto the
+      // resource's $id (keeping its fragment) — once embedded, the resource is
+      // reachable only by its $id. A $ref already resolving to that $id is left
+      // as written. See rebaseSchema$ref for the spec trade-off.
+      const rebased$ref = (0,_util_ts__WEBPACK_IMPORTED_MODULE_25__.rebaseSchema$ref)($refBaseURI, resourceBaseURI);
+
+      // resource already embedded (or being embedded) — point the referencing
+      // $ref at it and stop. This also terminates circular external schema
       // references, since the assignment is reserved BEFORE recursion.
       if (this.assignments.has(canonicalKey)) {
+        if (rebased$ref !== undefined) referencingElement.set('$ref', rebased$ref);
         path.skip();
         return;
       }
 
-      // own a copy of the resource and ensure it carries a $id so the unchanged
-      // $ref still resolves against it once embedded
+      // own a copy of the resource
       const embeddedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.cloneDeep)(resourceRoot);
-      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isStringElement)(embeddedElement.$id)) {
-        embeddedElement.set('$id', resourceBaseURI);
-      }
 
       // the embedded thing is the WHOLE resource (keyed by its $id), so its name
       // is derived from the resource URI
@@ -829,22 +897,37 @@ class Arazzo1BundleVisitor {
         reference: schemaReference,
         options: this.options,
         assignments: this.assignments,
-        reservedNames: this.reservedNames
+        reservedNames: this.reservedNames,
+        placements: this.placements,
+        schema$idIndex: this.schema$idIndex
       });
       const bundledElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_7__.traverseAsync)(embeddedElement, visitor, {
         mutable: true
       });
 
+      // a resource without its own $id is identified by its retrieval URI; write
+      // it relative to the entry document (the base of components.inputs) so the
+      // bundle carries no absolute filesystem path and stays relocatable. Assigned
+      // after the nested traversal so a reader deriving a schema's base from live
+      // $ids (see #540) never resolves the resource's own $refs against the entry
+      // document.
+      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isStringElement)(bundledElement.$id)) {
+        bundledElement.set('$id', _util_url_ts__WEBPACK_IMPORTED_MODULE_17__.relative(this.entryBaseURI, resourceBaseURI));
+      }
+
       // annotate the embedded resource with info about its origin
       if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isElement)(bundledElement)) {
         bundledElement.meta.set('ref-origin', schemaReference.uri);
       }
 
-      // place the embedded resource into the entry document's components.inputs
-      this.ensureInputsField().set(componentName, bundledElement);
+      // queue the embedded resource for placement into the entry document's components.inputs
+      this.placements.push({
+        name: componentName,
+        element: bundledElement
+      });
 
-      // the referencing $ref is left UNCHANGED — it resolves against the
-      // embedded resource's $id
+      // point the referencing $ref at the embedded resource's $id
+      if (rebased$ref !== undefined) referencingElement.set('$ref', rebased$ref);
       path.skip();
     } catch (error) {
       this.handleError(`Error while bundling JSON Schema Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
@@ -3164,43 +3247,44 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(87009);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(6352);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(25162);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(12111);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(97071);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(84660);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(37205);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(44673);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(16280);
-/* harmony import */ var _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(44641);
-/* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(80796);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(12020);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(61198);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(21314);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(24329);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(29881);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(76332);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(23806);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(52645);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(23031);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(63842);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(87455);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(16363);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(55122);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(71117);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(72257);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(69511);
-/* harmony import */ var _errors_BundleError_ts__WEBPACK_IMPORTED_MODULE_27__ = __webpack_require__(81002);
-/* harmony import */ var _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_28__ = __webpack_require__(8853);
-/* harmony import */ var _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_29__ = __webpack_require__(16843);
-/* harmony import */ var _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_30__ = __webpack_require__(51325);
-/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_31__ = __webpack_require__(44477);
-/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_32__ = __webpack_require__(30658);
-/* harmony import */ var _parse_index_ts__WEBPACK_IMPORTED_MODULE_33__ = __webpack_require__(35014);
-/* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_34__ = __webpack_require__(98979);
-/* harmony import */ var _File_ts__WEBPACK_IMPORTED_MODULE_35__ = __webpack_require__(10682);
-/* harmony import */ var _dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_36__ = __webpack_require__(32054);
-/* harmony import */ var _dereference_strategies_openapi_3_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_37__ = __webpack_require__(56481);
-/* harmony import */ var _dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_38__ = __webpack_require__(60888);
-/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_39__ = __webpack_require__(25939);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(96911);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(12111);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(97071);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(84660);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(37205);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(44673);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(16280);
+/* harmony import */ var _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(44641);
+/* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(80796);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(12020);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(61198);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(21314);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(24329);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(29881);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(76332);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(23806);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(52645);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(23031);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(63842);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(87455);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(16363);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(55122);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(71117);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(72257);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_27__ = __webpack_require__(69511);
+/* harmony import */ var _errors_BundleError_ts__WEBPACK_IMPORTED_MODULE_28__ = __webpack_require__(81002);
+/* harmony import */ var _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_29__ = __webpack_require__(8853);
+/* harmony import */ var _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_30__ = __webpack_require__(16843);
+/* harmony import */ var _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_31__ = __webpack_require__(51325);
+/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_32__ = __webpack_require__(44477);
+/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_33__ = __webpack_require__(30658);
+/* harmony import */ var _parse_index_ts__WEBPACK_IMPORTED_MODULE_34__ = __webpack_require__(35014);
+/* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_35__ = __webpack_require__(98979);
+/* harmony import */ var _File_ts__WEBPACK_IMPORTED_MODULE_36__ = __webpack_require__(10682);
+/* harmony import */ var _dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_37__ = __webpack_require__(32054);
+/* harmony import */ var _dereference_strategies_openapi_3_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_38__ = __webpack_require__(56481);
+/* harmony import */ var _dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__ = __webpack_require__(60888);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_40__ = __webpack_require__(25939);
 
 
 
@@ -3227,7 +3311,7 @@ __webpack_require__.r(__webpack_exports__);
  * Field names are sourced from the Components Object fixed fields so they
  * cannot drift from the namespace definition.
  */
-const cf = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__.fixedFields)(_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.ComponentsElement, {
+const cf = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__.fixedFields)(_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__.ComponentsElement, {
   indexed: true
 });
 const componentFieldByReferencedElement = {
@@ -3250,18 +3334,24 @@ const componentFieldByReferencedElement = {
  * object.
  */
 const componentFieldElementByField = {
-  [cf.schemas.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_25__["default"],
-  [cf.responses.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_24__["default"],
-  [cf.parameters.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_21__["default"],
-  [cf.examples.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__["default"],
-  [cf.requestBodies.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_23__["default"],
-  [cf.headers.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__["default"],
-  [cf.securitySchemes.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_26__["default"],
-  [cf.links.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__["default"],
-  [cf.callbacks.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__["default"],
-  [cf.pathItems.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_22__["default"]
+  [cf.schemas.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_26__["default"],
+  [cf.responses.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_25__["default"],
+  [cf.parameters.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_22__["default"],
+  [cf.examples.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__["default"],
+  [cf.requestBodies.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_24__["default"],
+  [cf.headers.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_20__["default"],
+  [cf.securitySchemes.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_27__["default"],
+  [cf.links.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_21__["default"],
+  [cf.callbacks.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__["default"],
+  [cf.pathItems.name]: _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_23__["default"]
 };
 
+/**
+ * A bundled element awaiting placement into the entry document's Components
+ * Object field.
+ * @public
+ */
+
 /**
  * @public
  */
@@ -3279,7 +3369,7 @@ class OpenAPI3_1BundleVisitor {
    * Derived from the shared refSet's root reference.
    */
   get entryURI() {
-    return _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(this.reference.refSet?.rootRef?.uri ?? '');
+    return _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.stripHash(this.reference.refSet?.rootRef?.uri ?? '');
   }
 
   /**
@@ -3319,18 +3409,50 @@ class OpenAPI3_1BundleVisitor {
    * generic object referenced once as a Parameter and once as a Response).
    */
   refractCache;
+
+  /**
+   * Index of `$id`-bearing schemas per document, shared across the entry document
+   * and every external document visitor of a single bundle run so it never
+   * outlives mutations of the documents (e.g. the final placement of components).
+   */
+  schema$idIndex;
+
+  /**
+   * Bundled fragments waiting to be placed into the entry document's
+   * Components Object, shared across the entry document and every external
+   * document visitor. Placement is deferred until the entry document traversal
+   * completes: the traversal walks live content, so placing a fragment mid-way
+   * would make it descend into the fragment and re-bundle its `$ref`s against
+   * the entry document's base URI instead of the fragment's own.
+   */
+  placements;
+
+  /**
+   * The base URI the traversed content will have once placed into the entry
+   * document, when placement changes it: content hoisted out of a non-schema
+   * document (a Response, Parameter, Path Item, ...) trades that document's
+   * base URI for the entry document's. Unset for the entry document itself and
+   * for embedded schema resources, whose `$id` carries their base along.
+   */
+  relocationBaseURI;
   constructor({
     reference,
     options,
     assignments = new Map(),
     reservedNames = new Map(),
-    refractCache = new WeakMap()
+    refractCache = new WeakMap(),
+    schema$idIndex = new WeakMap(),
+    placements = [],
+    relocationBaseURI
   }) {
     this.reference = reference;
     this.options = options;
     this.assignments = assignments;
     this.reservedNames = reservedNames;
     this.refractCache = refractCache;
+    this.schema$idIndex = schema$idIndex;
+    this.placements = placements;
+    this.relocationBaseURI = relocationBaseURI;
   }
   getRefracted(source, type) {
     return this.refractCache.get(source)?.get(type);
@@ -3344,12 +3466,12 @@ class OpenAPI3_1BundleVisitor {
     byType.set(type, refracted);
   }
   toBaseURI(uri) {
-    return _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.resolve(this.reference.uri, _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(uri)));
+    return _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.resolve(this.reference.uri, _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_33__.stripHash(uri)));
   }
   async toReference(uri) {
     // detect maximum depth of resolution
     if (this.reference.depth >= this.options.resolve.maxDepth) {
-      throw new _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_30__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`, {
+      throw new _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_31__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`, {
         maxDepth: this.options.resolve.maxDepth,
         uri: this.reference.uri
       });
@@ -3363,14 +3485,14 @@ class OpenAPI3_1BundleVisitor {
     if (refSet.has(baseURI)) {
       return refSet.find((0,ramda__WEBPACK_IMPORTED_MODULE_1__["default"])(baseURI, 'uri'));
     }
-    const parseResult = await (0,_parse_index_ts__WEBPACK_IMPORTED_MODULE_33__["default"])(_util_url_ts__WEBPACK_IMPORTED_MODULE_32__.unsanitize(baseURI), {
+    const parseResult = await (0,_parse_index_ts__WEBPACK_IMPORTED_MODULE_34__["default"])(_util_url_ts__WEBPACK_IMPORTED_MODULE_33__.unsanitize(baseURI), {
       ...this.options,
       parse: {
         ...this.options.parse,
         mediaType: 'text/plain'
       }
     });
-    const reference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_34__["default"]({
+    const reference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_35__["default"]({
       uri: baseURI,
       value: parseResult,
       depth: this.reference.depth + 1
@@ -3385,7 +3507,23 @@ class OpenAPI3_1BundleVisitor {
    * transferable. Bare fragments are returned unchanged.
    */
   normalizeSelfReference(ref) {
-    return ref.startsWith('#') ? ref : _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.getHash(ref);
+    return ref.startsWith('#') ? ref : _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.getHash(ref);
+  }
+
+  /**
+   * The base URI the given Schema Object's `$ref` will be resolved against once
+   * the content is placed into the entry document, or `undefined` when the
+   * `$ref` as written resolves to `$refBaseURI` from there as well: the content
+   * isn't relocated, an absolute `$id` on the schema's ancestor chain pins its
+   * base, or the hoisted document sits next to the entry document.
+   */
+  relocatedSchemaBaseURI(path, $refBaseURI) {
+    if (this.relocationBaseURI === undefined) return undefined;
+    const relocatedBaseURI = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.resolveSchemaBaseURI)(this.relocationBaseURI, path);
+    if ((0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.resolveSchema$refField)(relocatedBaseURI, path.node) === $refBaseURI) {
+      return undefined;
+    }
+    return relocatedBaseURI;
   }
 
   /**
@@ -3404,16 +3542,16 @@ class OpenAPI3_1BundleVisitor {
     // breach (MaximumBundleDepthError, which also extends BundleError) is a
     // resolution failure and flows through below — wrapped and subject to
     // continueOnError, like dereferencing.
-    if (error instanceof _errors_BundleError_ts__WEBPACK_IMPORTED_MODULE_27__["default"] && !(error instanceof _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_29__["default"])) {
+    if (error instanceof _errors_BundleError_ts__WEBPACK_IMPORTED_MODULE_28__["default"] && !(error instanceof _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_30__["default"])) {
       throw error;
     }
     const {
       continueOnError
     } = this.options.bundle;
-    const isEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(this.reference.refSet?.rootRef?.uri ?? '') === this.reference.uri;
+    const isEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.stripHash(this.reference.refSet?.rootRef?.uri ?? '') === this.reference.uri;
     const uri = this.reference.uri;
     const type = referencingElement.element;
-    const codeFrame = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement);
+    const codeFrame = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement);
     const location = visitorPath.formatPath();
     const hop = {
       uri,
@@ -3424,12 +3562,12 @@ class OpenAPI3_1BundleVisitor {
       codeFrame
     };
     let unresolvedError;
-    if (error instanceof _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_28__["default"]) {
+    if (error instanceof _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_29__["default"]) {
       // @ts-ignore
       error.trace = [hop, ...error.trace];
       unresolvedError = error;
     } else {
-      unresolvedError = new _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_28__["default"](message, {
+      unresolvedError = new _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_29__["default"](message, {
         cause: error,
         type,
         uri,
@@ -3452,12 +3590,12 @@ class OpenAPI3_1BundleVisitor {
     const entryResult = this.entryResult;
     let components = entryResult.components;
     if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isObjectElement)(components)) {
-      components = new _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_18__.ComponentsElement();
+      components = new _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_19__.ComponentsElement();
       entryResult.components = components;
     }
     let fieldElement = components.get(field);
     if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isObjectElement)(fieldElement)) {
-      const FieldElement = componentFieldElementByField[field] ?? _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__["default"];
+      const FieldElement = componentFieldElementByField[field] ?? _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"];
       fieldElement = new FieldElement();
       components.set(field, fieldElement);
     }
@@ -3469,9 +3607,9 @@ class OpenAPI3_1BundleVisitor {
    * falling back to the referenced file's basename.
    */
   basenameOf(jsonPointer, baseURI) {
-    const tokens = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.parse)(jsonPointer).tree;
+    const tokens = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.parse)(jsonPointer).tree;
     const lastToken = tokens.length > 0 ? tokens[tokens.length - 1] : '';
-    return lastToken || _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.getBasename(baseURI) || 'Schema';
+    return lastToken || _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.getBasename(baseURI) || 'Schema';
   }
 
   /**
@@ -3494,9 +3632,9 @@ class OpenAPI3_1BundleVisitor {
       return this.basenameOf(jsonPointer, baseURI);
     }
     if (componentNamesStrategy === 'title') {
-      const title = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isObjectElement)(element) ? (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(element.get('title')) : undefined;
+      const title = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isObjectElement)(element) ? (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(element.get('title')) : undefined;
       if (typeof title === 'string' && title.trim() !== '') {
-        const name = (0,_util_ts__WEBPACK_IMPORTED_MODULE_39__.sanitizeComponentName)((0,_util_ts__WEBPACK_IMPORTED_MODULE_39__.toPascalCase)(title));
+        const name = (0,_util_ts__WEBPACK_IMPORTED_MODULE_40__.sanitizeComponentName)((0,_util_ts__WEBPACK_IMPORTED_MODULE_40__.toPascalCase)(title));
         if (name !== '') return name;
       }
       // fall back to basename when no usable title is present
@@ -3506,13 +3644,16 @@ class OpenAPI3_1BundleVisitor {
 
   /**
    * Computes a collision-free component name within the target field. A name is
-   * taken if it's already placed in components or reserved by a component that
-   * is still being bundled (reserved before recursion).
+   * taken if it's already present in the entry document's components or reserved
+   * by a component that is still being bundled (reserved before recursion).
    */
   uniqueName(candidate, field) {
-    const fieldElement = this.ensureComponentsField(field);
+    const {
+      components
+    } = this.entryResult;
+    const fieldElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isObjectElement)(components) ? components.get(field) : undefined;
     const reserved = this.reservedNames.get(field) ?? new Set();
-    return (0,_util_ts__WEBPACK_IMPORTED_MODULE_39__.uniqueName)(candidate, name => fieldElement.hasKey(name) || reserved.has(name));
+    return (0,_util_ts__WEBPACK_IMPORTED_MODULE_40__.uniqueName)(candidate, name => (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isObjectElement)(fieldElement) && fieldElement.hasKey(name) || reserved.has(name));
   }
 
   /**
@@ -3528,17 +3669,39 @@ class OpenAPI3_1BundleVisitor {
     }
     const message = `Component "${preferredName}" in components/${field} is referenced with the same name but different content. Renamed to "${componentName}".`;
     if (onComponentNameCollision === 'error') {
-      throw new _errors_BundleError_ts__WEBPACK_IMPORTED_MODULE_27__["default"](message);
+      throw new _errors_BundleError_ts__WEBPACK_IMPORTED_MODULE_28__["default"](message);
     }
-    const annotation = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"](message);
+    const annotation = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"](message);
     annotation.classes.push('warning');
     annotation.code = 'bundle-component-name-collision';
     // append (never prepend) so the result element stays ahead of annotations
     this.entryParseResult.content.push(annotation);
   }
+
+  /**
+   * The entry document traversal is rooted at its Parse Result (nested
+   * traversals are rooted at fragments), so leaving it marks the moment the
+   * whole entry document has been visited and the collected fragments can be
+   * placed into its Components Object without the traversal descending into them.
+   * Guarded on the node so that a traversal rooted at any other Parse Result
+   * never flushes the shared placements early.
+   */
+  ParseResultElement = {
+    leave: path => {
+      if (path.node !== this.entryParseResult) return;
+      for (const {
+        field,
+        name,
+        element
+      } of this.placements) {
+        this.ensureComponentsField(field).set(name, element);
+      }
+      this.placements.length = 0;
+    }
+  };
   async ReferenceElement(path) {
     const referencingElement = path.node;
-    const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref);
+    const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref);
     const retrievalURI = this.toBaseURI($ref);
     const isInternalReference = this.entryURI === retrievalURI;
     const isExternalReference = !isInternalReference;
@@ -3555,8 +3718,8 @@ class OpenAPI3_1BundleVisitor {
       path.skip();
       return;
     }
-    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.resolve(retrievalURI, $ref);
-    const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.resolve(retrievalURI, $ref);
+    const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference($refBaseURI);
 
     // the target bucket depends on the referencing context, so it's part of the
     // identity: the same external target referenced as e.g. both a parameter and
@@ -3584,7 +3747,7 @@ class OpenAPI3_1BundleVisitor {
     try {
       // detect maximum depth of bundling
       if (this.reference.depth >= this.options.bundle.maxDepth) {
-        throw new _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_29__["default"](`Maximum bundle depth of "${this.options.bundle.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
+        throw new _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_30__["default"](`Maximum bundle depth of "${this.options.bundle.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
           maxDepth: this.options.bundle.maxDepth,
           uri: this.reference.uri
         });
@@ -3592,21 +3755,21 @@ class OpenAPI3_1BundleVisitor {
       const reference = await this.toReference($ref);
 
       // possibly non-semantic fragment
-      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(reference.value.result, jsonPointer);
+      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
 
       // apply semantics to the fragment so nested references become Reference Objects
-      if (referencedElement.element !== referencedElementType && !(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isReferenceElement)(referencedElement)) {
+      if (referencedElement.element !== referencedElementType && !(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isReferenceElement)(referencedElement)) {
         const cached = this.getRefracted(referencedElement, referencedElementType);
         if (cached !== undefined) {
           referencedElement = cached;
-        } else if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__.isReferenceLikeElement)(referencedElement)) {
+        } else if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isReferenceLikeElement)(referencedElement)) {
           const sourceElement = referencedElement;
-          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.refractReference)(referencedElement);
+          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.refractReference)(referencedElement);
           referencedElement.meta.set('referenced-element', referencedElementType);
           this.setRefracted(sourceElement, referencedElementType, referencedElement);
         } else {
           const sourceElement = referencedElement;
-          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__["default"])(referencedElement, {
+          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__["default"])(referencedElement, {
             element: referencedElementType
           });
           this.setRefracted(sourceElement, referencedElementType, referencedElement);
@@ -3614,7 +3777,7 @@ class OpenAPI3_1BundleVisitor {
       }
       const preferredName = this.baseName(referencedElement, field, jsonPointer, retrievalURI);
       const componentName = this.uniqueName(preferredName, field);
-      const internalPointer = `#/components/${field}/${(0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.escape)(componentName)}`;
+      const internalPointer = `#/components/${field}/${(0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.escape)(componentName)}`;
       this.reportNameCollision(preferredName, componentName, field);
 
       // reserve the assignment and component name before recursing so cyclic
@@ -3623,16 +3786,21 @@ class OpenAPI3_1BundleVisitor {
       if (!this.reservedNames.has(field)) this.reservedNames.set(field, new Set());
       this.reservedNames.get(field).add(componentName);
 
-      // own a copy of the fragment and bundle its own external references
-      const hoistedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneDeep)(referencedElement);
+      // own a copy of the fragment and bundle its own external references; the
+      // fragment ends up in the entry document, so that is where its content
+      // resolves relative references from
+      const hoistedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(referencedElement);
       const visitor = new OpenAPI3_1BundleVisitor({
         reference,
         options: this.options,
         assignments: this.assignments,
         reservedNames: this.reservedNames,
-        refractCache: this.refractCache
+        refractCache: this.refractCache,
+        schema$idIndex: this.schema$idIndex,
+        placements: this.placements,
+        relocationBaseURI: this.entryURI
       });
-      const bundledElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.traverseAsync)(hoistedElement, visitor, {
+      const bundledElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.traverseAsync)(hoistedElement, visitor, {
         mutable: true
       });
 
@@ -3641,8 +3809,12 @@ class OpenAPI3_1BundleVisitor {
         bundledElement.meta.set('ref-origin', reference.uri);
       }
 
-      // place the bundled fragment into the entry document's components
-      this.ensureComponentsField(field).set(componentName, bundledElement);
+      // queue the bundled fragment for placement into the entry document's components
+      this.placements.push({
+        field,
+        name: componentName,
+        element: bundledElement
+      });
 
       // rewrite the referencing element to point at the hoisted fragment
       referencingElement.set('$ref', internalPointer);
@@ -3668,7 +3840,7 @@ class OpenAPI3_1BundleVisitor {
     if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(pathItemElement.$ref)) {
       return;
     }
-    const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(pathItemElement.$ref);
+    const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(pathItemElement.$ref);
     const retrievalURI = this.toBaseURI($ref);
     const isInternalReference = this.entryURI === retrievalURI;
     const isExternalReference = !isInternalReference;
@@ -3685,8 +3857,8 @@ class OpenAPI3_1BundleVisitor {
       path.skip();
       return;
     }
-    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.resolve(retrievalURI, $ref);
-    const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.resolve(retrievalURI, $ref);
+    const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference($refBaseURI);
     const field = cf.pathItems.name;
     const canonicalKey = `${field}\t${retrievalURI}#${jsonPointer}`;
 
@@ -3701,28 +3873,28 @@ class OpenAPI3_1BundleVisitor {
     try {
       // detect maximum depth of bundling
       if (this.reference.depth >= this.options.bundle.maxDepth) {
-        throw new _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_29__["default"](`Maximum bundle depth of "${this.options.bundle.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
+        throw new _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_30__["default"](`Maximum bundle depth of "${this.options.bundle.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
           maxDepth: this.options.bundle.maxDepth,
           uri: this.reference.uri
         });
       }
       const reference = await this.toReference($ref);
-      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(reference.value.result, jsonPointer);
+      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
 
       // apply Path Item semantics to the referenced fragment
-      if (!(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isPathItemElement)(referencedElement)) {
+      if (!(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isPathItemElement)(referencedElement)) {
         const cached = this.getRefracted(referencedElement, 'pathItem');
         if (cached !== undefined) {
           referencedElement = cached;
         } else {
           const sourceElement = referencedElement;
-          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.refractPathItem)(referencedElement);
+          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.refractPathItem)(referencedElement);
           this.setRefracted(sourceElement, 'pathItem', referencedElement);
         }
       }
       const preferredName = this.baseName(referencedElement, field, jsonPointer, retrievalURI);
       const componentName = this.uniqueName(preferredName, field);
-      const internalPointer = `#/components/${field}/${(0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.escape)(componentName)}`;
+      const internalPointer = `#/components/${field}/${(0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.escape)(componentName)}`;
       this.reportNameCollision(preferredName, componentName, field);
 
       // reserve the assignment and component name before recursing so cyclic
@@ -3731,16 +3903,21 @@ class OpenAPI3_1BundleVisitor {
       if (!this.reservedNames.has(field)) this.reservedNames.set(field, new Set());
       this.reservedNames.get(field).add(componentName);
 
-      // own a copy of the fragment and bundle its own external references
-      const hoistedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneDeep)(referencedElement);
+      // own a copy of the fragment and bundle its own external references; the
+      // Path Item ends up in the entry document, so that is where its content
+      // resolves relative references from
+      const hoistedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(referencedElement);
       const visitor = new OpenAPI3_1BundleVisitor({
         reference,
         options: this.options,
         assignments: this.assignments,
         reservedNames: this.reservedNames,
-        refractCache: this.refractCache
+        refractCache: this.refractCache,
+        schema$idIndex: this.schema$idIndex,
+        placements: this.placements,
+        relocationBaseURI: this.entryURI
       });
-      const bundledElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.traverseAsync)(hoistedElement, visitor, {
+      const bundledElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.traverseAsync)(hoistedElement, visitor, {
         mutable: true
       });
 
@@ -3749,8 +3926,12 @@ class OpenAPI3_1BundleVisitor {
       // internal `#/components/pathItems/...` pointer by the child traversal
       bundledElement.meta.set('ref-origin', reference.uri);
 
-      // place the bundled Path Item into the entry document's components
-      this.ensureComponentsField(field).set(componentName, bundledElement);
+      // queue the bundled Path Item for placement into the entry document's components
+      this.placements.push({
+        field,
+        name: componentName,
+        element: bundledElement
+      });
 
       // rewrite the referencing Path Item to point at the hoisted one, keeping
       // any sibling fields (e.g. summary, description) next to the $ref
@@ -3778,21 +3959,22 @@ class OpenAPI3_1BundleVisitor {
     if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(referencingElement.$ref)) {
       return;
     }
-    const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref);
+    const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref);
     try {
       // compute baseURI using rules around $id and $ref keywords. The current
       // document's URI is the retrieval URI — derive it directly (not via
       // toReference) so an internal $ref needs no resolution and never trips the
       // resolve.maxDepth guard, matching how ReferenceElement returns early.
       const retrievalURI = this.reference.uri;
-      const $refBaseURI = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_38__.resolveSchema$refField)(retrievalURI, referencingElement);
-      const $refBaseURIStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash($refBaseURI);
-      const file = new _File_ts__WEBPACK_IMPORTED_MODULE_35__["default"]({
+      const schemaBaseURI = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.resolveSchemaBaseURI)(retrievalURI, path);
+      const $refBaseURI = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.resolveSchema$refField)(schemaBaseURI, referencingElement);
+      const $refBaseURIStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.stripHash($refBaseURI);
+      const file = new _File_ts__WEBPACK_IMPORTED_MODULE_36__["default"]({
         uri: $refBaseURIStrippedHash
       });
       const isUnknownURI = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(r => r.canRead(file), this.options.resolve.resolvers);
       const isURL = !isUnknownURI;
-      const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(this.reference.uri) === $refBaseURIStrippedHash;
+      const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.stripHash(this.reference.uri) === $refBaseURIStrippedHash;
       const isExternalReference = !isInternalReference;
 
       // internal Schema Object $refs resolve against the in-document $id graph;
@@ -3810,7 +3992,7 @@ class OpenAPI3_1BundleVisitor {
       // detect maximum depth of bundling before fetching the external resource,
       // matching ReferenceElement/PathItemElement (which check before toReference)
       if (this.reference.depth >= this.options.bundle.maxDepth) {
-        throw new _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_29__["default"](`Maximum bundle depth of "${this.options.bundle.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
+        throw new _errors_MaximumBundleDepthError_ts__WEBPACK_IMPORTED_MODULE_30__["default"](`Maximum bundle depth of "${this.options.bundle.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
           maxDepth: this.options.bundle.maxDepth,
           uri: this.reference.uri
         });
@@ -3821,59 +4003,95 @@ class OpenAPI3_1BundleVisitor {
       // as a canonical URI / URL against the current document's $id graph; if
       // that fails, fall back to fetching the external document and resolving
       // the fragment there as a $anchor or JSON Pointer.
+      //
+      // the fragment being traversed is searched before the whole document:
+      // content hoisted out of an external document (a Response, Parameter, Path
+      // Item, ...) is refracted with its own semantics, so the Schema Objects it
+      // contains are indexed, whereas the external document as a whole is parsed
+      // generically and refracted as a bare JSON Schema, which leaves those Schema
+      // Objects (under `content`, `schema`, ...) unrecognized and their `$id`s out
+      // of the index
+      const documentElement = this.reference.value.result;
+      const rootNode = path.getAncestorNodes().at(-1) ?? path.node;
+      const fragmentElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isParseResultElement)(rootNode) ? rootNode.result : rootNode;
+      const uriEvaluateOptions = {
+        baseURI: retrievalURI,
+        index: this.schema$idIndex
+      };
       let schemaReference = this.reference;
+      let resourceRoot;
+      let resourceBaseURI;
       try {
-        const referenceAsSchema = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_38__.maybeRefractToSchemaElement)(schemaReference.value.result);
-        (0,_dereference_strategies_openapi_3_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_37__.evaluate)($refBaseURI, referenceAsSchema);
+        try {
+          (0,_dereference_strategies_openapi_3_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_38__.evaluate)($refBaseURI, (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.maybeRefractToSchemaElement)(fragmentElement), uriEvaluateOptions);
+          // a $ref that resolves (by $id/$anchor/pointer) within the traversed
+          // content is internal even when its URI form (e.g. a URN or absolute
+          // $id) is not a bare fragment: the $id resource travels with the content
+          // wherever it is placed. Leave it untouched — it resolves against the
+          // in-content $id graph, and embedding the content into itself would be
+          // wrong.
+          return;
+        } catch (error) {
+          if (!(error instanceof _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_32__["default"]) || fragmentElement === documentElement) {
+            throw error;
+          }
+          const documentAsSchema = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.maybeRefractToSchemaElement)(documentElement);
+          (0,_dereference_strategies_openapi_3_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_38__.evaluate)($refBaseURI, documentAsSchema, uriEvaluateOptions);
+          // the $id resource sits in the current document but outside the
+          // traversed fragment, so it stays behind once the fragment is placed
+          // into the entry document. The resource to embed is that $id-bearing
+          // schema, addressed by its canonical URI (the $ref without fragment).
+          resourceRoot = (0,_dereference_strategies_openapi_3_1_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_38__.evaluate)($refBaseURIStrippedHash, documentAsSchema, uriEvaluateOptions);
+          resourceBaseURI = $refBaseURIStrippedHash;
+        }
       } catch (error) {
-        if (isURL && error instanceof _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_31__["default"]) {
-          if ((0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_36__.isAnchor)((0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_36__.uriToAnchor)($refBaseURI))) {
-            schemaReference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_32__.unsanitize($refBaseURI));
-            const selector = (0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_36__.uriToAnchor)($refBaseURI);
-            const referenceAsSchema = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_38__.maybeRefractToSchemaElement)(schemaReference.value.result);
-            (0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_36__.evaluate)(selector, referenceAsSchema);
+        if (isURL && error instanceof _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_32__["default"]) {
+          schemaReference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_33__.unsanitize($refBaseURI));
+          const referenceAsSchema = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.maybeRefractToSchemaElement)(schemaReference.value.result);
+          if ((0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_37__.isAnchor)((0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_37__.uriToAnchor)($refBaseURI))) {
+            const selector = (0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_37__.uriToAnchor)($refBaseURI);
+            (0,_dereference_strategies_openapi_3_1_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_37__.evaluate)(selector, referenceAsSchema);
           } else {
-            schemaReference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_32__.unsanitize($refBaseURI));
-            const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference($refBaseURI);
-            const referenceAsSchema = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_38__.maybeRefractToSchemaElement)(schemaReference.value.result);
-            (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(referenceAsSchema, selector);
+            const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+            (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.evaluate)(referenceAsSchema, selector);
           }
+
+          // the resource to embed is the WHOLE external document (its root
+          // schema), identified by its $id. A $ref into a fragment of the
+          // document embeds the entire document resource once; the fragment
+          // keeps resolving against the embedded $id.
+          resourceRoot = referenceAsSchema;
+          resourceBaseURI = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_39__.resolveSchema$idField)(_util_url_ts__WEBPACK_IMPORTED_MODULE_33__.stripHash(schemaReference.uri), resourceRoot) ?? _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.stripHash(schemaReference.uri);
         } else {
           throw error;
         }
       }
-
-      // a $ref that resolves (by $id/$anchor/pointer) within the current document
-      // is internal even when its URI form (e.g. a URN or absolute $id) is not a
-      // bare fragment. Leave it untouched — it resolves against the in-document
-      // $id graph, and embedding the current document into itself would be wrong.
-      if (_util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(schemaReference.uri) === _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(this.reference.uri)) {
-        return;
-      }
-
-      // the resource to embed is the WHOLE external document (its root schema),
-      // identified by its $id. A $ref into a fragment of the document embeds the
-      // entire document resource once; the fragment keeps resolving against the
-      // embedded $id.
-      const resourceRoot = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_38__.maybeRefractToSchemaElement)(schemaReference.value.result);
-      const resourceBaseURI = (0,_dereference_strategies_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_38__.resolveSchema$idField)(_util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(schemaReference.uri), resourceRoot) ?? _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.stripHash(schemaReference.uri);
       const field = cf.schemas.name;
       const canonicalKey = `${field}\t${resourceBaseURI}`;
 
-      // resource already embedded (or being embedded) — leave the referencing
-      // $ref untouched and stop. This also terminates circular external schema
+      // a location-based $ref to a self-identifying resource is rebased onto the
+      // resource's $id (keeping its fragment) — once embedded, the resource is
+      // reachable only by its $id. A $ref already resolving to that $id is left
+      // as written. See rebaseSchema$ref for the spec trade-off.
+      //
+      // a $ref whose base URI changes on relocation into the entry document
+      // (inside a hoisted Response, Parameter, Path Item, ...) is instead
+      // rewritten to address the embedded resource from the base it will have
+      // there, otherwise it dangles once placed. See relocateSchema$ref.
+      const relocatedBaseURI = this.relocatedSchemaBaseURI(path, $refBaseURI);
+      const rebased$ref = relocatedBaseURI === undefined ? (0,_util_ts__WEBPACK_IMPORTED_MODULE_40__.rebaseSchema$ref)($refBaseURI, resourceBaseURI) : (0,_util_ts__WEBPACK_IMPORTED_MODULE_40__.relocateSchema$ref)($refBaseURI, resourceBaseURI, relocatedBaseURI, (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(resourceRoot.$id));
+
+      // resource already embedded (or being embedded) — point the referencing
+      // $ref at it and stop. This also terminates circular external schema
       // references, since the assignment is reserved BEFORE recursion.
       if (this.assignments.has(canonicalKey)) {
+        if (rebased$ref !== undefined) referencingElement.set('$ref', rebased$ref);
         path.skip();
         return;
       }
 
-      // own a copy of the resource and ensure it carries a $id so the unchanged
-      // $ref still resolves against it once embedded
-      const embeddedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneDeep)(resourceRoot);
-      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(embeddedElement.$id)) {
-        embeddedElement.set('$id', resourceBaseURI);
-      }
+      // own a copy of the resource
+      const embeddedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(resourceRoot);
 
       // the embedded thing is the WHOLE resource (keyed by its $id), so its name
       // is derived from the resource URI, not the $ref fragment — passing a root
@@ -3884,7 +4102,7 @@ class OpenAPI3_1BundleVisitor {
 
       // reserve the assignment and component name before recursing so circular
       // external schema references terminate
-      this.assignments.set(canonicalKey, `#/components/${field}/${(0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.escape)(componentName)}`);
+      this.assignments.set(canonicalKey, `#/components/${field}/${(0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.escape)(componentName)}`);
       if (!this.reservedNames.has(field)) this.reservedNames.set(field, new Set());
       this.reservedNames.get(field).add(componentName);
 
@@ -3895,20 +4113,36 @@ class OpenAPI3_1BundleVisitor {
         options: this.options,
         assignments: this.assignments,
         reservedNames: this.reservedNames,
-        refractCache: this.refractCache
+        refractCache: this.refractCache,
+        schema$idIndex: this.schema$idIndex,
+        placements: this.placements
       });
-      const bundledElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.traverseAsync)(embeddedElement, visitor, {
+      const bundledElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.traverseAsync)(embeddedElement, visitor, {
         mutable: true
       });
 
+      // a resource without its own $id is identified by its retrieval URI; write
+      // it relative to the entry document (the base of components.schemas) so the
+      // bundle carries no absolute filesystem path and stays relocatable. Assigned
+      // after the nested traversal so a reader deriving a schema's base from live
+      // $ids (see #540) never resolves the resource's own $refs against the entry
+      // document.
+      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(bundledElement.$id)) {
+        bundledElement.set('$id', _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.relative(this.entryURI, resourceBaseURI));
+      }
+
       // annotate the embedded resource with info about its origin
       bundledElement.meta.set('ref-origin', schemaReference.uri);
 
-      // place the embedded resource into the entry document's components
-      this.ensureComponentsField(field).set(componentName, bundledElement);
+      // queue the embedded resource for placement into the entry document's components
+      this.placements.push({
+        field,
+        name: componentName,
+        element: bundledElement
+      });
 
-      // the referencing $ref is left UNCHANGED — it resolves against the
-      // embedded resource's $id
+      // point the referencing $ref at the embedded resource's $id
+      if (rebased$ref !== undefined) referencingElement.set('$ref', rebased$ref);
       path.skip();
     } catch (error) {
       this.handleError(`Error while bundling Schema Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
@@ -3931,12 +4165,12 @@ class OpenAPI3_1BundleVisitor {
 
     // value and externalValue fields are mutually exclusive
     if (exampleElement.hasKey('value') && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(exampleElement.externalValue)) {
-      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('ExampleElement value and externalValue fields are mutually exclusive', {
-        value: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.value),
-        externalValue: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.externalValue)
+      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('ExampleElement value and externalValue fields are mutually exclusive', {
+        value: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.value),
+        externalValue: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.externalValue)
       });
     }
-    const externalValue = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.externalValue);
+    const externalValue = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.externalValue);
     const retrievalURI = this.toBaseURI(externalValue);
     const isInternalReference = this.entryURI === retrievalURI;
     const isExternalReference = !isInternalReference;
@@ -3947,9 +4181,9 @@ class OpenAPI3_1BundleVisitor {
     }
     try {
       const reference = await this.toReference(externalValue);
-      const valueElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneShallow)(reference.value.result);
+      const valueElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(reference.value.result);
       valueElement.meta.set('ref-origin', reference.uri);
-      const exampleElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneShallow)(exampleElement);
+      const exampleElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(exampleElement);
       exampleElementCopy.value = valueElement;
       exampleElementCopy.remove('externalValue');
       path.replaceWith(exampleElementCopy);
@@ -3970,9 +4204,9 @@ class OpenAPI3_1BundleVisitor {
 
     // operationRef and operationId fields are mutually exclusive
     if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(linkElement.operationRef) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(linkElement.operationId)) {
-      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('LinkElement operationRef and operationId fields are mutually exclusive', {
-        operationRef: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationRef),
-        operationId: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationId)
+      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('LinkElement operationRef and operationId fields are mutually exclusive', {
+        operationRef: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationRef),
+        operationId: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationId)
       });
     }
 
@@ -3980,7 +4214,7 @@ class OpenAPI3_1BundleVisitor {
     if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(linkElement.operationRef)) {
       return;
     }
-    const operationRef = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationRef);
+    const operationRef = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationRef);
     const retrievalURI = this.toBaseURI(operationRef);
     const isInternalReference = this.entryURI === retrievalURI;
     if (isInternalReference) {
@@ -3997,7 +4231,7 @@ class OpenAPI3_1BundleVisitor {
 
     // rewrite to an absolute URI so the link keeps resolving once the document
     // is treated as self-contained
-    const absoluteURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_32__.resolve(this.reference.uri, operationRef);
+    const absoluteURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_33__.resolve(this.reference.uri, operationRef);
     if (absoluteURI !== operationRef) {
       linkElement.set('operationRef', absoluteURI);
     }
@@ -4016,6 +4250,9 @@ class OpenAPI3_1BundleVisitor {
 
 "use strict";
 __webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(30658);
+
+
 /**
  * Upper-cases the first letter of each whitespace-separated word and joins
  * them, e.g. `pet model` -> `PetModel`.
@@ -4049,7 +4286,60 @@ const uniqueName = (candidate, isTaken) => {
   }
   return `${candidate}-${counter}`;
 };
+
+/**
+ * Computes the `$ref` value addressing an embedded JSON Schema resource by its
+ * canonical `$id`. `$refURI` is the `$ref` resolved against the referencing
+ * document's base URI; `resourceURI` is the embedded resource's canonical URI
+ * (its `$id`, or the retrieval URI when it has none).
+ *
+ * When the two differ — a location-based `$ref` (e.g. `./ex.json#/$defs/Pet`)
+ * to a resource that identifies itself differently (`$id: https://example.com/pets`)
+ * — the `$ref` is rebased onto the resource URI, keeping its `$anchor` or JSON
+ * Pointer fragment. Once embedded, the resource is reachable only by its `$id`,
+ * so an unchanged `$ref` would dangle. When they already agree, `undefined` is
+ * returned and the `$ref` is to be left as written.
+ *
+ * This knowingly departs from the letter of JSON Schema 2020-12 §9.3.1
+ * ("references ... MUST NOT be changed"), which presumes `$ref`s are written
+ * against `$id`s. The target schema — and thus evaluation output — is unchanged;
+ * only the alias the loader knew the resource by is normalized to its canonical URI.
+ *
+ * @public
+ */
+const rebaseSchema$ref = ($refURI, resourceURI) => {
+  if (_util_url_ts__WEBPACK_IMPORTED_MODULE_0__.stripHash($refURI) === resourceURI) {
+    return undefined;
+  }
+  const fragment = _util_url_ts__WEBPACK_IMPORTED_MODULE_0__.getHash($refURI);
+  return fragment === '#' ? resourceURI : `${resourceURI}${fragment}`;
+};
+
+/**
+ * Computes the `$ref` value addressing an embedded JSON Schema resource from a
+ * Schema Object whose base URI changes when it is relocated into the entry
+ * document — one carried inside a hoisted Response, Parameter, Path Item, etc.
+ * `$refURI` and `resourceURI` are as in `rebaseSchema$ref`; `baseURI` is the
+ * base the `$ref` resolves against after relocation.
+ *
+ * A resource that identifies itself (`isResourceIdentified`, i.e. it declares a
+ * `$id`) is addressed by that `$id`, exactly as `rebaseSchema$ref` does. A
+ * resource identified only by its retrieval URI is addressed by a URI reference
+ * relative to `baseURI`: it then resolves to the `$id` assigned from that
+ * retrieval URI wherever the bundle is placed, and no absolute retrieval
+ * location leaks into the `$ref`. The `$anchor` or JSON Pointer fragment is
+ * kept in both cases.
+ *
+ * @public
+ */
+const relocateSchema$ref = ($refURI, resourceURI, baseURI, isResourceIdentified) => {
+  const target = isResourceIdentified ? resourceURI : _util_url_ts__WEBPACK_IMPORTED_MODULE_0__.relative(baseURI, resourceURI);
+  const fragment = _util_url_ts__WEBPACK_IMPORTED_MODULE_0__.getHash($refURI);
+  return fragment === '#' ? target : `${target}${fragment}`;
+};
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "rebaseSchema$ref", 0, /* binding */ rebaseSchema$ref,
+/* harmony export */   "relocateSchema$ref", 0, /* binding */ relocateSchema$ref,
 /* harmony export */   "sanitizeComponentName", 0, /* binding */ sanitizeComponentName,
 /* harmony export */   "toPascalCase", 0, /* binding */ toPascalCase,
 /* harmony export */   "uniqueName", 0, /* binding */ uniqueName
@@ -4670,7 +4960,9 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(98979);
 /* harmony import */ var _ReferenceSet_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(24131);
 /* harmony import */ var _visitor_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(31843);
-/* harmony import */ var _source_descriptions_ts__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(12586);
+/* harmony import */ var _openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(60888);
+/* harmony import */ var _source_descriptions_ts__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(12586);
+
 
 
 
@@ -4734,7 +5026,8 @@ class Arazzo1DereferenceStrategy extends _DereferenceStrategy_ts__WEBPACK_IMPORT
     const shouldDetectCircular = ['error', 'replace'].includes(options.dereference.circular);
     const visitor = new _visitor_ts__WEBPACK_IMPORTED_MODULE_9__["default"]({
       reference,
-      options
+      options,
+      ancestorSchema$ids: (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_11__.detachedRootSchema$ids)(refSet.rootRef.value.result)
     });
     const dereferencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_3__.traverseAsync)(refSet.rootRef.value, visitor, {
       mutable: true,
@@ -4743,6 +5036,17 @@ class Arazzo1DereferenceStrategy extends _DereferenceStrategy_ts__WEBPACK_IMPORT
       })
     });
 
+    /**
+     * If immutable option is set, replay refs from the refSet.
+     * Replayed before source descriptions are dereferenced, so they can reuse the refs.
+     */
+    if (options.dereference.immutable) {
+      mutableRefSet.refs.filter(ref => ref.uri.startsWith('immutable://')).map(ref => new _Reference_ts__WEBPACK_IMPORTED_MODULE_7__["default"]({
+        ...ref,
+        uri: ref.uri.replace(/^immutable:\/\//, '')
+      })).forEach(ref => immutableRefSet.add(ref));
+    }
+
     /**
      * Dereference source descriptions if option is enabled.
      */
@@ -4753,20 +5057,10 @@ class Arazzo1DereferenceStrategy extends _DereferenceStrategy_ts__WEBPACK_IMPORT
       // drop any existing parse-phase source description results before pushing
       const cleaned = parseResult.reject(item => (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isParseResultElement)(item) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.includesClasses)(item, ['source-description']));
       parseResult.content = cleaned.content;
-      const sourceDescriptions = await (0,_source_descriptions_ts__WEBPACK_IMPORTED_MODULE_11__.dereferenceSourceDescriptions)(parseResult, reference.uri, options, this.name);
+      const sourceDescriptions = await (0,_source_descriptions_ts__WEBPACK_IMPORTED_MODULE_12__.dereferenceSourceDescriptions)(parseResult, reference.uri, options, this.name);
       parseResult.push(...sourceDescriptions);
     }
 
-    /**
-     * If immutable option is set, replay refs from the refSet.
-     */
-    if (options.dereference.immutable) {
-      mutableRefSet.refs.filter(ref => ref.uri.startsWith('immutable://')).map(ref => new _Reference_ts__WEBPACK_IMPORTED_MODULE_7__["default"]({
-        ...ref,
-        uri: ref.uri.replace(/^immutable:\/\//, '')
-      })).forEach(ref => immutableRefSet.add(ref));
-    }
-
     /**
      * Release all memory if this refSet was not provided as a configuration option.
      * If provided as configuration option, then provider is responsible for cleanup.
@@ -4803,10 +5097,18 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(4823);
 /* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(28839);
 /* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(44673);
-/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(30658);
-/* harmony import */ var _options_util_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(86547);
-/* harmony import */ var _index_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(42037);
-/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(91005);
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(164);
+/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(30658);
+/* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(98979);
+/* harmony import */ var _ReferenceSet_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(24131);
+/* harmony import */ var _options_util_ts__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(86547);
+/* harmony import */ var _parse_index_ts__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(35014);
+/* harmony import */ var _index_ts__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(42037);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(91005);
+
+
+
+
 
 
 
@@ -4840,7 +5142,7 @@ async function dereferenceSourceDescription(sourceDescription, ctx) {
   }
 
   // normalize URI for consistent cycle detection and refSet cache key matching
-  const retrievalURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_6__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_6__.stripHash(_util_url_ts__WEBPACK_IMPORTED_MODULE_6__.resolve(ctx.baseURI, sourceDescriptionURI)));
+  const retrievalURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_7__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_7__.stripHash(_util_url_ts__WEBPACK_IMPORTED_MODULE_7__.resolve(ctx.baseURI, sourceDescriptionURI)));
   parseResult.setMetaProperty('retrievalURI', retrievalURI);
 
   // skip if the document is still being dereferenced higher up the chain (cycle detection)
@@ -4859,58 +5161,69 @@ async function dereferenceSourceDescription(sourceDescription, ctx) {
     annotation.classes.push('info');
     parseResult.push(annotation);
     parseResult.meta.set('parseResult', sharedDereferenceResult);
-    (0,_util_ts__WEBPACK_IMPORTED_MODULE_9__.validateSourceDescriptionAPI)(parseResult, sourceDescription, sharedDereferenceResult.api, retrievalURI);
+    (0,_util_ts__WEBPACK_IMPORTED_MODULE_13__.validateSourceDescriptionAPI)(parseResult, sourceDescription, sharedDereferenceResult.api, retrievalURI);
     return parseResult;
   }
 
   // check if source description was already parsed (e.g., during parse phase with sourceDescriptions: true)
   const existingParseResult = sourceDescription.meta.get('parseResult');
+  const parentRefSet = ctx.options.dereference.refSet;
+  let refSet = null;
   try {
-    let sourceDescriptionDereferenced;
-    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isParseResultElement)(existingParseResult)) {
-      // use existing parsed result - just dereference it (no re-fetch/re-parse)
-      sourceDescriptionDereferenced = await (0,_index_ts__WEBPACK_IMPORTED_MODULE_8__.dereferenceApiDOM)(existingParseResult, (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_7__.merge)(ctx.options, {
-        parse: {
-          mediaType: 'text/plain' // allow dereference strategy detection via ApiDOM inspection
-        },
-        resolve: {
-          baseURI: retrievalURI
-        },
-        dereference: {
-          strategyOpts: {
-            // nested documents should dereference all their source descriptions
-            // (parent's name filter doesn't apply to nested documents)
-            // set at strategy-specific level to override any inherited filters
-            [ctx.strategyName]: {
-              sourceDescriptions: true,
-              sourceDescriptionsDepth: ctx.currentDepth + 1,
-              sourceDescriptionsAncestors: ctx.ancestors,
-              sourceDescriptionsDereferenced: ctx.dereferenced
-            }
-          }
-        }
-      }));
+    // source description document comes from, in order of preference:
+    // caller-supplied refSet, parse phase, or is fetched and parsed now
+    const cachedReference = parentRefSet?.find(ref => ref.uri === retrievalURI);
+    let sourceDescriptionParseResult;
+    let isFreshlyParsed = false;
+    if (cachedReference !== undefined) {
+      sourceDescriptionParseResult = cachedReference.value;
+    } else if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isParseResultElement)(existingParseResult)) {
+      sourceDescriptionParseResult = existingParseResult;
     } else {
-      // no existing parse result - fetch, parse, and dereference
-      sourceDescriptionDereferenced = await (0,_index_ts__WEBPACK_IMPORTED_MODULE_8__["default"])(retrievalURI, (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_7__.merge)(ctx.options, {
+      sourceDescriptionParseResult = await (0,_parse_index_ts__WEBPACK_IMPORTED_MODULE_11__["default"])(retrievalURI, (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_10__.merge)(ctx.options, {
         parse: {
-          mediaType: 'text/plain' // allow parser plugin detection
-        },
-        dereference: {
-          strategyOpts: {
-            // nested documents should dereference all their source descriptions
-            // (parent's name filter doesn't apply to nested documents)
-            // set at strategy-specific level to override any inherited filters
-            [ctx.strategyName]: {
-              sourceDescriptions: true,
-              sourceDescriptionsDepth: ctx.currentDepth + 1,
-              sourceDescriptionsAncestors: ctx.ancestors,
-              sourceDescriptionsDereferenced: ctx.dereferenced
-            }
-          }
-        }
+          mediaType: 'text/plain'
+        } // allow parser plugin detection
       }));
+      isFreshlyParsed = true;
+    }
+
+    // caller-supplied refSet is rooted at the entry document, but strategies dereference
+    // the root of the refSet; re-root its references at the source description
+    if (parentRefSet !== null) {
+      refSet = new _ReferenceSet_ts__WEBPACK_IMPORTED_MODULE_9__["default"]({
+        refs: [new _Reference_ts__WEBPACK_IMPORTED_MODULE_8__["default"]({
+          uri: retrievalURI,
+          value: sourceDescriptionParseResult
+        }), ...parentRefSet.refs.map(ref => new _Reference_ts__WEBPACK_IMPORTED_MODULE_8__["default"]({
+          ...ref,
+          refSet: undefined
+        }))]
+      });
     }
+    const sourceDescriptionDereferenced = await (0,_index_ts__WEBPACK_IMPORTED_MODULE_12__.dereferenceApiDOM)(sourceDescriptionParseResult, (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_10__.merge)((0,ramda__WEBPACK_IMPORTED_MODULE_6__["default"])(['dereference', 'refSet'], refSet, ctx.options), {
+      parse: {
+        mediaType: 'text/plain' // allow dereference strategy detection via ApiDOM inspection
+      },
+      resolve: {
+        baseURI: retrievalURI
+      },
+      dereference: {
+        // freshly parsed document not reported to any refSet can be dereferenced in mutable mode
+        immutable: ctx.options.dereference.immutable && !(isFreshlyParsed && parentRefSet === null),
+        strategyOpts: {
+          // nested documents should dereference all their source descriptions
+          // (parent's name filter doesn't apply to nested documents)
+          // set at strategy-specific level to override any inherited filters
+          [ctx.strategyName]: {
+            sourceDescriptions: true,
+            sourceDescriptionsDepth: ctx.currentDepth + 1,
+            sourceDescriptionsAncestors: ctx.ancestors,
+            sourceDescriptionsDereferenced: ctx.dereferenced
+          }
+        }
+      }
+    }));
 
     // merge dereferenced result into our parse result
     for (const item of sourceDescriptionDereferenced) {
@@ -4923,16 +5236,23 @@ async function dereferenceSourceDescription(sourceDescription, ctx) {
     annotation.classes.push('error');
     parseResult.push(annotation);
     return parseResult;
+  } finally {
+    // report documents reached through the source description to the caller-supplied refSet,
+    // even when dereferencing it failed
+    if (parentRefSet !== null && refSet !== null) {
+      parentRefSet.merge(refSet);
+      parentRefSet.circular ||= refSet.circular;
+    }
   }
 
   // register dereferenced document for later references to it
   const {
     api: sourceDescriptionAPI
   } = parseResult;
-  for (const documentURI of (0,_util_ts__WEBPACK_IMPORTED_MODULE_9__.arazzoDocumentURIs)(retrievalURI, sourceDescriptionAPI)) {
+  for (const documentURI of (0,_util_ts__WEBPACK_IMPORTED_MODULE_13__.arazzoDocumentURIs)(retrievalURI, sourceDescriptionAPI)) {
     ctx.dereferenced.set(documentURI, parseResult);
   }
-  ;(0,_util_ts__WEBPACK_IMPORTED_MODULE_9__.validateSourceDescriptionAPI)(parseResult, sourceDescription, sourceDescriptionAPI, retrievalURI);
+  ;(0,_util_ts__WEBPACK_IMPORTED_MODULE_13__.validateSourceDescriptionAPI)(parseResult, sourceDescription, sourceDescriptionAPI, retrievalURI);
   return parseResult;
 }
 
@@ -4985,7 +5305,7 @@ async function dereferenceSourceDescription(sourceDescription, ctx) {
  * @public
  */
 async function dereferenceSourceDescriptions(parseResult, parseResultRetrievalURI, options, strategyName = 'arazzo-1') {
-  const retrievalURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_6__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_6__.stripHash(parseResultRetrievalURI));
+  const retrievalURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_7__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_7__.stripHash(parseResultRetrievalURI));
   const results = [];
 
   // get API from dereferenced parse result
@@ -5016,7 +5336,7 @@ async function dereferenceSourceDescriptions(parseResult, parseResultRetrievalUR
   const currentDepth = sharedOpts.sourceDescriptionsDepth ?? 0;
   const dereferenced = sharedOpts.sourceDescriptionsDereferenced ?? new Map();
   // current file is an ancestor of everything dereferenced below
-  const ancestors = [...(sharedOpts.sourceDescriptionsAncestors ?? []), ...(0,_util_ts__WEBPACK_IMPORTED_MODULE_9__.arazzoDocumentURIs)(retrievalURI, api)];
+  const ancestors = [...(sharedOpts.sourceDescriptionsAncestors ?? []), ...(0,_util_ts__WEBPACK_IMPORTED_MODULE_13__.arazzoDocumentURIs)(retrievalURI, api)];
   if (currentDepth >= maxDepth) {
     const annotation = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"](`Maximum dereference depth of ${maxDepth} has been exceeded by file "${retrievalURI}"`);
     annotation.classes.push('error');
@@ -5026,7 +5346,7 @@ async function dereferenceSourceDescriptions(parseResult, parseResultRetrievalUR
   }
   const ctx = {
     // base URI for resolving source description URLs honors Arazzo `$self` field
-    baseURI: (0,_util_ts__WEBPACK_IMPORTED_MODULE_9__.resolveArazzo$selfField)(retrievalURI, api),
+    baseURI: (0,_util_ts__WEBPACK_IMPORTED_MODULE_13__.resolveArazzo$selfField)(retrievalURI, api),
     options,
     strategyName,
     currentDepth,
@@ -5062,7 +5382,8 @@ async function dereferenceSourceDescriptions(parseResult, parseResultRetrievalUR
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   resolveSchema$idField: () => (/* reexport safe */ _openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_9__.resolveSchema$idField),
-/* harmony export */   resolveSchema$refField: () => (/* reexport safe */ _openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_9__.resolveSchema$refField)
+/* harmony export */   resolveSchema$refField: () => (/* reexport safe */ _openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_9__.resolveSchema$refField),
+/* harmony export */   resolveSchemaBaseURI: () => (/* reexport safe */ _openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_9__.resolveSchemaBaseURI)
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(25162);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(84660);
@@ -5203,31 +5524,34 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(87009);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(6352);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(25162);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(12111);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(78894);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(44673);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(16280);
-/* harmony import */ var _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(44641);
-/* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(80796);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(12020);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(61198);
-/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(7557);
-/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(96681);
-/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(28839);
-/* harmony import */ var _swaggerexpert_arazzo_runtime_expression__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(26847);
-/* harmony import */ var _selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(32054);
-/* harmony import */ var _selectors_uri_ts__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(56481);
-/* harmony import */ var _openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(60888);
-/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(91005);
-/* harmony import */ var _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(8853);
-/* harmony import */ var _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(37757);
-/* harmony import */ var _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(51325);
-/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(30658);
-/* harmony import */ var _parse_index_ts__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(35014);
-/* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(98979);
-/* harmony import */ var _File_ts__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(10682);
-/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(53429);
-/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_27__ = __webpack_require__(44477);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(96911);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(12111);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(78894);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(44673);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(16280);
+/* harmony import */ var _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(44641);
+/* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(80796);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(12020);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(61198);
+/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(7557);
+/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(96681);
+/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(28839);
+/* harmony import */ var _swaggerexpert_arazzo_runtime_expression__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(26847);
+/* harmony import */ var _selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(32054);
+/* harmony import */ var _selectors_uri_ts__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(56481);
+/* harmony import */ var _openapi_3_1_selectors_json_pointer_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(37517);
+/* harmony import */ var _openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(60888);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(91005);
+/* harmony import */ var _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(8853);
+/* harmony import */ var _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(37757);
+/* harmony import */ var _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(51325);
+/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(30658);
+/* harmony import */ var _parse_index_ts__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(35014);
+/* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(98979);
+/* harmony import */ var _File_ts__WEBPACK_IMPORTED_MODULE_27__ = __webpack_require__(10682);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_28__ = __webpack_require__(53429);
+/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_29__ = __webpack_require__(44477);
+
 
 
 
@@ -5268,8 +5592,23 @@ class Arazzo1DereferenceVisitor {
    */
   baseURI;
   options;
+
+  /**
+   * Index of `$id`-bearing schemas per document, shared across nested visitors
+   * of a single dereference run so it never outlives mutations of the documents.
+   */
+  schema$idIndex;
   visited;
 
+  /**
+   * `$id`s of the JSON Schema elements enclosing the traversal root within its
+   * document (outermost first). Empty when the root is the document itself; a
+   * nested visitor traversing a fragment is seeded with the `$id`s of the
+   * schemas the fragment sits under, so the `$ref`s and `$id`s within resolve
+   * against the same base as they would from the document root.
+   */
+  ancestorSchema$ids;
+
   /**
    * Tracks element ancestors across dive-deep traversal boundaries.
    * Used for cycle detection: if a referenced element is found in
@@ -5280,29 +5619,33 @@ class Arazzo1DereferenceVisitor {
     reference,
     options,
     indirections = [],
-    ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_26__.AncestorLineage(),
-    visited = new WeakSet()
+    schema$idIndex = new WeakMap(),
+    ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_28__.AncestorLineage(),
+    visited = new WeakSet(),
+    ancestorSchema$ids = []
   }) {
     this.indirections = indirections;
     this.reference = reference;
-    this.baseURI = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.resolveArazzo$selfField)(reference.uri, reference.value?.result);
+    this.baseURI = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.resolveArazzo$selfField)(reference.uri, reference.value?.result);
     this.options = options;
-    this.ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_26__.AncestorLineage(...ancestors);
+    this.schema$idIndex = schema$idIndex;
+    this.ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_28__.AncestorLineage(...ancestors);
     this.visited = visited;
+    this.ancestorSchema$ids = ancestorSchema$ids;
   }
   toAncestorLineage(path) {
     const ancestorNodes = path.getAncestorNodes();
     const directAncestors = new Set(ancestorNodes.filter(_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isElement));
-    const ancestorsLineage = new _util_ts__WEBPACK_IMPORTED_MODULE_26__.AncestorLineage(...this.ancestors, directAncestors);
+    const ancestorsLineage = new _util_ts__WEBPACK_IMPORTED_MODULE_28__.AncestorLineage(...this.ancestors, directAncestors);
     return [ancestorsLineage, directAncestors];
   }
   toBaseURI(uri) {
-    return _util_url_ts__WEBPACK_IMPORTED_MODULE_22__.resolve(this.baseURI, _util_url_ts__WEBPACK_IMPORTED_MODULE_22__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_22__.stripHash(uri)));
+    return _util_url_ts__WEBPACK_IMPORTED_MODULE_24__.resolve(this.baseURI, _util_url_ts__WEBPACK_IMPORTED_MODULE_24__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_24__.stripHash(uri)));
   }
   async toReference(uri) {
     // detect maximum depth of resolution
     if (this.reference.depth >= this.options.resolve.maxDepth) {
-      throw new _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_21__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`, {
+      throw new _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_23__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`, {
         maxDepth: this.options.resolve.maxDepth,
         uri: this.reference.uri
       });
@@ -5318,11 +5661,11 @@ class Arazzo1DereferenceVisitor {
     }
 
     // identity-based referencing: URI matches `$self` of an already processed Arazzo document
-    const referenceBy$self = refSet.find((0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.identifiedBy$self)(baseURI));
+    const referenceBy$self = refSet.find((0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.identifiedBy$self)(baseURI));
     if (referenceBy$self !== undefined) {
       return referenceBy$self;
     }
-    const parseResult = await (0,_parse_index_ts__WEBPACK_IMPORTED_MODULE_23__["default"])(_util_url_ts__WEBPACK_IMPORTED_MODULE_22__.unsanitize(baseURI), {
+    const parseResult = await (0,_parse_index_ts__WEBPACK_IMPORTED_MODULE_25__["default"])(_util_url_ts__WEBPACK_IMPORTED_MODULE_24__.unsanitize(baseURI), {
       ...this.options,
       parse: {
         ...this.options.parse,
@@ -5345,15 +5688,15 @@ class Arazzo1DereferenceVisitor {
     // context always sees raw, unresolved elements and processes them with its own
     // ancestors/indirections. The trade-off is that elements referenced by multiple
     // documents would be resolved once per context instead of being reused.
-    const mutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_24__["default"]({
+    const mutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_26__["default"]({
       uri: baseURI,
-      value: this.options.dereference.immutable ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneDeep)(parseResult) : parseResult,
+      value: this.options.dereference.immutable ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(parseResult) : parseResult,
       depth: this.reference.depth + 1
     });
     refSet.add(mutableReference);
     if (this.options.dereference.immutable) {
       // register new immutable reference with a refSet
-      const immutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_24__["default"]({
+      const immutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_26__["default"]({
         uri: `immutable://${baseURI}`,
         value: parseResult,
         depth: this.reference.depth + 1
@@ -5377,10 +5720,10 @@ class Arazzo1DereferenceVisitor {
     const {
       continueOnError
     } = this.options.dereference;
-    const isEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_22__.stripHash(this.reference.refSet?.rootRef?.uri ?? '') === this.reference.uri;
+    const isEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_24__.stripHash(this.reference.refSet?.rootRef?.uri ?? '') === this.reference.uri;
     const uri = this.reference.uri;
     const type = referencingElement.element;
-    const codeFrame = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement);
+    const codeFrame = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement);
 
     // find element location by identity in the document tree.
     // guarded: this.reference.value may not be a ParseResultElement or may lack a result.
@@ -5389,7 +5732,7 @@ class Arazzo1DereferenceVisitor {
     let location;
     const root = this.reference.value.result;
     if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isElement)(root)) {
-      (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_8__.traverse)(root, {
+      (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_9__.traverse)(root, {
         enter(p) {
           if (p.node === referencingElement) {
             location = p.formatPath();
@@ -5410,10 +5753,10 @@ class Arazzo1DereferenceVisitor {
 
     // enrich existing error from nested visitor or create new one
     let unresolvedError;
-    if (error instanceof _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_19__["default"]) {
+    if (error instanceof _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_21__["default"]) {
       // prefix relative locations for entries belonging to the referenced document
       const refBaseURI = this.toBaseURI(refFieldValue);
-      const fragment = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__.URIFragmentIdentifier.fromURIReference(refFieldValue);
+      const fragment = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.URIFragmentIdentifier.fromURIReference(refFieldValue);
       if (fragment) {
         if (refBaseURI === error.uri && error.location) {
           error.location = fragment + error.location;
@@ -5426,7 +5769,7 @@ class Arazzo1DereferenceVisitor {
       error.trace = [hop, ...error.trace];
       unresolvedError = error;
     } else {
-      unresolvedError = new _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_19__["default"](message, {
+      unresolvedError = new _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_21__["default"](message, {
         cause: error,
         type,
         uri,
@@ -5454,52 +5797,56 @@ class Arazzo1DereferenceVisitor {
       path.skip();
       return;
     }
-    const runtimeExpression = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.reference);
-
-    // parse the runtime expression
-    const {
-      result,
-      tree
-    } = (0,_swaggerexpert_arazzo_runtime_expression__WEBPACK_IMPORTED_MODULE_14__.parse)(runtimeExpression);
-    if (!result.success) {
-      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_7__["default"](`Invalid Reusable Object reference format: "${runtimeExpression}"`, {
-        runtimeExpression
-      });
-    }
-
-    // ReusableElement can only reference components
-    if (tree.type !== 'ComponentsExpression') {
-      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_7__["default"](`Reusable Object reference "${runtimeExpression}" must be a components expression`, {
-        runtimeExpression
-      });
-    }
-
-    // evaluate runtime expression as JSON Pointer to get the referenced element
-    const jsonPointer = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__.compile)(['components', tree.componentType, tree.componentName]);
+    const runtimeExpression = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.reference);
     let referencedElement;
     try {
-      referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.evaluate)(this.reference.value.result, jsonPointer);
-    } catch {
-      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_7__["default"](`Reusable Object reference "${runtimeExpression}" cannot be resolved`, {
-        runtimeExpression
-      });
+      // parse the runtime expression
+      const {
+        result,
+        tree
+      } = (0,_swaggerexpert_arazzo_runtime_expression__WEBPACK_IMPORTED_MODULE_15__.parse)(runtimeExpression);
+      if (!result.success) {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_8__["default"](`Invalid Reusable Object reference format: "${runtimeExpression}"`, {
+          runtimeExpression
+        });
+      }
+
+      // ReusableElement can only reference components
+      if (tree.type !== 'ComponentsExpression') {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_8__["default"](`Reusable Object reference "${runtimeExpression}" must be a components expression`, {
+          runtimeExpression
+        });
+      }
+
+      // evaluate runtime expression as JSON Pointer to get the referenced element
+      const jsonPointer = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.compile)(['components', tree.componentType, tree.componentName]);
+      try {
+        referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__.evaluate)(this.reference.value.result, jsonPointer);
+      } catch {
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_8__["default"](`Reusable Object reference "${runtimeExpression}" cannot be resolved`, {
+          runtimeExpression
+        });
+      }
+    } catch (error) {
+      this.handleError(`Error while dereferencing Reusable Object. Cannot resolve reference "${runtimeExpression}": ${error.message}`, error, referencingElement, 'reference', runtimeExpression, path);
+      return;
     }
 
     /**
      * Create a shallow clone of the referenced element to avoid modifying the original.
      */
-    const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneShallow)(referencedElement);
+    const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(referencedElement);
     // annotate with info about original referencing element
     mergedElement.meta.set('ref-fields', {
       reference: runtimeExpression,
-      value: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.value)
+      value: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.value)
     });
     // annotate with info about origin
     mergedElement.meta.set('ref-origin', this.reference.uri);
     mergedElement.meta.set('ref-type', referencingElement.element);
 
     // override value field if present for Parameter Objects
-    if ((0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_13__.isParameterElement)(mergedElement) && referencingElement.hasKey('value')) {
+    if ((0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_14__.isParameterElement)(mergedElement) && referencingElement.hasKey('value')) {
       mergedElement.remove('value');
       mergedElement.set('value', referencingElement.get('value'));
     }
@@ -5526,13 +5873,17 @@ class Arazzo1DereferenceVisitor {
     const indirectionsSize = this.indirections.length;
     try {
       // compute baseURI using rules around $self, $id and $ref keywords
-      let reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_22__.unsanitize(this.reference.uri));
+      let reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_24__.unsanitize(this.reference.uri));
       let {
         uri: retrievalURI
       } = reference;
-      const $refBaseURI = (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_17__.resolveSchema$refField)(this.baseURI, referencingElement);
-      const $refBaseURIStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_22__.stripHash($refBaseURI);
-      const file = new _File_ts__WEBPACK_IMPORTED_MODULE_25__["default"]({
+      // base URI in effect at the traversal root: the document base refined by
+      // the $ids of the schemas enclosing the root when the root is a fragment
+      const rootBaseURI = (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_19__.resolveSchema$ids)(this.baseURI, this.ancestorSchema$ids);
+      const schemaBaseURI = (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_19__.resolveSchemaBaseURI)(rootBaseURI, path);
+      const $refBaseURI = (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_19__.resolveSchema$refField)(schemaBaseURI, referencingElement);
+      const $refBaseURIStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_24__.stripHash($refBaseURI);
+      const file = new _File_ts__WEBPACK_IMPORTED_MODULE_27__["default"]({
         uri: $refBaseURIStrippedHash
       });
       const isUnknownURI = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(r => r.canRead(file), this.options.resolve.resolvers);
@@ -5542,14 +5893,33 @@ class Arazzo1DereferenceVisitor {
 
       // determining reference, proper evaluation and selection mechanism
       let referencedElement;
+      // $ids of the schemas enclosing the referenced element within its document
+      let ancestorSchema$ids;
       try {
         if (isUnknownURI || isURL) {
           // we're dealing with canonical URI or URL with possible fragment
           retrievalURI = this.toBaseURI($refBaseURI);
           const selector = $refBaseURI;
-          const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(reference.value.result);
-          referencedElement = (0,_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_16__.evaluate)(selector, referenceAsSchema);
-          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(referencedElement);
+          const documentElement = reference.value.result;
+          const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(documentElement);
+          // a document that is itself a fragment detached from its source carries
+          // the $ids enclosing it only as `ancestorSchema$ids`: its $ids are then
+          // indexed against the base that chain leaves in effect, and the chain
+          // prefixes the one of the located schema. A nested visitor rooted at a
+          // fragment of a whole document indexes that document against its own base.
+          const rootNode = path.getAncestorNodes().at(-1) ?? path.node;
+          const isDocumentRoot = ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isParseResultElement)(rootNode) ? rootNode.result : rootNode) === documentElement;
+          ({
+            element: referencedElement,
+            ancestorSchema$ids
+          } = (0,_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_17__.locate)(selector, referenceAsSchema, {
+            baseURI: isDocumentRoot ? rootBaseURI : this.baseURI,
+            index: this.schema$idIndex
+          }));
+          if (isDocumentRoot) {
+            ancestorSchema$ids = [...this.ancestorSchema$ids, ...ancestorSchema$ids];
+          }
+          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(referencedElement);
 
           // ignore resolving internal Schema Objects
           if (!this.options.resolve.internal && isInternalReference) {
@@ -5577,19 +5947,22 @@ class Arazzo1DereferenceVisitor {
             // skip traversing this schema element but traverse all its child elements
             return;
           }
-          reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_22__.unsanitize($refBaseURI));
-          const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__.URIFragmentIdentifier.fromURIReference($refBaseURI);
-          const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(reference.value.result);
-          referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.evaluate)(referenceAsSchema, selector);
-          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(referencedElement);
+          reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_24__.unsanitize($refBaseURI));
+          const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+          const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(reference.value.result);
+          ({
+            element: referencedElement,
+            ancestorSchema$ids
+          } = (0,_openapi_3_1_selectors_json_pointer_ts__WEBPACK_IMPORTED_MODULE_18__.locate)(referenceAsSchema, selector));
+          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(referencedElement);
         }
       } catch (error) {
         /**
          * JSONSchemaElement($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_ts__WEBPACK_IMPORTED_MODULE_27__["default"]) {
-          if ((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_15__.isAnchor)((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_15__.uriToAnchor)($refBaseURI))) {
+        if (isURL && error instanceof _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_29__["default"]) {
+          if ((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_16__.isAnchor)((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_16__.uriToAnchor)($refBaseURI))) {
             // we're dealing with JSON Schema $anchor here
             isInternalReference = this.baseURI === retrievalURI;
             isExternalReference = !isInternalReference;
@@ -5604,11 +5977,14 @@ class Arazzo1DereferenceVisitor {
               // skip traversing this schema element but traverse all its child elements
               return;
             }
-            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_22__.unsanitize($refBaseURI));
-            const selector = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_15__.uriToAnchor)($refBaseURI);
-            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(reference.value.result);
-            referencedElement = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_15__.evaluate)(selector, referenceAsSchema);
-            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(referencedElement);
+            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_24__.unsanitize($refBaseURI));
+            const selector = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_16__.uriToAnchor)($refBaseURI);
+            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(reference.value.result);
+            ({
+              element: referencedElement,
+              ancestorSchema$ids
+            } = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_16__.locate)(selector, referenceAsSchema));
+            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(referencedElement);
           } else {
             // we're assuming here that we're dealing with JSON Pointer here
             retrievalURI = this.toBaseURI($refBaseURI);
@@ -5625,11 +6001,14 @@ class Arazzo1DereferenceVisitor {
               // skip traversing this schema element but traverse all its child elements
               return;
             }
-            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_22__.unsanitize($refBaseURI));
-            const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_10__.URIFragmentIdentifier.fromURIReference($refBaseURI);
-            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(reference.value.result);
-            referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_9__.evaluate)(referenceAsSchema, selector);
-            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_18__.maybeRefractToJSONSchemaElement)(referencedElement);
+            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_24__.unsanitize($refBaseURI));
+            const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(reference.value.result);
+            ({
+              element: referencedElement,
+              ancestorSchema$ids
+            } = (0,_openapi_3_1_selectors_json_pointer_ts__WEBPACK_IMPORTED_MODULE_18__.locate)(referenceAsSchema, selector));
+            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.maybeRefractToJSONSchemaElement)(referencedElement);
           }
         } else {
           throw error;
@@ -5639,14 +6018,14 @@ class Arazzo1DereferenceVisitor {
 
       // detect direct or indirect reference
       if (referencingElement === referencedElement) {
-        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_7__["default"]('Recursive JSON Schema reference detected', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref)
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_8__["default"]('Recursive JSON Schema reference detected', {
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.$ref)
         });
       }
 
       // detect maximum depth of dereferencing
       if (this.indirections.length > this.options.dereference.maxDepth) {
-        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_20__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
+        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_22__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
           maxDepth: this.options.dereference.maxDepth,
           uri: this.reference.uri
         });
@@ -5657,14 +6036,14 @@ class Arazzo1DereferenceVisitor {
       if (ancestorsLineage.includes(referencedElement)) {
         reference.refSet.circular = true;
         if (this.options.dereference.circular === 'error') {
-          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_7__["default"]('Circular reference detected', {
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref)
+          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_8__["default"]('Circular reference detected', {
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.$ref)
           });
         } else if (this.options.dereference.circular === 'replace') {
-          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__["default"]($refBaseURI, {
+          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"]($refBaseURI, {
             type: referencingElement.element,
             uri: reference.uri,
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref)
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.$ref)
           });
           const replacer = this.options.dereference.strategyOpts['arazzo-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
@@ -5683,9 +6062,13 @@ class Arazzo1DereferenceVisitor {
        *  3. Fragment is a JSON Schema with $ref field. We need to follow it to get the eventual value
        *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
        */
-      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_22__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_24__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
       const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-      if ((isExternalReference || isNonEntryDocument || (0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_11__.isJSONSchemaElement)(referencedElement) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(referencedElement.$ref) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
+      // content transplanted into the referencing site is traversed under that
+      // site's $id chain; a fragment enclosed by a different chain has its own
+      // $refs resolved in place first, by a nested visitor seeded with that chain
+      const hasDifferentEnclosingBase = (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_19__.resolveSchema$ids)((0,_util_ts__WEBPACK_IMPORTED_MODULE_20__.resolveArazzo$selfField)(reference.uri, reference.value.result), ancestorSchema$ids) !== (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_19__.resolveSchema$ids)(rootBaseURI, (0,_openapi_3_1_util_ts__WEBPACK_IMPORTED_MODULE_19__.schema$idsOf)(path.getAncestorNodes().reverse()));
+      if ((isExternalReference || isNonEntryDocument || hasDifferentEnclosingBase || (0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_12__.isJSONSchemaElement)(referencedElement) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(referencedElement.$ref) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
         if (shouldDetectCircular) {
           this.visited.add(referencedElement);
         }
@@ -5696,10 +6079,12 @@ class Arazzo1DereferenceVisitor {
           reference,
           indirections: [...this.indirections],
           options: this.options,
+          schema$idIndex: this.schema$idIndex,
           visited: this.visited,
-          ancestors: ancestorsLineage
+          ancestors: ancestorsLineage,
+          ancestorSchema$ids
         });
-        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_8__.traverseAsync)(referencedElement, visitor, {
+        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_9__.traverseAsync)(referencedElement, visitor, {
           mutable: true,
           skipVisited: 'skip'
         });
@@ -5709,11 +6094,11 @@ class Arazzo1DereferenceVisitor {
       }
 
       // Boolean JSON Schemas
-      if ((0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_12__.isBooleanJSONSchemaElement)(referencedElement)) {
-        const booleanJsonSchemaElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneDeep)(referencedElement);
+      if ((0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_13__.isBooleanJSONSchemaElement)(referencedElement)) {
+        const booleanJsonSchemaElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(referencedElement);
         // annotate referenced element with info about original referencing element
         booleanJsonSchemaElement.meta.set('ref-fields', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref)
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.$ref)
         });
         // annotate referenced element with info about origin
         booleanJsonSchemaElement.meta.set('ref-origin', reference.uri);
@@ -5726,17 +6111,17 @@ class Arazzo1DereferenceVisitor {
       /**
        * Creating a new version of JSON Schema by merging fields from referenced Schema with referencing one.
        */
-      if ((0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_11__.isJSONSchemaElement)(referencedElement)) {
-        const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.cloneShallow)(referencedElement);
+      if ((0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_12__.isJSONSchemaElement)(referencedElement)) {
+        const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(referencedElement);
         // existing keywords from referencing schema overrides ones from referenced schema
         referencingElement.forEach((value, keyElement, item) => {
-          mergedElement.remove((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(keyElement));
+          mergedElement.remove((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(keyElement));
           mergedElement.content.push(item);
         });
         mergedElement.remove('$ref');
         // annotate referenced element with info about original referencing element
         mergedElement.meta.set('ref-fields', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref)
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.$ref)
         });
         // annotate fragment with info about origin
         mergedElement.meta.set('ref-origin', reference.uri);
@@ -5748,7 +6133,7 @@ class Arazzo1DereferenceVisitor {
        */
       path.replaceWith(referencedElement);
     } catch (error) {
-      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_5__["default"])(referencingElement.$ref);
+      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Schema Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
     } finally {
       if (this.indirections.length > indirectionsSize) this.indirections.pop();
@@ -8030,6 +8415,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(98979);
 /* harmony import */ var _ReferenceSet_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(24131);
 /* harmony import */ var _visitor_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(4224);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(60888);
+
 
 
 
@@ -8093,7 +8480,8 @@ class OpenAPI3_1DereferenceStrategy extends _DereferenceStrategy_ts__WEBPACK_IMP
     const shouldDetectCircular = ['error', 'replace'].includes(options.dereference.circular);
     const visitor = new _visitor_ts__WEBPACK_IMPORTED_MODULE_8__["default"]({
       reference: reference,
-      options
+      options,
+      ancestorSchema$ids: (0,_util_ts__WEBPACK_IMPORTED_MODULE_10__.detachedRootSchema$ids)(refSet.rootRef.value.result)
     });
     const dereferencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_2__.traverseAsync)(refSet.rootRef.value, visitor, {
       mutable: true,
@@ -8139,9 +8527,9 @@ class OpenAPI3_1DereferenceStrategy extends _DereferenceStrategy_ts__WEBPACK_IMP
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   EvaluationJsonSchema$anchorError: () => (/* reexport safe */ _errors_EvaluationJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_6__["default"]),
-/* harmony export */   InvalidJsonSchema$anchorError: () => (/* reexport safe */ _errors_InvalidJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_7__["default"]),
-/* harmony export */   JsonSchema$anchorError: () => (/* reexport safe */ _errors_JsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_8__["default"])
+/* harmony export */   EvaluationJsonSchema$anchorError: () => (/* reexport safe */ _errors_EvaluationJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_7__["default"]),
+/* harmony export */   InvalidJsonSchema$anchorError: () => (/* reexport safe */ _errors_InvalidJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_8__["default"]),
+/* harmony export */   JsonSchema$anchorError: () => (/* reexport safe */ _errors_JsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_9__["default"])
 /* harmony export */ });
 /* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(33031);
 /* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(64988);
@@ -8149,9 +8537,11 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(80796);
 /* harmony import */ var _speclynx_apidom_ns_json_schema_2020_12__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(7557);
 /* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(30658);
-/* harmony import */ var _errors_EvaluationJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(21376);
-/* harmony import */ var _errors_InvalidJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(56335);
-/* harmony import */ var _errors_JsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(75578);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(60888);
+/* harmony import */ var _errors_EvaluationJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(21376);
+/* harmony import */ var _errors_InvalidJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(56335);
+/* harmony import */ var _errors_JsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(75578);
+
 
 
 
@@ -8186,35 +8576,83 @@ const uriToAnchor = uri => {
  */
 const parse = anchor => {
   if (!isAnchor(anchor)) {
-    throw new _errors_InvalidJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_7__["default"](anchor);
+    throw new _errors_InvalidJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_8__["default"](anchor);
   }
   return anchor;
 };
 
 /**
- * Evaluates JSON Schema $anchor against ApiDOM fragment.
+ * Locates the schema identified by JSON Schema $anchor within ApiDOM fragment,
+ * along with the `$id`s of the schemas enclosing it, the search root included.
  * @public
  */
-const evaluate = (anchor, element) => {
+const locate = (anchor, element) => {
   const token = parse(anchor);
   const resultPath = (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_3__.find)(element,
   // @ts-ignore
   path => (0,_speclynx_apidom_ns_json_schema_2020_12__WEBPACK_IMPORTED_MODULE_4__.isJSONSchemaElement)(path.node) && (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(path.node.$anchor) === token);
   if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_0__["default"])(resultPath)) {
-    throw new _errors_EvaluationJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_6__["default"](`Evaluation failed on token: "${token}"`);
+    throw new _errors_EvaluationJsonSchema$anchorError_ts__WEBPACK_IMPORTED_MODULE_7__["default"](`Evaluation failed on token: "${token}"`);
   }
-  return resultPath.node;
+  return {
+    element: resultPath.node,
+    ancestorSchema$ids: (0,_util_ts__WEBPACK_IMPORTED_MODULE_6__.schema$idsOf)(resultPath.getAncestorNodes().reverse())
+  };
 };
 
+/**
+ * Evaluates JSON Schema $anchor against ApiDOM fragment.
+ * @public
+ */
+const evaluate = (anchor, element) => locate(anchor, element).element;
+
 
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
 /* harmony export */   "evaluate", 0, /* binding */ evaluate,
 /* harmony export */   "isAnchor", 0, /* binding */ isAnchor,
+/* harmony export */   "locate", 0, /* binding */ locate,
 /* harmony export */   "parse", 0, /* binding */ parse,
 /* harmony export */   "uriToAnchor", 0, /* binding */ uriToAnchor
 /* harmony export */ ]);
 
 
+/***/ },
+
+/***/ 37517
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(12020);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(60888);
+
+
+
+/**
+ * Locates the element addressed by JSON Pointer within ApiDOM fragment, along
+ * with the `$id`s of the schemas enclosing it: the elements the pointer walks
+ * through on its way to the target, the search root included.
+ */
+const locate = (element, jsonPointer) => {
+  const trace = {
+    steps: []
+  };
+  const result = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_0__.evaluate)(element, jsonPointer, {
+    trace
+  });
+
+  // each step's input is the node the token was applied to, so the inputs are
+  // exactly the walked nodes minus the target
+  return {
+    element: result,
+    ancestorSchema$ids: (0,_util_ts__WEBPACK_IMPORTED_MODULE_1__.schema$idsOf)(trace.steps.map(step => step.input))
+  };
+};
+/* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "locate", 0, /* binding */ locate
+/* harmony export */ ]);
+
+
 /***/ },
 
 /***/ 56481
@@ -8223,19 +8661,18 @@ const evaluate = (anchor, element) => {
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   EvaluationJsonSchemaUriError: () => (/* reexport safe */ _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_6__["default"]),
-/* harmony export */   JsonSchemaUriError: () => (/* reexport safe */ _errors_JsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_9__["default"])
+/* harmony export */   EvaluationJsonSchemaUriError: () => (/* reexport safe */ _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_4__["default"]),
+/* harmony export */   JsonSchemaUriError: () => (/* reexport safe */ _errors_JsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_8__["default"])
 /* harmony export */ });
 /* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(33031);
 /* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(80796);
-/* harmony import */ var _speclynx_apidom_ns_json_schema_2020_12__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(7557);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(12020);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(61198);
-/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(30658);
-/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(44477);
-/* harmony import */ var _$anchor_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(32054);
-/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(60888);
-/* harmony import */ var _errors_JsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(51651);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(61198);
+/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(30658);
+/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(44477);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(60888);
+/* harmony import */ var _$anchor_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(32054);
+/* harmony import */ var _json_pointer_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(37517);
+/* harmony import */ var _errors_JsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(51651);
 
 
 
@@ -8246,41 +8683,68 @@ __webpack_require__.r(__webpack_exports__);
 
 
 /**
- * Evaluates JSON Schema $ref containing unknown URI against ApiDOM fragment.
+ * Index of `$id`-bearing schemas per indexed element (a document root, or the
+ * fragment a visitor traverses). Each entry pairs a schema with the `$id`s of its
+ * enclosing schema resources (outermost first, including its own). The index is
+ * populated once per element and never refreshed, so callers scope it
+ * to a single dereference/bundle run instead of sharing it globally. Within a run the
+ * `$id` graph of an indexed document is stable: the bundle strategies mutate deep
+ * clones and place components only after the entry traversal ends, and the
+ * dereference strategies only replace `$ref`-bearing schemas.
  * @public
  */
-const evaluate = (uri, element) => {
-  const {
-    cache
-  } = evaluate;
-  const uriStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_5__.stripHash(uri);
-  const isJSONSchemaElementWith$id = path => (0,_speclynx_apidom_ns_json_schema_2020_12__WEBPACK_IMPORTED_MODULE_2__.isJSONSchemaElement)(path.node) && typeof path.node.$id !== 'undefined';
 
-  // warm the cache
-  if (!cache.has(element)) {
-    const schemaObjectPaths = (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_1__.filter)(element, isJSONSchemaElementWith$id);
-    cache.set(element, schemaObjectPaths.map(path => path.node));
-  }
+/**
+ * @public
+ */
 
-  // search for the matching schema
-  const result = cache.get(element).find(e => {
-    const $idBaseURI = (0,_util_ts__WEBPACK_IMPORTED_MODULE_8__.resolveSchema$idField)(uriStrippedHash, e);
-    return $idBaseURI === uriStrippedHash;
-  });
-  if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_0__["default"])(result)) {
-    throw new _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_6__["default"](`Evaluation failed on URI: "${uri}"`);
+const indexSchema$ids = element => (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_1__.filter)(element, path => (0,_util_ts__WEBPACK_IMPORTED_MODULE_5__.isJSONSchemaElementWith$id)(path.node)).map(path => ({
+  schema: path.node,
+  $ids: (0,_util_ts__WEBPACK_IMPORTED_MODULE_5__.collectSchema$ids)(path)
+}));
+
+/**
+ * Locates the schema addressed by JSON Schema $ref containing unknown URI within
+ * ApiDOM fragment, along with the `$id`s of the schemas enclosing it.
+ * @public
+ */
+const locate = (uri, element, options = {}) => {
+  const uriStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_3__.stripHash(uri);
+  const {
+    baseURI = uriStrippedHash,
+    index = new WeakMap()
+  } = options;
+  if (!index.has(element)) {
+    index.set(element, indexSchema$ids(element));
   }
-  if ((0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_7__.isAnchor)((0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_7__.uriToAnchor)(uri))) {
-    // we're dealing with JSON Schema $anchor here
-    return (0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_7__.evaluate)((0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_7__.uriToAnchor)(uri), result);
+
+  // search for the schema whose canonical URI matches
+  const entry = index.get(element).find(({
+    $ids
+  }) => (0,_util_ts__WEBPACK_IMPORTED_MODULE_5__.resolveSchema$ids)(baseURI, $ids) === uriStrippedHash);
+  if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_0__["default"])(entry)) {
+    throw new _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_4__["default"](`Evaluation failed on URI: "${uri}"`);
   }
-  return (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_3__.evaluate)(result, _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_4__.URIFragmentIdentifier.fromURIReference(uri));
+
+  // the fragment is resolved within the matched schema, whose own $id is the
+  // last of its chain; the fragment walk contributes it again when descending
+  const fragmentLocation = (0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_6__.isAnchor)((0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_6__.uriToAnchor)(uri)) ? (0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_6__.locate)((0,_$anchor_ts__WEBPACK_IMPORTED_MODULE_6__.uriToAnchor)(uri), entry.schema) : (0,_json_pointer_ts__WEBPACK_IMPORTED_MODULE_7__.locate)(entry.schema, _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_2__.URIFragmentIdentifier.fromURIReference(uri));
+  return {
+    element: fragmentLocation.element,
+    ancestorSchema$ids: [...entry.$ids.slice(0, -1), ...fragmentLocation.ancestorSchema$ids]
+  };
 };
-evaluate.cache = new WeakMap();
+
+/**
+ * Evaluates JSON Schema $ref containing unknown URI against ApiDOM fragment.
+ * @public
+ */
+const evaluate = (uri, element, options = {}) => locate(uri, element, options).element;
 
 
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
-/* harmony export */   "evaluate", 0, /* binding */ evaluate
+/* harmony export */   "evaluate", 0, /* binding */ evaluate,
+/* harmony export */   "locate", 0, /* binding */ locate
 /* harmony export */ ]);
 
 
@@ -8292,10 +8756,14 @@ evaluate.cache = new WeakMap();
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(97797);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(25162);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(44673);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(24329);
-/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(30658);
+/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(85102);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(25162);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(44673);
+/* harmony import */ var _speclynx_apidom_ns_json_schema_2020_12__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(7557);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(24329);
+/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(30658);
+
+
 
 
 
@@ -8303,31 +8771,84 @@ __webpack_require__.r(__webpack_exports__);
 
 
 /**
+ * A schema located within a document, together with the `$id`s of the JSON Schema
+ * elements enclosing it (outermost first; the located schema's own `$id` excluded).
  * @public
  */
-const resolveSchema$refField = (retrievalURI, schemaElement) => {
-  if (typeof schemaElement.$ref === 'undefined') {
+
+/**
+ * Whether the element is a JSON Schema element declaring a `$id`.
+ */
+const isJSONSchemaElementWith$id = element => (0,_speclynx_apidom_ns_json_schema_2020_12__WEBPACK_IMPORTED_MODULE_4__.isJSONSchemaElement)(element) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(element.$id);
+
+/**
+ * `$id`s declared by the JSON Schema elements among `nodes`, in order.
+ */
+const schema$idsOf = nodes => nodes.filter(isJSONSchemaElementWith$id).map(node => (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(node.$id));
+
+/**
+ * `$id`s of the JSON Schema elements on `path` (outermost first, the node itself
+ * included). The `$id`s are read from the elements themselves rather than from
+ * refraction-time metadata, so a `$id` assigned after refraction (e.g. by the
+ * bundler) is honored.
+ */
+const collectSchema$ids = path => schema$idsOf([...path.getAncestorNodes().reverse(), path.node]);
+
+/**
+ * `$id`s of the schemas enclosing a traversal root that is a fragment detached
+ * from its document, read from the `ancestorsSchemaIdentifiers` meta the JSON
+ * Schema refractors record. The meta also carries the root's own `$id`, which
+ * the ancestor walk contributes itself, so it is dropped. A detached fragment
+ * has no live ancestors, so the meta is the only carrier of its lexical
+ * context; this is the one reader of it the refractors must keep serving.
+ */
+const detachedRootSchema$ids = root => {
+  const meta = root?.meta.get('ancestorsSchemaIdentifiers');
+  const $ids = Array.isArray(meta) ? meta.filter(ramda_adjunct__WEBPACK_IMPORTED_MODULE_1__["default"]) : [];
+  const own$id = isJSONSchemaElementWith$id(root) ? (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(root.$id) : undefined;
+  return $ids.length > 0 && $ids.at(-1) === own$id ? $ids.slice(0, -1) : $ids;
+};
+
+/**
+ * Resolves a chain of `$id`s (outermost first) against `baseURI`, each `$id`
+ * refining the base the next one resolves against.
+ */
+const resolveSchema$ids = (baseURI, $ids) => (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])((acc, $id) => _util_url_ts__WEBPACK_IMPORTED_MODULE_6__.resolve(acc, _util_url_ts__WEBPACK_IMPORTED_MODULE_6__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_6__.stripHash($id))), baseURI, $ids);
+
+/**
+ * Resolves the base URI of the schema at `path`: `baseURI` (the base URI in
+ * effect at the traversal root) refined by each `$id` on the schema's ancestor
+ * chain in turn, the schema's own `$id` included.
+ */
+const resolveSchemaBaseURI = (baseURI, path) => resolveSchema$ids(baseURI, collectSchema$ids(path));
+
+/**
+ * Resolves the `$ref` of the schema against its base URI (see
+ * `resolveSchemaBaseURI`), or returns `undefined` when the schema has no string `$ref`.
+ *
+ * @public
+ */
+const resolveSchema$refField = (schemaBaseURI, schemaElement) => {
+  if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(schemaElement.$ref)) {
     return undefined;
   }
-  const hash = _util_url_ts__WEBPACK_IMPORTED_MODULE_4__.getHash((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(schemaElement.$ref));
-  const ancestorsSchemaIdentifiers = schemaElement.meta.get('ancestorsSchemaIdentifiers');
-  const $refBaseURI = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])((acc, uri) => {
-    return _util_url_ts__WEBPACK_IMPORTED_MODULE_4__.resolve(acc, _util_url_ts__WEBPACK_IMPORTED_MODULE_4__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_4__.stripHash(uri)));
-  }, retrievalURI, [...ancestorsSchemaIdentifiers, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(schemaElement.$ref)]);
+  const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(schemaElement.$ref);
+  const hash = _util_url_ts__WEBPACK_IMPORTED_MODULE_6__.getHash($ref);
+  const $refBaseURI = resolveSchema$ids(schemaBaseURI, [$ref]);
   return `${$refBaseURI}${hash === '#' ? '' : hash}`;
 };
 
 /**
+ * Resolves the `$id` of the schema against `baseURI`, the base URI in effect
+ * where the schema sits, or returns `undefined` when the schema declares no string `$id`.
+ *
  * @public
  */
-const resolveSchema$idField = (retrievalURI, schemaElement) => {
-  if (typeof schemaElement.$id === 'undefined') {
+const resolveSchema$idField = (baseURI, schemaElement) => {
+  if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(schemaElement.$id)) {
     return undefined;
   }
-  const ancestorsSchemaIdentifiers = schemaElement.meta.get('ancestorsSchemaIdentifiers');
-  return (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])((acc, $id) => {
-    return _util_url_ts__WEBPACK_IMPORTED_MODULE_4__.resolve(acc, _util_url_ts__WEBPACK_IMPORTED_MODULE_4__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_4__.stripHash($id)));
-  }, retrievalURI, ancestorsSchemaIdentifiers);
+  return resolveSchema$ids(baseURI, [(0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(schemaElement.$id)]);
 };
 
 /**
@@ -8337,7 +8858,7 @@ const refractToSchemaElement = element => {
   if (refractToSchemaElement.cache.has(element)) {
     return refractToSchemaElement.cache.get(element);
   }
-  const refracted = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_3__.refractSchema)(element);
+  const refracted = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_5__.refractSchema)(element);
   refractToSchemaElement.cache.set(element, refracted);
   return refracted;
 };
@@ -8351,16 +8872,22 @@ const maybeRefractToSchemaElement = element => {
    * Conditional version of refractToSchemaElement, that acts as an identity
    * function for all non-primitive Element instances.
    */
-  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isPrimitiveElement)(element)) {
+  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isPrimitiveElement)(element)) {
     return refractToSchemaElement(element);
   }
   return element;
 };
 /* harmony export */ __webpack_require__.d(__webpack_exports__, [
+/* harmony export */   "collectSchema$ids", 0, /* binding */ collectSchema$ids,
+/* harmony export */   "detachedRootSchema$ids", 0, /* binding */ detachedRootSchema$ids,
+/* harmony export */   "isJSONSchemaElementWith$id", 0, /* binding */ isJSONSchemaElementWith$id,
 /* harmony export */   "maybeRefractToSchemaElement", 0, /* binding */ maybeRefractToSchemaElement,
 /* harmony export */   "refractToSchemaElement", 0, /* binding */ refractToSchemaElement,
 /* harmony export */   "resolveSchema$idField", 0, /* binding */ resolveSchema$idField,
-/* harmony export */   "resolveSchema$refField", 0, /* binding */ resolveSchema$refField
+/* harmony export */   "resolveSchema$ids", 0, /* binding */ resolveSchema$ids,
+/* harmony export */   "resolveSchema$refField", 0, /* binding */ resolveSchema$refField,
+/* harmony export */   "resolveSchemaBaseURI", 0, /* binding */ resolveSchemaBaseURI,
+/* harmony export */   "schema$idsOf", 0, /* binding */ schema$idsOf
 /* harmony export */ ]);
 
 
@@ -8375,31 +8902,34 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(6352);
 /* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(33031);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(25162);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(12111);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(78894);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(37205);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(44673);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(16280);
-/* harmony import */ var _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(44641);
-/* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(80796);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(12020);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(61198);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(96681);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(21314);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(24329);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(76332);
-/* harmony import */ var _selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(32054);
-/* harmony import */ var _selectors_uri_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(56481);
-/* harmony import */ var _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(37757);
-/* harmony import */ var _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(51325);
-/* harmony import */ var _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(8853);
-/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(44477);
-/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(30658);
-/* harmony import */ var _parse_index_ts__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(35014);
-/* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(98979);
-/* harmony import */ var _File_ts__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(10682);
-/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_27__ = __webpack_require__(60888);
-/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_28__ = __webpack_require__(53429);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(96911);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(12111);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(78894);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(37205);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(44673);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(16280);
+/* harmony import */ var _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(44641);
+/* harmony import */ var _speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(80796);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(12020);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(61198);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(96681);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(21314);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(24329);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(76332);
+/* harmony import */ var _selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(32054);
+/* harmony import */ var _selectors_uri_ts__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(56481);
+/* harmony import */ var _selectors_json_pointer_ts__WEBPACK_IMPORTED_MODULE_20__ = __webpack_require__(37517);
+/* harmony import */ var _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_21__ = __webpack_require__(37757);
+/* harmony import */ var _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_22__ = __webpack_require__(51325);
+/* harmony import */ var _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_23__ = __webpack_require__(8853);
+/* harmony import */ var _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_24__ = __webpack_require__(44477);
+/* harmony import */ var _util_url_ts__WEBPACK_IMPORTED_MODULE_25__ = __webpack_require__(30658);
+/* harmony import */ var _parse_index_ts__WEBPACK_IMPORTED_MODULE_26__ = __webpack_require__(35014);
+/* harmony import */ var _Reference_ts__WEBPACK_IMPORTED_MODULE_27__ = __webpack_require__(98979);
+/* harmony import */ var _File_ts__WEBPACK_IMPORTED_MODULE_28__ = __webpack_require__(10682);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_29__ = __webpack_require__(60888);
+/* harmony import */ var _util_ts__WEBPACK_IMPORTED_MODULE_30__ = __webpack_require__(53429);
+
 
 
 
@@ -8433,8 +8963,23 @@ class OpenAPI3_1DereferenceVisitor {
   reference;
   options;
   refractCache;
+
+  /**
+   * Index of `$id`-bearing schemas per document, shared across nested visitors
+   * of a single dereference run so it never outlives mutations of the documents.
+   */
+  schema$idIndex;
   visited;
 
+  /**
+   * `$id`s of the JSON Schema elements enclosing the traversal root within its
+   * document (outermost first). Empty when the root is the document itself; a
+   * nested visitor traversing a fragment is seeded with the `$id`s of the
+   * schemas the fragment sits under, so the `$ref`s and `$id`s within resolve
+   * against the same base as they would from the document root.
+   */
+  ancestorSchema$ids;
+
   /**
    * Tracks element ancestors across dive-deep traversal boundaries.
    * Used for cycle detection: if a referenced element is found in
@@ -8446,29 +8991,33 @@ class OpenAPI3_1DereferenceVisitor {
     options,
     indirections = [],
     refractCache = new WeakMap(),
-    ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_28__.AncestorLineage(),
-    visited = new WeakSet()
+    schema$idIndex = new WeakMap(),
+    ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_30__.AncestorLineage(),
+    visited = new WeakSet(),
+    ancestorSchema$ids = []
   }) {
     this.indirections = indirections;
     this.reference = reference;
     this.options = options;
     this.refractCache = refractCache;
-    this.ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_28__.AncestorLineage(...ancestors);
+    this.schema$idIndex = schema$idIndex;
+    this.ancestors = new _util_ts__WEBPACK_IMPORTED_MODULE_30__.AncestorLineage(...ancestors);
     this.visited = visited;
+    this.ancestorSchema$ids = ancestorSchema$ids;
   }
   toAncestorLineage(path) {
     const ancestorNodes = path.getAncestorNodes();
     const directAncestors = new Set(ancestorNodes.filter(_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isElement));
-    const ancestorsLineage = new _util_ts__WEBPACK_IMPORTED_MODULE_28__.AncestorLineage(...this.ancestors, directAncestors);
+    const ancestorsLineage = new _util_ts__WEBPACK_IMPORTED_MODULE_30__.AncestorLineage(...this.ancestors, directAncestors);
     return [ancestorsLineage, directAncestors];
   }
   toBaseURI(uri) {
-    return _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.resolve(this.reference.uri, _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(uri)));
+    return _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.resolve(this.reference.uri, _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.sanitize(_util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(uri)));
   }
   async toReference(uri) {
     // detect maximum depth of resolution
     if (this.reference.depth >= this.options.resolve.maxDepth) {
-      throw new _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_20__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`, {
+      throw new _errors_MaximumResolveDepthError_ts__WEBPACK_IMPORTED_MODULE_22__["default"](`Maximum resolution depth of ${this.options.resolve.maxDepth} has been exceeded by file "${this.reference.uri}"`, {
         maxDepth: this.options.resolve.maxDepth,
         uri: this.reference.uri
       });
@@ -8482,7 +9031,7 @@ class OpenAPI3_1DereferenceVisitor {
     if (refSet.has(baseURI)) {
       return refSet.find((0,ramda__WEBPACK_IMPORTED_MODULE_1__["default"])(baseURI, 'uri'));
     }
-    const parseResult = await (0,_parse_index_ts__WEBPACK_IMPORTED_MODULE_24__["default"])(_util_url_ts__WEBPACK_IMPORTED_MODULE_23__.unsanitize(baseURI), {
+    const parseResult = await (0,_parse_index_ts__WEBPACK_IMPORTED_MODULE_26__["default"])(_util_url_ts__WEBPACK_IMPORTED_MODULE_25__.unsanitize(baseURI), {
       ...this.options,
       parse: {
         ...this.options.parse,
@@ -8505,15 +9054,15 @@ class OpenAPI3_1DereferenceVisitor {
     // context always sees raw, unresolved elements and processes them with its own
     // ancestors/indirections. The trade-off is that elements referenced by multiple
     // documents would be resolved once per context instead of being reused.
-    const mutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_25__["default"]({
+    const mutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_27__["default"]({
       uri: baseURI,
-      value: this.options.dereference.immutable ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(parseResult) : parseResult,
+      value: this.options.dereference.immutable ? (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneDeep)(parseResult) : parseResult,
       depth: this.reference.depth + 1
     });
     refSet.add(mutableReference);
     if (this.options.dereference.immutable) {
       // register new immutable reference with original parseResult
-      const immutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_25__["default"]({
+      const immutableReference = new _Reference_ts__WEBPACK_IMPORTED_MODULE_27__["default"]({
         uri: `immutable://${baseURI}`,
         value: parseResult,
         depth: this.reference.depth + 1
@@ -8537,10 +9086,10 @@ class OpenAPI3_1DereferenceVisitor {
     const {
       continueOnError
     } = this.options.dereference;
-    const isEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.refSet?.rootRef?.uri ?? '') === this.reference.uri;
+    const isEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.refSet?.rootRef?.uri ?? '') === this.reference.uri;
     const uri = this.reference.uri;
     const type = referencingElement.element;
-    const codeFrame = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement);
+    const codeFrame = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement);
 
     // find element location by identity in the document tree.
     // guarded: this.reference.value may not be a ParseResultElement or may lack a result.
@@ -8549,7 +9098,7 @@ class OpenAPI3_1DereferenceVisitor {
     let location;
     const root = this.reference.value.result;
     if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isElement)(root)) {
-      (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.traverse)(root, {
+      (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.traverse)(root, {
         enter: p => {
           if (p.node === referencingElement || this.refractCache.get(p.node) === referencingElement) {
             location = p.formatPath();
@@ -8570,10 +9119,10 @@ class OpenAPI3_1DereferenceVisitor {
 
     // enrich existing error from nested visitor or create new one
     let unresolvedError;
-    if (error instanceof _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_21__["default"]) {
+    if (error instanceof _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_23__["default"]) {
       // prefix relative locations for entries belonging to the referenced document
       const refBaseURI = this.toBaseURI(refFieldValue);
-      const fragment = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference(refFieldValue);
+      const fragment = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference(refFieldValue);
       if (fragment) {
         if (refBaseURI === error.uri && error.location) {
           error.location = fragment + error.location;
@@ -8586,7 +9135,7 @@ class OpenAPI3_1DereferenceVisitor {
       error.trace = [hop, ...error.trace];
       unresolvedError = error;
     } else {
-      unresolvedError = new _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_21__["default"](message, {
+      unresolvedError = new _errors_UnresolvableReferenceError_ts__WEBPACK_IMPORTED_MODULE_23__["default"](message, {
         cause: error,
         type,
         uri,
@@ -8608,8 +9157,8 @@ class OpenAPI3_1DereferenceVisitor {
       path.skip();
       return;
     }
-    const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref));
-    const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === retrievalURI;
+    const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref));
+    const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === retrievalURI;
     const isExternalReference = !isInternalReference;
 
     // ignore resolving internal Reference Objects
@@ -8624,31 +9173,31 @@ class OpenAPI3_1DereferenceVisitor {
       path.skip();
       return;
     }
-    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref));
+    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref));
     const indirectionsSize = this.indirections.length;
     try {
-      const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref));
+      const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
-      const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+      const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference($refBaseURI);
 
       // possibly non-semantic fragment
-      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(reference.value.result, jsonPointer);
+      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
 
       // applying semantics to a fragment
       const referencedElementType = referencingElement.meta.get('referenced-element');
-      if (referencedElement.element !== referencedElementType && !(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isReferenceElement)(referencedElement)) {
+      if (referencedElement.element !== referencedElementType && !(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isReferenceElement)(referencedElement)) {
         if (this.refractCache.has(referencedElement)) {
           referencedElement = this.refractCache.get(referencedElement);
-        } else if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isReferenceLikeElement)(referencedElement)) {
+        } else if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.isReferenceLikeElement)(referencedElement)) {
           // handling generic indirect references
           const sourceElement = referencedElement;
-          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.refractReference)(referencedElement);
+          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.refractReference)(referencedElement);
           referencedElement.meta.set('referenced-element', referencedElementType);
           this.refractCache.set(sourceElement, referencedElement);
         } else {
           // handling direct references
           const sourceElement = referencedElement;
-          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__["default"])(referencedElement, {
+          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__["default"])(referencedElement, {
             element: referencedElementType
           });
           this.refractCache.set(sourceElement, referencedElement);
@@ -8657,14 +9206,14 @@ class OpenAPI3_1DereferenceVisitor {
 
       // detect direct or indirect reference
       if (referencingElement === referencedElement) {
-        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('Recursive Reference Object detected', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Reference Object detected', {
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
         });
       }
 
       // detect maximum depth of dereferencing
       if (this.indirections.length > this.options.dereference.maxDepth) {
-        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
+        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_21__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
           maxDepth: this.options.dereference.maxDepth,
           uri: this.reference.uri
         });
@@ -8675,14 +9224,14 @@ class OpenAPI3_1DereferenceVisitor {
       if (ancestorsLineage.includes(referencedElement)) {
         reference.refSet.circular = true;
         if (this.options.dereference.circular === 'error') {
-          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('Circular reference detected', {
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected', {
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
           });
         } else if (this.options.dereference.circular === 'replace') {
-          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"]($refBaseURI, {
+          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"]($refBaseURI, {
             type: referencingElement.element,
             uri: reference.uri,
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
           });
           const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
@@ -8701,9 +9250,9 @@ class OpenAPI3_1DereferenceVisitor {
        *  3. Fragment is a Reference Object. We need to follow it to get the eventual value
        *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
        */
-      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
       const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-      if ((isExternalReference || isNonEntryDocument || (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isReferenceElement)(referencedElement) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
+      if ((isExternalReference || isNonEntryDocument || (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isReferenceElement)(referencedElement) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
         if (shouldDetectCircular) {
           this.visited.add(referencedElement);
         }
@@ -8713,10 +9262,11 @@ class OpenAPI3_1DereferenceVisitor {
           indirections: [...this.indirections],
           options: this.options,
           refractCache: this.refractCache,
+          schema$idIndex: this.schema$idIndex,
           visited: this.visited,
           ancestors: ancestorsLineage
         });
-        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.traverseAsync)(referencedElement, visitor, {
+        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.traverseAsync)(referencedElement, visitor, {
           mutable: true,
           skipVisited: 'skip'
         });
@@ -8726,14 +9276,14 @@ class OpenAPI3_1DereferenceVisitor {
       /**
        * Creating a new version of referenced element to avoid modifying the original one.
        */
-      const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(referencedElement);
+      const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(referencedElement);
       // annotate fragment with info about original Reference element
       mergedElement.meta.set('ref-fields', {
-        $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref),
+        $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref),
         // @ts-ignore
-        description: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.description),
+        description: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.description),
         // @ts-ignore
-        summary: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.summary)
+        summary: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.summary)
       });
       // annotate fragment with info about origin and type
       mergedElement.meta.set('ref-origin', reference.uri);
@@ -8741,7 +9291,7 @@ class OpenAPI3_1DereferenceVisitor {
 
       // override description and summary (outer has higher priority then inner)
       if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isObjectElement)(referencedElement) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isObjectElement)(mergedElement)) {
-        const fields = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_6__.fixedFields)(referencedElement, {
+        const fields = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__.fixedFields)(referencedElement, {
           indexed: true
         });
         if (referencingElement.hasKey('description') && Object.hasOwn(fields, 'description')) {
@@ -8759,7 +9309,7 @@ class OpenAPI3_1DereferenceVisitor {
        */
       path.replaceWith(mergedElement);
     } catch (error) {
-      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref);
+      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Reference Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
     } finally {
       if (this.indirections.length > indirectionsSize) this.indirections.pop();
@@ -8778,8 +9328,8 @@ class OpenAPI3_1DereferenceVisitor {
       path.skip();
       return;
     }
-    const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref));
-    const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === retrievalURI;
+    const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref));
+    const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === retrievalURI;
     const isExternalReference = !isInternalReference;
 
     // ignore resolving internal Path Item Objects
@@ -8792,37 +9342,37 @@ class OpenAPI3_1DereferenceVisitor {
       // skip traversing this Path Item element but traverse all it's child elements
       return;
     }
-    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref));
+    const $refBaseURI = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.resolve(retrievalURI, (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref));
     const indirectionsSize = this.indirections.length;
     try {
-      const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref));
+      const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref));
       this.indirections.push(referencingElement);
-      const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+      const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference($refBaseURI);
 
       // possibly non-semantic referenced element
-      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(reference.value.result, jsonPointer);
+      let referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
 
       // applying semantics to a referenced element
-      if (!(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isPathItemElement)(referencedElement)) {
+      if (!(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isPathItemElement)(referencedElement)) {
         if (this.refractCache.has(referencedElement)) {
           referencedElement = this.refractCache.get(referencedElement);
         } else {
           const sourceElement = referencedElement;
-          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.refractPathItem)(referencedElement);
+          referencedElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.refractPathItem)(referencedElement);
           this.refractCache.set(sourceElement, referencedElement);
         }
       }
 
       // detect direct or indirect reference
       if (referencingElement === referencedElement) {
-        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('Recursive Path Item Object reference detected', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Path Item Object reference detected', {
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
         });
       }
 
       // detect maximum depth of dereferencing
       if (this.indirections.length > this.options.dereference.maxDepth) {
-        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
+        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_21__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
           maxDepth: this.options.dereference.maxDepth,
           uri: this.reference.uri
         });
@@ -8833,14 +9383,14 @@ class OpenAPI3_1DereferenceVisitor {
       if (ancestorsLineage.includes(referencedElement)) {
         reference.refSet.circular = true;
         if (this.options.dereference.circular === 'error') {
-          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('Circular reference detected', {
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected', {
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
           });
         } else if (this.options.dereference.circular === 'replace') {
-          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"]($refBaseURI, {
+          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"]($refBaseURI, {
             type: referencingElement.element,
             uri: reference.uri,
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
           });
           const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
@@ -8859,9 +9409,9 @@ class OpenAPI3_1DereferenceVisitor {
        *  3. Fragment is a Path Item Object with $ref field. We need to follow it to get the eventual value
        *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
        */
-      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
       const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-      if ((isExternalReference || isNonEntryDocument || (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isPathItemElement)(referencedElement) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(referencedElement.$ref) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
+      if ((isExternalReference || isNonEntryDocument || (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isPathItemElement)(referencedElement) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(referencedElement.$ref) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
         if (shouldDetectCircular) {
           this.visited.add(referencedElement);
         }
@@ -8871,10 +9421,11 @@ class OpenAPI3_1DereferenceVisitor {
           indirections: [...this.indirections],
           options: this.options,
           refractCache: this.refractCache,
+          schema$idIndex: this.schema$idIndex,
           visited: this.visited,
           ancestors: ancestorsLineage
         });
-        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.traverseAsync)(referencedElement, visitor, {
+        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.traverseAsync)(referencedElement, visitor, {
           mutable: true,
           skipVisited: 'skip'
         });
@@ -8884,18 +9435,18 @@ class OpenAPI3_1DereferenceVisitor {
       /**
        * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
        */
-      if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isPathItemElement)(referencedElement)) {
-        const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(referencedElement);
+      if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isPathItemElement)(referencedElement)) {
+        const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(referencedElement);
         // existing keywords from referencing PathItemElement overrides ones from referenced element
         referencingElement.forEach((value, keyElement, item) => {
-          mergedElement.remove((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(keyElement));
+          mergedElement.remove((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(keyElement));
           mergedElement.content.push(item);
         });
         mergedElement.remove('$ref');
 
         // annotate referenced element with info about original referencing element
         mergedElement.meta.set('ref-fields', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
         });
         // annotate referenced element with info about origin and type
         mergedElement.meta.set('ref-origin', reference.uri);
@@ -8908,7 +9459,7 @@ class OpenAPI3_1DereferenceVisitor {
        */
       path.replaceWith(referencedElement);
     } catch (error) {
-      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref);
+      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Path Item Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
     } finally {
       if (this.indirections.length > indirectionsSize) this.indirections.pop();
@@ -8924,18 +9475,18 @@ class OpenAPI3_1DereferenceVisitor {
 
     // operationRef and operationId fields are mutually exclusive
     if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(linkElement.operationRef) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(linkElement.operationId)) {
-      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('LinkElement operationRef and operationId fields are mutually exclusive', {
-        operationRef: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationRef),
-        operationId: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationId)
+      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('LinkElement operationRef and operationId fields are mutually exclusive', {
+        operationRef: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationRef),
+        operationId: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationId)
       });
     }
     try {
       let operationElement;
       if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(linkElement.operationRef)) {
         // possibly non-semantic referenced element
-        const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationRef));
-        const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationRef));
-        const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === retrievalURI;
+        const jsonPointer = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationRef));
+        const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationRef));
+        const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === retrievalURI;
         const isExternalReference = !isInternalReference;
 
         // ignore resolving internal Operation Object reference
@@ -8948,24 +9499,24 @@ class OpenAPI3_1DereferenceVisitor {
           // skip traversing this Link element but traverse all it's child elements
           return;
         }
-        const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationRef));
-        operationElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(reference.value.result, jsonPointer);
+        const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationRef));
+        operationElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
         // applying semantics to a referenced element
-        if (!(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isOperationElement)(operationElement)) {
+        if (!(0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isOperationElement)(operationElement)) {
           if (this.refractCache.has(operationElement)) {
             operationElement = this.refractCache.get(operationElement);
           } else {
             const sourceElement = operationElement;
-            operationElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.refractOperation)(operationElement);
+            operationElement = (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.refractOperation)(operationElement);
             this.refractCache.set(sourceElement, operationElement);
           }
         }
         // create shallow clone to be able to annotate with metadata
-        operationElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(operationElement);
+        operationElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(operationElement);
         // annotate operation element with info about origin and type
         operationElement.meta.set('ref-origin', reference.uri);
         operationElement.meta.set('ref-type', linkElement.element);
-        const linkElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(linkElement);
+        const linkElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(linkElement);
         linkElementCopy.operationRef?.meta.set('operation', operationElement);
 
         /**
@@ -8975,17 +9526,17 @@ class OpenAPI3_1DereferenceVisitor {
         return;
       }
       if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(linkElement.operationId)) {
-        const operationId = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationId);
-        const reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_23__.unsanitize(this.reference.uri));
-        const operationPath = (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.find)(reference.value.result, path => (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isOperationElement)(path.node) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isElement)(path.node.operationId) && path.node.operationId.equals(operationId));
+        const operationId = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationId);
+        const reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_25__.unsanitize(this.reference.uri));
+        const operationPath = (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.find)(reference.value.result, path => (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isOperationElement)(path.node) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isElement)(path.node.operationId) && path.node.operationId.equals(operationId));
         operationElement = operationPath?.node;
         // OperationElement not found by its operationId
         if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_2__["default"])(operationElement)) {
-          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"](`OperationElement(operationId=${operationId}) not found`, {
+          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"](`OperationElement(operationId=${operationId}) not found`, {
             operationId
           });
         }
-        const linkElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(linkElement);
+        const linkElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(linkElement);
         linkElementCopy.operationId?.meta.set('operation', operationElement);
 
         /**
@@ -8995,7 +9546,7 @@ class OpenAPI3_1DereferenceVisitor {
       }
     } catch (error) {
       const refFieldName = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(linkElement.operationRef) ? 'operationRef' : 'operationId';
-      const refFieldValue = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(linkElement.operationRef) ? (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationRef) : (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(linkElement.operationId);
+      const refFieldValue = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(linkElement.operationRef) ? (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationRef) : (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(linkElement.operationId);
       this.handleError(`Error while dereferencing Link Object. Cannot resolve ${refFieldName} "${refFieldValue}": ${error.message}`, error, linkElement, refFieldName, refFieldValue, path);
     }
   }
@@ -9009,13 +9560,13 @@ class OpenAPI3_1DereferenceVisitor {
 
     // value and externalValue fields are mutually exclusive
     if (exampleElement.hasKey('value') && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(exampleElement.externalValue)) {
-      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('ExampleElement value and externalValue fields are mutually exclusive', {
-        value: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.value),
-        externalValue: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.externalValue)
+      throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('ExampleElement value and externalValue fields are mutually exclusive', {
+        value: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.value),
+        externalValue: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.externalValue)
       });
     }
-    const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.externalValue));
-    const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === retrievalURI;
+    const retrievalURI = this.toBaseURI((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.externalValue));
+    const isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === retrievalURI;
     const isExternalReference = !isInternalReference;
 
     // ignore resolving internal Example Objects
@@ -9029,14 +9580,14 @@ class OpenAPI3_1DereferenceVisitor {
       return;
     }
     try {
-      const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.externalValue));
+      const reference = await this.toReference((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.externalValue));
 
       // shallow clone of the referenced element
-      const valueElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(reference.value.result);
+      const valueElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(reference.value.result);
       // annotate element with info about origin and type
       valueElement.meta.set('ref-origin', reference.uri);
       valueElement.meta.set('ref-type', exampleElement.element);
-      const exampleElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(exampleElement);
+      const exampleElementCopy = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(exampleElement);
       exampleElementCopy.value = valueElement;
 
       /**
@@ -9044,7 +9595,7 @@ class OpenAPI3_1DereferenceVisitor {
        */
       path.replaceWith(exampleElementCopy);
     } catch (error) {
-      const externalValue = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(exampleElement.externalValue);
+      const externalValue = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(exampleElement.externalValue);
       this.handleError(`Error while dereferencing Example Object. Cannot resolve externalValue "${externalValue}": ${error.message}`, error, exampleElement, 'externalValue', externalValue, path);
     }
   }
@@ -9064,30 +9615,69 @@ class OpenAPI3_1DereferenceVisitor {
     const indirectionsSize = this.indirections.length;
     try {
       // compute baseURI using rules around $id and $ref keywords
-      let reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_23__.unsanitize(this.reference.uri));
+      let reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_25__.unsanitize(this.reference.uri));
       let {
         uri: retrievalURI
       } = reference;
-      const $refBaseURI = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.resolveSchema$refField)(retrievalURI, referencingElement);
-      const $refBaseURIStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash($refBaseURI);
-      const file = new _File_ts__WEBPACK_IMPORTED_MODULE_26__["default"]({
+      // base URI in effect at the traversal root: the document base refined by
+      // the $ids of the schemas enclosing the root when the root is a fragment
+      const rootBaseURI = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.resolveSchema$ids)(retrievalURI, this.ancestorSchema$ids);
+      const schemaBaseURI = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.resolveSchemaBaseURI)(rootBaseURI, path);
+      const $refBaseURI = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.resolveSchema$refField)(schemaBaseURI, referencingElement);
+      const $refBaseURIStrippedHash = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash($refBaseURI);
+      const file = new _File_ts__WEBPACK_IMPORTED_MODULE_28__["default"]({
         uri: $refBaseURIStrippedHash
       });
       const isUnknownURI = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(r => r.canRead(file), this.options.resolve.resolvers);
       const isURL = !isUnknownURI;
-      let isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === $refBaseURI;
+      let isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === $refBaseURI;
       let isExternalReference = !isInternalReference;
 
       // determining reference, proper evaluation and selection mechanism
       let referencedElement;
+      // $ids of the schemas enclosing the referenced element within its document
+      let ancestorSchema$ids;
       try {
         if (isUnknownURI || isURL) {
           // we're dealing with canonical URI or URL with possible fragment
           retrievalURI = this.toBaseURI($refBaseURI);
           const selector = $refBaseURI;
-          const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(reference.value.result);
-          referencedElement = (0,_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_18__.evaluate)(selector, referenceAsSchema);
-          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(referencedElement);
+          // the fragment being traversed is searched before the whole document: a
+          // fragment referenced from another document (a Response, Parameter, Path
+          // Item, ...) is refracted with its own semantics, so the Schema Objects it
+          // contains are indexed, whereas the referenced document as a whole is
+          // parsed generically and refracted as a bare JSON Schema, which leaves
+          // those Schema Objects (under `content`, `schema`, ...) unrecognized and
+          // their `$id`s out of the index
+          const documentElement = reference.value.result;
+          const rootNode = path.getAncestorNodes().at(-1) ?? path.node;
+          const fragmentElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.isParseResultElement)(rootNode) ? rootNode.result : rootNode;
+          try {
+            // the fragment's $ids resolve against the base its enclosing chain
+            // leaves in effect, which then also prefixes the located schema's chain
+            ({
+              element: referencedElement,
+              ancestorSchema$ids
+            } = (0,_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_19__.locate)(selector, (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(fragmentElement), {
+              baseURI: rootBaseURI,
+              index: this.schema$idIndex
+            }));
+            ancestorSchema$ids = [...this.ancestorSchema$ids, ...ancestorSchema$ids];
+          } catch (error) {
+            if (!(error instanceof _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_24__["default"]) || fragmentElement === documentElement) {
+              throw error;
+            }
+            // the document index is rooted at the document, so the located chain
+            // is already document-relative and takes no prefix
+            ({
+              element: referencedElement,
+              ancestorSchema$ids
+            } = (0,_selectors_uri_ts__WEBPACK_IMPORTED_MODULE_19__.locate)(selector, (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(documentElement), {
+              baseURI: reference.uri,
+              index: this.schema$idIndex
+            }));
+          }
+          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(referencedElement);
 
           // ignore resolving internal Schema Objects
           if (!this.options.resolve.internal && isInternalReference) {
@@ -9102,7 +9692,7 @@ class OpenAPI3_1DereferenceVisitor {
         } else {
           // we're assuming here that we're dealing with JSON Pointer here
           retrievalURI = this.toBaseURI($refBaseURI);
-          isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === retrievalURI;
+          isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === retrievalURI;
           isExternalReference = !isInternalReference;
 
           // ignore resolving internal Schema Objects
@@ -9115,21 +9705,24 @@ class OpenAPI3_1DereferenceVisitor {
             // skip traversing this schema element but traverse all it's child elements
             return;
           }
-          reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_23__.unsanitize($refBaseURI));
-          const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference($refBaseURI);
-          const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(reference.value.result);
-          referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(referenceAsSchema, selector);
-          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(referencedElement);
+          reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_25__.unsanitize($refBaseURI));
+          const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+          const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(reference.value.result);
+          ({
+            element: referencedElement,
+            ancestorSchema$ids
+          } = (0,_selectors_json_pointer_ts__WEBPACK_IMPORTED_MODULE_20__.locate)(referenceAsSchema, selector));
+          referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(referencedElement);
         }
       } catch (error) {
         /**
          * 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_ts__WEBPACK_IMPORTED_MODULE_22__["default"]) {
-          if ((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_17__.isAnchor)((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_17__.uriToAnchor)($refBaseURI))) {
+        if (isURL && error instanceof _errors_EvaluationJsonSchemaUriError_ts__WEBPACK_IMPORTED_MODULE_24__["default"]) {
+          if ((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_18__.isAnchor)((0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_18__.uriToAnchor)($refBaseURI))) {
             // we're dealing with JSON Schema $anchor here
-            isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === retrievalURI;
+            isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === retrievalURI;
             isExternalReference = !isInternalReference;
 
             // ignore resolving internal Schema Objects
@@ -9142,15 +9735,18 @@ class OpenAPI3_1DereferenceVisitor {
               // skip traversing this schema element but traverse all it's child elements
               return;
             }
-            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_23__.unsanitize($refBaseURI));
-            const selector = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_17__.uriToAnchor)($refBaseURI);
-            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(reference.value.result);
-            referencedElement = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_17__.evaluate)(selector, referenceAsSchema);
-            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(referencedElement);
+            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_25__.unsanitize($refBaseURI));
+            const selector = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_18__.uriToAnchor)($refBaseURI);
+            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(reference.value.result);
+            ({
+              element: referencedElement,
+              ancestorSchema$ids
+            } = (0,_selectors_$anchor_ts__WEBPACK_IMPORTED_MODULE_18__.locate)(selector, referenceAsSchema));
+            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(referencedElement);
           } else {
             // we're assuming here that we're dealing with JSON Pointer here
             retrievalURI = this.toBaseURI($refBaseURI);
-            isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(this.reference.uri) === retrievalURI;
+            isInternalReference = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(this.reference.uri) === retrievalURI;
             isExternalReference = !isInternalReference;
 
             // ignore resolving internal Schema Objects
@@ -9163,11 +9759,14 @@ class OpenAPI3_1DereferenceVisitor {
               // skip traversing this schema element but traverse all it's child elements
               return;
             }
-            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_23__.unsanitize($refBaseURI));
-            const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_12__.URIFragmentIdentifier.fromURIReference($refBaseURI);
-            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(reference.value.result);
-            referencedElement = (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_11__.evaluate)(referenceAsSchema, selector);
-            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_27__.maybeRefractToSchemaElement)(referencedElement);
+            reference = await this.toReference(_util_url_ts__WEBPACK_IMPORTED_MODULE_25__.unsanitize($refBaseURI));
+            const selector = _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_13__.URIFragmentIdentifier.fromURIReference($refBaseURI);
+            const referenceAsSchema = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(reference.value.result);
+            ({
+              element: referencedElement,
+              ancestorSchema$ids
+            } = (0,_selectors_json_pointer_ts__WEBPACK_IMPORTED_MODULE_20__.locate)(referenceAsSchema, selector));
+            referencedElement = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.maybeRefractToSchemaElement)(referencedElement);
           }
         } else {
           throw error;
@@ -9177,14 +9776,14 @@ class OpenAPI3_1DereferenceVisitor {
 
       // detect direct or indirect reference
       if (referencingElement === referencedElement) {
-        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('Recursive Schema Object reference detected', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+        throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Schema Object reference detected', {
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
         });
       }
 
       // detect maximum depth of dereferencing
       if (this.indirections.length > this.options.dereference.maxDepth) {
-        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
+        throw new _errors_MaximumDereferenceDepthError_ts__WEBPACK_IMPORTED_MODULE_21__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`, {
           maxDepth: this.options.dereference.maxDepth,
           uri: this.reference.uri
         });
@@ -9195,14 +9794,14 @@ class OpenAPI3_1DereferenceVisitor {
       if (ancestorsLineage.includes(referencedElement)) {
         reference.refSet.circular = true;
         if (this.options.dereference.circular === 'error') {
-          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_9__["default"]('Circular reference detected', {
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+          throw new _speclynx_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected', {
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
           });
         } else if (this.options.dereference.circular === 'replace') {
-          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"]($refBaseURI, {
+          const refElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"]($refBaseURI, {
             type: referencingElement.element,
             uri: reference.uri,
-            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+            $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
           });
           const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
           const replacement = replacer(refElement);
@@ -9221,9 +9820,13 @@ class OpenAPI3_1DereferenceVisitor {
        *  3. Fragment is a Schema Object with $ref field. We need to follow it to get the eventual value
        *  4. We are dereferencing the fragment lazily/eagerly depending on circular mode
        */
-      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_23__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
+      const isNonEntryDocument = _util_url_ts__WEBPACK_IMPORTED_MODULE_25__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
       const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-      if ((isExternalReference || isNonEntryDocument || (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isSchemaElement)(referencedElement) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(referencedElement.$ref) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
+      // content transplanted into the referencing site is traversed under that
+      // site's $id chain; a fragment enclosed by a different chain has its own
+      // $refs resolved in place first, by a nested visitor seeded with that chain
+      const hasDifferentEnclosingBase = (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.resolveSchema$ids)(reference.uri, ancestorSchema$ids) !== (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.resolveSchema$ids)(rootBaseURI, (0,_util_ts__WEBPACK_IMPORTED_MODULE_29__.schema$idsOf)(path.getAncestorNodes().reverse()));
+      if ((isExternalReference || isNonEntryDocument || hasDifferentEnclosingBase || (0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isSchemaElement)(referencedElement) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__.isStringElement)(referencedElement.$ref) || shouldDetectCircular && !this.visited.has(referencedElement)) && !ancestorsLineage.includesCycle(referencedElement)) {
         if (shouldDetectCircular) {
           this.visited.add(referencedElement);
         }
@@ -9233,10 +9836,12 @@ class OpenAPI3_1DereferenceVisitor {
           indirections: [...this.indirections],
           options: this.options,
           refractCache: this.refractCache,
+          schema$idIndex: this.schema$idIndex,
           visited: this.visited,
-          ancestors: ancestorsLineage
+          ancestors: ancestorsLineage,
+          ancestorSchema$ids
         });
-        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_10__.traverseAsync)(referencedElement, visitor, {
+        referencedElement = await (0,_speclynx_apidom_traverse__WEBPACK_IMPORTED_MODULE_11__.traverseAsync)(referencedElement, visitor, {
           mutable: true,
           skipVisited: 'skip'
         });
@@ -9244,11 +9849,11 @@ class OpenAPI3_1DereferenceVisitor {
       }
 
       // Boolean JSON Schemas
-      if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_13__.isBooleanJSONSchemaElement)(referencedElement)) {
-        const booleanJsonSchemaElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneDeep)(referencedElement);
+      if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isBooleanJSONSchemaElement)(referencedElement)) {
+        const booleanJsonSchemaElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneDeep)(referencedElement);
         // annotate referenced element with info about original referencing element
         booleanJsonSchemaElement.meta.set('ref-fields', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
         });
         // annotate referenced element with info about origin and type
         booleanJsonSchemaElement.meta.set('ref-origin', reference.uri);
@@ -9261,17 +9866,17 @@ class OpenAPI3_1DereferenceVisitor {
       /**
        * Creating a new version of Schema Object by merging fields from referenced Schema Object with referencing one.
        */
-      if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.isSchemaElement)(referencedElement)) {
-        const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.cloneShallow)(referencedElement);
+      if ((0,_speclynx_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_17__.isSchemaElement)(referencedElement)) {
+        const mergedElement = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__.cloneShallow)(referencedElement);
         // existing keywords from referencing schema overrides ones from referenced schema
         referencingElement.forEach((value, keyElement, item) => {
-          mergedElement.remove((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(keyElement));
+          mergedElement.remove((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(keyElement));
           mergedElement.content.push(item);
         });
         mergedElement.remove('$ref');
         // annotate referenced element with info about original referencing element
         mergedElement.meta.set('ref-fields', {
-          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref)
+          $ref: (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref)
         });
         // annotate fragment with info about origin and type
         mergedElement.meta.set('ref-origin', reference.uri);
@@ -9283,7 +9888,7 @@ class OpenAPI3_1DereferenceVisitor {
        */
       path.replaceWith(referencedElement);
     } catch (error) {
-      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_7__["default"])(referencingElement.$ref);
+      const $ref = (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_8__["default"])(referencingElement.$ref);
       this.handleError(`Error while dereferencing Schema Object. Cannot resolve $ref "${$ref}": ${error.message}`, error, referencingElement, '$ref', $ref, path);
     } finally {
       if (this.indirections.length > indirectionsSize) this.indirections.pop();
@@ -13355,6 +13960,38 @@ const resolve = (from, to) => {
   return resolvedUrl.toString();
 };
 
+/**
+ * Computes the URI reference that resolves to `to` against `from` — the inverse
+ * of `resolve`: `resolve(from, relative(from, to)) === to`. The reference is
+ * relative to the directory of `from` (its last path segment is the document,
+ * not a directory). When the two URIs differ in scheme or authority, or either
+ * has no hierarchical path (e.g. a URN), no relative form exists and `to` is
+ * returned unchanged.
+ * @public
+ */
+const relative = (from, to) => {
+  const fromURL = new URL(from, 'resolve://');
+  const toURL = new URL(to, 'resolve://');
+
+  // the authority is host plus userinfo; a relative reference keeps both from `from`
+  if (fromURL.protocol !== toURL.protocol || fromURL.host !== toURL.host || fromURL.username !== toURL.username || fromURL.password !== toURL.password || !fromURL.pathname.startsWith('/') || !toURL.pathname.startsWith('/')) {
+    return to;
+  }
+  const fromSegments = fromURL.pathname.split('/').slice(0, -1);
+  const toSegments = toURL.pathname.split('/');
+  let common = 0;
+  while (common < fromSegments.length && common < toSegments.length - 1 && fromSegments[common] === toSegments[common]) {
+    common += 1;
+  }
+  const segments = [...fromSegments.slice(common).map(() => '..'), ...toSegments.slice(common)];
+  // a leading segment with a colon would be parsed as a scheme, and an empty
+  // reference (`to` is the directory of `from`) would resolve back to `from`
+  if (segments[0].includes(':') || segments.join('/') === '') {
+    segments.unshift('.');
+  }
+  return segments.join('/') + toURL.search + toURL.hash;
+};
+
 /**
  * Sanitizes/Encodes URI to it's url encoded form.
  *
@@ -13400,6 +14037,7 @@ const unsanitize = uri => {
 /* harmony export */   "isFileSystemPath", 0, /* binding */ isFileSystemPath,
 /* harmony export */   "isHttpUrl", 0, /* binding */ isHttpUrl,
 /* harmony export */   "isURI", 0, /* binding */ isURI,
+/* harmony export */   "relative", 0, /* binding */ relative,
 /* harmony export */   "resolve", 0, /* binding */ resolve,
 /* harmony export */   "sanitize", 0, /* binding */ sanitize,
 /* harmony export */   "stripHash", 0, /* binding */ stripHash,