fumadocs-openapi 10.8.5 → 10.8.6

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.8.5",
+  "version": "10.8.6",
   "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,8 +72,8 @@
     "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.8.12",
+    "fumadocs-ui": "16.8.12",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -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 };

package/dist/server/create.d.ts

@@ -1,40 +0,0 @@
-import { InlineCodeUsageGenerator } from "../requests/generators/index.js";
-import { createProxy } from "./proxy.js";
-import { ProcessedDocument } from "../utils/document/process.js";
-import { Document } from "../types.js";
-
-//#region src/server/create.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>;
-  /** @private internal API */
-  _getWatchPaths: () => string[];
-  readonly options: OpenAPIOptions;
-}
-declare function createOpenAPI(options?: OpenAPIOptions): OpenAPIServer;
-/**
- * @deprecated
- */
-declare function createCodeSample<T>(options: InlineCodeUsageGenerator<T>): InlineCodeUsageGenerator<T>;
-//#endregion
-export { OpenAPIOptions, OpenAPIServer, createCodeSample, createOpenAPI };

package/dist/server/create.js

@@ -1,42 +0,0 @@
-import { createProxy } from "./proxy.js";
-import { processDocument } from "../utils/document/process.js";
-import fs from "node:fs";
-//#region src/server/create.ts
-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);
-		}
-	}
-	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();
-		}
-	};
-}
-/**
-* @deprecated
-*/
-function createCodeSample(options) {
-	return options;
-}
-//#endregion
-export { createCodeSample, createOpenAPI };

package/dist/server/source-api.d.ts

@@ -1,55 +0,0 @@
-import { OpenAPIServer } from "./create.js";
-import { ApiPageProps } from "../ui/api-page.js";
-import { SchemaToPagesOptions } from "../utils/pages/preset-auto.js";
-import { ClientApiPageProps } from "../ui/create-client.js";
-import { DereferencedDocument } from "../utils/document/dereference.js";
-import { LoaderPlugin, MetaData, PageData, PageTreeTransformer, Source } from "fumadocs-core/source";
-import { StructuredData } from "fumadocs-core/mdx-plugins";
-import { TOCItemType } from "fumadocs-core/toc";
-
-//#region src/server/source-api.d.ts
-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;
-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';
-  };
-};
-/**
- * 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 { InternalOpenAPIMeta, OpenAPIPageData, OpenAPISourceOptions, openapiPlugin, openapiSource, transformerOpenAPI };