fumadocs-openapi 10.8.1 → 10.8.3

package/dist/utils/pages/preset-auto.js

@@ -58,17 +58,18 @@ function createAutoPreset(options) {
 					tags = ["unknown"];
 				}
 				for (const tag of tags) {
+					const res = builder.fromTagName(tag);
+					if (!res) continue;
 					const groupName = slugify(tag);
-					const { displayName, info } = builder.fromTagName(tag);
 					let group = groups.get(groupName);
 					if (!group) {
 						group = {
 							type: "group",
 							info: {
-								title: displayName,
-								description: info.description
+								title: res.displayName,
+								description: res.info.description
 							},
-							tag: info,
+							tag: res.info,
 							entries: [],
 							schemaId: builder.id,
 							path: groupName
@@ -161,7 +162,8 @@ function createAutoPreset(options) {
 				item: op,
 				info: {
 					title: displayName,
-					description: operation.description ?? pathItem.description
+					description: operation.description ?? pathItem.description,
+					deprecated: operation.deprecated
 				}
 			});
 		}
@@ -172,7 +174,8 @@ function createAutoPreset(options) {
 				schemaId: builder.id,
 				info: {
 					title: displayName,
-					description: operation.description ?? pathItem.description
+					description: operation.description ?? pathItem.description,
+					deprecated: operation.deprecated
 				},
 				item: webhook
 			});

package/dist/utils/pages/to-text.d.ts

@@ -34,7 +34,7 @@ interface PagesToTextOptions {
 }
 type DocumentContext = {
   type: 'tag';
-  tag: TagObject | undefined;
+  tag: TagObject;
 } | {
   type: 'operation';
 } | {

package/dist/utils/pages/to-text.js

@@ -5,25 +5,13 @@ import { dump } from "js-yaml";
 //#region src/utils/pages/to-text.ts
 function toText(entry, processed, options = {}) {
 	switch (entry.type) {
-		case "operation": return generatePage(entry.schemaId, processed, { operations: [entry.item] }, {
-			...options,
-			...entry.info
-		}, { type: "operation" });
+		case "operation": return generatePage(entry.schemaId, processed, { operations: [entry.item] }, options, entry);
 		case "page": return generatePage(entry.schemaId, processed, {
 			operations: entry.operations,
 			webhooks: entry.webhooks,
 			showTitle: true
-		}, {
-			...options,
-			...entry.info
-		}, entry.tag ? {
-			type: "tag",
-			tag: entry.tag
-		} : { type: "file" });
-		case "webhook": return generatePage(entry.schemaId, processed, { webhooks: [entry.item] }, {
-			...options,
-			...entry.info
-		}, { type: "operation" });
+		}, options, entry);
+		case "webhook": return generatePage(entry.schemaId, processed, { webhooks: [entry.item] }, options, entry);
 	}
 }
 function generateDocument(frontmatter, content, options) {
@@ -41,26 +29,33 @@ function generateDocument(frontmatter, content, options) {
 	out.push(content);
 	return out.join("\n\n");
 }
-function generatePage(schemaId, processed, pageProps, options, context) {
+function generatePage(schemaId, processed, pageProps, options, entry) {
 	const { frontmatter, includeDescription = false } = options;
-	const extend = frontmatter?.(options.title, options.description, context);
+	const extend = frontmatter?.(entry.info.title, entry.info.description, entry.type === "page" ? entry.tag ? {
+		type: "tag",
+		tag: entry.tag
+	} : { type: "file" } : { type: "operation" });
 	const page = {
 		...pageProps,
 		document: schemaId
 	};
 	let meta;
-	if (page.operations?.length === 1) meta = { method: page.operations[0].method.toUpperCase() };
+	if (page.operations?.length === 1) meta = {
+		method: page.operations[0].method.toUpperCase(),
+		deprecated: entry.info.deprecated
+	};
 	else if (page.webhooks?.length === 1) meta = {
 		method: page.webhooks[0].method.toUpperCase(),
-		webhook: true
+		webhook: true,
+		deprecated: entry.info.deprecated
 	};
 	const data = toStaticData(page, processed.dereferenced);
 	const content = [];
-	if (options.description && includeDescription) content.push(options.description);
+	if (entry.info.description && includeDescription) content.push(entry.info.description);
 	content.push(pageContent(page));
 	return generateDocument({
-		title: options.title,
-		description: !includeDescription ? options.description : void 0,
+		title: entry.info.title,
+		description: !includeDescription ? entry.info.description : void 0,
 		full: true,
 		...extend,
 		_openapi: {

package/dist/utils/schema/index.d.ts

@@ -5,6 +5,10 @@ import { JSONSchema } from "json-schema-typed/draft-2020-12";
 type NoReference<T> = T extends (infer I)[] ? NoReference<I>[] : T extends ReferenceObject ? Exclude<T, ReferenceObject> : T extends object ? { [K in keyof T]: NoReference<T[K]> } : T;
 type ParsedSchema = (JSONSchema & {
   'x-playground-lazy'?: boolean;
+  discriminator?: {
+    propertyName?: string;
+    mapping?: Record<string, string>;
+  };
 }) | boolean;
 interface SecurityEntry {
   scopes: string[];

package/dist/utils/schema/to-string.js

@@ -9,14 +9,18 @@ function schemaToString(value, _resolver, flags = 0) {
 	};
 	function union(union, sep, flags) {
 		const members = /* @__PURE__ */ new Set();
+		const out = [];
 		let nullable = false;
 		for (const item of union) {
 			const result = run(item, flags | 1);
 			if (result === "null") nullable = true;
-			else if (result !== "unknown") members.add(result);
+			else if (result !== "unknown" && !members.has(result)) {
+				out.push(result);
+				members.add(result);
+			}
 		}
-		const result = Array.from(members).join(sep);
-		return nullable ? `${result} | null` : result;
+		if (nullable) out.push("null");
+		return out.join(sep);
 	}
 	function run(input, flags) {
 		const { dereferenced: schema, raw } = resolver(input);
@@ -34,14 +38,13 @@ function schemaToString(value, _resolver, flags = 0) {
 			type
 		})), " | ", flags);
 		if (schema.type === "array") return `array<${schema.items ? run(schema.items, flags | 1) : "unknown"}>`;
-		const or = schema.oneOf ?? schema.anyOf;
 		if (schema.oneOf && schema.anyOf) return `(${union(schema.oneOf, " | ", flags)}) & (${union(schema.anyOf, " | ", flags)})`;
-		else if (or) return union(or, " | ", flags);
+		const or = schema.oneOf ?? schema.anyOf;
+		if (or) return union(or, " | ", flags);
 		if (schema.allOf) return union(schema.allOf, " & ", flags);
-		if (schema.not) return `not ${run(schema.not, flags)}`;
+		if (schema.not) return `not (${run(schema.not, flags)})`;
 		if (schema.type === "string" && schema.format === "binary") return "file";
-		if (schema.type && Array.isArray(schema.type)) return schema.type.filter((v) => v !== "null").join(" | ");
-		if (schema.type) return schema.type;
+		if (typeof schema.type === "string") return schema.type;
 		return "unknown";
 	}
 	return run(value, flags);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.8.1",
+  "version": "10.8.3",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -15,9 +15,6 @@
     "dist"
   ],
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
     "./i18n": "./dist/i18n.js",
@@ -54,29 +51,29 @@
     "github-slugger": "^2.0.0",
     "hast-util-to-jsx-runtime": "^2.3.6",
     "js-yaml": "^4.1.1",
-    "lucide-react": "^1.11.0",
+    "lucide-react": "^1.14.0",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
     "shiki": "^4.0.2",
-    "tailwind-merge": "^3.5.0",
+    "tailwind-merge": "^3.6.0",
     "xml-js": "^1.6.11",
     "@fumari/stf": "1.0.5"
   },
   "devDependencies": {
     "@fastify/deepmerge": "^3.2.1",
     "@scalar/api-client-react": "2.0.1",
-    "@scalar/json-magic": "^0.12.8",
-    "@scalar/openapi-upgrader": "^0.2.6",
-    "@tailwindcss/oxide": "^4.2.4",
+    "@scalar/json-magic": "^0.12.12",
+    "@scalar/openapi-upgrader": "^0.2.7",
+    "@tailwindcss/oxide": "^4.3.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "25.6.0",
+    "@types/node": "25.6.2",
     "@types/react": "^19.2.14",
     "fast-content-type-parse": "^3.0.0",
     "json-schema-typed": "^8.0.2",
-    "tailwindcss": "^4.2.4",
-    "tsdown": "0.21.10",
-    "fumadocs-core": "16.8.5",
-    "fumadocs-ui": "16.8.5",
+    "tailwindcss": "^4.3.0",
+    "tsdown": "0.22.0",
+    "fumadocs-core": "16.8.11",
+    "fumadocs-ui": "16.8.11",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -101,15 +98,15 @@
   },
   "inlinedDependencies": {
     "@fastify/deepmerge": "3.2.1",
-    "@scalar/helpers": "0.5.2",
-    "@scalar/json-magic": "0.12.8",
-    "@scalar/openapi-upgrader": "0.2.6",
+    "@scalar/helpers": "0.6.0",
+    "@scalar/json-magic": "0.12.12",
+    "@scalar/openapi-upgrader": "0.2.7",
     "fast-content-type-parse": "3.0.0",
     "pathe": "2.0.3",
-    "yaml": "2.8.3"
+    "yaml": "2.8.4"
   },
   "scripts": {
-    "build": "tsdown --config-loader unrun",
+    "build": "tsdown",
     "clean": "rimraf dist",
     "dev": "tsdown --watch --clean false",
     "lint": "oxlint .",

package/dist/node_modules/.pnpm/@scalar_json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/plugins/parse-yaml/index.js

@@ -1 +0,0 @@
-import "../../../../../../../../yaml@2.8.3/node_modules/yaml/browser/index.js";