fumadocs-openapi 12.1.0 → 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 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 blob 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 buffer 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 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 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 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 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 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 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 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 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 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 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 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");
+@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/playground/auth.d.ts

@@ -11,7 +11,10 @@ export interface OAuthFlowInput {
   clientSecret: string;
   username: string;
   password: string;
-  /** where the password and client credentials flows send 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;
@@ -31,17 +34,20 @@ type TokenInfo = {
   type: 'authorization_code';
   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,11 +1,10 @@
 "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";
 /**
@@ -25,6 +24,7 @@ async function requestOAuthToken(scheme, type, { schemeId, scopes, clientId, cli
 			scheme: schemeId,
 			client_id: clientId,
 			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
 		};
@@ -42,27 +42,28 @@ async function requestOAuthToken(scheme, type, { schemeId, scopes, clientId, cli
 	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);
 	} else body.set("grant_type", "client_credentials");
-	if (clientAuth === "header") headers.Authorization = `Basic ${btoa(`${encodeURIComponent(clientId)}:${encodeURIComponent(clientSecret)}`)}`;
+	return fetchToken(new URL(flow.tokenUrl, serverUrl).href, body, {
+		client_id: clientId,
+		client_secret: clientSecret,
+		client_auth: clientAuth
+	});
+}
+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 (clientId) body.set("client_id", clientId);
-		if (clientSecret) body.set("client_secret", clientSecret);
+		if (client_id) body.set("client_id", client_id);
+		if (client_secret) body.set("client_secret", client_secret);
 	}
-	return fetchToken(new URL(flow.tokenUrl, serverUrl).href, body, headers);
-}
-async function fetchToken(tokenUrl, body, headers = {}) {
 	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());
@@ -77,23 +78,33 @@ function usePlaygroundAuth() {
 }
 function AuthProvider({ children }) {
 	const [store, setStore] = useState({});
+	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,
+			[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,
+			redirect_uri: flow.redirect_uri
+		}), flow);
+		save(flow.scheme, {
+			type: "authorization_code",
 			client_id: flow.client_id,
-			client_secret: flow.client_secret
-		}));
-		setStore((s) => ({
-			...s,
-			[flow.scheme]: {
-				type: "authorization_code",
-				client_id: flow.client_id,
-				client_secret: flow.client_secret,
-				token
-			}
-		}));
+			client_secret: flow.client_secret,
+			client_auth: flow.client_auth,
+			token
+		});
 	});
 	useEffect(() => {
 		const stored = sessionStorage.getItem(pendingFlowKey);
@@ -104,14 +115,11 @@ function AuthProvider({ children }) {
 		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) setStore((s) => ({
-			...s,
-			[flow.scheme]: {
-				type: "implicit",
-				client_id: flow.client_id,
-				token: `${hash.get("token_type") ?? "Bearer"} ${token}`
-			}
-		}));
+		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);
@@ -119,13 +127,14 @@ function AuthProvider({ children }) {
 	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
 	});
@@ -134,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;
@@ -215,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/ui/playground/client.js

@@ -22,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() {

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

@@ -28,16 +28,16 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 	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(() => ({
@@ -148,7 +148,7 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 						autoComplete: "off",
 						disabled: isLoading,
 						defaultValue: defaultValues.clientId,
-						required: type !== "password" || clientAuth === "header"
+						required: type !== "password"
 					})
 				]
 			}),
@@ -171,11 +171,11 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 						autoComplete: "off",
 						disabled: isLoading,
 						defaultValue: defaultValues.clientSecret,
-						required: type !== "password" || clientAuth === "header"
+						required: type !== "password"
 					})
 				]
 			}),
-			(type === "clientCredentials" || type === "password") && /* @__PURE__ */ jsxs("fieldset", {
+			(type === "authorizationCode" || type === "clientCredentials" || type === "password") && /* @__PURE__ */ jsxs("fieldset", {
 				className: "flex flex-col gap-1.5",
 				children: [/* @__PURE__ */ jsx(Label, {
 					htmlFor: "client_auth",

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "12.1.0",
+  "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.16",
-    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.16",
+    "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",