@scalar/api-client 2.38.3 → 2.39.0

package/dist/v2/blocks/operation-block/helpers/send-request.js

@@ -0,0 +1,149 @@
+import { ERRORS, normalizeError } from "../../../../libs/errors.js";
+import { normalizeHeaders } from "../../../../libs/normalize-headers.js";
+import { getCookieHeaderKeys } from "./get-cookie-header-keys.js";
+import { decodeBuffer } from "./decode-buffer.js";
+import { executeHook } from "@scalar/oas-utils/helpers";
+import { httpStatusCodes as httpStatusCodes$1 } from "@scalar/helpers/http/http-status-codes";
+//#region src/v2/blocks/operation-block/helpers/send-request.ts
+/** HTTP status codes that should not include a response body */
+var NO_BODY_STATUS_CODES = [
+	204,
+	205,
+	304
+];
+/**
+* Execute the built fetch request and return a structured response.
+*
+* This function handles the complete request lifecycle including plugin hooks,
+* response processing, streaming detection, and error handling. It supports both
+* standard responses and server-sent event streams.
+*
+* @param request - The request built by the buildRequest helper
+* @param operation - The OpenAPI operation being executed
+* @param plugins - Array of client plugins to execute hooks
+* @param isUsingProxy - Whether the request is being proxied for header handling
+* @returns A tuple with either an error or the response data
+*/
+var sendRequest = async ({ isUsingProxy, operation, request, plugins }) => {
+	try {
+		const { request: modifiedRequest } = await executeHook({ request }, "beforeRequest", plugins);
+		const startTime = Date.now();
+		const response = await fetch(modifiedRequest.clone());
+		const endTime = Date.now();
+		const duration = endTime - startTime;
+		const contentType = response.headers.get("content-type");
+		const responseHeaders = normalizeHeaders(response.headers, isUsingProxy);
+		const responseUrl = new URL(response.url);
+		const fullPath = responseUrl.pathname + responseUrl.search;
+		const statusText = response.statusText || httpStatusCodes$1[response.status]?.name || "";
+		const method = modifiedRequest.method;
+		const shouldSkipBody = NO_BODY_STATUS_CODES.includes(response.status);
+		/**
+		* Handle server-sent event streams separately.
+		* These responses need a reader instead of buffered data.
+		* We check this early to avoid unnecessary body reading.
+		*/
+		if (contentType?.startsWith("text/event-stream") && response.body) return buildStreamingResponse({
+			response,
+			modifiedRequest,
+			operation,
+			plugins,
+			endTime,
+			duration,
+			responseHeaders,
+			statusText,
+			method,
+			fullPath
+		});
+		return buildStandardResponse({
+			response,
+			modifiedRequest,
+			operation,
+			plugins,
+			endTime,
+			duration,
+			responseHeaders,
+			statusText,
+			method,
+			fullPath,
+			contentType,
+			shouldSkipBody
+		});
+	} catch (error) {
+		return [normalizeError(error, ERRORS.REQUEST_FAILED), null];
+	}
+};
+/**
+* Build a streaming response for server-sent events.
+* Streaming responses use a reader instead of buffering the entire body.
+*/
+var buildStreamingResponse = async ({ response, modifiedRequest, operation, plugins, endTime, duration, responseHeaders, statusText, method, fullPath }) => {
+	const normalizedResponse = new Response(null, {
+		status: response.status,
+		statusText,
+		headers: response.headers
+	});
+	await executeHook({
+		response: normalizedResponse,
+		request: modifiedRequest,
+		operation
+	}, "responseReceived", plugins);
+	const cookieHeaderKeys = getCookieHeaderKeys(normalizedResponse.headers);
+	return [null, {
+		timestamp: endTime,
+		request: modifiedRequest,
+		response: {
+			...normalizedResponse,
+			headers: responseHeaders,
+			cookieHeaderKeys,
+			reader: response.body.getReader(),
+			duration,
+			method,
+			path: fullPath
+		},
+		originalResponse: normalizedResponse.clone()
+	}];
+};
+/**
+* Build a standard response with buffered body data.
+* This handles all non-streaming responses including JSON, text, and binary data.
+*/
+var buildStandardResponse = async ({ response, modifiedRequest, operation, plugins, endTime, duration, responseHeaders, statusText, method, fullPath, contentType, shouldSkipBody }) => {
+	const arrayBuffer = await response.clone().arrayBuffer();
+	const responseData = decodeBuffer(arrayBuffer, contentType ?? "text/plain;charset=UTF-8");
+	/**
+	* Create a new Response using the arrayBuffer we already read.
+	* ArrayBuffers can be reused to create new Response objects without additional memory.
+	*/
+	const normalizedResponse = new Response(shouldSkipBody ? null : arrayBuffer, {
+		status: response.status,
+		statusText,
+		headers: response.headers
+	});
+	await executeHook({
+		response: normalizedResponse,
+		request: modifiedRequest,
+		operation
+	}, "responseReceived", plugins);
+	const cookieHeaderKeys = getCookieHeaderKeys(normalizedResponse.headers);
+	return [null, {
+		timestamp: endTime,
+		request: modifiedRequest,
+		response: {
+			...normalizedResponse,
+			headers: responseHeaders,
+			cookieHeaderKeys,
+			data: responseData,
+			size: arrayBuffer.byteLength,
+			duration,
+			method,
+			status: response.status,
+			path: fullPath
+		},
+		originalResponse: response.clone()
+	}];
+};
+//#endregion
+export { sendRequest };
+
+//# sourceMappingURL=send-request.js.map

package/dist/v2/blocks/operation-block/helpers/send-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-request.js","names":[],"sources":["../../../../../src/v2/blocks/operation-block/helpers/send-request.ts"],"sourcesContent":["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { httpStatusCodes } from '@scalar/helpers/http/http-status-codes'\nimport { type ClientPlugin, executeHook } from '@scalar/oas-utils/helpers'\nimport type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\nimport { ERRORS, type ErrorResponse, normalizeError } from '@/libs/errors'\nimport { normalizeHeaders } from '@/libs/normalize-headers'\n\nimport { decodeBuffer } from './decode-buffer'\nimport { getCookieHeaderKeys } from './get-cookie-header-keys'\n\n/** A single set of populated values for a sent request */\nexport type ResponseInstance = Omit<Response, 'headers'> & {\n  /** Store headers as an object to match what we had with axios */\n  headers: Record<string, string>\n  /** Keys of headers which set cookies */\n  cookieHeaderKeys: string[]\n  /** Time in ms the request took */\n  duration: number\n  /** The response status */\n  status: number\n  /** The response status text */\n  statusText: string\n  /** The response method */\n  method: HttpMethod\n  /** The request path */\n  path: string\n} & (\n    | {\n        /** The response data */\n        data: string | Blob\n        /** The response size in bytes */\n        size: number\n      }\n    | {\n        /** A stream reader for a streamable response body */\n        reader: ReadableStreamDefaultReader<Uint8Array>\n      }\n  )\n\n/** HTTP status codes that should not include a response body */\nconst NO_BODY_STATUS_CODES = [204, 205, 304]\n\n/**\n * Execute the built fetch request and return a structured response.\n *\n * This function handles the complete request lifecycle including plugin hooks,\n * response processing, streaming detection, and error handling. It supports both\n * standard responses and server-sent event streams.\n *\n * @param request - The request built by the buildRequest helper\n * @param operation - The OpenAPI operation being executed\n * @param plugins - Array of client plugins to execute hooks\n * @param isUsingProxy - Whether the request is being proxied for header handling\n * @returns A tuple with either an error or the response data\n */\nexport const sendRequest = async ({\n  isUsingProxy,\n  operation,\n  request,\n  plugins,\n}: {\n  isUsingProxy: boolean\n  operation: OperationObject\n  plugins: ClientPlugin[]\n  request: Request\n}): Promise<\n  ErrorResponse<{\n    response: ResponseInstance\n    request: Request\n    timestamp: number\n    originalResponse: Response\n  }>\n> => {\n  try {\n    // Apply any beforeRequest hooks from the plugins\n    const { request: modifiedRequest } = await executeHook({ request }, 'beforeRequest', plugins)\n\n    // Execute the request and measure duration\n    const startTime = Date.now()\n    const response = await fetch(modifiedRequest.clone())\n    const endTime = Date.now()\n    const duration = endTime - startTime\n\n    // Extract response metadata early for reuse\n    const contentType = response.headers.get('content-type')\n    const responseHeaders = normalizeHeaders(response.headers, isUsingProxy)\n    const responseUrl = new URL(response.url)\n    const fullPath = responseUrl.pathname + responseUrl.search\n    const statusText = response.statusText || httpStatusCodes[response.status]?.name || ''\n    const method = modifiedRequest.method as HttpMethod\n    const shouldSkipBody = NO_BODY_STATUS_CODES.includes(response.status)\n\n    /**\n     * Handle server-sent event streams separately.\n     * These responses need a reader instead of buffered data.\n     * We check this early to avoid unnecessary body reading.\n     */\n    if (contentType?.startsWith('text/event-stream') && response.body) {\n      return buildStreamingResponse({\n        response,\n        modifiedRequest,\n        operation,\n        plugins,\n        endTime,\n        duration,\n        responseHeaders,\n        statusText,\n        method,\n        fullPath,\n      })\n    }\n\n    return buildStandardResponse({\n      response,\n      modifiedRequest,\n      operation,\n      plugins,\n      endTime,\n      duration,\n      responseHeaders,\n      statusText,\n      method,\n      fullPath,\n      contentType,\n      shouldSkipBody,\n    })\n  } catch (error) {\n    return [normalizeError(error, ERRORS.REQUEST_FAILED), null]\n  }\n}\n\n/**\n * Build a streaming response for server-sent events.\n * Streaming responses use a reader instead of buffering the entire body.\n */\nconst buildStreamingResponse = async ({\n  response,\n  modifiedRequest,\n  operation,\n  plugins,\n  endTime,\n  duration,\n  responseHeaders,\n  statusText,\n  method,\n  fullPath,\n}: {\n  response: Response\n  modifiedRequest: Request\n  operation: OperationObject\n  plugins: ClientPlugin[]\n  endTime: number\n  duration: number\n  responseHeaders: Record<string, string>\n  statusText: string\n  method: HttpMethod\n  fullPath: string\n}): Promise<\n  ErrorResponse<{\n    response: ResponseInstance\n    request: Request\n    timestamp: number\n    originalResponse: Response\n  }>\n> => {\n  const normalizedResponse = new Response(null, {\n    status: response.status,\n    statusText,\n    headers: response.headers,\n  })\n\n  await executeHook({ response: normalizedResponse, request: modifiedRequest, operation }, 'responseReceived', plugins)\n  const cookieHeaderKeys = getCookieHeaderKeys(normalizedResponse.headers)\n\n  return [\n    null,\n    {\n      timestamp: endTime,\n      request: modifiedRequest,\n      response: {\n        ...normalizedResponse,\n        headers: responseHeaders,\n        cookieHeaderKeys,\n        reader: response.body!.getReader(),\n        duration,\n        method,\n        path: fullPath,\n      },\n      originalResponse: normalizedResponse.clone(),\n    },\n  ]\n}\n\n/**\n * Build a standard response with buffered body data.\n * This handles all non-streaming responses including JSON, text, and binary data.\n */\nconst buildStandardResponse = async ({\n  response,\n  modifiedRequest,\n  operation,\n  plugins,\n  endTime,\n  duration,\n  responseHeaders,\n  statusText,\n  method,\n  fullPath,\n  contentType,\n  shouldSkipBody,\n}: {\n  response: Response\n  modifiedRequest: Request\n  operation: OperationObject\n  plugins: ClientPlugin[]\n  endTime: number\n  duration: number\n  responseHeaders: Record<string, string>\n  statusText: string\n  method: HttpMethod\n  fullPath: string\n  contentType: string | null\n  shouldSkipBody: boolean\n}): Promise<\n  ErrorResponse<{\n    response: ResponseInstance\n    request: Request\n    timestamp: number\n    originalResponse: Response\n  }>\n> => {\n  /**\n   * Clone the response to preserve the original for body reading.\n   * Read the body once and reuse the buffer for both decoding and creating a new Response.\n   */\n  const clonedResponse = response.clone()\n  const arrayBuffer = await clonedResponse.arrayBuffer()\n  const responseType = contentType ?? 'text/plain;charset=UTF-8'\n  const responseData = decodeBuffer(arrayBuffer, responseType)\n\n  /**\n   * Create a new Response using the arrayBuffer we already read.\n   * ArrayBuffers can be reused to create new Response objects without additional memory.\n   */\n  const normalizedResponse = new Response(shouldSkipBody ? null : arrayBuffer, {\n    status: response.status,\n    statusText,\n    headers: response.headers,\n  })\n\n  await executeHook({ response: normalizedResponse, request: modifiedRequest, operation }, 'responseReceived', plugins)\n  const cookieHeaderKeys = getCookieHeaderKeys(normalizedResponse.headers)\n\n  return [\n    null,\n    {\n      timestamp: endTime,\n      request: modifiedRequest,\n      response: {\n        ...normalizedResponse,\n        headers: responseHeaders,\n        cookieHeaderKeys,\n        data: responseData,\n        size: arrayBuffer.byteLength,\n        duration,\n        method,\n        status: response.status,\n        path: fullPath,\n      },\n      originalResponse: response.clone(),\n    },\n  ]\n}\n"],"mappings":";;;;;;;;AAyCA,IAAM,uBAAuB;CAAC;CAAK;CAAK;CAAI;;;;;;;;;;;;;;AAe5C,IAAa,cAAc,OAAO,EAChC,cACA,WACA,SACA,cAaG;AACH,KAAI;EAEF,MAAM,EAAE,SAAS,oBAAoB,MAAM,YAAY,EAAE,SAAS,EAAE,iBAAiB,QAAQ;EAG7F,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,WAAW,MAAM,MAAM,gBAAgB,OAAO,CAAC;EACrD,MAAM,UAAU,KAAK,KAAK;EAC1B,MAAM,WAAW,UAAU;EAG3B,MAAM,cAAc,SAAS,QAAQ,IAAI,eAAe;EACxD,MAAM,kBAAkB,iBAAiB,SAAS,SAAS,aAAa;EACxE,MAAM,cAAc,IAAI,IAAI,SAAS,IAAI;EACzC,MAAM,WAAW,YAAY,WAAW,YAAY;EACpD,MAAM,aAAa,SAAS,cAAc,kBAAgB,SAAS,SAAS,QAAQ;EACpF,MAAM,SAAS,gBAAgB;EAC/B,MAAM,iBAAiB,qBAAqB,SAAS,SAAS,OAAO;;;;;;AAOrE,MAAI,aAAa,WAAW,oBAAoB,IAAI,SAAS,KAC3D,QAAO,uBAAuB;GAC5B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAO,sBAAsB;GAC3B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;UACK,OAAO;AACd,SAAO,CAAC,eAAe,OAAO,OAAO,eAAe,EAAE,KAAK;;;;;;;AAQ/D,IAAM,yBAAyB,OAAO,EACpC,UACA,iBACA,WACA,SACA,SACA,UACA,iBACA,YACA,QACA,eAmBG;CACH,MAAM,qBAAqB,IAAI,SAAS,MAAM;EAC5C,QAAQ,SAAS;EACjB;EACA,SAAS,SAAS;EACnB,CAAC;AAEF,OAAM,YAAY;EAAE,UAAU;EAAoB,SAAS;EAAiB;EAAW,EAAE,oBAAoB,QAAQ;CACrH,MAAM,mBAAmB,oBAAoB,mBAAmB,QAAQ;AAExE,QAAO,CACL,MACA;EACE,WAAW;EACX,SAAS;EACT,UAAU;GACR,GAAG;GACH,SAAS;GACT;GACA,QAAQ,SAAS,KAAM,WAAW;GAClC;GACA;GACA,MAAM;GACP;EACD,kBAAkB,mBAAmB,OAAO;EAC7C,CACF;;;;;;AAOH,IAAM,wBAAwB,OAAO,EACnC,UACA,iBACA,WACA,SACA,SACA,UACA,iBACA,YACA,QACA,UACA,aACA,qBAqBG;CAMH,MAAM,cAAc,MADG,SAAS,OAAO,CACE,aAAa;CAEtD,MAAM,eAAe,aAAa,aADb,eAAe,2BACwB;;;;;CAM5D,MAAM,qBAAqB,IAAI,SAAS,iBAAiB,OAAO,aAAa;EAC3E,QAAQ,SAAS;EACjB;EACA,SAAS,SAAS;EACnB,CAAC;AAEF,OAAM,YAAY;EAAE,UAAU;EAAoB,SAAS;EAAiB;EAAW,EAAE,oBAAoB,QAAQ;CACrH,MAAM,mBAAmB,oBAAoB,mBAAmB,QAAQ;AAExE,QAAO,CACL,MACA;EACE,WAAW;EACX,SAAS;EACT,UAAU;GACR,GAAG;GACH,SAAS;GACT;GACA,MAAM;GACN,MAAM,YAAY;GAClB;GACA;GACA,QAAQ,SAAS;GACjB,MAAM;GACP;EACD,kBAAkB,SAAS,OAAO;EACnC,CACF"}

package/dist/v2/blocks/operation-block/helpers/serialize-parameter.js

@@ -0,0 +1,160 @@
+//#region src/v2/blocks/operation-block/helpers/serialize-parameter.ts
+/**
+* Shared parameter serialization utilities for OpenAPI style values.
+* Used by both build-request-parameters and process-parameters.
+*
+* @see https://spec.openapis.org/oas/v3.1.1.html#style-values
+*/
+/**
+* Serializes a value based on the content type for content-based query parameters.
+* Content-based query parameters do not use style serialization and instead follow
+* their content type specification (e.g., application/json should be JSON.stringified).
+*
+* @param value - The value to serialize
+* @param contentType - The content type to use for serialization
+* @returns The serialized value as a string
+*/
+var serializeContentValue = (value, contentType) => {
+	if (typeof value === "string") return value;
+	if (contentType.includes("json") || typeof value === "object" && value !== null && !Array.isArray(value)) return JSON.stringify(value);
+	return String(value);
+};
+/**
+* Serializes a value according to OpenAPI simple style.
+* Used for path and header parameters.
+*
+* Simple style with explode: false
+* - Primitive: blue
+* - Array: blue,black,brown
+* - Object: R,100,G,200,B,150
+*
+* Simple style with explode: true
+* - Primitive: blue
+* - Array: blue,black,brown
+* - Object: R=100,G=200,B=150
+*/
+var serializeSimpleStyle = (value, explode) => {
+	if (Array.isArray(value)) return value.join(",");
+	if (typeof value === "object" && value !== null) {
+		const entries = Object.entries(value);
+		if (explode) return entries.map(([k, v]) => `${k}=${v}`).join(",");
+		return entries.map(([k, v]) => `${k},${v}`).join(",");
+	}
+	return value;
+};
+/**
+* Serializes a value according to OpenAPI form style.
+* Used for query and cookie parameters.
+*
+* Form style with explode: true (default for query)
+* - Primitive: color=blue
+* - Array: color=blue&color=black&color=brown (multiple entries)
+* - Object: R=100&G=200&B=150 (multiple entries)
+*
+* Form style with explode: false
+* - Primitive: color=blue
+* - Array: color=blue,black,brown
+* - Object: color=R,100,G,200,B,150
+*/
+var serializeFormStyle = (value, explode) => {
+	if (Array.isArray(value) && explode) return value.map((v) => ({
+		key: "",
+		value: v
+	}));
+	if (Array.isArray(value)) return value.join(",");
+	if (typeof value === "object" && value !== null && explode) return Object.entries(value).map(([k, v]) => ({
+		key: k,
+		value: v
+	}));
+	if (typeof value === "object" && value !== null) return Object.entries(value).map(([k, v]) => `${k},${v}`).join(",");
+	return value;
+};
+/**
+* Serializes a value according to OpenAPI form style for cookies.
+* This is similar to serializeFormStyle but handles nested objects recursively
+* and treats null values specially for cookie serialization.
+*
+* Form style with explode: true (default for cookies)
+* - Primitive: color=blue
+* - Array: color=blue&color=black&color=brown (multiple entries)
+* - Object: R=100&G=200&B=150 (multiple entries)
+*
+* Form style with explode: false
+* - Primitive: color=blue
+* - Array: color=blue,black,brown (null becomes "null")
+* - Object: color=R,100,G,200,B,150 (recursively flattened)
+*/
+var serializeFormStyleForCookies = (value, explode) => {
+	if (Array.isArray(value) && explode) return value.map((v) => ({
+		key: "",
+		value: v
+	}));
+	if (Array.isArray(value)) return value.map((v) => v === null ? "null" : String(v)).join(",");
+	if (typeof value === "object" && value !== null && explode) return Object.entries(value).map(([k, v]) => ({
+		key: k,
+		value: v
+	}));
+	if (typeof value === "object" && value !== null) {
+		const flattenObject = (obj) => {
+			const result = [];
+			for (const [key, val] of Object.entries(obj)) if (typeof val === "object" && val !== null && !Array.isArray(val)) result.push(key, ...flattenObject(val));
+			else result.push(key, val === null ? "null" : String(val));
+			return result;
+		};
+		return flattenObject(value).join(",");
+	}
+	return value;
+};
+/**
+* Serializes a value according to OpenAPI spaceDelimited style.
+* Only valid for query parameters with array or object values.
+*
+* SpaceDelimited array: blue black brown
+* SpaceDelimited object: R 100 G 200 B 150
+*/
+var serializeSpaceDelimitedStyle = (value) => {
+	if (Array.isArray(value)) return value.join(" ");
+	if (typeof value === "object" && value !== null) return Object.entries(value).map(([k, v]) => `${k} ${v}`).join(" ");
+	return String(value);
+};
+/**
+* Serializes a value according to OpenAPI pipeDelimited style.
+* Only valid for query parameters with array or object values.
+*
+* PipeDelimited array: blue|black|brown
+* PipeDelimited object: R|100|G|200|B|150
+*/
+var serializePipeDelimitedStyle = (value) => {
+	if (Array.isArray(value)) return value.join("|");
+	if (typeof value === "object" && value !== null) return Object.entries(value).flat().join("|");
+	return String(value);
+};
+/**
+* Serializes a value according to OpenAPI deepObject style.
+* Only valid for query parameters with explode: true.
+*
+* DeepObject: color[R]=100&color[G]=200&color[B]=150
+* Nested: user[name][first]=Alex&user[name][last]=Smith&user[role]=admin
+*/
+var serializeDeepObjectStyle = (paramName, value) => {
+	const result = [];
+	/**
+	* Recursively flattens nested objects into deepObject notation.
+	*/
+	const flatten = (obj, prefix) => {
+		for (const [key, val] of Object.entries(obj)) {
+			const fullKey = `${prefix}[${key}]`;
+			if (typeof val === "object" && val !== null && !Array.isArray(val)) flatten(val, fullKey);
+			else result.push({
+				key: fullKey,
+				value: String(val)
+			});
+		}
+	};
+	if (typeof value === "object" && value !== null && !Array.isArray(value)) flatten(value, paramName);
+	return result;
+};
+//#endregion
+export { serializeContentValue, serializeDeepObjectStyle, serializeFormStyle, serializeFormStyleForCookies, serializePipeDelimitedStyle, serializeSimpleStyle, serializeSpaceDelimitedStyle };
+
+//# sourceMappingURL=serialize-parameter.js.map

package/dist/v2/blocks/operation-block/helpers/serialize-parameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-parameter.js","names":[],"sources":["../../../../../src/v2/blocks/operation-block/helpers/serialize-parameter.ts"],"sourcesContent":["/**\n * Shared parameter serialization utilities for OpenAPI style values.\n * Used by both build-request-parameters and process-parameters.\n *\n * @see https://spec.openapis.org/oas/v3.1.1.html#style-values\n */\n\n/**\n * Serializes a value based on the content type for content-based query parameters.\n * Content-based query parameters do not use style serialization and instead follow\n * their content type specification (e.g., application/json should be JSON.stringified).\n *\n * @param value - The value to serialize\n * @param contentType - The content type to use for serialization\n * @returns The serialized value as a string\n */\nexport const serializeContentValue = (value: unknown, contentType: string): string => {\n  // If already a string, return as is\n  if (typeof value === 'string') {\n    return value\n  }\n\n  // Handle JSON content types\n  if (contentType.includes('json') || (typeof value === 'object' && value !== null && !Array.isArray(value))) {\n    return JSON.stringify(value)\n  }\n\n  // Default: convert to string\n  return String(value)\n}\n\n/**\n * Serializes a value according to OpenAPI simple style.\n * Used for path and header parameters.\n *\n * Simple style with explode: false\n * - Primitive: blue\n * - Array: blue,black,brown\n * - Object: R,100,G,200,B,150\n *\n * Simple style with explode: true\n * - Primitive: blue\n * - Array: blue,black,brown\n * - Object: R=100,G=200,B=150\n */\nexport const serializeSimpleStyle = (value: unknown, explode: boolean): unknown => {\n  // Handle arrays\n  if (Array.isArray(value)) {\n    return value.join(',')\n  }\n\n  // Handle objects\n  if (typeof value === 'object' && value !== null) {\n    const entries = Object.entries(value as Record<string, unknown>)\n\n    if (explode) {\n      // Simple explode object: R=100,G=200,B=150\n      return entries.map(([k, v]) => `${k}=${v}`).join(',')\n    }\n\n    // Simple no explode object: R,100,G,200,B,150\n    return entries.map(([k, v]) => `${k},${v}`).join(',')\n  }\n\n  // Handle primitives - return as-is to preserve type\n  return value\n}\n\n/**\n * Serializes a value according to OpenAPI form style.\n * Used for query and cookie parameters.\n *\n * Form style with explode: true (default for query)\n * - Primitive: color=blue\n * - Array: color=blue&color=black&color=brown (multiple entries)\n * - Object: R=100&G=200&B=150 (multiple entries)\n *\n * Form style with explode: false\n * - Primitive: color=blue\n * - Array: color=blue,black,brown\n * - Object: color=R,100,G,200,B,150\n */\nexport const serializeFormStyle = (\n  value: unknown,\n  explode: boolean,\n): unknown | Array<{ key: string; value: unknown }> => {\n  // Handle arrays with explode\n  if (Array.isArray(value) && explode) {\n    return value.map((v) => ({ key: '', value: v }))\n  }\n\n  // Handle arrays without explode\n  if (Array.isArray(value)) {\n    return value.join(',')\n  }\n\n  // Handle objects with explode\n  if (typeof value === 'object' && value !== null && explode) {\n    return Object.entries(value as Record<string, unknown>).map(([k, v]) => ({\n      key: k,\n      value: v,\n    }))\n  }\n\n  // Handle objects without explode\n  if (typeof value === 'object' && value !== null) {\n    return Object.entries(value as Record<string, unknown>)\n      .map(([k, v]) => `${k},${v}`)\n      .join(',')\n  }\n\n  // Handle primitives - return as-is to preserve type\n  return value\n}\n\n/**\n * Serializes a value according to OpenAPI form style for cookies.\n * This is similar to serializeFormStyle but handles nested objects recursively\n * and treats null values specially for cookie serialization.\n *\n * Form style with explode: true (default for cookies)\n * - Primitive: color=blue\n * - Array: color=blue&color=black&color=brown (multiple entries)\n * - Object: R=100&G=200&B=150 (multiple entries)\n *\n * Form style with explode: false\n * - Primitive: color=blue\n * - Array: color=blue,black,brown (null becomes \"null\")\n * - Object: color=R,100,G,200,B,150 (recursively flattened)\n */\nexport const serializeFormStyleForCookies = (\n  value: unknown,\n  explode: boolean,\n): unknown | Array<{ key: string; value: unknown }> => {\n  // Handle arrays with explode\n  if (Array.isArray(value) && explode) {\n    return value.map((v) => ({ key: '', value: v }))\n  }\n\n  // Handle arrays without explode - convert null to \"null\" string\n  if (Array.isArray(value)) {\n    return value.map((v) => (v === null ? 'null' : String(v))).join(',')\n  }\n\n  // Handle objects with explode\n  if (typeof value === 'object' && value !== null && explode) {\n    return Object.entries(value as Record<string, unknown>).map(([k, v]) => ({\n      key: k,\n      value: v,\n    }))\n  }\n\n  // Handle objects without explode - recursively flatten nested objects\n  if (typeof value === 'object' && value !== null) {\n    const flattenObject = (obj: Record<string, unknown>): string[] => {\n      const result: string[] = []\n\n      for (const [key, val] of Object.entries(obj)) {\n        // Recursively flatten nested objects\n        if (typeof val === 'object' && val !== null && !Array.isArray(val)) {\n          result.push(key, ...flattenObject(val as Record<string, unknown>))\n        }\n        // Handle primitive values\n        else {\n          result.push(key, val === null ? 'null' : String(val))\n        }\n      }\n\n      return result\n    }\n\n    return flattenObject(value as Record<string, unknown>).join(',')\n  }\n\n  // Handle primitives - return as-is to preserve type\n  return value\n}\n\n/**\n * Serializes a value according to OpenAPI spaceDelimited style.\n * Only valid for query parameters with array or object values.\n *\n * SpaceDelimited array: blue black brown\n * SpaceDelimited object: R 100 G 200 B 150\n */\nexport const serializeSpaceDelimitedStyle = (value: unknown): string => {\n  // Handle arrays\n  if (Array.isArray(value)) {\n    return value.join(' ')\n  }\n\n  // Handle objects\n  if (typeof value === 'object' && value !== null) {\n    return Object.entries(value as Record<string, unknown>)\n      .map(([k, v]) => `${k} ${v}`)\n      .join(' ')\n  }\n\n  // Handle primitives (shouldn't happen for spaceDelimited)\n  return String(value)\n}\n\n/**\n * Serializes a value according to OpenAPI pipeDelimited style.\n * Only valid for query parameters with array or object values.\n *\n * PipeDelimited array: blue|black|brown\n * PipeDelimited object: R|100|G|200|B|150\n */\nexport const serializePipeDelimitedStyle = (value: unknown): string => {\n  // Handle arrays\n  if (Array.isArray(value)) {\n    return value.join('|')\n  }\n\n  // Handle objects\n  if (typeof value === 'object' && value !== null) {\n    return Object.entries(value as Record<string, unknown>)\n      .flat()\n      .join('|')\n  }\n\n  // Handle primitives (shouldn't happen for pipeDelimited)\n  return String(value)\n}\n\n/**\n * Serializes a value according to OpenAPI deepObject style.\n * Only valid for query parameters with explode: true.\n *\n * DeepObject: color[R]=100&color[G]=200&color[B]=150\n * Nested: user[name][first]=Alex&user[name][last]=Smith&user[role]=admin\n */\nexport const serializeDeepObjectStyle = (paramName: string, value: unknown): Array<{ key: string; value: string }> => {\n  const result: Array<{ key: string; value: string }> = []\n\n  /**\n   * Recursively flattens nested objects into deepObject notation.\n   */\n  const flatten = (obj: Record<string, unknown>, prefix: string): void => {\n    for (const [key, val] of Object.entries(obj)) {\n      const fullKey = `${prefix}[${key}]`\n\n      if (typeof val === 'object' && val !== null && !Array.isArray(val)) {\n        // Recursively flatten nested objects\n        flatten(val as Record<string, unknown>, fullKey)\n      } else {\n        // Add primitive values\n        result.push({ key: fullKey, value: String(val) })\n      }\n    }\n  }\n\n  if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n    flatten(value as Record<string, unknown>, paramName)\n  }\n\n  return result\n}\n"],"mappings":"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"}

package/dist/v2/blocks/operation-block/helpers/validate-path-parameters.js

@@ -0,0 +1,34 @@
+import { getExample } from "./get-example.js";
+import { isParamDisabled } from "../../request-block/helpers/is-param-disabled.js";
+import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
+//#region src/v2/blocks/operation-block/helpers/validate-path-parameters.ts
+/** Treats undefined, null, and blank/whitespace strings as empty. */
+var isEmptyParamValue = (value) => {
+	if (value === void 0 || value === null) return true;
+	if (typeof value === "string") return value.trim() === "";
+	return false;
+};
+/**
+* Validates that all required path parameters have non-empty values.
+*
+* Path parameters are always required per the OpenAPI specification.
+* Returns the names of any path parameters that are missing values.
+*/
+var validatePathParameters = (parameters = [], exampleKey = "default") => {
+	const invalidParams = [];
+	for (const referencedParam of parameters) {
+		const param = getResolvedRef(referencedParam);
+		if (param.in !== "path") continue;
+		const example = getExample(param, exampleKey, void 0);
+		if (isParamDisabled(param, example)) continue;
+		if (isEmptyParamValue(example?.value)) invalidParams.push(param.name);
+	}
+	return invalidParams.length > 0 ? {
+		ok: false,
+		invalidParams
+	} : { ok: true };
+};
+//#endregion
+export { validatePathParameters };
+
+//# sourceMappingURL=validate-path-parameters.js.map

package/dist/v2/blocks/operation-block/helpers/validate-path-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-path-parameters.js","names":[],"sources":["../../../../../src/v2/blocks/operation-block/helpers/validate-path-parameters.ts"],"sourcesContent":["import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type { ParameterObject, ReferenceType } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\nimport { isParamDisabled } from '@/v2/blocks/request-block/helpers/is-param-disabled'\n\nimport { getExample } from './get-example'\n\ntype ValidatePathParametersResult = { ok: true } | { ok: false; invalidParams: string[] }\n\n/** Treats undefined, null, and blank/whitespace strings as empty. */\nconst isEmptyParamValue = (value: unknown): boolean => {\n  if (value === undefined || value === null) {\n    return true\n  }\n  if (typeof value === 'string') {\n    return value.trim() === ''\n  }\n  return false\n}\n\n/**\n * Validates that all required path parameters have non-empty values.\n *\n * Path parameters are always required per the OpenAPI specification.\n * Returns the names of any path parameters that are missing values.\n */\nexport const validatePathParameters = (\n  parameters: ReferenceType<ParameterObject>[] = [],\n  exampleKey: string = 'default',\n): ValidatePathParametersResult => {\n  const invalidParams: string[] = []\n\n  for (const referencedParam of parameters) {\n    const param = getResolvedRef(referencedParam)\n    if (param.in !== 'path') {\n      continue\n    }\n\n    const example = getExample(param, exampleKey, undefined)\n    if (isParamDisabled(param, example)) {\n      continue\n    }\n\n    if (isEmptyParamValue(example?.value)) {\n      invalidParams.push(param.name)\n    }\n  }\n\n  return invalidParams.length > 0 ? { ok: false, invalidParams } : { ok: true }\n}\n"],"mappings":";;;;;AAUA,IAAM,qBAAqB,UAA4B;AACrD,KAAI,UAAU,KAAA,KAAa,UAAU,KACnC,QAAO;AAET,KAAI,OAAO,UAAU,SACnB,QAAO,MAAM,MAAM,KAAK;AAE1B,QAAO;;;;;;;;AAST,IAAa,0BACX,aAA+C,EAAE,EACjD,aAAqB,cACY;CACjC,MAAM,gBAA0B,EAAE;AAElC,MAAK,MAAM,mBAAmB,YAAY;EACxC,MAAM,QAAQ,eAAe,gBAAgB;AAC7C,MAAI,MAAM,OAAO,OACf;EAGF,MAAM,UAAU,WAAW,OAAO,YAAY,KAAA,EAAU;AACxD,MAAI,gBAAgB,OAAO,QAAQ,CACjC;AAGF,MAAI,kBAAkB,SAAS,MAAM,CACnC,eAAc,KAAK,MAAM,KAAK;;AAIlC,QAAO,cAAc,SAAS,IAAI;EAAE,IAAI;EAAO;EAAe,GAAG,EAAE,IAAI,MAAM"}

package/dist/v2/blocks/operation-block/index.d.ts

@@ -1,5 +1,5 @@
-export { buildRequestSecurity, getSecuritySchemes } from './helpers/build-request-security';
-export { getExample } from './helpers/get-example';
-export { getResolvedUrl } from './helpers/get-resolved-url';
-export { default as OperationBlock } from './OperationBlock.vue';
+export { buildRequestSecurity, getSecuritySchemes } from './helpers/build-request-security.js';
+export { getExample } from './helpers/get-example.js';
+export { getResolvedUrl } from './helpers/get-resolved-url.js';
+export { default as OperationBlock } from './OperationBlock.vue.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/v2/blocks/operation-block/index.js

@@ -1,20 +1,5 @@
-import "../../../HttpMethod-rnWEgC3T.js";
-import "../../../CodeInput-BN7uw3Bh.js";
-import "../../../Server-BS4zjUdO.js";
-import "../../../AddressBar-CX8xiYoe.js";
-import "../../../components-ChixwQhN.js";
-import "../../../Sidebar-Xl9_nFXX.js";
-import "../../../DataTableInput-SkIUPlrB.js";
-import { l as buildRequestSecurity, t as OperationBlock_default, u as getSecuritySchemes } from "../../../operation-block-DE-hoO03.js";
-import { T as getExample } from "../../../operation-code-sample-xgx4qi2H.js";
-import { t as getResolvedUrl } from "../../../get-resolved-url-SybDPV0U.js";
-import "../../../request-block-N7dPFyrG.js";
-import "../../../SectionFilter-hrtoRLwj.js";
-import "../../../code-input-iq-moLxi.js";
-import "../../../data-table-PL7e8NRO.js";
-import "../../../scalar-auth-selector-block-Bs79QOMA.js";
-import "../../../response-block-DmkaDZYs.js";
-import "../../../ScalarAsciiArt-BjuSnj8e.js";
-import "../../../scalar-address-bar-block-BbysOhkE.js";
-import "../../../server-tcI-OCyx.js";
+import { buildRequestSecurity, getSecuritySchemes } from "./helpers/build-request-security.js";
+import { getExample } from "./helpers/get-example.js";
+import { getResolvedUrl } from "./helpers/get-resolved-url.js";
+import OperationBlock_default from "./OperationBlock.vue.js";
 export { OperationBlock_default as OperationBlock, buildRequestSecurity, getExample, getResolvedUrl, getSecuritySchemes };

package/dist/v2/blocks/operation-code-sample/components/ExamplePicker.vue.js

@@ -0,0 +1,7 @@
+import ExamplePicker_vue_vue_type_script_setup_true_lang_default from "./ExamplePicker.vue.script.js";
+//#region src/v2/blocks/operation-code-sample/components/ExamplePicker.vue
+var ExamplePicker_default = ExamplePicker_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { ExamplePicker_default as default };
+
+//# sourceMappingURL=ExamplePicker.vue.js.map

package/dist/v2/blocks/operation-code-sample/components/ExamplePicker.vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExamplePicker.vue.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/components/ExamplePicker.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport {\n  ScalarButton,\n  ScalarListbox,\n  type ScalarListboxOption,\n} from '@scalar/components'\nimport { ScalarIconCaretDown } from '@scalar/icons'\nimport type { MediaTypeObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { computed } from 'vue'\n\nconst { examples = {} } = defineProps<{\n  examples?: MediaTypeObject['examples'] | Record<string, string>\n}>()\n\nconst selectedExampleKey = defineModel<string>({\n  required: true,\n})\n\ndefineOptions({ inheritAttrs: false })\n\nconst exampleOptions = computed<ScalarListboxOption[]>(() =>\n  Object.entries(examples).map(([key, example]) => ({\n    id: key,\n    label: example?.summary ?? key,\n  })),\n)\n\nconst selectedExample = computed<ScalarListboxOption | undefined>({\n  get: () =>\n    exampleOptions.value.find(({ id }) => id === selectedExampleKey.value),\n  set: (v) => (selectedExampleKey.value = v?.id ?? ''),\n})\n</script>\n\n<template>\n  <ScalarListbox\n    v-model=\"selectedExample\"\n    class=\"w-fit min-w-32\"\n    :options=\"exampleOptions\"\n    placement=\"bottom-start\"\n    teleport>\n    <ScalarButton\n      class=\"text-c-2 hover:text-c-1 flex h-full w-fit min-w-0 gap-1.5 px-1.5 py-0.75 text-base font-normal\"\n      data-testid=\"example-picker\"\n      variant=\"ghost\"\n      v-bind=\"$attrs\">\n      <div class=\"min-w-0 flex-1 truncate\">\n        {{ selectedExample?.label ?? 'Select an example' }}\n      </div>\n      <ScalarIconCaretDown\n        class=\"ui-open:rotate-180 mt-0.25 size-3 transition-transform duration-100\"\n        weight=\"bold\" />\n    </ScalarButton>\n  </ScalarListbox>\n</template>\n"],"mappings":""}

package/dist/v2/blocks/operation-code-sample/components/ExamplePicker.vue.script.js

@@ -0,0 +1,52 @@
+import { computed, createBlock, createElementVNode, createVNode, defineComponent, mergeModels, mergeProps, openBlock, toDisplayString, unref, useModel, withCtx } from "vue";
+import { ScalarButton, ScalarListbox } from "@scalar/components";
+import { ScalarIconCaretDown } from "@scalar/icons";
+//#region src/v2/blocks/operation-code-sample/components/ExamplePicker.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "min-w-0 flex-1 truncate" };
+var ExamplePicker_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	inheritAttrs: false,
+	__name: "ExamplePicker",
+	props: /* @__PURE__ */ mergeModels({ examples: { default: () => ({}) } }, {
+		"modelValue": { required: true },
+		"modelModifiers": {}
+	}),
+	emits: ["update:modelValue"],
+	setup(__props) {
+		const selectedExampleKey = useModel(__props, "modelValue");
+		const exampleOptions = computed(() => Object.entries(__props.examples).map(([key, example]) => ({
+			id: key,
+			label: example?.summary ?? key
+		})));
+		const selectedExample = computed({
+			get: () => exampleOptions.value.find(({ id }) => id === selectedExampleKey.value),
+			set: (v) => selectedExampleKey.value = v?.id ?? ""
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(ScalarListbox), {
+				modelValue: selectedExample.value,
+				"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => selectedExample.value = $event),
+				class: "w-fit min-w-32",
+				options: exampleOptions.value,
+				placement: "bottom-start",
+				teleport: ""
+			}, {
+				default: withCtx(() => [createVNode(unref(ScalarButton), mergeProps({
+					class: "text-c-2 hover:text-c-1 flex h-full w-fit min-w-0 gap-1.5 px-1.5 py-0.75 text-base font-normal",
+					"data-testid": "example-picker",
+					variant: "ghost"
+				}, _ctx.$attrs), {
+					default: withCtx(() => [createElementVNode("div", _hoisted_1, toDisplayString(selectedExample.value?.label ?? "Select an example"), 1), createVNode(unref(ScalarIconCaretDown), {
+						class: "ui-open:rotate-180 mt-0.25 size-3 transition-transform duration-100",
+						weight: "bold"
+					})]),
+					_: 1
+				}, 16)]),
+				_: 1
+			}, 8, ["modelValue", "options"]);
+		};
+	}
+});
+//#endregion
+export { ExamplePicker_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=ExamplePicker.vue.script.js.map

package/dist/v2/blocks/operation-code-sample/components/ExamplePicker.vue.script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExamplePicker.vue.script.js","names":["$attrs"],"sources":["../../../../../src/v2/blocks/operation-code-sample/components/ExamplePicker.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport {\n  ScalarButton,\n  ScalarListbox,\n  type ScalarListboxOption,\n} from '@scalar/components'\nimport { ScalarIconCaretDown } from '@scalar/icons'\nimport type { MediaTypeObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { computed } from 'vue'\n\nconst { examples = {} } = defineProps<{\n  examples?: MediaTypeObject['examples'] | Record<string, string>\n}>()\n\nconst selectedExampleKey = defineModel<string>({\n  required: true,\n})\n\ndefineOptions({ inheritAttrs: false })\n\nconst exampleOptions = computed<ScalarListboxOption[]>(() =>\n  Object.entries(examples).map(([key, example]) => ({\n    id: key,\n    label: example?.summary ?? key,\n  })),\n)\n\nconst selectedExample = computed<ScalarListboxOption | undefined>({\n  get: () =>\n    exampleOptions.value.find(({ id }) => id === selectedExampleKey.value),\n  set: (v) => (selectedExampleKey.value = v?.id ?? ''),\n})\n</script>\n\n<template>\n  <ScalarListbox\n    v-model=\"selectedExample\"\n    class=\"w-fit min-w-32\"\n    :options=\"exampleOptions\"\n    placement=\"bottom-start\"\n    teleport>\n    <ScalarButton\n      class=\"text-c-2 hover:text-c-1 flex h-full w-fit min-w-0 gap-1.5 px-1.5 py-0.75 text-base font-normal\"\n      data-testid=\"example-picker\"\n      variant=\"ghost\"\n      v-bind=\"$attrs\">\n      <div class=\"min-w-0 flex-1 truncate\">\n        {{ selectedExample?.label ?? 'Select an example' }}\n      </div>\n      <ScalarIconCaretDown\n        class=\"ui-open:rotate-180 mt-0.25 size-3 transition-transform duration-100\"\n        weight=\"bold\" />\n    </ScalarButton>\n  </ScalarListbox>\n</template>\n"],"mappings":";;;;;;;;;;;;;;EAcA,MAAM,qBAAqB,SAAmB,SAAA,aAE7C;EAID,MAAM,iBAAiB,eACrB,OAAO,QAAQ,QAAA,SAAS,CAAC,KAAK,CAAC,KAAK,cAAc;GAChD,IAAI;GACJ,OAAO,SAAS,WAAW;GAC5B,EAAE,CACL;EAEA,MAAM,kBAAkB,SAA0C;GAChE,WACE,eAAe,MAAM,MAAM,EAAE,SAAS,OAAO,mBAAmB,MAAM;GACxE,MAAM,MAAO,mBAAmB,QAAQ,GAAG,MAAM;GAClD,CAAA;;uBAIC,YAkBgB,MAAA,cAAA,EAAA;gBAjBL,gBAAA;iFAAe,QAAA;IACxB,OAAM;IACL,SAAS,eAAA;IACV,WAAU;IACV,UAAA;;2BAYe,CAXf,YAWe,MAAA,aAAA,EAXf,WAWe;KAVb,OAAM;KACN,eAAY;KACZ,SAAQ;OACAA,KAAAA,OAAM,EAAA;4BAGR,CAFN,mBAEM,OAFN,YAEM,gBADD,gBAAA,OAAiB,SAAK,oBAAA,EAAA,EAAA,EAE3B,YAEkB,MAAA,oBAAA,EAAA;MADhB,OAAM;MACN,QAAO"}

package/dist/v2/blocks/operation-code-sample/components/HttpMethod.vue.js

@@ -0,0 +1,7 @@
+import HttpMethod_vue_vue_type_script_setup_true_lang_default from "./HttpMethod.vue.script.js";
+//#region src/v2/blocks/operation-code-sample/components/HttpMethod.vue
+var HttpMethod_default = HttpMethod_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { HttpMethod_default as default };
+
+//# sourceMappingURL=HttpMethod.vue.js.map

package/dist/v2/blocks/operation-code-sample/components/HttpMethod.vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpMethod.vue.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/components/HttpMethod.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { getHttpMethodInfo } from '@scalar/helpers/http/http-info'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { normalizeHttpMethod } from '@scalar/helpers/http/normalize-http-method'\nimport { computed, type Component } from 'vue'\n\nconst props = defineProps<{\n  /** The type of element to render as, defaults to `span` */\n  as?: Component | string\n  /** The css style property or variable that will be set to the request method color, defaults to `color` */\n  property?: string\n  /** Whether or not to abbreviated the slot content */\n  short?: boolean\n  /** The HTTP method to show */\n  method: HttpMethod | string\n}>()\n\n/** Grabs the method info object which contains abbreviation, color, and background color etc */\nconst httpMethodInfo = computed(() =>\n  getHttpMethodInfo(String(props.method || '')),\n)\n\n/** Full method name */\nconst normalized = computed(() => normalizeHttpMethod(props.method))\n</script>\n\n<template>\n  <component\n    :is=\"as ?? 'span'\"\n    class=\"uppercase\"\n    :style=\"{ [property || 'color']: httpMethodInfo.colorVar }\">\n    <slot />\n    {{ short ? httpMethodInfo.short : normalized }}\n  </component>\n</template>\n"],"mappings":""}

package/dist/v2/blocks/operation-code-sample/components/HttpMethod.vue.script.js

@@ -0,0 +1,33 @@
+import { computed, createBlock, createTextVNode, defineComponent, normalizeStyle, openBlock, renderSlot, resolveDynamicComponent, toDisplayString, withCtx } from "vue";
+import { getHttpMethodInfo } from "@scalar/helpers/http/http-info";
+import { normalizeHttpMethod } from "@scalar/helpers/http/normalize-http-method";
+//#region src/v2/blocks/operation-code-sample/components/HttpMethod.vue?vue&type=script&setup=true&lang.ts
+var HttpMethod_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	__name: "HttpMethod",
+	props: {
+		as: {},
+		property: {},
+		short: { type: Boolean },
+		method: {}
+	},
+	setup(__props) {
+		const props = __props;
+		/** Grabs the method info object which contains abbreviation, color, and background color etc */
+		const httpMethodInfo = computed(() => getHttpMethodInfo(String(props.method || "")));
+		/** Full method name */
+		const normalized = computed(() => normalizeHttpMethod(props.method));
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(resolveDynamicComponent(__props.as ?? "span"), {
+				class: "uppercase",
+				style: normalizeStyle({ [__props.property || "color"]: httpMethodInfo.value.colorVar })
+			}, {
+				default: withCtx(() => [renderSlot(_ctx.$slots, "default"), createTextVNode(" " + toDisplayString(__props.short ? httpMethodInfo.value.short : normalized.value), 1)]),
+				_: 3
+			}, 8, ["style"]);
+		};
+	}
+});
+//#endregion
+export { HttpMethod_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=HttpMethod.vue.script.js.map

package/dist/v2/blocks/operation-code-sample/components/HttpMethod.vue.script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpMethod.vue.script.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/components/HttpMethod.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { getHttpMethodInfo } from '@scalar/helpers/http/http-info'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { normalizeHttpMethod } from '@scalar/helpers/http/normalize-http-method'\nimport { computed, type Component } from 'vue'\n\nconst props = defineProps<{\n  /** The type of element to render as, defaults to `span` */\n  as?: Component | string\n  /** The css style property or variable that will be set to the request method color, defaults to `color` */\n  property?: string\n  /** Whether or not to abbreviated the slot content */\n  short?: boolean\n  /** The HTTP method to show */\n  method: HttpMethod | string\n}>()\n\n/** Grabs the method info object which contains abbreviation, color, and background color etc */\nconst httpMethodInfo = computed(() =>\n  getHttpMethodInfo(String(props.method || '')),\n)\n\n/** Full method name */\nconst normalized = computed(() => normalizeHttpMethod(props.method))\n</script>\n\n<template>\n  <component\n    :is=\"as ?? 'span'\"\n    class=\"uppercase\"\n    :style=\"{ [property || 'color']: httpMethodInfo.colorVar }\">\n    <slot />\n    {{ short ? httpMethodInfo.short : normalized }}\n  </component>\n</template>\n"],"mappings":";;;;;;;;;;;;;EAMA,MAAM,QAAQ;;EAYd,MAAM,iBAAiB,eACrB,kBAAkB,OAAO,MAAM,UAAU,GAAG,CAAC,CAC/C;;EAGA,MAAM,aAAa,eAAe,oBAAoB,MAAM,OAAO,CAAA;;uBAIjE,YAMY,wBALL,QAAA,MAAE,OAAA,EAAA;IACP,OAAM;IACL,OAAK,eAAA,GAAK,QAAA,YAAQ,UAAc,eAAA,MAAe,UAAQ,CAAA;;2BAChD,CAAR,WAAQ,KAAA,QAAA,UAAA,EAAA,gBAAA,MACR,gBAAG,QAAA,QAAQ,eAAA,MAAe,QAAQ,WAAA,MAAU,EAAA,EAAA,CAAA,CAAA"}

package/dist/v2/blocks/operation-code-sample/components/OperationCodeSample.vue.d.ts

@@ -3,8 +3,8 @@ import { type AvailableClients } from '@scalar/snippetz';
 import { type WorkspaceEventBus } from '@scalar/workspace-store/events';
 import type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies';
 import type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
-import type { ClientOptionGroup } from '@/v2/blocks/operation-code-sample/types';
-import type { SecuritySchemeObjectSecret } from '@/v2/blocks/scalar-auth-selector-block/helpers/secret-types';
+import type { ClientOptionGroup } from '../../../../v2/blocks/operation-code-sample/types';
+import type { SecuritySchemeObjectSecret } from '../../../../v2/blocks/scalar-auth-selector-block/helpers/secret-types';
 export type OperationCodeSampleProps = {
     /**
      * Integration type: determines if the code sample is displayed in a client environment

package/dist/v2/blocks/operation-code-sample/components/OperationCodeSample.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OperationCodeSample.vue.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/components/OperationCodeSample.vue"],"names":[],"mappings":"AAydA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAErF,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACb,MAAM,8DAA8D,CAAA;AAgBrE,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAA;AAM7G,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;IACpC;;OAEG;IACH,aAAa,EAAE,iBAAiB,EAAE,CAAA;IAClC;;;;OAIG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzC;;OAEG;IACH,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAA;IAC3B;;OAEG;IACH,eAAe,EAAE,0BAA0B,EAAE,CAAA;IAC7C;;OAEG;IACH,MAAM,EAAE,cAAc,CAAA;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,SAAS,EAAE,eAAe,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAA;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;CAChC,CAAA;AAED;;;;;;;;GAQG;wBACkB,OAAO,YAAY;AAAxC,wBAAyC;AAGzC,QAAA,MAAM,YAAY;IA2KlB,8DAA8D;sBAC1C,MAAM;;;;IAD1B,8DAA8D;sBAC1C,MAAM;;;;YAxJhB,MAAM,OAAO;YACb,CAAC,EAAE,WAAW,EAAE,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO;EAygB3D,CAAC;AACL,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"OperationCodeSample.vue.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/components/OperationCodeSample.vue"],"names":[],"mappings":"AA2dA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAErF,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACb,MAAM,8DAA8D,CAAA;AAiBrE,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAA;AAM7G,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;IACpC;;OAEG;IACH,aAAa,EAAE,iBAAiB,EAAE,CAAA;IAClC;;;;OAIG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzC;;OAEG;IACH,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAA;IAC3B;;OAEG;IACH,eAAe,EAAE,0BAA0B,EAAE,CAAA;IAC7C;;OAEG;IACH,MAAM,EAAE,cAAc,CAAA;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,SAAS,EAAE,eAAe,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAA;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;CAChC,CAAA;AAED;;;;;;;;GAQG;wBACkB,OAAO,YAAY;AAAxC,wBAAyC;AAGzC,QAAA,MAAM,YAAY;IA2KlB,8DAA8D;sBAC1C,MAAM;;;;IAD1B,8DAA8D;sBAC1C,MAAM;;;;YAxJhB,MAAM,OAAO;YACb,CAAC,EAAE,WAAW,EAAE,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO;EA4gB3D,CAAC;AACL,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/v2/blocks/operation-code-sample/components/OperationCodeSample.vue.js

@@ -0,0 +1,9 @@
+import _plugin_vue_export_helper_default from "../../../../_virtual/_plugin-vue_export-helper.js";
+import OperationCodeSample_vue_vue_type_script_setup_true_lang_default from "./OperationCodeSample.vue.script.js";
+/* empty css                                  */
+//#region src/v2/blocks/operation-code-sample/components/OperationCodeSample.vue
+var OperationCodeSample_default = /* @__PURE__ */ _plugin_vue_export_helper_default(OperationCodeSample_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-4f489717"]]);
+//#endregion
+export { OperationCodeSample_default as default };
+
+//# sourceMappingURL=OperationCodeSample.vue.js.map