fumadocs-openapi 11.2.3 → 11.3.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 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 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 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 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 cachedDocFiles call callback callbacks callbacksNode can cannot case catch changes charset check children class-variance-authority className client clientCredentials clientId clientSecret client_credentials client_error client_id client_secret cloned cn code codeProps codeUsages codegen codegens collapsible color com compatibility compiler component components conditions configuration const content contentTypes context cookie cookies core could createClientAPIPage createCodeUsageGeneratorRegistry createContext createOpenAPIPageBase createProxy credentials css csv ctx current currentValue custom customization cva dark dark:text-blue-400 dark:text-green-400 dark:text-orange-400 dark:text-red-400 dark:text-yellow-400 data data-[open]:border-b-0 data-type default defaultAdapters defaultExampleId defaultItem defaultMdxComponents defaultOpen defaultShikiFactory defaultValue defaultValues default_processMarkdown definitions deprecated depth dereferenceBundledDocument dereferenceShallow dereferenced description descriptionNode development deviceAuthorization dialog didn disable disableCache disabled display displayNames div do doc docCache docFilesCache docRoot docs document documents domain downloaded dynamicSource e each else empty:hidden enabled encodeRequestData encoded endpoint enforce engine ensure entire entries entry error eslint-disable eslint-disable-next-line example exampleId exampleRequests examples export exported extends fallback false fast-content-type-parse fd-page-tree-item-name fetch fetcher field fieldName fields file filePath files fine first first:border-t-0 flex flex-1 flex-col flex-col-reverse flex-row flex-wrap flow flows folder folderStyle font-medium font-mono font-semibold for form formData format found from fs full fumadocs-core/source fumadocs-core/toc fumadocs-openapi/ui fumadocs-ui/mdx fumadocs:openapi fumadocs_openapi_requests fumadocs_openapi_responses function gap-0.5 gap-1 gap-1.5 gap-2 gap-2.5 gap-24 gap-3 gap-4 gap-6 gap-x-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 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 schemaUI schemaUIShared scheme schemeId schemes scope scopes search secondary seconds secret securities security securityEntries securityId securitySchemes segments segs select selector separator server server-to-server server-url serverSchema servers services set setData setExample setExampleData setIsJson setIsMounted setMounted setObjectUrl setOpen setRequirementId setSecurityId setServer setServerVariables setStore setToken setType setValue shadow-md shadow-sm shiki shikiOptions showDescription showExample showResponseSchema showTitle shrink-0 side signal single size size-3.5 size-4 slot slots sm so source spec specify spread src state staticSource status statusInfo statuses stf stfSync still storageKey storageKeys store stored string stringifyFieldKey structuredData styles submit summary supported sure switch t tab tabs testQuery text text-[0.8125rem] text-blue-600 text-fd-card-foreground text-fd-foreground text-fd-muted-foreground text-fd-primary text-fd-secondary-foreground text-green-500 text-green-600 text-nowrap text-orange-600 text-red-400 text-red-500 text-red-600 text-sm text-start text-xs text-yellow-600 text/css text/csv text/html text/plain the their them themes this throw timeout timerRef tips title to toJsxRuntime toStaticData toc token tokenInfo token_type transform transformAuthInputs transformPageTree transition-colors tree true truncate try ts type typeof types typescript unchanged under unexpected unknown unlisted update updated updatedSchemeId updating url usage usageTabs usages use useAnchorId useApiClient useAuth useCopyButton useMemo useOnChange useOperationContext useQuery useRef useRenderContext useServerContext useState useStatusInfo useStf useStorageKey useTheme useTranslations used username using utf-8 v value values variable variables variant variants via virtual void w-14 w-fit w-full warn we webhook webhookCallbacks webhooks when whitespace-pre-wrap will with without won wrapping writeOnly x-codeSamples x-exclusiveCodeSample x-selectedCodeSample xml yellow you your");

package/dist/_virtual/_rolldown/runtime.js

@@ -16,7 +16,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

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

@@ -1,5 +1,5 @@
 import { traverse } from "../helpers/traverse.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.11/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js
 const DEFAULT_MEDIA_TYPE = "application/json";
 /** Extracts and removes x-example and x-examples extensions from an object */
 function extractXExampleExtensions(obj) {
@@ -179,9 +179,11 @@ function upgradeFromTwoToThree(originalSpecification) {
 		const parameters = document.parameters && typeof document.parameters === "object" ? document.parameters : {};
 		for (const [name, param] of Object.entries(parameters)) if (param && typeof param === "object") {
 			if ("$ref" in param) params[name] = transformParameterObject(param);
-			else if ("in" in param) if (param.in === "body") bodyParams[name] = migrateBodyParameter(param, document.consumes ?? [DEFAULT_MEDIA_TYPE]);
-			else if (param.in === "formData") bodyParams[name] = migrateFormDataParameter([param], document.consumes);
-			else params[name] = transformParameterObject(param);
+			else if ("in" in param) {
+				if (param.in === "body") bodyParams[name] = migrateBodyParameter(param, document.consumes ?? [DEFAULT_MEDIA_TYPE]);
+				else if (param.in === "formData") bodyParams[name] = migrateFormDataParameter([param], document.consumes);
+				else params[name] = transformParameterObject(param);
+			}
 		}
 		if (Object.keys(params).length > 0) document.components.parameters = params;
 		if (Object.keys(bodyParams).length > 0) document.components.requestBodies = bodyParams;
@@ -195,38 +197,40 @@ function upgradeFromTwoToThree(originalSpecification) {
 		document.components ??= {};
 		const migratedResponses = {};
 		const responses = document.responses;
-		for (const [name, response] of Object.entries(responses)) if (response && typeof response === "object") if ("$ref" in response) migratedResponses[name] = response;
-		else {
-			const responseObj = response;
-			const produces = document.produces ?? [DEFAULT_MEDIA_TYPE];
-			if (responseObj.schema) {
-				if (typeof responseObj.content !== "object") responseObj.content = {};
-				for (const type of produces) responseObj.content[type] = { schema: responseObj.schema };
-				delete responseObj.schema;
-			}
-			if (responseObj.examples && typeof responseObj.examples === "object") {
-				if (typeof responseObj.content !== "object") responseObj.content = {};
-				const defaultMediaType = produces[0] ?? DEFAULT_MEDIA_TYPE;
-				for (const [key, exampleValue] of Object.entries(responseObj.examples)) if (isMediaTypeKey(key)) {
-					if (typeof responseObj.content[key] !== "object") responseObj.content[key] = {};
-					responseObj.content[key].example = exampleValue;
-				} else {
-					if (typeof responseObj.content[defaultMediaType] !== "object") responseObj.content[defaultMediaType] = {};
-					const mediaEntry = responseObj.content[defaultMediaType];
-					if (typeof mediaEntry.examples !== "object") mediaEntry.examples = {};
-					mediaEntry.examples[key] = wrapAsExampleObject(exampleValue);
+		for (const [name, response] of Object.entries(responses)) if (response && typeof response === "object") {
+			if ("$ref" in response) migratedResponses[name] = response;
+			else {
+				const responseObj = response;
+				const produces = document.produces ?? [DEFAULT_MEDIA_TYPE];
+				if (responseObj.schema) {
+					if (typeof responseObj.content !== "object") responseObj.content = {};
+					for (const type of produces) responseObj.content[type] = { schema: responseObj.schema };
+					delete responseObj.schema;
+				}
+				if (responseObj.examples && typeof responseObj.examples === "object") {
+					if (typeof responseObj.content !== "object") responseObj.content = {};
+					const defaultMediaType = produces[0] ?? DEFAULT_MEDIA_TYPE;
+					for (const [key, exampleValue] of Object.entries(responseObj.examples)) if (isMediaTypeKey(key)) {
+						if (typeof responseObj.content[key] !== "object") responseObj.content[key] = {};
+						responseObj.content[key].example = exampleValue;
+					} else {
+						if (typeof responseObj.content[defaultMediaType] !== "object") responseObj.content[defaultMediaType] = {};
+						const mediaEntry = responseObj.content[defaultMediaType];
+						if (typeof mediaEntry.examples !== "object") mediaEntry.examples = {};
+						mediaEntry.examples[key] = wrapAsExampleObject(exampleValue);
+					}
+					delete responseObj.examples;
 				}
-				delete responseObj.examples;
+				if (responseObj.content && typeof responseObj.content === "object") removeEmptySchemaOnlyContentEntries(responseObj.content);
+				if (responseObj.headers && typeof responseObj.headers === "object") responseObj.headers = Object.entries(responseObj.headers).reduce((acc, [headerName, header]) => {
+					if (header && typeof header === "object") return {
+						[headerName]: transformResponseHeader(header),
+						...acc
+					};
+					return acc;
+				}, {});
+				migratedResponses[name] = responseObj;
 			}
-			if (responseObj.content && typeof responseObj.content === "object") removeEmptySchemaOnlyContentEntries(responseObj.content);
-			if (responseObj.headers && typeof responseObj.headers === "object") responseObj.headers = Object.entries(responseObj.headers).reduce((acc, [headerName, header]) => {
-				if (header && typeof header === "object") return {
-					[headerName]: transformResponseHeader(header),
-					...acc
-				};
-				return acc;
-			}, {});
-			migratedResponses[name] = responseObj;
 		}
 		if (Object.keys(migratedResponses).length > 0) document.components.responses = migratedResponses;
 		delete document.responses;

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

@@ -1,5 +1,5 @@
 import { traverse } from "../helpers/traverse.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.11/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js
 const SCHEMA_SEGMENTS = /* @__PURE__ */ new Set([
 	"properties",
 	"items",
@@ -18,6 +18,46 @@ function isSchemaPath(path) {
 	if (path.length >= 2 && path[0] === "components" && path[1] === "schemas") return true;
 	return false;
 }
+const NAMED_SCHEMA_MAP_SEGMENTS = /* @__PURE__ */ new Set([
+	"properties",
+	"patternProperties",
+	"$defs",
+	"definitions"
+]);
+/**
+* Determine if the node at `path` is a map of named subschemas rather than a schema object.
+*
+* This matters because the 3.0 to 3.1 upgrade rewrites the `example` keyword into `examples`.
+* A key called `example` (or `examples`) inside one of these maps is a member *name*, not the
+* schema keyword, so it must be left untouched.
+*/
+function isNamedSchemaMap(path) {
+	const last = path?.[path.length - 1];
+	if (last === void 0) return false;
+	if (last === "schemas" && path?.[path.length - 2] === "components") return true;
+	return NAMED_SCHEMA_MAP_SEGMENTS.has(last);
+}
+const DATA_KEYWORDS = /* @__PURE__ */ new Set([
+	"example",
+	"default",
+	"const",
+	"enum"
+]);
+/**
+* Determine if the node at `path` lives inside a data value rather than a schema.
+*
+* The traversal visits every object node, but a value held by keywords like `example` or
+* `default` is user data, not a schema. Applying the schema transforms to it would mangle it
+* (turning `nullable: true` into a type array, renaming a nested `x-webhooks`, and so on).
+*/
+function isInsideDataValue(path) {
+	if (!path) return false;
+	for (const [index, segment] of path.entries()) {
+		if (DATA_KEYWORDS.has(segment) && !isNamedSchemaMap(path.slice(0, index))) return true;
+		if (segment === "value" && path[index - 2] === "examples" && !isNamedSchemaMap(path.slice(0, index - 2))) return true;
+	}
+	return false;
+}
 /**
 * Upgrade from OpenAPI 3.0.x to 3.1.1
 *
@@ -31,9 +71,26 @@ function upgradeFromThreeToThreeOne(originalContent) {
 	return content;
 }
 const applyChangesToDocument = (schema, path) => {
+	if (isInsideDataValue(path)) return schema;
 	if (schema.type !== void 0 && schema.nullable === true) {
 		schema.type = [schema.type, "null"];
 		delete schema.nullable;
+	} else if (schema.nullable === true && schema.type === void 0) {
+		if (typeof schema.$ref === "string") {
+			const { nullable: _nullable, $ref, ...rest } = schema;
+			return {
+				...rest,
+				anyOf: [{ $ref }, { type: "null" }]
+			};
+		}
+		if (Array.isArray(schema.allOf)) {
+			const { nullable: _nullable, allOf, ...rest } = schema;
+			const base = allOf.length === 1 ? allOf[0] : { allOf };
+			return {
+				...rest,
+				anyOf: [base, { type: "null" }]
+			};
+		}
 	}
 	if (schema.exclusiveMinimum === true) {
 		schema.exclusiveMinimum = schema.minimum;
@@ -44,10 +101,10 @@ const applyChangesToDocument = (schema, path) => {
 		delete schema.maximum;
 	} else if (schema.exclusiveMaximum === false) delete schema.exclusiveMaximum;
 	const isInsideExamplesMap = path?.some((segment, index) => {
-		if (segment === "examples" && index > 0) return path[index - 1] !== "properties";
+		if (segment === "examples" && index > 0) return !isNamedSchemaMap(path.slice(0, index));
 		return false;
 	});
-	if (schema.example !== void 0 && !isInsideExamplesMap) {
+	if (schema.example !== void 0 && !isInsideExamplesMap && !isNamedSchemaMap(path)) {
 		if (isSchemaPath(path)) schema.examples = [schema.example];
 		else schema.examples = { default: { value: schema.example } };
 		delete schema.example;
@@ -85,7 +142,7 @@ const applyChangesToDocument = (schema, path) => {
 			};
 		}
 	}
-	if (schema["x-webhooks"] !== void 0) {
+	if (schema["x-webhooks"] !== void 0 && (path === void 0 || path.length === 0)) {
 		schema.webhooks = schema["x-webhooks"];
 		delete schema["x-webhooks"];
 	}

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

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.11/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.13/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js
 /**
 * Recursively migrate XML object properties from 3.1 to 3.2 format
 */
@@ -33,10 +33,12 @@ function migrateTagGroups(document) {
 		if (Array.isArray(document.tags)) {
 			for (const tag of document.tags) if (typeof tag === "object" && tag !== null && "name" in tag) {
 				const groupName = tagGroupMap.get(tag.name);
-				if (groupName) if (groupName.toLowerCase().includes("nav") || groupName.toLowerCase().includes("navigation")) tag.kind = "nav";
-				else if (groupName.toLowerCase().includes("audience")) tag.kind = "audience";
-				else if (groupName.toLowerCase().includes("badge")) tag.kind = "badge";
-				else tag.kind = "nav";
+				if (groupName) {
+					if (groupName.toLowerCase().includes("nav") || groupName.toLowerCase().includes("navigation")) tag.kind = "nav";
+					else if (groupName.toLowerCase().includes("audience")) tag.kind = "audience";
+					else if (groupName.toLowerCase().includes("badge")) tag.kind = "badge";
+					else tag.kind = "nav";
+				}
 			}
 		}
 		delete document["x-tagGroups"];

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

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

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

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

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

@@ -128,8 +128,10 @@ var require_js2xml = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		xml.push("<" + elementName);
 		if (element[options.attributesKey]) xml.push(writeAttributes(element[options.attributesKey], options, depth));
 		var withClosingTag = element[options.elementsKey] && element[options.elementsKey].length || element[options.attributesKey] && element[options.attributesKey]["xml:space"] === "preserve";
-		if (!withClosingTag) if ("fullTagEmptyElementFn" in options) withClosingTag = options.fullTagEmptyElementFn(element.name, element);
-		else withClosingTag = options.fullTagEmptyElement;
+		if (!withClosingTag) {
+			if ("fullTagEmptyElementFn" in options) withClosingTag = options.fullTagEmptyElementFn(element.name, element);
+			else withClosingTag = options.fullTagEmptyElement;
+		}
 		if (withClosingTag) {
 			xml.push(">");
 			if (element[options.elementsKey] && element[options.elementsKey].length) {
@@ -192,8 +194,10 @@ var require_js2xml = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			if (element[options.attributesKey]) xml.push(writeAttributes(element[options.attributesKey], options, depth));
 			var withClosingTag = hasContentCompact(element, options, true) || element[options.attributesKey] && element[options.attributesKey]["xml:space"] === "preserve";
-			if (!withClosingTag) if ("fullTagEmptyElementFn" in options) withClosingTag = options.fullTagEmptyElementFn(name, element);
-			else withClosingTag = options.fullTagEmptyElement;
+			if (!withClosingTag) {
+				if ("fullTagEmptyElementFn" in options) withClosingTag = options.fullTagEmptyElementFn(name, element);
+				else withClosingTag = options.fullTagEmptyElement;
+			}
 			if (withClosingTag) xml.push(">");
 			else {
 				xml.push("/>");

package/dist/requests/media/adapter.js

@@ -118,7 +118,10 @@ function str(init, mediaType, ctx) {
 		addImport("java.net.http.HttpRequest.BodyPublishers");
 		return `var body = BodyPublishers.ofString(${tripleDoubleQuote(inputToString(init, mediaType))});`;
 	}
-	if (ctx.lang === "csharp") return `var body = new StringContent(${tripleDoubleQuote(`\n${inputToString(init, mediaType)}\n`)}, Encoding.UTF8, "${mediaType}");`;
+	if (ctx.lang === "csharp") {
+		const input = `\n${inputToString(init, mediaType)}\n`;
+		return `var body = new StringContent(${tripleDoubleQuote(input)}, Encoding.UTF8, "${mediaType}");`;
+	}
 	if (ctx.lang === "rust") return `let body = ${rustRawStringLiteral(inputToString(init, mediaType))};`;
 }
 //#endregion

package/dist/requests/media/encode.js

@@ -42,9 +42,7 @@ function encodeRequestData(from, adapters, parameters = []) {
 			case "header":
 				result.header[key] = { value: serializeSimple(value, field.explode ?? false) };
 				break;
-			case "cookie":
-				serializeCookieParameter(field, value, result.cookie);
-				break;
+			case "cookie": serializeCookieParameter(field, value, result.cookie);
 		}
 	}
 	return result;

package/dist/server/index.js

@@ -1,5 +1,6 @@
-import { getPageProps } from "../utils/pages/builder.js";
+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 { MethodLabel } from "../ui/components/method-label.js";
 import { createProxy } from "./proxy.js";
 import { loadDocument } from "../utils/document/load.js";
@@ -10,7 +11,7 @@ import fs from "node:fs";
 //#region src/server/index.tsx
 function createOpenAPI(options = {}) {
 	const { disableCache = false } = options;
-	const schemaMap = /* @__PURE__ */ new Map();
+	const docCache = /* @__PURE__ */ new Map();
 	let resolvedInput = {};
 	if (Array.isArray(options.input)) for (const item of options.input) resolvedInput[item] = item;
 	else if (options.input) resolvedInput = options.input;
@@ -20,30 +21,34 @@ function createOpenAPI(options = {}) {
 			return loadDocument(schemaId);
 		}
 		if (!disableCache) {
-			const cached = schemaMap.get(schemaId);
+			const cached = docCache.get(schemaId);
 			if (cached) return cached;
 		}
 		const raw = resolvedInput[schemaId];
 		const output = Promise.resolve(typeof raw === "function" ? raw() : raw).then(loadDocument);
-		if (!disableCache) schemaMap.set(schemaId, output);
+		if (!disableCache) docCache.set(schemaId, output);
 		return output;
 	}
 	async function getSchemas() {
 		const entries = await Promise.all(Object.keys(resolvedInput).map(async (k) => [k, await getSchema(k)]));
 		return Object.fromEntries(entries);
 	}
-	async function getVirtualFiles(server, options) {
+	async function getVirtualFiles(server, options, docFilesCache) {
 		const { baseDir = "", meta = false } = options;
-		const { createAutoPreset } = await import("../utils/pages/preset-auto.js");
-		const { fromSchema } = await import("../utils/pages/builder.js");
 		const files = [];
-		const schemas = await server.getSchemas();
 		const builderOptions = createAutoPreset(options);
-		for (const [id, schema] of Object.entries(schemas)) {
-			onEntries(fromSchema(id, schema.bundled, builderOptions));
+		for (const [id, schema] of Object.entries(await server.getSchemas())) {
+			const cachedDocFiles = docFilesCache?.get(schema);
+			if (cachedDocFiles) {
+				files.push(...cachedDocFiles);
+				continue;
+			}
+			const entries = onEntries(fromSchema(id, schema.bundled, builderOptions));
+			docFilesCache?.set(schema, entries);
+			files.push(...entries);
 			function onEntry(entry) {
 				const props = getPageProps(entry);
-				files.push({
+				return {
 					type: "page",
 					path: `${baseDir}/${entry.path}`,
 					data: {
@@ -76,29 +81,29 @@ function createOpenAPI(options = {}) {
 							deprecated: entry.info.deprecated
 						}
 					}
-				});
+				};
 			}
 			function onEntries(entries, parent) {
+				const out = [];
 				if (!meta) {
-					for (const entry of entries) if (entry.type === "group") onEntries(entry.entries, entry);
-					else onEntry(entry);
-					return;
+					for (const entry of entries) if (entry.type === "group") out.push(...onEntries(entry.entries, entry));
+					else out.push(onEntry(entry));
+					return out;
 				}
 				const { folderStyle = "folder" } = meta === true ? {} : meta;
 				const pages = [];
 				for (const entry of entries) {
 					const relativePath = PathUtils.slash(parent ? path.relative(parent.path, entry.path) : entry.path);
 					if (entry.type === "group") {
-						onEntries(entry.entries, entry);
+						out.push(...onEntries(entry.entries, entry));
 						if (folderStyle === "folder") pages.push(relativePath);
 						else pages.push(`---${entry.info.title}---`, `...${relativePath}`);
 					} else {
-						onEntry(entry);
+						out.push(onEntry(entry));
 						pages.push(relativePath.slice(0, -path.extname(entry.path).length));
 					}
 				}
-				if (pages.length === 0) return;
-				files.push({
+				if (pages.length > 0) out.push({
 					type: "meta",
 					path: path.join(baseDir, parent?.path ?? "", "meta.json"),
 					data: {
@@ -107,6 +112,7 @@ function createOpenAPI(options = {}) {
 						pages
 					}
 				});
+				return out;
 			}
 		}
 		return files;
@@ -132,7 +138,14 @@ function createOpenAPI(options = {}) {
 			return { files: await getVirtualFiles(this, options) };
 		},
 		dynamicSource(options = {}) {
-			return { files: () => getVirtualFiles(this, options) };
+			const docFilesCache = /* @__PURE__ */ new WeakMap();
+			return {
+				cache: "custom",
+				files: () => getVirtualFiles(this, options, docFilesCache),
+				invalidate() {
+					docCache.clear();
+				}
+			};
 		},
 		loaderPlugin() {
 			return openapiPlugin();

package/dist/server/proxy.js

@@ -79,7 +79,6 @@ function createProxy(options = {}) {
 					body = void 0;
 					headers.delete("content-length");
 					headers.delete("content-type");
-					break;
 			}
 			url = next.href;
 		}

package/dist/ui/base.js

@@ -4,10 +4,10 @@ import { ClientCodeBlock } from "./components/codeblock.js";
 import { createCodeUsageGeneratorRegistry } from "../requests/generators/index.js";
 import { defaultAdapters } from "../requests/media/adapter.js";
 import { AuthProvider } from "../playground/auth.js";
-import { registerDefault } from "../requests/generators/all.js";
 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";
@@ -168,8 +168,9 @@ function MarkdownPre(props) {
 	const codeProps = Children.only(props.children).props;
 	const content = codeProps.children;
 	if (typeof content !== "string") return null;
+	const lang = codeProps.className?.split(" ").find((v) => v.startsWith("language-"))?.slice(9) ?? "text";
 	return /* @__PURE__ */ jsx(ClientCodeBlock, {
-		lang: codeProps.className?.split(" ").find((v) => v.startsWith("language-"))?.slice(9) ?? "text",
+		lang,
 		code: content.trimEnd()
 	});
 }

package/dist/utils/document/load.js

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

package/dist/utils/pages/to-static-data.js

@@ -3,8 +3,13 @@ import { dereferenceShallow } from "@fumadocs/api-docs/schema/dereference";
 import { createMagicProxy } from "@scalar/json-magic/magic-proxy";
 import Slugger from "github-slugger";
 //#region src/utils/pages/to-static-data.ts
+const proxyCache = /* @__PURE__ */ new WeakMap();
 function toStaticData(page, doc) {
-	const proxied = createMagicProxy(doc);
+	let proxied = proxyCache.get(doc);
+	if (!proxied) {
+		proxied = createMagicProxy(doc);
+		proxyCache.set(doc, proxied);
+	}
 	const slugger = new Slugger();
 	const toc = [];
 	const structuredData = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "11.2.3",
+  "version": "11.3.0",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -45,39 +45,39 @@
   "dependencies": {
     "@fuma-translate/react": "^1.0.2",
     "@fumari/json-schema-ts": "^1.0.2",
-    "@scalar/json-magic": "^0.12.19",
+    "@scalar/json-magic": "^0.12.20",
     "chokidar": "^5.0.0",
     "class-variance-authority": "^0.7.1",
     "cnfast": "^0.1.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-jsx-runtime": "^2.3.6",
-    "lucide-react": "^1.27.0",
+    "lucide-react": "^1.31.0",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
-    "shiki": "^4.3.1",
+    "shiki": "^4.4.3",
     "yaml": "^2.9.0",
-    "@fumadocs/api-docs": "0.2.2",
+    "@fumadocs/api-docs": "0.2.3",
     "@fumari/stf": "1.1.0"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^2.0.36",
-    "@scalar/openapi-upgrader": "^0.2.11",
+    "@scalar/api-client-react": "^2.0.38",
+    "@scalar/openapi-upgrader": "^0.2.13",
     "@tailwindcss/oxide": "^4.3.3",
-    "@types/node": "26.1.2",
-    "@types/react": "^19.2.17",
+    "@types/node": "26.2.0",
+    "@types/react": "^19.2.18",
     "fast-content-type-parse": "^3.0.0",
     "json-schema-typed": "^8.0.2",
     "tsdown": "0.22.14",
     "xml-js": "^1.6.11",
-    "fumadocs-ui": "npm:@fumadocs/base-ui@16.14.0",
-    "fumadocs-core": "16.14.0",
+    "fumadocs-core": "16.15.0",
+    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "@scalar/api-client-react": "^2.0.20",
     "@types/react": "*",
-    "fumadocs-core": "^16.10.0",
-    "fumadocs-ui": "^16.10.0",
+    "fumadocs-core": "^16.15.0",
+    "fumadocs-ui": "^16.15.0",
     "json-schema-typed": "*",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
@@ -94,7 +94,7 @@
     }
   },
   "inlinedDependencies": {
-    "@scalar/openapi-upgrader": "0.2.11",
+    "@scalar/openapi-upgrader": "0.2.13",
     "fast-content-type-parse": "3.0.0",
     "xml-js": "1.6.11"
   },