@speclynx/apidom-reference 6.1.2 → 7.0.0

package/src/dereference/strategies/overlay-1/index.cjs

@@ -20,6 +20,7 @@ Object.defineProperty(exports, "dereferenceExtends", {
 var _apidomDatamodel = require("@speclynx/apidom-datamodel");
 var _apidomNsOverlay = require("@speclynx/apidom-ns-overlay-1");
 var _apidomTraverse = require("@speclynx/apidom-traverse");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _DereferenceStrategy = _interopRequireDefault(require("../DereferenceStrategy.cjs"));
 var _Reference = _interopRequireDefault(require("../../../Reference.cjs"));
 var _ReferenceSet = _interopRequireDefault(require("../../../ReferenceSet.cjs"));
@@ -41,8 +42,8 @@ class Overlay1DereferenceStrategy extends _DereferenceStrategy.default {
   }
   canDereference(file) {
     // assert by media type
-    if (file.mediaType !== 'text/plain') {
-      return _apidomNsOverlay.mediaTypes.includes(file.mediaType);
+    if (!(0, _mediaTypes.matches)('text/plain', file.mediaType)) {
+      return (0, _mediaTypes.selectBestMatch)(_apidomNsOverlay.mediaTypes, file.mediaType) !== null;
     }
 
     // assert by inspecting ApiDOM

package/src/dereference/strategies/overlay-1/index.mjs

@@ -1,6 +1,7 @@
 import { cloneDeep, isParseResultElement } from '@speclynx/apidom-datamodel';
 import { isOverlay1Element, mediaTypes } from '@speclynx/apidom-ns-overlay-1';
 import { traverseAsync } from '@speclynx/apidom-traverse';
+import { matches, selectBestMatch } from '@swaggerexpert/media-types';
 import DereferenceStrategy from "../DereferenceStrategy.mjs";
 import Reference from "../../../Reference.mjs";
 import ReferenceSet from "../../../ReferenceSet.mjs";
@@ -21,8 +22,8 @@ class Overlay1DereferenceStrategy extends DereferenceStrategy {
   }
   canDereference(file) {
     // assert by media type
-    if (file.mediaType !== 'text/plain') {
-      return mediaTypes.includes(file.mediaType);
+    if (!matches('text/plain', file.mediaType)) {
+      return selectBestMatch(mediaTypes, file.mediaType) !== null;
     }
 
     // assert by inspecting ApiDOM

package/src/index.cjs

@@ -17,12 +17,6 @@ Object.defineProperty(exports, "BundleStrategy", {
     return _BundleStrategy.default;
   }
 });
-Object.defineProperty(exports, "DereferenceAncestorLineage", {
-  enumerable: true,
-  get: function () {
-    return _util3.AncestorLineage;
-  }
-});
 Object.defineProperty(exports, "DereferenceError", {
   enumerable: true,
   get: function () {
@@ -227,7 +221,6 @@ var _Resolver = _interopRequireDefault(require("./resolve/resolvers/Resolver.cjs
 var _HTTPResolver = _interopRequireDefault(require("./resolve/resolvers/HTTPResolver.cjs"));
 var _ResolveStrategy = _interopRequireDefault(require("./resolve/strategies/ResolveStrategy.cjs"));
 var _DereferenceStrategy = _interopRequireDefault(require("./dereference/strategies/DereferenceStrategy.cjs"));
-var _util3 = require("./dereference/util.cjs");
 var _BundleStrategy = _interopRequireDefault(require("./bundle/strategies/BundleStrategy.cjs"));
 var _Reference = _interopRequireDefault(require("./Reference.cjs"));
 var _BundleError = _interopRequireDefault(require("./errors/BundleError.cjs"));

package/src/index.mjs

@@ -14,7 +14,6 @@ export { default as Resolver } from "./resolve/resolvers/Resolver.mjs";
 export { default as HTTPResolver } from "./resolve/resolvers/HTTPResolver.mjs";
 export { default as ResolveStrategy } from "./resolve/strategies/ResolveStrategy.mjs";
 export { default as DereferenceStrategy } from "./dereference/strategies/DereferenceStrategy.mjs";
-export { AncestorLineage as DereferenceAncestorLineage } from "./dereference/util.mjs";
 export { default as BundleStrategy } from "./bundle/strategies/BundleStrategy.mjs";
 export { default as options } from "./options/index.mjs";
 export { merge as mergeOptions } from "./options/util.mjs";

package/src/options/index.cjs

@@ -68,6 +68,10 @@ const defaultOptions = {
   resolve: {
     /**
      * baseURI serves as a base for all relative URL found in ApiDOM references.
+     * It must be absolute: a file system path, a file:// URL or an HTTP(S) URL.
+     * Defaults to the current working directory (the page URL in browsers).
+     * A fragment marks where the ApiDOM fragment is located in its document;
+     * leave it out when passing a whole document.
      */
     baseURI: '',
     /**

package/src/options/index.mjs

@@ -63,6 +63,10 @@ const defaultOptions = {
   resolve: {
     /**
      * baseURI serves as a base for all relative URL found in ApiDOM references.
+     * It must be absolute: a file system path, a file:// URL or an HTTP(S) URL.
+     * Defaults to the current working directory (the page URL in browsers).
+     * A fragment marks where the ApiDOM fragment is located in its document;
+     * leave it out when passing a whole document.
      */
     baseURI: '',
     /**

package/src/options/util.cjs

@@ -12,7 +12,13 @@ var _url = require("../util/url.cjs");
  */
 
 const baseURILens = (0, _ramda.lens)((0, _ramda.path)(['resolve', 'baseURI']), (0, _ramda.assocPath)(['resolve', 'baseURI']));
-const baseURIDefault = baseURI => (0, _ramdaAdjunct.isEmptyString)(baseURI) ? (0, _url.cwd)() : baseURI;
+// in Node cwd() is a raw file system path; encode it, so that it reads as a URI
+// (in browsers it is the page URL, which may be an already encoded file:// URL)
+const cwdURI = () => {
+  const dir = (0, _url.cwd)();
+  return (0, _url.isFileSystemPath)(dir) && (0, _url.getProtocol)(dir) !== 'file' ? (0, _url.fromFileSystemPath)(dir) : dir;
+};
+const baseURIDefault = baseURI => (0, _ramdaAdjunct.isEmptyString)(baseURI) ? cwdURI() : baseURI;
 
 /**
  * @public

package/src/options/util.mjs

@@ -1,12 +1,18 @@
 import { mergeDeepRight, lens, path, assocPath, over } from 'ramda';
 import { isEmptyString } from 'ramda-adjunct';
-import { cwd } from "../util/url.mjs";
+import { cwd, getProtocol, isFileSystemPath, fromFileSystemPath } from "../util/url.mjs";
 /**
  * Algorithm for deep merging options.
  */
 
 const baseURILens = lens(path(['resolve', 'baseURI']), assocPath(['resolve', 'baseURI']));
-const baseURIDefault = baseURI => isEmptyString(baseURI) ? cwd() : baseURI;
+// in Node cwd() is a raw file system path; encode it, so that it reads as a URI
+// (in browsers it is the page URL, which may be an already encoded file:// URL)
+const cwdURI = () => {
+  const dir = cwd();
+  return isFileSystemPath(dir) && getProtocol(dir) !== 'file' ? fromFileSystemPath(dir) : dir;
+};
+const baseURIDefault = baseURI => isEmptyString(baseURI) ? cwdURI() : baseURI;
 
 /**
  * @public

package/src/parse/index.cjs

@@ -7,12 +7,16 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _ramda = require("ramda");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var url = _interopRequireWildcard(require("../util/url.cjs"));
 var _File = _interopRequireDefault(require("../File.cjs"));
 var plugins = _interopRequireWildcard(require("../util/plugins.cjs"));
 var _ParseError = _interopRequireDefault(require("../errors/ParseError.cjs"));
 var _UnmatchedParserError = _interopRequireDefault(require("../errors/UnmatchedParserError.cjs"));
 var _util = require("../resolve/util.cjs");
+// media types of a serialization format only, naming no specification
+const formatMediaTypes = ['application/json', 'application/yaml', 'text/yaml'];
+
 /**
  * Parses the given file's contents, using the configured parser plugins.
  */
@@ -21,7 +25,11 @@ const parseFile = async (file, options) => {
     const clonedParser = Object.create(parser);
     return Object.assign(clonedParser, options.parse.parserOpts);
   });
-  const parsers = await plugins.filter('canParse', [file, options], optsBoundParsers);
+  const candidates = await plugins.filter('canParse', [file, options], optsBoundParsers);
+  // parsers listing the file's media type are tried first, the others in their configured order;
+  // for a format media type the configured order decides, as it puts specific parsers first
+  const isListing = parser => parser.mediaTypes !== undefined && (0, _mediaTypes.selectBestMatch)(parser.mediaTypes, file.mediaType) !== null;
+  const parsers = (0, _mediaTypes.selectBestMatch)(formatMediaTypes, file.mediaType) !== null ? candidates : [...candidates.filter(isListing), ...candidates.filter(p => !isListing(p))];
 
   // we couldn't find any parser for this File
   if ((0, _ramda.isEmpty)(parsers)) {

package/src/parse/index.mjs

@@ -1,10 +1,14 @@
 import { isEmpty } from 'ramda';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import * as url from "../util/url.mjs";
 import File from "../File.mjs";
 import * as plugins from "../util/plugins.mjs";
 import ParseError from "../errors/ParseError.mjs";
 import UnmatchedParserError from "../errors/UnmatchedParserError.mjs";
 import { readFile } from "../resolve/util.mjs";
+// media types of a serialization format only, naming no specification
+const formatMediaTypes = ['application/json', 'application/yaml', 'text/yaml'];
+
 /**
  * Parses the given file's contents, using the configured parser plugins.
  */
@@ -13,7 +17,11 @@ const parseFile = async (file, options) => {
     const clonedParser = Object.create(parser);
     return Object.assign(clonedParser, options.parse.parserOpts);
   });
-  const parsers = await plugins.filter('canParse', [file, options], optsBoundParsers);
+  const candidates = await plugins.filter('canParse', [file, options], optsBoundParsers);
+  // parsers listing the file's media type are tried first, the others in their configured order;
+  // for a format media type the configured order decides, as it puts specific parsers first
+  const isListing = parser => parser.mediaTypes !== undefined && selectBestMatch(parser.mediaTypes, file.mediaType) !== null;
+  const parsers = selectBestMatch(formatMediaTypes, file.mediaType) !== null ? candidates : [...candidates.filter(isListing), ...candidates.filter(p => !isListing(p))];
 
   // we couldn't find any parser for this File
   if (isEmpty(parsers)) {

package/src/parse/parsers/apidom-json/index.cjs

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -35,7 +36,7 @@ class ApiDOMJSONParser extends _Parser.default {
   }
   canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/apidom-json/index.mjs

@@ -1,4 +1,5 @@
 import { Namespace, ParseResultElement, isParseResultElement } from '@speclynx/apidom-datamodel';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -27,7 +28,7 @@ class ApiDOMJSONParser extends Parser {
   }
   canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/arazzo-json-1/index.cjs

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "parseSourceDescriptions", {
 });
 var _ramda = require("ramda");
 var _apidomParserAdapterArazzoJson = require("@speclynx/apidom-parser-adapter-arazzo-json-1");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 var _sourceDescriptions = require("./source-descriptions.cjs");
@@ -40,7 +41,7 @@ class ArazzoJSON1Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/arazzo-json-1/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as ArazzoJSON1MediaTypes, detect } from '@speclynx/apidom-parser-adapter-arazzo-json-1';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 import { parseSourceDescriptions } from "./source-descriptions.mjs";
@@ -26,7 +27,7 @@ class ArazzoJSON1Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/arazzo-yaml-1/index.cjs

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "parseSourceDescriptions", {
 });
 var _ramda = require("ramda");
 var _apidomParserAdapterArazzoYaml = require("@speclynx/apidom-parser-adapter-arazzo-yaml-1");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 var _sourceDescriptions = require("./source-descriptions.cjs");
@@ -40,7 +41,7 @@ class ArazzoYAML1Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/arazzo-yaml-1/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as ArazzoYAML1MediaTypes, detect } from '@speclynx/apidom-parser-adapter-arazzo-yaml-1';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 import { parseSourceDescriptions } from "./source-descriptions.mjs";
@@ -26,7 +27,7 @@ class ArazzoYAML1Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/asyncapi-json-2/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterAsyncapiJson = require("@speclynx/apidom-parser-adapter-asyncapi-json-2");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class AsyncAPIJSON2Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/asyncapi-json-2/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as AsyncAPI2MediaTypes, detect } from '@speclynx/apidom-parser-adapter-asyncapi-json-2';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class AsyncAPIJSON2Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/asyncapi-yaml-2/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterAsyncapiYaml = require("@speclynx/apidom-parser-adapter-asyncapi-yaml-2");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class AsyncAPIYAML2Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/asyncapi-yaml-2/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as AsyncAPI2MediaTypes, detect } from '@speclynx/apidom-parser-adapter-asyncapi-yaml-2';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class AsyncAPIYAML2Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/json/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterJson = require("@speclynx/apidom-parser-adapter-json");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -32,7 +33,7 @@ class JSONParser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/json/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as JSONMediaTypes, detect } from '@speclynx/apidom-parser-adapter-json';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -24,7 +25,7 @@ class JSONParser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-json-2/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterOpenapiJson = require("@speclynx/apidom-parser-adapter-openapi-json-2");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class OpenAPIJSON2Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-json-2/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as OpenAPI2MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-json-2';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class OpenAPIJSON2Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-json-3-0/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterOpenapiJson = require("@speclynx/apidom-parser-adapter-openapi-json-3-0");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class OpenAPIJSON3_0Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-json-3-0/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as OpenAPI3_0MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-json-3-0';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class OpenAPIJSON3_0Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-json-3-1/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterOpenapiJson = require("@speclynx/apidom-parser-adapter-openapi-json-3-1");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class OpenAPIJSON3_1Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-json-3-1/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as OpenAPI3_1MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-json-3-1';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class OpenAPIJSON3_1Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-yaml-2/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterOpenapiYaml = require("@speclynx/apidom-parser-adapter-openapi-yaml-2");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class OpenAPIYAML2Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-yaml-2/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as OpenAPIYAML2MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-yaml-2';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class OpenAPIYAML2Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-yaml-3-0/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterOpenapiYaml = require("@speclynx/apidom-parser-adapter-openapi-yaml-3-0");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class OpenAPIYAML3_0Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-yaml-3-0/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as OpenAPIYAML3_0MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-yaml-3-0';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class OpenAPIYAML3_0Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-yaml-3-1/index.cjs

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomParserAdapterOpenapiYaml = require("@speclynx/apidom-parser-adapter-openapi-yaml-3-1");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 /**
@@ -33,7 +34,7 @@ class OpenAPIYAML3_1Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/openapi-yaml-3-1/index.mjs

@@ -1,5 +1,6 @@
 import { pick } from 'ramda';
 import { parse, mediaTypes as OpenAPIYAML3_1MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-yaml-3-1';
+import { selectBestMatch } from '@swaggerexpert/media-types';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
 /**
@@ -25,7 +26,7 @@ class OpenAPIYAML3_1Parser extends Parser {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = selectBestMatch(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {

package/src/parse/parsers/overlay-json-1/index.cjs

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "parseExtends", {
 });
 var _ramda = require("ramda");
 var _apidomParserAdapterOverlayJson = require("@speclynx/apidom-parser-adapter-overlay-json-1");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
 var _extends = require("./extends.cjs");
@@ -43,7 +44,7 @@ class OverlayJSON1Parser extends _Parser.default {
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
-    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    const hasSupportedMediaType = (0, _mediaTypes.selectBestMatch)(this.mediaTypes, file.mediaType) !== null;
     if (!hasSupportedFileExtension) return false;
     if (hasSupportedMediaType) return true;
     if (!hasSupportedMediaType) {