@scalar/api-client 2.17.7 → 2.18.0

package/dist/v2/features/app/App.vue.js

@@ -1,163 +1,111 @@
-import { defineComponent as $, ref as F, computed as r, createElementBlock as V, createBlock as y, unref as e, openBlock as d, Fragment as z, createElementVNode as W, createVNode as l, withCtx as G, normalizeProps as K, guardReactiveProps as j } from "vue";
-import { useModal as q, ScalarTeleportRoot as J } from "@scalar/components";
-import { isHttpMethod as Q } from "@scalar/helpers/http/is-http-method";
-import { getThemeStyles as X } from "@scalar/themes";
-import { ScalarToasts as Y } from "@scalar/use-toasts";
-import { createWorkspaceEventBus as Z } from "@scalar/workspace-store/events";
-import { useRoute as ee, useRouter as te, RouterView as oe } from "vue-router";
-import ae from "./components/CreateWorkspaceModal.vue.js";
-import re from "./components/SplashScreen.vue.js";
-import { useAppSidebar as se } from "./hooks/use-app-sidebar.js";
-import { useDocumentWatcher as ne } from "./hooks/use-document-watcher.js";
-import { useSyncPath as le } from "./hooks/use-sync-path.js";
-import { useWorkspaceSelector as ce } from "./hooks/use-workspace-selector.js";
-import ue from "../command-palette/components/TheCommandPalette.vue.js";
-import { useCommandPaletteState as pe } from "../command-palette/hooks/use-command-palette-state.js";
-import { getActiveEnvironment as ie } from "../../helpers/get-active-environment.js";
-import { useColorMode as me } from "../../hooks/use-color-mode.js";
-import { useGlobalHotKeys as de } from "../../hooks/use-global-hot-keys.js";
-import ve from "./components/AppSidebar.vue.js";
-import ke from "./components/DesktopTabs.vue.js";
-import Se from "./components/WebTopNav.vue.js";
-import { useTabs as fe } from "./hooks/use-tabs.js";
-import { useWorkspaceClientAppEvents as we } from "./hooks/use-workspace-client-app-events.js";
-const he = ["innerHTML"], ye = { class: "flex min-h-0 flex-1" }, We = { class: "bg-b-1 flex-1" }, be = {}, je = /* @__PURE__ */ $({
-  ...be,
+import { defineComponent as k, computed as u, createElementBlock as w, createBlock as p, unref as t, openBlock as n, Fragment as S, createElementVNode as c, createVNode as o, withCtx as f, normalizeProps as b, guardReactiveProps as h } from "vue";
+import { useModal as W, ScalarTeleportRoot as T } from "@scalar/components";
+import { getThemeStyles as y } from "@scalar/themes";
+import { ScalarToasts as B } from "@scalar/use-toasts";
+import { extensions as _ } from "@scalar/workspace-store/schemas/extensions";
+import { RouterView as g } from "vue-router";
+import C from "./components/CreateWorkspaceModal.vue.js";
+import E from "./components/SplashScreen.vue.js";
+import { useDocumentWatcher as O } from "./hooks/use-document-watcher.js";
+import x from "../command-palette/components/TheCommandPalette.vue.js";
+import { useColorMode as I } from "../../hooks/use-color-mode.js";
+import { useGlobalHotKeys as U } from "../../hooks/use-global-hot-keys.js";
+import { useAppState as M } from "./app-state.js";
+import A from "./components/AppSidebar.vue.js";
+import D from "./components/DesktopTabs.vue.js";
+import N from "./components/WebTopNav.vue.js";
+const L = ["innerHTML"], $ = { class: "flex min-h-0 flex-1" }, H = { class: "bg-b-1 flex-1" }, P = {}, se = /* @__PURE__ */ k({
+  ...P,
   __name: "App",
   props: {
     layout: {},
     plugins: { default: () => [] }
   },
-  setup(v) {
-    typeof window < "u" && (window.dataDumpWorkspace = () => o.value);
-    const s = Z({
-      debug: !1
-    }), k = F(!0), B = ee(), A = te(), c = (t) => {
-      const a = B.params[t];
-      return typeof a == "string" ? a : void 0;
-    }, S = r(() => c("workspaceSlug")), n = r(() => c("documentSlug")), p = r(() => !n.value || o.value === null ? null : o.value.workspace.documents[n.value] ?? null), f = r(() => {
-      const t = c("pathEncoded");
-      return t ? decodeURIComponent(t) : void 0;
-    }), w = r(() => {
-      const t = c("method");
-      return t && Q(t) ? t : void 0;
-    }), b = r(() => c("exampleName")), g = ce(), { store: o, workspaces: T, activeWorkspace: i, setWorkspaceId: O, createWorkspace: U } = g;
-    me({ workspaceStore: o });
-    const m = se({
-      workspaceStore: o,
-      documentSlug: n,
-      path: f,
-      method: w,
-      exampleName: b
-    }), E = fe({
-      workspaceStore: o,
-      getEntryByLocation: m.getEntryByLocation,
-      workspaceSlug: S,
-      documentSlug: n,
-      path: f,
-      method: w
-    }), { isLoading: x } = le({
-      workspaceSelectorState: g,
-      tabsState: E,
-      eventBus: s
-    }), _ = pe();
-    we({
-      eventBus: s,
-      document: p,
-      workspaceStore: o,
-      isSidebarOpen: k,
-      commandPaletteState: _,
-      sidebarState: m
-    }), de(s, v.layout), ne({
-      documentName: n,
-      store: o,
+  setup(i) {
+    const e = M();
+    typeof window < "u" && (window.dataDumpWorkspace = () => e.store.value, window.dumpAppState = () => e), I({ workspaceStore: e.store }), U(e.eventBus, i.layout), O({
+      documentName: () => e.store.value?.workspace[_.workspace.activeDocument],
+      store: e.store,
       initialTimeout: 5e3
     });
-    const I = r(
-      () => ie(o.value, p.value)
-    ), M = r(() => {
-      if (o.value === null)
+    const m = u(() => {
+      if (e.store.value === null)
         return "";
-      const t = o.value.workspace["x-scalar-theme"];
-      return t ? `<style>${X(t)}</style>` : "";
-    }), P = 288, D = r(
-      () => o.value?.workspace?.["x-scalar-sidebar-width"] ?? P
-    ), L = r(
-      () => !!(S.value && !n.value)
-    ), N = (t) => o.value?.update("x-scalar-sidebar-width", t), R = () => A.push({
+      const s = e.store.value.workspace["x-scalar-theme"];
+      return s ? `<style>${y(s)}</style>` : "";
+    }), d = () => e.router.value?.push({
       name: "workspace.environment",
-      params: { workspaceSlug: S.value }
-    }), C = (t) => {
-      t && O(t);
-    }, H = r(
-      () => ({
-        documentSlug: n.value ?? "",
-        document: p.value,
-        environment: I.value,
-        eventBus: s,
-        exampleName: b.value,
-        layout: v.layout,
-        method: w.value,
-        path: f.value,
-        workspaceStore: o.value,
-        activeWorkspace: i.value,
-        plugins: v.plugins,
-        securitySchemes: p.value?.components?.securitySchemes ?? {}
-      })
-    ), h = q();
-    return (t, a) => e(o) !== null && e(i) !== null && !e(x) ? (d(), V(z, { key: 0 }, [
-      W("div", { innerHTML: M.value }, null, 8, he),
-      l(e(J), null, {
-        default: G(() => [
-          l(e(Y)),
-          t.layout === "desktop" ? (d(), y(ke, {
+      params: {
+        workspaceSlug: e.activeEntities.workspaceSlug.value
+      }
+    }), l = W(), v = u(() => ({
+      documentSlug: e.activeEntities.documentSlug.value ?? "",
+      document: e.store.value?.workspace.activeDocument ?? null,
+      environment: e.environment.value,
+      eventBus: e.eventBus,
+      exampleName: e.activeEntities.exampleName.value,
+      layout: i.layout,
+      method: e.activeEntities.method.value,
+      path: e.activeEntities.path.value,
+      workspaceStore: e.store.value,
+      activeWorkspace: e.workspace.activeWorkspace.value,
+      plugins: i.plugins,
+      securitySchemes: e.document.value?.components?.securitySchemes ?? {}
+    }));
+    return (s, a) => t(e).store.value !== null && t(e).workspace.activeWorkspace.value !== null && !t(e).loading.value ? (n(), w(S, { key: 0 }, [
+      c("div", { innerHTML: m.value }, null, 8, L),
+      o(t(T), null, {
+        default: f(() => [
+          o(t(B)),
+          s.layout === "desktop" ? (n(), p(D, {
             key: 0,
-            eventBus: e(s),
-            tabsState: e(E)
-          }, null, 8, ["eventBus", "tabsState"])) : (d(), y(Se, {
+            activeTabIndex: t(e).tabs.activeTabIndex.value,
+            eventBus: t(e).eventBus,
+            tabs: t(e).tabs.state.value
+          }, null, 8, ["activeTabIndex", "eventBus", "tabs"])) : (n(), p(N, {
             key: 1,
-            activeWorkspace: e(i),
-            workspaces: e(T),
-            "onCreate:workspace": a[0] || (a[0] = (u) => e(h).show()),
-            "onSelect:workspace": C
-          }, null, 8, ["activeWorkspace", "workspaces"])),
-          W("main", ye, [
-            l(ve, {
-              isSidebarOpen: k.value,
-              "onUpdate:isSidebarOpen": a[1] || (a[1] = (u) => k.value = u),
-              activeWorkspace: e(i),
-              eventBus: e(s),
-              isWorkspaceOpen: L.value,
-              layout: t.layout,
-              sidebarState: e(m).state,
-              sidebarWidth: D.value,
-              store: e(o),
-              workspaces: e(T),
-              "onClick:workspace": R,
-              "onCreate:workspace": a[2] || (a[2] = (u) => e(h).show()),
-              "onSelect:workspace": C,
-              onSelectItem: e(m).handleSelectItem,
-              "onUpdate:sidebarWidth": N
-            }, null, 8, ["isSidebarOpen", "activeWorkspace", "eventBus", "isWorkspaceOpen", "layout", "sidebarState", "sidebarWidth", "store", "workspaces", "onSelectItem"]),
-            l(ae, {
-              state: e(h),
-              "onCreate:workspace": a[3] || (a[3] = (u) => e(U)(u))
+            activeWorkspace: t(e).workspace.activeWorkspace.value,
+            workspaces: t(e).workspace.workspaceList.value,
+            "onCreate:workspace": a[0] || (a[0] = (r) => t(l).show()),
+            "onSelect:workspace": t(e).workspace.setId
+          }, null, 8, ["activeWorkspace", "workspaces", "onSelect:workspace"])),
+          c("main", $, [
+            o(A, {
+              isSidebarOpen: t(e).sidebar.isOpen.value,
+              "onUpdate:isSidebarOpen": a[1] || (a[1] = (r) => t(e).sidebar.isOpen.value = r),
+              activeWorkspace: t(e).workspace.activeWorkspace.value,
+              eventBus: t(e).eventBus,
+              isWorkspaceOpen: t(e).workspace.isOpen.value,
+              layout: s.layout,
+              sidebarState: t(e).sidebar.state,
+              sidebarWidth: t(e).sidebar.width.value,
+              store: t(e).store.value,
+              workspaces: t(e).workspace.workspaceList.value,
+              "onClick:workspace": d,
+              "onCreate:workspace": a[2] || (a[2] = (r) => t(l).show()),
+              "onSelect:workspace": t(e).workspace.setId,
+              onSelectItem: t(e).sidebar.handleSelectItem,
+              "onUpdate:sidebarWidth": t(e).sidebar.handleSidebarWidthUpdate
+            }, null, 8, ["isSidebarOpen", "activeWorkspace", "eventBus", "isWorkspaceOpen", "layout", "sidebarState", "sidebarWidth", "store", "workspaces", "onSelect:workspace", "onSelectItem", "onUpdate:sidebarWidth"]),
+            o(C, {
+              state: t(l),
+              "onCreate:workspace": a[3] || (a[3] = (r) => t(e).workspace.create(r))
             }, null, 8, ["state"]),
-            l(ue, {
-              eventBus: e(s),
-              paletteState: e(_),
-              workspaceStore: e(o)
+            o(x, {
+              eventBus: t(e).eventBus,
+              paletteState: t(e).commandPalette,
+              workspaceStore: t(e).store.value
             }, null, 8, ["eventBus", "paletteState", "workspaceStore"]),
-            W("div", We, [
-              l(e(oe), K(j(H.value)), null, 16)
+            c("div", H, [
+              o(t(g), b(h(v.value)), null, 16)
             ])
           ])
         ]),
         _: 1
       })
-    ], 64)) : (d(), y(re, { key: 1 }));
+    ], 64)) : (n(), p(E, { key: 1 }));
   }
 });
 export {
-  je as default
+  se as default
 };

package/dist/v2/features/app/app-events.d.ts

@@ -0,0 +1,22 @@
+import type { WorkspaceStore } from '@scalar/workspace-store/client';
+import type { WorkspaceEventBus } from '@scalar/workspace-store/events';
+import { type OperationExampleMeta } from '@scalar/workspace-store/mutators';
+import type { WorkspaceDocument } from '@scalar/workspace-store/schemas/workspace';
+import { type ComputedRef, type ShallowRef } from 'vue';
+import type { Router } from 'vue-router';
+import type { OpenCommand } from '../command-palette/hooks/use-command-palette-state.js';
+export declare function initializeAppEventHandlers({ eventBus, getStore, document, router, rebuildSidebar, navigateToCurrentTab, onSelectSidebarItem, onAfterExampleCreation, onOpenCommandPalette, onCopyTabUrl, onToggleSidebar, }: {
+    eventBus: WorkspaceEventBus;
+    getStore: () => WorkspaceStore | null;
+    /** Current active document */
+    document: ComputedRef<WorkspaceDocument | null>;
+    router: ShallowRef<Router | null>;
+    navigateToCurrentTab: () => Promise<void>;
+    rebuildSidebar: (documentName?: string) => void;
+    onSelectSidebarItem: (id: string) => void;
+    onAfterExampleCreation: (o: OperationExampleMeta) => void;
+    onOpenCommandPalette: OpenCommand;
+    onCopyTabUrl: (tabIndex: number) => void;
+    onToggleSidebar: () => void;
+}): void;
+//# sourceMappingURL=app-events.d.ts.map

package/dist/v2/features/app/app-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-events.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/app/app-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAwC,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAE7G,OAAO,EACL,KAAK,oBAAoB,EAgD1B,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAClF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAY,MAAM,KAAK,CAAA;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAA;AAErF,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,eAAe,GAChB,EAAE;IACD,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,QAAQ,EAAE,MAAM,cAAc,GAAG,IAAI,CAAA;IACrC,8BAA8B;IAC9B,QAAQ,EAAE,WAAW,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IAC/C,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACjC,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,cAAc,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,sBAAsB,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAA;IACzD,oBAAoB,EAAE,WAAW,CAAA;IACjC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,eAAe,EAAE,MAAM,IAAI,CAAA;CAC5B,QAySA"}

package/dist/v2/features/app/app-events.js

@@ -0,0 +1,136 @@
+import { mergeObjects as k } from "@scalar/workspace-store/helpers/merge-object";
+import { updateActiveProxy as b, updateColorMode as y, updateTheme as x, updateSelectedClient as R, updateDocumentIcon as O, toggleSecurity as N, updateWatchMode as q, createEmptyDocument as P, deleteDocument as E, upsertEnvironment as M, upsertEnvironmentVariable as T, upsertCookie as I, deleteCookie as D, deleteSecurityScheme as F, updateSelectedAuthTab as U, updateSecurityScheme as V, updateSelectedScopes as j, updateSelectedSecuritySchemes as z, addServer as A, updateServer as H, deleteServer as K, updateServerVariables as L, updateSelectedServer as W, createOperation as G, updateOperationPathMethod as J, updateOperationSummary as Q, deleteOperation as X, deleteOperationExample as Y, addOperationParameter as Z, updateOperationParameter as _, deleteOperationParameter as $, deleteAllOperationParameters as C, updateOperationRequestBodyContentType as S, updateOperationRequestBodyExample as g, addOperationRequestBodyFormRow as B, updateOperationRequestBodyFormRow as ee, deleteOperationRequestBodyFormRow as ae, createTag as oe, deleteTag as te, addTab as re, closeTab as le, closeOtherTabs as ne, focusTab as pe, focusLastTab as ce, navigatePreviousTab as ie, navigateNextTab as me, updateTabs as ue } from "@scalar/workspace-store/mutators";
+import { computed as de } from "vue";
+function ve({
+  eventBus: a,
+  getStore: t,
+  document: o,
+  router: p,
+  rebuildSidebar: i,
+  navigateToCurrentTab: l,
+  onSelectSidebarItem: w,
+  onAfterExampleCreation: u,
+  onOpenCommandPalette: d,
+  onCopyTabUrl: v,
+  onToggleSidebar: f
+}) {
+  const c = de(() => p.value?.currentRoute?.value), s = ({
+    documentName: e,
+    path: r,
+    method: n,
+    exampleName: h
+  }) => !(e !== void 0 && e !== c.value?.params.documentSlug || r !== void 0 && encodeURIComponent(r) !== c.value?.params.pathEncoded || n !== void 0 && n !== c.value?.params.method || h !== void 0 && h !== c.value?.params.exampleName), m = (e, r) => {
+    const n = t();
+    return n ? r === "document" ? e : n.workspace : null;
+  };
+  a.on("scroll-to:nav-item", ({ id: e }) => w(e)), a.on("workspace:update:active-proxy", (e) => b(t()?.workspace ?? null, e)), a.on("workspace:update:color-mode", (e) => y(t()?.workspace ?? null, e)), a.on("workspace:update:theme", (e) => x(t()?.workspace ?? null, e)), a.on("workspace:update:selected-client", (e) => R(t()?.workspace, e)), a.on("document:update:icon", (e) => O(o.value, e)), a.on("document:update:info", (e) => o.value && k(o.value.info, e)), a.on("document:toggle:security", () => N(o.value)), a.on("document:update:watch-mode", (e) => q(o.value, e)), a.on("document:create:empty-document", (e) => P(t(), e)), a.on("document:delete:document", async (e) => {
+    E(t(), e), c?.value?.params.documentSlug === e.name && await p.value?.push({
+      name: "workspace.environment"
+    });
+  }), a.on("environment:upsert:environment", (e) => {
+    const r = t();
+    r && M(o.value, r.workspace, e);
+  }), a.on(
+    "environment:delete:environment",
+    ({ environmentName: e, collectionType: r }) => delete m(o.value, r)?.["x-scalar-environments"]?.[e]
+  ), a.on("environment:upsert:environment-variable", (e) => {
+    const r = m(o.value, e.collectionType);
+    T(r, e);
+  }), a.on(
+    "environment:delete:environment-variable",
+    ({ environmentName: e, index: r, collectionType: n }) => m(o.value, n)?.["x-scalar-environments"]?.[e]?.variables?.splice(
+      r,
+      1
+    )
+  ), a.on("cookie:upsert:cookie", (e) => {
+    const r = m(o.value, e.collectionType);
+    I(r, e);
+  }), a.on("cookie:delete:cookie", (e) => {
+    const r = m(o.value, e.collectionType);
+    D(r, e);
+  }), a.on("auth:delete:security-scheme", (e) => F(o.value, e)), a.on("auth:update:active-index", (e) => U(o.value, e)), a.on("auth:update:security-scheme", (e) => V(o.value, e)), a.on("auth:update:selected-scopes", (e) => j(o.value, e)), a.on(
+    "auth:update:selected-security-schemes",
+    async (e) => await z(o.value, e)
+  ), a.on("server:add:server", () => A(o.value)), a.on("server:update:server", (e) => H(o.value, e)), a.on("server:delete:server", (e) => K(o.value, e)), a.on("server:update:variables", (e) => L(o.value, e)), a.on("server:update:selected", (e) => W(o.value, e)), a.on("operation:create:operation", (e) => G(t(), e)), a.on(
+    "operation:update:pathMethod",
+    (e) => J(o.value, t(), e, async (r) => {
+      r === "success" && (await p.value?.replace({
+        name: "example",
+        params: {
+          method: e.payload.method,
+          pathEncoded: encodeURIComponent(e.payload.path),
+          exampleName: c.value?.params.exampleName
+        }
+      }), i(o.value?.["x-scalar-navigation"]?.name)), e.callback(r);
+    })
+  ), a.on("operation:update:summary", (e) => Q(o.value, e)), a.on("operation:delete:operation", async (e) => {
+    X(t(), e), i(e.documentName), s({
+      documentName: e.documentName,
+      path: e.meta.path,
+      method: e.meta.method
+    }) && await p.value?.replace({
+      name: "document.overview",
+      params: {
+        documentSlug: e.documentName
+      }
+    });
+  }), a.on("operation:delete:example", async (e) => {
+    Y(t(), e), i(e.documentName), s({
+      documentName: e.documentName,
+      path: e.meta.path,
+      method: e.meta.method,
+      exampleName: e.meta.exampleKey
+    }) && await p.value?.replace({
+      name: "example",
+      params: {
+        pathEncoded: encodeURIComponent(e.meta.path),
+        method: e.meta.method,
+        documentSlug: e.documentName,
+        exampleName: "default"
+      }
+    });
+  }), a.on("operation:add:parameter", (e) => {
+    Z(o.value, e), u(e.meta);
+  }), a.on("operation:update:parameter", (e) => {
+    _(o.value, e), u(e.meta);
+  }), a.on("operation:delete:parameter", (e) => $(o.value, e)), a.on("operation:delete-all:parameters", (e) => C(o.value, e)), a.on(
+    "operation:update:requestBody:contentType",
+    (e) => S(o.value, e)
+  ), a.on("operation:update:requestBody:value", (e) => {
+    g(o.value, e), u(e.meta);
+  }), a.on("operation:add:requestBody:formRow", (e) => {
+    B(o.value, e), u(e.meta);
+  }), a.on(
+    "operation:update:requestBody:formRow",
+    (e) => ee(o.value, e)
+  ), a.on(
+    "operation:delete:requestBody:formRow",
+    (e) => ae(o.value, e)
+  ), a.on("tag:create:tag", (e) => {
+    oe(t(), e), i(e.documentName);
+  }), a.on("tag:delete:tag", (e) => {
+    te(t(), e), i(e.documentName);
+  }), a.on("ui:toggle:sidebar", f), a.on(
+    "ui:open:command-palette",
+    (e) => {
+      e ? d(e.action, e.payload) : d();
+    }
+  ), a.on("ui:route:page", ({ name: e }) => p.value?.push({ name: e })), a.on("tabs:add:tab", async (e) => {
+    re(t()?.workspace ?? null, e), await l();
+  }), a.on("tabs:close:tab", async (e) => {
+    le(t()?.workspace ?? null, e), await l();
+  }), a.on("tabs:close:other-tabs", (e) => ne(t()?.workspace ?? null, e)), a.on("tabs:focus:tab", async (e) => {
+    pe(t()?.workspace ?? null, e), await l();
+  }), a.on("tabs:focus:tab-last", async (e) => {
+    ce(t()?.workspace ?? null, e), await l();
+  }), a.on("tabs:navigate:previous", async (e) => {
+    ie(t()?.workspace ?? null, e), await l();
+  }), a.on("tabs:navigate:next", async (e) => {
+    me(t()?.workspace ?? null, e), await l();
+  }), a.on("tabs:update:tabs", async (e) => {
+    ue(t()?.workspace ?? null, e), await l();
+  }), a.on("tabs:copy:url", (e) => v(e.index));
+}
+export {
+  ve as initializeAppEventHandlers
+};

package/dist/v2/features/app/app-state.d.ts

@@ -0,0 +1,135 @@
+import type { ScalarListboxOption } from '@scalar/components';
+import type { HttpMethod } from '@scalar/helpers/http/http-methods';
+import { type WorkspaceStore } from '@scalar/workspace-store/client';
+import { type WorkspaceEventBus } from '@scalar/workspace-store/events';
+import type { WorkspaceDocument } from '@scalar/workspace-store/schemas';
+import type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments';
+import type { Tab } from '@scalar/workspace-store/schemas/extensions/workspace/x-scalar-tabs';
+import type { TraversedEntry } from '@scalar/workspace-store/schemas/navigation';
+import { type ComputedRef, type Ref, type ShallowRef } from 'vue';
+import type { RouteLocationNormalizedGeneric, Router } from 'vue-router';
+import { type UseCommandPaletteStateReturn } from '../command-palette/hooks/use-command-palette-state.js';
+/**
+ * Updates the route to reflect the currently selected workspace.
+ * Navigates to the workspace's main environment view, with an option to control
+ * whether the previous route path should be loaded via a query parameter.
+ *
+ * @param id - The workspace slug (unique identifier) to navigate to.
+ * @param loadFromSession - If true, includes "loadFromSession=true" in the query to indicate state/session should be restored.
+ */
+declare const setWorkspaceId: (id?: string) => Promise<void>;
+/**
+ * Creates a new workspace with the provided name.
+ * - Generates a unique ID for the workspace (sluggified from the name and guaranteed unique).
+ * - Adds a default blank document ("drafts") to the workspace.
+ * - Persists the workspace and navigates to it.
+ *
+ * Example usage:
+ *   await createWorkspace({ name: 'My Awesome API' })
+ *   // -> Navigates to /workspace/my-awesome-api (if available)
+ */
+declare const createWorkspace: ({ id, name, }: {
+    id?: string;
+    name: string;
+}) => Promise<{
+    id: string;
+    name: string;
+} | undefined>;
+declare const sidebarState: {
+    items: ComputedRef<TraversedEntry[]>;
+    index: ComputedRef<Map<string, TraversedEntry & {
+        parent?: TraversedEntry | undefined;
+    }>>;
+    selectedItems: import("vue").Ref<Record<string, boolean>, Record<string, boolean>>;
+    expandedItems: import("vue").Ref<Record<string, boolean>, Record<string, boolean>>;
+    selectedItem: import("vue").Ref<string | null, string | null>;
+    setSelected: (id: string | null) => void;
+    setExpanded: (id: string, value: boolean) => void;
+    isExpanded: (id: string) => boolean;
+    isSelected: (id: string) => boolean;
+    getEntryById: (id: string) => (TraversedEntry & {
+        parent?: TraversedEntry | undefined;
+    }) | undefined;
+    reset: () => void;
+};
+/**
+ * Looks up a sidebar entry by its unique API location.
+ * - First tries to find an entry matching all provided properties (including example).
+ * - If not found, falls back to matching only the operation (ignores example field).
+ * This allows resolving either examples, operations, or documents as appropriate.
+ *
+ * @param location - Object specifying the document name, path, method, and optional example name.
+ * @returns The matching sidebar entry, or undefined if none found.
+ *
+ * Example:
+ *   const entry = getEntryByLocation({
+ *     document: 'pets',
+ *     path: '/pets',
+ *     method: 'get',
+ *     example: 'default',
+ *   })
+ */
+declare const getEntryByLocation: GetEntryByLocation;
+export type GetEntryByLocation = (location: {
+    document: string;
+    path?: string;
+    method?: HttpMethod;
+    example?: string;
+}) => (TraversedEntry & {
+    parent?: TraversedEntry | undefined;
+}) | undefined;
+/**
+ * Handles item selection from the sidebar and routes navigation accordingly.
+ *
+ * Example:
+ *   handleSelectItem('id-of-entry')
+ */
+declare const handleSelectItem: (id: string) => Promise<void | import("vue-router").NavigationFailure | undefined> | undefined;
+/** Handler for sidebar width changes. */
+declare const handleSidebarWidthUpdate: (width: number) => void | undefined;
+/**
+ * Copies the URL of the tab at the given index to the clipboard.
+ * Constructs the full URL using the current origin and the tab path.
+ *
+ * @throws Will silently fail if clipboard API is unavailable or the tab does not exist.
+ */
+declare const copyTabUrl: (index: number) => Promise<void>;
+export declare function useAppState(): {
+    store: ShallowRef<WorkspaceStore | null>;
+    sidebar: {
+        state: typeof sidebarState;
+        width: ComputedRef<number>;
+        isOpen: Ref<boolean>;
+        handleSelectItem: typeof handleSelectItem;
+        handleSidebarWidthUpdate: typeof handleSidebarWidthUpdate;
+        getEntryByLocation: typeof getEntryByLocation;
+    };
+    tabs: {
+        state: Ref<Tab[]>;
+        activeTabIndex: Ref<number>;
+        copyTabUrl: typeof copyTabUrl;
+    };
+    workspace: {
+        create: typeof createWorkspace;
+        workspaceList: Ref<ScalarListboxOption[]>;
+        activeWorkspace: ShallowRef<ScalarListboxOption | null>;
+        setId: typeof setWorkspaceId;
+        isOpen: ComputedRef<boolean>;
+    };
+    commandPalette: UseCommandPaletteStateReturn;
+    eventBus: WorkspaceEventBus;
+    router: ShallowRef<Router | null>;
+    currentRoute: Ref<RouteLocationNormalizedGeneric | null>;
+    loading: Ref<boolean>;
+    activeEntities: {
+        workspaceSlug: Ref<string | undefined>;
+        documentSlug: Ref<string | undefined>;
+        path: Ref<string | undefined>;
+        method: Ref<HttpMethod | undefined>;
+        exampleName: Ref<string | undefined>;
+    };
+    environment: ComputedRef<XScalarEnvironment>;
+    document: ComputedRef<WorkspaceDocument | null>;
+};
+export {};
+//# sourceMappingURL=app-state.d.ts.map

package/dist/v2/features/app/app-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/app/app-state.ts"],"names":[],"mappings":"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"}