@scalar/api-client 3.8.5 → 3.10.0

package/dist/v2/blocks/operation-code-sample/helpers/format-language.js

@@ -0,0 +1,70 @@
+import { capitalize } from "@scalar/helpers/string/capitalize";
+//#region src/v2/blocks/operation-code-sample/helpers/format-language.ts
+/**
+* Display names for the most common languages found in custom code samples.
+*
+* Custom samples (`x-scalar-examples`, `x-readme`, `x-stainless-*`, …) carry a
+* free-form `lang` string that we otherwise show verbatim in the picker. This
+* map gives the common ones a properly cased label (e.g. `typescript` →
+* `TypeScript`). Anything not listed falls back to a simple capitalization.
+*/
+var LANGUAGE_LABELS = {
+	c: "C",
+	clojure: "Clojure",
+	cpp: "C++",
+	"c++": "C++",
+	csharp: "C#",
+	"c#": "C#",
+	css: "CSS",
+	curl: "cURL",
+	dart: "Dart",
+	fsharp: "F#",
+	"f#": "F#",
+	go: "Go",
+	golang: "Go",
+	graphql: "GraphQL",
+	html: "HTML",
+	http: "HTTP",
+	java: "Java",
+	javascript: "JavaScript",
+	js: "JavaScript",
+	json: "JSON",
+	kotlin: "Kotlin",
+	node: "Node.js",
+	nodejs: "Node.js",
+	objc: "Objective-C",
+	"objective-c": "Objective-C",
+	ocaml: "OCaml",
+	php: "PHP",
+	powershell: "PowerShell",
+	py: "Python",
+	python: "Python",
+	r: "R",
+	ruby: "Ruby",
+	rust: "Rust",
+	scala: "Scala",
+	sh: "Shell",
+	shell: "Shell",
+	bash: "Shell",
+	sql: "SQL",
+	swift: "Swift",
+	ts: "TypeScript",
+	typescript: "TypeScript",
+	xml: "XML",
+	yaml: "YAML",
+	yml: "YAML"
+};
+/**
+* Turn a free-form language identifier into a display label for the code sample picker.
+*
+* @param lang - The language identifier from a custom code sample (e.g. `typescript`)
+* @returns A properly cased label (e.g. `TypeScript`), or `undefined` when no language is given
+*/
+var formatLanguage = (lang) => {
+	if (!lang) return;
+	return LANGUAGE_LABELS[lang.toLowerCase()] ?? capitalize(lang);
+};
+//#endregion
+export { formatLanguage };
+
+//# sourceMappingURL=format-language.js.map

package/dist/v2/blocks/operation-code-sample/helpers/format-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-language.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/format-language.ts"],"sourcesContent":["import { capitalize } from '@scalar/helpers/string/capitalize'\n\n/**\n * Display names for the most common languages found in custom code samples.\n *\n * Custom samples (`x-scalar-examples`, `x-readme`, `x-stainless-*`, …) carry a\n * free-form `lang` string that we otherwise show verbatim in the picker. This\n * map gives the common ones a properly cased label (e.g. `typescript` →\n * `TypeScript`). Anything not listed falls back to a simple capitalization.\n */\nconst LANGUAGE_LABELS: Record<string, string> = {\n  c: 'C',\n  clojure: 'Clojure',\n  cpp: 'C++',\n  'c++': 'C++',\n  csharp: 'C#',\n  'c#': 'C#',\n  css: 'CSS',\n  curl: 'cURL',\n  dart: 'Dart',\n  fsharp: 'F#',\n  'f#': 'F#',\n  go: 'Go',\n  golang: 'Go',\n  graphql: 'GraphQL',\n  html: 'HTML',\n  http: 'HTTP',\n  java: 'Java',\n  javascript: 'JavaScript',\n  js: 'JavaScript',\n  json: 'JSON',\n  kotlin: 'Kotlin',\n  node: 'Node.js',\n  nodejs: 'Node.js',\n  objc: 'Objective-C',\n  'objective-c': 'Objective-C',\n  ocaml: 'OCaml',\n  php: 'PHP',\n  powershell: 'PowerShell',\n  py: 'Python',\n  python: 'Python',\n  r: 'R',\n  ruby: 'Ruby',\n  rust: 'Rust',\n  scala: 'Scala',\n  sh: 'Shell',\n  shell: 'Shell',\n  bash: 'Shell',\n  sql: 'SQL',\n  swift: 'Swift',\n  ts: 'TypeScript',\n  typescript: 'TypeScript',\n  xml: 'XML',\n  yaml: 'YAML',\n  yml: 'YAML',\n}\n\n/**\n * Turn a free-form language identifier into a display label for the code sample picker.\n *\n * @param lang - The language identifier from a custom code sample (e.g. `typescript`)\n * @returns A properly cased label (e.g. `TypeScript`), or `undefined` when no language is given\n */\nexport const formatLanguage = (lang?: string): string | undefined => {\n  if (!lang) {\n    return undefined\n  }\n\n  return LANGUAGE_LABELS[lang.toLowerCase()] ?? capitalize(lang)\n}\n"],"mappings":";;;;;;;;;;AAUA,IAAM,kBAA0C;CAC9C,GAAG;CACH,SAAS;CACT,KAAK;CACL,OAAO;CACP,QAAQ;CACR,MAAM;CACN,KAAK;CACL,MAAM;CACN,MAAM;CACN,QAAQ;CACR,MAAM;CACN,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,MAAM;CACN,MAAM;CACN,MAAM;CACN,YAAY;CACZ,IAAI;CACJ,MAAM;CACN,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,MAAM;CACN,eAAe;CACf,OAAO;CACP,KAAK;CACL,YAAY;CACZ,IAAI;CACJ,QAAQ;CACR,GAAG;CACH,MAAM;CACN,MAAM;CACN,OAAO;CACP,IAAI;CACJ,OAAO;CACP,MAAM;CACN,KAAK;CACL,OAAO;CACP,IAAI;CACJ,YAAY;CACZ,KAAK;CACL,MAAM;CACN,KAAK;CACN;;;;;;;AAQD,IAAa,kBAAkB,SAAsC;AACnE,KAAI,CAAC,KACH;AAGF,QAAO,gBAAgB,KAAK,aAAa,KAAK,WAAW,KAAK"}

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

@@ -3,8 +3,23 @@ import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/ope
 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) => CustomCodeSampleId;
+/**
+ * Build stable, language-keyed ids for an operation's custom code samples.
+ *
+ * Custom samples are defined per operation, but a selection (e.g. the Python SDK
+ * example) should sync across every operation that ships the same language. So we
+ * key the id by language rather than by position: the first sample of a language
+ * becomes `custom/<lang>`, and any further samples that repeat a language fall back
+ * to `custom/<lang>/<n>` so they stay individually selectable within the operation.
+ *
+ * The language is lower-cased so a selection still matches when operations (or
+ * extensions) spell the same language with different casing (e.g. `Python` vs
+ * `python`).
+ *
+ * @param samples - The custom code samples for a single operation
+ * @returns A list of ids aligned by index with the input samples
+ */
+export declare const getCustomClientIds: (samples: XCodeSample[]) => CustomCodeSampleId[];
 /**
  * Generate client options for the request example block by filtering by allowed clients
  *

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":"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,EAuC7G,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;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,WAAW,EAAE,KAAG,kBAAkB,EAU7E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,iBAAgB,gBAAoC,KAAG,iBAAiB,EAuC7G,CAAA"}

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

@@ -1,8 +1,31 @@
 import { capitalize } from "vue";
 import { AVAILABLE_CLIENTS, snippetz } from "@scalar/snippetz";
 //#region src/v2/blocks/operation-code-sample/helpers/generate-client-options.ts
-/** Helper to generate an ID for custom code samples */
-var generateCustomId = (example) => `custom/${example.lang}`;
+/**
+* Build stable, language-keyed ids for an operation's custom code samples.
+*
+* Custom samples are defined per operation, but a selection (e.g. the Python SDK
+* example) should sync across every operation that ships the same language. So we
+* key the id by language rather than by position: the first sample of a language
+* becomes `custom/<lang>`, and any further samples that repeat a language fall back
+* to `custom/<lang>/<n>` so they stay individually selectable within the operation.
+*
+* The language is lower-cased so a selection still matches when operations (or
+* extensions) spell the same language with different casing (e.g. `Python` vs
+* `python`).
+*
+* @param samples - The custom code samples for a single operation
+* @returns A list of ids aligned by index with the input samples
+*/
+var getCustomClientIds = (samples) => {
+	const countByLang = /* @__PURE__ */ new Map();
+	return samples.map((sample) => {
+		const lang = (sample.lang || "plaintext").toLowerCase();
+		const seen = countByLang.get(lang) ?? 0;
+		countByLang.set(lang, seen + 1);
+		return seen === 0 ? `custom/${lang}` : `custom/${lang}/${seen}`;
+	});
+};
 /**
 * Generate client options for the request example block by filtering by allowed clients
 *
@@ -35,6 +58,6 @@ var generateClientOptions = (allowedClients = AVAILABLE_CLIENTS) => {
 	});
 };
 //#endregion
-export { generateClientOptions, generateCustomId };
+export { generateClientOptions, getCustomClientIds };
 
 //# sourceMappingURL=generate-client-options.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generate-client-options.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-client-options.ts"],"sourcesContent":["import { AVAILABLE_CLIENTS, type AvailableClients, snippetz } from '@scalar/snippetz'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport { capitalize } from 'vue'\n\nimport type { ClientOptionGroup } from '@/v2/blocks/operation-code-sample/types'\n\n/** Type of custom code sample IDs */\nexport type CustomCodeSampleId = `custom/${string}`\n\n/** Helper to generate an ID for custom code samples */\nexport const generateCustomId = (example: XCodeSample): CustomCodeSampleId => `custom/${example.lang}`\n\n/**\n * Generate client options for the request example block by filtering by allowed clients\n *\n * @param allowedClients - The list of allowed clients to include in the options\n * @returns A list of client option groups\n */\nexport const generateClientOptions = (allowedClients: AvailableClients = AVAILABLE_CLIENTS): ClientOptionGroup[] => {\n  /** Create set of allowlist for quicker lookups */\n  const allowedClientsSet = new Set(allowedClients)\n\n  const options = snippetz()\n    .clients()\n    .flatMap((group) => {\n      const options = group.clients.flatMap((plugin) => {\n        const id = `${group.key}/${plugin.client}` as AvailableClients[number]\n\n        // If the client is not allowed, skip it\n        if (!allowedClientsSet.has(id)) {\n          return []\n        }\n\n        return {\n          id,\n          lang: plugin.client === 'curl' ? ('curl' as const) : group.key,\n          title: `${capitalize(group.title)} ${plugin.title}`,\n          label: plugin.title,\n          targetKey: group.key,\n          targetTitle: group.title,\n          clientKey: plugin.client,\n        }\n      })\n\n      // If no clients are allowed, skip this group\n      if (options.length === 0) {\n        return []\n      }\n\n      return {\n        label: group.title,\n        key: group.key,\n        options,\n      }\n    })\n\n  return options\n}\n"],"mappings":";;;;AAUA,IAAa,oBAAoB,YAA6C,UAAU,QAAQ;;;;;;;AAQhG,IAAa,yBAAyB,iBAAmC,sBAA2C;;CAElH,MAAM,oBAAoB,IAAI,IAAI,eAAe;AAoCjD,QAlCgB,UAAU,CACvB,SAAS,CACT,SAAS,UAAU;EAClB,MAAM,UAAU,MAAM,QAAQ,SAAS,WAAW;GAChD,MAAM,KAAK,GAAG,MAAM,IAAI,GAAG,OAAO;AAGlC,OAAI,CAAC,kBAAkB,IAAI,GAAG,CAC5B,QAAO,EAAE;AAGX,UAAO;IACL;IACA,MAAM,OAAO,WAAW,SAAU,SAAmB,MAAM;IAC3D,OAAO,GAAG,WAAW,MAAM,MAAM,CAAC,GAAG,OAAO;IAC5C,OAAO,OAAO;IACd,WAAW,MAAM;IACjB,aAAa,MAAM;IACnB,WAAW,OAAO;IACnB;IACD;AAGF,MAAI,QAAQ,WAAW,EACrB,QAAO,EAAE;AAGX,SAAO;GACL,OAAO,MAAM;GACb,KAAK,MAAM;GACX;GACD;GACD"}
+{"version":3,"file":"generate-client-options.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-client-options.ts"],"sourcesContent":["import { AVAILABLE_CLIENTS, type AvailableClients, snippetz } from '@scalar/snippetz'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport { capitalize } from 'vue'\n\nimport type { ClientOptionGroup } from '@/v2/blocks/operation-code-sample/types'\n\n/** Type of custom code sample IDs */\nexport type CustomCodeSampleId = `custom/${string}`\n\n/**\n * Build stable, language-keyed ids for an operation's custom code samples.\n *\n * Custom samples are defined per operation, but a selection (e.g. the Python SDK\n * example) should sync across every operation that ships the same language. So we\n * key the id by language rather than by position: the first sample of a language\n * becomes `custom/<lang>`, and any further samples that repeat a language fall back\n * to `custom/<lang>/<n>` so they stay individually selectable within the operation.\n *\n * The language is lower-cased so a selection still matches when operations (or\n * extensions) spell the same language with different casing (e.g. `Python` vs\n * `python`).\n *\n * @param samples - The custom code samples for a single operation\n * @returns A list of ids aligned by index with the input samples\n */\nexport const getCustomClientIds = (samples: XCodeSample[]): CustomCodeSampleId[] => {\n  const countByLang = new Map<string, number>()\n\n  return samples.map((sample): CustomCodeSampleId => {\n    const lang = (sample.lang || 'plaintext').toLowerCase()\n    const seen = countByLang.get(lang) ?? 0\n    countByLang.set(lang, seen + 1)\n\n    return seen === 0 ? `custom/${lang}` : `custom/${lang}/${seen}`\n  })\n}\n\n/**\n * Generate client options for the request example block by filtering by allowed clients\n *\n * @param allowedClients - The list of allowed clients to include in the options\n * @returns A list of client option groups\n */\nexport const generateClientOptions = (allowedClients: AvailableClients = AVAILABLE_CLIENTS): ClientOptionGroup[] => {\n  /** Create set of allowlist for quicker lookups */\n  const allowedClientsSet = new Set(allowedClients)\n\n  const options = snippetz()\n    .clients()\n    .flatMap((group) => {\n      const options = group.clients.flatMap((plugin) => {\n        const id = `${group.key}/${plugin.client}` as AvailableClients[number]\n\n        // If the client is not allowed, skip it\n        if (!allowedClientsSet.has(id)) {\n          return []\n        }\n\n        return {\n          id,\n          lang: plugin.client === 'curl' ? ('curl' as const) : group.key,\n          title: `${capitalize(group.title)} ${plugin.title}`,\n          label: plugin.title,\n          targetKey: group.key,\n          targetTitle: group.title,\n          clientKey: plugin.client,\n        }\n      })\n\n      // If no clients are allowed, skip this group\n      if (options.length === 0) {\n        return []\n      }\n\n      return {\n        label: group.title,\n        key: group.key,\n        options,\n      }\n    })\n\n  return options\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyBA,IAAa,sBAAsB,YAAiD;CAClF,MAAM,8BAAc,IAAI,KAAqB;AAE7C,QAAO,QAAQ,KAAK,WAA+B;EACjD,MAAM,QAAQ,OAAO,QAAQ,aAAa,aAAa;EACvD,MAAM,OAAO,YAAY,IAAI,KAAK,IAAI;AACtC,cAAY,IAAI,MAAM,OAAO,EAAE;AAE/B,SAAO,SAAS,IAAI,UAAU,SAAS,UAAU,KAAK,GAAG;GACzD;;;;;;;;AASJ,IAAa,yBAAyB,iBAAmC,sBAA2C;;CAElH,MAAM,oBAAoB,IAAI,IAAI,eAAe;AAoCjD,QAlCgB,UAAU,CACvB,SAAS,CACT,SAAS,UAAU;EAClB,MAAM,UAAU,MAAM,QAAQ,SAAS,WAAW;GAChD,MAAM,KAAK,GAAG,MAAM,IAAI,GAAG,OAAO;AAGlC,OAAI,CAAC,kBAAkB,IAAI,GAAG,CAC5B,QAAO,EAAE;AAGX,UAAO;IACL;IACA,MAAM,OAAO,WAAW,SAAU,SAAmB,MAAM;IAC3D,OAAO,GAAG,WAAW,MAAM,MAAM,CAAC,GAAG,OAAO;IAC5C,OAAO,OAAO;IACd,WAAW,MAAM;IACjB,aAAa,MAAM;IACnB,WAAW,OAAO;IACnB;IACD;AAGF,MAAI,QAAQ,WAAW,EACrB,QAAO,EAAE;AAGX,SAAO;GACL,OAAO,MAAM;GACb,KAAK,MAAM;GACX;GACD;GACD"}

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,eAAe,EAAsB,MAAM,kBAAkB,CAAA;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAIjH,OAAO,EAAE,KAAK,kBAAkB,EAAoB,MAAM,2BAA2B,CAAA;AAGrF,KAAK,wBAAwB,GAAG;IAC9B,wGAAwG;IACxG,QAAQ,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAA;IAC1D,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,mFAAmF;IACnF,iBAAiB,EAAE,WAAW,EAAE,CAAA;IAChC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,gEAAgE;IAChE,MAAM,EAAE,UAAU,CAAA;IAClB,wEAAwE;IACxE,SAAS,EAAE,eAAe,CAAA;IAC1B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,eAAe,EAAE,0BAA0B,EAAE,CAAA;IAC7C,mEAAmE;IACnE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,qFAAqF;IACrF,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gFAAgF;IAChF,+BAA+B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxD,gDAAgD;IAChD,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,GAAI,4MAcjC,wBAAwB,KAAG,MAyC7B,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,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAIjH,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,2BAA2B,CAAA;AAGvF,KAAK,wBAAwB,GAAG;IAC9B,wGAAwG;IACxG,QAAQ,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAA;IAC1D,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,mFAAmF;IACnF,iBAAiB,EAAE,WAAW,EAAE,CAAA;IAChC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,gEAAgE;IAChE,MAAM,EAAE,UAAU,CAAA;IAClB,wEAAwE;IACxE,SAAS,EAAE,eAAe,CAAA;IAC1B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,eAAe,EAAE,0BAA0B,EAAE,CAAA;IAC7C,mEAAmE;IACnE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,qFAAqF;IACrF,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gFAAgF;IAChF,+BAA+B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxD,gDAAgD;IAChD,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,GAAI,4MAcjC,wBAAwB,KAAG,MAyC7B,CAAA"}

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

@@ -1,12 +1,12 @@
 import { operationToHar } from "./operation-to-har/operation-to-har.js";
-import { generateCustomId } from "./generate-client-options.js";
+import { getCustomClientIds } from "./generate-client-options.js";
 import { getSnippet } from "./get-snippet.js";
 //#region src/v2/blocks/operation-code-sample/helpers/generate-code-snippet.ts
 /** Generate the code snippet for the selected example OR operation */
 var generateCodeSnippet = ({ clientId, customCodeSamples, includeDefaultHeaders = false, operation, method, path, example, contentType, server, securitySchemes, globalCookies, requestBodyCompositionSelection, defaultDisabledParameters }) => {
 	try {
 		if (!clientId) return "";
-		if (clientId.startsWith("custom")) return customCodeSamples.find((example) => generateCustomId(example) === clientId)?.source ?? "Custom example not found";
+		if (clientId.startsWith("custom")) return customCodeSamples[getCustomClientIds(customCodeSamples).indexOf(clientId)]?.source ?? "Custom example not found";
 		const harRequest = operationToHar({
 			operation,
 			contentType,

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

@@ -1 +1 @@
-{"version":3,"file":"generate-code-snippet.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-code-snippet.ts"],"sourcesContent":["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport type { AvailableClient, ClientId, TargetId } from '@scalar/snippetz'\nimport type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example'\nimport type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\nimport { operationToHar } from '@/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har'\n\nimport { type CustomCodeSampleId, generateCustomId } from './generate-client-options'\nimport { getSnippet } from './get-snippet'\n\ntype GenerateCodeSnippetProps = {\n  /** The selected client/language for code generation (e.g., 'node/fetch') or a custom code sample ID. */\n  clientId: AvailableClient | CustomCodeSampleId | undefined\n  /** The Content-Type header value for the request body (e.g., 'application/json'). */\n  contentType: string | undefined\n  /** Array of custom code samples defined in the OpenAPI x-codeSamples extension. */\n  customCodeSamples: XCodeSample[]\n  /** The specific example value to use when generating the code snippet. */\n  example: string | undefined\n  /** The HTTP method for the operation (e.g., GET, POST, PUT). */\n  method: HttpMethod\n  /** The OpenAPI operation object containing request/response details. */\n  operation: OperationObject\n  /** The API endpoint path (e.g., '/users/{id}'). */\n  path: string\n  /** Array of security schemes to apply to the request (e.g., API keys, OAuth). */\n  securitySchemes: SecuritySchemeObjectSecret[]\n  /** The server object defining the base URL for the API request. */\n  server: ServerObject | null\n  /** Workspace + document cookies */\n  globalCookies?: XScalarCookie[]\n  /** Whether to include default headers (e.g., Accept, Content-Type) automatically. */\n  includeDefaultHeaders?: boolean\n  /** Selected oneOf/anyOf variants for nested request body example generation. */\n  requestBodyCompositionSelection?: Record<string, number>\n  /** Whether to disable parameters by default. */\n  defaultDisabledParameters?: boolean\n}\n\n/** Generate the code snippet for the selected example OR operation */\nexport const generateCodeSnippet = ({\n  clientId,\n  customCodeSamples,\n  includeDefaultHeaders = false,\n  operation,\n  method,\n  path,\n  example,\n  contentType,\n  server,\n  securitySchemes,\n  globalCookies,\n  requestBodyCompositionSelection,\n  defaultDisabledParameters,\n}: GenerateCodeSnippetProps): string => {\n  try {\n    if (!clientId) {\n      return ''\n    }\n\n    // Use the selected custom example\n    if (clientId.startsWith('custom')) {\n      return (\n        customCodeSamples.find((example) => generateCustomId(example) === clientId)?.source ??\n        'Custom example not found'\n      )\n    }\n\n    const harRequest = operationToHar({\n      operation,\n      contentType,\n      method,\n      path,\n      server,\n      securitySchemes,\n      example,\n      globalCookies,\n      includeDefaultHeaders,\n      requestBodyCompositionSelection,\n      defaultDisabledParameters,\n    })\n\n    const [targetKey, clientKey] = clientId.split('/') as [TargetId, ClientId<TargetId>]\n\n    const [error, payload] = getSnippet(targetKey, clientKey, harRequest)\n    if (error) {\n      console.error('[generateCodeSnippet]', error)\n      return error.message ?? 'Error generating code snippet'\n    }\n\n    return payload\n  } catch (error) {\n    console.error('[generateCodeSnippet]', error)\n    return 'Error generating code snippet'\n  }\n}\n"],"mappings":";;;;;AA0CA,IAAa,uBAAuB,EAClC,UACA,mBACA,wBAAwB,OACxB,WACA,QACA,MACA,SACA,aACA,QACA,iBACA,eACA,iCACA,gCACsC;AACtC,KAAI;AACF,MAAI,CAAC,SACH,QAAO;AAIT,MAAI,SAAS,WAAW,SAAS,CAC/B,QACE,kBAAkB,MAAM,YAAY,iBAAiB,QAAQ,KAAK,SAAS,EAAE,UAC7E;EAIJ,MAAM,aAAa,eAAe;GAChC;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;EAEF,MAAM,CAAC,WAAW,aAAa,SAAS,MAAM,IAAI;EAElD,MAAM,CAAC,OAAO,WAAW,WAAW,WAAW,WAAW,WAAW;AACrE,MAAI,OAAO;AACT,WAAQ,MAAM,yBAAyB,MAAM;AAC7C,UAAO,MAAM,WAAW;;AAG1B,SAAO;UACA,OAAO;AACd,UAAQ,MAAM,yBAAyB,MAAM;AAC7C,SAAO"}
+{"version":3,"file":"generate-code-snippet.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/generate-code-snippet.ts"],"sourcesContent":["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport type { AvailableClient, ClientId, TargetId } from '@scalar/snippetz'\nimport type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example'\nimport type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\nimport { operationToHar } from '@/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har'\n\nimport { type CustomCodeSampleId, getCustomClientIds } from './generate-client-options'\nimport { getSnippet } from './get-snippet'\n\ntype GenerateCodeSnippetProps = {\n  /** The selected client/language for code generation (e.g., 'node/fetch') or a custom code sample ID. */\n  clientId: AvailableClient | CustomCodeSampleId | undefined\n  /** The Content-Type header value for the request body (e.g., 'application/json'). */\n  contentType: string | undefined\n  /** Array of custom code samples defined in the OpenAPI x-codeSamples extension. */\n  customCodeSamples: XCodeSample[]\n  /** The specific example value to use when generating the code snippet. */\n  example: string | undefined\n  /** The HTTP method for the operation (e.g., GET, POST, PUT). */\n  method: HttpMethod\n  /** The OpenAPI operation object containing request/response details. */\n  operation: OperationObject\n  /** The API endpoint path (e.g., '/users/{id}'). */\n  path: string\n  /** Array of security schemes to apply to the request (e.g., API keys, OAuth). */\n  securitySchemes: SecuritySchemeObjectSecret[]\n  /** The server object defining the base URL for the API request. */\n  server: ServerObject | null\n  /** Workspace + document cookies */\n  globalCookies?: XScalarCookie[]\n  /** Whether to include default headers (e.g., Accept, Content-Type) automatically. */\n  includeDefaultHeaders?: boolean\n  /** Selected oneOf/anyOf variants for nested request body example generation. */\n  requestBodyCompositionSelection?: Record<string, number>\n  /** Whether to disable parameters by default. */\n  defaultDisabledParameters?: boolean\n}\n\n/** Generate the code snippet for the selected example OR operation */\nexport const generateCodeSnippet = ({\n  clientId,\n  customCodeSamples,\n  includeDefaultHeaders = false,\n  operation,\n  method,\n  path,\n  example,\n  contentType,\n  server,\n  securitySchemes,\n  globalCookies,\n  requestBodyCompositionSelection,\n  defaultDisabledParameters,\n}: GenerateCodeSnippetProps): string => {\n  try {\n    if (!clientId) {\n      return ''\n    }\n\n    // Use the selected custom example, matched by its language-keyed id\n    if (clientId.startsWith('custom')) {\n      const ids = getCustomClientIds(customCodeSamples)\n      const index = ids.indexOf(clientId as CustomCodeSampleId)\n\n      return customCodeSamples[index]?.source ?? 'Custom example not found'\n    }\n\n    const harRequest = operationToHar({\n      operation,\n      contentType,\n      method,\n      path,\n      server,\n      securitySchemes,\n      example,\n      globalCookies,\n      includeDefaultHeaders,\n      requestBodyCompositionSelection,\n      defaultDisabledParameters,\n    })\n\n    const [targetKey, clientKey] = clientId.split('/') as [TargetId, ClientId<TargetId>]\n\n    const [error, payload] = getSnippet(targetKey, clientKey, harRequest)\n    if (error) {\n      console.error('[generateCodeSnippet]', error)\n      return error.message ?? 'Error generating code snippet'\n    }\n\n    return payload\n  } catch (error) {\n    console.error('[generateCodeSnippet]', error)\n    return 'Error generating code snippet'\n  }\n}\n"],"mappings":";;;;;AA0CA,IAAa,uBAAuB,EAClC,UACA,mBACA,wBAAwB,OACxB,WACA,QACA,MACA,SACA,aACA,QACA,iBACA,eACA,iCACA,gCACsC;AACtC,KAAI;AACF,MAAI,CAAC,SACH,QAAO;AAIT,MAAI,SAAS,WAAW,SAAS,CAI/B,QAAO,kBAHK,mBAAmB,kBAAkB,CAC/B,QAAQ,SAA+B,GAExB,UAAU;EAG7C,MAAM,aAAa,eAAe;GAChC;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;EAEF,MAAM,CAAC,WAAW,aAAa,SAAS,MAAM,IAAI;EAElD,MAAM,CAAC,OAAO,WAAW,WAAW,WAAW,WAAW,WAAW;AACrE,MAAI,OAAO;AACT,WAAQ,MAAM,yBAAyB,MAAM;AAC7C,UAAO,MAAM,WAAW;;AAG1B,SAAO;UACA,OAAO;AACd,UAAQ,MAAM,yBAAyB,MAAM;AAC7C,SAAO"}

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

@@ -6,7 +6,8 @@ import type { CustomClientOptionGroup } from '../../../../v2/blocks/operation-co
  *
  * @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
+ * @param label - The label for the custom samples group (e.g. "SDK" or "Code Examples")
  * @returns A list of client option groups
  */
-export declare const getClients: (customCodeSamples: XCodeSample[], clientOptions: ClientOptionGroup[]) => CustomClientOptionGroup[];
+export declare const getClients: (customCodeSamples: XCodeSample[], clientOptions: ClientOptionGroup[], label?: string) => CustomClientOptionGroup[];
 //# sourceMappingURL=get-clients.d.ts.map

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

@@ -1 +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,EA4BzB,CAAA"}
+{"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;AAI9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AAEtF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,mBAAmB,WAAW,EAAE,EAChC,eAAe,iBAAiB,EAAE,EAClC,QAAO,MAAkC,KACxC,uBAAuB,EA+BzB,CAAA"}

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

@@ -1,28 +1,34 @@
-import { generateCustomId } from "./generate-client-options.js";
+import { formatLanguage } from "./format-language.js";
+import { getCustomClientIds } from "./generate-client-options.js";
+import { CODE_EXAMPLES_GROUP_LABEL } from "./get-custom-code-samples.js";
 //#region src/v2/blocks/operation-code-sample/helpers/get-clients.ts
 /**
 * 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
+* @param label - The label for the custom samples group (e.g. "SDK" or "Code Examples")
 * @returns A list of client option groups
 */
-var getClients = (customCodeSamples, clientOptions) => {
-	if (customCodeSamples.length) return [{
-		label: "Code Examples",
-		key: "custom",
-		options: customCodeSamples.map((sample) => {
-			const id = generateCustomId(sample);
-			const label = sample.label || sample.lang || id;
-			return {
-				id,
-				lang: sample.lang || "plaintext",
-				title: label,
-				label,
-				clientKey: "custom"
-			};
-		})
-	}, ...clientOptions];
+var getClients = (customCodeSamples, clientOptions, label = CODE_EXAMPLES_GROUP_LABEL) => {
+	if (customCodeSamples.length) {
+		const ids = getCustomClientIds(customCodeSamples);
+		return [{
+			label,
+			key: "custom",
+			options: customCodeSamples.map((sample, index) => {
+				const id = ids[index] ?? `custom/${index}`;
+				const label = sample.label || formatLanguage(sample.lang) || id;
+				return {
+					id,
+					lang: sample.lang || "plaintext",
+					title: label,
+					label,
+					clientKey: "custom"
+				};
+			})
+		}, ...clientOptions];
+	}
 	return clientOptions;
 };
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"get-clients.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-clients.ts"],"sourcesContent":["import type { TargetId } from '@scalar/types/snippetz'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\n\nimport type { ClientOptionGroup, CustomClientOption } from '@/v2/blocks/operation-code-sample'\nimport { generateCustomId } from '@/v2/blocks/operation-code-sample/helpers/generate-client-options'\nimport type { CustomClientOptionGroup } from '@/v2/blocks/operation-code-sample/types'\n\n/**\n * Merges custom code samples with the client options\n *\n * @param customCodeSamples - The custom code samples from the operation to merge with the client options\n * @param clientOptions - The client options to merge with the custom code samples\n * @returns A list of client option groups\n */\nexport const getClients = (\n  customCodeSamples: XCodeSample[],\n  clientOptions: ClientOptionGroup[],\n): CustomClientOptionGroup[] => {\n  // Handle custom code examples\n  if (customCodeSamples.length) {\n    const customClients = customCodeSamples.map((sample) => {\n      const id = generateCustomId(sample)\n      const label = sample.label || sample.lang || id\n      const lang = (sample.lang as TargetId) || 'plaintext'\n\n      return {\n        id,\n        lang,\n        title: label,\n        label,\n        clientKey: 'custom',\n      } satisfies CustomClientOption\n    })\n\n    return [\n      {\n        label: 'Code Examples',\n        key: 'custom',\n        options: customClients,\n      },\n      ...clientOptions,\n    ]\n  }\n\n  return clientOptions\n}\n"],"mappings":";;;;;;;;;AAcA,IAAa,cACX,mBACA,kBAC8B;AAE9B,KAAI,kBAAkB,OAepB,QAAO,CACL;EACE,OAAO;EACP,KAAK;EACL,SAlBkB,kBAAkB,KAAK,WAAW;GACtD,MAAM,KAAK,iBAAiB,OAAO;GACnC,MAAM,QAAQ,OAAO,SAAS,OAAO,QAAQ;AAG7C,UAAO;IACL;IACA,MAJY,OAAO,QAAqB;IAKxC,OAAO;IACP;IACA,WAAW;IACZ;IACD;EAOC,EACD,GAAG,cACJ;AAGH,QAAO"}
+{"version":3,"file":"get-clients.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-clients.ts"],"sourcesContent":["import type { TargetId } from '@scalar/types/snippetz'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\n\nimport type { ClientOptionGroup, CustomClientOption } from '@/v2/blocks/operation-code-sample'\nimport { formatLanguage } from '@/v2/blocks/operation-code-sample/helpers/format-language'\nimport { getCustomClientIds } from '@/v2/blocks/operation-code-sample/helpers/generate-client-options'\nimport { CODE_EXAMPLES_GROUP_LABEL } from '@/v2/blocks/operation-code-sample/helpers/get-custom-code-samples'\nimport type { CustomClientOptionGroup } from '@/v2/blocks/operation-code-sample/types'\n\n/**\n * Merges custom code samples with the client options\n *\n * @param customCodeSamples - The custom code samples from the operation to merge with the client options\n * @param clientOptions - The client options to merge with the custom code samples\n * @param label - The label for the custom samples group (e.g. \"SDK\" or \"Code Examples\")\n * @returns A list of client option groups\n */\nexport const getClients = (\n  customCodeSamples: XCodeSample[],\n  clientOptions: ClientOptionGroup[],\n  label: string = CODE_EXAMPLES_GROUP_LABEL,\n): CustomClientOptionGroup[] => {\n  // Handle custom code examples\n  if (customCodeSamples.length) {\n    // Language-keyed ids so the same sample can be selected across operations\n    const ids = getCustomClientIds(customCodeSamples)\n\n    const customClients = customCodeSamples.map((sample, index) => {\n      const id = ids[index] ?? `custom/${index}`\n      const label = sample.label || formatLanguage(sample.lang) || id\n      const lang = (sample.lang as TargetId) || 'plaintext'\n\n      return {\n        id,\n        lang,\n        title: label,\n        label,\n        clientKey: 'custom',\n      } satisfies CustomClientOption\n    })\n\n    return [\n      {\n        label,\n        key: 'custom',\n        options: customClients,\n      },\n      ...clientOptions,\n    ]\n  }\n\n  return clientOptions\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,IAAa,cACX,mBACA,eACA,QAAgB,8BACc;AAE9B,KAAI,kBAAkB,QAAQ;EAE5B,MAAM,MAAM,mBAAmB,kBAAkB;AAgBjD,SAAO,CACL;GACE;GACA,KAAK;GACL,SAlBkB,kBAAkB,KAAK,QAAQ,UAAU;IAC7D,MAAM,KAAK,IAAI,UAAU,UAAU;IACnC,MAAM,QAAQ,OAAO,SAAS,eAAe,OAAO,KAAK,IAAI;AAG7D,WAAO;KACL;KACA,MAJY,OAAO,QAAqB;KAKxC,OAAO;KACP;KACA,WAAW;KACZ;KACD;GAOC,EACD,GAAG,cACJ;;AAGH,QAAO"}

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

@@ -1,10 +1,45 @@
 import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation';
 import type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+/** Picker group label for samples generated by an SDK provider (Scalar, Stainless, …). */
+declare const SDK_GROUP_LABEL = "SDK";
+/** Picker group label for generic or docs-platform samples (the standard `x-codeSamples` family, ReadMe, …). */
+export declare const CODE_EXAMPLES_GROUP_LABEL = "Code Examples";
+type CustomCodeSampleGroupLabel = typeof SDK_GROUP_LABEL | typeof CODE_EXAMPLES_GROUP_LABEL;
+type CustomCodeSamples = {
+    /**
+     * Group label for the code sample picker.
+     *
+     * Samples that come from an SDK provider extension (`x-scalar-examples`,
+     * `x-stainless-snippets`, `x-stainless-examples`) surface under "SDK". Generic
+     * or docs-platform samples (`x-readme`, the `x-codeSamples` family) surface
+     * under "Code Examples".
+     */
+    label: CustomCodeSampleGroupLabel;
+    /** The custom code samples, in picker order. */
+    samples: XCodeSample[];
+};
 /**
- * Grabs any custom code samples from the operation
+ * Grabs any custom code samples from the operation.
+ *
+ * Several tools write code samples into OpenAPI under different extensions. When
+ * more than one is present we use the highest-priority source only, rather than
+ * showing duplicates from every tool. Priority, highest first:
+ *
+ * 1. `x-scalar-examples` (SDK)
+ * 2. `x-stainless-snippets` (SDK, overrides `x-stainless-examples`)
+ * 3. `x-stainless-examples` (SDK)
+ * 4. `x-readme.code-samples` (Code Examples)
+ * 5. `x-codeSamples` / `x-code-samples` / `x-custom-examples` (Code Examples)
+ *
+ * The winning source also determines the picker group label: SDK-provider
+ * extensions surface under "SDK", everything else under "Code Examples".
+ *
+ * Note that Speakeasy does not have its own extension — it writes into the
+ * standard `x-codeSamples`, so its snippets surface under "Code Examples".
  *
  * @param operation - The operation to get the custom code samples from
- * @returns An array of custom code samples which exist in the operation
+ * @returns The picker group label and the custom code samples which exist in the operation
  */
-export declare const getCustomCodeSamples: (operation: OperationObject) => XCodeSample[];
+export declare const getCustomCodeSamples: (operation: OperationObject) => CustomCodeSamples;
+export {};
 //# sourceMappingURL=get-custom-code-samples.d.ts.map

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

@@ -1 +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"}
+{"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,EACV,WAAW,EAGZ,MAAM,sDAAsD,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAA;AA+BnG,0FAA0F;AAC1F,QAAA,MAAM,eAAe,QAAQ,CAAA;AAE7B,gHAAgH;AAChH,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AAExD,KAAK,0BAA0B,GAAG,OAAO,eAAe,GAAG,OAAO,yBAAyB,CAAA;AAE3F,KAAK,iBAAiB,GAAG;IACvB;;;;;;;OAOG;IACH,KAAK,EAAE,0BAA0B,CAAA;IACjC,gDAAgD;IAChD,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,eAAe,KAAG,iBAuBjE,CAAA"}

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

@@ -1,18 +1,84 @@
 //#region src/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.ts
+/** Turns a `{ language: source }` map (x-stainless-snippets) into code samples. */
+var fromSnippetMap = (snippets, label) => Object.entries(snippets ?? {}).map(([lang, source]) => ({
+	lang,
+	source,
+	...label ? { label } : {}
+}));
 /**
-* Grabs any custom code samples from the operation
+* Turns `x-stainless-examples` / `x-scalar-examples` into code samples.
+*
+* Each example carries per-language request snippets and an optional title that
+* we surface as the picker label. The response is only used for documentation,
+* so it is ignored here.
+*/
+var fromLanguageExamples = (examples) => {
+	if (!examples) return [];
+	return (Array.isArray(examples) ? examples : [examples]).flatMap((example) => fromSnippetMap(example.request, example.title));
+};
+/** Turns ReadMe's `x-readme.code-samples` into code samples. */
+var fromReadmeSamples = (samples) => (samples ?? []).map((sample) => ({
+	lang: sample.language,
+	source: sample.code,
+	...sample.name ? { label: sample.name } : {}
+}));
+/** Picker group label for samples generated by an SDK provider (Scalar, Stainless, …). */
+var SDK_GROUP_LABEL = "SDK";
+/** Picker group label for generic or docs-platform samples (the standard `x-codeSamples` family, ReadMe, …). */
+var CODE_EXAMPLES_GROUP_LABEL = "Code Examples";
+/**
+* Grabs any custom code samples from the operation.
+*
+* Several tools write code samples into OpenAPI under different extensions. When
+* more than one is present we use the highest-priority source only, rather than
+* showing duplicates from every tool. Priority, highest first:
+*
+* 1. `x-scalar-examples` (SDK)
+* 2. `x-stainless-snippets` (SDK, overrides `x-stainless-examples`)
+* 3. `x-stainless-examples` (SDK)
+* 4. `x-readme.code-samples` (Code Examples)
+* 5. `x-codeSamples` / `x-code-samples` / `x-custom-examples` (Code Examples)
+*
+* The winning source also determines the picker group label: SDK-provider
+* extensions surface under "SDK", everything else under "Code Examples".
+*
+* Note that Speakeasy does not have its own extension — it writes into the
+* standard `x-codeSamples`, so its snippets surface under "Code Examples".
 *
 * @param operation - The operation to get the custom code samples from
-* @returns An array of custom code samples which exist in the operation
+* @returns The picker group label and the custom code samples which exist in the operation
 */
 var getCustomCodeSamples = (operation) => {
-	return [
-		"x-custom-examples",
-		"x-codeSamples",
-		"x-code-samples"
-	].flatMap((key) => operation[key] ?? []);
+	const scalarExamples = operation["x-scalar-examples"] ?? [];
+	if (scalarExamples.length) return {
+		label: SDK_GROUP_LABEL,
+		samples: scalarExamples
+	};
+	const stainlessSnippets = fromSnippetMap(operation["x-stainless-snippets"]);
+	if (stainlessSnippets.length) return {
+		label: SDK_GROUP_LABEL,
+		samples: stainlessSnippets
+	};
+	const stainlessExamples = fromLanguageExamples(operation["x-stainless-examples"]);
+	if (stainlessExamples.length) return {
+		label: SDK_GROUP_LABEL,
+		samples: stainlessExamples
+	};
+	const readmeSamples = fromReadmeSamples(operation["x-readme"]?.["code-samples"]);
+	if (readmeSamples.length) return {
+		label: CODE_EXAMPLES_GROUP_LABEL,
+		samples: readmeSamples
+	};
+	return {
+		label: CODE_EXAMPLES_GROUP_LABEL,
+		samples: [
+			"x-custom-examples",
+			"x-codeSamples",
+			"x-code-samples"
+		].flatMap((key) => operation[key] ?? [])
+	};
 };
 //#endregion
-export { getCustomCodeSamples };
+export { CODE_EXAMPLES_GROUP_LABEL, getCustomCodeSamples };
 
 //# sourceMappingURL=get-custom-code-samples.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-custom-code-samples.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.ts"],"sourcesContent":["import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\n/**\n * Grabs any custom code samples from the operation\n *\n * @param operation - The operation to get the custom code samples from\n * @returns An array of custom code samples which exist in the operation\n */\nexport const getCustomCodeSamples = (operation: OperationObject): XCodeSample[] => {\n  const customCodeKeys = ['x-custom-examples', 'x-codeSamples', 'x-code-samples'] as const\n  return customCodeKeys.flatMap((key) => operation[key] ?? [])\n}\n"],"mappings":";;;;;;;AASA,IAAa,wBAAwB,cAA8C;AAEjF,QADuB;EAAC;EAAqB;EAAiB;EAAiB,CACzD,SAAS,QAAQ,UAAU,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"get-custom-code-samples.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.ts"],"sourcesContent":["import type {\n  XCodeSample,\n  XLanguageExample,\n  XReadmeCodeSample,\n} from '@scalar/workspace-store/schemas/extensions/operation'\nimport type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\n/** Turns a `{ language: source }` map (x-stainless-snippets) into code samples. */\nconst fromSnippetMap = (snippets: Record<string, string> | undefined, label?: string): XCodeSample[] =>\n  Object.entries(snippets ?? {}).map(([lang, source]) => ({ lang, source, ...(label ? { label } : {}) }))\n\n/**\n * Turns `x-stainless-examples` / `x-scalar-examples` into code samples.\n *\n * Each example carries per-language request snippets and an optional title that\n * we surface as the picker label. The response is only used for documentation,\n * so it is ignored here.\n */\nconst fromLanguageExamples = (examples: XLanguageExample | XLanguageExample[] | undefined): XCodeSample[] => {\n  if (!examples) {\n    return []\n  }\n\n  return (Array.isArray(examples) ? examples : [examples]).flatMap((example) =>\n    fromSnippetMap(example.request, example.title),\n  )\n}\n\n/** Turns ReadMe's `x-readme.code-samples` into code samples. */\nconst fromReadmeSamples = (samples: XReadmeCodeSample[] | undefined): XCodeSample[] =>\n  (samples ?? []).map((sample) => ({\n    lang: sample.language,\n    source: sample.code,\n    ...(sample.name ? { label: sample.name } : {}),\n  }))\n\n/** Picker group label for samples generated by an SDK provider (Scalar, Stainless, …). */\nconst SDK_GROUP_LABEL = 'SDK'\n\n/** Picker group label for generic or docs-platform samples (the standard `x-codeSamples` family, ReadMe, …). */\nexport const CODE_EXAMPLES_GROUP_LABEL = 'Code Examples'\n\ntype CustomCodeSampleGroupLabel = typeof SDK_GROUP_LABEL | typeof CODE_EXAMPLES_GROUP_LABEL\n\ntype CustomCodeSamples = {\n  /**\n   * Group label for the code sample picker.\n   *\n   * Samples that come from an SDK provider extension (`x-scalar-examples`,\n   * `x-stainless-snippets`, `x-stainless-examples`) surface under \"SDK\". Generic\n   * or docs-platform samples (`x-readme`, the `x-codeSamples` family) surface\n   * under \"Code Examples\".\n   */\n  label: CustomCodeSampleGroupLabel\n  /** The custom code samples, in picker order. */\n  samples: XCodeSample[]\n}\n\n/**\n * Grabs any custom code samples from the operation.\n *\n * Several tools write code samples into OpenAPI under different extensions. When\n * more than one is present we use the highest-priority source only, rather than\n * showing duplicates from every tool. Priority, highest first:\n *\n * 1. `x-scalar-examples` (SDK)\n * 2. `x-stainless-snippets` (SDK, overrides `x-stainless-examples`)\n * 3. `x-stainless-examples` (SDK)\n * 4. `x-readme.code-samples` (Code Examples)\n * 5. `x-codeSamples` / `x-code-samples` / `x-custom-examples` (Code Examples)\n *\n * The winning source also determines the picker group label: SDK-provider\n * extensions surface under \"SDK\", everything else under \"Code Examples\".\n *\n * Note that Speakeasy does not have its own extension — it writes into the\n * standard `x-codeSamples`, so its snippets surface under \"Code Examples\".\n *\n * @param operation - The operation to get the custom code samples from\n * @returns The picker group label and the custom code samples which exist in the operation\n */\nexport const getCustomCodeSamples = (operation: OperationObject): CustomCodeSamples => {\n  const scalarExamples = operation['x-scalar-examples'] ?? []\n  if (scalarExamples.length) {\n    return { label: SDK_GROUP_LABEL, samples: scalarExamples }\n  }\n\n  const stainlessSnippets = fromSnippetMap(operation['x-stainless-snippets'])\n  if (stainlessSnippets.length) {\n    return { label: SDK_GROUP_LABEL, samples: stainlessSnippets }\n  }\n\n  const stainlessExamples = fromLanguageExamples(operation['x-stainless-examples'])\n  if (stainlessExamples.length) {\n    return { label: SDK_GROUP_LABEL, samples: stainlessExamples }\n  }\n\n  const readmeSamples = fromReadmeSamples(operation['x-readme']?.['code-samples'])\n  if (readmeSamples.length) {\n    return { label: CODE_EXAMPLES_GROUP_LABEL, samples: readmeSamples }\n  }\n\n  const customCodeKeys = ['x-custom-examples', 'x-codeSamples', 'x-code-samples'] as const\n  return { label: CODE_EXAMPLES_GROUP_LABEL, samples: customCodeKeys.flatMap((key) => operation[key] ?? []) }\n}\n"],"mappings":";;AAQA,IAAM,kBAAkB,UAA8C,UACpE,OAAO,QAAQ,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,aAAa;CAAE;CAAM;CAAQ,GAAI,QAAQ,EAAE,OAAO,GAAG,EAAE;CAAG,EAAE;;;;;;;;AASzG,IAAM,wBAAwB,aAA+E;AAC3G,KAAI,CAAC,SACH,QAAO,EAAE;AAGX,SAAQ,MAAM,QAAQ,SAAS,GAAG,WAAW,CAAC,SAAS,EAAE,SAAS,YAChE,eAAe,QAAQ,SAAS,QAAQ,MAAM,CAC/C;;;AAIH,IAAM,qBAAqB,aACxB,WAAW,EAAE,EAAE,KAAK,YAAY;CAC/B,MAAM,OAAO;CACb,QAAQ,OAAO;CACf,GAAI,OAAO,OAAO,EAAE,OAAO,OAAO,MAAM,GAAG,EAAE;CAC9C,EAAE;;AAGL,IAAM,kBAAkB;;AAGxB,IAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;AAwCzC,IAAa,wBAAwB,cAAkD;CACrF,MAAM,iBAAiB,UAAU,wBAAwB,EAAE;AAC3D,KAAI,eAAe,OACjB,QAAO;EAAE,OAAO;EAAiB,SAAS;EAAgB;CAG5D,MAAM,oBAAoB,eAAe,UAAU,wBAAwB;AAC3E,KAAI,kBAAkB,OACpB,QAAO;EAAE,OAAO;EAAiB,SAAS;EAAmB;CAG/D,MAAM,oBAAoB,qBAAqB,UAAU,wBAAwB;AACjF,KAAI,kBAAkB,OACpB,QAAO;EAAE,OAAO;EAAiB,SAAS;EAAmB;CAG/D,MAAM,gBAAgB,kBAAkB,UAAU,cAAc,gBAAgB;AAChF,KAAI,cAAc,OAChB,QAAO;EAAE,OAAO;EAA2B,SAAS;EAAe;AAIrE,QAAO;EAAE,OAAO;EAA2B,SADpB;GAAC;GAAqB;GAAiB;GAAiB,CACZ,SAAS,QAAQ,UAAU,QAAQ,EAAE,CAAC;EAAE"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,8DAA8D,CAAA;AAErE,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,KAAK,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,SAAS,GAAG,iCAAiC,CAAC,GAAG;IACjH,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAwOD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,yEAKzB,gBAAgB,KAAG,QAAQ,GAAG,SAyFhC,CAAA"}
+{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,8DAA8D,CAAA;AAErE,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,KAAK,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,SAAS,GAAG,iCAAiC,CAAC,GAAG;IACjH,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAyJD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,yEAKzB,gBAAgB,KAAG,QAAQ,GAAG,SAyFhC,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.js

@@ -1,20 +1,10 @@
 import { getResolvedRefDeep } from "../get-resolved-ref-deep.js";
-import { getExample, getExampleFromSchema, serializeDeepObjectStyle, serializeFormStyle, serializePipeDelimitedStyle, serializeSpaceDelimitedStyle } from "@scalar/workspace-store/request-example";
+import { getExample, getExampleFromSchema, serializeFormPropertyWithEncoding } from "@scalar/workspace-store/request-example";
 import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
 import { json2xml } from "@scalar/helpers/file/json2xml";
 import { unpackProxyObject } from "@scalar/workspace-store/helpers/unpack-proxy";
 //#region src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts
 /**
-* Stringify a value emitted by `serializeFormStyle` into a HAR param value.
-*
-* Form-style serialization only addresses one level of nesting per RFC6570;
-* deeper structures (an object or array still sitting in `entry.value`) are
-* spec-undefined. JSON-stringify them so authors get readable output instead
-* of `String(value)` returning `"[object Object]"`. Primitives pass through
-* `String()` to preserve the existing wire shape (e.g. `true` → `"true"`).
-*/
-var stringifyEntryValue = (value) => value !== null && typeof value === "object" ? JSON.stringify(value) : String(value);
-/**
 * Converts a form-data body into HAR `Param[]` entries for `multipart/form-data`
 * and `application/x-www-form-urlencoded` requests.
 *
@@ -56,83 +46,18 @@ var objectToFormParams = (obj, encoding, parentKey, isMultipart = false) => {
 		*/
 		const explicitContentType = hasFormStyle || !isMultipart ? void 0 : partEncoding?.contentType;
 		/**
-		* Per OpenAPI 3.1.x Encoding Object: when style/explode/allowReserved is set on a
-		* `multipart/form-data` or `application/x-www-form-urlencoded` part, the value is
-		* serialized as if it were a query-style parameter and contentType is ignored. For
-		* multipart the query delimiters are stripped per §Appendix C; HAR represents both
-		* content types via `PostData.params`, so the same shape works for both.
-		*
-		* Primitives skip this branch and fall through to the String(value) path below since
-		* style is a no-op for primitives. Files skip too, as do arrays containing Files —
-		* RFC6570 expansion of binary data is undefined per §Appendix C, and the array branch
-		* below already emits one `@filename` part per File.
-		*
-		* allowReserved only affects percent-encoding, which is a no-op at the HAR layer per
-		* OAS 3.1.2 ("`allowReserved` has no effect" for multipart); its presence still opts
-		* into this branch per spec.
+		* When the encoding sets style/explode/allowReserved, serialize the value RFC6570-style
+		* (bracket/exploded notation) and ignore contentType. See `serializeFormPropertyWithEncoding`
+		* for the per-style rules; it returns null for primitives, Files, and arrays of Files, which
+		* then fall through to the dedicated branches below. HAR represents multipart and urlencoded
+		* the same way via `PostData.params`, so the resulting parts work for both.
 		*/
-		if (!parentKey && hasFormStyle && typeof value === "object" && value !== null && !(value instanceof File) && !(Array.isArray(value) && value.some((item) => item instanceof File))) {
-			const unpacked = unpackProxyObject(value);
-			/**
-			* OAS 3.1.x Encoding Object: encoding follows query-parameter defaults — when no
-			* `style` is set, the default is "form"; when no `explode` is set, the default is
-			* `true` for "form" and `false` for every other style.
-			*/
-			const style = partEncoding?.style ?? "form";
-			const explode = partEncoding?.explode ?? style === "form";
-			if (style === "deepObject") if (Array.isArray(unpacked)) {
-				/**
-				* OAS 3.1.1 marks deepObject-on-array as n/a; fall back to the form/explode:true
-				* shape so the array still reaches the wire instead of being silently dropped.
-				*/
-				const serialized = serializeFormStyle(unpacked, true);
-				if (Array.isArray(serialized)) for (const entry of serialized) params.push({
-					name: entry.key || key,
-					value: stringifyEntryValue(entry.value)
-				});
-				else params.push({
-					name: key,
-					value: String(serialized)
-				});
-			} else
- /**
-			* explode:false with deepObject is undefined per spec; we invoke the serializer
-			* either way so authors get useful output instead of nothing.
-			*/
-			for (const entry of serializeDeepObjectStyle(key, unpacked)) params.push({
-				name: entry.key,
-				value: String(entry.value)
-			});
-			else if (style === "spaceDelimited") params.push({
-				name: key,
-				value: String(serializeSpaceDelimitedStyle(unpacked))
-			});
-			else if (style === "pipeDelimited") params.push({
-				name: key,
-				value: String(serializePipeDelimitedStyle(unpacked))
-			});
-			else {
-				const serialized = serializeFormStyle(unpacked, explode);
-				if (Array.isArray(serialized)) for (const entry of serialized)
- /**
-				* Arrays: entry.key === '' → fall back to the outer name.
-				* Objects: entry.key is the inner property name (spec strips the outer name).
-				*
-				* Nested objects/arrays inside entry.value are spec-undefined (RFC6570 form-style
-				* only addresses one level of nesting); JSON-stringify them instead of letting
-				* String() emit "[object Object]". The escape hatch for cleaner output is
-				* style: deepObject + explode: true.
-				*/
-				params.push({
-					name: entry.key || key,
-					value: stringifyEntryValue(entry.value)
-				});
-				else params.push({
-					name: key,
-					value: String(serialized)
-				});
-			}
-		} else if (value instanceof File) {
+		const styleParams = parentKey ? null : serializeFormPropertyWithEncoding(key, value, partEncoding);
+		if (styleParams) for (const param of styleParams) params.push({
+			name: param.key,
+			value: param.value
+		});
+		else if (value instanceof File) {
 			/**
 			* File values render as `@filename` references, the conventional cURL syntax for an
 			* attached file. Picked up by snippet renderers downstream (e.g. `--form 'x=@file.png'`).