@scalar/blocks 0.4.3 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @scalar/blocks
 
+## 0.5.0
+
+### Minor Changes
+
+- [#10443](https://github.com/scalar/scalar/pull/10443): Add a showExtensions allowlist to display OpenAPI extensions on operations, parameters, response headers, and schema fields without a custom plugin, with a schema-style value tree from the blocks package.
+- [#10397](https://github.com/scalar/scalar/pull/10397): Extract the schema renderer into @scalar/blocks so other Scalar surfaces can reuse the schema tree while preserving API Reference behavior.
+
+  Keep the public API Reference Schema and SchemaProperty exports connected to extension plugins and deep-link navigation when mounted outside ApiReference.
+
+  Expose shared presentation components through @scalar/blocks/shared, group host integration APIs under schema/helpers and schema/expansion, and keep schema stories and visual regression coverage with Blocks.
+
+  Preserve literal toolbar icon types so Storybook previews can be type checked.
+
+  Pass schema navigation, extension rendering, and shared expansion state explicitly through props instead of providing or injecting host context.
+
+### Patch Changes
+
+- [#10460](https://github.com/scalar/scalar/pull/10460): Preserve multipart file metadata in generated code examples, including arrays and composed schemas, read actual file bytes across code example targets, let HTTP clients set the multipart boundary, and preserve typed text fields without turning them into file attachments.
+- [#10468](https://github.com/scalar/scalar/pull/10468): Stop the schema property copy-link button from taking width from a collapsed preview such as `{ compound, percentage }`. Its 24px hit box now overhangs the end of the line, so the row gives up only the icon and its gap, however the consuming app orders its stylesheets.
+
 ## 0.4.3
 
 ### Patch Changes

package/README.md

@@ -44,3 +44,48 @@ createCodeExample('#block', {
   },
 })
 ```
+
+## Schema tree
+
+Render an OpenAPI schema in a Vue application using the same tree as API Reference:
+
+```vue
+<script setup lang="ts">
+import { Schema } from '@scalar/blocks/schema'
+import { useSchemaExpansion } from '@scalar/blocks/schema/expansion'
+import { ref } from 'vue'
+import type { SchemaObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'
+import '@scalar/blocks/style.css'
+
+const { schema } = defineProps<{ schema: SchemaObject }>()
+const scrollTargetId = ref('')
+const expansion = useSchemaExpansion(scrollTargetId)
+</script>
+
+<template>
+  <div class="scalar-app">
+    <Schema :schema="schema" :eventBus="null" :options="{ hideModels: true }" :scrollTargetId="scrollTargetId" :expansion="expansion" />
+  </div>
+</template>
+```
+
+The tree supports nested properties, composition selectors, constraints, examples, and keyboard navigation. Pass schemas from the workspace store to retain resolved references. Display options are typed by `SchemaOptions`.
+
+Translations inherit the host's `@scalar/localization` provider, including locale and custom overrides. Without a provider, labels use English.
+
+Hosts pass `scrollTargetId`, `specificationExtension`, and `expansion` as props. Create a shared store with `useSchemaExpansion(scrollTargetId)` from `@scalar/blocks/schema/expansion` inside the host’s setup and pass it to each tree. Without an expansion prop, a standalone tree owns its own store. The extension component receives the schema through its `value` prop. Request-body composition selectors share selections with code samples through `REQUEST_BODY_COMPOSITION_INDEX_SYMBOL`.
+
+### Entry points
+
+- `@scalar/blocks/schema` exposes the schema renderers, rail controls, `SchemaOptions`, translations, `SchemaRenderingProps`, and the composition-selection key.
+- `@scalar/blocks/schema/expansion` exposes `useSchemaExpansion`, the expansion store and its controls, and breadcrumb node keys for hosts that render their own schema rows.
+- `@scalar/blocks/schema/helpers` exposes the schema classification, composition, naming, ordering, and keyboard helpers shared with those host rows.
+- `@scalar/blocks/shared` exposes the general-purpose `Badge` and `ScreenReader` components.
+
+These entry points are supported package APIs. Implementation components such as composition selectors, enum lists, breadcrumbs, and copy-link buttons stay private to the schema renderer.
+
+### Schema workbench and snapshots
+
+From the repository root, build the dependencies with `pnpm turbo --filter @scalar/blocks build`, then run `pnpm --filter @scalar/blocks dev:storybook` to browse the schema stories.
+
+The stories, interactive snapshot tests, and checked-in baselines live together in `src/schema`. Run `pnpm --filter @scalar/blocks build:storybook` followed by `pnpm --filter @scalar/blocks test:e2e:storybook` with Docker running. The browser runs in the same Linux image as CI so snapshots compare consistently across host platforms. Use `test:e2e:storybook:update-snapshots` only for intentional visual changes.

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

@@ -1 +1 @@
-{"version":3,"file":"operation-to-har.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/operation-to-har.ts"],"names":[],"mappings":"AAEA,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,MAAM,CAAA;IACd,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,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+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,+LAa5B,mBAAmB,KAAG,UAyJxB,CAAA"}
+{"version":3,"file":"operation-to-har.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/operation-to-har.ts"],"names":[],"mappings":"AAEA,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,MAAM,CAAA;IACd,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,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+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,+LAa5B,mBAAmB,KAAG,UAkKxB,CAAA"}

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

@@ -82,6 +82,7 @@ var u = ({ includeDefaultHeaders: u = !1, operation: d, contentType: f, method:
 		let e = w.url.indexOf("#"), t = e === -1 ? "" : w.url.slice(e), n = e === -1 ? w.url : w.url.slice(0, e), r = w.queryString.map(({ name: e, value: t }) => `${encodeURIComponent(e)}=${t}`).join("&");
 		w.url = `${n}${n.includes("?") ? "&" : "?"}${r}${t}`, w.queryString = [];
 	}
+	w.postData?.mimeType === "multipart/form-data" && w.postData.params?.some((e) => e.fileName !== void 0) && (w.headers = w.headers.filter((e) => e.name.toLowerCase() !== "content-type"));
 	let A = 0;
 	for (let e of w.headers) A += (e.name?.length ?? 0) + 2 + (e.value?.length ?? 0) + 2;
 	return w.headersSize = A, w;

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

@@ -1 +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 { 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.2/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: string\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  /** Originating OpenAPI version, used for XML mapping rules. */\n  openapiVersion?: string\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  openapiVersion,\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  let hasCookieStyleEntries = false\n  let hasSerializedQuery = false\n\n  // Handle parameters\n  if (operation.parameters) {\n    const {\n      url,\n      headers,\n      queryString,\n      cookies,\n      hasCookieStyleEntries: processedCookieStyleEntries,\n      hasSerializedQuery: processedSerializedQuery,\n    } = 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    hasCookieStyleEntries = processedCookieStyleEntries\n    hasSerializedQuery = processedSerializedQuery ?? false\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      openapiVersion,\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 (\n          existingContentTypeHeader &&\n          (!existingContentTypeHeader.value ||\n            (postData.mimeType.startsWith('multipart/') &&\n              postData.mimeType.includes('boundary=') &&\n              postData.text !== undefined))\n        ) {\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  const hasUriReadyQuery =\n    hasSerializedQuery || operation.parameters?.some((parameter) => getResolvedRef(parameter)?.in === 'querystring')\n\n  // Handle security schemes\n  if (securitySchemes) {\n    const { headers, queryString, cookies } = processSecuritySchemes(securitySchemes)\n    harRequest.headers.push(...headers)\n    // Named parameter values are already serialized, but authentication values are still raw.\n    harRequest.queryString.push(\n      ...queryString.map((parameter) =>\n        hasUriReadyQuery ? { ...parameter, value: encodeURIComponent(parameter.value) } : parameter,\n      ),\n    )\n    harRequest.cookies.push(...cookies)\n  }\n\n  // Keep authentication and global cookies in the explicit header as well, so\n  // snippet generators cannot replace cookie-style parameters with their own header.\n  const cookieHeader = harRequest.headers.find((header) => header.name.toLowerCase() === 'cookie')\n  if (hasCookieStyleEntries && cookieHeader && harRequest.cookies.length) {\n    const extraCookies = harRequest.cookies\n      .map((cookie) => `${encodeURIComponent(cookie.name)}=${encodeURIComponent(cookie.value)}`)\n      .join('; ')\n    cookieHeader.value = cookieHeader.value ? `${cookieHeader.value}; ${extraCookies}` : extraCookies\n    harRequest.cookies = []\n  }\n\n  // Whole-query content and serialized examples must retain their authored URI encoding.\n  // Keeping all query data in the URL avoids snippet generators introducing a second question mark.\n  if (hasUriReadyQuery && harRequest.queryString.length) {\n    const hashIndex = harRequest.url.indexOf('#')\n    const hash = hashIndex === -1 ? '' : harRequest.url.slice(hashIndex)\n    const url = hashIndex === -1 ? harRequest.url : harRequest.url.slice(0, hashIndex)\n    const query = harRequest.queryString.map(({ name, value }) => `${encodeURIComponent(name)}=${value}`).join('&')\n    harRequest.url = `${url}${url.includes('?') ? '&' : '?'}${query}${hash}`\n    harRequest.queryString = []\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":"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"}
+{"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 { 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.2/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: string\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  /** Originating OpenAPI version, used for XML mapping rules. */\n  openapiVersion?: string\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  openapiVersion,\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  let hasCookieStyleEntries = false\n  let hasSerializedQuery = false\n\n  // Handle parameters\n  if (operation.parameters) {\n    const {\n      url,\n      headers,\n      queryString,\n      cookies,\n      hasCookieStyleEntries: processedCookieStyleEntries,\n      hasSerializedQuery: processedSerializedQuery,\n    } = 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    hasCookieStyleEntries = processedCookieStyleEntries\n    hasSerializedQuery = processedSerializedQuery ?? false\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      openapiVersion,\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 (\n          existingContentTypeHeader &&\n          (!existingContentTypeHeader.value ||\n            (postData.mimeType.startsWith('multipart/') &&\n              postData.mimeType.includes('boundary=') &&\n              postData.text !== undefined))\n        ) {\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  const hasUriReadyQuery =\n    hasSerializedQuery || operation.parameters?.some((parameter) => getResolvedRef(parameter)?.in === 'querystring')\n\n  // Handle security schemes\n  if (securitySchemes) {\n    const { headers, queryString, cookies } = processSecuritySchemes(securitySchemes)\n    harRequest.headers.push(...headers)\n    // Named parameter values are already serialized, but authentication values are still raw.\n    harRequest.queryString.push(\n      ...queryString.map((parameter) =>\n        hasUriReadyQuery ? { ...parameter, value: encodeURIComponent(parameter.value) } : parameter,\n      ),\n    )\n    harRequest.cookies.push(...cookies)\n  }\n\n  // Keep authentication and global cookies in the explicit header as well, so\n  // snippet generators cannot replace cookie-style parameters with their own header.\n  const cookieHeader = harRequest.headers.find((header) => header.name.toLowerCase() === 'cookie')\n  if (hasCookieStyleEntries && cookieHeader && harRequest.cookies.length) {\n    const extraCookies = harRequest.cookies\n      .map((cookie) => `${encodeURIComponent(cookie.name)}=${encodeURIComponent(cookie.value)}`)\n      .join('; ')\n    cookieHeader.value = cookieHeader.value ? `${cookieHeader.value}; ${extraCookies}` : extraCookies\n    harRequest.cookies = []\n  }\n\n  // Whole-query content and serialized examples must retain their authored URI encoding.\n  // Keeping all query data in the URL avoids snippet generators introducing a second question mark.\n  if (hasUriReadyQuery && harRequest.queryString.length) {\n    const hashIndex = harRequest.url.indexOf('#')\n    const hash = hashIndex === -1 ? '' : harRequest.url.slice(hashIndex)\n    const url = hashIndex === -1 ? harRequest.url : harRequest.url.slice(0, hashIndex)\n    const query = harRequest.queryString.map(({ name, value }) => `${encodeURIComponent(name)}=${value}`).join('&')\n    harRequest.url = `${url}${url.includes('?') ? '&' : '?'}${query}${hash}`\n    harRequest.queryString = []\n  }\n\n  // Multipart file parts are encoded by the HTTP client, which owns the boundary.\n  // Raw multipart text already has its boundary and must retain its Content-Type.\n  if (\n    harRequest.postData?.mimeType === 'multipart/form-data' &&\n    harRequest.postData.params?.some((param) => param.fileName !== undefined)\n  ) {\n    harRequest.headers = harRequest.headers.filter((header) => header.name.toLowerCase() !== 'content-type')\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":"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"}

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":"AAkBA,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,CAC1B,mBAAmB,EACnB,aAAa,GAAG,SAAS,GAAG,iCAAiC,GAAG,gBAAgB,CACjF,GAAG;IACF,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AA8JD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,yFAMzB,gBAAgB,KAAG,QAAQ,GAAG,SA0HhC,CAAA"}
+{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AAkBA,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,CAC1B,mBAAmB,EACnB,aAAa,GAAG,SAAS,GAAG,iCAAiC,GAAG,gBAAgB,CACjF,GAAG;IACF,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AA0LD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,yFAMzB,gBAAgB,KAAG,QAAQ,GAAG,SAiIhC,CAAA"}

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

@@ -6,7 +6,12 @@ import { getExampleValue as m, getExplicitExampleText as h } from "@scalar/works
 import { serializeStreamExample as g } from "@scalar/workspace-store/helpers/serialize-stream-example";
 import { unpackProxyObject as _ } from "@scalar/workspace-store/helpers/unpack-proxy";
 //#region src/code-example/helpers/operation-to-har/process-body.ts
-var v = (e, t, n, r = !1, a) => {
+var v = (e, t, n) => ({
+	name: e,
+	value: `@${t}`,
+	fileName: t,
+	...n ? { contentType: n } : {}
+}), y = (e) => !!e && "type" in e && e.type === "string" && "format" in e && e.format === "binary", b = (e, t) => typeof e == "string" && e.startsWith("@") && y(t) ? e.slice(1) : void 0, x = (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 [c, f] of s) {
 		if (f == null) continue;
@@ -14,27 +19,30 @@ var v = (e, t, n, r = !1, a) => {
 		if (r && !n) {
 			let t = Array.isArray(e) ? i(f, l(a, [c])) : f, n = d(c, Array.isArray(t) ? t : f, s);
 			if (n) {
-				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 } : {}
-				});
+				for (let e of n) {
+					if (e.value instanceof File) {
+						o.push(v(e.key, e.value.name, e.contentType ?? e.value.type));
+						continue;
+					}
+					o.push({
+						name: e.key,
+						value: e.value,
+						...e.contentType ? { contentType: e.contentType } : {}
+					});
+				}
 				continue;
 			}
 		}
-		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 : u(c, f, s);
-		if (h) for (let e of h) o.push({
+		let p = s && (s.style !== void 0 || s.explode !== void 0 || s.allowReserved !== void 0), m = p || !r ? void 0 : s?.contentType, h = r && !n ? b(f, l(a, [c])) : void 0, g = n ? null : u(c, f, s);
+		if (g) for (let e of g) o.push({
 			name: e.key,
 			value: e.value
 		});
 		else if (f instanceof File) {
 			let e = _(f);
-			o.push({
-				name: c,
-				value: `@${e.name}`,
-				...m ? { contentType: m } : {}
-			});
-		} else if (m && typeof f == "object") o.push({
+			o.push(v(c, e.name, m ?? (r ? e.type : void 0)));
+		} else if (h !== void 0) o.push(v(c, h, m));
+		else if (m && typeof f == "object") o.push({
 			name: c,
 			value: JSON.stringify(_(f)),
 			contentType: m
@@ -46,16 +54,13 @@ var v = (e, t, n, r = !1, a) => {
 		});
 		else if (Array.isArray(f)) for (let e of f) if (e instanceof File) {
 			let t = _(e);
-			o.push({
-				name: c,
-				value: `@${t.name}`
-			});
+			o.push(v(c, t.name, r ? t.type : void 0));
 		} else o.push({
 			name: c,
 			value: String(e)
 		});
 		else if (typeof f == "object") {
-			let e = v(f, void 0, c);
+			let e = x(f, void 0, c);
 			for (let t of e) o.push({
 				name: `${c}.${t.name}`,
 				value: t.value
@@ -67,13 +72,13 @@ var v = (e, t, n, r = !1, a) => {
 		});
 	}
 	return o;
-}, y = ({ requestBody: i, contentType: l, example: u, openapiVersion: d, requestBodyCompositionSelection: y }) => {
-	let b = l || Object.keys(i.content)[0] || "", x = b === "other" ? "" : b, S = (e) => `@${_(e).name || "filename"}`, C = i.content[b]?.encoding, w = i.content[b];
-	if (w && c(b, w)) {
+}, S = ({ requestBody: i, contentType: l, example: u, openapiVersion: d, requestBodyCompositionSelection: v }) => {
+	let y = l || Object.keys(i.content)[0] || "", b = y === "other" ? "" : y, S = (e) => `@${_(e).name || "filename"}`, C = i.content[y]?.encoding, w = i.content[y];
+	if (w && c(y, w)) {
 		let e = u ?? Object.keys(w.examples ?? {})[0] ?? "default", t = r({
 			...i,
-			"x-scalar-selected-content-type": { [e]: b }
-		}, e, y);
+			"x-scalar-selected-content-type": { [e]: y }
+		}, e, v);
 		if (t?.mode === "multipart") {
 			let e = f(t.value, t.contentType);
 			return {
@@ -82,49 +87,50 @@ var v = (e, t, n, r = !1, a) => {
 			};
 		}
 	}
-	let T = b === "multipart/form-data" || b === "application/x-www-form-urlencoded";
-	if (p(b)) {
-		let e = o(i, b, u ?? "", y, d);
+	let T = y === "multipart/form-data" || y === "application/x-www-form-urlencoded";
+	if (p(y)) {
+		let e = o(i, y, u ?? "", v, d);
 		return e ? {
-			mimeType: x,
+			mimeType: b,
 			text: e.value
 		} : void 0;
 	}
-	let E = m(a(i, u, l)), D = h(E, b);
+	let E = m(a(i, u, l)), D = h(E, y);
 	if (D !== void 0) return {
-		mimeType: x,
+		mimeType: b,
 		text: D
 	};
 	let O = E?.value;
 	if (O !== void 0) {
 		let e = typeof O == "object" && O ? _(O) : O;
 		return T && typeof e == "object" && e ? {
-			mimeType: x,
-			params: v(e, C, void 0, b === "multipart/form-data", t(i.content[b]?.schema, n))
+			mimeType: b,
+			params: x(e, C, void 0, y === "multipart/form-data", t(i.content[y]?.schema, n))
 		} : e instanceof File ? {
-			mimeType: x,
+			mimeType: b,
 			text: S(e)
 		} : {
-			mimeType: x,
-			text: typeof e == "string" ? e : g(e, b, !1) ?? JSON.stringify(e)
+			mimeType: b,
+			text: typeof e == "string" ? e : g(e, y, !1) ?? JSON.stringify(e)
 		};
 	}
-	let k = i.content[b], A = t(k?.schema ?? k?.itemSchema);
+	let k = i.content[y], A = t(k?.schema ?? k?.itemSchema);
 	if (A !== void 0) {
-		let t = s(e(A), {
-			compositionSelection: y,
-			mode: "write"
+		let t = e(A), n = s(t, {
+			compositionSelection: v,
+			mode: "write",
+			binaryAsFile: y === "multipart/form-data"
 		}, { schemaPath: ["requestBody"] });
-		if (t !== void 0) return T && typeof t == "object" && t ? {
-			mimeType: x,
-			params: v(t, C, void 0, b === "multipart/form-data")
+		if (n !== void 0) return T && typeof n == "object" && n ? {
+			mimeType: b,
+			params: x(n, C, void 0, y === "multipart/form-data", t)
 		} : {
-			mimeType: x,
-			text: g(t, b, k?.schema === void 0) ?? (typeof t == "string" ? t : JSON.stringify(t))
+			mimeType: b,
+			text: g(n, y, k?.schema === void 0) ?? (typeof n == "string" ? n : JSON.stringify(n))
 		};
 	}
 };
 //#endregion
-export { y as processBody };
+export { S 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 { isXmlMediaType } from '@scalar/helpers/http/is-xml-media-type'\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  getExampleFromBody,\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<\n  OperationToHarProps,\n  'contentType' | 'example' | 'requestBodyCompositionSelection' | 'openapiVersion'\n> & {\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  openapiVersion,\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  if (isXmlMediaType(_contentType)) {\n    const xmlExample = getExampleFromBody(\n      requestBody,\n      _contentType,\n      example ?? '',\n      requestBodyCompositionSelection,\n      openapiVersion,\n    )\n    return xmlExample ? { mimeType: harMimeType, text: xmlExample.value as string } : undefined\n  }\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 (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      },\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      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":";;;;;;;;AAwDA,IAAM,KACJ,GACA,GACA,GACA,IAAc,IACd,MACY;CACZ,IAAM,IAAkB,CAAC,GAGnB,IAA+B,MAAM,QAAQ,CAAG,IAClD,EAAI,QAAQ,MAAS,CAAC,EAAK,UAAU,CAAC,CAAC,KAAK,MAAS,CAAC,OAAO,EAAK,IAAI,GAAG,EAAK,KAAK,CAAC,IACpF,OAAO,QAAQ,CAAG;CAEtB,KAAK,IAAM,CAAC,GAAK,MAAU,GAAS;EAClC,IAAI,KAAiC,MACnC;EAGF,IAAM,IAAe,IAAY,KAAA,IAAY,IAAW;EAExD,IAAI,KAAe,CAAC,GAAW;GAC7B,IAAM,IAAW,MAAM,QAAQ,CAAG,IAAI,EAA4B,GAAO,EAAkB,GAAQ,CAAC,CAAG,CAAC,CAAC,IAAI,GACvG,IAAa,EAAwB,GAAK,MAAM,QAAQ,CAAQ,IAAI,IAAW,GAAO,CAAY;GACxG,IAAI,GAAY;IACd,KAAK,IAAM,KAAQ,GACjB,EAAO,KAAK;KACV,MAAM,EAAK;KACX,OAAO,EAAK,iBAAiB,OAAO,IAAI,EAAK,MAAM,SAAS,EAAK;KACjE,GAAI,EAAK,cAAc,EAAE,aAAa,EAAK,YAAY,IAAI,CAAC;IAC9D,CAAC;IAEH;GACF;EACF;EAMA,IAAM,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,CAAY;EACjG,IAAI,GACF,KAAK,IAAM,KAAS,GAClB,EAAO,KAAK;GAAE,MAAM,EAAM;GAAK,OAAO,EAAM;EAAM,CAAC;OAEhD,IAAI,aAAiB,MAAM;GAKhC,IAAM,IAAO,EAAkB,CAAK;GACpC,EAAO,KAAK;IACV,MAAM;IACN,OAAO,IAAI,EAAK;IAChB,GAAI,IAAsB,EAAE,aAAa,EAAoB,IAAI,CAAC;GACpE,CAAC;EACH,OAAO,IAAI,KAAuB,OAAO,KAAU,UAOjD,EAAO,KAAK;GACV,MAAM;GACN,OAAO,KAAK,UAAU,EAAkB,CAAK,CAAC;GAC9C,aAAa;EACf,CAAC;OACI,IAAI,KAAe,CAAC,KAAa,CAAC,KAAgB,OAAO,KAAU,YAAY,CAAC,MAAM,QAAQ,CAAK,GAMxG,EAAO,KAAK;GACV,MAAM;GACN,OAAO,KAAK,UAAU,EAAkB,CAAK,CAAC;GAC9C,aAAa;EACf,CAAC;OACI,IAAI,MAAM,QAAQ,CAAK,GAC5B,KAAK,IAAM,KAAQ,GACjB,IAAI,aAAgB,MAAM;GACxB,IAAM,IAAO,EAAkB,CAAI;GACnC,EAAO,KAAK;IAAE,MAAM;IAAK,OAAO,IAAI,EAAK;GAAO,CAAC;EACnD,OACE,EAAO,KAAK;GAAE,MAAM;GAAK,OAAO,OAAO,CAAI;EAAE,CAAC;OAG7C,IAAI,OAAO,KAAU,UAAU;GASpC,IAAM,IAAe,EAAmB,GAAO,KAAA,GAAW,CAAG;GAE7D,KAAK,IAAM,KAAS,GAClB,EAAO,KAAK;IAAE,MAAM,GAAG,EAAI,GAAG,EAAM;IAAQ,OAAO,EAAM;GAAM,CAAC;EAEpE,OACE,EAAO,KAAK;GACV,MAAM;GACN,OAAO,OAAO,CAAK;GACnB,GAAI,IAAsB,EAAE,aAAa,EAAoB,IAAI,CAAC;EACpE,CAAC;CAEL;CAEA,OAAO;AACT,GAMa,KAAe,EAC1B,gBACA,gBACA,YACA,mBACA,yCAC4C;CAC5C,IAAM,IAAe,KAAe,OAAO,KAAK,EAAY,OAAO,CAAC,CAAC,MAAM,IAErE,IAAc,MAAiB,UAAU,KAAK,GAC9C,KAAoB,MAEjB,IADe,EAAkB,CAC7B,CAAA,CAAc,QAAQ,cAE7B,IAAW,EAAY,QAAQ,EAAa,EAAE,UAE9C,IAAQ,EAAY,QAAQ;CAClC,IAAI,KAAS,EAAuB,GAAc,CAAK,GAAG;EACxD,IAAM,IAAc,KAAW,OAAO,KAAK,EAAM,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,WACjE,IAAO,EACX;GAAE,GAAG;GAAa,kCAAkC,GAAG,IAAc,EAAa;EAAE,GACpF,GACA,CACF;EACA,IAAI,GAAM,SAAS,aAAa;GAC9B,IAAM,IAAU,EAAuB,EAAK,OAAO,EAAK,WAAW;GACnE,OAAO;IACL,UAAU,EAAQ;IAElB,MAAM,EAAQ,OACX,KAAK,MACJ,aAAiB,OAAO,EAAiB,CAAK,IAAI,aAAiB,OAAO,WAAW,OAAO,CAAK,CACnG,CAAC,CACA,KAAK,EAAE;GACZ;EACF;CACF;CAGA,IAAM,IAAa,MAAiB,yBAAyB,MAAiB;CAG9E,IAAI,EAAe,CAAY,GAAG;EAChC,IAAM,IAAa,EACjB,GACA,GACA,KAAW,IACX,GACA,CACF;EACA,OAAO,IAAa;GAAE,UAAU;GAAa,MAAM,EAAW;EAAgB,IAAI,KAAA;CACpF;CAGA,IAAM,IAAW,EAAgB,EAAW,GAAa,GAAS,CAAW,CAAC,GACxE,IAAe,EAAuB,GAAU,CAAY;CAClE,IAAI,MAAiB,KAAA,GACnB,OAAO;EAAE,UAAU;EAAa,MAAM;CAAa;CAErD,IAAM,IAAW,GAAU;CAG3B,IAAW,MAAa,QAAa;EACnC,IAAM,IAAoC,OAAO,KAAa,YAAzC,IAAoD,EAAkB,CAAQ,IAAI;EAsBvG,OApBI,KAAc,OAAO,KAAiB,YAAY,IAC7C;GACL,UAAU;GACV,QAAQ,EACN,GACA,GACA,KAAA,GACA,MAAiB,uBACjB,EAAe,EAAY,QAAQ,EAAa,EAAE,QAAQ,CAAsB,CAClF;EACF,IAGE,aAAwB,OACnB;GACL,UAAU;GACV,MAAM,EAAiB,CAAY;EACrC,IAGK;GACL,UAAU;GACV,MACE,OAAO,KAAiB,WACpB,IACC,EAAuB,GAAc,GAAc,EAAK,KAAK,KAAK,UAAU,CAAY;EACjG;CACF;CAGA,IAAM,IAAY,EAAY,QAAQ,IAChC,IAAgB,EAAe,GAAW,UAAU,GAAW,UAAU;CAC/E,IAAW,MAAkB,QAAa;EAExC,IAAM,IAAmB,EADK,EAAmB,CAE/C,GACA;GACE,sBAAsB;GACtB,MAAM;EACR,GACA,EACE,YAAY,CAAC,aAAa,EAC5B,CACF;EAEA,IAAI,MAAqB,KAAA,GAQvB,OAPI,KAAc,OAAO,KAAqB,YAAY,IACjD;GACL,UAAU;GACV,QAAQ,EAAmB,GAAkB,GAAU,KAAA,GAAW,MAAiB,qBAAqB;EAC1G,IAGK;GACL,UAAU;GACV,MACE,EAAuB,GAAkB,GAAc,GAAW,WAAW,KAAA,CAAS,MACrF,OAAO,KAAqB,WAAW,IAAmB,KAAK,UAAU,CAAgB;EAC9F;CAEJ;AAGF"}
+{"version":3,"file":"process-body.js","names":[],"sources":["../../../../src/code-example/helpers/operation-to-har/process-body.ts"],"sourcesContent":["import { isXmlMediaType } from '@scalar/helpers/http/is-xml-media-type'\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  getExampleFromBody,\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<\n  OperationToHarProps,\n  'contentType' | 'example' | 'requestBodyCompositionSelection' | 'openapiVersion'\n> & {\n  requestBody: RequestBodyObject\n}\n\ntype MultipartEncodingMap = MediaTypeObject['encoding']\n\n/**\n * Builds a HAR param for an uploaded file. `fileName` is what snippet generators read to emit real\n * file handling (for example `files=` in Python or `new Blob` in fetch). `value` keeps the\n * `@filename` placeholder for consumers that only read the text value.\n */\nconst buildFileParam = (name: string, fileName: string, contentType?: string): Param => ({\n  name,\n  value: `@${fileName}`,\n  fileName,\n  ...(contentType ? { contentType } : {}),\n})\n\n/** True when the schema describes a binary file (`type: string, format: binary`). */\nconst isBinarySchema = (schema: SchemaObject | undefined): boolean =>\n  !!schema && 'type' in schema && schema.type === 'string' && 'format' in schema && schema.format === 'binary'\n\n/**\n * Example generation turns a binary property into the `@filename` placeholder string.\n * Use the schema to tell that apart from a normal text field that happens to start with `@`.\n */\nconst getBinaryPlaceholderFileName = (value: unknown, schema: SchemaObject | undefined): string | undefined =>\n  typeof value === 'string' && value.startsWith('@') && isBinarySchema(schema) ? value.slice(1) : undefined\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          if (part.value instanceof File) {\n            params.push(buildFileParam(part.key, part.value.name, part.contentType ?? part.value.type))\n            continue\n          }\n          params.push({\n            name: part.key,\n            value: 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 binaryPlaceholderFileName =\n      isMultipart && !parentKey ? getBinaryPlaceholderFileName(value, resolveLeafSchema(schema, [key])) : undefined\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(buildFileParam(key, file.name, explicitContentType ?? (isMultipart ? file.type : undefined)))\n    } else if (binaryPlaceholderFileName !== undefined) {\n      /** A binary property filled in by example generation, so it is a file and not a text field. */\n      params.push(buildFileParam(key, binaryPlaceholderFileName, explicitContentType))\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(buildFileParam(key, file.name, isMultipart ? file.type : undefined))\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  openapiVersion,\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  if (isXmlMediaType(_contentType)) {\n    const xmlExample = getExampleFromBody(\n      requestBody,\n      _contentType,\n      example ?? '',\n      requestBodyCompositionSelection,\n      openapiVersion,\n    )\n    return xmlExample ? { mimeType: harMimeType, text: xmlExample.value as string } : undefined\n  }\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 (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        binaryAsFile: _contentType === 'multipart/form-data',\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(\n            extractedExample,\n            encoding,\n            undefined,\n            _contentType === 'multipart/form-data',\n            resolvedContentSchema,\n          ),\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/constants.js

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

package/dist/schema/LinkButton.vue.d.ts

@@ -0,0 +1,14 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=LinkButton.vue.d.ts.map

package/dist/schema/LinkButton.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkButton.vue.d.ts","sourceRoot":"","sources":["../../src/schema/LinkButton.vue"],"names":[],"mappings":"AA4BA,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAG/C,QAAA,MAAM,UAAU,+QACd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/schema/LinkButton.vue.js

@@ -0,0 +1,15 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import { createElementBlock as t, openBlock as n, renderSlot as r } from "vue";
+//#region src/schema/LinkButton.vue
+var i = {}, a = {
+	class: "text-c-2 hover:text-c-1 underline",
+	type: "button"
+};
+function o(e, i) {
+	return n(), t("button", a, [r(e.$slots, "default")]);
+}
+var s = /*#__PURE__*/ e(i, [["render", o]]);
+//#endregion
+export { s as default };
+
+//# sourceMappingURL=LinkButton.vue.js.map

package/dist/schema/LinkButton.vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkButton.vue.js","names":[],"sources":["../../src/schema/LinkButton.vue"],"sourcesContent":["<template>\n  <button\n    class=\"text-c-2 hover:text-c-1 underline\"\n    type=\"button\">\n    <slot />\n  </button>\n</template>\n"],"mappings":";;;;CAEI,OAAM;CACN,MAAK;;;aAFP,EAIS,UAJT,GAIS,CADP,EAAQ,EAAA,QAAA,SAAA,CAAA,CAAA"}

package/dist/schema/RenderString.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    value: any;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=RenderString.vue.d.ts.map

package/dist/schema/RenderString.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderString.vue.d.ts","sourceRoot":"","sources":["../../src/schema/RenderString.vue"],"names":[],"mappings":"AA+DA,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,GAAG,CAAA;CACX,CAAC;AAyCF,QAAA,MAAM,YAAY,kSAEhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/schema/RenderString.vue.js

@@ -0,0 +1,7 @@
+import e from "./RenderString.vue.script.js";
+//#region src/schema/RenderString.vue
+var t = e;
+//#endregion
+export { t as default };
+
+//# sourceMappingURL=RenderString.vue.js.map

package/dist/schema/RenderString.vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderString.vue.js","names":[],"sources":["../../src/schema/RenderString.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/**\n * Give this component any data, and it tries to render a meaningful string.\n *\n * @example\n * <RenderString :value=\"1\" /> => \"1\"\n * <RenderString :value=\"true\" /> => \"true\"\n * <RenderString :value=\"false\" /> => \"false\"\n * <RenderString :value=\"null\" /> => \"null\"\n * <RenderString :value=\"undefined\" /> => \"undefined\"\n * <RenderString :value=\"{}\" /> => \"{}\"\n * <RenderString :value=\"[]\" /> => \"[]\"\n * <RenderString :value=\"['a', 'b', 'c']\" /> => \"['a', 'b', 'c']\"\n * <RenderString :value=\"() => 'hello'\" /> => \"() => 'hello'\"\n * <RenderString :value=\"Symbol('test')\" /> => \"Symbol(test)\"\n **/\nimport { computed } from 'vue'\n\nconst { value } = defineProps<{\n  value: any\n}>()\n\nconst valueAsString = computed(() => {\n  if (value === '') {\n    return `''`\n  }\n\n  if (value === null) {\n    return 'null'\n  }\n\n  if (value === undefined) {\n    return 'undefined'\n  }\n\n  // We don't need to cover all cases, Vue does a good job of rendering objects, arrays and functions.\n  return value\n})\n</script>\n\n<template>\n  {{ valueAsString }}\n</template>\n"],"mappings":""}

package/dist/schema/RenderString.vue.script.js

@@ -0,0 +1,14 @@
+import { computed as e, defineComponent as t, toDisplayString as n } from "vue";
+//#region src/schema/RenderString.vue?vue&type=script&setup=true&lang.ts
+var r = /*@__PURE__*/ t({
+	__name: "RenderString",
+	props: { value: {} },
+	setup(t) {
+		let r = e(() => t.value === "" ? "''" : t.value === null ? "null" : t.value === void 0 ? "undefined" : t.value);
+		return (e, t) => n(r.value);
+	}
+});
+//#endregion
+export { r as default };
+
+//# sourceMappingURL=RenderString.vue.script.js.map

package/dist/schema/RenderString.vue.script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderString.vue.script.js","names":[],"sources":["../../src/schema/RenderString.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/**\n * Give this component any data, and it tries to render a meaningful string.\n *\n * @example\n * <RenderString :value=\"1\" /> => \"1\"\n * <RenderString :value=\"true\" /> => \"true\"\n * <RenderString :value=\"false\" /> => \"false\"\n * <RenderString :value=\"null\" /> => \"null\"\n * <RenderString :value=\"undefined\" /> => \"undefined\"\n * <RenderString :value=\"{}\" /> => \"{}\"\n * <RenderString :value=\"[]\" /> => \"[]\"\n * <RenderString :value=\"['a', 'b', 'c']\" /> => \"['a', 'b', 'c']\"\n * <RenderString :value=\"() => 'hello'\" /> => \"() => 'hello'\"\n * <RenderString :value=\"Symbol('test')\" /> => \"Symbol(test)\"\n **/\nimport { computed } from 'vue'\n\nconst { value } = defineProps<{\n  value: any\n}>()\n\nconst valueAsString = computed(() => {\n  if (value === '') {\n    return `''`\n  }\n\n  if (value === null) {\n    return 'null'\n  }\n\n  if (value === undefined) {\n    return 'undefined'\n  }\n\n  // We don't need to cover all cases, Vue does a good job of rendering objects, arrays and functions.\n  return value\n})\n</script>\n\n<template>\n  {{ valueAsString }}\n</template>\n"],"mappings":";;;;;;EAsBA,IAAM,IAAgB,QAChB,EAAA,UAAU,KACL,OAGL,EAAA,UAAU,OACL,SAGL,EAAA,UAAU,KAAA,IACL,cAIF,EAAA,KACR;qBAII,EAAA,KAAa"}

package/dist/schema/Schema.vue.d.ts

@@ -0,0 +1,50 @@
+import type { WorkspaceEventBus } from '@scalar/workspace-store/events';
+import type { DiscriminatorObject, SchemaObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document';
+import type { SchemaOptions, SchemaRenderingProps } from './types';
+type __VLS_Props = {
+    schema?: SchemaObject;
+    /** Track how deep we've gone */
+    level?: number;
+    /**
+     * Real nesting depth. Not derived from `level`, whose stride differs per
+     * edge (object +2, composition +1, non-object root +0).
+     */
+    depth?: number;
+    name?: string;
+    /** A tighter layout with less borders and without a heading */
+    compact?: boolean;
+    /** Shows a toggle to hide/show children */
+    noncollapsible?: boolean;
+    /** Hide the heading */
+    hideHeading?: boolean;
+    /** Hide the schema description */
+    hideDescription?: boolean;
+    /** Show a special one way toggle for additional properties, also has a top border when open */
+    additionalProperties?: boolean;
+    /** Number of request body properties hidden behind the overflow control. */
+    additionalPropertyCount?: number;
+    /** Hide model names in type display */
+    hideModelNames?: boolean;
+    /** Discriminator object */
+    discriminator?: DiscriminatorObject;
+    /** Breadcrumb for the schema */
+    breadcrumb?: string[];
+    /** Event bus emitting actions */
+    eventBus: WorkspaceEventBus | null;
+    /** Move the options into a single prop so they are easy to pass around */
+    options: SchemaOptions;
+    /** When "requestBody", composition dropdown selection is synced with the example snippet */
+    schemaContext?: string;
+    /** Internal path used to sync nested request body compositions with the code sample */
+    compositionPath?: string[];
+    /**
+     * Stable identity of this schema node, derived from its raw (unresolved)
+     * value by the parent. Used to detect self-referential cycles. See
+     * {@link getCycleKey}.
+     */
+    cycleKey?: unknown;
+} & SchemaRenderingProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=Schema.vue.d.ts.map

package/dist/schema/Schema.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.vue.d.ts","sourceRoot":"","sources":["../../src/schema/Schema.vue"],"names":[],"mappings":"AAqqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAGvE,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACb,MAAM,8DAA8D,CAAA;AA4BrE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAElE,KAAK,WAAW,GAAG;IACf,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,uBAAuB;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,+FAA+F;IAC/F,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,4EAA4E;IAC5E,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,mBAAmB,CAAA;IACnC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,iCAAiC;IACjC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,0EAA0E;IAC1E,OAAO,EAAE,aAAa,CAAA;IACtB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,oBAAoB,CAAC;AAmqB3B,QAAA,MAAM,YAAY,kSAEhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/schema/Schema.vue.js

@@ -0,0 +1,9 @@
+import e from "../_virtual/_plugin-vue_export-helper.js";
+import t from "./Schema.vue.script.js";
+/* empty css                     */
+//#region src/schema/Schema.vue
+var n = /*#__PURE__*/ e(t, [["__scopeId", "data-v-8f822427"]]);
+//#endregion
+export { n as default };
+
+//# sourceMappingURL=Schema.vue.js.map