@speclynx/apidom-parser 1.12.1

package/dist/apidom-parser.browser.min.js

@@ -0,0 +1 @@
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.apidomParser=e():t.apidomParser=e()}(self,()=>(()=>{"use strict";var t={d:(e,n)=>{for(var r in n)t.o(n,r)&&!t.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:n[r]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e),r:t=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})}},e={};function n(t){return null!=t&&"object"==typeof t&&!0===t["@@functional/placeholder"]}function r(t){return function e(r){return 0===arguments.length||n(r)?e:t.apply(this,arguments)}}function o(t,e){return e[t<0?e.length+t:t]}t.r(e),t.d(e,{ParserError:()=>Mt,default:()=>kt});const u=r(function(t){return o(0,t)});function c(t,e){switch(t){case 0:return function(){return e.apply(this,arguments)};case 1:return function(t){return e.apply(this,arguments)};case 2:return function(t,n){return e.apply(this,arguments)};case 3:return function(t,n,r){return e.apply(this,arguments)};case 4:return function(t,n,r,o){return e.apply(this,arguments)};case 5:return function(t,n,r,o,u){return e.apply(this,arguments)};case 6:return function(t,n,r,o,u,c){return e.apply(this,arguments)};case 7:return function(t,n,r,o,u,c,a){return e.apply(this,arguments)};case 8:return function(t,n,r,o,u,c,a,i){return e.apply(this,arguments)};case 9:return function(t,n,r,o,u,c,a,i,s){return e.apply(this,arguments)};case 10:return function(t,n,r,o,u,c,a,i,s,f){return e.apply(this,arguments)};default:throw new Error("First argument to _arity must be a non-negative integer no greater than ten")}}function a(t){return function e(o,u){switch(arguments.length){case 0:return e;case 1:return n(o)?e:r(function(e){return t(o,e)});default:return n(o)&&n(u)?e:n(o)?r(function(e){return t(e,u)}):n(u)?r(function(e){return t(o,e)}):t(o,u)}}}function i(t,e,r){return function(){for(var o=[],u=0,a=t,s=0,f=!1;s<e.length||u<arguments.length;){var l;s<e.length&&(!n(e[s])||u>=arguments.length)?l=e[s]:(l=arguments[u],u+=1),o[s]=l,n(l)?f=!0:a-=1,s+=1}return!f&&a<=0?r.apply(this,o):c(Math.max(0,a),i(t,o,r))}}const s=a(function(t,e){return 1===t?r(e):c(t,i(t,[],e))});function f(t){for(var e,n=[];!(e=t.next()).done;)n.push(e.value);return n}function l(t,e,n){for(var r=0,o=n.length;r<o;){if(t(e,n[r]))return!0;r+=1}return!1}function p(t,e){return Object.prototype.hasOwnProperty.call(e,t)}const y="function"==typeof Object.is?Object.is:function(t,e){return t===e?0!==t||1/t==1/e:t!=t&&e!=e};var d=Object.prototype.toString;const h=function(){return"[object Arguments]"===d.call(arguments)?function(t){return"[object Arguments]"===d.call(t)}:function(t){return p("callee",t)}}();var g=!{toString:null}.propertyIsEnumerable("toString"),b=["constructor","valueOf","isPrototypeOf","toString","propertyIsEnumerable","hasOwnProperty","toLocaleString"],v=function(){return arguments.propertyIsEnumerable("length")}(),m=function(t,e){for(var n=0;n<t.length;){if(t[n]===e)return!0;n+=1}return!1},j="function"!=typeof Object.keys||v?r(function(t){if(Object(t)!==t)return[];var e,n,r=[],o=v&&h(t);for(e in t)!p(e,t)||o&&"length"===e||(r[r.length]=e);if(g)for(n=b.length-1;n>=0;)p(e=b[n],t)&&!m(r,e)&&(r[r.length]=e),n-=1;return r}):r(function(t){return Object(t)!==t?[]:Object.keys(t)});const w=j;const O=r(function(t){return null===t?"Null":void 0===t?"Undefined":Object.prototype.toString.call(t).slice(8,-1)});function S(t,e,n,r){var o=f(t);function u(t,e){return A(t,e,n.slice(),r.slice())}return!l(function(t,e){return!l(u,e,t)},f(e),o)}function A(t,e,n,r){if(y(t,e))return!0;var o,u,c=O(t);if(c!==O(e))return!1;if("function"==typeof t["fantasy-land/equals"]||"function"==typeof e["fantasy-land/equals"])return"function"==typeof t["fantasy-land/equals"]&&t["fantasy-land/equals"](e)&&"function"==typeof e["fantasy-land/equals"]&&e["fantasy-land/equals"](t);if("function"==typeof t.equals||"function"==typeof e.equals)return"function"==typeof t.equals&&t.equals(e)&&"function"==typeof e.equals&&e.equals(t);switch(c){case"Arguments":case"Array":case"Object":if("function"==typeof t.constructor&&"Promise"===(o=t.constructor,null==(u=String(o).match(/^function (\w*)/))?"":u[1]))return t===e;break;case"Boolean":case"Number":case"String":if(typeof t!=typeof e||!y(t.valueOf(),e.valueOf()))return!1;break;case"Date":if(!y(t.valueOf(),e.valueOf()))return!1;break;case"Error":return t.name===e.name&&t.message===e.message;case"RegExp":if(t.source!==e.source||t.global!==e.global||t.ignoreCase!==e.ignoreCase||t.multiline!==e.multiline||t.sticky!==e.sticky||t.unicode!==e.unicode)return!1}for(var a=n.length-1;a>=0;){if(n[a]===t)return r[a]===e;a-=1}switch(c){case"Map":return t.size===e.size&&S(t.entries(),e.entries(),n.concat([t]),r.concat([e]));case"Set":return t.size===e.size&&S(t.values(),e.values(),n.concat([t]),r.concat([e]));case"Arguments":case"Array":case"Object":case"Boolean":case"Number":case"String":case"Date":case"Error":case"RegExp":case"Int8Array":case"Uint8Array":case"Uint8ClampedArray":case"Int16Array":case"Uint16Array":case"Int32Array":case"Uint32Array":case"Float32Array":case"Float64Array":case"ArrayBuffer":break;default:return!1}var i=w(t);if(i.length!==w(e).length)return!1;var s=n.concat([t]),f=r.concat([e]);for(a=i.length-1;a>=0;){var l=i[a];if(!p(l,e)||!A(e[l],t[l],s,f))return!1;a-=1}return!0}const x=a(function(t,e){return A(t,e,[],[])});function T(t,e){return function(t,e,n){var r,o;if("function"==typeof t.indexOf)switch(typeof e){case"number":if(0===e){for(r=1/e;n<t.length;){if(0===(o=t[n])&&1/o===r)return n;n+=1}return-1}if(e!=e){for(;n<t.length;){if("number"==typeof(o=t[n])&&o!=o)return n;n+=1}return-1}return t.indexOf(e,n);case"string":case"boolean":case"function":case"undefined":return t.indexOf(e,n);case"object":if(null===e)return t.indexOf(e,n)}for(;n<t.length;){if(x(t[n],e))return n;n+=1}return-1}(e,t,0)>=0}function E(t,e){for(var n=0,r=e.length,o=Array(r);n<r;)o[n]=t(e[n]),n+=1;return o}function M(t){return'"'+t.replace(/\\/g,"\\\\").replace(/[\b]/g,"\\b").replace(/\f/g,"\\f").replace(/\n/g,"\\n").replace(/\r/g,"\\r").replace(/\t/g,"\\t").replace(/\v/g,"\\v").replace(/\0/g,"\\0").replace(/"/g,'\\"')+'"'}var k=function(t){return(t<10?"0":"")+t};const P="function"==typeof Date.prototype.toISOString?function(t){return t.toISOString()}:function(t){return t.getUTCFullYear()+"-"+k(t.getUTCMonth()+1)+"-"+k(t.getUTCDate())+"T"+k(t.getUTCHours())+":"+k(t.getUTCMinutes())+":"+k(t.getUTCSeconds())+"."+(t.getUTCMilliseconds()/1e3).toFixed(3).slice(2,5)+"Z"};function q(t,e,n){for(var r=0,o=n.length;r<o;)e=t(e,n[r]),r+=1;return e}const C=Array.isArray||function(t){return null!=t&&t.length>=0&&"[object Array]"===Object.prototype.toString.call(t)};function U(t,e,n){return function(){if(0===arguments.length)return n();var r=arguments[arguments.length-1];if(!C(r)){for(var o=0;o<t.length;){if("function"==typeof r[t[o]])return r[t[o]].apply(r,Array.prototype.slice.call(arguments,0,-1));o+=1}if(function(t){return null!=t&&"function"==typeof t["@@transducer/step"]}(r))return e.apply(null,Array.prototype.slice.call(arguments,0,-1))(r)}return n.apply(this,arguments)}}const F=function(){return this.xf["@@transducer/init"]()},I=function(t){return this.xf["@@transducer/result"](t)};var N=function(){function t(t,e){this.xf=e,this.f=t}return t.prototype["@@transducer/init"]=F,t.prototype["@@transducer/result"]=I,t.prototype["@@transducer/step"]=function(t,e){return this.f(e)?this.xf["@@transducer/step"](t,e):t},t}();function B(t){return function(e){return new N(t,e)}}var _=a(U(["fantasy-land/filter","filter"],B,function(t,e){return n=e,"[object Object]"===Object.prototype.toString.call(n)?q(function(n,r){return t(e[r])&&(n[r]=e[r]),n},{},w(e)):function(t){return"[object Map]"===Object.prototype.toString.call(t)}(e)?function(t,e){for(var n=new Map,r=e.entries(),o=r.next();!o.done;)t(o.value[1])&&n.set(o.value[0],o.value[1]),o=r.next();return n}(t,e):function(t,e){for(var n=0,r=e.length,o=[];n<r;)t(e[n])&&(o[o.length]=e[n]),n+=1;return o}(t,e);var n}));const D=_;const z=a(function(t,e){return D((n=t,function(){return!n.apply(this,arguments)}),e);var n});function R(t,e){var n=function(n){var r=e.concat([t]);return T(n,r)?"<Circular>":R(n,r)},r=function(t,e){return E(function(e){return M(e)+": "+n(t[e])},e.slice().sort())};switch(Object.prototype.toString.call(t)){case"[object Arguments]":return"(function() { return arguments; }("+E(n,t).join(", ")+"))";case"[object Array]":return"["+E(n,t).concat(r(t,z(function(t){return/^\d+$/.test(t)},w(t)))).join(", ")+"]";case"[object Boolean]":return"object"==typeof t?"new Boolean("+n(t.valueOf())+")":t.toString();case"[object Date]":return"new Date("+(isNaN(t.valueOf())?n(NaN):M(P(t)))+")";case"[object Map]":return"new Map("+n(Array.from(t))+")";case"[object Null]":return"null";case"[object Number]":return"object"==typeof t?"new Number("+n(t.valueOf())+")":1/t==-1/0?"-0":t.toString(10);case"[object Set]":return"new Set("+n(Array.from(t).sort())+")";case"[object String]":return"object"==typeof t?"new String("+n(t.valueOf())+")":M(t);case"[object Undefined]":return"undefined";default:if("function"==typeof t.toString){var o=t.toString();if("[object Object]"!==o)return o}return"{"+r(t,w(t)).join(", ")+"}"}}const G=r(function(t){return R(t,[])});const H=a(function(t,e){if(t===e)return e;function n(t,e){if(t>e!=e>t)return e>t?e:t}var r=n(t,e);if(void 0!==r)return r;var o=n(typeof t,typeof e);if(void 0!==o)return o===typeof t?t:e;var u=G(t),c=n(u,G(e));return void 0!==c&&c===u?t:e});var L=function(){function t(t,e){this.xf=e,this.f=t}return t.prototype["@@transducer/init"]=F,t.prototype["@@transducer/result"]=I,t.prototype["@@transducer/step"]=function(t,e){return this.xf["@@transducer/step"](t,this.f(e))},t}();const W=a(U(["fantasy-land/map","map"],function(t){return function(e){return new L(t,e)}},function(t,e){switch(Object.prototype.toString.call(e)){case"[object Function]":return s(e.length,function(){return t.call(this,e.apply(this,arguments))});case"[object Object]":return q(function(n,r){return n[r]=t(e[r]),n},{},w(e));default:return E(t,e)}})),X=Number.isInteger||function(t){return(t|0)===t};const Y=a(function(t,e){if(null!=e)return X(t)?o(t,e):e[t]});const Z=a(function(t,e){return W(Y(t),e)});function $(t){return function e(o,u,c){switch(arguments.length){case 0:return e;case 1:return n(o)?e:a(function(e,n){return t(o,e,n)});case 2:return n(o)&&n(u)?e:n(o)?a(function(e,n){return t(e,u,n)}):n(u)?a(function(e,n){return t(o,e,n)}):r(function(e){return t(o,u,e)});default:return n(o)&&n(u)&&n(c)?e:n(o)&&n(u)?a(function(e,n){return t(e,n,c)}):n(o)&&n(c)?a(function(e,n){return t(e,u,n)}):n(u)&&n(c)?a(function(e,n){return t(o,e,n)}):n(o)?r(function(e){return t(e,u,c)}):n(u)?r(function(e){return t(o,e,c)}):n(c)?r(function(e){return t(o,u,e)}):t(o,u,c)}}}const J=r(function(t){return!!C(t)||!!t&&("object"==typeof t&&(!function(t){return"[object String]"===Object.prototype.toString.call(t)}(t)&&(0===t.length||t.length>0&&(t.hasOwnProperty(0)&&t.hasOwnProperty(t.length-1)))))});var K="undefined"!=typeof Symbol?Symbol.iterator:"@@iterator";function Q(t,e,n){return function(r,o,u){if(J(u))return t(r,o,u);if(null==u)return o;if("function"==typeof u["fantasy-land/reduce"])return e(r,o,u,"fantasy-land/reduce");if(null!=u[K])return n(r,o,u[K]());if("function"==typeof u.next)return n(r,o,u);if("function"==typeof u.reduce)return e(r,o,u,"reduce");throw new TypeError("reduce: list must be array or iterable")}}function V(t,e,n){for(var r=0,o=n.length;r<o;){if((e=t["@@transducer/step"](e,n[r]))&&e["@@transducer/reduced"]){e=e["@@transducer/value"];break}r+=1}return t["@@transducer/result"](e)}const tt=a(function(t,e){return c(t.length,function(){return t.apply(e,arguments)})});function et(t,e,n){for(var r=n.next();!r.done;){if((e=t["@@transducer/step"](e,r.value))&&e["@@transducer/reduced"]){e=e["@@transducer/value"];break}r=n.next()}return t["@@transducer/result"](e)}function nt(t,e,n,r){return t["@@transducer/result"](n[r](tt(t["@@transducer/step"],t),e))}const rt=Q(V,nt,et);var ot=function(){function t(t){this.f=t}return t.prototype["@@transducer/init"]=function(){throw new Error("init not implemented on XWrap")},t.prototype["@@transducer/result"]=function(t){return t},t.prototype["@@transducer/step"]=function(t,e){return this.f(t,e)},t}();const ut=$(function(t,e,n){return rt("function"==typeof t?new ot(t):t,e,n)});const ct=r(function(t){return s(ut(H,0,Z("length",t)),function(){for(var e=0,n=t.length;e<n;){if(t[e].apply(this,arguments))return!0;e+=1}return!1})});function at(t,e){return function(){return e.call(this,t.apply(this,arguments))}}function it(t,e){return function(){var n=arguments.length;if(0===n)return e();var r=arguments[n-1];return C(r)||"function"!=typeof r[t]?e.apply(this,arguments):r[t].apply(r,Array.prototype.slice.call(arguments,0,n-1))}}const st=r(it("tail",$(it("slice",function(t,e,n){return Array.prototype.slice.call(n,t,e)}))(1,1/0)));function ft(){if(0===arguments.length)throw new Error("pipe requires at least one argument");return c(arguments[0].length,ut(at,arguments[0],st(arguments)))}var lt=function(t,e){switch(arguments.length){case 0:return lt;case 1:return function e(n){return 0===arguments.length?e:y(t,n)};default:return y(t,e)}};const pt=lt;const yt=s(1,ft(O,pt("GeneratorFunction")));const dt=s(1,ft(O,pt("AsyncFunction")));const ht=ct([ft(O,pt("Function")),yt,dt]);const gt=s(1,ft(O,pt("String")));const bt=s(1,ht(Array.isArray)?Array.isArray:ft(O,pt("Array")));var vt=r(function(t){return function(){return t}})(void 0);const mt=x(vt());class jt extends AggregateError{constructor(t,e,n){super(t,e,n),this.name=this.constructor.name,"function"==typeof Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}}const wt=jt;class Ot extends Error{static[Symbol.hasInstance](t){return super[Symbol.hasInstance](t)||Function.prototype[Symbol.hasInstance].call(wt,t)}constructor(t,e){super(t,e),this.name=this.constructor.name,"function"==typeof Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}}const St=Ot;const At=class extends St{};const xt=class extends At{};const Tt=class extends Array{unknownMediaType="application/octet-stream";filterByFormat(){throw new xt("filterByFormat method in MediaTypes class is not yet implemented.")}findBy(){throw new xt("findBy method in MediaTypes class is not yet implemented.")}latest(){throw new xt("latest method in MediaTypes class is not yet implemented.")}};const Et=class extends St{constructor(t,e){if(super(t,e),null!=e&&"object"==typeof e){const{cause:t,...n}=e;Object.assign(this,n)}}};const Mt=class extends Et{source;parserOptions;constructor(t,e){super(t,e),void 0!==e&&(this.source=e.source,this.parserOptions=e.parserOptions)}};const kt=class{adapters=[];async detectAdapterCandidates(t){const e=[];for(const n of this.adapters)ht(n.detect)&&await n.detect(t)&&e.push(n);return e}async findAdapter(t,e){if(gt(e))return this.adapters.find(t=>!!bt(t.mediaTypes)&&t.mediaTypes.includes(e));const n=await this.detectAdapterCandidates(t);return u(n)}use(t){return this.adapters.push(t),this}async findNamespace(t,e={}){const n=await this.findAdapter(t,e.mediaType);return n?.namespace}async findMediaType(t){const e=await this.findAdapter(t,void 0);if(void 0===e)return(new Tt).unknownMediaType;if(void 0===e.mediaTypes)return(new Tt).unknownMediaType;if(void 0===e.detectionRegExp)return e.mediaTypes.latest();const{detectionRegExp:n}=e,r=t.match(n);if(null===r)return(new Tt).unknownMediaType;const{groups:o}=r,u=o?.version||o?.version_json||o?.version_yaml,c=o?.version_json?"json":o?.version_yaml?"yaml":"generic";return void 0===u?e.mediaTypes.latest():e.mediaTypes.findBy(u,c)}async parse(t,e={}){let n;try{n=await this.findAdapter(t,e.mediaType)}catch(n){throw new Mt("Encountered an unexpected error while matching parser adapters against the source.",{source:t,parserOptions:e,cause:n})}if(mt(n))throw new Mt("Source did not match any registered parsers",{source:t,parserOptions:e});try{return n.parse(t,e)}catch(n){throw new Mt("Parsing encountered an unexpected error.",{source:t,parserOptions:e,cause:n})}}};return e})());

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@speclynx/apidom-parser",
+  "version": "1.12.1",
+  "description": "Parser consumes parser adapters and provides unified API for parsing.",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org",
+    "provenance": true
+  },
+  "type": "module",
+  "sideEffects": false,
+  "unpkg": "./dist/apidom-parser.browser.min.js",
+  "main": "./src/parser.cjs",
+  "exports": {
+    "types": "./types/apidom-parser.d.ts",
+    "import": "./src/parser.mjs",
+    "require": "./src/parser.cjs"
+  },
+  "types": "./types/apidom-parser.d.ts",
+  "scripts": {
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
+    "build:es": "cross-env BABEL_ENV=es babel src --out-dir src --extensions '.ts' --out-file-extension '.mjs' --root-mode 'upward'",
+    "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir src --extensions '.ts' --out-file-extension '.cjs' --root-mode 'upward'",
+    "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",
+    "lint": "eslint ./",
+    "lint:fix": "eslint ./ --fix",
+    "clean": "rimraf --glob 'src/**/*.mjs' 'src/**/*.cjs' 'test/**/*.mjs' ./dist ./types",
+    "typescript:check-types": "tsc --noEmit",
+    "typescript:declaration": "copyfiles -u 1 'src/**/*.d.ts' ./types && tsc -p tsconfig.declaration.json && api-extractor run -l -c ./config/api-extractor/api-extractor.json",
+    "test": "npm run build:es && cross-env BABEL_ENV=es babel test --out-dir test --extensions '.ts' --out-file-extension '.mjs' --root-mode 'upward' && cross-env NODE_ENV=test mocha",
+    "prepack": "copyfiles -u 3 ../../LICENSES/* LICENSES && copyfiles -u 2 ../../NOTICE .",
+    "postpack": "rimraf NOTICE LICENSES"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/speclynx/apidom.git"
+  },
+  "author": "Vladimir Gorej",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@babel/runtime-corejs3": "^7.28.4",
+    "@speclynx/apidom-core": "^1.12.1",
+    "@speclynx/apidom-error": "^1.12.1",
+    "@types/ramda": "~0.30.0",
+    "ramda": "~0.32.0",
+    "ramda-adjunct": "^6.0.0"
+  },
+  "files": [
+    "src/**/*.mjs",
+    "src/**/*.cjs",
+    "dist/",
+    "types/apidom-parser.d.ts",
+    "LICENSES",
+    "NOTICE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "gitHead": "49be88493f922c4ace2e4ebc0f23387ccb62c4fc"
+}

package/src/errors/ParserError.cjs

@@ -0,0 +1,24 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomError = require("@speclynx/apidom-error");
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class ParserError extends _apidomError.ApiDOMStructuredError {
+  source;
+  parserOptions;
+  constructor(message, structuredOptions) {
+    super(message, structuredOptions);
+    if (typeof structuredOptions !== 'undefined') {
+      this.source = structuredOptions.source;
+      this.parserOptions = structuredOptions.parserOptions;
+    }
+  }
+}
+var _default = exports.default = ParserError;

package/src/errors/ParserError.mjs

@@ -0,0 +1,21 @@
+import { ApiDOMStructuredError } from '@speclynx/apidom-error';
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class ParserError extends ApiDOMStructuredError {
+  source;
+  parserOptions;
+  constructor(message, structuredOptions) {
+    super(message, structuredOptions);
+    if (typeof structuredOptions !== 'undefined') {
+      this.source = structuredOptions.source;
+      this.parserOptions = structuredOptions.parserOptions;
+    }
+  }
+}
+export default ParserError;

package/src/parser.cjs

@@ -0,0 +1,101 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _ramda = require("ramda");
+var _ramdaAdjunct = require("ramda-adjunct");
+var _apidomCore = require("@speclynx/apidom-core");
+var _ParserError = _interopRequireDefault(require("./errors/ParserError.cjs"));
+exports.ParserError = _ParserError.default;
+/**
+ * @public
+ */
+class ApiDOMParser {
+  adapters = [];
+  async detectAdapterCandidates(source) {
+    const candidates = [];
+    for (const adapter of this.adapters) {
+      if ((0, _ramdaAdjunct.isFunction)(adapter.detect) && (await adapter.detect(source))) {
+        candidates.push(adapter);
+      }
+    }
+    return candidates;
+  }
+  async findAdapter(source, mediaType) {
+    if ((0, _ramdaAdjunct.isString)(mediaType)) {
+      return this.adapters.find(adapter => {
+        if (!(0, _ramdaAdjunct.isArray)(adapter.mediaTypes)) return false;
+        return adapter.mediaTypes.includes(mediaType);
+      });
+    }
+    const candidates = await this.detectAdapterCandidates(source);
+    return (0, _ramda.head)(candidates);
+  }
+  use(adapter) {
+    this.adapters.push(adapter);
+    return this;
+  }
+  async findNamespace(source, options = {}) {
+    const adapter = await this.findAdapter(source, options.mediaType);
+    return adapter?.namespace;
+  }
+  async findMediaType(source) {
+    const adapter = await this.findAdapter(source, undefined);
+    if (typeof adapter === 'undefined') {
+      return new _apidomCore.MediaTypes().unknownMediaType;
+    }
+    if (typeof adapter.mediaTypes === 'undefined') {
+      return new _apidomCore.MediaTypes().unknownMediaType;
+    }
+    if (typeof adapter.detectionRegExp === 'undefined') {
+      return adapter.mediaTypes.latest();
+    }
+    const {
+      detectionRegExp
+    } = adapter;
+    const matches = source.match(detectionRegExp);
+    if (matches === null) {
+      return new _apidomCore.MediaTypes().unknownMediaType;
+    }
+    const {
+      groups
+    } = matches;
+    const version = groups?.version || groups?.version_json || groups?.version_yaml;
+    const format = groups?.version_json ? 'json' : groups?.version_yaml ? 'yaml' : 'generic';
+    if (typeof version === 'undefined') {
+      return adapter.mediaTypes.latest();
+    }
+
+    // @ts-ignore
+    return adapter.mediaTypes.findBy(version, format);
+  }
+  async parse(source, options = {}) {
+    let adapter;
+    try {
+      adapter = await this.findAdapter(source, options.mediaType);
+    } catch (error) {
+      throw new _ParserError.default('Encountered an unexpected error while matching parser adapters against the source.', {
+        source,
+        parserOptions: options,
+        cause: error
+      });
+    }
+    if ((0, _ramdaAdjunct.isUndefined)(adapter)) {
+      throw new _ParserError.default('Source did not match any registered parsers', {
+        source,
+        parserOptions: options
+      });
+    }
+    try {
+      return adapter.parse(source, options);
+    } catch (error) {
+      throw new _ParserError.default('Parsing encountered an unexpected error.', {
+        source,
+        parserOptions: options,
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = ApiDOMParser;

package/src/parser.mjs

@@ -0,0 +1,97 @@
+import { head } from 'ramda';
+import { isArray, isFunction, isString, isUndefined } from 'ramda-adjunct';
+import { MediaTypes } from '@speclynx/apidom-core';
+import ParserError from "./errors/ParserError.mjs";
+export { ParserError };
+
+/**
+ * @public
+ */
+class ApiDOMParser {
+  adapters = [];
+  async detectAdapterCandidates(source) {
+    const candidates = [];
+    for (const adapter of this.adapters) {
+      if (isFunction(adapter.detect) && (await adapter.detect(source))) {
+        candidates.push(adapter);
+      }
+    }
+    return candidates;
+  }
+  async findAdapter(source, mediaType) {
+    if (isString(mediaType)) {
+      return this.adapters.find(adapter => {
+        if (!isArray(adapter.mediaTypes)) return false;
+        return adapter.mediaTypes.includes(mediaType);
+      });
+    }
+    const candidates = await this.detectAdapterCandidates(source);
+    return head(candidates);
+  }
+  use(adapter) {
+    this.adapters.push(adapter);
+    return this;
+  }
+  async findNamespace(source, options = {}) {
+    const adapter = await this.findAdapter(source, options.mediaType);
+    return adapter?.namespace;
+  }
+  async findMediaType(source) {
+    const adapter = await this.findAdapter(source, undefined);
+    if (typeof adapter === 'undefined') {
+      return new MediaTypes().unknownMediaType;
+    }
+    if (typeof adapter.mediaTypes === 'undefined') {
+      return new MediaTypes().unknownMediaType;
+    }
+    if (typeof adapter.detectionRegExp === 'undefined') {
+      return adapter.mediaTypes.latest();
+    }
+    const {
+      detectionRegExp
+    } = adapter;
+    const matches = source.match(detectionRegExp);
+    if (matches === null) {
+      return new MediaTypes().unknownMediaType;
+    }
+    const {
+      groups
+    } = matches;
+    const version = groups?.version || groups?.version_json || groups?.version_yaml;
+    const format = groups?.version_json ? 'json' : groups?.version_yaml ? 'yaml' : 'generic';
+    if (typeof version === 'undefined') {
+      return adapter.mediaTypes.latest();
+    }
+
+    // @ts-ignore
+    return adapter.mediaTypes.findBy(version, format);
+  }
+  async parse(source, options = {}) {
+    let adapter;
+    try {
+      adapter = await this.findAdapter(source, options.mediaType);
+    } catch (error) {
+      throw new ParserError('Encountered an unexpected error while matching parser adapters against the source.', {
+        source,
+        parserOptions: options,
+        cause: error
+      });
+    }
+    if (isUndefined(adapter)) {
+      throw new ParserError('Source did not match any registered parsers', {
+        source,
+        parserOptions: options
+      });
+    }
+    try {
+      return adapter.parse(source, options);
+    } catch (error) {
+      throw new ParserError('Parsing encountered an unexpected error.', {
+        source,
+        parserOptions: options,
+        cause: error
+      });
+    }
+  }
+}
+export default ApiDOMParser;

package/types/apidom-parser.d.ts

@@ -0,0 +1,68 @@
+import { ApiDOMErrorOptions } from '@speclynx/apidom-error';
+import { ApiDOMStructuredError } from '@speclynx/apidom-error';
+import { MediaTypes } from '@speclynx/apidom-core';
+import { Namespace } from '@speclynx/apidom-core';
+import { ParseResultElement } from '@speclynx/apidom-core';
+
+/**
+ * @public
+ */
+declare class ApiDOMParser {
+    private adapters;
+    protected detectAdapterCandidates(source: string): Promise<ApiDOMParserAdapter[]>;
+    protected findAdapter(source: string, mediaType: string | undefined): Promise<ApiDOMParserAdapter | undefined>;
+    use(adapter: ApiDOMParserAdapter): this;
+    findNamespace(source: string, options?: ApiDOMParserOptions): Promise<Namespace | undefined>;
+    findMediaType(source: string): Promise<string | void>;
+    parse(source: string, options?: ApiDOMParserOptions): Promise<ParseResultElement>;
+}
+export default ApiDOMParser;
+
+/**
+ * @public
+ */
+export declare interface ApiDOMParserAdapter {
+    detectionRegExp?: RegExp;
+    detect?: Detect;
+    mediaTypes?: MediaTypes<string>;
+    parse: Parse;
+    namespace: Namespace;
+}
+
+/**
+ * @public
+ */
+export declare interface ApiDOMParserOptions {
+    readonly mediaType?: string;
+    readonly sourceMap?: boolean;
+    [key: string]: unknown;
+}
+
+/**
+ * @public
+ */
+export declare type Detect = (source: string) => boolean | Promise<boolean>;
+
+/**
+ * @public
+ */
+export declare type Parse = (source: string, options?: ApiDOMParserOptions) => Promise<ParseResultElement>;
+
+/**
+ * @public
+ */
+export declare class ParserError extends ApiDOMStructuredError {
+    readonly source: string;
+    readonly parserOptions: ApiDOMParserOptions;
+    constructor(message?: string, structuredOptions?: ParserErrorOptions);
+}
+
+/**
+ * @public
+ */
+export declare interface ParserErrorOptions extends ApiDOMErrorOptions {
+    readonly source: string;
+    readonly parserOptions: ApiDOMParserOptions;
+}
+
+export { }