fumadocs-openapi 11.2.3 → 11.2.4

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/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.2.4",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -45,33 +45,33 @@
   "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",
     "@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",
-    "tsconfig": "0.0.0"
+    "fumadocs-core": "16.14.4",
+    "tsconfig": "0.0.0",
+    "fumadocs-ui": "npm:@fumadocs/base-ui@16.14.4"
   },
   "peerDependencies": {
     "@scalar/api-client-react": "^2.0.20",
@@ -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"
   },