@speclynx/apidom-reference 5.2.4 → 5.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-reference",
-  "version": "5.2.4",
+  "version": "5.2.5",
   "description": "Advanced algorithms for semantic ApiDOM manipulations like dereferencing or resolution.",
   "keywords": [
     "apidom",
@@ -299,32 +299,32 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^8.0.0",
-    "@speclynx/apidom-core": "5.2.4",
-    "@speclynx/apidom-datamodel": "5.2.4",
-    "@speclynx/apidom-error": "5.2.4",
-    "@speclynx/apidom-json-pointer": "5.2.4",
-    "@speclynx/apidom-ns-arazzo-1": "5.2.4",
-    "@speclynx/apidom-ns-asyncapi-2": "5.2.4",
-    "@speclynx/apidom-ns-json-schema-2020-12": "5.2.4",
-    "@speclynx/apidom-ns-openapi-2": "5.2.4",
-    "@speclynx/apidom-ns-openapi-3-0": "5.2.4",
-    "@speclynx/apidom-ns-openapi-3-1": "5.2.4",
-    "@speclynx/apidom-ns-overlay-1": "5.2.4",
-    "@speclynx/apidom-parser-adapter-arazzo-json-1": "5.2.4",
-    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "5.2.4",
-    "@speclynx/apidom-parser-adapter-asyncapi-json-2": "5.2.4",
-    "@speclynx/apidom-parser-adapter-asyncapi-yaml-2": "5.2.4",
-    "@speclynx/apidom-parser-adapter-json": "5.2.4",
-    "@speclynx/apidom-parser-adapter-openapi-json-2": "5.2.4",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "5.2.4",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "5.2.4",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "5.2.4",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "5.2.4",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "5.2.4",
-    "@speclynx/apidom-parser-adapter-overlay-json-1": "5.2.4",
-    "@speclynx/apidom-parser-adapter-overlay-yaml-1": "5.2.4",
-    "@speclynx/apidom-parser-adapter-yaml-1-2": "5.2.4",
-    "@speclynx/apidom-traverse": "5.2.4",
+    "@speclynx/apidom-core": "5.2.5",
+    "@speclynx/apidom-datamodel": "5.2.5",
+    "@speclynx/apidom-error": "5.2.5",
+    "@speclynx/apidom-json-pointer": "5.2.5",
+    "@speclynx/apidom-ns-arazzo-1": "5.2.5",
+    "@speclynx/apidom-ns-asyncapi-2": "5.2.5",
+    "@speclynx/apidom-ns-json-schema-2020-12": "5.2.5",
+    "@speclynx/apidom-ns-openapi-2": "5.2.5",
+    "@speclynx/apidom-ns-openapi-3-0": "5.2.5",
+    "@speclynx/apidom-ns-openapi-3-1": "5.2.5",
+    "@speclynx/apidom-ns-overlay-1": "5.2.5",
+    "@speclynx/apidom-parser-adapter-arazzo-json-1": "5.2.5",
+    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "5.2.5",
+    "@speclynx/apidom-parser-adapter-asyncapi-json-2": "5.2.5",
+    "@speclynx/apidom-parser-adapter-asyncapi-yaml-2": "5.2.5",
+    "@speclynx/apidom-parser-adapter-json": "5.2.5",
+    "@speclynx/apidom-parser-adapter-openapi-json-2": "5.2.5",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "5.2.5",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "5.2.5",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "5.2.5",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "5.2.5",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "5.2.5",
+    "@speclynx/apidom-parser-adapter-overlay-json-1": "5.2.5",
+    "@speclynx/apidom-parser-adapter-overlay-yaml-1": "5.2.5",
+    "@speclynx/apidom-parser-adapter-yaml-1-2": "5.2.5",
+    "@speclynx/apidom-traverse": "5.2.5",
     "@swaggerexpert/arazzo-runtime-expression": "^3.2.0",
     "axios": "^1.20.0",
     "picomatch": "^4.0.7",
@@ -346,5 +346,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "5b467dbfe42b1989fe64b4a83c226274de24d783"
+  "gitHead": "677f42e6af4e7b5311c74cd054283c943f8700a9"
 }

package/src/bundle/strategies/arazzo-1/visitor.cjs

@@ -34,6 +34,12 @@ const cf = (0, _apidomCore.fixedFields)(_apidomNsArazzo.ComponentsElement, {
   indexed: true
 });
 
+/**
+ * A bundled JSON Schema resource awaiting placement into the entry document's
+ * `components.inputs`.
+ * @public
+ */
+
 /**
  * @public
  */
@@ -81,17 +87,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, _util.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, _util.resolveArazzo$selfField)(url.stripHash(this.reference.refSet.rootRef.uri), this.entryResult);
   }
   toBaseURI(uri) {
     return url.resolve(this.baseURI, url.sanitize(url.stripHash(uri)));
@@ -243,14 +279,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, _apidomDatamodel.isObjectElement)(components) ? components.get(field) : undefined;
     const reserved = this.reservedNames.get(field) ?? new Set();
-    return (0, _util2.uniqueName)(candidate, name => inputs.hasKey(name) || reserved.has(name));
+    return (0, _util2.uniqueName)(candidate, name => (0, _apidomDatamodel.isObjectElement)(inputs) && inputs.hasKey(name) || reserved.has(name));
   }
 
   /**
@@ -275,14 +314,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;
@@ -297,7 +358,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, _util.resolveSchema$refField)(this.baseURI, referencingElement);
+      const schemaBaseURI = (0, _util.resolveSchemaBaseURI)(this.baseURI, path);
+      const $refBaseURI = (0, _util.resolveSchema$refField)(schemaBaseURI, referencingElement);
       const $refBaseURIStrippedHash = url.stripHash($refBaseURI);
       const file = new _File.default({
         uri: $refBaseURIStrippedHash
@@ -335,7 +397,10 @@ class Arazzo1BundleVisitor {
       let schemaReference = this.reference;
       try {
         const referenceAsSchema = (0, _util.maybeRefractToJSONSchemaElement)(schemaReference.value.result);
-        (0, _uri.evaluate)($refBaseURI, referenceAsSchema);
+        (0, _uri.evaluate)($refBaseURI, referenceAsSchema, {
+          baseURI: this.baseURI,
+          index: this.schema$idIndex
+        });
       } catch (error) {
         if (isURL && error instanceof _EvaluationJsonSchemaUriError.default) {
           if ((0, _$anchor.isAnchor)((0, _$anchor.uriToAnchor)($refBaseURI))) {
@@ -374,20 +439,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, _util2.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, _apidomDatamodel.cloneDeep)(resourceRoot);
-      if (!(0, _apidomDatamodel.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
@@ -407,22 +475,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, _apidomTraverse.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, _apidomDatamodel.isStringElement)(bundledElement.$id)) {
+        bundledElement.set('$id', url.relative(this.entryBaseURI, resourceBaseURI));
+      }
+
       // annotate the embedded resource with info about its origin
       if ((0, _apidomDatamodel.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);

package/src/bundle/strategies/arazzo-1/visitor.mjs

@@ -15,8 +15,8 @@ import Reference from "../../../Reference.mjs";
 import File from "../../../File.mjs";
 import { isAnchor, uriToAnchor, evaluate as $anchorEvaluate } from "../../../dereference/strategies/arazzo-1/selectors/$anchor.mjs";
 import { evaluate as uriEvaluate } from "../../../dereference/strategies/arazzo-1/selectors/uri.mjs";
-import { resolveSchema$refField, resolveSchema$idField, maybeRefractToJSONSchemaElement, resolveArazzo$selfField, identifiedBy$self } from "../../../dereference/strategies/arazzo-1/util.mjs";
-import { toPascalCase, sanitizeComponentName, uniqueName as resolveUniqueName } from "../../util.mjs";
+import { resolveSchema$refField, resolveSchema$idField, resolveSchemaBaseURI, maybeRefractToJSONSchemaElement, resolveArazzo$selfField, identifiedBy$self } from "../../../dereference/strategies/arazzo-1/util.mjs";
+import { rebaseSchema$ref, sanitizeComponentName, toPascalCase, uniqueName as resolveUniqueName } from "../../util.mjs";
 /**
  * The Components Object field where embedded JSON Schema resources are hoisted.
  * Sourced from the Components Object fixed fields so it cannot drift from the
@@ -26,6 +26,12 @@ const cf = fixedFields(ComponentsElement, {
   indexed: true
 });
 
+/**
+ * A bundled JSON Schema resource awaiting placement into the entry document's
+ * `components.inputs`.
+ * @public
+ */
+
 /**
  * @public
  */
@@ -73,17 +79,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 = 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 resolveArazzo$selfField(url.stripHash(this.reference.refSet.rootRef.uri), this.entryResult);
   }
   toBaseURI(uri) {
     return url.resolve(this.baseURI, url.sanitize(url.stripHash(uri)));
@@ -235,14 +271,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 = isObjectElement(components) ? components.get(field) : undefined;
     const reserved = this.reservedNames.get(field) ?? new Set();
-    return resolveUniqueName(candidate, name => inputs.hasKey(name) || reserved.has(name));
+    return resolveUniqueName(candidate, name => isObjectElement(inputs) && inputs.hasKey(name) || reserved.has(name));
   }
 
   /**
@@ -267,14 +306,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;
@@ -289,7 +350,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 = resolveSchema$refField(this.baseURI, referencingElement);
+      const schemaBaseURI = resolveSchemaBaseURI(this.baseURI, path);
+      const $refBaseURI = resolveSchema$refField(schemaBaseURI, referencingElement);
       const $refBaseURIStrippedHash = url.stripHash($refBaseURI);
       const file = new File({
         uri: $refBaseURIStrippedHash
@@ -327,7 +389,10 @@ class Arazzo1BundleVisitor {
       let schemaReference = this.reference;
       try {
         const referenceAsSchema = maybeRefractToJSONSchemaElement(schemaReference.value.result);
-        uriEvaluate($refBaseURI, referenceAsSchema);
+        uriEvaluate($refBaseURI, referenceAsSchema, {
+          baseURI: this.baseURI,
+          index: this.schema$idIndex
+        });
       } catch (error) {
         if (isURL && error instanceof EvaluationJsonSchemaUriError) {
           if (isAnchor(uriToAnchor($refBaseURI))) {
@@ -366,20 +431,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 = 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 = cloneDeep(resourceRoot);
-      if (!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
@@ -399,22 +467,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 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 (!isStringElement(bundledElement.$id)) {
+        bundledElement.set('$id', url.relative(this.entryBaseURI, resourceBaseURI));
+      }
+
       // annotate the embedded resource with info about its origin
       if (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);