@farming-labs/next 0.2.118 → 0.2.120

package/dist/api-reference.d.mts

@@ -1,3 +1,4 @@
+import { FumadocsApiReferenceRendererOptions, fumadocsRenderer } from "./fumadocs-renderer.mjs";
 import { DocsConfig } from "@farming-labs/docs";
 import { resolveApiReferenceConfig } from "@farming-labs/docs/runtime";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
@@ -43,4 +44,4 @@ declare function createNextApiReferenceLayout(config: DocsConfig): (props: {
 declare function getNextApiReferenceSourceState(config: DocsConfig, versionId?: string): Promise<NextApiReferenceSourceState>;
 declare function getNextApiReferenceMode(config: DocsConfig): "farming-labs" | "fumadocs" | "scalar";
 //#endregion
-export { NextApiReferenceSourceState, buildNextOpenApiDocument, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, flattenApiReferencePageTreeForSidebar, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withNextApiReferenceBanner };
+export { type FumadocsApiReferenceRendererOptions, NextApiReferenceSourceState, buildNextOpenApiDocument, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, flattenApiReferencePageTreeForSidebar, fumadocsRenderer, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withNextApiReferenceBanner };

package/dist/api-reference.mjs

@@ -1,4 +1,6 @@
 import DocsClientCallbacks from "./client-callbacks.mjs";
+import FumadocsOpenAPIPage from "./fumadocs-api-page.mjs";
+import { fumadocsRenderer } from "./fumadocs-renderer.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join, relative } from "node:path";
 import { resolveDocsMetadataBaseUrl } from "@farming-labs/docs";
@@ -537,30 +539,6 @@ function flattenApiReferencePageTreeForSidebar(tree) {
 		children: nextChildren
 	};
 }
-function renderApiReferenceOperationLayout(slots) {
-	return /* @__PURE__ */ jsxs("div", {
-		className: "fd-api-reference-operation",
-		children: [/* @__PURE__ */ jsxs("div", {
-			className: "fd-api-reference-operation-main",
-			children: [
-				slots.header,
-				slots.apiPlayground,
-				slots.description ? /* @__PURE__ */ jsx("div", {
-					className: "fd-api-reference-operation-description",
-					children: slots.description
-				}) : null,
-				slots.authSchemes,
-				slots.parameters,
-				slots.body,
-				slots.responses,
-				slots.callbacks
-			]
-		}), slots.apiExample ? /* @__PURE__ */ jsx("div", {
-			className: "fd-api-reference-operation-example",
-			children: slots.apiExample
-		}) : null]
-	});
-}
 function withNextApiReferenceBanner(config) {
 	const apiReference = resolveApiReferenceConfig(config.apiReference);
 	if (!apiReference.enabled) return config;
@@ -651,11 +629,11 @@ function getOpenApiInfo(document) {
 }
 function createNextApiReferencePage(config) {
 	return async function NextApiReferencePage(props) {
-		const [{ createAPIPage }, { DocsDescription, DocsPage, DocsTitle }] = await Promise.all([import("fumadocs-openapi/ui"), import("fumadocs-ui/layouts/notebook/page")]);
+		const { DocsDescription, DocsPage, DocsTitle } = await import("fumadocs-ui/layouts/notebook/page");
 		const slug = (props?.params ? await props.params : void 0)?.slug ?? [];
 		const version = resolveApiReferenceVersion(resolveApiReferenceConfig(config.apiReference), slug[0]);
 		const pageSlug = version ? slug.slice(1) : slug;
-		const { info, pages, server, source } = await getNextApiReferenceSourceState(config, version?.id);
+		const { info, pages, source } = await getNextApiReferenceSourceState(config, version?.id);
 		if (pages.length === 0) return /* @__PURE__ */ jsxs(DocsPage, {
 			full: true,
 			children: [
@@ -671,8 +649,7 @@ function createNextApiReferencePage(config) {
 			]
 		});
 		const page = pageSlug.length === 0 ? pages[0] : source.getPage(pageSlug);
-		if (!page || typeof page.data?.getAPIPageProps !== "function") notFound();
-		const APIPage = createAPIPage(server, { content: { renderOperationLayout: renderApiReferenceOperationLayout } });
+		if (!page || typeof page.data?.getOpenAPIPageProps !== "function") notFound();
 		const currentPageIndex = pageSlug.length === 0 ? 0 : pages.findIndex((entry) => entry.url === page.url);
 		const previousPage = currentPageIndex > 0 ? pages[currentPageIndex - 1] : void 0;
 		const nextPage = currentPageIndex >= 0 && currentPageIndex < pages.length - 1 ? pages[currentPageIndex + 1] : void 0;
@@ -686,7 +663,7 @@ function createNextApiReferencePage(config) {
 				/* @__PURE__ */ jsx(DocsDescription, { children: typeof page.data.description === "string" && page.data.description.trim() ? page.data.description : info.description }),
 				/* @__PURE__ */ jsx("div", {
 					className: "fd-api-reference-body",
-					children: /* @__PURE__ */ jsx(APIPage, { ...page.data.getAPIPageProps() })
+					children: /* @__PURE__ */ jsx(FumadocsOpenAPIPage, { ...page.data.getOpenAPIPageProps() })
 				}),
 				previousPage || nextPage ? /* @__PURE__ */ jsxs("nav", {
 					className: "fd-api-reference-pagination",
@@ -790,14 +767,19 @@ async function getNextApiReferenceSourceState(config, versionId) {
 		baseUrl,
 		version: version?.id
 	});
-	const server = createOpenAPI({ input: async () => ({ main: document }) });
+	const fumadocsOptions = apiReference.renderer === "fumadocs" ? apiReference.rendererOptions : void 0;
+	const server = createOpenAPI({
+		input: { main: document },
+		disableCache: typeof fumadocsOptions?.disableCache === "boolean" ? fumadocsOptions.disableCache : void 0,
+		proxyUrl: typeof fumadocsOptions?.proxyUrl === "string" ? fumadocsOptions.proxyUrl : void 0
+	});
 	const info = getOpenApiInfo(document);
 	const source = loader(await openapiSource(server, {
 		per: "operation",
 		groupBy: "tag",
-		name(output, dereferenced) {
+		name(output) {
 			if (output.type !== "operation") return slugifyApiReferencePageName(output.item.name);
-			const operation = (dereferenced.paths?.[output.item.path])?.[output.item.method];
+			const operation = (this.document?.paths?.[output.item.path])?.[output.item.method];
 			return slugifyApiReferencePageName(typeof operation?.summary === "string" && operation.summary.trim() ? operation.summary : typeof operation?.operationId === "string" && operation.operationId.trim() ? operation.operationId : `${output.item.method} ${output.item.path}`);
 		}
 	}), {
@@ -819,4 +801,4 @@ function getNextApiReferenceMode(config) {
 }
 
 //#endregion
-export { buildNextOpenApiDocument, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, flattenApiReferencePageTreeForSidebar, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withNextApiReferenceBanner };
+export { buildNextOpenApiDocument, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, flattenApiReferencePageTreeForSidebar, fumadocsRenderer, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withNextApiReferenceBanner };

package/dist/config.mjs

@@ -731,11 +731,13 @@ function readApiReferenceConfig(root) {
 			const enabledMatch = block.match(/enabled\s*:\s*(true|false)/);
 			const pathMatch = block.match(/path\s*:\s*["']([^"']+)["']/);
 			const rendererMatch = block.match(/renderer\s*:\s*["'](farming-labs|fumadocs|scalar)["']/);
+			const rendererConfigNameMatch = extractObjectLiteral(block, "renderer")?.match(/name\s*:\s*["'](farming-labs|fumadocs|scalar)["']/);
+			const usesFumadocsRendererHelper = /renderer\s*:\s*fumadocsRenderer\s*\(/.test(block);
 			const routeRootMatch = block.match(/routeRoot\s*:\s*["']([^"']+)["']/);
 			return {
 				enabled: enabledMatch ? enabledMatch[1] !== "false" : true,
 				path: pathMatch?.[1]?.replace(/^\/+|\/+$/g, "") || "api-reference",
-				renderer: rendererMatch?.[1] ?? "farming-labs",
+				renderer: rendererMatch?.[1] ?? rendererConfigNameMatch?.[1] ?? (usesFumadocsRendererHelper ? "fumadocs" : void 0) ?? "farming-labs",
 				routeRoot: routeRootMatch?.[1]?.replace(/^\/+|\/+$/g, "") || "api"
 			};
 		} catch {

package/dist/fumadocs-api-page.d.mts

@@ -0,0 +1,11 @@
+import { DocsConfig } from "@farming-labs/docs";
+import * as react from "react";
+import * as fumadocs_openapi_ui0 from "fumadocs-openapi/ui";
+import { CreateOpenAPIPageOptions } from "fumadocs-openapi/ui";
+
+//#region src/fumadocs-api-page.d.ts
+declare function resolveFumadocsOpenAPIPageOptions(config: DocsConfig): CreateOpenAPIPageOptions;
+/** Client boundary for Fumadocs OpenAPI's interactive renderer. */
+declare const FumadocsOpenAPIPage: react.FC<fumadocs_openapi_ui0.OpenAPIPageProps>;
+//#endregion
+export { FumadocsOpenAPIPage as default, resolveFumadocsOpenAPIPageOptions };

package/dist/fumadocs-api-page.mjs

@@ -0,0 +1,49 @@
+"use client";
+
+import docsConfig from "@farming-labs/next-internal-docs-config";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { createOpenAPIPage } from "fumadocs-openapi/ui";
+
+//#region src/fumadocs-api-page.tsx
+function renderApiReferenceOperationLayout(slots) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "fd-api-reference-operation",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "fd-api-reference-operation-main",
+			children: [
+				slots.header,
+				slots.apiPlayground,
+				slots.description ? /* @__PURE__ */ jsx("div", {
+					className: "fd-api-reference-operation-description",
+					children: slots.description
+				}) : null,
+				slots.authSchemes,
+				slots.parameters,
+				slots.body,
+				slots.responses,
+				slots.callbacks
+			]
+		}), slots.apiExample ? /* @__PURE__ */ jsx("div", {
+			className: "fd-api-reference-operation-example",
+			children: slots.apiExample
+		}) : null]
+	});
+}
+function resolveFumadocsOpenAPIPageOptions(config) {
+	const renderer = config.apiReference && typeof config.apiReference === "object" ? config.apiReference.renderer : void 0;
+	const pageOptions = { ...renderer && typeof renderer === "object" && renderer.name === "fumadocs" ? renderer.options : void 0 };
+	delete pageOptions.disableCache;
+	delete pageOptions.proxyUrl;
+	return {
+		...pageOptions,
+		content: {
+			renderOperationLayout: renderApiReferenceOperationLayout,
+			...pageOptions.content
+		}
+	};
+}
+/** Client boundary for Fumadocs OpenAPI's interactive renderer. */
+const FumadocsOpenAPIPage = createOpenAPIPage(resolveFumadocsOpenAPIPageOptions(docsConfig));
+
+//#endregion
+export { FumadocsOpenAPIPage as default, resolveFumadocsOpenAPIPageOptions };

package/dist/fumadocs-renderer.d.mts

@@ -0,0 +1,13 @@
+import { ApiReferenceRendererConfig } from "@farming-labs/docs";
+import { CreateOpenAPIPageOptions } from "fumadocs-openapi/ui";
+import { OpenAPIOptions } from "fumadocs-openapi/server";
+
+//#region src/fumadocs-renderer.d.ts
+/** Options supported by the bundled Fumadocs OpenAPI renderer. */
+type FumadocsApiReferenceRendererOptions = CreateOpenAPIPageOptions & Pick<OpenAPIOptions, "disableCache" | "proxyUrl">;
+/**
+ * Configure the bundled Fumadocs OpenAPI renderer with fully typed upstream options.
+ */
+declare function fumadocsRenderer(options?: FumadocsApiReferenceRendererOptions): ApiReferenceRendererConfig;
+//#endregion
+export { FumadocsApiReferenceRendererOptions, fumadocsRenderer };

package/dist/fumadocs-renderer.mjs

@@ -0,0 +1,13 @@
+//#region src/fumadocs-renderer.ts
+/**
+* Configure the bundled Fumadocs OpenAPI renderer with fully typed upstream options.
+*/
+function fumadocsRenderer(options = {}) {
+	return {
+		name: "fumadocs",
+		options: { ...options }
+	};
+}
+
+//#endregion
+export { fumadocsRenderer };

package/dist/layout.mjs

@@ -79,7 +79,7 @@ function createNextDocsMetadata(config) {
 }
 function createNextDocsLayout(config) {
 	emitDocsTelemetryProjectEvent(config, { framework: "next" });
-	const DocsLayout = createDocsLayout(withNextApiReferenceBanner(config));
+	const DocsLayout = createDocsLayout(withNextApiReferenceBanner(config), { telemetryFramework: "next" });
 	return function NextDocsLayout({ children }) {
 		const docsCloud = resolveNextDocsCloudClientOptions(config);
 		return /* @__PURE__ */ jsxs(Fragment, { children: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.2.118",
+  "version": "0.2.120",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -29,6 +29,11 @@
       "default": "./dist/api-reference.mjs"
     },
     "./api-reference.css": "./styles/api-reference.css",
+    "./fumadocs-renderer": {
+      "types": "./dist/fumadocs-renderer.d.mts",
+      "import": "./dist/fumadocs-renderer.mjs",
+      "default": "./dist/fumadocs-renderer.mjs"
+    },
     "./api": {
       "types": "./dist/api.d.mts",
       "import": "./dist/api.mjs",
@@ -91,9 +96,9 @@
     "@mdx-js/react": "^3.1.0",
     "@next/mdx": "^16.1.6",
     "@scalar/nextjs-api-reference": "0.10.3",
-    "fumadocs-openapi": "10.7.0",
-    "fumadocs-core": "16.7.16",
-    "fumadocs-ui": "16.7.16",
+    "fumadocs-core": "16.17.1",
+    "fumadocs-openapi": "12.4.1",
+    "fumadocs-ui": "16.17.1",
     "gray-matter": "^4.0.3",
     "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.1",
@@ -109,8 +114,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/docs": "0.2.118",
-    "@farming-labs/theme": "0.2.118"
+    "@farming-labs/docs": "0.2.120",
+    "@farming-labs/theme": "0.2.120"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.2.73",