@speclynx/apidom-reference 2.6.0 → 2.7.0

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

@@ -405,7 +405,7 @@ class OpenAPI3_1DereferenceVisitor {
 
     // operationRef and operationId fields are mutually exclusive
     if (isStringElement(linkElement.operationRef) && isStringElement(linkElement.operationId)) {
-      throw new ApiDOMError('LinkElement operationRef and operationId fields are mutually exclusive.');
+      throw new ApiDOMError('LinkElement operationRef and operationId fields are mutually exclusive');
     }
     let operationElement;
     if (isStringElement(linkElement.operationRef)) {
@@ -456,7 +456,7 @@ class OpenAPI3_1DereferenceVisitor {
       operationElement = find(reference.value.result, e => isOperationElement(e) && isElement(e.operationId) && e.operationId.equals(operationId));
       // OperationElement not found by its operationId
       if (isUndefined(operationElement)) {
-        throw new ApiDOMError(`OperationElement(operationId=${operationId}) not found.`);
+        throw new ApiDOMError(`OperationElement(operationId=${operationId}) not found`);
       }
       const linkElementCopy = cloneShallow(linkElement);
       linkElementCopy.operationId?.meta.set('operation', operationElement);
@@ -477,7 +477,7 @@ class OpenAPI3_1DereferenceVisitor {
 
     // value and externalValue fields are mutually exclusive
     if (exampleElement.hasKey('value') && isStringElement(exampleElement.externalValue)) {
-      throw new ApiDOMError('ExampleElement value and externalValue fields are mutually exclusive.');
+      throw new ApiDOMError('ExampleElement value and externalValue fields are mutually exclusive');
     }
     const retrievalURI = this.toBaseURI(toValue(exampleElement.externalValue));
     const isInternalReference = url.stripHash(this.reference.uri) === retrievalURI;

package/src/errors/InvalidJsonSchema$anchorError.cjs

@@ -9,7 +9,7 @@ var _JsonSchema$anchorError = _interopRequireDefault(require("./JsonSchema$ancho
  */
 class InvalidJsonSchema$anchorError extends _JsonSchema$anchorError.default {
   constructor(anchor) {
-    super(`Invalid JSON Schema $anchor "${anchor}".`);
+    super(`Invalid JSON Schema $anchor "${anchor}"`);
   }
 }
 var _default = exports.default = InvalidJsonSchema$anchorError;

package/src/errors/InvalidJsonSchema$anchorError.mjs

@@ -4,7 +4,7 @@ import JsonSchema$anchorError from "./JsonSchema$anchorError.mjs";
  */
 class InvalidJsonSchema$anchorError extends JsonSchema$anchorError {
   constructor(anchor) {
-    super(`Invalid JSON Schema $anchor "${anchor}".`);
+    super(`Invalid JSON Schema $anchor "${anchor}"`);
   }
 }
 export default InvalidJsonSchema$anchorError;

package/src/errors/UnmatchedParserError.cjs

@@ -0,0 +1,11 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _ParserError = _interopRequireDefault(require("./ParserError.cjs"));
+/**
+ * @public
+ */
+class UnmatchedParserError extends _ParserError.default {}
+var _default = exports.default = UnmatchedParserError;

package/src/errors/UnmatchedParserError.mjs

@@ -0,0 +1,6 @@
+import ParserError from "./ParserError.mjs";
+/**
+ * @public
+ */
+class UnmatchedParserError extends ParserError {}
+export default UnmatchedParserError;

package/src/index.cjs

@@ -3,7 +3,7 @@
 var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
 var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
-exports.url = exports.resolveApiDOM = exports.resolve = exports.readFile = exports.parse = exports.options = exports.mergeOptions = exports.dereferenceApiDOM = exports.dereference = exports.bundle = exports.UnmatchedResolverError = exports.UnmatchedResolveStrategyError = exports.UnmatchedDereferenceStrategyError = exports.UnmatchedBundleStrategyError = exports.ResolverError = exports.Resolver = exports.ResolveStrategy = exports.ResolveError = exports.Reference = exports.PluginError = exports.ParserError = exports.Parser = exports.ParseError = exports.MaximumResolveDepthError = exports.MaximumDereferenceDepthError = exports.MaximumBundleDepthError = exports.JsonSchemaURIError = exports.JsonSchema$anchorError = exports.InvalidJsonSchema$anchorError = exports.HTTPResolver = exports.EvaluationJsonSchemaUriError = exports.EvaluationJsonSchema$anchorError = exports.EvaluationElementIdError = exports.DereferenceStrategy = exports.DereferenceError = exports.DereferenceAncestorLineage = exports.BundleStrategy = exports.BundleError = void 0;
+exports.url = exports.resolveApiDOM = exports.resolve = exports.readFile = exports.parse = exports.options = exports.mergeOptions = exports.dereferenceApiDOM = exports.dereference = exports.bundle = exports.UnmatchedResolverError = exports.UnmatchedResolveStrategyError = exports.UnmatchedParserError = exports.UnmatchedDereferenceStrategyError = exports.UnmatchedBundleStrategyError = exports.ResolverError = exports.Resolver = exports.ResolveStrategy = exports.ResolveError = exports.Reference = exports.PluginError = exports.ParserError = exports.Parser = exports.ParseError = exports.MaximumResolveDepthError = exports.MaximumDereferenceDepthError = exports.MaximumBundleDepthError = exports.JsonSchemaURIError = exports.JsonSchema$anchorError = exports.InvalidJsonSchema$anchorError = exports.HTTPResolver = exports.EvaluationJsonSchemaUriError = exports.EvaluationJsonSchema$anchorError = exports.EvaluationElementIdError = exports.DereferenceStrategy = exports.DereferenceError = exports.DereferenceAncestorLineage = exports.BundleStrategy = exports.BundleError = void 0;
 var _File = _interopRequireDefault(require("./File.cjs"));
 exports.File = _File.default;
 var _ReferenceSet = _interopRequireDefault(require("./ReferenceSet.cjs"));
@@ -75,6 +75,8 @@ var _UnmatchedResolveStrategyError = _interopRequireDefault(require("./errors/Un
 exports.UnmatchedResolveStrategyError = _UnmatchedResolveStrategyError.default;
 var _UnmatchedResolverError = _interopRequireDefault(require("./errors/UnmatchedResolverError.cjs"));
 exports.UnmatchedResolverError = _UnmatchedResolverError.default;
+var _UnmatchedParserError = _interopRequireDefault(require("./errors/UnmatchedParserError.cjs"));
+exports.UnmatchedParserError = _UnmatchedParserError.default;
 /**
  * @public
  */

package/src/index.mjs

@@ -41,6 +41,7 @@ export { default as ResolverError } from "./errors/ResolverError.mjs";
 export { default as UnmatchedDereferenceStrategyError } from "./errors/UnmatchedDereferenceStrategyError.mjs";
 export { default as UnmatchedResolveStrategyError } from "./errors/UnmatchedResolveStrategyError.mjs";
 export { default as UnmatchedResolverError } from "./errors/UnmatchedResolverError.mjs";
+export { default as UnmatchedParserError } from "./errors/UnmatchedParserError.mjs";
 /**
  * @public
  */

package/src/parse/index.cjs

@@ -9,7 +9,7 @@ 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 _UnmatchedResolverError = _interopRequireDefault(require("../errors/UnmatchedResolverError.cjs"));
+var _UnmatchedParserError = _interopRequireDefault(require("../errors/UnmatchedParserError.cjs"));
 var _util = require("../resolve/util.cjs");
 /**
  * Parses the given file's contents, using the configured parser plugins.
@@ -23,7 +23,7 @@ const parseFile = async (file, options) => {
 
   // we couldn't find any parser for this File
   if ((0, _ramda.isEmpty)(parsers)) {
-    throw new _UnmatchedResolverError.default(file.uri);
+    throw new _UnmatchedParserError.default(`Could not find a parser that can parse the file "${file.uri}"`);
   }
   try {
     const {
@@ -33,7 +33,7 @@ const parseFile = async (file, options) => {
 
     // empty files handling
     if (!plugin.allowEmpty && result.isEmpty) {
-      return Promise.reject(new _ParseError.default(`Error while parsing file "${file.uri}". File is empty.`));
+      return Promise.reject(new _ParseError.default(`Error while parsing file "${file.uri}": file is empty`));
     }
     return result;
   } catch (error) {

package/src/parse/index.mjs

@@ -3,7 +3,7 @@ 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 UnmatchedResolverError from "../errors/UnmatchedResolverError.mjs";
+import UnmatchedParserError from "../errors/UnmatchedParserError.mjs";
 import { readFile } from "../resolve/util.mjs";
 /**
  * Parses the given file's contents, using the configured parser plugins.
@@ -17,7 +17,7 @@ const parseFile = async (file, options) => {
 
   // we couldn't find any parser for this File
   if (isEmpty(parsers)) {
-    throw new UnmatchedResolverError(file.uri);
+    throw new UnmatchedParserError(`Could not find a parser that can parse the file "${file.uri}"`);
   }
   try {
     const {
@@ -27,7 +27,7 @@ const parseFile = async (file, options) => {
 
     // empty files handling
     if (!plugin.allowEmpty && result.isEmpty) {
-      return Promise.reject(new ParseError(`Error while parsing file "${file.uri}". File is empty.`));
+      return Promise.reject(new ParseError(`Error while parsing file "${file.uri}": file is empty`));
     }
     return result;
   } catch (error) {

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

@@ -17,10 +17,8 @@ var _sourceDescription = require("./source-description.cjs");
  */
 class ArazzoJSON1Parser extends _Parser.default {
   refractorOpts;
-  parseFn;
   constructor(options) {
     const {
-      parseFn,
       fileExtensions = [],
       mediaTypes = _apidomParserAdapterArazzoJson.mediaTypes,
       ...rest
@@ -31,7 +29,6 @@ class ArazzoJSON1Parser extends _Parser.default {
       fileExtensions,
       mediaTypes
     });
-    this.parseFn = parseFn;
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
@@ -50,7 +47,7 @@ class ArazzoJSON1Parser extends _Parser.default {
       const parseResult = await (0, _apidomParserAdapterArazzoJson.parse)(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {
-        const sourceDescriptions = await _sourceDescription.parseSourceDescriptions.call(this, parseResult.api, file, options);
+        const sourceDescriptions = await (0, _sourceDescription.parseSourceDescriptions)(this.name, parseResult.api, file, options);
         parseResult.push(...sourceDescriptions);
       }
       return parseResult;

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

@@ -11,10 +11,8 @@ import { parseSourceDescriptions } from "./source-description.mjs";
  */
 class ArazzoJSON1Parser extends Parser {
   refractorOpts;
-  parseFn;
   constructor(options) {
     const {
-      parseFn,
       fileExtensions = [],
       mediaTypes = ArazzoJSON1MediaTypes,
       ...rest
@@ -25,7 +23,6 @@ class ArazzoJSON1Parser extends Parser {
       fileExtensions,
       mediaTypes
     });
-    this.parseFn = parseFn;
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
@@ -44,7 +41,7 @@ class ArazzoJSON1Parser extends Parser {
       const parseResult = await parse(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {
-        const sourceDescriptions = await parseSourceDescriptions.call(this, parseResult.api, file, options);
+        const sourceDescriptions = await parseSourceDescriptions(this.name, parseResult.api, file, options);
         parseResult.push(...sourceDescriptions);
       }
       return parseResult;

package/src/parse/parsers/arazzo-json-1/source-description.cjs

@@ -1,5 +1,6 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
 exports.__esModule = true;
 exports.parseSourceDescriptions = parseSourceDescriptions;
@@ -11,6 +12,7 @@ var _apidomNsOpenapi3 = require("@speclynx/apidom-ns-openapi-3-1");
 var _apidomCore = require("@speclynx/apidom-core");
 var url = _interopRequireWildcard(require("../../../util/url.cjs"));
 var _util = require("../../../options/util.cjs");
+var _index = _interopRequireDefault(require("../../index.cjs"));
 // shared key for recursion state (works across JSON/YAML parsers)
 const ARAZZO_RECURSION_KEY = 'arazzo-1';
 /**
@@ -20,7 +22,7 @@ const ARAZZO_RECURSION_KEY = 'arazzo-1';
 async function parseSourceDescription(sourceDescription, ctx) {
   const parseResult = new _apidomDatamodel.ParseResultElement();
   if (!(0, _apidomNsArazzo.isSourceDescriptionElement)(sourceDescription)) {
-    const annotation = new _apidomDatamodel.AnnotationElement('Element is not a valid SourceDescriptionElement. Skipping.');
+    const annotation = new _apidomDatamodel.AnnotationElement('Element is not a valid SourceDescriptionElement. Skipping');
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
@@ -32,7 +34,7 @@ async function parseSourceDescription(sourceDescription, ctx) {
   if ((0, _apidomDatamodel.isStringElement)(sourceDescription.type)) parseResult.setMetaProperty('type', (0, _apidomDatamodel.cloneDeep)(sourceDescription.type));
   const sourceDescriptionURI = (0, _apidomCore.toValue)(sourceDescription.url);
   if (typeof sourceDescriptionURI !== 'string') {
-    const annotation = new _apidomDatamodel.AnnotationElement('Source description URL is missing or not a string. Skipping.');
+    const annotation = new _apidomDatamodel.AnnotationElement('Source description URL is missing or not a string. Skipping');
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
@@ -41,14 +43,14 @@ async function parseSourceDescription(sourceDescription, ctx) {
 
   // skip if already visited (cycle detection)
   if (ctx.visitedUrls.has(retrievalURI)) {
-    const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" has already been visited. Skipping to prevent cycle.`);
+    const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" has already been visited. Skipping to prevent cycle`);
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
   }
   ctx.visitedUrls.add(retrievalURI);
   try {
-    const sdParseResult = await ctx.parseFn(retrievalURI, (0, _util.merge)(ctx.options, {
+    const sdParseResult = await (0, _index.default)(retrievalURI, (0, _util.merge)(ctx.options, {
       parse: {
         mediaType: 'text/plain',
         // allow parser plugin detection
@@ -80,7 +82,7 @@ async function parseSourceDescription(sourceDescription, ctx) {
   const isOpenApi = (0, _apidomNsOpenapi.isSwaggerElement)(sourceDescriptionAPI) || (0, _apidomNsOpenapi2.isOpenApi3_0Element)(sourceDescriptionAPI) || (0, _apidomNsOpenapi3.isOpenApi3_1Element)(sourceDescriptionAPI);
   const isArazzo = (0, _apidomNsArazzo.isArazzoSpecification1Element)(sourceDescriptionAPI);
   if (!isOpenApi && !isArazzo) {
-    const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" is not an OpenAPI or Arazzo document. Skipping.`);
+    const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" is not an OpenAPI or Arazzo document`);
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
@@ -90,11 +92,11 @@ async function parseSourceDescription(sourceDescription, ctx) {
   const declaredType = (0, _apidomCore.toValue)(sourceDescription.type);
   if (typeof declaredType === 'string') {
     if (declaredType === 'openapi' && !isOpenApi) {
-      const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" declared as "openapi" but parsed as Arazzo document.`);
+      const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" declared as "openapi" but parsed as Arazzo document`);
       annotation.classes.push('warning');
       parseResult.push(annotation);
     } else if (declaredType === 'arazzo' && !isArazzo) {
-      const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" declared as "arazzo" but parsed as OpenAPI document.`);
+      const annotation = new _apidomDatamodel.AnnotationElement(`Source description "${retrievalURI}" declared as "arazzo" but parsed as OpenAPI document`);
       annotation.classes.push('warning');
       parseResult.push(annotation);
     }
@@ -104,10 +106,9 @@ async function parseSourceDescription(sourceDescription, ctx) {
 
 /**
  * Shared function for parsing source descriptions.
- * Call with `.call(this, ...)` where `this` has `name` and `parseFn` properties.
  * @public
  */
-async function parseSourceDescriptions(api, file, options) {
+async function parseSourceDescriptions(parserName, api, file, options) {
   const results = [];
 
   /**
@@ -115,23 +116,18 @@ async function parseSourceDescriptions(api, file, options) {
    * Return warning annotations if validation fails.
    */
   if (!(0, _apidomNsArazzo.isArazzoSpecification1Element)(api)) {
-    const annotation = new _apidomDatamodel.AnnotationElement('Cannot parse source descriptions: API is not an Arazzo specification.');
+    const annotation = new _apidomDatamodel.AnnotationElement('Cannot parse source descriptions: API is not an Arazzo specification');
     annotation.classes.push('warning');
     return [new _apidomDatamodel.ParseResultElement([annotation])];
   }
   if (!(0, _apidomDatamodel.isArrayElement)(api.sourceDescriptions)) {
-    const annotation = new _apidomDatamodel.AnnotationElement('Cannot parse source descriptions: sourceDescriptions field is missing or not an array.');
+    const annotation = new _apidomDatamodel.AnnotationElement('Cannot parse source descriptions: sourceDescriptions field is missing or not an array');
     annotation.classes.push('warning');
     return [new _apidomDatamodel.ParseResultElement([annotation])];
   }
-  if (typeof this.parseFn !== 'function') {
-    const annotation = new _apidomDatamodel.AnnotationElement('Source descriptions found but parseFn is not configured. Skipping source description parsing.');
-    annotation.classes.push('error');
-    return [new _apidomDatamodel.ParseResultElement([annotation])];
-  }
 
   // user config: parser-specific options take precedence over global parserOpts
-  const maxDepth = options?.parse?.parserOpts?.[this.name]?.sourceDescriptionsMaxDepth ?? options?.parse?.parserOpts?.sourceDescriptionsMaxDepth ?? +Infinity;
+  const maxDepth = options?.parse?.parserOpts?.[parserName]?.sourceDescriptionsMaxDepth ?? options?.parse?.parserOpts?.sourceDescriptionsMaxDepth ?? +Infinity;
 
   // recursion state comes from shared key (works across JSON/YAML)
   const sharedOpts = options?.parse?.parserOpts?.[ARAZZO_RECURSION_KEY] ?? {};
@@ -148,7 +144,6 @@ async function parseSourceDescriptions(api, file, options) {
     return [parseResult];
   }
   const ctx = {
-    parseFn: this.parseFn,
     baseURI: file.uri,
     options,
     currentDepth,
@@ -156,7 +151,7 @@ async function parseSourceDescriptions(api, file, options) {
   };
 
   // determine which source descriptions to parse
-  const sourceDescriptionsOption = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
+  const sourceDescriptionsOption = options?.parse?.parserOpts?.[parserName]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
 
   // handle false or other falsy values - no source descriptions should be parsed
   if (!sourceDescriptionsOption) {

package/src/parse/parsers/arazzo-json-1/source-description.mjs

@@ -5,7 +5,8 @@ import { isOpenApi3_0Element } from '@speclynx/apidom-ns-openapi-3-0';
 import { isOpenApi3_1Element } from '@speclynx/apidom-ns-openapi-3-1';
 import { toValue } from '@speclynx/apidom-core';
 import * as url from "../../../util/url.mjs";
-import { merge as mergeOptions } from "../../../options/util.mjs"; // shared key for recursion state (works across JSON/YAML parsers)
+import { merge as mergeOptions } from "../../../options/util.mjs";
+import parse from "../../index.mjs"; // shared key for recursion state (works across JSON/YAML parsers)
 const ARAZZO_RECURSION_KEY = 'arazzo-1';
 /**
  * Parses a single source description element.
@@ -14,7 +15,7 @@ const ARAZZO_RECURSION_KEY = 'arazzo-1';
 async function parseSourceDescription(sourceDescription, ctx) {
   const parseResult = new ParseResultElement();
   if (!isSourceDescriptionElement(sourceDescription)) {
-    const annotation = new AnnotationElement('Element is not a valid SourceDescriptionElement. Skipping.');
+    const annotation = new AnnotationElement('Element is not a valid SourceDescriptionElement. Skipping');
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
@@ -26,7 +27,7 @@ async function parseSourceDescription(sourceDescription, ctx) {
   if (isStringElement(sourceDescription.type)) parseResult.setMetaProperty('type', cloneDeep(sourceDescription.type));
   const sourceDescriptionURI = toValue(sourceDescription.url);
   if (typeof sourceDescriptionURI !== 'string') {
-    const annotation = new AnnotationElement('Source description URL is missing or not a string. Skipping.');
+    const annotation = new AnnotationElement('Source description URL is missing or not a string. Skipping');
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
@@ -35,14 +36,14 @@ async function parseSourceDescription(sourceDescription, ctx) {
 
   // skip if already visited (cycle detection)
   if (ctx.visitedUrls.has(retrievalURI)) {
-    const annotation = new AnnotationElement(`Source description "${retrievalURI}" has already been visited. Skipping to prevent cycle.`);
+    const annotation = new AnnotationElement(`Source description "${retrievalURI}" has already been visited. Skipping to prevent cycle`);
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
   }
   ctx.visitedUrls.add(retrievalURI);
   try {
-    const sdParseResult = await ctx.parseFn(retrievalURI, mergeOptions(ctx.options, {
+    const sdParseResult = await parse(retrievalURI, mergeOptions(ctx.options, {
       parse: {
         mediaType: 'text/plain',
         // allow parser plugin detection
@@ -74,7 +75,7 @@ async function parseSourceDescription(sourceDescription, ctx) {
   const isOpenApi = isSwaggerElement(sourceDescriptionAPI) || isOpenApi3_0Element(sourceDescriptionAPI) || isOpenApi3_1Element(sourceDescriptionAPI);
   const isArazzo = isArazzoSpecification1Element(sourceDescriptionAPI);
   if (!isOpenApi && !isArazzo) {
-    const annotation = new AnnotationElement(`Source description "${retrievalURI}" is not an OpenAPI or Arazzo document. Skipping.`);
+    const annotation = new AnnotationElement(`Source description "${retrievalURI}" is not an OpenAPI or Arazzo document`);
     annotation.classes.push('warning');
     parseResult.push(annotation);
     return parseResult;
@@ -84,11 +85,11 @@ async function parseSourceDescription(sourceDescription, ctx) {
   const declaredType = toValue(sourceDescription.type);
   if (typeof declaredType === 'string') {
     if (declaredType === 'openapi' && !isOpenApi) {
-      const annotation = new AnnotationElement(`Source description "${retrievalURI}" declared as "openapi" but parsed as Arazzo document.`);
+      const annotation = new AnnotationElement(`Source description "${retrievalURI}" declared as "openapi" but parsed as Arazzo document`);
       annotation.classes.push('warning');
       parseResult.push(annotation);
     } else if (declaredType === 'arazzo' && !isArazzo) {
-      const annotation = new AnnotationElement(`Source description "${retrievalURI}" declared as "arazzo" but parsed as OpenAPI document.`);
+      const annotation = new AnnotationElement(`Source description "${retrievalURI}" declared as "arazzo" but parsed as OpenAPI document`);
       annotation.classes.push('warning');
       parseResult.push(annotation);
     }
@@ -98,10 +99,9 @@ async function parseSourceDescription(sourceDescription, ctx) {
 
 /**
  * Shared function for parsing source descriptions.
- * Call with `.call(this, ...)` where `this` has `name` and `parseFn` properties.
  * @public
  */
-export async function parseSourceDescriptions(api, file, options) {
+export async function parseSourceDescriptions(parserName, api, file, options) {
   const results = [];
 
   /**
@@ -109,23 +109,18 @@ export async function parseSourceDescriptions(api, file, options) {
    * Return warning annotations if validation fails.
    */
   if (!isArazzoSpecification1Element(api)) {
-    const annotation = new AnnotationElement('Cannot parse source descriptions: API is not an Arazzo specification.');
+    const annotation = new AnnotationElement('Cannot parse source descriptions: API is not an Arazzo specification');
     annotation.classes.push('warning');
     return [new ParseResultElement([annotation])];
   }
   if (!isArrayElement(api.sourceDescriptions)) {
-    const annotation = new AnnotationElement('Cannot parse source descriptions: sourceDescriptions field is missing or not an array.');
+    const annotation = new AnnotationElement('Cannot parse source descriptions: sourceDescriptions field is missing or not an array');
     annotation.classes.push('warning');
     return [new ParseResultElement([annotation])];
   }
-  if (typeof this.parseFn !== 'function') {
-    const annotation = new AnnotationElement('Source descriptions found but parseFn is not configured. Skipping source description parsing.');
-    annotation.classes.push('error');
-    return [new ParseResultElement([annotation])];
-  }
 
   // user config: parser-specific options take precedence over global parserOpts
-  const maxDepth = options?.parse?.parserOpts?.[this.name]?.sourceDescriptionsMaxDepth ?? options?.parse?.parserOpts?.sourceDescriptionsMaxDepth ?? +Infinity;
+  const maxDepth = options?.parse?.parserOpts?.[parserName]?.sourceDescriptionsMaxDepth ?? options?.parse?.parserOpts?.sourceDescriptionsMaxDepth ?? +Infinity;
 
   // recursion state comes from shared key (works across JSON/YAML)
   const sharedOpts = options?.parse?.parserOpts?.[ARAZZO_RECURSION_KEY] ?? {};
@@ -142,7 +137,6 @@ export async function parseSourceDescriptions(api, file, options) {
     return [parseResult];
   }
   const ctx = {
-    parseFn: this.parseFn,
     baseURI: file.uri,
     options,
     currentDepth,
@@ -150,7 +144,7 @@ export async function parseSourceDescriptions(api, file, options) {
   };
 
   // determine which source descriptions to parse
-  const sourceDescriptionsOption = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
+  const sourceDescriptionsOption = options?.parse?.parserOpts?.[parserName]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
 
   // handle false or other falsy values - no source descriptions should be parsed
   if (!sourceDescriptionsOption) {

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

@@ -17,10 +17,8 @@ var _sourceDescription = require("../arazzo-json-1/source-description.cjs");
  */
 class ArazzoYAML1Parser extends _Parser.default {
   refractorOpts;
-  parseFn;
   constructor(options) {
     const {
-      parseFn,
       fileExtensions = [],
       mediaTypes = _apidomParserAdapterArazzoYaml.mediaTypes,
       ...rest
@@ -31,7 +29,6 @@ class ArazzoYAML1Parser extends _Parser.default {
       fileExtensions,
       mediaTypes
     });
-    this.parseFn = parseFn;
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
@@ -50,7 +47,7 @@ class ArazzoYAML1Parser extends _Parser.default {
       const parseResult = await (0, _apidomParserAdapterArazzoYaml.parse)(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {
-        const sourceDescriptions = await _sourceDescription.parseSourceDescriptions.call(this, parseResult.api, file, options);
+        const sourceDescriptions = await (0, _sourceDescription.parseSourceDescriptions)(this.name, parseResult.api, file, options);
         parseResult.push(...sourceDescriptions);
       }
       return parseResult;

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

@@ -11,10 +11,8 @@ import { parseSourceDescriptions } from "../arazzo-json-1/source-description.mjs
  */
 class ArazzoYAML1Parser extends Parser {
   refractorOpts;
-  parseFn;
   constructor(options) {
     const {
-      parseFn,
       fileExtensions = [],
       mediaTypes = ArazzoYAML1MediaTypes,
       ...rest
@@ -25,7 +23,6 @@ class ArazzoYAML1Parser extends Parser {
       fileExtensions,
       mediaTypes
     });
-    this.parseFn = parseFn;
   }
   async canParse(file) {
     const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
@@ -44,7 +41,7 @@ class ArazzoYAML1Parser extends Parser {
       const parseResult = await parse(source, parserOpts);
       const shouldParseSourceDescriptions = options?.parse?.parserOpts?.[this.name]?.sourceDescriptions ?? options?.parse?.parserOpts?.sourceDescriptions;
       if (shouldParseSourceDescriptions) {
-        const sourceDescriptions = await parseSourceDescriptions.call(this, parseResult.api, file, options);
+        const sourceDescriptions = await parseSourceDescriptions(this.name, parseResult.api, file, options);
         parseResult.push(...sourceDescriptions);
       }
       return parseResult;

package/src/resolve/index.cjs

@@ -35,9 +35,9 @@ const resolveApiDOM = async (element, options) => {
   });
   const resolveStrategies = await plugins.filter('canResolve', [file, options], options.resolve.strategies);
 
-  // we couldn't find any resolver for this File
+  // we couldn't find any resolve strategy for this File
   if ((0, _ramda.isEmpty)(resolveStrategies)) {
-    throw new _UnmatchedResolveStrategyError.default(file.uri);
+    throw new _UnmatchedResolveStrategyError.default(`Could not find a resolve strategy that can resolve the file "${file.uri}"`);
   }
   try {
     const {

package/src/resolve/index.mjs

@@ -29,9 +29,9 @@ export const resolveApiDOM = async (element, options) => {
   });
   const resolveStrategies = await plugins.filter('canResolve', [file, options], options.resolve.strategies);
 
-  // we couldn't find any resolver for this File
+  // we couldn't find any resolve strategy for this File
   if (isEmpty(resolveStrategies)) {
-    throw new UnmatchedResolveStrategyError(file.uri);
+    throw new UnmatchedResolveStrategyError(`Could not find a resolve strategy that can resolve the file "${file.uri}"`);
   }
   try {
     const {

package/src/resolve/resolvers/file/index-browser.cjs

@@ -18,7 +18,7 @@ class FileResolver extends _Resolver.default {
     return false;
   }
   read() {
-    throw new _ResolverError.default('FileResolver is not intended to be used in browser context.');
+    throw new _ResolverError.default('FileResolver is not intended to be used in browser context');
   }
 }
 var _default = exports.default = FileResolver;

package/src/resolve/resolvers/file/index-browser.mjs

@@ -13,7 +13,7 @@ class FileResolver extends Resolver {
     return false;
   }
   read() {
-    throw new ResolverError('FileResolver is not intended to be used in browser context.');
+    throw new ResolverError('FileResolver is not intended to be used in browser context');
   }
 }
 export default FileResolver;

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

@@ -31,7 +31,7 @@ class ApiDOMResolveStrategy extends _ResolveStrategy.default {
   async resolve(file, options) {
     const dereferenceStrategy = options.dereference.strategies.find(strategy => strategy.name === 'apidom');
     if (dereferenceStrategy === undefined) {
-      throw new _UnmatchedDereferenceStrategyError.default('"apidom" dereference strategy is not available.');
+      throw new _UnmatchedDereferenceStrategyError.default(`"apidom" resolve strategy requires "apidom" dereference strategy to be configured for file "${file.uri}"`);
     }
     const refSet = new _ReferenceSet.default();
     const mergedOptions = (0, _util.merge)(options, {

package/src/resolve/strategies/apidom/index.mjs

@@ -25,7 +25,7 @@ class ApiDOMResolveStrategy extends ResolveStrategy {
   async resolve(file, options) {
     const dereferenceStrategy = options.dereference.strategies.find(strategy => strategy.name === 'apidom');
     if (dereferenceStrategy === undefined) {
-      throw new UnmatchedDereferenceStrategyError('"apidom" dereference strategy is not available.');
+      throw new UnmatchedDereferenceStrategyError(`"apidom" resolve strategy requires "apidom" dereference strategy to be configured for file "${file.uri}"`);
     }
     const refSet = new ReferenceSet();
     const mergedOptions = mergeOptions(options, {

package/src/resolve/strategies/asyncapi-2/index.cjs

@@ -31,7 +31,7 @@ class AsyncAPI2ResolveStrategy extends _ResolveStrategy.default {
   async resolve(file, options) {
     const dereferenceStrategy = options.dereference.strategies.find(strategy => strategy.name === 'asyncapi-2');
     if (dereferenceStrategy === undefined) {
-      throw new _UnmatchedDereferenceStrategyError.default('"asyncapi-2" dereference strategy is not available.');
+      throw new _UnmatchedDereferenceStrategyError.default(`"asyncapi-2" resolve strategy requires "asyncapi-2" dereference strategy to be configured for file "${file.uri}"`);
     }
     const refSet = new _ReferenceSet.default();
     const mergedOptions = (0, _util.merge)(options, {

package/src/resolve/strategies/asyncapi-2/index.mjs

@@ -25,7 +25,7 @@ class AsyncAPI2ResolveStrategy extends ResolveStrategy {
   async resolve(file, options) {
     const dereferenceStrategy = options.dereference.strategies.find(strategy => strategy.name === 'asyncapi-2');
     if (dereferenceStrategy === undefined) {
-      throw new UnmatchedDereferenceStrategyError('"asyncapi-2" dereference strategy is not available.');
+      throw new UnmatchedDereferenceStrategyError(`"asyncapi-2" resolve strategy requires "asyncapi-2" dereference strategy to be configured for file "${file.uri}"`);
     }
     const refSet = new ReferenceSet();
     const mergedOptions = mergeOptions(options, {

package/src/resolve/strategies/openapi-2/index.cjs

@@ -31,7 +31,7 @@ class OpenAPI2ResolveStrategy extends _ResolveStrategy.default {
   async resolve(file, options) {
     const dereferenceStrategy = options.dereference.strategies.find(strategy => strategy.name === 'openapi-2');
     if (dereferenceStrategy === undefined) {
-      throw new _UnmatchedDereferenceStrategyError.default('"openapi-2" dereference strategy is not available.');
+      throw new _UnmatchedDereferenceStrategyError.default(`"openapi-2" resolve strategy requires "openapi-2" dereference strategy to be configured for file "${file.uri}"`);
     }
     const refSet = new _ReferenceSet.default();
     const mergedOptions = (0, _util.merge)(options, {

package/src/resolve/strategies/openapi-2/index.mjs

@@ -25,7 +25,7 @@ class OpenAPI2ResolveStrategy extends ResolveStrategy {
   async resolve(file, options) {
     const dereferenceStrategy = options.dereference.strategies.find(strategy => strategy.name === 'openapi-2');
     if (dereferenceStrategy === undefined) {
-      throw new UnmatchedDereferenceStrategyError('"openapi-2" dereference strategy is not available.');
+      throw new UnmatchedDereferenceStrategyError(`"openapi-2" resolve strategy requires "openapi-2" dereference strategy to be configured for file "${file.uri}"`);
     }
     const refSet = new ReferenceSet();
     const mergedOptions = mergeOptions(options, {