@farming-labs/theme 0.0.2-beta.10

package/dist/docs-api.mjs

@@ -0,0 +1,204 @@
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { createSearchAPI } from "fumadocs-core/search/server";
+
+//#region src/docs-api.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;
+* ```
+*/
+const FILE_EXTS = [
+	"tsx",
+	"ts",
+	"jsx",
+	"js"
+];
+function readEntry(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = path.join(root, `docs.config.${ext}`);
+		if (fs.existsSync(configPath)) try {
+			const match = fs.readFileSync(configPath, "utf-8").match(/entry\s*:\s*["']([^"']+)["']/);
+			if (match) return match[1];
+		} catch {}
+	}
+	return "docs";
+}
+/**
+* Read AI config from docs.config by parsing the file for the `ai` block.
+* This avoids importing the config (which may use JSX/React).
+*/
+function readAIConfig(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("ai:") && !content.includes("ai :")) return {};
+			const enabledMatch = content.match(/ai\s*:\s*\{[^}]*enabled\s*:\s*(true|false)/s);
+			if (enabledMatch && enabledMatch[1] === "false") return {};
+			const modelMatch = content.match(/ai\s*:\s*\{[^}]*model\s*:\s*["']([^"']+)["']/s);
+			const baseUrlMatch = content.match(/ai\s*:\s*\{[^}]*baseUrl\s*:\s*["']([^"']+)["']/s);
+			const apiKeyMatch = content.match(/ai\s*:\s*\{[^}]*apiKey\s*:\s*process\.env\.(\w+)/s);
+			const maxResultsMatch = content.match(/ai\s*:\s*\{[^}]*maxResults\s*:\s*(\d+)/s);
+			const systemPromptMatch = content.match(/ai\s*:\s*\{[^}]*systemPrompt\s*:\s*["'`]([^"'`]+)["'`]/s);
+			return {
+				enabled: true,
+				model: modelMatch?.[1],
+				baseUrl: baseUrlMatch?.[1],
+				apiKey: apiKeyMatch?.[1] ? process.env[apiKeyMatch[1]] : void 0,
+				maxResults: maxResultsMatch ? parseInt(maxResultsMatch[1], 10) : void 0,
+				systemPrompt: systemPromptMatch?.[1]
+			};
+		} catch {}
+	}
+	return {};
+}
+function stripMdx(raw) {
+	const { content } = matter(raw);
+	return content.replace(/^(import|export)\s.*$/gm, "").replace(/<[^>]+\/>/g, "").replace(/<\/?[A-Z][^>]*>/g, "").replace(/<\/?[a-z][^>]*>/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2").replace(/```[\s\S]*?```/g, "").replace(/`([^`]+)`/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
+}
+function scanDocsDir(docsDir, entry) {
+	const indexes = [];
+	function scan(dir, slugParts) {
+		if (!fs.existsSync(dir)) return;
+		const pagePath = path.join(dir, "page.mdx");
+		if (fs.existsSync(pagePath)) try {
+			const raw = fs.readFileSync(pagePath, "utf-8");
+			const { data } = matter(raw);
+			const title = data.title || slugParts[slugParts.length - 1]?.replace(/-/g, " ") || "Documentation";
+			const description = data.description;
+			const content = stripMdx(raw);
+			const url = slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`;
+			indexes.push({
+				title,
+				description,
+				content,
+				url
+			});
+		} catch {}
+		let entries;
+		try {
+			entries = fs.readdirSync(dir);
+		} catch {
+			return;
+		}
+		for (const name of entries.sort()) {
+			const full = path.join(dir, name);
+			try {
+				if (fs.statSync(full).isDirectory()) scan(full, [...slugParts, name]);
+			} catch {}
+		}
+	}
+	scan(docsDir, []);
+	return indexes;
+}
+const DEFAULT_SYSTEM_PROMPT = `You are a helpful documentation assistant. Answer questions based on the provided documentation context. Be concise and accurate. If the answer is not in the context, say so honestly. Use markdown formatting for code examples and links.`;
+async function handleAskAI(request, indexes, searchServer, aiConfig) {
+	const apiKey = aiConfig.apiKey ?? process.env.OPENAI_API_KEY;
+	if (!apiKey) return Response.json({ error: `AI is enabled but no API key was found. Either set apiKey in your docs.config or add OPENAI_API_KEY to your .env.local file.` }, { status: 500 });
+	let body;
+	try {
+		body = await request.json();
+	} catch {
+		return Response.json({ error: "Invalid JSON body. Expected { messages: [...] }" }, { status: 400 });
+	}
+	const messages = body.messages;
+	if (!Array.isArray(messages) || messages.length === 0) return Response.json({ error: "messages array is required and must not be empty." }, { status: 400 });
+	const lastUserMessage = [...messages].reverse().find((m) => m.role === "user");
+	if (!lastUserMessage) return Response.json({ error: "At least one user message is required." }, { status: 400 });
+	const maxResults = aiConfig.maxResults ?? 5;
+	const query = lastUserMessage.content;
+	const context = indexes.map((doc) => {
+		const q = query.toLowerCase();
+		const titleMatch = doc.title.toLowerCase().includes(q) ? 10 : 0;
+		const contentMatch = q.split(/\s+/).reduce((score, word) => {
+			return score + (doc.content.toLowerCase().includes(word) ? 1 : 0);
+		}, 0);
+		return {
+			...doc,
+			score: titleMatch + contentMatch
+		};
+	}).filter((d) => d.score > 0).sort((a, b) => b.score - a.score).slice(0, maxResults).map((doc) => `## ${doc.title}\nURL: ${doc.url}\n${doc.description ? `Description: ${doc.description}\n` : ""}\n${doc.content}`).join("\n\n---\n\n");
+	const systemPrompt = aiConfig.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+	const llmMessages = [{
+		role: "system",
+		content: context ? `${systemPrompt}\n\n---\n\nDocumentation context:\n\n${context}` : systemPrompt
+	}, ...messages.filter((m) => m.role !== "system")];
+	const baseUrl = (aiConfig.baseUrl ?? "https://api.openai.com/v1").replace(/\/$/, "");
+	const model = aiConfig.model ?? "gpt-4o-mini";
+	const llmResponse = await fetch(`${baseUrl}/chat/completions`, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			Authorization: `Bearer ${apiKey}`
+		},
+		body: JSON.stringify({
+			model,
+			stream: true,
+			messages: llmMessages
+		})
+	});
+	if (!llmResponse.ok) {
+		const errText = await llmResponse.text().catch(() => "Unknown error");
+		return Response.json({ error: `LLM API error (${llmResponse.status}): ${errText}` }, { status: 502 });
+	}
+	return new Response(llmResponse.body, { headers: {
+		"Content-Type": "text/event-stream",
+		"Cache-Control": "no-cache",
+		Connection: "keep-alive"
+	} });
+}
+/**
+* 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)
+*/
+function createDocsAPI(options) {
+	const root = process.cwd();
+	const entry = options?.entry ?? readEntry(root);
+	const docsDir = path.join(root, "app", entry);
+	const language = options?.language ?? "english";
+	const aiConfig = options?.ai ?? readAIConfig(root);
+	const indexes = scanDocsDir(docsDir, entry);
+	const searchAPI = createSearchAPI("simple", {
+		language,
+		indexes
+	});
+	return {
+		GET: searchAPI.GET,
+		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);
+		}
+	};
+}
+
+//#endregion
+export { createDocsAPI };

package/dist/docs-layout.d.mts

@@ -0,0 +1,33 @@
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { DocsConfig } from "@farming-labs/docs";
+
+//#region src/docs-layout.d.ts
+/**
+ * Build a Next.js Metadata object from the docs config.
+ *
+ * Returns layout-level metadata including `title.template` so each page's
+ * frontmatter `title` is formatted (e.g. "Getting Started – Docs").
+ *
+ * Usage in `app/docs/layout.tsx`:
+ * ```ts
+ * export const metadata = createDocsMetadata(docsConfig);
+ * ```
+ */
+declare function createDocsMetadata(config: DocsConfig): {
+  twitter?: {
+    card: "summary" | "summary_large_image";
+  } | undefined;
+  description?: string | undefined;
+  title: {
+    template: string;
+    default: string;
+  };
+};
+declare function createDocsLayout(config: DocsConfig): ({
+  children
+}: {
+  children: ReactNode;
+}) => react_jsx_runtime0.JSX.Element;
+//#endregion
+export { createDocsLayout, createDocsMetadata };

package/dist/docs-layout.mjs

@@ -0,0 +1,331 @@
+import { DocsAIFeatures } from "./docs-ai-features.mjs";
+import { serializeIcon } from "./serialize-icon.mjs";
+import { DocsPageClient } from "./docs-page-client.mjs";
+import { jsx, jsxs } from "react/jsx-runtime";
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { DocsLayout } from "fumadocs-ui/layouts/docs";
+
+//#region src/docs-layout.tsx
+/** Resolve a frontmatter `icon` string to a ReactNode via the icon registry. */
+function resolveIcon(iconKey, registry) {
+	if (!iconKey || !registry) return void 0;
+	return registry[iconKey] ?? void 0;
+}
+/** Read frontmatter from a page.mdx file. */
+function readFrontmatter(filePath) {
+	try {
+		const { data } = matter(fs.readFileSync(filePath, "utf-8"));
+		return data;
+	} catch {
+		return {};
+	}
+}
+/** Check if a directory has any subdirectories that contain page.mdx. */
+function hasChildPages(dir) {
+	if (!fs.existsSync(dir)) return false;
+	for (const name of fs.readdirSync(dir)) {
+		const full = path.join(dir, name);
+		if (fs.statSync(full).isDirectory() && fs.existsSync(path.join(full, "page.mdx"))) return true;
+	}
+	return false;
+}
+function buildTree(config) {
+	const docsDir = path.join(process.cwd(), "app", config.entry);
+	const icons = config.icons;
+	const rootChildren = [];
+	if (fs.existsSync(path.join(docsDir, "page.mdx"))) {
+		const data = readFrontmatter(path.join(docsDir, "page.mdx"));
+		rootChildren.push({
+			type: "page",
+			name: data.title ?? "Documentation",
+			url: `/${config.entry}`,
+			icon: resolveIcon(data.icon, icons)
+		});
+	}
+	/**
+	* Recursively scan a directory and return tree nodes.
+	*
+	* - If a subdirectory has its own children (nested pages), it becomes a
+	*   **folder** node with collapsible children. Its own `page.mdx` becomes
+	*   the folder's `index` page.
+	* - Otherwise it becomes a simple **page** node.
+	*/
+	function scan(dir, baseSlug) {
+		if (!fs.existsSync(dir)) return [];
+		const nodes = [];
+		const entries = fs.readdirSync(dir).sort();
+		for (const name of entries) {
+			const full = path.join(dir, name);
+			if (!fs.statSync(full).isDirectory()) continue;
+			const pagePath = path.join(full, "page.mdx");
+			if (!fs.existsSync(pagePath)) continue;
+			const data = readFrontmatter(pagePath);
+			const slug = [...baseSlug, name];
+			const url = `/${config.entry}/${slug.join("/")}`;
+			const icon = resolveIcon(data.icon, icons);
+			const displayName = data.title ?? name.replace(/-/g, " ");
+			if (hasChildPages(full)) {
+				const folderChildren = scan(full, slug);
+				nodes.push({
+					type: "folder",
+					name: displayName,
+					icon,
+					index: {
+						type: "page",
+						name: displayName,
+						url,
+						icon
+					},
+					children: folderChildren
+				});
+			} else nodes.push({
+				type: "page",
+				name: displayName,
+				url,
+				icon
+			});
+		}
+		return nodes;
+	}
+	rootChildren.push(...scan(docsDir, []));
+	return {
+		name: "Docs",
+		children: rootChildren
+	};
+}
+/**
+* Scan all page.mdx files under the docs entry directory and build
+* a map of URL pathname → formatted last-modified date string.
+*/
+function buildLastModifiedMap(entry) {
+	const docsDir = path.join(process.cwd(), "app", entry);
+	const map = {};
+	function formatDate(date) {
+		return date.toLocaleDateString("en-US", {
+			year: "numeric",
+			month: "long",
+			day: "numeric"
+		});
+	}
+	function scan(dir, slugParts) {
+		if (!fs.existsSync(dir)) return;
+		const pagePath = path.join(dir, "page.mdx");
+		if (fs.existsSync(pagePath)) {
+			const url = slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`;
+			map[url] = formatDate(fs.statSync(pagePath).mtime);
+		}
+		for (const name of fs.readdirSync(dir)) {
+			const full = path.join(dir, name);
+			if (fs.statSync(full).isDirectory()) scan(full, [...slugParts, name]);
+		}
+	}
+	scan(docsDir, []);
+	return map;
+}
+/**
+* Build a Next.js Metadata object from the docs config.
+*
+* Returns layout-level metadata including `title.template` so each page's
+* frontmatter `title` is formatted (e.g. "Getting Started – Docs").
+*
+* Usage in `app/docs/layout.tsx`:
+* ```ts
+* export const metadata = createDocsMetadata(docsConfig);
+* ```
+*/
+function createDocsMetadata(config) {
+	const meta = config.metadata;
+	const template = meta?.titleTemplate ?? "%s";
+	return {
+		title: {
+			template,
+			default: template.replace("%s", "").replace(/^[\s–—-]+/, "").trim() || "Docs"
+		},
+		...meta?.description ? { description: meta.description } : {},
+		...meta?.twitterCard ? { twitter: { card: meta.twitterCard } } : {}
+	};
+}
+/** Resolve the themeToggle config into fumadocs-ui's `themeSwitch` prop. */
+function resolveThemeSwitch(toggle) {
+	if (toggle === void 0 || toggle === true) return { enabled: true };
+	if (toggle === false) return { enabled: false };
+	return {
+		enabled: toggle.enabled !== false,
+		mode: toggle.mode
+	};
+}
+/** Resolve sidebar config. */
+function resolveSidebar(sidebar) {
+	if (sidebar === void 0 || sidebar === true) return {};
+	if (sidebar === false) return { enabled: false };
+	return {
+		enabled: sidebar.enabled !== false,
+		component: sidebar.component,
+		footer: sidebar.footer,
+		banner: sidebar.banner,
+		collapsible: sidebar.collapsible
+	};
+}
+const COLOR_MAP = {
+	primary: "--color-fd-primary",
+	primaryForeground: "--color-fd-primary-foreground",
+	background: "--color-fd-background",
+	foreground: "--color-fd-foreground",
+	muted: "--color-fd-muted",
+	mutedForeground: "--color-fd-muted-foreground",
+	border: "--color-fd-border",
+	card: "--color-fd-card",
+	cardForeground: "--color-fd-card-foreground",
+	accent: "--color-fd-accent",
+	accentForeground: "--color-fd-accent-foreground",
+	popover: "--color-fd-popover",
+	popoverForeground: "--color-fd-popover-foreground",
+	secondary: "--color-fd-secondary",
+	secondaryForeground: "--color-fd-secondary-foreground",
+	ring: "--color-fd-ring"
+};
+function buildColorsCSS(colors) {
+	if (!colors) return "";
+	const vars = [];
+	for (const [key, value] of Object.entries(colors)) {
+		if (!value || !COLOR_MAP[key]) continue;
+		vars.push(`${COLOR_MAP[key]}: ${value};`);
+	}
+	if (vars.length === 0) return "";
+	return `:root, .dark {\n  ${vars.join("\n  ")}\n}`;
+}
+function ColorStyle({ colors }) {
+	const css = buildColorsCSS(colors);
+	if (!css) return null;
+	return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: css } });
+}
+function buildFontStyleVars(prefix, style) {
+	if (!style) return "";
+	const parts = [];
+	if (style.size) parts.push(`${prefix}-size: ${style.size};`);
+	if (style.weight != null) parts.push(`${prefix}-weight: ${style.weight};`);
+	if (style.lineHeight) parts.push(`${prefix}-line-height: ${style.lineHeight};`);
+	if (style.letterSpacing) parts.push(`${prefix}-letter-spacing: ${style.letterSpacing};`);
+	return parts.join("\n  ");
+}
+function buildTypographyCSS(typo) {
+	if (!typo?.font) return "";
+	const vars = [];
+	const fontStyle = typo.font.style;
+	if (fontStyle?.sans) vars.push(`--fd-font-sans: ${fontStyle.sans};`);
+	if (fontStyle?.mono) vars.push(`--fd-font-mono: ${fontStyle.mono};`);
+	for (const el of [
+		"h1",
+		"h2",
+		"h3",
+		"h4",
+		"body",
+		"small"
+	]) {
+		const style = typo.font[el];
+		if (style) {
+			const cssVars = buildFontStyleVars(`--fd-${el}`, style);
+			if (cssVars) vars.push(cssVars);
+		}
+	}
+	if (vars.length === 0) return "";
+	return `:root {\n  ${vars.join("\n  ")}\n}`;
+}
+function TypographyStyle({ typography }) {
+	const css = buildTypographyCSS(typography);
+	if (!css) return null;
+	return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: css } });
+}
+function createDocsLayout(config) {
+	const tocEnabled = (config.theme?.ui?.layout?.toc)?.enabled !== false;
+	const navTitle = config.nav?.title ?? "Docs";
+	const navUrl = config.nav?.url ?? `/${config.entry}`;
+	const themeSwitch = resolveThemeSwitch(config.themeToggle);
+	const toggleConfig = typeof config.themeToggle === "object" ? config.themeToggle : void 0;
+	const forcedTheme = themeSwitch.enabled === false && toggleConfig?.default && toggleConfig.default !== "system" ? toggleConfig.default : void 0;
+	const sidebarProps = resolveSidebar(config.sidebar);
+	const breadcrumbConfig = config.breadcrumb;
+	const breadcrumbEnabled = breadcrumbConfig === void 0 || breadcrumbConfig === true || typeof breadcrumbConfig === "object" && breadcrumbConfig.enabled !== false;
+	const colors = config.theme?._userColorOverrides;
+	const typography = config.theme?.ui?.typography;
+	const pageActions = config.pageActions;
+	const copyMarkdownEnabled = resolveBool(pageActions?.copyMarkdown);
+	const openDocsEnabled = resolveBool(pageActions?.openDocs);
+	const pageActionsPosition = pageActions?.position ?? "below-title";
+	const openDocsProviders = (typeof pageActions?.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((p) => ({
+		name: p.name,
+		urlTemplate: p.urlTemplate,
+		iconHtml: p.icon ? serializeIcon(p.icon) : void 0
+	}));
+	const githubRaw = config.github;
+	const githubUrl = typeof githubRaw === "string" ? githubRaw.replace(/\/$/, "") : githubRaw?.url.replace(/\/$/, "");
+	const githubBranch = typeof githubRaw === "object" ? githubRaw.branch ?? "main" : "main";
+	const githubDirectory = typeof githubRaw === "object" ? githubRaw.directory?.replace(/^\/|\/$/g, "") : void 0;
+	const aiConfig = config.ai;
+	const aiEnabled = !!aiConfig?.enabled;
+	const aiMode = aiConfig?.mode ?? "search";
+	const aiPosition = aiConfig?.position ?? "bottom-right";
+	const aiFloatingStyle = aiConfig?.floatingStyle ?? "panel";
+	const aiTriggerComponentHtml = aiConfig?.triggerComponent ? serializeIcon(aiConfig.triggerComponent) : void 0;
+	const aiSuggestedQuestions = aiConfig?.suggestedQuestions;
+	const aiLabel = aiConfig?.aiLabel;
+	const aiLoadingComponentHtml = typeof aiConfig?.loadingComponent === "function" ? serializeIcon(aiConfig.loadingComponent({ name: aiLabel || "AI" })) : void 0;
+	const lastModifiedMap = buildLastModifiedMap(config.entry);
+	return function DocsLayoutWrapper({ children }) {
+		return /* @__PURE__ */ jsxs(DocsLayout, {
+			tree: buildTree(config),
+			nav: {
+				title: navTitle,
+				url: navUrl
+			},
+			themeSwitch,
+			sidebar: sidebarProps,
+			children: [
+				/* @__PURE__ */ jsx(ColorStyle, { colors }),
+				/* @__PURE__ */ jsx(TypographyStyle, { typography }),
+				forcedTheme && /* @__PURE__ */ jsx(ForcedThemeScript, { theme: forcedTheme }),
+				aiEnabled && /* @__PURE__ */ jsx(DocsAIFeatures, {
+					mode: aiMode,
+					position: aiPosition,
+					floatingStyle: aiFloatingStyle,
+					triggerComponentHtml: aiTriggerComponentHtml,
+					suggestedQuestions: aiSuggestedQuestions,
+					aiLabel,
+					loadingComponentHtml: aiLoadingComponentHtml
+				}),
+				/* @__PURE__ */ jsx(DocsPageClient, {
+					tocEnabled,
+					breadcrumbEnabled,
+					entry: config.entry,
+					copyMarkdown: copyMarkdownEnabled,
+					openDocs: openDocsEnabled,
+					openDocsProviders,
+					pageActionsPosition,
+					githubUrl,
+					githubBranch,
+					githubDirectory,
+					lastModifiedMap,
+					children
+				})
+			]
+		});
+	};
+}
+/** Resolve `boolean | { enabled?: boolean }` to a simple boolean. */
+function resolveBool(v) {
+	if (v === void 0) return false;
+	if (typeof v === "boolean") return v;
+	return v.enabled !== false;
+}
+/**
+* Tiny inline script to force a theme when the toggle is hidden.
+* Sets the class on <html> before React hydrates to avoid FOUC.
+*/
+function ForcedThemeScript({ theme }) {
+	return /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: `document.documentElement.classList.remove('light','dark');document.documentElement.classList.add('${theme}');` } });
+}
+
+//#endregion
+export { createDocsLayout, createDocsMetadata };

package/dist/docs-page-client.d.mts

@@ -0,0 +1,46 @@
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/docs-page-client.d.ts
+/** Serializable provider — icon is an HTML string, not JSX. */
+interface SerializedProvider {
+  name: string;
+  iconHtml?: string;
+  urlTemplate: string;
+}
+interface DocsPageClientProps {
+  tocEnabled: boolean;
+  breadcrumbEnabled?: boolean;
+  /** The docs entry folder name (e.g. "docs") — used to strip from breadcrumb */
+  entry?: string;
+  copyMarkdown?: boolean;
+  openDocs?: boolean;
+  openDocsProviders?: SerializedProvider[];
+  /** Where to render page actions relative to the title */
+  pageActionsPosition?: "above-title" | "below-title";
+  /** GitHub repository URL (e.g. "https://github.com/user/repo") */
+  githubUrl?: string;
+  /** GitHub branch name @default "main" */
+  githubBranch?: string;
+  /** Subdirectory in the repo where the docs site lives (for monorepos) */
+  githubDirectory?: string;
+  /** Map of pathname → formatted last-modified date string */
+  lastModifiedMap?: Record<string, string>;
+  children: ReactNode;
+}
+declare function DocsPageClient({
+  tocEnabled,
+  breadcrumbEnabled,
+  entry,
+  copyMarkdown,
+  openDocs,
+  openDocsProviders,
+  pageActionsPosition,
+  githubUrl,
+  githubBranch,
+  githubDirectory,
+  lastModifiedMap,
+  children
+}: DocsPageClientProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsPageClient };