@farming-labs/next 0.0.2-beta.1

package/dist/config.d.mts

@@ -0,0 +1,23 @@
+import * as next from "next";
+
+//#region src/config.d.ts
+/**
+ * Next.js config wrapper for @farming-labs/docs.
+ * Handles MDX compilation, frontmatter, syntax highlighting, TOC extraction,
+ * and auto-generates mdx-components.tsx + docs layout when missing.
+ *
+ * @example
+ * // next.config.ts — this is all you need:
+ *   import { withDocs } from "@farming-labs/next/config";
+ *   export default withDocs();
+ *
+ * @example
+ * // With existing Next.js config
+ *   import { withDocs } from "@farming-labs/next/config";
+ *   export default withDocs({
+ *     images: { remotePatterns: [{ hostname: "example.com" }] },
+ *   });
+ */
+declare function withDocs(nextConfig?: Record<string, unknown>): Promise<next.NextConfig>;
+//#endregion
+export { withDocs };

package/dist/config.mjs

@@ -0,0 +1,122 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import createMDX from "@next/mdx";
+import remarkGfm from "remark-gfm";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkMdxFrontmatter from "remark-mdx-frontmatter";
+
+//#region src/config.ts
+/**
+* Next.js config wrapper for @farming-labs/docs.
+* Handles MDX compilation, frontmatter, syntax highlighting, TOC extraction,
+* and auto-generates mdx-components.tsx + docs layout when missing.
+*
+* @example
+* // next.config.ts — this is all you need:
+*   import { withDocs } from "@farming-labs/next/config";
+*   export default withDocs();
+*
+* @example
+* // With existing Next.js config
+*   import { withDocs } from "@farming-labs/next/config";
+*   export default withDocs({
+*     images: { remotePatterns: [{ hostname: "example.com" }] },
+*   });
+*/
+const GENERATED_BANNER = "// Auto-generated by @farming-labs/next — do not edit manually.\n";
+const MDX_COMPONENTS_TEMPLATE = `\
+${GENERATED_BANNER}
+import { getMDXComponents } from "@farming-labs/fumadocs/mdx";
+import type { MDXComponents } from "mdx/types";
+import docsConfig from "@/docs.config";
+
+export function useMDXComponents(components?: MDXComponents): MDXComponents {
+  return getMDXComponents({
+    ...(docsConfig.components as MDXComponents),
+    ...components,
+  });
+}
+`;
+const DOCS_LAYOUT_TEMPLATE = `\
+${GENERATED_BANNER}
+import docsConfig from "@/docs.config";
+import { createDocsLayout, createDocsMetadata } from "@farming-labs/fumadocs";
+
+export const metadata = createDocsMetadata(docsConfig);
+export default createDocsLayout(docsConfig);
+`;
+const SEARCH_ROUTE_TEMPLATE = `\
+${GENERATED_BANNER}
+import { createDocsSearchAPI } from "@farming-labs/fumadocs/search";
+
+export const { GET } = createDocsSearchAPI();
+
+export const revalidate = false;
+`;
+const FILE_EXTS = [
+	"tsx",
+	"ts",
+	"jsx",
+	"js"
+];
+function hasFile(root, baseName) {
+	return FILE_EXTS.some((ext) => existsSync(join(root, `${baseName}.${ext}`)));
+}
+/** Read the docs entry path from docs.config.ts[x] (defaults to "docs"). */
+function readDocsEntry(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = join(root, `docs.config.${ext}`);
+		if (existsSync(configPath)) try {
+			const match = readFileSync(configPath, "utf-8").match(/entry\s*:\s*["']([^"']+)["']/);
+			if (match) return match[1];
+		} catch {}
+	}
+	return "docs";
+}
+async function withDocs(nextConfig = {}) {
+	const root = process.cwd();
+	const { remarkHeading, rehypeToc, rehypeCode } = await new Function("specifier", "return import(specifier)")("fumadocs-core/mdx-plugins");
+	if (!hasFile(root, "mdx-components")) writeFileSync(join(root, "mdx-components.tsx"), MDX_COMPONENTS_TEMPLATE);
+	const layoutDir = join(root, "app", readDocsEntry(root));
+	if (existsSync(layoutDir) && !hasFile(layoutDir, "layout")) writeFileSync(join(layoutDir, "layout.tsx"), DOCS_LAYOUT_TEMPLATE);
+	else if (!existsSync(layoutDir)) {
+		mkdirSync(layoutDir, { recursive: true });
+		writeFileSync(join(layoutDir, "layout.tsx"), DOCS_LAYOUT_TEMPLATE);
+	}
+	const searchRouteDir = join(root, "app", "api", "search");
+	if (!hasFile(searchRouteDir, "route")) {
+		mkdirSync(searchRouteDir, { recursive: true });
+		writeFileSync(join(searchRouteDir, "route.ts"), SEARCH_ROUTE_TEMPLATE);
+	}
+	const withMDX = createMDX({
+		extension: /\.mdx?$/,
+		options: {
+			remarkPlugins: [
+				remarkGfm,
+				remarkFrontmatter,
+				[remarkMdxFrontmatter, { name: "metadata" }],
+				remarkHeading
+			],
+			rehypePlugins: [rehypeToc, [rehypeCode, { themes: {
+				dark: "github-dark",
+				light: "github-light"
+			} }]]
+		}
+	});
+	const defaultExts = [
+		"js",
+		"jsx",
+		"md",
+		"mdx",
+		"ts",
+		"tsx"
+	];
+	const userExts = nextConfig.pageExtensions;
+	if (userExts) {
+		for (const ext of ["md", "mdx"]) if (!userExts.includes(ext)) userExts.push(ext);
+	} else nextConfig.pageExtensions = defaultExts;
+	return withMDX(nextConfig);
+}
+
+//#endregion
+export { withDocs };

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { withDocs } from "./config.mjs";
+export { withDocs };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { withDocs } from "./config.mjs";
+
+export { withDocs };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@farming-labs/next",
+  "version": "0.0.2-beta.1",
+  "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.mts",
+      "import": "./dist/config.mjs",
+      "default": "./dist/config.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "docs",
+    "next",
+    "mdx",
+    "documentation"
+  ],
+  "author": "Farming Labs",
+  "license": "MIT",
+  "dependencies": {
+    "@mdx-js/loader": "^3.1.0",
+    "@mdx-js/react": "^3.1.0",
+    "@next/mdx": "^16.1.6",
+    "fumadocs-core": "^16.6.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-mdx-frontmatter": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}