@scalar/helpers 0.0.6 → 0.0.8

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @scalar/helpers
 
+## 0.0.8
+
+### Patch Changes
+
+- 66b18fc: feat: update the references to handle $refs from the magic proxy
+
+## 0.0.7
+
+### Patch Changes
+
+- c0d6793: feat: ensure we use the path routing base path for relative document url resolution
+- f3d0216: feat: lazy loading v1.5
+
 ## 0.0.6
 
 ### Patch Changes

package/dist/dom/freeze-at-top.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Freezes an element at the top of the viewport using a mutation observer to check if the element has entered the dom
+ * Differs from freezeElement as the element doesn't need to exist yet
+ */
+export declare const freezeAtTop: (id: string) => () => void;
+//# sourceMappingURL=freeze-at-top.d.ts.map

package/dist/dom/freeze-at-top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze-at-top.d.ts","sourceRoot":"","sources":["../../src/dom/freeze-at-top.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,WAAW,OAAQ,MAAM,eAyCrC,CAAA"}

package/dist/dom/freeze-at-top.js

@@ -0,0 +1,34 @@
+const freezeAtTop = (id) => {
+  if (!id) {
+    return () => null;
+  }
+  let rafId = null;
+  let element = document.getElementById(id);
+  const observer = new MutationObserver(() => {
+    element ||= document.getElementById(id);
+    if (!element) {
+      return;
+    }
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+    }
+    rafId = requestAnimationFrame(() => {
+      element?.scrollIntoView();
+      rafId = null;
+    });
+  });
+  observer.observe(document.body, {
+    childList: true,
+    subtree: true
+  });
+  return () => {
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+    }
+    observer.disconnect();
+  };
+};
+export {
+  freezeAtTop
+};
+//# sourceMappingURL=freeze-at-top.js.map

package/dist/dom/freeze-at-top.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/dom/freeze-at-top.ts"],
+  "sourcesContent": ["/**\n * Freezes an element at the top of the viewport using a mutation observer to check if the element has entered the dom\n * Differs from freezeElement as the element doesn't need to exist yet\n */\nexport const freezeAtTop = (id: string) => {\n  if (!id) {\n    return () => null\n  }\n\n  let rafId: number | null = null\n  let element = document.getElementById(id)\n\n  // Create mutation observer to watch for DOM changes\n  const observer = new MutationObserver(() => {\n    element ||= document.getElementById(id)\n\n    if (!element) {\n      return\n    }\n\n    // Cancel any pending animation frame\n    if (rafId !== null) {\n      cancelAnimationFrame(rafId)\n    }\n\n    // Schedule the scroll adjustment for the next frame\n    rafId = requestAnimationFrame(() => {\n      element?.scrollIntoView()\n      rafId = null\n    })\n  })\n\n  // Start observing with more specific configuration\n  observer.observe(document.body, {\n    childList: true,\n    subtree: true,\n  })\n\n  // Return function to stop maintaining position\n  return () => {\n    if (rafId !== null) {\n      cancelAnimationFrame(rafId)\n    }\n    observer.disconnect()\n  }\n}\n"],
+  "mappings": "AAIO,MAAM,cAAc,CAAC,OAAe;AACzC,MAAI,CAAC,IAAI;AACP,WAAO,MAAM;AAAA,EACf;AAEA,MAAI,QAAuB;AAC3B,MAAI,UAAU,SAAS,eAAe,EAAE;AAGxC,QAAM,WAAW,IAAI,iBAAiB,MAAM;AAC1C,gBAAY,SAAS,eAAe,EAAE;AAEtC,QAAI,CAAC,SAAS;AACZ;AAAA,IACF;AAGA,QAAI,UAAU,MAAM;AAClB,2BAAqB,KAAK;AAAA,IAC5B;AAGA,YAAQ,sBAAsB,MAAM;AAClC,eAAS,eAAe;AACxB,cAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AAGD,WAAS,QAAQ,SAAS,MAAM;AAAA,IAC9B,WAAW;AAAA,IACX,SAAS;AAAA,EACX,CAAC;AAGD,SAAO,MAAM;AACX,QAAI,UAAU,MAAM;AAClB,2BAAqB,KAAK;AAAA,IAC5B;AACA,aAAS,WAAW;AAAA,EACtB;AACF;",
+  "names": []
+}

package/dist/http/http-methods.d.ts

@@ -3,5 +3,5 @@ export declare const HTTP_METHODS: readonly ["connect", "delete", "get", "head",
 /** All http methods we support */
 export type HttpMethod = (typeof HTTP_METHODS)[number];
 /** Set of all http methods we support */
-export declare const httpMethods: Set<"connect" | "delete" | "get" | "head" | "options" | "patch" | "post" | "put" | "trace">;
+export declare const httpMethods: Readonly<Set<"connect" | "delete" | "get" | "head" | "options" | "patch" | "post" | "put" | "trace">>;
 //# sourceMappingURL=http-methods.d.ts.map

package/dist/http/http-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-methods.d.ts","sourceRoot":"","sources":["../../src/http/http-methods.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,eAAO,MAAM,YAAY,2FAA4F,CAAA;AAErH,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD,yCAAyC;AACzC,eAAO,MAAM,WAAW,6FAAwB,CAAA"}
+{"version":3,"file":"http-methods.d.ts","sourceRoot":"","sources":["../../src/http/http-methods.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,eAAO,MAAM,YAAY,2FAA4F,CAAA;AAErH,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD,yCAAyC;AACzC,eAAO,MAAM,WAAW,uGAAuC,CAAA"}

package/dist/http/http-methods.js

@@ -1,5 +1,5 @@
 const HTTP_METHODS = ["connect", "delete", "get", "head", "options", "patch", "post", "put", "trace"];
-const httpMethods = new Set(HTTP_METHODS);
+const httpMethods = Object.freeze(new Set(HTTP_METHODS));
 export {
   HTTP_METHODS,
   httpMethods

package/dist/http/http-methods.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/http/http-methods.ts"],
-  "sourcesContent": ["/** All OpenAPI HTTP methods plus connect */\nexport const HTTP_METHODS = ['connect', 'delete', 'get', 'head', 'options', 'patch', 'post', 'put', 'trace'] as const\n\n/** All http methods we support */\nexport type HttpMethod = (typeof HTTP_METHODS)[number]\n\n/** Set of all http methods we support */\nexport const httpMethods = new Set(HTTP_METHODS)\n"],
-  "mappings": "AACO,MAAM,eAAe,CAAC,WAAW,UAAU,OAAO,QAAQ,WAAW,SAAS,QAAQ,OAAO,OAAO;AAMpG,MAAM,cAAc,IAAI,IAAI,YAAY;",
+  "sourcesContent": ["/** All OpenAPI HTTP methods plus connect */\nexport const HTTP_METHODS = ['connect', 'delete', 'get', 'head', 'options', 'patch', 'post', 'put', 'trace'] as const\n\n/** All http methods we support */\nexport type HttpMethod = (typeof HTTP_METHODS)[number]\n\n/** Set of all http methods we support */\nexport const httpMethods = Object.freeze(new Set(HTTP_METHODS))\n"],
+  "mappings": "AACO,MAAM,eAAe,CAAC,WAAW,UAAU,OAAO,QAAQ,WAAW,SAAS,QAAQ,OAAO,OAAO;AAMpG,MAAM,cAAc,OAAO,OAAO,IAAI,IAAI,YAAY,CAAC;",
   "names": []
 }

package/dist/object/local-storage.d.ts

@@ -18,7 +18,15 @@ export declare const LS_KEYS: {
  * to ensure we do not have any conflicts
  */
 export declare const REFERENCE_LS_KEYS: {
-    readonly SELECTED_CLIENT: "scalar-reference-selected-client";
+    /**
+     * We should remove after some time as we no longer store an object
+     * @deprecated
+     */
+    readonly SELECTED_CLIENT_DEPRECATED: "scalar-reference-selected-client";
+    /**
+     * Store the selected client as a string in localStorage
+     */
+    readonly SELECTED_CLIENT: "scalar-reference-selected-client-v2";
 };
 /**
  * localStorage keys for all client resources

package/dist/object/local-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../src/object/local-storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;CAUV,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;CAEpB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAA;AAEV,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;CAOX,CAAA"}
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../src/object/local-storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;CAUV,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;OAGG;;IAEH;;OAEG;;CAEK,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAA;AAEV,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;CAOX,CAAA"}

package/dist/object/local-storage.js

@@ -10,7 +10,15 @@ const LS_KEYS = {
   WORKSPACE: "workspace"
 };
 const REFERENCE_LS_KEYS = {
-  SELECTED_CLIENT: "scalar-reference-selected-client"
+  /**
+   * We should remove after some time as we no longer store an object
+   * @deprecated
+   */
+  SELECTED_CLIENT_DEPRECATED: "scalar-reference-selected-client",
+  /**
+   * Store the selected client as a string in localStorage
+   */
+  SELECTED_CLIENT: "scalar-reference-selected-client-v2"
 };
 const CLIENT_LS_KEYS = {
   AUTH: "scalar-client-auth",

package/dist/object/local-storage.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/object/local-storage.ts"],
-  "sourcesContent": ["/**\n * localStorage keys for resources\n * DO NOT CHANGE THESE AS IT WILL BREAK THE MIGRATION\n */\nexport const LS_KEYS = {\n  COLLECTION: 'collection',\n  COOKIE: 'cookie',\n  ENVIRONMENT: 'environment',\n  REQUEST: 'request',\n  REQUEST_EXAMPLE: 'requestExample',\n  SECURITY_SCHEME: 'securityScheme',\n  SERVER: 'server',\n  TAG: 'tag',\n  WORKSPACE: 'workspace',\n} as const\n\n/**\n * localStorage keys for all reference resources\n * to ensure we do not have any conflicts\n */\nexport const REFERENCE_LS_KEYS = {\n  SELECTED_CLIENT: 'scalar-reference-selected-client',\n} as const\n\n/**\n * localStorage keys for all client resources\n * to ensure we do not have any conflicts\n */\nexport const CLIENT_LS_KEYS = {\n  AUTH: 'scalar-client-auth',\n  SELECTED_SECURITY_SCHEMES: 'scalar-client-selected-security-schemes',\n} as const\n\n/** SSR safe alias for localStorage */\nexport const safeLocalStorage = () =>\n  typeof window === 'undefined'\n    ? {\n        getItem: () => null,\n        setItem: () => null,\n        removeItem: () => null,\n      }\n    : localStorage\n"],
-  "mappings": "AAIO,MAAM,UAAU;AAAA,EACrB,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,WAAW;AACb;AAMO,MAAM,oBAAoB;AAAA,EAC/B,iBAAiB;AACnB;AAMO,MAAM,iBAAiB;AAAA,EAC5B,MAAM;AAAA,EACN,2BAA2B;AAC7B;AAGO,MAAM,mBAAmB,MAC9B,OAAO,WAAW,cACd;AAAA,EACE,SAAS,MAAM;AAAA,EACf,SAAS,MAAM;AAAA,EACf,YAAY,MAAM;AACpB,IACA;",
+  "sourcesContent": ["/**\n * localStorage keys for resources\n * DO NOT CHANGE THESE AS IT WILL BREAK THE MIGRATION\n */\nexport const LS_KEYS = {\n  COLLECTION: 'collection',\n  COOKIE: 'cookie',\n  ENVIRONMENT: 'environment',\n  REQUEST: 'request',\n  REQUEST_EXAMPLE: 'requestExample',\n  SECURITY_SCHEME: 'securityScheme',\n  SERVER: 'server',\n  TAG: 'tag',\n  WORKSPACE: 'workspace',\n} as const\n\n/**\n * localStorage keys for all reference resources\n * to ensure we do not have any conflicts\n */\nexport const REFERENCE_LS_KEYS = {\n  /**\n   * We should remove after some time as we no longer store an object\n   * @deprecated\n   */\n  SELECTED_CLIENT_DEPRECATED: 'scalar-reference-selected-client',\n  /**\n   * Store the selected client as a string in localStorage\n   */\n  SELECTED_CLIENT: 'scalar-reference-selected-client-v2',\n} as const\n\n/**\n * localStorage keys for all client resources\n * to ensure we do not have any conflicts\n */\nexport const CLIENT_LS_KEYS = {\n  AUTH: 'scalar-client-auth',\n  SELECTED_SECURITY_SCHEMES: 'scalar-client-selected-security-schemes',\n} as const\n\n/** SSR safe alias for localStorage */\nexport const safeLocalStorage = () =>\n  typeof window === 'undefined'\n    ? {\n        getItem: () => null,\n        setItem: () => null,\n        removeItem: () => null,\n      }\n    : localStorage\n"],
+  "mappings": "AAIO,MAAM,UAAU;AAAA,EACrB,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,WAAW;AACb;AAMO,MAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EAK/B,4BAA4B;AAAA;AAAA;AAAA;AAAA,EAI5B,iBAAiB;AACnB;AAMO,MAAM,iBAAiB;AAAA,EAC5B,MAAM;AAAA,EACN,2BAA2B;AAC7B;AAGO,MAAM,mBAAmB,MAC9B,OAAO,WAAW,cACd;AAAA,EACE,SAAS,MAAM;AAAA,EACf,SAAS,MAAM;AAAA,EACf,YAAY,MAAM;AACpB,IACA;",
   "names": []
 }

package/dist/regex/find-variables.d.ts

@@ -1,5 +1,5 @@
 /**
  * Find all strings wrapped in {} or {{}} in value.
  */
-export declare const findVariables: (value: string) => string[];
+export declare const findVariables: (value: string) => (string | undefined)[];
 //# sourceMappingURL=find-variables.d.ts.map

package/dist/regex/find-variables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-variables.d.ts","sourceRoot":"","sources":["../../src/regex/find-variables.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,aAAa,UAAW,MAAM,aACiE,CAAA"}
+{"version":3,"file":"find-variables.d.ts","sourceRoot":"","sources":["../../src/regex/find-variables.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,aAAa,UAAW,MAAM,2BACiE,CAAA"}

package/dist/testing/console-spies.d.ts

@@ -1,8 +1,14 @@
 /** Spy on console.warn */
-export declare const consoleWarnSpy: import("vitest").MockInstance<[message?: any, ...optionalParams: any[]], void>;
+export declare const consoleWarnSpy: import("vitest").MockInstance<{
+    (...data: any[]): void;
+    (message?: any, ...optionalParams: any[]): void;
+}>;
 export declare let isConsoleWarnEnabled: boolean;
 /** Spy on console.error */
-export declare const consoleErrorSpy: import("vitest").MockInstance<[message?: any, ...optionalParams: any[]], void>;
+export declare const consoleErrorSpy: import("vitest").MockInstance<{
+    (...data: any[]): void;
+    (message?: any, ...optionalParams: any[]): void;
+}>;
 export declare let isConsoleErrorEnabled: boolean;
 /** Reset the spies */
 export declare const resetConsoleSpies: () => void;

package/dist/testing/console-spies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console-spies.d.ts","sourceRoot":"","sources":["../../src/testing/console-spies.ts"],"names":[],"mappings":"AAEA,0BAA0B;AAC1B,eAAO,MAAM,cAAc,gFAA4B,CAAA;AACvD,eAAO,IAAI,oBAAoB,SAAQ,CAAA;AAEvC,2BAA2B;AAC3B,eAAO,MAAM,eAAe,gFAA6B,CAAA;AACzD,eAAO,IAAI,qBAAqB,SAAQ,CAAA;AAExC,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,YAG7B,CAAA;AAED,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,eAAsC,CAAA;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,eAAuC,CAAA;AAEtE,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,eAAuC,CAAA;AAEtE,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,eAAwC,CAAA"}
+{"version":3,"file":"console-spies.d.ts","sourceRoot":"","sources":["../../src/testing/console-spies.ts"],"names":[],"mappings":"AAEA,0BAA0B;AAC1B,eAAO,MAAM,cAAc;;;EAA4B,CAAA;AACvD,eAAO,IAAI,oBAAoB,SAAQ,CAAA;AAEvC,2BAA2B;AAC3B,eAAO,MAAM,eAAe;;;EAA6B,CAAA;AACzD,eAAO,IAAI,qBAAqB,SAAQ,CAAA;AAExC,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,YAG7B,CAAA;AAED,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,eAAsC,CAAA;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,eAAuC,CAAA;AAEtE,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,eAAuC,CAAA;AAEtE,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,eAAwC,CAAA"}

package/dist/testing/measure.d.ts

@@ -1,26 +1,31 @@
-/** Function overload for createApiReference to allow multiple different signatures */
-export type Measure = {
-    <T>(name: string, fn: () => T): T;
-    <T>(name: string, fn: () => Promise<T>): Promise<T>;
-    <T>(name: string, fn: () => T | Promise<T>): T | Promise<T>;
-};
 /**
  * Measures the execution time of a function and logs it.
- * Works with both async and sync functions.
- * Returns the result of the measured function.
+ *
+ * Works only with sync functions and returns the result of the measured function.
  *
  * @example
- * ```ts
- * // Async function
- * const result = await measure('api-call', async () => {
- *   return await fetchData()
- * })
  *
+ * ```ts
  * // Sync function
- * const result = measure('computation', () => {
+ * const result = measureSync('computation', () => {
  *   return heavyComputation()
  * })
  * ```
  */
-export declare const measure: Measure;
+export declare const measureSync: <T>(name: string, fn: () => T) => T;
+/**
+ * Measures the execution time of an async function and logs it.
+ *
+ * Works only with async functions and returns the result of the measured function.
+ *
+ * @example
+ *
+ * ```ts
+ * // Async function
+ * const result = await measure('api-call', async () => {
+ *   return await fetchData()
+ * })
+ * ````
+ */
+export declare const measureAsync: <T>(name: string, fn: () => Promise<T>) => Promise<T>;
 //# sourceMappingURL=measure.d.ts.map

package/dist/testing/measure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/testing/measure.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACnD,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC5D,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,OAAO,EAAE,OAWrB,CAAA"}
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/testing/measure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,QAAQ,MAAM,MAAM,MAAM,CAAC,KAAG,CAW1D,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,QAAQ,MAAM,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAWnF,CAAA"}

package/dist/testing/measure.js

@@ -1,4 +1,4 @@
-const measure = (name, fn) => {
+const measureSync = (name, fn) => {
   const start = performance.now();
   const result = fn();
   const end = performance.now();
@@ -6,7 +6,16 @@ const measure = (name, fn) => {
   console.info(`${name}: ${duration} ms`);
   return result;
 };
+const measureAsync = async (name, fn) => {
+  const start = performance.now();
+  const result = await fn();
+  const end = performance.now();
+  const duration = Math.round(end - start);
+  console.info(`${name}: ${duration} ms`);
+  return result;
+};
 export {
-  measure
+  measureAsync,
+  measureSync
 };
 //# sourceMappingURL=measure.js.map

package/dist/testing/measure.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/testing/measure.ts"],
-  "sourcesContent": ["/** Function overload for createApiReference to allow multiple different signatures */\nexport type Measure = {\n  <T>(name: string, fn: () => T): T\n  <T>(name: string, fn: () => Promise<T>): Promise<T>\n  <T>(name: string, fn: () => T | Promise<T>): T | Promise<T>\n}\n\n/**\n * Measures the execution time of a function and logs it.\n * Works with both async and sync functions.\n * Returns the result of the measured function.\n *\n * @example\n * ```ts\n * // Async function\n * const result = await measure('api-call', async () => {\n *   return await fetchData()\n * })\n *\n * // Sync function\n * const result = measure('computation', () => {\n *   return heavyComputation()\n * })\n * ```\n */\nexport const measure: Measure = (name, fn) => {\n  const start = performance.now()\n\n  const result = fn()\n\n  const end = performance.now()\n  const duration = Math.round(end - start)\n\n  console.info(`${name}: ${duration} ms`)\n\n  return result\n}\n"],
-  "mappings": "AAyBO,MAAM,UAAmB,CAAC,MAAM,OAAO;AAC5C,QAAM,QAAQ,YAAY,IAAI;AAE9B,QAAM,SAAS,GAAG;AAElB,QAAM,MAAM,YAAY,IAAI;AAC5B,QAAM,WAAW,KAAK,MAAM,MAAM,KAAK;AAEvC,UAAQ,KAAK,GAAG,IAAI,KAAK,QAAQ,KAAK;AAEtC,SAAO;AACT;",
+  "sourcesContent": ["/**\n * Measures the execution time of a function and logs it.\n *\n * Works only with sync functions and returns the result of the measured function.\n *\n * @example\n *\n * ```ts\n * // Sync function\n * const result = measureSync('computation', () => {\n *   return heavyComputation()\n * })\n * ```\n */\nexport const measureSync = <T>(name: string, fn: () => T): T => {\n  const start = performance.now()\n\n  const result = fn()\n\n  const end = performance.now()\n  const duration = Math.round(end - start)\n\n  console.info(`${name}: ${duration} ms`)\n\n  return result\n}\n\n/**\n * Measures the execution time of an async function and logs it.\n *\n * Works only with async functions and returns the result of the measured function.\n *\n * @example\n *\n * ```ts\n * // Async function\n * const result = await measure('api-call', async () => {\n *   return await fetchData()\n * })\n * ````\n */\nexport const measureAsync = async <T>(name: string, fn: () => Promise<T>): Promise<T> => {\n  const start = performance.now()\n\n  const result = await fn()\n\n  const end = performance.now()\n  const duration = Math.round(end - start)\n\n  console.info(`${name}: ${duration} ms`)\n\n  return result\n}\n"],
+  "mappings": "AAcO,MAAM,cAAc,CAAI,MAAc,OAAmB;AAC9D,QAAM,QAAQ,YAAY,IAAI;AAE9B,QAAM,SAAS,GAAG;AAElB,QAAM,MAAM,YAAY,IAAI;AAC5B,QAAM,WAAW,KAAK,MAAM,MAAM,KAAK;AAEvC,UAAQ,KAAK,GAAG,IAAI,KAAK,QAAQ,KAAK;AAEtC,SAAO;AACT;AAgBO,MAAM,eAAe,OAAU,MAAc,OAAqC;AACvF,QAAM,QAAQ,YAAY,IAAI;AAE9B,QAAM,SAAS,MAAM,GAAG;AAExB,QAAM,MAAM,YAAY,IAAI;AAC5B,QAAM,WAAW,KAAK,MAAM,MAAM,KAAK;AAEvC,UAAQ,KAAK,GAAG,IAAI,KAAK,QAAQ,KAAK;AAEtC,SAAO;AACT;",
   "names": []
 }

package/dist/url/make-url-absolute.d.ts

@@ -1,5 +1,13 @@
 /**
- * Pass an URL or a relative URL and get an absolute URL
+ * Converts a relative URL to an absolute URL using the provided base URL or current window location.
+ * @param url - The URL to make absolute
+ * @param options - Configuration options
+ * @param options.baseUrl - Optional base URL to resolve against (defaults to window.location.href)
+ * @param options.basePath - If provided, combines with baseUrl or window.location.origin before resolving
+ * @returns The absolute URL, or the original URL if it's already absolute or invalid
  */
-export declare const makeUrlAbsolute: (url?: string, baseUrl?: string) => string | undefined;
+export declare const makeUrlAbsolute: (url: string, { baseUrl, basePath, }?: {
+    baseUrl?: string;
+    basePath?: string;
+}) => string;
 //# sourceMappingURL=make-url-absolute.d.ts.map

package/dist/url/make-url-absolute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make-url-absolute.d.ts","sourceRoot":"","sources":["../../src/url/make-url-absolute.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM,YAAY,MAAM,uBAiB7D,CAAA"}
+{"version":3,"file":"make-url-absolute.d.ts","sourceRoot":"","sources":["../../src/url/make-url-absolute.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,QACrB,MAAM,2BAMR;IACD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,KACA,MA6BF,CAAA"}

package/dist/url/make-url-absolute.js

@@ -1,11 +1,28 @@
-const makeUrlAbsolute = (url, baseUrl) => {
-  if (!url || url.startsWith("http://") || url.startsWith("https://") || typeof window === "undefined" && !baseUrl) {
+import { combineUrlAndPath } from "../url/merge-urls.js";
+const makeUrlAbsolute = (url, {
+  /** Optional base URL to resolve against (defaults to window.location.href) */
+  baseUrl,
+  /** If we have a basePath then we resolve against window.location.origin + basePath */
+  basePath
+} = {}) => {
+  if (typeof window === "undefined" && !baseUrl) {
+    return url;
+  }
+  try {
+    new URL(url);
+    return url;
+  } catch {
+  }
+  try {
+    let base = baseUrl || window.location.href;
+    if (basePath) {
+      const origin = baseUrl ? new URL(baseUrl).origin : window.location.origin;
+      base = combineUrlAndPath(origin, basePath + "/");
+    }
+    return new URL(url, base).toString();
+  } catch {
     return url;
   }
-  const base = baseUrl || window.location.href;
-  const cleanBaseUrl = base.split("?")[0]?.split("#")[0];
-  const normalizedBaseUrl = cleanBaseUrl?.endsWith("/") ? cleanBaseUrl : cleanBaseUrl?.substring(0, cleanBaseUrl?.lastIndexOf("/") + 1);
-  return new URL(url, normalizedBaseUrl).toString();
 };
 export {
   makeUrlAbsolute

package/dist/url/make-url-absolute.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/url/make-url-absolute.ts"],
-  "sourcesContent": ["/**\n * Pass an URL or a relative URL and get an absolute URL\n */\nexport const makeUrlAbsolute = (url?: string, baseUrl?: string) => {\n  if (!url || url.startsWith('http://') || url.startsWith('https://') || (typeof window === 'undefined' && !baseUrl)) {\n    return url\n  }\n\n  const base = baseUrl || window.location.href\n\n  // Remove any query parameters or hash from the base URL\n  const cleanBaseUrl = base.split('?')[0]?.split('#')[0]\n\n  // For base URLs with a path component, we want to remove the last path segment\n  // if it doesn't end with a slash\n  const normalizedBaseUrl = cleanBaseUrl?.endsWith('/')\n    ? cleanBaseUrl\n    : cleanBaseUrl?.substring(0, cleanBaseUrl?.lastIndexOf('/') + 1)\n\n  return new URL(url, normalizedBaseUrl).toString()\n}\n"],
-  "mappings": "AAGO,MAAM,kBAAkB,CAAC,KAAc,YAAqB;AACjE,MAAI,CAAC,OAAO,IAAI,WAAW,SAAS,KAAK,IAAI,WAAW,UAAU,KAAM,OAAO,WAAW,eAAe,CAAC,SAAU;AAClH,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,WAAW,OAAO,SAAS;AAGxC,QAAM,eAAe,KAAK,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC;AAIrD,QAAM,oBAAoB,cAAc,SAAS,GAAG,IAChD,eACA,cAAc,UAAU,GAAG,cAAc,YAAY,GAAG,IAAI,CAAC;AAEjE,SAAO,IAAI,IAAI,KAAK,iBAAiB,EAAE,SAAS;AAClD;",
+  "sourcesContent": ["import { combineUrlAndPath } from '@/url/merge-urls'\n\n/**\n * Converts a relative URL to an absolute URL using the provided base URL or current window location.\n * @param url - The URL to make absolute\n * @param options - Configuration options\n * @param options.baseUrl - Optional base URL to resolve against (defaults to window.location.href)\n * @param options.basePath - If provided, combines with baseUrl or window.location.origin before resolving\n * @returns The absolute URL, or the original URL if it's already absolute or invalid\n */\nexport const makeUrlAbsolute = (\n  url: string,\n  {\n    /** Optional base URL to resolve against (defaults to window.location.href) */\n    baseUrl,\n    /** If we have a basePath then we resolve against window.location.origin + basePath */\n    basePath,\n  }: {\n    baseUrl?: string\n    basePath?: string\n  } = {},\n): string => {\n  // If no base URL provided and we're not in a browser environment, return as-is\n  if (typeof window === 'undefined' && !baseUrl) {\n    return url\n  }\n\n  try {\n    // If we can create a URL object without a base, it's already absolute\n    new URL(url)\n    return url\n  } catch {\n    // URL is relative, proceed with resolution\n  }\n\n  // Use URL constructor which handles path normalization automatically\n  try {\n    let base = baseUrl || window.location.href\n\n    // If basePath is provided, combine it with the base URL\n    if (basePath) {\n      const origin = baseUrl ? new URL(baseUrl).origin : window.location.origin\n      base = combineUrlAndPath(origin, basePath + '/')\n    }\n\n    return new URL(url, base).toString()\n  } catch {\n    // If URL construction fails, return the original URL\n    return url\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAU3B,MAAM,kBAAkB,CAC7B,KACA;AAAA;AAAA,EAEE;AAAA;AAAA,EAEA;AACF,IAGI,CAAC,MACM;AAEX,MAAI,OAAO,WAAW,eAAe,CAAC,SAAS;AAC7C,WAAO;AAAA,EACT;AAEA,MAAI;AAEF,QAAI,IAAI,GAAG;AACX,WAAO;AAAA,EACT,QAAQ;AAAA,EAER;AAGA,MAAI;AACF,QAAI,OAAO,WAAW,OAAO,SAAS;AAGtC,QAAI,UAAU;AACZ,YAAM,SAAS,UAAU,IAAI,IAAI,OAAO,EAAE,SAAS,OAAO,SAAS;AACnE,aAAO,kBAAkB,QAAQ,WAAW,GAAG;AAAA,IACjD;AAEA,WAAO,IAAI,IAAI,KAAK,IAAI,EAAE,SAAS;AAAA,EACrC,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;",
   "names": []
 }

package/package.json

@@ -14,7 +14,7 @@
     "helpers",
     "js"
   ],
-  "version": "0.0.6",
+  "version": "0.0.8",
   "engines": {
     "node": ">=20"
   },
@@ -78,9 +78,9 @@
   ],
   "module": "dist/index.js",
   "devDependencies": {
-    "vite": "5.4.19",
-    "vitest": "^1.6.1",
-    "@scalar/build-tooling": "0.2.4"
+    "vite": "6.1.6",
+    "vitest": "^3.2.4",
+    "@scalar/build-tooling": "0.2.6"
   },
   "scripts": {
     "build": "scalar-build-esbuild",