@speclynx/apidom-reference 2.6.1 → 2.8.0

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

@@ -2,7 +2,7 @@ import { pick } from 'ramda';
 import { parse, mediaTypes as ArazzoJSON1MediaTypes, detect } from '@speclynx/apidom-parser-adapter-arazzo-json-1';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
-import { parseSourceDescriptions } from "./source-description.mjs";
+import { parseSourceDescriptions } from "./source-descriptions.mjs";
 /**
  * @public
  */
@@ -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(parseResult, file.uri, options, this.name);
         parseResult.push(...sourceDescriptions);
       }
       return parseResult;
@@ -55,4 +52,5 @@ class ArazzoJSON1Parser extends Parser {
     }
   }
 }
+export { parseSourceDescriptions } from "./source-descriptions.mjs";
 export default ArazzoJSON1Parser;

package/src/parse/parsers/arazzo-json-1/{source-description.cjs → source-descriptions.cjs}

@@ -1,6 +1,7 @@
 "use strict";
 
 var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.parseSourceDescriptions = parseSourceDescriptions;
 var _apidomDatamodel = require("@speclynx/apidom-datamodel");
@@ -9,8 +10,10 @@ var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-2");
 var _apidomNsOpenapi2 = require("@speclynx/apidom-ns-openapi-3-0");
 var _apidomNsOpenapi3 = require("@speclynx/apidom-ns-openapi-3-1");
 var _apidomCore = require("@speclynx/apidom-core");
+var _File = _interopRequireDefault(require("../../../File.cjs"));
 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 +23,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 +35,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 +44,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 sourceDescriptionParseResult = await (0, _index.default)(retrievalURI, (0, _util.merge)(ctx.options, {
       parse: {
         mediaType: 'text/plain',
         // allow parser plugin detection
@@ -61,7 +64,7 @@ async function parseSourceDescription(sourceDescription, ctx) {
       }
     }));
     // merge parsed result into our parse result
-    for (const item of sdParseResult) {
+    for (const item of sourceDescriptionParseResult) {
       parseResult.push(item);
     }
   } catch (error) {
@@ -80,7 +83,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 +93,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);
     }
@@ -103,11 +106,40 @@ async function parseSourceDescription(sourceDescription, ctx) {
 }
 
 /**
- * Shared function for parsing source descriptions.
- * Call with `.call(this, ...)` where `this` has `name` and `parseFn` properties.
+ * Parses source descriptions from an Arazzo document's ParseResult.
+ *
+ * @param parseResult - ParseResult containing an Arazzo specification
+ * @param parseResultRetrievalURI - URI from which the parseResult was retrieved
+ * @param options - Full ReferenceOptions (caller responsibility to construct)
+ * @param parserName - Parser name for options lookup (defaults to 'arazzo-json-1')
+ * @returns Array of ParseResultElements. On success, returns one ParseResultElement per
+ *   source description (each with class 'source-description' and name/type metadata).
+ *   May return early with a single-element array containing a warning annotation when:
+ *   - The API is not an Arazzo specification
+ *   - The sourceDescriptions field is missing or not an array
+ *   - Maximum parse depth is exceeded (error annotation)
+ *   Returns an empty array when sourceDescriptions option is disabled or no names match.
+ *
+ * @example
+ * ```typescript
+ * import { options, mergeOptions } from '@speclynx/apidom-reference';
+ * import { parseSourceDescriptions } from '@speclynx/apidom-reference/parse/parsers/arazzo-json-1';
+ *
+ * const fullOptions = mergeOptions(options, {
+ *   parse: { parserOpts: { sourceDescriptions: true } }
+ * });
+ * const results = await parseSourceDescriptions(parseResult, uri, fullOptions);
+ * ```
+ *
  * @public
  */
-async function parseSourceDescriptions(api, file, options) {
+async function parseSourceDescriptions(parseResult, parseResultRetrievalURI, options, parserName = 'arazzo-json-1') {
+  const {
+    api
+  } = parseResult;
+  const file = new _File.default({
+    uri: url.sanitize(url.stripHash(parseResultRetrievalURI))
+  });
   const results = [];
 
   /**
@@ -115,23 +147,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 +175,6 @@ async function parseSourceDescriptions(api, file, options) {
     return [parseResult];
   }
   const ctx = {
-    parseFn: this.parseFn,
     baseURI: file.uri,
     options,
     currentDepth,
@@ -156,7 +182,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 → source-descriptions.mjs}

@@ -4,8 +4,10 @@ import { isSwaggerElement } from '@speclynx/apidom-ns-openapi-2';
 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 File from "../../../File.mjs";
 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 +16,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 +28,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 +37,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 sourceDescriptionParseResult = await parse(retrievalURI, mergeOptions(ctx.options, {
       parse: {
         mediaType: 'text/plain',
         // allow parser plugin detection
@@ -55,7 +57,7 @@ async function parseSourceDescription(sourceDescription, ctx) {
       }
     }));
     // merge parsed result into our parse result
-    for (const item of sdParseResult) {
+    for (const item of sourceDescriptionParseResult) {
       parseResult.push(item);
     }
   } catch (error) {
@@ -74,7 +76,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 +86,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);
     }
@@ -97,11 +99,40 @@ async function parseSourceDescription(sourceDescription, ctx) {
 }
 
 /**
- * Shared function for parsing source descriptions.
- * Call with `.call(this, ...)` where `this` has `name` and `parseFn` properties.
+ * Parses source descriptions from an Arazzo document's ParseResult.
+ *
+ * @param parseResult - ParseResult containing an Arazzo specification
+ * @param parseResultRetrievalURI - URI from which the parseResult was retrieved
+ * @param options - Full ReferenceOptions (caller responsibility to construct)
+ * @param parserName - Parser name for options lookup (defaults to 'arazzo-json-1')
+ * @returns Array of ParseResultElements. On success, returns one ParseResultElement per
+ *   source description (each with class 'source-description' and name/type metadata).
+ *   May return early with a single-element array containing a warning annotation when:
+ *   - The API is not an Arazzo specification
+ *   - The sourceDescriptions field is missing or not an array
+ *   - Maximum parse depth is exceeded (error annotation)
+ *   Returns an empty array when sourceDescriptions option is disabled or no names match.
+ *
+ * @example
+ * ```typescript
+ * import { options, mergeOptions } from '@speclynx/apidom-reference';
+ * import { parseSourceDescriptions } from '@speclynx/apidom-reference/parse/parsers/arazzo-json-1';
+ *
+ * const fullOptions = mergeOptions(options, {
+ *   parse: { parserOpts: { sourceDescriptions: true } }
+ * });
+ * const results = await parseSourceDescriptions(parseResult, uri, fullOptions);
+ * ```
+ *
  * @public
  */
-export async function parseSourceDescriptions(api, file, options) {
+export async function parseSourceDescriptions(parseResult, parseResultRetrievalURI, options, parserName = 'arazzo-json-1') {
+  const {
+    api
+  } = parseResult;
+  const file = new File({
+    uri: url.sanitize(url.stripHash(parseResultRetrievalURI))
+  });
   const results = [];
 
   /**
@@ -109,23 +140,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 +168,6 @@ export async function parseSourceDescriptions(api, file, options) {
     return [parseResult];
   }
   const ctx = {
-    parseFn: this.parseFn,
     baseURI: file.uri,
     options,
     currentDepth,
@@ -150,7 +175,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

@@ -7,7 +7,8 @@ var _ramda = require("ramda");
 var _apidomParserAdapterArazzoYaml = require("@speclynx/apidom-parser-adapter-arazzo-yaml-1");
 var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
 var _Parser = _interopRequireDefault(require("../Parser.cjs"));
-var _sourceDescription = require("../arazzo-json-1/source-description.cjs");
+var _sourceDescriptions = require("./source-descriptions.cjs");
+exports.parseSourceDescriptions = _sourceDescriptions.parseSourceDescriptions;
 /**
  * @public
  */
@@ -17,10 +18,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 +30,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 +48,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, _sourceDescriptions.parseSourceDescriptions)(parseResult, file.uri, options, this.name);
         parseResult.push(...sourceDescriptions);
       }
       return parseResult;

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

@@ -2,7 +2,7 @@ import { pick } from 'ramda';
 import { parse, mediaTypes as ArazzoYAML1MediaTypes, detect } from '@speclynx/apidom-parser-adapter-arazzo-yaml-1';
 import ParserError from "../../../errors/ParserError.mjs";
 import Parser from "../Parser.mjs";
-import { parseSourceDescriptions } from "../arazzo-json-1/source-description.mjs";
+import { parseSourceDescriptions } from "./source-descriptions.mjs";
 /**
  * @public
  */
@@ -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(parseResult, file.uri, options, this.name);
         parseResult.push(...sourceDescriptions);
       }
       return parseResult;
@@ -55,4 +52,5 @@ class ArazzoYAML1Parser extends Parser {
     }
   }
 }
+export { parseSourceDescriptions } from "./source-descriptions.mjs";
 export default ArazzoYAML1Parser;

package/src/parse/parsers/arazzo-yaml-1/source-descriptions.cjs

@@ -0,0 +1,12 @@
+"use strict";
+
+exports.__esModule = true;
+exports.parseSourceDescriptions = void 0;
+var _sourceDescriptions = require("../arazzo-json-1/source-descriptions.cjs");
+/**
+ * @public
+ */
+const parseSourceDescriptions = (parseResult, parseResultRetrievalURI, options, parserName = 'arazzo-yaml-1') => {
+  return (0, _sourceDescriptions.parseSourceDescriptions)(parseResult, parseResultRetrievalURI, options, parserName);
+};
+exports.parseSourceDescriptions = parseSourceDescriptions;

package/src/parse/parsers/arazzo-yaml-1/source-descriptions.mjs

@@ -0,0 +1,7 @@
+import { parseSourceDescriptions as parseSourceDescriptionsBase } from "../arazzo-json-1/source-descriptions.mjs";
+/**
+ * @public
+ */
+export const parseSourceDescriptions = (parseResult, parseResultRetrievalURI, options, parserName = 'arazzo-yaml-1') => {
+  return parseSourceDescriptionsBase(parseResult, parseResultRetrievalURI, options, parserName);
+};

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/types/dereference/strategies/arazzo-1/source-description.d.ts

@@ -0,0 +1,8 @@
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
+import Reference from '../../../Reference.ts';
+import type { ReferenceOptions } from '../../../options/index.ts';
+/**
+ * Dereferences source descriptions from an Arazzo document.
+ * @public
+ */
+export declare function dereferenceSourceDescriptions(parseResult: ParseResultElement, reference: Reference, options: ReferenceOptions): Promise<ParseResultElement[]>;

package/types/parse/parsers/arazzo-json-1/index.d.ts

@@ -2,23 +2,21 @@ import { ParseResultElement } from '@speclynx/apidom-datamodel';
 import Parser, { ParserOptions } from '../Parser.ts';
 import File from '../../../File.ts';
 import type { ReferenceOptions } from '../../../options/index.ts';
-import type ParseFn from '../../index.ts';
 export type { default as Parser, ParserOptions } from '../Parser.ts';
 export type { default as File, FileOptions } from '../../../File.ts';
 /**
  * @public
  */
 export interface ArazzoJSON1ParserOptions extends Omit<ParserOptions, 'name'> {
-    readonly parseFn?: typeof ParseFn;
 }
 /**
  * @public
  */
 declare class ArazzoJSON1Parser extends Parser {
     refractorOpts: object;
-    parseFn?: typeof ParseFn;
     constructor(options?: ArazzoJSON1ParserOptions);
     canParse(file: File): Promise<boolean>;
     parse(file: File, options?: ReferenceOptions): Promise<ParseResultElement>;
 }
+export { parseSourceDescriptions } from './source-descriptions.ts';
 export default ArazzoJSON1Parser;

package/types/parse/parsers/arazzo-json-1/source-descriptions.d.ts

@@ -0,0 +1,31 @@
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
+import type { ReferenceOptions } from '../../../options/index.ts';
+/**
+ * Parses source descriptions from an Arazzo document's ParseResult.
+ *
+ * @param parseResult - ParseResult containing an Arazzo specification
+ * @param parseResultRetrievalURI - URI from which the parseResult was retrieved
+ * @param options - Full ReferenceOptions (caller responsibility to construct)
+ * @param parserName - Parser name for options lookup (defaults to 'arazzo-json-1')
+ * @returns Array of ParseResultElements. On success, returns one ParseResultElement per
+ *   source description (each with class 'source-description' and name/type metadata).
+ *   May return early with a single-element array containing a warning annotation when:
+ *   - The API is not an Arazzo specification
+ *   - The sourceDescriptions field is missing or not an array
+ *   - Maximum parse depth is exceeded (error annotation)
+ *   Returns an empty array when sourceDescriptions option is disabled or no names match.
+ *
+ * @example
+ * ```typescript
+ * import { options, mergeOptions } from '@speclynx/apidom-reference';
+ * import { parseSourceDescriptions } from '@speclynx/apidom-reference/parse/parsers/arazzo-json-1';
+ *
+ * const fullOptions = mergeOptions(options, {
+ *   parse: { parserOpts: { sourceDescriptions: true } }
+ * });
+ * const results = await parseSourceDescriptions(parseResult, uri, fullOptions);
+ * ```
+ *
+ * @public
+ */
+export declare function parseSourceDescriptions(parseResult: ParseResultElement, parseResultRetrievalURI: string, options: ReferenceOptions, parserName?: string): Promise<ParseResultElement[]>;

package/types/parse/parsers/arazzo-yaml-1/index.d.ts

@@ -2,23 +2,21 @@ import { ParseResultElement } from '@speclynx/apidom-datamodel';
 import Parser, { ParserOptions } from '../Parser.ts';
 import File from '../../../File.ts';
 import type { ReferenceOptions } from '../../../options/index.ts';
-import type ParseFn from '../../index.ts';
 export type { default as Parser, ParserOptions } from '../Parser.ts';
 export type { default as File, FileOptions } from '../../../File.ts';
 /**
  * @public
  */
 export interface ArazzoYAML1ParserOptions extends Omit<ParserOptions, 'name'> {
-    readonly parseFn?: typeof ParseFn;
 }
 /**
  * @public
  */
 declare class ArazzoYAML1Parser extends Parser {
     refractorOpts: object;
-    parseFn?: typeof ParseFn;
     constructor(options?: ArazzoYAML1ParserOptions);
     canParse(file: File): Promise<boolean>;
     parse(file: File, options?: ReferenceOptions): Promise<ParseResultElement>;
 }
+export { parseSourceDescriptions } from './source-descriptions.ts';
 export default ArazzoYAML1Parser;

package/types/parse/parsers/arazzo-yaml-1/source-descriptions.d.ts

@@ -0,0 +1,6 @@
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
+import type { ReferenceOptions } from '../../../options/index.ts';
+/**
+ * @public
+ */
+export declare const parseSourceDescriptions: (parseResult: ParseResultElement, parseResultRetrievalURI: string, options: ReferenceOptions, parserName?: string) => Promise<ParseResultElement[]>;

package/types/parse/parsers/arazzo-json-1/source-description.d.ts

@@ -1,13 +0,0 @@
-import { Element, ParseResultElement } from '@speclynx/apidom-datamodel';
-import File from '../../../File.ts';
-import type { ReferenceOptions } from '../../../options/index.ts';
-import type ParseFn from '../../index.ts';
-/**
- * Shared function for parsing source descriptions.
- * Call with `.call(this, ...)` where `this` has `name` and `parseFn` properties.
- * @public
- */
-export declare function parseSourceDescriptions(this: {
-    name: string;
-    parseFn?: typeof ParseFn;
-}, api: Element | undefined, file: File, options: ReferenceOptions): Promise<ParseResultElement[]>;