@speclynx/apidom-reference 1.12.1

package/src/bundle/index.mjs

@@ -0,0 +1,55 @@
+import { isEmpty, propEq } from 'ramda';
+import File from "../File.mjs";
+import * as plugins from "../util/plugins.mjs";
+import UnmatchedBundleStrategyError from "../errors/UnmatchedBundleStrategyError.mjs";
+import BundleError from "../errors/BundleError.mjs";
+import parse from "../parse/index.mjs";
+import { merge as mergeOptions } from "../options/util.mjs";
+import * as url from "../util/url.mjs";
+/**
+ * Bundle a file with all its external references to a compound document.
+ */
+const bundle = async (uri, options) => {
+  const {
+    refSet
+  } = options.bundle;
+  const sanitizedURI = url.sanitize(uri);
+  const mergedOptions = mergeOptions(options, {
+    resolve: {
+      baseURI: sanitizedURI
+    }
+  });
+  let parseResult;
+
+  // if refSet was provided, use it to avoid unnecessary parsing
+  if (refSet !== null && refSet.has(sanitizedURI)) {
+    // @ts-ignore
+    ({
+      value: parseResult
+    } = refSet.find(propEq(sanitizedURI, 'uri')));
+  } else {
+    parseResult = await parse(uri, mergedOptions);
+  }
+  const file = new File({
+    uri: mergedOptions.resolve.baseURI,
+    parseResult,
+    mediaType: mergedOptions.parse.mediaType
+  });
+  const bundleStrategies = await plugins.filter('canBundle', [file, mergedOptions], mergedOptions.bundle.strategies);
+
+  // we couldn't find any bundle strategy for this File
+  if (isEmpty(bundleStrategies)) {
+    throw new UnmatchedBundleStrategyError(file.uri);
+  }
+  try {
+    const {
+      result
+    } = await plugins.run('bundle', [file, mergedOptions], bundleStrategies);
+    return result;
+  } catch (error) {
+    throw new BundleError(`Error while bundling file "${file.uri}"`, {
+      cause: error
+    });
+  }
+};
+export default bundle;

package/src/bundle/strategies/BundleStrategy.cjs

@@ -0,0 +1,20 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class BundleStrategy {
+  name;
+  constructor({
+    name
+  }) {
+    this.name = name;
+  }
+}
+var _default = exports.default = BundleStrategy;

package/src/bundle/strategies/BundleStrategy.mjs

@@ -0,0 +1,16 @@
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class BundleStrategy {
+  name;
+  constructor({
+    name
+  }) {
+    this.name = name;
+  }
+}
+export default BundleStrategy;

package/src/bundle/strategies/openapi-3-1/index.cjs

@@ -0,0 +1,35 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-1");
+var _BundleStrategy = _interopRequireDefault(require("../BundleStrategy.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class OpenAPI3_1BundleStrategy extends _BundleStrategy.default {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'openapi-3-1'
+    });
+  }
+  canBundle(file) {
+    // assert by media type
+    if (file.mediaType !== 'text/plain') {
+      return _apidomNsOpenapi.mediaTypes.includes(file.mediaType);
+    }
+
+    // assert by inspecting ApiDOM
+    return (0, _apidomNsOpenapi.isOpenApi3_1Element)(file.parseResult?.result);
+  }
+  async bundle(file) {
+    return file.parseResult;
+  }
+}
+var _default = exports.default = OpenAPI3_1BundleStrategy;

package/src/bundle/strategies/openapi-3-1/index.mjs

@@ -0,0 +1,29 @@
+import { mediaTypes, isOpenApi3_1Element } from '@speclynx/apidom-ns-openapi-3-1';
+import BundleStrategy from "../BundleStrategy.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class OpenAPI3_1BundleStrategy extends BundleStrategy {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'openapi-3-1'
+    });
+  }
+  canBundle(file) {
+    // assert by media type
+    if (file.mediaType !== 'text/plain') {
+      return mediaTypes.includes(file.mediaType);
+    }
+
+    // assert by inspecting ApiDOM
+    return isOpenApi3_1Element(file.parseResult?.result);
+  }
+  async bundle(file) {
+    return file.parseResult;
+  }
+}
+export default OpenAPI3_1BundleStrategy;

package/src/configuration/empty.cjs

@@ -0,0 +1,9 @@
+"use strict";
+
+exports.__esModule = true;
+var _index = require("../index.cjs");
+Object.keys(_index).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _index[key]) return;
+  exports[key] = _index[key];
+});

package/src/configuration/empty.mjs

@@ -0,0 +1 @@
+export * from "../index.mjs";

package/src/configuration/saturated.cjs

@@ -0,0 +1,95 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+var _indexNode = _interopRequireDefault(require("../resolve/resolvers/file/index-node.cjs"));
+var _index = _interopRequireDefault(require("../resolve/resolvers/http-axios/index.cjs"));
+var _index2 = _interopRequireDefault(require("../resolve/strategies/openapi-2/index.cjs"));
+var _index3 = _interopRequireDefault(require("../resolve/strategies/openapi-3-0/index.cjs"));
+var _index4 = _interopRequireDefault(require("../resolve/strategies/openapi-3-1/index.cjs"));
+var _index5 = _interopRequireDefault(require("../resolve/strategies/asyncapi-2/index.cjs"));
+var _index6 = _interopRequireDefault(require("../resolve/strategies/apidom/index.cjs"));
+var _index7 = _interopRequireDefault(require("../parse/parsers/api-design-systems-json/index.cjs"));
+var _index8 = _interopRequireDefault(require("../parse/parsers/api-design-systems-yaml/index.cjs"));
+var _index9 = _interopRequireDefault(require("../parse/parsers/openapi-json-2/index.cjs"));
+var _index0 = _interopRequireDefault(require("../parse/parsers/openapi-yaml-2/index.cjs"));
+var _index1 = _interopRequireDefault(require("../parse/parsers/openapi-json-3-0/index.cjs"));
+var _index10 = _interopRequireDefault(require("../parse/parsers/openapi-yaml-3-0/index.cjs"));
+var _index11 = _interopRequireDefault(require("../parse/parsers/openapi-json-3-1/index.cjs"));
+var _index12 = _interopRequireDefault(require("../parse/parsers/openapi-yaml-3-1/index.cjs"));
+var _index13 = _interopRequireDefault(require("../parse/parsers/asyncapi-json-2/index.cjs"));
+var _index14 = _interopRequireDefault(require("../parse/parsers/asyncapi-yaml-2/index.cjs"));
+var _index15 = _interopRequireDefault(require("../parse/parsers/arazzo-json-1/index.cjs"));
+var _index16 = _interopRequireDefault(require("../parse/parsers/arazzo-yaml-1/index.cjs"));
+var _index17 = _interopRequireDefault(require("../parse/parsers/apidom-json/index.cjs"));
+var _index18 = _interopRequireDefault(require("../parse/parsers/json/index.cjs"));
+var _index19 = _interopRequireDefault(require("../parse/parsers/yaml-1-2/index.cjs"));
+var _indexNode2 = _interopRequireDefault(require("../parse/parsers/binary/index-node.cjs"));
+var _index20 = _interopRequireDefault(require("../dereference/strategies/apidom/index.cjs"));
+var _index21 = _interopRequireDefault(require("../dereference/strategies/openapi-2/index.cjs"));
+var _index22 = _interopRequireDefault(require("../dereference/strategies/openapi-3-0/index.cjs"));
+var _index23 = _interopRequireDefault(require("../dereference/strategies/openapi-3-1/index.cjs"));
+var _index24 = _interopRequireDefault(require("../dereference/strategies/asyncapi-2/index.cjs"));
+var _index25 = _interopRequireDefault(require("../bundle/strategies/openapi-3-1/index.cjs"));
+var _index26 = require("../index.cjs");
+Object.keys(_index26).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _index26[key]) return;
+  exports[key] = _index26[key];
+});
+_index26.options.parse.parsers = [new _index9.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index0.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index1.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index10.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index11.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index12.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index13.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index14.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index15.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index16.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index7.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index8.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index17.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index18.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index19.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _indexNode2.default({
+  allowEmpty: true
+})];
+_index26.options.resolve.resolvers = [new _indexNode.default(), new _index.default({
+  timeout: 5000,
+  redirects: 5,
+  withCredentials: false
+})];
+_index26.options.resolve.strategies = [new _index2.default(), new _index3.default(), new _index4.default(), new _index5.default(), new _index6.default()];
+_index26.options.dereference.strategies = [new _index21.default(), new _index22.default(), new _index23.default(), new _index24.default(), new _index20.default()];
+_index26.options.bundle.strategies = [new _index25.default()];

package/src/configuration/saturated.mjs

@@ -0,0 +1,87 @@
+import FileResolver from "../resolve/resolvers/file/index-node.mjs";
+import HTTPResolverAxios from "../resolve/resolvers/http-axios/index.mjs";
+import OpenAPI2ResolveStrategy from "../resolve/strategies/openapi-2/index.mjs";
+import OpenAPI3_0ResolveStrategy from "../resolve/strategies/openapi-3-0/index.mjs";
+import OpenAPI3_1ResolveStrategy from "../resolve/strategies/openapi-3-1/index.mjs";
+import AsyncAPI2ResolveStrategy from "../resolve/strategies/asyncapi-2/index.mjs";
+import ApiDOMResolveStrategy from "../resolve/strategies/apidom/index.mjs";
+import APIDesignSystemsJSONParser from "../parse/parsers/api-design-systems-json/index.mjs";
+import APIDesignSystemsYAMLParser from "../parse/parsers/api-design-systems-yaml/index.mjs";
+import OpenAPIJSON2Parser from "../parse/parsers/openapi-json-2/index.mjs";
+import OpenAPIYAML2Parser from "../parse/parsers/openapi-yaml-2/index.mjs";
+import OpenAPIJSON3_0Parser from "../parse/parsers/openapi-json-3-0/index.mjs";
+import OpenAPIYAML3_0Parser from "../parse/parsers/openapi-yaml-3-0/index.mjs";
+import OpenAPIJSON3_1Parser from "../parse/parsers/openapi-json-3-1/index.mjs";
+import OpenAPIYAML3_1Parser from "../parse/parsers/openapi-yaml-3-1/index.mjs";
+import AsyncAPIJSON2Parser from "../parse/parsers/asyncapi-json-2/index.mjs";
+import AsyncAPIYAML2Parser from "../parse/parsers/asyncapi-yaml-2/index.mjs";
+import ArazzoJSON1Parser from "../parse/parsers/arazzo-json-1/index.mjs";
+import ArazzoYAML1Parser from "../parse/parsers/arazzo-yaml-1/index.mjs";
+import APIDOMJSONParser from "../parse/parsers/apidom-json/index.mjs";
+import JSONParser from "../parse/parsers/json/index.mjs";
+import YAMLParser from "../parse/parsers/yaml-1-2/index.mjs";
+import BinaryParser from "../parse/parsers/binary/index-node.mjs";
+import ApiDOMDereferenceStrategy from "../dereference/strategies/apidom/index.mjs";
+import OpenAPI2DereferenceStrategy from "../dereference/strategies/openapi-2/index.mjs";
+import OpenAPI3_0DereferenceStrategy from "../dereference/strategies/openapi-3-0/index.mjs";
+import OpenAPI3_1DereferenceStrategy from "../dereference/strategies/openapi-3-1/index.mjs";
+import AsyncAPI2DereferenceStrategy from "../dereference/strategies/asyncapi-2/index.mjs";
+import OpenAPI3_1BundleStrategy from "../bundle/strategies/openapi-3-1/index.mjs";
+import { options } from "../index.mjs";
+options.parse.parsers = [new OpenAPIJSON2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIYAML2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIJSON3_0Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIYAML3_0Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIJSON3_1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIYAML3_1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new AsyncAPIJSON2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new AsyncAPIYAML2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new ArazzoJSON1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new ArazzoYAML1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new APIDesignSystemsJSONParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new APIDesignSystemsYAMLParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new APIDOMJSONParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new JSONParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new YAMLParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new BinaryParser({
+  allowEmpty: true
+})];
+options.resolve.resolvers = [new FileResolver(), new HTTPResolverAxios({
+  timeout: 5000,
+  redirects: 5,
+  withCredentials: false
+})];
+options.resolve.strategies = [new OpenAPI2ResolveStrategy(), new OpenAPI3_0ResolveStrategy(), new OpenAPI3_1ResolveStrategy(), new AsyncAPI2ResolveStrategy(), new ApiDOMResolveStrategy()];
+options.dereference.strategies = [new OpenAPI2DereferenceStrategy(), new OpenAPI3_0DereferenceStrategy(), new OpenAPI3_1DereferenceStrategy(), new AsyncAPI2DereferenceStrategy(), new ApiDOMDereferenceStrategy()];
+options.bundle.strategies = [new OpenAPI3_1BundleStrategy()];
+export * from "../index.mjs";

package/src/dereference/index.cjs

@@ -0,0 +1,86 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.dereferenceApiDOM = exports.default = void 0;
+var _ramda = require("ramda");
+var _apidomCore = require("@speclynx/apidom-core");
+var _File = _interopRequireDefault(require("../File.cjs"));
+var plugins = _interopRequireWildcard(require("../util/plugins.cjs"));
+var _UnmatchedDereferenceStrategyError = _interopRequireDefault(require("../errors/UnmatchedDereferenceStrategyError.cjs"));
+var _DereferenceError = _interopRequireDefault(require("../errors/DereferenceError.cjs"));
+var _index = _interopRequireDefault(require("../parse/index.cjs"));
+var _util = require("../options/util.cjs");
+var url = _interopRequireWildcard(require("../util/url.cjs"));
+/**
+ * Dereferences ApiDOM with all its external references.
+ */
+const dereferenceApiDOM = async (element, options) => {
+  // @ts-ignore
+  let parseResult = element;
+  let surrogateWrapping = false;
+
+  // wrap element into parse result
+  if (!(0, _apidomCore.isParseResultElement)(element)) {
+    const elementClone = (0, _apidomCore.cloneShallow)(element);
+    elementClone.classes.push('result');
+    parseResult = new _apidomCore.ParseResultElement([elementClone]);
+    surrogateWrapping = true;
+  }
+  const file = new _File.default({
+    uri: options.resolve.baseURI,
+    parseResult,
+    mediaType: options.parse.mediaType
+  });
+  const dereferenceStrategies = await plugins.filter('canDereference', [file, options], options.dereference.strategies);
+
+  // we couldn't find any dereference strategy for this File
+  if ((0, _ramda.isEmpty)(dereferenceStrategies)) {
+    throw new _UnmatchedDereferenceStrategyError.default(file.uri);
+  }
+  try {
+    const {
+      result
+    } = await plugins.run('dereference', [file, options], dereferenceStrategies);
+    // unwrap the element from ParseResult assuming first element is the actual result
+    return surrogateWrapping ? result.get(0) : result;
+  } catch (error) {
+    throw new _DereferenceError.default(`Error while dereferencing file "${file.uri}"`, {
+      cause: error
+    });
+  }
+};
+
+/**
+ * Dereferences a file with all its external references.
+ */
+exports.dereferenceApiDOM = dereferenceApiDOM;
+const dereference = async (uri, options) => {
+  const {
+    refSet
+  } = options.dereference;
+  const sanitizedURI = url.sanitize(uri);
+  let parseResult;
+
+  // if refSet was provided, use it to avoid unnecessary parsing
+  if (refSet !== null && refSet.has(sanitizedURI)) {
+    // @ts-ignore
+    ({
+      value: parseResult
+    } = refSet.find((0, _ramda.propEq)(sanitizedURI, 'uri')));
+  } else {
+    parseResult = await (0, _index.default)(uri, options);
+  }
+  const mergedOptions = (0, _util.merge)(options, {
+    resolve: {
+      baseURI: sanitizedURI
+    },
+    dereference: {
+      // if refSet was not provided, then we can work in mutable mode
+      immutable: options.dereference.immutable && refSet !== null
+    }
+  });
+  return dereferenceApiDOM(parseResult, mergedOptions);
+};
+var _default = exports.default = dereference;

package/src/dereference/index.mjs

@@ -0,0 +1,79 @@
+import { isEmpty, propEq } from 'ramda';
+import { isParseResultElement, ParseResultElement, cloneShallow } from '@speclynx/apidom-core';
+import File from "../File.mjs";
+import * as plugins from "../util/plugins.mjs";
+import UnmatchedDereferenceStrategyError from "../errors/UnmatchedDereferenceStrategyError.mjs";
+import DereferenceError from "../errors/DereferenceError.mjs";
+import parse from "../parse/index.mjs";
+import { merge as mergeOptions } from "../options/util.mjs";
+import * as url from "../util/url.mjs";
+/**
+ * Dereferences ApiDOM with all its external references.
+ */
+export const dereferenceApiDOM = async (element, options) => {
+  // @ts-ignore
+  let parseResult = element;
+  let surrogateWrapping = false;
+
+  // wrap element into parse result
+  if (!isParseResultElement(element)) {
+    const elementClone = cloneShallow(element);
+    elementClone.classes.push('result');
+    parseResult = new ParseResultElement([elementClone]);
+    surrogateWrapping = true;
+  }
+  const file = new File({
+    uri: options.resolve.baseURI,
+    parseResult,
+    mediaType: options.parse.mediaType
+  });
+  const dereferenceStrategies = await plugins.filter('canDereference', [file, options], options.dereference.strategies);
+
+  // we couldn't find any dereference strategy for this File
+  if (isEmpty(dereferenceStrategies)) {
+    throw new UnmatchedDereferenceStrategyError(file.uri);
+  }
+  try {
+    const {
+      result
+    } = await plugins.run('dereference', [file, options], dereferenceStrategies);
+    // unwrap the element from ParseResult assuming first element is the actual result
+    return surrogateWrapping ? result.get(0) : result;
+  } catch (error) {
+    throw new DereferenceError(`Error while dereferencing file "${file.uri}"`, {
+      cause: error
+    });
+  }
+};
+
+/**
+ * Dereferences a file with all its external references.
+ */
+const dereference = async (uri, options) => {
+  const {
+    refSet
+  } = options.dereference;
+  const sanitizedURI = url.sanitize(uri);
+  let parseResult;
+
+  // if refSet was provided, use it to avoid unnecessary parsing
+  if (refSet !== null && refSet.has(sanitizedURI)) {
+    // @ts-ignore
+    ({
+      value: parseResult
+    } = refSet.find(propEq(sanitizedURI, 'uri')));
+  } else {
+    parseResult = await parse(uri, options);
+  }
+  const mergedOptions = mergeOptions(options, {
+    resolve: {
+      baseURI: sanitizedURI
+    },
+    dereference: {
+      // if refSet was not provided, then we can work in mutable mode
+      immutable: options.dereference.immutable && refSet !== null
+    }
+  });
+  return dereferenceApiDOM(parseResult, mergedOptions);
+};
+export default dereference;

package/src/dereference/strategies/DereferenceStrategy.cjs

@@ -0,0 +1,20 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class DereferenceStrategy {
+  name;
+  constructor({
+    name
+  }) {
+    this.name = name;
+  }
+}
+var _default = exports.default = DereferenceStrategy;

package/src/dereference/strategies/DereferenceStrategy.mjs

@@ -0,0 +1,16 @@
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class DereferenceStrategy {
+  name;
+  constructor({
+    name
+  }) {
+    this.name = name;
+  }
+}
+export default DereferenceStrategy;

package/src/dereference/strategies/apidom/index.cjs

@@ -0,0 +1,89 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _DereferenceStrategy = _interopRequireDefault(require("../DereferenceStrategy.cjs"));
+var _Reference = _interopRequireDefault(require("../../../Reference.cjs"));
+var _ReferenceSet = _interopRequireDefault(require("../../../ReferenceSet.cjs"));
+var _visitor = _interopRequireDefault(require("./visitor.cjs"));
+exports.ApiDOMDereferenceVisitor = _visitor.default;
+// @ts-ignore
+const visitAsync = _apidomCore.visit[Symbol.for('nodejs.util.promisify.custom')];
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class ApiDOMDereferenceStrategy extends _DereferenceStrategy.default {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'apidom'
+    });
+  }
+  canDereference(file) {
+    return file.mediaType.startsWith('application/vnd.apidom') && (0, _apidomCore.isElement)(file.parseResult?.result);
+  }
+  async dereference(file, options) {
+    const immutableRefSet = options.dereference.refSet ?? new _ReferenceSet.default();
+    const mutableRefSet = new _ReferenceSet.default();
+    let refSet = immutableRefSet;
+    let reference;
+
+    // determine the initial reference
+    if (!immutableRefSet.has(file.uri)) {
+      reference = new _Reference.default({
+        uri: file.uri,
+        value: file.parseResult
+      });
+      immutableRefSet.add(reference);
+    } else {
+      // pre-computed refSet was provided as configuration option
+      reference = immutableRefSet.find(ref => ref.uri === file.uri);
+    }
+
+    /**
+     * Clone refSet due the dereferencing process being mutable.
+     * We don't want to mutate the original refSet and the references.
+     */
+    if (options.dereference.immutable) {
+      immutableRefSet.refs.map(ref => new _Reference.default({
+        ...ref,
+        value: (0, _apidomCore.cloneDeep)(ref.value)
+      })).forEach(ref => mutableRefSet.add(ref));
+      reference = mutableRefSet.find(ref => ref.uri === file.uri);
+      refSet = mutableRefSet;
+    }
+    const visitor = new _visitor.default({
+      reference: reference,
+      options
+    });
+    const dereferencedElement = await visitAsync(refSet.rootRef.value, visitor);
+
+    /**
+     * 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.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.
+     */
+    if (options.dereference.refSet === null) {
+      immutableRefSet.clean();
+    }
+    mutableRefSet.clean();
+    return dereferencedElement;
+  }
+}
+var _default = exports.default = ApiDOMDereferenceStrategy;