@farming-labs/theme 0.0.2-beta.9 → 0.0.2

package/dist/darkbold/index.mjs

@@ -0,0 +1,84 @@
+import { createTheme } from "@farming-labs/docs";
+
+//#region src/darkbold/index.ts
+/**
+* DarkBold theme preset.
+* Pure monochrome design, Geist typography, clean minimalism.
+*
+* CSS: `@import "@farming-labs/theme/darkbold/css";`
+*/
+const DarkBoldUIDefaults = {
+	colors: {
+		primary: "#000",
+		background: "#fff",
+		muted: "#666",
+		border: "#eaeaea"
+	},
+	typography: { font: {
+		style: {
+			sans: "Geist, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+			mono: "Geist Mono, ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace"
+		},
+		h1: {
+			size: "2.5rem",
+			weight: 600,
+			lineHeight: "1.2",
+			letterSpacing: "-0.06em"
+		},
+		h2: {
+			size: "2rem",
+			weight: 600,
+			lineHeight: "1.25",
+			letterSpacing: "-0.04em"
+		},
+		h3: {
+			size: "1.5rem",
+			weight: 600,
+			lineHeight: "1.3",
+			letterSpacing: "-0.02em"
+		},
+		h4: {
+			size: "1.25rem",
+			weight: 600,
+			lineHeight: "1.4"
+		},
+		body: {
+			size: "1rem",
+			weight: 400,
+			lineHeight: "1.6"
+		},
+		small: {
+			size: "0.875rem",
+			weight: 400,
+			lineHeight: "1.5"
+		}
+	} },
+	layout: {
+		contentWidth: 768,
+		sidebarWidth: 260,
+		toc: {
+			enabled: true,
+			depth: 3,
+			style: "default"
+		},
+		header: {
+			height: 64,
+			sticky: true
+		}
+	},
+	components: {
+		Callout: {
+			variant: "soft",
+			icon: true
+		},
+		CodeBlock: { showCopyButton: true },
+		Tabs: { style: "default" }
+	}
+};
+const darkbold = createTheme({
+	name: "darkbold",
+	ui: DarkBoldUIDefaults
+});
+
+//#endregion
+export { DarkBoldUIDefaults, darkbold };

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

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

package/dist/docs-ai-features.mjs

@@ -1,26 +1,35 @@
 "use client";
 
-import { DocsSearchDialog, FloatingAIChat } from "./ai-search-dialog.mjs";
+import { AIModalDialog, DocsSearchDialog, FloatingAIChat } from "./ai-search-dialog.mjs";
 import { useEffect, useState } from "react";
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-ai-features.tsx
 /**
 * Client component injected by `createDocsLayout` when `ai` is configured.
 *
-* Handles both modes:
+* Handles multiple 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.
+* - "sidebar-icon": Injects an AI trigger icon button next to the search bar
+*   in the sidebar header area (Mintlify-style).
 *
 * 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 }) {
+function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	if (mode === "search") return /* @__PURE__ */ jsx(SearchModeAI, {
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
+		loadingComponentHtml
+	});
+	if (mode === "sidebar-icon") return /* @__PURE__ */ jsx(SidebarIconModeAI, {
+		suggestedQuestions,
+		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	});
 	return /* @__PURE__ */ jsx(FloatingAIChat, {
@@ -30,15 +39,11 @@ function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "pane
 		triggerComponentHtml,
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		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 }) {
+function SearchModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	const [open, setOpen] = useState(false);
 	useEffect(() => {
 		function handler(e) {
@@ -73,9 +78,57 @@ function SearchModeAI({ suggestedQuestions, aiLabel, loadingComponentHtml }) {
 		api: "/api/docs",
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	});
 }
+function SidebarIconModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
+	const [searchOpen, setSearchOpen] = useState(false);
+	const [aiOpen, setAiOpen] = useState(false);
+	useEffect(() => {
+		function handler(e) {
+			if ((e.metaKey || e.ctrlKey) && e.key === "k") {
+				e.preventDefault();
+				e.stopPropagation();
+				e.stopImmediatePropagation();
+				setSearchOpen(true);
+			}
+		}
+		document.addEventListener("keydown", handler, true);
+		return () => document.removeEventListener("keydown", handler, true);
+	}, []);
+	useEffect(() => {
+		function onSearch() {
+			setSearchOpen(true);
+		}
+		function onAI() {
+			setAiOpen(true);
+		}
+		window.addEventListener("fd-open-search", onSearch);
+		window.addEventListener("fd-open-ai", onAI);
+		return () => {
+			window.removeEventListener("fd-open-search", onSearch);
+			window.removeEventListener("fd-open-ai", onAI);
+		};
+	}, []);
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(DocsSearchDialog, {
+		open: searchOpen,
+		onOpenChange: setSearchOpen,
+		api: "/api/docs",
+		suggestedQuestions,
+		aiLabel,
+		loaderVariant,
+		loadingComponentHtml
+	}), /* @__PURE__ */ jsx(AIModalDialog, {
+		open: aiOpen,
+		onOpenChange: setAiOpen,
+		api: "/api/docs",
+		suggestedQuestions,
+		aiLabel,
+		loaderVariant,
+		loadingComponentHtml
+	})] });
+}
 
 //#endregion
 export { DocsAIFeatures };

package/dist/docs-api.d.mts

@@ -38,12 +38,14 @@ interface DocsAPIOptions {
  * 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)
+ * - **GET  ?query=…**        → full-text search
+ * - **GET  ?format=llms**     → llms.txt (concise page listing)
+ * - **GET  ?format=llms-full** → llms-full.txt (full page content)
+ * - **POST**                  → AI-powered chat with RAG
  *
  * @example
  * ```ts
- * // app/api/docs/route.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;
@@ -53,10 +55,9 @@ interface DocsAPIOptions {
  */
 declare function createDocsAPI(options?: DocsAPIOptions): {
   /**
-   * GET handler — full-text search.
-   * Query: `?query=search+term`
+   * GET handler — search, llms.txt, or llms-full.txt depending on query params.
    */
-  GET: (request: Request) => Promise<Response>;
+  GET(request: Request): Response | Promise<Response>;
   /**
    * POST handler — AI chat with RAG.
    * Body: `{ messages: [{ role: "user", content: "How do I …?" }] }`

package/dist/docs-api.mjs

@@ -163,16 +163,64 @@ async function handleAskAI(request, indexes, searchServer, aiConfig) {
 		Connection: "keep-alive"
 	} });
 }
+function readLlmsTxtConfig(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = path.join(root, `docs.config.${ext}`);
+		if (fs.existsSync(configPath)) try {
+			const content = fs.readFileSync(configPath, "utf-8");
+			if (!content.includes("llmsTxt")) return { enabled: false };
+			if (/llmsTxt\s*:\s*true/.test(content)) return { enabled: true };
+			const enabledMatch = content.match(/llmsTxt\s*:\s*\{[^}]*enabled\s*:\s*(true|false)/s);
+			if (enabledMatch && enabledMatch[1] === "false") return { enabled: false };
+			const baseUrlMatch = content.match(/llmsTxt\s*:\s*\{[^}]*baseUrl\s*:\s*["']([^"']+)["']/s);
+			const siteTitleMatch = content.match(/llmsTxt\s*:\s*\{[^}]*siteTitle\s*:\s*["']([^"']+)["']/s);
+			const siteDescMatch = content.match(/llmsTxt\s*:\s*\{[^}]*siteDescription\s*:\s*["']([^"']+)["']/s);
+			const navTitleMatch = content.match(/nav\s*:\s*\{[^}]*title\s*:\s*["']([^"']+)["']/s);
+			return {
+				enabled: true,
+				baseUrl: baseUrlMatch?.[1],
+				siteTitle: siteTitleMatch?.[1] ?? navTitleMatch?.[1],
+				siteDescription: siteDescMatch?.[1]
+			};
+		} catch {}
+	}
+	return { enabled: false };
+}
+function generateLlmsTxt(indexes, options) {
+	const { siteTitle = "Documentation", siteDescription, baseUrl = "" } = options;
+	let llmsTxt = `# ${siteTitle}\n\n`;
+	if (siteDescription) llmsTxt += `> ${siteDescription}\n\n`;
+	llmsTxt += `## Pages\n\n`;
+	for (const page of indexes) {
+		llmsTxt += `- [${page.title}](${baseUrl}${page.url})`;
+		if (page.description) llmsTxt += `: ${page.description}`;
+		llmsTxt += `\n`;
+	}
+	let llmsFullTxt = `# ${siteTitle}\n\n`;
+	if (siteDescription) llmsFullTxt += `> ${siteDescription}\n\n`;
+	for (const page of indexes) {
+		llmsFullTxt += `## ${page.title}\n\n`;
+		llmsFullTxt += `URL: ${baseUrl}${page.url}\n\n`;
+		if (page.description) llmsFullTxt += `${page.description}\n\n`;
+		llmsFullTxt += `${page.content}\n\n---\n\n`;
+	}
+	return {
+		llmsTxt,
+		llmsFullTxt
+	};
+}
 /**
 * 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)
+* - **GET  ?query=…**        → full-text search
+* - **GET  ?format=llms**     → llms.txt (concise page listing)
+* - **GET  ?format=llms-full** → llms-full.txt (full page content)
+* - **POST**                  → AI-powered chat with RAG
 *
 * @example
 * ```ts
-* // app/api/docs/route.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;
@@ -186,13 +234,34 @@ function createDocsAPI(options) {
 	const docsDir = path.join(root, "app", entry);
 	const language = options?.language ?? "english";
 	const aiConfig = options?.ai ?? readAIConfig(root);
+	const llmsConfig = readLlmsTxtConfig(root);
 	const indexes = scanDocsDir(docsDir, entry);
+	let _llmsCache = null;
+	function getLlmsContent() {
+		if (!_llmsCache) _llmsCache = generateLlmsTxt(indexes, {
+			siteTitle: llmsConfig.siteTitle ?? "Documentation",
+			siteDescription: llmsConfig.siteDescription,
+			baseUrl: llmsConfig.baseUrl ?? ""
+		});
+		return _llmsCache;
+	}
 	const searchAPI = createSearchAPI("simple", {
 		language,
 		indexes
 	});
 	return {
-		GET: searchAPI.GET,
+		GET(request) {
+			const format = new URL(request.url).searchParams.get("format");
+			if (format === "llms") return new Response(getLlmsContent().llmsTxt, { headers: {
+				"Content-Type": "text/plain; charset=utf-8",
+				"Cache-Control": "public, max-age=3600"
+			} });
+			if (format === "llms-full") return new Response(getLlmsContent().llmsFullTxt, { headers: {
+				"Content-Type": "text/plain; charset=utf-8",
+				"Cache-Control": "public, max-age=3600"
+			} });
+			return searchAPI.GET(request);
+		},
 		async POST(request) {
 			if (!aiConfig.enabled) return Response.json({ error: "AI is not enabled. Set `ai: { enabled: true }` in your docs.config to enable it." }, { status: 404 });
 			return handleAskAI(request, indexes, searchAPI, aiConfig);

package/dist/docs-command-search.d.mts

@@ -0,0 +1,10 @@
+//#region src/docs-command-search.d.ts
+/**
+ * Built-in docs search command palette.
+ * Intercepts Cmd+K and sidebar search button to provide an advanced
+ * fuzzy-search experience. Styled entirely via omni-* CSS classes
+ * so each theme provides its own visual variant.
+ */
+declare function DocsCommandSearch(): any;
+//#endregion
+export { DocsCommandSearch };