@scalar/api-client 2.26.2 → 2.29.1

package/dist/v2/features/app/components/SidebarItemMenu.vue.js

@@ -1,7 +1,8 @@
-import { defineComponent as S, ref as C, watch as E, nextTick as b, createBlock as i, openBlock as a, unref as n, withCtx as m, createCommentVNode as l, createElementVNode as r, createVNode as u, createTextVNode as c } from "vue";
-import { ScalarDropdown as M, ScalarDropdownItem as s, ScalarIcon as y, ScalarDropdownDivider as T } from "@scalar/components";
-import { getParentEntry as I } from "@scalar/workspace-store/navigation";
-const z = { class: "flex items-center gap-2" }, N = { class: "flex items-center gap-2" }, V = { class: "flex items-center gap-2" }, $ = { class: "text-red flex items-center gap-2" }, W = /* @__PURE__ */ S({
+import { defineComponent as C, ref as T, watch as b, nextTick as p, createBlock as i, openBlock as d, unref as n, withCtx as o, createCommentVNode as l, createElementVNode as c, createVNode as u, createTextVNode as s } from "vue";
+import { ScalarDropdown as P, ScalarDropdownItem as r, ScalarIcon as y, ScalarDropdownDivider as z } from "@scalar/components";
+import { ScalarIconPencil as M } from "@scalar/icons";
+import { getParentEntry as f } from "@scalar/workspace-store/navigation";
+const $ = { class: "flex items-center gap-2" }, V = { class: "flex items-center gap-2" }, O = { class: "flex items-center gap-2" }, W = { class: "flex items-center gap-2" }, q = { class: "text-red flex items-center gap-2" }, G = /* @__PURE__ */ C({
   __name: "SidebarItemMenu",
   props: {
     item: {},
@@ -10,111 +11,138 @@ const z = { class: "flex items-center gap-2" }, N = { class: "flex items-center
     target: {}
   },
   emits: ["closeMenu", "showDeleteModal"],
-  setup(e, { emit: p }) {
-    const g = p, f = C(!1);
-    E(f, async (d, t) => {
-      !d && t && (await b(), g("closeMenu"));
+  setup(e, { emit: E }) {
+    const v = E, g = T(!1);
+    b(g, async (a, t) => {
+      !a && t && (await p(), v("closeMenu"));
     });
-    const v = () => e.item.type === "document" || e.item.type === "tag", x = () => e.item.type === "document", k = () => e.item.type === "operation", A = () => e.item.type === "document" && e.item.id !== "drafts" || e.item.type === "tag" || e.item.type === "operation" || e.item.type === "example", B = () => {
+    const x = () => e.item.type === "document" || e.item.type === "tag", k = () => e.item.type === "document", S = () => e.item.type === "tag", A = () => e.item.type === "operation", B = () => e.item.type === "document" && e.item.id !== "drafts" || e.item.type === "tag" || e.item.type === "operation" || e.item.type === "example", D = () => {
       if (e.item.type === "document" && e.eventBus.emit("ui:open:command-palette", {
         action: "create-request",
         payload: {
-          documentId: e.item.id
+          documentName: e.item.name
         }
       }), e.item.type === "tag") {
-        const d = e.sidebarState.getEntryById(e.item.id);
+        const a = e.sidebarState.getEntryById(e.item.id);
         e.eventBus.emit("ui:open:command-palette", {
           action: "create-request",
           payload: {
-            documentId: I("document", d)?.id,
+            documentName: f("document", a)?.name,
             tagId: e.item.name
           }
         });
       }
-    }, D = () => {
+    }, I = () => {
       e.item.type === "document" && e.eventBus.emit("ui:open:command-palette", {
         action: "add-tag",
         payload: {
-          documentId: e.item.id
+          documentName: e.item.name
         }
       });
+    }, N = () => {
+      if (e.item.type === "tag") {
+        const a = e.sidebarState.getEntryById(e.item.id);
+        e.eventBus.emit(
+          "ui:open:command-palette",
+          {
+            action: "edit-tag",
+            payload: {
+              tag: e.item,
+              documentName: f("document", a)?.name ?? ""
+            }
+          },
+          { skipUnpackProxy: !0 }
+        );
+      }
     }, w = () => {
       if (e.item.type === "operation") {
-        const d = e.sidebarState.getEntryById(e.item.id);
+        const a = e.sidebarState.getEntryById(e.item.id);
         e.eventBus.emit("ui:open:command-palette", {
           action: "add-example",
           payload: {
-            documentId: I("document", d)?.id,
+            documentName: f("document", a)?.name,
             operationId: e.item.id
           }
         });
       }
     };
-    return (d, t) => (a(), i(n(M), {
-      open: f.value,
-      "onUpdate:open": t[4] || (t[4] = (o) => f.value = o),
+    return (a, t) => (d(), i(n(P), {
+      open: g.value,
+      "onUpdate:open": t[5] || (t[5] = (m) => g.value = m),
       placement: "bottom-end",
       target: e.target,
       teleport: ""
     }, {
-      items: m(() => [
-        v() ? (a(), i(n(s), {
+      items: o(() => [
+        x() ? (d(), i(n(r), {
           key: 0,
-          onClick: t[0] || (t[0] = (o) => B())
+          onClick: t[0] || (t[0] = (m) => D())
         }, {
-          default: m(() => [
-            r("div", z, [
+          default: o(() => [
+            c("div", $, [
               u(n(y), {
                 icon: "Add",
                 size: "sm"
               }),
-              t[5] || (t[5] = c(" Add Operation ", -1))
+              t[6] || (t[6] = s(" Add Operation ", -1))
             ])
           ]),
           _: 1
         })) : l("", !0),
-        x() ? (a(), i(n(s), {
+        k() ? (d(), i(n(r), {
           key: 1,
-          onClick: t[1] || (t[1] = (o) => D())
+          onClick: t[1] || (t[1] = (m) => I())
         }, {
-          default: m(() => [
-            r("div", N, [
+          default: o(() => [
+            c("div", V, [
               u(n(y), {
                 icon: "Add",
                 size: "sm"
               }),
-              t[6] || (t[6] = c(" Add Tag ", -1))
+              t[7] || (t[7] = s(" Add Tag ", -1))
             ])
           ]),
           _: 1
         })) : l("", !0),
-        k() ? (a(), i(n(s), {
+        S() ? (d(), i(n(r), {
           key: 2,
-          onClick: t[2] || (t[2] = (o) => w())
+          onClick: t[2] || (t[2] = (m) => N())
+        }, {
+          default: o(() => [
+            c("div", O, [
+              u(n(M), { size: "sm" }),
+              t[8] || (t[8] = s(" Rename Tag ", -1))
+            ])
+          ]),
+          _: 1
+        })) : l("", !0),
+        A() ? (d(), i(n(r), {
+          key: 3,
+          onClick: t[3] || (t[3] = (m) => w())
         }, {
-          default: m(() => [
-            r("div", V, [
+          default: o(() => [
+            c("div", W, [
               u(n(y), {
                 icon: "Add",
                 size: "sm"
               }),
-              t[7] || (t[7] = c(" Add Example ", -1))
+              t[9] || (t[9] = s(" Add Example ", -1))
             ])
           ]),
           _: 1
         })) : l("", !0),
-        (k() || v() || x()) && A() ? (a(), i(n(T), { key: 3 })) : l("", !0),
-        A() ? (a(), i(n(s), {
-          key: 4,
-          onClick: t[3] || (t[3] = (o) => g("showDeleteModal"))
+        (A() || x() || k()) && B() ? (d(), i(n(z), { key: 4 })) : l("", !0),
+        B() ? (d(), i(n(r), {
+          key: 5,
+          onClick: t[4] || (t[4] = (m) => v("showDeleteModal"))
         }, {
-          default: m(() => [
-            r("div", $, [
+          default: o(() => [
+            c("div", q, [
               u(n(y), {
                 icon: "Delete",
                 size: "sm"
               }),
-              t[8] || (t[8] = c(" Delete ", -1))
+              t[10] || (t[10] = s(" Delete ", -1))
             ])
           ]),
           _: 1
@@ -125,5 +153,5 @@ const z = { class: "flex items-center gap-2" }, N = { class: "flex items-center
   }
 });
 export {
-  W as default
+  G as default
 };

package/dist/v2/features/app/helpers/create-api-client-app.d.ts

@@ -1,4 +1,5 @@
 import type { ClientPlugin } from '@scalar/oas-utils/helpers';
+import type { Theme } from '@scalar/themes';
 import type { ClientLayout } from '../../../../v2/types/layout';
 type CreateApiClientOptions = {
     /**
@@ -12,6 +13,15 @@ type CreateApiClientOptions = {
      * Api client plugins to include in the app
      */
     plugins?: ClientPlugin[];
+    /**
+     * Custom themes to include in the app
+     */
+    customThemes?: Theme[];
+    /**
+     * Fallback theme slug to use if no theme is selected for the workspace
+     * @default 'default'
+     */
+    fallbackThemeSlug?: string;
 };
 /**
  * Creates the appropriate router with the appropriate routes based on the layout
@@ -20,7 +30,7 @@ export declare const createAppRouter: (layout: CreateApiClientOptions["layout"])
 /**
  * Create the API Client with router and passes in the workspace store as a prop
  */
-export declare const createApiClientApp: (el: HTMLElement | null, { layout, plugins }: CreateApiClientOptions) => Promise<{
+export declare const createApiClientApp: (el: HTMLElement | null, { layout, plugins, customThemes, fallbackThemeSlug }: CreateApiClientOptions) => Promise<{
     app: import("vue").App<Element>;
     state: import("../../../../v2/features/app/app-state.js").AppState;
 } | undefined>;

package/dist/v2/features/app/helpers/create-api-client-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-api-client-app.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/create-api-client-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAO7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,KAAK,sBAAsB,GAAG;IAC5B;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,sBAAsB,CAAC,QAAQ,CAAC,gCAQvE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,IAAI,WAAW,GAAG,IAAI,EACtB,qBAAiC,sBAAsB;;;cAgCxD,CAAA"}
+{"version":3,"file":"create-api-client-app.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/create-api-client-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAO3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,KAAK,sBAAsB,GAAG;IAC5B;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,EAAE,CAAA;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,sBAAsB,CAAC,QAAQ,CAAC,gCAQvE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,IAAI,WAAW,GAAG,IAAI,EACtB,sDAA8E,sBAAsB;;;cAkCrG,CAAA"}

package/dist/v2/features/app/helpers/create-api-client-app.js

@@ -1,16 +1,18 @@
-import { createApp as n } from "vue";
-import { createRouter as p, createWebHistory as s, createWebHashHistory as l } from "vue-router";
-import u from "../App.vue.js";
+import { createApp as l } from "vue";
+import { createRouter as p, createWebHistory as u, createWebHashHistory as d } from "vue-router";
+import f from "../App.vue.js";
 /* empty css          */
-import { createAppState as d } from "../app-state.js";
+import { createAppState as A } from "../app-state.js";
 import { ROUTES as c } from "./routes.js";
-import { useCommandPaletteState as f } from "../../command-palette/hooks/use-command-palette-state.js";
-const A = (t) => t === "web" ? p({ history: s(), routes: c }) : p({ history: l(), routes: c }), P = async (t, { layout: r = "desktop", plugins: i }) => {
-  const o = A(r), a = await d({ router: o }), m = f(), e = n(u, {
+import { useCommandPaletteState as h } from "../../command-palette/hooks/use-command-palette-state.js";
+const S = (t) => t === "web" ? p({ history: u(), routes: c }) : p({ history: d(), routes: c }), k = async (t, { layout: r = "desktop", plugins: i, customThemes: m, fallbackThemeSlug: n = "default" }) => {
+  const o = S(r), a = await A({ router: o }), s = h(), e = l(f, {
     layout: r,
     plugins: i,
+    customThemes: m,
+    fallbackThemeSlug: n,
     getAppState: () => a,
-    getCommandPaletteState: () => m
+    getCommandPaletteState: () => s
   });
   if (e.use(o), !t) {
     console.error(
@@ -26,6 +28,6 @@ const A = (t) => t === "web" ? p({ history: s(), routes: c }) : p({ history: l()
   };
 };
 export {
-  P as createApiClientApp,
-  A as createAppRouter
+  k as createApiClientApp,
+  S as createAppRouter
 };

package/dist/v2/features/app/helpers/routes.d.ts

@@ -1,5 +1,6 @@
 import type { HttpMethod } from '@scalar/helpers/http/http-methods';
 import type { ClientPlugin } from '@scalar/oas-utils/helpers';
+import type { Theme } from '@scalar/themes';
 import type { WorkspaceStore } from '@scalar/workspace-store/client';
 import type { WorkspaceEventBus } from '@scalar/workspace-store/events';
 import type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments';
@@ -23,6 +24,7 @@ export type RouteProps = {
         label: string;
     };
     plugins: ClientPlugin[];
+    customThemes?: Theme[];
 };
 /** When in the collections pages */
 export type CollectionProps = RouteProps & ({

package/dist/v2/features/app/helpers/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2EAA2E,CAAA;AACnH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAGlF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAA;AAW1G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,eAAe,EAAE,qBAAqB,CAAA;IACtC,cAAc,EAAE,cAAc,CAAA;IAC9B,eAAe,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,OAAO,EAAE,YAAY,EAAE,CAAA;CAGxB,CAAA;AAED,oCAAoC;AACpC,MAAM,MAAM,eAAe,GAAG,UAAU,GACtC,CACI;IACE,cAAc,EAAE,UAAU,CAAA;IAC1B,QAAQ,EAAE,iBAAiB,CAAA;CAC5B,GACD;IACE,cAAc,EAAE,WAAW,CAAA;IAC3B,QAAQ,EAAE,IAAI,CAAA;CACf,CACJ,CAAA;AAEH,MAAM,MAAM,0BAA0B,GAClC,WAAW,GACX,eAAe,GACf,cAAc,GACd,aAAa,GACb,QAAQ,GACR,aAAa,CAAA;AAEjB,kFAAkF;AAClF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAlBK,UAAU;8BAChB,iBAAiB;;oCAGX,WAAW;8BACjB,IAAI;;oCALE,UAAU;8BAChB,iBAAiB;;oCAGX,WAAW;8BACjB,IAAI;;;;;;;;;;;;;;;gCALE,UAAU;0BAChB,iBAAiB;;gCAGX,WAAW;0BACjB,IAAI;;gCALE,UAAU;0BAChB,iBAAiB;;gCAGX,WAAW;0BACjB,IAAI;;;;;;;;;IAgIM,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/helpers/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2EAA2E,CAAA;AACnH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAGlF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAA;AAW1G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,eAAe,EAAE,qBAAqB,CAAA;IACtC,cAAc,EAAE,cAAc,CAAA;IAC9B,eAAe,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,KAAK,EAAE,CAAA;CAGvB,CAAA;AAED,oCAAoC;AACpC,MAAM,MAAM,eAAe,GAAG,UAAU,GACtC,CACI;IACE,cAAc,EAAE,UAAU,CAAA;IAC1B,QAAQ,EAAE,iBAAiB,CAAA;CAC5B,GACD;IACE,cAAc,EAAE,WAAW,CAAA;IAC3B,QAAQ,EAAE,IAAI,CAAA;CACf,CACJ,CAAA;AAEH,MAAM,MAAM,0BAA0B,GAClC,WAAW,GACX,eAAe,GACf,cAAc,GACd,aAAa,GACb,QAAQ,GACR,aAAa,CAAA;AAEjB,kFAAkF;AAClF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAlBK,UAAU;8BAChB,iBAAiB;;oCAGX,WAAW;8BACjB,IAAI;;oCALE,UAAU;8BAChB,iBAAiB;;oCAGX,WAAW;8BACjB,IAAI;;;;;;;;;;;;;;;gCALE,UAAU;0BAChB,iBAAiB;;gCAGX,WAAW;0BACjB,IAAI;;gCALE,UAAU;0BAChB,iBAAiB;;gCAGX,WAAW;0BACjB,IAAI;;;;;;;;;IAgIM,CAAA"}

package/dist/v2/features/app/helpers/routes.js

@@ -4,17 +4,17 @@ import o from "../../collection/components/Cookies.vue.js";
 import n from "../../collection/components/Environment.vue.js";
 import h from "../../collection/components/Overview.vue.js";
 import d from "../../collection/components/Servers.vue.js";
-import a from "../../collection/components/Settings.vue.js";
-import f from "../../collection/DocumentCollection.vue.js";
-import u from "../../collection/WorkspaceCollection.vue.js";
+import m from "../../collection/components/Settings.vue.js";
+import u from "../../collection/DocumentCollection.vue.js";
+import f from "../../collection/WorkspaceCollection.vue.js";
 import l from "../../operation/Operation.vue.js";
-import { workspaceStorage as m } from "../../../helpers/storage.js";
+import { workspaceStorage as a } from "../../../helpers/storage.js";
 const A = [
   {
     path: "/@:namespace/:workspaceSlug",
     children: [
       {
-        path: ":documentSlug",
+        path: "document/:documentSlug",
         children: [
           // Example page
           {
@@ -26,7 +26,7 @@ const A = [
           {
             name: "document",
             path: "",
-            component: f,
+            component: u,
             children: [
               // Redirect to overview
               {
@@ -70,7 +70,7 @@ const A = [
               {
                 name: "document.settings",
                 path: "settings",
-                component: a
+                component: m
               }
             ]
           }
@@ -80,7 +80,7 @@ const A = [
       {
         name: "workspace",
         path: "",
-        component: u,
+        component: f,
         children: [
           // Workspace environment
           {
@@ -98,7 +98,7 @@ const A = [
           {
             name: "workspace.settings",
             path: "settings",
-            component: a
+            component: m
           }
         ]
       }
@@ -107,8 +107,8 @@ const A = [
   {
     path: "/:pathMatch(.*)*",
     redirect: () => {
-      const e = "/@local/local/drafts/overview", r = m.getLastPath() ?? e;
-      m.setCurrentPath(e);
+      const e = "/@local/default/document/drafts/overview", r = a.getLastPath() ?? e;
+      a.setCurrentPath(e);
       const t = new URL(r, "http://example.com"), c = new URLSearchParams(window.location.search), p = i(t.searchParams, c);
       return `${t.pathname}?${p.toString()}`;
     }

package/dist/v2/features/app/hooks/use-theme.d.ts

@@ -0,0 +1,42 @@
+import { type Theme } from '@scalar/themes';
+import type { WorkspaceStore } from '@scalar/workspace-store/client';
+import { type MaybeRefOrGetter } from 'vue';
+/**
+ * useTheme
+ *
+ * Reactive Vue.js hook to resolve and generate a <style> tag string based on the current theme.
+ * Automatically selects the appropriate theme styles in the following priority order:
+ *    1. Workspace theme (from the provided store, e.g. store.workspace['x-scalar-theme'])
+ *    2. Fallback theme (from the fallbackThemeSlug prop)
+ *    3. Default built-in theme (with slug "default")
+ *
+ * The returned `themeStyleTag` can be injected into your page to dynamically apply theming.
+ *
+ * @example
+ * ```ts
+ * // In a Vue component setup() function
+ * import { ref } from 'vue'
+ * import { useTheme } from './use-theme.js'
+ *
+ * const myThemes = ref([...])
+ * const workspaceStore = ref(...)
+ * const fallbackThemeSlug = ref('dark')
+ *
+ * const { themeStyleTag } = useTheme({
+ *   customThemes: myThemes,
+ *   fallbackThemeSlug,
+ *   store: workspaceStore
+ * })
+ *
+ * // To inject in template:
+ * // <div v-html="themeStyleTag"></div>
+ * ```
+ */
+export declare const useTheme: ({ fallbackThemeSlug, store, customThemes, }: {
+    customThemes: MaybeRefOrGetter<Theme[]>;
+    fallbackThemeSlug: MaybeRefOrGetter<string>;
+    store: MaybeRefOrGetter<WorkspaceStore | null>;
+}) => {
+    themeStyleTag: import("vue").ComputedRef<string>;
+};
+//# sourceMappingURL=use-theme.d.ts.map

package/dist/v2/features/app/hooks/use-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/app/hooks/use-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAA8B,MAAM,gBAAgB,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAE,KAAK,gBAAgB,EAAqB,MAAM,KAAK,CAAA;AAkC9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,QAAQ,GAAI,6CAItB;IACD,YAAY,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAA;IACvC,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC3C,KAAK,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;CAC/C;;CA2CA,CAAA"}

package/dist/v2/features/app/hooks/use-theme.js

@@ -0,0 +1,34 @@
+import { themePresets as y, defaultFonts as S } from "@scalar/themes";
+import { computed as T, toValue as a } from "vue";
+const p = new Map(y.map((e) => [e.slug, e])), l = (e, s = "scalar-theme") => `<style id="scalar-theme" data-testid="${s}">${e}</style>`, o = (e, s) => {
+  const r = (t) => `${t}
+${S}`;
+  if (p.has(e))
+    return r(p.get(e)?.theme ?? "");
+  const c = s.find((t) => t.slug === e);
+  if (c)
+    return r(c.theme);
+}, w = ({
+  fallbackThemeSlug: e,
+  store: s,
+  customThemes: r
+}) => ({
+  themeStyleTag: T(() => {
+    const t = l(o("default", []), "default"), m = a(s), n = a(e);
+    if (m === null)
+      return t;
+    const f = m.workspace["x-scalar-theme"], u = f === "none" ? n : f;
+    if (!u) {
+      const i = o(n, a(r));
+      return i ? l(i, n) : t;
+    }
+    const h = o(u, a(r));
+    if (h)
+      return l(h, u);
+    const d = o(n, a(r));
+    return d ? l(d, n) : t;
+  })
+});
+export {
+  w as useTheme
+};

package/dist/v2/features/collection/DocumentCollection.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentCollection.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/collection/DocumentCollection.vue"],"names":[],"mappings":"AAyJA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAMlE;;;;;;;GAOG;wBACkB,OAAO,YAAY;AAAxC,wBAAyC;AAKzC,QAAA,MAAM,YAAY,gSA6Vd,CAAC"}
+{"version":3,"file":"DocumentCollection.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/collection/DocumentCollection.vue"],"names":[],"mappings":"AAyJA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAMlE;;;;;;;GAOG;wBACkB,OAAO,YAAY;AAAxC,wBAAyC;AAKzC,QAAA,MAAM,YAAY,gSA4Vd,CAAC"}

package/dist/v2/features/collection/DocumentCollection.vue.js

@@ -1,4 +1,4 @@
-import { defineComponent as y, computed as p, createElementBlock as c, openBlock as u, createElementVNode as t, createVNode as o, createBlock as f, createCommentVNode as g, withCtx as l, unref as s, resolveDynamicComponent as h, mergeProps as k } from "vue";
+import { defineComponent as h, computed as p, createElementBlock as c, openBlock as u, createElementVNode as t, createVNode as o, createBlock as f, createCommentVNode as y, withCtx as l, unref as s, resolveDynamicComponent as g, mergeProps as k } from "vue";
 import { ScalarButton as i } from "@scalar/components";
 import { ScalarIconFloppyDisk as b } from "@scalar/icons";
 import { LibraryIcon as w } from "@scalar/icons/library";
@@ -9,14 +9,14 @@ import V from "./components/LabelInput.vue.js";
 import B from "./components/Tabs.vue.js";
 const D = { class: "custom-scroll h-full" }, N = {
   key: 0,
-  class: "w-full md:mx-auto md:max-w-[720px]"
-}, z = ["aria-label"], I = { class: "flex flex-row items-center gap-2" }, U = { class: "group relative ml-1.25" }, $ = { class: "px-1.5 py-8" }, j = {
+  class: "w-full md:mx-auto md:max-w-180"
+}, z = ["aria-label"], I = { class: "flex flex-row items-center gap-2" }, U = { class: "group relative ml-1.25" }, T = { class: "px-1.5 py-8" }, $ = {
   key: 1,
   class: "flex w-full flex-1 items-center justify-center"
-}, E = {
+}, j = {
   name: "DocumentCollection"
-}, H = /* @__PURE__ */ y({
-  ...E,
+}, H = /* @__PURE__ */ h({
+  ...j,
   props: {
     documentSlug: {},
     document: {},
@@ -29,21 +29,22 @@ const D = { class: "custom-scroll h-full" }, N = {
     securitySchemes: {},
     workspaceStore: {},
     activeWorkspace: {},
-    plugins: {}
+    plugins: {},
+    customThemes: {}
   },
   setup(a) {
     const n = a, m = p(() => n.document?.info?.title || "Untitled Document"), d = p(
       () => n.document?.["x-scalar-icon"] || "interface-content-folder"
-    ), x = () => {
+    ), v = () => {
       n.workspaceStore.revertDocumentChanges(n.documentSlug);
-    }, v = () => {
+    }, x = () => {
       n.workspaceStore.saveDocument(n.documentSlug);
     };
-    return (L, e) => (u(), c("div", D, [
+    return (E, e) => (u(), c("div", D, [
       a.document ? (u(), c("div", N, [
         t("div", {
           "aria-label": `title: ${m.value}`,
-          class: "mx-auto flex h-fit w-full flex-col gap-2 pt-6 pb-3 md:mx-auto md:max-w-[720px]"
+          class: "mx-auto flex h-fit w-full flex-col gap-2 pt-6 pb-3 md:max-w-180"
         }, [
           a.document?.["x-scalar-is-dirty"] ? (u(), f(S, {
             key: 0,
@@ -56,7 +57,7 @@ const D = { class: "custom-scroll h-full" }, N = {
                 size: "xs",
                 type: "button",
                 variant: "outlined",
-                onClick: x
+                onClick: v
               }, {
                 default: l(() => [...e[2] || (e[2] = [
                   t("span", null, "Undo", -1)
@@ -68,7 +69,7 @@ const D = { class: "custom-scroll h-full" }, N = {
                 size: "xs",
                 type: "button",
                 variant: "solid",
-                onClick: v
+                onClick: x
               }, {
                 default: l(() => [
                   o(s(b), {
@@ -84,7 +85,7 @@ const D = { class: "custom-scroll h-full" }, N = {
               e[4] || (e[4] = t("p", null, " You have unsaved changes. Save your work to keep your changes, or undo to revert them. ", -1))
             ]),
             _: 1
-          })) : g("", !0),
+          })) : y("", !0),
           t("div", I, [
             o(C, {
               modelValue: d.value,
@@ -107,27 +108,27 @@ const D = { class: "custom-scroll h-full" }, N = {
                 })
               ]),
               _: 1
-            }, 8, ["modelValue"])
-          ]),
-          t("div", U, [
-            o(V, {
-              class: "text-xl font-bold",
-              inputId: "documentName",
-              modelValue: m.value,
-              "onUpdate:modelValue": e[1] || (e[1] = (r) => a.eventBus.emit("document:update:info", { title: r }))
-            }, null, 8, ["modelValue"])
+            }, 8, ["modelValue"]),
+            t("div", U, [
+              o(V, {
+                class: "text-xl font-bold",
+                inputId: "documentName",
+                modelValue: m.value,
+                "onUpdate:modelValue": e[1] || (e[1] = (r) => a.eventBus.emit("document:update:info", { title: r }))
+              }, null, 8, ["modelValue"])
+            ])
           ])
         ], 8, z),
         o(B, { type: "document" }),
-        t("div", $, [
+        t("div", T, [
           o(s(_), null, {
             default: l(({ Component: r }) => [
-              (u(), f(h(r), k(n, { collectionType: "document" }), null, 16))
+              (u(), f(g(r), k(n, { collectionType: "document" }), null, 16))
             ]),
             _: 1
           })
         ])
-      ])) : (u(), c("div", j, [...e[5] || (e[5] = [
+      ])) : (u(), c("div", $, [...e[5] || (e[5] = [
         t("div", { class: "flex h-full flex-col items-center justify-center" }, [
           t("h1", { class: "text-2xl font-bold" }, "Document not found"),
           t("p", { class: "text-gray-500" }, " The document you are looking for does not exist. ")

package/dist/v2/features/collection/WorkspaceCollection.vue.d.ts

@@ -1,10 +1,5 @@
 import type { RouteProps } from '../../../v2/features/app/helpers/routes.js';
-/**
- * Document Collection Page
- *
- * Displays primary document editing and viewing interface, enabling users navigate among
- * Overview, Servers, Authentication, Environment, Cookies, and Settings tabs
- */
+/** Document collection page — tabs for Overview, Servers, Auth, Environment, Cookies, and Settings. */
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import("vue").DefineComponent<RouteProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<RouteProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/v2/features/collection/WorkspaceCollection.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceCollection.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/collection/WorkspaceCollection.vue"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAKlE;;;;;GAKG;wBACkB,OAAO,YAAY;AAAxC,wBAAyC;AAGzC,QAAA,MAAM,YAAY,gSAyGd,CAAC"}
+{"version":3,"file":"WorkspaceCollection.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/collection/WorkspaceCollection.vue"],"names":[],"mappings":"AA0EA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAMlE,uGAAuG;wBAClF,OAAO,YAAY;AAAxC,wBAAyC;AAGzC,QAAA,MAAM,YAAY,gSAmId,CAAC"}