@scalar/workspace-store 0.21.0 → 0.22.0

package/dist/mutators/tabs.d.ts

@@ -0,0 +1,44 @@
+import type { TabEvents } from '../events/definitions/tabs.js';
+import type { Workspace } from '../schemas.js';
+/**
+ * Updates the tabs and active tab index in the workspace.
+ * This is used for bulk updates when synchronizing state.
+ */
+export declare const updateTabs: (workspace: Workspace | null, payload: TabEvents["tabs:update:tabs"]) => void;
+/**
+ * Adds a new tab by duplicating the currently active tab.
+ * This preserves the user's context when opening a new tab.
+ */
+export declare const addTab: (workspace: Workspace | null, _payload: TabEvents["tabs:add:tab"]) => boolean;
+/**
+ * Closes the currently active tab.
+ * Prevents closing if only one tab remains, to ensure the user always has a tab open.
+ * Adjusts the active index if needed to keep it in bounds.
+ */
+export declare const closeTab: (workspace: Workspace | null, payload: TabEvents["tabs:close:tab"]) => boolean;
+/**
+ * Closes all other tabs except the one at the given index
+ */
+export declare const closeOtherTabs: (workspace: Workspace | null, payload: TabEvents["tabs:close:other-tabs"]) => boolean;
+/**
+ * Navigates to the previous tab in the list.
+ * Does nothing if already at the first tab.
+ */
+export declare const navigatePreviousTab: (workspace: Workspace | null, _payload: TabEvents["tabs:navigate:previous"]) => boolean;
+/**
+ * Navigates to the next tab in the list.
+ * Does nothing if already at the last tab.
+ */
+export declare const navigateNextTab: (workspace: Workspace | null, _payload: TabEvents["tabs:navigate:next"]) => boolean;
+/**
+ * Focuses a specific tab based on keyboard number input (1-9).
+ * Extracts the digit from the keyboard event and focuses that tab.
+ * Tab numbering starts at 1 for user convenience but uses 0-based indexing internally.
+ */
+export declare const focusTab: (workspace: Workspace | null, payload: TabEvents["tabs:focus:tab"]) => boolean;
+/**
+ * Focuses the last tab in the list.
+ * This provides a quick way to jump to the end, regardless of how many tabs exist.
+ */
+export declare const focusLastTab: (workspace: Workspace | null, _payload: TabEvents["tabs:focus:tab-last"]) => boolean;
+//# sourceMappingURL=tabs.d.ts.map

package/dist/mutators/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/mutators/tabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAoC1C;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,WAAW,SAAS,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,kBAAkB,CAAC,KAAG,IAYhG,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,WAAW,SAAS,GAAG,IAAI,EAAE,UAAU,SAAS,CAAC,cAAc,CAAC,KAAG,OAkBzF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,SAAS,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,KAAG,OA8B5F,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,SAAS,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,uBAAuB,CAAC,KAAG,OAezG,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,SAAS,GAAG,IAAI,EAC3B,UAAU,SAAS,CAAC,wBAAwB,CAAC,KAC5C,OAaF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,SAAS,GAAG,IAAI,EAAE,UAAU,SAAS,CAAC,oBAAoB,CAAC,KAAG,OAcxG,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,SAAS,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,KAAG,OAsB5F,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,SAAS,GAAG,IAAI,EAAE,UAAU,SAAS,CAAC,qBAAqB,CAAC,KAAG,OAatG,CAAA"}

package/dist/mutators/tabs.js

@@ -0,0 +1,133 @@
+import { unpackProxyObject } from "../helpers/unpack-proxy.js";
+const TAB_UNPACK_DEPTH = 1;
+const hasValidTabs = (workspace) => {
+  return workspace !== null && workspace["x-scalar-tabs"] !== void 0;
+};
+const getUnpackedTabs = (workspace) => {
+  return unpackProxyObject(workspace["x-scalar-tabs"], { depth: TAB_UNPACK_DEPTH });
+};
+const getActiveIndex = (workspace) => {
+  return workspace["x-scalar-active-tab"] ?? 0;
+};
+const updateTabs = (workspace, payload) => {
+  if (!workspace) {
+    return;
+  }
+  if (payload["x-scalar-tabs"]) {
+    workspace["x-scalar-tabs"] = payload["x-scalar-tabs"];
+  }
+  if (payload["x-scalar-active-tab"] !== void 0) {
+    workspace["x-scalar-active-tab"] = payload["x-scalar-active-tab"];
+  }
+};
+const addTab = (workspace, _payload) => {
+  if (!hasValidTabs(workspace)) {
+    return false;
+  }
+  const tabs = getUnpackedTabs(workspace);
+  const activeIndex = getActiveIndex(workspace);
+  const currentTab = tabs[activeIndex];
+  if (!currentTab) {
+    return false;
+  }
+  const newTabs = [...tabs, { ...currentTab }];
+  workspace["x-scalar-tabs"] = newTabs;
+  workspace["x-scalar-active-tab"] = newTabs.length - 1;
+  return true;
+};
+const closeTab = (workspace, payload) => {
+  const getInputIndex = () => {
+    if ("event" in payload) {
+      return payload.event.code.startsWith("Digit") ? Number.parseInt(payload.event.key, 10) - 1 : Number.NaN;
+    }
+    return payload.index;
+  };
+  if (!hasValidTabs(workspace)) {
+    return false;
+  }
+  const tabs = getUnpackedTabs(workspace);
+  const index = getInputIndex();
+  if (tabs.length <= 1) {
+    return false;
+  }
+  workspace["x-scalar-tabs"] = tabs.filter((_, i) => i !== index);
+  if (index >= tabs.length - 1) {
+    workspace["x-scalar-active-tab"] = tabs.length - 2;
+  }
+  return true;
+};
+const closeOtherTabs = (workspace, payload) => {
+  if (!hasValidTabs(workspace)) {
+    return false;
+  }
+  const tabs = getUnpackedTabs(workspace);
+  if (tabs.length <= 1) {
+    return false;
+  }
+  workspace["x-scalar-tabs"] = tabs.filter((_, index) => index === payload.index);
+  workspace["x-scalar-active-tab"] = 0;
+  return true;
+};
+const navigatePreviousTab = (workspace, _payload) => {
+  if (!hasValidTabs(workspace)) {
+    return false;
+  }
+  const activeIndex = getActiveIndex(workspace);
+  if (activeIndex <= 0) {
+    return false;
+  }
+  workspace["x-scalar-active-tab"] = activeIndex - 1;
+  return true;
+};
+const navigateNextTab = (workspace, _payload) => {
+  if (!hasValidTabs(workspace)) {
+    return false;
+  }
+  const tabs = getUnpackedTabs(workspace);
+  const activeIndex = getActiveIndex(workspace);
+  if (activeIndex >= tabs.length - 1) {
+    return false;
+  }
+  workspace["x-scalar-active-tab"] = activeIndex + 1;
+  return true;
+};
+const focusTab = (workspace, payload) => {
+  if (!hasValidTabs(workspace)) {
+    return false;
+  }
+  const getInputIndex = () => {
+    if ("event" in payload) {
+      return payload.event.code.startsWith("Digit") ? Number.parseInt(payload.event.key, 10) - 1 : Number.NaN;
+    }
+    return payload.index;
+  };
+  const tabs = getUnpackedTabs(workspace);
+  const newActiveIndex = getInputIndex();
+  if (Number.isNaN(newActiveIndex) || newActiveIndex < 0 || newActiveIndex >= tabs.length) {
+    return false;
+  }
+  workspace["x-scalar-active-tab"] = newActiveIndex;
+  return true;
+};
+const focusLastTab = (workspace, _payload) => {
+  if (!hasValidTabs(workspace)) {
+    return false;
+  }
+  const tabs = getUnpackedTabs(workspace);
+  if (tabs.length <= 1) {
+    return false;
+  }
+  workspace["x-scalar-active-tab"] = tabs.length - 1;
+  return true;
+};
+export {
+  addTab,
+  closeOtherTabs,
+  closeTab,
+  focusLastTab,
+  focusTab,
+  navigateNextTab,
+  navigatePreviousTab,
+  updateTabs
+};
+//# sourceMappingURL=tabs.js.map

package/dist/mutators/tabs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mutators/tabs.ts"],
+  "sourcesContent": ["import type { TabEvents } from '@/events/definitions/tabs'\nimport { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport type { Workspace } from '@/schemas'\n\n/**\n * Depth level for unpacking tab proxy objects.\n * We only need shallow unpacking since tabs are a flat array.\n */\nconst TAB_UNPACK_DEPTH = 1\n\n/**\n * Helper to validate that workspace has tabs configured.\n * Returns false if workspace or tabs are not available.\n */\nconst hasValidTabs = (\n  workspace: Workspace | null,\n): workspace is Workspace & { 'x-scalar-tabs': NonNullable<Workspace['x-scalar-tabs']> } => {\n  return workspace !== null && workspace['x-scalar-tabs'] !== undefined\n}\n\n/**\n * Helper to get the unpacked tabs array from workspace.\n * Returns the tabs as a plain array, not a proxy.\n */\nconst getUnpackedTabs = (\n  workspace: Workspace & { 'x-scalar-tabs': NonNullable<Workspace['x-scalar-tabs']> },\n): ReturnType<typeof unpackProxyObject<NonNullable<Workspace['x-scalar-tabs']>>> => {\n  return unpackProxyObject(workspace['x-scalar-tabs']!, { depth: TAB_UNPACK_DEPTH })\n}\n\n/**\n * Helper to get the current active tab index.\n * Defaults to 0 if not set.\n */\nconst getActiveIndex = (workspace: Workspace): number => {\n  return workspace['x-scalar-active-tab'] ?? 0\n}\n\n/**\n * Updates the tabs and active tab index in the workspace.\n * This is used for bulk updates when synchronizing state.\n */\nexport const updateTabs = (workspace: Workspace | null, payload: TabEvents['tabs:update:tabs']): void => {\n  if (!workspace) {\n    return\n  }\n\n  if (payload['x-scalar-tabs']) {\n    workspace['x-scalar-tabs'] = payload['x-scalar-tabs']\n  }\n\n  if (payload['x-scalar-active-tab'] !== undefined) {\n    workspace['x-scalar-active-tab'] = payload['x-scalar-active-tab']\n  }\n}\n\n/**\n * Adds a new tab by duplicating the currently active tab.\n * This preserves the user's context when opening a new tab.\n */\nexport const addTab = (workspace: Workspace | null, _payload: TabEvents['tabs:add:tab']): boolean => {\n  if (!hasValidTabs(workspace)) {\n    return false\n  }\n\n  const tabs = getUnpackedTabs(workspace)\n  const activeIndex = getActiveIndex(workspace)\n  const currentTab = tabs[activeIndex]\n\n  if (!currentTab) {\n    return false\n  }\n\n  const newTabs = [...tabs, { ...currentTab }]\n\n  workspace['x-scalar-tabs'] = newTabs\n  workspace['x-scalar-active-tab'] = newTabs.length - 1\n  return true\n}\n\n/**\n * Closes the currently active tab.\n * Prevents closing if only one tab remains, to ensure the user always has a tab open.\n * Adjusts the active index if needed to keep it in bounds.\n */\nexport const closeTab = (workspace: Workspace | null, payload: TabEvents['tabs:close:tab']): boolean => {\n  const getInputIndex = (): number => {\n    if ('event' in payload) {\n      return payload.event.code.startsWith('Digit') ? Number.parseInt(payload.event.key, 10) - 1 : Number.NaN\n    }\n    return payload.index\n  }\n\n  if (!hasValidTabs(workspace)) {\n    return false\n  }\n\n  const tabs = getUnpackedTabs(workspace)\n  const index = getInputIndex()\n\n  if (tabs.length <= 1) {\n    return false\n  }\n\n  workspace['x-scalar-tabs'] = tabs.filter((_, i) => i !== index)\n\n  /**\n   * If we closed a tab at the end, the active index needs to move back.\n   * This ensures the active tab stays within bounds after removal.\n   */\n  if (index >= tabs.length - 1) {\n    workspace['x-scalar-active-tab'] = tabs.length - 2\n  }\n\n  return true\n}\n\n/**\n * Closes all other tabs except the one at the given index\n */\nexport const closeOtherTabs = (workspace: Workspace | null, payload: TabEvents['tabs:close:other-tabs']): boolean => {\n  if (!hasValidTabs(workspace)) {\n    return false\n  }\n\n  const tabs = getUnpackedTabs(workspace)\n\n  if (tabs.length <= 1) {\n    return false\n  }\n\n  workspace['x-scalar-tabs'] = tabs.filter((_, index) => index === payload.index)\n  // set the active tab to the first tab since we closed all other tabs\n  workspace['x-scalar-active-tab'] = 0\n  return true\n}\n\n/**\n * Navigates to the previous tab in the list.\n * Does nothing if already at the first tab.\n */\nexport const navigatePreviousTab = (\n  workspace: Workspace | null,\n  _payload: TabEvents['tabs:navigate:previous'],\n): boolean => {\n  if (!hasValidTabs(workspace)) {\n    return false\n  }\n\n  const activeIndex = getActiveIndex(workspace)\n\n  if (activeIndex <= 0) {\n    return false\n  }\n\n  workspace['x-scalar-active-tab'] = activeIndex - 1\n  return true\n}\n\n/**\n * Navigates to the next tab in the list.\n * Does nothing if already at the last tab.\n */\nexport const navigateNextTab = (workspace: Workspace | null, _payload: TabEvents['tabs:navigate:next']): boolean => {\n  if (!hasValidTabs(workspace)) {\n    return false\n  }\n\n  const tabs = getUnpackedTabs(workspace)\n  const activeIndex = getActiveIndex(workspace)\n\n  if (activeIndex >= tabs.length - 1) {\n    return false\n  }\n\n  workspace['x-scalar-active-tab'] = activeIndex + 1\n  return true\n}\n\n/**\n * Focuses a specific tab based on keyboard number input (1-9).\n * Extracts the digit from the keyboard event and focuses that tab.\n * Tab numbering starts at 1 for user convenience but uses 0-based indexing internally.\n */\nexport const focusTab = (workspace: Workspace | null, payload: TabEvents['tabs:focus:tab']): boolean => {\n  if (!hasValidTabs(workspace)) {\n    return false\n  }\n\n  const getInputIndex = (): number => {\n    if ('event' in payload) {\n      return payload.event.code.startsWith('Digit') ? Number.parseInt(payload.event.key, 10) - 1 : Number.NaN\n    }\n    return payload.index\n  }\n\n  const tabs = getUnpackedTabs(workspace)\n\n  const newActiveIndex = getInputIndex()\n\n  if (Number.isNaN(newActiveIndex) || newActiveIndex < 0 || newActiveIndex >= tabs.length) {\n    return false\n  }\n\n  workspace['x-scalar-active-tab'] = newActiveIndex\n  return true\n}\n\n/**\n * Focuses the last tab in the list.\n * This provides a quick way to jump to the end, regardless of how many tabs exist.\n */\nexport const focusLastTab = (workspace: Workspace | null, _payload: TabEvents['tabs:focus:tab-last']): boolean => {\n  if (!hasValidTabs(workspace)) {\n    return false\n  }\n\n  const tabs = getUnpackedTabs(workspace)\n\n  if (tabs.length <= 1) {\n    return false\n  }\n\n  workspace['x-scalar-active-tab'] = tabs.length - 1\n  return true\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/mutators/tag.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceStore } from '../client.js';
+import type { TagEvents } from '../events/definitions/tag.js';
+/**
+ * Adds a new tag to the WorkspaceDocument's `tags` array.
+ *
+ * If the document or its tags property does not exist, the function safely no-ops or initializes `tags` as needed.
+ *
+ * @param document - The target WorkspaceDocument
+ * @param payload - The name of the tag to add
+ */
+export declare const createTag: (store: WorkspaceStore | null, payload: TagEvents["tag:create:tag"]) => void;
+//# sourceMappingURL=tag.d.ts.map

package/dist/mutators/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/mutators/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAkB3F,CAAA"}

package/dist/mutators/tag.js

@@ -0,0 +1,19 @@
+const createTag = (store, payload) => {
+  const document = store?.workspace.documents[payload.documentName];
+  if (!document) {
+    console.error("Document not found", { payload, store });
+    payload.callback?.(false);
+    return;
+  }
+  if (!document.tags) {
+    document.tags = [];
+  }
+  document.tags.push({
+    name: payload.name
+  });
+  payload.callback?.(true);
+};
+export {
+  createTag
+};
+//# sourceMappingURL=tag.js.map

package/dist/mutators/tag.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mutators/tag.ts"],
+  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport type { TagEvents } from '@/events/definitions/tag'\n\n/**\n * Adds a new tag to the WorkspaceDocument's `tags` array.\n *\n * If the document or its tags property does not exist, the function safely no-ops or initializes `tags` as needed.\n *\n * @param document - The target WorkspaceDocument\n * @param payload - The name of the tag to add\n */\nexport const createTag = (store: WorkspaceStore | null, payload: TagEvents['tag:create:tag']) => {\n  const document = store?.workspace.documents[payload.documentName]\n\n  if (!document) {\n    console.error('Document not found', { payload, store })\n    payload.callback?.(false)\n    return\n  }\n\n  if (!document.tags) {\n    document.tags = []\n  }\n\n  document.tags.push({\n    name: payload.name,\n  })\n\n  payload.callback?.(true)\n}\n"],
+  "mappings": "AAWO,MAAM,YAAY,CAAC,OAA8B,YAAyC;AAC/F,QAAM,WAAW,OAAO,UAAU,UAAU,QAAQ,YAAY;AAEhE,MAAI,CAAC,UAAU;AACb,YAAQ,MAAM,sBAAsB,EAAE,SAAS,MAAM,CAAC;AACtD,YAAQ,WAAW,KAAK;AACxB;AAAA,EACF;AAEA,MAAI,CAAC,SAAS,MAAM;AAClB,aAAS,OAAO,CAAC;AAAA,EACnB;AAEA,WAAS,KAAK,KAAK;AAAA,IACjB,MAAM,QAAQ;AAAA,EAChB,CAAC;AAED,UAAQ,WAAW,IAAI;AACzB;",
+  "names": []
+}

package/dist/navigation/helpers/get-openapi-object.d.ts

@@ -0,0 +1,35 @@
+import type { WorkspaceStore } from '../../client.js';
+import type { WorkspaceDocument } from '../../schemas.js';
+import type { TraversedDocument, TraversedEntry, TraversedOperation, TraversedTag } from '../../schemas/navigation.js';
+import type { OperationObject, TagObject } from '../../schemas/v3.1/strict/openapi-document.js';
+type TraversedOrderable = TraversedDocument | TraversedTag | TraversedOperation;
+type GetOpenapiObject<Entry extends TraversedOrderable> = Entry extends TraversedDocument ? WorkspaceDocument : Entry extends TraversedTag ? TagObject : Entry extends TraversedOperation ? OperationObject : never;
+/** Type guard which checks if the entry has an x-scalar-order property */
+export declare const canHaveOrder: (entry: TraversedEntry) => entry is TraversedOrderable;
+/**
+ * Retrieves the corresponding OpenAPI object (document, tag, or operation) from the workspace store based on the provided entry.
+ *
+ * This helper abstracts the common lookup logic for working with sidebar/drag-and-drop entries and their associated OpenAPI objects.
+ * Returns `null` when the lookup cannot be completed (e.g., document/tag/operation not found).
+ *
+ * @template Entry Either TraversedDocument, TraversedTag, or TraversedOperation.
+ * @param store - The workspace store containing loaded documents.
+ * @param entry - The sidebar entry (document, tag, or operation).
+ * @returns The corresponding OpenAPI object (WorkspaceDocument, TagObject, or OperationObject) or `null` if not found.
+ *
+ * @example
+ * // For a Document entry:
+ * const document = getOpenapiObject({ store, entry: documentEntry })
+ *
+ * // For a Tag entry:
+ * const tag = getOpenapiObject({ store, entry: tagEntry })
+ *
+ * // For an Operation entry:
+ * const operation = getOpenapiObject({ store, entry: operationEntry })
+ */
+export declare const getOpenapiObject: <Entry extends TraversedOrderable>({ store, entry, }: {
+    store: WorkspaceStore;
+    entry: Entry;
+}) => GetOpenapiObject<Entry> | null;
+export {};
+//# sourceMappingURL=get-openapi-object.d.ts.map

package/dist/navigation/helpers/get-openapi-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-openapi-object.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/get-openapi-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC/G,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AAIxF,KAAK,kBAAkB,GAAG,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,CAAA;AAE/E,KAAK,gBAAgB,CAAC,KAAK,SAAS,kBAAkB,IAAI,KAAK,SAAS,iBAAiB,GACrF,iBAAiB,GACjB,KAAK,SAAS,YAAY,GACxB,SAAS,GACT,KAAK,SAAS,kBAAkB,GAC9B,eAAe,GACf,KAAK,CAAA;AAEb,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GAAI,OAAO,cAAc,KAAG,KAAK,IAAI,kBACmB,CAAA;AAEjF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,SAAS,kBAAkB,EAAE,mBAGhE;IACD,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,KAAK,CAAA;CACb,KAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,IA2B7B,CAAA"}

package/dist/navigation/helpers/get-openapi-object.js

@@ -0,0 +1,31 @@
+import { getResolvedRef } from "../../helpers/get-resolved-ref.js";
+import { getParentEntry } from "./get-parent-entry.js";
+const canHaveOrder = (entry) => entry.type === "document" || entry.type === "tag" || entry.type === "operation";
+const getOpenapiObject = ({
+  store,
+  entry
+}) => {
+  const documentEntry = getParentEntry("document", entry);
+  if (!documentEntry) {
+    return null;
+  }
+  const document = store.workspace.documents[documentEntry.name];
+  if (!document) {
+    return null;
+  }
+  if (entry.type === "document") {
+    return document;
+  }
+  if (entry.type === "tag") {
+    return document.tags?.find((tag) => tag.name === entry.name) ?? null;
+  }
+  if (entry.type === "operation") {
+    return getResolvedRef(document.paths?.[entry.path]?.[entry.method]) ?? null;
+  }
+  return null;
+};
+export {
+  canHaveOrder,
+  getOpenapiObject
+};
+//# sourceMappingURL=get-openapi-object.js.map

package/dist/navigation/helpers/get-openapi-object.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/navigation/helpers/get-openapi-object.ts"],
+  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport { getResolvedRef } from '@/helpers/get-resolved-ref'\nimport type { WorkspaceDocument } from '@/schemas'\nimport type { TraversedDocument, TraversedEntry, TraversedOperation, TraversedTag } from '@/schemas/navigation'\nimport type { OperationObject, TagObject } from '@/schemas/v3.1/strict/openapi-document'\n\nimport { getParentEntry } from './get-parent-entry'\n\ntype TraversedOrderable = TraversedDocument | TraversedTag | TraversedOperation\n\ntype GetOpenapiObject<Entry extends TraversedOrderable> = Entry extends TraversedDocument\n  ? WorkspaceDocument\n  : Entry extends TraversedTag\n    ? TagObject\n    : Entry extends TraversedOperation\n      ? OperationObject\n      : never\n\n/** Type guard which checks if the entry has an x-scalar-order property */\nexport const canHaveOrder = (entry: TraversedEntry): entry is TraversedOrderable =>\n  entry.type === 'document' || entry.type === 'tag' || entry.type === 'operation'\n\n/**\n * Retrieves the corresponding OpenAPI object (document, tag, or operation) from the workspace store based on the provided entry.\n *\n * This helper abstracts the common lookup logic for working with sidebar/drag-and-drop entries and their associated OpenAPI objects.\n * Returns `null` when the lookup cannot be completed (e.g., document/tag/operation not found).\n *\n * @template Entry Either TraversedDocument, TraversedTag, or TraversedOperation.\n * @param store - The workspace store containing loaded documents.\n * @param entry - The sidebar entry (document, tag, or operation).\n * @returns The corresponding OpenAPI object (WorkspaceDocument, TagObject, or OperationObject) or `null` if not found.\n *\n * @example\n * // For a Document entry:\n * const document = getOpenapiObject({ store, entry: documentEntry })\n *\n * // For a Tag entry:\n * const tag = getOpenapiObject({ store, entry: tagEntry })\n *\n * // For an Operation entry:\n * const operation = getOpenapiObject({ store, entry: operationEntry })\n */\nexport const getOpenapiObject = <Entry extends TraversedOrderable>({\n  store,\n  entry,\n}: {\n  store: WorkspaceStore\n  entry: Entry\n}): GetOpenapiObject<Entry> | null => {\n  const documentEntry = getParentEntry('document', entry)\n  if (!documentEntry) {\n    return null\n  }\n\n  const document = store.workspace.documents[documentEntry.name]\n  if (!document) {\n    return null\n  }\n\n  if (entry.type === 'document') {\n    return document as GetOpenapiObject<Entry>\n  }\n\n  if (entry.type === 'tag') {\n    // Find the tag by name in the document's tags array\n    return (document.tags?.find((tag) => tag.name === entry.name) as GetOpenapiObject<Entry> | undefined) ?? null\n  }\n\n  if (entry.type === 'operation') {\n    // Fetch and resolve the referenced operation object at the given path/method\n    return (getResolvedRef(document.paths?.[entry.path]?.[entry.method]) as GetOpenapiObject<Entry> | undefined) ?? null\n  }\n\n  // If entry type is unknown, return null\n  return null\n}\n"],
+  "mappings": "AACA,SAAS,sBAAsB;AAK/B,SAAS,sBAAsB;AAaxB,MAAM,eAAe,CAAC,UAC3B,MAAM,SAAS,cAAc,MAAM,SAAS,SAAS,MAAM,SAAS;AAuB/D,MAAM,mBAAmB,CAAmC;AAAA,EACjE;AAAA,EACA;AACF,MAGsC;AACpC,QAAM,gBAAgB,eAAe,YAAY,KAAK;AACtD,MAAI,CAAC,eAAe;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,MAAM,UAAU,UAAU,cAAc,IAAI;AAC7D,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,SAAS,YAAY;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,SAAS,OAAO;AAExB,WAAQ,SAAS,MAAM,KAAK,CAAC,QAAQ,IAAI,SAAS,MAAM,IAAI,KAA6C;AAAA,EAC3G;AAEA,MAAI,MAAM,SAAS,aAAa;AAE9B,WAAQ,eAAe,SAAS,QAAQ,MAAM,IAAI,IAAI,MAAM,MAAM,CAAC,KAA6C;AAAA,EAClH;AAGA,SAAO;AACT;",
+  "names": []
+}

package/dist/navigation/helpers/get-operation-entries.d.ts

@@ -0,0 +1,24 @@
+import type { TraversedDocument, TraversedOperation, TraversedWebhook, WithParent } from '../../schemas/navigation.js';
+type EntriesMap = Map<string, (WithParent<TraversedOperation> | WithParent<TraversedWebhook>)[]>;
+/**
+ * Builds a map of all operations and webhooks in a document, indexed by path/name and method.
+ *
+ * This function recursively traverses the document structure and collects all operation and webhook
+ * entries. Multiple entries can share the same path|method key (for example, when operations are
+ * duplicated across different tags or groups).
+ *
+ * Performance note: If this function is called frequently, consider generating this map once when
+ * creating the sidebar state rather than recalculating it in mutators.
+ *
+ * @param document - The traversed OpenAPI document to extract operations from
+ * @returns A map where keys are `path|method` (for operations) or `name|method` (for webhooks),
+ *          and values are arrays of matching entries. The pipe separator is used to create a
+ *          unique composite key from the two parts.
+ *
+ * @example
+ * const entries = getOperationEntries(document)
+ * const getUsers = entries.get('/users|get') // Array of all GET /users operations
+ */
+export declare const getOperationEntries: (document: TraversedDocument) => EntriesMap;
+export {};
+//# sourceMappingURL=get-operation-entries.d.ts.map

package/dist/navigation/helpers/get-operation-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-operation-entries.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/get-operation-entries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAEjB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACX,MAAM,sBAAsB,CAAA;AAE7B,KAAK,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAA;AAEhG;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,iBAAiB,KAAG,UA2DjE,CAAA"}

package/dist/navigation/helpers/get-operation-entries.js

@@ -0,0 +1,33 @@
+const getOperationEntries = (document) => {
+  const map = /* @__PURE__ */ new Map();
+  const addToMap = (key, entry) => {
+    const existing = map.get(key);
+    if (existing) {
+      existing.push(entry);
+    } else {
+      map.set(key, [entry]);
+    }
+  };
+  const traverse = (entries, parent) => {
+    if (!entries) {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.type === "operation") {
+        const key = `${entry.path}|${entry.method}`;
+        addToMap(key, { ...entry, parent });
+      } else if (entry.type === "webhook") {
+        const key = `${entry.name}|${entry.method}`;
+        addToMap(key, { ...entry, parent });
+      } else if ("children" in entry && entry.children) {
+        traverse(entry.children, { ...entry, parent });
+      }
+    }
+  };
+  traverse(document.children, document);
+  return map;
+};
+export {
+  getOperationEntries
+};
+//# sourceMappingURL=get-operation-entries.js.map

package/dist/navigation/helpers/get-operation-entries.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/navigation/helpers/get-operation-entries.ts"],
+  "sourcesContent": ["import type {\n  TraversedDocument,\n  TraversedEntry,\n  TraversedOperation,\n  TraversedWebhook,\n  WithParent,\n} from '@/schemas/navigation'\n\ntype EntriesMap = Map<string, (WithParent<TraversedOperation> | WithParent<TraversedWebhook>)[]>\n\n/**\n * Builds a map of all operations and webhooks in a document, indexed by path/name and method.\n *\n * This function recursively traverses the document structure and collects all operation and webhook\n * entries. Multiple entries can share the same path|method key (for example, when operations are\n * duplicated across different tags or groups).\n *\n * Performance note: If this function is called frequently, consider generating this map once when\n * creating the sidebar state rather than recalculating it in mutators.\n *\n * @param document - The traversed OpenAPI document to extract operations from\n * @returns A map where keys are `path|method` (for operations) or `name|method` (for webhooks),\n *          and values are arrays of matching entries. The pipe separator is used to create a\n *          unique composite key from the two parts.\n *\n * @example\n * const entries = getOperationEntries(document)\n * const getUsers = entries.get('/users|get') // Array of all GET /users operations\n */\nexport const getOperationEntries = (document: TraversedDocument): EntriesMap => {\n  const map: EntriesMap = new Map()\n\n  /**\n   * Helper function to add an entry to the map under the specified key.\n   * If the key already exists, appends to the array; otherwise creates a new array.\n   *\n   * @param key - The composite key (path|method or name|method)\n   * @param entry - The operation or webhook entry to add (with parent information)\n   */\n  const addToMap = (key: string, entry: WithParent<TraversedOperation> | WithParent<TraversedWebhook>): void => {\n    const existing = map.get(key)\n    if (existing) {\n      existing.push(entry)\n    } else {\n      map.set(key, [entry])\n    }\n  }\n\n  /**\n   * Recursively traverses the document tree to find all operations and webhooks.\n   * Handles three entry types:\n   * - operations: collected into the map using path|method as key\n   * - webhooks: collected into the map using name|method as key\n   * - containers (tags, groups): recursively traversed for their children\n   *\n   * @param entries - Array of entries to traverse (may be undefined for empty sections)\n   * @param parent - The parent entry of the current entries (if any)\n   */\n  const traverse = (\n    entries: TraversedEntry[] | undefined,\n    parent: WithParent<TraversedEntry> | TraversedDocument,\n  ): void => {\n    if (!entries) {\n      return\n    }\n\n    for (const entry of entries) {\n      // Handle operations - use path and method to create unique key\n      if (entry.type === 'operation') {\n        const key = `${entry.path}|${entry.method}`\n        addToMap(key, { ...entry, parent })\n      }\n      // Handle webhooks - use name and method to create unique key\n      else if (entry.type === 'webhook') {\n        const key = `${entry.name}|${entry.method}`\n        addToMap(key, { ...entry, parent })\n      }\n      // Handle containers - recursively traverse children, passing current entry as parent\n      else if ('children' in entry && entry.children) {\n        traverse(entry.children, { ...entry, parent })\n      }\n    }\n  }\n\n  // Start traversal from document root\n  traverse(document.children, document)\n\n  return map\n}\n"],
+  "mappings": "AA6BO,MAAM,sBAAsB,CAAC,aAA4C;AAC9E,QAAM,MAAkB,oBAAI,IAAI;AAShC,QAAM,WAAW,CAAC,KAAa,UAA+E;AAC5G,UAAM,WAAW,IAAI,IAAI,GAAG;AAC5B,QAAI,UAAU;AACZ,eAAS,KAAK,KAAK;AAAA,IACrB,OAAO;AACL,UAAI,IAAI,KAAK,CAAC,KAAK,CAAC;AAAA,IACtB;AAAA,EACF;AAYA,QAAM,WAAW,CACf,SACA,WACS;AACT,QAAI,CAAC,SAAS;AACZ;AAAA,IACF;AAEA,eAAW,SAAS,SAAS;AAE3B,UAAI,MAAM,SAAS,aAAa;AAC9B,cAAM,MAAM,GAAG,MAAM,IAAI,IAAI,MAAM,MAAM;AACzC,iBAAS,KAAK,EAAE,GAAG,OAAO,OAAO,CAAC;AAAA,MACpC,WAES,MAAM,SAAS,WAAW;AACjC,cAAM,MAAM,GAAG,MAAM,IAAI,IAAI,MAAM,MAAM;AACzC,iBAAS,KAAK,EAAE,GAAG,OAAO,OAAO,CAAC;AAAA,MACpC,WAES,cAAc,SAAS,MAAM,UAAU;AAC9C,iBAAS,MAAM,UAAU,EAAE,GAAG,OAAO,OAAO,CAAC;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAGA,WAAS,SAAS,UAAU,QAAQ;AAEpC,SAAO;AACT;",
+  "names": []
+}

package/dist/navigation/helpers/get-parent-entry.d.ts

@@ -0,0 +1,15 @@
+import type { TraversedEntry } from '../../schemas/navigation.js';
+/**
+ * Traverses up the tree to find and return the closest parent node (including self) of a specified type.
+ *
+ * @template Type - The type of node to look for.
+ * @param type - The type to match in the parent chain.
+ * @param node - The node from which traversal begins.
+ * @returns The closest parent node of the specified type, or undefined if not found.
+ */
+export declare const getParentEntry: <Type extends TraversedEntry["type"]>(type: Type, node?: TraversedEntry & {
+    parent?: TraversedEntry;
+}) => (TraversedEntry & {
+    type: Type;
+}) | undefined;
+//# sourceMappingURL=get-parent-entry.d.ts.map

package/dist/navigation/helpers/get-parent-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-parent-entry.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/get-parent-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,SAAS,cAAc,CAAC,MAAM,CAAC,EAChE,MAAM,IAAI,EACV,OAAO,cAAc,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,KAClD,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,GAAG,SAUtC,CAAA"}

package/dist/navigation/helpers/get-parent-entry.js

@@ -0,0 +1,13 @@
+const getParentEntry = (type, node) => {
+  if (!node) {
+    return void 0;
+  }
+  if (node.type === type) {
+    return node;
+  }
+  return getParentEntry(type, node.parent);
+};
+export {
+  getParentEntry
+};
+//# sourceMappingURL=get-parent-entry.js.map

package/dist/navigation/helpers/get-parent-entry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/navigation/helpers/get-parent-entry.ts"],
+  "sourcesContent": ["import type { TraversedEntry } from '@/schemas/navigation'\n\n/**\n * Traverses up the tree to find and return the closest parent node (including self) of a specified type.\n *\n * @template Type - The type of node to look for.\n * @param type - The type to match in the parent chain.\n * @param node - The node from which traversal begins.\n * @returns The closest parent node of the specified type, or undefined if not found.\n */\nexport const getParentEntry = <Type extends TraversedEntry['type']>(\n  type: Type,\n  node?: TraversedEntry & { parent?: TraversedEntry },\n): (TraversedEntry & { type: Type }) | undefined => {\n  if (!node) {\n    return undefined\n  }\n\n  if (node.type === type) {\n    return node as TraversedEntry & { type: Type }\n  }\n\n  return getParentEntry(type, node.parent)\n}\n"],
+  "mappings": "AAUO,MAAM,iBAAiB,CAC5B,MACA,SACkD;AAClD,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,MAAI,KAAK,SAAS,MAAM;AACtB,WAAO;AAAA,EACT;AAEA,SAAO,eAAe,MAAM,KAAK,MAAM;AACzC;",
+  "names": []
+}

package/dist/navigation/helpers/traverse-description.d.ts

@@ -1,7 +1,6 @@
 import type { TraverseSpecOptions } from '../../navigation/types.js';
 import type { TraversedDescription } from '../../schemas/navigation.js';
 import type { InfoObject } from '../../schemas/v3.1/strict/info.js';
-export declare const DEFAULT_INTRODUCTION_SLUG = "introduction";
 /**
  * Creates a hierarchical navigation structure from markdown headings in an OpenAPI description.
  *

package/dist/navigation/helpers/traverse-description.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-description.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-description.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAE5D,eAAO,MAAM,yBAAyB,iBAAiB,CAAA;AAEvD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,GAAI,iCAIjC;IACD,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;CACjB,KAAG,oBAAoB,EAoEvB,CAAA"}
+{"version":3,"file":"traverse-description.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-description.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAI5D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,GAAI,iCAIjC;IACD,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;CACjB,KAAG,oBAAoB,EAoEvB,CAAA"}

package/dist/navigation/helpers/traverse-description.js

@@ -61,7 +61,6 @@ const traverseDescription = ({
   return entries;
 };
 export {
-  DEFAULT_INTRODUCTION_SLUG,
   traverseDescription
 };
 //# sourceMappingURL=traverse-description.js.map

package/dist/navigation/helpers/traverse-description.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/navigation/helpers/traverse-description.ts"],
-  "sourcesContent": ["import { getHeadingsFromMarkdown, getLowestHeadingLevel } from '@/navigation/helpers/utils'\nimport type { Heading, TraverseSpecOptions } from '@/navigation/types'\nimport type { TraversedDescription } from '@/schemas/navigation'\nimport type { InfoObject } from '@/schemas/v3.1/strict/info'\n\nexport const DEFAULT_INTRODUCTION_SLUG = 'introduction'\n\n/**\n * Creates a hierarchical navigation structure from markdown headings in an OpenAPI description.\n *\n * The function processes markdown headings to create a two-level navigation tree:\n * - Level 1: Main sections (based on the lowest heading level found)\n * - Level 2: Subsections (one level deeper than the main sections)\n *\n * If the description starts with content rather than a heading, an \"Introduction\" section\n * is automatically added as the first entry.\n *\n * @param description - The markdown description text to process\n * @param entitiesMap - Map to store heading IDs and titles for mobile header navigation\n * @param getHeadingId - Function to generate unique IDs for headings\n * @returns Array of navigation entries with their hierarchy\n */\nexport const traverseDescription = ({\n  generateId,\n  parentId,\n  info,\n}: {\n  generateId: TraverseSpecOptions['generateId']\n  parentId: string\n  info: InfoObject\n}): TraversedDescription[] => {\n  if (!info.description?.trim()) {\n    return []\n  }\n\n  const headings = getHeadingsFromMarkdown(info.description)\n  const lowestLevel = getLowestHeadingLevel(headings)\n\n  const entries: TraversedDescription[] = []\n  let currentParent: TraversedDescription | null = null\n\n  // Add \"Introduction\" as the first heading\n  if (info.description && !info.description.trim().startsWith('#')) {\n    const heading: Heading = {\n      depth: 1,\n      value: 'Introduction',\n      slug: DEFAULT_INTRODUCTION_SLUG,\n    }\n\n    const id = generateId({\n      type: 'text',\n      depth: heading.depth,\n      slug: heading.slug,\n      parentId: parentId,\n      info: info,\n      value: heading.value,\n    })\n    const title = heading.value\n\n    const entry = {\n      id,\n      title,\n      type: 'text',\n    } satisfies TraversedDescription\n\n    // Push to entries\n    entries.push(entry)\n  }\n\n  // Traverse for the rest\n  for (const heading of headings) {\n    if (heading.depth !== lowestLevel && heading.depth !== lowestLevel + 1) {\n      continue\n    }\n\n    const entry: TraversedDescription = {\n      id: generateId({\n        type: 'text',\n        depth: heading.depth,\n        slug: heading.slug,\n        parentId: parentId,\n        info: info,\n        value: heading.value,\n      }),\n      title: heading.value,\n      type: 'text',\n    }\n\n    if (heading.depth === lowestLevel) {\n      entry.children = []\n      entries.push(entry)\n      currentParent = entry\n    } else if (currentParent) {\n      currentParent.children?.push(entry)\n    }\n  }\n\n  return entries\n}\n"],
-  "mappings": "AAAA,SAAS,yBAAyB,6BAA6B;AAKxD,MAAM,4BAA4B;AAiBlC,MAAM,sBAAsB,CAAC;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF,MAI8B;AAC5B,MAAI,CAAC,KAAK,aAAa,KAAK,GAAG;AAC7B,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,WAAW,wBAAwB,KAAK,WAAW;AACzD,QAAM,cAAc,sBAAsB,QAAQ;AAElD,QAAM,UAAkC,CAAC;AACzC,MAAI,gBAA6C;AAGjD,MAAI,KAAK,eAAe,CAAC,KAAK,YAAY,KAAK,EAAE,WAAW,GAAG,GAAG;AAChE,UAAM,UAAmB;AAAA,MACvB,OAAO;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAEA,UAAM,KAAK,WAAW;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ;AAAA,MACd;AAAA,MACA;AAAA,MACA,OAAO,QAAQ;AAAA,IACjB,CAAC;AACD,UAAM,QAAQ,QAAQ;AAEtB,UAAM,QAAQ;AAAA,MACZ;AAAA,MACA;AAAA,MACA,MAAM;AAAA,IACR;AAGA,YAAQ,KAAK,KAAK;AAAA,EACpB;AAGA,aAAW,WAAW,UAAU;AAC9B,QAAI,QAAQ,UAAU,eAAe,QAAQ,UAAU,cAAc,GAAG;AACtE;AAAA,IACF;AAEA,UAAM,QAA8B;AAAA,MAClC,IAAI,WAAW;AAAA,QACb,MAAM;AAAA,QACN,OAAO,QAAQ;AAAA,QACf,MAAM,QAAQ;AAAA,QACd;AAAA,QACA;AAAA,QACA,OAAO,QAAQ;AAAA,MACjB,CAAC;AAAA,MACD,OAAO,QAAQ;AAAA,MACf,MAAM;AAAA,IACR;AAEA,QAAI,QAAQ,UAAU,aAAa;AACjC,YAAM,WAAW,CAAC;AAClB,cAAQ,KAAK,KAAK;AAClB,sBAAgB;AAAA,IAClB,WAAW,eAAe;AACxB,oBAAc,UAAU,KAAK,KAAK;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import { getHeadingsFromMarkdown, getLowestHeadingLevel } from '@/navigation/helpers/utils'\nimport type { Heading, TraverseSpecOptions } from '@/navigation/types'\nimport type { TraversedDescription } from '@/schemas/navigation'\nimport type { InfoObject } from '@/schemas/v3.1/strict/info'\n\nconst DEFAULT_INTRODUCTION_SLUG = 'introduction'\n\n/**\n * Creates a hierarchical navigation structure from markdown headings in an OpenAPI description.\n *\n * The function processes markdown headings to create a two-level navigation tree:\n * - Level 1: Main sections (based on the lowest heading level found)\n * - Level 2: Subsections (one level deeper than the main sections)\n *\n * If the description starts with content rather than a heading, an \"Introduction\" section\n * is automatically added as the first entry.\n *\n * @param description - The markdown description text to process\n * @param entitiesMap - Map to store heading IDs and titles for mobile header navigation\n * @param getHeadingId - Function to generate unique IDs for headings\n * @returns Array of navigation entries with their hierarchy\n */\nexport const traverseDescription = ({\n  generateId,\n  parentId,\n  info,\n}: {\n  generateId: TraverseSpecOptions['generateId']\n  parentId: string\n  info: InfoObject\n}): TraversedDescription[] => {\n  if (!info.description?.trim()) {\n    return []\n  }\n\n  const headings = getHeadingsFromMarkdown(info.description)\n  const lowestLevel = getLowestHeadingLevel(headings)\n\n  const entries: TraversedDescription[] = []\n  let currentParent: TraversedDescription | null = null\n\n  // Add \"Introduction\" as the first heading\n  if (info.description && !info.description.trim().startsWith('#')) {\n    const heading: Heading = {\n      depth: 1,\n      value: 'Introduction',\n      slug: DEFAULT_INTRODUCTION_SLUG,\n    }\n\n    const id = generateId({\n      type: 'text',\n      depth: heading.depth,\n      slug: heading.slug,\n      parentId: parentId,\n      info: info,\n      value: heading.value,\n    })\n    const title = heading.value\n\n    const entry = {\n      id,\n      title,\n      type: 'text',\n    } satisfies TraversedDescription\n\n    // Push to entries\n    entries.push(entry)\n  }\n\n  // Traverse for the rest\n  for (const heading of headings) {\n    if (heading.depth !== lowestLevel && heading.depth !== lowestLevel + 1) {\n      continue\n    }\n\n    const entry: TraversedDescription = {\n      id: generateId({\n        type: 'text',\n        depth: heading.depth,\n        slug: heading.slug,\n        parentId: parentId,\n        info: info,\n        value: heading.value,\n      }),\n      title: heading.value,\n      type: 'text',\n    }\n\n    if (heading.depth === lowestLevel) {\n      entry.children = []\n      entries.push(entry)\n      currentParent = entry\n    } else if (currentParent) {\n      currentParent.children?.push(entry)\n    }\n  }\n\n  return entries\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB,6BAA6B;AAK/D,MAAM,4BAA4B;AAiB3B,MAAM,sBAAsB,CAAC;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF,MAI8B;AAC5B,MAAI,CAAC,KAAK,aAAa,KAAK,GAAG;AAC7B,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,WAAW,wBAAwB,KAAK,WAAW;AACzD,QAAM,cAAc,sBAAsB,QAAQ;AAElD,QAAM,UAAkC,CAAC;AACzC,MAAI,gBAA6C;AAGjD,MAAI,KAAK,eAAe,CAAC,KAAK,YAAY,KAAK,EAAE,WAAW,GAAG,GAAG;AAChE,UAAM,UAAmB;AAAA,MACvB,OAAO;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAEA,UAAM,KAAK,WAAW;AAAA,MACpB,MAAM;AAAA,MACN,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ;AAAA,MACd;AAAA,MACA;AAAA,MACA,OAAO,QAAQ;AAAA,IACjB,CAAC;AACD,UAAM,QAAQ,QAAQ;AAEtB,UAAM,QAAQ;AAAA,MACZ;AAAA,MACA;AAAA,MACA,MAAM;AAAA,IACR;AAGA,YAAQ,KAAK,KAAK;AAAA,EACpB;AAGA,aAAW,WAAW,UAAU;AAC9B,QAAI,QAAQ,UAAU,eAAe,QAAQ,UAAU,cAAc,GAAG;AACtE;AAAA,IACF;AAEA,UAAM,QAA8B;AAAA,MAClC,IAAI,WAAW;AAAA,QACb,MAAM;AAAA,QACN,OAAO,QAAQ;AAAA,QACf,MAAM,QAAQ;AAAA,QACd;AAAA,QACA;AAAA,QACA,OAAO,QAAQ;AAAA,MACjB,CAAC;AAAA,MACD,OAAO,QAAQ;AAAA,MACf,MAAM;AAAA,IACR;AAEA,QAAI,QAAQ,UAAU,aAAa;AACjC,YAAM,WAAW,CAAC;AAClB,cAAQ,KAAK,KAAK;AAClB,sBAAgB;AAAA,IAClB,WAAW,eAAe;AACxB,oBAAc,UAAU,KAAK,KAAK;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/navigation/helpers/traverse-document.js

@@ -84,8 +84,8 @@ const traverseDocument = (documentName, document, config) => {
       const safeIndexB = indexB === -1 ? Number.POSITIVE_INFINITY : indexB;
       return safeIndexA - safeIndexB;
     });
-    document["x-scalar-order"] = unpackProxyObject(entries.map((entry) => entry.id));
   }
+  document["x-scalar-order"] = unpackProxyObject(entries.map((entry) => entry.id));
   return {
     id: documentId,
     type: "document",

package/dist/navigation/helpers/traverse-document.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/navigation/helpers/traverse-document.ts"],
-  "sourcesContent": ["import { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport { getNavigationOptions } from '@/navigation/get-navigation-options'\nimport type { TagsMap } from '@/navigation/types'\nimport type { TraversedDocument, TraversedEntry } from '@/schemas/navigation'\nimport type { OpenApiDocument } from '@/schemas/v3.1/strict/openapi-document'\nimport type { DocumentConfiguration } from '@/schemas/workspace-specification/config'\n\nimport { traverseDescription } from './traverse-description'\nimport { traversePaths } from './traverse-paths'\nimport { traverseSchemas } from './traverse-schemas'\nimport { traverseTags } from './traverse-tags'\nimport { traverseWebhooks } from './traverse-webhooks'\n\n/**\n * Traverses an OpenAPI Document to generate navigation structure and metadata.\n *\n * This function processes the OpenAPI document to create:\n * - A hierarchical navigation structure for the sidebar\n * - A mapping of IDs to titles for mobile header navigation\n * - Tag-based organization of operations and webhooks\n * - Optional schema/model documentation\n */\nexport const traverseDocument = (documentName: string, document: OpenApiDocument, config?: DocumentConfiguration) => {\n  const { hideModels, tagsSorter, operationsSorter, generateId } = getNavigationOptions(documentName, config)\n\n  const documentId = generateId({\n    type: 'document',\n    info: document.info,\n    name: documentName,\n  })\n\n  /** Map of tags and their entries */\n  const tagsMap: TagsMap = new Map(\n    document.tags?.map((tag) => [\n      tag.name ?? 'Untitled Tag',\n      { id: generateId({ type: 'tag', tag, parentId: documentId }), parentId: documentId, tag, entries: [] },\n    ]) ?? [],\n  )\n\n  /** Generate entries for the document info description field */\n  const entries: TraversedEntry[] = traverseDescription({\n    generateId,\n    parentId: documentId,\n    info: document.info,\n  })\n\n  /** Traverse all the document path  */\n  const { untaggedOperations } = traversePaths({ document, tagsMap, generateId, documentId })\n\n  const untaggedWebhooksParentId = generateId({\n    type: 'webhook',\n    name: '',\n    parentId: documentId,\n  })\n\n  const untaggedWebhooks = traverseWebhooks({\n    document,\n    generateId,\n    tagsMap,\n    untaggedWebhooksParentId,\n    documentId,\n  })\n\n  const tagsEntries = traverseTags({\n    document,\n    tagsMap,\n    documentId,\n    options: { tagsSorter, operationsSorter, generateId },\n  })\n\n  // Add tagged operations, webhooks and tagGroups\n  entries.push(...tagsEntries)\n  // Add untagged operations\n  entries.push(...untaggedOperations)\n\n  // Add untagged webhooks\n  if (untaggedWebhooks.length) {\n    entries.push({\n      type: 'tag',\n      id: untaggedWebhooksParentId,\n      title: 'Webhooks',\n      name: 'Webhooks',\n      children: untaggedWebhooks,\n      isGroup: false,\n      isWebhooks: true,\n    })\n  }\n\n  // Add models if they are not hidden\n  if (!hideModels && document.components?.schemas) {\n    const untaggedModels = traverseSchemas({\n      documentId,\n      document,\n      generateId,\n      tagsMap,\n    })\n\n    if (untaggedModels.length) {\n      entries.push({\n        type: 'models',\n        id: generateId({\n          type: 'model',\n          parentId: documentId,\n        }),\n        title: 'Models',\n        name: 'Models',\n        children: untaggedModels,\n      })\n    }\n  }\n\n  const sortOrder = document['x-scalar-order']\n\n  // Try to sort the entries using the x-scalar-order\n  if (sortOrder) {\n    entries.sort((a, b) => {\n      const indexA = sortOrder.indexOf(a.id)\n      const indexB = sortOrder.indexOf(b.id)\n      // If an id is not found, treat it as \"infinity\" so those items go last.\n      const safeIndexA = indexA === -1 ? Number.POSITIVE_INFINITY : indexA\n      const safeIndexB = indexB === -1 ? Number.POSITIVE_INFINITY : indexB\n      return safeIndexA - safeIndexB\n    })\n\n    // Now update the sort order of the entries\n    document['x-scalar-order'] = unpackProxyObject(entries.map((entry) => entry.id))\n  }\n\n  return {\n    id: documentId,\n    type: 'document',\n    title: document.info.title,\n    name: documentName,\n    children: entries,\n    icon: document['x-scalar-icon'],\n  } satisfies TraversedDocument\n}\n"],
-  "mappings": "AAAA,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AAMrC,SAAS,2BAA2B;AACpC,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,wBAAwB;AAW1B,MAAM,mBAAmB,CAAC,cAAsB,UAA2B,WAAmC;AACnH,QAAM,EAAE,YAAY,YAAY,kBAAkB,WAAW,IAAI,qBAAqB,cAAc,MAAM;AAE1G,QAAM,aAAa,WAAW;AAAA,IAC5B,MAAM;AAAA,IACN,MAAM,SAAS;AAAA,IACf,MAAM;AAAA,EACR,CAAC;AAGD,QAAM,UAAmB,IAAI;AAAA,IAC3B,SAAS,MAAM,IAAI,CAAC,QAAQ;AAAA,MAC1B,IAAI,QAAQ;AAAA,MACZ,EAAE,IAAI,WAAW,EAAE,MAAM,OAAO,KAAK,UAAU,WAAW,CAAC,GAAG,UAAU,YAAY,KAAK,SAAS,CAAC,EAAE;AAAA,IACvG,CAAC,KAAK,CAAC;AAAA,EACT;AAGA,QAAM,UAA4B,oBAAoB;AAAA,IACpD;AAAA,IACA,UAAU;AAAA,IACV,MAAM,SAAS;AAAA,EACjB,CAAC;AAGD,QAAM,EAAE,mBAAmB,IAAI,cAAc,EAAE,UAAU,SAAS,YAAY,WAAW,CAAC;AAE1F,QAAM,2BAA2B,WAAW;AAAA,IAC1C,MAAM;AAAA,IACN,MAAM;AAAA,IACN,UAAU;AAAA,EACZ,CAAC;AAED,QAAM,mBAAmB,iBAAiB;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,cAAc,aAAa;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,EAAE,YAAY,kBAAkB,WAAW;AAAA,EACtD,CAAC;AAGD,UAAQ,KAAK,GAAG,WAAW;AAE3B,UAAQ,KAAK,GAAG,kBAAkB;AAGlC,MAAI,iBAAiB,QAAQ;AAC3B,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAGA,MAAI,CAAC,cAAc,SAAS,YAAY,SAAS;AAC/C,UAAM,iBAAiB,gBAAgB;AAAA,MACrC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,eAAe,QAAQ;AACzB,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,IAAI,WAAW;AAAA,UACb,MAAM;AAAA,UACN,UAAU;AAAA,QACZ,CAAC;AAAA,QACD,OAAO;AAAA,QACP,MAAM;AAAA,QACN,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,YAAY,SAAS,gBAAgB;AAG3C,MAAI,WAAW;AACb,YAAQ,KAAK,CAAC,GAAG,MAAM;AACrB,YAAM,SAAS,UAAU,QAAQ,EAAE,EAAE;AACrC,YAAM,SAAS,UAAU,QAAQ,EAAE,EAAE;AAErC,YAAM,aAAa,WAAW,KAAK,OAAO,oBAAoB;AAC9D,YAAM,aAAa,WAAW,KAAK,OAAO,oBAAoB;AAC9D,aAAO,aAAa;AAAA,IACtB,CAAC;AAGD,aAAS,gBAAgB,IAAI,kBAAkB,QAAQ,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC;AAAA,EACjF;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,OAAO,SAAS,KAAK;AAAA,IACrB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,SAAS,eAAe;AAAA,EAChC;AACF;",
+  "sourcesContent": ["import { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport { getNavigationOptions } from '@/navigation/get-navigation-options'\nimport type { TagsMap } from '@/navigation/types'\nimport type { TraversedDocument, TraversedEntry } from '@/schemas/navigation'\nimport type { OpenApiDocument } from '@/schemas/v3.1/strict/openapi-document'\nimport type { DocumentConfiguration } from '@/schemas/workspace-specification/config'\n\nimport { traverseDescription } from './traverse-description'\nimport { traversePaths } from './traverse-paths'\nimport { traverseSchemas } from './traverse-schemas'\nimport { traverseTags } from './traverse-tags'\nimport { traverseWebhooks } from './traverse-webhooks'\n\n/**\n * Traverses an OpenAPI Document to generate navigation structure and metadata.\n *\n * This function processes the OpenAPI document to create:\n * - A hierarchical navigation structure for the sidebar\n * - A mapping of IDs to titles for mobile header navigation\n * - Tag-based organization of operations and webhooks\n * - Optional schema/model documentation\n */\nexport const traverseDocument = (documentName: string, document: OpenApiDocument, config?: DocumentConfiguration) => {\n  const { hideModels, tagsSorter, operationsSorter, generateId } = getNavigationOptions(documentName, config)\n\n  const documentId = generateId({\n    type: 'document',\n    info: document.info,\n    name: documentName,\n  })\n\n  /** Map of tags and their entries */\n  const tagsMap: TagsMap = new Map(\n    document.tags?.map((tag) => [\n      tag.name ?? 'Untitled Tag',\n      { id: generateId({ type: 'tag', tag, parentId: documentId }), parentId: documentId, tag, entries: [] },\n    ]) ?? [],\n  )\n\n  /** Generate entries for the document info description field */\n  const entries: TraversedEntry[] = traverseDescription({\n    generateId,\n    parentId: documentId,\n    info: document.info,\n  })\n\n  /** Traverse all the document path  */\n  const { untaggedOperations } = traversePaths({ document, tagsMap, generateId, documentId })\n\n  const untaggedWebhooksParentId = generateId({\n    type: 'webhook',\n    name: '',\n    parentId: documentId,\n  })\n\n  const untaggedWebhooks = traverseWebhooks({\n    document,\n    generateId,\n    tagsMap,\n    untaggedWebhooksParentId,\n    documentId,\n  })\n\n  const tagsEntries = traverseTags({\n    document,\n    tagsMap,\n    documentId,\n    options: { tagsSorter, operationsSorter, generateId },\n  })\n\n  // Add tagged operations, webhooks and tagGroups\n  entries.push(...tagsEntries)\n  // Add untagged operations\n  entries.push(...untaggedOperations)\n\n  // Add untagged webhooks\n  if (untaggedWebhooks.length) {\n    entries.push({\n      type: 'tag',\n      id: untaggedWebhooksParentId,\n      title: 'Webhooks',\n      name: 'Webhooks',\n      children: untaggedWebhooks,\n      isGroup: false,\n      isWebhooks: true,\n    })\n  }\n\n  // Add models if they are not hidden\n  if (!hideModels && document.components?.schemas) {\n    const untaggedModels = traverseSchemas({\n      documentId,\n      document,\n      generateId,\n      tagsMap,\n    })\n\n    if (untaggedModels.length) {\n      entries.push({\n        type: 'models',\n        id: generateId({\n          type: 'model',\n          parentId: documentId,\n        }),\n        title: 'Models',\n        name: 'Models',\n        children: untaggedModels,\n      })\n    }\n  }\n\n  const sortOrder = document['x-scalar-order']\n\n  // Try to sort the entries using the x-scalar-order\n  if (sortOrder) {\n    entries.sort((a, b) => {\n      const indexA = sortOrder.indexOf(a.id)\n      const indexB = sortOrder.indexOf(b.id)\n      // If an id is not found, treat it as \"infinity\" so those items go last.\n      const safeIndexA = indexA === -1 ? Number.POSITIVE_INFINITY : indexA\n      const safeIndexB = indexB === -1 ? Number.POSITIVE_INFINITY : indexB\n      return safeIndexA - safeIndexB\n    })\n  }\n\n  // Now update the sort order of the entries\n  document['x-scalar-order'] = unpackProxyObject(entries.map((entry) => entry.id))\n\n  return {\n    id: documentId,\n    type: 'document',\n    title: document.info.title,\n    name: documentName,\n    children: entries,\n    icon: document['x-scalar-icon'],\n  } satisfies TraversedDocument\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AAMrC,SAAS,2BAA2B;AACpC,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,wBAAwB;AAW1B,MAAM,mBAAmB,CAAC,cAAsB,UAA2B,WAAmC;AACnH,QAAM,EAAE,YAAY,YAAY,kBAAkB,WAAW,IAAI,qBAAqB,cAAc,MAAM;AAE1G,QAAM,aAAa,WAAW;AAAA,IAC5B,MAAM;AAAA,IACN,MAAM,SAAS;AAAA,IACf,MAAM;AAAA,EACR,CAAC;AAGD,QAAM,UAAmB,IAAI;AAAA,IAC3B,SAAS,MAAM,IAAI,CAAC,QAAQ;AAAA,MAC1B,IAAI,QAAQ;AAAA,MACZ,EAAE,IAAI,WAAW,EAAE,MAAM,OAAO,KAAK,UAAU,WAAW,CAAC,GAAG,UAAU,YAAY,KAAK,SAAS,CAAC,EAAE;AAAA,IACvG,CAAC,KAAK,CAAC;AAAA,EACT;AAGA,QAAM,UAA4B,oBAAoB;AAAA,IACpD;AAAA,IACA,UAAU;AAAA,IACV,MAAM,SAAS;AAAA,EACjB,CAAC;AAGD,QAAM,EAAE,mBAAmB,IAAI,cAAc,EAAE,UAAU,SAAS,YAAY,WAAW,CAAC;AAE1F,QAAM,2BAA2B,WAAW;AAAA,IAC1C,MAAM;AAAA,IACN,MAAM;AAAA,IACN,UAAU;AAAA,EACZ,CAAC;AAED,QAAM,mBAAmB,iBAAiB;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,cAAc,aAAa;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,EAAE,YAAY,kBAAkB,WAAW;AAAA,EACtD,CAAC;AAGD,UAAQ,KAAK,GAAG,WAAW;AAE3B,UAAQ,KAAK,GAAG,kBAAkB;AAGlC,MAAI,iBAAiB,QAAQ;AAC3B,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAGA,MAAI,CAAC,cAAc,SAAS,YAAY,SAAS;AAC/C,UAAM,iBAAiB,gBAAgB;AAAA,MACrC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,eAAe,QAAQ;AACzB,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,IAAI,WAAW;AAAA,UACb,MAAM;AAAA,UACN,UAAU;AAAA,QACZ,CAAC;AAAA,QACD,OAAO;AAAA,QACP,MAAM;AAAA,QACN,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,YAAY,SAAS,gBAAgB;AAG3C,MAAI,WAAW;AACb,YAAQ,KAAK,CAAC,GAAG,MAAM;AACrB,YAAM,SAAS,UAAU,QAAQ,EAAE,EAAE;AACrC,YAAM,SAAS,UAAU,QAAQ,EAAE,EAAE;AAErC,YAAM,aAAa,WAAW,KAAK,OAAO,oBAAoB;AAC9D,YAAM,aAAa,WAAW,KAAK,OAAO,oBAAoB;AAC9D,aAAO,aAAa;AAAA,IACtB,CAAC;AAAA,EACH;AAGA,WAAS,gBAAgB,IAAI,kBAAkB,QAAQ,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC;AAE/E,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,OAAO,SAAS,KAAK;AAAA,IACrB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,SAAS,eAAe;AAAA,EAChC;AACF;",
   "names": []
 }

package/dist/navigation/helpers/traverse-paths.js

@@ -3,7 +3,7 @@ import { objectKeys } from "@scalar/helpers/object/object-keys";
 import { escapeJsonPointer } from "@scalar/json-magic/helpers/escape-json-pointer";
 import { getResolvedRef } from "../../helpers/get-resolved-ref.js";
 import { traverseOperationExamples } from "../../navigation/helpers/traverse-examples.js";
-import { XScalarStabilityValues } from "../../schemas/extensions/operation/x-scalar-stability.js";
+import { XScalarStabilityValues } from "../../schemas/extensions/operation/index.js";
 import { getTag } from "./get-tag.js";
 const isDeprecatedOperation = (operation) => {
   return operation.deprecated || operation["x-scalar-stability"] === XScalarStabilityValues.Deprecated;