@scalar/api-client 2.15.0 → 2.17.0

package/dist/v2/blocks/operation-code-sample/components/OperationCodeSample.vue2.js

@@ -1,21 +1,22 @@
-import { defineComponent as D, computed as n, ref as C, watch as N, useId as R, createBlock as i, createCommentVNode as f, openBlock as s, unref as o, withCtx as r, createVNode as u, createSlots as z, createElementVNode as g, createElementBlock as S, renderSlot as y, createTextVNode as K, toDisplayString as M } from "vue";
-import { ScalarCard as T, ScalarCardHeader as U, ScalarCombobox as A, ScalarButton as F, ScalarCardSection as q, ScalarCodeBlock as Z, ScalarVirtualText as G, ScalarCardFooter as J } from "@scalar/components";
-import { freezeElement as P } from "@scalar/helpers/dom/freeze-element";
-import { ScalarIconCaretDown as Q } from "@scalar/icons";
+import { defineComponent as D, computed as a, ref as C, watch as I, useId as N, createBlock as i, createCommentVNode as f, openBlock as s, unref as o, withCtx as n, createVNode as r, createSlots as W, createElementVNode as b, createElementBlock as x, renderSlot as y, createTextVNode as R, toDisplayString as z } from "vue";
+import { ScalarCard as S, ScalarCardHeader as U, ScalarCombobox as A, ScalarButton as F, ScalarCardSection as T, ScalarCodeBlock as M, ScalarVirtualText as K, ScalarCardFooter as Z } from "@scalar/components";
+import { freezeElement as G } from "@scalar/helpers/dom/freeze-element";
+import { ScalarIconCaretDown as J } from "@scalar/icons";
 import { emitCustomEvent as V } from "@scalar/workspace-store/events";
-import { getResolvedRef as X } from "@scalar/workspace-store/helpers/get-resolved-ref";
-import { operationToHar as Y } from "../helpers/operation-to-har/operation-to-har.js";
-import E from "./HttpMethod.vue.js";
-import { findClient as O } from "../helpers/find-client.js";
-import { generateCustomId as $ } from "../helpers/generate-client-options.js";
-import { generateCodeSnippet as _ } from "../helpers/generate-code-snippet.js";
-import { getSecrets as ee } from "../helpers/get-secrets.js";
+import { getResolvedRef as P } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { operationToHar as Q } from "../helpers/operation-to-har/operation-to-har.js";
+import q from "./HttpMethod.vue.js";
+import { findClient as $ } from "../helpers/find-client.js";
+import { getClients as X } from "../helpers/get-clients.js";
+import { getCustomCodeSamples as Y } from "../helpers/get-custom-code-samples.js";
+import { getSecrets as _ } from "../helpers/get-secrets.js";
+import { generateCodeSnippet as ee } from "../helpers/generate-code-snippet.js";
 import te from "./ExamplePicker.vue.js";
 const le = ["innerHTML"], oe = ["id"], ae = {
   key: 0,
   class: "request-card-footer-addon"
-}, ne = { class: "request-header" }, re = {}, Ce = /* @__PURE__ */ D({
-  ...re,
+}, ne = { class: "request-header" }, se = {}, ge = /* @__PURE__ */ D({
+  ...se,
   __name: "OperationCodeSample",
   props: {
     clientOptions: {},
@@ -31,99 +32,77 @@ const le = ["innerHTML"], oe = ["id"], ae = {
     generateLabel: { type: Function },
     isWebhook: { type: Boolean }
   },
-  setup(l) {
-    const d = n(() => {
-      const e = X(l.operation.requestBody)?.content ?? {}, t = l.selectedContentType || Object.keys(e)[0];
-      return t ? e[t]?.examples ?? {} : {};
+  setup(t) {
+    const d = a(() => {
+      const e = P(t.operation.requestBody)?.content ?? {}, l = t.selectedContentType || Object.keys(e)[0];
+      return l ? e[l]?.examples ?? {} : {};
     }), p = C(
-      l.selectedExample ?? Object.keys(d.value)[0] ?? ""
-    ), b = n(() => [
-      "x-custom-examples",
-      "x-codeSamples",
-      "x-code-samples"
-    ].flatMap((t) => l.operation[t] ?? [])), h = n(() => b.value.length ? [
-      {
-        label: "Code Examples",
-        options: b.value.map((t) => {
-          const a = $(t), k = t.label || t.lang || a;
-          return {
-            id: a,
-            lang: t.lang || "plaintext",
-            title: k,
-            label: k
-          };
-        })
-      },
-      ...l.clientOptions
-    ] : l.clientOptions), c = C(
-      O(h.value, l.selectedClient)
+      t.selectedExample ?? Object.keys(d.value)[0] ?? ""
+    ), g = a(() => Y(t.operation)), h = a(
+      () => X(g.value, t.clientOptions)
+    ), u = C(
+      $(h.value, t.selectedClient)
     );
-    N(
-      () => l.selectedClient,
+    I(
+      () => t.selectedClient,
       (e) => {
-        const t = O(h.value, e);
-        t && (c.value = t);
+        const l = $(h.value, e);
+        l && (u.value = l);
       }
     );
-    const x = n(() => {
-      if (!l.isWebhook) return null;
+    const k = a(() => {
+      if (!t.isWebhook) return null;
       try {
-        return Y({
-          operation: l.operation,
-          method: l.method,
-          path: l.path,
+        return Q({
+          operation: t.operation,
+          method: t.method,
+          path: t.path,
           example: p.value
         });
       } catch (e) {
         return console.error("[webhookHar]", e), null;
       }
-    }), v = n(() => {
-      try {
-        const e = c.value?.id;
-        return e ? e.startsWith("custom") ? b.value.find(
-          (t) => $(t) === c.value?.id
-        )?.source ?? "Custom example not found" : l.isWebhook ? x.value?.postData?.text ?? "" : _({
-          clientId: e,
-          operation: l.operation,
-          method: l.method,
-          server: l.selectedServer,
-          securitySchemes: l.securitySchemes,
-          contentType: l.selectedContentType,
-          path: l.path,
-          example: p.value
-        }) : "";
-      } catch (e) {
-        return console.error("[generateSnippet]", e), "";
-      }
-    }), B = n(() => l.isWebhook ? j.value : c.value?.lang), j = n(() => {
-      if (!x.value?.postData) return "json";
-      const e = x.value.postData.mimeType;
+    }), v = a(() => t.isWebhook ? k.value?.postData?.text ?? "" : ee({
+      clientId: u.value?.id,
+      customCodeSamples: g.value,
+      operation: t.operation,
+      method: t.method,
+      path: t.path,
+      contentType: t.selectedContentType,
+      server: t.selectedServer,
+      securitySchemes: t.securitySchemes,
+      example: p.value
+    })), B = a(() => t.isWebhook ? E.value : u.value?.lang), E = a(() => {
+      if (!k.value?.postData) return "json";
+      const e = k.value.postData.mimeType;
       return e?.includes("json") ? "json" : e?.includes("xml") ? "xml" : e?.includes("yaml") || e?.includes("yml") ? "yaml" : e?.includes("text/plain") ? "text" : "json";
-    }), w = n(() => ee(l.securitySchemes)), m = C(null), H = (e) => {
+    }), O = a(() => _(t.securitySchemes)), m = C(null), j = (e) => {
       if (m.value) {
-        const t = P(m.value.$el);
+        const l = G(m.value.$el);
         setTimeout(() => {
-          t();
+          l();
         }, 300);
       }
-      c.value = e, e.id.startsWith("custom") || V(m.value?.$el, "scalar-update-selected-client", e.id);
-    }, L = 2e4, I = n(() => (v.value.length ?? 0) > L), W = R();
-    return (e, t) => v.value ? (s(), i(o(T), {
+      u.value = e, e.id.startsWith("custom") || V(m.value?.$el, "scalar-update-selected-client", e.id);
+    }, w = 2e4, H = a(
+      () => (v.value.length ?? 0) > w
+    ), L = N();
+    return (e, l) => v.value ? (s(), i(o(S), {
       key: 0,
       ref_key: "elem",
       ref: m,
       class: "request-card dark-mode"
     }, {
-      default: r(() => [
-        u(o(U), { class: "pr-2.5" }, z({
-          default: r(() => [
-            t[3] || (t[3] = g("span", { class: "sr-only" }, "Request Example for", -1)),
-            u(E, {
+      default: n(() => [
+        r(o(U), { class: "pr-2.5" }, W({
+          default: n(() => [
+            l[3] || (l[3] = b("span", { class: "sr-only" }, "Request Example for", -1)),
+            r(q, {
               as: "span",
               class: "request-method",
               method: e.method
             }, null, 8, ["method"]),
-            e.generateLabel ? (s(), S("span", {
+            e.generateLabel ? (s(), x("span", {
               key: 0,
               innerHTML: e.generateLabel()
             }, null, 8, le)) : f("", !0),
@@ -133,24 +112,24 @@ const le = ["innerHTML"], oe = ["id"], ae = {
         }, [
           !e.isWebhook && h.value.length ? {
             name: "actions",
-            fn: r(() => [
-              u(o(A), {
+            fn: n(() => [
+              r(o(A), {
                 class: "max-h-80",
-                modelValue: c.value,
+                modelValue: u.value,
                 options: h.value,
                 placement: "bottom-end",
                 teleport: "",
-                "onUpdate:modelValue": t[0] || (t[0] = (a) => H(a))
+                "onUpdate:modelValue": l[0] || (l[0] = (c) => j(c))
               }, {
-                default: r(() => [
-                  u(o(F), {
+                default: n(() => [
+                  r(o(F), {
                     class: "text-c-2 hover:text-c-1 flex h-full w-fit gap-1.5 px-0.5 py-0 text-base font-normal",
                     "data-testid": "client-picker",
                     variant: "ghost"
                   }, {
-                    default: r(() => [
-                      K(M(c.value?.title) + " ", 1),
-                      u(o(Q), {
+                    default: n(() => [
+                      R(z(u.value?.title) + " ", 1),
+                      r(o(J), {
                         class: "ui-open:rotate-180 mt-0.25 size-3 transition-transform duration-100",
                         weight: "bold"
                       })
@@ -164,23 +143,23 @@ const le = ["innerHTML"], oe = ["id"], ae = {
             key: "0"
           } : void 0
         ]), 1024),
-        u(o(q), { class: "request-editor-section custom-scroll p-0" }, {
-          default: r(() => [
-            g("div", {
-              id: `${o(W)}-example`,
+        r(o(T), { class: "request-editor-section custom-scroll p-0" }, {
+          default: n(() => [
+            b("div", {
+              id: `${o(L)}-example`,
               class: "code-snippet"
             }, [
-              I.value ? (s(), i(o(G), {
+              H.value ? (s(), i(o(K), {
                 key: 1,
                 containerClass: "custom-scroll scalar-code-block border rounded-b flex flex-1 max-h-screen",
                 contentClass: "language-plaintext whitespace-pre font-code text-base",
                 lineHeight: 20,
                 text: v.value
-              }, null, 8, ["text"])) : (s(), i(o(Z), {
+              }, null, 8, ["text"])) : (s(), i(o(M), {
                 key: 0,
                 class: "bg-b-2 !min-h-full -outline-offset-2",
                 content: v.value,
-                hideCredentials: w.value,
+                hideCredentials: O.value,
                 lang: B.value,
                 lineNumbers: ""
               }, null, 8, ["content", "hideCredentials", "lang"]))
@@ -188,21 +167,21 @@ const le = ["innerHTML"], oe = ["id"], ae = {
           ]),
           _: 1
         }),
-        Object.keys(d.value).length > 1 || e.$slots.footer ? (s(), i(o(J), {
+        Object.keys(d.value).length > 1 || e.$slots.footer ? (s(), i(o(Z), {
           key: 0,
           class: "request-card-footer bg-b-3"
         }, {
-          default: r(() => [
-            Object.keys(d.value).length > 1 ? (s(), S("div", ae, [
+          default: n(() => [
+            Object.keys(d.value).length > 1 ? (s(), x("div", ae, [
               Object.keys(d.value).length ? (s(), i(te, {
                 key: 0,
                 modelValue: p.value,
                 "onUpdate:modelValue": [
-                  t[1] || (t[1] = (a) => p.value = a),
-                  t[2] || (t[2] = (a) => o(V)(
+                  l[1] || (l[1] = (c) => p.value = c),
+                  l[2] || (l[2] = (c) => o(V)(
                     m.value?.$el,
                     "scalar-update-selected-example",
-                    a
+                    c
                   ))
                 ],
                 examples: d.value
@@ -214,15 +193,15 @@ const le = ["innerHTML"], oe = ["id"], ae = {
         })) : f("", !0)
       ]),
       _: 3
-    }, 512)) : e.fallback ? (s(), i(o(T), {
+    }, 512)) : e.fallback ? (s(), i(o(S), {
       key: 1,
       class: "request-card dark-mode"
     }, {
-      default: r(() => [
-        u(o(q), { class: "request-card-simple" }, {
-          default: r(() => [
-            g("div", ne, [
-              u(E, {
+      default: n(() => [
+        r(o(T), { class: "request-card-simple" }, {
+          default: n(() => [
+            b("div", ne, [
+              r(q, {
                 as: "span",
                 class: "request-method",
                 method: e.method
@@ -239,5 +218,5 @@ const le = ["innerHTML"], oe = ["id"], ae = {
   }
 });
 export {
-  Ce as default
+  ge as default
 };

package/dist/v2/blocks/operation-code-sample/helpers/find-client.d.ts

@@ -1,5 +1,5 @@
 import { type AvailableClients } from '@scalar/snippetz';
-import type { ClientOption, ClientOptionGroup } from '../../../../v2/blocks/operation-code-sample/types';
+import type { ClientOption, CustomClientOption, CustomClientOptionGroup } from '../../../../v2/blocks/operation-code-sample/types';
 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];
@@ -37,5 +37,5 @@ export declare const isClient: (id: any) => id is AvailableClients[number];
  * // Returns: { id: 'js/fetch', label: 'Fetch API', lang: 'js' }
  * ```
  */
-export declare const findClient: (clientGroups: ClientOptionGroup[], clientId?: AvailableClients[number] | undefined) => ClientOption | undefined;
+export declare const findClient: (clientGroups: CustomClientOptionGroup[], clientId?: AvailableClients[number] | undefined) => ClientOption | CustomClientOption | undefined;
 //# sourceMappingURL=find-client.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/find-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-client.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/find-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAE9F,eAAO,MAAM,cAAc,eAAe,CAAA;AAE1C,2DAA2D;AAC3D,eAAO,MAAM,QAAQ,GAAI,IAAI,GAAG,KAAG,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAmC,CAAA;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,UAAU,GACrB,cAAc,iBAAiB,EAAE,EACjC,WAAW,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,KAC9C,YAAY,GAAG,SAwBjB,CAAA"}
+{"version":3,"file":"find-client.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/find-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AAExH,eAAO,MAAM,cAAc,eAAe,CAAA;AAE1C,2DAA2D;AAC3D,eAAO,MAAM,QAAQ,GAAI,IAAI,GAAG,KAAG,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAmC,CAAA;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,UAAU,GACrB,cAAc,uBAAuB,EAAE,EACvC,WAAW,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,KAC9C,YAAY,GAAG,kBAAkB,GAAG,SAwBtC,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/generate-client-options.d.ts

@@ -1,20 +1,15 @@
-import type { ApiReferenceConfiguration } from '@scalar/types/api-reference';
+import { type AvailableClients } from '@scalar/snippetz';
 import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation';
 import type { ClientOptionGroup } from '../../../../v2/blocks/operation-code-sample/types';
+/** Type of custom code sample IDs */
+export type CustomCodeSampleId = `custom/${string}`;
 /** Helper to generate an ID for custom code samples */
-export declare const generateCustomId: (example: XCodeSample) => string;
+export declare const generateCustomId: (example: XCodeSample) => CustomCodeSampleId;
 /**
- * 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.
+ * Generate client options for the request example block by filtering by allowed clients
  *
- * 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
+ * @param allowedClients - The list of allowed clients to include in the options
+ * @returns A list of client option groups
  */
-export declare const generateClientOptions: (hiddenClients: ApiReferenceConfiguration["hiddenClients"]) => ClientOptionGroup[];
+export declare const generateClientOptions: (allowedClients?: AvailableClients) => ClientOptionGroup[];
 //# sourceMappingURL=generate-client-options.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/generate-client-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-client-options.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-client-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AAGvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAEhF,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,WAA6B,CAAA;AAElF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,eAAe,yBAAyB,CAAC,eAAe,CAAC,KACxD,iBAAiB,EAwDnB,CAAA"}
+{"version":3,"file":"generate-client-options.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-client-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAY,MAAM,kBAAkB,CAAA;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AAGvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAEhF,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,GAAG,UAAU,MAAM,EAAE,CAAA;AAEnD,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,KAAG,kBAA8C,CAAA;AAEtG;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,iBAAgB,gBAAoC,KAAG,iBAAiB,EAsC7G,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/generate-client-options.js

@@ -1,33 +1,27 @@
-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: 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
+import { AVAILABLE_CLIENTS as o, snippetz as a } from "@scalar/snippetz";
+import { capitalize as c } from "vue";
+const y = (n) => `custom/${n.lang}`, $ = (n = o) => {
+  const s = new Set(n);
+  return a().clients().flatMap((t) => {
+    const l = t.clients.flatMap((e) => {
+      const i = `${t.key}/${e.client}`;
+      return s.has(i) ? {
+        id: i,
+        lang: e.client === "curl" ? "curl" : t.key,
+        title: `${c(t.title)} ${e.title}`,
+        label: e.title,
+        targetKey: t.key,
+        targetTitle: t.title,
+        clientKey: e.client
+      } : [];
+    });
+    return l.length === 0 ? [] : {
+      label: t.title,
+      options: l
     };
   });
-  return n.length === 0 ? [] : {
-    label: e.title,
-    options: n
-  };
-});
+};
 export {
-  m as generateClientOptions,
+  $ as generateClientOptions,
   y as generateCustomId
 };

package/dist/v2/blocks/operation-code-sample/helpers/generate-code-snippet.d.ts

@@ -1,17 +1,28 @@
 import type { HttpMethod } from '@scalar/helpers/http/http-methods';
-import type { AvailableClients } from '@scalar/snippetz';
+import type { AvailableClient } from '@scalar/snippetz';
+import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation';
 import type { OperationObject, SecuritySchemeObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
-type Props = {
-    clientId: AvailableClients[number];
-    operation: OperationObject;
+import { type CustomCodeSampleId } from './generate-client-options.js';
+export type GenerateCodeSnippetProps = {
+    /** The selected client/language for code generation (e.g., 'node/fetch') or a custom code sample ID. */
+    clientId: AvailableClient | CustomCodeSampleId | undefined;
+    /** The Content-Type header value for the request body (e.g., 'application/json'). */
+    contentType?: string | undefined;
+    /** Array of custom code samples defined in the OpenAPI x-codeSamples extension. */
+    customCodeSamples: XCodeSample[];
+    /** The specific example value to use when generating the code snippet. */
     example?: string | undefined;
+    /** The HTTP method for the operation (e.g., GET, POST, PUT). */
     method: HttpMethod;
+    /** The OpenAPI operation object containing request/response details. */
+    operation: OperationObject;
+    /** The API endpoint path (e.g., '/users/{id}'). */
     path: string;
-    contentType?: string | undefined;
-    server?: ServerObject | undefined;
+    /** Array of security schemes to apply to the request (e.g., API keys, OAuth). */
     securitySchemes?: SecuritySchemeObject[] | undefined;
+    /** The server object defining the base URL for the API request. */
+    server?: ServerObject | undefined;
 };
 /** Generate the code snippet for the selected example OR operation */
-export declare const generateCodeSnippet: ({ clientId, operation, method, path, example, contentType, server, securitySchemes, }: Props) => string;
-export {};
+export declare const generateCodeSnippet: ({ clientId, customCodeSamples, operation, method, path, example, contentType, server, securitySchemes, }: GenerateCodeSnippetProps) => string;
 //# sourceMappingURL=generate-code-snippet.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/generate-code-snippet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-code-snippet.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-code-snippet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAA;AAC5E,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACb,MAAM,8DAA8D,CAAA;AAKrE,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAClC,SAAS,EAAE,eAAe,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACjC,eAAe,CAAC,EAAE,oBAAoB,EAAE,GAAG,SAAS,CAAA;CACrD,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,GAAI,uFASjC,KAAK,KAAG,MAyBV,CAAA"}
+{"version":3,"file":"generate-code-snippet.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-code-snippet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,kBAAkB,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AACvF,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACb,MAAM,8DAA8D,CAAA;AAKrE,OAAO,EAAE,KAAK,kBAAkB,EAAoB,MAAM,2BAA2B,CAAA;AAErF,MAAM,MAAM,wBAAwB,GAAG;IACrC,wGAAwG;IACxG,QAAQ,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAA;IAC1D,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,mFAAmF;IACnF,iBAAiB,EAAE,WAAW,EAAE,CAAA;IAChC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gEAAgE;IAChE,MAAM,EAAE,UAAU,CAAA;IAClB,wEAAwE;IACxE,SAAS,EAAE,eAAe,CAAA;IAC1B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,eAAe,CAAC,EAAE,oBAAoB,EAAE,GAAG,SAAS,CAAA;IACpD,mEAAmE;IACnE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAClC,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,GAAI,0GAUjC,wBAAwB,KAAG,MAqC7B,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/generate-code-snippet.js

@@ -1,30 +1,36 @@
-import { operationToHar as m } from "./operation-to-har/operation-to-har.js";
-import { getSnippet as u } from "../../../../views/Components/CodeSnippet/helpers/get-snippet.js";
-const f = ({
-  clientId: t,
-  operation: o,
-  method: n,
-  path: p,
-  example: i,
-  contentType: a,
-  server: s,
-  securitySchemes: c
+import { operationToHar as C } from "./operation-to-har/operation-to-har.js";
+import { getSnippet as y } from "../../../../views/Components/CodeSnippet/helpers/get-snippet.js";
+import { generateCustomId as S } from "./generate-client-options.js";
+const E = ({
+  clientId: e,
+  customCodeSamples: o,
+  operation: n,
+  method: p,
+  path: s,
+  example: a,
+  contentType: i,
+  server: g,
+  securitySchemes: m
 }) => {
   try {
-    const e = m({
-      operation: o,
-      contentType: a,
-      method: n,
-      path: p,
-      server: s,
-      securitySchemes: c,
-      example: i
-    }), [g, d] = t.split("/"), [r, l] = u(g, d, e);
-    return r ? (console.error("[generateCodeSnippet]", r), r.message ?? "Error generating code snippet") : l;
-  } catch (e) {
-    return console.error("[generateCodeSnippet]", e), "Error generating code snippet";
+    if (!e)
+      return "";
+    if (e.startsWith("custom"))
+      return o.find((d) => S(d) === e)?.source ?? "Custom example not found";
+    const r = C({
+      operation: n,
+      contentType: i,
+      method: p,
+      path: s,
+      server: g,
+      securitySchemes: m,
+      example: a
+    }), [u, c] = e.split("/"), [t, f] = y(u, c, r);
+    return t ? (console.error("[generateCodeSnippet]", t), t.message ?? "Error generating code snippet") : f;
+  } catch (r) {
+    return console.error("[generateCodeSnippet]", r), "Error generating code snippet";
   }
 };
 export {
-  f as generateCodeSnippet
+  E as generateCodeSnippet
 };

package/dist/v2/blocks/operation-code-sample/helpers/get-clients.d.ts

@@ -0,0 +1,12 @@
+import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation';
+import type { ClientOptionGroup } from '../../../../v2/blocks/operation-code-sample/index.js';
+import type { CustomClientOptionGroup } from '../../../../v2/blocks/operation-code-sample/types';
+/**
+ * Merges custom code samples with the client options
+ *
+ * @param customCodeSamples - The custom code samples from the operation to merge with the client options
+ * @param clientOptions - The client options to merge with the custom code samples
+ * @returns A list of client option groups
+ */
+export declare const getClients: (customCodeSamples: XCodeSample[], clientOptions: ClientOptionGroup[]) => CustomClientOptionGroup[];
+//# sourceMappingURL=get-clients.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/get-clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-clients.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-clients.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AAEvF,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,mCAAmC,CAAA;AAE9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,mBAAmB,WAAW,EAAE,EAChC,eAAe,iBAAiB,EAAE,KACjC,uBAAuB,EA2BzB,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/get-clients.js

@@ -0,0 +1,20 @@
+import { generateCustomId as i } from "./generate-client-options.js";
+const a = (n, e) => n.length ? [
+  {
+    label: "Code Examples",
+    options: n.map((t) => {
+      const l = i(t), o = t.label || t.lang || l, r = t.lang || "plaintext";
+      return {
+        id: l,
+        lang: r,
+        title: o,
+        label: o,
+        clientKey: "custom"
+      };
+    })
+  },
+  ...e
+] : e;
+export {
+  a as getClients
+};

package/dist/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.d.ts

@@ -0,0 +1,10 @@
+import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation';
+import type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+/**
+ * Grabs any custom code samples from the operation
+ *
+ * @param operation - The operation to get the custom code samples from
+ * @returns An array of custom code samples which exist in the operation
+ */
+export declare const getCustomCodeSamples: (operation: OperationObject) => XCodeSample[];
+//# sourceMappingURL=get-custom-code-samples.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-custom-code-samples.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAA;AAEnG;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,eAAe,KAAG,WAAW,EAG5E,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.js

@@ -0,0 +1,4 @@
+const t = (e) => ["x-custom-examples", "x-codeSamples", "x-code-samples"].flatMap((s) => e[s] ?? []);
+export {
+  t as getCustomCodeSamples
+};

package/dist/v2/blocks/operation-code-sample/helpers/get-example-from-schema.d.ts

@@ -1,4 +1,16 @@
 import type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+type GetExampleFromSchemaOptions = {
+    /** Fallback string for empty string values. */
+    emptyString?: string;
+    /** Whether to use XML tag names as keys. */
+    xml?: boolean;
+    /** Whether to show read-only/write-only properties. */
+    mode?: 'read' | 'write';
+    /** Dynamic variables which can replace values via x-variable. */
+    variables?: Record<string, unknown>;
+    /** Whether to omit empty and optional properties. */
+    omitEmptyAndOptionalProperties?: boolean;
+};
 /**
  * Generate an example value from a given OpenAPI SchemaObject.
  *
@@ -14,21 +26,11 @@ import type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/o
  * @param name - The name of the property being processed.
  * @returns An example value for the given schema.
  */
-export declare const getExampleFromSchema: (schema: SchemaObject, options?: {
-    /** Fallback string for empty string values. */
-    emptyString?: string;
-    /** Whether to use XML tag names as keys. */
-    xml?: boolean;
-    /** Whether to show read-only/write-only properties. */
-    mode?: "read" | "write";
-    /** Dynamic variables which can replace values via x-variable. */
-    variables?: Record<string, unknown>;
-    /** Whether to omit empty and optional properties. */
-    omitEmptyAndOptionalProperties?: boolean;
-}, args?: Partial<{
+export declare const getExampleFromSchema: (schema: SchemaObject, options?: GetExampleFromSchemaOptions, { level, parentSchema, name, seen, }?: Partial<{
     level: number;
     parentSchema: SchemaObject;
     name: string;
     seen: WeakSet<object>;
 }>) => unknown;
+export {};
 //# sourceMappingURL=get-example-from-schema.d.ts.map