@farming-labs/next 0.1.2 → 0.1.4

package/dist/api.d.mts

@@ -0,0 +1,23 @@
+import { createDocsAPI as createDocsAPI$1, createDocsMCPAPI as createDocsMCPAPI$1 } from "@farming-labs/theme/api";
+
+//#region src/api.d.ts
+type DocsAPIOptions = NonNullable<Parameters<typeof createDocsAPI$1>[0]>;
+type DocsMCPAPIOptions = NonNullable<Parameters<typeof createDocsMCPAPI$1>[0]>;
+/**
+ * Resolve the app project root for a Next route module.
+ *
+ * This handles source routes (`app/...` or `src/app/...`) and built production
+ * output (`.next/server/app/...` or custom-dist-dir `/server/app/...`).
+ */
+declare function resolveNextProjectRoot(metaUrl: string): string;
+declare function createDocsAPI(options?: DocsAPIOptions): {
+  GET(request: Request): Promise<Response>;
+  POST(request: Request): Promise<Response>;
+};
+declare function createDocsMCPAPI(options?: DocsMCPAPIOptions): {
+  GET(request: Request): Promise<Response>;
+  POST(request: Request): Promise<Response>;
+  DELETE(request: Request): Promise<Response>;
+};
+//#endregion
+export { createDocsAPI, createDocsMCPAPI, resolveNextProjectRoot };

package/dist/api.mjs

@@ -0,0 +1,62 @@
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { createDocsAPI as createDocsAPI$1, createDocsMCPAPI as createDocsMCPAPI$1 } from "@farming-labs/theme/api";
+
+//#region src/api.ts
+/**
+* Resolve the app project root for a Next route module.
+*
+* This handles source routes (`app/...` or `src/app/...`) and built production
+* output (`.next/server/app/...` or custom-dist-dir `/server/app/...`).
+*/
+function resolveNextProjectRoot(metaUrl) {
+	const filePath = fileURLToPath(metaUrl);
+	let current = path.dirname(filePath);
+	while (true) {
+		const parent = path.dirname(current);
+		if (path.basename(current) === "app") {
+			if (path.basename(parent) === "src") return path.dirname(parent);
+			if (path.basename(parent) === "server") return path.dirname(path.dirname(parent));
+			return parent;
+		}
+		if (parent === current) return process.cwd();
+		current = parent;
+	}
+}
+function isNextRouteFile(filePath) {
+	const normalized = filePath.replaceAll("\\", "/");
+	return /\/(?:src\/)?app\/api\/.+\/route\.[cm]?[jt]sx?$/.test(normalized);
+}
+function inferNextProjectRootFromCaller() {
+	const previousPrepareStackTrace = Error.prepareStackTrace;
+	try {
+		Error.prepareStackTrace = (_error, stack) => stack;
+		const error = /* @__PURE__ */ new Error();
+		Error.captureStackTrace?.(error, inferNextProjectRootFromCaller);
+		const stack = error.stack;
+		for (const frame of stack ?? []) {
+			const fileName = frame.getFileName?.();
+			if (!fileName || !isNextRouteFile(fileName)) continue;
+			return resolveNextProjectRoot(pathToFileURL(fileName).href);
+		}
+	} catch {} finally {
+		Error.prepareStackTrace = previousPrepareStackTrace;
+	}
+}
+function createDocsAPI(options = {}) {
+	const rootDir = options.rootDir ?? inferNextProjectRootFromCaller();
+	return createDocsAPI$1(rootDir ? {
+		...options,
+		rootDir
+	} : options);
+}
+function createDocsMCPAPI(options = {}) {
+	const rootDir = options.rootDir ?? inferNextProjectRootFromCaller();
+	return createDocsMCPAPI$1(rootDir ? {
+		...options,
+		rootDir
+	} : options);
+}
+
+//#endregion
+export { createDocsAPI, createDocsMCPAPI, resolveNextProjectRoot };

package/dist/config.mjs

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import createMDX from "@next/mdx";
 
 //#region src/config.ts
@@ -66,11 +66,14 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 const DOCS_API_ROUTE_TEMPLATE = `\
 ${GENERATED_BANNER}
 import docsConfig from "@/docs.config";
-import { createDocsAPI } from "@farming-labs/theme/api";
+import { createDocsAPI } from "@farming-labs/next/api";
 
 export const { GET, POST } = createDocsAPI({
   entry: docsConfig.entry,
+  contentDir: docsConfig.contentDir,
   i18n: docsConfig.i18n,
+  search: docsConfig.search,
+  ai: docsConfig.ai,
 });
 
 export const revalidate = false;
@@ -78,13 +81,14 @@ export const revalidate = false;
 const DOCS_MCP_ROUTE_TEMPLATE = `\
 ${GENERATED_BANNER}
 import docsConfig from "@/docs.config";
-import { createDocsMCPAPI } from "@farming-labs/theme/api";
+import { createDocsMCPAPI } from "@farming-labs/next/api";
 
 export const { GET, POST, DELETE } = createDocsMCPAPI({
   entry: docsConfig.entry,
   contentDir: docsConfig.contentDir,
   nav: docsConfig.nav,
   ordering: docsConfig.ordering,
+  search: docsConfig.search,
   mcp: docsConfig.mcp,
 });
 
@@ -106,6 +110,39 @@ const FILE_EXTS = [
 	"js"
 ];
 const INTERNAL_DOCS_CONFIG_ALIAS = "@farming-labs/next-internal-docs-config";
+function isDocsWorkspaceRoot(root) {
+	return existsSync(join(root, "packages", "docs", "src", "index.ts")) && existsSync(join(root, "packages", "fumadocs", "src", "index.ts")) && existsSync(join(root, "packages", "next", "src", "config.ts"));
+}
+function findDocsWorkspaceRoot(start) {
+	let current = start;
+	while (true) {
+		if (isDocsWorkspaceRoot(current)) return current;
+		const parent = dirname(current);
+		if (parent === current) return void 0;
+		current = parent;
+	}
+}
+function createDocsWorkspaceAliases() {
+	return {
+		"@farming-labs/docs": "./packages/docs/src/index.ts",
+		"@farming-labs/docs/server": "./packages/docs/src/server.ts",
+		"@farming-labs/next": "./packages/next/src/index.ts",
+		"@farming-labs/next/api": "./packages/next/src/api.ts",
+		"@farming-labs/next/client-callbacks": "./packages/next/src/client-callbacks.tsx",
+		"@farming-labs/next/layout": "./packages/next/src/layout.tsx",
+		"@farming-labs/next/mdx-plugins/rehype-code": "./packages/next/src/mdx-plugins/rehype-code.ts",
+		"@farming-labs/next/mdx-plugins/rehype-toc": "./packages/next/src/mdx-plugins/rehype-toc.ts",
+		"@farming-labs/next/mdx-plugins/remark-heading": "./packages/next/src/mdx-plugins/remark-heading.ts",
+		"@farming-labs/next/mdx-plugins/remark-og": "./packages/next/src/mdx-plugins/remark-og.ts",
+		"@farming-labs/theme": "./packages/fumadocs/src/index.ts",
+		"@farming-labs/theme/api": "./packages/fumadocs/src/docs-api.ts",
+		"@farming-labs/theme/client-hooks": "./packages/fumadocs/src/docs-client-hooks.tsx",
+		"@farming-labs/theme/concrete": "./packages/fumadocs/src/concrete/index.ts",
+		"@farming-labs/theme/hardline": "./packages/fumadocs/src/hardline/index.ts",
+		"@farming-labs/theme/mdx": "./packages/fumadocs/src/mdx.ts",
+		"@farming-labs/theme/search": "./packages/fumadocs/src/search.ts"
+	};
+}
 function hasFile(root, baseName) {
 	return FILE_EXTS.some((ext) => existsSync(join(root, `${baseName}.${ext}`)));
 }
@@ -128,6 +165,16 @@ function readDocsEntry(root) {
 	}
 	return "docs";
 }
+function readDocsContentDir(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = join(root, `docs.config.${ext}`);
+		if (!existsSync(configPath)) continue;
+		try {
+			const match = readFileSync(configPath, "utf-8").match(/contentDir\s*:\s*["']([^"']+)["']/);
+			if (match?.[1]) return match[1];
+		} catch {}
+	}
+}
 function readDocsConfigPath(root) {
 	for (const ext of FILE_EXTS) {
 		const relativePath = `docs.config.${ext}`;
@@ -242,12 +289,15 @@ function normalizeRoutePath(route) {
 }
 function withDocs(nextConfig = {}) {
 	const root = process.cwd();
+	const workspaceRoot = findDocsWorkspaceRoot(root);
 	const docsConfigPath = readDocsConfigPath(root);
 	const docsConfigAbsolutePath = join(root, docsConfigPath);
 	const docsConfigRelativeAlias = docsConfigPath.startsWith("./") || docsConfigPath.startsWith("../") ? docsConfigPath : `./${docsConfigPath}`;
 	if (!hasFile(root, "mdx-components")) writeFileSync(join(root, "mdx-components.tsx"), MDX_COMPONENTS_TEMPLATE);
 	const entry = readDocsEntry(root);
+	const configuredContentDir = readDocsContentDir(root);
 	const appDir = getNextAppDir(root);
+	const docsContentDir = configuredContentDir ?? join(appDir, entry);
 	const layoutDir = join(root, appDir, entry);
 	if (!existsSync(layoutDir)) mkdirSync(layoutDir, { recursive: true });
 	const docsLayoutPath = join(layoutDir, "layout.tsx");
@@ -302,7 +352,9 @@ function withDocs(nextConfig = {}) {
 	const existingResolveAlias = existingTurbopack.resolveAlias ?? {};
 	nextConfig.turbopack = {
 		...existingTurbopack,
+		...workspaceRoot && !existingTurbopack.root ? { root: workspaceRoot } : {},
 		resolveAlias: {
+			...workspaceRoot ? createDocsWorkspaceAliases() : {},
 			...existingResolveAlias,
 			[INTERNAL_DOCS_CONFIG_ALIAS]: docsConfigRelativeAlias
 		}
@@ -315,6 +367,13 @@ function withDocs(nextConfig = {}) {
 		resolvedConfig.resolve.alias[INTERNAL_DOCS_CONFIG_ALIAS] = docsConfigAbsolutePath;
 		return resolvedConfig;
 	};
+	const existingTracingIncludes = nextConfig.outputFileTracingIncludes ?? {};
+	const docsTraceGlob = docsContentDir.replace(/\\/g, "/").replace(/^\.?\//, "") + "/**/*";
+	nextConfig.outputFileTracingIncludes = {
+		...existingTracingIncludes,
+		"/api/docs": [...new Set([...existingTracingIncludes["/api/docs"] ?? [], docsTraceGlob])],
+		"/api/docs/mcp": [...new Set([...existingTracingIncludes["/api/docs/mcp"] ?? [], docsTraceGlob])]
+	};
 	return withMDX(nextConfig);
 }
 

package/dist/index.d.mts

@@ -1,3 +1,4 @@
 import { buildNextOpenApiDocument, createNextApiReference, resolveApiReferenceConfig, withNextApiReferenceBanner } from "./api-reference.mjs";
+import { createDocsAPI, createDocsMCPAPI } from "./api.mjs";
 import { withDocs } from "./config.mjs";
-export { buildNextOpenApiDocument, createNextApiReference, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };
+export { buildNextOpenApiDocument, createDocsAPI, createDocsMCPAPI, createNextApiReference, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { withDocs } from "./config.mjs";
+import { createDocsAPI, createDocsMCPAPI } from "./api.mjs";
 import { buildNextOpenApiDocument, createNextApiReference, resolveApiReferenceConfig, withNextApiReferenceBanner } from "./api-reference.mjs";
 
-export { buildNextOpenApiDocument, createNextApiReference, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };
+export { buildNextOpenApiDocument, createDocsAPI, createDocsMCPAPI, createNextApiReference, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -27,6 +27,11 @@
       "import": "./dist/api-reference.mjs",
       "default": "./dist/api-reference.mjs"
     },
+    "./api": {
+      "types": "./dist/api.d.mts",
+      "import": "./dist/api.mjs",
+      "default": "./dist/api.mjs"
+    },
     "./client-callbacks": {
       "types": "./dist/client-callbacks.d.mts",
       "import": "./dist/client-callbacks.mjs",
@@ -79,8 +84,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.2",
-    "@farming-labs/theme": "0.1.2"
+    "@farming-labs/docs": "0.1.4",
+    "@farming-labs/theme": "0.1.4"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",