fumadocs-openapi 11.3.2 → 11.3.4

package/css/generated/shared.css

@@ -1 +1 @@
-@source inline("--- --fd-docs-row-1 -mode -ms-2 @4xl:flex-row @4xl:items-start @4xl:sticky @4xl:top-[calc(var(--fd-docs-row-1,2rem)+1rem)] @4xl:w-[400px] @container @default @defaultValue @deprecated @fuma-translate/react @fumari/json-schema-ts @fumari/stf @param @private @scalar/api-client-react @see @typescript-eslint/no-explicit-any a access access_token active adapter adapters addListener against all allFlows allow already alt an anchorSegments and animate-spin apiExample apiKey apiPlayground application/javascript application/json application/x-javascript application/x-www-form-urlencoded application/xml apply are array as assume async at auth-specific authCodeQuery authCtx authNode authSchemes authorization authorizationCode authorization_code authorize autoComplete avoid await backward badgeVariants base baseDir basic be because before between bg-fd-card bg-fd-muted bg-fd-primary/10 bg-fd-secondary binary blob blue body bodyMediaType bodyNode boolean border border-b border-current border-s border-t border-y break-all buffer built-in bundled but button buttonVariants by byteLength bytes cache cached cachedDocFiles call callback callbacks callbacksNode can cannot case catch changes charset check children class-variance-authority className client clientCredentials clientId clientSecret client_credentials client_error client_id client_secret cloned cn code codeProps codeUsages codeblock codegen codegens collapsible color com compatibility compiler component components conditions configuration const content contentType contentTypes context cookie cookies core could createClientAPIPage createCodeUsageGeneratorRegistry createContext createOpenAPIPageBase createProxy credentials css csv ctx current currentValue custom customization cva dark dark:text-blue-400 dark:text-green-400 dark:text-orange-400 dark:text-red-400 dark:text-yellow-400 data data-[open]:border-b-0 data-type default defaultAdapters defaultExampleId defaultItem defaultMdxComponents defaultOpen defaultShikiFactory defaultValue defaultValues default_processMarkdown definitions deprecated depth dereferenceBundledDocument dereferenceShallow dereferenced description descriptionNode development deviceAuthorization dialog didn disable disableCache disabled display displayNames div do doc docCache docFilesCache docRoot docs document documents domain downloaded dynamicSource e each else empty:hidden enabled encodeRequestData encoded endpoint enforce engine ensure entire entries entry error eslint-disable eslint-disable-next-line example exampleId exampleRequests examples export exported extends fallback false fast-content-type-parse fd-page-tree-item-name fetch fetcher field fieldName fields file filePath files fine first first:border-t-0 flex flex-1 flex-col flex-col-reverse flex-row flex-wrap flow flows folder folderStyle font-medium font-mono font-normal font-semibold for form formData format found from fs full fumadocs-core/source fumadocs-core/toc fumadocs-openapi/ui fumadocs-ui/mdx fumadocs:openapi fumadocs_openapi_requests fumadocs_openapi_responses function gap-0.5 gap-1 gap-1.5 gap-2 gap-2.5 gap-24 gap-3 gap-4 gap-6 gap-x-4 gap-x-6 gap-y-1 gap-y-4 gen generate generateTypeScriptDefinitions generated generated/defined generators get getAPIPageProps getClientAPIPageProps getExampleRequests getOpenAPIPageProps getPreferredType getRaw getSchema getSchemas getWatchPaths github-dark github-light given grant_type green grid grid-cols-[auto_1fr] group group-data-[panel-open]:rotate-180 groupId h1 handling hasHead hash hast-util-to-jsx-runtime headNode header headers headingLevel highlighter hook hover:bg-fd-accent hover:text-fd-accent-foreground href html htmlFor http icon id idToTitle idx if ignore img implicit import imports in in-document info initAuthInputs initial inline-flex input inputs instanceof instances instead insteawd interface internal into is isLoading isMediaTypeSupported isRequired issues it item items items-center items-start js json json-schema-typed justify-between kept key keyof label labelVariants lang last:border-b-0 last:mb-0 latest layout lazy length let light line-through list list-disc list-inside listed listener listeners load loadDocument loaderPlugin localStorage lucide-react make map max-age may mb-1 mb-2 md mdxComponents me-auto media mediaAdapters mediaType message meta metaData method methodKeys mime min-w-0 modify mounted ms-auto mt-0! mt-10 mt-2 mt-3 multipart/form-data multiple must my-0! my-1.5 my-4 name name! named necessary need never new newKey no-cache node:fs node:path not not-last:pb-0 not-prose note null number oauth2 obj object of off omit on onChange onClick onCopy onOpenChange onSubmit onValueChange one only open openApiData openIdConnect openapi openapiMeta openid operation operationDescription operationId operations options or orange origin other out outline output overflow-auto overflow-hidden p p-1 p-2 p-3 packages page page-level pageData pages panelVariants param paramTypeKeys parameter parameterLabel parameterNode parameters params parent parsed parsedState parts party pass password path pathItem pathnameFromRequest payload pb-2 pe-3 persist persisted persistent place placeholder playground playgrounds please plugins pre prefix preloadOpenAPIPage preloaded prevent primary processed processor prop properties props prose-no-margin provider proxy proxyForwardCookie proxyUrl ps-2 ps-4.5 pt-1 pt-2 pt-2.5 px-1 px-2 px-3 py-0.5 py-1 py-1.5 py-2 query race raw react react-hooks/exhaustive-deps react/jsx-runtime readOnly readonly record red redirect_uri reference refs registerDefault registry rehype-react relativePath remark remark-rehype remarkGfm remarkRehype removeListener render renderAPIExampleLayout renderAPIExampleUsageTabs renderOperationLayout renderPageLayout renderParameterField renderRequestTabs renderRequestTabsDefault renderResponseTabs renderResponseTabsDefault renderWebhookLayout renderer replace request request-body requestData requestInit requestTimeout requestUrl requests required requirement requirementId requirements res reset resolvable resolve resolveMediaAdapter resolveServerUrl resolvedInput resolvedTheme resolves response response-body responseNode responseOfType responseTabs response_type responses rest result return returned returning root rounded-2xl rounded-lg rounded-md rounded-xl route s safeParse same sample satisfies scalar scan schema schemaId schemaUI schemaUIShared scheme schemeId schemes scope scopes search secondary seconds secret securities security securityEntries securityId securitySchemes segments segs select selector separator server server-to-server server-url serverSchema servers services set setData setExample setExampleData setIsJson setIsMounted setMounted setObjectUrl setOpen setRequirementId setSecurityId setServer setServerVariables setStore setToken setType setValue shadow-md shadow-sm shiki shikiOptions showDescription showExample showResponseSchema showTitle shrink-0 side signal single size size-3.5 size-4 slot slots sm so source spec specify spread src state staticSource status statusInfo statuses stf stfSync still storageKey storageKeys store stored string stringifyFieldKey structuredData styles submit summary supported sure switch t tab tabs testQuery text text-[0.8125rem] text-blue-600 text-fd-card-foreground text-fd-foreground text-fd-muted-foreground text-fd-primary text-fd-secondary-foreground text-green-500 text-green-600 text-nowrap text-orange-600 text-red-400 text-red-500 text-red-600 text-sm text-start text-xs text-yellow-600 text/css text/csv text/html text/plain the their them themes this throw timeout timerRef tips title to toJsxRuntime toStaticData toc token tokenInfo token_type transform transformAuthInputs transformPageTree transition-colors tree true truncate try ts type typeof types typescript unchanged under unexpected unknown unlisted update updated updatedSchemeId updating url usage usageTabs usages use useAnchorId useApiClient useAuth useCopyButton useMemo useOnChange useOperationContext useQuery useRef useRenderContext useServerContext useState useStatusInfo useStf useStorageKey useTheme useTranslations used username using utf-8 v value values variable variables variant variants via virtual void w-14 w-fit w-full warn we webhook webhookCallbacks webhooks when whitespace-pre-wrap will with without won wrapping writeOnly x-codeSamples x-exclusiveCodeSample x-selectedCodeSample xml yellow you your");
+@source inline("--- --fd-docs-row-1 -mode -ms-2 @4xl:flex-row @4xl:items-start @4xl:sticky @4xl:top-[calc(var(--fd-docs-row-1,2rem)+1rem)] @4xl:w-[400px] @container @default @defaultValue @deprecated @fuma-translate/react @fumari/json-schema-ts @fumari/stf @param @private @scalar/api-client-react @see @typescript-eslint/no-explicit-any a access access_token active adapter adapters addListener against all allFlows allow already alt an anchorSegments and animate-spin apiExample apiKey apiPlayground application/javascript application/json application/x-javascript application/x-www-form-urlencoded application/xml apply are array as assume async at auth-specific authCodeQuery authCtx authNode authSchemes authorization authorizationCode authorization_code authorize autoComplete avoid await backward badgeVariants base baseDir basic be because before between bg-fd-card bg-fd-muted bg-fd-primary/10 bg-fd-secondary binary blob blue body bodyMediaType bodyNode boolean border border-b border-current border-s border-t border-y break-all buffer built-in bundled but button buttonVariants by byteLength bytes cache cached cachedDocFiles call callback callbacks callbacksNode can cannot case catch changes charset check children class-variance-authority className client clientAuth clientAuthMethods clientCredentials clientId clientSecret client_auth client_credentials client_error client_id client_secret cloned cn code codeProps codeUsages codeblock codegen codegens collapsible color com compatibility compiler component components conditions configuration const content contentType contentTypes context cookie cookies core could createClientAPIPage createCodeUsageGeneratorRegistry createContext createOpenAPIPageBase createProxy credentials css csv ctx current currentValue custom customization cva dark dark:text-blue-400 dark:text-green-400 dark:text-orange-400 dark:text-red-400 dark:text-yellow-400 data data-[open]:border-b-0 data-type default defaultAdapters defaultExampleId defaultItem defaultMdxComponents defaultOpen defaultShikiFactory defaultValue defaultValues default_processMarkdown definitions deprecated depth dereferenceBundledDocument dereferenceShallow dereferenced description descriptionNode development deviceAuthorization dialog didn disable disableCache disabled display displayNames div do doc docCache docFilesCache docRoot docs document documents domain downloaded dynamicSource e each else empty:hidden enabled encodeRequestData encoded endpoint enforce engine ensure entire entries entry error eslint-disable eslint-disable-next-line example exampleId exampleRequests examples export exported extends fallback false fast-content-type-parse fd-page-tree-item-name fetch fetcher field fieldName fields file filePath files fine first first:border-t-0 flex flex-1 flex-col flex-col-reverse flex-row flex-wrap flow flows folder folderStyle font-medium font-mono font-normal font-semibold for form formData format found from fs full fumadocs-core/source fumadocs-core/toc fumadocs-openapi/ui fumadocs-ui/mdx fumadocs:openapi fumadocs_openapi_requests fumadocs_openapi_responses function gap-0.5 gap-1 gap-1.5 gap-2 gap-2.5 gap-24 gap-3 gap-4 gap-6 gap-x-4 gap-x-6 gap-y-1 gap-y-4 gen generate generateTypeScriptDefinitions generated generated/defined generators get getAPIPageProps getClientAPIPageProps getExampleRequests getOpenAPIPageProps getPreferredType getRaw getSchema getSchemas getWatchPaths github-dark github-light given grant_type green grid grid-cols-[auto_1fr] group group-data-[panel-open]:rotate-180 groupId h1 handling hasHead hash hast-util-to-jsx-runtime headNode header headers headingLevel highlighter hook hover:bg-fd-accent hover:text-fd-accent-foreground href html htmlFor http icon id idToTitle idx if ignore img implicit import imports in in-document info initAuthInputs initial inline-flex input inputs instanceof instances instead insteawd interface internal into is isLoading isMediaTypeSupported isRequired issues it item items items-center items-start js json json-schema-typed justify-between kept key keyof label labelVariants lang last:border-b-0 last:mb-0 latest layout lazy length let light line-through list list-disc list-inside listed listener listeners load loadDocument loaderPlugin localStorage lucide-react make map max-age may mb-1 mb-2 md mdxComponents me-auto media mediaAdapters mediaType message meta metaData method methodKeys mime min-w-0 modify mounted ms-auto mt-0! mt-10 mt-2 mt-3 multipart/form-data multiple must my-0! my-1.5 my-4 name name! named necessary need never new newKey no-cache node:fs node:path not not-last:pb-0 not-prose note null number oauth2 obj object of off omit on onChange onClick onCopy onOpenChange onSubmit onValueChange one only open openApiData openIdConnect openapi openapiMeta openid operation operationDescription operationId operations options or orange origin other out outline output overflow-auto overflow-hidden p p-1 p-2 p-3 packages page page-level pageData pages panelVariants param paramTypeKeys parameter parameterLabel parameterNode parameters params parent parsed parsedState parts party pass password path pathItem pathnameFromRequest payload pb-2 pe-3 persist persisted persistent place placeholder playground playgrounds please plugins pre prefix preloadOpenAPIPage preloaded prevent primary processed processor prop properties props prose-no-margin provider proxy proxyForwardCookie proxyUrl ps-2 ps-4.5 pt-1 pt-2 pt-2.5 px-1 px-2 px-3 py-0.5 py-1 py-1.5 py-2 query race raw react react-hooks/exhaustive-deps react/jsx-runtime readOnly readonly record red redirect_uri reference refs registerDefault registry rehype-react relativePath remark remark-rehype remarkGfm remarkRehype removeListener render renderAPIExampleLayout renderAPIExampleUsageTabs renderOperationLayout renderPageLayout renderParameterField renderRequestTabs renderRequestTabsDefault renderResponseTabs renderResponseTabsDefault renderWebhookLayout renderer replace request request-body requestData requestInit requestTimeout requestUrl requests required requirement requirementId requirements res reset resolvable resolve resolveMediaAdapter resolveServerUrl resolvedInput resolvedTheme resolves response response-body responseNode responseOfType responseTabs response_type responses rest result return returned returning root rounded-2xl rounded-lg rounded-md rounded-xl route s safeParse same sample satisfies scalar scan schema schemaId schemaUI schemaUIShared scheme schemeId schemes scope scopes search secondary seconds secret securities security securityEntries securityId securitySchemes segments segs select selector separator server server-to-server server-url serverSchema servers services set setClientAuth setData setExample setExampleData setIsJson setIsMounted setMounted setObjectUrl setOpen setRequirementId setSecurityId setServer setServerVariables setStore setToken setType setValue shadow-md shadow-sm shiki shikiOptions showDescription showExample showResponseSchema showTitle shrink-0 side signal single size size-3.5 size-4 slot slots sm so source spec specify spread src state staticSource status statusInfo statuses stf stfSync still storageKey storageKeys store stored string stringifyFieldKey structuredData styles submit summary supported sure switch t tab tabs testQuery text text-[0.8125rem] text-blue-600 text-fd-card-foreground text-fd-foreground text-fd-muted-foreground text-fd-primary text-fd-secondary-foreground text-green-500 text-green-600 text-nowrap text-orange-600 text-red-400 text-red-500 text-red-600 text-sm text-start text-xs text-yellow-600 text/css text/csv text/html text/plain the their them themes this throw timeout timerRef tips title to toJsxRuntime toStaticData toc token tokenInfo token_type transform transformAuthInputs transformPageTree transition-colors tree true truncate try ts type typeof types typescript unchanged under unexpected unknown unlisted update updated updatedSchemeId updating url usage usageTabs usages use useAnchorId useApiClient useAuth useCopyButton useMemo useOnChange useOperationContext useQuery useRef useRenderContext useServerContext useState useStatusInfo useStf useStorageKey useTheme useTranslations used username using utf-8 v value values variable variables variant variants via virtual void w-14 w-fit w-full warn we webhook webhookCallbacks webhooks when whitespace-pre-wrap will with without won wrapping writeOnly x-codeSamples x-exclusiveCodeSample x-selectedCodeSample xml yellow you your");

package/dist/.translations/index.d.ts

@@ -16,6 +16,7 @@ type Translations = {
   "Binary response body, {length} bytes(playground result display)": string;
   "Body(playground)": string;
   "Callbacks(operation page)": string;
+  "Client Authentication(OAuth dialog)": string;
   "Client Credentials(OAuth dialog)": string;
   "Client Error(playground result display)": string;
   "Client ID(OAuth dialog)": string;
@@ -44,6 +45,7 @@ type Translations = {
   "Headers(playground result display)": string;
   "Implicit(OAuth dialog)": string;
   "In(security scheme)": string;
+  "Include the client ID and secret in the token request body.(OAuth dialog)": string;
   "Intended for the server-to-server authentication.(OAuth dialog)": string;
   "Internal Server Error(playground status info)": string;
   "Not Found(playground status info)": string;
@@ -62,6 +64,9 @@ type Translations = {
   "Retrieve the access token directly.(OAuth dialog)": string;
   "Scope(security scheme)": string;
   "Select a flow(OAuth dialog)": string;
+  "Send as Basic Auth header(OAuth dialog)": string;
+  "Send client credentials in body(OAuth dialog)": string;
+  "Send the client ID and secret in the Authorization header.(OAuth dialog)": string;
   "Send(playground)": string;
   "Server URL(playground server select)": string;
   "Submit(OAuth dialog)": string;

package/dist/.translations/keys.js

@@ -16,6 +16,7 @@ var keys_default = [
 	"Binary response body, {length} bytes(playground result display)",
 	"Body(playground)",
 	"Callbacks(operation page)",
+	"Client Authentication(OAuth dialog)",
 	"Client Credentials(OAuth dialog)",
 	"Client Error(playground result display)",
 	"Client ID(OAuth dialog)",
@@ -44,6 +45,7 @@ var keys_default = [
 	"Headers(playground result display)",
 	"Implicit(OAuth dialog)",
 	"In(security scheme)",
+	"Include the client ID and secret in the token request body.(OAuth dialog)",
 	"Intended for the server-to-server authentication.(OAuth dialog)",
 	"Internal Server Error(playground status info)",
 	"Not Found(playground status info)",
@@ -62,6 +64,9 @@ var keys_default = [
 	"Retrieve the access token directly.(OAuth dialog)",
 	"Scope(security scheme)",
 	"Select a flow(OAuth dialog)",
+	"Send as Basic Auth header(OAuth dialog)",
+	"Send client credentials in body(OAuth dialog)",
+	"Send the client ID and secret in the Authorization header.(OAuth dialog)",
 	"Send(playground)",
 	"Server URL(playground server select)",
 	"Submit(OAuth dialog)",

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.13 → @scalar_openapi-upgrader@0.2.15}/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js

@@ -1,5 +1,5 @@
 import { traverse } from "../helpers/traverse.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.15/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js
 const DEFAULT_MEDIA_TYPE = "application/json";
 /** Extracts and removes x-example and x-examples extensions from an object */
 function extractXExampleExtensions(obj) {
@@ -417,6 +417,19 @@ function getParameterSerializationStyle(parameter) {
 	if (parameter.in in serializationStyles && collectionFormat in serializationStyles[parameter.in]) return serializationStyles[parameter.in][collectionFormat];
 	return {};
 }
+/**
+* Translate the Swagger 2.0 `collectionFormat` of a formData array parameter into an OpenAPI 3.0
+* encoding entry. Form bodies serialize arrays with the same styles as query parameters, so the
+* query serialization mapping is reused. Returns undefined when there is nothing to preserve, for
+* example a non-array parameter, one without a `collectionFormat`, or `tsv` which has no OpenAPI
+* 3.0 equivalent.
+*/
+function getFormDataEncoding(parameter) {
+	if (parameter.type !== "array" || typeof parameter.collectionFormat !== "string") return;
+	const encoding = querySerialization[parameter.collectionFormat];
+	if (!encoding || Object.keys(encoding).length === 0) return;
+	return encoding;
+}
 function migrateBodyParameter(bodyParameter, consumes) {
 	const { xExample, xExamples } = extractXExampleExtensions(bodyParameter);
 	delete bodyParameter.name;
@@ -458,10 +471,14 @@ function migrateFormDataParameter(parameters, consumes = ["multipart/form-data"]
 		if (formContent?.schema && typeof formContent.schema === "object" && "properties" in formContent.schema) {
 			for (const param of parameters) if (param.name && formContent.schema.properties) {
 				formContent.schema.properties[param.name] = {
-					type: param.type,
-					description: param.description,
-					...param.format ? { format: param.format } : {}
+					...transformItemsObject(structuredClone(param)),
+					...param.description !== void 0 ? { description: param.description } : {}
 				};
+				const encoding = getFormDataEncoding(param);
+				if (encoding) {
+					formContent.encoding ??= {};
+					formContent.encoding[param.name] = encoding;
+				}
 				if (param.required && Array.isArray(formContent.schema.required)) formContent.schema.required.push(param.name);
 			}
 		}

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.13 → @scalar_openapi-upgrader@0.2.15}/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js

@@ -1,5 +1,5 @@
 import { traverse } from "../helpers/traverse.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.15/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js
 const SCHEMA_SEGMENTS = /* @__PURE__ */ new Set([
 	"properties",
 	"items",

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.13 → @scalar_openapi-upgrader@0.2.15}/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.15/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js
 /**
 * Recursively migrate XML object properties from 3.1 to 3.2 format
 */

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.13 → @scalar_openapi-upgrader@0.2.15}/node_modules/@scalar/openapi-upgrader/dist/helpers/traverse.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/helpers/traverse.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.15/node_modules/@scalar/openapi-upgrader/dist/helpers/traverse.js
 /**
 * Recursively traverses the content and applies the transform function to each node.
 */

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.13 → @scalar_openapi-upgrader@0.2.15}/node_modules/@scalar/openapi-upgrader/dist/upgrade.js

@@ -1,7 +1,7 @@
 import { upgradeFromThreeOneToThreeTwo } from "./3.1-to-3.2/upgrade-from-three-one-to-three-two.js";
 import { upgradeFromTwoToThree } from "./2.0-to-3.0/upgrade-from-two-to-three.js";
 import { upgradeFromThreeToThreeOne } from "./3.0-to-3.1/upgrade-from-three-to-three-one.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/upgrade.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.15/node_modules/@scalar/openapi-upgrader/dist/upgrade.js
 function upgrade(value, targetVersion) {
 	const openapi30 = upgradeFromTwoToThree(value);
 	if (targetVersion === "3.0") return openapi30;

package/dist/playground/components/oauth-dialog.js

@@ -24,7 +24,18 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 	const [type, setType] = useState(() => {
 		return Object.keys(scheme.flows)[0];
 	});
+	const [clientAuth, setClientAuth] = useState("body");
 	const t = useTranslations({ note: "OAuth dialog" });
+	const clientAuthMethods = {
+		body: {
+			name: t("Send client credentials in body"),
+			description: t("Include the client ID and secret in the token request body.")
+		},
+		header: {
+			name: t("Send as Basic Auth header"),
+			description: t("Send the client ID and secret in the Authorization header.")
+		}
+	};
 	const allFlows = useMemo(() => ({
 		password: {
 			name: t("Resource Owner Password Flow"),
@@ -101,11 +112,15 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 				password: values.password,
 				scope: scopes.join("+")
 			});
-			if (values.clientId) body.set("client_id", values.clientId);
-			if (values.clientSecret) body.set("client_secret", values.clientSecret);
+			const headers = { "Content-Type": "application/x-www-form-urlencoded" };
+			if (clientAuth === "header") headers.Authorization = `Basic ${btoa(`${values.clientId}:${values.clientSecret}`)}`;
+			else {
+				if (values.clientId) body.set("client_id", values.clientId);
+				if (values.clientSecret) body.set("client_secret", values.clientSecret);
+			}
 			res = await fetch(value.tokenUrl, {
 				method: "POST",
-				headers: { "Content-Type": "application/x-www-form-urlencoded" },
+				headers,
 				body
 			});
 		}
@@ -140,7 +155,19 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 		},
 		children: [
 			/* @__PURE__ */ jsxs(Select, {
-				items: Object.fromEntries(Object.keys(scheme.flows).map((key) => [key, allFlows[key].name])),
+				items: Object.keys(scheme.flows).map((key) => {
+					const { name, description } = allFlows[key];
+					return {
+						value: key,
+						label: /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("p", {
+							className: "font-medium",
+							children: name
+						}), /* @__PURE__ */ jsx("p", {
+							className: "text-fd-muted-foreground",
+							children: description
+						})] })
+					};
+				}),
 				value: type,
 				onValueChange: setType,
 				children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, { placeholder: t("Select a flow") }) }), /* @__PURE__ */ jsx(SelectContent, { children: Object.keys(scheme.flows).map((key) => {
@@ -177,7 +204,7 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 						autoComplete: "off",
 						disabled: isLoading,
 						defaultValue: defaultValues.clientId,
-						required: type !== "password"
+						required: type !== "password" || clientAuth === "header"
 					})
 				]
 			}),
@@ -201,43 +228,81 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 						autoComplete: "off",
 						disabled: isLoading,
 						defaultValue: defaultValues.clientSecret,
-						required: type !== "password"
+						required: type !== "password" || clientAuth === "header"
 					})
 				]
 			}),
-			type === "password" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("fieldset", {
-				className: "flex flex-col gap-1.5",
-				children: [/* @__PURE__ */ jsx("label", {
-					htmlFor: "username",
-					className: cn(labelVariants()),
-					children: t("Username")
-				}), /* @__PURE__ */ jsx(Input, {
-					id: "username",
-					name: "username",
-					placeholder: t("Enter value"),
-					type: "text",
-					autoComplete: "off",
-					disabled: isLoading,
-					defaultValue: defaultValues.username,
-					required: true
-				})]
-			}), /* @__PURE__ */ jsxs("fieldset", {
-				className: "flex flex-col gap-1.5",
-				children: [/* @__PURE__ */ jsx("label", {
-					htmlFor: "password",
-					className: cn(labelVariants()),
-					children: t("Password")
-				}), /* @__PURE__ */ jsx(Input, {
-					id: "password",
-					name: "password",
-					placeholder: t("Enter value"),
-					type: "password",
-					autoComplete: "off",
-					disabled: isLoading,
-					defaultValue: defaultValues.password,
-					required: true
-				})]
-			})] }),
+			type === "password" && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				/* @__PURE__ */ jsxs("fieldset", {
+					className: "flex flex-col gap-1.5",
+					children: [/* @__PURE__ */ jsx("label", {
+						htmlFor: "client_auth",
+						className: cn(labelVariants()),
+						children: t("Client Authentication")
+					}), /* @__PURE__ */ jsxs(Select, {
+						items: Object.entries(clientAuthMethods).map(([key, method]) => ({
+							label: /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("p", {
+								className: "font-medium",
+								children: method.name
+							}), /* @__PURE__ */ jsx("p", {
+								className: "text-fd-muted-foreground",
+								children: method.description
+							})] }),
+							value: key
+						})),
+						value: clientAuth,
+						onValueChange: (v) => v !== null && setClientAuth(v),
+						children: [/* @__PURE__ */ jsx(SelectTrigger, {
+							id: "client_auth",
+							disabled: isLoading,
+							children: /* @__PURE__ */ jsx(SelectValue, {})
+						}), /* @__PURE__ */ jsx(SelectContent, { children: Object.entries(clientAuthMethods).map(([key, method]) => /* @__PURE__ */ jsxs(SelectItem, {
+							value: key,
+							children: [/* @__PURE__ */ jsx("p", {
+								className: "font-medium",
+								children: method.name
+							}), /* @__PURE__ */ jsx("p", {
+								className: "text-fd-muted-foreground",
+								children: method.description
+							})]
+						}, key)) })]
+					})]
+				}),
+				/* @__PURE__ */ jsxs("fieldset", {
+					className: "flex flex-col gap-1.5",
+					children: [/* @__PURE__ */ jsx("label", {
+						htmlFor: "username",
+						className: cn(labelVariants()),
+						children: t("Username")
+					}), /* @__PURE__ */ jsx(Input, {
+						id: "username",
+						name: "username",
+						placeholder: t("Enter value"),
+						type: "text",
+						autoComplete: "off",
+						disabled: isLoading,
+						defaultValue: defaultValues.username,
+						required: true
+					})]
+				}),
+				/* @__PURE__ */ jsxs("fieldset", {
+					className: "flex flex-col gap-1.5",
+					children: [/* @__PURE__ */ jsx("label", {
+						htmlFor: "password",
+						className: cn(labelVariants()),
+						children: t("Password")
+					}), /* @__PURE__ */ jsx(Input, {
+						id: "password",
+						name: "password",
+						placeholder: t("Enter value"),
+						type: "password",
+						autoComplete: "off",
+						disabled: isLoading,
+						defaultValue: defaultValues.password,
+						required: true
+					})]
+				})
+			] }),
 			type && allFlows[type].supported ? /* @__PURE__ */ jsxs(Fragment$1, { children: [authorize.error ? /* @__PURE__ */ jsx("p", {
 				className: "text-red-400 font-medium text-sm",
 				children: String(authorize.error)

package/dist/playground/fetcher.js

@@ -43,7 +43,7 @@ function createBrowserFetcher(adapters, { proxyUrl, proxyForwardCookie = true, r
 		return fetch(requestUrl, requestInit).then(async (res) => {
 			return {
 				type: "response",
-				url,
+				url: res.url,
 				status: res.status,
 				headers: res.headers,
 				body: await res.arrayBuffer()

package/dist/utils/document/load.js

@@ -1,4 +1,4 @@
-import { upgrade } from "../../node_modules/.pnpm/@scalar_openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/upgrade.js";
+import { upgrade } from "../../node_modules/.pnpm/@scalar_openapi-upgrader@0.2.15/node_modules/@scalar/openapi-upgrader/dist/upgrade.js";
 import { bundle } from "@fumadocs/api-docs/schema/bundle";
 //#region src/utils/document/load.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "11.3.2",
+  "version": "11.3.4",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -45,32 +45,32 @@
   "dependencies": {
     "@fuma-translate/react": "^1.0.2",
     "@fumari/json-schema-ts": "^1.0.2",
-    "@scalar/json-magic": "^0.12.20",
+    "@scalar/json-magic": "^0.13.2",
     "chokidar": "^5.0.0",
     "class-variance-authority": "^0.7.1",
     "cnfast": "^0.1.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-jsx-runtime": "^2.3.6",
-    "lucide-react": "^1.31.0",
+    "lucide-react": "^1.34.0",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
     "shiki": "^4.4.3",
     "yaml": "^2.9.0",
-    "@fumadocs/api-docs": "0.2.4",
-    "@fumari/stf": "1.1.0"
+    "@fumari/stf": "1.1.0",
+    "@fumadocs/api-docs": "0.2.5"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^2.0.38",
-    "@scalar/openapi-upgrader": "^0.2.13",
+    "@scalar/api-client-react": "^2.0.42",
+    "@scalar/openapi-upgrader": "^0.2.15",
     "@tailwindcss/oxide": "^4.3.3",
-    "@types/node": "26.2.0",
+    "@types/node": "26.3.0",
     "@types/react": "^19.2.18",
     "fast-content-type-parse": "^3.0.0",
     "json-schema-typed": "^8.0.2",
     "tsdown": "0.22.14",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "16.15.1",
-    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.1",
+    "fumadocs-core": "16.15.2",
+    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.2",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -94,7 +94,7 @@
     }
   },
   "inlinedDependencies": {
-    "@scalar/openapi-upgrader": "0.2.13",
+    "@scalar/openapi-upgrader": "0.2.15",
     "fast-content-type-parse": "3.0.0",
     "xml-js": "1.6.11"
   },