@farming-labs/next 0.2.117 → 0.2.119

package/dist/api-reference.d.mts

@@ -1,5 +1,5 @@
 import { DocsConfig } from "@farming-labs/docs";
-import { resolveApiReferenceConfig } from "@farming-labs/docs/server";
+import { resolveApiReferenceConfig } from "@farming-labs/docs/runtime";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/api-reference.d.ts

package/dist/api-reference.mjs

@@ -1,9 +1,10 @@
 import DocsClientCallbacks from "./client-callbacks.mjs";
+import FumadocsOpenAPIPage from "./fumadocs-api-page.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join, relative } from "node:path";
 import { resolveDocsMetadataBaseUrl } from "@farming-labs/docs";
-import { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname } from "@farming-labs/docs/server";
 import { ApiReference } from "@scalar/nextjs-api-reference";
+import { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname } from "@farming-labs/docs/runtime";
 import { SidebarTabsDropdown } from "fumadocs-ui/components/sidebar/tabs/dropdown";
 import Link from "next/link";
 import { notFound } from "next/navigation";
@@ -13,7 +14,15 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 const ROUTE_FILE_RE = /^route\.(ts|tsx|js|jsx)$/;
 const METHOD_RE = /export\s+(?:async\s+function|function|const)\s+(GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD)\b/g;
 function getNextAppDir(root) {
-	if (existsSync(join(root, "src", "app"))) return "src/app";
+	if (existsSync(
+		/* turbopackIgnore: true */
+		join(
+			/* turbopackIgnore: true */
+			root,
+			"src",
+			"app"
+		)
+	)) return "src/app";
 	return "app";
 }
 function normalizeRouteRoot(value) {
@@ -31,8 +40,17 @@ function getRoutePathBase(config) {
 }
 function resolveNextApiRouteRoot(root, config) {
 	const routeRoot = normalizeRouteRoot(config.routeRoot);
-	if (routeRoot === "app" || routeRoot.startsWith("app/") || routeRoot === "src/app" || routeRoot.startsWith("src/app/")) return join(root, ...routeRoot.split("/"));
-	return join(root, getNextAppDir(root), ...routeRoot.split("/"));
+	if (routeRoot === "app" || routeRoot.startsWith("app/") || routeRoot === "src/app" || routeRoot.startsWith("src/app/")) return join(
+		/* turbopackIgnore: true */
+		root,
+		...routeRoot.split("/")
+	);
+	return join(
+		/* turbopackIgnore: true */
+		root,
+		getNextAppDir(root),
+		...routeRoot.split("/")
+	);
 }
 function shouldExcludeRoute(excludes, routePath, relativeFile, relativeDir) {
 	if (excludes.length === 0) return false;
@@ -78,11 +96,24 @@ function extractMethods(source) {
 	return Array.from(methods);
 }
 function scanRouteFiles(dir) {
-	if (!existsSync(dir)) return [];
+	if (!existsSync(
+		/* turbopackIgnore: true */
+		dir
+	)) return [];
 	const results = [];
-	for (const name of readdirSync(dir)) {
-		const full = join(dir, name);
-		if (statSync(full).isDirectory()) {
+	for (const name of readdirSync(
+		/* turbopackIgnore: true */
+		dir
+	)) {
+		const full = join(
+			/* turbopackIgnore: true */
+			dir,
+			name
+		);
+		if (statSync(
+			/* turbopackIgnore: true */
+			full
+		).isDirectory()) {
 			results.push(...scanRouteFiles(full));
 			continue;
 		}
@@ -160,7 +191,11 @@ function buildApiReferenceRoutes(config) {
 	const excludes = apiReference.exclude;
 	const routes = [];
 	for (const file of files) {
-		const source = readFileSync(file, "utf-8");
+		const source = readFileSync(
+			/* turbopackIgnore: true */
+			file,
+			"utf-8"
+		);
 		const methods = extractMethods(source);
 		if (methods.length === 0) continue;
 		const relativeFile = relative(apiDir, file).replace(/\\/g, "/");
@@ -503,30 +538,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;
@@ -617,11 +628,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: [
@@ -637,8 +648,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;
@@ -652,7 +662,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",
@@ -756,14 +766,14 @@ async function getNextApiReferenceSourceState(config, versionId) {
 		baseUrl,
 		version: version?.id
 	});
-	const server = createOpenAPI({ input: async () => ({ main: document }) });
+	const server = createOpenAPI({ input: { main: document } });
 	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}`);
 		}
 	}), {

package/dist/changelog.mjs

@@ -42,7 +42,15 @@ function truncatePaginationDescription(value, maxLength = 110) {
 }
 function extractChangelogToc(sourcePath) {
 	try {
-		return collectDocsMarkdownSections(readFileSync(join(process.cwd(), sourcePath), "utf-8")).filter((heading) => heading.level >= 2 && heading.level <= 4 && heading.heading).map((heading) => ({
+		return collectDocsMarkdownSections(readFileSync(
+			/* turbopackIgnore: true */
+			join(
+				/* turbopackIgnore: true */
+				process.cwd(),
+				sourcePath
+			),
+			"utf-8"
+		)).filter((heading) => heading.level >= 2 && heading.level <= 4 && heading.heading).map((heading) => ({
 			title: heading.heading,
 			url: `#${encodeURIComponent(heading.id)}`,
 			depth: heading.level

package/dist/config.mjs

@@ -2208,6 +2208,7 @@ function withDocs(nextConfig = {}, docsConfig) {
 		return resolvedConfig;
 	};
 	const existingTracingIncludes = nextConfig.outputFileTracingIncludes ?? {};
+	const existingTracingExcludes = nextConfig.outputFileTracingExcludes ?? {};
 	const docsTraceGlob = docsContentDir.replace(/\\/g, "/").replace(/^\.?\//, "") + "/**/*";
 	const sitemapManifestTraceFile = DEFAULT_SITEMAP_MANIFEST_PATH;
 	const docsContentRoot = isAbsolute(docsContentDir) ? docsContentDir : join(root, docsContentDir);
@@ -2233,6 +2234,21 @@ function withDocs(nextConfig = {}, docsConfig) {
 		])],
 		[DEFAULT_MCP_ROUTE]: [...new Set([...existingTracingIncludes[DEFAULT_MCP_ROUTE] ?? [], docsTraceGlob])]
 	};
+	nextConfig.outputFileTracingExcludes = {
+		...existingTracingExcludes,
+		"/api/docs": [...new Set([
+			...existingTracingExcludes["/api/docs"] ?? [],
+			"next.config.js",
+			"next.config.mjs",
+			"next.config.ts"
+		])],
+		[DEFAULT_MCP_ROUTE]: [...new Set([
+			...existingTracingExcludes[DEFAULT_MCP_ROUTE] ?? [],
+			"next.config.js",
+			"next.config.mjs",
+			"next.config.ts"
+		])]
+	};
 	return withMDX(nextConfig);
 }
 

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

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

package/dist/fumadocs-api-page.mjs

@@ -0,0 +1,35 @@
+"use client";
+
+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]
+	});
+}
+/** Client boundary for Fumadocs OpenAPI's interactive renderer. */
+const FumadocsOpenAPIPage = createOpenAPIPage({ content: { renderOperationLayout: renderApiReferenceOperationLayout } });
+
+//#endregion
+export { FumadocsOpenAPIPage as default };

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.117",
+  "version": "0.2.119",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -91,9 +91,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 +109,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/theme": "0.2.117",
-    "@farming-labs/docs": "0.2.117"
+    "@farming-labs/docs": "0.2.119",
+    "@farming-labs/theme": "0.2.119"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.2.73",