@farming-labs/theme 0.0.2-beta.4

package/dist/darksharp/index.d.mts

@@ -0,0 +1,97 @@
+import { DocsTheme } from "@farming-labs/docs";
+
+//#region src/darksharp/index.d.ts
+/**
+ * Darksharp UI defaults — all-black, sharp edges, zero-radius aesthetic.
+ *
+ * Theme authors can import and extend:
+ * ```ts
+ * import { DarksharpUIDefaults } from "@farming-labs/theme/darksharp";
+ * ```
+ */
+declare const DarksharpUIDefaults: {
+  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;
+      };
+      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: {
+    Callout: {
+      variant: string;
+      icon: boolean;
+    };
+    CodeBlock: {
+      showCopyButton: boolean;
+    };
+    Tabs: {
+      style: string;
+    };
+  };
+};
+/**
+ * Darksharp theme preset factory.
+ *
+ * Built with `createTheme` — the same helper theme authors use.
+ * All-black background, near-zero border-radius, minimal & sharp aesthetic.
+ *
+ * @example
+ * ```ts
+ * import { darksharp } from "@farming-labs/theme/darksharp";
+ * export default defineDocs({ theme: darksharp() });
+ * ```
+ */
+declare const darksharp: (overrides?: Partial<DocsTheme>) => DocsTheme;
+//#endregion
+export { DarksharpUIDefaults, darksharp };

package/dist/darksharp/index.mjs

@@ -0,0 +1,111 @@
+import { createTheme } from "@farming-labs/docs";
+
+//#region src/darksharp/index.ts
+/**
+* Darksharp fumadocs theme preset — all-black, sharp edges, zero-radius look.
+* Inspired by better-auth.com documentation style.
+*
+* @example
+* ```ts
+* import { darksharp } from "@farming-labs/theme/darksharp";
+*
+* export default defineDocs({
+*   entry: "docs",
+*   theme: darksharp({ ui: { colors: { primary: "#ffffff" } } }),
+* });
+* ```
+*
+* CSS: `@import "@farming-labs/theme/darksharp/css";`
+*/
+/**
+* Darksharp UI defaults — all-black, sharp edges, zero-radius aesthetic.
+*
+* Theme authors can import and extend:
+* ```ts
+* import { DarksharpUIDefaults } from "@farming-labs/theme/darksharp";
+* ```
+*/
+const DarksharpUIDefaults = {
+	colors: {
+		primary: "#fafaf9",
+		background: "#000000",
+		muted: "#a8a29e",
+		border: "#292524"
+	},
+	typography: { font: {
+		style: {
+			sans: "Geist, system-ui, sans-serif",
+			mono: "Geist Mono, monospace"
+		},
+		h1: {
+			size: "2rem",
+			weight: 700,
+			lineHeight: "1.2",
+			letterSpacing: "-0.02em"
+		},
+		h2: {
+			size: "1.5rem",
+			weight: 600,
+			lineHeight: "1.3"
+		},
+		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: 768,
+		sidebarWidth: 280,
+		toc: {
+			enabled: true,
+			depth: 3
+		},
+		header: {
+			height: 56,
+			sticky: true
+		}
+	},
+	components: {
+		Callout: {
+			variant: "soft",
+			icon: true
+		},
+		CodeBlock: { showCopyButton: true },
+		Tabs: { style: "default" }
+	}
+};
+/**
+* Darksharp theme preset factory.
+*
+* Built with `createTheme` — the same helper theme authors use.
+* All-black background, near-zero border-radius, minimal & sharp aesthetic.
+*
+* @example
+* ```ts
+* import { darksharp } from "@farming-labs/theme/darksharp";
+* export default defineDocs({ theme: darksharp() });
+* ```
+*/
+const darksharp = createTheme({
+	name: "fumadocs-darksharp",
+	ui: DarksharpUIDefaults
+});
+
+//#endregion
+export { DarksharpUIDefaults, darksharp };

package/dist/default/index.d.mts

@@ -0,0 +1,97 @@
+import { DocsTheme } from "@farming-labs/docs";
+
+//#region src/default/index.d.ts
+/**
+ * Default UI configuration — neutral palette, standard border-radius.
+ *
+ * Theme authors can import this and extend it:
+ * ```ts
+ * import { DefaultUIDefaults } from "@farming-labs/theme/default";
+ * ```
+ */
+declare const DefaultUIDefaults: {
+  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;
+      };
+      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: {
+    Callout: {
+      variant: string;
+      icon: boolean;
+    };
+    CodeBlock: {
+      showCopyButton: boolean;
+    };
+    Tabs: {
+      style: string;
+    };
+  };
+};
+/**
+ * Default fumadocs theme preset factory.
+ *
+ * Built with `createTheme` — the same helper theme authors use.
+ * Merges user overrides on top of sensible defaults.
+ *
+ * @example
+ * ```ts
+ * import { fumadocs } from "@farming-labs/theme/default";
+ * export default defineDocs({ theme: fumadocs({ ui: { colors: { primary: "#22c55e" } } }) });
+ * ```
+ */
+declare const fumadocs: (overrides?: Partial<DocsTheme>) => DocsTheme;
+//#endregion
+export { DefaultUIDefaults, fumadocs };

package/dist/default/index.mjs

@@ -0,0 +1,110 @@
+import { createTheme } from "@farming-labs/docs";
+
+//#region src/default/index.ts
+/**
+* Default fumadocs theme preset — neutral colors, standard radius.
+*
+* @example
+* ```ts
+* import { fumadocs } from "@farming-labs/theme/default";
+*
+* export default defineDocs({
+*   entry: "docs",
+*   theme: fumadocs({ ui: { colors: { primary: "#22c55e" } } }),
+* });
+* ```
+*
+* CSS: `@import "@farming-labs/theme/default/css";`
+*/
+/**
+* Default UI configuration — neutral palette, standard border-radius.
+*
+* Theme authors can import this and extend it:
+* ```ts
+* import { DefaultUIDefaults } from "@farming-labs/theme/default";
+* ```
+*/
+const DefaultUIDefaults = {
+	colors: {
+		primary: "#6366f1",
+		background: "#ffffff",
+		muted: "#64748b",
+		border: "#e5e7eb"
+	},
+	typography: { font: {
+		style: {
+			sans: "Inter, system-ui, sans-serif",
+			mono: "JetBrains Mono, monospace"
+		},
+		h1: {
+			size: "2rem",
+			weight: 700,
+			lineHeight: "1.2",
+			letterSpacing: "-0.02em"
+		},
+		h2: {
+			size: "1.5rem",
+			weight: 600,
+			lineHeight: "1.3"
+		},
+		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: 768,
+		sidebarWidth: 280,
+		toc: {
+			enabled: true,
+			depth: 3
+		},
+		header: {
+			height: 72,
+			sticky: true
+		}
+	},
+	components: {
+		Callout: {
+			variant: "soft",
+			icon: true
+		},
+		CodeBlock: { showCopyButton: true },
+		Tabs: { style: "default" }
+	}
+};
+/**
+* Default fumadocs theme preset factory.
+*
+* Built with `createTheme` — the same helper theme authors use.
+* Merges user overrides on top of sensible defaults.
+*
+* @example
+* ```ts
+* import { fumadocs } from "@farming-labs/theme/default";
+* export default defineDocs({ theme: fumadocs({ ui: { colors: { primary: "#22c55e" } } }) });
+* ```
+*/
+const fumadocs = createTheme({
+	name: "fumadocs-default",
+	ui: DefaultUIDefaults
+});
+
+//#endregion
+export { DefaultUIDefaults, fumadocs };

package/dist/docs-ai-features.d.mts

@@ -0,0 +1,23 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/docs-ai-features.d.ts
+interface DocsAIFeaturesProps {
+  mode: "search" | "floating";
+  position?: "bottom-right" | "bottom-left" | "bottom-center";
+  floatingStyle?: "panel" | "modal" | "popover" | "full-modal";
+  triggerComponentHtml?: string;
+  suggestedQuestions?: string[];
+  aiLabel?: string;
+  loadingComponentHtml?: string;
+}
+declare function DocsAIFeatures({
+  mode,
+  position,
+  floatingStyle,
+  triggerComponentHtml,
+  suggestedQuestions,
+  aiLabel,
+  loadingComponentHtml
+}: DocsAIFeaturesProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsAIFeatures };

package/dist/docs-ai-features.mjs

@@ -0,0 +1,81 @@
+"use client";
+
+import { DocsSearchDialog, FloatingAIChat } from "./ai-search-dialog.mjs";
+import { useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/docs-ai-features.tsx
+/**
+* Client component injected by `createDocsLayout` when `ai` is configured.
+*
+* Handles both modes:
+* - "search": Intercepts Cmd+K / Ctrl+K and opens the custom search dialog
+*   with Search + Ask AI tabs (prevents fumadocs' default dialog from opening).
+* - "floating": Renders the floating chat widget with configurable position,
+*   style, and trigger component.
+*
+* This component is rendered inside the docs layout so the user's root layout
+* never needs to be modified — AI features work purely from `docs.config.tsx`.
+*/
+function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loadingComponentHtml }) {
+	if (mode === "search") return /* @__PURE__ */ jsx(SearchModeAI, {
+		suggestedQuestions,
+		aiLabel,
+		loadingComponentHtml
+	});
+	return /* @__PURE__ */ jsx(FloatingAIChat, {
+		api: "/api/docs",
+		position,
+		floatingStyle,
+		triggerComponentHtml,
+		suggestedQuestions,
+		aiLabel,
+		loadingComponentHtml
+	});
+}
+/**
+* Search mode: intercepts Cmd+K / Ctrl+K globally and opens the
+* custom search dialog (with Search + Ask AI tabs) instead of
+* fumadocs' built-in search dialog.
+*/
+function SearchModeAI({ suggestedQuestions, aiLabel, loadingComponentHtml }) {
+	const [open, setOpen] = useState(false);
+	useEffect(() => {
+		function handler(e) {
+			if ((e.metaKey || e.ctrlKey) && e.key === "k") {
+				e.preventDefault();
+				e.stopPropagation();
+				e.stopImmediatePropagation();
+				setOpen(true);
+			}
+		}
+		document.addEventListener("keydown", handler, true);
+		return () => document.removeEventListener("keydown", handler, true);
+	}, []);
+	useEffect(() => {
+		function handler(e) {
+			const button = e.target.closest("button");
+			if (!button) return;
+			const text = button.textContent || "";
+			if (text.includes("Search") && (text.includes("⌘") || text.includes("K"))) {
+				e.preventDefault();
+				e.stopPropagation();
+				e.stopImmediatePropagation();
+				setOpen(true);
+			}
+		}
+		document.addEventListener("click", handler, true);
+		return () => document.removeEventListener("click", handler, true);
+	}, []);
+	return /* @__PURE__ */ jsx(DocsSearchDialog, {
+		open,
+		onOpenChange: setOpen,
+		api: "/api/docs",
+		suggestedQuestions,
+		aiLabel,
+		loadingComponentHtml
+	});
+}
+
+//#endregion
+export { DocsAIFeatures };

package/dist/docs-api.d.mts

@@ -0,0 +1,68 @@
+//#region src/docs-api.d.ts
+/**
+ * Unified docs API handler for @farming-labs/theme.
+ *
+ * A single route handler that serves **both** search and AI chat:
+ *
+ * - `GET  /api/docs?query=…` → full-text search over indexed MDX pages
+ * - `POST /api/docs` → RAG-powered "Ask AI" (searches relevant docs,
+ *   then streams an LLM response using the docs as context)
+ *
+ * This replaces the old `createDocsSearchAPI` — one handler, one route.
+ *
+ * @example
+ * ```ts
+ * // app/api/docs/route.ts (auto-generated by withDocs)
+ * import { createDocsAPI } from "@farming-labs/theme/api";
+ * export const { GET, POST } = createDocsAPI();
+ * export const revalidate = false;
+ * ```
+ */
+interface AIOptions {
+  enabled?: boolean;
+  model?: string;
+  systemPrompt?: string;
+  baseUrl?: string;
+  apiKey?: string;
+  maxResults?: number;
+}
+interface DocsAPIOptions {
+  /** Docs entry folder (default: read from docs.config) */
+  entry?: string;
+  /** Search language (default: "english") */
+  language?: string;
+  /** AI chat configuration */
+  ai?: AIOptions;
+}
+/**
+ * Create a unified docs API route handler.
+ *
+ * Returns `{ GET, POST }` for use in a Next.js route handler:
+ * - **GET** → full-text search (same as the old `createDocsSearchAPI`)
+ * - **POST** → AI-powered chat with RAG (when AI is enabled in config)
+ *
+ * @example
+ * ```ts
+ * // app/api/docs/route.ts
+ * import { createDocsAPI } from "@farming-labs/theme/api";
+ * export const { GET, POST } = createDocsAPI();
+ * export const revalidate = false;
+ * ```
+ *
+ * @param options - Optional overrides (entry, language, ai config)
+ */
+declare function createDocsAPI(options?: DocsAPIOptions): {
+  /**
+   * GET handler — full-text search.
+   * Query: `?query=search+term`
+   */
+  GET: (request: Request) => Promise<Response>;
+  /**
+   * POST handler — AI chat with RAG.
+   * Body: `{ messages: [{ role: "user", content: "How do I …?" }] }`
+   * Response: SSE stream of chat completion chunks.
+   */
+  POST(request: Request): Promise<Response>;
+};
+//#endregion
+export { createDocsAPI };