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

package/dist/docs-layout.mjs

@@ -1,6 +1,8 @@
 import { DocsAIFeatures } from "./docs-ai-features.mjs";
+import { DocsCommandSearch } from "./docs-command-search.mjs";
 import { serializeIcon } from "./serialize-icon.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
+import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 import fs from "node:fs";
 import path from "node:path";
@@ -31,9 +33,10 @@ function hasChildPages(dir) {
 	}
 	return false;
 }
-function buildTree(config) {
+function buildTree(config, flat = false) {
 	const docsDir = path.join(process.cwd(), "app", config.entry);
 	const icons = config.icons;
+	const ordering = config.ordering;
 	const rootChildren = [];
 	if (fs.existsSync(path.join(docsDir, "page.mdx"))) {
 		const data = readFrontmatter(path.join(docsDir, "page.mdx"));
@@ -44,52 +47,91 @@ function buildTree(config) {
 			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) {
+	function buildNode(dir, name, baseSlug, slugOrder) {
+		const full = path.join(dir, name);
+		if (!fs.statSync(full).isDirectory()) return null;
+		const pagePath = path.join(full, "page.mdx");
+		if (!fs.existsSync(pagePath)) return null;
+		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 = scanDir(full, slug, slugOrder);
+			return {
+				type: "folder",
+				name: displayName,
+				icon,
+				index: {
+					type: "page",
+					name: displayName,
+					url,
+					icon
+				},
+				children: folderChildren,
+				...flat ? {
+					collapsible: false,
+					defaultOpen: true
+				} : {}
+			};
+		}
+		return {
+			type: "page",
+			name: displayName,
+			url,
+			icon
+		};
+	}
+	function scanDir(dir, baseSlug, slugOrder) {
 		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
+		if (slugOrder) {
+			const nodes = [];
+			const slugMap = /* @__PURE__ */ new Map();
+			for (const item of slugOrder) slugMap.set(item.slug, item);
+			for (const item of slugOrder) {
+				if (!entries.includes(item.slug)) continue;
+				const node = buildNode(dir, item.slug, baseSlug, item.children);
+				if (node) nodes.push(node);
+			}
+			for (const name of entries) {
+				if (slugMap.has(name)) continue;
+				const node = buildNode(dir, name, baseSlug);
+				if (node) nodes.push(node);
+			}
+			return nodes;
+		}
+		if (ordering === "numeric") {
+			const nodes = [];
+			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 order = typeof data.order === "number" ? data.order : Infinity;
+				const node = buildNode(dir, name, baseSlug);
+				if (node) nodes.push({
+					order,
+					node
 				});
-			} else nodes.push({
-				type: "page",
-				name: displayName,
-				url,
-				icon
+			}
+			nodes.sort((a, b) => {
+				if (a.order === b.order) return 0;
+				return a.order - b.order;
 			});
+			return nodes.map((n) => n.node);
+		}
+		const nodes = [];
+		for (const name of entries) {
+			const node = buildNode(dir, name, baseSlug);
+			if (node) nodes.push(node);
 		}
 		return nodes;
 	}
-	rootChildren.push(...scan(docsDir, []));
+	const rootSlugOrder = Array.isArray(ordering) ? ordering : void 0;
+	rootChildren.push(...scanDir(docsDir, [], rootSlugOrder));
 	return {
 		name: "Docs",
 		children: rootChildren
@@ -125,6 +167,31 @@ function buildLastModifiedMap(entry) {
 	return map;
 }
 /**
+* Scan all page.mdx files and build a map of URL pathname → description
+* from the frontmatter `description` field.
+*/
+function buildDescriptionMap(entry) {
+	const docsDir = path.join(process.cwd(), "app", entry);
+	const map = {};
+	function scan(dir, slugParts) {
+		if (!fs.existsSync(dir)) return;
+		const pagePath = path.join(dir, "page.mdx");
+		if (fs.existsSync(pagePath)) {
+			const desc = readFrontmatter(pagePath).description;
+			if (desc) {
+				const url = slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`;
+				map[url] = desc;
+			}
+		}
+		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
@@ -137,15 +204,71 @@ function buildLastModifiedMap(entry) {
 */
 function createDocsMetadata(config) {
 	const meta = config.metadata;
+	const og = config.og;
 	const template = meta?.titleTemplate ?? "%s";
-	return {
+	const defaultTitle = template.replace("%s", "").replace(/^[\s–—-]+/, "").trim() || "Docs";
+	const result = {
 		title: {
 			template,
-			default: template.replace("%s", "").replace(/^[\s–—-]+/, "").trim() || "Docs"
+			default: defaultTitle
 		},
 		...meta?.description ? { description: meta.description } : {},
 		...meta?.twitterCard ? { twitter: { card: meta.twitterCard } } : {}
 	};
+	if (og?.enabled !== false && og?.endpoint) {
+		const ogUrl = `${og.endpoint}?title=${encodeURIComponent(defaultTitle)}${meta?.description ? `&description=${encodeURIComponent(meta.description)}` : ""}`;
+		result.openGraph = { images: [{
+			url: ogUrl,
+			width: 1200,
+			height: 630
+		}] };
+		result.twitter = {
+			...result.twitter,
+			card: meta?.twitterCard ?? "summary_large_image",
+			images: [ogUrl]
+		};
+	}
+	return result;
+}
+/**
+* Generate page-level metadata with dynamic OG images.
+*
+* Usage in a docs page or [[...slug]] route:
+* ```ts
+* export function generateMetadata({ params }) {
+*   const page = getPage(params.slug);
+*   return createPageMetadata(docsConfig, {
+*     title: page.data.title,
+*     description: page.data.description,
+*   });
+* }
+* ```
+*/
+function createPageMetadata(config, page) {
+	const og = config.og;
+	const result = {
+		title: page.title,
+		...page.description ? { description: page.description } : {}
+	};
+	if (og?.enabled !== false && og?.endpoint) {
+		const ogUrl = `${og.endpoint}?title=${encodeURIComponent(page.title)}${page.description ? `&description=${encodeURIComponent(page.description)}` : ""}`;
+		result.openGraph = {
+			title: page.title,
+			description: page.description,
+			images: [{
+				url: ogUrl,
+				width: 1200,
+				height: 630
+			}]
+		};
+		result.twitter = {
+			card: "summary_large_image",
+			title: page.title,
+			description: page.description,
+			images: [ogUrl]
+		};
+	}
+	return result;
 }
 /** Resolve the themeToggle config into fumadocs-ui's `themeSwitch` prop. */
 function resolveThemeSwitch(toggle) {
@@ -162,10 +285,11 @@ function resolveSidebar(sidebar) {
 	if (sidebar === false) return { enabled: false };
 	return {
 		enabled: sidebar.enabled !== false,
-		component: sidebar.component,
+		componentFn: typeof sidebar.component === "function" ? sidebar.component : void 0,
 		footer: sidebar.footer,
 		banner: sidebar.banner,
-		collapsible: sidebar.collapsible
+		collapsible: sidebar.collapsible,
+		flat: sidebar.flat
 	};
 }
 const COLOR_MAP = {
@@ -194,7 +318,7 @@ function buildColorsCSS(colors) {
 		vars.push(`${COLOR_MAP[key]}: ${value};`);
 	}
 	if (vars.length === 0) return "";
-	return `:root, .dark {\n  ${vars.join("\n  ")}\n}`;
+	return `.dark {\n  ${vars.join("\n  ")}\n}`;
 }
 function ColorStyle({ colors }) {
 	const css = buildColorsCSS(colors);
@@ -238,22 +362,59 @@ function TypographyStyle({ typography }) {
 	if (!css) return null;
 	return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: css } });
 }
+function LayoutStyle({ layout }) {
+	if (!layout) return null;
+	const rootVars = [];
+	const desktopRootVars = [];
+	const desktopGridVars = [];
+	if (layout.sidebarWidth) {
+		const v = `--fd-sidebar-width: ${layout.sidebarWidth}px`;
+		desktopRootVars.push(`${v};`);
+		desktopGridVars.push(`${v} !important;`);
+	}
+	if (layout.contentWidth) rootVars.push(`--fd-content-width: ${layout.contentWidth}px;`);
+	if (layout.tocWidth) {
+		const v = `--fd-toc-width: ${layout.tocWidth}px`;
+		desktopRootVars.push(`${v};`);
+		desktopGridVars.push(`${v} !important;`);
+	}
+	if (rootVars.length === 0 && desktopRootVars.length === 0) return null;
+	const parts = [];
+	if (rootVars.length > 0) parts.push(`:root {\n  ${rootVars.join("\n  ")}\n}`);
+	if (desktopRootVars.length > 0) {
+		const inner = [`:root {\n    ${desktopRootVars.join("\n    ")}\n  }`];
+		if (desktopGridVars.length > 0) inner.push(`[style*="fd-sidebar-col"] {\n    ${desktopGridVars.join("\n    ")}\n  }`);
+		parts.push(`@media (min-width: 1024px) {\n  ${inner.join("\n  ")}\n}`);
+	}
+	return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: parts.join("\n") } });
+}
 function createDocsLayout(config) {
-	const tocEnabled = (config.theme?.ui?.layout?.toc)?.enabled !== false;
+	const tocConfig = config.theme?.ui?.layout?.toc;
+	const tocEnabled = tocConfig?.enabled !== false;
+	const tocStyle = tocConfig?.style;
 	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 resolvedSidebar = resolveSidebar(config.sidebar);
+	const sidebarFlat = resolvedSidebar.flat;
+	const sidebarComponentFn = resolvedSidebar.componentFn;
+	const { flat: _sidebarFlat, componentFn: _componentFn, ...sidebarProps } = resolvedSidebar;
 	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 layoutDimensions = config.theme?.ui?.layout;
 	const pageActions = config.pageActions;
 	const copyMarkdownEnabled = resolveBool(pageActions?.copyMarkdown);
 	const openDocsEnabled = resolveBool(pageActions?.openDocs);
 	const pageActionsPosition = pageActions?.position ?? "below-title";
+	const pageActionsAlignment = pageActions?.alignment ?? "left";
+	const lastUpdatedRaw = config.lastUpdated;
+	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
+	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
+	const llmsTxtEnabled = resolveBool(config.llmsTxt);
 	const openDocsProviders = (typeof pageActions?.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((p) => ({
 		name: p.name,
 		urlTemplate: p.urlTemplate,
@@ -271,21 +432,33 @@ function createDocsLayout(config) {
 	const aiTriggerComponentHtml = aiConfig?.triggerComponent ? serializeIcon(aiConfig.triggerComponent) : void 0;
 	const aiSuggestedQuestions = aiConfig?.suggestedQuestions;
 	const aiLabel = aiConfig?.aiLabel;
+	const aiLoaderVariant = aiConfig?.loader;
 	const aiLoadingComponentHtml = typeof aiConfig?.loadingComponent === "function" ? serializeIcon(aiConfig.loadingComponent({ name: aiLabel || "AI" })) : void 0;
 	const lastModifiedMap = buildLastModifiedMap(config.entry);
+	const descriptionMap = buildDescriptionMap(config.entry);
 	return function DocsLayoutWrapper({ children }) {
+		const tree = buildTree(config, !!sidebarFlat);
+		const finalSidebarProps = { ...sidebarProps };
+		if (sidebarComponentFn) finalSidebarProps.component = sidebarComponentFn({
+			tree,
+			collapsible: sidebarProps.collapsible !== false,
+			flat: !!sidebarFlat
+		});
 		return /* @__PURE__ */ jsxs(DocsLayout, {
-			tree: buildTree(config),
+			tree,
 			nav: {
 				title: navTitle,
 				url: navUrl
 			},
 			themeSwitch,
-			sidebar: sidebarProps,
+			sidebar: finalSidebarProps,
+			...aiMode === "sidebar-icon" && aiEnabled ? { searchToggle: { components: { lg: /* @__PURE__ */ jsx(SidebarSearchWithAI, {}) } } } : {},
 			children: [
 				/* @__PURE__ */ jsx(ColorStyle, { colors }),
 				/* @__PURE__ */ jsx(TypographyStyle, { typography }),
+				/* @__PURE__ */ jsx(LayoutStyle, { layout: layoutDimensions }),
 				forcedTheme && /* @__PURE__ */ jsx(ForcedThemeScript, { theme: forcedTheme }),
+				/* @__PURE__ */ jsx(DocsCommandSearch, {}),
 				aiEnabled && /* @__PURE__ */ jsx(DocsAIFeatures, {
 					mode: aiMode,
 					position: aiPosition,
@@ -293,20 +466,27 @@ function createDocsLayout(config) {
 					triggerComponentHtml: aiTriggerComponentHtml,
 					suggestedQuestions: aiSuggestedQuestions,
 					aiLabel,
+					loaderVariant: aiLoaderVariant,
 					loadingComponentHtml: aiLoadingComponentHtml
 				}),
 				/* @__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
 				})
 			]
@@ -328,4 +508,4 @@ function ForcedThemeScript({ theme }) {
 }
 
 //#endregion
-export { createDocsLayout, createDocsMetadata };
+export { createDocsLayout, createDocsMetadata, createPageMetadata };

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

@@ -10,6 +10,7 @@ interface SerializedProvider {
 }
 interface DocsPageClientProps {
   tocEnabled: boolean;
+  tocStyle?: "default" | "directional";
   breadcrumbEnabled?: boolean;
   /** The docs entry folder name (e.g. "docs") — used to strip from breadcrumb */
   entry?: string;
@@ -18,6 +19,8 @@ interface DocsPageClientProps {
   openDocsProviders?: SerializedProvider[];
   /** Where to render page actions relative to the title */
   pageActionsPosition?: "above-title" | "below-title";
+  /** Horizontal alignment of page action buttons */
+  pageActionsAlignment?: "left" | "right";
   /** GitHub repository URL (e.g. "https://github.com/user/repo") */
   githubUrl?: string;
   /** GitHub branch name @default "main" */
@@ -26,20 +29,37 @@ interface DocsPageClientProps {
   githubDirectory?: string;
   /** Map of pathname → formatted last-modified date string */
   lastModifiedMap?: Record<string, string>;
+  /** Whether to show "Last updated" at all */
+  lastUpdatedEnabled?: boolean;
+  /** Where to show the "Last updated" date: "footer" (next to Edit on GitHub) or "below-title" */
+  lastUpdatedPosition?: "footer" | "below-title";
+  /** Whether llms.txt is enabled — shows links in footer */
+  llmsTxtEnabled?: boolean;
+  /** Map of pathname → frontmatter description */
+  descriptionMap?: Record<string, string>;
+  /** Frontmatter description to display below the page title (overrides descriptionMap) */
+  description?: string;
   children: ReactNode;
 }
 declare function DocsPageClient({
   tocEnabled,
+  tocStyle,
   breadcrumbEnabled,
   entry,
   copyMarkdown,
   openDocs,
   openDocsProviders,
   pageActionsPosition,
+  pageActionsAlignment,
   githubUrl,
   githubBranch,
   githubDirectory,
   lastModifiedMap,
+  lastUpdatedEnabled,
+  lastUpdatedPosition,
+  llmsTxtEnabled,
+  descriptionMap,
+  description,
   children
 }: DocsPageClientProps): react_jsx_runtime0.JSX.Element;
 //#endregion

package/dist/docs-page-client.mjs

@@ -2,6 +2,7 @@
 
 import { PageActions } from "./page-actions.mjs";
 import { useEffect, useState } from "react";
+import { createPortal } from "react-dom";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { DocsBody, DocsPage, EditOnGitHub } from "fumadocs-ui/layouts/docs/page";
 import { usePathname, useRouter } from "next/navigation";
@@ -13,15 +14,13 @@ import { usePathname, useRouter } from "next/navigation";
 */
 function PathBreadcrumb({ pathname, entry }) {
 	const router = useRouter();
-	const allSegments = pathname.split("/").filter(Boolean);
-	const segments = allSegments.filter((s) => s.toLowerCase() !== entry.toLowerCase());
+	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 parentLabel = parentSegment.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 	const currentLabel = currentSegment.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-	const parentIndex = allSegments.indexOf(parentSegment);
-	const parentUrl = "/" + allSegments.slice(0, parentIndex + 1).join("/");
+	const parentUrl = "/" + segments.slice(0, segments.length - 1).join("/");
 	return /* @__PURE__ */ jsxs("nav", {
 		className: "fd-breadcrumb",
 		"aria-label": "Breadcrumb",
@@ -54,19 +53,22 @@ function PathBreadcrumb({ pathname, entry }) {
 * (Copy Markdown, Open in LLM). Re-scans when the route changes.
 */
 /**
-* Build the GitHub URL for the current page's source file.
+* Build the GitHub URL for the current page's source file (edit view).
 *
 * Examples:
-*   No directory:  https://github.com/user/repo/tree/main/app/docs/cli/page.mdx
-*   With directory: https://github.com/farming-labs/docs/tree/main/website/app/docs/cli/page.mdx
+*   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}/tree/${branch}/${directory ? `${directory}/` : ""}app/${segments}/page.mdx`;
+	return `${githubUrl}/edit/${branch}/${`${directory ? `${directory}/` : ""}app/${segments}/page.mdx`}`;
 }
-function DocsPageClient({ tocEnabled, breadcrumbEnabled = true, entry = "docs", copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", githubUrl, githubBranch = "main", githubDirectory, lastModifiedMap, children }) {
+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 }) {
+	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const pathname = usePathname();
+	const [actionsPortalTarget, setActionsPortalTarget] = useState(null);
+	const pageDescription = description ?? descriptionMap?.[pathname.replace(/\/$/, "") || "/"];
 	useEffect(() => {
 		if (!tocEnabled) return;
 		const timer = requestAnimationFrame(() => {
@@ -81,29 +83,102 @@ function DocsPageClient({ tocEnabled, breadcrumbEnabled = true, entry = "docs",
 		});
 		return () => cancelAnimationFrame(timer);
 	}, [tocEnabled, pathname]);
+	useEffect(() => {
+		if (!pageDescription) return;
+		const timer = requestAnimationFrame(() => {
+			const container = document.getElementById("nd-page");
+			if (!container) return;
+			const existingDesc = container.querySelector(".fd-page-description");
+			if (existingDesc) existingDesc.remove();
+			const h1 = container.querySelector("h1");
+			if (!h1) return;
+			const descEl = document.createElement("p");
+			descEl.className = "fd-page-description";
+			descEl.textContent = pageDescription;
+			h1.insertAdjacentElement("afterend", descEl);
+		});
+		return () => {
+			cancelAnimationFrame(timer);
+			const desc = document.querySelector("#nd-page .fd-page-description");
+			if (desc) desc.remove();
+		};
+	}, [pageDescription, pathname]);
 	const showActions = copyMarkdown || openDocs;
 	const githubFileUrl = githubUrl ? buildGithubFileUrl(githubUrl, githubBranch, pathname, githubDirectory) : void 0;
 	const normalizedPath = pathname.replace(/\/$/, "") || "/";
-	const lastModified = lastModifiedMap?.[normalizedPath];
-	const showFooter = githubFileUrl || lastModified;
+	const lastModified = lastUpdatedEnabled ? lastModifiedMap?.[normalizedPath] : void 0;
+	const showLastUpdatedBelowTitle = !!lastModified && lastUpdatedPosition === "below-title";
+	const showLastUpdatedInFooter = !!lastModified && lastUpdatedPosition === "footer";
+	const showFooter = !!githubFileUrl || showLastUpdatedInFooter || llmsTxtEnabled;
+	const needsBelowTitleBlock = showLastUpdatedBelowTitle || showActions;
+	useEffect(() => {
+		if (!needsBelowTitleBlock) return;
+		const timer = requestAnimationFrame(() => {
+			const container = document.getElementById("nd-page");
+			if (!container) return;
+			container.querySelectorAll(".fd-below-title-block").forEach((el) => el.remove());
+			const h1 = container.querySelector("h1");
+			if (!h1) return;
+			let insertAfter = h1;
+			const desc = container.querySelector(".fd-page-description");
+			if (desc) insertAfter = desc;
+			const wrapper = document.createElement("div");
+			wrapper.className = "fd-below-title-block not-prose";
+			if (showLastUpdatedBelowTitle) {
+				const lastUpdatedEl = document.createElement("p");
+				lastUpdatedEl.className = "fd-last-updated-inline";
+				lastUpdatedEl.textContent = `Last updated ${lastModified}`;
+				wrapper.appendChild(lastUpdatedEl);
+			}
+			if (showLastUpdatedBelowTitle || showActions) {
+				const hr = document.createElement("hr");
+				hr.className = "fd-title-separator";
+				wrapper.appendChild(hr);
+			}
+			if (showActions) {
+				const portalEl = document.createElement("div");
+				portalEl.className = "fd-actions-portal";
+				portalEl.setAttribute("data-actions-alignment", pageActionsAlignment);
+				wrapper.appendChild(portalEl);
+				setActionsPortalTarget(portalEl);
+			}
+			insertAfter.insertAdjacentElement("afterend", wrapper);
+		});
+		return () => {
+			cancelAnimationFrame(timer);
+			setActionsPortalTarget(null);
+			document.querySelectorAll("#nd-page .fd-below-title-block").forEach((el) => el.remove());
+		};
+	}, [
+		lastModified,
+		needsBelowTitleBlock,
+		showLastUpdatedBelowTitle,
+		showActions,
+		pageActionsAlignment,
+		pathname
+	]);
 	return /* @__PURE__ */ jsxs(DocsPage, {
 		toc,
-		tableOfContent: { enabled: tocEnabled },
-		tableOfContentPopover: { enabled: tocEnabled },
+		tableOfContent: {
+			enabled: tocEnabled,
+			style: fdTocStyle
+		},
+		tableOfContentPopover: {
+			enabled: tocEnabled,
+			style: fdTocStyle
+		},
 		breadcrumb: { enabled: false },
 		children: [
 			breadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
 				pathname,
 				entry
 			}),
-			showActions && /* @__PURE__ */ jsx("div", {
-				"data-actions-position": pageActionsPosition,
-				children: /* @__PURE__ */ jsx(PageActions, {
-					copyMarkdown,
-					openDocs,
-					providers: openDocsProviders
-				})
-			}),
+			showActions && actionsPortalTarget && createPortal(/* @__PURE__ */ jsx(PageActions, {
+				copyMarkdown,
+				openDocs,
+				providers: openDocsProviders,
+				githubFileUrl
+			}), actionsPortalTarget),
 			/* @__PURE__ */ jsxs(DocsBody, {
 				style: {
 					display: "flex",
@@ -114,10 +189,29 @@ function DocsPageClient({ tocEnabled, breadcrumbEnabled = true, entry = "docs",
 					children
 				}), showFooter && /* @__PURE__ */ jsxs("div", {
 					className: "not-prose fd-page-footer",
-					children: [githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }), lastModified && /* @__PURE__ */ jsxs("span", {
-						className: "fd-last-updated",
-						children: ["Last updated: ", lastModified]
-					})]
+					children: [
+						githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }),
+						llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
+							className: "fd-llms-txt-links",
+							children: [/* @__PURE__ */ jsx("a", {
+								href: "/api/docs?format=llms",
+								target: "_blank",
+								rel: "noopener noreferrer",
+								className: "fd-llms-txt-link",
+								children: "llms.txt"
+							}), /* @__PURE__ */ jsx("a", {
+								href: "/api/docs?format=llms-full",
+								target: "_blank",
+								rel: "noopener noreferrer",
+								className: "fd-llms-txt-link",
+								children: "llms-full.txt"
+							})]
+						}),
+						showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
+							className: "fd-last-updated-footer",
+							children: ["Last updated ", lastModified]
+						})
+					]
 				})]
 			})
 		]