@speclynx/apidom-reference 1.12.1 → 2.0.1

package/src/dereference/strategies/openapi-3-1/visitor.cjs

@@ -3,11 +3,13 @@
 var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
 var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
-exports.mutationReplacer = exports.default = void 0;
+exports.default = void 0;
 var _ramda = require("ramda");
 var _ramdaAdjunct = require("ramda-adjunct");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
 var _apidomCore = require("@speclynx/apidom-core");
 var _apidomError = require("@speclynx/apidom-error");
+var _apidomTraverse = require("@speclynx/apidom-traverse");
 var _apidomJsonPointer = require("@speclynx/apidom-json-pointer");
 var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-1");
 var _$anchor = require("./selectors/$anchor.cjs");
@@ -21,28 +23,13 @@ var _File = _interopRequireDefault(require("../../../File.cjs"));
 var _util = require("./util.cjs");
 var _util2 = require("../../util.cjs");
 var _EvaluationJsonSchemaUriError = _interopRequireDefault(require("../../../errors/EvaluationJsonSchemaUriError.cjs"));
-// @ts-ignore
-const visitAsync = _apidomCore.visit[Symbol.for('nodejs.util.promisify.custom')];
-
 // initialize element identity manager
 const identityManager = new _apidomCore.IdentityManager();
 
 /**
- * Custom mutation replacer.
  * @public
  */
-const mutationReplacer = (newElement, oldElement, key, parent) => {
-  if ((0, _apidomCore.isMemberElement)(parent)) {
-    parent.value = newElement;
-  } else if (Array.isArray(parent)) {
-    parent[key] = newElement;
-  }
-};
 
-/**
- * @public
- */
-exports.mutationReplacer = mutationReplacer;
 /**
  * @public
  */
@@ -96,7 +83,7 @@ class OpenAPI3_1DereferenceVisitor {
     // register new mutable reference with a refSet
     const mutableReference = new _Reference.default({
       uri: baseURI,
-      value: (0, _apidomCore.cloneDeep)(parseResult),
+      value: (0, _apidomDatamodel.cloneDeep)(parseResult),
       depth: this.reference.depth + 1
     });
     refSet.add(mutableReference);
@@ -111,21 +98,25 @@ class OpenAPI3_1DereferenceVisitor {
     }
     return mutableReference;
   }
-  toAncestorLineage(ancestors) {
+  toAncestorLineage(path) {
     /**
      * Compute full ancestors lineage.
      * Ancestors are flatten to unwrap all Element instances.
      */
-    const directAncestors = new Set(ancestors.filter(_apidomCore.isElement));
+    const ancestorNodes = path.getAncestorNodes();
+    const directAncestors = new Set(ancestorNodes.filter(_apidomDatamodel.isElement));
     const ancestorsLineage = new _util2.AncestorLineage(...this.ancestors, directAncestors);
     return [ancestorsLineage, directAncestors];
   }
-  async ReferenceElement(referencingElement, key, parent, path, ancestors, link) {
+  async ReferenceElement(path) {
+    const referencingElement = path.node;
+
     // skip current referencing element as it's already been access
     if (this.indirections.includes(referencingElement)) {
-      return false;
+      path.skip();
+      return;
     }
-    const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+    const [ancestorsLineage, directAncestors] = this.toAncestorLineage(path);
     const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(referencingElement.$ref));
     const isInternalReference = url.stripHash(this.reference.uri) === retrievalURI;
     const isExternalReference = !isInternalReference;
@@ -133,12 +124,14 @@ class OpenAPI3_1DereferenceVisitor {
     // ignore resolving internal Reference Objects
     if (!this.options.resolve.internal && isInternalReference) {
       // skip traversing this reference element and all it's child elements
-      return false;
+      path.skip();
+      return;
     }
     // ignore resolving external Reference Objects
     if (!this.options.resolve.external && isExternalReference) {
       // skip traversing this reference element and all it's child elements
-      return false;
+      path.skip();
+      return;
     }
     const reference = await this.toReference((0, _apidomCore.toValue)(referencingElement.$ref));
     const $refBaseURI = url.resolve(retrievalURI, (0, _apidomCore.toValue)(referencingElement.$ref));
@@ -150,20 +143,21 @@ class OpenAPI3_1DereferenceVisitor {
     referencedElement.id = identityManager.identify(referencedElement);
 
     // applying semantics to a fragment
-    if ((0, _apidomCore.isPrimitiveElement)(referencedElement)) {
+    if ((0, _apidomDatamodel.isPrimitiveElement)(referencedElement)) {
       const referencedElementType = (0, _apidomCore.toValue)(referencingElement.meta.get('referenced-element'));
       const cacheKey = `${referencedElementType}-${(0, _apidomCore.toValue)(identityManager.identify(referencedElement))}`;
       if (this.refractCache.has(cacheKey)) {
         referencedElement = this.refractCache.get(cacheKey);
       } else if ((0, _apidomNsOpenapi.isReferenceLikeElement)(referencedElement)) {
         // handling indirect references
-        referencedElement = _apidomNsOpenapi.ReferenceElement.refract(referencedElement);
-        referencedElement.setMetaProperty('referenced-element', referencedElementType);
+        referencedElement = (0, _apidomNsOpenapi.refractReference)(referencedElement);
+        referencedElement.meta.set('referenced-element', referencedElementType);
         this.refractCache.set(cacheKey, referencedElement);
       } else {
         // handling direct references
-        const ElementClass = this.namespace.getElementClass(referencedElementType);
-        referencedElement = ElementClass.refract(referencedElement);
+        referencedElement = (0, _apidomNsOpenapi.refract)(referencedElement, {
+          element: referencedElementType
+        });
         this.refractCache.set(cacheKey, referencedElement);
       }
     }
@@ -184,15 +178,16 @@ class OpenAPI3_1DereferenceVisitor {
       if (this.options.dereference.circular === 'error') {
         throw new _apidomError.ApiDOMError('Circular reference detected');
       } else if (this.options.dereference.circular === 'replace') {
-        const refElement = new _apidomCore.RefElement(referencedElement.id, {
+        const refElement = new _apidomDatamodel.RefElement(referencedElement.id, {
           type: 'reference',
           uri: reference.uri,
           $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
         });
         const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
         const replacement = replacer(refElement);
-        link.replaceWith(replacement, mutationReplacer);
-        return !parent ? replacement : false;
+        this.indirections.pop();
+        path.replaceWith(replacement);
+        return;
       }
     }
 
@@ -218,9 +213,8 @@ class OpenAPI3_1DereferenceVisitor {
         refractCache: this.refractCache,
         ancestors: ancestorsLineage
       });
-      referencedElement = await visitAsync(referencedElement, visitor, {
-        keyMap: _apidomNsOpenapi.keyMap,
-        nodeTypeGetter: _apidomNsOpenapi.getNodeType
+      referencedElement = await (0, _apidomTraverse.traverseAsync)(referencedElement, visitor, {
+        mutable: true
       });
 
       // remove referencing reference from ancestors lineage
@@ -231,11 +225,11 @@ class OpenAPI3_1DereferenceVisitor {
     /**
      * Creating a new version of referenced element to avoid modifying the original one.
      */
-    const mergedElement = (0, _apidomCore.cloneShallow)(referencedElement);
+    const mergedElement = (0, _apidomDatamodel.cloneShallow)(referencedElement);
     // assign unique id to merged element
-    mergedElement.setMetaProperty('id', identityManager.generateId());
+    mergedElement.meta.set('id', identityManager.generateId());
     // annotate fragment with info about original Reference element
-    mergedElement.setMetaProperty('ref-fields', {
+    mergedElement.meta.set('ref-fields', {
       $ref: (0, _apidomCore.toValue)(referencingElement.$ref),
       // @ts-ignore
       description: (0, _apidomCore.toValue)(referencingElement.description),
@@ -243,12 +237,12 @@ class OpenAPI3_1DereferenceVisitor {
       summary: (0, _apidomCore.toValue)(referencingElement.summary)
     });
     // annotate fragment with info about origin
-    mergedElement.setMetaProperty('ref-origin', reference.uri);
+    mergedElement.meta.set('ref-origin', reference.uri);
     // annotate fragment with info about referencing element
-    mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
+    mergedElement.meta.set('ref-referencing-element-id', (0, _apidomDatamodel.cloneDeep)(identityManager.identify(referencingElement)));
 
     // override description and summary (outer has higher priority then inner)
-    if ((0, _apidomCore.isObjectElement)(referencedElement) && (0, _apidomCore.isObjectElement)(mergedElement)) {
+    if ((0, _apidomDatamodel.isObjectElement)(referencedElement) && (0, _apidomDatamodel.isObjectElement)(mergedElement)) {
       if (referencingElement.hasKey('description') && 'description' in referencedElement) {
         mergedElement.remove('description');
         mergedElement.set('description', referencingElement.get('description'));
@@ -262,37 +256,35 @@ class OpenAPI3_1DereferenceVisitor {
     /**
      * Transclude referencing element with merged referenced element.
      */
-    link.replaceWith(mergedElement, mutationReplacer);
-
-    /**
-     * We're at the root of the tree, so we're just replacing the entire tree.
-     */
-    return !parent ? mergedElement : false;
+    path.replaceWith(mergedElement);
   }
-  async PathItemElement(referencingElement, key, parent, path, ancestors, link) {
+  async PathItemElement(path) {
+    const referencingElement = path.node;
+
     // ignore PathItemElement without $ref field
-    if (!(0, _apidomCore.isStringElement)(referencingElement.$ref)) {
-      return undefined;
+    if (!(0, _apidomDatamodel.isStringElement)(referencingElement.$ref)) {
+      return;
     }
 
     // skip current referencing element as it's already been access
     if (this.indirections.includes(referencingElement)) {
-      return false;
+      path.skip();
+      return;
     }
-    const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+    const [ancestorsLineage, directAncestors] = this.toAncestorLineage(path);
     const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(referencingElement.$ref));
     const isInternalReference = url.stripHash(this.reference.uri) === retrievalURI;
     const isExternalReference = !isInternalReference;
 
-    // ignore resolving external Path Item Objects
+    // ignore resolving internal Path Item Objects
     if (!this.options.resolve.internal && isInternalReference) {
       // skip traversing this Path Item element but traverse all it's child elements
-      return undefined;
+      return;
     }
     // ignore resolving external Path Item Objects
     if (!this.options.resolve.external && isExternalReference) {
       // skip traversing this Path Item element but traverse all it's child elements
-      return undefined;
+      return;
     }
     const reference = await this.toReference((0, _apidomCore.toValue)(referencingElement.$ref));
     const $refBaseURI = url.resolve(retrievalURI, (0, _apidomCore.toValue)(referencingElement.$ref));
@@ -306,12 +298,12 @@ class OpenAPI3_1DereferenceVisitor {
     /**
      * Applying semantics to a referenced element if semantics are missing.
      */
-    if ((0, _apidomCore.isPrimitiveElement)(referencedElement)) {
+    if ((0, _apidomDatamodel.isPrimitiveElement)(referencedElement)) {
       const cacheKey = `path-item-${(0, _apidomCore.toValue)(identityManager.identify(referencedElement))}`;
       if (this.refractCache.has(cacheKey)) {
         referencedElement = this.refractCache.get(cacheKey);
       } else {
-        referencedElement = _apidomNsOpenapi.PathItemElement.refract(referencedElement);
+        referencedElement = (0, _apidomNsOpenapi.refractPathItem)(referencedElement);
         this.refractCache.set(cacheKey, referencedElement);
       }
     }
@@ -332,15 +324,16 @@ class OpenAPI3_1DereferenceVisitor {
       if (this.options.dereference.circular === 'error') {
         throw new _apidomError.ApiDOMError('Circular reference detected');
       } else if (this.options.dereference.circular === 'replace') {
-        const refElement = new _apidomCore.RefElement(referencedElement.id, {
+        const refElement = new _apidomDatamodel.RefElement(referencedElement.id, {
           type: 'path-item',
           uri: reference.uri,
           $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
         });
         const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
         const replacement = replacer(refElement);
-        link.replaceWith(replacement, mutationReplacer);
-        return !parent ? replacement : false;
+        this.indirections.pop();
+        path.replaceWith(replacement);
+        return;
       }
     }
 
@@ -355,7 +348,7 @@ class OpenAPI3_1DereferenceVisitor {
      */
     const isNonRootDocument = url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
     const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-    if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isPathItemElement)(referencedElement) && (0, _apidomCore.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+    if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isPathItemElement)(referencedElement) && (0, _apidomDatamodel.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
       // append referencing reference to ancestors lineage
       directAncestors.add(referencingElement);
       const visitor = new OpenAPI3_1DereferenceVisitor({
@@ -366,9 +359,8 @@ class OpenAPI3_1DereferenceVisitor {
         refractCache: this.refractCache,
         ancestors: ancestorsLineage
       });
-      referencedElement = await visitAsync(referencedElement, visitor, {
-        keyMap: _apidomNsOpenapi.keyMap,
-        nodeTypeGetter: _apidomNsOpenapi.getNodeType
+      referencedElement = await (0, _apidomTraverse.traverseAsync)(referencedElement, visitor, {
+        mutable: true
       });
 
       // remove referencing reference from ancestors lineage
@@ -380,9 +372,9 @@ class OpenAPI3_1DereferenceVisitor {
      * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
      */
     if ((0, _apidomNsOpenapi.isPathItemElement)(referencedElement)) {
-      const mergedElement = new _apidomNsOpenapi.PathItemElement([...referencedElement.content], (0, _apidomCore.cloneDeep)(referencedElement.meta), (0, _apidomCore.cloneDeep)(referencedElement.attributes));
+      const mergedElement = (0, _apidomDatamodel.cloneShallow)(referencedElement);
       // assign unique id to merged element
-      mergedElement.setMetaProperty('id', identityManager.generateId());
+      mergedElement.meta.set('id', identityManager.generateId());
       // existing keywords from referencing PathItemElement overrides ones from referenced element
       referencingElement.forEach((value, keyElement, item) => {
         mergedElement.remove((0, _apidomCore.toValue)(keyElement));
@@ -391,38 +383,35 @@ class OpenAPI3_1DereferenceVisitor {
       mergedElement.remove('$ref');
 
       // annotate referenced element with info about original referencing element
-      mergedElement.setMetaProperty('ref-fields', {
+      mergedElement.meta.set('ref-fields', {
         $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
       });
       // annotate referenced element with info about origin
-      mergedElement.setMetaProperty('ref-origin', reference.uri);
+      mergedElement.meta.set('ref-origin', reference.uri);
       // annotate fragment with info about referencing element
-      mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
+      mergedElement.meta.set('ref-referencing-element-id', (0, _apidomDatamodel.cloneDeep)(identityManager.identify(referencingElement)));
       referencedElement = mergedElement;
     }
 
     /**
      * Transclude referencing element with merged referenced element.
      */
-    link.replaceWith(referencedElement, mutationReplacer);
-
-    /**
-     * We're at the root of the tree, so we're just replacing the entire tree.
-     */
-    return !parent ? referencedElement : undefined;
+    path.replaceWith(referencedElement);
   }
-  async LinkElement(linkElement, key, parent, path, ancestors, link) {
+  async LinkElement(path) {
+    const linkElement = path.node;
+
     // ignore LinkElement without operationRef or operationId field
-    if (!(0, _apidomCore.isStringElement)(linkElement.operationRef) && !(0, _apidomCore.isStringElement)(linkElement.operationId)) {
-      return undefined;
+    if (!(0, _apidomDatamodel.isStringElement)(linkElement.operationRef) && !(0, _apidomDatamodel.isStringElement)(linkElement.operationId)) {
+      return;
     }
 
     // operationRef and operationId fields are mutually exclusive
-    if ((0, _apidomCore.isStringElement)(linkElement.operationRef) && (0, _apidomCore.isStringElement)(linkElement.operationId)) {
+    if ((0, _apidomDatamodel.isStringElement)(linkElement.operationRef) && (0, _apidomDatamodel.isStringElement)(linkElement.operationId)) {
       throw new _apidomError.ApiDOMError('LinkElement operationRef and operationId fields are mutually exclusive.');
     }
     let operationElement;
-    if ((0, _apidomCore.isStringElement)(linkElement.operationRef)) {
+    if ((0, _apidomDatamodel.isStringElement)(linkElement.operationRef)) {
       // possibly non-semantic referenced element
       const jsonPointer = _apidomJsonPointer.URIFragmentIdentifier.fromURIReference((0, _apidomCore.toValue)(linkElement.operationRef));
       const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(linkElement.operationRef));
@@ -432,73 +421,65 @@ class OpenAPI3_1DereferenceVisitor {
       // ignore resolving internal Operation Object reference
       if (!this.options.resolve.internal && isInternalReference) {
         // skip traversing this Link element but traverse all it's child elements
-        return undefined;
+        return;
       }
       // ignore resolving external Operation Object reference
       if (!this.options.resolve.external && isExternalReference) {
         // skip traversing this Link element but traverse all it's child elements
-        return undefined;
+        return;
       }
       const reference = await this.toReference((0, _apidomCore.toValue)(linkElement.operationRef));
       operationElement = (0, _apidomJsonPointer.evaluate)(reference.value.result, jsonPointer);
       // applying semantics to a referenced element
-      if ((0, _apidomCore.isPrimitiveElement)(operationElement)) {
+      if ((0, _apidomDatamodel.isPrimitiveElement)(operationElement)) {
         const cacheKey = `operation-${(0, _apidomCore.toValue)(identityManager.identify(operationElement))}`;
         if (this.refractCache.has(cacheKey)) {
           operationElement = this.refractCache.get(cacheKey);
         } else {
-          operationElement = _apidomNsOpenapi.OperationElement.refract(operationElement);
+          operationElement = (0, _apidomNsOpenapi.refractOperation)(operationElement);
           this.refractCache.set(cacheKey, operationElement);
         }
       }
       // create shallow clone to be able to annotate with metadata
-      operationElement = (0, _apidomCore.cloneShallow)(operationElement);
+      operationElement = (0, _apidomDatamodel.cloneShallow)(operationElement);
       // annotate operation element with info about origin
-      operationElement.setMetaProperty('ref-origin', reference.uri);
-      const linkElementCopy = (0, _apidomCore.cloneShallow)(linkElement);
+      operationElement.meta.set('ref-origin', reference.uri);
+      const linkElementCopy = (0, _apidomDatamodel.cloneShallow)(linkElement);
       linkElementCopy.operationRef?.meta.set('operation', operationElement);
 
       /**
        * Transclude Link Object containing Operation Object in its meta.
        */
-      link.replaceWith(linkElementCopy, mutationReplacer);
-
-      /**
-       * We're at the root of the tree, so we're just replacing the entire tree.
-       */
-      return !parent ? linkElementCopy : undefined;
+      path.replaceWith(linkElementCopy);
+      return;
     }
-    if ((0, _apidomCore.isStringElement)(linkElement.operationId)) {
+    if ((0, _apidomDatamodel.isStringElement)(linkElement.operationId)) {
       const operationId = (0, _apidomCore.toValue)(linkElement.operationId);
       const reference = await this.toReference(url.unsanitize(this.reference.uri));
-      operationElement = (0, _apidomCore.find)(e => (0, _apidomNsOpenapi.isOperationElement)(e) && (0, _apidomCore.isElement)(e.operationId) && e.operationId.equals(operationId), reference.value.result);
+      operationElement = (0, _apidomTraverse.find)(reference.value.result, e => (0, _apidomNsOpenapi.isOperationElement)(e) && (0, _apidomDatamodel.isElement)(e.operationId) && e.operationId.equals(operationId));
       // OperationElement not found by its operationId
       if ((0, _ramdaAdjunct.isUndefined)(operationElement)) {
         throw new _apidomError.ApiDOMError(`OperationElement(operationId=${operationId}) not found.`);
       }
-      const linkElementCopy = (0, _apidomCore.cloneShallow)(linkElement);
+      const linkElementCopy = (0, _apidomDatamodel.cloneShallow)(linkElement);
       linkElementCopy.operationId?.meta.set('operation', operationElement);
 
       /**
        * Transclude Link Object containing Operation Object in its meta.
        */
-      link.replaceWith(linkElementCopy, mutationReplacer);
-
-      /**
-       * We're at the root of the tree, so we're just replacing the entire tree.
-       */
-      return !parent ? linkElementCopy : undefined;
+      path.replaceWith(linkElementCopy);
     }
-    return undefined;
   }
-  async ExampleElement(exampleElement, key, parent, path, ancestors, link) {
+  async ExampleElement(path) {
+    const exampleElement = path.node;
+
     // ignore ExampleElement without externalValue field
-    if (!(0, _apidomCore.isStringElement)(exampleElement.externalValue)) {
-      return undefined;
+    if (!(0, _apidomDatamodel.isStringElement)(exampleElement.externalValue)) {
+      return;
     }
 
     // value and externalValue fields are mutually exclusive
-    if (exampleElement.hasKey('value') && (0, _apidomCore.isStringElement)(exampleElement.externalValue)) {
+    if (exampleElement.hasKey('value') && (0, _apidomDatamodel.isStringElement)(exampleElement.externalValue)) {
       throw new _apidomError.ApiDOMError('ExampleElement value and externalValue fields are mutually exclusive.');
     }
     const retrievalURI = this.toBaseURI((0, _apidomCore.toValue)(exampleElement.externalValue));
@@ -508,43 +489,41 @@ class OpenAPI3_1DereferenceVisitor {
     // ignore resolving internal Example Objects
     if (!this.options.resolve.internal && isInternalReference) {
       // skip traversing this Example element but traverse all it's child elements
-      return undefined;
+      return;
     }
     // ignore resolving external Example Objects
     if (!this.options.resolve.external && isExternalReference) {
       // skip traversing this Example element but traverse all it's child elements
-      return undefined;
+      return;
     }
     const reference = await this.toReference((0, _apidomCore.toValue)(exampleElement.externalValue));
 
     // shallow clone of the referenced element
-    const valueElement = (0, _apidomCore.cloneShallow)(reference.value.result);
+    const valueElement = (0, _apidomDatamodel.cloneShallow)(reference.value.result);
     // annotate operation element with info about origin
-    valueElement.setMetaProperty('ref-origin', reference.uri);
-    const exampleElementCopy = (0, _apidomCore.cloneShallow)(exampleElement);
+    valueElement.meta.set('ref-origin', reference.uri);
+    const exampleElementCopy = (0, _apidomDatamodel.cloneShallow)(exampleElement);
     exampleElementCopy.value = valueElement;
 
     /**
      * Transclude Example Object containing external value.
      */
-    link.replaceWith(exampleElementCopy, mutationReplacer);
-
-    /**
-     * We're at the root of the tree, so we're just replacing the entire tree.
-     */
-    return !parent ? exampleElementCopy : undefined;
+    path.replaceWith(exampleElementCopy);
   }
-  async SchemaElement(referencingElement, key, parent, path, ancestors, link) {
+  async SchemaElement(path) {
+    const referencingElement = path.node;
+
     // skip current referencing schema as $ref keyword was not defined
-    if (!(0, _apidomCore.isStringElement)(referencingElement.$ref)) {
-      return undefined;
+    if (!(0, _apidomDatamodel.isStringElement)(referencingElement.$ref)) {
+      return;
     }
 
     // skip current referencing element as it's already been access
     if (this.indirections.includes(referencingElement)) {
-      return false;
+      path.skip();
+      return;
     }
-    const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
+    const [ancestorsLineage, directAncestors] = this.toAncestorLineage(path);
 
     // compute baseURI using rules around $id and $ref keywords
     let reference = await this.toReference(url.unsanitize(this.reference.uri));
@@ -577,12 +556,12 @@ class OpenAPI3_1DereferenceVisitor {
         // ignore resolving internal Schema Objects
         if (!this.options.resolve.internal && isInternalReference) {
           // skip traversing this schema element but traverse all it's child elements
-          return undefined;
+          return;
         }
         // ignore resolving external Schema Objects
         if (!this.options.resolve.external && isExternalReference) {
           // skip traversing this schema element but traverse all it's child elements
-          return undefined;
+          return;
         }
       } else {
         // we're assuming here that we're dealing with JSON Pointer here
@@ -593,12 +572,12 @@ class OpenAPI3_1DereferenceVisitor {
         // ignore resolving internal Schema Objects
         if (!this.options.resolve.internal && isInternalReference) {
           // skip traversing this schema element but traverse all it's child elements
-          return undefined;
+          return;
         }
         // ignore resolving external Schema Objects
         if (!this.options.resolve.external && isExternalReference) {
           // skip traversing this schema element but traverse all it's child elements
-          return undefined;
+          return;
         }
         reference = await this.toReference(url.unsanitize($refBaseURI));
         const selector = _apidomJsonPointer.URIFragmentIdentifier.fromURIReference($refBaseURI);
@@ -621,12 +600,12 @@ class OpenAPI3_1DereferenceVisitor {
           // ignore resolving internal Schema Objects
           if (!this.options.resolve.internal && isInternalReference) {
             // skip traversing this schema element but traverse all it's child elements
-            return undefined;
+            return;
           }
           // ignore resolving external Schema Objects
           if (!this.options.resolve.external && isExternalReference) {
             // skip traversing this schema element but traverse all it's child elements
-            return undefined;
+            return;
           }
           reference = await this.toReference(url.unsanitize($refBaseURI));
           const selector = (0, _$anchor.uriToAnchor)($refBaseURI);
@@ -643,12 +622,12 @@ class OpenAPI3_1DereferenceVisitor {
           // ignore resolving internal Schema Objects
           if (!this.options.resolve.internal && isInternalReference) {
             // skip traversing this schema element but traverse all it's child elements
-            return undefined;
+            return;
           }
           // ignore resolving external Schema Objects
           if (!this.options.resolve.external && isExternalReference) {
             // skip traversing this schema element but traverse all it's child elements
-            return undefined;
+            return;
           }
           reference = await this.toReference(url.unsanitize($refBaseURI));
           const selector = _apidomJsonPointer.URIFragmentIdentifier.fromURIReference($refBaseURI);
@@ -678,15 +657,16 @@ class OpenAPI3_1DereferenceVisitor {
       if (this.options.dereference.circular === 'error') {
         throw new _apidomError.ApiDOMError('Circular reference detected');
       } else if (this.options.dereference.circular === 'replace') {
-        const refElement = new _apidomCore.RefElement(referencedElement.id, {
+        const refElement = new _apidomDatamodel.RefElement(referencedElement.id, {
           type: 'json-schema',
           uri: reference.uri,
           $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
         });
         const replacer = this.options.dereference.strategyOpts['openapi-3-1']?.circularReplacer ?? this.options.dereference.circularReplacer;
         const replacement = replacer(refElement);
-        link.replaceWith(replacement, mutationReplacer);
-        return !parent ? replacement : false;
+        this.indirections.pop();
+        path.replaceWith(replacement);
+        return;
       }
     }
 
@@ -701,7 +681,7 @@ class OpenAPI3_1DereferenceVisitor {
      */
     const isNonRootDocument = url.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
     const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-    if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isSchemaElement)(referencedElement) && (0, _apidomCore.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+    if ((isExternalReference || isNonRootDocument || (0, _apidomNsOpenapi.isSchemaElement)(referencedElement) && (0, _apidomDatamodel.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
       // append referencing reference to ancestors lineage
       directAncestors.add(referencingElement);
       const visitor = new OpenAPI3_1DereferenceVisitor({
@@ -712,9 +692,8 @@ class OpenAPI3_1DereferenceVisitor {
         refractCache: this.refractCache,
         ancestors: ancestorsLineage
       });
-      referencedElement = await visitAsync(referencedElement, visitor, {
-        keyMap: _apidomNsOpenapi.keyMap,
-        nodeTypeGetter: _apidomNsOpenapi.getNodeType
+      referencedElement = await (0, _apidomTraverse.traverseAsync)(referencedElement, visitor, {
+        mutable: true
       });
 
       // remove referencing reference from ancestors lineage
@@ -724,28 +703,28 @@ class OpenAPI3_1DereferenceVisitor {
 
     // Boolean JSON Schemas
     if ((0, _apidomNsOpenapi.isBooleanJsonSchemaElement)(referencedElement)) {
-      const booleanJsonSchemaElement = (0, _apidomCore.cloneDeep)(referencedElement);
+      const booleanJsonSchemaElement = (0, _apidomDatamodel.cloneDeep)(referencedElement);
       // assign unique id to merged element
-      booleanJsonSchemaElement.setMetaProperty('id', identityManager.generateId());
+      booleanJsonSchemaElement.meta.set('id', identityManager.generateId());
       // annotate referenced element with info about original referencing element
-      booleanJsonSchemaElement.setMetaProperty('ref-fields', {
+      booleanJsonSchemaElement.meta.set('ref-fields', {
         $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
       });
       // annotate referenced element with info about origin
-      booleanJsonSchemaElement.setMetaProperty('ref-origin', reference.uri);
+      booleanJsonSchemaElement.meta.set('ref-origin', reference.uri);
       // annotate fragment with info about referencing element
-      booleanJsonSchemaElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
-      link.replaceWith(booleanJsonSchemaElement, mutationReplacer);
-      return !parent ? booleanJsonSchemaElement : false;
+      booleanJsonSchemaElement.meta.set('ref-referencing-element-id', (0, _apidomDatamodel.cloneDeep)(identityManager.identify(referencingElement)));
+      path.replaceWith(booleanJsonSchemaElement);
+      return;
     }
 
     /**
      * Creating a new version of Schema Object by merging fields from referenced Schema Object with referencing one.
      */
     if ((0, _apidomNsOpenapi.isSchemaElement)(referencedElement)) {
-      const mergedElement = new _apidomNsOpenapi.SchemaElement([...referencedElement.content], (0, _apidomCore.cloneDeep)(referencedElement.meta), (0, _apidomCore.cloneDeep)(referencedElement.attributes));
+      const mergedElement = (0, _apidomDatamodel.cloneShallow)(referencedElement);
       // assign unique id to merged element
-      mergedElement.setMetaProperty('id', identityManager.generateId());
+      mergedElement.meta.set('id', identityManager.generateId());
       // existing keywords from referencing schema overrides ones from referenced schema
       referencingElement.forEach((value, keyElement, item) => {
         mergedElement.remove((0, _apidomCore.toValue)(keyElement));
@@ -753,24 +732,19 @@ class OpenAPI3_1DereferenceVisitor {
       });
       mergedElement.remove('$ref');
       // annotate referenced element with info about original referencing element
-      mergedElement.setMetaProperty('ref-fields', {
+      mergedElement.meta.set('ref-fields', {
         $ref: (0, _apidomCore.toValue)(referencingElement.$ref)
       });
       // annotate fragment with info about origin
-      mergedElement.setMetaProperty('ref-origin', reference.uri);
+      mergedElement.meta.set('ref-origin', reference.uri);
       // annotate fragment with info about referencing element
-      mergedElement.setMetaProperty('ref-referencing-element-id', (0, _apidomCore.cloneDeep)(identityManager.identify(referencingElement)));
+      mergedElement.meta.set('ref-referencing-element-id', (0, _apidomDatamodel.cloneDeep)(identityManager.identify(referencingElement)));
       referencedElement = mergedElement;
     }
     /**
      * Transclude referencing element with merged referenced element.
      */
-    link.replaceWith(referencedElement, mutationReplacer);
-
-    /**
-     * We're at the root of the tree, so we're just replacing the entire tree.
-     */
-    return !parent ? referencedElement : undefined;
+    path.replaceWith(referencedElement);
   }
 }
 var _default = exports.default = OpenAPI3_1DereferenceVisitor;