@scalar/blocks 0.1.20 → 0.3.0

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

@@ -1,18 +1,20 @@
 import { getResolvedRefDeep as e } from "@scalar/workspace-store/helpers/get-resolved-ref-deep";
 import { getResolvedRef as t, mergeSiblingReferences as n } from "@scalar/workspace-store/helpers/get-resolved-ref";
-import { coerceLeafValueToSchemaType as r, getExample as i, getExampleFromSchema as a, resolveLeafSchema as o, serializeFormPropertyWithEncoding as s, serializeMultipartArray as c } from "@scalar/workspace-store/request-example";
-import { json2xml as l } from "@scalar/helpers/file/json2xml";
-import { unpackProxyObject as u } from "@scalar/workspace-store/helpers/unpack-proxy";
+import { buildRequestBody as r, coerceLeafValueToSchemaType as i, getExample as a, getExampleFromSchema as o, needsMultipartEncoding as s, resolveLeafSchema as c, serializeFormPropertyWithEncoding as l, serializeMultipartArray as u, serializeMultipartBody as d } from "@scalar/workspace-store/request-example";
+import { json2xml as f } from "@scalar/helpers/file/json2xml";
+import { getExampleValue as p, getExplicitExampleText as m } from "@scalar/workspace-store/helpers/get-example-value";
+import { serializeStreamExample as h } from "@scalar/workspace-store/helpers/serialize-stream-example";
+import { unpackProxyObject as g } from "@scalar/workspace-store/helpers/unpack-proxy";
 //#region src/code-example/helpers/operation-to-har/process-body.ts
-var d = (e, t, n, i = !1, a) => {
-	let l = [], f = Array.isArray(e) ? e.filter((e) => !e.isDisabled).map((e) => [String(e.name), e.value]) : Object.entries(e);
-	for (let [p, m] of f) {
-		if (m == null) continue;
-		let f = n ? void 0 : t?.[p];
-		if (i && !n) {
-			let t = Array.isArray(e) ? r(m, o(a, [p])) : m, n = c(p, Array.isArray(t) ? t : m, f);
+var _ = (e, t, n, r = !1, a) => {
+	let o = [], s = Array.isArray(e) ? e.filter((e) => !e.isDisabled).map((e) => [String(e.name), e.value]) : Object.entries(e);
+	for (let [d, f] of s) {
+		if (f == null) continue;
+		let s = n ? void 0 : t?.[d];
+		if (r && !n) {
+			let t = Array.isArray(e) ? i(f, c(a, [d])) : f, n = u(d, Array.isArray(t) ? t : f, s);
 			if (n) {
-				for (let e of n) l.push({
+				for (let e of n) o.push({
 					name: e.key,
 					value: e.value instanceof File ? `@${e.value.name}` : e.value,
 					...e.contentType ? { contentType: e.contentType } : {}
@@ -20,89 +22,108 @@ var d = (e, t, n, i = !1, a) => {
 				continue;
 			}
 		}
-		let h = f && (f.style !== void 0 || f.explode !== void 0 || f.allowReserved !== void 0), g = h || !i ? void 0 : f?.contentType, _ = n ? null : s(p, m, f);
-		if (_) for (let e of _) l.push({
+		let p = s && (s.style !== void 0 || s.explode !== void 0 || s.allowReserved !== void 0), m = p || !r ? void 0 : s?.contentType, h = n ? null : l(d, f, s);
+		if (h) for (let e of h) o.push({
 			name: e.key,
 			value: e.value
 		});
-		else if (m instanceof File) {
-			let e = u(m);
-			l.push({
-				name: p,
+		else if (f instanceof File) {
+			let e = g(f);
+			o.push({
+				name: d,
 				value: `@${e.name}`,
-				...g ? { contentType: g } : {}
+				...m ? { contentType: m } : {}
 			});
-		} else if (g && typeof m == "object") l.push({
-			name: p,
-			value: JSON.stringify(u(m)),
-			contentType: g
+		} else if (m && typeof f == "object") o.push({
+			name: d,
+			value: JSON.stringify(g(f)),
+			contentType: m
 		});
-		else if (i && !n && !h && typeof m == "object" && !Array.isArray(m)) l.push({
-			name: p,
-			value: JSON.stringify(u(m)),
+		else if (r && !n && !p && typeof f == "object" && !Array.isArray(f)) o.push({
+			name: d,
+			value: JSON.stringify(g(f)),
 			contentType: "application/json"
 		});
-		else if (Array.isArray(m)) for (let e of m) if (e instanceof File) {
-			let t = u(e);
-			l.push({
-				name: p,
+		else if (Array.isArray(f)) for (let e of f) if (e instanceof File) {
+			let t = g(e);
+			o.push({
+				name: d,
 				value: `@${t.name}`
 			});
-		} else l.push({
-			name: p,
+		} else o.push({
+			name: d,
 			value: String(e)
 		});
-		else if (typeof m == "object") {
-			let e = d(m, void 0, p);
-			for (let t of e) l.push({
-				name: `${p}.${t.name}`,
+		else if (typeof f == "object") {
+			let e = _(f, void 0, d);
+			for (let t of e) o.push({
+				name: `${d}.${t.name}`,
 				value: t.value
 			});
-		} else l.push({
-			name: p,
-			value: String(m),
-			...g ? { contentType: g } : {}
+		} else o.push({
+			name: d,
+			value: String(f),
+			...m ? { contentType: m } : {}
 		});
 	}
-	return l;
-}, f = ({ requestBody: r, contentType: o, example: s, requestBodyCompositionSelection: c }) => {
-	let f = o || Object.keys(r.content)[0] || "", p = f === "other" ? "" : f, m = (e) => `@${u(e).name || "filename"}`, h = r.content[f]?.encoding, g = f === "multipart/form-data" || f === "application/x-www-form-urlencoded", _ = f === "application/xml", v = i(r, s, o)?.value;
-	if (v !== void 0) {
-		let e = typeof v == "object" && v ? u(v) : v;
-		return g && typeof e == "object" && e ? {
-			mimeType: p,
-			params: d(e, h, void 0, f === "multipart/form-data", t(r.content[f]?.schema, n))
-		} : _ && typeof e == "object" && e ? {
-			mimeType: p,
-			text: l(e)
+	return o;
+}, v = ({ requestBody: i, contentType: c, example: l, requestBodyCompositionSelection: u }) => {
+	let v = c || Object.keys(i.content)[0] || "", y = v === "other" ? "" : v, b = (e) => `@${g(e).name || "filename"}`, x = i.content[v]?.encoding, S = i.content[v];
+	if (S && s(v, S)) {
+		let e = l ?? Object.keys(S.examples ?? {})[0] ?? "default", t = r({
+			...i,
+			"x-scalar-selected-content-type": { [e]: v }
+		}, e, u);
+		if (t?.mode === "multipart") {
+			let e = d(t.value, t.contentType);
+			return {
+				mimeType: e.contentType,
+				text: e.chunks.map((e) => e instanceof File ? b(e) : e instanceof Blob ? "BINARY" : String(e)).join("")
+			};
+		}
+	}
+	let C = v === "multipart/form-data" || v === "application/x-www-form-urlencoded", w = v === "application/xml", T = p(a(i, l, c)), E = m(T, v);
+	if (E !== void 0) return {
+		mimeType: y,
+		text: E
+	};
+	let D = T?.value;
+	if (D !== void 0) {
+		let e = typeof D == "object" && D ? g(D) : D;
+		return C && typeof e == "object" && e ? {
+			mimeType: y,
+			params: _(e, x, void 0, v === "multipart/form-data", t(i.content[v]?.schema, n))
+		} : w && typeof e == "object" && e ? {
+			mimeType: y,
+			text: f(e)
 		} : e instanceof File ? {
-			mimeType: p,
-			text: m(e)
+			mimeType: y,
+			text: b(e)
 		} : {
-			mimeType: p,
-			text: typeof e == "string" ? e : JSON.stringify(e)
+			mimeType: y,
+			text: typeof e == "string" ? e : h(e, v, !1) ?? JSON.stringify(e)
 		};
 	}
-	let y = t(r.content[f]?.schema);
-	if (y !== void 0) {
-		let t = a(e(y), {
-			compositionSelection: c,
+	let O = i.content[v], k = t(O?.schema ?? O?.itemSchema);
+	if (k !== void 0) {
+		let t = o(e(k), {
+			compositionSelection: u,
 			mode: "write",
-			xml: _
+			xml: w
 		}, { schemaPath: ["requestBody"] });
-		if (t !== void 0) return g && typeof t == "object" && t ? {
-			mimeType: p,
-			params: d(t, h, void 0, f === "multipart/form-data")
-		} : _ && typeof t == "object" && t ? {
-			mimeType: p,
-			text: l(t)
+		if (t !== void 0) return C && typeof t == "object" && t ? {
+			mimeType: y,
+			params: _(t, x, void 0, v === "multipart/form-data")
+		} : w && typeof t == "object" && t ? {
+			mimeType: y,
+			text: f(t)
 		} : {
-			mimeType: p,
-			text: typeof t == "string" ? t : JSON.stringify(t)
+			mimeType: y,
+			text: h(t, v, O?.schema === void 0) ?? (typeof t == "string" ? t : JSON.stringify(t))
 		};
 	}
 };
 //#endregion
-export { f as processBody };
+export { v as processBody };
 
 //# sourceMappingURL=process-body.js.map

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

@@ -1 +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, mergeSiblingReferences } 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  coerceLeafValueToSchemaType,\n  getExample,\n  getExampleFromSchema,\n  resolveLeafSchema,\n  serializeFormPropertyWithEncoding,\n  serializeMultipartArray,\n} from '@scalar/workspace-store/request-example'\nimport type {\n  MediaTypeObject,\n  RequestBodyObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.2/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 * Multipart arrays apply the encoding to each item and repeat the property name.\n * Object items default to JSON, and uploaded files retain their filename references.\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 properties and array items. Urlencoded bodies retain their existing\n *   serialization and flattening behavior.\n */\nconst objectToFormParams = (\n  obj: object | { name: string; value: unknown; isDisabled: boolean }[],\n  encoding?: MultipartEncodingMap,\n  parentKey?: string,\n  isMultipart = false,\n  schema?: SchemaObject,\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    if (isMultipart && !parentKey) {\n      const restored = Array.isArray(obj) ? coerceLeafValueToSchemaType(value, resolveLeafSchema(schema, [key])) : value\n      const arrayParts = serializeMultipartArray(key, Array.isArray(restored) ? restored : value, partEncoding)\n      if (arrayParts) {\n        for (const part of arrayParts) {\n          params.push({\n            name: part.key,\n            value: part.value instanceof File ? `@${part.value.name}` : part.value,\n            ...(part.contentType ? { contentType: part.contentType } : {}),\n          })\n        }\n        continue\n      }\n    }\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 {\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(\n          exampleValue,\n          encoding,\n          undefined,\n          _contentType === 'multipart/form-data',\n          getResolvedRef(requestBody.content[_contentType]?.schema, mergeSiblingReferences),\n        ),\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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"}
+{"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 { getExampleValue, getExplicitExampleText } from '@scalar/workspace-store/helpers/get-example-value'\nimport { getResolvedRef, mergeSiblingReferences } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { getResolvedRefDeep } from '@scalar/workspace-store/helpers/get-resolved-ref-deep'\nimport { serializeStreamExample } from '@scalar/workspace-store/helpers/serialize-stream-example'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\nimport {\n  buildRequestBody,\n  coerceLeafValueToSchemaType,\n  getExample,\n  getExampleFromSchema,\n  needsMultipartEncoding,\n  resolveLeafSchema,\n  serializeFormPropertyWithEncoding,\n  serializeMultipartArray,\n  serializeMultipartBody,\n} from '@scalar/workspace-store/request-example'\nimport type {\n  MediaTypeObject,\n  RequestBodyObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.2/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 * Multipart arrays apply the encoding to each item and repeat the property name.\n * Object items default to JSON, and uploaded files retain their filename references.\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 properties and array items. Urlencoded bodies retain their existing\n *   serialization and flattening behavior.\n */\nconst objectToFormParams = (\n  obj: object | { name: string; value: unknown; isDisabled: boolean }[],\n  encoding?: MultipartEncodingMap,\n  parentKey?: string,\n  isMultipart = false,\n  schema?: SchemaObject,\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    if (isMultipart && !parentKey) {\n      const restored = Array.isArray(obj) ? coerceLeafValueToSchemaType(value, resolveLeafSchema(schema, [key])) : value\n      const arrayParts = serializeMultipartArray(key, Array.isArray(restored) ? restored : value, partEncoding)\n      if (arrayParts) {\n        for (const part of arrayParts) {\n          params.push({\n            name: part.key,\n            value: part.value instanceof File ? `@${part.value.name}` : part.value,\n            ...(part.contentType ? { contentType: part.contentType } : {}),\n          })\n        }\n        continue\n      }\n    }\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 {\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  const media = requestBody.content[_contentType]\n  if (media && needsMultipartEncoding(_contentType, media)) {\n    const exampleName = example ?? Object.keys(media.examples ?? {})[0] ?? 'default'\n    const body = buildRequestBody(\n      { ...requestBody, 'x-scalar-selected-content-type': { [exampleName]: _contentType } },\n      exampleName,\n      requestBodyCompositionSelection,\n    )\n    if (body?.mode === 'multipart') {\n      const encoded = serializeMultipartBody(body.value, body.contentType)\n      return {\n        mimeType: encoded.contentType,\n        // HAR text cannot embed file bytes synchronously. Keep visible file placeholders.\n        text: encoded.chunks\n          .map((chunk) =>\n            chunk instanceof File ? formatBinaryFile(chunk) : chunk instanceof Blob ? 'BINARY' : String(chunk),\n          )\n          .join(''),\n      }\n    }\n  }\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 selected = getExampleValue(getExample(requestBody, example, contentType))\n  const explicitText = getExplicitExampleText(selected, _contentType)\n  if (explicitText !== undefined) {\n    return { mimeType: harMimeType, text: explicitText }\n  }\n  const _example = selected?.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(\n          exampleValue,\n          encoding,\n          undefined,\n          _contentType === 'multipart/form-data',\n          getResolvedRef(requestBody.content[_contentType]?.schema, mergeSiblingReferences),\n        ),\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:\n        typeof exampleValue === 'string'\n          ? exampleValue\n          : (serializeStreamExample(exampleValue, _contentType, false) ?? JSON.stringify(exampleValue)),\n    }\n  }\n\n  // Try to extract examples from the schema\n  const mediaType = requestBody.content[_contentType]\n  const contentSchema = getResolvedRef(mediaType?.schema ?? mediaType?.itemSchema)\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:\n          serializeStreamExample(extractedExample, _contentType, mediaType?.schema === undefined) ??\n          (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

@@ -1,10 +1,14 @@
 import type { OperationObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document';
 import type { Request as HarRequest } from 'har-format';
 type ProcessedParameters = {
+    /** Named serialized examples already embedded in the URL. */
+    hasSerializedQuery?: boolean;
     url: string;
     headers: HarRequest['headers'];
     queryString: HarRequest['queryString'];
     cookies: HarRequest['cookies'];
+    /** Whether serialized cookie-style values require a complete Cookie header. */
+    hasCookieStyleEntries: boolean;
 };
 /**
  * Process OpenAPI parameters and return the updated properties.

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

@@ -1 +1 @@
-{"version":3,"file":"process-parameters.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-parameters.ts"],"names":[],"mappings":"AAeA,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;AAiGD;;;;;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,mBAyIH,CAAA"}
+{"version":3,"file":"process-parameters.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-parameters.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AACpH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvD,KAAK,mBAAmB,GAAG;IACzB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,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;IAC9B,+EAA+E;IAC/E,qBAAqB,EAAE,OAAO,CAAA;CAC/B,CAAA;AAyFD;;;;;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,mBA0NH,CAAA"}

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

@@ -1,149 +1,235 @@
 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";
+import { deSerializeParameter as t, getExampleFromSchema as n, isParamDisabled as r, serializeContentValue as i, serializeCookieStyle 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";
 import { isObjectLike as f } from "@scalar/helpers/object/is-object";
+import { getParameterExample as p } from "@scalar/workspace-store/helpers/get-parameter-example";
+import { getQuerystringParameter as m, serializeQuerystringParameter as h } from "@scalar/workspace-store/helpers/querystring-parameter";
 //#region src/code-example/helpers/operation-to-har/process-parameters.ts
-var p = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), m = (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, h = (e, t) => m(t) ? e : encodeURIComponent(e), g = (e) => {
+var g = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), _ = (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, v = (e, t) => _(t) ? e : encodeURIComponent(e), y = (e) => {
 	if (e.in === "header") return {
 		style: "simple",
 		explode: "explode" in e && e.explode !== void 0 && e.explode
 	};
-	if (e.in === "cookie") return {
-		style: "form",
-		explode: "explode" in e && e.explode !== void 0 ? e.explode : !0
-	};
+	if (e.in === "cookie") {
+		let t = "explode" in e && e.explode !== void 0 ? e.explode : !0;
+		return {
+			style: "style" in e && e.style === "cookie" ? "cookie" : "form",
+			explode: t
+		};
+	}
 	let t = {
 		path: "simple",
 		query: "form",
+		querystring: "form",
 		header: "simple",
 		cookie: "form"
-	}[e.in] ?? "form", n = "style" in e && e.style ? e.style : t;
+	}[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"
 	};
-}, _ = (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}}` } : {}, d = e(a.schema);
-	return d ? r(d, u) : void 0;
-}, v = ({ harRequest: e, parameters: t, example: n, defaultDisabled: r }) => {
-	let i = [...e.headers], f = [...e.queryString], m = e.url, v = p(t);
-	for (let t of v) {
-		if (!t.in || !t.name) continue;
-		let p = _(t, n, void 0, r);
-		if (p === void 0) continue;
-		let { style: v, explode: b } = g(t);
-		switch (t.in) {
+}, b = (i, a, o) => {
+	let s = p(i, a), c = s.example;
+	if (r(i, c, o)) return;
+	if (s.value !== void 0) return t(s.value, i);
+	if (!("schema" in i) || !i.schema) return;
+	let l = i.in === "path" ? { emptyString: `{${i.name}}` } : {}, u = e(i.schema);
+	return u ? n(u, l) : void 0;
+}, x = ({ harRequest: e, parameters: t, example: n, defaultDisabled: f }) => {
+	let _ = [...e.headers], x = [...e.queryString], C = [...e.cookies], w = [], T = e.url, E = [], D = [], O = g(t);
+	for (let e of O) {
+		if (!e.in || !e.name) continue;
+		if (e.in === "querystring") {
+			let t = m(e, n, { defaultDisabled: f });
+			if (t) {
+				let e = T.indexOf("#"), n = e === -1 ? "" : T.slice(e), r = (e === -1 ? T : T.slice(0, e)).split("?")[0], i = h(t);
+				T = `${r}${i ? `?${i}` : ""}${n}`;
+			}
+			continue;
+		}
+		let t = p(e, n);
+		if (t.serialized && !r(e, t.example, f)) {
+			let n = String(t.value);
+			switch (e.in) {
+				case "path":
+					T = T.replaceAll(`{${e.name}}`, () => n);
+					break;
+				case "query":
+					E.push(n);
+					break;
+				case "header":
+					_.push({
+						name: e.name,
+						value: n
+					});
+					break;
+				case "cookie":
+					D.push(n);
+					break;
+			}
+			continue;
+		}
+		if (t.mediaSerialized && !r(e, t.example, f)) {
+			let n = String(t.value);
+			switch (e.in) {
+				case "query":
+					x.push({
+						name: e.name,
+						value: v(n, e)
+					});
+					break;
+				case "header":
+					_.push({
+						name: e.name,
+						value: n
+					});
+					break;
+				case "path":
+					T = T.replaceAll(`{${e.name}}`, () => encodeURIComponent(n));
+					break;
+				case "cookie":
+					C.push({
+						name: e.name,
+						value: n
+					});
+					break;
+			}
+			continue;
+		}
+		let g = b(e, n, f);
+		if (g === void 0) continue;
+		let { style: O, explode: k } = y(e);
+		switch (e.in) {
 			case "path":
-				m = y(m, t, p, v, b);
+				T = S(T, e, g, O, k);
 				break;
 			case "query":
-			case "querystring":
-				if ("content" in t && t.content) {
-					let e = a(p, Object.keys(t.content)[0] ?? "application/json");
-					f.push({
-						name: t.name,
-						value: h(e, t)
+				if ("content" in e && e.content) {
+					let t = i(g, Object.keys(e.content)[0] ?? "application/json");
+					x.push({
+						name: e.name,
+						value: v(t, e)
 					});
 					break;
 				}
-				switch (v) {
+				switch (O) {
 					case "form": {
-						let e = s(p, b);
-						if (Array.isArray(e)) for (let n of e) {
-							let e = n.key || t.name;
-							f.push({
-								name: e,
-								value: h(String(n.value), t)
+						let t = s(g, k);
+						if (Array.isArray(t)) for (let n of t) {
+							let t = n.key || e.name;
+							x.push({
+								name: t,
+								value: v(String(n.value), e)
 							});
 						}
-						else f.push({
-							name: t.name,
-							value: h(String(e), t)
+						else x.push({
+							name: e.name,
+							value: v(String(t), e)
 						});
 						break;
 					}
 					case "spaceDelimited": {
-						let e = d(p);
-						f.push({
-							name: t.name,
-							value: h(e, t)
+						let t = d(g);
+						x.push({
+							name: e.name,
+							value: v(t, e)
 						});
 						break;
 					}
 					case "pipeDelimited": {
-						let e = l(p);
-						f.push({
-							name: t.name,
-							value: h(e, t)
+						let t = l(g);
+						x.push({
+							name: e.name,
+							value: v(t, e)
 						});
 						break;
 					}
 					case "deepObject":
-						if (Array.isArray(p)) {
-							let e = s(p, !0);
-							if (Array.isArray(e)) for (let n of e) {
-								let e = n.key || t.name;
-								f.push({
-									name: e,
-									value: h(String(n.value), t)
+						if (Array.isArray(g)) {
+							let t = s(g, !0);
+							if (Array.isArray(t)) for (let n of t) {
+								let t = n.key || e.name;
+								x.push({
+									name: t,
+									value: v(String(n.value), e)
 								});
 							}
-							else f.push({
-								name: t.name,
-								value: h(String(e), t)
+							else x.push({
+								name: e.name,
+								value: v(String(t), e)
 							});
 						} else {
-							let e = o(t.name, p);
-							for (let n of e) f.push({
+							let t = o(e.name, g);
+							for (let n of t) x.push({
 								name: n.key,
-								value: h(n.value, t)
+								value: v(n.value, e)
 							});
 						}
 						break;
-					default: f.push({
-						name: t.name,
-						value: h(String(p), t)
+					default: x.push({
+						name: e.name,
+						value: v(String(g), e)
 					});
 				}
 				break;
 			case "header": {
-				let e = u(p, b);
-				i.push({
-					name: t.name,
-					value: String(e)
+				let t = u(g, k);
+				_.push({
+					name: e.name,
+					value: String(t)
 				});
 				break;
 			}
 			case "cookie": {
-				let n = c(p, 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
+				if (O === "cookie") {
+					w.push(...a(e.name, g, k));
+					break;
+				}
+				let t = c(g, k);
+				if (Array.isArray(t)) for (let n of t) {
+					let t = n.key || e.name, r = n.value === null ? "null" : String(n.value);
+					C.push({
+						name: t,
+						value: r
 					});
 				}
 				else {
-					let r = n === null ? "null" : String(n);
-					e.cookies.push({
-						name: t.name,
-						value: r
+					let n = t === null ? "null" : String(t);
+					C.push({
+						name: e.name,
+						value: n
 					});
 				}
 				break;
 			}
 		}
 	}
+	if (w.length || D.length) {
+		let e = [
+			...C.map((e) => `${encodeURIComponent(e.name)}=${encodeURIComponent(e.value)}`),
+			...w.map((e) => `${e.name}=${e.value}`),
+			...D
+		].join("; "), t = _.find((e) => e.name.toLowerCase() === "cookie");
+		t ? _.splice(_.indexOf(t), 1, {
+			...t,
+			value: t.value ? `${t.value}; ${e}` : e
+		}) : _.push({
+			name: "Cookie",
+			value: e
+		});
+	}
+	if (E.length) {
+		let e = T.indexOf("#"), t = e < 0 ? "" : T.slice(e), n = e < 0 ? T : T.slice(0, e);
+		T = `${n}${n.includes("?") ? "&" : "?"}${E.join("&")}${t}`;
+	}
 	return {
-		url: m,
-		headers: i,
-		queryString: f,
-		cookies: e.cookies
+		url: T,
+		headers: _,
+		queryString: x,
+		cookies: w.length || D.length ? [] : C,
+		hasCookieStyleEntries: w.length > 0 || D.length > 0,
+		...E.length ? { hasSerializedQuery: !0 } : {}
 	};
-}, y = (e, t, n, r, i) => {
+}, S = (e, t, n, r, i) => {
 	switch (r) {
 		case "matrix":
 			if (i) {
@@ -186,6 +272,6 @@ var p = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), m = (e) =
 	}
 };
 //#endregion
-export { v as processParameters };
+export { x as processParameters };
 
 //# sourceMappingURL=process-parameters.js.map