@scalar/api-client 2.38.3 → 2.39.0

package/dist/v2/features/settings/components/Section.vue.script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.vue.script.js","names":[],"sources":["../../../../../src/v2/features/settings/components/Section.vue"],"sourcesContent":["<script setup lang=\"ts\">\nconst slots = defineSlots<{\n  title?: () => string\n  description?: () => string\n  actions?: () => unknown\n  default: () => unknown\n}>()\n</script>\n\n<template>\n  <div class=\"flex flex-col gap-2\">\n    <div\n      v-if=\"slots.title || slots.description\"\n      class=\"flex items-start justify-between gap-2\">\n      <div class=\"flex flex-col gap-2\">\n        <div\n          v-if=\"slots.title\"\n          class=\"flex h-8 items-center\">\n          <h3 class=\"font-bold\">\n            <slot name=\"title\" />\n          </h3>\n        </div>\n\n        <p\n          v-if=\"slots.description\"\n          class=\"text-c-2 mb-4 text-sm leading-tight\">\n          <slot name=\"description\" />\n        </p>\n      </div>\n\n      <slot\n        v-if=\"slots.actions\"\n        name=\"actions\" />\n    </div>\n\n    <slot />\n  </div>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;EACA,MAAM,QAAQ,UAAA;;uBASZ,mBA0BM,OA1BN,YA0BM,CAxBI,MAAM,SAAS,MAAM,eAAA,WAAA,EAD7B,mBAsBM,OAtBN,YAsBM,CAnBJ,mBAcM,OAdN,YAcM,CAZI,MAAM,SAAA,WAAA,EADd,mBAMM,OANN,YAMM,CAHJ,mBAEK,MAFL,YAEK,CADH,WAAqB,KAAA,QAAA,QAAA,CAAA,CAAA,CAAA,CAAA,IAAA,mBAAA,IAAA,KAAA,EAKjB,MAAM,eAAA,WAAA,EADd,mBAII,KAJJ,YAII,CADF,WAA2B,KAAA,QAAA,cAAA,CAAA,CAAA,IAAA,mBAAA,IAAA,KAAA,CAAA,CAAA,EAKvB,MAAM,UADd,WAEmB,KAAA,QAAA,WAAA,EAAA,KAAA,GAAA,CAAA,GAAA,mBAAA,IAAA,KAAA,CAAA,CAAA,IAAA,mBAAA,IAAA,KAAA,EAGrB,WAAQ,KAAA,QAAA,UAAA,CAAA,CAAA"}

package/dist/v2/features/settings/helpers/get-theme-colors.js

@@ -0,0 +1,68 @@
+//#region src/v2/features/settings/helpers/get-theme-colors.ts
+var getThemeColors = (themeId) => {
+	return {
+		default: {
+			light: "#fff",
+			dark: "#0f0f0f",
+			accent: "#0099ff"
+		},
+		alternate: {
+			light: "#f9f9f9",
+			dark: "#131313",
+			accent: "#e7e7e7"
+		},
+		moon: {
+			light: "#ccc9b3",
+			dark: "#313332",
+			accent: "#645b0f"
+		},
+		purple: {
+			light: "#f5f6f8",
+			dark: "#22252b",
+			accent: "#5469d4"
+		},
+		solarized: {
+			light: "#fdf6e3",
+			dark: "#00212b",
+			accent: "#007acc"
+		},
+		"blue-planet": {
+			light: "#f0f2f5",
+			dark: "#000e23",
+			accent: "#e0e2e6"
+		},
+		saturn: {
+			light: "#e4e4df",
+			dark: "#2c2c30",
+			accent: "#1763a6"
+		},
+		"kepler-11e": {
+			light: "#f6f6f6",
+			dark: "#0d0f1e",
+			accent: "#7070ff"
+		},
+		mars: {
+			light: "#f2efe8",
+			dark: "#321116",
+			accent: "#c75549"
+		},
+		"deep-space": {
+			light: "#f4f4f5",
+			dark: "#09090b",
+			accent: "#8ab4f8"
+		},
+		laserwave: {
+			light: "#f4f2f7",
+			dark: "#27212e",
+			accent: "#ed78c2"
+		}
+	}[themeId] || {
+		light: "#ffffff",
+		dark: "#000000",
+		accent: "#3b82f6"
+	};
+};
+//#endregion
+export { getThemeColors };
+
+//# sourceMappingURL=get-theme-colors.js.map

package/dist/v2/features/settings/helpers/get-theme-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-theme-colors.js","names":[],"sources":["../../../../../src/v2/features/settings/helpers/get-theme-colors.ts"],"sourcesContent":["import type { IntegrationThemeId, themePresets } from '@scalar/themes'\n\ntype ThemePresets = typeof themePresets\n\ntype Themes = Exclude<ThemePresets[number]['slug'], IntegrationThemeId>\n\nexport const getThemeColors = (themeId: Themes | 'none'): { light: string; dark: string; accent: string } => {\n  const colors: Record<Themes, { light: string; dark: string; accent: string }> = {\n    default: { light: '#fff', dark: '#0f0f0f', accent: '#0099ff' },\n    alternate: { light: '#f9f9f9', dark: '#131313', accent: '#e7e7e7' },\n    moon: { light: '#ccc9b3', dark: '#313332', accent: '#645b0f' },\n    purple: { light: '#f5f6f8', dark: '#22252b', accent: '#5469d4' },\n    solarized: { light: '#fdf6e3', dark: '#00212b', accent: '#007acc' },\n    'blue-planet': { light: '#f0f2f5', dark: '#000e23', accent: '#e0e2e6' },\n    saturn: { light: '#e4e4df', dark: '#2c2c30', accent: '#1763a6' },\n    'kepler-11e': { light: '#f6f6f6', dark: '#0d0f1e', accent: '#7070ff' },\n    mars: { light: '#f2efe8', dark: '#321116', accent: '#c75549' },\n    'deep-space': { light: '#f4f4f5', dark: '#09090b', accent: '#8ab4f8' },\n    laserwave: { light: '#f4f2f7', dark: '#27212e', accent: '#ed78c2' },\n  }\n  return colors[themeId as Themes] || { light: '#ffffff', dark: '#000000', accent: '#3b82f6' }\n}\n"],"mappings":";AAMA,IAAa,kBAAkB,YAA8E;AAc3G,QAbgF;EAC9E,SAAS;GAAE,OAAO;GAAQ,MAAM;GAAW,QAAQ;GAAW;EAC9D,WAAW;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EACnE,MAAM;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EAC9D,QAAQ;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EAChE,WAAW;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EACnE,eAAe;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EACvE,QAAQ;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EAChE,cAAc;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EACtE,MAAM;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EAC9D,cAAc;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EACtE,WAAW;GAAE,OAAO;GAAW,MAAM;GAAW,QAAQ;GAAW;EACpE,CACa,YAAsB;EAAE,OAAO;EAAW,MAAM;EAAW,QAAQ;EAAW"}

package/dist/v2/features/settings/index.d.ts

@@ -1,3 +1,3 @@
-export { default as CollectionSettings } from './CollectionSettings.vue';
-export { default as DocumentSettings } from './DocumentSettings.vue';
+export { default as CollectionSettings } from './CollectionSettings.vue.js';
+export { default as DocumentSettings } from './DocumentSettings.vue.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/v2/features/settings/index.js

@@ -1,2 +1,3 @@
-import { n as CollectionSettings_default, t as DocumentSettings_default } from "../../../settings-BKk_1lcH.js";
+import CollectionSettings_default from "./CollectionSettings.vue.js";
+import DocumentSettings_default from "./DocumentSettings.vue.js";
 export { CollectionSettings_default as CollectionSettings, DocumentSettings_default as DocumentSettings };

package/dist/v2/helpers/drag-handle-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drag-handle-factory.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/drag-handle-factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAIpE,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,4CAA4C,CAAA;AAGnD,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,KAAK,CAAA;AA+SpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,kCAG/B;IACD,KAAK,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC9C,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAA;CAC3C;mCAKuC,YAAY,gBAAgB,WAAW,KAAG,OAAO;iCA2DnD,YAAY,gBAAgB,WAAW,KAAG,OAAO;CAwEtF,CAAA"}
+{"version":3,"file":"drag-handle-factory.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/drag-handle-factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAIpE,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,4CAA4C,CAAA;AAGnD,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,KAAK,CAAA;AAkTpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,kCAG/B;IACD,KAAK,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC9C,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAA;CAC3C;mCAKuC,YAAY,gBAAgB,WAAW,KAAG,OAAO;iCA2DnD,YAAY,gBAAgB,WAAW,KAAG,OAAO;CAwEtF,CAAA"}

package/dist/v2/helpers/drag-handle-factory.js

@@ -0,0 +1,258 @@
+import { getResolvedRefDeep } from "../blocks/operation-code-sample/helpers/get-resolved-ref-deep.js";
+import { toValue } from "vue";
+import { unpackProxyObject } from "@scalar/workspace-store/helpers/unpack-proxy";
+import { sortByOrder } from "@scalar/helpers/array/sort-by-order";
+import { getOpenapiObject, getParentEntry } from "@scalar/workspace-store/navigation";
+import { toJsonCompatible } from "@scalar/helpers/object/to-json-compatible";
+import { escapeJsonPointer } from "@scalar/json-magic/helpers/escape-json-pointer";
+//#region src/v2/helpers/drag-handle-factory.ts
+/**
+* Reorders items in an array by moving an item from one index to another,
+* adjusting insertion point based on offset.
+* Returns the new order array, or null if indices are invalid.
+*/
+var reorderArray = (array, fromIndex, toIndex, offset) => {
+	if (fromIndex === -1 || toIndex === -1 || fromIndex === toIndex) return null;
+	const newArray = [...array];
+	const [removed] = newArray.splice(fromIndex, 1);
+	if (removed === void 0) return null;
+	const insertIndex = calculateInsertIndex(fromIndex, toIndex, offset, newArray.length);
+	newArray.splice(insertIndex, 0, removed);
+	return unpackProxyObject(newArray, { depth: 1 });
+};
+/**
+* Calculates the insertion index based on drag offset and direction.
+*/
+var calculateInsertIndex = (fromIndex, toIndex, offset, arrayLength) => {
+	const isMovingDown = fromIndex < toIndex;
+	if (offset === "after") return isMovingDown ? toIndex : toIndex + 1;
+	if (offset === "before") return isMovingDown ? toIndex - 1 : toIndex;
+	if (offset === "into") return arrayLength;
+	return toIndex;
+};
+/**
+* Type guard to check if an entry's type matches any of the provided types.
+*
+* @template Entry - The traversed entry type (must extend TraversedEntry).
+* @template Type - An array of allowed entry types to check against.
+* @param entry - The sidebar entry to check.
+* @param type - Array of entry types to match (e.g., ['document', 'tag']).
+* @returns {boolean} True if entry.type is included in the provided type array; otherwise, false.
+*
+* @example
+* isEntryType(someEntry, ['document', 'tag']) // true if someEntry.type === 'document' or 'tag'
+*/
+var isEntryType = (entry, type) => {
+	return type.includes(entry.type);
+};
+/**
+* Determines if the hovered item qualifies as a "reorder" operation.
+* Reorder means moving before or after another item, not dropping
+* into a parent container.
+*/
+var isReorder = (hoveredItem) => {
+	return hoveredItem.offset === "before" || hoveredItem.offset === "after";
+};
+/**
+* Determines if the hovered item represents a "drop into parent" operation.
+*/
+var isDropIntoParent = (hoveredItem) => {
+	return hoveredItem.offset === "into";
+};
+/**
+* Checks if two sidebar entries (dragging and hovered) share the same parent.
+*
+* This is useful for determining if items can be reordered within the same context,
+* such as reordering tags or operations under the same tag or document, during drag-and-drop operations.
+*
+* @param draggingItem - The entry currently being dragged (must have a parent to compare).
+* @param hoveredItem - The entry currently hovered over (must have a parent to compare).
+* @returns {boolean} True if both entries have the same parent (by id), false otherwise.
+*
+* @example
+* const parent = { id: 'doc-1', type: 'document' };
+* const tagA = { id: 'tag-1', type: 'tag', parent };
+* const tagB = { id: 'tag-2', type: 'tag', parent };
+* itemsShareParent(tagA, tagB); // true
+*
+* const otherParent = { id: 'doc-2', type: 'document' };
+* const tagC = { id: 'tag-3', type: 'tag', parent: otherParent };
+* itemsShareParent(tagA, tagC); // false
+*/
+var itemsShareParent = (draggingItem, hoveredItem) => {
+	if (!draggingItem.parent || !hoveredItem.parent) return false;
+	return draggingItem.parent.id === hoveredItem.parent.id;
+};
+/**
+* Triggers rebuilding of the sidebar for a specific document entry.
+* This is called after operations that alter the sidebar structure.
+*/
+var rebuildSidebar = ({ store, entry }) => {
+	const documentEntry = getParentEntry("document", entry);
+	if (documentEntry) store.buildSidebar(documentEntry.name);
+};
+/**
+* Gets the current order array for a parent entry.
+* Falls back to children IDs if no explicit order exists.
+*/
+var getCurrentOrder = (parent, parentEntry) => {
+	return parent["x-scalar-order"] ?? parentEntry.children?.map((child) => child.id) ?? [];
+};
+/**
+* Handles reordering of entries (tags or operations) within the same parent.
+*/
+var handleReorderWithinParent = (store, draggingItem, hoveredItem, offset) => {
+	const parentEntry = draggingItem.parent;
+	if (!parentEntry || !isEntryType(parentEntry, ["tag", "document"])) return false;
+	const parent = getOpenapiObject({
+		store,
+		entry: parentEntry
+	});
+	if (!parent) return false;
+	const currentOrder = getCurrentOrder(parent, parentEntry);
+	const newOrder = reorderArray(currentOrder, currentOrder.findIndex((id) => id === draggingItem.id), currentOrder.findIndex((id) => id === hoveredItem.id), offset);
+	if (!newOrder) return false;
+	parent["x-scalar-order"] = newOrder;
+	rebuildSidebar({
+		store,
+		entry: parentEntry
+	});
+	return true;
+};
+/**
+* Updates operation tags when moving between different parents.
+*/
+var updateOperationTags = (operation, draggedTag, hoveredTag) => {
+	const tags = new Set(operation.tags ?? []);
+	if (hoveredTag) tags.add(hoveredTag.name);
+	if (draggedTag) tags.delete(draggedTag.name);
+	operation.tags = Array.from(tags);
+};
+/**
+* Moves an operation from one document to another.
+*/
+var moveOperationBetweenDocuments = (draggingDocument, hoveredDocument, draggingItem, operationCopy) => {
+	if (draggingDocument.paths?.[draggingItem.path]?.[draggingItem.method]) delete draggingDocument.paths[draggingItem.path][draggingItem.method];
+	if (!hoveredDocument.paths) hoveredDocument.paths = { [draggingItem.path]: { [draggingItem.method]: operationCopy } };
+	else {
+		if (!hoveredDocument.paths[draggingItem.path]) hoveredDocument.paths[draggingItem.path] = {};
+		hoveredDocument.paths[draggingItem.path][draggingItem.method] = operationCopy;
+	}
+};
+/**
+* Retrieves the dereferenced operation object for a given path and method.
+* This resolves all $ref references so you always get the full, dereferenced operation.
+*/
+var getDereferencedOperation = (document, path, method) => {
+	const operation = document.paths?.[path]?.[method];
+	if (!operation) return;
+	return toJsonCompatible(getResolvedRefDeep(operation), { prefix: `#/paths/${escapeJsonPointer(path)}/${method}` });
+};
+/**
+* Handles moving an operation between different documents/tags.
+*/
+var handleMoveOperation = (store, draggingItem, hoveredItem) => {
+	const draggingDocumentEntry = getParentEntry("document", draggingItem);
+	const hoveredDocumentEntry = getParentEntry("document", hoveredItem);
+	if (!draggingDocumentEntry || !hoveredDocumentEntry) return false;
+	const draggingDocument = getOpenapiObject({
+		store,
+		entry: draggingDocumentEntry
+	});
+	const hoveredDocument = getOpenapiObject({
+		store,
+		entry: hoveredDocumentEntry
+	});
+	if (!draggingDocument || !hoveredDocument) return false;
+	const currentOperation = getDereferencedOperation(draggingDocument, draggingItem.path, draggingItem.method);
+	if (!currentOperation) return false;
+	updateOperationTags(currentOperation, getParentEntry("tag", draggingItem) ?? null, getParentEntry("tag", hoveredItem) ?? null);
+	moveOperationBetweenDocuments(draggingDocument, hoveredDocument, draggingItem, currentOperation);
+	rebuildSidebar({
+		store,
+		entry: draggingItem
+	});
+	rebuildSidebar({
+		store,
+		entry: hoveredItem
+	});
+	return true;
+};
+/**
+* Handles document reordering.
+*/
+var handleDocumentReorder = (store, draggingItem, hoveredItem, offset) => {
+	const order = store.workspace["x-scalar-order"] ?? [];
+	const currentOrder = sortByOrder(Object.keys(store.workspace.documents), order, (item) => item);
+	const newOrder = reorderArray(currentOrder, currentOrder.findIndex((id) => id === draggingItem.id), currentOrder.findIndex((id) => id === hoveredItem.id), offset);
+	if (!newOrder) return false;
+	store.update("x-scalar-order", newOrder);
+	return true;
+};
+/**
+* Factory function that creates drag and drop handlers for sidebar items.
+* Handles reordering and moving of documents, tags, and operations.
+*/
+var dragHandleFactory = ({ store: _store, sidebarState }) => {
+	/**
+	* Handles the end of a drag operation.
+	* Returns true if the drag and drop was successful, false otherwise.
+	*/
+	const handleDragEnd = (_draggingItem, _hoveredItem) => {
+		const store = toValue(_store);
+		if (!store) return false;
+		const draggingItem = sidebarState.getEntryById(_draggingItem.id);
+		const hoveredItem = sidebarState.getEntryById(_hoveredItem.id);
+		if (!draggingItem || !hoveredItem) return false;
+		if (draggingItem.type === "document") {
+			if (hoveredItem.type !== "document" || !isReorder(_hoveredItem)) return false;
+			return handleDocumentReorder(store, draggingItem, hoveredItem, _hoveredItem.offset);
+		}
+		if (draggingItem.type === "tag") {
+			if (hoveredItem.type !== "tag" || !isReorder(_hoveredItem) || !itemsShareParent(draggingItem, hoveredItem)) return false;
+			return handleReorderWithinParent(store, draggingItem, hoveredItem, _hoveredItem.offset);
+		}
+		if (draggingItem.type === "operation") {
+			if (isReorder(_hoveredItem) && itemsShareParent(draggingItem, hoveredItem)) return handleReorderWithinParent(store, draggingItem, hoveredItem, _hoveredItem.offset);
+			if (isEntryType(hoveredItem, ["tag", "document"]) && isDropIntoParent(_hoveredItem)) return handleMoveOperation(store, draggingItem, hoveredItem);
+		}
+		return false;
+	};
+	/**
+	* Determines if an item can be dropped on another item.
+	* Returns true if the drop operation is allowed, false otherwise.
+	*/
+	const isDroppable = (_draggingItem, _hoveredItem) => {
+		const store = toValue(_store);
+		if (!store) return false;
+		const draggingItem = sidebarState.getEntryById(_draggingItem.id);
+		const hoveredItem = sidebarState.getEntryById(_hoveredItem.id);
+		if (!draggingItem || !hoveredItem) return false;
+		if (draggingItem.type === "example") return false;
+		if (draggingItem.type === "document") return hoveredItem.type === "document" && isReorder(_hoveredItem);
+		if (draggingItem.type === "tag") return isReorder(_hoveredItem) && itemsShareParent(draggingItem, hoveredItem);
+		if (draggingItem.type === "operation") {
+			const hoveredDocumentEntry = getParentEntry("document", hoveredItem);
+			const draggingDocumentEntry = getParentEntry("document", draggingItem);
+			if (!hoveredDocumentEntry || !draggingDocumentEntry) return false;
+			const hoveredDocument = getOpenapiObject({
+				store,
+				entry: hoveredDocumentEntry
+			});
+			if (!hoveredDocument) return false;
+			const sameParent = itemsShareParent(draggingItem, hoveredItem);
+			if (isReorder(_hoveredItem) && !sameParent) return false;
+			if (sameParent) return isReorder(_hoveredItem) || isDropIntoParent(_hoveredItem) && isEntryType(hoveredItem, ["tag", "document"]);
+			return isDropIntoParent(_hoveredItem) && isEntryType(hoveredItem, ["tag", "document"]) && (draggingDocumentEntry.id === hoveredDocumentEntry.id || hoveredDocument.paths?.[draggingItem.path]?.[draggingItem.method] === void 0);
+		}
+		return false;
+	};
+	return {
+		handleDragEnd,
+		isDroppable
+	};
+};
+//#endregion
+export { dragHandleFactory };
+
+//# sourceMappingURL=drag-handle-factory.js.map

package/dist/v2/helpers/drag-handle-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-handle-factory.js","names":[],"sources":["../../../src/v2/helpers/drag-handle-factory.ts"],"sourcesContent":["import { sortByOrder } from '@scalar/helpers/array/sort-by-order'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { toJsonCompatible } from '@scalar/helpers/object/to-json-compatible'\nimport { escapeJsonPointer } from '@scalar/json-magic/helpers/escape-json-pointer'\nimport type { DragOffset, DraggingItem, HoveredItem, SidebarState } from '@scalar/sidebar'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\nimport { getOpenapiObject, getParentEntry } from '@scalar/workspace-store/navigation'\nimport type { WorkspaceDocument } from '@scalar/workspace-store/schemas'\nimport type {\n  TraversedDocument,\n  TraversedEntry,\n  TraversedOperation,\n  TraversedTag,\n} from '@scalar/workspace-store/schemas/navigation'\nimport type { TagObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/operation'\nimport { type MaybeRefOrGetter, toValue } from 'vue'\n\nimport { getResolvedRefDeep } from '@/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep'\n\n/**\n * Reorders items in an array by moving an item from one index to another,\n * adjusting insertion point based on offset.\n * Returns the new order array, or null if indices are invalid.\n */\nconst reorderArray = <T>(array: T[], fromIndex: number, toIndex: number, offset: DragOffset): T[] | null => {\n  if (fromIndex === -1 || toIndex === -1 || fromIndex === toIndex) {\n    return null\n  }\n\n  const newArray = [...array]\n  const [removed] = newArray.splice(fromIndex, 1)\n  if (removed === undefined) {\n    return null\n  }\n\n  const insertIndex = calculateInsertIndex(fromIndex, toIndex, offset, newArray.length)\n  newArray.splice(insertIndex, 0, removed)\n  return unpackProxyObject(newArray, { depth: 1 })\n}\n\n/**\n * Calculates the insertion index based on drag offset and direction.\n */\nconst calculateInsertIndex = (fromIndex: number, toIndex: number, offset: DragOffset, arrayLength: number): number => {\n  const isMovingDown = fromIndex < toIndex\n\n  if (offset === 'after') {\n    return isMovingDown ? toIndex : toIndex + 1\n  }\n\n  if (offset === 'before') {\n    return isMovingDown ? toIndex - 1 : toIndex\n  }\n\n  if (offset === 'into') {\n    return arrayLength\n  }\n\n  return toIndex\n}\n\n/**\n * Type guard to check if an entry's type matches any of the provided types.\n *\n * @template Entry - The traversed entry type (must extend TraversedEntry).\n * @template Type - An array of allowed entry types to check against.\n * @param entry - The sidebar entry to check.\n * @param type - Array of entry types to match (e.g., ['document', 'tag']).\n * @returns {boolean} True if entry.type is included in the provided type array; otherwise, false.\n *\n * @example\n * isEntryType(someEntry, ['document', 'tag']) // true if someEntry.type === 'document' or 'tag'\n */\nconst isEntryType = <Entry extends TraversedEntry, const Type extends TraversedEntry['type'][]>(\n  entry: Entry,\n  type: Type,\n): entry is Entry & { type: Type[number] } => {\n  return type.includes(entry.type)\n}\n\n/**\n * Determines if the hovered item qualifies as a \"reorder\" operation.\n * Reorder means moving before or after another item, not dropping\n * into a parent container.\n */\nconst isReorder = (hoveredItem: HoveredItem): boolean => {\n  return hoveredItem.offset === 'before' || hoveredItem.offset === 'after'\n}\n\n/**\n * Determines if the hovered item represents a \"drop into parent\" operation.\n */\nconst isDropIntoParent = (hoveredItem: HoveredItem): boolean => {\n  return hoveredItem.offset === 'into'\n}\n\n/**\n * Checks if two sidebar entries (dragging and hovered) share the same parent.\n *\n * This is useful for determining if items can be reordered within the same context,\n * such as reordering tags or operations under the same tag or document, during drag-and-drop operations.\n *\n * @param draggingItem - The entry currently being dragged (must have a parent to compare).\n * @param hoveredItem - The entry currently hovered over (must have a parent to compare).\n * @returns {boolean} True if both entries have the same parent (by id), false otherwise.\n *\n * @example\n * const parent = { id: 'doc-1', type: 'document' };\n * const tagA = { id: 'tag-1', type: 'tag', parent };\n * const tagB = { id: 'tag-2', type: 'tag', parent };\n * itemsShareParent(tagA, tagB); // true\n *\n * const otherParent = { id: 'doc-2', type: 'document' };\n * const tagC = { id: 'tag-3', type: 'tag', parent: otherParent };\n * itemsShareParent(tagA, tagC); // false\n */\nconst itemsShareParent = (\n  draggingItem: TraversedEntry & { parent?: TraversedEntry },\n  hoveredItem: TraversedEntry & { parent?: TraversedEntry },\n): boolean => {\n  if (!draggingItem.parent || !hoveredItem.parent) {\n    return false\n  }\n  return draggingItem.parent.id === hoveredItem.parent.id\n}\n\n/**\n * Triggers rebuilding of the sidebar for a specific document entry.\n * This is called after operations that alter the sidebar structure.\n */\nconst rebuildSidebar = ({ store, entry }: { store: WorkspaceStore; entry: TraversedEntry }): void => {\n  const documentEntry = getParentEntry('document', entry)\n  if (documentEntry) {\n    store.buildSidebar(documentEntry.name)\n  }\n}\n\n/**\n * Gets the current order array for a parent entry.\n * Falls back to children IDs if no explicit order exists.\n */\nconst getCurrentOrder = (\n  parent: WorkspaceDocument | TagObject,\n  parentEntry: TraversedDocument | TraversedTag,\n): string[] => {\n  const order = parent['x-scalar-order']\n  return order ?? parentEntry.children?.map((child) => child.id) ?? []\n}\n\n/**\n * Handles reordering of entries (tags or operations) within the same parent.\n */\nconst handleReorderWithinParent = (\n  store: WorkspaceStore,\n  draggingItem: TraversedEntry & { parent?: TraversedEntry },\n  hoveredItem: TraversedEntry & { parent?: TraversedEntry },\n  offset: DragOffset,\n): boolean => {\n  const parentEntry = draggingItem.parent\n  if (!parentEntry || !isEntryType(parentEntry, ['tag', 'document'])) {\n    return false\n  }\n\n  const parent = getOpenapiObject({ store, entry: parentEntry })\n  if (!parent) {\n    return false\n  }\n\n  const currentOrder = getCurrentOrder(parent, parentEntry)\n  const draggedIndex = currentOrder.findIndex((id) => id === draggingItem.id)\n  const hoveredIndex = currentOrder.findIndex((id) => id === hoveredItem.id)\n\n  const newOrder = reorderArray(currentOrder, draggedIndex, hoveredIndex, offset)\n  if (!newOrder) {\n    return false\n  }\n\n  parent['x-scalar-order'] = newOrder\n  rebuildSidebar({ store, entry: parentEntry })\n  return true\n}\n\n/**\n * Updates operation tags when moving between different parents.\n */\nconst updateOperationTags = (\n  operation: OperationObject,\n  draggedTag: TraversedTag | null,\n  hoveredTag: TraversedTag | null,\n): void => {\n  const tags = new Set(operation.tags ?? [])\n\n  if (hoveredTag) {\n    tags.add(hoveredTag.name)\n  }\n\n  if (draggedTag) {\n    tags.delete(draggedTag.name)\n  }\n\n  operation.tags = Array.from(tags)\n}\n\n/**\n * Moves an operation from one document to another.\n */\nconst moveOperationBetweenDocuments = (\n  draggingDocument: WorkspaceDocument,\n  hoveredDocument: WorkspaceDocument,\n  draggingItem: TraversedOperation,\n  operationCopy: OperationObject,\n): void => {\n  // Delete from old location\n  if (draggingDocument.paths?.[draggingItem.path]?.[draggingItem.method]) {\n    delete draggingDocument.paths[draggingItem.path]![draggingItem.method]\n  }\n\n  // Add to new location\n  if (!hoveredDocument.paths) {\n    hoveredDocument.paths = {\n      [draggingItem.path]: {\n        [draggingItem.method]: operationCopy,\n      },\n    }\n  } else {\n    if (!hoveredDocument.paths[draggingItem.path]) {\n      hoveredDocument.paths[draggingItem.path] = {}\n    }\n    hoveredDocument.paths[draggingItem.path]![draggingItem.method] = operationCopy\n  }\n}\n\n/**\n * Retrieves the dereferenced operation object for a given path and method.\n * This resolves all $ref references so you always get the full, dereferenced operation.\n */\nconst getDereferencedOperation = (\n  document: WorkspaceDocument,\n  path: string,\n  method: HttpMethod,\n): OperationObject | undefined => {\n  const operation = document.paths?.[path]?.[method]\n\n  if (!operation) {\n    return undefined\n  }\n\n  const dereferencedOperation = getResolvedRefDeep(operation) as OperationObject\n\n  return toJsonCompatible(dereferencedOperation, { prefix: `#/paths/${escapeJsonPointer(path)}/${method}` }) as\n    | OperationObject\n    | undefined\n}\n\n/**\n * Handles moving an operation between different documents/tags.\n */\nconst handleMoveOperation = (\n  store: WorkspaceStore,\n  draggingItem: TraversedOperation,\n  hoveredItem: TraversedTag | TraversedDocument,\n): boolean => {\n  const draggingDocumentEntry = getParentEntry('document', draggingItem)\n  const hoveredDocumentEntry = getParentEntry('document', hoveredItem)\n\n  if (!draggingDocumentEntry || !hoveredDocumentEntry) {\n    return false\n  }\n\n  const draggingDocument = getOpenapiObject({ store, entry: draggingDocumentEntry })\n  const hoveredDocument = getOpenapiObject({ store, entry: hoveredDocumentEntry })\n\n  if (!draggingDocument || !hoveredDocument) {\n    return false\n  }\n\n  const currentOperation = getDereferencedOperation(draggingDocument, draggingItem.path, draggingItem.method)\n\n  if (!currentOperation) {\n    return false\n  }\n\n  const draggedTag = getParentEntry('tag', draggingItem) ?? null\n  const hoveredTag = getParentEntry('tag', hoveredItem) ?? null\n\n  updateOperationTags(currentOperation, draggedTag, hoveredTag)\n\n  // Create deep copy to avoid proxy reference issues\n  moveOperationBetweenDocuments(draggingDocument, hoveredDocument, draggingItem, currentOperation)\n\n  // Rebuild sidebars for both documents\n  rebuildSidebar({ store, entry: draggingItem })\n  rebuildSidebar({ store, entry: hoveredItem })\n\n  return true\n}\n\n/**\n * Handles document reordering.\n */\nconst handleDocumentReorder = (\n  store: WorkspaceStore,\n  draggingItem: TraversedDocument,\n  hoveredItem: TraversedDocument,\n  offset: DragOffset,\n): boolean => {\n  const order = store.workspace['x-scalar-order'] ?? []\n  const documents = Object.keys(store.workspace.documents)\n  const currentOrder = sortByOrder(documents, order, (item) => item)\n  const draggedIndex = currentOrder.findIndex((id) => id === draggingItem.id)\n  const hoveredIndex = currentOrder.findIndex((id) => id === hoveredItem.id)\n\n  const newOrder = reorderArray(currentOrder, draggedIndex, hoveredIndex, offset)\n  if (!newOrder) {\n    return false\n  }\n\n  store.update('x-scalar-order', newOrder)\n  return true\n}\n\n/**\n * Factory function that creates drag and drop handlers for sidebar items.\n * Handles reordering and moving of documents, tags, and operations.\n */\nexport const dragHandleFactory = ({\n  store: _store,\n  sidebarState,\n}: {\n  store: MaybeRefOrGetter<WorkspaceStore | null>\n  sidebarState: SidebarState<TraversedEntry>\n}) => {\n  /**\n   * Handles the end of a drag operation.\n   * Returns true if the drag and drop was successful, false otherwise.\n   */\n  const handleDragEnd = (_draggingItem: DraggingItem, _hoveredItem: HoveredItem): boolean => {\n    const store = toValue(_store)\n    if (!store) {\n      return false\n    }\n\n    const draggingItem = sidebarState.getEntryById(_draggingItem.id)\n    const hoveredItem = sidebarState.getEntryById(_hoveredItem.id)\n\n    if (!draggingItem || !hoveredItem) {\n      return false\n    }\n\n    // Handle document reordering\n    if (draggingItem.type === 'document') {\n      if (hoveredItem.type !== 'document' || !isReorder(_hoveredItem)) {\n        return false\n      }\n      return handleDocumentReorder(store, draggingItem, hoveredItem, _hoveredItem.offset)\n    }\n\n    // Handle tag reordering\n    if (draggingItem.type === 'tag') {\n      if (hoveredItem.type !== 'tag' || !isReorder(_hoveredItem) || !itemsShareParent(draggingItem, hoveredItem)) {\n        return false\n      }\n      return handleReorderWithinParent(\n        store,\n        draggingItem as TraversedEntry & { parent?: TraversedEntry },\n        hoveredItem as TraversedEntry & { parent?: TraversedEntry },\n        _hoveredItem.offset,\n      )\n    }\n\n    // Handle operation reordering and moving\n    if (draggingItem.type === 'operation') {\n      // Reorder within same parent\n      if (isReorder(_hoveredItem) && itemsShareParent(draggingItem, hoveredItem)) {\n        return handleReorderWithinParent(\n          store,\n          draggingItem as TraversedEntry & { parent?: TraversedEntry },\n          hoveredItem as TraversedEntry & { parent?: TraversedEntry },\n          _hoveredItem.offset,\n        )\n      }\n\n      // Move between different documents/tags\n      if (isEntryType(hoveredItem, ['tag', 'document']) && isDropIntoParent(_hoveredItem)) {\n        return handleMoveOperation(store, draggingItem, hoveredItem)\n      }\n    }\n\n    return false\n  }\n\n  /**\n   * Determines if an item can be dropped on another item.\n   * Returns true if the drop operation is allowed, false otherwise.\n   */\n  const isDroppable = (_draggingItem: DraggingItem, _hoveredItem: HoveredItem): boolean => {\n    const store = toValue(_store)\n    if (!store) {\n      return false\n    }\n\n    const draggingItem = sidebarState.getEntryById(_draggingItem.id)\n    const hoveredItem = sidebarState.getEntryById(_hoveredItem.id)\n\n    if (!draggingItem || !hoveredItem) {\n      return false\n    }\n\n    // Examples cannot be reordered\n    if (draggingItem.type === 'example') {\n      return false\n    }\n\n    // Documents can only be reordered (not dropped into other documents)\n    if (draggingItem.type === 'document') {\n      return hoveredItem.type === 'document' && isReorder(_hoveredItem)\n    }\n\n    // Tags can only be reordered within the same parent\n    if (draggingItem.type === 'tag') {\n      return isReorder(_hoveredItem) && itemsShareParent(draggingItem, hoveredItem)\n    }\n\n    // Operations can be reordered within the same parent or moved between documents/tags\n    if (draggingItem.type === 'operation') {\n      const hoveredDocumentEntry = getParentEntry('document', hoveredItem)\n      const draggingDocumentEntry = getParentEntry('document', draggingItem)\n\n      if (!hoveredDocumentEntry || !draggingDocumentEntry) {\n        return false\n      }\n\n      const hoveredDocument = getOpenapiObject({ store, entry: hoveredDocumentEntry })\n      if (!hoveredDocument) {\n        return false\n      }\n\n      const sameParent = itemsShareParent(draggingItem, hoveredItem)\n\n      // Don't allow reorder when parents are different\n      if (isReorder(_hoveredItem) && !sameParent) {\n        return false\n      }\n\n      // Same parent: allow reorder or drop into tag/document\n      if (sameParent) {\n        return (\n          isReorder(_hoveredItem) || (isDropIntoParent(_hoveredItem) && isEntryType(hoveredItem, ['tag', 'document']))\n        )\n      }\n\n      // Different parents: allow drop into tag/document if no path conflict\n      return (\n        isDropIntoParent(_hoveredItem) &&\n        isEntryType(hoveredItem, ['tag', 'document']) &&\n        (draggingDocumentEntry.id === hoveredDocumentEntry.id ||\n          hoveredDocument.paths?.[draggingItem.path]?.[draggingItem.method] === undefined)\n      )\n    }\n\n    return false\n  }\n\n  return {\n    handleDragEnd,\n    isDroppable,\n  }\n}\n"],"mappings":"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"}

package/dist/v2/helpers/generate-location-id.js

@@ -0,0 +1,25 @@
+import { isDefined } from "@scalar/helpers/array/is-defined";
+//#region src/v2/helpers/generate-location-id.ts
+/**
+* Generates a unique string ID for an API location, based on the document, path, method, and example.
+* Filters out undefined values and serializes the composite array into a stable string.
+*
+* @param params - An object containing document, path, method, and optional example name.
+* @returns A stringified array representing the unique location identifier.
+*
+* Example:
+*   generateLocationId({ document: 'mydoc', path: '/users', method: 'get', example: 'default' })
+*   // => '["mydoc","/users","get","default"]'
+*/
+var generateLocationId = ({ document, path, method, example }) => {
+	return JSON.stringify([
+		document,
+		path,
+		method,
+		example
+	].filter(isDefined));
+};
+//#endregion
+export { generateLocationId };
+
+//# sourceMappingURL=generate-location-id.js.map

package/dist/v2/helpers/generate-location-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-location-id.js","names":[],"sources":["../../../src/v2/helpers/generate-location-id.ts"],"sourcesContent":["import { isDefined } from '@scalar/helpers/array/is-defined'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\n\n/**\n * Generates a unique string ID for an API location, based on the document, path, method, and example.\n * Filters out undefined values and serializes the composite array into a stable string.\n *\n * @param params - An object containing document, path, method, and optional example name.\n * @returns A stringified array representing the unique location identifier.\n *\n * Example:\n *   generateLocationId({ document: 'mydoc', path: '/users', method: 'get', example: 'default' })\n *   // => '[\"mydoc\",\"/users\",\"get\",\"default\"]'\n */\nexport const generateLocationId = ({\n  document,\n  path,\n  method,\n  example,\n}: {\n  document: string\n  path?: string\n  method?: HttpMethod\n  example?: string\n}) => {\n  return JSON.stringify([document, path, method, example].filter(isDefined))\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,IAAa,sBAAsB,EACjC,UACA,MACA,QACA,cAMI;AACJ,QAAO,KAAK,UAAU;EAAC;EAAU;EAAM;EAAQ;EAAQ,CAAC,OAAO,UAAU,CAAC"}

package/dist/v2/helpers/get-active-environment.js

@@ -0,0 +1,19 @@
+import { coerceValue } from "@scalar/workspace-store/schemas/typebox-coerce";
+import { xScalarEnvironmentSchema } from "@scalar/workspace-store/schemas/extensions/document/x-scalar-environments";
+//#region src/v2/helpers/get-active-environment.ts
+var getActiveEnvironment = (workspace, document) => {
+	if (workspace === null) return coerceValue(xScalarEnvironmentSchema, {});
+	const activeEnv = workspace.workspace["x-scalar-active-environment"];
+	if (!activeEnv) return coerceValue(xScalarEnvironmentSchema, {});
+	const workspaceEnv = workspace.workspace["x-scalar-environments"]?.[activeEnv] ?? { variables: [] };
+	const documentEnv = document?.["x-scalar-environments"]?.[activeEnv] ?? { variables: [] };
+	return coerceValue(xScalarEnvironmentSchema, {
+		...workspaceEnv,
+		...documentEnv,
+		variables: [...workspaceEnv.variables, ...documentEnv.variables]
+	});
+};
+//#endregion
+export { getActiveEnvironment };
+
+//# sourceMappingURL=get-active-environment.js.map

package/dist/v2/helpers/get-active-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-environment.js","names":[],"sources":["../../../src/v2/helpers/get-active-environment.ts"],"sourcesContent":["import type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport type { WorkspaceDocument } from '@scalar/workspace-store/schemas'\nimport {\n  type XScalarEnvironment,\n  xScalarEnvironmentSchema,\n} from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport { coerceValue } from '@scalar/workspace-store/schemas/typebox-coerce'\n\nexport const getActiveEnvironment = (\n  workspace: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n): XScalarEnvironment => {\n  if (workspace === null) {\n    return coerceValue(xScalarEnvironmentSchema, {})\n  }\n  const activeEnv = workspace.workspace['x-scalar-active-environment']\n\n  if (!activeEnv) {\n    return coerceValue(xScalarEnvironmentSchema, {})\n  }\n\n  const workspaceEnv = workspace.workspace['x-scalar-environments']?.[activeEnv] ?? {\n    variables: [],\n  }\n  const documentEnv = document?.['x-scalar-environments']?.[activeEnv] ?? {\n    variables: [],\n  }\n\n  return coerceValue(xScalarEnvironmentSchema, {\n    ...workspaceEnv,\n    ...documentEnv,\n    variables: [...workspaceEnv.variables, ...documentEnv.variables],\n  })\n}\n"],"mappings":";;;AAQA,IAAa,wBACX,WACA,aACuB;AACvB,KAAI,cAAc,KAChB,QAAO,YAAY,0BAA0B,EAAE,CAAC;CAElD,MAAM,YAAY,UAAU,UAAU;AAEtC,KAAI,CAAC,UACH,QAAO,YAAY,0BAA0B,EAAE,CAAC;CAGlD,MAAM,eAAe,UAAU,UAAU,2BAA2B,cAAc,EAChF,WAAW,EAAE,EACd;CACD,MAAM,cAAc,WAAW,2BAA2B,cAAc,EACtE,WAAW,EAAE,EACd;AAED,QAAO,YAAY,0BAA0B;EAC3C,GAAG;EACH,GAAG;EACH,WAAW,CAAC,GAAG,aAAa,WAAW,GAAG,YAAY,UAAU;EACjE,CAAC"}

package/dist/v2/helpers/get-active-proxy-url.d.ts

@@ -1,5 +1,5 @@
 import type { Workspace } from '@scalar/workspace-store/schemas';
-import type { ClientLayout } from '@/v2/types/layout';
+import type { ClientLayout } from '../../v2/types/layout';
 /**
  * Returns the default proxy URL for web layout.
  * For the 'web' layout, this ensures requests use Scalar's hosted proxy unless overridden,

package/dist/v2/helpers/get-active-proxy-url.js

@@ -0,0 +1,26 @@
+//#region src/v2/helpers/get-active-proxy-url.ts
+/**
+* Returns the default proxy URL for web layout.
+* For the 'web' layout, this ensures requests use Scalar's hosted proxy unless overridden,
+* which is important for browser environments with CORS or network restrictions.
+* For 'desktop' or 'modal' layouts, returns null to indicate no proxy by default.
+*/
+var getDefaultProxyUrl = (layout) => {
+	if (layout === "web") return "https://proxy.scalar.com";
+	return null;
+};
+/**
+* Returns the active proxy URL for the workspace.
+*
+* Logic:
+* - If the active proxy url is not set, use the default proxy url.
+* - Otherwise, use the active proxy url.
+*/
+var getActiveProxyUrl = (activeProxyUrl, layout) => {
+	if (activeProxyUrl === void 0) return getDefaultProxyUrl(layout);
+	return activeProxyUrl;
+};
+//#endregion
+export { getActiveProxyUrl };
+
+//# sourceMappingURL=get-active-proxy-url.js.map

package/dist/v2/helpers/get-active-proxy-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-proxy-url.js","names":[],"sources":["../../../src/v2/helpers/get-active-proxy-url.ts"],"sourcesContent":["import type { Workspace } from '@scalar/workspace-store/schemas'\n\nimport type { ClientLayout } from '@/v2/types/layout'\n\n/**\n * Returns the default proxy URL for web layout.\n * For the 'web' layout, this ensures requests use Scalar's hosted proxy unless overridden,\n * which is important for browser environments with CORS or network restrictions.\n * For 'desktop' or 'modal' layouts, returns null to indicate no proxy by default.\n */\nexport const getDefaultProxyUrl = (layout: ClientLayout) => {\n  if (layout === 'web') {\n    return 'https://proxy.scalar.com'\n  }\n  return null\n}\n\n/**\n * Returns the active proxy URL for the workspace.\n *\n * Logic:\n * - If the active proxy url is not set, use the default proxy url.\n * - Otherwise, use the active proxy url.\n */\nexport const getActiveProxyUrl = (activeProxyUrl: Workspace['x-scalar-active-proxy'], layout: ClientLayout) => {\n  // If the active proxy url is not set, use the default proxy url\n  if (activeProxyUrl === undefined) {\n    return getDefaultProxyUrl(layout)\n  }\n  return activeProxyUrl\n}\n"],"mappings":";;;;;;;AAUA,IAAa,sBAAsB,WAAyB;AAC1D,KAAI,WAAW,MACb,QAAO;AAET,QAAO;;;;;;;;;AAUT,IAAa,qBAAqB,gBAAoD,WAAyB;AAE7G,KAAI,mBAAmB,KAAA,EACrB,QAAO,mBAAmB,OAAO;AAEnC,QAAO"}

package/dist/v2/helpers/get-servers.js

@@ -0,0 +1,106 @@
+import { combineUrlAndPath } from "@scalar/helpers/url/merge-urls";
+//#region src/v2/helpers/get-servers.ts
+/**
+* Retrieves and processes servers from an OpenAPI document.
+*
+* This function handles several scenarios:
+* 1. No servers provided - creates a default server from document URL or fallback
+* 2. Invalid server configurations - filters them out with warnings
+* 3. Relative URLs - resolves them to absolute URLs using available base URLs
+*
+* @param servers - Array of OpenAPI server objects from the document
+* @param options - Configuration options for server processing
+* @returns Array of validated Server entities
+*/
+function getServers(servers, options = {}) {
+	if (!servers?.length) {
+		const fallbackServer = createFallbackServer(options);
+		return fallbackServer ? [fallbackServer] : [];
+	}
+	if (!Array.isArray(servers)) return [];
+	const validServers = servers.map((server) => processServerObject(server, options));
+	if (validServers.length === 0) {
+		const fallbackServer = createFallbackServer(options);
+		return fallbackServer ? [fallbackServer] : [];
+	}
+	return validServers;
+}
+/**
+* Extracts the base URL (protocol + hostname) from a document URL.
+* Returns undefined if the URL is invalid.
+*/
+function extractBaseUrlFromDocumentUrl(documentUrl) {
+	try {
+		const url = new URL(documentUrl);
+		const port = url.port ? `:${url.port}` : "";
+		return `${url.protocol}//${url.hostname}${port}`;
+	} catch {
+		return;
+	}
+}
+/**
+* Gets the fallback URL from window.location.origin if available.
+*/
+function getFallbackUrl() {
+	if (typeof window === "undefined" || typeof window?.location?.origin !== "string") return;
+	return window.location.origin;
+}
+/**
+* Creates a server object from a URL string, with error handling.
+*/
+function createServerFromUrl(url) {
+	return { url };
+}
+/**
+* Creates a default server using the document URL as the base.
+*/
+function createDefaultServerFromDocumentUrl(documentUrl) {
+	const baseUrl = extractBaseUrlFromDocumentUrl(documentUrl);
+	if (!baseUrl) return;
+	return createServerFromUrl(baseUrl);
+}
+/**
+* Creates a default server using the fallback URL (window.location.origin).
+*/
+function createDefaultServerFromFallback() {
+	const fallbackUrl = getFallbackUrl();
+	if (!fallbackUrl) return;
+	return createServerFromUrl(fallbackUrl);
+}
+/**
+* Resolves a relative server URL to an absolute URL using available base URLs.
+* Uses a priority system: baseServerURL > documentUrl > fallbackUrl.
+*/
+function resolveRelativeServerUrl(serverUrl, options) {
+	const { baseServerUrl: baseServerURL, documentUrl } = options;
+	if (baseServerURL) return combineUrlAndPath(baseServerURL, serverUrl);
+	if (documentUrl) {
+		const baseUrl = extractBaseUrlFromDocumentUrl(documentUrl);
+		if (baseUrl) return combineUrlAndPath(baseUrl, serverUrl);
+	}
+	const fallbackUrl = getFallbackUrl();
+	if (fallbackUrl) return combineUrlAndPath(fallbackUrl, serverUrl);
+	return serverUrl;
+}
+/**
+* Processes a single server object, handling validation and URL resolution.
+*/
+function processServerObject(server, options) {
+	if (server.url?.startsWith("/")) server.url = resolveRelativeServerUrl(server.url, options);
+	return server;
+}
+/**
+* Creates a fallback server when no valid servers are available.
+* Uses document URL first, then fallback URL.
+*/
+function createFallbackServer(options) {
+	if (options.documentUrl) {
+		const defaultServer = createDefaultServerFromDocumentUrl(options.documentUrl);
+		if (defaultServer) return defaultServer;
+	}
+	return createDefaultServerFromFallback();
+}
+//#endregion
+export { getServers };
+
+//# sourceMappingURL=get-servers.js.map

package/dist/v2/helpers/get-servers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-servers.js","names":[],"sources":["../../../src/v2/helpers/get-servers.ts"],"sourcesContent":["import { combineUrlAndPath } from '@scalar/helpers/url/merge-urls'\nimport type { ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\n/**\n * Server processing options containing base URLs for resolving relative server URLs.\n */\ntype ServerProcessingOptions = {\n  baseServerUrl?: string\n  documentUrl?: string\n}\n\n/**\n * Retrieves and processes servers from an OpenAPI document.\n *\n * This function handles several scenarios:\n * 1. No servers provided - creates a default server from document URL or fallback\n * 2. Invalid server configurations - filters them out with warnings\n * 3. Relative URLs - resolves them to absolute URLs using available base URLs\n *\n * @param servers - Array of OpenAPI server objects from the document\n * @param options - Configuration options for server processing\n * @returns Array of validated Server entities\n */\nexport function getServers(servers: ServerObject[] | undefined, options: ServerProcessingOptions = {}): ServerObject[] {\n  // Handle case where no servers are provided\n  if (!servers?.length) {\n    const fallbackServer = createFallbackServer(options)\n    return fallbackServer ? [fallbackServer] : []\n  }\n\n  // Handle invalid server array\n  if (!Array.isArray(servers)) {\n    return []\n  }\n\n  // Process each server and filter out invalid ones\n  const validServers = servers.map((server) => processServerObject(server, options))\n\n  // If all servers were invalid, provide a fallback\n  if (validServers.length === 0) {\n    const fallbackServer = createFallbackServer(options)\n    return fallbackServer ? [fallbackServer] : []\n  }\n\n  return validServers\n}\n\n/**\n * Extracts the base URL (protocol + hostname) from a document URL.\n * Returns undefined if the URL is invalid.\n */\nfunction extractBaseUrlFromDocumentUrl(documentUrl: string): string | undefined {\n  try {\n    const url = new URL(documentUrl)\n    const port = url.port ? `:${url.port}` : ''\n    return `${url.protocol}//${url.hostname}${port}`\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Gets the fallback URL from window.location.origin if available.\n */\nfunction getFallbackUrl(): string | undefined {\n  if (typeof window === 'undefined' || typeof window?.location?.origin !== 'string') {\n    return undefined\n  }\n  return window.location.origin\n}\n\n/**\n * Creates a server object from a URL string, with error handling.\n */\nfunction createServerFromUrl(url: string): ServerObject | undefined {\n  return { url }\n}\n\n/**\n * Creates a default server using the document URL as the base.\n */\nfunction createDefaultServerFromDocumentUrl(documentUrl: string): ServerObject | undefined {\n  const baseUrl = extractBaseUrlFromDocumentUrl(documentUrl)\n  if (!baseUrl) {\n    return undefined\n  }\n\n  return createServerFromUrl(baseUrl)\n}\n\n/**\n * Creates a default server using the fallback URL (window.location.origin).\n */\nfunction createDefaultServerFromFallback(): ServerObject | undefined {\n  const fallbackUrl = getFallbackUrl()\n  if (!fallbackUrl) {\n    return undefined\n  }\n\n  return createServerFromUrl(fallbackUrl)\n}\n\n/**\n * Resolves a relative server URL to an absolute URL using available base URLs.\n * Uses a priority system: baseServerURL > documentUrl > fallbackUrl.\n */\nfunction resolveRelativeServerUrl(serverUrl: string, options: ServerProcessingOptions): string {\n  const { baseServerUrl: baseServerURL, documentUrl } = options\n\n  // Priority 1: Use provided base server URL\n  if (baseServerURL) {\n    return combineUrlAndPath(baseServerURL, serverUrl)\n  }\n\n  // Priority 2: Extract base URL from document URL\n  if (documentUrl) {\n    const baseUrl = extractBaseUrlFromDocumentUrl(documentUrl)\n    if (baseUrl) {\n      return combineUrlAndPath(baseUrl, serverUrl)\n    }\n  }\n\n  // Priority 3: Use fallback URL (window.location.origin)\n  const fallbackUrl = getFallbackUrl()\n  if (fallbackUrl) {\n    return combineUrlAndPath(fallbackUrl, serverUrl)\n  }\n\n  // If no base URL is available, return the original URL\n  return serverUrl\n}\n\n/**\n * Processes a single server object, handling validation and URL resolution.\n */\nfunction processServerObject(server: ServerObject, options: ServerProcessingOptions): ServerObject {\n  // Resolve relative URLs to absolute URLs\n  if (server.url?.startsWith('/')) {\n    server.url = resolveRelativeServerUrl(server.url, options)\n  }\n\n  return server\n}\n\n/**\n * Creates a fallback server when no valid servers are available.\n * Uses document URL first, then fallback URL.\n */\nfunction createFallbackServer(options: ServerProcessingOptions): ServerObject | undefined {\n  // Priority 1: Try to create default server from document URL\n  if (options.documentUrl) {\n    const defaultServer = createDefaultServerFromDocumentUrl(options.documentUrl)\n\n    if (defaultServer) {\n      return defaultServer\n    }\n  }\n\n  // Priority 2: Try to create default server from fallback URL\n  return createDefaultServerFromFallback()\n}\n"],"mappings":";;;;;;;;;;;;;;AAuBA,SAAgB,WAAW,SAAqC,UAAmC,EAAE,EAAkB;AAErH,KAAI,CAAC,SAAS,QAAQ;EACpB,MAAM,iBAAiB,qBAAqB,QAAQ;AACpD,SAAO,iBAAiB,CAAC,eAAe,GAAG,EAAE;;AAI/C,KAAI,CAAC,MAAM,QAAQ,QAAQ,CACzB,QAAO,EAAE;CAIX,MAAM,eAAe,QAAQ,KAAK,WAAW,oBAAoB,QAAQ,QAAQ,CAAC;AAGlF,KAAI,aAAa,WAAW,GAAG;EAC7B,MAAM,iBAAiB,qBAAqB,QAAQ;AACpD,SAAO,iBAAiB,CAAC,eAAe,GAAG,EAAE;;AAG/C,QAAO;;;;;;AAOT,SAAS,8BAA8B,aAAyC;AAC9E,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,YAAY;EAChC,MAAM,OAAO,IAAI,OAAO,IAAI,IAAI,SAAS;AACzC,SAAO,GAAG,IAAI,SAAS,IAAI,IAAI,WAAW;SACpC;AACN;;;;;;AAOJ,SAAS,iBAAqC;AAC5C,KAAI,OAAO,WAAW,eAAe,OAAO,QAAQ,UAAU,WAAW,SACvE;AAEF,QAAO,OAAO,SAAS;;;;;AAMzB,SAAS,oBAAoB,KAAuC;AAClE,QAAO,EAAE,KAAK;;;;;AAMhB,SAAS,mCAAmC,aAA+C;CACzF,MAAM,UAAU,8BAA8B,YAAY;AAC1D,KAAI,CAAC,QACH;AAGF,QAAO,oBAAoB,QAAQ;;;;;AAMrC,SAAS,kCAA4D;CACnE,MAAM,cAAc,gBAAgB;AACpC,KAAI,CAAC,YACH;AAGF,QAAO,oBAAoB,YAAY;;;;;;AAOzC,SAAS,yBAAyB,WAAmB,SAA0C;CAC7F,MAAM,EAAE,eAAe,eAAe,gBAAgB;AAGtD,KAAI,cACF,QAAO,kBAAkB,eAAe,UAAU;AAIpD,KAAI,aAAa;EACf,MAAM,UAAU,8BAA8B,YAAY;AAC1D,MAAI,QACF,QAAO,kBAAkB,SAAS,UAAU;;CAKhD,MAAM,cAAc,gBAAgB;AACpC,KAAI,YACF,QAAO,kBAAkB,aAAa,UAAU;AAIlD,QAAO;;;;;AAMT,SAAS,oBAAoB,QAAsB,SAAgD;AAEjG,KAAI,OAAO,KAAK,WAAW,IAAI,CAC7B,QAAO,MAAM,yBAAyB,OAAO,KAAK,QAAQ;AAG5D,QAAO;;;;;;AAOT,SAAS,qBAAqB,SAA4D;AAExF,KAAI,QAAQ,aAAa;EACvB,MAAM,gBAAgB,mCAAmC,QAAQ,YAAY;AAE7E,MAAI,cACF,QAAO;;AAKX,QAAO,iCAAiC"}

package/dist/v2/helpers/get-tab-details.d.ts

@@ -1,6 +1,6 @@
 import type { HttpMethod } from '@scalar/helpers/http/http-methods';
 import type { Tab } from '@scalar/workspace-store/schemas/extensions/workspace';
-import type { GetEntryByLocation } from '@/v2/features/app/app-state';
+import type { GetEntryByLocation } from '../../v2/features/app/app-state.js';
 /**
  * Returns display details for a tab in the API client UI.
  * Determines the title and icon to use based on workspace, document, path, and method.