fumadocs-openapi 10.10.3 → 11.0.0

package/dist/playground/status-info.js

@@ -1,52 +1,44 @@
-import { useTranslations } from "../ui/client/i18n.js";
 import { useMemo } from "react";
 import { CircleCheck, CircleX } from "lucide-react";
+import { useTranslations } from "@fuma-translate/react";
 //#region src/playground/status-info.tsx
-const statusKeys = {
-	400: {
-		key: "statusBadRequest",
-		color: "text-red-500",
-		icon: CircleX
-	},
-	401: {
-		key: "statusUnauthorized",
-		color: "text-red-500",
-		icon: CircleX
-	},
-	403: {
-		key: "statusForbidden",
-		color: "text-red-500",
-		icon: CircleX
-	},
-	404: {
-		key: "statusNotFound",
-		color: "text-fd-muted-foreground",
-		icon: CircleX
-	},
-	500: {
-		key: "statusInternalServerError",
-		color: "text-red-500",
-		icon: CircleX
-	}
-};
 function useStatusInfo(status) {
-	const t = useTranslations();
+	const t = useTranslations({ note: "playground status info" });
 	return useMemo(() => {
-		if (status in statusKeys) {
-			const { key, color, icon } = statusKeys[status];
-			return {
-				description: t[key],
-				color,
-				icon
+		switch (status) {
+			case 400: return {
+				description: t("Bad Request"),
+				color: "text-red-500",
+				icon: CircleX
+			};
+			case 401: return {
+				description: t("Unauthorized"),
+				color: "text-red-500",
+				icon: CircleX
+			};
+			case 403: return {
+				description: t("Forbidden"),
+				color: "text-red-500",
+				icon: CircleX
+			};
+			case 404: return {
+				description: t("Not Found"),
+				color: "text-fd-muted-foreground",
+				icon: CircleX
+			};
+			case 500: return {
+				description: t("Internal Server Error"),
+				color: "text-red-500",
+				icon: CircleX
 			};
 		}
 		if (status >= 200 && status < 300) return {
-			description: t.statusSuccessful,
+			description: t("Successful"),
 			color: "text-green-500",
 			icon: CircleCheck
 		};
 		if (status >= 400) return {
-			description: t.statusError,
+			description: t("Error"),
 			color: "text-red-500",
 			icon: CircleX
 		};

package/dist/requests/generators/csharp.js

@@ -5,7 +5,7 @@ import "../media/adapter.js";
 const csharp = {
 	label: "C#",
 	lang: "csharp",
-	generate(url, data, { mediaAdapters }) {
+	generate(data, { mediaAdapters }) {
 		const s = [];
 		const imports = new Set([
 			"System",
@@ -32,8 +32,8 @@ const csharp = {
 		if (Object.keys(data.cookie).length > 0) addHeader("cookie", Object.entries(data.cookie).map(([key, param]) => `${key}=${param.value}`).join("; "));
 		s.push(...headerLines);
 		const method = data.method[0].toUpperCase() + data.method.slice(1).toLowerCase() + "Async";
-		if (body) s.push(`var response = await client.${method}("${url}", body);`);
-		else s.push(`var response = await client.${method}("${url}");`);
+		if (body) s.push(`var response = await client.${method}("${data.url}", body);`);
+		else s.push(`var response = await client.${method}("${data.url}");`);
 		s.push("var responseBody = await response.Content.ReadAsStringAsync();");
 		return s.join("\n");
 	}

package/dist/requests/generators/curl.js

@@ -3,9 +3,9 @@ import { doubleQuote, indent, inputToString, singleQuote } from "../string-utils
 const curl = {
 	label: "cURL",
 	lang: "bash",
-	generate(url, data) {
+	generate(data) {
 		const s = [];
-		s.push(`curl -X ${data.method.toUpperCase()} "${url}"`);
+		s.push(`curl -X ${data.method.toUpperCase()} "${data.url}"`);
 		for (const header in data.header) {
 			const value = `${header}: ${data.header[header].value}`;
 			s.push(`-H "${value}"`);

package/dist/requests/generators/go.js

@@ -5,7 +5,7 @@ import "../media/adapter.js";
 const go = {
 	label: "Go",
 	lang: "go",
-	generate(url, data, { mediaAdapters }) {
+	generate(data, { mediaAdapters }) {
 		const imports = [
 			"fmt",
 			"net/http",
@@ -13,7 +13,7 @@ const go = {
 		];
 		const headers = /* @__PURE__ */ new Map();
 		const variables = /* @__PURE__ */ new Map();
-		variables.set("url", doubleQuote(url));
+		variables.set("url", doubleQuote(data.url));
 		for (const header in data.header) headers.set(header, doubleQuote(data.header[header].value));
 		const cookies = Object.entries(data.cookie);
 		if (cookies.length > 0) headers.set("Cookie", doubleQuote(cookies.map(([k, param]) => `${k}=${param.value}`).join("; ")));

package/dist/requests/generators/index.d.ts

@@ -1,55 +1,42 @@
 import { MediaAdapter } from "../media/adapter.js";
 import { RequestData } from "../types.js";
+import * as Shared from "@fumadocs/api-docs/codegen";
 
 //#region src/requests/generators/index.d.ts
-interface CodeUsageGeneratorRegistry {
-  add: (id: string, generator: CodeUsageGenerator) => void;
-  get: (id: string) => CodeUsageGenerator | undefined;
-  addInline: (generator: InlineCodeUsageGenerator) => void;
-  /**
-   * @returns if the generator is removed
-   */
-  remove: (id: string) => boolean;
-  map: () => Map<string, CodeUsageGenerator>;
-}
+declare function pathnameFromRequest(pathname: string, {
+  path,
+  query
+}: RequestData): string;
+type CodeUsageGeneratorRegistry = Shared.CodeUsageGeneratorRegistry<RequestData & {
+  url: string;
+}, {
+  mediaAdapters: Record<string, MediaAdapter>;
+  custom: unknown;
+}>;
 /**
  * Generate code example for given programming language
  */
-interface CodeUsageGenerator {
-  generate: CodeUsageGeneratorFn;
-  lang: string;
-  label?: string;
-  /**
-   * for inline generators passed from server, this stores info available for client (e.g. forwarded from "use client").
-   */
-  _client?: {
-    generate: string | CodeUsageGeneratorFn;
-    serverContext?: unknown;
-  };
-}
+type CodeUsageGenerator = Shared.CodeUsageGenerator<RequestData & {
+  url: string;
+}, {
+  mediaAdapters: Record<string, MediaAdapter>;
+  custom: unknown;
+}>;
 /**
  * Generate code example for given programming language
  */
-interface InlineCodeUsageGenerator<T = unknown> {
-  id?: string;
-  lang: string;
-  label?: string;
-  /**
-   * either:
-   * - code
-   * - a function imported from a file with "use client" directive
-   * - false (disabled)
-   */
-  source?: string | CodeUsageGeneratorFn<T> | false;
-  /**
-   * Pass extra context to client-side source generator
-   */
-  serverContext?: T;
-}
+type InlineCodeUsageGenerator<T = unknown> = Shared.InlineCodeUsageGenerator<RequestData & {
+  url: string;
+}, {
+  mediaAdapters: Record<string, MediaAdapter>;
+  custom: T;
+}>;
 declare function createCodeUsageGeneratorRegistry(inherit?: CodeUsageGeneratorRegistry): CodeUsageGeneratorRegistry;
-type CodeUsageGeneratorFn<ServerContext = unknown> = (url: string, data: RequestData, context: {
+type CodeUsageGeneratorFn<T = unknown> = (data: RequestData & {
+  url: string;
+}, context: {
   mediaAdapters: Record<string, MediaAdapter>;
-  server: ServerContext;
+  custom: T;
 }) => string;
 //#endregion
-export { CodeUsageGenerator, CodeUsageGeneratorFn, CodeUsageGeneratorRegistry, InlineCodeUsageGenerator, createCodeUsageGeneratorRegistry };
+export { CodeUsageGenerator, CodeUsageGeneratorFn, CodeUsageGeneratorRegistry, InlineCodeUsageGenerator, createCodeUsageGeneratorRegistry, pathnameFromRequest };

package/dist/requests/generators/index.js

@@ -1,39 +1,22 @@
+import * as Shared from "@fumadocs/api-docs/codegen";
 //#region src/requests/generators/index.ts
+function pathnameFromRequest(pathname, { path, query }) {
+	for (const key in path) {
+		const param = path[key];
+		pathname = pathname.replace(`{${key}}`, param.value);
+	}
+	const [pathPart, existingQueryString] = pathname.split("?", 2);
+	const searchParams = new URLSearchParams(existingQueryString || "");
+	for (const key in query) {
+		const param = query[key];
+		if (!param || param.values.length === 0) continue;
+		searchParams.delete(key);
+		for (const item of param.values) searchParams.append(key, item);
+	}
+	return searchParams.size > 0 ? `${pathPart}?${searchParams}` : pathPart;
+}
 function createCodeUsageGeneratorRegistry(inherit) {
-	const registry = new Map(inherit?.map());
-	return {
-		add(id, generator) {
-			registry.set(id, generator);
-		},
-		get(id) {
-			return registry.get(id);
-		},
-		addInline(generator) {
-			const source = generator.source;
-			const id = generator.id ?? generator.lang;
-			if (!source) {
-				this.remove(id);
-				return;
-			}
-			registry.set(id, {
-				lang: generator.lang,
-				label: generator.label,
-				generate() {
-					return typeof source === "string" ? source : "";
-				},
-				_client: {
-					generate: source,
-					serverContext: generator.serverContext
-				}
-			});
-		},
-		remove(id) {
-			return registry.delete(id);
-		},
-		map() {
-			return registry;
-		}
-	};
+	return Shared.createCodeUsageGeneratorRegistry(inherit);
 }
 //#endregion
-export { createCodeUsageGeneratorRegistry };
+export { createCodeUsageGeneratorRegistry, pathnameFromRequest };

package/dist/requests/generators/java.js

@@ -5,7 +5,7 @@ import "../media/adapter.js";
 const java = {
 	label: "Java",
 	lang: "java",
-	generate(url, data, { mediaAdapters }) {
+	generate(data, { mediaAdapters }) {
 		const s = [];
 		const headers = { ...data.header };
 		const imports = new Set([
@@ -31,7 +31,7 @@ const java = {
 		s.push(indent(".build();"));
 		s.push("");
 		s.push("HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()");
-		s.push(indent(`.uri(URI.create(${doubleQuote(url)}))`));
+		s.push(indent(`.uri(URI.create(${doubleQuote(data.url)}))`));
 		for (const [key, param] of Object.entries(headers)) s.push(indent(`.header(${doubleQuote(key)}, ${doubleQuote(param.value)})`));
 		if (data.bodyMediaType) s.push(indent(`.header("Content-Type", "${data.bodyMediaType}")`));
 		const cookies = Object.entries(data.cookie);

package/dist/requests/generators/javascript.js

@@ -5,7 +5,7 @@ import "../media/adapter.js";
 const javascript = {
 	label: "JavaScript",
 	lang: "js",
-	generate(url, data, { mediaAdapters }) {
+	generate(data, { mediaAdapters }) {
 		const s = [];
 		const options = /* @__PURE__ */ new Map();
 		const headers = {};
@@ -26,7 +26,7 @@ const javascript = {
 			s.push(body);
 			options.set("body", "body");
 		}
-		const params = [doubleQuote(url)];
+		const params = [doubleQuote(data.url)];
 		if (options.size > 0) {
 			const str = Array.from(options.entries()).map(([k, v]) => indent(k === v ? k : `${k}: ${v}`)).join(",\n");
 			params.push(`{\n${str}\n}`);

package/dist/requests/generators/python.js

@@ -5,7 +5,7 @@ import "../media/adapter.js";
 const python = {
 	label: "Python",
 	lang: "python",
-	generate(url, data, { mediaAdapters }) {
+	generate(data, { mediaAdapters }) {
 		const headers = {};
 		const imports = /* @__PURE__ */ new Set();
 		const params = [`"${data.method.toUpperCase()}"`, "url"];
@@ -27,7 +27,7 @@ const python = {
 		}
 		return `${Array.from(imports).map((name) => "import " + name).join("\n")}
 
-url = ${doubleQuote(url)}
+url = ${doubleQuote(data.url)}
 ${body ?? ""}
 response = requests.request(${params.join(", ")})
 

package/dist/scalar/client.js

@@ -1,9 +1,9 @@
 "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";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useTranslations } from "@fuma-translate/react";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
 import { useApiClient } from "@scalar/api-client-react";
 import { useTheme } from "fumadocs-ui/provider/base";
@@ -11,6 +11,7 @@ import "@scalar/api-client-react/style.css";
 //#region src/scalar/client.tsx
 function ScalarPlayground({ path, method, spec }) {
 	const { resolvedTheme } = useTheme();
+	const t = useTranslations({ note: "scalar API client" });
 	const [mounted, setMounted] = useState(false);
 	const client = useApiClient({ configuration: { content: spec } });
 	useEffect(() => {
@@ -37,7 +38,7 @@ function ScalarPlayground({ path, method, spec }) {
 					path,
 					method
 				}),
-				children: /* @__PURE__ */ jsx(I18nLabel, { label: "test" })
+				children: t("Test")
 			})
 		]
 	});

package/dist/scalar/index.d.ts

@@ -1,4 +1,4 @@
-import { CreateAPIPageOptions } from "../ui/index.js";
+import { CreateOpenAPIPageOptions } from "../ui/index.js";
 
 //#region src/scalar/index.d.ts
 /**
@@ -6,6 +6,6 @@ import { CreateAPIPageOptions } from "../ui/index.js";
  *
  * Requires `@scalar/api-client-react` to be installed, it imports the styles automatically.
  */
-declare function withScalar(options?: CreateAPIPageOptions): CreateAPIPageOptions;
+declare function withScalar(options?: CreateOpenAPIPageOptions): CreateOpenAPIPageOptions;
 //#endregion
 export { withScalar };

package/dist/scalar/index.js

@@ -1,14 +1,8 @@
+"use client";
 import { lazy } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/scalar/index.tsx
 const Client = lazy(() => import("./client.js"));
-function APIPlayground({ path, method, ctx }) {
-	return /* @__PURE__ */ jsx(Client, {
-		method: method.method,
-		path,
-		spec: ctx.schema.bundled
-	});
-}
 /**
 * Enable Scalar for API playgrounds by wrapping your options inside.
 *
@@ -19,8 +13,15 @@ function withScalar(options = {}) {
 		...options,
 		playground: {
 			...options.playground,
-			render(props) {
-				return /* @__PURE__ */ jsx(APIPlayground, { ...props });
+			provider(props) {
+				return props.children;
+			},
+			render({ method, path, ctx }) {
+				return /* @__PURE__ */ jsx(Client, {
+					method,
+					path,
+					spec: ctx.schema.bundled
+				});
 			}
 		}
 	};

package/dist/server/index.d.ts

@@ -1,29 +1,27 @@
-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 { OpenAPIPageProps_Preloaded, OpenAPIPageProps_Spec } from "../ui/index.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 { Awaitable, Document } from "../types.js";
+import { DynamicSource, LoaderPlugin, MetaData, Page, PageData, 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
+ * schema ID -> file path, URL, downloaded schema object, or a function returning them
  */
-type SchemaMap = Record<string, string | Document>;
-type ProcessedSchemaMap = Record<string, ProcessedDocument>;
+type SchemaRecord = Record<string, string | Document | (() => Awaitable<string | Document>)>;
+interface LoadedDocument {
+  bundled: Document;
+}
 interface OpenAPIOptions {
   /**
    * Schema files, can be:
    * - URL
    * - file path
-   * - a function returning records of downloaded schemas.
+   * - a schema record object
    */
-  input?: string[] | (() => SchemaMap | Promise<SchemaMap>);
+  input?: string[] | SchemaRecord;
   disableCache?: boolean;
   /**
    * The url of proxy to avoid CORS issues
@@ -32,8 +30,8 @@ interface OpenAPIOptions {
 }
 interface OpenAPIServer {
   createProxy: typeof createProxy;
-  getSchemas: () => Promise<ProcessedSchemaMap>;
-  getSchema: (document: string) => Promise<ProcessedDocument>;
+  getSchemas: () => Promise<Record<string, LoadedDocument>>;
+  getSchema: (document: string) => Promise<LoadedDocument>;
   readonly options: OpenAPIOptions;
   /**
    * Generate virtual pages for Fumadocs Source API
@@ -49,6 +47,7 @@ interface OpenAPIServer {
     metaData: MetaData;
     pageData: OpenAPIPageData;
   }>;
+  preloadOpenAPIPage: <Type extends string | undefined, Data extends PageData>(page: Page<Type, Data>) => Promise<Pick<OpenAPIPageProps_Preloaded, 'preloaded'>>;
   /**
    * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
    */
@@ -57,14 +56,18 @@ interface OpenAPIServer {
   _getWatchPaths: () => string[];
 }
 interface OpenAPIPageData extends PageData {
-  getAPIPageProps: () => ApiPageProps;
+  getOpenAPIPageProps: () => OpenAPIPageProps_Spec;
   getSchema: () => {
     id: string;
-  } & DereferencedDocument;
-  getClientAPIPageProps: () => Promise<ClientApiPageProps>;
+    bundled: Document;
+  };
   structuredData: StructuredData;
   toc: TOCItemType[];
-  _openapi?: InternalOpenAPIMeta;
+  _openapi: InternalOpenAPIMeta;
+  /** @deprecated use `getOpenAPIPageProps()` instead */
+  getAPIPageProps: () => OpenAPIPageProps_Spec;
+  /** @deprecated use `getOpenAPIPageProps()` instead */
+  getClientAPIPageProps: () => OpenAPIPageProps_Spec;
 }
 type OpenAPISourceOptions = SchemaToPagesOptions & {
   baseDir?: string; /** Generate `meta.json` files */
@@ -73,14 +76,11 @@ type OpenAPISourceOptions = SchemaToPagesOptions & {
   };
 };
 declare function createOpenAPI(options?: OpenAPIOptions): OpenAPIServer;
-/**
- * @deprecated
- */
-declare function createCodeSample<T>(options: InlineCodeUsageGenerator<T>): InlineCodeUsageGenerator<T>;
 interface InternalOpenAPIMeta {
   method?: string;
   webhook?: boolean;
   deprecated?: boolean;
+  preload?: string[];
 }
 /**
  * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
@@ -93,9 +93,5 @@ declare function openapiSource(server: OpenAPIServer, options?: OpenAPISourceOpt
   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 };
+export { type CreateProxyOptions, InternalOpenAPIMeta, OpenAPIOptions, OpenAPIPageData, type OpenAPIPageProps_Preloaded, type OpenAPIPageProps_Spec, OpenAPIServer, OpenAPISourceOptions, type Proxy, createOpenAPI, openapiPlugin, openapiSource };

package/dist/server/index.js

@@ -2,23 +2,35 @@ 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 { loadDocument } from "../utils/document/load.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);
+	const { disableCache = false } = options;
+	const schemaMap = /* @__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;
+	function getSchema(schemaId) {
+		if (!(schemaId in resolvedInput)) {
+			console.warn(`[Fumadocs OpenAPI] the document "${schemaId}" is not listed in the input array, this may be unexpected and won't be cached properly.`);
+			return loadDocument(schemaId);
+		}
+		if (!disableCache) {
+			const cached = schemaMap.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);
+		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) {
 		const { baseDir = "", meta = false } = options;
@@ -28,7 +40,7 @@ function createOpenAPI(options = {}) {
 		const schemas = await server.getSchemas();
 		const builderOptions = createAutoPreset(options);
 		for (const [id, schema] of Object.entries(schemas)) {
-			onEntries(fromSchema(id, schema, builderOptions));
+			onEntries(fromSchema(id, schema.bundled, builderOptions));
 			function onEntry(entry) {
 				const props = getPageProps(entry);
 				files.push({
@@ -37,9 +49,12 @@ function createOpenAPI(options = {}) {
 					data: {
 						...entry.info,
 						getAPIPageProps() {
-							return props;
+							return this.getOpenAPIPageProps();
+						},
+						getClientAPIPageProps() {
+							return this.getOpenAPIPageProps();
 						},
-						async getClientAPIPageProps() {
+						getOpenAPIPageProps() {
 							return {
 								payload: {
 									bundled: schema.bundled,
@@ -51,10 +66,10 @@ function createOpenAPI(options = {}) {
 						getSchema() {
 							return {
 								id,
-								...schema
+								bundled: schema.bundled
 							};
 						},
-						...toStaticData(props, schema.dereferenced),
+						...toStaticData(props, schema.bundled),
 						_openapi: {
 							method: entry.type === "operation" || entry.type === "webhook" ? entry.item.method : void 0,
 							webhook: entry.type === "webhook",
@@ -100,18 +115,19 @@ function createOpenAPI(options = {}) {
 		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);
+			return Object.keys(resolvedInput).filter((key) => !URL.canParse(key) && fs.existsSync(key));
 		},
-		async getSchemas() {
-			if (disableCache) return getSchemas();
-			return schemas ??= getSchemas();
+		async preloadOpenAPIPage(page) {
+			const out = {
+				docs: {},
+				proxyUrl: options.proxyUrl
+			};
+			const openapiMeta = page.data._openapi;
+			if (openapiMeta?.preload) out.docs = Object.fromEntries(await Promise.all(openapiMeta.preload.map(async (k) => [k, (await getSchema(k)).bundled])));
+			return { preloaded: out };
 		},
+		getSchema,
+		getSchemas,
 		async staticSource(options = {}) {
 			return { files: await getVirtualFiles(this, options) };
 		},
@@ -124,12 +140,6 @@ function createOpenAPI(options = {}) {
 	};
 }
 /**
-* @deprecated
-*/
-function createCodeSample(options) {
-	return options;
-}
-/**
 * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
 */
 function openapiPlugin() {
@@ -172,11 +182,5 @@ function openapiPlugin() {
 async function openapiSource(server, options = {}) {
 	return server.staticSource(options);
 }
-/**
-* @deprecated use `openapiPlugin()`
-*/
-function transformerOpenAPI() {
-	return openapiPlugin().transformPageTree;
-}
 //#endregion
-export { createCodeSample, createOpenAPI, openapiPlugin, openapiSource, transformerOpenAPI };
+export { createOpenAPI, openapiPlugin, openapiSource };

package/dist/server/proxy.d.ts

@@ -5,12 +5,6 @@ interface Proxy extends Record<(typeof methods)[number], Handler> {
   handle: Handler;
 }
 interface CreateProxyOptions {
-  /**
-   * Filter by prefixes of request url
-   *
-   * @deprecated Use `allowedOrigins` for filtering origins, or `filterRequest` for more detailed rules.
-   */
-  allowedUrls?: string[];
   /**
    * List of allowed origins to proxy to.
    */