@farming-labs/theme 0.0.2-beta.10

package/dist/docs-page-client.mjs

@@ -0,0 +1,128 @@
+"use client";
+
+import { PageActions } from "./page-actions.mjs";
+import { useEffect, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { DocsBody, DocsPage, EditOnGitHub } from "fumadocs-ui/layouts/docs/page";
+import { usePathname, useRouter } from "next/navigation";
+
+//#region src/docs-page-client.tsx
+/**
+* Path-based breadcrumb that shows only parent / current folder.
+* Skips the entry segment (e.g. "docs"). Parent is clickable.
+*/
+function PathBreadcrumb({ pathname, entry }) {
+	const router = useRouter();
+	const allSegments = pathname.split("/").filter(Boolean);
+	const segments = allSegments.filter((s) => s.toLowerCase() !== entry.toLowerCase());
+	if (segments.length < 2) return null;
+	const parentSegment = segments[segments.length - 2];
+	const currentSegment = segments[segments.length - 1];
+	const parentLabel = parentSegment.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+	const currentLabel = currentSegment.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+	const parentIndex = allSegments.indexOf(parentSegment);
+	const parentUrl = "/" + allSegments.slice(0, parentIndex + 1).join("/");
+	return /* @__PURE__ */ jsxs("nav", {
+		className: "fd-breadcrumb",
+		"aria-label": "Breadcrumb",
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "fd-breadcrumb-item",
+			children: /* @__PURE__ */ jsx("a", {
+				href: parentUrl,
+				className: "fd-breadcrumb-parent fd-breadcrumb-link",
+				onClick: (e) => {
+					e.preventDefault();
+					router.push(parentUrl);
+				},
+				children: parentLabel
+			})
+		}), /* @__PURE__ */ jsxs("span", {
+			className: "fd-breadcrumb-item",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "fd-breadcrumb-sep",
+				children: "/"
+			}), /* @__PURE__ */ jsx("span", {
+				className: "fd-breadcrumb-current",
+				children: currentLabel
+			})]
+		})]
+	});
+}
+/**
+* Client wrapper for DocsPage that auto-detects headings from the DOM,
+* populates the Table of Contents, and renders page action buttons
+* (Copy Markdown, Open in LLM). Re-scans when the route changes.
+*/
+/**
+* Build the GitHub URL for the current page's source file.
+*
+* Examples:
+*   No directory:  https://github.com/user/repo/tree/main/app/docs/cli/page.mdx
+*   With directory: https://github.com/farming-labs/docs/tree/main/website/app/docs/cli/page.mdx
+*/
+function buildGithubFileUrl(githubUrl, branch, pathname, directory) {
+	const segments = pathname.replace(/^\//, "").replace(/\/$/, "");
+	return `${githubUrl}/tree/${branch}/${directory ? `${directory}/` : ""}app/${segments}/page.mdx`;
+}
+function DocsPageClient({ tocEnabled, breadcrumbEnabled = true, entry = "docs", copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", githubUrl, githubBranch = "main", githubDirectory, lastModifiedMap, children }) {
+	const [toc, setToc] = useState([]);
+	const pathname = usePathname();
+	useEffect(() => {
+		if (!tocEnabled) return;
+		const timer = requestAnimationFrame(() => {
+			const container = document.getElementById("nd-page");
+			if (!container) return;
+			const headings = container.querySelectorAll("h2[id], h3[id], h4[id]");
+			setToc(Array.from(headings).map((el) => ({
+				title: el.textContent?.replace(/^#\s*/, "") || "",
+				url: `#${el.id}`,
+				depth: parseInt(el.tagName[1], 10)
+			})));
+		});
+		return () => cancelAnimationFrame(timer);
+	}, [tocEnabled, pathname]);
+	const showActions = copyMarkdown || openDocs;
+	const githubFileUrl = githubUrl ? buildGithubFileUrl(githubUrl, githubBranch, pathname, githubDirectory) : void 0;
+	const normalizedPath = pathname.replace(/\/$/, "") || "/";
+	const lastModified = lastModifiedMap?.[normalizedPath];
+	const showFooter = githubFileUrl || lastModified;
+	return /* @__PURE__ */ jsxs(DocsPage, {
+		toc,
+		tableOfContent: { enabled: tocEnabled },
+		tableOfContentPopover: { enabled: tocEnabled },
+		breadcrumb: { enabled: false },
+		children: [
+			breadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
+				pathname,
+				entry
+			}),
+			showActions && /* @__PURE__ */ jsx("div", {
+				"data-actions-position": pageActionsPosition,
+				children: /* @__PURE__ */ jsx(PageActions, {
+					copyMarkdown,
+					openDocs,
+					providers: openDocsProviders
+				})
+			}),
+			/* @__PURE__ */ jsxs(DocsBody, {
+				style: {
+					display: "flex",
+					flexDirection: "column"
+				},
+				children: [/* @__PURE__ */ jsx("div", {
+					style: { flex: 1 },
+					children
+				}), showFooter && /* @__PURE__ */ jsxs("div", {
+					className: "not-prose fd-page-footer",
+					children: [githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }), lastModified && /* @__PURE__ */ jsxs("span", {
+						className: "fd-last-updated",
+						children: ["Last updated: ", lastModified]
+					})]
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { DocsPageClient };

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { DefaultUIDefaults, fumadocs } from "./default/index.mjs";
+import { createDocsLayout, createDocsMetadata } from "./docs-layout.mjs";
+import { DocsPageClient } from "./docs-page-client.mjs";
+import { RootProvider } from "./provider.mjs";
+import { PageActions } from "./page-actions.mjs";
+import { DocsLayout } from "fumadocs-ui/layouts/docs";
+import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
+import { AIConfig, BreadcrumbConfig, CopyMarkdownConfig, DocsConfig, DocsMetadata, DocsNav, DocsTheme, FontStyle, OGConfig, OpenDocsConfig, OpenDocsProvider, PageActionsConfig, PageFrontmatter, SidebarConfig, ThemeToggleConfig, TypographyConfig, UIConfig, createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
+import { Tab, Tabs } from "fumadocs-ui/components/tabs";
+import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
+export { type AIConfig, type BreadcrumbConfig, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, type CopyMarkdownConfig, DocsBody, type DocsConfig, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, createDocsLayout, createDocsMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs };

package/dist/index.mjs

@@ -0,0 +1,12 @@
+import { PageActions } from "./page-actions.mjs";
+import { DocsPageClient } from "./docs-page-client.mjs";
+import { createDocsLayout, createDocsMetadata } from "./docs-layout.mjs";
+import { RootProvider } from "./provider.mjs";
+import { DefaultUIDefaults, fumadocs } from "./default/index.mjs";
+import { DocsLayout } from "fumadocs-ui/layouts/docs";
+import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
+import { createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
+import { Tab, Tabs } from "fumadocs-ui/components/tabs";
+import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
+
+export { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, DocsBody, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, PageActions, Pre, RootProvider, Tab, Tabs, createDocsLayout, createDocsMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs };

package/dist/mdx.d.mts

@@ -0,0 +1,38 @@
+import * as react from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { Tab, Tabs } from "fumadocs-ui/components/tabs";
+import * as fumadocs_ui_components_codeblock0 from "fumadocs-ui/components/codeblock";
+import defaultMdxComponents from "fumadocs-ui/mdx";
+import * as fumadocs_ui_components_card0 from "fumadocs-ui/components/card";
+import * as fumadocs_ui_components_callout0 from "fumadocs-ui/components/callout";
+
+//#region src/mdx.d.ts
+declare const extendedMdxComponents: {
+  Tab: typeof Tab;
+  Tabs: typeof Tabs;
+  CodeBlockTab: typeof fumadocs_ui_components_codeblock0.CodeBlockTab;
+  CodeBlockTabs: typeof fumadocs_ui_components_codeblock0.CodeBlockTabs;
+  CodeBlockTabsList: typeof fumadocs_ui_components_codeblock0.CodeBlockTabsList;
+  CodeBlockTabsTrigger: typeof fumadocs_ui_components_codeblock0.CodeBlockTabsTrigger;
+  pre: (props: react.HTMLAttributes<HTMLPreElement>) => react_jsx_runtime0.JSX.Element;
+  Card: typeof fumadocs_ui_components_card0.Card;
+  Cards: typeof fumadocs_ui_components_card0.Cards;
+  a: react.FC<react.AnchorHTMLAttributes<HTMLAnchorElement>>;
+  img: (props: react.ImgHTMLAttributes<HTMLImageElement> & {
+    sizes?: string;
+  }) => react_jsx_runtime0.JSX.Element;
+  h1: (props: react.HTMLAttributes<HTMLHeadingElement>) => react_jsx_runtime0.JSX.Element;
+  h2: (props: react.HTMLAttributes<HTMLHeadingElement>) => react_jsx_runtime0.JSX.Element;
+  h3: (props: react.HTMLAttributes<HTMLHeadingElement>) => react_jsx_runtime0.JSX.Element;
+  h4: (props: react.HTMLAttributes<HTMLHeadingElement>) => react_jsx_runtime0.JSX.Element;
+  h5: (props: react.HTMLAttributes<HTMLHeadingElement>) => react_jsx_runtime0.JSX.Element;
+  h6: (props: react.HTMLAttributes<HTMLHeadingElement>) => react_jsx_runtime0.JSX.Element;
+  table: (props: react.TableHTMLAttributes<HTMLTableElement>) => react_jsx_runtime0.JSX.Element;
+  Callout: typeof fumadocs_ui_components_callout0.Callout;
+  CalloutContainer: typeof fumadocs_ui_components_callout0.CalloutContainer;
+  CalloutTitle: typeof fumadocs_ui_components_callout0.CalloutTitle;
+  CalloutDescription: typeof fumadocs_ui_components_callout0.CalloutDescription;
+};
+declare function getMDXComponents<T extends Record<string, unknown> = Record<string, unknown>>(overrides?: T): typeof extendedMdxComponents & T;
+//#endregion
+export { Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };

package/dist/mdx.mjs

@@ -0,0 +1,27 @@
+import { Tab, Tabs } from "fumadocs-ui/components/tabs";
+import defaultMdxComponents from "fumadocs-ui/mdx";
+
+//#region src/mdx.ts
+/**
+* Re-export fumadocs-ui MDX components.
+*
+* Includes all default MDX components (headings, code blocks, callouts, cards)
+* plus Tabs/Tab for tabbed content and InstallTabs for package manager tabs.
+*
+* Usage in mdx-components.tsx:
+*   import { getMDXComponents } from "@farming-labs/theme/mdx";
+*/
+const extendedMdxComponents = {
+	...defaultMdxComponents,
+	Tab,
+	Tabs
+};
+function getMDXComponents(overrides) {
+	return {
+		...extendedMdxComponents,
+		...overrides
+	};
+}
+
+//#endregion
+export { Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };

package/dist/page-actions.d.mts

@@ -0,0 +1,21 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/page-actions.d.ts
+/** Serializable provider — icon is an HTML string, not JSX. */
+interface SerializedProvider {
+  name: string;
+  iconHtml?: string;
+  urlTemplate: string;
+}
+interface PageActionsProps {
+  copyMarkdown?: boolean;
+  openDocs?: boolean;
+  providers?: SerializedProvider[];
+}
+declare function PageActions({
+  copyMarkdown,
+  openDocs,
+  providers
+}: PageActionsProps): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { PageActions };

package/dist/page-actions.mjs

@@ -0,0 +1,155 @@
+"use client";
+
+import { useCallback, useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { usePathname } from "next/navigation";
+
+//#region src/page-actions.tsx
+const CopyIcon = () => /* @__PURE__ */ jsxs("svg", {
+	width: "14",
+	height: "14",
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "2",
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	children: [/* @__PURE__ */ jsx("rect", {
+		x: "9",
+		y: "9",
+		width: "13",
+		height: "13",
+		rx: "2",
+		ry: "2"
+	}), /* @__PURE__ */ jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" })]
+});
+const CheckIcon = () => /* @__PURE__ */ jsx("svg", {
+	width: "14",
+	height: "14",
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "2",
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	children: /* @__PURE__ */ jsx("polyline", { points: "20 6 9 17 4 12" })
+});
+const ChevronDownIcon = () => /* @__PURE__ */ jsx("svg", {
+	width: "12",
+	height: "12",
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "2",
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	children: /* @__PURE__ */ jsx("polyline", { points: "6 9 12 15 18 9" })
+});
+const ExternalLinkIcon = () => /* @__PURE__ */ jsxs("svg", {
+	width: "12",
+	height: "12",
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "2",
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	children: [
+		/* @__PURE__ */ jsx("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" }),
+		/* @__PURE__ */ jsx("polyline", { points: "15 3 21 3 21 9" }),
+		/* @__PURE__ */ jsx("line", {
+			x1: "10",
+			y1: "14",
+			x2: "21",
+			y2: "3"
+		})
+	]
+});
+const DEFAULT_PROVIDERS = [{
+	name: "ChatGPT",
+	urlTemplate: "https://chatgpt.com/?hints=search&q=Read+{mdxUrl},+I+want+to+ask+questions+about+it."
+}, {
+	name: "Claude",
+	urlTemplate: "https://claude.ai/new?q=Read+{mdxUrl},+I+want+to+ask+questions+about+it."
+}];
+function PageActions({ copyMarkdown, openDocs, providers }) {
+	const [copied, setCopied] = useState(false);
+	const [dropdownOpen, setDropdownOpen] = useState(false);
+	const dropdownRef = useRef(null);
+	const pathname = usePathname();
+	const resolvedProviders = providers ?? DEFAULT_PROVIDERS;
+	const handleCopyMarkdown = useCallback(async () => {
+		try {
+			const article = document.querySelector("article");
+			if (article) {
+				await navigator.clipboard.writeText(article.innerText || "");
+				setCopied(true);
+				setTimeout(() => setCopied(false), 2e3);
+			}
+		} catch {}
+	}, []);
+	const handleOpen = useCallback((template) => {
+		const pageUrl = window.location.href;
+		const mdxUrl = `${window.location.origin}${pathname}.mdx`;
+		const url = template.replace(/\{url\}/g, encodeURIComponent(pageUrl)).replace(/\{mdxUrl\}/g, encodeURIComponent(mdxUrl));
+		window.open(url, "_blank", "noopener,noreferrer");
+		setDropdownOpen(false);
+	}, [pathname]);
+	useEffect(() => {
+		if (!dropdownOpen) return;
+		function handleClick(e) {
+			if (dropdownRef.current && !dropdownRef.current.contains(e.target)) setDropdownOpen(false);
+		}
+		document.addEventListener("mousedown", handleClick);
+		return () => document.removeEventListener("mousedown", handleClick);
+	}, [dropdownOpen]);
+	useEffect(() => {
+		setDropdownOpen(false);
+		setCopied(false);
+	}, [pathname]);
+	if (!copyMarkdown && !openDocs) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "fd-page-actions",
+		"data-page-actions": true,
+		children: [copyMarkdown && /* @__PURE__ */ jsxs("button", {
+			type: "button",
+			onClick: handleCopyMarkdown,
+			className: "fd-page-action-btn",
+			"data-copied": copied,
+			children: [copied ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {}), /* @__PURE__ */ jsx("span", { children: copied ? "Copied!" : "Copy Markdown" })]
+		}), openDocs && resolvedProviders.length > 0 && /* @__PURE__ */ jsxs("div", {
+			ref: dropdownRef,
+			className: "fd-page-action-dropdown",
+			children: [/* @__PURE__ */ jsxs("button", {
+				type: "button",
+				onClick: () => setDropdownOpen(!dropdownOpen),
+				className: "fd-page-action-btn",
+				"aria-expanded": dropdownOpen,
+				children: [/* @__PURE__ */ jsx("span", { children: "Open in" }), /* @__PURE__ */ jsx(ChevronDownIcon, {})]
+			}), dropdownOpen && /* @__PURE__ */ jsx("div", {
+				className: "fd-page-action-menu",
+				role: "menu",
+				children: resolvedProviders.map((provider) => /* @__PURE__ */ jsxs("button", {
+					type: "button",
+					role: "menuitem",
+					className: "fd-page-action-menu-item",
+					onClick: () => handleOpen(provider.urlTemplate),
+					children: [
+						provider.iconHtml && /* @__PURE__ */ jsx("span", {
+							className: "fd-page-action-menu-icon",
+							dangerouslySetInnerHTML: { __html: provider.iconHtml }
+						}),
+						/* @__PURE__ */ jsxs("span", {
+							className: "fd-page-action-menu-label",
+							children: ["Open in ", provider.name]
+						}),
+						/* @__PURE__ */ jsx(ExternalLinkIcon, {})
+					]
+				}, provider.name))
+			})]
+		})]
+	});
+}
+
+//#endregion
+export { PageActions };

package/dist/pixel-border/index.d.mts

@@ -0,0 +1,87 @@
+import { DocsTheme } from "@farming-labs/docs";
+
+//#region src/pixel-border/index.d.ts
+/**
+ * Pixel-border UI defaults — better-auth inspired, clean dark UI.
+ *
+ * Theme authors can import and extend:
+ * ```ts
+ * import { PixelBorderUIDefaults } from "@farming-labs/theme/pixel-border";
+ * ```
+ */
+declare const PixelBorderUIDefaults: {
+  colors: {
+    primary: string;
+    background: string;
+    muted: string;
+    border: string;
+  };
+  typography: {
+    font: {
+      style: {
+        sans: string;
+        mono: string;
+      };
+      h1: {
+        size: string;
+        weight: number;
+        lineHeight: string;
+        letterSpacing: string;
+      };
+      h2: {
+        size: string;
+        weight: number;
+        lineHeight: string;
+        letterSpacing: string;
+      };
+      h3: {
+        size: string;
+        weight: number;
+        lineHeight: string;
+      };
+      h4: {
+        size: string;
+        weight: number;
+        lineHeight: string;
+      };
+      body: {
+        size: string;
+        weight: number;
+        lineHeight: string;
+      };
+      small: {
+        size: string;
+        weight: number;
+        lineHeight: string;
+      };
+    };
+  };
+  layout: {
+    contentWidth: number;
+    sidebarWidth: number;
+    toc: {
+      enabled: boolean;
+      depth: number;
+    };
+    header: {
+      height: number;
+      sticky: boolean;
+    };
+  };
+  components: {};
+};
+/**
+ * Pixel-border theme preset factory.
+ *
+ * Built with `createTheme` — the same helper theme authors use.
+ * Inspired by better-auth.com — clean dark UI with visible borders.
+ *
+ * @example
+ * ```ts
+ * import { pixelBorder } from "@farming-labs/theme/pixel-border";
+ * export default defineDocs({ theme: pixelBorder() });
+ * ```
+ */
+declare const pixelBorder: (overrides?: Partial<DocsTheme>) => DocsTheme;
+//#endregion
+export { PixelBorderUIDefaults, pixelBorder };

package/dist/pixel-border/index.mjs

@@ -0,0 +1,95 @@
+import { createTheme } from "@farming-labs/docs";
+
+//#region src/pixel-border/index.ts
+/**
+* @farming-labs/theme/pixel-border
+*
+* Inspired by better-auth.com — clean dark UI with visible rounded borders,
+* pixel-perfect spacing, and a refined sidebar.
+*/
+/**
+* Pixel-border UI defaults — better-auth inspired, clean dark UI.
+*
+* Theme authors can import and extend:
+* ```ts
+* import { PixelBorderUIDefaults } from "@farming-labs/theme/pixel-border";
+* ```
+*/
+const PixelBorderUIDefaults = {
+	colors: {
+		primary: "oklch(0.985 0.001 106.423)",
+		background: "hsl(0 0% 2%)",
+		muted: "hsl(0 0% 55%)",
+		border: "hsl(0 0% 15%)"
+	},
+	typography: { font: {
+		style: {
+			sans: "var(--font-geist-sans, system-ui, -apple-system, sans-serif)",
+			mono: "var(--font-geist-mono, ui-monospace, monospace)"
+		},
+		h1: {
+			size: "2.25rem",
+			weight: 700,
+			lineHeight: "1.2",
+			letterSpacing: "-0.02em"
+		},
+		h2: {
+			size: "1.5rem",
+			weight: 600,
+			lineHeight: "1.3",
+			letterSpacing: "-0.01em"
+		},
+		h3: {
+			size: "1.25rem",
+			weight: 600,
+			lineHeight: "1.4"
+		},
+		h4: {
+			size: "1.125rem",
+			weight: 600,
+			lineHeight: "1.4"
+		},
+		body: {
+			size: "1rem",
+			weight: 400,
+			lineHeight: "1.75"
+		},
+		small: {
+			size: "0.875rem",
+			weight: 400,
+			lineHeight: "1.5"
+		}
+	} },
+	layout: {
+		contentWidth: 860,
+		sidebarWidth: 286,
+		toc: {
+			enabled: true,
+			depth: 3
+		},
+		header: {
+			height: 56,
+			sticky: true
+		}
+	},
+	components: {}
+};
+/**
+* Pixel-border theme preset factory.
+*
+* Built with `createTheme` — the same helper theme authors use.
+* Inspired by better-auth.com — clean dark UI with visible borders.
+*
+* @example
+* ```ts
+* import { pixelBorder } from "@farming-labs/theme/pixel-border";
+* export default defineDocs({ theme: pixelBorder() });
+* ```
+*/
+const pixelBorder = createTheme({
+	name: "fumadocs-pixel-border",
+	ui: PixelBorderUIDefaults
+});
+
+//#endregion
+export { PixelBorderUIDefaults, pixelBorder };

package/dist/provider.d.mts

@@ -0,0 +1,14 @@
+import { ComponentPropsWithoutRef } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { RootProvider as RootProvider$1 } from "fumadocs-ui/provider/next";
+
+//#region src/provider.d.ts
+type FumadocsProviderProps = ComponentPropsWithoutRef<typeof RootProvider$1>;
+interface DocsRootProviderProps extends FumadocsProviderProps {}
+declare function RootProvider({
+  children,
+  search,
+  ...props
+}: DocsRootProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsRootProviderProps, RootProvider };

package/dist/provider.mjs

@@ -0,0 +1,29 @@
+"use client";
+
+import { jsx } from "react/jsx-runtime";
+import { RootProvider as RootProvider$1 } from "fumadocs-ui/provider/next";
+
+//#region src/provider.tsx
+/**
+* RootProvider wrapper — thin layer over fumadocs-ui's RootProvider.
+*
+* Defaults the search API to `/api/docs` (unified handler).
+* AI features are handled automatically by `createDocsLayout`
+* based on the `ai` config in `docs.config.tsx` — no props needed here.
+*/
+function RootProvider({ children, search, ...props }) {
+	return /* @__PURE__ */ jsx(RootProvider$1, {
+		search: {
+			...search,
+			options: {
+				api: "/api/docs",
+				...search?.options
+			}
+		},
+		...props,
+		children
+	});
+}
+
+//#endregion
+export { RootProvider };

package/dist/search.d.mts

@@ -0,0 +1,34 @@
+//#region src/search.d.ts
+/**
+ * Search API — backward-compatible re-export.
+ *
+ * New projects should use `createDocsAPI` from `@farming-labs/theme/api`
+ * which provides a unified handler for both search (GET) and AI chat (POST).
+ *
+ * This module is kept for backward compatibility with existing projects
+ * that import `createDocsSearchAPI` from `@farming-labs/theme/search`.
+ *
+ * @example
+ * ```ts
+ * // Recommended (new): app/api/docs/route.ts
+ * import { createDocsAPI } from "@farming-labs/theme/api";
+ * export const { GET, POST } = createDocsAPI();
+ *
+ * // Legacy: app/api/search/route.ts
+ * import { createDocsSearchAPI } from "@farming-labs/theme/search";
+ * export const { GET } = createDocsSearchAPI();
+ * ```
+ */
+/**
+ * @deprecated Use `createDocsAPI` from `@farming-labs/theme/api` instead.
+ * This function is kept for backward compatibility.
+ */
+declare function createDocsSearchAPI(options?: {
+  entry?: string;
+  language?: string;
+}): {
+  GET: (request: Request) => Promise<Response>;
+  POST(request: Request): Promise<Response>;
+};
+//#endregion
+export { createDocsSearchAPI };