@scalar/api-reference 1.49.3 → 1.49.4

package/dist/{lazy-bus-CV8Ox5hD.js → helpers/lazy-bus.js}

@@ -1,110 +1,7 @@
+import { getSchemaParamsFromId } from "./id-routing.js";
 import { computed, nextTick, onBeforeUnmount, reactive, ref } from "vue";
 import { watchDebounced } from "@vueuse/core";
 import { nanoid } from "nanoid";
-//#region src/helpers/id-routing.ts
-var sanitizeBasePath = (basePath) => {
-	return basePath.replace(/^\/+|\/+$/g, "");
-};
-var isHashBasePath = (basePath) => basePath.startsWith("#");
-var sanitizeHashBasePath = (basePath) => {
-	return basePath.replace(/^#+/, "").replace(/\/+$/g, "");
-};
-var applySlugPrefix = (base, slugPrefix) => {
-	return slugPrefix ? `${slugPrefix}${base ? "/" : ""}${base}` : base;
-};
-var stripBasePathPrefix = (value, basePath) => {
-	if (value === basePath) return "";
-	if (value.startsWith(`${basePath}/`)) return value.slice(basePath.length + 1);
-	return null;
-};
-/** Extracts an element id from the hash when using hash routing */
-var getIdFromHash = (location, slugPrefix) => {
-	const url = typeof location === "string" ? new URL(location) : location;
-	return applySlugPrefix(decodeURIComponent(url.hash.slice(1)), slugPrefix);
-};
-/** Extracts an element id from the path when using path routing */
-var getIdFromPath = (location, basePath, slugPrefix) => {
-	const url = typeof location === "string" ? new URL(location) : location;
-	const sanitized = sanitizeBasePath(basePath);
-	const basePathWithSlash = sanitized ? `/${sanitized.split("/").map((segment) => encodeURIComponent(segment)).join("/")}` : "";
-	if (url.pathname.startsWith(basePathWithSlash)) {
-		const remainder = url.pathname.slice(basePathWithSlash.length);
-		return applySlugPrefix(decodeURIComponent(remainder.startsWith("/") ? remainder.slice(1) : remainder), slugPrefix);
-	}
-	return slugPrefix ?? "";
-};
-/** Extracts an element id from a hash-prefixed basePath */
-var getIdFromHashBasePath = (location, basePath, slugPrefix) => {
-	const url = typeof location === "string" ? new URL(location) : location;
-	const remainder = stripBasePathPrefix(decodeURIComponent(url.hash.slice(1)), sanitizeHashBasePath(basePath));
-	if (remainder !== null) return applySlugPrefix(remainder, slugPrefix);
-	return slugPrefix ?? "";
-};
-/** Determines whether a URL matches the provided basePath. */
-var matchesBasePath = (location, basePath) => {
-	const url = typeof location === "string" ? new URL(location) : location;
-	if (isHashBasePath(basePath)) {
-		const hash = decodeURIComponent(url.hash);
-		return hash === basePath || hash.startsWith(`${basePath}/`);
-	}
-	const sanitized = sanitizeBasePath(basePath);
-	const basePathWithSlash = sanitized ? `/${sanitized.split("/").map((segment) => encodeURIComponent(segment)).join("/")}` : "";
-	return url.pathname === basePathWithSlash || url.pathname.startsWith(`${basePathWithSlash}/`);
-};
-/**
-* Extracts a navigation id from a URL based on the routing type
-*
-* @param url - The URL to extract the id from
-* @param basePath - The base path used in path routing
-* @param slugPrefix - If the document slug is not expected in the URL then we must prefix it
-*/
-var getIdFromUrl = (url, basePath, slugPrefix) => {
-	if (typeof basePath !== "string") return getIdFromHash(url, slugPrefix);
-	return isHashBasePath(basePath) ? getIdFromHashBasePath(url, basePath, slugPrefix) : getIdFromPath(url, basePath, slugPrefix);
-};
-/**
-* Strips the first segment from an id and preserves trailing slashes
-* Used in single-document mode where the document slug is not needed in the URL
-*
-* @param id - The full id to process
-* @returns The id with the first segment removed, preserving trailing slash if present
-*/
-var stripFirstSegment = (id) => {
-	const hasTrailingSlash = id.endsWith("/");
-	const result = id.split("/").filter(Boolean).slice(1).join("/");
-	return hasTrailingSlash && result ? `${result}/` : result;
-};
-/**
-* Generate a new URL and applies the ID to the path or hash
-* depending on the type of routing used
-*
-* @param id - The id to apply to the URL
-* @param basePath - The base path used in path routing
-* @param isMultiDocument - Whether the document is multi-document or single-document. Single-document documents will strip the document slug from the id
-*/
-var makeUrlFromId = (_id, basePath, isMultiDocument) => {
-	if (typeof window === "undefined") return;
-	/** When there is only 1 document we don't need to include the document name in the URL */
-	const id = isMultiDocument ? _id : stripFirstSegment(_id);
-	const url = new URL(window.location.href);
-	if (typeof basePath === "string") if (isHashBasePath(basePath)) url.hash = [sanitizeHashBasePath(basePath), id].filter(Boolean).join("/");
-	else url.pathname = `${sanitizeBasePath(basePath)}/${id}`;
-	else url.hash = id;
-	return url;
-};
-/** Extracts the schema parameters from the id if they are present */
-var getSchemaParamsFromId = (id) => {
-	const matcher = id.match(/(.*)(\.body\.|\.path\.|\.query\.|\.header\.)(.*)/);
-	if (matcher && typeof matcher[1] === "string" && typeof matcher[2] === "string") return {
-		rawId: matcher[1],
-		params: matcher[2].slice(1) + matcher[3]
-	};
-	return {
-		rawId: id,
-		params: ""
-	};
-};
-//#endregion
 //#region src/helpers/lazy-bus.ts
 /**
 * List of items that are in the priority queue and will be rendered first (e.g. scroll target).
@@ -328,6 +225,6 @@ var freeze = (id) => {
 	};
 };
 //#endregion
-export { intersectionEnabled as a, scrollToLazy as c, getIdFromUrl as d, makeUrlFromId as f, getLazyPlaceholderHeight as i, setLazyPlaceholderHeight as l, blockIntersection as n, requestLazyRender as o, matchesBasePath as p, firstLazyLoadComplete as r, scheduleInitialLoadComplete as s, addToPriorityQueue as t, useLazyBus as u };
+export { addToPriorityQueue, blockIntersection, firstLazyLoadComplete, getLazyPlaceholderHeight, intersectionEnabled, requestLazyRender, scheduleInitialLoadComplete, scrollToLazy, setLazyPlaceholderHeight, useLazyBus };
 
-//# sourceMappingURL=lazy-bus-CV8Ox5hD.js.map
+//# sourceMappingURL=lazy-bus.js.map

package/dist/helpers/lazy-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-bus.js","names":[],"sources":["../../src/helpers/lazy-bus.ts"],"sourcesContent":["import { watchDebounced } from '@vueuse/core'\nimport { nanoid } from 'nanoid'\nimport { computed, nextTick, onBeforeUnmount, reactive, ref } from 'vue'\n\nimport { getSchemaParamsFromId } from './id-routing'\n\n/**\n * List of items that are in the priority queue and will be rendered first (e.g. scroll target).\n */\nconst priorityQueue = reactive<Set<string>>(new Set())\n/** List of items that are pending to be loaded (in viewport overscan). */\nconst pendingQueue = reactive<Set<string>>(new Set())\n/** List of items that are already loaded and stay mounted (no eviction). */\nconst readyQueue = reactive<Set<string>>(new Set())\n/**\n * Flag to indicate if the lazy bus is currently running\n * Blocks ID changes while running\n */\nconst isRunning = ref(false)\n\n/** How long tryScroll keeps retrying to find the element (ms). */\nconst SCROLL_RETRY_MS = 3000\n\n/** Tracks when the initial load is complete. */\nexport const firstLazyLoadComplete = ref(false)\n\n/** List of unique identifiers that are blocking intersection */\nconst intersectionBlockers = reactive<Set<string>>(new Set())\n\nconst onRenderComplete = new Set<() => void>()\n\n/** Cached content heights so placeholders can match when not rendered. */\nconst lazyPlaceholderHeights = reactive<Map<string, number>>(new Map())\n\nexport const getLazyPlaceholderHeight = (id: string): number | undefined => lazyPlaceholderHeights.get(id)\n\nexport const setLazyPlaceholderHeight = (id: string, height: number): void => {\n  if (!Number.isFinite(height) || height <= 0) {\n    return\n  }\n  lazyPlaceholderHeights.set(id, Math.round(height))\n}\n\n/** Adds a one time callback to be executed when the lazy bus has finished loading */\nconst addLazyCompleteCallback = (callback: (() => void) | undefined) => {\n  if (callback) {\n    onRenderComplete.add(callback)\n  }\n}\n\ntype UnblockFn = () => void\n\n/**\n * Blocks intersection until the returned unblock callback is run.\n * Prevents scroll jump while we render new lazy content.\n */\nexport const blockIntersection = (): UnblockFn => {\n  const blockId = nanoid()\n  intersectionBlockers.add(blockId)\n\n  /** Unblock uses a small delay to ensure the scroll is complete before enabling intersection */\n  return () => setTimeout(() => intersectionBlockers.delete(blockId), 100)\n}\n\n/** If there are any pending blocking operations we disable intersection */\nexport const intersectionEnabled = computed(() => intersectionBlockers.size === 0)\n\n/**\n * Processes the full queue: priority first, then pending. Blocks intersection while\n * rendering so the viewport does not jump. No eviction — items stay in readyQueue.\n */\nconst runLazyBus = () => {\n  // We always render the lazy bus when the window is undefined (see useLazyBus)\n  if (typeof window === 'undefined') {\n    return\n  }\n\n  if (isRunning.value) {\n    return\n  }\n\n  isRunning.value = true\n\n  /**\n   * Sets all the pending elements into the ready queue\n   * After waiting for Vue to update the DOM we execute the callbacks and unblock intersection\n   */\n  const processQueue = async () => {\n    const priorityIds = [...priorityQueue]\n    const pendingIds = [...pendingQueue]\n\n    if (priorityIds.length === 0 && pendingIds.length === 0) {\n      onRenderComplete.forEach((fn) => fn())\n      onRenderComplete.clear()\n      isRunning.value = false\n      firstLazyLoadComplete.value = true\n      return\n    }\n\n    for (const id of priorityIds) {\n      readyQueue.add(id)\n      priorityQueue.delete(id)\n    }\n    for (const id of pendingIds) {\n      readyQueue.add(id)\n      pendingQueue.delete(id)\n    }\n\n    await nextTick()\n\n    onRenderComplete.forEach((fn) => fn())\n    onRenderComplete.clear()\n    isRunning.value = false\n    firstLazyLoadComplete.value = true\n  }\n\n  if (window.requestIdleCallback) {\n    window.requestIdleCallback(processQueue, { timeout: 1500 })\n  } else {\n    // biome-ignore lint/nursery/noFloatingPromises: Expected floating promise\n    nextTick(processQueue)\n  }\n}\n\n/**\n * Run the lazy bus when the queue changes and is not currently running\n * Debounce so that multiple changes to the queue are batched together\n *\n * We must run when the priority queue changes because we rely on finish callbacks\n * anytime we request potentially lazy elements. If we don't run when the priority queue changes\n * we may not have a finish callback even though the element is set to load.\n */\nwatchDebounced(\n  [() => pendingQueue.size, () => priorityQueue.size, () => isRunning.value],\n  () => {\n    if ((pendingQueue.size > 0 || priorityQueue.size > 0) && !isRunning.value) {\n      runLazyBus()\n    }\n  },\n  { debounce: 300, maxWait: 1500 },\n)\n\n/**\n * We only make elements pending if they are not already in the priority or ready queue\n */\nconst addToPendingQueue = (id: string | undefined) => {\n  if (id && !readyQueue.has(id) && !priorityQueue.has(id)) {\n    pendingQueue.add(id)\n  }\n}\n\n/**\n * Add elements to the priority queue for immediate rendering.\n * We allow adding items already in readyQueue so that callbacks are still triggered,\n * but processQueue will skip actual re-rendering for items already ready.\n */\nexport const addToPriorityQueue = (id: string | undefined) => {\n  if (id && !priorityQueue.has(id)) {\n    priorityQueue.add(id)\n  }\n}\n\n/**\n * Request an item to be rendered (e.g. when it re-enters the overscan zone).\n */\nexport const requestLazyRender = (id: string | undefined, priority = false): void => {\n  if (!id || readyQueue.has(id)) {\n    return\n  }\n  if (priority) {\n    addToPriorityQueue(id)\n  } else {\n    addToPendingQueue(id)\n  }\n  if (!isRunning.value) {\n    runLazyBus()\n  }\n}\n\n/**\n * Schedules a single run of the lazy bus so that documents with no Lazy components\n * (e.g. no operations, tags, or models) still get firstLazyLoadComplete set and the\n * full-viewport placeholder can be hidden. Call from content root on mount.\n */\nexport const scheduleInitialLoadComplete = (): void => {\n  if (typeof window === 'undefined') {\n    return\n  }\n  const delay = 400\n  window.setTimeout(() => runLazyBus(), delay)\n}\n\n/** When an element is unmounted we remove it from all queues */\nconst resetLazyElement = (id: string) => {\n  priorityQueue.delete(id)\n  pendingQueue.delete(id)\n  readyQueue.delete(id)\n  lazyPlaceholderHeights.delete(id)\n}\n\n// ---------------------------------------------------------------------------\n\n/**\n * Tracks the lazy loading state of an element.\n * Use isReady (or expanded) to decide whether to render the slot or show a placeholder.\n * The element is only added to the queue when it enters the viewport overscan (see Lazy.vue).\n */\nexport function useLazyBus(id: string) {\n  onBeforeUnmount(() => {\n    resetLazyElement(id)\n  })\n\n  return {\n    isReady: computed(() => typeof window === 'undefined' || priorityQueue.has(id) || readyQueue.has(id)),\n  }\n}\n\n/**\n * Scroll to a possibly lazy-loaded element. Expands parents and adds target (and\n * parents) to the priority queue, then scrolls after Vue has flushed.\n */\nexport const scrollToLazy = (\n  id: string,\n  setExpanded: (id: string, value: boolean) => void,\n  getEntryById: (id: string) => { id: string; parent?: { id: string }; children?: { id: string }[] } | undefined,\n) => {\n  const item = getEntryById(id)\n\n  /**\n   * If the element is lazy we must freeze the element so that it does not move until after the next lazy bus run\n   * If the element never loads then the scroll onFailure callback will be run to unfreeze the element\n   *\n   * If the readyQueue does not have the item we must freeze it while it renders\n   * If the item has lazy children we must freeze the item while the children are (potentially) loaded\n   */\n  const isLazy = !readyQueue.has(id) || item?.children?.some((child) => !readyQueue.has(child.id))\n\n  const unfreeze = isLazy ? freeze(id) : undefined\n  addLazyCompleteCallback(unfreeze)\n\n  // Disable intersection while we scroll to the element\n  const unblock = blockIntersection()\n  const { rawId } = getSchemaParamsFromId(id)\n\n  addToPriorityQueue(id)\n  addToPriorityQueue(rawId)\n\n  // When there are children we ensure the first 2 are loaded\n  if (item?.children) {\n    item.children.slice(0, 2).forEach((child) => addToPriorityQueue(child.id))\n  }\n\n  // When there are sibling items we attempt to load the next 2 to better fill the viewport\n  if (item?.parent) {\n    const parent = getEntryById(item.parent.id)\n    const elementIdx = parent?.children?.findIndex((child) => child.id === id)\n    if (elementIdx !== undefined && elementIdx >= 0) {\n      parent?.children?.slice(elementIdx, elementIdx + 2).forEach((child) => addToPriorityQueue(child.id))\n    }\n  }\n\n  setExpanded(rawId, true)\n  /**\n   * Recursively expand the parents and set them as a loading priority\n   * This ensures all parents will be immediately loaded and open\n   */\n  const addParents = (currentId: string) => {\n    const parent = getEntryById(currentId)?.parent\n    if (parent) {\n      addToPriorityQueue(parent.id)\n      setExpanded(parent.id, true)\n      addParents(parent.id)\n    }\n  }\n  /** Must use the rawId as schema params are not in the navigation tree */\n  addParents(rawId)\n\n  void nextTick(() => {\n    tryScroll(id, Date.now() + SCROLL_RETRY_MS, unblock, unfreeze)\n  })\n}\n\n/**\n * Tiny wrapper around the scrollIntoView API\n * Retries up to the stopTime in case the element is not yet rendered\n *\n * @param id - The id of the element to scroll to\n * @param stopTime - The time to stop retrying in unix milliseconds\n */\nconst tryScroll = (id: string, stopTime: number, onComplete: UnblockFn, onFailure?: () => void): void => {\n  const element = document.getElementById(id)\n  if (element) {\n    element.scrollIntoView({ block: 'start' })\n    onComplete()\n  } else if (Date.now() < stopTime) {\n    requestAnimationFrame(() => tryScroll(id, stopTime, onComplete, onFailure))\n  } else {\n    // If the scroll has expired we enable intersection again\n    onComplete()\n    onFailure?.()\n  }\n}\n\nconst freeze = (id: string): (() => void) => {\n  let stop = false\n\n  /**\n   * Runs until the stop flag is set\n   * Executes the final frame after stop changes to true\n   */\n  const runFrame = (stopAfterFrame: boolean) => {\n    const element = document.getElementById(id)\n    if (element) {\n      element.scrollIntoView({ block: 'start' })\n    }\n    if (!stopAfterFrame) {\n      requestAnimationFrame(() => runFrame(stop))\n    }\n  }\n\n  runFrame(false)\n\n  return () => {\n    stop = true\n  }\n}\n"],"mappings":"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"}

package/dist/helpers/load-from-perssistance.js

@@ -0,0 +1,23 @@
+import { authStorage, clientStorage } from "./storage.js";
+import { isClient } from "@scalar/api-client/v2/blocks/operation-code-sample";
+//#region src/helpers/load-from-perssistance.ts
+/**
+* Loads the default HTTP client from storage and applies it to the workspace.
+* Only updates if no default client is already set.
+*/
+var loadClientFromStorage = (store) => {
+	const storedClient = clientStorage().get();
+	if (isClient(storedClient) && !store.workspace["x-scalar-default-client"]) store.update("x-scalar-default-client", storedClient);
+};
+/**
+* Loads the authentication data from storage and applies it to the workspace.
+* Only updates if no authentication data is already set.
+*/
+var loadAuthFromStorage = (store, slug) => {
+	const auth = authStorage().getAuth(slug);
+	store.auth.load({ [slug]: auth });
+};
+//#endregion
+export { loadAuthFromStorage, loadClientFromStorage };
+
+//# sourceMappingURL=load-from-perssistance.js.map

package/dist/helpers/load-from-perssistance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-from-perssistance.js","names":[],"sources":["../../src/helpers/load-from-perssistance.ts"],"sourcesContent":["import { isClient } from '@scalar/api-client/v2/blocks/operation-code-sample'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\n\nimport { authStorage, clientStorage } from '@/helpers/storage'\n\n/**\n * Loads the default HTTP client from storage and applies it to the workspace.\n * Only updates if no default client is already set.\n */\nexport const loadClientFromStorage = (store: WorkspaceStore): void => {\n  const storedClient = clientStorage().get()\n\n  if (isClient(storedClient) && !store.workspace['x-scalar-default-client']) {\n    store.update('x-scalar-default-client', storedClient)\n  }\n}\n\n/**\n * Loads the authentication data from storage and applies it to the workspace.\n * Only updates if no authentication data is already set.\n */\nexport const loadAuthFromStorage = (store: WorkspaceStore, slug: string): void => {\n  const authPersistence = authStorage()\n  const auth = authPersistence.getAuth(slug)\n  store.auth.load({ [slug]: auth })\n}\n"],"mappings":";;;;;;;AASA,IAAa,yBAAyB,UAAgC;CACpE,MAAM,eAAe,eAAe,CAAC,KAAK;AAE1C,KAAI,SAAS,aAAa,IAAI,CAAC,MAAM,UAAU,2BAC7C,OAAM,OAAO,2BAA2B,aAAa;;;;;;AAQzD,IAAa,uBAAuB,OAAuB,SAAuB;CAEhF,MAAM,OADkB,aAAa,CACR,QAAQ,KAAK;AAC1C,OAAM,KAAK,KAAK,GAAG,OAAO,MAAM,CAAC"}

package/dist/helpers/map-config-plugins.js

@@ -0,0 +1,44 @@
+import { watch } from "vue";
+//#region src/helpers/map-config-plugins.ts
+/**
+* Maps API reference configuration callbacks to client plugins.
+*
+* This function transforms the legacy onBeforeRequest and onRequestSent callbacks
+* into the new plugin hook system. The mapping is reactive, so changes to the
+* configuration will automatically update the plugin hooks.
+*
+* Note: onRequestSent is mapped to responseReceived hook. This is not a perfect
+* one-to-one mapping, but it maintains backward compatibility with the old API.
+* The old callback receives only the URL string, while the new hook receives
+* the full response object.
+*
+* @param config - Reactive configuration object containing optional hook callbacks
+* @returns Array containing a single plugin with the mapped hooks
+*/
+var mapConfigPlugins = (config) => {
+	const plugin = { hooks: {} };
+	watch([() => config.value.onBeforeRequest, () => config.value.onRequestSent], ([onBeforeRequest, onRequestSent]) => {
+		if (!plugin.hooks) plugin.hooks = {};
+		plugin.hooks.beforeRequest = onBeforeRequest ? async (payload) => {
+			const result = await onBeforeRequest(payload);
+			/**
+			* When the callback returns void (for side-effect only callbacks like logging),
+			* we return the original payload to keep the request pipeline working.
+			*/
+			if (result === void 0) return payload;
+			return result;
+		} : void 0;
+		/**
+		* Maps onRequestSent to responseReceived hook.
+		* The old API only passed the URL string, so we extract it from the request.
+		*/
+		plugin.hooks.responseReceived = onRequestSent ? (payload) => {
+			onRequestSent(payload.request.url);
+		} : void 0;
+	}, { immediate: true });
+	return [plugin];
+};
+//#endregion
+export { mapConfigPlugins };
+
+//# sourceMappingURL=map-config-plugins.js.map

package/dist/helpers/map-config-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-config-plugins.js","names":[],"sources":["../../src/helpers/map-config-plugins.ts"],"sourcesContent":["import type { ClientPlugin } from '@scalar/oas-utils/helpers'\nimport type { ApiReferenceConfigurationRaw } from '@scalar/types/api-reference'\nimport { type ComputedRef, watch } from 'vue'\n\n/**\n * Maps API reference configuration callbacks to client plugins.\n *\n * This function transforms the legacy onBeforeRequest and onRequestSent callbacks\n * into the new plugin hook system. The mapping is reactive, so changes to the\n * configuration will automatically update the plugin hooks.\n *\n * Note: onRequestSent is mapped to responseReceived hook. This is not a perfect\n * one-to-one mapping, but it maintains backward compatibility with the old API.\n * The old callback receives only the URL string, while the new hook receives\n * the full response object.\n *\n * @param config - Reactive configuration object containing optional hook callbacks\n * @returns Array containing a single plugin with the mapped hooks\n */\nexport const mapConfigPlugins = (config: ComputedRef<ApiReferenceConfigurationRaw>): ClientPlugin[] => {\n  const plugin: ClientPlugin = { hooks: {} }\n\n  watch(\n    [() => config.value.onBeforeRequest, () => config.value.onRequestSent],\n    ([onBeforeRequest, onRequestSent]) => {\n      if (!plugin.hooks) {\n        plugin.hooks = {}\n      }\n\n      plugin.hooks.beforeRequest = onBeforeRequest\n        ? async (payload) => {\n            const result = await onBeforeRequest(payload)\n\n            /**\n             * When the callback returns void (for side-effect only callbacks like logging),\n             * we return the original payload to keep the request pipeline working.\n             */\n            if (result === undefined) {\n              return payload\n            }\n\n            return result\n          }\n        : undefined\n\n      /**\n       * Maps onRequestSent to responseReceived hook.\n       * The old API only passed the URL string, so we extract it from the request.\n       */\n      plugin.hooks.responseReceived = onRequestSent\n        ? (payload) => {\n            onRequestSent(payload.request.url)\n          }\n        : undefined\n    },\n    { immediate: true },\n  )\n\n  return [plugin]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,IAAa,oBAAoB,WAAsE;CACrG,MAAM,SAAuB,EAAE,OAAO,EAAE,EAAE;AAE1C,OACE,OAAO,OAAO,MAAM,uBAAuB,OAAO,MAAM,cAAc,GACrE,CAAC,iBAAiB,mBAAmB;AACpC,MAAI,CAAC,OAAO,MACV,QAAO,QAAQ,EAAE;AAGnB,SAAO,MAAM,gBAAgB,kBACzB,OAAO,YAAY;GACjB,MAAM,SAAS,MAAM,gBAAgB,QAAQ;;;;;AAM7C,OAAI,WAAW,KAAA,EACb,QAAO;AAGT,UAAO;MAET,KAAA;;;;;AAMJ,SAAO,MAAM,mBAAmB,iBAC3B,YAAY;AACX,iBAAc,QAAQ,QAAQ,IAAI;MAEpC,KAAA;IAEN,EAAE,WAAW,MAAM,CACpB;AAED,QAAO,CAAC,OAAO"}

package/dist/helpers/map-config-to-workspace-store.js

@@ -0,0 +1,24 @@
+import { computed, toValue, watch } from "vue";
+import { useFavicon } from "@vueuse/core";
+import { isClient } from "@scalar/api-client/v2/blocks/operation-code-sample";
+import { useSeoMeta } from "@unhead/vue";
+//#region src/helpers/map-config-to-workspace-store.ts
+var mapConfigToWorkspaceStore = ({ config, store, isDarkMode }) => {
+	watch(() => toValue(config).defaultHttpClient, (newValue) => {
+		if (newValue) {
+			const { targetKey, clientKey } = newValue;
+			const clientId = `${targetKey}/${clientKey}`;
+			if (isClient(clientId)) store.update("x-scalar-default-client", clientId);
+		}
+	}, { immediate: true });
+	/** Update the dark mode state when props change */
+	watch(() => toValue(config).darkMode, (isDark) => store.update("x-scalar-color-mode", isDark ? "dark" : "light"));
+	watch(() => isDarkMode.value, (newIsDark) => store.update("x-scalar-color-mode", newIsDark ? "dark" : "light"), { immediate: true });
+	if (toValue(config).metaData) useSeoMeta(toValue(config).metaData);
+	watch(() => toValue(config).proxyUrl, (newProxyUrl) => store.update("x-scalar-active-proxy", newProxyUrl), { immediate: true });
+	useFavicon(computed(() => toValue(config).favicon));
+};
+//#endregion
+export { mapConfigToWorkspaceStore };
+
+//# sourceMappingURL=map-config-to-workspace-store.js.map

package/dist/helpers/map-config-to-workspace-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-config-to-workspace-store.js","names":[],"sources":["../../src/helpers/map-config-to-workspace-store.ts"],"sourcesContent":["import { isClient } from '@scalar/api-client/v2/blocks/operation-code-sample'\nimport type { ApiReferenceConfigurationRaw } from '@scalar/types/api-reference'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport { useSeoMeta } from '@unhead/vue'\nimport { useFavicon } from '@vueuse/core'\nimport { type MaybeRefOrGetter, type Ref, computed, toValue, watch } from 'vue'\n\nexport const mapConfigToWorkspaceStore = ({\n  config,\n  store,\n  isDarkMode,\n}: {\n  config: MaybeRefOrGetter<ApiReferenceConfigurationRaw>\n  store: WorkspaceStore\n  isDarkMode: Ref<boolean>\n}) => {\n  // Update the workspace store if default client changes\n  watch(\n    () => toValue(config).defaultHttpClient,\n    (newValue) => {\n      if (newValue) {\n        const { targetKey, clientKey } = newValue\n\n        const clientId = `${targetKey}/${clientKey}`\n        if (isClient(clientId)) {\n          store.update('x-scalar-default-client', clientId)\n        }\n      }\n    },\n    { immediate: true },\n  )\n\n  /** Update the dark mode state when props change */\n  watch(\n    () => toValue(config).darkMode,\n    (isDark) => store.update('x-scalar-color-mode', isDark ? 'dark' : 'light'),\n  )\n\n  // Temporary mapping of isDarkMode until we update the standalone component\n  watch(\n    () => isDarkMode.value,\n    (newIsDark) => store.update('x-scalar-color-mode', newIsDark ? 'dark' : 'light'),\n    { immediate: true },\n  )\n\n  if (toValue(config).metaData) {\n    useSeoMeta(toValue(config).metaData)\n  }\n\n  // Update the active proxy when the proxyUrl changes\n  watch(\n    () => toValue(config).proxyUrl,\n    (newProxyUrl) => store.update('x-scalar-active-proxy', newProxyUrl),\n    { immediate: true },\n  )\n\n  const favicon = computed(() => toValue(config).favicon)\n  useFavicon(favicon)\n}\n"],"mappings":";;;;;AAOA,IAAa,6BAA6B,EACxC,QACA,OACA,iBAKI;AAEJ,aACQ,QAAQ,OAAO,CAAC,oBACrB,aAAa;AACZ,MAAI,UAAU;GACZ,MAAM,EAAE,WAAW,cAAc;GAEjC,MAAM,WAAW,GAAG,UAAU,GAAG;AACjC,OAAI,SAAS,SAAS,CACpB,OAAM,OAAO,2BAA2B,SAAS;;IAIvD,EAAE,WAAW,MAAM,CACpB;;AAGD,aACQ,QAAQ,OAAO,CAAC,WACrB,WAAW,MAAM,OAAO,uBAAuB,SAAS,SAAS,QAAQ,CAC3E;AAGD,aACQ,WAAW,QAChB,cAAc,MAAM,OAAO,uBAAuB,YAAY,SAAS,QAAQ,EAChF,EAAE,WAAW,MAAM,CACpB;AAED,KAAI,QAAQ,OAAO,CAAC,SAClB,YAAW,QAAQ,OAAO,CAAC,SAAS;AAItC,aACQ,QAAQ,OAAO,CAAC,WACrB,gBAAgB,MAAM,OAAO,yBAAyB,YAAY,EACnE,EAAE,WAAW,MAAM,CACpB;AAGD,YADgB,eAAe,QAAQ,OAAO,CAAC,QAAQ,CACpC"}

package/dist/helpers/normalize-configurations.js

@@ -0,0 +1,66 @@
+import { apiReferenceConfigurationWithSourceSchema, isConfigurationWithSources } from "@scalar/types/api-reference";
+import { parseJsonOrYaml } from "@scalar/oas-utils/helpers";
+import GithubSlugger from "github-slugger";
+//#region src/helpers/normalize-configurations.ts
+/**
+* Take any configuration and return a flat array of configurations.
+*/
+var normalizeConfigurations = (configuration) => {
+	const slugger = new GithubSlugger();
+	const normalized = {};
+	if (!configuration) return normalized;
+	(Array.isArray(configuration) ? configuration : [configuration]).flatMap((c) => {
+		if (isConfigurationWithSources(c)) {
+			const { sources: configSources, ...rest } = c;
+			return configSources?.map((source) => ({
+				...rest,
+				...source
+			})) ?? [];
+		}
+		return [c];
+	}).map((source) => {
+		/** Validation with migrate deprecated attributes to their new format */
+		const validated = apiReferenceConfigurationWithSourceSchema.safeParse(source);
+		return validated.success ? validated.data : null;
+	}).filter((c) => !!c && (!!c.url || !!c.content)).map((source, index) => addSlugAndTitle(source, index, slugger)).forEach((c) => {
+		const { url, content, ...config } = c;
+		normalized[c.slug] = {
+			config,
+			title: c.title,
+			slug: c.slug,
+			default: !!c?.default,
+			agent: c.agent,
+			source: content ? { content: normalizeContent(content) ?? {} } : { url }
+		};
+	});
+	return normalized;
+};
+/** Normalize content into a JS object or return null if it is falsey */
+var normalizeContent = (content) => {
+	if (!content) return null;
+	if (typeof content === "function") return normalizeContent(content());
+	if (typeof content === "string") return parseJsonOrYaml(content);
+	return content;
+};
+/** Process a single spec configuration so that it has a title and a slug */
+var addSlugAndTitle = (source, index = 0, slugger) => {
+	if (source.title) return {
+		...source,
+		slug: source.slug || slugger.slug(source.title),
+		title: source.title
+	};
+	if (source.slug) return {
+		...source,
+		slug: slugger.slug(source.slug),
+		title: source.slug
+	};
+	return {
+		...source,
+		slug: `api-${index + 1}`,
+		title: `API #${index + 1}`
+	};
+};
+//#endregion
+export { normalizeConfigurations };
+
+//# sourceMappingURL=normalize-configurations.js.map

package/dist/helpers/normalize-configurations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-configurations.js","names":[],"sources":["../../src/helpers/normalize-configurations.ts"],"sourcesContent":["import { parseJsonOrYaml } from '@scalar/oas-utils/helpers'\nimport {\n  type AnyApiReferenceConfiguration,\n  type ApiReferenceConfigurationRaw,\n  type ApiReferenceConfigurationWithSource,\n  apiReferenceConfigurationWithSourceSchema,\n  isConfigurationWithSources,\n} from '@scalar/types/api-reference'\nimport GithubSlugger from 'github-slugger'\n\n/** Processed API Reference Configuration\n *\n * Creates the required title and slug for the API Reference.\n * Separate the source into a dedicated object\n * Returns the raw configuration to pass to components\n */\nexport type NormalizedConfiguration = {\n  title: string\n  slug: string\n  config: ApiReferenceConfigurationRaw\n  default: boolean\n  agent: ApiReferenceConfigurationWithSource['agent']\n  source: { url: string; content?: never } | { content: Record<string, unknown>; url?: never }\n}\n\ntype NormalizedConfigurations = Record<string, NormalizedConfiguration>\n\ntype ConfigWithRequiredSource = Omit<ApiReferenceConfigurationWithSource, 'url' | 'content'> &\n  ({ url: string; content?: never } | { content: Record<string, unknown>; url?: never })\n\n/**\n * Take any configuration and return a flat array of configurations.\n */\nexport const normalizeConfigurations = (\n  configuration: AnyApiReferenceConfiguration | undefined,\n): NormalizedConfigurations => {\n  const slugger = new GithubSlugger()\n\n  const normalized: NormalizedConfigurations = {}\n\n  if (!configuration) {\n    return normalized\n  }\n\n  const configList = Array.isArray(configuration) ? configuration : [configuration]\n\n  configList\n    /** Create a flat array of configurations with their document source data integrated. */\n    .flatMap((c) => {\n      // Check if this config has a 'sources' array property\n      if (isConfigurationWithSources(c)) {\n        // Destructure to separate sources array from other config properties\n        const { sources: configSources, ...rest } = c\n\n        // For each source in the array:\n        // - Merge the source with the parent config properties\n        // - Handle undefined sources by returning empty array via ?? []\n        return configSources?.map((source) => ({ ...rest, ...source })) ?? []\n      }\n\n      // If config doesn't have sources array, treat the config itself as a source\n      return [c]\n    })\n    .map((source) => {\n      /** Validation with migrate deprecated attributes to their new format */\n      const validated = apiReferenceConfigurationWithSourceSchema.safeParse(source)\n      return validated.success ? validated.data : null\n    })\n    /** Filter out configurations that failed validation or don't have a url or content */\n    .filter((c): c is ConfigWithRequiredSource => !!c && (!!c.url || !!c.content))\n    /** Add required attributes to the source */\n    .map((source, index) => addSlugAndTitle(source, index, slugger))\n    /** Separate the configuration and sources by slug */\n    .forEach((c) => {\n      const { url, content, ...config } = c\n      normalized[c.slug] = {\n        config,\n        title: c.title,\n        slug: c.slug,\n        default: !!c?.default,\n        agent: c.agent,\n        source: content ? { content: normalizeContent(content) ?? {} } : { url },\n      }\n    })\n\n  // Process them and return normalized\n  return normalized\n}\n\n/** Normalize content into a JS object or return null if it is falsey */\nexport const normalizeContent = (\n  content: string | Record<string, unknown> | (() => string | Record<string, unknown>),\n): Record<string, unknown> | null => {\n  if (!content) {\n    return null\n  }\n\n  if (typeof content === 'function') {\n    return normalizeContent(content())\n  }\n\n  if (typeof content === 'string') {\n    return parseJsonOrYaml(content)\n  }\n\n  return content\n}\n\n/** Process a single spec configuration so that it has a title and a slug */\nconst addSlugAndTitle = (\n  source: ConfigWithRequiredSource,\n  index = 0,\n  slugger: GithubSlugger,\n): ConfigWithRequiredSource & { slug: string; title: string } => {\n  // Case 1: Title exists, generate slug from it\n  if (source.title) {\n    return {\n      ...source,\n      slug: source.slug || slugger.slug(source.title),\n      title: source.title,\n    }\n  }\n\n  // Case 2: Slug exists but no title, use slug as title\n  if (source.slug) {\n    return {\n      ...source,\n      slug: slugger.slug(source.slug),\n      title: source.slug,\n    }\n  }\n\n  // Case 3: Neither exists, use index\n  return {\n    ...source,\n    slug: `api-${index + 1}`,\n    title: `API #${index + 1}`,\n  }\n}\n"],"mappings":";;;;;;;AAiCA,IAAa,2BACX,kBAC6B;CAC7B,MAAM,UAAU,IAAI,eAAe;CAEnC,MAAM,aAAuC,EAAE;AAE/C,KAAI,CAAC,cACH,QAAO;AAKT,EAFmB,MAAM,QAAQ,cAAc,GAAG,gBAAgB,CAAC,cAAc,EAI9E,SAAS,MAAM;AAEd,MAAI,2BAA2B,EAAE,EAAE;GAEjC,MAAM,EAAE,SAAS,eAAe,GAAG,SAAS;AAK5C,UAAO,eAAe,KAAK,YAAY;IAAE,GAAG;IAAM,GAAG;IAAQ,EAAE,IAAI,EAAE;;AAIvE,SAAO,CAAC,EAAE;GACV,CACD,KAAK,WAAW;;EAEf,MAAM,YAAY,0CAA0C,UAAU,OAAO;AAC7E,SAAO,UAAU,UAAU,UAAU,OAAO;GAC5C,CAED,QAAQ,MAAqC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,CAE7E,KAAK,QAAQ,UAAU,gBAAgB,QAAQ,OAAO,QAAQ,CAAC,CAE/D,SAAS,MAAM;EACd,MAAM,EAAE,KAAK,SAAS,GAAG,WAAW;AACpC,aAAW,EAAE,QAAQ;GACnB;GACA,OAAO,EAAE;GACT,MAAM,EAAE;GACR,SAAS,CAAC,CAAC,GAAG;GACd,OAAO,EAAE;GACT,QAAQ,UAAU,EAAE,SAAS,iBAAiB,QAAQ,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK;GACzE;GACD;AAGJ,QAAO;;;AAIT,IAAa,oBACX,YACmC;AACnC,KAAI,CAAC,QACH,QAAO;AAGT,KAAI,OAAO,YAAY,WACrB,QAAO,iBAAiB,SAAS,CAAC;AAGpC,KAAI,OAAO,YAAY,SACrB,QAAO,gBAAgB,QAAQ;AAGjC,QAAO;;;AAIT,IAAM,mBACJ,QACA,QAAQ,GACR,YAC+D;AAE/D,KAAI,OAAO,MACT,QAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ,QAAQ,KAAK,OAAO,MAAM;EAC/C,OAAO,OAAO;EACf;AAIH,KAAI,OAAO,KACT,QAAO;EACL,GAAG;EACH,MAAM,QAAQ,KAAK,OAAO,KAAK;EAC/B,OAAO,OAAO;EACf;AAIH,QAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ;EACrB,OAAO,QAAQ,QAAQ;EACxB"}

package/dist/helpers/openapi.js

@@ -0,0 +1,132 @@
+import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { isObjectSchema } from "@scalar/workspace-store/schemas/v3.1/strict/type-guards";
+import { isDereferenced } from "@scalar/openapi-types/helpers";
+//#region src/helpers/openapi.ts
+/**
+* Resolves a schema reference from workspace-store to a SchemaObject.
+* Bridges SchemaReferenceType (which uses '$ref-value': unknown) to NodeInput (which uses '$ref-value': SchemaObject).
+*/
+function resolveSchemaRef(ref) {
+	return getResolvedRef(ref);
+}
+/**
+* Formats a property object into a string.
+*/
+function formatProperty(key, obj) {
+	let output = key;
+	const isRequired = obj.required?.includes(key);
+	output += isRequired ? " REQUIRED " : " optional ";
+	const propRef = obj.properties[key];
+	if (!propRef) return output;
+	const property = resolveSchemaRef(propRef);
+	if (property && typeof property === "object" && "type" in property) {
+		output += property.type ?? "";
+		if ("description" in property && typeof property.description === "string") output += " " + property.description;
+	}
+	return output;
+}
+/**
+* Recursively logs the properties of an object.
+*/
+function recursiveLogger(obj) {
+	const results = ["Body"];
+	const schema = getResolvedRef(obj?.schema);
+	if (!schema || !isObjectSchema(schema) || !schema.properties) return results;
+	const properties = schema.properties;
+	const schemaWithProps = {
+		properties,
+		required: schema.required
+	};
+	Object.keys(properties).forEach((key) => {
+		if (!obj.schema) return;
+		results.push(formatProperty(key, schemaWithProps));
+		const propRef = properties[key];
+		if (!propRef) return;
+		const property = resolveSchemaRef(propRef);
+		if (property && isObjectSchema(property) && property.properties) {
+			const nestedProperties = property.properties;
+			Object.keys(nestedProperties).forEach((subKey) => {
+				const ref = nestedProperties[subKey];
+				if (!ref) return;
+				const nested = resolveSchemaRef(ref);
+				const typeStr = nested && typeof nested === "object" && "type" in nested ? nested.type ?? "" : "";
+				results.push(`${subKey} ${typeStr}`);
+			});
+		}
+	});
+	return results;
+}
+/**
+* Extracts the request body from an operation.
+*/
+function extractRequestBody(operation) {
+	try {
+		const media = getResolvedRef(operation?.requestBody)?.content?.["application/json"];
+		if (!media) throw new Error("Body not found");
+		return recursiveLogger(media);
+	} catch (_error) {
+		return false;
+	}
+}
+/**
+* Deep merge for objects
+*/
+function deepMerge(source, target) {
+	for (const [key, val] of Object.entries(source)) if (val !== null && typeof val === "object") {
+		target[key] ??= new val.__proto__.constructor();
+		deepMerge(val, target[key]);
+	} else if (typeof val !== "undefined") target[key] = val;
+	return target;
+}
+/**
+* Creates an empty specification object.
+* The returning object has the same structure as a valid OpenAPI specification, but everything is empty.
+*/
+function createEmptySpecification(partialSpecification) {
+	return deepMerge(partialSpecification ?? {}, {
+		info: {
+			title: "",
+			description: "",
+			termsOfService: "",
+			version: "",
+			license: {
+				name: "",
+				url: ""
+			},
+			contact: { email: "" }
+		},
+		servers: [],
+		tags: []
+	});
+}
+/**
+* This function creates a parameter map from an Operation Object, that's easier to consume.
+*
+* TODO: Isn't it easier to just stick to the OpenAPI structure, without transforming it?
+*/
+function createParameterMap(operation) {
+	const map = {
+		path: [],
+		query: [],
+		header: [],
+		cookie: [],
+		body: [],
+		formData: []
+	};
+	const parameters = operation.parameters ?? [];
+	if (parameters) parameters.forEach((parameter) => {
+		if (!isDereferenced(parameter)) return;
+		if (typeof parameter === "object" && parameter !== null && "$ref" in parameter) return;
+		if (parameter.in === "path") map.path.push(parameter);
+		else if (parameter.in === "query") map.query.push(parameter);
+		else if (parameter.in === "header") map.header.push(parameter);
+		else if (parameter.in === "cookie") map.cookie.push(parameter);
+		else if (parameter.in === "body") map.body.push(parameter);
+		else if (parameter.in === "formData") map.formData.push(parameter);
+	});
+	return map;
+}
+//#endregion
+export { createEmptySpecification, createParameterMap, extractRequestBody };
+
+//# sourceMappingURL=openapi.js.map

package/dist/helpers/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","names":[],"sources":["../../src/helpers/openapi.ts"],"sourcesContent":["import type { OpenAPI } from '@scalar/openapi-types'\nimport { isDereferenced } from '@scalar/openapi-types/helpers'\nimport { type NodeInput, getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type { MediaTypeObject } from '@scalar/workspace-store/schemas/v3.1/strict/media-type'\nimport type {\n  OperationObject,\n  ParameterObject,\n  SchemaObject,\n  SchemaReferenceType,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isObjectSchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\n\n/** Object schema shape with properties, used when logging request body. */\ntype ObjectSchemaWithProperties = {\n  properties: Record<string, SchemaReferenceType<SchemaObject>>\n  required?: string[]\n}\n\n/**\n * Resolves a schema reference from workspace-store to a SchemaObject.\n * Bridges SchemaReferenceType (which uses '$ref-value': unknown) to NodeInput (which uses '$ref-value': SchemaObject).\n */\nfunction resolveSchemaRef(ref: SchemaReferenceType<SchemaObject>): SchemaObject {\n  return getResolvedRef(ref as NodeInput<SchemaObject>)\n}\n\n/**\n * Formats a property object into a string.\n */\nfunction formatProperty(key: string, obj: ObjectSchemaWithProperties): string {\n  let output = key\n  const isRequired = obj.required?.includes(key)\n  output += isRequired ? ' REQUIRED ' : ' optional '\n  const propRef = obj.properties[key]\n  if (!propRef) return output\n  const property = resolveSchemaRef(propRef)\n\n  // Check existence before accessing\n  if (property && typeof property === 'object' && 'type' in property) {\n    output += (property as { type?: string }).type ?? ''\n    if ('description' in property && typeof (property as { description?: string }).description === 'string') {\n      output += ' ' + (property as { description: string }).description\n    }\n  }\n\n  return output\n}\n\n/**\n * Recursively logs the properties of an object.\n */\nfunction recursiveLogger(obj: MediaTypeObject): string[] {\n  const results: string[] = ['Body']\n  const schema = getResolvedRef(obj?.schema)\n\n  if (!schema || !isObjectSchema(schema) || !schema.properties) {\n    return results\n  }\n\n  const properties = schema.properties\n  const schemaWithProps: ObjectSchemaWithProperties = {\n    properties,\n    required: schema.required,\n  }\n  Object.keys(properties).forEach((key) => {\n    if (!obj.schema) {\n      return\n    }\n\n    results.push(formatProperty(key, schemaWithProps))\n\n    const propRef = properties[key]\n    if (!propRef) return\n    const property = resolveSchemaRef(propRef)\n    if (property && isObjectSchema(property) && property.properties) {\n      const nestedProperties = property.properties\n      Object.keys(nestedProperties).forEach((subKey) => {\n        const ref = nestedProperties[subKey]\n        if (!ref) return\n        const nested = resolveSchemaRef(ref)\n        const typeStr =\n          nested && typeof nested === 'object' && 'type' in nested ? ((nested as { type?: string }).type ?? '') : ''\n        results.push(`${subKey} ${typeStr}`)\n      })\n    }\n  })\n\n  return results\n}\n\n/**\n * Extracts the request body from an operation.\n */\nexport function extractRequestBody(operation: OperationObject): string[] | boolean {\n  try {\n    // TODO: Wait… there's more than just 'application/json' (https://github.com/scalar/scalar/issues/6427)\n    const media = getResolvedRef(operation?.requestBody)?.content?.['application/json']\n    if (!media) {\n      throw new Error('Body not found')\n    }\n\n    return recursiveLogger(media)\n  } catch (_error) {\n    return false\n  }\n}\n\n/**\n * Deep merge for objects\n */\nexport function deepMerge(source: Record<any, any>, target: Record<any, any>) {\n  for (const [key, val] of Object.entries(source)) {\n    if (val !== null && typeof val === 'object') {\n      target[key] ??= new val.__proto__.constructor()\n      deepMerge(val, target[key])\n    } else if (typeof val !== 'undefined') {\n      target[key] = val\n    }\n  }\n\n  return target\n}\n\n/**\n * Creates an empty specification object.\n * The returning object has the same structure as a valid OpenAPI specification, but everything is empty.\n */\nexport function createEmptySpecification(partialSpecification?: Partial<OpenAPI.Document>) {\n  return deepMerge(partialSpecification ?? {}, {\n    info: {\n      title: '',\n      description: '',\n      termsOfService: '',\n      version: '',\n      license: {\n        name: '',\n        url: '',\n      },\n      contact: {\n        email: '',\n      },\n    },\n    servers: [],\n    tags: [],\n  }) as OpenAPI.Document\n}\n\nexport type ParameterMap = {\n  path: ParameterObject[]\n  query: ParameterObject[]\n  header: ParameterObject[]\n  cookie: ParameterObject[]\n  body: ParameterObject[]\n  formData: ParameterObject[]\n}\n\n/**\n * This function creates a parameter map from an Operation Object, that's easier to consume.\n *\n * TODO: Isn't it easier to just stick to the OpenAPI structure, without transforming it?\n */\nexport function createParameterMap(operation: OperationObject) {\n  const map: ParameterMap = {\n    path: [],\n    query: [],\n    header: [],\n    cookie: [],\n    body: [],\n    formData: [],\n  }\n\n  // TODO: They are not passed to the function, so we don't need to deal with them yet, but we should.\n  // @see https://github.com/scalar/scalar/issues/6428\n  // if (operation.pathParameters) {\n  //   operation.pathParameters.forEach((parameter: OpenAPIV3_1.ParameterObject) => {\n  //     if (parameter.in === 'path') {\n  //       map.path.push(parameter)\n  //     } else if (parameter.in === 'query') {\n  //       map.query.push(parameter)\n  //     } else if (parameter.in === 'header') {\n  //       map.header.push(parameter)\n  //     } else if (parameter.in === 'cookie') {\n  //       map.cookie.push(parameter)\n  //     } else if (parameter.in === 'body') {\n  //       map.body.push(parameter)\n  //     } else if (parameter.in === 'formData') {\n  //       map.formData.push(parameter)\n  //     }\n  //   })\n  // }\n\n  const parameters = operation.parameters ?? []\n\n  if (parameters) {\n    parameters.forEach((parameter) => {\n      if (!isDereferenced<ParameterObject>(parameter)) {\n        return\n      }\n\n      if (typeof parameter === 'object' && parameter !== null && '$ref' in parameter) {\n        return\n      }\n\n      if (parameter.in === 'path') {\n        map.path.push(parameter)\n      } else if (parameter.in === 'query') {\n        map.query.push(parameter)\n      } else if (parameter.in === 'header') {\n        map.header.push(parameter)\n      } else if (parameter.in === 'cookie') {\n        map.cookie.push(parameter)\n      } else if (parameter.in === 'body') {\n        map.body.push(parameter)\n      } else if (parameter.in === 'formData') {\n        map.formData.push(parameter)\n      }\n    })\n  }\n\n  return map\n}\n"],"mappings":"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"}

package/dist/{storage--3JuzjCI.js → helpers/storage.js}

@@ -37,6 +37,6 @@ var authStorage = () => {
 	};
 };
 //#endregion
-export { clientStorage as n, authStorage as t };
+export { authStorage, clientStorage };
 
-//# sourceMappingURL=storage--3JuzjCI.js.map
+//# sourceMappingURL=storage.js.map

package/dist/helpers/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","names":[],"sources":["../../src/helpers/storage.ts"],"sourcesContent":["import { REFERENCE_LS_KEYS, safeLocalStorage } from '@scalar/helpers/object/local-storage'\nimport { type Auth, AuthSchema } from '@scalar/workspace-store/entities/auth'\nimport { coerceValue } from '@scalar/workspace-store/schemas/typebox-coerce'\n\n// Local storage helper instance, safely wrapped.\nconst storage = safeLocalStorage()\n\n/**\n * Provides an interface to store and retrieve the selected client value\n * in local storage.\n */\nexport const clientStorage = () => {\n  const key = REFERENCE_LS_KEYS.SELECTED_CLIENT\n  return {\n    /**\n     * Gets the stored selected client from local storage.\n     */\n    get: () => {\n      return storage.getItem(key)\n    },\n    /**\n     * Stores the selected client value in local storage.\n     * @param value The value to store\n     */\n    set: (value: string) => {\n      storage.setItem(key, value as string)\n    },\n  }\n}\n\n/**\n * Provides an interface to store and retrieve authentication scheme\n * information in local storage, including both the available schemes and\n * the user's selected schemes.\n */\nexport const authStorage = () => {\n  const getKey = (slug: string) => {\n    return `${REFERENCE_LS_KEYS.AUTH}-${slug}`\n  }\n\n  return {\n    /**\n     * Retrieves and coerces the authentication schemes stored in local storage.\n     */\n    getAuth: (slug: string) => {\n      const parsed = JSON.parse(storage.getItem(getKey(slug)) ?? '{}')\n      return coerceValue(AuthSchema, parsed)\n    },\n    /**\n     * Stores the authentication schemes in local storage.\n     * @param value The Auth object to stringify and store.\n     */\n    setAuth: (slug: string, value: Auth) => {\n      storage.setItem(getKey(slug), JSON.stringify(value))\n    },\n  }\n}\n"],"mappings":";;;;AAKA,IAAM,UAAU,kBAAkB;;;;;AAMlC,IAAa,sBAAsB;CACjC,MAAM,MAAM,kBAAkB;AAC9B,QAAO;EAIL,WAAW;AACT,UAAO,QAAQ,QAAQ,IAAI;;EAM7B,MAAM,UAAkB;AACtB,WAAQ,QAAQ,KAAK,MAAgB;;EAExC;;;;;;;AAQH,IAAa,oBAAoB;CAC/B,MAAM,UAAU,SAAiB;AAC/B,SAAO,GAAG,kBAAkB,KAAK,GAAG;;AAGtC,QAAO;EAIL,UAAU,SAAiB;AAEzB,UAAO,YAAY,YADJ,KAAK,MAAM,QAAQ,QAAQ,OAAO,KAAK,CAAC,IAAI,KAAK,CAC1B;;EAMxC,UAAU,MAAc,UAAgB;AACtC,WAAQ,QAAQ,OAAO,KAAK,EAAE,KAAK,UAAU,MAAM,CAAC;;EAEvD"}

package/dist/helpers/upload-temp-document.js

@@ -0,0 +1,24 @@
+import { PROXY_URL, UPLOAD_TEMP_API_URL } from "../consts/urls.js";
+import { redirectToProxy } from "@scalar/helpers/url/redirect-to-proxy";
+//#region src/helpers/upload-temp-document.ts
+/** Type guard for the response body */
+function isResponseBody(data) {
+	return !!data && typeof data === "object" && "url" in data && typeof data.url === "string";
+}
+/** Upload a document and return a temporary URL */
+async function uploadTempDocument(document) {
+	const body = JSON.stringify({ document });
+	const response = await fetch(redirectToProxy(PROXY_URL, UPLOAD_TEMP_API_URL), {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body
+	});
+	if (!response.ok) throw new Error(` Failed to generate temporary link, server responded with ${response.status}`);
+	const data = await response.json();
+	if (!isResponseBody(data)) throw new Error("Failed to generate temporary link, invalid response from server");
+	return data.url;
+}
+//#endregion
+export { uploadTempDocument };
+
+//# sourceMappingURL=upload-temp-document.js.map

package/dist/helpers/upload-temp-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-temp-document.js","names":[],"sources":["../../src/helpers/upload-temp-document.ts"],"sourcesContent":["import { redirectToProxy } from '@scalar/helpers/url/redirect-to-proxy'\n\nimport { PROXY_URL, UPLOAD_TEMP_API_URL } from '@/consts/urls'\n\n/** Type guard for the response body */\nfunction isResponseBody(data: unknown): data is { url: string } {\n  return !!data && typeof data === 'object' && 'url' in data && typeof (data as any).url === 'string'\n}\n\n/** Upload a document and return a temporary URL */\nexport async function uploadTempDocument(document: string): Promise<string> {\n  const body = JSON.stringify({ document })\n\n  // Proxy the request to avoid localhost CORS issues\n  const response = await fetch(redirectToProxy(PROXY_URL, UPLOAD_TEMP_API_URL), {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body,\n  })\n\n  if (!response.ok) {\n    throw new Error(` Failed to generate temporary link, server responded with ${response.status}`)\n  }\n  const data = (await response.json()) as unknown\n\n  if (!isResponseBody(data)) {\n    throw new Error('Failed to generate temporary link, invalid response from server')\n  }\n\n  return data.url\n}\n"],"mappings":";;;;AAKA,SAAS,eAAe,MAAwC;AAC9D,QAAO,CAAC,CAAC,QAAQ,OAAO,SAAS,YAAY,SAAS,QAAQ,OAAQ,KAAa,QAAQ;;;AAI7F,eAAsB,mBAAmB,UAAmC;CAC1E,MAAM,OAAO,KAAK,UAAU,EAAE,UAAU,CAAC;CAGzC,MAAM,WAAW,MAAM,MAAM,gBAAgB,WAAW,oBAAoB,EAAE;EAC5E,QAAQ;EACR,SAAS,EAAE,gBAAgB,oBAAoB;EAC/C;EACD,CAAC;AAEF,KAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,6DAA6D,SAAS,SAAS;CAEjG,MAAM,OAAQ,MAAM,SAAS,MAAM;AAEnC,KAAI,CAAC,eAAe,KAAK,CACvB,OAAM,IAAI,MAAM,kEAAkE;AAGpF,QAAO,KAAK"}

package/dist/hooks/index.d.ts

@@ -1,3 +1,3 @@
-export { AGENT_CONTEXT_SYMBOL, useAgent, useAgentContext, } from './use-agent';
-export { useIntersection } from './use-intersection';
+export { AGENT_CONTEXT_SYMBOL, useAgent, useAgentContext, } from './use-agent.js';
+export { useIntersection } from './use-intersection.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.js

@@ -1,3 +1,3 @@
-import { n as useAgent, r as useAgentContext, t as AGENT_CONTEXT_SYMBOL } from "../use-agent-Bnm1de0n.js";
-import { t as useIntersection } from "../use-intersection-8QqPi2O-.js";
+import { AGENT_CONTEXT_SYMBOL, useAgent, useAgentContext } from "./use-agent.js";
+import { useIntersection } from "./use-intersection.js";
 export { AGENT_CONTEXT_SYMBOL, useAgent, useAgentContext, useIntersection };

package/dist/{use-agent-Bnm1de0n.js → hooks/use-agent.js}

@@ -55,6 +55,6 @@ function useAgentContext() {
 	return computed(() => injected ?? agentStateRef.value ?? void 0);
 }
 //#endregion
-export { useAgent as n, useAgentContext as r, AGENT_CONTEXT_SYMBOL as t };
+export { AGENT_CONTEXT_SYMBOL, useAgent, useAgentContext };
 
-//# sourceMappingURL=use-agent-Bnm1de0n.js.map
+//# sourceMappingURL=use-agent.js.map

package/dist/hooks/use-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent.js","names":[],"sources":["../../src/hooks/use-agent.ts"],"sourcesContent":["import { isLocalUrl } from '@scalar/helpers/url/is-local-url'\nimport type { ComputedRef, Ref } from 'vue'\nimport { type InjectionKey, computed, inject, ref } from 'vue'\n\ntype UseAgentOptions = {\n  /** Optional. When provided, controls whether the agent UI is enabled (e.g. from doc config). Defaults to isLocalUrl. */\n  agentEnabled?: ComputedRef<boolean>\n}\n\ntype UseAgentReturn = {\n  showAgent: Ref<boolean>\n  agentEnabled: ComputedRef<boolean>\n  /** Ref used to pass a prefill message into the agent when opening. Cleared on close. */\n  prefilledMessage: Ref<string>\n  openAgent: (message?: string) => void\n  closeAgent: () => void\n  toggleAgent: () => void\n}\n\nexport const AGENT_CONTEXT_SYMBOL = Symbol() as InjectionKey<UseAgentReturn>\n\n/**\n * Module-level ref so useAgentContext() can resolve context even when inject fails\n * (e.g. async component boundary or mount order). Set when ApiReference calls useAgent().\n */\nconst agentStateRef: Ref<UseAgentReturn | null> = ref(null)\n\n/**\n * Hook for agent visibility and enabled state.\n * Call from the API Reference root (e.g. ApiReference.vue) with options to create the state, then provide it so descendants can inject it.\n *\n * Returns:\n * - showAgent: whether the agent panel is visible\n * - agentEnabled: whether the agent is enabled\n * - openAgent, closeAgent, toggleAgent: imperative controls\n */\nexport function useAgent(options: UseAgentOptions): UseAgentReturn {\n  const showAgent = ref(false)\n  const prefilledMessage = ref('')\n\n  const agentEnabled = options.agentEnabled ?? computed(() => isLocalUrl(window.location.href))\n\n  const openAgent = (message?: string) => {\n    prefilledMessage.value = message ?? ''\n    showAgent.value = true\n  }\n\n  const closeAgent = () => {\n    showAgent.value = false\n    prefilledMessage.value = ''\n  }\n\n  const toggleAgent = () => {\n    showAgent.value = !showAgent.value\n    if (!showAgent.value) {\n      prefilledMessage.value = ''\n    }\n  }\n\n  const state: UseAgentReturn = {\n    showAgent,\n    agentEnabled,\n    prefilledMessage,\n    openAgent,\n    closeAgent,\n    toggleAgent,\n  }\n  agentStateRef.value = state\n  return state\n}\n\n/**\n * Inject the agent context provided by ApiReference.\n * Falls back to module-level state when inject is undefined (e.g. async boundary or mount order).\n * Use in descendant components (e.g. AskAgentButton) to open the agent or check if it is enabled.\n *\n * Returns a computed ref; use v-if=\"agentContext?.agentEnabled\" so the button only renders when context exists and agent is enabled.\n */\nexport function useAgentContext(): ComputedRef<UseAgentReturn | undefined> {\n  const injected = inject(AGENT_CONTEXT_SYMBOL, undefined)\n  return computed((): UseAgentReturn | undefined => injected ?? agentStateRef.value ?? undefined)\n}\n"],"mappings":";;;AAmBA,IAAa,uBAAuB,QAAQ;;;;;AAM5C,IAAM,gBAA4C,IAAI,KAAK;;;;;;;;;;AAW3D,SAAgB,SAAS,SAA0C;CACjE,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,mBAAmB,IAAI,GAAG;CAEhC,MAAM,eAAe,QAAQ,gBAAgB,eAAe,WAAW,OAAO,SAAS,KAAK,CAAC;CAE7F,MAAM,aAAa,YAAqB;AACtC,mBAAiB,QAAQ,WAAW;AACpC,YAAU,QAAQ;;CAGpB,MAAM,mBAAmB;AACvB,YAAU,QAAQ;AAClB,mBAAiB,QAAQ;;CAG3B,MAAM,oBAAoB;AACxB,YAAU,QAAQ,CAAC,UAAU;AAC7B,MAAI,CAAC,UAAU,MACb,kBAAiB,QAAQ;;CAI7B,MAAM,QAAwB;EAC5B;EACA;EACA;EACA;EACA;EACA;EACD;AACD,eAAc,QAAQ;AACtB,QAAO;;;;;;;;;AAUT,SAAgB,kBAA2D;CACzE,MAAM,WAAW,OAAO,sBAAsB,KAAA,EAAU;AACxD,QAAO,eAA2C,YAAY,cAAc,SAAS,KAAA,EAAU"}

package/dist/{use-intersection-8QqPi2O-.js → hooks/use-intersection.js}

@@ -19,6 +19,6 @@ var useIntersection = (el, onIntersect) => {
 	});
 };
 //#endregion
-export { useIntersection as t };
+export { useIntersection };
 
-//# sourceMappingURL=use-intersection-8QqPi2O-.js.map
+//# sourceMappingURL=use-intersection.js.map

package/dist/hooks/use-intersection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-intersection.js","names":[],"sources":["../../src/hooks/use-intersection.ts"],"sourcesContent":["import { useIntersectionObserver } from '@vueuse/core'\nimport { type TemplateRef, onMounted } from 'vue'\n\nexport const useIntersection = (el: TemplateRef<HTMLElement | undefined>, onIntersect: () => void) => {\n  const calculateRootMargin = (element: HTMLElement) => {\n    const height = element.offsetHeight\n    // Use of a margin on height to ensure sooner intersection detection.\n    return `${height / 2}px 0px ${height / 2}px 0px`\n  }\n\n  const calculateThreshold = (element: HTMLElement) => {\n    const height = element.offsetHeight\n    // Favor larger threshold if the element is smaller that the screen\n    // to ensure that it is selected\n    return height < window.innerHeight ? 0.8 : 0.5\n  }\n\n  onMounted(() => {\n    if (el.value) {\n      const options = {\n        rootMargin: calculateRootMargin(el.value),\n        threshold: calculateThreshold(el.value),\n      }\n\n      useIntersectionObserver(\n        el,\n        ([entry]) => {\n          if (entry?.isIntersecting) {\n            onIntersect()\n          }\n        },\n        options,\n      )\n    }\n  })\n}\n"],"mappings":";;;AAGA,IAAa,mBAAmB,IAA0C,gBAA4B;CACpG,MAAM,uBAAuB,YAAyB;EACpD,MAAM,SAAS,QAAQ;AAEvB,SAAO,GAAG,SAAS,EAAE,SAAS,SAAS,EAAE;;CAG3C,MAAM,sBAAsB,YAAyB;AAInD,SAHe,QAAQ,eAGP,OAAO,cAAc,KAAM;;AAG7C,iBAAgB;AACd,MAAI,GAAG,MAML,yBACE,KACC,CAAC,WAAW;AACX,OAAI,OAAO,eACT,cAAa;KATH;GACd,YAAY,oBAAoB,GAAG,MAAM;GACzC,WAAW,mBAAmB,GAAG,MAAM;GACxC,CAUA;GAEH"}

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import type { AnyApiReferenceConfiguration } from '@scalar/types/api-reference';
 export type { ApiReferenceConfiguration } from '@scalar/types/api-reference';
-export { default as ApiReference } from './components/ApiReference.vue';
-export { default as GettingStarted } from './components/GettingStarted.vue';
+export { default as ApiReference } from './components/ApiReference.vue.js';
+export { default as GettingStarted } from './components/GettingStarted.vue.js';
 export { SearchButton, SearchModal } from './features/Search';
-export { createEmptySpecification } from './helpers/openapi';
-export { createApiReference } from './standalone/lib/html-api';
+export { createEmptySpecification } from './helpers/openapi.js';
+export { createApiReference } from './standalone/lib/html-api.js';
 export type ReferenceProps = {
     configuration?: AnyApiReferenceConfiguration;
 };