@scalar/api-reference 1.32.10 → 1.34.0

package/dist/v2/blocks/scalar-request-example-block/components/RequestExample.vue2.js

@@ -1,25 +1,23 @@
-import { defineComponent as O, computed as m, ref as S, watch as j, useId as D, createElementBlock as k, openBlock as u, Fragment as I, createBlock as p, createCommentVNode as v, unref as l, withCtx as n, createVNode as o, createSlots as N, createElementVNode as h, renderSlot as y, toDisplayString as R } from "vue";
-import { ScalarCard as x, ScalarCardHeader as z, ScalarCombobox as F, ScalarButton as H, ScalarCardSection as q, ScalarCodeBlock as K, ScalarCardFooter as M } from "@scalar/components";
-import { freezeElement as W } from "@scalar/helpers/dom/freeze-element";
-import { ScalarIconCaretDown as U } from "@scalar/icons";
-import { isReference as A } from "@scalar/workspace-store/schemas/v3.1/type-guard";
-import { findClient as $ } from "../helpers/find-client.js";
-import { generateClientOptions as G, generateCustomId as J } from "../helpers/generate-client-options.js";
+import { defineComponent as N, computed as i, ref as g, watch as R, useId as z, createBlock as S, createCommentVNode as b, openBlock as m, unref as s, withCtx as r, createVNode as n, createSlots as H, createElementVNode as v, createElementBlock as q, renderSlot as h, toDisplayString as K } from "vue";
+import { ScalarCard as $, ScalarCardHeader as M, ScalarCombobox as W, ScalarButton as D, ScalarCardSection as E, ScalarCodeBlock as F, ScalarCardFooter as U } from "@scalar/components";
+import { freezeElement as A } from "@scalar/helpers/dom/freeze-element";
+import { ScalarIconCaretDown as G } from "@scalar/icons";
+import { isReference as J } from "@scalar/workspace-store/schemas/v3.1/type-guard";
+import { findClient as V } from "../helpers/find-client.js";
+import { generateCustomId as B } from "../helpers/generate-client-options.js";
 import { generateCodeSnippet as P } from "../helpers/generate-code-snippet.js";
 import { getSecrets as Q } from "../helpers/get-secrets.js";
 import X from "./ExamplePicker.vue2.js";
-import Y from "../../../../components/LinkList/LinkList.vue.js";
-import Z from "../../../../features/external-docs/ExternalDocs.vue.js";
-import B from "../../../../components/HttpMethod/HttpMethod.vue.js";
-import { emitCustomEvent as V } from "../../../events/definitions.js";
-const _ = ["innerHTML"], ee = { class: "text-base" }, te = ["id"], le = {
+import T from "../../../../components/HttpMethod/HttpMethod.vue.js";
+import { emitCustomEvent as O } from "../../../events/definitions.js";
+const Y = ["innerHTML"], Z = { class: "text-base font-normal" }, _ = ["id"], ee = {
   key: 0,
   class: "request-card-footer-addon"
-}, ae = { class: "request-header" }, oe = {}, Se = /* @__PURE__ */ O({
-  ...oe,
+}, te = { class: "request-header" }, le = {}, ve = /* @__PURE__ */ N({
+  ...le,
   __name: "RequestExample",
   props: {
-    allowedClients: {},
+    clientOptions: {},
     selectedClient: {},
     selectedServer: { default: () => ({ url: "/" }) },
     selectedContentType: {},
@@ -29,199 +27,205 @@ const _ = ["innerHTML"], ee = { class: "text-base" }, te = ["id"], le = {
     path: {},
     operation: {},
     fallback: { type: Boolean },
-    generateLabel: { type: Function },
-    hideClientSelector: { type: Boolean, default: !1 }
+    generateLabel: { type: Function }
   },
-  setup(a) {
-    const c = m(() => {
-      var d, b;
-      if (A(a.operation.requestBody))
+  setup(o) {
+    const c = i(() => {
+      var a, p;
+      if (J(o.operation.requestBody))
         return {};
-      const t = ((d = a.operation.requestBody) == null ? void 0 : d.content) ?? {}, e = a.selectedContentType || Object.keys(t)[0];
-      return ((b = t[e]) == null ? void 0 : b.examples) ?? {};
-    }), C = S(
-      a.selectedExample ?? Object.keys(c.value)[0]
-    ), g = m(() => [
+      const t = ((a = o.operation.requestBody) == null ? void 0 : a.content) ?? {}, e = o.selectedContentType || Object.keys(t)[0];
+      return ((p = t[e]) == null ? void 0 : p.examples) ?? {};
+    }), y = g(
+      o.selectedExample ?? Object.keys(c.value)[0]
+    ), C = i(() => [
       "x-custom-examples",
       "x-codeSamples",
       "x-code-samples"
     ].flatMap(
-      (e) => a.operation[e] ?? []
-    )), f = m(
-      () => G(g.value, a.allowedClients)
-    ), r = S(
-      $(f.value, a.selectedClient)
+      (e) => o.operation[e] ?? []
+    )), f = i(() => C.value.length ? [
+      {
+        label: "Code Examples",
+        options: C.value.map((e) => {
+          const l = B(e), a = e.label || e.lang || l;
+          return {
+            id: l,
+            lang: e.lang || "plaintext",
+            title: a,
+            label: a
+          };
+        })
+      },
+      ...o.clientOptions
+    ] : o.clientOptions), u = g(
+      V(f.value, o.selectedClient) ?? null
     );
-    j(
-      () => a.selectedClient,
+    R(
+      () => o.selectedClient,
       (t) => {
-        const e = $(f.value, t);
-        e && (r.value = e);
+        const e = V(f.value, t);
+        e && (u.value = e);
       }
     );
-    const E = m(() => {
-      var t;
+    const k = i(() => {
+      var t, e, l;
       try {
-        if (r.value.id.startsWith("custom"))
-          return ((t = g.value.find(
-            (d) => J(d) === r.value.id
-          )) == null ? void 0 : t.source) ?? "Custom example not found";
-        const e = c.value[C.value || ""], s = (e == null ? void 0 : e.value) ?? (e == null ? void 0 : e.summary);
+        if ((t = u.value) != null && t.id.startsWith("custom"))
+          return ((e = C.value.find(
+            (I) => {
+              var x;
+              return B(I) === ((x = u.value) == null ? void 0 : x.id);
+            }
+          )) == null ? void 0 : e.source) ?? "Custom example not found";
+        const a = c.value[y.value || ""], p = (a == null ? void 0 : a.value) ?? (a == null ? void 0 : a.summary);
         return P({
-          clientId: r.value.id,
-          operation: a.operation,
-          method: a.method,
-          server: a.selectedServer,
-          securitySchemes: a.securitySchemes,
-          contentType: a.selectedContentType,
-          path: a.path,
-          example: s
+          clientId: (l = u.value) == null ? void 0 : l.id,
+          operation: o.operation,
+          method: o.method,
+          server: o.selectedServer,
+          securitySchemes: o.securitySchemes,
+          contentType: o.selectedContentType,
+          path: o.path,
+          example: p
         });
-      } catch (e) {
-        return console.error("[generateSnippet]", e), "";
+      } catch (a) {
+        return console.error("[generateSnippet]", a), "";
       }
-    }), T = m(() => Q(a.securitySchemes)), i = S(null), L = (t) => {
+    }), w = i(() => Q(o.securitySchemes)), d = g(null), L = (t) => {
       var e;
-      if (i.value) {
-        const s = W(i.value.$el);
+      if (d.value) {
+        const l = A(d.value.$el);
         setTimeout(() => {
-          s();
+          l();
         }, 300);
       }
-      r.value = t, t.id.startsWith("custom") || V(
-        (e = i.value) == null ? void 0 : e.$el,
-        "scalar-update-selected-client",
-        t.id
-      );
-    }, w = D();
-    return (t, e) => (u(), k(I, null, [
-      t.operation.externalDocs ? (u(), p(l(Y), { key: 0 }, {
-        default: n(() => [
-          o(l(Z), {
-            value: t.operation.externalDocs
-          }, null, 8, ["value"])
-        ]),
-        _: 1
-      })) : v("", !0),
-      f.value.length ? (u(), p(l(x), {
-        key: 1,
-        class: "request-card dark-mode",
-        ref_key: "elem",
-        ref: i
-      }, {
-        default: n(() => [
-          o(l(z), { class: "pr-0.5" }, N({
-            default: n(() => [
-              e[3] || (e[3] = h("span", { class: "sr-only" }, "Request Example for", -1)),
-              o(l(B), {
-                as: "span",
-                class: "request-method",
-                method: t.method
-              }, null, 8, ["method"]),
-              t.generateLabel ? (u(), k("span", {
-                key: 0,
-                innerHTML: t.generateLabel()
-              }, null, 8, _)) : y(t.$slots, "header", { key: 1 }, void 0, !0)
+      u.value = t, t.id.startsWith("custom") || O((e = d.value) == null ? void 0 : e.$el, "scalar-update-selected-client", t.id);
+    }, j = z();
+    return (t, e) => k.value ? (m(), S(s($), {
+      key: 0,
+      class: "request-card dark-mode",
+      ref_key: "elem",
+      ref: d
+    }, {
+      default: r(() => [
+        n(s(M), { class: "pr-2.5" }, H({
+          default: r(() => [
+            e[3] || (e[3] = v("span", { class: "sr-only" }, "Request Example for", -1)),
+            n(s(T), {
+              as: "span",
+              class: "request-method",
+              method: t.method
+            }, null, 8, ["method"]),
+            t.generateLabel ? (m(), q("span", {
+              key: 0,
+              innerHTML: t.generateLabel()
+            }, null, 8, Y)) : h(t.$slots, "header", { key: 1 }, void 0, !0)
+          ]),
+          _: 2
+        }, [
+          f.value.length ? {
+            name: "actions",
+            fn: r(() => [
+              n(s(W), {
+                class: "max-h-80",
+                modelValue: u.value,
+                options: f.value,
+                teleport: "",
+                placement: "bottom-end",
+                "onUpdate:modelValue": e[0] || (e[0] = (l) => L(l))
+              }, {
+                default: r(() => [
+                  n(s(D), {
+                    "data-testid": "client-picker",
+                    class: "text-c-2 hover:text-c-1 flex h-full w-fit gap-1.5 px-0.5",
+                    fullWidth: "",
+                    variant: "ghost"
+                  }, {
+                    default: r(() => [
+                      v("span", Z, K(u.value.title), 1),
+                      n(s(G), {
+                        weight: "bold",
+                        class: "ui-open:rotate-180 mt-0.25 size-3 transition-transform duration-100"
+                      })
+                    ]),
+                    _: 1
+                  })
+                ]),
+                _: 1
+              }, 8, ["modelValue", "options"])
             ]),
-            _: 2
-          }, [
-            t.hideClientSelector ? void 0 : {
-              name: "actions",
-              fn: n(() => [
-                o(l(F), {
-                  class: "max-h-80",
-                  modelValue: r.value,
-                  options: f.value,
-                  teleport: "",
-                  placement: "bottom-end",
-                  "onUpdate:modelValue": e[0] || (e[0] = (s) => L(s))
-                }, {
-                  default: n(() => [
-                    o(l(H), {
-                      "data-testid": "client-picker",
-                      class: "text-c-2 hover:text-c-1 flex h-full w-fit gap-2 px-1",
-                      fullWidth: "",
-                      variant: "ghost"
-                    }, {
-                      default: n(() => [
-                        h("span", ee, R(r.value.title), 1),
-                        o(l(U), { class: "size-3.5" })
-                      ]),
-                      _: 1
-                    })
-                  ]),
-                  _: 1
-                }, 8, ["modelValue", "options"])
-              ]),
-              key: "0"
-            }
-          ]), 1024),
-          o(l(q), { class: "request-editor-section custom-scroll p-0" }, {
-            default: n(() => [
-              h("div", {
-                id: `${l(w)}-example`,
+            key: "0"
+          } : void 0
+        ]), 1024),
+        n(s(E), { class: "request-editor-section custom-scroll p-0" }, {
+          default: r(() => {
+            var l;
+            return [
+              v("div", {
+                id: `${s(j)}-example`,
                 class: "code-snippet"
               }, [
-                o(l(K), {
+                n(s(F), {
                   class: "bg-b-2 !min-h-full -outline-offset-2",
-                  content: E.value,
-                  hideCredentials: T.value,
-                  lang: r.value.lang,
+                  content: k.value,
+                  hideCredentials: w.value,
+                  lang: (l = u.value) == null ? void 0 : l.lang,
                   lineNumbers: ""
                 }, null, 8, ["content", "hideCredentials", "lang"])
-              ], 8, te)
-            ]),
-            _: 1
+              ], 8, _)
+            ];
           }),
-          Object.keys(c.value).length || t.$slots.footer ? (u(), p(l(M), {
-            key: 0,
-            class: "request-card-footer bg-b-3"
-          }, {
-            default: n(() => [
-              Object.keys(c.value).length ? (u(), k("div", le, [
-                o(X, {
-                  examples: c.value,
-                  modelValue: C.value,
-                  "onUpdate:modelValue": [
-                    e[1] || (e[1] = (s) => C.value = s),
-                    e[2] || (e[2] = (s) => {
-                      var d;
-                      return l(V)((d = i.value) == null ? void 0 : d.$el, "scalar-update-selected-example", s);
-                    })
-                  ]
-                }, null, 8, ["examples", "modelValue"])
-              ])) : v("", !0),
-              y(t.$slots, "footer", {}, void 0, !0)
-            ]),
-            _: 3
-          })) : v("", !0)
-        ]),
-        _: 3
-      }, 512)) : t.fallback ? (u(), p(l(x), {
-        key: 2,
-        class: "request-card dark-mode"
-      }, {
-        default: n(() => [
-          o(l(q), { class: "request-card-simple" }, {
-            default: n(() => [
-              h("div", ae, [
-                o(l(B), {
-                  as: "span",
-                  class: "request-method",
-                  method: t.method
-                }, null, 8, ["method"]),
-                y(t.$slots, "header", {}, void 0, !0)
-              ]),
-              y(t.$slots, "footer", {}, void 0, !0)
+          _: 1
+        }),
+        Object.keys(c.value).length || t.$slots.footer ? (m(), S(s(U), {
+          key: 0,
+          class: "request-card-footer bg-b-3"
+        }, {
+          default: r(() => [
+            Object.keys(c.value).length ? (m(), q("div", ee, [
+              n(X, {
+                examples: c.value,
+                modelValue: y.value,
+                "onUpdate:modelValue": [
+                  e[1] || (e[1] = (l) => y.value = l),
+                  e[2] || (e[2] = (l) => {
+                    var a;
+                    return s(O)((a = d.value) == null ? void 0 : a.$el, "scalar-update-selected-example", l);
+                  })
+                ]
+              }, null, 8, ["examples", "modelValue"])
+            ])) : b("", !0),
+            h(t.$slots, "footer", {}, void 0, !0)
+          ]),
+          _: 3
+        })) : b("", !0)
+      ]),
+      _: 3
+    }, 512)) : t.fallback ? (m(), S(s($), {
+      key: 1,
+      class: "request-card dark-mode"
+    }, {
+      default: r(() => [
+        n(s(E), { class: "request-card-simple" }, {
+          default: r(() => [
+            v("div", te, [
+              n(s(T), {
+                as: "span",
+                class: "request-method",
+                method: t.method
+              }, null, 8, ["method"]),
+              h(t.$slots, "header", {}, void 0, !0)
             ]),
-            _: 3
-          })
-        ]),
-        _: 3
-      })) : v("", !0)
-    ], 64));
+            h(t.$slots, "footer", {}, void 0, !0)
+          ]),
+          _: 3
+        })
+      ]),
+      _: 3
+    })) : b("", !0);
   }
 });
 export {
-  Se as default
+  ve as default
 };

package/dist/v2/blocks/scalar-request-example-block/components/RequestExample.vue3.js

@@ -0,0 +1,4 @@
+const e = "";
+export {
+  e as default
+};

package/dist/v2/blocks/scalar-request-example-block/helpers/find-client.d.ts

@@ -1,5 +1,6 @@
 import type { ClientOption, ClientOptionGroup } from '../../../../v2/blocks/scalar-request-example-block/types';
 import { type AvailableClients } from '@scalar/snippetz';
+export declare const DEFAULT_CLIENT = "shell/curl";
 /** Type guard to check if a string is a valid client id */
 export declare const isClient: (id: any) => id is AvailableClients[number];
 /**

package/dist/v2/blocks/scalar-request-example-block/helpers/find-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-client.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-request-example-block/helpers/find-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAA;AACrG,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAI3E,2DAA2D;AAC3D,eAAO,MAAM,QAAQ,OAAQ,GAAG,KAAG,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAmC,CAAA;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,UAAU,iBACP,iBAAiB,EAAE,aACtB,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,KAC9C,YAwBF,CAAA"}
+{"version":3,"file":"find-client.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-request-example-block/helpers/find-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAA;AACrG,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE3E,eAAO,MAAM,cAAc,eAAe,CAAA;AAE1C,2DAA2D;AAC3D,eAAO,MAAM,QAAQ,OAAQ,GAAG,KAAG,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAmC,CAAA;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,UAAU,iBACP,iBAAiB,EAAE,aACtB,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,KAC9C,YAwBF,CAAA"}

package/dist/v2/blocks/scalar-request-example-block/helpers/find-client.js

@@ -17,6 +17,7 @@ const d = "shell/curl", u = (o) => c.includes(o), e = (o, r) => {
   return n;
 };
 export {
+  d as DEFAULT_CLIENT,
   e as findClient,
   u as isClient
 };

package/dist/v2/blocks/scalar-request-example-block/helpers/generate-client-options.d.ts

@@ -1,21 +1,20 @@
 import type { ClientOptionGroup } from '../../../../v2/blocks/scalar-request-example-block/types';
 import type { XCodeSample } from '@scalar/openapi-types/schemas/extensions';
-import { type AvailableClients } from '@scalar/snippetz';
+import type { ApiReferenceConfiguration } from '@scalar/types/api-reference';
 /** Helper to generate an ID for custom code samples */
 export declare const generateCustomId: (example: XCodeSample) => string;
 /**
- * Generates client options for the request example block by combining built-in snippets
- * with custom code samples. This function creates a structured list of available
- * client options that can be used to generate code examples for different programming
- * languages and frameworks.
+ * Generates client options for the request example block by filtering and organizing
+ * built-in snippets based on the hiddenClients configuration. This function creates
+ * a structured list of available client options that can be used to generate code
+ * examples for different programming languages and frameworks.
  *
- * The function filters built-in clients based on the allowedClients parameter and
- * groups them by their category (e.g., JavaScript, Python, etc.). Custom code samples
- * are added as a separate "Code Examples" group at the top of the list.
- *
- * @param customRequestExamples - Array of custom code samples to include in the options
- * @param allowedClients - Optional array of allowed client IDs to filter built-in clients
- * @returns Array of client option groups, each containing a label and array of client options
+ * The function filters built-in clients based on the hiddenClients parameter and
+ * groups them by their category (e.g., JavaScript, Python, etc.). The hiddenClients
+ * parameter supports multiple formats:
+ * - boolean: true to hide all clients
+ * - array: ['fetch', 'axios'] to hide specific clients across all categories
+ * - object: { node: true, python: ['requests'] } to hide entire categories or specific clients within categories
  */
-export declare const generateClientOptions: (customRequestExamples: XCodeSample[], allowedClients?: AvailableClients[number][]) => ClientOptionGroup[];
+export declare const generateClientOptions: (hiddenClients: ApiReferenceConfiguration["hiddenClients"]) => ClientOptionGroup[];
 //# sourceMappingURL=generate-client-options.d.ts.map

package/dist/v2/blocks/scalar-request-example-block/helpers/generate-client-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-client-options.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-request-example-block/helpers/generate-client-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAC3E,OAAO,EAAY,KAAK,gBAAgB,EAAiB,MAAM,kBAAkB,CAAA;AAGjF,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,YAAa,WAAW,WAA6B,CAAA;AAElF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,0BACT,WAAW,EAAE,mBACnB,gBAAgB,CAAC,MAAM,CAAC,EAAE,KAC1C,iBAAiB,EAqDnB,CAAA"}
+{"version":3,"file":"generate-client-options.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-request-example-block/helpers/generate-client-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAE3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAG5E,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,YAAa,WAAW,WAA6B,CAAA;AAElF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,kBACjB,yBAAyB,CAAC,eAAe,CAAC,KACxD,iBAAiB,EAwDnB,CAAA"}

package/dist/v2/blocks/scalar-request-example-block/helpers/generate-client-options.js

@@ -1,35 +1,33 @@
-import { snippetz as a } from "@scalar/snippetz";
-import { capitalize as r } from "vue";
-const f = (l) => `custom/${l.lang}`, u = (l, i) => {
-  const o = a().clients().flatMap((t) => {
-    const n = t.clients.flatMap((e) => {
-      const c = `${t.key}/${e.client}`;
-      return i && !i.includes(c) ? [] : {
-        id: c,
-        lang: e.client === "curl" ? "curl" : t.key,
-        title: `${r(t.title)} ${e.title}`,
-        label: e.title
-      };
-    });
-    return n.length === 0 ? [] : {
-      label: t.title,
-      options: n
-    };
-  }), s = l.map((t) => {
-    const n = f(t), e = t.label || t.lang || n;
+import { snippetz as l } from "@scalar/snippetz";
+import { capitalize as o } from "vue";
+const y = (t) => `custom/${t.lang}`, m = (t) => t === !0 ? [] : l().clients().flatMap((e) => {
+  const n = e.clients.flatMap((r) => {
+    const c = `${e.key}/${r.client}`;
+    if (Array.isArray(t) && t.includes(r.client))
+      return [];
+    if (typeof t == "object" && t !== null) {
+      const i = t[e.key];
+      if (i === !0)
+        return [];
+      if (Array.isArray(i) && i.includes(r.client))
+        return [];
+    }
     return {
-      id: n,
-      lang: t.lang || "plaintext",
-      title: e,
-      label: e
+      id: c,
+      lang: r.client === "curl" ? "curl" : e.key,
+      title: `${o(e.title)} ${r.title}`,
+      label: r.title,
+      targetKey: e.key,
+      targetTitle: e.title,
+      clientKey: r.client
     };
   });
-  return s.length > 0 && o.unshift({
-    label: "Code Examples",
-    options: s
-  }), o;
-};
+  return n.length === 0 ? [] : {
+    label: e.title,
+    options: n
+  };
+});
 export {
-  u as generateClientOptions,
-  f as generateCustomId
+  m as generateClientOptions,
+  y as generateCustomId
 };

package/dist/v2/blocks/scalar-request-example-block/types.d.ts

@@ -1,15 +1,23 @@
 import type { ScalarComboboxOption, ScalarComboboxOptionGroup } from '@scalar/components';
-import type { TargetId } from '@scalar/snippetz';
+import type { AvailableClients, ClientId, TargetId } from '@scalar/snippetz';
 /**
  * Represents a client option in the request example block.
  * Extends the base combobox option with language-specific information
  * for generating code examples in different programming languages.
  */
 export type ClientOption = ScalarComboboxOption & {
-    /** The programming language or tool for code generation (e.g., 'javascript', 'python', 'curl') */
+    /** A more specific ID */
+    id: AvailableClients[number];
+    /** Programming language or tool for code generation (e.g., 'javascript', 'python', 'curl') */
     lang: TargetId | 'curl' | 'plaintext';
-    /** The title shows when the client is selected in the dropdown */
+    /** Title shows when the client is selected in the dropdown */
     title: string;
+    /** Target key for the client, differs from the lang due to the curl thing */
+    targetKey: TargetId;
+    /** Title of the target */
+    targetTitle: string;
+    /** Client key for the client */
+    clientKey: ClientId<TargetId>;
 };
 /**
  * Augments the base combobox option group with ClientOptions

package/dist/v2/blocks/scalar-request-example-block/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/v2/blocks/scalar-request-example-block/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG;IAChD,kGAAkG;IAClG,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IACrC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,GAAG;IAC3E,wDAAwD;IACxD,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/v2/blocks/scalar-request-example-block/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE5E;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG;IAChD,yBAAyB;IACzB,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC5B,8FAA8F;IAC9F,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IACrC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,SAAS,EAAE,QAAQ,CAAA;IACnB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,GAAG;IAC3E,wDAAwD;IACxD,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB,CAAA"}

package/dist/v2/helpers/get-document-name.d.ts

@@ -0,0 +1,13 @@
+import type { ObjectDoc, UrlDoc } from '@scalar/workspace-store/client';
+import type { OpenApiDocument } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+/**
+ * Calculate a default name for the document to make the workspace store name parameter optional
+ *
+ * @param params.name - If we have a name already, like config.slug
+ * @param params.url - URL of the document
+ * @param params.document - The document object
+ * @param documents - Optional documents record which will automatically iterate the title if we have a duplicate
+ * @returns The name of the document
+ */
+export declare const getDocumentName: ({ name, url, document }?: Partial<UrlDoc> & Partial<ObjectDoc>, documents?: Record<string, OpenApiDocument>) => string;
+//# sourceMappingURL=get-document-name.d.ts.map

package/dist/v2/helpers/get-document-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-name.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/get-document-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAA;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAA;AAEnG;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,6BACD,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,cACjD,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,KAC1C,MA2BF,CAAA"}

package/dist/v2/helpers/get-document-name.js

@@ -0,0 +1,15 @@
+const n = ({ name: i, url: f, document: t } = {}, e) => {
+  if (i)
+    return i;
+  if (f)
+    return f;
+  if (t != null && t.info) {
+    const r = t.info;
+    if (r.title)
+      return r.title;
+  }
+  return "default";
+};
+export {
+  n as getDocumentName
+};

package/dist/v2/helpers/normalize-content.d.ts

@@ -0,0 +1,3 @@
+/** Normalize content into a JS object or return null if it is falsey */
+export declare const normalizeContent: (content: string | Record<string, unknown> | (() => string | Record<string, unknown>) | undefined | null) => Record<string, unknown> | undefined;
+//# sourceMappingURL=normalize-content.d.ts.map

package/dist/v2/helpers/normalize-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-content.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/normalize-content.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,YAClB,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,KACtG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAc5B,CAAA"}