@scalar/blocks 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @scalar/blocks
 
+## 0.5.1
+
+### Patch Changes
+
+- [#10489](https://github.com/scalar/scalar/pull/10489): Report invalid non-exploded structured cookies in OpenAPI 3.2 documents and prevent invalid request and code sample generation. Recommend `style: cookie` with `explode: true`.
+- [#10479](https://github.com/scalar/scalar/pull/10479): Keep query parameter values raw for code examples that use client query maps, and encode values once when constructing snippet URLs.
+- [#10487](https://github.com/scalar/scalar/pull/10487): Honor OpenAPI 3.2 allowReserved for path parameters while escaping forbidden path characters and preserving the encoded path in Ruby code examples.
+
 ## 0.5.0
 
 ### Minor Changes

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

@@ -1 +1 @@
-{"version":3,"file":"generate-code-snippet.d.ts","sourceRoot":"","sources":["../../../src/code-example/helpers/generate-code-snippet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,kBAAkB,CAAA;AAE3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAEjH,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,2BAA2B,CAAA;AAIvF,KAAK,wBAAwB,GAAG;IAC9B,wGAAwG;IACxG,QAAQ,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAA;IAC1D,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,mFAAmF;IACnF,iBAAiB,EAAE,WAAW,EAAE,CAAA;IAChC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,SAAS,EAAE,eAAe,CAAA;IAC1B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,eAAe,EAAE,0BAA0B,EAAE,CAAA;IAC7C,mEAAmE;IACnE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,qFAAqF;IACrF,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gFAAgF;IAChF,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+BAA+B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxD,gDAAgD;IAChD,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC,CAAA;AAED,oHAAoH;AACpH,eAAO,MAAM,mBAAmB,GAAI,4NAejC,wBAAwB,KAAG,MAAM,GAAG,IAmDtC,CAAA"}
+{"version":3,"file":"generate-code-snippet.d.ts","sourceRoot":"","sources":["../../../src/code-example/helpers/generate-code-snippet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,kBAAkB,CAAA;AAE3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAA;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAEjH,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,2BAA2B,CAAA;AAKvF,KAAK,wBAAwB,GAAG;IAC9B,wGAAwG;IACxG,QAAQ,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAA;IAC1D,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,mFAAmF;IACnF,iBAAiB,EAAE,WAAW,EAAE,CAAA;IAChC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,SAAS,EAAE,eAAe,CAAA;IAC1B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,eAAe,EAAE,0BAA0B,EAAE,CAAA;IAC7C,mEAAmE;IACnE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,qFAAqF;IACrF,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gFAAgF;IAChF,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+BAA+B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxD,gDAAgD;IAChD,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC,CAAA;AAED,oHAAoH;AACpH,eAAO,MAAM,mBAAmB,GAAI,4NAejC,wBAAwB,KAAG,MAAM,GAAG,IAmDtC,CAAA"}

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

@@ -1,37 +1,38 @@
 import { getCustomClientIds as e } from "./generate-client-options.js";
 import { getSnippet as t } from "./get-snippet.js";
-import { operationToHar as n } from "./operation-to-har/operation-to-har.js";
-import { getResolvedRef as r } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { CookieSerializationError as n } from "./operation-to-har/process-parameters.js";
+import { operationToHar as r } from "./operation-to-har/operation-to-har.js";
+import { getResolvedRef as i } from "@scalar/workspace-store/helpers/get-resolved-ref";
 //#region src/code-example/helpers/generate-code-snippet.ts
-var i = ({ clientId: i, customCodeSamples: a, includeDefaultHeaders: o = !1, operation: s, method: c, path: l, example: u, contentType: d, server: f, securitySchemes: p, globalCookies: m, openapiVersion: h, requestBodyCompositionSelection: g, defaultDisabledParameters: _ }) => {
+var a = ({ clientId: a, customCodeSamples: o, includeDefaultHeaders: s = !1, operation: c, method: l, path: u, example: d, contentType: f, server: p, securitySchemes: m, globalCookies: h, openapiVersion: g, requestBodyCompositionSelection: _, defaultDisabledParameters: v }) => {
 	try {
-		if (!i) return "";
-		if (i.startsWith("custom")) {
-			let t = e(a), n = a.filter((e, n) => t[n] === i);
+		if (!a) return "";
+		if (a.startsWith("custom")) {
+			let t = e(o), n = o.filter((e, n) => t[n] === a);
 			if (!n.some((e) => e.example !== void 0)) return n[0]?.source ?? "Custom example not found";
-			let o = r(s.requestBody)?.content ?? {}, c = d ?? Object.keys(o)[0], l = u ?? Object.keys(o[c ?? ""]?.examples ?? {})[0];
-			return (n.find((e) => e.example === l && e.contentType === c) ?? n.find((e) => e.example === l && e.contentType === void 0))?.source ?? null;
+			let r = i(c.requestBody)?.content ?? {}, s = f ?? Object.keys(r)[0], l = d ?? Object.keys(r[s ?? ""]?.examples ?? {})[0];
+			return (n.find((e) => e.example === l && e.contentType === s) ?? n.find((e) => e.example === l && e.contentType === void 0))?.source ?? null;
 		}
-		let v = n({
-			operation: s,
-			contentType: d,
-			method: c,
-			path: l,
-			server: f,
-			securitySchemes: p,
-			example: u,
-			globalCookies: m,
-			includeDefaultHeaders: o,
-			openapiVersion: h,
-			requestBodyCompositionSelection: g,
-			defaultDisabledParameters: _
-		}), [y, b] = i.split("/"), [x, S] = t(y, b, v);
+		let n = r({
+			operation: c,
+			contentType: f,
+			method: l,
+			path: u,
+			server: p,
+			securitySchemes: m,
+			example: d,
+			globalCookies: h,
+			includeDefaultHeaders: s,
+			openapiVersion: g,
+			requestBodyCompositionSelection: _,
+			defaultDisabledParameters: v
+		}), [y, b] = a.split("/"), [x, S] = t(y, b, n);
 		return x ? (console.error("[generateCodeSnippet]", x), x.message ?? "Error generating code snippet") : S;
 	} catch (e) {
-		return console.error("[generateCodeSnippet]", e), "Error generating code snippet";
+		return console.error("[generateCodeSnippet]", e), e instanceof n ? e.message : "Error generating code snippet";
 	}
 };
 //#endregion
-export { i as generateCodeSnippet };
+export { a as generateCodeSnippet };
 
 //# sourceMappingURL=generate-code-snippet.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generate-code-snippet.js","names":[],"sources":["../../../src/code-example/helpers/generate-code-snippet.ts"],"sourcesContent":["import type { AvailableClient, ClientId, TargetId } from '@scalar/snippetz'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example'\nimport type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\n\nimport { type CustomCodeSampleId, getCustomClientIds } from './generate-client-options'\nimport { getSnippet } from './get-snippet'\nimport { operationToHar } from './operation-to-har/operation-to-har'\n\ntype GenerateCodeSnippetProps = {\n  /** The selected client/language for code generation (e.g., 'node/fetch') or a custom code sample ID. */\n  clientId: AvailableClient | CustomCodeSampleId | undefined\n  /** The Content-Type header value for the request body (e.g., 'application/json'). */\n  contentType: string | undefined\n  /** Array of custom code samples defined in the OpenAPI x-codeSamples extension. */\n  customCodeSamples: XCodeSample[]\n  /** The specific example value to use when generating the code snippet. */\n  example: string | undefined\n  /** The HTTP method for the operation (e.g., GET, POST, PUT). */\n  method: string\n  /** The OpenAPI operation object containing request/response details. */\n  operation: OperationObject\n  /** The API endpoint path (e.g., '/users/{id}'). */\n  path: string\n  /** Array of security schemes to apply to the request (e.g., API keys, OAuth). */\n  securitySchemes: SecuritySchemeObjectSecret[]\n  /** The server object defining the base URL for the API request. */\n  server: ServerObject | null\n  /** Workspace + document cookies */\n  globalCookies?: XScalarCookie[]\n  /** Whether to include default headers (e.g., Accept, Content-Type) automatically. */\n  includeDefaultHeaders?: boolean\n  /** Selected oneOf/anyOf variants for nested request body example generation. */\n  /** Originating OpenAPI version, used for XML mapping rules. */\n  openapiVersion?: string\n  requestBodyCompositionSelection?: Record<string, number>\n  /** Whether to disable parameters by default. */\n  defaultDisabledParameters?: boolean\n}\n\n/** Generate the code snippet for the selected example OR operation, or null when a linked sample is unavailable. */\nexport const generateCodeSnippet = ({\n  clientId,\n  customCodeSamples,\n  includeDefaultHeaders = false,\n  operation,\n  method,\n  path,\n  example,\n  contentType,\n  server,\n  securitySchemes,\n  globalCookies,\n  openapiVersion,\n  requestBodyCompositionSelection,\n  defaultDisabledParameters,\n}: GenerateCodeSnippetProps): string | null => {\n  try {\n    if (!clientId) {\n      return ''\n    }\n\n    // Use the selected custom example, matched by its language-keyed id\n    if (clientId.startsWith('custom')) {\n      const ids = getCustomClientIds(customCodeSamples)\n      const samples = customCodeSamples.filter((_, index) => ids[index] === clientId)\n      if (!samples.some((sample) => sample.example !== undefined)) {\n        return samples[0]?.source ?? 'Custom example not found'\n      }\n\n      const content = getResolvedRef(operation.requestBody)?.content ?? {}\n      const mediaType = contentType ?? Object.keys(content)[0]\n      const exampleKey = example ?? Object.keys(content[mediaType ?? '']?.examples ?? {})[0]\n      const sample =\n        samples.find((sample) => sample.example === exampleKey && sample.contentType === mediaType) ??\n        samples.find((sample) => sample.example === exampleKey && sample.contentType === undefined)\n      return sample?.source ?? null\n    }\n\n    const harRequest = operationToHar({\n      operation,\n      contentType,\n      method,\n      path,\n      server,\n      securitySchemes,\n      example,\n      globalCookies,\n      includeDefaultHeaders,\n      openapiVersion,\n      requestBodyCompositionSelection,\n      defaultDisabledParameters,\n    })\n\n    const [targetKey, clientKey] = clientId.split('/') as [TargetId, ClientId<TargetId>]\n\n    const [error, payload] = getSnippet(targetKey, clientKey, harRequest)\n    if (error) {\n      console.error('[generateCodeSnippet]', error)\n      return error.message ?? 'Error generating code snippet'\n    }\n\n    return payload\n  } catch (error) {\n    console.error('[generateCodeSnippet]', error)\n    return 'Error generating code snippet'\n  }\n}\n"],"mappings":";;;;;AA2CA,IAAa,KAAuB,EAClC,aACA,sBACA,2BAAwB,IACxB,cACA,WACA,SACA,YACA,gBACA,WACA,oBACA,kBACA,mBACA,oCACA,mCAC6C;CAC7C,IAAI;EACF,IAAI,CAAC,GACH,OAAO;EAIT,IAAI,EAAS,WAAW,QAAQ,GAAG;GACjC,IAAM,IAAM,EAAmB,CAAiB,GAC1C,IAAU,EAAkB,QAAQ,GAAG,MAAU,EAAI,OAAW,CAAQ;GAC9E,IAAI,CAAC,EAAQ,MAAM,MAAW,EAAO,YAAY,KAAA,CAAS,GACxD,OAAO,EAAQ,EAAE,EAAE,UAAU;GAG/B,IAAM,IAAU,EAAe,EAAU,WAAW,CAAC,EAAE,WAAW,CAAC,GAC7D,IAAY,KAAe,OAAO,KAAK,CAAO,CAAC,CAAC,IAChD,IAAa,KAAW,OAAO,KAAK,EAAQ,KAAa,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;GAIpF,QAFE,EAAQ,MAAM,MAAW,EAAO,YAAY,KAAc,EAAO,gBAAgB,CAAS,KAC1F,EAAQ,MAAM,MAAW,EAAO,YAAY,KAAc,EAAO,gBAAgB,KAAA,CAAS,EAAA,EAC7E,UAAU;EAC3B;EAEA,IAAM,IAAa,EAAe;GAChC;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAAC,GAEK,CAAC,GAAW,KAAa,EAAS,MAAM,GAAG,GAE3C,CAAC,GAAO,KAAW,EAAW,GAAW,GAAW,CAAU;EAMpE,OALI,KACF,QAAQ,MAAM,yBAAyB,CAAK,GACrC,EAAM,WAAW,mCAGnB;CACT,SAAS,GAAO;EAEd,OADA,QAAQ,MAAM,yBAAyB,CAAK,GACrC;CACT;AACF"}
+{"version":3,"file":"generate-code-snippet.js","names":[],"sources":["../../../src/code-example/helpers/generate-code-snippet.ts"],"sourcesContent":["import type { AvailableClient, ClientId, TargetId } from '@scalar/snippetz'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example'\nimport type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\n\nimport { type CustomCodeSampleId, getCustomClientIds } from './generate-client-options'\nimport { getSnippet } from './get-snippet'\nimport { operationToHar } from './operation-to-har/operation-to-har'\nimport { CookieSerializationError } from './operation-to-har/process-parameters'\n\ntype GenerateCodeSnippetProps = {\n  /** The selected client/language for code generation (e.g., 'node/fetch') or a custom code sample ID. */\n  clientId: AvailableClient | CustomCodeSampleId | undefined\n  /** The Content-Type header value for the request body (e.g., 'application/json'). */\n  contentType: string | undefined\n  /** Array of custom code samples defined in the OpenAPI x-codeSamples extension. */\n  customCodeSamples: XCodeSample[]\n  /** The specific example value to use when generating the code snippet. */\n  example: string | undefined\n  /** The HTTP method for the operation (e.g., GET, POST, PUT). */\n  method: string\n  /** The OpenAPI operation object containing request/response details. */\n  operation: OperationObject\n  /** The API endpoint path (e.g., '/users/{id}'). */\n  path: string\n  /** Array of security schemes to apply to the request (e.g., API keys, OAuth). */\n  securitySchemes: SecuritySchemeObjectSecret[]\n  /** The server object defining the base URL for the API request. */\n  server: ServerObject | null\n  /** Workspace + document cookies */\n  globalCookies?: XScalarCookie[]\n  /** Whether to include default headers (e.g., Accept, Content-Type) automatically. */\n  includeDefaultHeaders?: boolean\n  /** Selected oneOf/anyOf variants for nested request body example generation. */\n  /** Originating OpenAPI version, used for XML mapping rules. */\n  openapiVersion?: string\n  requestBodyCompositionSelection?: Record<string, number>\n  /** Whether to disable parameters by default. */\n  defaultDisabledParameters?: boolean\n}\n\n/** Generate the code snippet for the selected example OR operation, or null when a linked sample is unavailable. */\nexport const generateCodeSnippet = ({\n  clientId,\n  customCodeSamples,\n  includeDefaultHeaders = false,\n  operation,\n  method,\n  path,\n  example,\n  contentType,\n  server,\n  securitySchemes,\n  globalCookies,\n  openapiVersion,\n  requestBodyCompositionSelection,\n  defaultDisabledParameters,\n}: GenerateCodeSnippetProps): string | null => {\n  try {\n    if (!clientId) {\n      return ''\n    }\n\n    // Use the selected custom example, matched by its language-keyed id\n    if (clientId.startsWith('custom')) {\n      const ids = getCustomClientIds(customCodeSamples)\n      const samples = customCodeSamples.filter((_, index) => ids[index] === clientId)\n      if (!samples.some((sample) => sample.example !== undefined)) {\n        return samples[0]?.source ?? 'Custom example not found'\n      }\n\n      const content = getResolvedRef(operation.requestBody)?.content ?? {}\n      const mediaType = contentType ?? Object.keys(content)[0]\n      const exampleKey = example ?? Object.keys(content[mediaType ?? '']?.examples ?? {})[0]\n      const sample =\n        samples.find((sample) => sample.example === exampleKey && sample.contentType === mediaType) ??\n        samples.find((sample) => sample.example === exampleKey && sample.contentType === undefined)\n      return sample?.source ?? null\n    }\n\n    const harRequest = operationToHar({\n      operation,\n      contentType,\n      method,\n      path,\n      server,\n      securitySchemes,\n      example,\n      globalCookies,\n      includeDefaultHeaders,\n      openapiVersion,\n      requestBodyCompositionSelection,\n      defaultDisabledParameters,\n    })\n\n    const [targetKey, clientKey] = clientId.split('/') as [TargetId, ClientId<TargetId>]\n\n    const [error, payload] = getSnippet(targetKey, clientKey, harRequest)\n    if (error) {\n      console.error('[generateCodeSnippet]', error)\n      return error.message ?? 'Error generating code snippet'\n    }\n\n    return payload\n  } catch (error) {\n    console.error('[generateCodeSnippet]', error)\n    return error instanceof CookieSerializationError ? error.message : 'Error generating code snippet'\n  }\n}\n"],"mappings":";;;;;;AA4CA,IAAa,KAAuB,EAClC,aACA,sBACA,2BAAwB,IACxB,cACA,WACA,SACA,YACA,gBACA,WACA,oBACA,kBACA,mBACA,oCACA,mCAC6C;CAC7C,IAAI;EACF,IAAI,CAAC,GACH,OAAO;EAIT,IAAI,EAAS,WAAW,QAAQ,GAAG;GACjC,IAAM,IAAM,EAAmB,CAAiB,GAC1C,IAAU,EAAkB,QAAQ,GAAG,MAAU,EAAI,OAAW,CAAQ;GAC9E,IAAI,CAAC,EAAQ,MAAM,MAAW,EAAO,YAAY,KAAA,CAAS,GACxD,OAAO,EAAQ,EAAE,EAAE,UAAU;GAG/B,IAAM,IAAU,EAAe,EAAU,WAAW,CAAC,EAAE,WAAW,CAAC,GAC7D,IAAY,KAAe,OAAO,KAAK,CAAO,CAAC,CAAC,IAChD,IAAa,KAAW,OAAO,KAAK,EAAQ,KAAa,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;GAIpF,QAFE,EAAQ,MAAM,MAAW,EAAO,YAAY,KAAc,EAAO,gBAAgB,CAAS,KAC1F,EAAQ,MAAM,MAAW,EAAO,YAAY,KAAc,EAAO,gBAAgB,KAAA,CAAS,EAAA,EAC7E,UAAU;EAC3B;EAEA,IAAM,IAAa,EAAe;GAChC;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAAC,GAEK,CAAC,GAAW,KAAa,EAAS,MAAM,GAAG,GAE3C,CAAC,GAAO,KAAW,EAAW,GAAW,GAAW,CAAU;EAMpE,OALI,KACF,QAAQ,MAAM,yBAAyB,CAAK,GACrC,EAAM,WAAW,mCAGnB;CACT,SAAS,GAAO;EAEd,OADA,QAAQ,MAAM,yBAAyB,CAAK,GACrC,aAAiB,IAA2B,EAAM,UAAU;CACrE;AACF"}

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

@@ -38,7 +38,7 @@ export type OperationToHarProps = {
      * Selected oneOf/anyOf variants for nested request body example generation
      * (e.g. from the schema dropdowns in the API reference).
      */
-    /** Originating OpenAPI version, used for XML mapping rules. */
+    /** Originating OpenAPI version, used for version-specific serialization. */
     openapiVersion?: string;
     requestBodyCompositionSelection?: Record<string, number>;
     /**

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,UAkKxB,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,4EAA4E;IAC5E,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,UAgKxB,CAAA"}

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

@@ -36,6 +36,7 @@ var u = ({ includeDefaultHeaders: u = !1, operation: d, contentType: f, method:
 		let { url: e, headers: t, queryString: r, cookies: i, hasCookieStyleEntries: a, hasSerializedQuery: o } = n({
 			harRequest: w,
 			parameters: d.parameters,
+			openapiVersion: y,
 			example: g,
 			defaultDisabled: x
 		}), c = v?.filter((t) => s({
@@ -68,10 +69,7 @@ var u = ({ includeDefaultHeaders: u = !1, operation: d, contentType: f, method:
 	let O = E || d.parameters?.some((e) => a(e)?.in === "querystring");
 	if (_) {
 		let { headers: e, queryString: t, cookies: n } = r(_);
-		w.headers.push(...e), w.queryString.push(...t.map((e) => O ? {
-			...e,
-			value: encodeURIComponent(e.value)
-		} : e)), w.cookies.push(...n);
+		w.headers.push(...e), w.queryString.push(...t), w.cookies.push(...n);
 	}
 	let k = w.headers.find((e) => e.name.toLowerCase() === "cookie");
 	if (T && k && w.cookies.length) {
@@ -79,7 +77,7 @@ var u = ({ includeDefaultHeaders: u = !1, operation: d, contentType: f, method:
 		k.value = k.value ? `${k.value}; ${e}` : e, w.cookies = [];
 	}
 	if (O && w.queryString.length) {
-		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("&");
+		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)}=${encodeURIComponent(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"));

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  // 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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"}
+{"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 version-specific serialization. */\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      openapiVersion,\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    harRequest.queryString.push(...queryString)\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\n      .map(({ name, value }) => `${encodeURIComponent(name)}=${encodeURIComponent(value)}`)\n      .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":";;;;;;;;;AAuFA,IAAa,KAAkB,EAC7B,2BAAwB,IACxB,cACA,gBACA,WACA,SACA,YAAS,MACT,YACA,oBACA,kBACA,mBACA,oCACA,+BAA4B,SACS;CAWrC,IAAM,IAAsC,EAVrB,IACnB,EAAkB;EAChB;EACA;EACA,aAAa,KAAW;EACxB,qBAAqB;EACrB,uBAAuB;EACvB,SAAS;GAAE,YAAY,EAAW;GAAG,YAAY;EAAY;CAC/D,CAAC,IACD,CAAC,CAC2F,GAE1F,IACJ,EAAU,8BAA8B,GAAG,iBAAiB,GAAG,KAAW,cAAc,CAAC,GAKrF,IAAyB;EAC7B;EACA,KALgB,EAAiB,GAAQ,CAKpC;EACL,SAAS,OAAO,QAAQ,CAAmC,CAAC,CAAC,KAAK,CAAC,GAAM,QAAY;GAAE;GAAM;EAAM,EAAE;EACrG,aAAa,CAAC;EACd,UAAU,KAAA;EACV,aAAa;EACb,SAAS,CAAC;EACV,aAAa;EACb,UAAU;CACZ,GAEI,IAAwB,IACxB,IAAqB;CAGzB,IAAI,EAAU,YAAY;EACxB,IAAM,EACJ,QACA,YACA,gBACA,YACA,uBAAuB,GACvB,oBAAoB,MAClB,EAAkB;GACpB;GACA,YAAY,EAAU;GACtB;GACA;GACA,iBAAiB;EACnB,CAAC,GAGK,IACJ,GACI,QAAQ,MAAW,EAAmB;GAAE;GAAQ;GAAK;EAAsB,CAAC,CAAC,CAAC,EAC9E,KAAK,OAAY;GAAE,MAAM,EAAO;GAAM,OAAO,EAAO;EAAM,EAAE,KAAK,CAAC;EAOxE,AALA,IAAwB,GACxB,IAAqB,KAA4B,IACjD,EAAW,MAAM,GACjB,EAAW,UAAU,GACrB,EAAW,cAAc,GACzB,EAAW,UAAU,CAAC,GAAG,GAAuB,GAAG,CAAO;CAC5D;CAEA,IAAM,IAAO,EAAe,EAAU,WAAW;CAGjD,IAAI,GAAM,SAAS;EACjB,IAAM,IAAW,EAAY;GAC3B,aAAa;GACb;GACA;GACA;GACA;EACF,CAAC;EAED,IAAI,MACF,EAAW,WAAW,GACtB,EAAW,WAAW,EAAS,MAAM,UAAU,IAG3C,EAAS,WAAU;GACrB,IAAM,IAA4B,EAAW,QAAQ,MAClD,MAAW,EAAO,KAAK,YAAY,MAAM,cAC5C;GAEA,AACE,MACC,CAAC,EAA0B,SACzB,EAAS,SAAS,WAAW,YAAY,KACxC,EAAS,SAAS,SAAS,WAAW,KACtC,EAAS,SAAS,KAAA,KAEtB,EAA0B,QAAQ,EAAS,WAGnC,KACR,EAAW,QAAQ,KAAK;IACtB,MAAM;IACN,OAAO,EAAS;GAClB,CAAC;EAEL;CAEJ;CAEA,IAAM,IACJ,KAAsB,EAAU,YAAY,MAAM,MAAc,EAAe,CAAS,CAAC,EAAE,OAAO,aAAa;CAGjH,IAAI,GAAiB;EACnB,IAAM,EAAE,YAAS,gBAAa,eAAY,EAAuB,CAAe;EAGhF,AAFA,EAAW,QAAQ,KAAK,GAAG,CAAO,GAClC,EAAW,YAAY,KAAK,GAAG,CAAW,GAC1C,EAAW,QAAQ,KAAK,GAAG,CAAO;CACpC;CAIA,IAAM,IAAe,EAAW,QAAQ,MAAM,MAAW,EAAO,KAAK,YAAY,MAAM,QAAQ;CAC/F,IAAI,KAAyB,KAAgB,EAAW,QAAQ,QAAQ;EACtE,IAAM,IAAe,EAAW,QAC7B,KAAK,MAAW,GAAG,mBAAmB,EAAO,IAAI,EAAE,GAAG,mBAAmB,EAAO,KAAK,GAAG,CAAC,CACzF,KAAK,IAAI;EAEZ,AADA,EAAa,QAAQ,EAAa,QAAQ,GAAG,EAAa,MAAM,IAAI,MAAiB,GACrF,EAAW,UAAU,CAAC;CACxB;CAIA,IAAI,KAAoB,EAAW,YAAY,QAAQ;EACrD,IAAM,IAAY,EAAW,IAAI,QAAQ,GAAG,GACtC,IAAO,MAAc,KAAK,KAAK,EAAW,IAAI,MAAM,CAAS,GAC7D,IAAM,MAAc,KAAK,EAAW,MAAM,EAAW,IAAI,MAAM,GAAG,CAAS,GAC3E,IAAQ,EAAW,YACtB,KAAK,EAAE,SAAM,eAAY,GAAG,mBAAmB,CAAI,EAAE,GAAG,mBAAmB,CAAK,GAAG,CAAC,CACpF,KAAK,GAAG;EAEX,AADA,EAAW,MAAM,GAAG,IAAM,EAAI,SAAS,GAAG,IAAI,MAAM,MAAM,IAAQ,KAClE,EAAW,cAAc,CAAC;CAC5B;CAIA,AACE,EAAW,UAAU,aAAa,yBAClC,EAAW,SAAS,QAAQ,MAAM,MAAU,EAAM,aAAa,KAAA,CAAS,MAExE,EAAW,UAAU,EAAW,QAAQ,QAAQ,MAAW,EAAO,KAAK,YAAY,MAAM,cAAc;CAIzG,IAAI,IAAc;CAClB,KAAK,IAAM,KAAK,EAAW,SAEzB,MAAgB,EAAE,MAAM,UAAU,KAAK,KAAK,EAAE,OAAO,UAAU,KAAK;CAItE,OAFA,EAAW,cAAc,GAElB;AACT"}

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

@@ -1,5 +1,8 @@
 import type { OperationObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document';
 import type { Request as HarRequest } from 'har-format';
+/** An invalid cookie declaration that authors can repair before generating a sample. */
+export declare class CookieSerializationError extends Error {
+}
 type ProcessedParameters = {
     /** Named serialized examples already embedded in the URL. */
     hasSerializedQuery?: boolean;
@@ -16,13 +19,15 @@ type ProcessedParameters = {
  *
  * @see https://spec.openapis.org/oas/latest.html#style-values
  */
-export declare const processParameters: ({ harRequest, parameters, example, defaultDisabled, }: {
+export declare const processParameters: ({ harRequest, parameters, example, defaultDisabled, openapiVersion, }: {
     harRequest: HarRequest;
     parameters: OperationObject["parameters"];
     /** The name of the example to use */
     example?: string | undefined;
     /** Whether to disable parameters by default. */
     defaultDisabled: boolean;
+    /** Originating API description version. */
+    openapiVersion?: string;
 }) => ProcessedParameters;
 export {};
 //# sourceMappingURL=process-parameters.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"process-parameters.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-parameters.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AACpH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvD,KAAK,mBAAmB,GAAG;IACzB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9B,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IACtC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9B,+EAA+E;IAC/E,qBAAqB,EAAE,OAAO,CAAA;CAC/B,CAAA;AAyFD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,uDAK/B;IACD,UAAU,EAAE,UAAU,CAAA;IACtB,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gDAAgD;IAChD,eAAe,EAAE,OAAO,CAAA;CACzB,KAAG,mBA0NH,CAAA"}
+{"version":3,"file":"process-parameters.d.ts","sourceRoot":"","sources":["../../../../src/code-example/helpers/operation-to-har/process-parameters.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AACpH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvD,wFAAwF;AACxF,qBAAa,wBAAyB,SAAQ,KAAK;CAAG;AAEtD,KAAK,mBAAmB,GAAG;IACzB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9B,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IACtC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9B,+EAA+E;IAC/E,qBAAqB,EAAE,OAAO,CAAA;CAC/B,CAAA;AAiFD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,uEAM/B;IACD,UAAU,EAAE,UAAU,CAAA;IACtB,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gDAAgD;IAChD,eAAe,EAAE,OAAO,CAAA;IACxB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,KAAG,mBAwPH,CAAA"}

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

@@ -1,10 +1,12 @@
 import { getResolvedRef as e } from "@scalar/workspace-store/helpers/get-resolved-ref";
 import { deSerializeParameter as t, getExampleFromSchema as n, isParamDisabled as r, serializeContentValue as i, serializeCookieStyle as a, serializeDeepObjectStyle as o, serializeFormStyle as s, serializeFormStyleForCookies as c, serializePipeDelimitedStyle as l, serializeSimpleStyle as u, serializeSpaceDelimitedStyle as d } from "@scalar/workspace-store/request-example";
-import { isObjectLike as f } from "@scalar/helpers/object/is-object";
-import { getParameterExample as p } from "@scalar/workspace-store/helpers/get-parameter-example";
-import { getQuerystringParameter as m, serializeQuerystringParameter as h } from "@scalar/workspace-store/helpers/querystring-parameter";
+import { getCookieSerializationError as f } from "@scalar/helpers/http/get-cookie-serialization-error";
+import { isObjectLike as p } from "@scalar/helpers/object/is-object";
+import { assertReservedPathUrl as m, serializeReservedPathParameter as h } from "@scalar/workspace-store/helpers/encode-path-parameter";
+import { getParameterExample as g } from "@scalar/workspace-store/helpers/get-parameter-example";
+import { getQuerystringParameter as _, serializeQuerystringParameter as v } from "@scalar/workspace-store/helpers/querystring-parameter";
 //#region src/code-example/helpers/operation-to-har/process-parameters.ts
-var g = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), _ = (e) => "allowReserved" in e && e.allowReserved !== void 0 ? e.allowReserved : "schema" in e && e.schema && typeof e.schema == "object" && "allowReserved" in e.schema ? e.schema.allowReserved === !0 : !1, v = (e, t) => _(t) ? e : encodeURIComponent(e), y = (e) => {
+var y = class extends Error {}, b = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), x = (e) => "allowReserved" in e && e.allowReserved !== void 0 ? e.allowReserved : "schema" in e && e.schema && typeof e.schema == "object" && "allowReserved" in e.schema ? e.schema.allowReserved === !0 : !1, S = (e) => {
 	if (e.in === "header") return {
 		style: "simple",
 		explode: "explode" in e && e.explode !== void 0 && e.explode
@@ -27,67 +29,69 @@ var g = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), _ = (e) =
 		style: n,
 		explode: "explode" in e && e.explode !== void 0 ? e.explode : n === "form"
 	};
-}, b = (i, a, o) => {
-	let s = p(i, a), c = s.example;
+}, C = (i, a, o) => {
+	let s = g(i, a), c = s.example;
 	if (r(i, c, o)) return;
 	if (s.value !== void 0) return t(s.value, i);
 	if (!("schema" in i) || !i.schema) return;
 	let l = i.in === "path" ? { emptyString: `{${i.name}}` } : {}, u = e(i.schema);
 	return u ? n(u, l) : void 0;
-}, x = ({ harRequest: e, parameters: t, example: n, defaultDisabled: f }) => {
-	let _ = [...e.headers], x = [...e.queryString], C = [...e.cookies], w = [], T = e.url, E = [], D = [], O = g(t);
-	for (let e of O) {
+}, w = ({ harRequest: e, parameters: t, example: n, defaultDisabled: p, openapiVersion: w }) => {
+	let E = [...e.headers], D = [...e.queryString], O = [...e.cookies], k = [], A = e.url, j = !1, M = [], N = [], P = (e, t, n) => {
+		x(n) ? M.push(`${encodeURIComponent(e)}=${t}`) : D.push({
+			name: e,
+			value: t
+		});
+	}, F = b(t);
+	for (let e of F) {
 		if (!e.in || !e.name) continue;
 		if (e.in === "querystring") {
-			let t = m(e, n, { defaultDisabled: f });
+			let t = _(e, n, { defaultDisabled: p });
 			if (t) {
-				let e = T.indexOf("#"), n = e === -1 ? "" : T.slice(e), r = (e === -1 ? T : T.slice(0, e)).split("?")[0], i = h(t);
-				T = `${r}${i ? `?${i}` : ""}${n}`;
+				let e = A.indexOf("#"), n = e === -1 ? "" : A.slice(e), r = (e === -1 ? A : A.slice(0, e)).split("?")[0], i = v(t);
+				A = `${r}${i ? `?${i}` : ""}${n}`;
 			}
 			continue;
 		}
-		let t = p(e, n);
-		if (t.serialized && !r(e, t.example, f)) {
+		let t = g(e, n);
+		if (t.serialized && !r(e, t.example, p)) {
 			let n = String(t.value);
 			switch (e.in) {
 				case "path":
-					T = T.replaceAll(`{${e.name}}`, () => n);
+					A = A.replaceAll(`{${e.name}}`, () => n);
 					break;
 				case "query":
-					E.push(n);
+					M.push(n);
 					break;
 				case "header":
-					_.push({
+					E.push({
 						name: e.name,
 						value: n
 					});
 					break;
 				case "cookie":
-					D.push(n);
+					N.push(n);
 					break;
 			}
 			continue;
 		}
-		if (t.mediaSerialized && !r(e, t.example, f)) {
+		if (t.mediaSerialized && !r(e, t.example, p)) {
 			let n = String(t.value);
 			switch (e.in) {
 				case "query":
-					x.push({
-						name: e.name,
-						value: v(n, e)
-					});
+					P(e.name, n, e);
 					break;
 				case "header":
-					_.push({
+					E.push({
 						name: e.name,
 						value: n
 					});
 					break;
 				case "path":
-					T = T.replaceAll(`{${e.name}}`, () => encodeURIComponent(n));
+					A = A.replaceAll(`{${e.name}}`, () => encodeURIComponent(n));
 					break;
 				case "cookie":
-					C.push({
+					O.push({
 						name: e.name,
 						value: n
 					});
@@ -95,141 +99,118 @@ var g = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), _ = (e) =
 			}
 			continue;
 		}
-		let g = b(e, n, f);
-		if (g === void 0) continue;
-		let { style: O, explode: k } = y(e);
+		let m = C(e, n, p);
+		if (m === void 0) continue;
+		let { style: b, explode: x } = S(e);
 		switch (e.in) {
-			case "path":
-				T = S(T, e, g, O, k);
+			case "path": {
+				let t = w?.startsWith("3.2.") && "schema" in e && e.allowReserved === !0;
+				j ||= !!t;
+				let n = t ? h(e.name, {
+					value: m,
+					style: b,
+					explode: x
+				}) : void 0;
+				A = n === void 0 ? T(A, e, m, b, x) : A.replaceAll(`{${e.name}}`, () => n);
 				break;
+			}
 			case "query":
 				if ("content" in e && e.content) {
-					let t = i(g, Object.keys(e.content)[0] ?? "application/json");
-					x.push({
-						name: e.name,
-						value: v(t, e)
-					});
+					let t = i(m, Object.keys(e.content)[0] ?? "application/json");
+					P(e.name, t, e);
 					break;
 				}
-				switch (O) {
+				switch (b) {
 					case "form": {
-						let t = s(g, k);
-						if (Array.isArray(t)) for (let n of t) {
-							let t = n.key || e.name;
-							x.push({
-								name: t,
-								value: v(String(n.value), e)
-							});
-						}
-						else x.push({
-							name: e.name,
-							value: v(String(t), e)
-						});
+						let t = s(m, x);
+						if (Array.isArray(t)) for (let n of t) P(n.key || e.name, String(n.value), e);
+						else P(e.name, String(t), e);
 						break;
 					}
 					case "spaceDelimited": {
-						let t = d(g);
-						x.push({
-							name: e.name,
-							value: v(t, e)
-						});
+						let t = d(m);
+						P(e.name, t, e);
 						break;
 					}
 					case "pipeDelimited": {
-						let t = l(g);
-						x.push({
-							name: e.name,
-							value: v(t, e)
-						});
+						let t = l(m);
+						P(e.name, t, e);
 						break;
 					}
 					case "deepObject":
-						if (Array.isArray(g)) {
-							let t = s(g, !0);
-							if (Array.isArray(t)) for (let n of t) {
-								let t = n.key || e.name;
-								x.push({
-									name: t,
-									value: v(String(n.value), e)
-								});
-							}
-							else x.push({
-								name: e.name,
-								value: v(String(t), e)
-							});
+						if (Array.isArray(m)) {
+							let t = s(m, !0);
+							if (Array.isArray(t)) for (let n of t) P(n.key || e.name, String(n.value), e);
+							else P(e.name, String(t), e);
 						} else {
-							let t = o(e.name, g);
-							for (let n of t) x.push({
-								name: n.key,
-								value: v(n.value, e)
-							});
+							let t = o(e.name, m);
+							for (let n of t) P(n.key, n.value, e);
 						}
 						break;
-					default: x.push({
-						name: e.name,
-						value: v(String(g), e)
-					});
+					default: P(e.name, String(m), e);
 				}
 				break;
 			case "header": {
-				let t = u(g, k);
-				_.push({
+				let t = u(m, x);
+				E.push({
 					name: e.name,
 					value: String(t)
 				});
 				break;
 			}
 			case "cookie": {
-				if (O === "cookie") {
-					w.push(...a(e.name, g, k));
+				let [t, n] = (w ?? "").split("."), r = t === "3" && n === "2" && !("content" in e) ? f(e, m) : void 0;
+				if (r) throw new y(r);
+				if (b === "cookie") {
+					k.push(...a(e.name, m, x));
 					break;
 				}
-				let t = c(g, k);
-				if (Array.isArray(t)) for (let n of t) {
-					let t = n.key || e.name, r = n.value === null ? "null" : String(n.value);
-					C.push({
-						name: t,
+				let i = c(m, x);
+				if (Array.isArray(i)) for (let t of i) {
+					let n = t.key || e.name, r = t.value === null ? "null" : String(t.value);
+					O.push({
+						name: n,
 						value: r
 					});
 				}
 				else {
-					let n = t === null ? "null" : String(t);
-					C.push({
+					let t = i === null ? "null" : String(i);
+					O.push({
 						name: e.name,
-						value: n
+						value: t
 					});
 				}
 				break;
 			}
 		}
 	}
-	if (w.length || D.length) {
+	if (k.length || N.length) {
 		let e = [
-			...C.map((e) => `${encodeURIComponent(e.name)}=${encodeURIComponent(e.value)}`),
-			...w.map((e) => `${e.name}=${e.value}`),
-			...D
-		].join("; "), t = _.find((e) => e.name.toLowerCase() === "cookie");
-		t ? _.splice(_.indexOf(t), 1, {
+			...O.map((e) => `${encodeURIComponent(e.name)}=${encodeURIComponent(e.value)}`),
+			...k.map((e) => `${e.name}=${e.value}`),
+			...N
+		].join("; "), t = E.find((e) => e.name.toLowerCase() === "cookie");
+		t ? E.splice(E.indexOf(t), 1, {
 			...t,
 			value: t.value ? `${t.value}; ${e}` : e
-		}) : _.push({
+		}) : E.push({
 			name: "Cookie",
 			value: e
 		});
 	}
-	if (E.length) {
-		let e = T.indexOf("#"), t = e < 0 ? "" : T.slice(e), n = e < 0 ? T : T.slice(0, e);
-		T = `${n}${n.includes("?") ? "&" : "?"}${E.join("&")}${t}`;
+	if (M.length) {
+		let e = A.indexOf("#"), t = e < 0 ? "" : A.slice(e), n = e < 0 ? A : A.slice(0, e);
+		A = `${n}${n.includes("?") ? "&" : "?"}${M.join("&")}${t}`;
 	}
-	return {
-		url: T,
-		headers: _,
-		queryString: x,
-		cookies: w.length || D.length ? [] : C,
-		hasCookieStyleEntries: w.length > 0 || D.length > 0,
-		...E.length ? { hasSerializedQuery: !0 } : {}
+	return j && m(A), {
+		url: A,
+		headers: E,
+		queryString: D,
+		cookies: k.length || N.length ? [] : O,
+		hasCookieStyleEntries: k.length > 0 || N.length > 0,
+		...M.length ? { hasSerializedQuery: !0 } : {}
 	};
-}, S = (e, t, n, r, i) => {
+}, T = (e, t, n, r, i) => {
 	switch (r) {
 		case "matrix":
 			if (i) {
@@ -237,14 +218,14 @@ var g = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), _ = (e) =
 					let r = n.map((e) => `${t.name}=${e}`).join(";");
 					return e.replace(`{;${t.name}}`, `;${r}`);
 				}
-				if (f(n)) {
+				if (p(n)) {
 					let r = Object.entries(n).map(([e, t]) => `${e}=${t}`).join(";");
 					return e.replace(`{;${t.name}}`, `;${r}`);
 				}
 				return e.replace(`{;${t.name}}`, `;${t.name}=${n}`);
 			}
 			if (Array.isArray(n)) return e.replace(`{;${t.name}}`, `;${t.name}=${n.join(",")}`);
-			if (f(n)) {
+			if (p(n)) {
 				let r = Object.entries(n).map(([e, t]) => `${e},${t}`).join(",");
 				return e.replace(`{;${t.name}}`, `;${t.name}=${r}`);
 			}
@@ -252,14 +233,14 @@ var g = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), _ = (e) =
 		case "label":
 			if (i) {
 				if (Array.isArray(n)) return e.replace(`{.${t.name}}`, `.${n.join(".")}`);
-				if (f(n)) {
+				if (p(n)) {
 					let r = Object.entries(n).map(([e, t]) => `${e}=${t}`).join(".");
 					return e.replace(`{.${t.name}}`, `.${r}`);
 				}
 				return e.replace(`{.${t.name}}`, `.${n}`);
 			}
 			if (Array.isArray(n)) return e.replace(`{.${t.name}}`, `.${n.join(",")}`);
-			if (f(n)) {
+			if (p(n)) {
 				let r = Object.entries(n).map(([e, t]) => `${e},${t}`).join(",");
 				return e.replace(`{.${t.name}}`, `.${r}`);
 			}
@@ -272,6 +253,6 @@ var g = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), _ = (e) =
 	}
 };
 //#endregion
-export { x as processParameters };
+export { y as CookieSerializationError, w as processParameters };
 
 //# sourceMappingURL=process-parameters.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"process-parameters.js","names":[],"sources":["../../../../src/code-example/helpers/operation-to-har/process-parameters.ts"],"sourcesContent":["import { isObjectLike } from '@scalar/helpers/object/is-object'\nimport { getParameterExample } from '@scalar/workspace-store/helpers/get-parameter-example'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport {\n  getQuerystringParameter,\n  serializeQuerystringParameter,\n} from '@scalar/workspace-store/helpers/querystring-parameter'\nimport {\n  deSerializeParameter,\n  getExampleFromSchema,\n  isParamDisabled,\n  serializeContentValue,\n  serializeCookieStyle,\n  serializeDeepObjectStyle,\n  serializeFormStyle,\n  serializeFormStyleForCookies,\n  serializePipeDelimitedStyle,\n  serializeSimpleStyle,\n  serializeSpaceDelimitedStyle,\n} from '@scalar/workspace-store/request-example'\nimport type { OperationObject, ParameterObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport type { Request as HarRequest } from 'har-format'\n\ntype ProcessedParameters = {\n  /** Named serialized examples already embedded in the URL. */\n  hasSerializedQuery?: boolean\n  url: string\n  headers: HarRequest['headers']\n  queryString: HarRequest['queryString']\n  cookies: HarRequest['cookies']\n  /** Whether serialized cookie-style values require a complete Cookie header. */\n  hasCookieStyleEntries: boolean\n}\n\n/** Ensures we don't have any references in the parameters */\nconst deReferenceParams = (params: OperationObject['parameters']): ParameterObject[] =>\n  (params ?? []).map((param) => getResolvedRef(param)).filter((param) => param !== undefined)\n\n/** Whether the parameter allows reserved characters (from param or schema). */\nconst isAllowReserved = (param: ParameterObject): boolean => {\n  if ('allowReserved' in param && param.allowReserved !== undefined) {\n    return param.allowReserved\n  }\n  if ('schema' in param && param.schema && typeof param.schema === 'object' && 'allowReserved' in param.schema) {\n    return (param.schema as { allowReserved?: boolean }).allowReserved === true\n  }\n  return false\n}\n\n/** URL encode a value if allowReserved is not set to true. */\nconst encodeQueryValue = (value: string, param: ParameterObject): string => {\n  if (isAllowReserved(param)) {\n    return value\n  }\n  return encodeURIComponent(value)\n}\n\n/**\n * Get the style and explode values for a parameter according to OpenAPI 3.1.1 specification.\n * Handles defaults and validation for parameter location restrictions.\n */\nconst getParameterStyleAndExplode = (param: ParameterObject): { style: string; explode: boolean } => {\n  // Headers only support 'simple' style\n  if (param.in === 'header') {\n    const explode = 'explode' in param && param.explode !== undefined ? param.explode : false\n    return { style: 'simple', explode }\n  }\n\n  // Cookies default to form for compatibility and also support cookie style.\n  if (param.in === 'cookie') {\n    const explode = 'explode' in param && param.explode !== undefined ? param.explode : true\n    return { style: 'style' in param && param.style === 'cookie' ? 'cookie' : 'form', explode }\n  }\n\n  const defaultStyle = {\n    path: 'simple',\n    query: 'form',\n    querystring: 'form',\n    header: 'simple',\n    cookie: 'form',\n  }[param.in]\n\n  // Use provided style or default based on location\n  const style = 'style' in param && param.style ? param.style : defaultStyle\n\n  // Determine explode value: use provided value or default based on style\n  const explode = 'explode' in param && param.explode !== undefined ? param.explode : style === 'form'\n\n  return { style, explode }\n}\n\n/**\n * Extract the value for a parameter from example data or schema.\n * Prioritizes example data over schema examples.\n * Returns null if the parameter is disabled so we can skip it.\n */\nconst getParameterValue = (param: ParameterObject, example: string | undefined, defaultDisabled: boolean): unknown => {\n  // Try to get value from example first\n  const selected = getParameterExample(param, example)\n  const exampleValue = selected.example\n\n  // If the parameter is disabled, return undefined so we can skip it.\n  if (isParamDisabled(param, exampleValue, defaultDisabled)) {\n    return undefined\n  }\n\n  // If the example value is set, return it.\n  if (selected.value !== undefined) {\n    return deSerializeParameter(selected.value, param)\n  }\n\n  // Fall back to schema example if available\n  if (!('schema' in param) || !param.schema) {\n    return undefined\n  }\n\n  const options = param.in === 'path' ? { emptyString: `{${param.name}}` } : {}\n  const schema = getResolvedRef(param.schema)\n  return schema ? getExampleFromSchema(schema, options) : undefined\n}\n\n/**\n * Process OpenAPI parameters and return the updated properties.\n * Handles path, query, and header parameters with various styles and explode options.\n *\n * @see https://spec.openapis.org/oas/latest.html#style-values\n */\nexport const processParameters = ({\n  harRequest,\n  parameters,\n  example,\n  defaultDisabled,\n}: {\n  harRequest: HarRequest\n  parameters: OperationObject['parameters']\n  /** The name of the example to use */\n  example?: string | undefined\n  /** Whether to disable parameters by default. */\n  defaultDisabled: boolean\n}): ProcessedParameters => {\n  // Create copies of the arrays to avoid modifying the input\n  const newHeaders = [...harRequest.headers]\n  const newQueryString = [...harRequest.queryString]\n  const newCookies = [...harRequest.cookies]\n  const cookieStyleEntries: HarRequest['cookies'] = []\n  let newUrl = harRequest.url\n  const serializedQuery: string[] = []\n  const serializedCookies: string[] = []\n\n  // Filter out references\n  const deReferencedParams = deReferenceParams(parameters)\n\n  for (const param of deReferencedParams) {\n    if (!param.in || !param.name) {\n      continue\n    }\n\n    if (param.in === 'querystring') {\n      const querystring = getQuerystringParameter(param, example, { defaultDisabled })\n      if (querystring) {\n        const hashIndex = newUrl.indexOf('#')\n        const hash = hashIndex === -1 ? '' : newUrl.slice(hashIndex)\n        const base = (hashIndex === -1 ? newUrl : newUrl.slice(0, hashIndex)).split('?')[0]\n        const query = serializeQuerystringParameter(querystring)\n        newUrl = `${base}${query ? `?${query}` : ''}${hash}`\n      }\n      continue\n    }\n\n    const selected = getParameterExample(param, example)\n    if (selected.serialized && !isParamDisabled(param, selected.example, defaultDisabled)) {\n      const wireValue = String(selected.value)\n      switch (param.in) {\n        case 'path':\n          newUrl = newUrl.replaceAll(`{${param.name}}`, () => wireValue)\n          break\n        case 'query':\n          serializedQuery.push(wireValue)\n          break\n        case 'header':\n          newHeaders.push({ name: param.name, value: wireValue })\n          break\n        case 'cookie':\n          serializedCookies.push(wireValue)\n          break\n      }\n      continue\n    }\n    if (selected.mediaSerialized && !isParamDisabled(param, selected.example, defaultDisabled)) {\n      const text = String(selected.value)\n      switch (param.in) {\n        case 'query':\n          newQueryString.push({ name: param.name, value: encodeQueryValue(text, param) })\n          break\n        case 'header':\n          newHeaders.push({ name: param.name, value: text })\n          break\n        case 'path':\n          newUrl = newUrl.replaceAll(`{${param.name}}`, () => encodeURIComponent(text))\n          break\n        case 'cookie':\n          newCookies.push({ name: param.name, value: text })\n          break\n      }\n      continue\n    }\n    const paramValue = getParameterValue(param, example, defaultDisabled)\n    if (paramValue === undefined) {\n      continue\n    }\n\n    const { style, explode } = getParameterStyleAndExplode(param)\n\n    switch (param.in) {\n      case 'path': {\n        newUrl = processPathParameters(newUrl, param, paramValue, style, explode)\n        break\n      }\n\n      case 'query': {\n        // Content type parameters should be serialized according to the parameter's own content type\n        if ('content' in param && param.content) {\n          // We grab the first for now but eventually we should support selecting the content type per parameter\n          const paramContentType = Object.keys(param.content)[0] ?? 'application/json'\n          const serializedValue = serializeContentValue(paramValue, paramContentType)\n          newQueryString.push({ name: param.name, value: encodeQueryValue(serializedValue, param) })\n          break\n        }\n\n        // Handle query parameters\n        switch (style) {\n          case 'form': {\n            const serialized = serializeFormStyle(paramValue, explode)\n\n            // If serialized is an array of key-value pairs (exploded object or array)\n            if (Array.isArray(serialized)) {\n              for (const entry of serialized) {\n                const key = entry.key || param.name\n                newQueryString.push({ name: key, value: encodeQueryValue(String(entry.value), param) })\n              }\n            }\n            // Otherwise, convert to string\n            else {\n              newQueryString.push({ name: param.name, value: encodeQueryValue(String(serialized), param) })\n            }\n            break\n          }\n          case 'spaceDelimited': {\n            const serialized = serializeSpaceDelimitedStyle(paramValue)\n            newQueryString.push({ name: param.name, value: encodeQueryValue(serialized, param) })\n            break\n          }\n          case 'pipeDelimited': {\n            const serialized = serializePipeDelimitedStyle(paramValue)\n            newQueryString.push({ name: param.name, value: encodeQueryValue(serialized, param) })\n            break\n          }\n          case 'deepObject': {\n            // OAS marks deepObject-on-array and deepObject+explode:false as undefined.\n            // Mirror process-body: fall back to form/explode:true for arrays and always\n            // invoke the serializer for objects so authors get useful output instead of\n            // a silently-dropped parameter.\n            if (Array.isArray(paramValue)) {\n              const serialized = serializeFormStyle(paramValue, true)\n              if (Array.isArray(serialized)) {\n                for (const entry of serialized) {\n                  const key = entry.key || param.name\n                  newQueryString.push({ name: key, value: encodeQueryValue(String(entry.value), param) })\n                }\n              } else {\n                newQueryString.push({ name: param.name, value: encodeQueryValue(String(serialized), param) })\n              }\n            } else {\n              const entries = serializeDeepObjectStyle(param.name, paramValue)\n              for (const entry of entries) {\n                newQueryString.push({ name: entry.key, value: encodeQueryValue(entry.value, param) })\n              }\n            }\n            break\n          }\n\n          // Default to form style\n          default:\n            newQueryString.push({ name: param.name, value: encodeQueryValue(String(paramValue), param) })\n        }\n        break\n      }\n\n      // Headers only support 'simple' style according to OpenAPI 3.1.1\n      // For arrays, simple style always produces comma-separated values regardless of explode\n      // The explode parameter only affects object serialization\n      case 'header': {\n        const serialized = serializeSimpleStyle(paramValue, explode)\n        newHeaders.push({ name: param.name, value: String(serialized) })\n        break\n      }\n\n      // Keep cookie style separate so snippet generators cannot percent-encode it.\n      case 'cookie': {\n        if (style === 'cookie') {\n          cookieStyleEntries.push(...serializeCookieStyle(param.name, paramValue, explode))\n          break\n        }\n        const serialized = serializeFormStyleForCookies(paramValue, explode)\n\n        // If serialized is an array of key-value pairs (exploded object or array)\n        if (Array.isArray(serialized)) {\n          for (const entry of serialized) {\n            const key = entry.key || param.name\n            const value = entry.value === null ? 'null' : String(entry.value)\n            newCookies.push({ name: key, value })\n          }\n        }\n        // Otherwise, convert to string\n        else {\n          const value = serialized === null ? 'null' : String(serialized)\n          newCookies.push({ name: param.name, value })\n        }\n        break\n      }\n    }\n  }\n\n  // HAR cookie entries are encoded by snippet generators. Use a complete header\n  // when cookie style is present, preserving legacy encoding for other cookies.\n  if (cookieStyleEntries.length || serializedCookies.length) {\n    const cookieValue = [\n      ...newCookies.map((cookie) => `${encodeURIComponent(cookie.name)}=${encodeURIComponent(cookie.value)}`),\n      ...cookieStyleEntries.map((cookie) => `${cookie.name}=${cookie.value}`),\n      ...serializedCookies,\n    ].join('; ')\n    const existing = newHeaders.find((header) => header.name.toLowerCase() === 'cookie')\n    if (existing) {\n      newHeaders.splice(newHeaders.indexOf(existing), 1, {\n        ...existing,\n        value: existing.value ? `${existing.value}; ${cookieValue}` : cookieValue,\n      })\n    } else {\n      newHeaders.push({ name: 'Cookie', value: cookieValue })\n    }\n  }\n\n  if (serializedQuery.length) {\n    const hashIndex = newUrl.indexOf('#')\n    const hash = hashIndex < 0 ? '' : newUrl.slice(hashIndex)\n    const base = hashIndex < 0 ? newUrl : newUrl.slice(0, hashIndex)\n    newUrl = `${base}${base.includes('?') ? '&' : '?'}${serializedQuery.join('&')}${hash}`\n  }\n\n  return {\n    url: newUrl,\n    headers: newHeaders,\n    queryString: newQueryString,\n    cookies: cookieStyleEntries.length || serializedCookies.length ? [] : newCookies,\n    hasCookieStyleEntries: cookieStyleEntries.length > 0 || serializedCookies.length > 0,\n    ...(serializedQuery.length ? { hasSerializedQuery: true } : {}),\n  }\n}\n\n/**\n * Process path parameters according to OpenAPI specification.\n * Handles matrix, label, and simple styles with explode options.\n *\n * @param url - The URL to process\n * @param param - The parameter object\n * @param paramValue - The value of the parameter\n * @param style - The style of the parameter (matrix, label, simple)\n * @param explode - Whether to explode the parameter\n * @returns The updated URL with processed path parameters\n */\nconst processPathParameters = (\n  url: string,\n  param: ParameterObject,\n  paramValue: unknown,\n  style: string,\n  explode: boolean,\n): string => {\n  switch (style) {\n    case 'matrix': {\n      if (explode) {\n        // Matrix explode array: ;color=blue;color=black;color=brown\n        if (Array.isArray(paramValue)) {\n          const values = paramValue.map((v: unknown) => `${param.name}=${v}`).join(';')\n          return url.replace(`{;${param.name}}`, `;${values}`)\n        }\n\n        // Matrix explode object: ;R=100;G=200;B=150\n        if (isObjectLike(paramValue)) {\n          const values = Object.entries(paramValue)\n            .map(([k, v]) => `${k}=${v}`)\n            .join(';')\n          return url.replace(`{;${param.name}}`, `;${values}`)\n        }\n\n        // Matrix explode primitive: ;color=blue\n        return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue}`)\n      }\n\n      // Matrix no explode array: ;color=blue,black,brown\n      if (Array.isArray(paramValue)) {\n        return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue.join(',')}`)\n      }\n\n      // Matrix no explode object: ;color=R,100,G,200,B,150\n      if (isObjectLike(paramValue)) {\n        const values = Object.entries(paramValue)\n          .map(([k, v]) => `${k},${v}`)\n          .join(',')\n        return url.replace(`{;${param.name}}`, `;${param.name}=${values}`)\n      }\n\n      // Matrix no explode primitive: ;color=blue\n      return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue}`)\n    }\n    case 'label': {\n      if (explode) {\n        // Label explode array: .blue.black.brown\n        if (Array.isArray(paramValue)) {\n          return url.replace(`{.${param.name}}`, `.${paramValue.join('.')}`)\n        }\n\n        // Label explode object: .R=100.G=200.B=150\n        if (isObjectLike(paramValue)) {\n          const values = Object.entries(paramValue)\n            .map(([k, v]) => `${k}=${v}`)\n            .join('.')\n\n          return url.replace(`{.${param.name}}`, `.${values}`)\n        }\n\n        // Label explode primitive: .blue\n        return url.replace(`{.${param.name}}`, `.${paramValue}`)\n      }\n\n      // Label no explode array: .blue,black,brown\n      if (Array.isArray(paramValue)) {\n        return url.replace(`{.${param.name}}`, `.${paramValue.join(',')}`)\n      }\n\n      // Label no explode object: .R,100,G,200,B,150\n      if (isObjectLike(paramValue)) {\n        const values = Object.entries(paramValue)\n          .map(([k, v]) => `${k},${v}`)\n          .join(',')\n\n        return url.replace(`{.${param.name}}`, `.${values}`)\n      }\n\n      // Label no explode primitive: .blue\n      return url.replace(`{.${param.name}}`, `.${paramValue}`)\n    }\n\n    case 'simple': {\n      const serialized = serializeSimpleStyle(paramValue, explode)\n      return url.replace(`{${param.name}}`, String(serialized))\n    }\n\n    // Default to simple style\n    default:\n      return url.replace(`{${param.name}}`, String(paramValue))\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"process-parameters.js","names":[],"sources":["../../../../src/code-example/helpers/operation-to-har/process-parameters.ts"],"sourcesContent":["import { getCookieSerializationError } from '@scalar/helpers/http/get-cookie-serialization-error'\nimport { isObjectLike } from '@scalar/helpers/object/is-object'\nimport {\n  assertReservedPathUrl,\n  serializeReservedPathParameter,\n} from '@scalar/workspace-store/helpers/encode-path-parameter'\nimport { getParameterExample } from '@scalar/workspace-store/helpers/get-parameter-example'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport {\n  getQuerystringParameter,\n  serializeQuerystringParameter,\n} from '@scalar/workspace-store/helpers/querystring-parameter'\nimport {\n  deSerializeParameter,\n  getExampleFromSchema,\n  isParamDisabled,\n  serializeContentValue,\n  serializeCookieStyle,\n  serializeDeepObjectStyle,\n  serializeFormStyle,\n  serializeFormStyleForCookies,\n  serializePipeDelimitedStyle,\n  serializeSimpleStyle,\n  serializeSpaceDelimitedStyle,\n} from '@scalar/workspace-store/request-example'\nimport type { OperationObject, ParameterObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport type { Request as HarRequest } from 'har-format'\n\n/** An invalid cookie declaration that authors can repair before generating a sample. */\nexport class CookieSerializationError extends Error {}\n\ntype ProcessedParameters = {\n  /** Named serialized examples already embedded in the URL. */\n  hasSerializedQuery?: boolean\n  url: string\n  headers: HarRequest['headers']\n  queryString: HarRequest['queryString']\n  cookies: HarRequest['cookies']\n  /** Whether serialized cookie-style values require a complete Cookie header. */\n  hasCookieStyleEntries: boolean\n}\n\n/** Ensures we don't have any references in the parameters */\nconst deReferenceParams = (params: OperationObject['parameters']): ParameterObject[] =>\n  (params ?? []).map((param) => getResolvedRef(param)).filter((param) => param !== undefined)\n\n/** Whether the parameter allows reserved characters (from param or schema). */\nconst isAllowReserved = (param: ParameterObject): boolean => {\n  if ('allowReserved' in param && param.allowReserved !== undefined) {\n    return param.allowReserved\n  }\n  if ('schema' in param && param.schema && typeof param.schema === 'object' && 'allowReserved' in param.schema) {\n    return (param.schema as { allowReserved?: boolean }).allowReserved === true\n  }\n  return false\n}\n\n/**\n * Get the style and explode values for a parameter according to OpenAPI 3.1.1 specification.\n * Handles defaults and validation for parameter location restrictions.\n */\nconst getParameterStyleAndExplode = (param: ParameterObject): { style: string; explode: boolean } => {\n  // Headers only support 'simple' style\n  if (param.in === 'header') {\n    const explode = 'explode' in param && param.explode !== undefined ? param.explode : false\n    return { style: 'simple', explode }\n  }\n\n  // Cookies default to form for compatibility and also support cookie style.\n  if (param.in === 'cookie') {\n    const explode = 'explode' in param && param.explode !== undefined ? param.explode : true\n    return { style: 'style' in param && param.style === 'cookie' ? 'cookie' : 'form', explode }\n  }\n\n  const defaultStyle = {\n    path: 'simple',\n    query: 'form',\n    querystring: 'form',\n    header: 'simple',\n    cookie: 'form',\n  }[param.in]\n\n  // Use provided style or default based on location\n  const style = 'style' in param && param.style ? param.style : defaultStyle\n\n  // Determine explode value: use provided value or default based on style\n  const explode = 'explode' in param && param.explode !== undefined ? param.explode : style === 'form'\n\n  return { style, explode }\n}\n\n/**\n * Extract the value for a parameter from example data or schema.\n * Prioritizes example data over schema examples.\n * Returns null if the parameter is disabled so we can skip it.\n */\nconst getParameterValue = (param: ParameterObject, example: string | undefined, defaultDisabled: boolean): unknown => {\n  // Try to get value from example first\n  const selected = getParameterExample(param, example)\n  const exampleValue = selected.example\n\n  // If the parameter is disabled, return undefined so we can skip it.\n  if (isParamDisabled(param, exampleValue, defaultDisabled)) {\n    return undefined\n  }\n\n  // If the example value is set, return it.\n  if (selected.value !== undefined) {\n    return deSerializeParameter(selected.value, param)\n  }\n\n  // Fall back to schema example if available\n  if (!('schema' in param) || !param.schema) {\n    return undefined\n  }\n\n  const options = param.in === 'path' ? { emptyString: `{${param.name}}` } : {}\n  const schema = getResolvedRef(param.schema)\n  return schema ? getExampleFromSchema(schema, options) : undefined\n}\n\n/**\n * Process OpenAPI parameters and return the updated properties.\n * Handles path, query, and header parameters with various styles and explode options.\n *\n * @see https://spec.openapis.org/oas/latest.html#style-values\n */\nexport const processParameters = ({\n  harRequest,\n  parameters,\n  example,\n  defaultDisabled,\n  openapiVersion,\n}: {\n  harRequest: HarRequest\n  parameters: OperationObject['parameters']\n  /** The name of the example to use */\n  example?: string | undefined\n  /** Whether to disable parameters by default. */\n  defaultDisabled: boolean\n  /** Originating API description version. */\n  openapiVersion?: string\n}): ProcessedParameters => {\n  // Create copies of the arrays to avoid modifying the input\n  const newHeaders = [...harRequest.headers]\n  const newQueryString = [...harRequest.queryString]\n  const newCookies = [...harRequest.cookies]\n  const cookieStyleEntries: HarRequest['cookies'] = []\n  let newUrl = harRequest.url\n  let hasReservedPathParameter = false\n  const serializedQuery: string[] = []\n  const serializedCookies: string[] = []\n\n  const appendQueryParameter = (name: string, value: string, param: ParameterObject): void => {\n    if (isAllowReserved(param)) {\n      // HTTP clients cannot infer reserved expansion from a HAR name/value pair.\n      serializedQuery.push(`${encodeURIComponent(name)}=${value}`)\n    } else {\n      newQueryString.push({ name, value })\n    }\n  }\n\n  // Filter out references\n  const deReferencedParams = deReferenceParams(parameters)\n\n  for (const param of deReferencedParams) {\n    if (!param.in || !param.name) {\n      continue\n    }\n\n    if (param.in === 'querystring') {\n      const querystring = getQuerystringParameter(param, example, { defaultDisabled })\n      if (querystring) {\n        const hashIndex = newUrl.indexOf('#')\n        const hash = hashIndex === -1 ? '' : newUrl.slice(hashIndex)\n        const base = (hashIndex === -1 ? newUrl : newUrl.slice(0, hashIndex)).split('?')[0]\n        const query = serializeQuerystringParameter(querystring)\n        newUrl = `${base}${query ? `?${query}` : ''}${hash}`\n      }\n      continue\n    }\n\n    const selected = getParameterExample(param, example)\n    if (selected.serialized && !isParamDisabled(param, selected.example, defaultDisabled)) {\n      const wireValue = String(selected.value)\n      switch (param.in) {\n        case 'path':\n          newUrl = newUrl.replaceAll(`{${param.name}}`, () => wireValue)\n          break\n        case 'query':\n          serializedQuery.push(wireValue)\n          break\n        case 'header':\n          newHeaders.push({ name: param.name, value: wireValue })\n          break\n        case 'cookie':\n          serializedCookies.push(wireValue)\n          break\n      }\n      continue\n    }\n    if (selected.mediaSerialized && !isParamDisabled(param, selected.example, defaultDisabled)) {\n      const text = String(selected.value)\n      switch (param.in) {\n        case 'query':\n          appendQueryParameter(param.name, text, param)\n          break\n        case 'header':\n          newHeaders.push({ name: param.name, value: text })\n          break\n        case 'path':\n          newUrl = newUrl.replaceAll(`{${param.name}}`, () => encodeURIComponent(text))\n          break\n        case 'cookie':\n          newCookies.push({ name: param.name, value: text })\n          break\n      }\n      continue\n    }\n    const paramValue = getParameterValue(param, example, defaultDisabled)\n    if (paramValue === undefined) {\n      continue\n    }\n\n    const { style, explode } = getParameterStyleAndExplode(param)\n\n    switch (param.in) {\n      case 'path': {\n        const allowReserved = openapiVersion?.startsWith('3.2.') && 'schema' in param && param.allowReserved === true\n        hasReservedPathParameter ||= Boolean(allowReserved)\n        const pathValue = allowReserved\n          ? serializeReservedPathParameter(param.name, { value: paramValue, style, explode })\n          : undefined\n        newUrl =\n          pathValue === undefined\n            ? processPathParameters(newUrl, param, paramValue, style, explode)\n            : newUrl.replaceAll(`{${param.name}}`, () => pathValue)\n        break\n      }\n\n      case 'query': {\n        // Content type parameters should be serialized according to the parameter's own content type\n        if ('content' in param && param.content) {\n          // We grab the first for now but eventually we should support selecting the content type per parameter\n          const paramContentType = Object.keys(param.content)[0] ?? 'application/json'\n          const serializedValue = serializeContentValue(paramValue, paramContentType)\n          appendQueryParameter(param.name, serializedValue, param)\n          break\n        }\n\n        // Handle query parameters\n        switch (style) {\n          case 'form': {\n            const serialized = serializeFormStyle(paramValue, explode)\n\n            // If serialized is an array of key-value pairs (exploded object or array)\n            if (Array.isArray(serialized)) {\n              for (const entry of serialized) {\n                const key = entry.key || param.name\n                appendQueryParameter(key, String(entry.value), param)\n              }\n            }\n            // Otherwise, convert to string\n            else {\n              appendQueryParameter(param.name, String(serialized), param)\n            }\n            break\n          }\n          case 'spaceDelimited': {\n            const serialized = serializeSpaceDelimitedStyle(paramValue)\n            appendQueryParameter(param.name, serialized, param)\n            break\n          }\n          case 'pipeDelimited': {\n            const serialized = serializePipeDelimitedStyle(paramValue)\n            appendQueryParameter(param.name, serialized, param)\n            break\n          }\n          case 'deepObject': {\n            // OAS marks deepObject-on-array and deepObject+explode:false as undefined.\n            // Mirror process-body: fall back to form/explode:true for arrays and always\n            // invoke the serializer for objects so authors get useful output instead of\n            // a silently-dropped parameter.\n            if (Array.isArray(paramValue)) {\n              const serialized = serializeFormStyle(paramValue, true)\n              if (Array.isArray(serialized)) {\n                for (const entry of serialized) {\n                  const key = entry.key || param.name\n                  appendQueryParameter(key, String(entry.value), param)\n                }\n              } else {\n                appendQueryParameter(param.name, String(serialized), param)\n              }\n            } else {\n              const entries = serializeDeepObjectStyle(param.name, paramValue)\n              for (const entry of entries) {\n                appendQueryParameter(entry.key, entry.value, param)\n              }\n            }\n            break\n          }\n\n          // Default to form style\n          default:\n            appendQueryParameter(param.name, String(paramValue), param)\n        }\n        break\n      }\n\n      // Headers only support 'simple' style according to OpenAPI 3.1.1\n      // For arrays, simple style always produces comma-separated values regardless of explode\n      // The explode parameter only affects object serialization\n      case 'header': {\n        const serialized = serializeSimpleStyle(paramValue, explode)\n        newHeaders.push({ name: param.name, value: String(serialized) })\n        break\n      }\n\n      // Keep cookie style separate so snippet generators cannot percent-encode it.\n      case 'cookie': {\n        const [major, minor] = (openapiVersion ?? '').split('.')\n        const error =\n          major === '3' && minor === '2' && !('content' in param)\n            ? getCookieSerializationError(param, paramValue)\n            : undefined\n        if (error) {\n          throw new CookieSerializationError(error)\n        }\n        if (style === 'cookie') {\n          cookieStyleEntries.push(...serializeCookieStyle(param.name, paramValue, explode))\n          break\n        }\n        const serialized = serializeFormStyleForCookies(paramValue, explode)\n\n        // If serialized is an array of key-value pairs (exploded object or array)\n        if (Array.isArray(serialized)) {\n          for (const entry of serialized) {\n            const key = entry.key || param.name\n            const value = entry.value === null ? 'null' : String(entry.value)\n            newCookies.push({ name: key, value })\n          }\n        }\n        // Otherwise, convert to string\n        else {\n          const value = serialized === null ? 'null' : String(serialized)\n          newCookies.push({ name: param.name, value })\n        }\n        break\n      }\n    }\n  }\n\n  // HAR cookie entries are encoded by snippet generators. Use a complete header\n  // when cookie style is present, preserving legacy encoding for other cookies.\n  if (cookieStyleEntries.length || serializedCookies.length) {\n    const cookieValue = [\n      ...newCookies.map((cookie) => `${encodeURIComponent(cookie.name)}=${encodeURIComponent(cookie.value)}`),\n      ...cookieStyleEntries.map((cookie) => `${cookie.name}=${cookie.value}`),\n      ...serializedCookies,\n    ].join('; ')\n    const existing = newHeaders.find((header) => header.name.toLowerCase() === 'cookie')\n    if (existing) {\n      newHeaders.splice(newHeaders.indexOf(existing), 1, {\n        ...existing,\n        value: existing.value ? `${existing.value}; ${cookieValue}` : cookieValue,\n      })\n    } else {\n      newHeaders.push({ name: 'Cookie', value: cookieValue })\n    }\n  }\n\n  if (serializedQuery.length) {\n    const hashIndex = newUrl.indexOf('#')\n    const hash = hashIndex < 0 ? '' : newUrl.slice(hashIndex)\n    const base = hashIndex < 0 ? newUrl : newUrl.slice(0, hashIndex)\n    newUrl = `${base}${base.includes('?') ? '&' : '?'}${serializedQuery.join('&')}${hash}`\n  }\n\n  if (hasReservedPathParameter) {\n    assertReservedPathUrl(newUrl)\n  }\n\n  return {\n    url: newUrl,\n    headers: newHeaders,\n    queryString: newQueryString,\n    cookies: cookieStyleEntries.length || serializedCookies.length ? [] : newCookies,\n    hasCookieStyleEntries: cookieStyleEntries.length > 0 || serializedCookies.length > 0,\n    ...(serializedQuery.length ? { hasSerializedQuery: true } : {}),\n  }\n}\n\n/**\n * Process path parameters according to OpenAPI specification.\n * Handles matrix, label, and simple styles with explode options.\n *\n * @param url - The URL to process\n * @param param - The parameter object\n * @param paramValue - The value of the parameter\n * @param style - The style of the parameter (matrix, label, simple)\n * @param explode - Whether to explode the parameter\n * @returns The updated URL with processed path parameters\n */\nconst processPathParameters = (\n  url: string,\n  param: ParameterObject,\n  paramValue: unknown,\n  style: string,\n  explode: boolean,\n): string => {\n  switch (style) {\n    case 'matrix': {\n      if (explode) {\n        // Matrix explode array: ;color=blue;color=black;color=brown\n        if (Array.isArray(paramValue)) {\n          const values = paramValue.map((v: unknown) => `${param.name}=${v}`).join(';')\n          return url.replace(`{;${param.name}}`, `;${values}`)\n        }\n\n        // Matrix explode object: ;R=100;G=200;B=150\n        if (isObjectLike(paramValue)) {\n          const values = Object.entries(paramValue)\n            .map(([k, v]) => `${k}=${v}`)\n            .join(';')\n          return url.replace(`{;${param.name}}`, `;${values}`)\n        }\n\n        // Matrix explode primitive: ;color=blue\n        return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue}`)\n      }\n\n      // Matrix no explode array: ;color=blue,black,brown\n      if (Array.isArray(paramValue)) {\n        return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue.join(',')}`)\n      }\n\n      // Matrix no explode object: ;color=R,100,G,200,B,150\n      if (isObjectLike(paramValue)) {\n        const values = Object.entries(paramValue)\n          .map(([k, v]) => `${k},${v}`)\n          .join(',')\n        return url.replace(`{;${param.name}}`, `;${param.name}=${values}`)\n      }\n\n      // Matrix no explode primitive: ;color=blue\n      return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue}`)\n    }\n    case 'label': {\n      if (explode) {\n        // Label explode array: .blue.black.brown\n        if (Array.isArray(paramValue)) {\n          return url.replace(`{.${param.name}}`, `.${paramValue.join('.')}`)\n        }\n\n        // Label explode object: .R=100.G=200.B=150\n        if (isObjectLike(paramValue)) {\n          const values = Object.entries(paramValue)\n            .map(([k, v]) => `${k}=${v}`)\n            .join('.')\n\n          return url.replace(`{.${param.name}}`, `.${values}`)\n        }\n\n        // Label explode primitive: .blue\n        return url.replace(`{.${param.name}}`, `.${paramValue}`)\n      }\n\n      // Label no explode array: .blue,black,brown\n      if (Array.isArray(paramValue)) {\n        return url.replace(`{.${param.name}}`, `.${paramValue.join(',')}`)\n      }\n\n      // Label no explode object: .R,100,G,200,B,150\n      if (isObjectLike(paramValue)) {\n        const values = Object.entries(paramValue)\n          .map(([k, v]) => `${k},${v}`)\n          .join(',')\n\n        return url.replace(`{.${param.name}}`, `.${values}`)\n      }\n\n      // Label no explode primitive: .blue\n      return url.replace(`{.${param.name}}`, `.${paramValue}`)\n    }\n\n    case 'simple': {\n      const serialized = serializeSimpleStyle(paramValue, explode)\n      return url.replace(`{${param.name}}`, String(serialized))\n    }\n\n    // Default to simple style\n    default:\n      return url.replace(`{${param.name}}`, String(paramValue))\n  }\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.5.0";
+var e = typeof OVERRIDE_PACKAGE_VERSION < "u" ? OVERRIDE_PACKAGE_VERSION : "0.5.1";
 //#endregion
 export { e as APP_VERSION };
 

package/dist/style.css

@@ -3964,11 +3964,6 @@
   opacity: 1;
 }
 
-.scalar-app .shadow {
-  --tw-shadow: var(--scalar-shadow-1);
-  box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-}
-
 .scalar-app .shadow-border {
   --tw-shadow: inset 0 0 0 var(--scalar-border-width) var(--scalar-border-color);
   box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
@@ -3994,6 +3989,11 @@
   box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
 }
 
+.scalar-app .inset-shadow-border {
+  --tw-inset-shadow: inset 0 0 0 var(--scalar-border-width) var(--scalar-border-color);
+  box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
+}
+
 .scalar-app .outline {
   outline-style: var(--tw-outline-style);
   outline-width: 1px;
@@ -4020,11 +4020,6 @@
   filter: var(--tw-blur, ) var(--tw-brightness, ) var(--tw-contrast, ) var(--tw-grayscale, ) var(--tw-hue-rotate, ) var(--tw-invert, ) var(--tw-saturate, ) var(--tw-sepia, ) var(--tw-drop-shadow, );
 }
 
-.scalar-app .brightness-lifted {
-  --tw-brightness: brightness(var(--scalar-lifted-brightness));
-  filter: var(--tw-blur, ) var(--tw-brightness, ) var(--tw-contrast, ) var(--tw-grayscale, ) var(--tw-hue-rotate, ) var(--tw-invert, ) var(--tw-saturate, ) var(--tw-sepia, ) var(--tw-drop-shadow, );
-}
-
 .scalar-app .filter {
   filter: var(--tw-blur, ) var(--tw-brightness, ) var(--tw-contrast, ) var(--tw-grayscale, ) var(--tw-hue-rotate, ) var(--tw-invert, ) var(--tw-saturate, ) var(--tw-sepia, ) var(--tw-drop-shadow, );
 }
@@ -4280,32 +4275,6 @@
   display: none !important;
 }
 
-.scalar-app .after\:pointer-events-none:after {
-  content: var(--tw-content);
-  pointer-events: none;
-}
-
-.scalar-app .after\:absolute:after {
-  content: var(--tw-content);
-  position: absolute;
-}
-
-.scalar-app .after\:inset-0:after {
-  content: var(--tw-content);
-  inset: 0;
-}
-
-.scalar-app .after\:rounded-\[inherit\]:after {
-  content: var(--tw-content);
-  border-radius: inherit;
-}
-
-.scalar-app .after\:shadow-border:after {
-  content: var(--tw-content);
-  --tw-shadow: inset 0 0 0 var(--scalar-border-width) var(--scalar-border-color);
-  box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-}
-
 .scalar-app .first\:rounded-t-\[inherit\]:first-child {
   border-top-left-radius: inherit;
   border-top-right-radius: inherit;

package/package.json

@@ -17,7 +17,7 @@
     "blocks",
     "docs"
   ],
-  "version": "0.5.0",
+  "version": "0.5.1",
   "engines": {
     "node": ">=22"
   },
@@ -62,15 +62,15 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@scalar/components": "0.30.7",
-    "@scalar/helpers": "0.16.1",
+    "@scalar/components": "0.31.0",
+    "@scalar/helpers": "0.16.2",
     "@scalar/icons": "0.7.6",
-    "@scalar/localization": "0.2.5",
-    "@scalar/snippetz": "0.10.6",
-    "@scalar/themes": "0.18.1",
-    "@scalar/types": "0.23.0",
-    "@scalar/use-hooks": "0.4.18",
-    "@scalar/workspace-store": "0.68.1",
+    "@scalar/localization": "0.2.6",
+    "@scalar/snippetz": "0.10.7",
+    "@scalar/themes": "0.19.0",
+    "@scalar/types": "0.23.1",
+    "@scalar/use-hooks": "0.4.19",
+    "@scalar/workspace-store": "0.68.2",
     "@types/har-format": "^1.2.16",
     "@vueuse/core": "13.9.0",
     "js-base64": "^3.9.2",