fumadocs-openapi 11.1.0 → 11.2.0

package/css/generated/shared.css

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

package/dist/generate-file.d.ts

@@ -3,7 +3,6 @@ import { SchemaToPagesOptions } from "./utils/pages/preset-auto.js";
 import { OpenAPIServer } from "./server/index.js";
 import { DistributiveOmit } from "./types.js";
 import { PagesToTextOptions } from "./utils/pages/to-text.js";
-
 //#region src/generate-file.d.ts
 interface OutputFile {
   path: string;

package/dist/i18n.d.ts

@@ -2,7 +2,6 @@ import { Translations } from "./.translations/index.js";
 import { Translations as Translations$1 } from "@fumadocs/api-docs/i18n";
 import { TranslationExtension } from "fumadocs-core/i18n";
 import { I18nUIConfig } from "fumadocs-ui/i18n";
-
 //#region src/i18n.d.ts
 declare function openapiTranslations(): TranslationExtension<keyof Translations | keyof Translations$1>;
 /** @deprecated use `i18n.translations()` & `openapiTranslations()` instead */

package/dist/node_modules/.pnpm/xml-js@1.6.11/node_modules/xml-js/lib/js2xml.js

@@ -5,7 +5,8 @@ import { require_options_helper } from "./options-helper.js";
 var require_js2xml = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	var helper = require_options_helper();
 	var isArray = require_array_helper().isArray;
-	var currentElement, currentElementName;
+	var currentElement;
+	var currentElementName;
 	function validateOptions(userOptions) {
 		var options = helper.copyOptions(userOptions);
 		helper.ensureFlagExists("ignoreDeclaration", options);

package/dist/playground/auth.js

@@ -11,10 +11,11 @@ function useAuth() {
 	return ctx;
 }
 function AuthProvider({ children }) {
-	const schemes = useRenderContext().schema.dereferenced.components?.securitySchemes;
+	const { dereferenced, resolve } = useRenderContext().schema;
+	const schemes = dereferenced.components?.securitySchemes;
 	const [store, setStore] = useState({});
 	const authCodeQuery = useQuery(async (code, state) => {
-		const scheme = schemes?.[state.scheme];
+		const scheme = resolve(schemes?.[state.scheme]);
 		if (!scheme || scheme.type !== "oauth2") return;
 		const value = scheme.flows?.authorizationCode;
 		if (!value) return;
@@ -58,7 +59,7 @@ function AuthProvider({ children }) {
 			const type = hash.get("token_type") ?? "Bearer";
 			if (!state || !token) return;
 			const parsedState = JSON.parse(state);
-			const scheme = schemes?.[parsedState.scheme];
+			const scheme = resolve(schemes?.[parsedState.scheme]);
 			if (!scheme || scheme.type !== "oauth2" || !scheme.flows?.implicit) return;
 			const info = {
 				type: "implicit",

package/dist/playground/client.d.ts

@@ -5,8 +5,6 @@ import { HttpMethods, OperationObject, ParameterObject, PathItemObject } from ".
 import { ComponentProps, FC, ReactNode } from "react";
 import { Collapsible } from "@fumadocs/api-docs/components/collapsible";
 import { FieldKey } from "@fumari/stf";
-import { NoReference } from "@fumadocs/api-docs/schema";
-
 //#region src/playground/client.d.ts
 interface FormValues extends Record<string, unknown> {
   path: Record<string, unknown>;
@@ -18,8 +16,8 @@ interface FormValues extends Record<string, unknown> {
 interface PlaygroundClientProps extends Omit<ComponentProps<'form'>, 'method'> {
   route: string;
   method: HttpMethods;
-  operation: NoReference<OperationObject>;
-  pathItem: NoReference<PathItemObject>;
+  operation: OperationObject;
+  pathItem: PathItemObject;
   writeOnly: boolean;
   readOnly: boolean;
 }
@@ -57,15 +55,7 @@ interface RequestBodyInfo {
   schema: ParsedSchema;
   mediaType: string;
 }
-declare function PlaygroundClient({
-  route,
-  method,
-  operation,
-  pathItem,
-  writeOnly,
-  readOnly,
-  ...rest
-}: PlaygroundClientProps): import("react").JSX.Element;
+declare function PlaygroundClient({ route, method, operation, pathItem, writeOnly, readOnly, ...rest }: PlaygroundClientProps): import("react").JSX.Element;
 declare const ParamTypes: readonly ["path", "header", "cookie", "query"];
 type ParamType = (typeof ParamTypes)[number];
 interface AuthField {
@@ -76,11 +66,7 @@ interface AuthField {
   children: ReactNode;
   mapOutput?: (values: unknown) => unknown;
 }
-declare function DefaultCollapsiblePanel({
-  title,
-  children,
-  ...props
-}: CollapsiblePanelProps): import("react").JSX.Element;
+declare function DefaultCollapsiblePanel({ title, children, ...props }: CollapsiblePanelProps): import("react").JSX.Element;
 declare const Custom: {
   useController(fieldName: FieldKey, options?: {
     defaultValue?: unknown;

package/dist/playground/client.js

@@ -15,7 +15,7 @@ import { OAuthDialog, OAuthDialogContent, OAuthDialogTrigger } from "./component
 import { dereferenceShallow } from "@fumadocs/api-docs/schema/dereference";
 import { Fragment, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
-import { ChevronDown, LoaderCircle } from "lucide-react";
+import { ChevronDown, LoaderCircle, PlusIcon } from "lucide-react";
 import { useTranslations } from "@fuma-translate/react";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@fumadocs/api-docs/components/collapsible";
@@ -32,29 +32,25 @@ import { Spinner } from "@fumadocs/api-docs/components/spinner";
 function PlaygroundClient({ route, method, operation, pathItem, writeOnly, readOnly, ...rest }) {
 	const t = useTranslations({ note: "playground" });
 	const ctx = useRenderContext();
-	const { bundled, dereferenced } = ctx.schema;
+	const { dereferenced } = ctx.schema;
 	const { parameters, body } = useMemo(() => {
 		const parameters = [];
-		if (operation.parameters) for (const p of operation.parameters) parameters.push(dereferenceShallow(p, bundled));
-		if (pathItem.parameters) for (const p of pathItem.parameters) parameters.push(dereferenceShallow(p, bundled));
+		if (operation.parameters) for (const p of operation.parameters) parameters.push(dereferenceShallow(p));
+		if (pathItem.parameters) for (const p of pathItem.parameters) parameters.push(dereferenceShallow(p));
 		let body;
 		if (operation.requestBody) {
-			const content = dereferenceShallow(operation.requestBody, bundled).content;
+			const content = dereferenceShallow(operation.requestBody).content;
 			const mediaType = content ? getPreferredType(content) : void 0;
 			if (content && mediaType) body = {
 				mediaType,
-				schema: dereferenceShallow(content[mediaType], bundled).schema ?? true
+				schema: dereferenceShallow(content[mediaType]).schema ?? true
 			};
 		}
 		return {
 			body,
 			parameters
 		};
-	}, [
-		bundled,
-		operation,
-		pathItem
-	]);
+	}, [operation, pathItem]);
 	const securityEntries = useMemo(() => {
 		const result = [];
 		const security = operation.security ?? dereferenced.security ?? [];
@@ -130,7 +126,7 @@ function PlaygroundClient({ route, method, operation, pathItem, writeOnly, readO
 	return /* @__PURE__ */ jsx(StfProvider, {
 		value: stf,
 		children: /* @__PURE__ */ jsx(SchemaProvider, {
-			docRoot: bundled,
+			docRoot: dereferenced,
 			writeOnly,
 			readOnly,
 			children: /* @__PURE__ */ jsxs("form", {
@@ -187,10 +183,42 @@ function SecurityRequirements({ securities, setSecurityId, securityId, children
 	const { isLoading, error } = useAuth();
 	const defaultOpen = isLoading || error != null;
 	const [open, setOpen] = useState(defaultOpen);
-	const { CollapsiblePanel = DefaultCollapsiblePanel } = useRenderContext().playground?.components ?? {};
+	const { schema: { dereferenced, resolve }, playground: { components: { CollapsiblePanel = DefaultCollapsiblePanel } = {} } = {} } = useRenderContext();
+	const schemes = dereferenced.components?.securitySchemes;
 	useOnChange(defaultOpen, () => {
 		if (defaultOpen) setOpen(true);
 	});
+	const items = securities.map((requirement, i) => {
+		if (requirement.length === 1) {
+			const scheme = resolve(schemes?.[requirement[0].id]);
+			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: requirement[0].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(resolve(schemes?.[item.id])?.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: resolve(schemes?.[item.id])?.description
+				}, 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",
@@ -212,38 +240,18 @@ function SecurityRequirements({ securities, setSecurityId, securityId, children
 				}), /* @__PURE__ */ jsx("p", { children: String(error) })]
 			}),
 			/* @__PURE__ */ jsxs(Select, {
-				items: securities.map((security, i) => ({
-					value: i.toString(),
-					label: /* @__PURE__ */ jsx(SecurityRequirement, { requirement: security })
-				})),
-				value: securityId.toString(),
-				onValueChange: (v) => setSecurityId(Number(v)),
-				children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, {}) }), /* @__PURE__ */ jsx(SelectContent, { children: securities.map((security, i) => /* @__PURE__ */ jsx(SelectItem, {
-					value: i.toString(),
-					children: /* @__PURE__ */ jsx(SecurityRequirement, { requirement: security })
-				}, i)) })]
+				items,
+				value: securityId,
+				onValueChange: (v) => v !== null && setSecurityId(v),
+				children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, {}) }), /* @__PURE__ */ jsx(SelectContent, { children: items.map(({ value, label }) => /* @__PURE__ */ jsx(SelectItem, {
+					value,
+					children: label
+				}, value)) })]
 			}),
 			children
 		]
 	});
 }
-function SecurityRequirement({ requirement }) {
-	const schemes = useRenderContext().schema.dereferenced.components?.securitySchemes;
-	return /* @__PURE__ */ jsx("div", {
-		className: "flex flex-col gap-2 max-w-[600px]",
-		children: requirement.map((item) => {
-			const scheme = schemes?.[item.id];
-			if (!scheme) return;
-			return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("p", {
-				className: cn("font-mono font-medium", scheme.deprecated && "text-fd-muted-foreground line-through"),
-				children: item.id
-			}), /* @__PURE__ */ jsx("p", {
-				className: "text-fd-muted-foreground whitespace-pre-wrap",
-				children: scheme.description
-			})] }, item.id);
-		})
-	});
-}
 const ParamTypes = [
 	"path",
 	"header",
@@ -328,18 +336,19 @@ function useAuthInputs(engine, requirements) {
 	const storageKeys = useStorageKey();
 	const t = useTranslations({ note: "playground" });
 	const ctx = useRenderContext();
+	const { resolve } = ctx.schema;
 	const schemes = ctx.schema.dereferenced.components?.securitySchemes;
 	const { transformAuthInputs } = ctx.playground ?? {};
 	const [requirementId, setRequirementId] = useState(() => {
 		if (!schemes || requirements.length === 0) return -1;
-		const idx = requirements.findIndex((s) => s.every((item) => !schemes[item.id].deprecated));
+		const idx = requirements.findIndex((s) => s.every((item) => !resolve(schemes[item.id]).deprecated));
 		return idx !== -1 ? idx : 0;
 	});
 	const requirement = requirementId === -1 ? null : requirements[requirementId];
 	let inputs = useMemo(() => {
 		if (!requirement || !schemes) return [];
 		return requirement.map((item) => {
-			const scheme = schemes?.[item.id];
+			const scheme = resolve(schemes?.[item.id]);
 			if (scheme.type === "http" && scheme.scheme === "basic") {
 				const fieldName = ["header", "Authorization"];
 				return {
@@ -430,6 +439,7 @@ function useAuthInputs(engine, requirements) {
 		requirement,
 		storageKeys,
 		schemes,
+		resolve,
 		t
 	]);
 	if (transformAuthInputs) inputs = transformAuthInputs(inputs);

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

@@ -16,9 +16,10 @@ 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 schemes = useRenderContext().schema.dereferenced.components?.securitySchemes;
+	const { dereferenced, resolve } = useRenderContext().schema;
+	const schemes = dereferenced.components?.securitySchemes;
 	const tokenInfo = useAuth().store[schemeId];
-	const scheme = schemes?.[schemeId];
+	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];

package/dist/playground/components/result-display.d.ts

@@ -1,15 +1,10 @@
 import { FetchResult } from "../fetcher.js";
 import { ComponentProps } from "react";
-
 //#region src/playground/components/result-display.d.ts
 interface ResultDisplayProps extends ComponentProps<'div'> {
   data: FetchResult;
   reset: () => void;
 }
-declare function DefaultResultDisplay({
-  data,
-  reset,
-  ...rest
-}: ResultDisplayProps): import("react").JSX.Element;
+declare function DefaultResultDisplay({ data, reset, ...rest }: ResultDisplayProps): import("react").JSX.Element;
 //#endregion
 export { DefaultResultDisplay, ResultDisplayProps };

package/dist/playground/components/server-select.js

@@ -41,6 +41,13 @@ function ServerSelect(props) {
 		}), /* @__PURE__ */ jsxs(DialogContent, { children: [
 			/* @__PURE__ */ jsxs(DialogHeader, { children: [/* @__PURE__ */ jsx(DialogTitle, { children: t("Server URL") }), /* @__PURE__ */ jsx(DialogDescription, { children: t("The base URL of your API endpoint.") })] }),
 			/* @__PURE__ */ jsxs(Select, {
+				items: servers.map((server) => ({
+					value: server.url,
+					label: /* @__PURE__ */ jsx("code", {
+						className: "text-[0.8125rem]",
+						children: server.url
+					})
+				})),
 				value: server?.url ?? null,
 				onValueChange: (v) => v !== null && setServer(v),
 				children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, {}) }), /* @__PURE__ */ jsx(SelectContent, { children: servers.map((item) => /* @__PURE__ */ jsxs(SelectItem, {
@@ -111,7 +118,7 @@ function Field({ fieldName, variable }) {
 			id: fieldName,
 			children: /* @__PURE__ */ jsx(SelectValue, {})
 		}), /* @__PURE__ */ jsx(SelectContent, { children: variable.enum.map((value) => /* @__PURE__ */ jsx(SelectItem, {
-			value: String(value),
+			value,
 			children: value
 		}, value)) })]
 	});

package/dist/playground/fetcher.d.ts

@@ -1,5 +1,5 @@
+import "../requests/types.js";
 import { Awaitable } from "../types.js";
-
 //#region src/playground/fetcher.d.ts
 type FetchResult = FetchResponseResult | FetchErrorResult;
 interface FetchErrorResult {

package/dist/requests/generators/all.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGeneratorRegistry } from "./index.js";
-
 //#region src/requests/generators/all.d.ts
 declare function registerDefault(registry: CodeUsageGeneratorRegistry): CodeUsageGeneratorRegistry;
 //#endregion

package/dist/requests/generators/csharp.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGenerator } from "./index.js";
-
 //#region src/requests/generators/csharp.d.ts
 declare const csharp: CodeUsageGenerator;
 //#endregion

package/dist/requests/generators/curl.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGenerator } from "./index.js";
-
 //#region src/requests/generators/curl.d.ts
 declare const curl: CodeUsageGenerator;
 //#endregion

package/dist/requests/generators/go.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGenerator } from "./index.js";
-
 //#region src/requests/generators/go.d.ts
 declare const go: CodeUsageGenerator;
 //#endregion

package/dist/requests/generators/index.d.ts

@@ -1,12 +1,8 @@
 import { MediaAdapter } from "../media/adapter.js";
 import { RequestData } from "../types.js";
 import * as Shared from "@fumadocs/api-docs/codegen";
-
 //#region src/requests/generators/index.d.ts
-declare function pathnameFromRequest(pathname: string, {
-  path,
-  query
-}: RequestData): string;
+declare function pathnameFromRequest(pathname: string, { path, query }: RequestData): string;
 type CodeUsageGeneratorRegistry = Shared.CodeUsageGeneratorRegistry<RequestData & {
   url: string;
 }, {

package/dist/requests/generators/java.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGenerator } from "./index.js";
-
 //#region src/requests/generators/java.d.ts
 declare const java: CodeUsageGenerator;
 //#endregion

package/dist/requests/generators/javascript.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGenerator } from "./index.js";
-
 //#region src/requests/generators/javascript.d.ts
 declare const javascript: CodeUsageGenerator;
 //#endregion

package/dist/requests/generators/python.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGenerator } from "./index.js";
-
 //#region src/requests/generators/python.d.ts
 declare const python: CodeUsageGenerator;
 declare function generatePythonObject(v: unknown, imports: Set<string>): string;

package/dist/requests/generators/rust.d.ts

@@ -1,5 +1,4 @@
 import { CodeUsageGenerator } from "./index.js";
-
 //#region src/requests/generators/rust.d.ts
 declare const rust: CodeUsageGenerator;
 //#endregion

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

@@ -1,3 +1,5 @@
+import "../types.js";
+import "../../types.js";
 //#region src/requests/media/encode.d.ts
 interface EncodedParameter {
   readonly value: string;

package/dist/requests/types.d.ts

@@ -1,6 +1,5 @@
 import { EncodedParameter, EncodedParameterMultiple } from "./media/encode.js";
 import { HttpMethods } from "../types.js";
-
 //#region src/requests/types.d.ts
 interface RawRequestData {
   method: HttpMethods;

package/dist/scalar/index.d.ts

@@ -1,5 +1,4 @@
 import { CreateOpenAPIPageOptions } from "../ui/index.js";
-
 //#region src/scalar/index.d.ts
 /**
  * Enable Scalar for API playgrounds by wrapping your options inside.

package/dist/server/index.d.ts

@@ -5,7 +5,6 @@ import { Awaitable, Document } from "../types.js";
 import { DynamicSource, LoaderPlugin, MetaData, Page, PageData, Source } from "fumadocs-core/source";
 import { StructuredData } from "fumadocs-core/mdx-plugins/remark-structure";
 import { TOCItemType } from "fumadocs-core/toc";
-
 //#region src/server/index.d.ts
 /**
  * schema ID -> file path, URL, downloaded schema object, or a function returning them
@@ -70,7 +69,8 @@ interface OpenAPIPageData extends PageData {
   getClientAPIPageProps: () => OpenAPIPageProps_Spec;
 }
 type OpenAPISourceOptions = SchemaToPagesOptions & {
-  baseDir?: string; /** Generate `meta.json` files */
+  baseDir?: string;
+  /** Generate `meta.json` files */
   meta?: boolean | {
     folderStyle?: 'folder' | 'separator';
   };

package/dist/types/openapi.d.ts

@@ -42,7 +42,7 @@ declare namespace OpenAPIV3_2 {
   }>;
   type PathsObject<T = {}, P extends {} = {}> = Record<string, (PathItemObject<T> & P) | undefined>;
   type HttpMethods = OpenAPIV3_1.HttpMethods | 'query';
-  type PathItemObject<T = {}> = Modify<OpenAPIV3_1.PathItemObject<T>, { [method in HttpMethods]?: OperationObject<T> }> & {
+  type PathItemObject<T = {}> = Modify<OpenAPIV3_1.PathItemObject<T>, { [method in HttpMethods]?: OperationObject<T>; }> & {
     additionalOperations?: Record<string, OperationObject<T>>;
     parameters?: (ReferenceObject | ParameterObject)[];
   };
@@ -220,7 +220,7 @@ declare namespace OpenAPIV3_1 {
   type PathItemObject<T = {}> = Modify<OpenAPIV3.PathItemObject<T>, {
     servers?: ServerObject[];
     parameters?: (ReferenceObject | ParameterObject)[];
-  }> & { [method in HttpMethods]?: OperationObject<T> };
+  }> & { [method in HttpMethods]?: OperationObject<T>; };
   type OperationObject<T = {}> = Modify<OpenAPIV3.OperationObject<T>, {
     parameters?: (ReferenceObject | ParameterObject)[];
     requestBody?: ReferenceObject | RequestBodyObject;
@@ -392,7 +392,7 @@ declare namespace OpenAPIV3 {
     description?: string;
     servers?: ServerObject[];
     parameters?: (ReferenceObject | ParameterObject)[];
-  } & { [method in HttpMethods]?: OperationObject<T> } & T;
+  } & { [method in HttpMethods]?: OperationObject<T>; } & T;
   type OperationObject<T = {}> = {
     tags?: string[];
     summary?: string;
@@ -768,7 +768,7 @@ declare namespace OpenAPIV2 {
   type PathItemObject<T = {}> = {
     $ref?: string;
     parameters?: Parameters;
-  } & { [method in HttpMethods]?: OperationObject<T> };
+  } & { [method in HttpMethods]?: OperationObject<T>; };
   type PathsObject<T = {}> = {
     [index: string]: PathItemObject<T>;
   };

package/dist/types.d.ts

@@ -5,7 +5,6 @@ import { CreateOpenAPIPageOptions } from "./ui/index.js";
 import { OpenAPIOptions } from "./server/index.js";
 import { FC, ReactNode } from "react";
 import { SchemaUIOptions } from "@fumadocs/api-docs/components/schema";
-
 //#region src/types.d.ts
 type Document = OpenAPIV3_2.Document;
 type OperationObject = OpenAPIV3_2.OperationObject & {

package/dist/ui/base.d.ts

@@ -1,19 +1,11 @@
 import { CreateOpenAPIPageOptions, OpenAPIPageProps } from "./index.js";
 import { FC } from "react";
 import { ShikiFactory } from "fumadocs-core/highlight/shiki";
-
 //#region src/ui/base.d.ts
 /**
  * Create `<OpenAPIPage />` (a client component) without the full Shiki bundle.
  */
-declare function createOpenAPIPageBase({
-  shiki,
-  shikiOptions,
-  schemaUI: schemaUIOptions,
-  codeUsages,
-  generateTypeScriptDefinitions,
-  ...options
-}: CreateOpenAPIPageOptions & {
+declare function createOpenAPIPageBase({ shiki, shikiOptions, schemaUI: schemaUIOptions, codeUsages, generateTypeScriptDefinitions, ...options }: CreateOpenAPIPageOptions & {
   shiki: ShikiFactory;
 }): FC<OpenAPIPageProps>;
 //#endregion

package/dist/ui/base.js

@@ -8,6 +8,7 @@ import { Markdown } from "./components/markdown.js";
 import { Operation } from "./operation/index.js";
 import { dereferenceBundledDocument } from "../utils/document/dereference.js";
 import { registerDefault } from "../requests/generators/all.js";
+import { getRaw } from "@scalar/json-magic/magic-proxy";
 import { Children, useMemo } from "react";
 import * as JsxRuntime from "react/jsx-runtime";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -16,7 +17,7 @@ import defaultMdxComponents from "fumadocs-ui/mdx";
 import { remark } from "remark";
 import remarkRehype from "remark-rehype";
 import { toJsxRuntime } from "hast-util-to-jsx-runtime";
-import { compile } from "@fumari/json-schema-ts";
+import { generate } from "@fumari/json-schema-ts";
 import { Schema } from "@fumadocs/api-docs/components/schema";
 //#region src/ui/base.tsx
 /**
@@ -28,11 +29,13 @@ function createOpenAPIPageBase({ shiki, shikiOptions = { themes: {
 } }, schemaUI: schemaUIOptions, codeUsages = registerDefault(createCodeUsageGeneratorRegistry()), generateTypeScriptDefinitions = (schema, ctx) => {
 	if (typeof schema !== "object") return;
 	try {
-		return compile(schema, {
+		return generate({
+			...ctx.ctx.schema.bundled,
+			...getRaw(schema)
+		}, {
 			name: ctx.name,
 			readOnly: ctx.readOnly,
-			writeOnly: ctx.writeOnly,
-			getSchemaId: ctx.ctx.schema.getRawRef
+			writeOnly: ctx.writeOnly
 		});
 	} catch (e) {
 		console.warn("Failed to generate typescript schema:", e);
@@ -76,12 +79,6 @@ function createOpenAPIPageBase({ shiki, shikiOptions = { themes: {
 				},
 				renderMarkdown(md) {
 					return /* @__PURE__ */ jsx(Markdown, { md });
-				},
-				resolver(v) {
-					return {
-						dereferenced: v,
-						$ref: typeof v === "object" ? processed.getRawRef(v) : void 0
-					};
 				}
 			};
 			return {
@@ -118,7 +115,7 @@ function createOpenAPIPageBase({ shiki, shikiOptions = { themes: {
 }
 function PageContent({ showTitle: hasHead = false, showDescription, operations, webhooks }) {
 	const ctx = useRenderContext();
-	const { dereferenced } = ctx.schema;
+	const { dereferenced, resolve } = ctx.schema;
 	let { renderPageLayout } = ctx.content ?? {};
 	renderPageLayout ??= (slots) => /* @__PURE__ */ jsxs("div", {
 		className: "flex flex-col gap-24 text-sm @container",
@@ -126,7 +123,7 @@ function PageContent({ showTitle: hasHead = false, showDescription, operations,
 	});
 	let content = renderPageLayout({
 		operations: operations?.map((item) => {
-			const pathItem = dereferenced.paths?.[item.path];
+			const pathItem = resolve(dereferenced.paths?.[item.path]);
 			if (!pathItem) throw new Error(`[Fumadocs OpenAPI] Path not found in OpenAPI schema: ${item.path}`);
 			const operation = pathItem[item.method];
 			if (!operation) throw new Error(`[Fumadocs OpenAPI] Method ${item.method} not found in operation: ${item.path}`);
@@ -143,7 +140,7 @@ function PageContent({ showTitle: hasHead = false, showDescription, operations,
 			};
 		}),
 		webhooks: webhooks?.map((item) => {
-			const webhook = dereferenced.webhooks?.[item.name];
+			const webhook = resolve(dereferenced.webhooks?.[item.name]);
 			if (!webhook) throw new Error(`[Fumadocs OpenAPI] Webhook not found in OpenAPI schema: ${item.name}`);
 			const hook = webhook[item.method];
 			if (!hook) throw new Error(`[Fumadocs OpenAPI] Method ${item.method} not found in webhook: ${item.name}`);

package/dist/ui/create-client.d.ts

@@ -1,5 +1,4 @@
 import { CreateOpenAPIPageOptions, OpenAPIPageProps, createOpenAPIPage } from "./index.js";
-
 //#region src/ui/create-client.d.ts
 /** @deprecated Use `CreateOpenAPIPageOptions` insteawd */
 type CreateClientAPIPageOptions = CreateOpenAPIPageOptions;