fix(resolver): allow to provide relative URI Reference in browser env (…

…#3177)

Refs #3170
Refs #3150 
Refs #3148

src/resolver/utils/options.js

@@ -1,11 +1,20 @@
 import Http from '../../http/index.js';
 
 export const retrievalURI = (options) => {
+  /**
+   * Swagger-UI uses baseDoc instead of url, this helper function exists
+   * to allow both.
+   *
+   * In browser environment, we allow to pass a relative URI Reference,
+   * and we resolve it against the document's baseURI before passing it deeper
+   * to swagger-client code.
+   */
   const { baseDoc, url } = options;
+  const retrievalURL = baseDoc ?? url ?? '';
 
-  // @TODO Swagger-UI uses baseDoc instead of url, this is to allow both
-  // need to fix and pick one.
-  return baseDoc || url || '';
+  return typeof globalThis.document?.baseURI === 'string'
+    ? String(new URL(retrievalURL, globalThis.document.baseURI))
+    : retrievalURL;
 };
 
 export const httpClient = (options) => {