@scalar/api-reference 1.41.0 → 1.42.0

package/CHANGELOG.md

@@ -1,5 +1,89 @@
 # @scalar/api-reference
 
+## 1.42.0
+
+### Minor Changes
+
+- [#7605](https://github.com/scalar/scalar/pull/7605): feat: api client v2 integration
+
+### Patch Changes
+
+#### Updated Dependencies
+
+- **@scalar/workspace-store@0.24.3**
+  - [#7605](https://github.com/scalar/scalar/pull/7605): fix: all issues for client modal v2 preparation
+
+- **@scalar/api-client@2.17.4**
+  - [#7605](https://github.com/scalar/scalar/pull/7605): fix: all issues for client modal v2 preparation
+
+- **@scalar/use-hooks@0.3.4**
+  - [#7605](https://github.com/scalar/scalar/pull/7605): fix: all issues for client modal v2 preparation
+
+- **@scalar/helpers@0.2.5**
+  - [#7605](https://github.com/scalar/scalar/pull/7605): fix: all issues for client modal v2 preparation
+
+- **@scalar/types@0.5.5**
+  - [#7605](https://github.com/scalar/scalar/pull/7605): fix: all issues for client modal v2 preparation
+
+- **@scalar/oas-utils@0.6.13**
+
+- **@scalar/sidebar@0.7.5**
+
+- **@scalar/components@0.16.15**
+
+- **@scalar/json-magic@0.8.9**
+
+- **@scalar/object-utils@1.2.19**
+
+- **@scalar/openapi-parser@0.23.10**
+
+- **@scalar/openapi-upgrader@0.1.6**
+
+- **@scalar/snippetz@0.6.2**
+
+## 1.41.1
+
+### Patch Changes
+
+#### Updated Dependencies
+
+- **@scalar/components@0.16.14**
+  - [#7654](https://github.com/scalar/scalar/pull/7654): fix(components): explicitly set line height for buttons and sections
+
+- **@scalar/api-client@2.17.3**
+
+- **@scalar/code-highlight@0.2.2**
+
+- **@scalar/helpers@0.2.4**
+
+- **@scalar/icons@0.5.2**
+
+- **@scalar/json-magic@0.8.8**
+
+- **@scalar/oas-utils@0.6.12**
+
+- **@scalar/object-utils@1.2.18**
+
+- **@scalar/openapi-parser@0.23.9**
+
+- **@scalar/openapi-types@0.5.3**
+
+- **@scalar/openapi-upgrader@0.1.6**
+
+- **@scalar/sidebar@0.7.4**
+
+- **@scalar/snippetz@0.6.1**
+
+- **@scalar/themes@0.13.26**
+
+- **@scalar/types@0.5.4**
+
+- **@scalar/use-hooks@0.3.3**
+
+- **@scalar/use-toasts@0.9.1**
+
+- **@scalar/workspace-store@0.24.2**
+
 ## 1.41.0
 
 ### Minor Changes

package/dist/blocks/index.d.ts

@@ -1,4 +1,3 @@
-export { AuthSelector } from './scalar-auth-selector-block';
 export { ClientSelector } from './scalar-client-selector-block';
 export { InfoBlock, IntroductionCardItem } from './scalar-info-block';
 export { ServerSelector } from './scalar-server-selector-block';

package/dist/blocks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/blocks/index.js

@@ -1,12 +1,10 @@
 import { default as default2 } from "./scalar-info-block/components/InfoBlock.vue.js";
 import { default as default3 } from "./scalar-server-selector-block/components/ServerSelector.vue.js";
-import { default as default4 } from "./scalar-auth-selector-block/components/AuthSelector.vue.js";
-import { default as default5 } from "./scalar-client-selector-block/components/ClientSelector.vue.js";
-import { default as default6 } from "./scalar-info-block/components/IntroductionCardItem.vue.js";
+import { default as default4 } from "./scalar-client-selector-block/components/ClientSelector.vue.js";
+import { default as default5 } from "./scalar-info-block/components/IntroductionCardItem.vue.js";
 export {
-  default4 as AuthSelector,
-  default5 as ClientSelector,
+  default4 as ClientSelector,
   default2 as InfoBlock,
-  default6 as IntroductionCardItem,
+  default5 as IntroductionCardItem,
   default3 as ServerSelector
 };

package/dist/blocks/scalar-client-selector-block/components/ClientDropdown.vue.d.ts

@@ -1,12 +1,15 @@
 import { type ClientOption, type ClientOptionGroup } from '@scalar/api-client/v2/blocks/operation-code-sample';
 import type { AvailableClients } from '@scalar/types/snippetz';
+import { type WorkspaceEventBus } from '@scalar/workspace-store/events';
 type __VLS_Props = {
     /** Client options */
     clientOptions: ClientOptionGroup[];
     /** The currently selected Http Client */
-    xSelectedClient?: AvailableClients[number];
+    selectedClient?: AvailableClients[number];
     /** List of featured clients */
     featuredClients: ClientOption[];
+    /** Event bus */
+    eventBus: WorkspaceEventBus;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/blocks/scalar-client-selector-block/components/ClientDropdown.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientDropdown.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-client-selector-block/components/ClientDropdown.vue"],"names":[],"mappings":"AA0PA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEvB,MAAM,oDAAoD,CAAA;AAG3D,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,wBAAwB,CAAA;AAMxE,KAAK,WAAW,GAAG;IACjB,qBAAqB;IACrB,aAAa,EAAE,iBAAiB,EAAE,CAAA;IAClC,yCAAyC;IACzC,eAAe,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC1C,+BAA+B;IAC/B,eAAe,EAAE,YAAY,EAAE,CAAA;CAChC,CAAC;;AAkPF,wBAMG"}
+{"version":3,"file":"ClientDropdown.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-client-selector-block/components/ClientDropdown.vue"],"names":[],"mappings":"AAwPA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEvB,MAAM,oDAAoD,CAAA;AAG3D,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,wBAAwB,CAAA;AACxE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAKvE,KAAK,WAAW,GAAG;IACf,qBAAqB;IACrB,aAAa,EAAE,iBAAiB,EAAE,CAAA;IAClC,yCAAyC;IACzC,cAAc,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzC,+BAA+B;IAC/B,eAAe,EAAE,YAAY,EAAE,CAAA;IAC/B,gBAAgB;IAChB,QAAQ,EAAE,iBAAiB,CAAA;CAC5B,CAAC;;AA+OJ,wBAMG"}

package/dist/blocks/scalar-client-selector-block/components/ClientDropdown.vue.js

@@ -1,7 +1,7 @@
 import _sfc_main from "./ClientDropdown.vue2.js";
 /* empty css                    */
 import _export_sfc from "../../../_virtual/_plugin-vue_export-helper.js";
-const ClientDropdown = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-ad178be1"]]);
+const ClientDropdown = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-6a49c111"]]);
 export {
   ClientDropdown as default
 };

package/dist/blocks/scalar-client-selector-block/components/ClientDropdown.vue2.js

@@ -3,7 +3,6 @@ import { Tab } from "@headlessui/vue";
 import { findClient } from "@scalar/api-client/v2/blocks/operation-code-sample";
 import { ScalarIcon, ScalarCombobox } from "@scalar/components";
 import { freezeElement } from "@scalar/helpers/dom/freeze-element";
-import { emitCustomEvent } from "@scalar/workspace-store/events";
 import { isFeaturedClient } from "../helpers/featured-clients.js";
 const _hoisted_1 = { class: "client-libraries-text" };
 const _hoisted_2 = {
@@ -27,8 +26,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "ClientDropdown",
   props: {
     clientOptions: {},
-    xSelectedClient: {},
-    featuredClients: {}
+    selectedClient: {},
+    featuredClients: {},
+    eventBus: {}
   },
   setup(__props) {
     const containerRef = ref();
@@ -42,15 +42,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
         unfreeze();
       }, 300);
       if (option.clientKey !== "custom") {
-        emitCustomEvent(
-          containerRef.value,
-          "scalar-update-selected-client",
-          option.id
-        );
+        __props.eventBus.emit("workspace:update:selected-client", option.id);
       }
     };
     const selectedTargetKey = computed(
-      () => __props.xSelectedClient?.split("/")[0]
+      () => __props.selectedClient?.split("/")[0]
     );
     return (_ctx, _cache) => {
       return openBlock(), createElementBlock("div", {
@@ -62,7 +58,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           return openBlock(), createBlock(unref(Tab), {
             key: featuredClient.clientKey,
             class: normalizeClass(["client-libraries rendered-code-sdks", {
-              "client-libraries__active": featuredClient.id === _ctx.xSelectedClient
+              "client-libraries__active": featuredClient.id === _ctx.selectedClient
             }])
           }, {
             default: withCtx(() => [
@@ -80,7 +76,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           }, 1032, ["class"]);
         }), 128)),
         createVNode(unref(ScalarCombobox), {
-          modelValue: unref(findClient)(_ctx.clientOptions, _ctx.xSelectedClient),
+          modelValue: unref(findClient)(_ctx.clientOptions, _ctx.selectedClient),
           options: _ctx.clientOptions,
           placement: "bottom-end",
           teleport: "",
@@ -89,12 +85,12 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           default: withCtx(() => [
             createElementVNode("button", {
               class: normalizeClass(["client-libraries client-libraries__select", {
-                "client-libraries__active": _ctx.xSelectedClient && !unref(isFeaturedClient)(_ctx.xSelectedClient)
+                "client-libraries__active": _ctx.selectedClient && !unref(isFeaturedClient)(_ctx.selectedClient)
               }]),
               type: "button"
             }, [
               createElementVNode("div", _hoisted_2, [
-                _ctx.xSelectedClient && !unref(isFeaturedClient)(_ctx.xSelectedClient) ? (openBlock(), createElementBlock("div", {
+                _ctx.selectedClient && !unref(isFeaturedClient)(_ctx.selectedClient) ? (openBlock(), createElementBlock("div", {
                   key: 0,
                   class: normalizeClass(`client-libraries-icon__${selectedTargetKey.value}`)
                 }, [

package/dist/blocks/scalar-client-selector-block/components/ClientSelector.vue.d.ts

@@ -1,5 +1,6 @@
 import { type ClientOptionGroup } from '@scalar/api-client/v2/blocks/operation-code-sample';
 import type { AvailableClient } from '@scalar/snippetz';
+import { type WorkspaceEventBus } from '@scalar/workspace-store/events';
 import type { XScalarSdkInstallation } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-sdk-installation';
 type __VLS_Props = {
     /** Selected SDK installation instructions */
@@ -7,7 +8,9 @@ type __VLS_Props = {
     /** Computed list of all available Http Client options */
     clientOptions: ClientOptionGroup[];
     /** The currently selected Http Client */
-    xSelectedClient?: AvailableClient;
+    selectedClient?: AvailableClient;
+    /** Event bus */
+    eventBus: WorkspaceEventBus;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {
     selectedClientOption: import("vue").ComputedRef<import("@scalar/api-client/v2/blocks/operation-code-sample").ClientOption | undefined>;

package/dist/blocks/scalar-client-selector-block/components/ClientSelector.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientSelector.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-client-selector-block/components/ClientSelector.vue"],"names":[],"mappings":"AA2MA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oDAAoD,CAAA;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+EAA+E,CAAA;AAU3H,KAAK,WAAW,GAAG;IACjB,6CAA6C;IAC7C,sBAAsB,CAAC,EAAE,sBAAsB,CAAC,2BAA2B,CAAC,CAAA;IAC5E,yDAAyD;IACzD,aAAa,EAAE,iBAAiB,EAAE,CAAA;IAClC,yCAAyC;IACzC,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAC;;;;AAuRF,wBAOG"}
+{"version":3,"file":"ClientSelector.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-client-selector-block/components/ClientSelector.vue"],"names":[],"mappings":"AAgNA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oDAAoD,CAAA;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+EAA+E,CAAA;AAU3H,KAAK,WAAW,GAAG;IACjB,6CAA6C;IAC7C,sBAAsB,CAAC,EAAE,sBAAsB,CAAC,2BAA2B,CAAC,CAAA;IAC5E,yDAAyD;IACzD,aAAa,EAAE,iBAAiB,EAAE,CAAA;IAClC,yCAAyC;IACzC,cAAc,CAAC,EAAE,eAAe,CAAA;IAChC,gBAAgB;IAChB,QAAQ,EAAE,iBAAiB,CAAA;CAC5B,CAAC;;;;AA2RF,wBAOG"}

package/dist/blocks/scalar-client-selector-block/components/ClientSelector.vue.js

@@ -1,7 +1,7 @@
 import _sfc_main from "./ClientSelector.vue2.js";
 /* empty css                    */
 import _export_sfc from "../../../_virtual/_plugin-vue_export-helper.js";
-const ClientSelector = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-9a309159"]]);
+const ClientSelector = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-e59e2ca0"]]);
 export {
   ClientSelector as default
 };

package/dist/blocks/scalar-client-selector-block/components/ClientSelector.vue2.js

@@ -2,7 +2,6 @@ import { defineComponent, useId, computed, useTemplateRef, createElementBlock, c
 import { TabGroup, TabList, TabPanels, TabPanel } from "@headlessui/vue";
 import { DEFAULT_CLIENT } from "@scalar/api-client/v2/blocks/operation-code-sample";
 import { ScalarMarkdown, ScalarCodeBlock } from "@scalar/components";
-import { emitCustomEvent } from "@scalar/workspace-store/events";
 import { getFeaturedClients, isFeaturedClient } from "../helpers/featured-clients.js";
 import ClientDropdown from "./ClientDropdown.vue.js";
 const _hoisted_1 = {
@@ -22,20 +21,21 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   props: {
     xScalarSdkInstallation: {},
     clientOptions: {},
-    xSelectedClient: { default: () => DEFAULT_CLIENT }
+    selectedClient: { default: () => DEFAULT_CLIENT },
+    eventBus: {}
   },
   setup(__props, { expose: __expose }) {
     const headingId = useId();
     const morePanel = useId();
     const selectedClientOption = computed(
       () => __props.clientOptions.flatMap(
-        (option) => option.options.find((option2) => option2.id === __props.xSelectedClient) ?? []
+        (optionGroup) => optionGroup.options.find((option) => option.id === __props.selectedClient) ?? []
       )[0]
     );
     const featuredClients = computed(() => getFeaturedClients(__props.clientOptions));
     const tabIndex = computed(
       () => featuredClients.value.findIndex(
-        (featuredClient) => __props.xSelectedClient === featuredClient.id
+        (featuredClient) => __props.selectedClient === featuredClient.id
       )
     );
     const wrapper = useTemplateRef("wrapper-ref");
@@ -44,14 +44,14 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       if (!client || !wrapper.value) {
         return;
       }
-      emitCustomEvent(wrapper.value, "scalar-update-selected-client", client.id);
+      __props.eventBus.emit("workspace:update:selected-client", client.id);
     };
     const installationInstructions = computed(() => {
       if (!Array.isArray(__props.xScalarSdkInstallation) || !__props.xScalarSdkInstallation?.length) {
         return void 0;
       }
       const instruction = __props.xScalarSdkInstallation.find((instruction2) => {
-        const targetKey = __props.xSelectedClient?.split("/")[0]?.toLowerCase();
+        const targetKey = __props.selectedClient?.split("/")[0]?.toLowerCase();
         return instruction2.lang.toLowerCase() === targetKey;
       });
       if (!instruction) {
@@ -81,10 +81,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
               default: withCtx(() => [
                 createVNode(ClientDropdown, {
                   clientOptions: _ctx.clientOptions,
+                  eventBus: _ctx.eventBus,
                   featuredClients: featuredClients.value,
                   morePanel: unref(morePanel),
-                  xSelectedClient: _ctx.xSelectedClient
-                }, null, 8, ["clientOptions", "featuredClients", "morePanel", "xSelectedClient"])
+                  selectedClient: _ctx.selectedClient
+                }, null, 8, ["clientOptions", "eventBus", "featuredClients", "morePanel", "selectedClient"])
               ]),
               _: 1
             }, 8, ["aria-labelledby"]),
@@ -109,7 +110,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
                       lang: "shell"
                     }, null, 8, ["content"])
                   ])) : createCommentVNode("", true)
-                ], 64)) : unref(isFeaturedClient)(_ctx.xSelectedClient) ? (openBlock(true), createElementBlock(Fragment, { key: 1 }, renderList(featuredClients.value, (client) => {
+                ], 64)) : unref(isFeaturedClient)(_ctx.selectedClient) ? (openBlock(true), createElementBlock(Fragment, { key: 1 }, renderList(featuredClients.value, (client) => {
                   return openBlock(), createBlock(unref(TabPanel), {
                     key: client.id,
                     class: "selected-client card-footer -outline-offset-2"

package/dist/blocks/scalar-info-block/components/DownloadLink.vue.d.ts

@@ -1,6 +1,10 @@
 import type { ApiReferenceConfiguration } from '@scalar/types/api-reference';
+import { type WorkspaceEventBus } from '@scalar/workspace-store/events';
 type __VLS_Props = {
+    /** The document download type. */
     documentDownloadType: ApiReferenceConfiguration['documentDownloadType'];
+    /** The event bus for the handling all events. */
+    eventBus: WorkspaceEventBus;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/blocks/scalar-info-block/components/DownloadLink.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DownloadLink.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-info-block/components/DownloadLink.vue"],"names":[],"mappings":"AA8LA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAM5E,KAAK,WAAW,GAAG;IACjB,oBAAoB,EAAE,yBAAyB,CAAC,sBAAsB,CAAC,CAAA;CACxE,CAAC;;AAsIF,wBAMG"}
+{"version":3,"file":"DownloadLink.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-info-block/components/DownloadLink.vue"],"names":[],"mappings":"AA6LA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAIvE,KAAK,WAAW,GAAG;IACjB,kCAAkC;IAClC,oBAAoB,EAAE,yBAAyB,CAAC,sBAAsB,CAAC,CAAA;IACvE,iDAAiD;IACjD,QAAQ,EAAE,iBAAiB,CAAA;CAC5B,CAAC;;AAiIF,wBAMG"}

package/dist/blocks/scalar-info-block/components/DownloadLink.vue.js

@@ -1,7 +1,7 @@
 import _sfc_main from "./DownloadLink.vue2.js";
 /* empty css                  */
 import _export_sfc from "../../../_virtual/_plugin-vue_export-helper.js";
-const DownloadLink = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-cb1587b6"]]);
+const DownloadLink = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-79ed4949"]]);
 export {
   DownloadLink as default
 };

package/dist/blocks/scalar-info-block/components/DownloadLink.vue2.js

@@ -1,21 +1,18 @@
-import { defineComponent, useTemplateRef, createElementBlock, createCommentVNode, openBlock, normalizeClass, withModifiers, createElementVNode, createVNode, withCtx, createTextVNode } from "vue";
-import { emitCustomEvent } from "@scalar/workspace-store/events";
+import { defineComponent, createElementBlock, createCommentVNode, openBlock, normalizeClass, withModifiers, createElementVNode, createVNode, withCtx, createTextVNode } from "vue";
 import Badge from "../../../components/Badge/Badge.vue.js";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "DownloadLink",
   props: {
-    documentDownloadType: {}
+    documentDownloadType: {},
+    eventBus: {}
   },
   setup(__props) {
-    const el = useTemplateRef("el");
     const handleDownloadClick = (format) => {
-      emitCustomEvent(el.value, "scalar-download-document", { format });
+      __props.eventBus.emit("ui:download:document", { format });
     };
     return (_ctx, _cache) => {
       return ["yaml", "json", "both", "direct"].includes(_ctx.documentDownloadType) ? (openBlock(), createElementBlock("div", {
         key: 0,
-        ref_key: "el",
-        ref: el,
         class: normalizeClass(["download-container group", {
           "download-both": _ctx.documentDownloadType === "both"
         }])

package/dist/blocks/scalar-info-block/components/InfoBlock.vue.d.ts

@@ -16,15 +16,13 @@ type __VLS_Props = {
     /** OpenAPI extension fields at the info object level. */
     infoExtensions?: Record<string, unknown>;
     /** The event bus for the handling all events. */
-    eventBus: WorkspaceEventBus | null;
-    options: {
-        /** Determines the layout style for the info block ('modern' or 'classic'). */
-        layout?: 'modern' | 'classic';
-        /** The document download type. */
-        documentDownloadType?: ApiReferenceConfiguration['documentDownloadType'];
-        /** Heading id generator for Markdown headings */
-        headingSlugGenerator: (heading: Heading) => string;
-    };
+    eventBus: WorkspaceEventBus;
+    /** Heading id generator for Markdown headings */
+    headingSlugGenerator: (heading: Heading) => string;
+    /** Determines the layout style for the info block ('modern' or 'classic'). */
+    layout?: 'modern' | 'classic';
+    /** The document download type. */
+    documentDownloadType?: ApiReferenceConfiguration['documentDownloadType'];
 };
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {

package/dist/blocks/scalar-info-block/components/InfoBlock.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InfoBlock.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-info-block/components/InfoBlock.vue"],"names":[],"mappings":"AAyEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EACV,2BAA2B,EAC3B,UAAU,EACX,MAAM,8DAA8D,CAAA;AAQrE,KAAK,WAAW,GAAG;IACjB,qDAAqD;IACrD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,IAAI,EAAE,UAAU,GAAG,SAAS,CAAA;IAC5B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,2BAA2B,CAAA;IAC1C,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,iDAAiD;IACjD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE;QACP,8EAA8E;QAC9E,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC7B,kCAAkC;QAClC,oBAAoB,CAAC,EAAE,yBAAyB,CAAC,sBAAsB,CAAC,CAAA;QACxE,iDAAiD;QACjD,oBAAoB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;KACnD,CAAA;CACF,CAAC;AAwEF,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAuBjD,QAAA,MAAM,eAAe,kSAMnB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAQ1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"InfoBlock.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-info-block/components/InfoBlock.vue"],"names":[],"mappings":"AA6EA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EACV,2BAA2B,EAC3B,UAAU,EACX,MAAM,8DAA8D,CAAA;AAQrE,KAAK,WAAW,GAAG;IACjB,qDAAqD;IACrD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,IAAI,EAAE,UAAU,GAAG,SAAS,CAAA;IAC5B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,2BAA2B,CAAA;IAC1C,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,iDAAiD;IACjD,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,iDAAiD;IACjD,oBAAoB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;IAClD,8EAA8E;IAC9E,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC7B,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,yBAAyB,CAAC,sBAAsB,CAAC,CAAA;CACzE,CAAC;AA+EF,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAuBjD,QAAA,MAAM,eAAe,kSAMnB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAQ1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/blocks/scalar-info-block/components/InfoBlock.vue.js

@@ -12,11 +12,13 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     documentExtensions: {},
     infoExtensions: {},
     eventBus: {},
-    options: {}
+    headingSlugGenerator: { type: Function },
+    layout: {},
+    documentDownloadType: { default: "both" }
   },
   setup(__props) {
     const introCardsSlot = computed(
-      () => __props.options.layout === "classic" ? "after" : "aside"
+      () => __props.layout === "classic" ? "after" : "aside"
     );
     return (_ctx, _cache) => {
       return openBlock(), createBlock(IntroductionLayout, {
@@ -24,14 +26,14 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
         documentExtensions: _ctx.documentExtensions,
         eventBus: _ctx.eventBus,
         externalDocs: _ctx.externalDocs,
-        headingSlugGenerator: _ctx.options.headingSlugGenerator,
+        headingSlugGenerator: _ctx.headingSlugGenerator,
         info: _ctx.info,
         infoExtensions: _ctx.infoExtensions,
         oasVersion: _ctx.oasVersion
       }, {
         [introCardsSlot.value]: withCtx(() => [
           createVNode(IntroductionCard, {
-            row: _ctx.options.layout === "classic"
+            row: _ctx.layout === "classic"
           }, {
             default: withCtx(() => [
               renderSlot(_ctx.$slots, "selectors")
@@ -41,8 +43,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
         ]),
         "download-link": withCtx(() => [
           createVNode(DownloadLink, {
-            documentDownloadType: _ctx.options.documentDownloadType ?? "both"
-          }, null, 8, ["documentDownloadType"])
+            documentDownloadType: _ctx.documentDownloadType,
+            eventBus: _ctx.eventBus
+          }, null, 8, ["documentDownloadType", "eventBus"])
         ]),
         _: 2
       }, 1032, ["id", "documentExtensions", "eventBus", "externalDocs", "headingSlugGenerator", "info", "infoExtensions", "oasVersion"]);

package/dist/blocks/scalar-server-selector-block/components/Selector.vue.d.ts

@@ -1,27 +1,20 @@
 import type { ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
 type __VLS_Props = {
     /** The selected server URL */
-    xSelectedServer?: string;
+    selectedServer: ServerObject | null;
     /** Available servers */
     servers: ServerObject[];
     /** The id of the target to use for the popover (e.g. address bar) */
     target: string;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {
-    server: import("vue").ComputedRef<ServerObject | undefined>;
     servers: ServerObject[];
     serverUrlWithoutTrailingSlash: import("vue").ComputedRef<string>;
     serverOptions: import("vue").ComputedRef<{
         id: string;
         label: string;
     }[]>;
-    selectedServer: import("vue").WritableComputedRef<{
-        id: string;
-        label: string;
-    } | undefined, {
-        id: string;
-        label: string;
-    } | undefined>;
+    selectedServer: ServerObject | null;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     "update:modelValue": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{

package/dist/blocks/scalar-server-selector-block/components/Selector.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Selector.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-server-selector-block/components/Selector.vue"],"names":[],"mappings":"AAuFA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAGhG,KAAK,WAAW,GAAG;IACjB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wBAAwB;IACxB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAA;CACf,CAAC;;;;;;;;;;;;;;;;;;;;;AAgMF,wBAQG"}
+{"version":3,"file":"Selector.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-server-selector-block/components/Selector.vue"],"names":[],"mappings":"AA6EA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAGhG,KAAK,WAAW,GAAG;IACjB,8BAA8B;IAC9B,cAAc,EAAE,YAAY,GAAG,IAAI,CAAA;IACnC,wBAAwB;IACxB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAA;CACf,CAAC;;;;;;;;;;;;;;AA6LF,wBAQG"}

package/dist/blocks/scalar-server-selector-block/components/Selector.vue.js

@@ -10,7 +10,7 @@ const _hoisted_3 = { class: "overflow-x-auto" };
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "Selector",
   props: {
-    xSelectedServer: {},
+    selectedServer: {},
     servers: {},
     target: {}
   },
@@ -18,46 +18,34 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   setup(__props, { expose: __expose, emit: __emit }) {
     const emit = __emit;
     const serverOptions = computed(
-      () => __props.servers.map((server2) => ({
-        id: server2.url,
-        label: server2.url
+      () => __props.servers.map((server) => ({
+        id: server.url,
+        label: server.url
       }))
     );
-    const server = computed(() => __props.servers.find((s) => s.url === __props.xSelectedServer));
     const serverUrlWithoutTrailingSlash = computed(
-      () => server.value?.url?.replace(/\/$/, "") || ""
+      () => __props.selectedServer?.url?.replace(/\/$/, "") || ""
+    );
+    const selectedServerOption = computed(
+      () => serverOptions.value.find((opt) => opt.id === __props.selectedServer?.url)
     );
-    const selectedServer = computed({
-      get: () => {
-        if (__props.xSelectedServer && serverOptions.value.length > 0) {
-          return serverOptions.value.find((opt) => opt.id === __props.xSelectedServer);
-        }
-        return void 0;
-      },
-      set: (option) => {
-        if (option) {
-          emit("update:modelValue", option.id);
-        }
-      }
-    });
     __expose({
-      server,
       servers: __props.servers,
       serverUrlWithoutTrailingSlash,
       serverOptions,
-      selectedServer
+      selectedServer: __props.selectedServer
     });
     return (_ctx, _cache) => {
       return serverOptions.value.length > 1 ? (openBlock(), createBlock(unref(ScalarListbox), {
         key: 0,
         ref: "elem",
-        modelValue: selectedServer.value,
-        "onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => selectedServer.value = $event),
         class: "group",
+        modelValue: selectedServerOption.value,
         options: serverOptions.value,
         placement: "bottom-start",
         resize: "",
-        target: _ctx.target
+        target: _ctx.target,
+        "onUpdate:modelValue": _cache[0] || (_cache[0] = (e) => emit("update:modelValue", e.id))
       }, {
         default: withCtx(() => [
           createVNode(unref(ScalarButton), {
@@ -66,7 +54,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           }, {
             default: withCtx(() => [
               _cache[1] || (_cache[1] = createElementVNode("span", { class: "sr-only" }, "Server:", -1)),
-              createElementVNode("span", _hoisted_1, toDisplayString(serverUrlWithoutTrailingSlash.value), 1),
+              createElementVNode("span", _hoisted_1, toDisplayString(serverUrlWithoutTrailingSlash.value || "Select a server"), 1),
               createVNode(unref(ScalarIconCaretDown), {
                 class: "text-c-2 ui-open:rotate-180 mt-0.25 size-3 transition-transform duration-100",
                 weight: "bold"

package/dist/blocks/scalar-server-selector-block/components/ServerSelector.vue.d.ts

@@ -1,7 +1,10 @@
+import type { WorkspaceEventBus } from '@scalar/workspace-store/events';
 import type { ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
 export type SelectorProps = {
-    /** The selected server URL */
-    xSelectedServer?: string;
+    /** The event bus to use for emitting events */
+    eventBus: WorkspaceEventBus;
+    /** The selected server  */
+    selectedServer: ServerObject | null;
     /** Available servers */
     servers: ServerObject[];
 };
@@ -9,9 +12,10 @@ export type SelectorProps = {
  * ServerSelector
  *
  * Core component for rendering a server selector block.
- * Handles server selection and emits a 'scalar-update-selected-server' event when the selected server changes.
+ * Handles server selection and emits a 'server:update:selected' event when the selected server changes.
  *
- * @event scalar-update-selected-server - Emitted when the selected server changes
+ * @event server:update:selected - Emitted when the selected server changes
+ * @event server:update:variables - Emitted when a server variable changes
  */
 declare const _default: import("vue").DefineComponent<SelectorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SelectorProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/blocks/scalar-server-selector-block/components/ServerSelector.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerSelector.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-server-selector-block/components/ServerSelector.vue"],"names":[],"mappings":"AAkHA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAOhG,MAAM,MAAM,aAAa,GAAG;IAC1B,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wBAAwB;IACxB,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB,CAAA;AAED;;;;;;;GAOG;;AACH,wBAiLC"}
+{"version":3,"file":"ServerSelector.vue.d.ts","sourceRoot":"","sources":["../../../../src/blocks/scalar-server-selector-block/components/ServerSelector.vue"],"names":[],"mappings":"AA4FA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAMhG,MAAM,MAAM,aAAa,GAAG;IAC1B,+CAA+C;IAC/C,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,2BAA2B;IAC3B,cAAc,EAAE,YAAY,GAAG,IAAI,CAAA;IACnC,wBAAwB;IACxB,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB,CAAA;AAED;;;;;;;;GAQG;;AACH,wBAuJC"}