@scalar/blocks 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @scalar/blocks
 
+## 0.1.9
+
+### Patch Changes
+
+- [#9752](https://github.com/scalar/scalar/pull/9752): fix: stop vendoring a second copy of the themes reset in the standalone stylesheet
+
+  The blocks `style.css` build pulled in `@scalar/components/style.css`, which re-imports `@scalar/themes/style.css` — so the published stylesheet shipped two unlayered copies of the universal reset. Loaded after the other Scalar packages, the late duplicate clobbered component font sizes, padding, and colors. Blocks now composes the lean `@scalar/components/vue-styles.css` instead, matching how `@scalar/api-reference` and `@scalar/components` build their stylesheets, and exposes `./vue-styles.css` alongside `./style.css` and `./tailwind.config.css`.
+
+- [#9689](https://github.com/scalar/scalar/pull/9689): fix: multipart/form-data array-of-objects fields now serialize as a JSON array instead of a single object in generated request examples
+
 ## 0.1.8
 
 ### Patch Changes

package/README.md

@@ -8,7 +8,7 @@ Scalar is an open-source API platform for teams who want beautiful developer int
 
 - **[API References](https://scalar.com/products/api-references/getting-started)** — Interactive API documentation from OpenAPI and AsyncAPI specs.
 - **[Developer Docs](https://scalar.com/products/docs/getting-started)** — Write in Markdown/MDX, generate API references, sync with two-way Git.
-- **[SDK Generator](https://scalar.com/products/sdks/getting-started)** — Type-safe SDKs and CLIs in TypeScript, Python, Go, PHP, Java, and Ruby.
+- **[SDK Generator](https://scalar.com/products/sdk-generator/getting-started)** — Type-safe SDKs and CLIs in TypeScript, Python, Go, PHP, Java, and Ruby.
 - **[API Client](https://scalar.com/products/api-client/getting-started)** — Open-source, offline-first Postman alternative built on OpenAPI.
 
 20M+ monthly npm installs · 15,500+ GitHub stars · MIT licensed · [scalar.com](https://scalar.com)

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

@@ -1 +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"}
+{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AAUA,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;AAiKD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,yEAKzB,gBAAgB,KAAG,QAAQ,GAAG,SAyFhC,CAAA"}

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

@@ -2,68 +2,70 @@ import { getResolvedRefDeep as e } from "@scalar/workspace-store/helpers/get-res
 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";
+import { isObjectLike as o } from "@scalar/helpers/object/is-object";
+import { unpackProxyObject as s } 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({
+var c = (e, t, n, r = !1) => {
+	let a = [], l = Array.isArray(e) ? e.filter((e) => !e.isDisabled).map((e) => [String(e.name), e.value]) : Object.entries(e);
+	for (let [e, u] of l) {
+		if (u == null) continue;
+		let l = n ? void 0 : t?.[e], d = l && (l.style !== void 0 || l.explode !== void 0 || l.allowReserved !== void 0), f = d || !r ? void 0 : l?.contentType, p = n ? null : i(e, u, l);
+		if (p) for (let e of p) a.push({
 			name: e.key,
 			value: e.value
 		});
-		else if (l instanceof File) {
-			let t = o(l);
+		else if (u instanceof File) {
+			let t = s(u);
 			a.push({
 				name: e,
 				value: `@${t.name}`,
-				...d ? { contentType: d } : {}
+				...f ? { contentType: f } : {}
 			});
-		} else if (d && typeof l == "object") a.push({
+		} else if (f && typeof u == "object") a.push({
 			name: e,
-			value: JSON.stringify(o(l)),
-			contentType: d
+			value: JSON.stringify(s(u)),
+			contentType: f
 		});
-		else if (r && !n && !u && typeof l == "object" && !Array.isArray(l)) a.push({
+		else if (r && !n && !d && typeof u == "object" && !Array.isArray(u)) a.push({
 			name: e,
-			value: JSON.stringify(o(l)),
+			value: JSON.stringify(s(u)),
 			contentType: "application/json"
 		});
-		else if (Array.isArray(l)) for (let t of l) if (t instanceof File) {
-			let n = o(t);
+		else if (Array.isArray(u) && r && !n && !d && u.some((e) => o(e) && !(e instanceof File))) a.push({
+			name: e,
+			value: JSON.stringify(s(u)),
+			contentType: "application/json"
+		});
+		else if (Array.isArray(u)) for (let t of u) if (t instanceof File) {
+			let n = s(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({
+		} else a.push({
 			name: e,
 			value: String(t)
 		});
-		else if (typeof l == "object") {
-			let t = s(l, void 0, e);
+		else if (typeof u == "object") {
+			let t = c(u, 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 } : {}
+			value: String(u),
+			...f ? { contentType: f } : {}
 		});
 	}
 	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;
+}, l = ({ requestBody: i, contentType: o, example: l, requestBodyCompositionSelection: u }) => {
+	let d = o || Object.keys(i.content)[0] || "", f = d === "other" ? "" : d, p = (e) => `@${s(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, o)?.value;
 	if (_ !== void 0) {
-		let e = typeof _ == "object" && _ ? o(_) : _;
+		let e = typeof _ == "object" && _ ? s(_) : _;
 		return h && typeof e == "object" && e ? {
 			mimeType: f,
-			params: s(e, m, void 0, d === "multipart/form-data")
+			params: c(e, m, void 0, d === "multipart/form-data")
 		} : g && typeof e == "object" && e ? {
 			mimeType: f,
 			text: a(e)
@@ -84,7 +86,7 @@ var s = (e, t, n, r = !1) => {
 		}, { schemaPath: ["requestBody"] });
 		if (t !== void 0) return h && typeof t == "object" && t ? {
 			mimeType: f,
-			params: s(t, m, void 0, d === "multipart/form-data")
+			params: c(t, m, void 0, d === "multipart/form-data")
 		} : g && typeof t == "object" && t ? {
 			mimeType: f,
 			text: a(t)
@@ -95,6 +97,6 @@ var s = (e, t, n, r = !1) => {
 	}
 };
 //#endregion
-export { c as processBody };
+export { l 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 } 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":";;;;;;AA6CA,IAAM,KACJ,GACA,GACA,GACA,IAAc,OACF;CACZ,IAAM,IAAkB,EAAE,EAGpB,IAA+B,MAAM,QAAQ,EAAI,GACnD,EAAI,QAAQ,MAAS,CAAC,EAAK,WAAW,CAAC,KAAK,MAAS,CAAC,OAAO,EAAK,KAAK,EAAE,EAAK,MAAM,CAAC,GACrF,OAAO,QAAQ,EAAI;AAEvB,MAAK,IAAM,CAAC,GAAK,MAAU,GAAS;AAClC,MAAI,KAAiC,KACnC;EAGF,IAAM,IAAe,IAAY,KAAA,IAAY,IAAW,IAMlD,IACJ,MACC,EAAa,UAAU,KAAA,KACtB,EAAa,YAAY,KAAA,KACzB,EAAa,kBAAkB,KAAA,IAO7B,IAAsB,KAAgB,CAAC,IAAc,KAAA,IAAY,GAAc,aAS/E,IAAc,IAAY,OAAO,EAAkC,GAAK,GAAO,EAAa;AAClG,MAAI,EACF,MAAK,IAAM,KAAS,EAClB,GAAO,KAAK;GAAE,MAAM,EAAM;GAAK,OAAO,EAAM;GAAO,CAAC;WAE7C,aAAiB,MAAM;GAKhC,IAAM,IAAO,EAAkB,EAAM;AACrC,KAAO,KAAK;IACV,MAAM;IACN,OAAO,IAAI,EAAK;IAChB,GAAI,IAAsB,EAAE,aAAa,GAAqB,GAAG,EAAE;IACpE,CAAC;aACO,KAAuB,OAAO,KAAU,SAOjD,GAAO,KAAK;GACV,MAAM;GACN,OAAO,KAAK,UAAU,EAAkB,EAAM,CAAC;GAC/C,aAAa;GACd,CAAC;WACO,KAAe,CAAC,KAAa,CAAC,KAAgB,OAAO,KAAU,YAAY,CAAC,MAAM,QAAQ,EAAM,CAMzG,GAAO,KAAK;GACV,MAAM;GACN,OAAO,KAAK,UAAU,EAAkB,EAAM,CAAC;GAC/C,aAAa;GACd,CAAC;WACO,MAAM,QAAQ,EAAM,CAC7B,MAAK,IAAM,KAAQ,EACjB,KAAI,aAAgB,MAAM;GACxB,IAAM,IAAO,EAAkB,EAAK;AACpC,KAAO,KAAK;IAAE,MAAM;IAAK,OAAO,IAAI,EAAK;IAAQ,CAAC;SACzC,KAAe,CAAC,KAAa,CAAC,KAAgB,OAAO,KAAS,YAAY,IAKnF,EAAO,KAAK;GACV,MAAM;GACN,OAAO,KAAK,UAAU,EAAkB,EAAK,CAAC;GAC9C,aAAa;GACd,CAAC,GAEF,EAAO,KAAK;GAAE,MAAM;GAAK,OAAO,OAAO,EAAK;GAAE,CAAC;WAG1C,OAAO,KAAU,UAAU;GASpC,IAAM,IAAe,EAAmB,GAAO,KAAA,GAAW,EAAI;AAE9D,QAAK,IAAM,KAAS,EAClB,GAAO,KAAK;IAAE,MAAM,GAAG,EAAI,GAAG,EAAM;IAAQ,OAAO,EAAM;IAAO,CAAC;QAGnE,GAAO,KAAK;GACV,MAAM;GACN,OAAO,OAAO,EAAM;GACpB,GAAI,IAAsB,EAAE,aAAa,GAAqB,GAAG,EAAE;GACpE,CAAC;;AAIN,QAAO;GAOI,KAAe,EAC1B,gBACA,gBACA,YACA,yCAC4C;CAC5C,IAAM,IAAe,KAAe,OAAO,KAAK,EAAY,QAAQ,CAAC,MAAM,IAErE,IAAc,MAAiB,UAAU,KAAK,GAC9C,KAAoB,MAEjB,IADe,EAAkB,EAAK,CACpB,QAAQ,cAE7B,IAAW,EAAY,QAAQ,IAAe,UAG9C,IAAa,MAAiB,yBAAyB,MAAiB,qCAGxE,IAAQ,MAAiB,mBAGzB,IAAW,EAAW,GAAa,GAAS,EAAY,EAAE;AAGhE,KAAW,MAAa,QAAa;EACnC,IAAM,IAAoC,OAAO,KAAa,YAAzC,IAAoD,EAAkB,EAAS,GAAG;AAuBvG,SArBI,KAAc,OAAO,KAAiB,YAAY,IAC7C;GACL,UAAU;GACV,QAAQ,EAAmB,GAAc,GAAU,KAAA,GAAW,MAAiB,sBAAsB;GACtG,GAGC,KAAS,OAAO,KAAiB,YAAY,IACxC;GACL,UAAU;GACV,MAAM,EAAS,EAAa;GAC7B,GAGC,aAAwB,OACnB;GACL,UAAU;GACV,MAAM,EAAiB,EAAa;GACrC,GAGI;GACL,UAAU;GACV,MAAM,OAAO,KAAiB,WAAW,IAAe,KAAK,UAAU,EAAa;GACrF;;CAIH,IAAM,IAAgB,EAAe,EAAY,QAAQ,IAAe,OAAO;AAC/E,KAAW,MAAkB,QAAa;EAExC,IAAM,IAAmB,EADK,EAAmB,EAAc,EAG7D;GACE,sBAAsB;GACtB,MAAM;GACN,KAAK;GACN,EACD,EACE,YAAY,CAAC,cAAc,EAC5B,CACF;AAED,MAAI,MAAqB,KAAA,EAevB,QAdI,KAAc,OAAO,KAAqB,YAAY,IACjD;GACL,UAAU;GACV,QAAQ,EAAmB,GAAkB,GAAU,KAAA,GAAW,MAAiB,sBAAsB;GAC1G,GAGC,KAAS,OAAO,KAAqB,YAAY,IAC5C;GACL,UAAU;GACV,MAAM,EAAS,EAAiB;GACjC,GAGI;GACL,UAAU;GACV,MAAM,OAAO,KAAqB,WAAW,IAAmB,KAAK,UAAU,EAAiB;GACjG"}
+{"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 { isObjectLike } from '@scalar/helpers/object/is-object'\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 (\n      Array.isArray(value) &&\n      isMultipart &&\n      !parentKey &&\n      !hasFormStyle &&\n      value.some((item) => isObjectLike(item) && !(item instanceof File))\n    ) {\n      /**\n       * Per OpenAPI 3.x: a top-level multipart array whose items are objects defaults to a single\n       * `application/json` part containing the whole array. Serializing each item into its own part\n       * would drop the enclosing array wrapper and emit a bare object (see issue #9688), so keep the\n       * array intact and stringify it as one value.\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(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/constants.js

@@ -1,5 +1,5 @@
 //#region src/constants.ts
-var e = typeof OVERRIDE_PACKAGE_VERSION < "u" ? OVERRIDE_PACKAGE_VERSION : "0.1.8";
+var e = typeof OVERRIDE_PACKAGE_VERSION < "u" ? OVERRIDE_PACKAGE_VERSION : "0.1.9";
 //#endregion
 export { e as APP_VERSION };