@farming-labs/docs 0.0.29 → 0.0.31

package/dist/cli/index.mjs

@@ -226,6 +226,14 @@ const THEME_INFO = {
 function getThemeInfo(theme) {
 	return THEME_INFO[theme] ?? THEME_INFO.fumadocs;
 }
+function renderI18nConfig(cfg, indent = "  ") {
+	const i18n = cfg.i18n;
+	if (!i18n || i18n.locales.length === 0) return "";
+	return `${indent}i18n: {\n${indent}  locales: [${i18n.locales.map((locale) => `"${locale}"`).join(", ")}],\n${indent}  defaultLocale: "${i18n.defaultLocale}",\n${indent}},\n`;
+}
+function toLocaleImportName(locale) {
+	return `LocalePage_${locale.replace(/[^a-zA-Z0-9_$]/g, "_")}`;
+}
 function getThemeExportName(themeName) {
 	const base = themeName.replace(/\.ts$/i, "").trim();
 	if (!base) return "customTheme";
@@ -315,7 +323,7 @@ import { ${exportName} } from "${cfg.useAlias ? "@/themes/" + cfg.customThemeNam
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: ${exportName}({
+  ${renderI18nConfig(cfg)}  theme: ${exportName}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -335,7 +343,7 @@ import { ${t.factory} } from "${t.nextImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: ${t.factory}({
+  ${renderI18nConfig(cfg)}  theme: ${t.factory}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -473,6 +481,48 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 }
 `;
 }
+function nextLocaleDocPageTemplate(defaultLocale) {
+	return `\
+import type { ComponentType } from "react";
+
+type SearchParams = Promise<{ lang?: string | string[] | undefined }> | undefined;
+
+function normalizeLang(value: string | string[] | undefined) {
+  return Array.isArray(value) ? value[0] : value;
+}
+
+export async function resolveLocaleDocPage<T extends ComponentType>(
+  searchParams: SearchParams,
+  pages: Record<string, T>,
+  fallbackLocale = "${defaultLocale}",
+) {
+  const params = (await searchParams) ?? {};
+  const locale = normalizeLang(params.lang) ?? fallbackLocale;
+
+  return pages[locale] ?? pages[fallbackLocale];
+}
+`;
+}
+function nextLocalizedPageTemplate(options) {
+	const importLines = options.pageImports.map(({ locale, importPath }) => `import ${toLocaleImportName(locale)} from "${importPath}";`).join("\n");
+	const pageMap = options.pageImports.map(({ locale }) => `    ${JSON.stringify(locale)}: ${toLocaleImportName(locale)},`).join("\n");
+	return `\
+${importLines}
+import { resolveLocaleDocPage } from "${options.helperImport}";
+
+type PageProps = {
+  searchParams?: Promise<{ lang?: string | string[] | undefined }>;
+};
+
+export default async function ${options.componentName}({ searchParams }: PageProps) {
+  const Page = await resolveLocaleDocPage(searchParams, {
+${pageMap}
+  }, "${options.defaultLocale}");
+
+  return <Page />;
+}
+`;
+}
 function postcssConfigTemplate() {
 	return `\
 const config = {
@@ -696,7 +746,8 @@ import { ${exportName} } from "${"../../themes/" + cfg.customThemeName.replace(/
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: ${exportName}({
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}  theme: ${exportName}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -723,7 +774,8 @@ import { ${t.factory} } from "${t.svelteImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: ${t.factory}({
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}  theme: ${t.factory}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -1005,7 +1057,7 @@ import { ${exportName} } from "${"../../themes/" + cfg.customThemeName.replace(/
 export default defineDocs({
   entry: "${cfg.entry}",
   contentDir: "${cfg.entry}",
-  theme: ${exportName}({
+  ${renderI18nConfig(cfg)}  theme: ${exportName}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -1033,7 +1085,7 @@ import { ${t.factory} } from "${t.astroImport}";
 export default defineDocs({
   entry: "${cfg.entry}",
   contentDir: "${cfg.entry}",
-  theme: ${t.factory}({
+  ${renderI18nConfig(cfg)}  theme: ${t.factory}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -1361,7 +1413,7 @@ import { ${exportName} } from "${cfg.useAlias ? "~/themes/" + cfg.customThemeNam
 export default defineDocs({
   entry: "${cfg.entry}",
   contentDir: "${cfg.entry}",
-  theme: ${exportName}({
+  ${renderI18nConfig(cfg)}  theme: ${exportName}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -1389,7 +1441,7 @@ import { ${t.factory} } from "${t.nuxtImport}";
 export default defineDocs({
   entry: "${cfg.entry}",
   contentDir: "${cfg.entry}",
-  theme: ${t.factory}({
+  ${renderI18nConfig(cfg)}  theme: ${t.factory}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -1713,6 +1765,79 @@ const VALID_TEMPLATES = [
 	"sveltekit",
 	"astro"
 ];
+const COMMON_LOCALE_OPTIONS = [
+	{
+		value: "en",
+		label: "English",
+		hint: "en"
+	},
+	{
+		value: "fr",
+		label: "French",
+		hint: "fr"
+	},
+	{
+		value: "es",
+		label: "Spanish",
+		hint: "es"
+	},
+	{
+		value: "de",
+		label: "German",
+		hint: "de"
+	},
+	{
+		value: "pt",
+		label: "Portuguese",
+		hint: "pt"
+	},
+	{
+		value: "it",
+		label: "Italian",
+		hint: "it"
+	},
+	{
+		value: "ja",
+		label: "Japanese",
+		hint: "ja"
+	},
+	{
+		value: "ko",
+		label: "Korean",
+		hint: "ko"
+	},
+	{
+		value: "zh",
+		label: "Chinese",
+		hint: "zh"
+	},
+	{
+		value: "ar",
+		label: "Arabic",
+		hint: "ar"
+	},
+	{
+		value: "hi",
+		label: "Hindi",
+		hint: "hi"
+	},
+	{
+		value: "ru",
+		label: "Russian",
+		hint: "ru"
+	}
+];
+function normalizeLocaleCode(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "";
+	const [language, ...rest] = trimmed.split("-");
+	const normalizedLanguage = language.toLowerCase();
+	if (rest.length === 0) return normalizedLanguage;
+	return `${normalizedLanguage}-${rest.join("-").toUpperCase()}`;
+}
+function parseLocaleInput(input) {
+	return Array.from(new Set(input.split(",").map((value) => normalizeLocaleCode(value)).filter(Boolean)));
+}
 async function init(options = {}) {
 	const cwd = process.cwd();
 	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs ")));
@@ -2032,6 +2157,64 @@ async function init(options = {}) {
 		process.exit(0);
 	}
 	const entryPath = entry.trim() || defaultEntry;
+	const enableI18n = await p.confirm({
+		message: "Do you want to scaffold internationalized docs with locale folders?",
+		initialValue: false
+	});
+	if (p.isCancel(enableI18n)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	let docsI18n;
+	if (enableI18n) {
+		const selectedLocales = await p.multiselect({
+			message: "Which languages should we scaffold?",
+			options: COMMON_LOCALE_OPTIONS.map((option) => ({
+				value: option.value,
+				label: option.label,
+				hint: option.hint
+			}))
+		});
+		if (p.isCancel(selectedLocales)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		const extraLocalesAnswer = await p.text({
+			message: "Any additional locale codes? (comma-separated, optional)",
+			placeholder: "nl, sv, pt-BR",
+			defaultValue: "",
+			validate: (value) => {
+				return parseLocaleInput(value ?? "").every((locale) => /^[a-z]{2,3}(?:-[A-Z]{2})?$/.test(locale)) ? void 0 : "Use locale codes like en, fr, zh, or pt-BR";
+			}
+		});
+		if (p.isCancel(extraLocalesAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		const locales = Array.from(new Set([...(selectedLocales ?? []).map((locale) => normalizeLocaleCode(locale)), ...parseLocaleInput(extraLocalesAnswer ?? "")])).filter(Boolean);
+		if (locales.length === 0) {
+			p.log.error("Pick at least one locale to scaffold i18n support.");
+			p.outro(pc.red("Init cancelled."));
+			process.exit(1);
+		}
+		const defaultLocaleAnswer = await p.select({
+			message: "Which locale should be the default?",
+			options: locales.map((locale) => ({
+				value: locale,
+				label: locale,
+				hint: locale === "en" ? "Recommended default" : void 0
+			})),
+			initialValue: locales[0]
+		});
+		if (p.isCancel(defaultLocaleAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		docsI18n = {
+			locales,
+			defaultLocale: defaultLocaleAnswer
+		};
+	}
 	const detectedCssFiles = detectGlobalCssFiles(cwd);
 	let globalCssRelPath;
 	const defaultCssPath = framework === "sveltekit" ? "src/app.css" : framework === "astro" ? "src/styles/global.css" : framework === "nuxt" ? "assets/css/main.css" : framework === "nextjs" ? `${nextAppDir}/globals.css` : "app/globals.css";
@@ -2078,6 +2261,7 @@ async function init(options = {}) {
 		framework,
 		useAlias,
 		astroAdapter,
+		i18n: docsI18n,
 		...framework === "nextjs" && { nextAppDir }
 	};
 	const s = p.spinner();
@@ -2219,6 +2403,9 @@ async function init(options = {}) {
 		process.exit(1);
 	}
 }
+function getScaffoldContentRoots(cfg) {
+	return cfg.i18n?.locales?.length ? cfg.i18n.locales.map((locale) => `${cfg.entry}/${locale}`) : [cfg.entry];
+}
 function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	const appDir = cfg.nextAppDir ?? "app";
 	if (cfg.theme === "custom" && cfg.customThemeName) {
@@ -2258,6 +2445,46 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	write(`${appDir}/${cfg.entry}/layout.tsx`, docsLayoutTemplate(cfg));
 	write("postcss.config.mjs", postcssConfigTemplate());
 	if (!fileExists(path.join(cwd, "tsconfig.json"))) write("tsconfig.json", tsconfigTemplate(cfg.useAlias));
+	if (cfg.i18n?.locales.length) {
+		write(`${appDir}/components/locale-doc-page.tsx`, nextLocaleDocPageTemplate(cfg.i18n.defaultLocale));
+		write(`${appDir}/${cfg.entry}/page.tsx`, nextLocalizedPageTemplate({
+			locales: cfg.i18n.locales,
+			defaultLocale: cfg.i18n.defaultLocale,
+			componentName: "DocsIndexPage",
+			helperImport: "../components/locale-doc-page",
+			pageImports: cfg.i18n.locales.map((locale) => ({
+				locale,
+				importPath: `./${locale}/page.mdx`
+			}))
+		}));
+		write(`${appDir}/${cfg.entry}/installation/page.tsx`, nextLocalizedPageTemplate({
+			locales: cfg.i18n.locales,
+			defaultLocale: cfg.i18n.defaultLocale,
+			componentName: "InstallationPage",
+			helperImport: "../../components/locale-doc-page",
+			pageImports: cfg.i18n.locales.map((locale) => ({
+				locale,
+				importPath: `../${locale}/installation/page.mdx`
+			}))
+		}));
+		write(`${appDir}/${cfg.entry}/quickstart/page.tsx`, nextLocalizedPageTemplate({
+			locales: cfg.i18n.locales,
+			defaultLocale: cfg.i18n.defaultLocale,
+			componentName: "QuickstartPage",
+			helperImport: "../../components/locale-doc-page",
+			pageImports: cfg.i18n.locales.map((locale) => ({
+				locale,
+				importPath: `../${locale}/quickstart/page.mdx`
+			}))
+		}));
+		for (const locale of cfg.i18n.locales) {
+			const base = `${appDir}/${cfg.entry}/${locale}`;
+			write(`${base}/page.mdx`, welcomePageTemplate(cfg));
+			write(`${base}/installation/page.mdx`, installationPageTemplate(cfg));
+			write(`${base}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
+		}
+		return;
+	}
 	write(`${appDir}/${cfg.entry}/page.mdx`, welcomePageTemplate(cfg));
 	write(`${appDir}/${cfg.entry}/installation/page.mdx`, installationPageTemplate(cfg));
 	write(`${appDir}/${cfg.entry}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
@@ -2273,6 +2500,7 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 	write(`src/routes/${cfg.entry}/+layout.svelte`, svelteDocsLayoutTemplate(cfg));
 	write(`src/routes/${cfg.entry}/+layout.server.js`, svelteDocsLayoutServerTemplate(cfg));
 	write(`src/routes/${cfg.entry}/[...slug]/+page.svelte`, svelteDocsPageTemplate(cfg));
+	if (cfg.i18n?.locales.length) write(`src/routes/${cfg.entry}/+page.svelte`, svelteDocsPageTemplate(cfg));
 	if (!readFileSafe(path.join(cwd, "src/routes/+layout.svelte"))) write("src/routes/+layout.svelte", svelteRootLayoutTemplate(globalCssRelPath));
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
 	const existingGlobalCss = readFileSafe(globalCssAbsPath);
@@ -2293,9 +2521,11 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
 	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? svelteGlobalCssTemplate("custom", cfg.customThemeName, globalCssRelPath) : svelteGlobalCssTemplate(cssTheme));
-	write(`${cfg.entry}/page.md`, svelteWelcomePageTemplate(cfg));
-	write(`${cfg.entry}/installation/page.md`, svelteInstallationPageTemplate(cfg));
-	write(`${cfg.entry}/quickstart/page.md`, svelteQuickstartPageTemplate(cfg));
+	for (const base of getScaffoldContentRoots(cfg)) {
+		write(`${base}/page.md`, svelteWelcomePageTemplate(cfg));
+		write(`${base}/installation/page.md`, svelteInstallationPageTemplate(cfg));
+		write(`${base}/quickstart/page.md`, svelteQuickstartPageTemplate(cfg));
+	}
 }
 function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	if (cfg.theme === "custom" && cfg.customThemeName) {
@@ -2328,9 +2558,11 @@ function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
 	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? astroGlobalCssTemplate("custom", cfg.customThemeName, globalCssRelPath) : astroGlobalCssTemplate(cssTheme));
-	write(`${cfg.entry}/page.md`, astroWelcomePageTemplate(cfg));
-	write(`${cfg.entry}/installation/page.md`, astroInstallationPageTemplate(cfg));
-	write(`${cfg.entry}/quickstart/page.md`, astroQuickstartPageTemplate(cfg));
+	for (const base of getScaffoldContentRoots(cfg)) {
+		write(`${base}/page.md`, astroWelcomePageTemplate(cfg));
+		write(`${base}/installation/page.md`, astroInstallationPageTemplate(cfg));
+		write(`${base}/quickstart/page.md`, astroQuickstartPageTemplate(cfg));
+	}
 }
 function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	if (cfg.theme === "custom" && cfg.customThemeName) {
@@ -2365,9 +2597,11 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
 	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? nuxtGlobalCssTemplate("custom", cfg.customThemeName, globalCssRelPath) : nuxtGlobalCssTemplate(cssTheme));
-	write(`${cfg.entry}/page.md`, nuxtWelcomePageTemplate(cfg));
-	write(`${cfg.entry}/installation/page.md`, nuxtInstallationPageTemplate(cfg));
-	write(`${cfg.entry}/quickstart/page.md`, nuxtQuickstartPageTemplate(cfg));
+	for (const base of getScaffoldContentRoots(cfg)) {
+		write(`${base}/page.md`, nuxtWelcomePageTemplate(cfg));
+		write(`${base}/installation/page.md`, nuxtInstallationPageTemplate(cfg));
+		write(`${base}/quickstart/page.md`, nuxtQuickstartPageTemplate(cfg));
+	}
 }
 
 //#endregion

package/dist/index.d.mts

@@ -999,11 +999,23 @@ interface CodeBlockCopyData {
   /** Language / syntax hint (e.g. "tsx", "bash"), if present */
   language?: string;
 }
+interface DocsI18nConfig {
+  /** Supported locale identifiers (e.g. ["en", "fr"]). */
+  locales: string[];
+  /** Default locale when `?lang=` is missing or invalid. Defaults to first locale. */
+  defaultLocale?: string;
+}
 interface DocsConfig {
   /** Entry folder for docs (e.g. "docs" → /docs) */
   entry: string;
   /** Path to the content directory. Defaults to `entry` value. */
   contentDir?: string;
+  /**
+   * Internationalization (i18n) configuration.
+   * When set, docs content is expected under `${contentDir}/{locale}` and
+   * the active locale is selected by `?lang=<locale>` in the URL.
+   */
+  i18n?: DocsI18nConfig;
   /**
    * Set to `true` when building for full static export (e.g. Cloudflare Pages).
    * When using `output: 'export'` in Next.js, the `/api/docs` route is not generated.
@@ -1326,6 +1338,21 @@ declare function createTheme(baseTheme: DocsTheme): (overrides?: Partial<DocsThe
  */
 declare function extendTheme(baseTheme: DocsTheme, extensions: Partial<DocsTheme>): DocsTheme;
 //#endregion
+//#region src/i18n.d.ts
+interface ResolvedDocsI18n {
+  locales: string[];
+  defaultLocale: string;
+}
+interface DocsPathMatch {
+  /** Slug path relative to the docs root (no leading slash). */
+  slug: string;
+  /** Entry path used for URLs (no locale segment). */
+  entryPath: string;
+}
+declare function resolveDocsI18n(config?: DocsI18nConfig | null): ResolvedDocsI18n | null;
+declare function resolveDocsLocale(searchParams: URLSearchParams, i18n?: ResolvedDocsI18n | null): string | undefined;
+declare function resolveDocsPath(pathname: string, entry: string): DocsPathMatch;
+//#endregion
 //#region src/metadata.d.ts
 /**
  * Resolve page title using metadata titleTemplate.
@@ -1350,4 +1377,4 @@ declare function buildPageOpenGraph(page: Pick<PageFrontmatter, "title" | "descr
  */
 declare function buildPageTwitter(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, ogConfig?: OGConfig, baseUrl?: string): PageTwitter | undefined;
 //#endregion
-export { type AIConfig, type BreadcrumbConfig, type CodeBlockCopyData, type CopyMarkdownConfig, type DocsConfig, type DocsMetadata, type DocsNav, type DocsTheme, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type ThemeToggleConfig, type TypographyConfig, type UIConfig, buildPageOpenGraph, buildPageTwitter, createTheme, deepMerge, defineDocs, extendTheme, resolveOGImage, resolveTitle };
+export { type AIConfig, type BreadcrumbConfig, type CodeBlockCopyData, type CopyMarkdownConfig, type DocsConfig, type DocsI18nConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsTheme, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedDocsI18n, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type ThemeToggleConfig, type TypographyConfig, type UIConfig, buildPageOpenGraph, buildPageTwitter, createTheme, deepMerge, defineDocs, extendTheme, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveTitle };

package/dist/index.mjs

@@ -6,6 +6,7 @@ function defineDocs(config) {
 	return {
 		entry: config.entry ?? "docs",
 		contentDir: config.contentDir,
+		i18n: config.i18n,
 		theme: config.theme,
 		nav: config.nav,
 		github: config.github,
@@ -99,6 +100,45 @@ function extendTheme(baseTheme, extensions) {
 	return deepMerge(baseTheme, extensions);
 }
 
+//#endregion
+//#region src/i18n.ts
+function normalizeSegment(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function splitSegments(value) {
+	const cleaned = normalizeSegment(value);
+	return cleaned ? cleaned.split("/").filter(Boolean) : [];
+}
+function resolveDocsI18n(config) {
+	if (!config || !Array.isArray(config.locales)) return null;
+	const locales = Array.from(new Set(config.locales.map((l) => l.trim()).filter(Boolean)));
+	if (locales.length === 0) return null;
+	return {
+		locales,
+		defaultLocale: config.defaultLocale && locales.includes(config.defaultLocale) ? config.defaultLocale : locales[0]
+	};
+}
+function resolveDocsLocale(searchParams, i18n) {
+	if (!i18n) return void 0;
+	const raw = searchParams.get("lang") ?? searchParams.get("locale");
+	if (!raw) return void 0;
+	if (i18n.locales.includes(raw)) return raw;
+	return i18n.defaultLocale;
+}
+function resolveDocsPath(pathname, entry) {
+	const entryBase = normalizeSegment(entry || "docs") || "docs";
+	const entryParts = splitSegments(entryBase);
+	const pathParts = splitSegments(pathname);
+	let rest = pathParts;
+	if (entryParts.length > 0) {
+		if (pathParts.slice(0, entryParts.length).join("/") === entryParts.join("/")) rest = pathParts.slice(entryParts.length);
+	}
+	return {
+		slug: rest.join("/"),
+		entryPath: entryBase
+	};
+}
+
 //#endregion
 //#region src/metadata.ts
 /**
@@ -180,4 +220,4 @@ function buildPageTwitter(page, ogConfig, baseUrl) {
 }
 
 //#endregion
-export { buildPageOpenGraph, buildPageTwitter, createTheme, deepMerge, defineDocs, extendTheme, resolveOGImage, resolveTitle };
+export { buildPageOpenGraph, buildPageTwitter, createTheme, deepMerge, defineDocs, extendTheme, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveTitle };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",