refactor(reference): use apidom-traverse package for dereferencing (#12)

Author: char0n

README.md

@@ -91,6 +91,7 @@ You can install ApiDOM packages using [npm CLI](https://docs.npmjs.com/cli):
  $ npm install @speclynx/apidom-parser-adapter-openapi-yaml-3-1
  $ npm install @speclynx/apidom-parser-adapter-yaml-1-2
  $ npm install @speclynx/apidom-reference
+ $ npm install @speclynx/apidom-traverse
 ```
 
 ### Usage

package-lock.json

@@ -24,7 +24,7 @@
     "clean": "lerna run clean",
     "test": "lerna run test",
     "link": "npm link --workspaces",
-    "unlink": "npm unlink --global @speclynx/apidom-ast @speclynx/apidom-converter @speclynx/apidom-core @speclynx/apidom-datamodel @speclynx/apidom-error @speclynx/apidom-json-path @speclynx/apidom-json-pointer @speclynx/apidom-json-pointer-relative @speclynx/apidom-parser-adapter-json @speclynx/apidom-ns-api-design-systems @speclynx/apidom-ns-asyncapi-2 @speclynx/apidom-ns-json-schema-draft-4 @speclynx/apidom-ns-json-schema-draft-6 @speclynx/apidom-ns-json-schema-draft-7 @speclynx/apidom-ns-openapi-2 @speclynx/apidom-ns-openapi-3-0 @speclynx/apidom-ns-openapi-3-1 @speclynx/apidom-parser-adapter-yaml-1-2 @speclynx/apidom-parser-adapter-asyncapi-yaml-2 @speclynx/apidom-parser-adapter-openapi-yaml-2 @speclynx/apidom-parser-adapter-openapi-yaml-3-0 @speclynx/apidom-parser-adapter-openapi-yaml-3-1 @speclynx/apidom-parser @speclynx/apidom-parser-adapter-api-design-systems-json @speclynx/apidom-parser-adapter-api-design-systems-yaml @speclynx/apidom-parser-adapter-asyncapi-json-2 @speclynx/apidom-reference @speclynx/apidom-parser-adapter-openapi-json-2 @speclynx/apidom-parser-adapter-openapi-json-3-0 @speclynx/apidom-parser-adapter-openapi-json-3-1 @speclynx/apidom-parser-adapter-arazzo-json-1 @speclynx/apidom-parser-adapter-arazzo-yaml-1 @speclynx/apidom-playground"
+    "unlink": "npm unlink --global @speclynx/apidom-ast @speclynx/apidom-converter @speclynx/apidom-core @speclynx/apidom-datamodel @speclynx/apidom-error @speclynx/apidom-json-path @speclynx/apidom-json-pointer @speclynx/apidom-json-pointer-relative @speclynx/apidom-parser-adapter-json @speclynx/apidom-ns-api-design-systems @speclynx/apidom-ns-asyncapi-2 @speclynx/apidom-ns-json-schema-draft-4 @speclynx/apidom-ns-json-schema-draft-6 @speclynx/apidom-ns-json-schema-draft-7 @speclynx/apidom-ns-openapi-2 @speclynx/apidom-ns-openapi-3-0 @speclynx/apidom-ns-openapi-3-1 @speclynx/apidom-parser-adapter-yaml-1-2 @speclynx/apidom-parser-adapter-asyncapi-yaml-2 @speclynx/apidom-parser-adapter-openapi-yaml-2 @speclynx/apidom-parser-adapter-openapi-yaml-3-0 @speclynx/apidom-parser-adapter-openapi-yaml-3-1 @speclynx/apidom-parser @speclynx/apidom-parser-adapter-api-design-systems-json @speclynx/apidom-parser-adapter-api-design-systems-yaml @speclynx/apidom-parser-adapter-asyncapi-json-2 @speclynx/apidom-reference @speclynx/apidom-parser-adapter-openapi-json-2 @speclynx/apidom-parser-adapter-openapi-json-3-0 @speclynx/apidom-parser-adapter-openapi-json-3-1 @speclynx/apidom-parser-adapter-arazzo-json-1 @speclynx/apidom-parser-adapter-arazzo-yaml-1 @speclynx/apidom-playground @speclynx/apidom-traverse"
   },
   "repository": {
     "type": "git",

package.json

@@ -8,8 +8,8 @@ import {
   getNodeType,
   isOpenApi3_1Element,
 } from '@speclynx/apidom-ns-openapi-3-1';
-import { ParseResultElement, AnnotationElement } from '@speclynx/apidom-datamodel';
-import { cloneDeep, dispatchRefractorPlugins as dispatchPlugins } from '@speclynx/apidom-core';
+import { ParseResultElement, AnnotationElement, cloneDeep } from '@speclynx/apidom-datamodel';
+import { dispatchRefractorPlugins as dispatchPlugins } from '@speclynx/apidom-core';
 import { File } from '@speclynx/apidom-reference';
 
 import ConvertStrategy from '../ConvertStrategy.ts';

packages/apidom-converter/src/strategies/openapi-3-1-to-openapi-3-0-3/index.ts

@@ -13,8 +13,9 @@ import {
   ParseResultElement,
   AnnotationElement,
   isObjectElement,
+  cloneDeep,
 } from '@speclynx/apidom-datamodel';
-import { toValue, cloneDeep } from '@speclynx/apidom-core';
+import { toValue } from '@speclynx/apidom-core';
 import { dereferenceApiDOM, ReferenceSet, Reference, url } from '@speclynx/apidom-reference';
 
 import type { Toolbox } from '../toolbox.ts';

packages/apidom-converter/src/strategies/openapi-3-1-to-openapi-3-0-3/refractor-plugins/security-scheme-type.ts

@@ -812,31 +812,3 @@ const numberElement = new NumberElement(1);
 
 toString(numberElement); // => '{"element":"number","content":1}'
 ```
-
-## Cloning
-
-Following functions provide mechanism for creating shallow and deep copies of ApiDOM elements.
-
-### Shallow cloning
-
-Creates shallow clone of ApiDOM element.
-
-```js
-import { ObjectElement } from '@speclynx/apidom-datamodel';
-import { cloneShallow } from '@speclynx/apidom-core';
-
-const objectElement = new ObjectElement({ a: 'b' });
-const objectElementShallowClone = cloneShallow(objectElement);
-```
-
-### Deep cloning
-
-Creates deep clone of ApiDOM Element.
-
-```js
-import { ObjectElement } from '@speclynx/apidom-datamodel';
-import { cloneDeep } from '@speclynx/apidom-core';
-
-const objectElement = new ObjectElement({ a: 'b' });
-const objectElementDeepClone = cloneDeep(objectElement);
-```

packages/apidom-core/README.md

@@ -29,13 +29,6 @@ export { transclude, default as Transcluder } from './transcluder/index.ts';
 
 export { resolveSpecification, type ResolvedSpecification } from './specification.ts';
 
-export { cloneShallow, cloneDeep } from './clone/index.ts';
-export { default as CloneError } from './clone/errors/CloneError.ts';
-export type { CloneErrorOptions } from './clone/errors/CloneError.ts';
-export { default as DeepCloneError } from './clone/errors/DeepCloneError.ts';
-export { default as ShallowCloneError } from './clone/errors/ShallowCloneError.ts';
-export type { FinalCloneTypes, DeepCloneOptions } from './clone/index.ts';
-
 export { defaultIdentityManager, IdentityManager } from './identity/index.ts';
 export { default as ElementIdentityError } from './identity/errors/ElementIdentityError.ts';
 export type { ElementIdentityErrorOptions } from './identity/errors/ElementIdentityError.ts';

packages/apidom-core/src/index.ts

@@ -5,9 +5,10 @@ import {
   Element,
   isObjectElement,
   isArrayElement,
+  cloneDeep,
+  cloneShallow,
 } from '@speclynx/apidom-datamodel';
 
-import { cloneDeep, cloneShallow } from '../clone/index.ts';
 import toValue from '../transformers/serializers/value/index.ts';
 
 /**

packages/apidom-core/src/merge/deepmerge.ts

@@ -10,6 +10,7 @@ import {
   isObjectElement,
   isNullElement,
   isNumberElement,
+  cloneShallow,
 } from '@speclynx/apidom-datamodel';
 import { F as stubFalse, pipe } from 'ramda';
 import { isString } from 'ramda-adjunct';
@@ -20,8 +21,6 @@ import {
   cloneNode as cloneNodeDefault,
 } from '@speclynx/apidom-ast';
 
-import { cloneShallow } from '../clone/index.ts';
-
 export { BREAK, mergeAllVisitors };
 
 /**