@farming-labs/theme 0.0.28 → 0.0.30

package/dist/ai-search-dialog.mjs

@@ -603,7 +603,9 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 		setIsSearching(true);
 		const timer = setTimeout(async () => {
 			try {
-				const res = await fetch(`${api}?query=${encodeURIComponent(searchQuery)}`);
+				const requestUrl = new URL(api, window.location.origin);
+				requestUrl.searchParams.set("query", searchQuery);
+				const res = await fetch(requestUrl.toString());
 				if (res.ok) {
 					setSearchResults(await res.json());
 					setActiveIndex(0);

package/dist/code-block-copy-wrapper.d.mts

@@ -1,5 +1,5 @@
-import { CodeBlockCopyData } from "@farming-labs/docs";
 import * as React$1 from "react";
+import { CodeBlockCopyData } from "@farming-labs/docs";
 
 //#region src/code-block-copy-wrapper.d.ts
 type PreProps = React$1.ComponentPropsWithoutRef<"pre">;

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

@@ -3,6 +3,8 @@ import * as react_jsx_runtime0 from "react/jsx-runtime";
 //#region src/docs-ai-features.d.ts
 interface DocsAIFeaturesProps {
   mode: "search" | "floating" | "sidebar-icon";
+  api?: string;
+  locale?: string;
   position?: "bottom-right" | "bottom-left" | "bottom-center";
   floatingStyle?: "panel" | "modal" | "popover" | "full-modal";
   triggerComponentHtml?: string;
@@ -18,6 +20,8 @@ interface DocsAIFeaturesProps {
 }
 declare function DocsAIFeatures({
   mode,
+  api,
+  locale,
   position,
   floatingStyle,
   triggerComponentHtml,

package/dist/docs-ai-features.mjs

@@ -1,7 +1,9 @@
 "use client";
 
+import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
 import { AIModalDialog, DocsSearchDialog, FloatingAIChat } from "./ai-search-dialog.mjs";
 import { useEffect, useState } from "react";
+import { useSearchParams } from "next/navigation";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-ai-features.tsx
@@ -19,8 +21,10 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 * 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.ts`.
 */
-function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+function DocsAIFeatures({ mode, api = "/api/docs", locale, position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+	const localizedApi = withLangInUrl(api, resolveClientLocale(useSearchParams(), locale));
 	if (mode === "search") return /* @__PURE__ */ jsx(SearchModeAI, {
+		api: localizedApi,
 		suggestedQuestions,
 		aiLabel,
 		loaderVariant,
@@ -29,6 +33,7 @@ function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "pane
 		defaultModelId
 	});
 	if (mode === "sidebar-icon") return /* @__PURE__ */ jsx(SidebarIconModeAI, {
+		api: localizedApi,
 		suggestedQuestions,
 		aiLabel,
 		loaderVariant,
@@ -37,7 +42,7 @@ function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "pane
 		defaultModelId
 	});
 	return /* @__PURE__ */ jsx(FloatingAIChat, {
-		api: "/api/docs",
+		api: localizedApi,
 		position,
 		floatingStyle,
 		triggerComponentHtml,
@@ -49,7 +54,7 @@ function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "pane
 		defaultModelId
 	});
 }
-function SearchModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+function SearchModeAI({ api, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
 	const [open, setOpen] = useState(false);
 	useEffect(() => {
 		function handler(e) {
@@ -81,7 +86,7 @@ function SearchModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingCompo
 	return /* @__PURE__ */ jsx(DocsSearchDialog, {
 		open,
 		onOpenChange: setOpen,
-		api: "/api/docs",
+		api,
 		suggestedQuestions,
 		aiLabel,
 		loaderVariant,
@@ -90,7 +95,7 @@ function SearchModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingCompo
 		defaultModelId
 	});
 }
-function SidebarIconModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+function SidebarIconModeAI({ api, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
 	const [searchOpen, setSearchOpen] = useState(false);
 	const [aiOpen, setAiOpen] = useState(false);
 	useEffect(() => {
@@ -122,7 +127,7 @@ function SidebarIconModeAI({ suggestedQuestions, aiLabel, loaderVariant, loading
 	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(DocsSearchDialog, {
 		open: searchOpen,
 		onOpenChange: setSearchOpen,
-		api: "/api/docs",
+		api,
 		suggestedQuestions,
 		aiLabel,
 		loaderVariant,
@@ -132,7 +137,7 @@ function SidebarIconModeAI({ suggestedQuestions, aiLabel, loaderVariant, loading
 	}), /* @__PURE__ */ jsx(AIModalDialog, {
 		open: aiOpen,
 		onOpenChange: setAiOpen,
-		api: "/api/docs",
+		api,
 		suggestedQuestions,
 		aiLabel,
 		loaderVariant,

package/dist/docs-api.d.mts

@@ -1,23 +1,6 @@
+import { DocsI18nConfig } from "@farming-labs/docs";
+
 //#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 AIProviderConfig {
   baseUrl: string;
   apiKey?: string;
@@ -49,6 +32,8 @@ interface DocsAPIOptions {
   language?: string;
   /** AI chat configuration */
   ai?: AIOptions;
+  /** i18n config (optional) */
+  i18n?: DocsI18nConfig;
 }
 /**
  * Create a unified docs API route handler.

package/dist/docs-api.mjs

@@ -1,7 +1,9 @@
 import { getNextAppDir } from "./get-app-dir.mjs";
+import { withLangInUrl } from "./i18n.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
+import { resolveDocsI18n, resolveDocsLocale } from "@farming-labs/docs";
 import { createSearchAPI } from "fumadocs-core/search/server";
 
 //#region src/docs-api.ts
@@ -40,6 +42,25 @@ function readEntry(root) {
 	}
 	return "docs";
 }
+function readI18nConfig(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = path.join(root, `docs.config.${ext}`);
+		if (!fs.existsSync(configPath)) continue;
+		try {
+			const content = fs.readFileSync(configPath, "utf-8");
+			if (!content.includes("i18n")) continue;
+			const localesMatch = content.match(/i18n\s*:\s*\{[\s\S]*?locales\s*:\s*\[([^\]]+)\]/);
+			if (!localesMatch) continue;
+			const locales = localesMatch[1].split(",").map((l) => l.trim().replace(/^['\"`]|['\"`]$/g, "")).filter(Boolean);
+			if (locales.length === 0) continue;
+			return {
+				locales,
+				defaultLocale: content.match(/i18n\s*:\s*\{[\s\S]*?defaultLocale\s*:\s*["']([^"']+)["']/)?.[1]
+			};
+		} catch {}
+	}
+	return null;
+}
 /**
 * Read AI config from docs.config by parsing the file for the `ai` block.
 * This avoids importing the config (which may use JSX/React).
@@ -73,7 +94,7 @@ 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) {
+function scanDocsDir(docsDir, entry, locale) {
 	const indexes = [];
 	function scan(dir, slugParts) {
 		if (!fs.existsSync(dir)) return;
@@ -84,7 +105,7 @@ function scanDocsDir(docsDir, entry) {
 			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("/")}`;
+			const url = withLangInUrl(slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`, locale);
 			indexes.push({
 				title,
 				description,
@@ -250,40 +271,85 @@ function createDocsAPI(options) {
 	const root = process.cwd();
 	const entry = options?.entry ?? readEntry(root);
 	const appDir = getNextAppDir(root);
-	const docsDir = path.join(root, appDir, entry);
 	const language = options?.language ?? "english";
+	const i18n = resolveDocsI18n(options?.i18n ?? readI18nConfig(root));
 	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, {
+	function resolveLocaleFromRequest(request) {
+		if (!i18n) return void 0;
+		const direct = resolveDocsLocale(new URL(request.url).searchParams, i18n);
+		if (direct) return direct;
+		const referrer = request.headers.get("referer") ?? request.headers.get("referrer");
+		if (referrer) try {
+			const fromRef = resolveDocsLocale(new URL(referrer).searchParams, i18n);
+			if (fromRef) return fromRef;
+		} catch {}
+		return i18n.defaultLocale;
+	}
+	function resolveContextFromRequest(request) {
+		if (!i18n) return {
+			entryPath: entry,
+			docsDir: path.join(root, appDir, entry)
+		};
+		const locale = resolveLocaleFromRequest(request) ?? i18n.defaultLocale;
+		return {
+			entryPath: entry,
+			locale,
+			docsDir: path.join(root, appDir, entry, locale)
+		};
+	}
+	const indexesByLocale = /* @__PURE__ */ new Map();
+	const searchApiByLocale = /* @__PURE__ */ new Map();
+	const llmsCacheByLocale = /* @__PURE__ */ new Map();
+	function getIndexes(ctx) {
+		const key = ctx.locale ?? "__default__";
+		const cached = indexesByLocale.get(key);
+		if (cached) return cached;
+		const next = scanDocsDir(ctx.docsDir, ctx.entryPath, ctx.locale);
+		indexesByLocale.set(key, next);
+		return next;
+	}
+	function getSearchAPI(ctx) {
+		const key = ctx.locale ?? "__default__";
+		const cached = searchApiByLocale.get(key);
+		if (cached) return cached;
+		const api = createSearchAPI("simple", {
+			language,
+			indexes: getIndexes(ctx)
+		});
+		searchApiByLocale.set(key, api);
+		return api;
+	}
+	function getLlmsContent(ctx) {
+		const key = ctx.locale ?? "__default__";
+		const cached = llmsCacheByLocale.get(key);
+		if (cached) return cached;
+		const next = generateLlmsTxt(getIndexes(ctx), {
 			siteTitle: llmsConfig.siteTitle ?? "Documentation",
 			siteDescription: llmsConfig.siteDescription,
 			baseUrl: llmsConfig.baseUrl ?? ""
 		});
-		return _llmsCache;
+		llmsCacheByLocale.set(key, next);
+		return next;
 	}
-	const searchAPI = createSearchAPI("simple", {
-		language,
-		indexes
-	});
 	return {
 		GET(request) {
+			const ctx = resolveContextFromRequest(request);
 			const format = new URL(request.url).searchParams.get("format");
-			if (format === "llms") return new Response(getLlmsContent().llmsTxt, { headers: {
+			if (format === "llms") return new Response(getLlmsContent(ctx).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: {
+			if (format === "llms-full") return new Response(getLlmsContent(ctx).llmsFullTxt, { headers: {
 				"Content-Type": "text/plain; charset=utf-8",
 				"Cache-Control": "public, max-age=3600"
 			} });
-			return searchAPI.GET(request);
+			return getSearchAPI(ctx).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);
+			const ctx = resolveContextFromRequest(request);
+			return handleAskAI(request, getIndexes(ctx), getSearchAPI(ctx), aiConfig);
 		}
 	};
 }

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

@@ -5,6 +5,12 @@
  * fuzzy-search experience. Styled entirely via omni-* CSS classes
  * so each theme provides its own visual variant.
  */
-declare function DocsCommandSearch(): any;
+declare function DocsCommandSearch({
+  api,
+  locale
+}: {
+  api?: string;
+  locale?: string;
+}): any;
 //#endregion
 export { DocsCommandSearch };

package/dist/docs-command-search.mjs

@@ -1,7 +1,9 @@
 "use client";
 
+import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
+import { useSearchParams } from "next/navigation";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-command-search.tsx
@@ -297,7 +299,7 @@ function labelForType(type) {
 * fuzzy-search experience. Styled entirely via omni-* CSS classes
 * so each theme provides its own visual variant.
 */
-function DocsCommandSearch() {
+function DocsCommandSearch({ api = "/api/docs", locale }) {
 	const [open, setOpen] = useState(false);
 	const [query, setQuery] = useState("");
 	const [debouncedQuery, setDebouncedQuery] = useState("");
@@ -306,6 +308,8 @@ function DocsCommandSearch() {
 	const [activeIndex, setActiveIndex] = useState(0);
 	const [recents, setRecents] = useState([]);
 	const [mounted, setMounted] = useState(false);
+	const activeLocale = resolveClientLocale(useSearchParams(), locale);
+	const searchApi = useMemo(() => withLangInUrl(api, activeLocale), [activeLocale, api]);
 	const inputRef = useRef(null);
 	const listRef = useRef(null);
 	useEffect(() => {
@@ -357,7 +361,9 @@ function DocsCommandSearch() {
 		setLoading(true);
 		(async () => {
 			try {
-				const res = await fetch(`/api/docs?query=${encodeURIComponent(debouncedQuery)}`);
+				const requestUrl = new URL(searchApi, window.location.origin);
+				requestUrl.searchParams.set("query", debouncedQuery);
+				const res = await fetch(requestUrl.toString());
 				if (!res.ok || cancelled) return;
 				const items = (await res.json()).map((r) => {
 					const label = stripHtml(r.content);
@@ -366,7 +372,7 @@ function DocsCommandSearch() {
 						id: r.id,
 						label,
 						subtitle: labelForType(r.type),
-						url: r.url,
+						url: withLangInUrl(r.url, activeLocale),
 						icon: iconForType(r.type),
 						score,
 						indices
@@ -383,7 +389,11 @@ function DocsCommandSearch() {
 		return () => {
 			cancelled = true;
 		};
-	}, [debouncedQuery]);
+	}, [
+		activeLocale,
+		debouncedQuery,
+		searchApi
+	]);
 	useEffect(() => {
 		if (open) setTimeout(() => inputRef.current?.focus(), 10);
 		else {

package/dist/docs-layout.d.mts

@@ -1,5 +1,5 @@
-import { DocsConfig, PageFrontmatter } from "@farming-labs/docs";
 import { ReactNode } from "react";
+import { DocsConfig, PageFrontmatter } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/docs-layout.d.ts
@@ -29,7 +29,9 @@ declare function createDocsMetadata(config: DocsConfig): Record<string, unknown>
  * ```
  */
 declare function createPageMetadata(config: DocsConfig, page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, baseUrl?: string): Record<string, unknown>;
-declare function createDocsLayout(config: DocsConfig): ({
+declare function createDocsLayout(config: DocsConfig, options?: {
+  locale?: string;
+}): ({
   children
 }: {
   children: ReactNode;

package/dist/docs-layout.mjs

@@ -1,13 +1,16 @@
 import { getNextAppDir } from "./get-app-dir.mjs";
 import { serializeIcon } from "./serialize-icon.mjs";
+import { withLangInUrl } from "./i18n.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { DocsAIFeatures } from "./docs-ai-features.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
 import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
+import { LocaleThemeControl } from "./locale-theme-control.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
+import { Suspense } from "react";
 import { buildPageOpenGraph, buildPageTwitter } from "@farming-labs/docs";
 import { jsx, jsxs } from "react/jsx-runtime";
 
@@ -35,9 +38,35 @@ function hasChildPages(dir) {
 	}
 	return false;
 }
-function buildTree(config, flat = false) {
+function getDocsI18n(config) {
+	return config.i18n;
+}
+function resolveDocsI18nConfig(i18n) {
+	if (!i18n || !Array.isArray(i18n.locales)) return null;
+	const locales = Array.from(new Set(i18n.locales.map((item) => item.trim()).filter(Boolean)));
+	if (locales.length === 0) return null;
+	return {
+		locales,
+		defaultLocale: i18n.defaultLocale && locales.includes(i18n.defaultLocale) ? i18n.defaultLocale : locales[0]
+	};
+}
+function resolveDocsLocaleContext(config, locale) {
+	const entryBase = config.entry ?? "docs";
 	const appDir = getNextAppDir(process.cwd());
-	const docsDir = path.join(process.cwd(), appDir, config.entry);
+	const i18n = resolveDocsI18nConfig(getDocsI18n(config));
+	if (!i18n) return {
+		entryPath: entryBase,
+		docsDir: path.join(process.cwd(), appDir, entryBase)
+	};
+	const resolvedLocale = locale && i18n.locales.includes(locale) ? locale : i18n.defaultLocale;
+	return {
+		entryPath: entryBase,
+		locale: resolvedLocale,
+		docsDir: path.join(process.cwd(), appDir, entryBase, resolvedLocale)
+	};
+}
+function buildTree(config, ctx, flat = false) {
+	const docsDir = ctx.docsDir;
 	const icons = config.icons;
 	const ordering = config.ordering;
 	const rootChildren = [];
@@ -46,7 +75,7 @@ function buildTree(config, flat = false) {
 		rootChildren.push({
 			type: "page",
 			name: data.title ?? "Documentation",
-			url: `/${config.entry}`,
+			url: `/${ctx.entryPath}`,
 			icon: resolveIcon(data.icon, icons)
 		});
 	}
@@ -57,7 +86,7 @@ function buildTree(config, flat = false) {
 		if (!fs.existsSync(pagePath)) return null;
 		const data = readFrontmatter(pagePath);
 		const slug = [...baseSlug, name];
-		const url = `/${config.entry}/${slug.join("/")}`;
+		const url = `/${ctx.entryPath}/${slug.join("/")}`;
 		const icon = resolveIcon(data.icon, icons);
 		const displayName = data.title ?? name.replace(/-/g, " ");
 		if (hasChildPages(full)) {
@@ -140,13 +169,32 @@ function buildTree(config, flat = false) {
 		children: rootChildren
 	};
 }
+function localizeTreeUrls(tree, locale) {
+	function mapNode(node) {
+		if (node.type === "page") return {
+			...node,
+			url: withLangInUrl(node.url, locale)
+		};
+		return {
+			...node,
+			index: node.index ? {
+				...node.index,
+				url: withLangInUrl(node.index.url, locale)
+			} : void 0,
+			children: node.children.map(mapNode)
+		};
+	}
+	return {
+		...tree,
+		children: tree.children.map(mapNode)
+	};
+}
 /**
 * 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 appDir = getNextAppDir(process.cwd());
-	const docsDir = path.join(process.cwd(), appDir, entry);
+function buildLastModifiedMap(ctx) {
+	const docsDir = ctx.docsDir;
 	const map = {};
 	function formatDate(date) {
 		return date.toLocaleDateString("en-US", {
@@ -159,7 +207,7 @@ function buildLastModifiedMap(entry) {
 		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("/")}`;
+			const url = slugParts.length === 0 ? `/${ctx.entryPath}` : `/${ctx.entryPath}/${slugParts.join("/")}`;
 			map[url] = formatDate(fs.statSync(pagePath).mtime);
 		}
 		for (const name of fs.readdirSync(dir)) {
@@ -174,9 +222,8 @@ function buildLastModifiedMap(entry) {
 * Scan all page.mdx files and build a map of URL pathname → description
 * from the frontmatter `description` field.
 */
-function buildDescriptionMap(entry) {
-	const appDir = getNextAppDir(process.cwd());
-	const docsDir = path.join(process.cwd(), appDir, entry);
+function buildDescriptionMap(ctx) {
+	const docsDir = ctx.docsDir;
 	const map = {};
 	function scan(dir, slugParts) {
 		if (!fs.existsSync(dir)) return;
@@ -184,7 +231,7 @@ function buildDescriptionMap(entry) {
 		if (fs.existsSync(pagePath)) {
 			const desc = readFrontmatter(pagePath).description;
 			if (desc) {
-				const url = slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`;
+				const url = slugParts.length === 0 ? `/${ctx.entryPath}` : `/${ctx.entryPath}/${slugParts.join("/")}`;
 				map[url] = desc;
 			}
 		}
@@ -380,12 +427,16 @@ function LayoutStyle({ layout }) {
 	}
 	return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: parts.join("\n") } });
 }
-function createDocsLayout(config) {
+function createDocsLayout(config, options) {
 	const tocConfig = config.theme?.ui?.layout?.toc;
 	const tocEnabled = tocConfig?.enabled !== false;
 	const tocStyle = tocConfig?.style;
+	const localeContext = resolveDocsLocaleContext(config, options?.locale);
+	const i18n = resolveDocsI18nConfig(getDocsI18n(config));
+	const activeLocale = localeContext.locale ?? i18n?.defaultLocale;
+	const docsApiUrl = withLangInUrl("/api/docs", activeLocale);
 	const navTitle = config.nav?.title ?? "Docs";
-	const navUrl = config.nav?.url ?? `/${config.entry}`;
+	const navUrl = withLangInUrl(config.nav?.url ?? `/${localeContext.entryPath}`, activeLocale);
 	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;
@@ -434,13 +485,32 @@ function createDocsLayout(config) {
 		aiModels = rawModelConfig.models ?? aiModels;
 		aiDefaultModelId = rawModelConfig.defaultModel ?? rawModelConfig.models?.[0]?.id ?? aiDefaultModelId;
 	}
-	const lastModifiedMap = buildLastModifiedMap(config.entry);
-	const descriptionMap = buildDescriptionMap(config.entry);
+	const lastModifiedMap = buildLastModifiedMap(localeContext);
+	const descriptionMap = buildDescriptionMap(localeContext);
 	return function DocsLayoutWrapper({ children }) {
-		const tree = buildTree(config, !!sidebarFlat);
+		const tree = buildTree(config, localeContext, !!sidebarFlat);
+		const localizedTree = i18n ? localizeTreeUrls(tree, activeLocale) : tree;
 		const finalSidebarProps = { ...sidebarProps };
+		const sidebarFooter = sidebarProps.footer;
+		if (i18n) finalSidebarProps.footer = /* @__PURE__ */ jsxs("div", {
+			style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 12
+			},
+			children: [sidebarFooter, /* @__PURE__ */ jsx(Suspense, {
+				fallback: null,
+				children: /* @__PURE__ */ jsx(LocaleThemeControl, {
+					locales: i18n.locales,
+					defaultLocale: i18n.defaultLocale,
+					locale: activeLocale,
+					showThemeToggle: themeSwitch.enabled !== false,
+					themeMode: themeSwitch.mode
+				})
+			})]
+		});
 		if (sidebarComponentFn) finalSidebarProps.component = sidebarComponentFn({
-			tree,
+			tree: localizedTree,
 			collapsible: sidebarProps.collapsible !== false,
 			flat: !!sidebarFlat
 		});
@@ -448,12 +518,15 @@ function createDocsLayout(config) {
 			id: "nd-docs-layout",
 			style: { display: "contents" },
 			children: /* @__PURE__ */ jsxs(DocsLayout, {
-				tree,
+				tree: localizedTree,
 				nav: {
 					title: navTitle,
 					url: navUrl
 				},
-				themeSwitch,
+				themeSwitch: i18n ? {
+					...themeSwitch,
+					enabled: false
+				} : themeSwitch,
 				sidebar: finalSidebarProps,
 				...aiMode === "sidebar-icon" && aiEnabled ? { searchToggle: { components: { lg: /* @__PURE__ */ jsx(SidebarSearchWithAI, {}) } } } : {},
 				children: [
@@ -461,38 +534,53 @@ function createDocsLayout(config) {
 					/* @__PURE__ */ jsx(TypographyStyle, { typography }),
 					/* @__PURE__ */ jsx(LayoutStyle, { layout: layoutDimensions }),
 					forcedTheme && /* @__PURE__ */ jsx(ForcedThemeScript, { theme: forcedTheme }),
-					!staticExport && /* @__PURE__ */ jsx(DocsCommandSearch, {}),
-					aiEnabled && /* @__PURE__ */ jsx(DocsAIFeatures, {
-						mode: aiMode,
-						position: aiPosition,
-						floatingStyle: aiFloatingStyle,
-						triggerComponentHtml: aiTriggerComponentHtml,
-						suggestedQuestions: aiSuggestedQuestions,
-						aiLabel,
-						loaderVariant: aiLoaderVariant,
-						loadingComponentHtml: aiLoadingComponentHtml,
-						models: aiModels,
-						defaultModelId: aiDefaultModelId
+					!staticExport && /* @__PURE__ */ jsx(Suspense, {
+						fallback: null,
+						children: /* @__PURE__ */ jsx(DocsCommandSearch, {
+							api: docsApiUrl,
+							locale: activeLocale
+						})
+					}),
+					aiEnabled && /* @__PURE__ */ jsx(Suspense, {
+						fallback: null,
+						children: /* @__PURE__ */ jsx(DocsAIFeatures, {
+							mode: aiMode,
+							api: docsApiUrl,
+							locale: activeLocale,
+							position: aiPosition,
+							floatingStyle: aiFloatingStyle,
+							triggerComponentHtml: aiTriggerComponentHtml,
+							suggestedQuestions: aiSuggestedQuestions,
+							aiLabel,
+							loaderVariant: aiLoaderVariant,
+							loadingComponentHtml: aiLoadingComponentHtml,
+							models: aiModels,
+							defaultModelId: aiDefaultModelId
+						})
 					}),
-					/* @__PURE__ */ jsx(DocsPageClient, {
-						tocEnabled,
-						tocStyle,
-						breadcrumbEnabled,
-						entry: config.entry,
-						copyMarkdown: copyMarkdownEnabled,
-						openDocs: openDocsEnabled,
-						openDocsProviders,
-						pageActionsPosition,
-						pageActionsAlignment,
-						githubUrl,
-						githubBranch,
-						githubDirectory,
-						lastModifiedMap,
-						lastUpdatedEnabled,
-						lastUpdatedPosition,
-						llmsTxtEnabled,
-						descriptionMap,
-						children
+					/* @__PURE__ */ jsx(Suspense, {
+						fallback: children,
+						children: /* @__PURE__ */ jsx(DocsPageClient, {
+							tocEnabled,
+							tocStyle,
+							breadcrumbEnabled,
+							entry: localeContext.entryPath,
+							locale: activeLocale,
+							copyMarkdown: copyMarkdownEnabled,
+							openDocs: openDocsEnabled,
+							openDocsProviders,
+							pageActionsPosition,
+							pageActionsAlignment,
+							githubUrl,
+							githubBranch,
+							githubDirectory,
+							lastModifiedMap,
+							lastUpdatedEnabled,
+							lastUpdatedPosition,
+							llmsTxtEnabled,
+							descriptionMap,
+							children
+						})
 					})
 				]
 			})

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

@@ -14,6 +14,8 @@ interface DocsPageClientProps {
   breadcrumbEnabled?: boolean;
   /** The docs entry folder name (e.g. "docs") — used to strip from breadcrumb */
   entry?: string;
+  /** Active locale (used for llms.txt links) */
+  locale?: string;
   copyMarkdown?: boolean;
   openDocs?: boolean;
   openDocsProviders?: SerializedProvider[];
@@ -46,6 +48,7 @@ declare function DocsPageClient({
   tocStyle,
   breadcrumbEnabled,
   entry,
+  locale,
   copyMarkdown,
   openDocs,
   openDocsProviders,

package/dist/docs-page-client.mjs

@@ -1,10 +1,11 @@
 "use client";
 
 import { PageActions } from "./page-actions.mjs";
-import { DocsBody, DocsPage, EditOnGitHub } from "fumadocs-ui/layouts/docs/page";
+import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
 import { useEffect, useState } from "react";
+import { DocsBody, DocsPage, EditOnGitHub } from "fumadocs-ui/layouts/docs/page";
 import { createPortal } from "react-dom";
-import { usePathname, useRouter } from "next/navigation";
+import { usePathname, useRouter, useSearchParams } from "next/navigation";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-page-client.tsx
@@ -12,26 +13,28 @@ import { jsx, jsxs } from "react/jsx-runtime";
 * Path-based breadcrumb that shows only parent / current folder.
 * Skips the entry segment (e.g. "docs"). Parent is clickable.
 */
-function PathBreadcrumb({ pathname, entry }) {
+function PathBreadcrumb({ pathname, entry, locale }) {
 	const router = useRouter();
 	const segments = pathname.split("/").filter(Boolean);
-	if (segments.length < 2) return null;
-	const parentSegment = segments[segments.length - 2];
-	const currentSegment = segments[segments.length - 1];
+	const entryParts = entry.split("/").filter(Boolean);
+	const contentSegments = segments.slice(entryParts.length);
+	if (contentSegments.length < 2) return null;
+	const parentSegment = contentSegments[contentSegments.length - 2];
+	const currentSegment = contentSegments[contentSegments.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 parentUrl = "/" + segments.slice(0, segments.length - 1).join("/");
+	const localizedParentUrl = withLangInUrl("/" + [...segments.slice(0, entryParts.length), ...contentSegments.slice(0, -1)].join("/"), locale);
 	return /* @__PURE__ */ jsxs("nav", {
 		className: "fd-breadcrumb",
 		"aria-label": "Breadcrumb",
 		children: [/* @__PURE__ */ jsx("span", {
 			className: "fd-breadcrumb-item",
 			children: /* @__PURE__ */ jsx("a", {
-				href: parentUrl,
+				href: localizedParentUrl,
 				className: "fd-breadcrumb-parent fd-breadcrumb-link",
 				onClick: (e) => {
 					e.preventDefault();
-					router.push(parentUrl);
+					router.push(localizedParentUrl);
 				},
 				children: parentLabel
 			})
@@ -59,14 +62,36 @@ function PathBreadcrumb({ pathname, entry }) {
 *   No directory:  https://github.com/user/repo/edit/main/app/docs/cli/page.mdx
 *   With directory: https://github.com/farming-labs/docs/edit/main/website/app/docs/cli/page.mdx
 */
-function buildGithubFileUrl(githubUrl, branch, pathname, directory) {
-	const segments = pathname.replace(/^\//, "").replace(/\/$/, "");
-	return `${githubUrl}/edit/${branch}/${`${directory ? `${directory}/` : ""}app/${segments}/page.mdx`}`;
+function buildGithubFileUrl(githubUrl, branch, pathname, entry, locale, directory) {
+	const normalizedEntry = entry.replace(/^\/+|\/+$/g, "") || "docs";
+	const entryParts = normalizedEntry.split("/").filter(Boolean);
+	const pathnameParts = pathname.replace(/^\/+|\/+$/g, "").split("/").filter(Boolean);
+	const slugParts = pathnameParts.slice(0, entryParts.length).join("/") === entryParts.join("/") ? pathnameParts.slice(entryParts.length) : pathnameParts;
+	const dirPrefix = directory ? `${directory}/` : "";
+	const basePath = `app/${normalizedEntry}`;
+	const relativePath = [locale, slugParts.join("/")].filter(Boolean).join("/");
+	return `${githubUrl}/edit/${branch}/${`${dirPrefix}${basePath}${relativePath ? `/${relativePath}` : ""}/page.mdx`}`;
+}
+function localizeInternalLinks(root, locale) {
+	const anchors = root.querySelectorAll("a[href]:not([data-fd-lang-localized=\"true\"])");
+	for (const anchor of anchors) {
+		const href = anchor.getAttribute("href");
+		if (!href || href.startsWith("#")) continue;
+		if (/^(mailto:|tel:|javascript:)/i.test(href)) continue;
+		try {
+			const url = new URL(href, window.location.origin);
+			if (url.origin !== window.location.origin) continue;
+			anchor.href = withLangInUrl(url.pathname + url.search + url.hash, locale);
+			anchor.dataset.fdLangLocalized = "true";
+		} catch {}
+	}
 }
-function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, entry = "docs", copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, githubBranch = "main", githubDirectory, lastModifiedMap, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, children }) {
+function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, entry = "docs", locale, copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, githubBranch = "main", githubDirectory, lastModifiedMap, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const pathname = usePathname();
+	const activeLocale = resolveClientLocale(useSearchParams(), locale);
+	const llmsLangParam = activeLocale ? `&lang=${encodeURIComponent(activeLocale)}` : "";
 	const [actionsPortalTarget, setActionsPortalTarget] = useState(null);
 	const pageDescription = description ?? descriptionMap?.[pathname.replace(/\/$/, "") || "/"];
 	useEffect(() => {
@@ -103,8 +128,20 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 			if (desc) desc.remove();
 		};
 	}, [pageDescription, pathname]);
+	useEffect(() => {
+		const timer = requestAnimationFrame(() => {
+			const container = document.getElementById("nd-page");
+			if (!container) return;
+			localizeInternalLinks(container, activeLocale);
+		});
+		return () => cancelAnimationFrame(timer);
+	}, [
+		activeLocale,
+		children,
+		pathname
+	]);
 	const showActions = copyMarkdown || openDocs;
-	const githubFileUrl = githubUrl ? buildGithubFileUrl(githubUrl, githubBranch, pathname, githubDirectory) : void 0;
+	const githubFileUrl = githubUrl ? buildGithubFileUrl(githubUrl, githubBranch, pathname, entry, activeLocale, githubDirectory) : void 0;
 	const normalizedPath = pathname.replace(/\/$/, "") || "/";
 	const lastModified = lastUpdatedEnabled ? lastModifiedMap?.[normalizedPath] : void 0;
 	const showLastUpdatedBelowTitle = !!lastModified && lastUpdatedPosition === "below-title";
@@ -171,7 +208,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		children: [
 			breadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
 				pathname,
-				entry
+				entry,
+				locale: activeLocale
 			}),
 			showActions && actionsPortalTarget && createPortal(/* @__PURE__ */ jsx(PageActions, {
 				copyMarkdown,
@@ -194,13 +232,13 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 						llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
 							className: "fd-llms-txt-links",
 							children: [/* @__PURE__ */ jsx("a", {
-								href: "/api/docs?format=llms",
+								href: `/api/docs?format=llms${llmsLangParam}`,
 								target: "_blank",
 								rel: "noopener noreferrer",
 								className: "fd-llms-txt-link",
 								children: "llms.txt"
 							}), /* @__PURE__ */ jsx("a", {
-								href: "/api/docs?format=llms-full",
+								href: `/api/docs?format=llms-full${llmsLangParam}`,
 								target: "_blank",
 								rel: "noopener noreferrer",
 								className: "fd-llms-txt-link",

package/dist/i18n.d.mts

@@ -0,0 +1,4 @@
+//#region src/i18n.d.ts
+declare function withLangInUrl(url: string, locale?: string | null): string;
+//#endregion
+export { withLangInUrl };

package/dist/i18n.mjs

@@ -0,0 +1,20 @@
+//#region src/i18n.ts
+function withLangInUrl(url, locale) {
+	if (!url || url.startsWith("#")) return url;
+	const isProtocolRelative = url.startsWith("//");
+	const isAbsolute = /^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(url) || isProtocolRelative;
+	const parsed = new URL(url, "https://farming-labs.local");
+	if (locale) parsed.searchParams.set("lang", locale);
+	else parsed.searchParams.delete("lang");
+	if (isAbsolute) {
+		if (isProtocolRelative) return `//${parsed.host}${parsed.pathname}${parsed.search}${parsed.hash}`;
+		return parsed.toString();
+	}
+	return `${parsed.pathname}${parsed.search}${parsed.hash}`;
+}
+function resolveClientLocale(searchParams, fallback) {
+	return (searchParams.get("lang") ?? searchParams.get("locale")) || fallback;
+}
+
+//#endregion
+export { resolveClientLocale, withLangInUrl };

package/dist/index.d.mts

@@ -4,9 +4,10 @@ import { createDocsLayout, createDocsMetadata, createPageMetadata } from "./docs
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { RootProvider } from "./provider.mjs";
 import { PageActions } from "./page-actions.mjs";
+import { withLangInUrl } from "./i18n.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 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 { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 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, DocsCommandSearch, 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, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs };
+export { type AIConfig, type BreadcrumbConfig, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, type CopyMarkdownConfig, DocsBody, DocsCommandSearch, 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, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, withLangInUrl };

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { PageActions } from "./page-actions.mjs";
+import { withLangInUrl } from "./i18n.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
 import { createDocsLayout, createDocsMetadata, createPageMetadata } from "./docs-layout.mjs";
@@ -10,4 +11,4 @@ import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 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, DocsCommandSearch, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, PageActions, Pre, RootProvider, Tab, Tabs, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs };
+export { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, DocsBody, DocsCommandSearch, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, PageActions, Pre, RootProvider, Tab, Tabs, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, withLangInUrl };

package/dist/locale-theme-control.mjs

@@ -0,0 +1,286 @@
+"use client";
+
+import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
+import { useEffect, useMemo, useState } from "react";
+import { usePathname, useRouter, useSearchParams } from "next/navigation";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/locale-theme-control.tsx
+function SunIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "16",
+		height: "16",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("circle", {
+				cx: "12",
+				cy: "12",
+				r: "5"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "12",
+				y1: "1",
+				x2: "12",
+				y2: "3"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "12",
+				y1: "21",
+				x2: "12",
+				y2: "23"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "4.22",
+				y1: "4.22",
+				x2: "5.64",
+				y2: "5.64"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "18.36",
+				y1: "18.36",
+				x2: "19.78",
+				y2: "19.78"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "1",
+				y1: "12",
+				x2: "3",
+				y2: "12"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "21",
+				y1: "12",
+				x2: "23",
+				y2: "12"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "4.22",
+				y1: "19.78",
+				x2: "5.64",
+				y2: "18.36"
+			}),
+			/* @__PURE__ */ jsx("line", {
+				x1: "18.36",
+				y1: "5.64",
+				x2: "19.78",
+				y2: "4.22"
+			})
+		]
+	});
+}
+function MoonIcon() {
+	return /* @__PURE__ */ jsx("svg", {
+		width: "16",
+		height: "16",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: /* @__PURE__ */ jsx("path", { d: "M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z" })
+	});
+}
+function ChevronDownIcon() {
+	return /* @__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: "6 9 12 15 18 9" })
+	});
+}
+function LocaleThemeControl({ locales, defaultLocale, locale, showThemeToggle = true, themeMode = "light-dark" }) {
+	const router = useRouter();
+	const pathname = usePathname();
+	const searchParams = useSearchParams();
+	const [mounted, setMounted] = useState(false);
+	const [themeValue, setThemeValue] = useState("system");
+	const [resolvedTheme, setResolvedTheme] = useState("light");
+	const activeLocale = useMemo(() => resolveClientLocale(searchParams, locale ?? defaultLocale) ?? defaultLocale, [
+		defaultLocale,
+		locale,
+		searchParams
+	]);
+	useEffect(() => {
+		setMounted(true);
+	}, []);
+	useEffect(() => {
+		if (!mounted || !showThemeToggle) return;
+		const media = window.matchMedia("(prefers-color-scheme: dark)");
+		const updateThemeState = () => {
+			let storedTheme = "system";
+			try {
+				const raw = localStorage.getItem("theme");
+				if (raw === "light" || raw === "dark" || raw === "system") storedTheme = raw;
+			} catch {}
+			const nextResolved = storedTheme === "system" ? media.matches ? "dark" : "light" : storedTheme;
+			setThemeValue(storedTheme);
+			setResolvedTheme(nextResolved);
+		};
+		const observer = new MutationObserver(updateThemeState);
+		observer.observe(document.documentElement, {
+			attributes: true,
+			attributeFilter: ["class"]
+		});
+		media.addEventListener("change", updateThemeState);
+		updateThemeState();
+		return () => {
+			observer.disconnect();
+			media.removeEventListener("change", updateThemeState);
+		};
+	}, [mounted, showThemeToggle]);
+	function onLocaleChange(nextLocale) {
+		const params = searchParams.toString();
+		const current = `${pathname}${params ? `?${params}` : ""}`;
+		router.push(withLangInUrl(current, nextLocale));
+	}
+	if (!mounted) return null;
+	const toggleContainerStyle = {
+		display: "inline-flex",
+		alignItems: "center",
+		borderRadius: 9999,
+		border: "1px solid var(--color-fd-border)",
+		padding: 4,
+		gap: 2
+	};
+	const getToggleItemStyle = (active) => ({
+		display: "inline-flex",
+		alignItems: "center",
+		justifyContent: "center",
+		width: 26,
+		height: 26,
+		borderRadius: 9999,
+		border: "none",
+		background: active ? "var(--color-fd-accent)" : "transparent",
+		color: active ? "var(--color-fd-accent-foreground)" : "var(--color-fd-muted-foreground)",
+		cursor: "pointer"
+	});
+	function applyTheme(nextTheme) {
+		const resolved = nextTheme === "system" ? window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light" : nextTheme;
+		document.documentElement.classList.remove("light", "dark");
+		document.documentElement.classList.add(resolved);
+		document.documentElement.style.colorScheme = resolved;
+		try {
+			localStorage.setItem("theme", nextTheme);
+		} catch {}
+		setThemeValue(nextTheme);
+		setResolvedTheme(resolved);
+	}
+	return /* @__PURE__ */ jsxs("div", {
+		className: "fd-sidebar-locale-theme-control",
+		style: {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "space-between",
+			gap: 12,
+			width: "100%"
+		},
+		children: [/* @__PURE__ */ jsxs("div", {
+			style: {
+				position: "relative",
+				display: "inline-flex",
+				alignItems: "center",
+				flexShrink: 0
+			},
+			children: [/* @__PURE__ */ jsx("select", {
+				id: "fd-locale-select",
+				value: activeLocale,
+				onChange: (e) => onLocaleChange(e.target.value),
+				"aria-label": "Select language",
+				style: {
+					appearance: "none",
+					WebkitAppearance: "none",
+					MozAppearance: "none",
+					minWidth: 84,
+					height: 36,
+					borderRadius: 9999,
+					border: "1px solid var(--color-fd-border)",
+					background: "var(--color-fd-card, var(--color-fd-background))",
+					color: "var(--color-fd-foreground)",
+					padding: "0 36px 0 14px",
+					fontSize: 12,
+					fontWeight: 600,
+					letterSpacing: "0.04em",
+					lineHeight: 1,
+					cursor: "pointer",
+					boxShadow: "0 1px 2px rgba(15, 23, 42, 0.08)"
+				},
+				children: locales.map((item) => /* @__PURE__ */ jsx("option", {
+					value: item,
+					children: item.toUpperCase()
+				}, item))
+			}), /* @__PURE__ */ jsx("span", {
+				"aria-hidden": "true",
+				style: {
+					position: "absolute",
+					right: 12,
+					display: "inline-flex",
+					alignItems: "center",
+					justifyContent: "center",
+					color: "var(--color-fd-muted-foreground)",
+					pointerEvents: "none"
+				},
+				children: /* @__PURE__ */ jsx(ChevronDownIcon, {})
+			})]
+		}), showThemeToggle && (themeMode === "light-dark" ? /* @__PURE__ */ jsxs("button", {
+			type: "button",
+			"aria-label": "Toggle theme",
+			onClick: () => applyTheme(resolvedTheme === "light" ? "dark" : "light"),
+			style: toggleContainerStyle,
+			children: [/* @__PURE__ */ jsx("span", {
+				style: getToggleItemStyle(resolvedTheme === "light"),
+				children: /* @__PURE__ */ jsx(SunIcon, {})
+			}), /* @__PURE__ */ jsx("span", {
+				style: getToggleItemStyle(resolvedTheme === "dark"),
+				children: /* @__PURE__ */ jsx(MoonIcon, {})
+			})]
+		}) : /* @__PURE__ */ jsxs("div", {
+			style: toggleContainerStyle,
+			children: [
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"aria-label": "light",
+					style: getToggleItemStyle(themeValue === "light"),
+					onClick: () => applyTheme("light"),
+					children: /* @__PURE__ */ jsx(SunIcon, {})
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"aria-label": "dark",
+					style: getToggleItemStyle(themeValue === "dark"),
+					onClick: () => applyTheme("dark"),
+					children: /* @__PURE__ */ jsx(MoonIcon, {})
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"aria-label": "system",
+					style: getToggleItemStyle(themeValue === "system"),
+					onClick: () => applyTheme("system"),
+					children: /* @__PURE__ */ jsx("span", {
+						style: {
+							display: "inline-flex",
+							alignItems: "center",
+							justifyContent: "center",
+							fontSize: 11,
+							fontWeight: 600
+						},
+						children: "Auto"
+					})
+				})
+			]
+		}))]
+	});
+}
+
+//#endregion
+export { LocaleThemeControl };

package/dist/mdx.d.mts

@@ -1,6 +1,6 @@
 import { MDXImg } from "./mdx-img.mjs";
-import { CodeBlockCopyData } from "@farming-labs/docs";
 import React from "react";
+import { CodeBlockCopyData } from "@farming-labs/docs";
 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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -104,7 +104,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.0.28"
+    "@farming-labs/docs": "0.0.30"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",