@scalar/blocks 0.1.0

package/dist/code-example/helpers/get-custom-code-samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-custom-code-samples.js","names":[],"sources":["../../../src/code-example/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,KAAkB,GAA8C,MACpE,OAAO,QAAQ,KAAY,EAAE,CAAC,CAAC,KAAK,CAAC,GAAM,QAAa;CAAE;CAAM;CAAQ,GAAI,IAAQ,EAAE,UAAO,GAAG,EAAE;CAAG,EAAE,EASnG,KAAwB,MACvB,KAIG,MAAM,QAAQ,EAAS,GAAG,IAAW,CAAC,EAAS,EAAE,SAAS,MAChE,EAAe,EAAQ,SAAS,EAAQ,MAAM,CAC/C,GALQ,EAAE,EASP,KAAqB,OACxB,KAAW,EAAE,EAAE,KAAK,OAAY;CAC/B,MAAM,EAAO;CACb,QAAQ,EAAO;CACf,GAAI,EAAO,OAAO,EAAE,OAAO,EAAO,MAAM,GAAG,EAAE;CAC9C,EAAE,EAGC,IAAkB,OAGX,IAA4B,iBAwC5B,KAAwB,MAAkD;CACrF,IAAM,IAAiB,EAAU,wBAAwB,EAAE;AAC3D,KAAI,EAAe,OACjB,QAAO;EAAE,OAAO;EAAiB,SAAS;EAAgB;CAG5D,IAAM,IAAoB,EAAe,EAAU,wBAAwB;AAC3E,KAAI,EAAkB,OACpB,QAAO;EAAE,OAAO;EAAiB,SAAS;EAAmB;CAG/D,IAAM,IAAoB,EAAqB,EAAU,wBAAwB;AACjF,KAAI,EAAkB,OACpB,QAAO;EAAE,OAAO;EAAiB,SAAS;EAAmB;CAG/D,IAAM,IAAgB,EAAkB,EAAU,cAAc,gBAAgB;AAMhF,QALI,EAAc,SACT;EAAE,OAAO;EAA2B,SAAS;EAAe,GAI9D;EAAE,OAAO;EAA2B,SADpB;GAAC;GAAqB;GAAiB;GAAiB,CACZ,SAAS,MAAQ,EAAU,MAAQ,EAAE,CAAC;EAAE"}

package/dist/code-example/helpers/get-secrets.d.ts

@@ -0,0 +1,4 @@
+import type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example';
+/** Extract secrets from security schemes */
+export declare const getSecrets: (securitySchemes: SecuritySchemeObjectSecret[]) => string[];
+//# sourceMappingURL=get-secrets.d.ts.map

package/dist/code-example/helpers/get-secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-secrets.d.ts","sourceRoot":"","sources":["../../../src/code-example/helpers/get-secrets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AAGzF,4CAA4C;AAC5C,eAAO,MAAM,UAAU,GAAI,iBAAiB,0BAA0B,EAAE,KAAG,MAAM,EAqB7D,CAAA"}

package/dist/code-example/helpers/get-secrets.js

@@ -0,0 +1,12 @@
+import { encode as e } from "js-base64";
+//#region src/code-example/helpers/get-secrets.ts
+var t = (t) => t.flatMap((t) => t.type === "apiKey" ? t["x-scalar-secret-token"] : t?.type === "http" ? [
+	t["x-scalar-secret-token"],
+	t["x-scalar-secret-username"],
+	t["x-scalar-secret-password"],
+	e(`${t["x-scalar-secret-username"]}:${t["x-scalar-secret-password"]}`)
+] : t.type === "oauth2" ? Object.values(t.flows).map((e) => e["x-scalar-secret-token"]) : []).filter(Boolean);
+//#endregion
+export { t as getSecrets };
+
+//# sourceMappingURL=get-secrets.js.map

package/dist/code-example/helpers/get-secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-secrets.js","names":[],"sources":["../../../src/code-example/helpers/get-secrets.ts"],"sourcesContent":["import type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example'\nimport { encode } from 'js-base64'\n\n/** Extract secrets from security schemes */\nexport const getSecrets = (securitySchemes: SecuritySchemeObjectSecret[]): string[] =>\n  securitySchemes\n    .flatMap((scheme) => {\n      if (scheme.type === 'apiKey') {\n        return scheme['x-scalar-secret-token']\n      }\n      if (scheme?.type === 'http') {\n        return [\n          scheme['x-scalar-secret-token'],\n          scheme['x-scalar-secret-username'],\n          scheme['x-scalar-secret-password'],\n          encode(`${scheme['x-scalar-secret-username']}:${scheme['x-scalar-secret-password']}`),\n        ]\n      }\n      if (scheme.type === 'oauth2') {\n        const flows = Object.values(scheme.flows)\n        return flows.map((flow) => flow['x-scalar-secret-token'])\n      }\n\n      return []\n    })\n    .filter(Boolean)\n"],"mappings":";;AAIA,IAAa,KAAc,MACzB,EACG,SAAS,MACJ,EAAO,SAAS,WACX,EAAO,2BAEZ,GAAQ,SAAS,SACZ;CACL,EAAO;CACP,EAAO;CACP,EAAO;CACP,EAAO,GAAG,EAAO,4BAA4B,GAAG,EAAO,8BAA8B;CACtF,GAEC,EAAO,SAAS,WACJ,OAAO,OAAO,EAAO,MAAM,CAC5B,KAAK,MAAS,EAAK,yBAAyB,GAGpD,EAAE,CACT,CACD,OAAO,QAAQ"}

package/dist/code-example/helpers/get-snippet.d.ts

@@ -0,0 +1,8 @@
+import type { ErrorResponse } from '@scalar/helpers/errors/normalize-error';
+import { type ClientId, type TargetId } from '@scalar/snippetz';
+import type { Request as HarRequest } from 'har-format';
+/**
+ * Returns a code example for given operation
+ */
+export declare const getSnippet: <T extends TargetId>(target: T | "javascript", client: ClientId<T>, harRequest: HarRequest) => ErrorResponse<string>;
+//# sourceMappingURL=get-snippet.d.ts.map

package/dist/code-example/helpers/get-snippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-snippet.d.ts","sourceRoot":"","sources":["../../../src/code-example/helpers/get-snippet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAC3E,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAY,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAKvD;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,QAAQ,EAC3C,QAAQ,CAAC,GAAG,YAAY,EACxB,QAAQ,QAAQ,CAAC,CAAC,CAAC,EACnB,YAAY,UAAU,KACrB,aAAa,CAAC,MAAM,CAyCtB,CAAA"}

package/dist/code-example/helpers/get-snippet.js

@@ -0,0 +1,30 @@
+import { snippetz as e } from "@scalar/snippetz";
+//#region src/code-example/helpers/get-snippet.ts
+var t = "ws://replace.me", n = (n, r, i) => {
+	try {
+		if (!i.url) return [/* @__PURE__ */ Error("Please enter a URL to see a code snippet"), null];
+		let a = i.url.startsWith("/") ? "" : "/";
+		try {
+			new URL(i.url);
+		} catch {
+			i.url = `${t}${a}${i.url}`;
+		}
+		if (i.postData?.mimeType === "application/json") try {
+			JSON.parse(i.postData.text || "{}");
+		} catch (e) {
+			return console.error("[getSnippet] Invalid JSON body", e), [/* @__PURE__ */ Error("Invalid JSON body"), null];
+		}
+		let o = n.replace("javascript", "js");
+		if (e().hasPlugin(o, r)) {
+			let n = e().print(o, r, i);
+			return n ? [null, n.replace(`${t}${a}`, "")] : [/* @__PURE__ */ Error("Error generating snippet"), null];
+		}
+	} catch (e) {
+		return console.error("[getSnippet] Error generating snippet", e), [/* @__PURE__ */ Error("Error generating snippet"), null];
+	}
+	return [/* @__PURE__ */ Error("No snippet found"), null];
+};
+//#endregion
+export { n as getSnippet };
+
+//# sourceMappingURL=get-snippet.js.map

package/dist/code-example/helpers/get-snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-snippet.js","names":[],"sources":["../../../src/code-example/helpers/get-snippet.ts"],"sourcesContent":["import type { ErrorResponse } from '@scalar/helpers/errors/normalize-error'\nimport { type ClientId, type TargetId, snippetz } from '@scalar/snippetz'\nimport type { Request as HarRequest } from 'har-format'\n\n/** Key used to hack around the invalid urls */\nconst INVALID_URLS_PREFIX = 'ws://replace.me'\n\n/**\n * Returns a code example for given operation\n */\nexport const getSnippet = <T extends TargetId>(\n  target: T | 'javascript',\n  client: ClientId<T>,\n  harRequest: HarRequest,\n): ErrorResponse<string> => {\n  try {\n    if (!harRequest.url) {\n      return [new Error('Please enter a URL to see a code snippet'), null]\n    }\n\n    const separator = harRequest.url.startsWith('/') ? '' : '/'\n\n    // Hack to get around invalid URLS until we update the snippets lib\n    try {\n      new URL(harRequest.url)\n    } catch {\n      harRequest.url = `${INVALID_URLS_PREFIX}${separator}${harRequest.url}`\n    }\n\n    // Ensure we have valid JSON\n    if (harRequest.postData?.mimeType === 'application/json') {\n      try {\n        JSON.parse(harRequest.postData.text || '{}')\n      } catch (error) {\n        console.error('[getSnippet] Invalid JSON body', error)\n        return [new Error('Invalid JSON body'), null]\n      }\n    }\n    // TODO: Fix this, use js (instead of javascript) everywhere\n    const snippetzTargetKey = target.replace('javascript', 'js') as TargetId\n\n    if (snippetz().hasPlugin(snippetzTargetKey, client)) {\n      const payload = snippetz().print(snippetzTargetKey, client as ClientId<TargetId>, harRequest)\n      if (!payload) {\n        return [new Error('Error generating snippet'), null]\n      }\n\n      return [null, payload.replace(`${INVALID_URLS_PREFIX}${separator}`, '')]\n    }\n  } catch (error) {\n    console.error('[getSnippet] Error generating snippet', error)\n    return [new Error('Error generating snippet'), null]\n  }\n\n  return [new Error('No snippet found'), null]\n}\n"],"mappings":";;AAKA,IAAM,IAAsB,mBAKf,KACX,GACA,GACA,MAC0B;AAC1B,KAAI;AACF,MAAI,CAAC,EAAW,IACd,QAAO,CAAC,gBAAI,MAAM,2CAA2C,EAAE,KAAK;EAGtE,IAAM,IAAY,EAAW,IAAI,WAAW,IAAI,GAAG,KAAK;AAGxD,MAAI;AACF,OAAI,IAAI,EAAW,IAAI;UACjB;AACN,KAAW,MAAM,GAAG,IAAsB,IAAY,EAAW;;AAInE,MAAI,EAAW,UAAU,aAAa,mBACpC,KAAI;AACF,QAAK,MAAM,EAAW,SAAS,QAAQ,KAAK;WACrC,GAAO;AAEd,UADA,QAAQ,MAAM,kCAAkC,EAAM,EAC/C,CAAC,gBAAI,MAAM,oBAAoB,EAAE,KAAK;;EAIjD,IAAM,IAAoB,EAAO,QAAQ,cAAc,KAAK;AAE5D,MAAI,GAAU,CAAC,UAAU,GAAmB,EAAO,EAAE;GACnD,IAAM,IAAU,GAAU,CAAC,MAAM,GAAmB,GAA8B,EAAW;AAK7F,UAJK,IAIE,CAAC,MAAM,EAAQ,QAAQ,GAAG,IAAsB,KAAa,GAAG,CAAC,GAH/D,CAAC,gBAAI,MAAM,2BAA2B,EAAE,KAAK;;UAKjD,GAAO;AAEd,SADA,QAAQ,MAAM,yCAAyC,EAAM,EACtD,CAAC,gBAAI,MAAM,2BAA2B,EAAE,KAAK;;AAGtD,QAAO,CAAC,gBAAI,MAAM,mBAAmB,EAAE,KAAK"}

package/dist/code-example/helpers/operation-to-har/operation-to-har.d.ts

@@ -0,0 +1,72 @@
+import type { HttpMethod } from '@scalar/helpers/http/http-methods';
+import { type SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example';
+import type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies';
+import type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import type { Request as HarRequest } from 'har-format';
+export type OperationToHarProps = {
+    /** OpenAPI Operation object */
+    operation: OperationObject;
+    /** HTTP method of the operation */
+    method: HttpMethod;
+    /** Path of the operation */
+    path: string;
+    /**
+     * Name of the currently selected operation example
+     *
+     * Applies to both the body and the parameters
+     */
+    example?: string;
+    /**
+     * Content type of the operation
+     *
+     * Applies to both the body and the parameters (if applicable)
+     * @defaults to the first content type in the MediaTypeObject
+     */
+    contentType?: string;
+    /** OpenAPI Server object */
+    server?: ServerObject | null;
+    /** OpenAPI SecurityScheme objects which are applicable to the operation */
+    securitySchemes?: SecuritySchemeObjectSecret[];
+    /** Workspace + document cookies */
+    globalCookies?: XScalarCookie[];
+    /**
+     * Whether to include default headers (e.g., Accept, Content-Type) automatically.
+     * If false, default headers will be omitted from the HAR request.
+     * @default true
+     */
+    includeDefaultHeaders?: boolean;
+    /**
+     * Selected oneOf/anyOf variants for nested request body example generation
+     * (e.g. from the schema dropdowns in the API reference).
+     */
+    requestBodyCompositionSelection?: Record<string, number>;
+    /**
+     * Whether to disable parameters by default.
+     * @default false
+     */
+    defaultDisabledParameters?: boolean;
+};
+/**
+ * Converts an OpenAPI Operation to a HarRequest format for generating HTTP request snippets.
+ *
+ * This function transforms OpenAPI 3.1 operation objects into HAR (HTTP Archive) format requests,
+ * which can be used to generate code snippets for various programming languages and HTTP clients.
+ *
+ * The conversion handles:
+ * - Server URL processing and path parameter substitution
+ * - Query parameter formatting based on OpenAPI parameter styles
+ * - Request body processing with content type handling
+ * - Security scheme integration (API keys, etc.)
+ *
+ * The resulting HarRequest object follows the HAR specification and includes:
+ * - HTTP method and URL
+ * - Headers and query parameters
+ * - Request body (if present)
+ * - Cookie information
+ * - Size calculations for headers and body
+ *
+ * @see https://w3c.github.io/web-performance/specs/HAR/Overview.html
+ * @see https://spec.openapis.org/oas/v3.1.0#operation-object
+ */
+export declare const operationToHar: ({ includeDefaultHeaders, operation, contentType, method, path, server, example, securitySchemes, globalCookies, requestBodyCompositionSelection, defaultDisabledParameters, }: OperationToHarProps) => HarRequest;
+//# sourceMappingURL=operation-to-har.d.ts.map

package/dist/code-example/helpers/operation-to-har/operation-to-har.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-to-har.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/operation-to-har.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,EACL,KAAK,0BAA0B,EAIhC,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AACjH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AASvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,+BAA+B;IAC/B,SAAS,EAAE,eAAe,CAAA;IAC1B,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAClB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC9C,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B;;;OAGG;IACH,+BAA+B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxD;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,+KAY5B,mBAAmB,KAAG,UAwGxB,CAAA"}

package/dist/code-example/helpers/operation-to-har/operation-to-har.js

@@ -0,0 +1,78 @@
+import { APP_VERSION as e } from "../../../constants.js";
+import { processBody as t } from "./process-body.js";
+import { processParameters as n } from "./process-parameters.js";
+import { processSecuritySchemes as r } from "./process-security-schemes.js";
+import { processServerUrl as i } from "./process-server-url.js";
+import { getResolvedRef as a } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { isElectron as o } from "@scalar/helpers/general/is-electron";
+import { filterGlobalCookie as s, getDefaultHeaders as c, restoreConventionalDefaultHeaderNames as l } from "@scalar/workspace-store/request-example";
+//#region src/code-example/helpers/operation-to-har/operation-to-har.ts
+var u = ({ includeDefaultHeaders: u = !1, operation: d, contentType: f, method: p, path: m, server: h = null, example: g, securitySchemes: _, globalCookies: v, requestBodyCompositionSelection: y, defaultDisabledParameters: b = !1 }) => {
+	let x = l(u ? c({
+		method: p,
+		operation: d,
+		exampleName: g ?? "default",
+		hideDisabledHeaders: !0,
+		hideOverriddenHeaders: !0,
+		options: {
+			isElectron: o(),
+			appVersion: e
+		}
+	}) : {}), S = d["x-scalar-disable-parameters"]?.["global-cookies"]?.[g ?? "default"] ?? {}, C = {
+		method: p,
+		url: i(h, m),
+		headers: Object.entries(x).map(([e, t]) => ({
+			name: e,
+			value: t
+		})),
+		queryString: [],
+		postData: void 0,
+		httpVersion: "HTTP/1.1",
+		cookies: [],
+		headersSize: -1,
+		bodySize: -1
+	};
+	if (d.parameters) {
+		let { url: e, headers: t, queryString: r, cookies: i } = n({
+			harRequest: C,
+			parameters: d.parameters,
+			example: g,
+			defaultDisabled: b
+		}), a = v?.filter((t) => s({
+			cookie: t,
+			url: e,
+			disabledGlobalCookies: S
+		}))?.map((e) => ({
+			name: e.name,
+			value: e.value
+		})) ?? [];
+		C.url = e, C.headers = t, C.queryString = r, C.cookies = [...a, ...i];
+	}
+	let w = a(d.requestBody);
+	if (w?.content) {
+		let e = t({
+			requestBody: w,
+			contentType: f,
+			example: g,
+			requestBodyCompositionSelection: y
+		});
+		if (e && (C.postData = e, C.bodySize = e.text?.length ?? -1, e.mimeType)) {
+			let t = C.headers.find((e) => e.name.toLowerCase() === "content-type");
+			t && !t.value ? t.value = e.mimeType : t || C.headers.push({
+				name: "Content-Type",
+				value: e.mimeType
+			});
+		}
+	}
+	if (_) {
+		let { headers: e, queryString: t, cookies: n } = r(_);
+		C.headers.push(...e), C.queryString.push(...t), C.cookies.push(...n);
+	}
+	let T = 0;
+	for (let e of C.headers) T += (e.name?.length ?? 0) + 2 + (e.value?.length ?? 0) + 2;
+	return C.headersSize = T, C;
+};
+//#endregion
+export { u as operationToHar };
+
+//# sourceMappingURL=operation-to-har.js.map

package/dist/code-example/helpers/operation-to-har/operation-to-har.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-to-har.js","names":[],"sources":["../../../../src/code-example/helpers/operation-to-har/operation-to-har.ts"],"sourcesContent":["import { isElectron } from '@scalar/helpers/general/is-electron'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport {\n  type SecuritySchemeObjectSecret,\n  filterGlobalCookie,\n  getDefaultHeaders,\n  restoreConventionalDefaultHeaderNames,\n} from '@scalar/workspace-store/request-example'\nimport type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport type { Request as HarRequest } from 'har-format'\n\nimport { APP_VERSION } from '@/constants'\n\nimport { processBody } from './process-body'\nimport { processParameters } from './process-parameters'\nimport { processSecuritySchemes } from './process-security-schemes'\nimport { processServerUrl } from './process-server-url'\n\nexport type OperationToHarProps = {\n  /** OpenAPI Operation object */\n  operation: OperationObject\n  /** HTTP method of the operation */\n  method: HttpMethod\n  /** Path of the operation */\n  path: string\n  /**\n   * Name of the currently selected operation example\n   *\n   * Applies to both the body and the parameters\n   */\n  example?: string\n  /**\n   * Content type of the operation\n   *\n   * Applies to both the body and the parameters (if applicable)\n   * @defaults to the first content type in the MediaTypeObject\n   */\n  contentType?: string\n  /** OpenAPI Server object */\n  server?: ServerObject | null\n  /** OpenAPI SecurityScheme objects which are applicable to the operation */\n  securitySchemes?: SecuritySchemeObjectSecret[]\n  /** Workspace + document cookies */\n  globalCookies?: XScalarCookie[]\n  /**\n   * Whether to include default headers (e.g., Accept, Content-Type) automatically.\n   * If false, default headers will be omitted from the HAR request.\n   * @default true\n   */\n  includeDefaultHeaders?: boolean\n  /**\n   * Selected oneOf/anyOf variants for nested request body example generation\n   * (e.g. from the schema dropdowns in the API reference).\n   */\n  requestBodyCompositionSelection?: Record<string, number>\n  /**\n   * Whether to disable parameters by default.\n   * @default false\n   */\n  defaultDisabledParameters?: boolean\n}\n\n/**\n * Converts an OpenAPI Operation to a HarRequest format for generating HTTP request snippets.\n *\n * This function transforms OpenAPI 3.1 operation objects into HAR (HTTP Archive) format requests,\n * which can be used to generate code snippets for various programming languages and HTTP clients.\n *\n * The conversion handles:\n * - Server URL processing and path parameter substitution\n * - Query parameter formatting based on OpenAPI parameter styles\n * - Request body processing with content type handling\n * - Security scheme integration (API keys, etc.)\n *\n * The resulting HarRequest object follows the HAR specification and includes:\n * - HTTP method and URL\n * - Headers and query parameters\n * - Request body (if present)\n * - Cookie information\n * - Size calculations for headers and body\n *\n * @see https://w3c.github.io/web-performance/specs/HAR/Overview.html\n * @see https://spec.openapis.org/oas/v3.1.0#operation-object\n */\nexport const operationToHar = ({\n  includeDefaultHeaders = false,\n  operation,\n  contentType,\n  method,\n  path,\n  server = null,\n  example,\n  securitySchemes,\n  globalCookies,\n  requestBodyCompositionSelection,\n  defaultDisabledParameters = false,\n}: OperationToHarProps): HarRequest => {\n  const defaultHeaders = includeDefaultHeaders\n    ? getDefaultHeaders({\n        method,\n        operation,\n        exampleName: example ?? 'default',\n        hideDisabledHeaders: true,\n        hideOverriddenHeaders: true,\n        options: { isElectron: isElectron(), appVersion: APP_VERSION },\n      })\n    : {}\n  const defaultHeadersWithConventionalNames = restoreConventionalDefaultHeaderNames(defaultHeaders)\n\n  const disabledGlobalCookies =\n    operation['x-scalar-disable-parameters']?.['global-cookies']?.[example ?? 'default'] ?? {}\n\n  const serverUrl = processServerUrl(server, path)\n\n  // Initialize the HAR request with basic properties\n  const harRequest: HarRequest = {\n    method,\n    url: serverUrl,\n    headers: Object.entries(defaultHeadersWithConventionalNames).map(([name, value]) => ({ name, value })),\n    queryString: [],\n    postData: undefined,\n    httpVersion: 'HTTP/1.1',\n    cookies: [],\n    headersSize: -1,\n    bodySize: -1,\n  }\n\n  // Handle parameters\n  if (operation.parameters) {\n    const { url, headers, queryString, cookies } = processParameters({\n      harRequest,\n      parameters: operation.parameters,\n      example,\n      defaultDisabled: defaultDisabledParameters,\n    })\n\n    // Correctly filter the global cookies by the processed url\n    const filteredGlobalCookies =\n      globalCookies\n        ?.filter((cookie) => filterGlobalCookie({ cookie, url, disabledGlobalCookies }))\n        ?.map((cookie) => ({ name: cookie.name, value: cookie.value })) ?? []\n\n    harRequest.url = url\n    harRequest.headers = headers\n    harRequest.queryString = queryString\n    harRequest.cookies = [...filteredGlobalCookies, ...cookies]\n  }\n\n  const body = getResolvedRef(operation.requestBody)\n\n  // Handle request body\n  if (body?.content) {\n    const postData = processBody({\n      requestBody: body,\n      contentType,\n      example,\n      requestBodyCompositionSelection,\n    })\n\n    if (postData) {\n      harRequest.postData = postData\n      harRequest.bodySize = postData.text?.length ?? -1\n\n      // Add or update Content-Type header\n      if (postData.mimeType) {\n        const existingContentTypeHeader = harRequest.headers.find(\n          (header) => header.name.toLowerCase() === 'content-type',\n        )\n        // Update existing header if it has an empty value\n        if (existingContentTypeHeader && !existingContentTypeHeader.value) {\n          existingContentTypeHeader.value = postData.mimeType\n        }\n        // Add new header if none exists\n        else if (!existingContentTypeHeader) {\n          harRequest.headers.push({\n            name: 'Content-Type',\n            value: postData.mimeType,\n          })\n        }\n      }\n    }\n  }\n\n  // Handle security schemes\n  if (securitySchemes) {\n    const { headers, queryString, cookies } = processSecuritySchemes(securitySchemes)\n    harRequest.headers.push(...headers)\n    harRequest.queryString.push(...queryString)\n    harRequest.cookies.push(...cookies)\n  }\n\n  // Calculate headers size without allocating a large joined string\n  let headersSize = 0\n  for (const h of harRequest.headers) {\n    // name + \": \" + value + \"\\r\\n\"\n    headersSize += (h.name?.length ?? 0) + 2 + (h.value?.length ?? 0) + 2\n  }\n  harRequest.headersSize = headersSize\n\n  return harRequest\n}\n"],"mappings":";;;;;;;;;AAsFA,IAAa,KAAkB,EAC7B,2BAAwB,IACxB,cACA,gBACA,WACA,SACA,YAAS,MACT,YACA,oBACA,kBACA,oCACA,+BAA4B,SACS;CAWrC,IAAM,IAAsC,EAVrB,IACnB,EAAkB;EAChB;EACA;EACA,aAAa,KAAW;EACxB,qBAAqB;EACrB,uBAAuB;EACvB,SAAS;GAAE,YAAY,GAAY;GAAE,YAAY;GAAa;EAC/D,CAAC,GACF,EAAE,CAC2F,EAE3F,IACJ,EAAU,iCAAiC,oBAAoB,KAAW,cAAc,EAAE,EAKtF,IAAyB;EAC7B;EACA,KALgB,EAAiB,GAAQ,EAAK;EAM9C,SAAS,OAAO,QAAQ,EAAoC,CAAC,KAAK,CAAC,GAAM,QAAY;GAAE;GAAM;GAAO,EAAE;EACtG,aAAa,EAAE;EACf,UAAU,KAAA;EACV,aAAa;EACb,SAAS,EAAE;EACX,aAAa;EACb,UAAU;EACX;AAGD,KAAI,EAAU,YAAY;EACxB,IAAM,EAAE,QAAK,YAAS,gBAAa,eAAY,EAAkB;GAC/D;GACA,YAAY,EAAU;GACtB;GACA,iBAAiB;GAClB,CAAC,EAGI,IACJ,GACI,QAAQ,MAAW,EAAmB;GAAE;GAAQ;GAAK;GAAuB,CAAC,CAAC,EAC9E,KAAK,OAAY;GAAE,MAAM,EAAO;GAAM,OAAO,EAAO;GAAO,EAAE,IAAI,EAAE;AAKzE,EAHA,EAAW,MAAM,GACjB,EAAW,UAAU,GACrB,EAAW,cAAc,GACzB,EAAW,UAAU,CAAC,GAAG,GAAuB,GAAG,EAAQ;;CAG7D,IAAM,IAAO,EAAe,EAAU,YAAY;AAGlD,KAAI,GAAM,SAAS;EACjB,IAAM,IAAW,EAAY;GAC3B,aAAa;GACb;GACA;GACA;GACD,CAAC;AAEF,MAAI,MACF,EAAW,WAAW,GACtB,EAAW,WAAW,EAAS,MAAM,UAAU,IAG3C,EAAS,WAAU;GACrB,IAAM,IAA4B,EAAW,QAAQ,MAClD,MAAW,EAAO,KAAK,aAAa,KAAK,eAC3C;AAED,GAAI,KAA6B,CAAC,EAA0B,QAC1D,EAA0B,QAAQ,EAAS,WAGnC,KACR,EAAW,QAAQ,KAAK;IACtB,MAAM;IACN,OAAO,EAAS;IACjB,CAAC;;;AAOV,KAAI,GAAiB;EACnB,IAAM,EAAE,YAAS,gBAAa,eAAY,EAAuB,EAAgB;AAGjF,EAFA,EAAW,QAAQ,KAAK,GAAG,EAAQ,EACnC,EAAW,YAAY,KAAK,GAAG,EAAY,EAC3C,EAAW,QAAQ,KAAK,GAAG,EAAQ;;CAIrC,IAAI,IAAc;AAClB,MAAK,IAAM,KAAK,EAAW,QAEzB,OAAgB,EAAE,MAAM,UAAU,KAAK,KAAK,EAAE,OAAO,UAAU,KAAK;AAItE,QAFA,EAAW,cAAc,GAElB"}

package/dist/code-example/helpers/operation-to-har/process-body.d.ts

@@ -0,0 +1,13 @@
+import type { RequestBodyObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import type { PostData } from 'har-format';
+import type { OperationToHarProps } from './operation-to-har';
+type ProcessBodyProps = Pick<OperationToHarProps, 'contentType' | 'example' | 'requestBodyCompositionSelection'> & {
+    requestBody: RequestBodyObject;
+};
+/**
+ * Processes the request body and returns the processed data
+ * Returns undefined if no example is found
+ */
+export declare const processBody: ({ requestBody, contentType, example, requestBodyCompositionSelection, }: ProcessBodyProps) => PostData | undefined;
+export {};
+//# sourceMappingURL=process-body.d.ts.map

package/dist/code-example/helpers/operation-to-har/process-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,8DAA8D,CAAA;AACrE,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/code-example/helpers/operation-to-har/process-body.js

@@ -0,0 +1,100 @@
+import { getResolvedRefDeep as e } from "@scalar/workspace-store/helpers/get-resolved-ref-deep";
+import { getResolvedRef as t } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { getExample as n, getExampleFromSchema as r, serializeFormPropertyWithEncoding as i } from "@scalar/workspace-store/request-example";
+import { json2xml as a } from "@scalar/helpers/file/json2xml";
+import { unpackProxyObject as o } from "@scalar/workspace-store/helpers/unpack-proxy";
+//#region src/code-example/helpers/operation-to-har/process-body.ts
+var s = (e, t, n, r = !1) => {
+	let a = [], c = Array.isArray(e) ? e.filter((e) => !e.isDisabled).map((e) => [String(e.name), e.value]) : Object.entries(e);
+	for (let [e, l] of c) {
+		if (l == null) continue;
+		let c = n ? void 0 : t?.[e], u = c && (c.style !== void 0 || c.explode !== void 0 || c.allowReserved !== void 0), d = u || !r ? void 0 : c?.contentType, f = n ? null : i(e, l, c);
+		if (f) for (let e of f) a.push({
+			name: e.key,
+			value: e.value
+		});
+		else if (l instanceof File) {
+			let t = o(l);
+			a.push({
+				name: e,
+				value: `@${t.name}`,
+				...d ? { contentType: d } : {}
+			});
+		} else if (d && typeof l == "object") a.push({
+			name: e,
+			value: JSON.stringify(o(l)),
+			contentType: d
+		});
+		else if (r && !n && !u && typeof l == "object" && !Array.isArray(l)) a.push({
+			name: e,
+			value: JSON.stringify(o(l)),
+			contentType: "application/json"
+		});
+		else if (Array.isArray(l)) for (let t of l) if (t instanceof File) {
+			let n = o(t);
+			a.push({
+				name: e,
+				value: `@${n.name}`
+			});
+		} else r && !n && !u && typeof t == "object" && t ? a.push({
+			name: e,
+			value: JSON.stringify(o(t)),
+			contentType: "application/json"
+		}) : a.push({
+			name: e,
+			value: String(t)
+		});
+		else if (typeof l == "object") {
+			let t = s(l, void 0, e);
+			for (let n of t) a.push({
+				name: `${e}.${n.name}`,
+				value: n.value
+			});
+		} else a.push({
+			name: e,
+			value: String(l),
+			...d ? { contentType: d } : {}
+		});
+	}
+	return a;
+}, c = ({ requestBody: i, contentType: c, example: l, requestBodyCompositionSelection: u }) => {
+	let d = c || Object.keys(i.content)[0] || "", f = d === "other" ? "" : d, p = (e) => `@${o(e).name || "filename"}`, m = i.content[d]?.encoding, h = d === "multipart/form-data" || d === "application/x-www-form-urlencoded", g = d === "application/xml", _ = n(i, l, c)?.value;
+	if (_ !== void 0) {
+		let e = typeof _ == "object" && _ ? o(_) : _;
+		return h && typeof e == "object" && e ? {
+			mimeType: f,
+			params: s(e, m, void 0, d === "multipart/form-data")
+		} : g && typeof e == "object" && e ? {
+			mimeType: f,
+			text: a(e)
+		} : e instanceof File ? {
+			mimeType: f,
+			text: p(e)
+		} : {
+			mimeType: f,
+			text: typeof e == "string" ? e : JSON.stringify(e)
+		};
+	}
+	let v = t(i.content[d]?.schema);
+	if (v !== void 0) {
+		let t = r(e(v), {
+			compositionSelection: u,
+			mode: "write",
+			xml: g
+		}, { schemaPath: ["requestBody"] });
+		if (t !== void 0) return h && typeof t == "object" && t ? {
+			mimeType: f,
+			params: s(t, m, void 0, d === "multipart/form-data")
+		} : g && typeof t == "object" && t ? {
+			mimeType: f,
+			text: a(t)
+		} : {
+			mimeType: f,
+			text: typeof t == "string" ? t : JSON.stringify(t)
+		};
+	}
+};
+//#endregion
+export { c as processBody };
+
+//# sourceMappingURL=process-body.js.map

package/dist/code-example/helpers/operation-to-har/process-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-body.js","names":[],"sources":["../../../../src/code-example/helpers/operation-to-har/process-body.ts"],"sourcesContent":["import { json2xml } from '@scalar/helpers/file/json2xml'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { getResolvedRefDeep } from '@scalar/workspace-store/helpers/get-resolved-ref-deep'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\nimport {\n  getExample,\n  getExampleFromSchema,\n  serializeFormPropertyWithEncoding,\n} from '@scalar/workspace-store/request-example'\nimport type {\n  MediaTypeObject,\n  RequestBodyObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport type { Param, PostData } from 'har-format'\n\nimport type { OperationToHarProps } from './operation-to-har'\n\ntype ProcessBodyProps = Pick<OperationToHarProps, 'contentType' | 'example' | 'requestBodyCompositionSelection'> & {\n  requestBody: RequestBodyObject\n}\n\ntype MultipartEncodingMap = MediaTypeObject['encoding']\n\n/**\n * Converts a form-data body into HAR `Param[]` entries for `multipart/form-data`\n * and `application/x-www-form-urlencoded` requests.\n *\n * Per OpenAPI 3.1.x Encoding Object, each property's serialization is governed\n * by an optional Encoding entry. When `style` / `explode` / `allowReserved` is\n * set, the value is serialized RFC6570-style and `contentType` is ignored.\n * When only `contentType` is set, the property becomes a single part with that\n * type. Otherwise spec defaults apply (object → `application/json` for multipart,\n * primitives → `text/plain`).\n *\n * @param obj - The form-data payload, either an object keyed by property name\n *   or a HAR-style `{ name, value, isDisabled }[]` array.\n * @param encoding - The `encoding` map from the Media Type Object, if any.\n *   Used only at the top level (`parentKey` undefined).\n * @param parentKey - When set, we are flattening a nested object inside another\n *   property; encoding is ignored and keys are joined with `.` (legacy default).\n * @param isMultipart - True for `multipart/form-data`. Gates the spec defaults\n *   for object/array properties that should become a single `application/json`\n *   part. Urlencoded bodies skip those branches and fall through to flattening.\n */\nconst objectToFormParams = (\n  obj: object | { name: string; value: unknown; isDisabled: boolean }[],\n  encoding?: MultipartEncodingMap,\n  parentKey?: string,\n  isMultipart = false,\n): Param[] => {\n  const params: Param[] = []\n\n  /** Ensure we do not include disabled items */\n  const entries: [string, unknown][] = Array.isArray(obj)\n    ? obj.filter((item) => !item.isDisabled).map((item) => [String(item.name), item.value])\n    : Object.entries(obj)\n\n  for (const [key, value] of entries) {\n    if (value === undefined || value === null) {\n      continue\n    }\n\n    const partEncoding = parentKey ? undefined : encoding?.[key]\n    /**\n     * Per OpenAPI 3.1.1: when style, explode, or allowReserved is explicitly set on the\n     * encoding entry, contentType (implicit or explicit) is ignored and the value is\n     * serialized as if it were a query-style parameter.\n     */\n    const hasFormStyle =\n      partEncoding &&\n      (partEncoding.style !== undefined ||\n        partEncoding.explode !== undefined ||\n        partEncoding.allowReserved !== undefined)\n    /**\n     * Per OAS 3.1.x Encoding Object: `contentType` SHALL be ignored if the request body\n     * media type is not a multipart. For `application/x-www-form-urlencoded` we still\n     * honor `style`/`explode`/`allowReserved` (handled above), but a `contentType`-only\n     * entry has no effect — values fall through to the dotted-key flattening default.\n     */\n    const explicitContentType = hasFormStyle || !isMultipart ? undefined : partEncoding?.contentType\n\n    /**\n     * When the encoding sets style/explode/allowReserved, serialize the value RFC6570-style\n     * (bracket/exploded notation) and ignore contentType. See `serializeFormPropertyWithEncoding`\n     * for the per-style rules; it returns null for primitives, Files, and arrays of Files, which\n     * then fall through to the dedicated branches below. HAR represents multipart and urlencoded\n     * the same way via `PostData.params`, so the resulting parts work for both.\n     */\n    const styleParams = parentKey ? null : serializeFormPropertyWithEncoding(key, value, partEncoding)\n    if (styleParams) {\n      for (const param of styleParams) {\n        params.push({ name: param.key, value: param.value })\n      }\n    } else if (value instanceof File) {\n      /**\n       * File values render as `@filename` references, the conventional cURL syntax for an\n       * attached file. Picked up by snippet renderers downstream (e.g. `--form 'x=@file.png'`).\n       */\n      const file = unpackProxyObject(value)\n      params.push({\n        name: key,\n        value: `@${file.name}`,\n        ...(explicitContentType ? { contentType: explicitContentType } : {}),\n      })\n    } else if (explicitContentType && typeof value === 'object') {\n      /**\n       * Per OAS 3.1.x Encoding Object: an explicit `encoding[key].contentType` on a\n       * complex value overrides the default and emits a single part containing the value\n       * JSON-stringified into that media type. Only reachable when style/explode/allowReserved\n       * are unset (otherwise contentType is ignored — see the style branch above).\n       */\n      params.push({\n        name: key,\n        value: JSON.stringify(unpackProxyObject(value)),\n        contentType: explicitContentType,\n      })\n    } else if (isMultipart && !parentKey && !hasFormStyle && typeof value === 'object' && !Array.isArray(value)) {\n      /**\n       * Per OpenAPI 3.x: a top-level multipart property whose value is an object (and not a File)\n       * defaults to a single part encoded as application/json, rather than being flattened\n       * into multiple parts with dotted keys.\n       */\n      params.push({\n        name: key,\n        value: JSON.stringify(unpackProxyObject(value)),\n        contentType: 'application/json',\n      })\n    } else if (Array.isArray(value)) {\n      for (const item of value) {\n        if (item instanceof File) {\n          const file = unpackProxyObject(item)\n          params.push({ name: key, value: `@${file.name}` })\n        } else if (isMultipart && !parentKey && !hasFormStyle && typeof item === 'object' && item !== null) {\n          /**\n           * Per OpenAPI 3.x: a top-level multipart array of complex items defaults each part\n           * to application/json, instead of flattening object items into dotted keys.\n           */\n          params.push({\n            name: key,\n            value: JSON.stringify(unpackProxyObject(item)),\n            contentType: 'application/json',\n          })\n        } else {\n          params.push({ name: key, value: String(item) })\n        }\n      }\n    } else if (typeof value === 'object') {\n      /**\n       * Legacy fallback: flatten nested objects into dotted-key parts. Reached when the\n       * multipart JSON-default branches above don't apply — i.e. either inside a recursive\n       * call (`parentKey` set) or on `application/x-www-form-urlencoded` bodies without an\n       * explicit encoding entry. Strict OAS 3.1.x would use `style: form, explode: true` as\n       * the urlencoded default (inner keys become top-level params); we keep dotted keys for\n       * backwards compatibility with consumers that already parse this shape.\n       */\n      const nestedParams = objectToFormParams(value, undefined, key)\n\n      for (const param of nestedParams) {\n        params.push({ name: `${key}.${param.name}`, value: param.value })\n      }\n    } else {\n      params.push({\n        name: key,\n        value: String(value),\n        ...(explicitContentType ? { contentType: explicitContentType } : {}),\n      })\n    }\n  }\n\n  return params\n}\n\n/**\n * Processes the request body and returns the processed data\n * Returns undefined if no example is found\n */\nexport const processBody = ({\n  requestBody,\n  contentType,\n  example,\n  requestBodyCompositionSelection,\n}: ProcessBodyProps): PostData | undefined => {\n  const _contentType = contentType || Object.keys(requestBody.content)[0] || ''\n  /** Empty when \"Other\" is selected so snippets do not inject `Content-Type: other`. */\n  const harMimeType = _contentType === 'other' ? '' : _contentType\n  const formatBinaryFile = (file: File) => {\n    const unwrappedFile = unpackProxyObject(file)\n    return `@${unwrappedFile.name || 'filename'}`\n  }\n  const encoding = requestBody.content[_contentType]?.encoding\n\n  // Check if this is a form data content type\n  const isFormData = _contentType === 'multipart/form-data' || _contentType === 'application/x-www-form-urlencoded'\n\n  // Check if this is an XML content type\n  const isXml = _contentType === 'application/xml'\n\n  // Get the example value\n  const _example = getExample(requestBody, example, contentType)?.value\n\n  // Return the provided top level example\n  if (typeof _example !== 'undefined') {\n    const exampleValue = _example !== null && typeof _example === 'object' ? unpackProxyObject(_example) : _example\n\n    if (isFormData && typeof exampleValue === 'object' && exampleValue !== null) {\n      return {\n        mimeType: harMimeType,\n        params: objectToFormParams(exampleValue, encoding, undefined, _contentType === 'multipart/form-data'),\n      }\n    }\n\n    if (isXml && typeof exampleValue === 'object' && exampleValue !== null) {\n      return {\n        mimeType: harMimeType,\n        text: json2xml(exampleValue),\n      }\n    }\n\n    if (exampleValue instanceof File) {\n      return {\n        mimeType: harMimeType,\n        text: formatBinaryFile(exampleValue),\n      }\n    }\n\n    return {\n      mimeType: harMimeType,\n      text: typeof exampleValue === 'string' ? exampleValue : JSON.stringify(exampleValue),\n    }\n  }\n\n  // Try to extract examples from the schema\n  const contentSchema = getResolvedRef(requestBody.content[_contentType]?.schema)\n  if (typeof contentSchema !== 'undefined') {\n    const resolvedContentSchema = getResolvedRefDeep(contentSchema) as SchemaObject\n    const extractedExample = getExampleFromSchema(\n      resolvedContentSchema,\n      {\n        compositionSelection: requestBodyCompositionSelection,\n        mode: 'write',\n        xml: isXml,\n      },\n      {\n        schemaPath: ['requestBody'],\n      },\n    )\n\n    if (extractedExample !== undefined) {\n      if (isFormData && typeof extractedExample === 'object' && extractedExample !== null) {\n        return {\n          mimeType: harMimeType,\n          params: objectToFormParams(extractedExample, encoding, undefined, _contentType === 'multipart/form-data'),\n        }\n      }\n\n      if (isXml && typeof extractedExample === 'object' && extractedExample !== null) {\n        return {\n          mimeType: harMimeType,\n          text: json2xml(extractedExample),\n        }\n      }\n\n      return {\n        mimeType: harMimeType,\n        text: typeof extractedExample === 'string' ? extractedExample : JSON.stringify(extractedExample),\n      }\n    }\n  }\n\n  return undefined\n}\n"],"mappings":"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"}

package/dist/code-example/helpers/operation-to-har/process-parameters.d.ts

@@ -0,0 +1,24 @@
+import type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import type { Request as HarRequest } from 'har-format';
+type ProcessedParameters = {
+    url: string;
+    headers: HarRequest['headers'];
+    queryString: HarRequest['queryString'];
+    cookies: HarRequest['cookies'];
+};
+/**
+ * Process OpenAPI parameters and return the updated properties.
+ * Handles path, query, and header parameters with various styles and explode options.
+ *
+ * @see https://spec.openapis.org/oas/latest.html#style-values
+ */
+export declare const processParameters: ({ harRequest, parameters, example, defaultDisabled, }: {
+    harRequest: HarRequest;
+    parameters: OperationObject["parameters"];
+    /** The name of the example to use */
+    example?: string | undefined;
+    /** Whether to disable parameters by default. */
+    defaultDisabled: boolean;
+}) => ProcessedParameters;
+export {};
+//# sourceMappingURL=process-parameters.d.ts.map

package/dist/code-example/helpers/operation-to-har/process-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-parameters.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-parameters.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AACpH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvD,KAAK,mBAAmB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9B,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IACtC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CAC/B,CAAA;AA2FD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,uDAK/B;IACD,UAAU,EAAE,UAAU,CAAA;IACtB,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gDAAgD;IAChD,eAAe,EAAE,OAAO,CAAA;CACzB,KAAG,mBAqIH,CAAA"}

package/dist/code-example/helpers/operation-to-har/process-parameters.js

@@ -0,0 +1,189 @@
+import { getResolvedRef as e } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { deSerializeParameter as t, getExample as n, getExampleFromSchema as r, isParamDisabled as i, serializeContentValue as a, serializeDeepObjectStyle as o, serializeFormStyle as s, serializeFormStyleForCookies as c, serializePipeDelimitedStyle as l, serializeSimpleStyle as u, serializeSpaceDelimitedStyle as d } from "@scalar/workspace-store/request-example";
+//#region src/code-example/helpers/operation-to-har/process-parameters.ts
+var f = (t) => (t ?? []).map((t) => e(t)), p = (e) => "allowReserved" in e && e.allowReserved !== void 0 ? e.allowReserved : "schema" in e && e.schema && typeof e.schema == "object" && "allowReserved" in e.schema ? e.schema.allowReserved === !0 : !1, m = (e, t) => p(t) ? e : encodeURIComponent(e), h = (e) => {
+	if (e.in === "header") return {
+		style: "simple",
+		explode: "explode" in e && e.explode !== void 0 ? e.explode : !1
+	};
+	if (e.in === "cookie") return {
+		style: "form",
+		explode: "explode" in e && e.explode !== void 0 ? e.explode : !0
+	};
+	let t = {
+		path: "simple",
+		query: "form",
+		header: "simple",
+		cookie: "form"
+	}[e.in], n = "style" in e && e.style ? e.style : t;
+	return {
+		style: n,
+		explode: "explode" in e && e.explode !== void 0 ? e.explode : n === "form"
+	};
+}, g = (a, o, s, c) => {
+	let l = n(a, o, s);
+	if (i(a, l, c)) return;
+	if (l?.value !== void 0) return t(l.value, a);
+	if (!("schema" in a) || !a.schema) return;
+	let u = a.in === "path" ? { emptyString: `{${a.name}}` } : {};
+	return r(e(a.schema), u);
+}, _ = ({ harRequest: e, parameters: t, example: n, defaultDisabled: r }) => {
+	let i = [...e.headers], p = [...e.queryString], _ = e.url, y = f(t);
+	for (let t of y) {
+		if (!t.in || !t.name) continue;
+		let f = g(t, n, void 0, r);
+		if (f === void 0) continue;
+		let { style: y, explode: b } = h(t);
+		switch (t.in) {
+			case "path":
+				_ = v(_, t, f, y, b);
+				break;
+			case "query":
+				if ("content" in t && t.content) {
+					let e = a(f, Object.keys(t.content)[0] ?? "application/json");
+					p.push({
+						name: t.name,
+						value: m(e, t)
+					});
+					break;
+				}
+				switch (y) {
+					case "form": {
+						let e = s(f, b);
+						if (Array.isArray(e)) for (let n of e) {
+							let e = n.key || t.name;
+							p.push({
+								name: e,
+								value: m(String(n.value), t)
+							});
+						}
+						else p.push({
+							name: t.name,
+							value: m(String(e), t)
+						});
+						break;
+					}
+					case "spaceDelimited": {
+						let e = d(f);
+						p.push({
+							name: t.name,
+							value: m(e, t)
+						});
+						break;
+					}
+					case "pipeDelimited": {
+						let e = l(f);
+						p.push({
+							name: t.name,
+							value: m(e, t)
+						});
+						break;
+					}
+					case "deepObject":
+						if (Array.isArray(f)) {
+							let e = s(f, !0);
+							if (Array.isArray(e)) for (let n of e) {
+								let e = n.key || t.name;
+								p.push({
+									name: e,
+									value: m(String(n.value), t)
+								});
+							}
+							else p.push({
+								name: t.name,
+								value: m(String(e), t)
+							});
+						} else {
+							let e = o(t.name, f);
+							for (let n of e) p.push({
+								name: n.key,
+								value: m(n.value, t)
+							});
+						}
+						break;
+					default: p.push({
+						name: t.name,
+						value: m(String(f), t)
+					});
+				}
+				break;
+			case "header": {
+				let e = u(f, b);
+				i.push({
+					name: t.name,
+					value: String(e)
+				});
+				break;
+			}
+			case "cookie": {
+				let n = c(f, b);
+				if (Array.isArray(n)) for (let r of n) {
+					let n = r.key || t.name, i = r.value === null ? "null" : String(r.value);
+					e.cookies.push({
+						name: n,
+						value: i
+					});
+				}
+				else {
+					let r = n === null ? "null" : String(n);
+					e.cookies.push({
+						name: t.name,
+						value: r
+					});
+				}
+				break;
+			}
+		}
+	}
+	return {
+		url: _,
+		headers: i,
+		queryString: p,
+		cookies: e.cookies
+	};
+}, v = (e, t, n, r, i) => {
+	switch (r) {
+		case "matrix":
+			if (i) {
+				if (Array.isArray(n)) {
+					let r = n.map((e) => `${t.name}=${e}`).join(";");
+					return e.replace(`{;${t.name}}`, `;${r}`);
+				}
+				if (typeof n == "object" && n) {
+					let r = Object.entries(n).map(([e, t]) => `${e}=${t}`).join(";");
+					return e.replace(`{;${t.name}}`, `;${r}`);
+				}
+				return e.replace(`{;${t.name}}`, `;${t.name}=${n}`);
+			}
+			if (Array.isArray(n)) return e.replace(`{;${t.name}}`, `;${t.name}=${n.join(",")}`);
+			if (typeof n == "object" && n) {
+				let r = Object.entries(n).map(([e, t]) => `${e},${t}`).join(",");
+				return e.replace(`{;${t.name}}`, `;${t.name}=${r}`);
+			}
+			return e.replace(`{;${t.name}}`, `;${t.name}=${n}`);
+		case "label":
+			if (i) {
+				if (Array.isArray(n)) return e.replace(`{.${t.name}}`, `.${n.join(".")}`);
+				if (typeof n == "object" && n) {
+					let r = Object.entries(n).map(([e, t]) => `${e}=${t}`).join(".");
+					return e.replace(`{.${t.name}}`, `.${r}`);
+				}
+				return e.replace(`{.${t.name}}`, `.${n}`);
+			}
+			if (Array.isArray(n)) return e.replace(`{.${t.name}}`, `.${n.join(",")}`);
+			if (typeof n == "object" && n) {
+				let r = Object.entries(n).map(([e, t]) => `${e},${t}`).join(",");
+				return e.replace(`{.${t.name}}`, `.${r}`);
+			}
+			return e.replace(`{.${t.name}}`, `.${n}`);
+		case "simple": {
+			let r = u(n, i);
+			return e.replace(`{${t.name}}`, String(r));
+		}
+		default: return e.replace(`{${t.name}}`, String(n));
+	}
+};
+//#endregion
+export { _ as processParameters };
+
+//# sourceMappingURL=process-parameters.js.map