@usearazzo/parser 1.0.1-alpha.1 → 1.0.1-alpha.2

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.0.1-alpha.2](https://github.com/usearazzo/arazzo-toolkit/compare/v1.0.1-alpha.1...v1.0.1-alpha.2) (2026-09-08)
+
+### Bug Fixes
+
+- **parser:** resolve relative file paths against working directory ([#148](https://github.com/usearazzo/arazzo-toolkit/issues/148)) ([41b5b22](https://github.com/usearazzo/arazzo-toolkit/commit/41b5b22ff1940b13b5c6419ac8787c1d722483b2)), closes [#147](https://github.com/usearazzo/arazzo-toolkit/issues/147)
+
 ## 1.0.1-alpha.1 (2026-09-08)
 
 - refactor(validator)!: remove CLI layer and fix URI resolution (#11) ([76f8556](https://github.com/usearazzo/arazzo-toolkit/commit/76f8556bbece403c38dc8f68e020ab359fee563c)), closes [#11](https://github.com/usearazzo/arazzo-toolkit/issues/11)

package/README.md

@@ -37,6 +37,8 @@ The expression and condition parsers are pure syntax parsers: a string in, an AS
 
 Documents come back as ApiDOM, so source positions for editor tooling, formatting-preserving round trips, and one-call parsing of every source description an Arazzo document points at are all options away.
 
+A relative file system path resolves against the current working directory, so `./samples/onboarding.arazzo.yaml` and `path.resolve('samples/onboarding.arazzo.yaml')` are equivalent.
+
 ## Installation
 
 ```sh

package/dist/arazzo-parser.browser.js

@@ -204,9 +204,11 @@ const defaultOptions = {
  * The function handles three types of input:
  * 1. Object - converts to JSON string and parses (source maps supported with `strict: false`)
  * 2. String content - uses Arazzo detection to identify and parse inline JSON or YAML content
- * 3. URI string - if not detected as Arazzo content, treats as file system path or HTTP(S) URL
+ * 3. URI string - if not detected as Arazzo content, treats as file system path or HTTP(S) URL.
+ *    A relative file system path resolves against the current working directory.
  *
- * @param source - The Arazzo Document as an object, string content, or a file system path / HTTP(S) URL
+ * @param source - The Arazzo Document as an object, string content, or a file system path / HTTP(S) URL.
+ *   A relative file system path resolves against the current working directory.
  * @param options - Reference options (uses defaultOptions when not provided)
  * @returns A promise that resolves to the parsed Arazzo Document as ApiDOM data model
  * @throws ParseError - When parsing fails for any reason. The original error is available via the `cause` property.
@@ -265,6 +267,18 @@ async function parse(source, options = {}) {
     sourceProvenance = '[inline YAML]';
   } else {
     sourceProvenance = _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.isHttpUrl(source) || _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.getProtocol(source) === 'file' || _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.isURI(`file://${source}`) ? source : '[inline CONTENT]';
+
+    // a relative file system path resolves against the current working directory; the string
+    // doubles as the base URI for relative source description URLs, where a relative base
+    // resolves against the filesystem root instead of the document. Not gated on the
+    // provenance above: isURI(`file://${source}`) rejects a first segment with a space,
+    // which is a valid relative path. A leading slash or backslash (UNC, drive-rooted) is
+    // already rooted and passes through untouched. RegExp.test coerces a null/undefined
+    // passed at runtime despite the string type, deferring to parseURI below for a proper
+    // ParseError instead of throwing here.
+    if (!_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.isHttpUrl(source) && _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.getProtocol(source) !== 'file' && !/^[\\/]/.test(source)) {
+      source = _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.resolve(_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.fromFileSystemPath(_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.cwd()), source);
+    }
   }
 
   // in-memory documents are served under their synthetic memory:// URI, or under the
@@ -407,23 +421,24 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   parse: () => (/* binding */ parse)
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(212);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(76680);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(41643);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(48834);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(52393);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(61275);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(28208);
-/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(10343);
-/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(43244);
-/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(50142);
-/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(99474);
-/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_2__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(64820);
-/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(71527);
-/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(34606);
-/* harmony import */ var _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(10425);
-/* harmony import */ var _options_util_ts__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(86547);
-/* harmony import */ var _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(30513);
-/* harmony import */ var _parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(30089);
+/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(30698);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(76680);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(41643);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(48834);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(52393);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(61275);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(28208);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(10343);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(43244);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(50142);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(99474);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_2__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(64820);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(71527);
+/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(34606);
+/* harmony import */ var _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(10425);
+/* harmony import */ var _options_util_ts__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(86547);
+/* harmony import */ var _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(30513);
+/* harmony import */ var _parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(30089);
 
 
 
@@ -454,25 +469,25 @@ __webpack_require__.r(__webpack_exports__);
  */
 const defaultOptions = {
   parse: {
-    parsers: [new _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_1__["default"]({
+    parsers: [new _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_2__["default"]({
       allowEmpty: false
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_2__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_3__["default"]({
       allowEmpty: false
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_3__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_4__["default"]({
       allowEmpty: false
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_4__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_5__["default"]({
       allowEmpty: false
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_5__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_6__["default"]({
       allowEmpty: false
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_6__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_7__["default"]({
       allowEmpty: false
     })],
     parserOpts: {
-      ..._parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_17__.defaultOptions.parse.parserOpts
+      ..._parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_18__.defaultOptions.parse.parserOpts
     }
   },
   resolve: {
-    resolvers: [..._parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_17__.defaultOptions.resolve.resolvers],
+    resolvers: [..._parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_18__.defaultOptions.resolve.resolvers],
     resolverOpts: {}
   }
 };
@@ -510,9 +525,11 @@ const defaultOptions = {
  * The function handles three types of input:
  * 1. Object - converts to JSON string and parses (source maps supported with `strict: false`)
  * 2. String content - uses OpenAPI detection to identify and parse inline JSON or YAML content
- * 3. URI string - if not detected as OpenAPI content, treats as file system path or HTTP(S) URL
+ * 3. URI string - if not detected as OpenAPI content, treats as file system path or HTTP(S) URL.
+ *    A relative file system path resolves against the current working directory.
  *
- * @param source - The OpenAPI Document as an object, string content, or a file system path / HTTP(S) URL
+ * @param source - The OpenAPI Document as an object, string content, or a file system path / HTTP(S) URL.
+ *   A relative file system path resolves against the current working directory.
  * @param options - Reference options (uses defaultOptions when not provided)
  * @returns A promise that resolves to the parsed OpenAPI Document as ApiDOM data model
  * @throws ParseError - When parsing fails for any reason. The original error is available via the `cause` property.
@@ -549,45 +566,45 @@ const defaultOptions = {
  * @public
  */
 async function parse(source, options = {}) {
-  let mergedOptions = (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_15__.mergeOptions)(defaultOptions, options);
+  let mergedOptions = (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_16__.mergeOptions)(defaultOptions, options);
   const strict = mergedOptions.parse?.parserOpts?.strict ?? true;
   let sourceProvenance;
   let document;
-  if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_13__["default"])(source)) {
+  if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_14__["default"])(source)) {
     document = JSON.stringify(source, null, 2);
     source = 'memory://openapi.json';
     sourceProvenance = '[object]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_2__WEBPACK_IMPORTED_MODULE_11__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_2__WEBPACK_IMPORTED_MODULE_12__.detect)(source, {
     strict
   })) {
     document = source;
     source = 'memory://openapi.json';
     sourceProvenance = '[inline JSON]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_12__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_13__.detect)(source, {
     strict
   })) {
     document = source;
     source = 'memory://openapi.yaml';
     sourceProvenance = '[inline YAML]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_9__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_10__.detect)(source, {
     strict
   })) {
     document = source;
     source = 'memory://openapi.json';
     sourceProvenance = '[inline JSON]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_10__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_11__.detect)(source, {
     strict
   })) {
     document = source;
     source = 'memory://openapi.yaml';
     sourceProvenance = '[inline YAML]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_7__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_8__.detect)(source, {
     strict
   })) {
     document = source;
     source = 'memory://openapi.json';
     sourceProvenance = '[inline JSON]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_8__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_9__.detect)(source, {
     strict
   })) {
     document = source;
@@ -595,6 +612,16 @@ async function parse(source, options = {}) {
     sourceProvenance = '[inline YAML]';
   } else {
     sourceProvenance = source;
+
+    // a relative file system path resolves against the current working directory; the string
+    // doubles as the base URI for relative references, where a relative base resolves against
+    // the filesystem root instead of the document. A leading slash or backslash (UNC,
+    // drive-rooted) is already rooted and passes through untouched. RegExp.test coerces a
+    // null/undefined passed at runtime despite the string type, deferring to parseURI below
+    // for a proper ParseError instead of throwing here.
+    if (!_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.isHttpUrl(source) && _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.getProtocol(source) !== 'file' && !/^[\\/]/.test(source)) {
+      source = _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.resolve(_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.fromFileSystemPath(_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.cwd()), source);
+    }
   }
 
   // in-memory documents are served under their synthetic memory:// URI, or under the
@@ -602,9 +629,9 @@ async function parse(source, options = {}) {
   if (document !== undefined) {
     // raw options, not merged: mergeOptions defaults baseURI to the current working directory
     source = options.resolve?.baseURI || source;
-    mergedOptions = (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_15__.mergeOptions)(mergedOptions, {
+    mergedOptions = (0,_options_util_ts__WEBPACK_IMPORTED_MODULE_16__.mergeOptions)(mergedOptions, {
       resolve: {
-        resolvers: [...mergedOptions.resolve.resolvers, new _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_16__["default"]({
+        resolvers: [...mergedOptions.resolve.resolvers, new _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_17__["default"]({
           document,
           uri: source
         })]
@@ -622,7 +649,7 @@ async function parse(source, options = {}) {
     }
     return parseResult;
   } catch (error) {
-    throw new _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_14__["default"](`Failed to parse OpenAPI Document from "${sourceProvenance}"`, {
+    throw new _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_15__["default"](`Failed to parse OpenAPI Document from "${sourceProvenance}"`, {
       cause: error
     });
   }