fumadocs-openapi 10.8.5 → 10.9.0

package/dist/scalar/client.js

@@ -1,4 +1,5 @@
 "use client";
+import { I18nLabel } from "../ui/client/i18n.js";
 import { cn } from "../utils/cn.js";
 import { MethodLabel } from "../ui/components/method-label.js";
 import { useEffect, useState } from "react";
@@ -39,7 +40,7 @@ function ScalarPlayground({ path, method, spec }) {
 					path,
 					method
 				}),
-				children: "Test"
+				children: /* @__PURE__ */ jsx(I18nLabel, { label: "test" })
 			})
 		]
 	});

package/dist/server/index.d.ts

@@ -1,3 +1,108 @@
-import { OpenAPIOptions, OpenAPIServer, createCodeSample, createOpenAPI } from "./create.js";
-import { InternalOpenAPIMeta, OpenAPIPageData, OpenAPISourceOptions, openapiPlugin, openapiSource, transformerOpenAPI } from "./source-api.js";
-export { InternalOpenAPIMeta, OpenAPIOptions, OpenAPIPageData, OpenAPIServer, OpenAPISourceOptions, createCodeSample, createOpenAPI, openapiPlugin, openapiSource, transformerOpenAPI };
+import { InlineCodeUsageGenerator } from "../requests/generators/index.js";
+import { CreateProxyOptions, Proxy, createProxy } from "./proxy.js";
+import { ProcessedDocument } from "../utils/document/process.js";
+import { ApiPageProps } from "../ui/api-page.js";
+import { ClientApiPageProps } from "../ui/create-client.js";
+import { SchemaToPagesOptions } from "../utils/pages/preset-auto.js";
+import { Document } from "../types.js";
+import { DereferencedDocument } from "../utils/document/dereference.js";
+import { DynamicSource, LoaderPlugin, MetaData, PageData, PageTreeTransformer, 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, or downloaded schema object
+ */
+type SchemaMap = Record<string, string | Document>;
+type ProcessedSchemaMap = Record<string, ProcessedDocument>;
+interface OpenAPIOptions {
+  /**
+   * Schema files, can be:
+   * - URL
+   * - file path
+   * - a function returning records of downloaded schemas.
+   */
+  input?: string[] | (() => SchemaMap | Promise<SchemaMap>);
+  disableCache?: boolean;
+  /**
+   * The url of proxy to avoid CORS issues
+   */
+  proxyUrl?: string;
+}
+interface OpenAPIServer {
+  createProxy: typeof createProxy;
+  getSchemas: () => Promise<ProcessedSchemaMap>;
+  getSchema: (document: string) => Promise<ProcessedDocument>;
+  readonly options: OpenAPIOptions;
+  /**
+   * Generate virtual pages for Fumadocs Source API
+   */
+  staticSource: (options?: OpenAPISourceOptions) => Promise<Source<{
+    metaData: MetaData;
+    pageData: OpenAPIPageData;
+  }>>;
+  /**
+   * Generate virtual pages for Fumadocs Source API
+   */
+  dynamicSource: (options?: OpenAPISourceOptions) => DynamicSource<{
+    metaData: MetaData;
+    pageData: OpenAPIPageData;
+  }>;
+  /**
+   * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
+   */
+  loaderPlugin: () => LoaderPlugin;
+  /** @private internal API */
+  _getWatchPaths: () => string[];
+}
+interface OpenAPIPageData extends PageData {
+  getAPIPageProps: () => ApiPageProps;
+  getSchema: () => {
+    id: string;
+  } & DereferencedDocument;
+  getClientAPIPageProps: () => Promise<ClientApiPageProps>;
+  structuredData: StructuredData;
+  toc: TOCItemType[];
+}
+type OpenAPISourceOptions = SchemaToPagesOptions & {
+  baseDir?: string; /** Generate `meta.json` files */
+  meta?: boolean | {
+    folderStyle?: 'folder' | 'separator';
+  };
+};
+declare function createOpenAPI(options?: OpenAPIOptions): OpenAPIServer;
+/**
+ * @deprecated
+ */
+declare function createCodeSample<T>(options: InlineCodeUsageGenerator<T>): InlineCodeUsageGenerator<T>;
+declare module 'fumadocs-core/source' {
+  interface PageData {
+    /**
+     * Added by Fumadocs OpenAPI
+     */
+    _openapi?: InternalOpenAPIMeta;
+  }
+}
+interface InternalOpenAPIMeta {
+  method?: string;
+  webhook?: boolean;
+  deprecated?: boolean;
+}
+/**
+ * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
+ */
+declare function openapiPlugin(): LoaderPlugin;
+/**
+ * Generate virtual pages for Fumadocs Source API
+ */
+declare function openapiSource(server: OpenAPIServer, options?: OpenAPISourceOptions): Promise<Source<{
+  metaData: MetaData;
+  pageData: OpenAPIPageData;
+}>>;
+/**
+ * @deprecated use `openapiPlugin()`
+ */
+declare function transformerOpenAPI(): PageTreeTransformer;
+//#endregion
+export { type CreateProxyOptions, InternalOpenAPIMeta, OpenAPIOptions, OpenAPIPageData, OpenAPIServer, OpenAPISourceOptions, type Proxy, createCodeSample, createOpenAPI, openapiPlugin, openapiSource, transformerOpenAPI };

package/dist/server/index.js

@@ -1,3 +1,182 @@
-import { createCodeSample, createOpenAPI } from "./create.js";
-import { openapiPlugin, openapiSource, transformerOpenAPI } from "./source-api.js";
+import { getPageProps } from "../utils/pages/builder.js";
+import { toStaticData } from "../utils/pages/to-static-data.js";
+import { MethodLabel } from "../ui/components/method-label.js";
+import { createProxy } from "./proxy.js";
+import { processDocument } from "../utils/document/process.js";
+import path from "node:path";
+import { PathUtils } from "fumadocs-core/source";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import fs from "node:fs";
+//#region src/server/index.tsx
+function createOpenAPI(options = {}) {
+	const { input = [], disableCache = false } = options;
+	let schemas;
+	async function getSchemas() {
+		if (Array.isArray(input)) {
+			const entries = await Promise.all(input.map(async (item) => [item, await processDocument(item)]));
+			return Object.fromEntries(entries);
+		} else {
+			const entries = await Promise.all(Object.entries(await input()).map(async ([k, v]) => [k, await processDocument(v)]));
+			return Object.fromEntries(entries);
+		}
+	}
+	async function getVirtualFiles(server, options) {
+		const { baseDir = "", meta = false } = options;
+		const { createAutoPreset } = await import("../utils/pages/preset-auto.js");
+		const { fromServer } = await import("../utils/pages/builder.js");
+		const files = [];
+		const entries = await fromServer(server, createAutoPreset(options));
+		for (const [schemaId, list] of Object.entries(entries)) {
+			const processed = await server.getSchema(schemaId);
+			function onEntry(entry) {
+				const props = getPageProps(entry);
+				files.push({
+					type: "page",
+					path: `${baseDir}/${entry.path}`,
+					data: {
+						...entry.info,
+						getAPIPageProps() {
+							return props;
+						},
+						async getClientAPIPageProps() {
+							return {
+								payload: {
+									bundled: processed.bundled,
+									proxyUrl: server.options.proxyUrl
+								},
+								...props
+							};
+						},
+						getSchema() {
+							return {
+								id: schemaId,
+								...processed
+							};
+						},
+						...toStaticData(props, processed.dereferenced),
+						_openapi: {
+							method: entry.type === "operation" || entry.type === "webhook" ? entry.item.method : void 0,
+							webhook: entry.type === "webhook",
+							deprecated: entry.info.deprecated
+						}
+					}
+				});
+			}
+			function onEntries(entries, parent) {
+				if (!meta) {
+					for (const entry of entries) if (entry.type === "group") onEntries(entry.entries, entry);
+					else onEntry(entry);
+					return;
+				}
+				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);
+						if (folderStyle === "folder") pages.push(relativePath);
+						else pages.push(`---${entry.info.title}---`, `...${relativePath}`);
+					} else {
+						onEntry(entry);
+						pages.push(relativePath.slice(0, -path.extname(entry.path).length));
+					}
+				}
+				if (pages.length === 0) return;
+				files.push({
+					type: "meta",
+					path: path.join(baseDir, parent?.path ?? "", "meta.json"),
+					data: {
+						title: parent?.info.title,
+						description: parent?.info.description,
+						pages
+					}
+				});
+			}
+			onEntries(list);
+		}
+		return files;
+	}
+	return {
+		options,
+		createProxy,
+		_getWatchPaths() {
+			return (Array.isArray(input) ? input : Object.keys(input)).filter((key) => !URL.canParse(key) && fs.existsSync(key));
+		},
+		async getSchema(document) {
+			const schemas = await this.getSchemas();
+			if (document in schemas) return schemas[document];
+			console.warn(`[Fumadocs OpenAPI] the document "${document}" is not listed in the input array, this may not be expected.`);
+			return processDocument(document);
+		},
+		async getSchemas() {
+			if (disableCache) return getSchemas();
+			return schemas ??= getSchemas();
+		},
+		async staticSource(options = {}) {
+			return { files: await getVirtualFiles(this, options) };
+		},
+		dynamicSource(options = {}) {
+			return { files: () => getVirtualFiles(this, options) };
+		},
+		loaderPlugin() {
+			return openapiPlugin();
+		}
+	};
+}
+/**
+* @deprecated
+*/
+function createCodeSample(options) {
+	return options;
+}
+/**
+* Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
+*/
+function openapiPlugin() {
+	return {
+		name: "fumadocs:openapi",
+		enforce: "pre",
+		transformPageTree: { file(node, filePath) {
+			if (!filePath) return node;
+			const file = this.storage.read(filePath);
+			if (!file || file.format !== "page") return node;
+			const openApiData = file.data._openapi;
+			if (!openApiData || typeof openApiData !== "object") return node;
+			if (openApiData.deprecated) node.name = /* @__PURE__ */ jsx("span", {
+				className: "fd-page-tree-item-name line-through",
+				children: node.name
+			});
+			if (openApiData.webhook) node.name = /* @__PURE__ */ jsxs(Fragment, { children: [
+				node.name,
+				" ",
+				/* @__PURE__ */ jsx("span", {
+					className: "ms-auto border border-current px-1 rounded-lg text-xs text-nowrap font-mono",
+					children: "Webhook"
+				})
+			] });
+			else if (openApiData.method) node.name = /* @__PURE__ */ jsxs(Fragment, { children: [
+				node.name,
+				" ",
+				/* @__PURE__ */ jsx(MethodLabel, {
+					className: "ms-auto text-xs text-nowrap",
+					children: openApiData.method
+				})
+			] });
+			return node;
+		} }
+	};
+}
+/**
+* Generate virtual pages for Fumadocs Source API
+*/
+async function openapiSource(server, options = {}) {
+	return server.staticSource(options);
+}
+/**
+* @deprecated use `openapiPlugin()`
+*/
+function transformerOpenAPI() {
+	return openapiPlugin().transformPageTree;
+}
+//#endregion
 export { createCodeSample, createOpenAPI, openapiPlugin, openapiSource, transformerOpenAPI };

package/dist/server/proxy.d.ts

@@ -31,4 +31,4 @@ interface CreateProxyOptions {
 }
 declare function createProxy(options?: CreateProxyOptions): Proxy;
 //#endregion
-export { createProxy };
+export { CreateProxyOptions, Proxy, createProxy };

package/dist/types.d.ts

@@ -2,8 +2,8 @@ import { MediaAdapter } from "./requests/media/adapter.js";
 import { InlineCodeUsageGenerator } from "./requests/generators/index.js";
 import { boundary_d_exports } from "./ui/client/boundary.js";
 import { OpenAPIV3, OpenAPIV3_2 } from "./_openapi/types.js";
-import { OpenAPIOptions } from "./server/create.js";
 import { CreateAPIPageOptions } from "./ui/base.js";
+import { OpenAPIOptions } from "./server/index.js";
 import { NoReference } from "./utils/schema/index.js";
 import { DereferencedDocument } from "./utils/document/dereference.js";
 import { HTMLAttributes, ReactNode } from "react";

package/dist/ui/base.d.ts

@@ -3,11 +3,11 @@ import { CodeUsageGeneratorRegistry, InlineCodeUsageGenerator } from "../request
 import { ExampleRequestItem } from "./operation/get-example-requests.js";
 import { APIPageClientOptions } from "./client/index.js";
 import { SchemaUIOptions } from "./schema/index.js";
-import { OpenAPIServer } from "../server/create.js";
 import { ApiPageProps, OperationItem, WebhookItem } from "./api-page.js";
 import { ResponseTab } from "./operation/response-tabs.js";
 import { RequestTabsRenderContext } from "./operation/request-tabs.js";
 import { ClientCodeBlockProvider } from "./components/codeblock.js";
+import { OpenAPIServer } from "../server/index.js";
 import { Awaitable, MethodInformation, RenderContext } from "../types.js";
 import { NoReference } from "../utils/schema/index.js";
 import { DereferencedDocument } from "../utils/document/dereference.js";

package/dist/ui/client/i18n.js

@@ -1,19 +1,16 @@
 "use client";
 import { defaultTranslations } from "../../i18n.js";
-import { useI18n } from "fumadocs-ui/contexts/i18n";
+import { renderTranslation } from "fumadocs-core/i18n";
+import { useTranslations } from "fumadocs-ui/contexts/i18n";
 //#region src/ui/client/i18n.ts
-function useTranslations() {
-	return useI18n().text.openapi ?? defaultTranslations;
+function useTranslations$1() {
+	return useTranslations("openapi") ?? defaultTranslations;
 }
 /**
 * Renders a translated string. Use in server components so the label is resolved on the client from the current locale.
 */
-function I18nLabel({ label, replacements = {} }) {
-	return withReplacements(useTranslations()[label], replacements);
-}
-function withReplacements(t, replacements) {
-	for (const [k, v] of Object.entries(replacements)) t = t.replaceAll(`{${k}}`, v);
-	return t;
+function I18nLabel({ label, replacements }) {
+	return renderTranslation(useTranslations$1()[label], replacements);
 }
 //#endregion
-export { I18nLabel, useTranslations, withReplacements };
+export { I18nLabel, useTranslations$1 as useTranslations };

package/dist/ui/components/method-label.js

@@ -20,10 +20,7 @@ function getMethodColor(method) {
 }
 function Badge({ className, color, ...props }) {
 	return /* @__PURE__ */ jsx("span", {
-		className: cn(badgeVariants({
-			color,
-			className
-		})),
+		className: cn(badgeVariants({ color }), className),
 		...props,
 		children: props.children
 	});

package/dist/ui/index.d.ts

@@ -1,6 +1,6 @@
-import { OpenAPIServer } from "../server/create.js";
 import { ApiPageProps, OperationItem, WebhookItem } from "./api-page.js";
 import { CreateAPIPageOptions as CreateAPIPageOptions$1, ServerApiPageProps } from "./base.js";
+import { OpenAPIServer } from "../server/index.js";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/ui/index.d.ts

package/dist/utils/document/process.js

@@ -1,8 +1,8 @@
-import { bundle } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.12/node_modules/@scalar/json-magic/dist/bundle/bundle.js";
+import { bundle } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.14/node_modules/@scalar/json-magic/dist/bundle/bundle.js";
 import { upgrade } from "../../node_modules/.pnpm/@scalar_openapi-upgrader@0.2.7/node_modules/@scalar/openapi-upgrader/dist/upgrade.js";
-import { fetchUrls } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.12/node_modules/@scalar/json-magic/dist/bundle/plugins/fetch-urls/index.js";
-import { readFiles } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.12/node_modules/@scalar/json-magic/dist/bundle/plugins/read-files/index.js";
-import "../../node_modules/.pnpm/@scalar_json-magic@0.12.12/node_modules/@scalar/json-magic/dist/bundle/plugins/node.js";
+import { fetchUrls } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.14/node_modules/@scalar/json-magic/dist/bundle/plugins/fetch-urls/index.js";
+import { readFiles } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.14/node_modules/@scalar/json-magic/dist/bundle/plugins/read-files/index.js";
+import "../../node_modules/.pnpm/@scalar_json-magic@0.12.14/node_modules/@scalar/json-magic/dist/bundle/plugins/node.js";
 import { dereferenceDocument } from "./dereference.js";
 //#region src/utils/document/process.ts
 /**

package/dist/utils/pages/builder.d.ts

@@ -1,5 +1,5 @@
-import { OpenAPIServer } from "../../server/create.js";
-import { OperationItem, WebhookItem } from "../../ui/api-page.js";
+import { ApiPageProps, OperationItem, WebhookItem } from "../../ui/api-page.js";
+import { OpenAPIServer } from "../../server/index.js";
 import { OperationObject, PathItemObject, TagObject } from "../../types.js";
 import { NoReference } from "../schema/index.js";
 import { DereferencedDocument } from "../document/dereference.js";
@@ -85,5 +85,6 @@ interface ExtractedInfo {
 }
 declare function fromServer(server: OpenAPIServer, config: PagesBuilderConfig): Promise<Record<string, OutputEntry[]>>;
 declare function fromSchema(schemaId: string, processed: DereferencedDocument, config: PagesBuilderConfig): OutputEntry[];
+declare function getPageProps(entry: PageOutput | OperationOutput | WebhookOutput): ApiPageProps;
 //#endregion
-export { OperationOutput, OutputEntry, OutputGroup, PageOutput, PagesBuilder, PagesBuilderConfig, WebhookOutput, fromSchema, fromServer };
+export { OperationOutput, OutputEntry, OutputGroup, PageOutput, PagesBuilder, PagesBuilderConfig, WebhookOutput, fromSchema, fromServer, getPageProps };

package/dist/utils/pages/builder.js

@@ -97,5 +97,24 @@ function fromSchema(schemaId, processed, config) {
 	});
 	return files;
 }
+function getPageProps(entry) {
+	if (entry.type === "operation") return {
+		document: entry.schemaId,
+		operations: [entry.item],
+		showDescription: true
+	};
+	if (entry.type === "webhook") return {
+		document: entry.schemaId,
+		webhooks: [entry.item],
+		showDescription: true
+	};
+	return {
+		showTitle: true,
+		showDescription: true,
+		document: entry.schemaId,
+		operations: entry.operations,
+		webhooks: entry.webhooks
+	};
+}
 //#endregion
-export { fromSchema, fromServer };
+export { fromSchema, fromServer, getPageProps };

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

@@ -17,7 +17,7 @@ interface PagesToTextOptions {
   /**
    * Add description to document body.
    *
-   * We recommend but don't enable it by default because some OpenAPI schemas have invalid description that breaks MDX syntax.
+   * We recommend to enable it, it is disabled by default because some OpenAPI schemas have invalid description that breaks Markdown syntax.
    *
    * @defaultValue false
    */

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

@@ -1,58 +1,24 @@
 import { removeUndefined } from "../remove-undefined.js";
+import { getPageProps } from "./builder.js";
 import { toStaticData } from "./to-static-data.js";
 import { doubleQuote } from "../../requests/string-utils.js";
 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);
-		case "page": return generatePage(entry.schemaId, processed, {
-			operations: entry.operations,
-			webhooks: entry.webhooks,
-			showTitle: true
-		}, options, entry);
-		case "webhook": return generatePage(entry.schemaId, processed, { webhooks: [entry.item] }, options, entry);
-	}
-}
-function generateDocument(frontmatter, content, options) {
-	const { addGeneratedComment = true, imports } = options;
-	const out = [];
-	const banner = dump(removeUndefined(frontmatter)).trimEnd();
-	if (banner.length > 0) out.push(`---\n${banner}\n---`);
-	if (addGeneratedComment) {
-		let commentContent = "This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again.";
-		if (typeof addGeneratedComment === "string") commentContent = addGeneratedComment;
-		commentContent = commentContent.replaceAll("/", "\\/");
-		out.push(`{/* ${commentContent} */}`);
-	}
-	if (imports) out.push(...imports.map((item) => `import { ${item.names.join(", ")} } from ${doubleQuote(item.from)};`).join("\n"));
-	out.push(content);
-	return out.join("\n\n");
-}
-function generatePage(schemaId, processed, pageProps, options, entry) {
 	const { frontmatter, includeDescription = false } = options;
 	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
-	};
+	const pageProps = getPageProps(entry);
+	if (!includeDescription) pageProps.showDescription = false;
 	let meta;
-	if (page.operations?.length === 1) meta = {
-		method: page.operations[0].method.toUpperCase(),
+	if (entry.type === "operation" || entry.type === "webhook") meta = {
+		method: entry.item.method.toUpperCase(),
+		webhook: entry.type === "webhook",
 		deprecated: entry.info.deprecated
 	};
-	else if (page.webhooks?.length === 1) meta = {
-		method: page.webhooks[0].method.toUpperCase(),
-		webhook: true,
-		deprecated: entry.info.deprecated
-	};
-	const data = toStaticData(page, processed.dereferenced);
-	const content = [];
-	if (entry.info.description && includeDescription) content.push(entry.info.description);
-	content.push(pageContent(page));
+	const data = toStaticData(pageProps, processed.dereferenced);
 	return generateDocument({
 		title: entry.info.title,
 		description: !includeDescription ? entry.info.description : void 0,
@@ -63,7 +29,22 @@ function generatePage(schemaId, processed, pageProps, options, entry) {
 			...data,
 			...extend?._openapi
 		}
-	}, content.join("\n\n"), options);
+	}, pageContent(pageProps), options);
+}
+function generateDocument(frontmatter, content, options) {
+	const { addGeneratedComment = true, imports } = options;
+	const out = [];
+	const banner = dump(removeUndefined(frontmatter)).trimEnd();
+	if (banner.length > 0) out.push(`---\n${banner}\n---`);
+	if (addGeneratedComment) {
+		let commentContent = "This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again.";
+		if (typeof addGeneratedComment === "string") commentContent = addGeneratedComment;
+		commentContent = commentContent.replaceAll("/", "\\/");
+		out.push(`{/* ${commentContent} */}`);
+	}
+	if (imports) out.push(...imports.map((item) => `import { ${item.names.join(", ")} } from ${doubleQuote(item.from)};`).join("\n"));
+	out.push(content);
+	return out.join("\n\n");
 }
 function pageContent({ showTitle, showDescription, document, webhooks, operations }) {
 	const propStrs = [`document={${doubleQuote(document)}}`];

package/dist/utils/schema/sample.js

@@ -1,5 +1,5 @@
-import { require_deepmerge } from "../../node_modules/.pnpm/@fastify_deepmerge@3.2.1/node_modules/@fastify/deepmerge/index.js";
 import { isPlainObject } from "../is-plain-object.js";
+import { require_deepmerge } from "../../node_modules/.pnpm/@fastify_deepmerge@3.2.1/node_modules/@fastify/deepmerge/index.js";
 import { resolveRefSync } from "./resolve-ref.js";
 const mergeDeep = (0, require_deepmerge().deepmerge)({
 	all: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.8.5",
+  "version": "10.9.0",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -60,11 +60,11 @@
   "devDependencies": {
     "@fastify/deepmerge": "^3.2.1",
     "@scalar/api-client-react": "2.0.1",
-    "@scalar/json-magic": "^0.12.12",
+    "@scalar/json-magic": "^0.12.14",
     "@scalar/openapi-upgrader": "^0.2.7",
     "@tailwindcss/oxide": "^4.3.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "25.7.0",
+    "@types/node": "25.8.0",
     "@types/react": "^19.2.14",
     "ajv": "^8.20.0",
     "fast-content-type-parse": "^3.0.0",
@@ -72,15 +72,15 @@
     "tailwindcss": "^4.3.0",
     "tsdown": "0.22.0",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "16.8.11",
-    "fumadocs-ui": "16.8.11",
+    "fumadocs-core": "16.9.0",
+    "fumadocs-ui": "16.9.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "@scalar/api-client-react": "2.0.1",
     "@types/react": "*",
-    "fumadocs-core": "^16.7.15",
-    "fumadocs-ui": "^16.7.15",
+    "fumadocs-core": "^16.9.0",
+    "fumadocs-ui": "^16.9.0",
     "json-schema-typed": "*",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
@@ -98,8 +98,8 @@
   },
   "inlinedDependencies": {
     "@fastify/deepmerge": "3.2.1",
-    "@scalar/helpers": "0.6.0",
-    "@scalar/json-magic": "0.12.12",
+    "@scalar/helpers": "0.8.0",
+    "@scalar/json-magic": "0.12.14",
     "@scalar/openapi-upgrader": "0.2.7",
     "ajv": "8.20.0",
     "fast-content-type-parse": "3.0.0",

package/dist/node_modules/.pnpm/@scalar_json-magic@0.12.12/node_modules/@scalar/json-magic/dist/helpers/normalize.js

@@ -1,26 +0,0 @@
-import { parse } from "../../../../../../yaml@2.9.0/node_modules/yaml/browser/dist/public-api.js";
-import "../../../../../../yaml@2.9.0/node_modules/yaml/browser/index.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.12/node_modules/@scalar/json-magic/dist/helpers/normalize.js
-/**
-* Normalize a string (YAML, JSON, object) to a JavaScript datatype.
-*/
-function normalize(content) {
-	if (content === null) return;
-	if (typeof content === "string") {
-		if (content.trim() === "") return;
-		try {
-			return JSON.parse(content);
-		} catch (_error) {
-			const hasColon = /^[^:]+:/.test(content);
-			const isJson = content.slice(0, 50).trimStart().startsWith("{");
-			if (!hasColon || isJson) return;
-			return parse(content, {
-				maxAliasCount: 1e4,
-				merge: true
-			});
-		}
-	}
-	return content;
-}
-//#endregion
-export { normalize };