@farming-labs/next 0.2.119 → 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,5 +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";
@@ -766,7 +767,12 @@ async function getNextApiReferenceSourceState(config, versionId) {
 		baseUrl,
 		version: version?.id
 	});
-	const server = createOpenAPI({ input: { 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",
@@ -795,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

@@ -1,8 +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 };
+export { FumadocsOpenAPIPage as default, resolveFumadocsOpenAPIPageOptions };

package/dist/fumadocs-api-page.mjs

@@ -1,5 +1,6 @@
 "use client";
 
+import docsConfig from "@farming-labs/next-internal-docs-config";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { createOpenAPIPage } from "fumadocs-openapi/ui";
 
@@ -28,8 +29,21 @@ function renderApiReferenceOperationLayout(slots) {
 		}) : 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({ content: { renderOperationLayout: renderApiReferenceOperationLayout } });
+const FumadocsOpenAPIPage = createOpenAPIPage(resolveFumadocsOpenAPIPageOptions(docsConfig));
 
 //#endregion
-export { FumadocsOpenAPIPage as default };
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.2.119",
+  "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",
@@ -109,8 +114,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/docs": "0.2.119",
-    "@farming-labs/theme": "0.2.119"
+    "@farming-labs/docs": "0.2.120",
+    "@farming-labs/theme": "0.2.120"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.2.73",