fumadocs-openapi 12.0.4 → 12.1.1

package/css/generated/shared.css

@@ -1 +1 @@
-@source inline("!isDefined *:data-[collapsible=true]:order-last *:min-w-0 --- --accordion-panel-height --anchor-width --available-height --available-width --collapsible-panel-height --fd-docs-row-1 --min-height --spacing --transform-origin -mode -ms-2 -mx-3 -translate-x-1/2 -translate-y-1/2 @4xl:flex-row @4xl:items-start @4xl:sticky @4xl:top-[calc(var(--fd-docs-row-1,2rem)+1rem)] @4xl:w-[400px] @container @default @fuma-translate/react @fumadocs/json-schema @fumari/stf @md:grid-cols-2 @param @private @returns @scalar/api-client-react @see @typescript-eslint/no-explicit-any [&[hidden]:not([hidden='until-found'])]:hidden [&_svg]:size-3.5 a absolute accept access access_token accordion actual adapter adapters additionalProperties again against alias align allFlows allOf allow already alt always an anchor anchorIdStartsWith anchorSegments and animate-spin anyFields anyOf apiExample apiKey apiPlayground applicable application/javascript application/json application/x-javascript application/x-www-form-urlencoded application/xml apply are aria-label aria-live arkdown array as asSchema async at auth auth-specific authCodeQuery authNode authSchemes authorization authorizationCode authorization_code authorize authorizes autoComplete avoid await back backdrop-blur-lg backdrop-blur-sm badgeVariants base baseDir basic be because before behavior belong bg-black/30 bg-fd-background/50 bg-fd-card bg-fd-muted bg-fd-popover bg-fd-popover/60 bg-fd-primary bg-fd-primary/10 bg-fd-secondary binary blob block blocks blue body bodyMediaType bodyNode boolean border border-b border-current border-fd-primary/20 border-s border-t border-y bottom break-all buffer built-in bundled but button buttonVariants by byteLength bytes cache cached cachedDocFiles callbacks callbacksNode can cannot case catch center change charset check children class-variance-authority className cleanup client clientAuth clientAuthMethods clientCredentials clientHeight clientId clientSecret client_auth client_credentials client_error client_id client_secret cloned closed cn code codeProps codeUsages codeblock col-span-full collapsible color compiler components configuration const content contentType contentTypes cookie cookies copying core could createContext createOpenAPIPageBase createProxy credentials css csv ctx current currentValue custom customise 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-[closed]:animate-fd-popover-out data-[disabled]:opacity-50 data-[disabled]:pointer-events-none data-[highlighted]:bg-fd-accent data-[highlighted]:text-fd-accent-foreground data-[open]:animate-fd-popover-in data-[open]:border-b-0 data-[popup-open]:text-fd-accent-foreground data-closed:animate-fd-dialog-out data-closed:animate-fd-fade-out data-collapsible data-ending-style:h-0 data-ending-style:opacity-0 data-object-search-input data-open:animate-fd-dialog-in data-open:animate-fd-fade-in data-placeholder:text-fd-muted-foreground data-starting-style:h-0 data-starting-style:opacity-0 data-type dataEngine decoded default defaultMdxComponents defaultOpen defaultShikiFactory defaultShikiOptions defaultValue defaultValues defaults deferredValue define definitions delete deprecated depth dereference dereferenced description descriptionNode development deviceAuthorization dialog didn disable disableCache disabled disabled:cursor-not-allowed disabled:opacity-50 display displayNames div do doc docCache docFilesCache docRoot docs document documents domain downloaded drives duplicated duration-200 during dynamic dynamicSource e eading ease-out element else empty empty:hidden enabled encode encodeRequestData encoded end end-2 endpoint enforce engine ensure entries entry enum error eslint-disable eslint-disable-next-line example exampleId examples export exported extends fallback false fast-content-type-parse fd-page-tree-item-name fd-scroll-container fetch fetcher field fieldData fieldLabelVariants fieldName fields file filePath files filtered fine first first:border-t-0 firstItemRef fixed flex flex-1 flex-col flex-col-reverse flex-row flex-wrap flow flows focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-fd-ring focus-within:[&_svg]:text-fd-primary focus-within:ring-2 focus-within:ring-fd-ring focus:outline-none focus:ring focus:ring-fd-ring folder folderStyle font-medium font-mono font-normal font-semibold for form formData format from fs full fumadocs-core/source fumadocs-core/toc 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 generate generateDefault generateSchemaUI generated get getOpenAPIPageProps getSchema getSchemas getWatchPaths ghost github-dark github-light given go grant_type gray green grid grid-cols-1 grid-cols-[auto_1fr] group group-data-[panel-open]/accordion:rotate-90 group-data-[panel-open]:rotate-180 group/accordion groupId h-(--accordion-panel-height) h-(--collapsible-panel-height) h-10 h-9 h-[240px] h-px h1 hash hast-util-to-jsx-runtime headNode header headers heading headingLevel headless hidden hiddenProperties highlighted highlighter holding hook hover:bg-fd-accent hover:text-fd-accent-foreground hover:underline how html htmlFor http hydration i icon icon-sm icon-xs id idx if ignore img implicit import imports in in-popover index indexItemMatch info infoTags init initial inline-flex input inputs inset-0 inside installed instanceof instead integer interface internal into invalid is isDefined isDuplicated isDynamic isLazy isLoading isMounted isNumber isRequired issues it item items items-center items-start its j js json json-schema-typed justify-between justify-center key keyed keyof kind label labelClassName lang last last:border-b-0 last:mb-0 lazy leading-none leave left-1/2 length let light like line-through link links list list-disc list-inside listed load loadDocument loaderPlugin localStorage location lucide-react map mapValues marker:text-fd-muted-foreground matching max-age max-h-(--available-height) max-h-[460px] max-w-(--available-width) max-w-[98vw] max-w-full max-w-lg may mb-1 mb-2 mb-auto md mdxComponents me-auto media mediaType member merge mergeRefs message meta metaData method methods mime min-h-(--min-height,200px) min-w-0 min-w-[240px] min-w-[calc(var(--anchor-width)+--spacing(2))] modify mounted ms-auto mt-0! mt-10 mt-2 mt-3 multipart/form-data multiple must mx-1 my-0! my-1 my-1.5 my-2 my-2! my-4 name name! named namespace navigating navigation need needs nested never new no no-cache node node:fs node:path noop normalizes not not-last:pb-0 not-prose note null number oauth2 object objectSearchOverrides objectSet objects of off omit on onChange onClick onCopy onKeyDown onOpenChange onScrollEnd onSubmit onValueChange one oneOf ones only opacity-80 open openApiData openIdConnect openapi openapiMeta opened opens operation options or orange order-last origin origin-(--transform-origin) other out outline outline-none output over overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y-hidden p-1 p-1.5 p-2 p-3 p-4 packages page pageData pages panelVariants param parameter parameterLabel parameterNode parameters params parent parentPathIndex parents parsed parsedState part parts party pass password path pathIndex pathItem pathName pathnameFromRequest pattern patternProperties payload pb-0 pb-2 pe-2 pe-3 peer-disabled:cursor-not-allowed peer-disabled:opacity-70 persist persisted picked place placeholder placeholder:text-fd-muted-foreground playground playgrounds please plugins polite popover popoverRef positions pre preloadOpenAPIPage preloaded preventScroll previous primitive processor properties property props prose prose-no-margin prose-sm proxy proxyForwardCookie proxyUrl ps-1 ps-2 ps-3 ps-4.5 ps-6 pt-0 pt-1 pt-2 pt-2.5 px px-1 px-2 px-3 px-4 py-0 py-0.5 py-1 py-1.5 py-2 py-4 query querySelector quiet raw rawSearch re-triggering react react-hooks/exhaustive-deps react/jsx-runtime read readOnly readonly record red redirect_uri ref reference refs regenerated rehype-react relativePath remark remark-rehype remarkGfm remarkRehype remove removeItem removing render renderBodyField renderCodeblock renderMarkdown renderParameterField renderPopoverTrigger renderTrigger rendered renderers renders replace represents request request-body requestBody requestData requestInit requestTimeout requestUrl requests required requirement requirements res reset resize-none resolve resolveMediaAdapter resolveUrl resolved resolvedInput resolvedTheme response response-body responseNode responseTabs response_type responses rest restored result return returning returns role root rootId roots rotate-90 rounded-2xl rounded-lg rounded-md rounded-sm rounded-xl route s-highlight safeParse same satisfies scalar scan schema schemaId schemaPropKeys schemaUI scheme schemeId schemes scope scopes scroll scroll-m-20 scrollTop scrollTops search secondary seconds secret section sections security segments segs select select-none selected selectedType selections selector sends sep separator server server-to-server serverSchema services set setClientAuth setError setInfo setIsJson setNextName setObjectUrl setOpen setPath setSearch setSelected setServerVariables setShow setStore setToken setType setValue shadow-lg shadow-md shadow-sm shared shiki shikiOptions show showDescription showExample showResponseSchema showSelect showTitle showing shrink-0 side sideOffset signal single size size-3.5 size-4 skipNonRequired skipReadOnly slot slotType slots sm sm:flex-row sm:gap-2 sm:justify-end sm:text-start smooth so some source specify sr-only src stable start state staticSource status statusInfo step stf stfSync sticky still storageKey store stored string stringify stringifyFieldKey structuredData styles submit such supported svg switch t tab tabDepth tabValues tabs tag target testQuery text text-[0.8125rem] text-blue-600 text-center text-end text-fd-card-foreground text-fd-foreground text-fd-muted-foreground text-fd-muted-foreground/70 text-fd-popover-foreground text-fd-primary text-fd-primary-foreground text-fd-secondary-foreground text-green-500 text-green-600 text-lg text-nowrap text-orange-400 text-orange-600 text-red-400 text-red-400/80 text-red-500 text-red-600 text-sm text-start text-xs text-yellow-600 text/css text/csv text/html text/plain that the their them themes they this through throw timeout timerRef tips title to toJsxRuntime toStaticData toc token tokenInfo tokenUrl token_type toolbar top top-0 top-1/2 top-10 top-2 tracking-tight transform transformPageTree transition-[height,opacity] transition-[height] transition-colors transition-transform translations tree trigger true truncate try ts type typeVariants typeof types unchanged undefined under underline unexpected union unionField unions unknown unlisted unselected up update updateInfo updated updatedSchemeId updating url usageTabs use useAnchorId useApiClient useComponents useCopyButton useFieldValue useListener useMemo useNamespace useObject useOnChange useOpenAPI useOperation usePlaygroundAuth useQuery useRef useRenderContext useResponseExamples useServer useState useStatusInfo useStf useSyncExternalStore useTheme useTranslations useTypeScriptDefinitions used username using utf-8 v value valueSchema values variable variables variant variants via view virtual void w-0 w-14 w-[600px] w-fit w-full warn was we webhook webhooks when where whitespace-pre-wrap will with without won wrap-break-word wrapping write writeOnly x-exclusiveCodeSample x-playground-lazy xml yellow you your z-20 z-50");
+@source inline("!isDefined *:data-[collapsible=true]:order-last *:min-w-0 --- --accordion-panel-height --anchor-width --available-height --available-width --collapsible-panel-height --fd-docs-row-1 --min-height --spacing --transform-origin -mode -ms-2 -mx-3 -translate-x-1/2 -translate-y-1/2 @4xl:flex-row @4xl:items-start @4xl:sticky @4xl:top-[calc(var(--fd-docs-row-1,2rem)+1rem)] @4xl:w-[400px] @container @default @fuma-translate/react @fumadocs/json-schema @fumari/stf @md:grid-cols-2 @param @private @returns @scalar/api-client-react @see @typescript-eslint/no-explicit-any [&[hidden]:not([hidden='until-found'])]:hidden [&_svg]:size-3.5 a absolute accept access access_token accordion actual adapter adapters additionalProperties again against alias align allFlows allOf allow already alt always an anchor anchorIdStartsWith anchorSegments and animate-spin anyFields anyOf apiExample apiKey apiPlayground applicable application/javascript application/json application/x-javascript application/x-www-form-urlencoded application/xml applies apply are aria-label aria-live arkdown array as asSchema async at audience auth auth-specific authCodeQuery authNode authSchemes authorization authorizationCode authorizationUrl authorization_code authorize authorizes autoComplete avoid await back backdrop-blur-lg backdrop-blur-sm badgeVariants base baseDir basic be because before behavior belong bg-black/30 bg-fd-background/50 bg-fd-card bg-fd-muted bg-fd-popover bg-fd-popover/60 bg-fd-primary bg-fd-primary/10 bg-fd-secondary bg-transparent binary block blocks blue body bodyMediaType bodyNode boolean border border-0 border-b border-current border-fd-primary/20 border-s border-t border-y bottom break-all built-in bundled button buttonVariants by byteLength bytes cache cached cachedDocFiles callbacks callbacksNode can cannot case catch center change charset children class-variance-authority className cleanup client clientAuth clientAuthMethods clientCredentials clientHeight clientId clientSecret client_auth client_credentials client_error client_id client_secret cloned closed cn code codeProps codeUsages codeblock col-span-full collapsible color compiler components configuration const content contentType contentTypes cookie cookies copying core createContext createOAuthHandler createOpenAPIPageBase createProxy credentials css csv ctx current currentValue custom customise 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-[closed]:animate-fd-popover-out data-[disabled]:opacity-50 data-[disabled]:pointer-events-none data-[highlighted]:bg-fd-accent data-[highlighted]:text-fd-accent-foreground data-[open]:animate-fd-popover-in data-[open]:border-b-0 data-[popup-open]:text-fd-accent-foreground data-closed:animate-fd-dialog-out data-closed:animate-fd-fade-out data-collapsible data-ending-style:h-0 data-ending-style:opacity-0 data-object-search-input data-open:animate-fd-dialog-in data-open:animate-fd-fade-in data-placeholder:text-fd-muted-foreground data-starting-style:h-0 data-starting-style:opacity-0 data-type dataEngine decoded default defaultMdxComponents defaultOpen defaultShikiFactory defaultShikiOptions defaultValue defaultValues defaults deferredValue define definitions delete deprecated depth dereference dereferenced description descriptionNode development deviceAuthorization dialog didn disable disableCache disabled disabled:cursor-not-allowed disabled:opacity-50 display displayNames disposition div do doc docCache docFilesCache docRoot docs document documents domain download downloaded drives duplicated duration-200 during dynamic dynamicSource e eading ease-out element else empty empty:hidden enabled encode encodeRequestData encoded end end-2 endpoint enforce engine ensure entries entry enum error eslint-disable eslint-disable-next-line example exampleId examples export exported extended extends fallback false fast-content-type-parse fd-page-tree-item-name fd-scroll-container fetch fetcher field fieldData fieldLabelVariants fieldName fields file filePath files filtered fine first first:border-t-0 firstItemRef fixed flex flex-1 flex-col flex-col-reverse flex-row flex-wrap flow flows focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-fd-ring focus-within:[&_svg]:text-fd-primary focus-within:ring focus-within:ring-2 focus-within:ring-fd-ring focus:outline-none focus:ring focus:ring-0 focus:ring-fd-ring folder folderStyle font-medium font-mono font-normal font-semibold for form form-encoded formData format fragment from fs full fumadocs-core/source fumadocs-core/toc fumadocs-openapi-oauth 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 generate generateDefault generateSchemaUI generated get getOpenAPIPageProps getSchema getSchemas getWatchPaths ghost github-dark github-light given go goes grant_type gray green grid grid-cols-1 grid-cols-[auto_1fr] group group-data-[panel-open]/accordion:rotate-90 group-data-[panel-open]:rotate-180 group/accordion groupId h-(--accordion-panel-height) h-(--collapsible-panel-height) h-10 h-9 h-[240px] h-px h1 hash hast-util-to-jsx-runtime have headNode header headers heading headingLevel headless hidden hiddenProperties highlighted highlighter holding hook hover:bg-fd-accent hover:text-fd-accent-foreground hover:underline how href html htmlFor http hydration i icon icon-sm icon-xs id idx if ignore img implicit import imports in in-popover index indexItemMatch info infoTags init initial inline-flex input inputs inset-0 inside installed instanceof instead integer interface internal into invalid is isDefined isDuplicated isDynamic isLazy isLoading isMounted isNumber isRequired issues it item items items-center items-start its j js json json-schema-typed justify-between justify-center keep key keyed keyof kind label labelClassName lang last last:border-b-0 last:mb-0 lazy leading-none leave left left-1/2 length let light like line-through link links list list-disc list-inside listed listen listener listeners load loadDocument loaderPlugin localStorage location lucide-react map mapValues marker:text-fd-muted-foreground match matching max-age max-h-(--available-height) max-h-[460px] max-w-(--available-width) max-w-[98vw] max-w-full max-w-lg may mb-1 mb-2 mb-auto md mdxComponents me-auto media mediaAdapters mediaType member merge mergeRefs message meta metaData method methods mime min-h-(--min-height,200px) min-w-0 min-w-[240px] min-w-[calc(var(--anchor-width)+--spacing(2))] modify mounted ms-auto mt-0! mt-10 mt-2 mt-3 multipart/form-data multiple must mx-1 my-0! my-1 my-1.5 my-2 my-2! my-4 name name! named namespace navigating navigation needs nested never new no no-cache node node:fs node:path noop normalizes not not-last:pb-0 not-prose note null number oauth2 oauthRedirectUrl object objectSearchOverrides objectSet objectUrl objects of off omit on onChange onClick onCopy onKeyDown onOpenChange onScrollEnd onSubmit onToken onValueChange one oneOf ones only opacity-80 open openApiData openIdConnect openapi openapiMeta opened opens operation options or orange order-last origin origin-(--transform-origin) other otherwise out outline outline-none output over overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y-hidden p-1 p-1.5 p-2 p-3 p-4 packages page pageData pages panelVariants param parameter parameterLabel parameterNode parameters params parent parentPathIndex parents parsed part parts party pass password path pathIndex pathItem pathName pathnameFromRequest pattern patternProperties payload pb-0 pb-2 pe-2 pe-3 peer-disabled:cursor-not-allowed peer-disabled:opacity-70 pending pendingFlowKey persist persisted picked place placeholder placeholder:text-fd-muted-foreground playground playgrounds please plugins polite popover popoverRef positions pre preferring preloadOpenAPIPage preloaded preventScroll previous primitive processor properties property props prose prose-no-margin prose-sm proxy proxyForwardCookie proxyUrl ps-1 ps-2 ps-3 ps-4.5 ps-6 pt-0 pt-1 pt-2 pt-2.5 px px-1 px-2 px-3 px-4 py-0 py-0.5 py-1 py-1.5 py-2 py-4 query querySelector quiet random raw rawSearch re-triggering react react-hooks/exhaustive-deps react/jsx-runtime read readOnly readonly record red redirect redirectUrl redirect_uri ref reference refs regenerated rehype-react relative relativePath remark remark-rehype remarkGfm remarkRehype remove removeItem removing render renderBodyField renderCodeblock renderMarkdown renderParameterField renderPopoverTrigger renderTrigger rendered renderers renders replace represents request request-body requestBody requestData requestInit requestTimeout requestUrl requests required requirement requirements res reset resize-none resolve resolveMediaAdapter resolveUrl resolved resolvedInput resolvedTheme response response-body responseNode responseTabs response_type responses rest restored result return returning returns role root rootId roots rotate-90 rounded-2xl rounded-b-none rounded-lg rounded-md rounded-sm rounded-t-md rounded-xl route s-highlight safeParse same satisfies scalar scan schema schemaId schemaPropKeys schemaUI scheme schemeId schemes scope scopes scroll scroll-m-20 scrollTop scrollTops search secondary seconds secret section sections security see segments segs select select-none selected selectedType selections selector send sends sep separator server server-to-server serverSchema serverUrl services sessionStorage set setClientAuth setError setInfo setIsJson setNextName setObjectUrl setOpen setPath setSearch setSelected setServerVariables setShow setStore setToken setType setValue shadow-lg shadow-md shadow-sm shared shiki shikiOptions show showDescription showExample showResponseSchema showSelect showTitle showing shrink-0 side sideOffset signal single size size-3.5 size-4 skipNonRequired skipReadOnly slot slotType slots sm sm:flex-row sm:gap-2 sm:justify-end sm:text-start smooth so some sr-only src stable start started state staticSource status statusInfo step stf stfSync sticky still storageKey store stored string stringify stringifyFieldKey structuredData styles submit subscribe such supported svg switch t tab tabDepth tabValues tabs tag target testQuery text text-[0.8125rem] text-blue-600 text-center text-end text-fd-card-foreground text-fd-foreground text-fd-muted-foreground text-fd-muted-foreground/70 text-fd-popover-foreground text-fd-primary text-fd-primary-foreground text-fd-secondary-foreground text-green-500 text-green-600 text-lg text-nowrap text-orange-400 text-orange-600 text-red-400 text-red-400/80 text-red-500 text-red-600 text-sm text-start text-xs text-yellow-600 text/css text/csv text/html text/plain that the their them themes they this through throw timeout timerRef tips title to toJsxRuntime toStaticData toc token tokenInfo tokenUrl token_type token_url tokens toolbar top top-0 top-1/2 top-10 top-2 tracking-tight transform transformPageTree transition-[height,opacity] transition-[height] transition-colors transition-transform translations tree trigger true truncate try ts type typeVariants typeof types unchanged undefined under underline unexpected union unionField unions unknown unlisted unselected up update updateInfo updated updating url usageTabs use useAnchorId useApiClient useComponents useCopyButton useFieldValue useListener useMemo useNamespace useObject useOnChange useOpenAPI useOperation usePlaygroundAuth useQuery useRef useRenderContext useResponseExamples useServer useState useStatusInfo useStf useSyncExternalStore useTheme useTranslations useTypeScriptDefinitions used username users using utf-8 v value valueSchema values variable variables variant variants via view virtual void w-0 w-14 w-[600px] w-fit w-full warn was we webhook webhooks when where will with without won wrap-break-word wrapping write writeOnly x-exclusiveCodeSample x-playground-lazy xml yellow you your z-20 z-50");

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

@@ -30,6 +30,7 @@ export type Translations = {
   "Deprecated(operation page)": string;
   "Deprecated(security scheme)": string;
   "Device Authorization(OAuth dialog)": string;
+  "Download(playground result display)": string;
   "Empty(operation page)": string;
   "Enter Value(playground server select)": string;
   "Enter value(OAuth dialog)": string;

package/dist/.translations/keys.js

@@ -30,6 +30,7 @@ var keys_default = [
 	"Deprecated(operation page)",
 	"Deprecated(security scheme)",
 	"Device Authorization(OAuth dialog)",
+	"Download(playground result display)",
 	"Empty(operation page)",
 	"Enter Value(playground server select)",
 	"Enter value(OAuth dialog)",

package/dist/operation.js

@@ -1,11 +1,10 @@
 "use client";
-import { isMediaTypeSupported } from "./requests/media/resolve-adapter.js";
 import { createCodeUsageGeneratorRegistry, pathnameFromRequest } from "./requests/generators/index.js";
 import { joinURL } from "./packages/shared-api/dist/utils/url.js";
 import { ServerProvider, useServer } from "./utils/use-server.js";
 import { useOpenAPI } from "./utils/create-page.js";
 import { idToTitle } from "./packages/shared-api/dist/utils/id-to-title.js";
-import { getPreferredType, methodKeys } from "./utils/schema.js";
+import { getExampleValue, getPreferredType, methodKeys } from "./utils/schema.js";
 import { encodeRequestData } from "./requests/media/encode.js";
 import { getExampleRequests } from "./utils/get-example-requests.js";
 import { createContext, use, useMemo, useSyncExternalStore } from "react";
@@ -29,10 +28,7 @@ function OperationProvider({ type = "operation", path, method, operation, pathIt
 		let requestBody;
 		if (body?.content && Object.keys(body.content).length > 0) {
 			const content = {};
-			for (const [mediaType, item] of Object.entries(body.content)) {
-				if (!isMediaTypeSupported(mediaType, runtime.mediaAdapters)) throw new Error(`Media type ${mediaType} is not supported (in ${path})`);
-				content[mediaType] = resolve(item);
-			}
+			for (const [mediaType, item] of Object.entries(body.content)) content[mediaType] = resolve(item);
 			requestBody = {
 				description: body.description,
 				required: body.required,
@@ -269,9 +265,11 @@ function useResponseExamples() {
 				tab.examples = [];
 				for (const [key, item] of Object.entries(responseOfType.examples)) {
 					const example = resolve(item);
+					const sample = getExampleValue(example);
+					if (sample === void 0) continue;
 					tab.examples.push({
 						label: example.summary ?? t("Example {key}", { variables: { key } }),
-						sample: getRaw(example.value),
+						sample,
 						description: example.description
 					});
 				}

package/dist/playground/auth.d.ts

@@ -11,8 +11,15 @@ export interface OAuthFlowInput {
   clientSecret: string;
   username: string;
   password: string;
-  /** where the password flow sends the client credentials */
+  /**
+   * where token requests send the client credentials,
+   * `header` (HTTP Basic) applies only with a client secret, otherwise the `client_id` goes in the body
+   */
   clientAuth: 'body' | 'header';
+  /** URL of the selected server, relative URLs of the flow resolve against it */
+  serverUrl: string;
+  /** URL of the `createOAuthHandler()` route, defaults to the page */
+  redirectUrl?: string;
 }
 /**
  * Run an OAuth flow and resolve its token.
@@ -20,25 +27,27 @@ export interface OAuthFlowInput {
  * `implicit` and `authorizationCode` leave the page instead: the token is picked up on return,
  * in `usePlaygroundAuth().store`.
  */
-export declare function requestOAuthToken(scheme: OAuth2SecurityScheme, type: OAuthFlowType, { schemeId, scopes, clientId, clientSecret, username, password, clientAuth }: OAuthFlowInput): Promise<string | undefined>;
+export declare function requestOAuthToken(scheme: OAuth2SecurityScheme, type: OAuthFlowType, { schemeId, scopes, clientId, clientSecret, username, password, clientAuth, serverUrl, redirectUrl }: OAuthFlowInput): Promise<string | undefined>;
 /** scheme name -> token info */
 type TokenStore = Record<string, TokenInfo | undefined>;
 type TokenInfo = {
   type: 'authorization_code';
-  redirect_uri: string;
   client_id: string;
   client_secret: string;
+  client_auth: OAuthFlowInput['clientAuth'];
   token: string;
 } | {
   type: 'implicit';
   client_id: string;
   token: string;
 };
+type TokenListener = (schemeId: string, token: string) => void;
 interface AuthContextType {
   store: TokenStore;
-  updatedSchemeId: string | null;
   isLoading: boolean;
   error?: unknown;
+  /** listen to the tokens of flows returning to the page, returns a cleanup */
+  subscribe: (listener: TokenListener) => () => void;
 }
 export declare function usePlaygroundAuth(): AuthContextType;
 export interface AuthRequirement {

package/dist/playground/auth.js

@@ -1,72 +1,69 @@
 "use client";
 import { useQuery } from "../packages/shared-api/dist/utils/use-query.js";
 import { useOpenAPI } from "../utils/create-page.js";
-import { createContext, use, useCallback, useEffect, useMemo, useState } from "react";
+import { createContext, use, useCallback, useEffect, useEffectEvent, useMemo, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 import { useListener } from "@fumari/stf";
 import { arrayStartsWith, objectGet, objectSet } from "@fumari/stf/lib/utils";
-import { useOnChange } from "fumadocs-core/utils/use-on-change";
 //#region src/playground/auth.tsx
+const pendingFlowKey = "fumadocs-openapi-oauth";
 /**
 * Run an OAuth flow and resolve its token.
 *
 * `implicit` and `authorizationCode` leave the page instead: the token is picked up on return,
 * in `usePlaygroundAuth().store`.
 */
-async function requestOAuthToken(scheme, type, { schemeId, scopes, clientId, clientSecret, username, password, clientAuth }) {
+async function requestOAuthToken(scheme, type, { schemeId, scopes, clientId, clientSecret, username, password, clientAuth, serverUrl, redirectUrl }) {
 	const flows = scheme.flows ?? {};
-	const scope = scopes.join("+");
-	const redirect_uri = window.location.href;
+	const scope = scopes.join(" ");
 	if (type === "implicit" || type === "authorizationCode") {
 		const flow = flows[type];
 		if (!flow) return;
-		const params = new URLSearchParams({
-			response_type: type === "implicit" ? "token" : "code",
+		const pending = {
+			state: crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(4)).join(""),
+			scheme: schemeId,
 			client_id: clientId,
-			redirect_uri,
-			scope,
-			state: JSON.stringify(type === "implicit" ? {
-				scheme: schemeId,
-				client_id: clientId,
-				redirect_uri
-			} : {
-				scheme: schemeId,
-				client_id: clientId,
-				client_secret: clientSecret,
-				redirect_uri
-			})
-		});
-		window.location.replace(`${flow.authorizationUrl}?${params}`);
+			client_secret: clientSecret,
+			client_auth: clientAuth,
+			redirect_uri: new URL(redirectUrl ?? window.location.pathname, window.location.origin).href,
+			token_url: "tokenUrl" in flow ? new URL(flow.tokenUrl, serverUrl).href : void 0
+		};
+		sessionStorage.setItem(pendingFlowKey, JSON.stringify(pending));
+		if (redirectUrl) document.cookie = `fumadocs-openapi-oauth=${encodeURIComponent(window.location.pathname)}; path=/`;
+		const url = new URL(flow.authorizationUrl, serverUrl);
+		url.searchParams.set("response_type", type === "implicit" ? "token" : "code");
+		url.searchParams.set("client_id", clientId);
+		url.searchParams.set("redirect_uri", pending.redirect_uri);
+		url.searchParams.set("scope", scope);
+		url.searchParams.set("state", pending.state);
+		window.location.replace(url);
 		return;
 	}
 	if (type !== "password" && type !== "clientCredentials") return;
 	const flow = flows[type];
 	if (!flow) return;
-	const headers = {};
 	const body = new URLSearchParams({ scope });
 	if (type === "password") {
 		body.set("grant_type", "password");
 		body.set("username", username);
 		body.set("password", password);
-		if (clientAuth === "header") headers.Authorization = `Basic ${btoa(`${clientId}:${clientSecret}`)}`;
-		else {
-			if (clientId) body.set("client_id", clientId);
-			if (clientSecret) body.set("client_secret", clientSecret);
-		}
-	} else {
-		body.set("grant_type", "client_credentials");
-		body.set("client_id", clientId);
-		body.set("client_secret", clientSecret);
-	}
-	return fetchToken(flow.tokenUrl, body, headers);
+	} else body.set("grant_type", "client_credentials");
+	return fetchToken(new URL(flow.tokenUrl, serverUrl).href, body, {
+		client_id: clientId,
+		client_secret: clientSecret,
+		client_auth: clientAuth
+	});
 }
-async function fetchToken(tokenUrl, body, headers = {}) {
+async function fetchToken(tokenUrl, body, { client_id, client_secret, client_auth }) {
+	const headers = { "Content-Type": "application/x-www-form-urlencoded" };
+	if (client_auth === "header" && client_secret) headers.Authorization = `Basic ${btoa(`${encodeURIComponent(client_id)}:${encodeURIComponent(client_secret)}`)}`;
+	else {
+		if (client_id) body.set("client_id", client_id);
+		if (client_secret) body.set("client_secret", client_secret);
+	}
 	const res = await fetch(tokenUrl, {
 		method: "POST",
-		headers: {
-			...headers,
-			"Content-Type": "application/x-www-form-urlencoded"
-		},
+		headers,
 		body
 	});
 	if (!res.ok) throw new Error(await res.text());
@@ -80,75 +77,64 @@ function usePlaygroundAuth() {
 	return ctx;
 }
 function AuthProvider({ children }) {
-	const { dereferenced, resolve } = useOpenAPI().doc;
-	const schemes = dereferenced.components?.securitySchemes;
 	const [store, setStore] = useState({});
-	const authCodeQuery = useQuery(async (code, state) => {
-		const scheme = resolve(schemes?.[state.scheme]);
-		if (!scheme || scheme.type !== "oauth2") return;
-		const value = scheme.flows?.authorizationCode;
-		if (!value) return;
-		const info = {
-			type: "authorization_code",
-			...state,
-			token: await fetchToken(value.tokenUrl, new URLSearchParams({
-				grant_type: "authorization_code",
-				code,
-				redirect_uri: state.redirect_uri,
-				client_id: state.client_id,
-				client_secret: state.client_secret
-			}))
+	const listeners = useMemo(() => /* @__PURE__ */ new Set(), []);
+	const subscribe = useCallback((listener) => {
+		listeners.add(listener);
+		return () => {
+			listeners.delete(listener);
 		};
+	}, [listeners]);
+	function save(schemeId, info) {
 		setStore((s) => ({
 			...s,
-			[state.scheme]: info
+			[schemeId]: info
 		}));
+		for (const listener of listeners) listener(schemeId, info.token);
+	}
+	const authCodeQuery = useQuery(async (code, flow) => {
+		const token = await fetchToken(flow.token_url, new URLSearchParams({
+			grant_type: "authorization_code",
+			code,
+			redirect_uri: flow.redirect_uri
+		}), flow);
+		save(flow.scheme, {
+			type: "authorization_code",
+			client_id: flow.client_id,
+			client_secret: flow.client_secret,
+			client_auth: flow.client_auth,
+			token
+		});
 	});
 	useEffect(() => {
-		function onQuery() {
-			const query = new URLSearchParams(window.location.search);
-			const state = query.get("state");
-			const code = query.get("code");
-			if (!state || !code) return;
-			const parsedState = JSON.parse(state);
-			authCodeQuery.start(code, parsedState);
-			window.history.replaceState(null, "", window.location.pathname);
-		}
-		function onHash() {
-			const hash = new URLSearchParams(window.location.hash.slice(1));
-			const state = hash.get("state");
-			const token = hash.get("access_token");
-			const type = hash.get("token_type") ?? "Bearer";
-			if (!state || !token) return;
-			const parsedState = JSON.parse(state);
-			const scheme = resolve(schemes?.[parsedState.scheme]);
-			if (!scheme || scheme.type !== "oauth2" || !scheme.flows?.implicit) return;
-			const info = {
-				type: "implicit",
-				client_id: parsedState.client_id,
-				token: `${type} ${token}`
-			};
-			setStore((s) => ({
-				...s,
-				[parsedState.scheme]: info
-			}));
-			window.history.replaceState(null, "", window.location.pathname);
-		}
-		try {
-			if (window.location.search.length > 0) onQuery();
-			if (window.location.hash.length > 1) onHash();
-		} catch {}
+		const stored = sessionStorage.getItem(pendingFlowKey);
+		if (!stored) return;
+		const flow = JSON.parse(stored);
+		const query = new URLSearchParams(window.location.search);
+		const hash = new URLSearchParams(window.location.hash.slice(1));
+		const code = query.get("code");
+		const token = hash.get("access_token");
+		if (code && query.get("state") === flow.state) authCodeQuery.start(code, flow);
+		else if (token && hash.get("state") === flow.state) save(flow.scheme, {
+			type: "implicit",
+			client_id: flow.client_id,
+			token: `${hash.get("token_type") ?? "Bearer"} ${token}`
+		});
+		else return;
+		sessionStorage.removeItem(pendingFlowKey);
+		window.history.replaceState(null, "", window.location.pathname);
 	}, []);
 	return /* @__PURE__ */ jsx(AuthContext, {
 		value: useMemo(() => ({
 			store,
-			updatedSchemeId: Object.keys(store)[0] ?? null,
 			isLoading: authCodeQuery.isLoading,
-			error: authCodeQuery.error
+			error: authCodeQuery.error,
+			subscribe
 		}), [
 			store,
 			authCodeQuery.isLoading,
-			authCodeQuery.error
+			authCodeQuery.error,
+			subscribe
 		]),
 		children
 	});
@@ -157,7 +143,7 @@ function AuthProvider({ children }) {
 * The auth fields of an API playground: the values it persists, and the request data they encode into.
 */
 function useAuthFields(engine, { operation, transform } = {}) {
-	const auth = usePlaygroundAuth();
+	const { subscribe } = usePlaygroundAuth();
 	const { storageKeyPrefix, doc } = useOpenAPI();
 	const { dereferenced, resolve } = doc;
 	const schemes = dereferenced.components?.securitySchemes;
@@ -238,21 +224,19 @@ function useAuthFields(engine, { operation, transform } = {}) {
 			}
 		}
 	});
-	useOnChange(auth.updatedSchemeId, () => {
-		const { updatedSchemeId } = auth;
-		if (!updatedSchemeId) return;
-		const { token } = auth.store[updatedSchemeId];
-		const field = fields.find((field) => field.schemeId === updatedSchemeId);
+	const onToken = useEffectEvent((schemeId, token) => {
+		const field = fields.find((field) => field.schemeId === schemeId);
 		if (field) {
 			engine.update(field.fieldName, token);
 			return;
 		}
-		const idx = requirements.findIndex((req) => req.some((item) => item.id === updatedSchemeId));
+		const idx = requirements.findIndex((req) => req.some((item) => item.id === schemeId));
 		if (idx !== -1) {
-			localStorage.setItem(`${storageKeyPrefix}auth-${updatedSchemeId}`, JSON.stringify(token));
+			localStorage.setItem(`${storageKeyPrefix}auth-${schemeId}`, JSON.stringify(token));
 			select(idx);
 		}
 	});
+	useEffect(() => subscribe(onToken), [subscribe]);
 	return {
 		requirements,
 		selected,

package/dist/playground/fetcher.js

@@ -22,7 +22,7 @@ function createBrowserFetcher(adapters, { proxyUrl, proxyForwardCookie = true, r
 			if (!adapter) return {
 				type: "client_error",
 				url,
-				message: `[Fumadocs] No adapter for ${data.bodyMediaType}, you need to specify one from 'createOpenAPI()'.`
+				message: `[Fumadocs] No media adapter for ${data.bodyMediaType}, pass one to \`mediaAdapters\` of \`createOpenAPIPage()\`.`
 			};
 			if (data.bodyMediaType !== "multipart/form-data") headers.append("Content-Type", data.bodyMediaType);
 			requestInit.body = adapter.encode(data);

package/dist/requests/generators/curl.js

@@ -1,9 +1,10 @@
 import { doubleQuote, indent, inputToString, singleQuote } from "../string-utils.js";
+import { resolveMediaAdapter } from "../media/resolve-adapter.js";
 //#region src/requests/generators/curl.ts
 const curl = {
 	label: "cURL",
 	lang: "bash",
-	generate(data) {
+	generate(data, { mediaAdapters }) {
 		const s = [];
 		s.push(`curl -X ${data.method.toUpperCase()} "${data.url}"`);
 		for (const header in data.header) {
@@ -17,7 +18,7 @@ const curl = {
 		if (data.body && data.bodyMediaType === "multipart/form-data") {
 			if (typeof data.body !== "object") throw new Error("[CURL] request body must be an object.");
 			for (const [key, value] of Object.entries(data.body)) s.push(`-F ${key}=${doubleQuote(inputToString(value))}`);
-		} else if (data.body && data.bodyMediaType) {
+		} else if (data.body && data.bodyMediaType && resolveMediaAdapter(data.bodyMediaType, mediaAdapters)) {
 			const escaped = singleQuote(inputToString(data.body, data.bodyMediaType));
 			s.push(`-H "Content-Type: ${data.bodyMediaType}"`);
 			s.push(`-d ${escaped}`);

package/dist/requests/index.d.ts

@@ -1,4 +1,4 @@
-import { isMediaTypeSupported, resolveMediaAdapter } from "./media/resolve-adapter.js";
+import { resolveMediaAdapter } from "./media/resolve-adapter.js";
 import { EncodedParameter, EncodedParameterMultiple, encodeRequestData } from "./media/encode.js";
 import { RawRequestData, RequestData } from "./types.js";
-export { type EncodedParameter, type EncodedParameterMultiple, type RawRequestData, type RequestData, encodeRequestData, isMediaTypeSupported, resolveMediaAdapter };
+export { type EncodedParameter, type EncodedParameterMultiple, type RawRequestData, type RequestData, encodeRequestData, resolveMediaAdapter };

package/dist/requests/index.js

@@ -1,3 +1,3 @@
-import { isMediaTypeSupported, resolveMediaAdapter } from "./media/resolve-adapter.js";
+import { resolveMediaAdapter } from "./media/resolve-adapter.js";
 import { encodeRequestData } from "./media/encode.js";
-export { encodeRequestData, isMediaTypeSupported, resolveMediaAdapter };
+export { encodeRequestData, resolveMediaAdapter };

package/dist/requests/media/adapter.d.ts

@@ -1,4 +1,4 @@
-import { isMediaTypeSupported, resolveMediaAdapter } from "./resolve-adapter.js";
+import { resolveMediaAdapter } from "./resolve-adapter.js";
 //#region src/requests/media/adapter.d.ts
 interface BaseContext {
   /**

package/dist/requests/media/adapter.js

@@ -1,7 +1,7 @@
 import { __toESM } from "../../_virtual/_rolldown/runtime.js";
 import { require_js2xml } from "../../node_modules/.pnpm/xml-js@1.6.11/node_modules/xml-js/lib/js2xml.js";
 import { backtickQuote, inputToString, rustRawStringLiteral, tripleDoubleQuote } from "../string-utils.js";
-import { isMediaTypeSupported, resolveMediaAdapter } from "./resolve-adapter.js";
+import { resolveMediaAdapter } from "./resolve-adapter.js";
 //#region src/requests/media/adapter.ts
 var import_js2xml = /* @__PURE__ */ __toESM(require_js2xml(), 1);
 const defaultAdapters = {
@@ -125,4 +125,4 @@ function str(init, mediaType, ctx) {
 	if (ctx.lang === "rust") return `let body = ${rustRawStringLiteral(inputToString(init, mediaType))};`;
 }
 //#endregion
-export { defaultAdapters, isMediaTypeSupported, resolveMediaAdapter };
+export { defaultAdapters, resolveMediaAdapter };

package/dist/requests/media/resolve-adapter.d.ts

@@ -9,12 +9,4 @@ import { MediaAdapter } from "./adapter.js";
  * @returns The resolved adapter or undefined if not found
  */
 export declare function resolveMediaAdapter(mediaType: string, adapters: Record<string, MediaAdapter>): MediaAdapter | undefined;
-/**
- * Check if a media type is supported by the given adapters.
- *
- * @param mediaType - The media type to check
- * @param adapters - Record of media adapters
- * @returns true if the media type is supported
- */
-export declare function isMediaTypeSupported(mediaType: string, adapters: Record<string, MediaAdapter>): boolean;
 //#endregion

package/dist/requests/media/resolve-adapter.js

@@ -16,20 +16,10 @@ function resolveMediaAdapter(mediaType, adapters) {
 		const baseType = `${match.groups.dir}/${match.groups.variant}`;
 		if (baseType in adapters) return adapters[baseType];
 	}
-	if (mediaType === "text/plain") {
+	if (normalized === "text/plain") {
 		console.warn("there is no defined behaviour for encoding form values into \"text/plain\", using JSON encoder for now.");
 		return adapters["application/json"];
 	}
 }
-/**
-* Check if a media type is supported by the given adapters.
-*
-* @param mediaType - The media type to check
-* @param adapters - Record of media adapters
-* @returns true if the media type is supported
-*/
-function isMediaTypeSupported(mediaType, adapters) {
-	return resolveMediaAdapter(mediaType, adapters) !== void 0;
-}
 //#endregion
-export { isMediaTypeSupported, resolveMediaAdapter };
+export { resolveMediaAdapter };

package/dist/server/index.d.ts

@@ -2,6 +2,7 @@ import { Awaitable, Document } from "../types.js";
 import { OpenAPIPageProps_Preloaded, OpenAPIPageProps_Spec } from "../utils/pages/builder.js";
 import { SchemaToPagesOptions } from "../utils/pages/preset-auto.js";
 import { CreateProxyOptions, Proxy, createProxy } from "./proxy.js";
+import { createOAuthHandler } from "./oauth.js";
 import "../ui/index.js";
 import { DynamicSource, LoaderPlugin, MetaData, Page, PageData, Source } from "fumadocs-core/source";
 import { StructuredData } from "fumadocs-core/mdx-plugins/remark-structure";
@@ -30,6 +31,7 @@ export interface OpenAPIOptions {
 }
 export interface OpenAPIServer {
   createProxy: typeof createProxy;
+  createOAuthHandler: typeof createOAuthHandler;
   getSchemas: () => Promise<Record<string, LoadedDocument>>;
   getSchema: (document: string) => Promise<LoadedDocument>;
   readonly options: OpenAPIOptions;

package/dist/server/index.js

@@ -2,6 +2,7 @@ import { fromSchema, getPageProps } from "../utils/pages/builder.js";
 import { toStaticData } from "../utils/pages/to-static-data.js";
 import { createAutoPreset } from "../utils/pages/preset-auto.js";
 import { createProxy } from "./proxy.js";
+import { createOAuthHandler } from "./oauth.js";
 import { loadDocument } from "../utils/document/load.js";
 import { MethodLabel } from "../ui/components/method-label.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -113,6 +114,7 @@ function createOpenAPI(options = {}) {
 	return {
 		options,
 		createProxy,
+		createOAuthHandler,
 		_getWatchPaths() {
 			return Object.keys(resolvedInput).filter((key) => !URL.canParse(key) && fs.existsSync(key));
 		},

package/dist/server/oauth.d.ts

@@ -0,0 +1,6 @@
+//#region src/server/oauth.d.ts
+/**
+ * A route handler for the redirect URI of OAuth flows, it sends users back to the page that started the flow.
+ */
+export declare function createOAuthHandler(): (req: Request) => Response;
+//#endregion

package/dist/server/oauth.js

@@ -0,0 +1,17 @@
+//#region src/server/oauth.ts
+/**
+* A route handler for the redirect URI of OAuth flows, it sends users back to the page that started the flow.
+*/
+function createOAuthHandler() {
+	return (req) => {
+		const page = /(?:^|;\s*)fumadocs-openapi-oauth=([^;]+)/.exec(req.headers.get("cookie") ?? "");
+		const target = page && URL.parse(decodeURIComponent(page[1]), "http://localhost");
+		if (!target || target.origin !== "http://localhost") return new Response(null, { status: 400 });
+		return new Response(null, {
+			status: 302,
+			headers: { Location: target.pathname + new URL(req.url).search }
+		});
+	};
+}
+//#endregion
+export { createOAuthHandler };

package/dist/ui/playground/client.js

@@ -8,6 +8,7 @@ import { encodeRequestData } from "../../requests/media/encode.js";
 import { useExampleRequests, useOperation } from "../../operation.js";
 import { MethodLabel } from "../components/method-label.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../packages/shared-api/dist/components/select.js";
+import { Markdown } from "../components/markdown.js";
 import { cn } from "../../utils/cn.js";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../../packages/shared-api/dist/components/collapsible.js";
 import { DefaultResultDisplay } from "./components/result-display.js";
@@ -21,10 +22,10 @@ import { Fragment, createContext, use, useEffect, useMemo, useRef, useState } fr
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { StfProvider, useDataEngine, useFieldValue, useListener, useStf } from "@fumari/stf";
 import { stringifyFieldKey } from "@fumari/stf/lib/utils";
-import { useOnChange } from "fumadocs-core/utils/use-on-change";
 import { useTranslations } from "@fuma-translate/react";
 import { ChevronDown, LoaderCircle, PlusIcon } from "lucide-react";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
+import { useOnChange } from "fumadocs-core/utils/use-on-change";
 //#region src/ui/playground/client.tsx
 const OptionsContext = createContext({});
 function usePlaygroundOptions() {
@@ -185,37 +186,16 @@ function SecurityRequirements({ requirements, select, selected, children }) {
 	useOnChange(defaultOpen, () => {
 		if (defaultOpen) setOpen(true);
 	});
-	const items = requirements.map((requirement, i) => {
-		if (requirement.length === 1) {
-			const { id, scheme } = requirement[0];
-			return {
-				value: i,
-				label: /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("p", {
-					className: cn("font-mono font-medium", scheme.deprecated && "text-fd-muted-foreground line-through"),
-					children: id
-				}), /* @__PURE__ */ jsx("p", {
-					className: "text-fd-muted-foreground whitespace-pre-wrap",
-					children: scheme.description
-				})] })
-			};
-		}
-		return {
-			value: i,
-			label: /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("p", {
-				className: "inline-flex items-center gap-1 font-mono font-medium",
-				children: requirement.map((item, i) => /* @__PURE__ */ jsxs(Fragment, { children: [i > 0 && /* @__PURE__ */ jsx(PlusIcon, { className: "text-fd-muted-foreground size-3.5" }), /* @__PURE__ */ jsx("span", {
-					className: cn(item.scheme.deprecated && "text-fd-muted-foreground line-through"),
-					children: item.id
-				})] }, i))
-			}), /* @__PURE__ */ jsx("ul", {
-				className: "text-fd-muted-foreground whitespace-pre-wrap list-disc list-inside",
-				children: requirement.map((item, i) => /* @__PURE__ */ jsx("li", {
-					className: "empty:hidden",
-					children: item.scheme.description
-				}, i))
-			})] })
-		};
-	});
+	const items = requirements.map((requirement, i) => ({
+		value: i,
+		label: /* @__PURE__ */ jsx("span", {
+			className: "inline-flex items-center gap-1 font-mono font-medium",
+			children: requirement.map((item, i) => /* @__PURE__ */ jsxs(Fragment, { children: [i > 0 && /* @__PURE__ */ jsx(PlusIcon, { className: "text-fd-muted-foreground size-3.5" }), /* @__PURE__ */ jsx("span", {
+				className: cn(item.scheme.deprecated && "text-fd-muted-foreground line-through"),
+				children: item.id
+			})] }, i))
+		})
+	}));
 	return /* @__PURE__ */ jsxs(CollapsiblePanel, {
 		title: /* @__PURE__ */ jsxs(Fragment$1, { children: [t("Authorization"), isLoading && /* @__PURE__ */ jsxs("span", {
 			className: "border-s ps-2 inline-flex items-center gap-1.5 text-fd-muted-foreground text-xs font-mono",
@@ -236,14 +216,29 @@ function SecurityRequirements({ requirements, select, selected, children }) {
 					children: t("Failed to fetch token")
 				}), /* @__PURE__ */ jsx("p", { children: String(error) })]
 			}),
-			/* @__PURE__ */ jsxs(Select, {
-				items,
-				value: selected,
-				onValueChange: (v) => v !== null && select(v),
-				children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, {}) }), /* @__PURE__ */ jsx(SelectContent, { children: items.map(({ value, label }) => /* @__PURE__ */ jsx(SelectItem, {
-					value,
-					children: label
-				}, value)) })]
+			/* @__PURE__ */ jsxs("div", {
+				className: "overflow-hidden rounded-md border bg-fd-secondary focus-within:ring focus-within:ring-fd-ring",
+				children: [/* @__PURE__ */ jsxs(Select, {
+					items,
+					value: selected,
+					onValueChange: (v) => v !== null && select(v),
+					children: [/* @__PURE__ */ jsx(SelectTrigger, {
+						className: "rounded-t-md rounded-b-none border-0 bg-transparent focus:ring-0",
+						children: /* @__PURE__ */ jsx(SelectValue, {})
+					}), /* @__PURE__ */ jsx(SelectContent, { children: items.map(({ value, label }) => /* @__PURE__ */ jsx(SelectItem, {
+						value,
+						children: label
+					}, value)) })]
+				}), /* @__PURE__ */ jsx("div", {
+					className: "grid grid-cols-[auto_1fr] gap-2 border-t px-2 py-1.5 text-xs text-fd-muted-foreground empty:hidden",
+					children: requirements[selected]?.map(({ id, scheme }, _, arr) => {
+						if (!scheme.description) return;
+						return /* @__PURE__ */ jsxs(Fragment, { children: [arr.length > 1 && /* @__PURE__ */ jsx("span", {
+							className: "font-medium font-mono text-fd-primary",
+							children: id
+						}), /* @__PURE__ */ jsx(Markdown, { md: scheme.description })] }, id);
+					})
+				})]
 			}),
 			children
 		]

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

@@ -1,5 +1,6 @@
 import { useQuery } from "../../../packages/shared-api/dist/utils/use-query.js";
 import { requestOAuthToken, usePlaygroundAuth } from "../../../playground/auth.js";
+import { useServer } from "../../../utils/use-server.js";
 import { useOpenAPI } from "../../../utils/create-page.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../../packages/shared-api/dist/components/select.js";
 import { cn } from "../../../utils/cn.js";
@@ -17,24 +18,26 @@ function OAuthDialogContent(props) {
 	return /* @__PURE__ */ jsxs(DialogContent, { children: [/* @__PURE__ */ jsxs(DialogHeader, { children: [/* @__PURE__ */ jsx(DialogTitle, { children: t("Authorization") }), /* @__PURE__ */ jsx(DialogDescription, { children: t("Obtain the access token for API.") })] }), /* @__PURE__ */ jsx(Content, { ...props })] });
 }
 function Content({ schemeId, scopes, setToken, setOpen }) {
-	const { dereferenced, resolve } = useOpenAPI().doc;
+	const { doc, oauthRedirectUrl } = useOpenAPI();
+	const { dereferenced, resolve } = doc;
 	const schemes = dereferenced.components?.securitySchemes;
 	const tokenInfo = usePlaygroundAuth().store[schemeId];
+	const { resolveUrl } = useServer();
 	const scheme = resolve(schemes?.[schemeId]);
 	if (!scheme || scheme.type !== "oauth2") throw new Error("unexpected schemaId: must be type oauth2");
 	const [type, setType] = useState(() => {
 		return Object.keys(scheme.flows)[0];
 	});
-	const [clientAuth, setClientAuth] = useState("body");
+	const [clientAuth, setClientAuth] = useState(() => tokenInfo?.type === "authorization_code" ? tokenInfo.client_auth : "header");
 	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.")
+		},
+		body: {
+			name: t("Send client credentials in body"),
+			description: t("Include the client ID and secret in the token request body.")
 		}
 	};
 	const allFlows = useMemo(() => ({
@@ -78,7 +81,9 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 			...values,
 			schemeId,
 			scopes,
-			clientAuth
+			clientAuth,
+			serverUrl: resolveUrl(),
+			redirectUrl: oauthRedirectUrl
 		});
 		if (!token) return;
 		setToken(token);
@@ -143,7 +148,7 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 						autoComplete: "off",
 						disabled: isLoading,
 						defaultValue: defaultValues.clientId,
-						required: type !== "password" || clientAuth === "header"
+						required: type !== "password"
 					})
 				]
 			}),
@@ -166,78 +171,75 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 						autoComplete: "off",
 						disabled: isLoading,
 						defaultValue: defaultValues.clientSecret,
-						required: type !== "password" || clientAuth === "header"
+						required: type !== "password"
 					})
 				]
 			}),
-			type === "password" && /* @__PURE__ */ jsxs(Fragment$1, { children: [
-				/* @__PURE__ */ jsxs("fieldset", {
-					className: "flex flex-col gap-1.5",
-					children: [/* @__PURE__ */ jsx(Label, {
-						htmlFor: "client_auth",
-						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",
-						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",
-						children: t("Password")
-					}), /* @__PURE__ */ jsx(Input, {
-						id: "password",
-						name: "password",
-						placeholder: t("Enter value"),
-						type: "password",
-						autoComplete: "off",
+			(type === "authorizationCode" || type === "clientCredentials" || type === "password") && /* @__PURE__ */ jsxs("fieldset", {
+				className: "flex flex-col gap-1.5",
+				children: [/* @__PURE__ */ jsx(Label, {
+					htmlFor: "client_auth",
+					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,
-						defaultValue: defaultValues.password,
-						required: true
-					})]
-				})
-			] }),
+						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)) })]
+				})]
+			}),
+			type === "password" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("fieldset", {
+				className: "flex flex-col gap-1.5",
+				children: [/* @__PURE__ */ jsx(Label, {
+					htmlFor: "username",
+					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",
+					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/ui/playground/components/result-display.js

@@ -8,7 +8,7 @@ import { Fragment, useEffect, useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useTranslations } from "@fuma-translate/react";
 import { cva } from "class-variance-authority";
-import { ChevronDown, CircleX, SignpostIcon } from "lucide-react";
+import { ChevronDown, CircleX, DownloadIcon, SignpostIcon } from "lucide-react";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
 //#region src/ui/playground/components/result-display.tsx
 var import_fast_content_type_parse = require_fast_content_type_parse();
@@ -69,11 +69,17 @@ function getTextFormat(mime) {
 function ResponseResult({ data, reset, ...rest }) {
 	const t = useTranslations({ note: "playground result display" });
 	const statusInfo = useStatusInfo(data.status);
+	const [objectUrl, setObjectUrl] = useState();
 	const { parameters, type } = useMemo(() => (0, import_fast_content_type_parse.safeParse)(data.headers.get("Content-Type") ?? "text/plain"), [data.headers]);
+	useEffect(() => {
+		const objectUrl = URL.createObjectURL(new Blob([data.body], { type }));
+		setObjectUrl(objectUrl);
+		return () => URL.revokeObjectURL(objectUrl);
+	}, [data.body, type]);
 	let body;
-	if (type.startsWith("image/")) body = /* @__PURE__ */ jsx(ImageResult, {
+	if (type.startsWith("image/")) body = objectUrl && /* @__PURE__ */ jsx(ImageResult, {
 		mime: type,
-		buffer: data.body
+		src: objectUrl
 	});
 	else if (data.body.byteLength > 0) {
 		const lang = getTextFormat(type);
@@ -103,19 +109,28 @@ function ResponseResult({ data, reset, ...rest }) {
 				children: [
 					/* @__PURE__ */ jsx(statusInfo.icon, { className: cn("size-4 shrink-0", statusInfo.color) }),
 					/* @__PURE__ */ jsxs("p", {
-						className: "text-sm font-medium text-nowrap",
+						className: "min-w-0 me-auto text-sm font-medium truncate",
 						children: [
 							data.status,
 							" ",
 							statusInfo.description
 						]
 					}),
+					data.body.byteLength > 0 && /* @__PURE__ */ jsxs("a", {
+						href: objectUrl,
+						download: getFileName(data.headers),
+						className: cn(buttonVariants({
+							size: "sm",
+							variant: "outline"
+						}), "gap-2"),
+						children: [/* @__PURE__ */ jsx(DownloadIcon, { className: "size-3.5 text-fd-muted-foreground" }), t("Download")]
+					}),
 					/* @__PURE__ */ jsx("button", {
 						type: "button",
-						className: cn(buttonVariants({
+						className: buttonVariants({
 							size: "sm",
 							variant: "outline"
-						}), "ms-auto"),
+						}),
 						onClick: () => reset(),
 						children: t("Close")
 					})
@@ -184,26 +199,34 @@ function TextResult({ lang, charset, data, contentType }) {
 		}) }
 	});
 }
-function ImageResult({ mime, buffer }) {
-	const [objectUrl, setObjectUrl] = useState(null);
-	useEffect(() => {
-		const blob = new Blob([buffer], { type: mime });
-		const url = URL.createObjectURL(blob);
-		setObjectUrl(url);
-		return () => URL.revokeObjectURL(url);
-	}, [mime, buffer]);
-	if (!objectUrl) return;
+function ImageResult({ mime, src }) {
 	return /* @__PURE__ */ jsxs("figure", {
 		className: "w-full p-1 bg-fd-card border rounded-lg shadow-sm",
 		children: [/* @__PURE__ */ jsx("figcaption", {
 			className: "text-xs text-fd-muted-foreground font-mono p-1 pb-2",
 			children: mime
 		}), /* @__PURE__ */ jsx("img", {
-			src: objectUrl,
+			src,
 			alt: "",
 			className: "w-full rounded-md"
 		})]
 	});
 }
+/**
+* The file name from `Content-Disposition`, preferring `filename*` (RFC 6266), without directories.
+*/
+function getFileName(headers) {
+	const disposition = headers.get("Content-Disposition") ?? "";
+	const extended = /(?:^|;)\s*filename\*\s*=\s*[^']*'[^']*'([^\s;"]+)/i.exec(disposition);
+	let name;
+	if (extended) try {
+		name = decodeURIComponent(extended[1]);
+	} catch {}
+	if (!name) {
+		const match = /(?:^|;)\s*filename\s*=\s*(?:"((?:\\.|[^"\\])*)"|([^\s;]+))/i.exec(disposition);
+		name = match?.[1]?.replace(/\\(.)/g, "$1") ?? match?.[2];
+	}
+	return name?.replace(/^.*[/\\]/, "") || "response";
+}
 //#endregion
 export { DefaultResultDisplay };

package/dist/utils/create-page.d.ts

@@ -34,6 +34,8 @@ export interface OpenAPIRuntimeOptions {
    * @defaultValue `fumadocs-openapi-`
    */
   storageKeyPrefix?: string;
+  /** URL of the `createOAuthHandler()` route, the redirect URI of OAuth flows instead of the page */
+  oauthRedirectUrl?: string;
   /**
    * Generate example code usage for all endpoints.
    */

package/dist/utils/create-page.js

@@ -59,7 +59,7 @@ function useTypeScriptDefinitions(schema, options) {
 	]);
 	return result instanceof Promise ? use(result) : result;
 }
-function OpenAPIProvider({ document, mediaAdapters, codeUsages, generateCodeSamples, generateTypeScriptDefinitions, proxyUrl, storageKeyPrefix = "fumadocs-openapi-", shiki, shikiOptions = defaultShikiOptions, showResponseSchema, content, schemaUI, playground, components, children }) {
+function OpenAPIProvider({ document, mediaAdapters, codeUsages, generateCodeSamples, generateTypeScriptDefinitions, proxyUrl, storageKeyPrefix = "fumadocs-openapi-", oauthRedirectUrl, shiki, shikiOptions = defaultShikiOptions, showResponseSchema, content, schemaUI, playground, components, children }) {
 	const runtime = useMemo(() => ({
 		doc: dereferenceBundledDocument(document),
 		mediaAdapters: {
@@ -70,7 +70,8 @@ function OpenAPIProvider({ document, mediaAdapters, codeUsages, generateCodeSamp
 		generateCodeSamples,
 		generateTypeScriptDefinitions,
 		proxyUrl,
-		storageKeyPrefix
+		storageKeyPrefix,
+		oauthRedirectUrl
 	}), [
 		document,
 		mediaAdapters,
@@ -78,7 +79,8 @@ function OpenAPIProvider({ document, mediaAdapters, codeUsages, generateCodeSamp
 		generateCodeSamples,
 		generateTypeScriptDefinitions,
 		proxyUrl,
-		storageKeyPrefix
+		storageKeyPrefix,
+		oauthRedirectUrl
 	]);
 	const render = useMemo(() => ({
 		shiki,

package/dist/utils/get-example-requests.js

@@ -1,4 +1,4 @@
-import { getPreferredType, pickExample } from "./schema.js";
+import { getExampleValue, getPreferredType, pickExample } from "./schema.js";
 import { encodeRequestData } from "../requests/media/encode.js";
 import { getRaw } from "@scalar/json-magic/magic-proxy";
 import { dereference, sample } from "@fumadocs/json-schema";
@@ -80,7 +80,7 @@ function getRequestData({ method, path, parameters, sampleKey, body }) {
 		if (!type) throw new Error(`Cannot find body schema for ${path} ${method}: missing media type`);
 		result.bodyMediaType = type;
 		const bodyOfType = dereference(body.content[type]);
-		if (bodyOfType.examples && sampleKey) result.body = getRaw(dereference(bodyOfType.examples[sampleKey]).value);
+		if (bodyOfType.examples && sampleKey) result.body = getExampleValue(dereference(bodyOfType.examples[sampleKey]));
 		else if (bodyOfType.example) result.body = getRaw(bodyOfType.example);
 		else result.body = sample(bodyOfType?.schema ?? {}, {
 			skipReadOnly: method !== "get",

package/dist/utils/schema.js

@@ -26,14 +26,18 @@ function pickExample(value) {
 		const content = type ? dereference(value.content[type]) : void 0;
 		if (type && content) {
 			const example = value.examples?.[type];
-			const out = (example !== void 0 ? getRaw(dereference(example).value) : void 0) ?? pickExample(content);
+			const out = (example !== void 0 ? getExampleValue(dereference(example)) : void 0) ?? pickExample(content);
 			if (out !== void 0) return out;
 		}
 	}
 	if (value.examples) {
 		const examples = Object.values(value.examples);
-		if (examples.length > 0) return getRaw(dereference(examples[0]).value);
+		if (examples.length > 0) return getExampleValue(dereference(examples[0]));
 	}
 }
+/** the value of an Example Object, `dataValue` since OpenAPI 3.2 */
+function getExampleValue(example) {
+	return getRaw(example.dataValue ?? example.value);
+}
 //#endregion
-export { getPreferredType, getTagDisplayName, methodKeys, pickExample };
+export { getExampleValue, getPreferredType, getTagDisplayName, methodKeys, pickExample };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "12.0.4",
+  "version": "12.1.1",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -78,8 +78,8 @@
     "@types/react-dom": "^19.3.0",
     "fast-content-type-parse": "^4.0.0",
     "fuma-cli": "^0.3.1",
-    "fumadocs-core": "16.15.15",
-    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.15",
+    "fumadocs-core": "16.15.18",
+    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.18",
     "json-schema-typed": "^8.0.2",
     "shared-api": "0.2.10",
     "tsconfig": "0.0.0",