@scalar/blocks 0.5.0 → 0.5.2

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 { deSerializeParameter as t, filterDisabledProperties as n, getExampleFromSchema as r, isParamDisabled as i, serializeContentValue as a, serializeCookieStyle as o, serializeDeepObjectStyle as s, serializeFormStyle as c, serializeFormStyleForCookies as l, serializePipeDelimitedStyle as u, serializeSimpleStyle as d, serializeSpaceDelimitedStyle as f } from "@scalar/workspace-store/request-example";
+import { getCookieSerializationError as p } from "@scalar/helpers/http/get-cookie-serialization-error";
+import { isObjectLike as m } from "@scalar/helpers/object/is-object";
+import { assertReservedPathUrl as h, serializeReservedPathParameter as g } from "@scalar/workspace-store/helpers/encode-path-parameter";
+import { getParameterExample as _ } from "@scalar/workspace-store/helpers/get-parameter-example";
+import { getQuerystringParameter as v, serializeQuerystringParameter as y } 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 b = class extends Error {}, x = (t) => (t ?? []).map((t) => e(t)).filter((e) => e !== void 0), S = (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, C = (e) => {
 	if (e.in === "header") return {
 		style: "simple",
 		explode: "explode" in e && e.explode !== void 0 && e.explode
@@ -27,67 +29,70 @@ 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;
-	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 = (a, o, s) => {
+	let c = _(a, o), l = c.example, u = a.in === "query" && !c.serialized && !c.mediaSerialized ? l?.["x-scalar-disabled-properties"] : void 0;
+	if (u) return n(t(c.value, a), u, i(a, l, s));
+	if (i(a, l, s)) return;
+	if (c.value !== void 0) return t(c.value, a);
+	if (!("schema" in a) || !a.schema) return;
+	let d = a.in === "path" ? { emptyString: `{${a.name}}` } : {}, f = e(a.schema);
+	return f ? r(f, d) : void 0;
+}, T = ({ harRequest: e, parameters: t, example: n, defaultDisabled: r, openapiVersion: m }) => {
+	let T = [...e.headers], D = [...e.queryString], O = [...e.cookies], k = [], A = e.url, j = !1, M = [], N = [], P = (e, t, n) => {
+		S(n) ? M.push(`${encodeURIComponent(e)}=${t}`) : D.push({
+			name: e,
+			value: t
+		});
+	}, F = x(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 = v(e, n, { defaultDisabled: r });
 			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 = y(t);
+				A = `${r}${i ? `?${i}` : ""}${n}`;
 			}
 			continue;
 		}
-		let t = p(e, n);
-		if (t.serialized && !r(e, t.example, f)) {
+		let t = _(e, n);
+		if (t.serialized && !i(e, t.example, r)) {
 			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({
+					T.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 && !i(e, t.example, r)) {
 			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({
+					T.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 +100,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 h = w(e, n, r);
+		if (h === void 0) continue;
+		let { style: x, explode: S } = C(e);
 		switch (e.in) {
-			case "path":
-				T = S(T, e, g, O, k);
+			case "path": {
+				let t = m?.startsWith("3.2.") && "schema" in e && e.allowReserved === !0;
+				j ||= !!t;
+				let n = t ? g(e.name, {
+					value: h,
+					style: x,
+					explode: S
+				}) : void 0;
+				A = n === void 0 ? E(A, e, h, x, S) : 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 = a(h, Object.keys(e.content)[0] ?? "application/json");
+					P(e.name, t, e);
 					break;
 				}
-				switch (O) {
+				switch (x) {
 					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 = c(h, S);
+						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 = f(h);
+						P(e.name, t, e);
 						break;
 					}
 					case "pipeDelimited": {
-						let t = l(g);
-						x.push({
-							name: e.name,
-							value: v(t, e)
-						});
+						let t = u(h);
+						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(h)) {
+							let t = c(h, !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 = s(e.name, h);
+							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(h), e);
 				}
 				break;
 			case "header": {
-				let t = u(g, k);
-				_.push({
+				let t = d(h, S);
+				T.push({
 					name: e.name,
 					value: String(t)
 				});
 				break;
 			}
 			case "cookie": {
-				if (O === "cookie") {
-					w.push(...a(e.name, g, k));
+				let [t, n] = (m ?? "").split("."), r = t === "3" && n === "2" && !("content" in e) ? p(e, h) : void 0;
+				if (r) throw new b(r);
+				if (x === "cookie") {
+					k.push(...o(e.name, h, S));
 					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 = l(h, S);
+				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 = T.find((e) => e.name.toLowerCase() === "cookie");
+		t ? T.splice(T.indexOf(t), 1, {
 			...t,
 			value: t.value ? `${t.value}; ${e}` : e
-		}) : _.push({
+		}) : T.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 && h(A), {
+		url: A,
+		headers: T,
+		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) => {
+}, E = (e, t, n, r, i) => {
 	switch (r) {
 		case "matrix":
 			if (i) {
@@ -237,14 +219,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 (m(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 (m(n)) {
 				let r = Object.entries(n).map(([e, t]) => `${e},${t}`).join(",");
 				return e.replace(`{;${t.name}}`, `;${t.name}=${r}`);
 			}
@@ -252,26 +234,26 @@ 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 (m(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 (m(n)) {
 				let r = Object.entries(n).map(([e, t]) => `${e},${t}`).join(",");
 				return e.replace(`{.${t.name}}`, `.${r}`);
 			}
 			return e.replace(`{.${t.name}}`, `.${n}`);
 		case "simple": {
-			let r = u(n, i);
+			let r = d(n, i);
 			return e.replace(`{${t.name}}`, String(r));
 		}
 		default: return e.replace(`{${t.name}}`, String(n));
 	}
 };
 //#endregion
-export { x as processParameters };
+export { b as CookieSerializationError, T 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":";;;;;;AAmCA,IAAM,KAAqB,OACxB,KAAU,CAAC,EAAA,CAAG,KAAK,MAAU,EAAe,CAAK,CAAC,CAAC,CAAC,QAAQ,MAAU,MAAU,KAAA,CAAS,GAGtF,KAAmB,MACnB,mBAAmB,KAAS,EAAM,kBAAkB,KAAA,IAC/C,EAAM,gBAEX,YAAY,KAAS,EAAM,UAAU,OAAO,EAAM,UAAW,YAAY,mBAAmB,EAAM,SAC5F,EAAM,OAAuC,kBAAkB,KAElE,IAIH,KAAoB,GAAe,MACnC,EAAgB,CAAK,IAChB,IAEF,mBAAmB,CAAK,GAO3B,KAA+B,MAAgE;CAEnG,IAAI,EAAM,OAAO,UAEf,OAAO;EAAE,OAAO;EAAU,SADV,aAAa,KAAS,EAAM,YAAY,KAAA,KAAY,EAAM;CACxC;CAIpC,IAAI,EAAM,OAAO,UAAU;EACzB,IAAM,IAAU,aAAa,KAAS,EAAM,YAAY,KAAA,IAAY,EAAM,UAAU;EACpF,OAAO;GAAE,OAAO,WAAW,KAAS,EAAM,UAAU,WAAW,WAAW;GAAQ;EAAQ;CAC5F;CAEA,IAAM,IAAe;EACnB,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ;CACV,EAAE,EAAM,KAGF,IAAQ,WAAW,KAAS,EAAM,QAAQ,EAAM,QAAQ;CAK9D,OAAO;EAAE;EAAO,SAFA,aAAa,KAAS,EAAM,YAAY,KAAA,IAAY,EAAM,UAAU,MAAU;CAEtE;AAC1B,GAOM,KAAqB,GAAwB,GAA6B,MAAsC;CAEpH,IAAM,IAAW,EAAoB,GAAO,CAAO,GAC7C,IAAe,EAAS;CAG9B,IAAI,EAAgB,GAAO,GAAc,CAAe,GACtD;CAIF,IAAI,EAAS,UAAU,KAAA,GACrB,OAAO,EAAqB,EAAS,OAAO,CAAK;CAInD,IAAI,EAAE,YAAY,MAAU,CAAC,EAAM,QACjC;CAGF,IAAM,IAAU,EAAM,OAAO,SAAS,EAAE,aAAa,IAAI,EAAM,KAAK,GAAG,IAAI,CAAC,GACtE,IAAS,EAAe,EAAM,MAAM;CAC1C,OAAO,IAAS,EAAqB,GAAQ,CAAO,IAAI,KAAA;AAC1D,GAQa,KAAqB,EAChC,eACA,eACA,YACA,yBAQyB;CAEzB,IAAM,IAAa,CAAC,GAAG,EAAW,OAAO,GACnC,IAAiB,CAAC,GAAG,EAAW,WAAW,GAC3C,IAAa,CAAC,GAAG,EAAW,OAAO,GACnC,IAA4C,CAAC,GAC/C,IAAS,EAAW,KAClB,IAA4B,CAAC,GAC7B,IAA8B,CAAC,GAG/B,IAAqB,EAAkB,CAAU;CAEvD,KAAK,IAAM,KAAS,GAAoB;EACtC,IAAI,CAAC,EAAM,MAAM,CAAC,EAAM,MACtB;EAGF,IAAI,EAAM,OAAO,eAAe;GAC9B,IAAM,IAAc,EAAwB,GAAO,GAAS,EAAE,mBAAgB,CAAC;GAC/E,IAAI,GAAa;IACf,IAAM,IAAY,EAAO,QAAQ,GAAG,GAC9B,IAAO,MAAc,KAAK,KAAK,EAAO,MAAM,CAAS,GACrD,KAAQ,MAAc,KAAK,IAAS,EAAO,MAAM,GAAG,CAAS,EAAA,CAAG,MAAM,GAAG,CAAC,CAAC,IAC3E,IAAQ,EAA8B,CAAW;IACvD,IAAS,GAAG,IAAO,IAAQ,IAAI,MAAU,KAAK;GAChD;GACA;EACF;EAEA,IAAM,IAAW,EAAoB,GAAO,CAAO;EACnD,IAAI,EAAS,cAAc,CAAC,EAAgB,GAAO,EAAS,SAAS,CAAe,GAAG;GACrF,IAAM,IAAY,OAAO,EAAS,KAAK;GACvC,QAAQ,EAAM,IAAd;IACE,KAAK;KACH,IAAS,EAAO,WAAW,IAAI,EAAM,KAAK,UAAU,CAAS;KAC7D;IACF,KAAK;KACH,EAAgB,KAAK,CAAS;KAC9B;IACF,KAAK;KACH,EAAW,KAAK;MAAE,MAAM,EAAM;MAAM,OAAO;KAAU,CAAC;KACtD;IACF,KAAK;KACH,EAAkB,KAAK,CAAS;KAChC;GACJ;GACA;EACF;EACA,IAAI,EAAS,mBAAmB,CAAC,EAAgB,GAAO,EAAS,SAAS,CAAe,GAAG;GAC1F,IAAM,IAAO,OAAO,EAAS,KAAK;GAClC,QAAQ,EAAM,IAAd;IACE,KAAK;KACH,EAAe,KAAK;MAAE,MAAM,EAAM;MAAM,OAAO,EAAiB,GAAM,CAAK;KAAE,CAAC;KAC9E;IACF,KAAK;KACH,EAAW,KAAK;MAAE,MAAM,EAAM;MAAM,OAAO;KAAK,CAAC;KACjD;IACF,KAAK;KACH,IAAS,EAAO,WAAW,IAAI,EAAM,KAAK,UAAU,mBAAmB,CAAI,CAAC;KAC5E;IACF,KAAK;KACH,EAAW,KAAK;MAAE,MAAM,EAAM;MAAM,OAAO;KAAK,CAAC;KACjD;GACJ;GACA;EACF;EACA,IAAM,IAAa,EAAkB,GAAO,GAAS,CAAe;EACpE,IAAI,MAAe,KAAA,GACjB;EAGF,IAAM,EAAE,UAAO,eAAY,EAA4B,CAAK;EAE5D,QAAQ,EAAM,IAAd;GACE,KAAK;IACH,IAAS,EAAsB,GAAQ,GAAO,GAAY,GAAO,CAAO;IACxE;GAGF,KAAK;IAEH,IAAI,aAAa,KAAS,EAAM,SAAS;KAGvC,IAAM,IAAkB,EAAsB,GADrB,OAAO,KAAK,EAAM,OAAO,CAAC,CAAC,MAAM,kBACgB;KAC1E,EAAe,KAAK;MAAE,MAAM,EAAM;MAAM,OAAO,EAAiB,GAAiB,CAAK;KAAE,CAAC;KACzF;IACF;IAGA,QAAQ,GAAR;KACE,KAAK,QAAQ;MACX,IAAM,IAAa,EAAmB,GAAY,CAAO;MAGzD,IAAI,MAAM,QAAQ,CAAU,GAC1B,KAAK,IAAM,KAAS,GAAY;OAC9B,IAAM,IAAM,EAAM,OAAO,EAAM;OAC/B,EAAe,KAAK;QAAE,MAAM;QAAK,OAAO,EAAiB,OAAO,EAAM,KAAK,GAAG,CAAK;OAAE,CAAC;MACxF;WAIA,EAAe,KAAK;OAAE,MAAM,EAAM;OAAM,OAAO,EAAiB,OAAO,CAAU,GAAG,CAAK;MAAE,CAAC;MAE9F;KACF;KACA,KAAK,kBAAkB;MACrB,IAAM,IAAa,EAA6B,CAAU;MAC1D,EAAe,KAAK;OAAE,MAAM,EAAM;OAAM,OAAO,EAAiB,GAAY,CAAK;MAAE,CAAC;MACpF;KACF;KACA,KAAK,iBAAiB;MACpB,IAAM,IAAa,EAA4B,CAAU;MACzD,EAAe,KAAK;OAAE,MAAM,EAAM;OAAM,OAAO,EAAiB,GAAY,CAAK;MAAE,CAAC;MACpF;KACF;KACA,KAAK;MAKH,IAAI,MAAM,QAAQ,CAAU,GAAG;OAC7B,IAAM,IAAa,EAAmB,GAAY,EAAI;OACtD,IAAI,MAAM,QAAQ,CAAU,GAC1B,KAAK,IAAM,KAAS,GAAY;QAC9B,IAAM,IAAM,EAAM,OAAO,EAAM;QAC/B,EAAe,KAAK;SAAE,MAAM;SAAK,OAAO,EAAiB,OAAO,EAAM,KAAK,GAAG,CAAK;QAAE,CAAC;OACxF;YAEA,EAAe,KAAK;QAAE,MAAM,EAAM;QAAM,OAAO,EAAiB,OAAO,CAAU,GAAG,CAAK;OAAE,CAAC;MAEhG,OAAO;OACL,IAAM,IAAU,EAAyB,EAAM,MAAM,CAAU;OAC/D,KAAK,IAAM,KAAS,GAClB,EAAe,KAAK;QAAE,MAAM,EAAM;QAAK,OAAO,EAAiB,EAAM,OAAO,CAAK;OAAE,CAAC;MAExF;MACA;KAIF,SACE,EAAe,KAAK;MAAE,MAAM,EAAM;MAAM,OAAO,EAAiB,OAAO,CAAU,GAAG,CAAK;KAAE,CAAC;IAChG;IACA;GAMF,KAAK,UAAU;IACb,IAAM,IAAa,EAAqB,GAAY,CAAO;IAC3D,EAAW,KAAK;KAAE,MAAM,EAAM;KAAM,OAAO,OAAO,CAAU;IAAE,CAAC;IAC/D;GACF;GAGA,KAAK,UAAU;IACb,IAAI,MAAU,UAAU;KACtB,EAAmB,KAAK,GAAG,EAAqB,EAAM,MAAM,GAAY,CAAO,CAAC;KAChF;IACF;IACA,IAAM,IAAa,EAA6B,GAAY,CAAO;IAGnE,IAAI,MAAM,QAAQ,CAAU,GAC1B,KAAK,IAAM,KAAS,GAAY;KAC9B,IAAM,IAAM,EAAM,OAAO,EAAM,MACzB,IAAQ,EAAM,UAAU,OAAO,SAAS,OAAO,EAAM,KAAK;KAChE,EAAW,KAAK;MAAE,MAAM;MAAK;KAAM,CAAC;IACtC;SAGG;KACH,IAAM,IAAQ,MAAe,OAAO,SAAS,OAAO,CAAU;KAC9D,EAAW,KAAK;MAAE,MAAM,EAAM;MAAM;KAAM,CAAC;IAC7C;IACA;GACF;EACF;CACF;CAIA,IAAI,EAAmB,UAAU,EAAkB,QAAQ;EACzD,IAAM,IAAc;GAClB,GAAG,EAAW,KAAK,MAAW,GAAG,mBAAmB,EAAO,IAAI,EAAE,GAAG,mBAAmB,EAAO,KAAK,GAAG;GACtG,GAAG,EAAmB,KAAK,MAAW,GAAG,EAAO,KAAK,GAAG,EAAO,OAAO;GACtE,GAAG;EACL,CAAC,CAAC,KAAK,IAAI,GACL,IAAW,EAAW,MAAM,MAAW,EAAO,KAAK,YAAY,MAAM,QAAQ;EACnF,AAAI,IACF,EAAW,OAAO,EAAW,QAAQ,CAAQ,GAAG,GAAG;GACjD,GAAG;GACH,OAAO,EAAS,QAAQ,GAAG,EAAS,MAAM,IAAI,MAAgB;EAChE,CAAC,IAED,EAAW,KAAK;GAAE,MAAM;GAAU,OAAO;EAAY,CAAC;CAE1D;CAEA,IAAI,EAAgB,QAAQ;EAC1B,IAAM,IAAY,EAAO,QAAQ,GAAG,GAC9B,IAAO,IAAY,IAAI,KAAK,EAAO,MAAM,CAAS,GAClD,IAAO,IAAY,IAAI,IAAS,EAAO,MAAM,GAAG,CAAS;EAC/D,IAAS,GAAG,IAAO,EAAK,SAAS,GAAG,IAAI,MAAM,MAAM,EAAgB,KAAK,GAAG,IAAI;CAClF;CAEA,OAAO;EACL,KAAK;EACL,SAAS;EACT,aAAa;EACb,SAAS,EAAmB,UAAU,EAAkB,SAAS,CAAC,IAAI;EACtE,uBAAuB,EAAmB,SAAS,KAAK,EAAkB,SAAS;EACnF,GAAI,EAAgB,SAAS,EAAE,oBAAoB,GAAK,IAAI,CAAC;CAC/D;AACF,GAaM,KACJ,GACA,GACA,GACA,GACA,MACW;CACX,QAAQ,GAAR;EACE,KAAK;GACH,IAAI,GAAS;IAEX,IAAI,MAAM,QAAQ,CAAU,GAAG;KAC7B,IAAM,IAAS,EAAW,KAAK,MAAe,GAAG,EAAM,KAAK,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;KAC5E,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,GAAQ;IACrD;IAGA,IAAI,EAAa,CAAU,GAAG;KAC5B,IAAM,IAAS,OAAO,QAAQ,CAAU,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,CAC5B,KAAK,GAAG;KACX,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,GAAQ;IACrD;IAGA,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,EAAM,KAAK,GAAG,GAAY;GACvE;GAGA,IAAI,MAAM,QAAQ,CAAU,GAC1B,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,EAAM,KAAK,GAAG,EAAW,KAAK,GAAG,GAAG;GAIjF,IAAI,EAAa,CAAU,GAAG;IAC5B,IAAM,IAAS,OAAO,QAAQ,CAAU,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,CAC5B,KAAK,GAAG;IACX,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,EAAM,KAAK,GAAG,GAAQ;GACnE;GAGA,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,EAAM,KAAK,GAAG,GAAY;EAEvE,KAAK;GACH,IAAI,GAAS;IAEX,IAAI,MAAM,QAAQ,CAAU,GAC1B,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,EAAW,KAAK,GAAG,GAAG;IAInE,IAAI,EAAa,CAAU,GAAG;KAC5B,IAAM,IAAS,OAAO,QAAQ,CAAU,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,CAC5B,KAAK,GAAG;KAEX,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,GAAQ;IACrD;IAGA,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,GAAY;GACzD;GAGA,IAAI,MAAM,QAAQ,CAAU,GAC1B,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,EAAW,KAAK,GAAG,GAAG;GAInE,IAAI,EAAa,CAAU,GAAG;IAC5B,IAAM,IAAS,OAAO,QAAQ,CAAU,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,CAC5B,KAAK,GAAG;IAEX,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,GAAQ;GACrD;GAGA,OAAO,EAAI,QAAQ,KAAK,EAAM,KAAK,IAAI,IAAI,GAAY;EAGzD,KAAK,UAAU;GACb,IAAM,IAAa,EAAqB,GAAY,CAAO;GAC3D,OAAO,EAAI,QAAQ,IAAI,EAAM,KAAK,IAAI,OAAO,CAAU,CAAC;EAC1D;EAGA,SACE,OAAO,EAAI,QAAQ,IAAI,EAAM,KAAK,IAAI,OAAO,CAAU,CAAC;CAC5D;AACF"}
+{"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  filterDisabledProperties,\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  const propertyStates =\n    param.in === 'query' && !selected.serialized && !selected.mediaSerialized\n      ? exampleValue?.['x-scalar-disabled-properties']\n      : undefined\n  if (propertyStates) {\n    return filterDisabledProperties(\n      deSerializeParameter(selected.value, param),\n      propertyStates,\n      isParamDisabled(param, exampleValue, defaultDisabled),\n    )\n  }\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/code-example/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/code-example/mount.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAOpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACzF,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAMjH,MAAM,MAAM,wBAAwB,GAAG;IACrC,uFAAuF;IACvF,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yEAAyE;IACzE,KAAK,EAAE,cAAc,CAAA;IACrB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,cAAc,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IACpC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oDAAoD;IACpD,eAAe,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAWD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,IAAI,WAAW,GAAG,MAAM,EAAE,SAAS,wBAAwB;;;CA4I5F,CAAA"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/code-example/mount.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAOpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACzF,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAMjH,MAAM,MAAM,wBAAwB,GAAG;IACrC,uFAAuF;IACvF,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yEAAyE;IACzE,KAAK,EAAE,cAAc,CAAA;IACrB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,cAAc,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IACpC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oDAAoD;IACpD,eAAe,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAkBD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,IAAI,WAAW,GAAG,MAAM,EAAE,SAAS,wBAAwB;;;CA4I5F,CAAA"}

package/dist/code-example/mount.js

@@ -9,7 +9,7 @@ import { getPathItemOperation as l } from "@scalar/workspace-store/helpers/for-e
 import { getFirstServer as u } from "@scalar/workspace-store/helpers/get-first-server";
 import { generateClientMutators as d } from "@scalar/workspace-store/mutators";
 //#region src/code-example/mount.ts
-var f = (e) => ["scalar-app", e === !0 ? "dark-mode" : e === !1 ? "light-mode" : ""].filter(Boolean).join(" "), p = (p, m) => {
+var f = (e) => e === !0 ? "scalar-app dark-mode" : e === !1 ? "scalar-app light-mode" : "scalar-app", p = (p, m) => {
 	let h = typeof p == "string" ? document.querySelector(p) : p;
 	if (!h) throw Error(`Element not found: ${p}`);
 	let g = a(), _ = e(), v = d(m.store), y = g.on("workspace:update:selected-client", (e) => v.workspace().workspace.updateSelectedClient(e)), b = g.on("workspace:update:selected-example", (e) => v.workspace().workspace.updateSelectedExample(e)), x = () => {

package/dist/code-example/mount.js.map

@@ -1 +1 @@
-{"version":3,"file":"mount.js","names":[],"sources":["../../src/code-example/mount.ts"],"sourcesContent":["import { ScalarTeleportRoot } from '@scalar/components/teleport'\nimport type { AvailableClients } from '@scalar/snippetz'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport { createWorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { getPathItemOperation } from '@scalar/workspace-store/helpers/for-each-path-item-operation'\nimport { getFirstServer } from '@scalar/workspace-store/helpers/get-first-server'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { EXTERNAL_EXAMPLES } from '@scalar/workspace-store/helpers/use-external-examples'\nimport { generateClientMutators } from '@scalar/workspace-store/mutators'\nimport type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport { createApp, h, reactive } from 'vue'\n\nimport CodeExample, { type CodeExampleProps } from './components/CodeExample.vue'\nimport { generateClientOptions } from './helpers/generate-client-options'\n\nexport type CreateCodeExampleOptions = {\n  /** Localized status text shown when the selected example has no linked code sample. */\n  codeSampleUnavailable?: string\n  /** Localized accessible name for the focusable code sample scroller. */\n  codeSampleLabel?: string\n  /** Workspace store that holds the OpenAPI document(s) to render from. */\n  store: WorkspaceStore\n  /** Path of the operation to render, e.g. '/users/{id}'. */\n  path: string\n  /** HTTP method of the operation to render. */\n  method: string\n  /** Pre-selected client ID, e.g. 'shell/curl'. */\n  selectedClient?: AvailableClients[number]\n  /**\n   * Server object override used to build the example request.\n   *\n   * When omitted, the server is derived from the active document (operation,\n   * then path item, then document level), mirroring the API reference. Pass\n   * `null` to force \"no server\".\n   */\n  selectedServer?: ServerObject | null\n  /**\n   * Pre-selected example key for parameters and the request body.\n   *\n   * The store is the source of truth once an example is picked, so\n   * `x-scalar-default-example` wins over this initial seed and the selection\n   * round-trips through the store like the client selection does.\n   */\n  selectedExample?: string\n  /** Security schemes applicable to the operation. */\n  securitySchemes?: SecuritySchemeObjectSecret[]\n  /**\n   * Force a color mode on the rendered block.\n   *\n   * When omitted, the block inherits the ambient theme of the host page.\n   * Pass `true` for dark mode or `false` for light mode.\n   */\n  darkMode?: boolean\n}\n\n/**\n * Builds the wrapper classes for the mounted block.\n *\n * The `.scalar-app` class scopes the Tailwind utilities, and the optional\n * color-mode class lets consumers pin the block to dark or light.\n */\nconst getWrapperClass = (darkMode: boolean | undefined): string =>\n  ['scalar-app', darkMode === true ? 'dark-mode' : darkMode === false ? 'light-mode' : ''].filter(Boolean).join(' ')\n\n/**\n * Mount the CodeExample block to a DOM element without Vue.\n *\n * The consumer creates and controls their own workspace store,\n * then passes it in along with the path and method to render.\n */\nexport const createCodeExample = (el: HTMLElement | string, options: CreateCodeExampleOptions) => {\n  const element = typeof el === 'string' ? document.querySelector(el) : el\n  if (!element) {\n    throw new Error(`Element not found: ${el}`)\n  }\n\n  const eventBus = createWorkspaceEventBus()\n  const clientOptions = generateClientOptions()\n\n  // Persist client changes back to the store. The block emits\n  // `workspace:update:selected-client` on its private bus when the user picks a\n  // client; without this subscription the choice would never reach the store\n  // and `x-scalar-default-client` (the source of truth read below) would stay\n  // stale, so the selection would not survive a re-render or be shared with\n  // other blocks reading from the same store.\n  const mutators = generateClientMutators(options.store)\n  const unsubscribeClient = eventBus.on('workspace:update:selected-client', (payload) =>\n    mutators.workspace().workspace.updateSelectedClient(payload),\n  )\n\n  // Persist example changes back to the store as well, mirroring the client\n  // round-trip above. The block emits `workspace:update:selected-example` when\n  // the user picks an example; without this the choice would never reach\n  // `x-scalar-default-example` (read below) and would neither survive a\n  // re-render nor sync to other blocks reading from the same store.\n  const unsubscribeExample = eventBus.on('workspace:update:selected-example', (payload) =>\n    mutators.workspace().workspace.updateSelectedExample(payload),\n  )\n\n  type OperationContext = { operation: OperationObject; server: ServerObject | null }\n\n  /**\n   * Resolve the operation and its effective server from the active document.\n   *\n   * The server is resolved from the same document the operation came from\n   * (operation, then path item, then document level), so a snippet never pairs\n   * an operation with a server URL from a different spec.\n   */\n  const resolveContext = (): OperationContext | undefined => {\n    // The active document may be an AsyncAPI document, which has no `paths`.\n    const activeDocument = options.store.workspace.activeDocument\n    if (!activeDocument || !('paths' in activeDocument)) {\n      return undefined\n    }\n    const pathItem = getResolvedRef(activeDocument.paths?.[options.path])\n    const operation = getResolvedRef(getPathItemOperation(pathItem, options.method))\n    if (!operation) {\n      return undefined\n    }\n    const server = getFirstServer(operation.servers ?? null, pathItem?.servers ?? null, activeDocument.servers ?? null)\n    return { operation, server }\n  }\n\n  // Fail loudly if the path and method do not point at an operation in the store,\n  // mirroring the \"element not found\" guard above.\n  if (!resolveContext()) {\n    throw new Error(`Operation not found: ${options.method.toUpperCase()} ${options.path}`)\n  }\n\n  // Remember the last context that resolved so a transient miss (e.g. the active\n  // document is swapped to one without this path or method after mount) keeps\n  // rendering the previous operation, paired with the server it actually came\n  // from, instead of feeding `undefined` to the block.\n  let lastContext: OperationContext | undefined\n\n  /** Current operation + server, falling back to the last good resolution on a transient miss. */\n  const currentContext = (): OperationContext => {\n    const context = resolveContext()\n    if (context) {\n      lastContext = context\n    }\n    return (context ?? lastContext) as OperationContext\n  }\n\n  // Props are getters so the block tracks the reactive store (active document,\n  // `x-scalar-default-client`, `x-scalar-default-example`) live. Change the\n  // client, example, or server through the store to drive re-renders.\n  const props = reactive<CodeExampleProps>({\n    get codeSampleUnavailable() {\n      return options.codeSampleUnavailable\n    },\n    get codeSampleLabel() {\n      return options.codeSampleLabel\n    },\n    get operation(): OperationObject {\n      return currentContext().operation\n    },\n    get method() {\n      return options.method\n    },\n    get path() {\n      return options.path\n    },\n    clientOptions,\n    eventBus,\n    get securitySchemes() {\n      return options.securitySchemes ?? []\n    },\n    get selectedClient() {\n      // The store is the source of truth once the user picks a client, so it\n      // wins over the initial `options.selectedClient` seed and the selection\n      // round-trips through the subscription above.\n      return options.store.workspace['x-scalar-default-client'] ?? options.selectedClient\n    },\n    get selectedExample() {\n      // Same as the client: the store wins over the initial seed so the example\n      // selection survives re-renders and syncs across blocks.\n      return options.store.workspace['x-scalar-default-example'] ?? options.selectedExample\n    },\n    get selectedServer() {\n      // An explicit option wins (including an explicit `null` for \"no server\");\n      // otherwise derive it from the same document the operation resolved from.\n      return options.selectedServer !== undefined ? options.selectedServer : currentContext().server\n    },\n  })\n\n  // Render the operation path in the header by default. The reference renders\n  // this via the `#header` slot too, so the standalone block matches its look.\n  const renderHeader = () => h('span', { class: 'font-code text-c-2 min-w-0 truncate' }, options.path)\n\n  // Wrap the block in its own teleport root so floating UI (the client picker\n  // popover) renders inside the themed `.scalar-app` wrapper instead of escaping\n  // to `body`, where it would miss the color-mode variables and lose its styling.\n  const app = createApp(() =>\n    h('div', { class: getWrapperClass(options.darkMode) }, [\n      h(ScalarTeleportRoot, null, { default: () => h(CodeExample, props, { header: renderHeader }) }),\n    ]),\n  )\n\n  app.provide(EXTERNAL_EXAMPLES, () => options.store.externalExamples())\n  app.mount(element)\n\n  return {\n    app,\n    destroy: () => {\n      unsubscribeClient()\n      unsubscribeExample()\n      app.unmount()\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;AA8DA,IAAM,KAAmB,MACvB,CAAC,cAAc,MAAa,KAAO,cAAc,MAAa,KAAQ,eAAe,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,GAQtG,KAAqB,GAA0B,MAAsC;CAChG,IAAM,IAAU,OAAO,KAAO,WAAW,SAAS,cAAc,CAAE,IAAI;CACtE,IAAI,CAAC,GACH,MAAU,MAAM,sBAAsB,GAAI;CAG5C,IAAM,IAAW,EAAwB,GACnC,IAAgB,EAAsB,GAQtC,IAAW,EAAuB,EAAQ,KAAK,GAC/C,IAAoB,EAAS,GAAG,qCAAqC,MACzE,EAAS,UAAU,CAAC,CAAC,UAAU,qBAAqB,CAAO,CAC7D,GAOM,IAAqB,EAAS,GAAG,sCAAsC,MAC3E,EAAS,UAAU,CAAC,CAAC,UAAU,sBAAsB,CAAO,CAC9D,GAWM,UAAqD;EAEzD,IAAM,IAAiB,EAAQ,MAAM,UAAU;EAC/C,IAAI,CAAC,KAAkB,EAAE,WAAW,IAClC;EAEF,IAAM,IAAW,EAAe,EAAe,QAAQ,EAAQ,KAAK,GAC9D,IAAY,EAAe,EAAqB,GAAU,EAAQ,MAAM,CAAC;EAC1E,OAIL,OAAO;GAAE;GAAW,QADL,EAAe,EAAU,WAAW,MAAM,GAAU,WAAW,MAAM,EAAe,WAAW,IAC1F;EAAO;CAC7B;CAIA,IAAI,CAAC,EAAe,GAClB,MAAU,MAAM,wBAAwB,EAAQ,OAAO,YAAY,EAAE,GAAG,EAAQ,MAAM;CAOxF,IAAI,GAGE,UAAyC;EAC7C,IAAM,IAAU,EAAe;EAI/B,OAHI,MACF,IAAc,IAER,KAAW;CACrB,GAKM,IAAQ,EAA2B;EACvC,IAAI,wBAAwB;GAC1B,OAAO,EAAQ;EACjB;EACA,IAAI,kBAAkB;GACpB,OAAO,EAAQ;EACjB;EACA,IAAI,YAA6B;GAC/B,OAAO,EAAe,CAAC,CAAC;EAC1B;EACA,IAAI,SAAS;GACX,OAAO,EAAQ;EACjB;EACA,IAAI,OAAO;GACT,OAAO,EAAQ;EACjB;EACA;EACA;EACA,IAAI,kBAAkB;GACpB,OAAO,EAAQ,mBAAmB,CAAC;EACrC;EACA,IAAI,iBAAiB;GAInB,OAAO,EAAQ,MAAM,UAAU,8BAA8B,EAAQ;EACvE;EACA,IAAI,kBAAkB;GAGpB,OAAO,EAAQ,MAAM,UAAU,+BAA+B,EAAQ;EACxE;EACA,IAAI,iBAAiB;GAGnB,OAAO,EAAQ,mBAAmB,KAAA,IAAqC,EAAe,CAAC,CAAC,SAA1C,EAAQ;EACxD;CACF,CAAC,GAIK,UAAqB,EAAE,QAAQ,EAAE,OAAO,sCAAsC,GAAG,EAAQ,IAAI,GAK7F,IAAM,QACV,EAAE,OAAO,EAAE,OAAO,EAAgB,EAAQ,QAAQ,EAAE,GAAG,CACrD,EAAE,GAAoB,MAAM,EAAE,eAAe,EAAE,GAAa,GAAO,EAAE,QAAQ,EAAa,CAAC,EAAE,CAAC,CAChG,CAAC,CACH;CAKA,OAHA,EAAI,QAAQ,SAAyB,EAAQ,MAAM,iBAAiB,CAAC,GACrE,EAAI,MAAM,CAAO,GAEV;EACL;EACA,eAAe;GAGb,AAFA,EAAkB,GAClB,EAAmB,GACnB,EAAI,QAAQ;EACd;CACF;AACF"}
+{"version":3,"file":"mount.js","names":[],"sources":["../../src/code-example/mount.ts"],"sourcesContent":["import { ScalarTeleportRoot } from '@scalar/components/teleport'\nimport type { AvailableClients } from '@scalar/snippetz'\nimport type { WorkspaceStore } from '@scalar/workspace-store/client'\nimport { createWorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { getPathItemOperation } from '@scalar/workspace-store/helpers/for-each-path-item-operation'\nimport { getFirstServer } from '@scalar/workspace-store/helpers/get-first-server'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { EXTERNAL_EXAMPLES } from '@scalar/workspace-store/helpers/use-external-examples'\nimport { generateClientMutators } from '@scalar/workspace-store/mutators'\nimport type { SecuritySchemeObjectSecret } from '@scalar/workspace-store/request-example'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport { createApp, h, reactive } from 'vue'\n\nimport CodeExample, { type CodeExampleProps } from './components/CodeExample.vue'\nimport { generateClientOptions } from './helpers/generate-client-options'\n\nexport type CreateCodeExampleOptions = {\n  /** Localized status text shown when the selected example has no linked code sample. */\n  codeSampleUnavailable?: string\n  /** Localized accessible name for the focusable code sample scroller. */\n  codeSampleLabel?: string\n  /** Workspace store that holds the OpenAPI document(s) to render from. */\n  store: WorkspaceStore\n  /** Path of the operation to render, e.g. '/users/{id}'. */\n  path: string\n  /** HTTP method of the operation to render. */\n  method: string\n  /** Pre-selected client ID, e.g. 'shell/curl'. */\n  selectedClient?: AvailableClients[number]\n  /**\n   * Server object override used to build the example request.\n   *\n   * When omitted, the server is derived from the active document (operation,\n   * then path item, then document level), mirroring the API reference. Pass\n   * `null` to force \"no server\".\n   */\n  selectedServer?: ServerObject | null\n  /**\n   * Pre-selected example key for parameters and the request body.\n   *\n   * The store is the source of truth once an example is picked, so\n   * `x-scalar-default-example` wins over this initial seed and the selection\n   * round-trips through the store like the client selection does.\n   */\n  selectedExample?: string\n  /** Security schemes applicable to the operation. */\n  securitySchemes?: SecuritySchemeObjectSecret[]\n  /**\n   * Force a color mode on the rendered block.\n   *\n   * When omitted, the block inherits the ambient theme of the host page.\n   * Pass `true` for dark mode or `false` for light mode.\n   */\n  darkMode?: boolean\n}\n\n/**\n * Builds the wrapper classes for the mounted block.\n *\n * The `.scalar-app` class scopes the Tailwind utilities, and the optional\n * color-mode class lets consumers pin the block to dark or light.\n */\nconst getWrapperClass = (darkMode: boolean | undefined): string => {\n  if (darkMode === true) {\n    return 'scalar-app dark-mode'\n  }\n  if (darkMode === false) {\n    return 'scalar-app light-mode'\n  }\n  return 'scalar-app'\n}\n\n/**\n * Mount the CodeExample block to a DOM element without Vue.\n *\n * The consumer creates and controls their own workspace store,\n * then passes it in along with the path and method to render.\n */\nexport const createCodeExample = (el: HTMLElement | string, options: CreateCodeExampleOptions) => {\n  const element = typeof el === 'string' ? document.querySelector(el) : el\n  if (!element) {\n    throw new Error(`Element not found: ${el}`)\n  }\n\n  const eventBus = createWorkspaceEventBus()\n  const clientOptions = generateClientOptions()\n\n  // Persist client changes back to the store. The block emits\n  // `workspace:update:selected-client` on its private bus when the user picks a\n  // client; without this subscription the choice would never reach the store\n  // and `x-scalar-default-client` (the source of truth read below) would stay\n  // stale, so the selection would not survive a re-render or be shared with\n  // other blocks reading from the same store.\n  const mutators = generateClientMutators(options.store)\n  const unsubscribeClient = eventBus.on('workspace:update:selected-client', (payload) =>\n    mutators.workspace().workspace.updateSelectedClient(payload),\n  )\n\n  // Persist example changes back to the store as well, mirroring the client\n  // round-trip above. The block emits `workspace:update:selected-example` when\n  // the user picks an example; without this the choice would never reach\n  // `x-scalar-default-example` (read below) and would neither survive a\n  // re-render nor sync to other blocks reading from the same store.\n  const unsubscribeExample = eventBus.on('workspace:update:selected-example', (payload) =>\n    mutators.workspace().workspace.updateSelectedExample(payload),\n  )\n\n  type OperationContext = { operation: OperationObject; server: ServerObject | null }\n\n  /**\n   * Resolve the operation and its effective server from the active document.\n   *\n   * The server is resolved from the same document the operation came from\n   * (operation, then path item, then document level), so a snippet never pairs\n   * an operation with a server URL from a different spec.\n   */\n  const resolveContext = (): OperationContext | undefined => {\n    // The active document may be an AsyncAPI document, which has no `paths`.\n    const activeDocument = options.store.workspace.activeDocument\n    if (!activeDocument || !('paths' in activeDocument)) {\n      return undefined\n    }\n    const pathItem = getResolvedRef(activeDocument.paths?.[options.path])\n    const operation = getResolvedRef(getPathItemOperation(pathItem, options.method))\n    if (!operation) {\n      return undefined\n    }\n    const server = getFirstServer(operation.servers ?? null, pathItem?.servers ?? null, activeDocument.servers ?? null)\n    return { operation, server }\n  }\n\n  // Fail loudly if the path and method do not point at an operation in the store,\n  // mirroring the \"element not found\" guard above.\n  if (!resolveContext()) {\n    throw new Error(`Operation not found: ${options.method.toUpperCase()} ${options.path}`)\n  }\n\n  // Remember the last context that resolved so a transient miss (e.g. the active\n  // document is swapped to one without this path or method after mount) keeps\n  // rendering the previous operation, paired with the server it actually came\n  // from, instead of feeding `undefined` to the block.\n  let lastContext: OperationContext | undefined\n\n  /** Current operation + server, falling back to the last good resolution on a transient miss. */\n  const currentContext = (): OperationContext => {\n    const context = resolveContext()\n    if (context) {\n      lastContext = context\n    }\n    return (context ?? lastContext) as OperationContext\n  }\n\n  // Props are getters so the block tracks the reactive store (active document,\n  // `x-scalar-default-client`, `x-scalar-default-example`) live. Change the\n  // client, example, or server through the store to drive re-renders.\n  const props = reactive<CodeExampleProps>({\n    get codeSampleUnavailable() {\n      return options.codeSampleUnavailable\n    },\n    get codeSampleLabel() {\n      return options.codeSampleLabel\n    },\n    get operation(): OperationObject {\n      return currentContext().operation\n    },\n    get method() {\n      return options.method\n    },\n    get path() {\n      return options.path\n    },\n    clientOptions,\n    eventBus,\n    get securitySchemes() {\n      return options.securitySchemes ?? []\n    },\n    get selectedClient() {\n      // The store is the source of truth once the user picks a client, so it\n      // wins over the initial `options.selectedClient` seed and the selection\n      // round-trips through the subscription above.\n      return options.store.workspace['x-scalar-default-client'] ?? options.selectedClient\n    },\n    get selectedExample() {\n      // Same as the client: the store wins over the initial seed so the example\n      // selection survives re-renders and syncs across blocks.\n      return options.store.workspace['x-scalar-default-example'] ?? options.selectedExample\n    },\n    get selectedServer() {\n      // An explicit option wins (including an explicit `null` for \"no server\");\n      // otherwise derive it from the same document the operation resolved from.\n      return options.selectedServer !== undefined ? options.selectedServer : currentContext().server\n    },\n  })\n\n  // Render the operation path in the header by default. The reference renders\n  // this via the `#header` slot too, so the standalone block matches its look.\n  const renderHeader = () => h('span', { class: 'font-code text-c-2 min-w-0 truncate' }, options.path)\n\n  // Wrap the block in its own teleport root so floating UI (the client picker\n  // popover) renders inside the themed `.scalar-app` wrapper instead of escaping\n  // to `body`, where it would miss the color-mode variables and lose its styling.\n  const app = createApp(() =>\n    h('div', { class: getWrapperClass(options.darkMode) }, [\n      h(ScalarTeleportRoot, null, { default: () => h(CodeExample, props, { header: renderHeader }) }),\n    ]),\n  )\n\n  app.provide(EXTERNAL_EXAMPLES, () => options.store.externalExamples())\n  app.mount(element)\n\n  return {\n    app,\n    destroy: () => {\n      unsubscribeClient()\n      unsubscribeExample()\n      app.unmount()\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;AA8DA,IAAM,KAAmB,MACnB,MAAa,KACR,yBAEL,MAAa,KACR,0BAEF,cASI,KAAqB,GAA0B,MAAsC;CAChG,IAAM,IAAU,OAAO,KAAO,WAAW,SAAS,cAAc,CAAE,IAAI;CACtE,IAAI,CAAC,GACH,MAAU,MAAM,sBAAsB,GAAI;CAG5C,IAAM,IAAW,EAAwB,GACnC,IAAgB,EAAsB,GAQtC,IAAW,EAAuB,EAAQ,KAAK,GAC/C,IAAoB,EAAS,GAAG,qCAAqC,MACzE,EAAS,UAAU,CAAC,CAAC,UAAU,qBAAqB,CAAO,CAC7D,GAOM,IAAqB,EAAS,GAAG,sCAAsC,MAC3E,EAAS,UAAU,CAAC,CAAC,UAAU,sBAAsB,CAAO,CAC9D,GAWM,UAAqD;EAEzD,IAAM,IAAiB,EAAQ,MAAM,UAAU;EAC/C,IAAI,CAAC,KAAkB,EAAE,WAAW,IAClC;EAEF,IAAM,IAAW,EAAe,EAAe,QAAQ,EAAQ,KAAK,GAC9D,IAAY,EAAe,EAAqB,GAAU,EAAQ,MAAM,CAAC;EAC1E,OAIL,OAAO;GAAE;GAAW,QADL,EAAe,EAAU,WAAW,MAAM,GAAU,WAAW,MAAM,EAAe,WAAW,IAC1F;EAAO;CAC7B;CAIA,IAAI,CAAC,EAAe,GAClB,MAAU,MAAM,wBAAwB,EAAQ,OAAO,YAAY,EAAE,GAAG,EAAQ,MAAM;CAOxF,IAAI,GAGE,UAAyC;EAC7C,IAAM,IAAU,EAAe;EAI/B,OAHI,MACF,IAAc,IAER,KAAW;CACrB,GAKM,IAAQ,EAA2B;EACvC,IAAI,wBAAwB;GAC1B,OAAO,EAAQ;EACjB;EACA,IAAI,kBAAkB;GACpB,OAAO,EAAQ;EACjB;EACA,IAAI,YAA6B;GAC/B,OAAO,EAAe,CAAC,CAAC;EAC1B;EACA,IAAI,SAAS;GACX,OAAO,EAAQ;EACjB;EACA,IAAI,OAAO;GACT,OAAO,EAAQ;EACjB;EACA;EACA;EACA,IAAI,kBAAkB;GACpB,OAAO,EAAQ,mBAAmB,CAAC;EACrC;EACA,IAAI,iBAAiB;GAInB,OAAO,EAAQ,MAAM,UAAU,8BAA8B,EAAQ;EACvE;EACA,IAAI,kBAAkB;GAGpB,OAAO,EAAQ,MAAM,UAAU,+BAA+B,EAAQ;EACxE;EACA,IAAI,iBAAiB;GAGnB,OAAO,EAAQ,mBAAmB,KAAA,IAAqC,EAAe,CAAC,CAAC,SAA1C,EAAQ;EACxD;CACF,CAAC,GAIK,UAAqB,EAAE,QAAQ,EAAE,OAAO,sCAAsC,GAAG,EAAQ,IAAI,GAK7F,IAAM,QACV,EAAE,OAAO,EAAE,OAAO,EAAgB,EAAQ,QAAQ,EAAE,GAAG,CACrD,EAAE,GAAoB,MAAM,EAAE,eAAe,EAAE,GAAa,GAAO,EAAE,QAAQ,EAAa,CAAC,EAAE,CAAC,CAChG,CAAC,CACH;CAKA,OAHA,EAAI,QAAQ,SAAyB,EAAQ,MAAM,iBAAiB,CAAC,GACrE,EAAI,MAAM,CAAO,GAEV;EACL;EACA,eAAe;GAGb,AAFA,EAAkB,GAClB,EAAmB,GACnB,EAAI,QAAQ;EACd;CACF;AACF"}

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.2";
 //#endregion
 export { e as APP_VERSION };